priv_set(3C) Standard C Library Functions priv_set(3C)NAME
priv_set, priv_ineffect - change privilege sets and check whether priv‐
ileges are set
SYNOPSIS
#include <priv.h>
int priv_set(priv_op_t op, priv_ptype_t which, ...);
boolean_t priv_ineffect(const char *priv);
DESCRIPTION
The priv_set() function is a convenient wrapper for the setppriv(2)
function. It takes three or more arguments. The operation argument, op,
can be one of PRIV_OFF, PRIV_ON or PRIV_SET. The which argument is the
name of the privilege set to change. The third argument is a list of
zero or more privilege names terminated with a null pointer. If which
is the special pseudo set PRIV_ALLSETS, the operation should be applied
to all privilege sets.
The specified privileges are converted to a binary privilege set and
setppriv() is called with the same op and which arguments. When called
with PRIV_ALLSETS as the value for the which argument, setppriv() is
called for each set in turn, aborting on the first failed call.
The priv_ineffect() function is a conventient wrapper for the getp‐
priv(2) function. The priv argument specifies the name of the privilege
for which this function checks its presence in the effective set.
RETURN VALUES
Upon successful completion, priv_set() return 0. Otherwise, -1 is
returned and errno is set to indicate the error.
If priv is a valid privilege that is a member of the effective set,
priv_ineffect() returns B_TRUE. Otherwise, it returns B_FALSE and sets
errno to incicate the error.
ERRORS
The priv_set() function will fail if:
EINVAL The value of op or which is out of range.
ENOMEM Insufficient memory was allocated.
EPERM The application attempted to add privileges to
PRIV_LIMIT or PRIV_PERMITTED, or the application
attempted to add privileges to PRIV_INHERITABLE or
PRIV_EFFECTIVE that were not in PRIV_PERMITTED.
The priv_ineffect() function will fail if:
EINVAL The privilege specified by priv is invalid.
ENOMEM Insufficient memory was allocated.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Evolving │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOsetppriv(2), priv_str_to_set(3C), attributes(5), privileges(5)SunOS 5.10 25 Sep 2003 priv_set(3C)
