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.
See also
setpriv(S-osr5)
Standards conformance
The getpriv routine
is an extension of AT&T System V
provided by the Santa Cruz Operation.
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 02 June 2005