illumos: manual page: Pcred.3proc

PCRED(3PROC) Process Control Library Functions PCRED(3PROC)

NAME

Pcred - obtain process credentials

LIBRARY

Process Control Library (libproc, -lproc)

SYNOPSIS

#include <libproc.h>

int
Pcred(struct ps_prochandle *P, prcred_t *pcrp, int ngroups);

DESCRIPTION

The Pcred() function obtains the credentials of the process from the handle
P.

The credentials are read into the buffer pointed to by pcrp. The prcred_t
type is defined in proc(5). It contains information about the current
effective, saved, and real user and group IDs. It also allows for
supplemental groups to be obtained. The Pcred() function will read a
number of supplemental groups based on the value of ngroups. The prcred_t
structure only contains the space for one supplemental group by default.
Callers should ensure that the buffer pointed to by pcrp contains enough
space to include all of the required supplemental groups that are desired.

Not all process handles have credential information available to them. For
example, the handles that come from Pgrab_file(3PROC) have no processes
associated with them and thus have no credentials associated with them.

RETURN VALUES

Upon successful completion, the Pcred() function returns 0 and updates the
memory at pcrp with the credentials. Otherwise, -1 is returned to indicate
an error.

INTERFACE STABILITY