getpriv(S-osr5)

getpriv -- get system privileges associated with this process

Syntax

cc . . . -lprot

#include <sys/types.h>
#include <sys/macro.h>
#include <sys/security.h>
#include <sys/audit.h>

int getpriv (privtype, privs)
int privtype;
priv_t *privs;

Description

The getpriv routine returns the system privilege vector for the current process in the vector argument privs. privs should have at least SEC_SPRIVVEC_SIZE entries. The argument privtype may only contain the privilege type SEC_EFFECTIVE_PRIV.

The system privilege vector contains per-process privileges used by the trusted control database. See setpriv(S-osr5) for a description of the privileges currently defined.

Return value

Upon successful completion, the getpriv routine returns the size, in bytes, of the privilege vector, privs. Otherwise, a value of -1 is returned and errno is set to indicate the appropriate error.

Diagnostics

If one of the following conditions occurs, getpriv fails and errno is set to the corresponding value:

[EFAULT]: privs points to an invalid address.
[EINVAL]: privtype is not SEC_EFFECTIVE_PRIV.

Standards conformance