NAME

Pldt, proc_get_ldt — obtain local descriptor table of a process

LIBRARY

Process Control Library (libproc, -lproc)

SYNOPSIS

#include <libproc.h>

int
Pldt(struct ps_prochandle *P, struct ssd *pldt, int nldt);

int
proc_get_ldt(pid_t pid, struct ssd *pldt, int nldt);

DESCRIPTION

The Pldt() function reads the local descriptor table (LDT) of the process handle P into the buffer pldt. Up to nldt entries will be read.

If either pldt is NULL or nldt is 0, then rather than filling in pldt, only the number of entries currently in the LDT is returned.

The buffer pldt should contain sufficient space for nldt entries. For example, callers could allocate space as:

pldt = malloc(sizeof (struct ssd) *
  nldt);

For more information on the LDT and the struct ssd, see proc(5).

The proc_get_ldt() function is similar to the Pldt() function; however, rather than reading from a process handle, it reads the ldt file from the /proc file system for the process pid.

RETURN VALUES

Upon successful completion, the Pldt() and proc_get_ldt() functions return the number of LDT entries written to pldt. If pldt is NULL or nldt is zero, then no data will be written. Otherwise, -1 is returned. The Pldt() function sets errno to indicate the error that occurred.

ERRORS

For a full list of possible errors see the DIAGNOSTICS section in proc(5).

The Pldt() function will fail if:

ENODATA: No LDT information is available in the process handle P.

ARCHITECTURE

The Pldt() and proc_get_ldt() functions are only available on x86 platforms.

INTERFACE STABILITY

Uncommitted

MT-LEVEL

See LOCKING in libproc(3LIB).