set_effective_priv(3TSOL)

NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | RETURN VALUES | ERRORS | SEE ALSO

NAME

set_effective_priv, set_inheritable_priv, set_permitted_priv- Assign a privilege set for the current process

SYNOPSIS

cc [flags...] file... -ltsol


#include <tsol/priv.h> 

int set_effective_priv(priv_op_t op, int privno, [ , priv_t priv_id, ... ] );
int set_permitted_priv(priv_op_t op, int privno, [ , priv_t priv_id, ... ] );
int set_inheritable_priv(priv_op_t op, int privno, [ , priv_t priv_id, ... ] );

DESCRIPTION

These routines, located in the Trusted Solaris library, assign the effective, inheritable, and permitted privilege sets, respectively, for the current process. These routines provide a user-friendly interface to the system call setppriv(2). op is one of these operations:

PRIV_ON

Add the specified privilege IDs to the privilege set of the target process.

PRIV_OFF

Clear the specified privileges from the privilege set of the target process.

PRIV_SET

Add the specified privilege IDs to the privilege set of the target process and clear all other privileges.

privno indicates the count of privilege IDs that follow. The behavior of these routines is undefined if privno is less than zero. priv_id is a numerical privilege ID defined in <priv_names.h>.

Note that if op is PRIV_SET and privno is 0, the target privilege set is initialized to the empty set.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWtsu
MT-Level	MT-Safe

RETURN VALUES

These routines return:

0

On success.

-1

On failure, and set errno to indicate the error.

ERRORS

EINVAL

The specified privilege is invalid.

EPERM

A specified privilege is not permitted in the asserted set of privileges.

SEE ALSO

Trusted Solaris 8 4/01 Reference Manual

setppriv(2)

SunOS 5.8 Reference Manual

attributes(5)

SunOS 5.8  Last Revised 21 Feb 1995

NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | RETURN VALUES | ERRORS | SEE ALSO