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

NAME

Psetpriv - set process privileges

LIBRARY

Process Control Library (libproc, -lproc)

SYNOPSIS

#include <libproc.h>

int
Psetpriv(struct ps_prochandle *P, prpriv_t *pprv);

DESCRIPTION

The Psetpriv() function updates the privileges of the process handle P to
the set described by pprv. The updated privilege set has restrictions on
what it may change for a process which are documented in the PCSPRIV
section of proc(5). In addition, the definition of the prpriv_t structure
is described in proc(5).

The current privilege set for the process may be obtained through a call to
Ppriv(3PROC).

Note, the privilege set may only be updated for active processes. Process
handles which correspond to core files, zombie processes, and files, may
not have their privilege sets updated.

RETURN VALUES

Upon successful completion, the Psetpriv() function returns 0 and updates
the privilege sets of the process. Otherwise, -1 is returned and errno is
set to indicate the error.

ERRORS

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

The Psetpriv() function will fail if:

EBADF P doesn't refer to an active process, but a core file,
zombie, or a file.

INTERFACE STABILITY

Uncommitted

MT-LEVEL
See LOCKING in libproc(3LIB).

SEE ALSO

libproc(3LIB), Ppriv(3PROC), proc(5), privileges(7)

illumos May 11, 2016 illumos