DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

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