privileges(3) Library Functions Manual privileges(3)
NAME
privileges: priv_addset(), priv_delset(), priv_ismember(), priv_isobserved(), privset_add(), privset_alloc(), privset_copy(),
privset_del(), privset_empty(), privset_fill(), privset_free(), privset_intersect(), privset_inverse(), privset_isempty(), privset_ise-
qual(), privset_isfull(), privset_ismember(), privset_issubset(), privset_subtract(), privset_union() - privilege manipulation operations
for checking and debugging purposes
SYNOPSIS
Parameters
dstp to type; points to the destination privilege set.
num type; specifies a privilege by number.
privid type; contains the ID of the privilege to be acted upon.
privname type; string that contains the name of the privilege to be acted upon.
privp Pointer to type; points to the privilege set to be acted upon.
srcp to type; points to the source privilege set.
DESCRIPTION
Adds the privilege privname to the privilege set referred to by privp.
Removes the privilege
privname from the privilege set referred to by privp.
Check whether the named privilege
privname is a member of the privilege set privp.
Checks whether the calling process observes the named privilege
privname See privileges.5 for more information on when a process observes a privilege.
Adds the privilege
privid to the privilege set referred to by dstp.
Allocates memory for a privilege set of type
but does not initialize the space. The space allocated by this routine should be released using the routine.
Copies the privilege set referred to by
srcp to the privilege set referred to by dstp.
Removes the privilege specified by
num from the privilege set referred to by privp.
Clears all privileges from
privp.
Assigns all privileges, including those not currently define on the system, to
the privilege set privp.
Deallocates the space used by the privilege set referred to by
privp. If privp is NULL, no action occurs.
Finds the privileges that the privilege sets
srcp and dstp have in common and places the results in the privilege set dstp.
Inverts the privilege set pointed to by
privp.
Checks whether the privilege set
privp is the empty set.
Checks whether the privilege sets
srcp and dstp are equal sets.
Check whether the privilege set
privp is the full set of privileges. A full set of privileges is a set with all bits set, regardless of whether the privi-
lege is currently defined on the system.
Check whether the privilege
privid is a member of the privilege set privp.
Checks whether the privilege set
srcp is a subset of the privilege set dstp.
Subtracts the privilege set referred to by
srcp from the privilege set referred to by dstp.
Checks the privileges in the privilege sets
srcp and dstp and puts any privilege that is in either set into dstp.
RETURN VALUE
and return the following values:
Successful completion.
Function failed.
is set to indicate the error.
and return the following values:
Non-zero number.
Condition is TRUE.
Condition is FALSE.
is set to indicate the error.
returns the following values:
pointer Successful completions. Returns a non-null pointer to the allocated space.
NULL pointer
Function failed. Returns a null pointer and sets to indicate the error .
ERRORS
If any of the following conditions occur, the functions fail and set
Insufficient memory available to allocate space to hold a privilege set.
The application can try again later.
Invalid argument.
SEE ALSO
priv_getbyname(3), priv_getbynum(3), priv_set_to_str(3), priv_str_to_set(3), privileges(5).
privileges(3)