Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Sun::Solaris::Privilege (3)

Name

Sun::Solaris::Privilege - Perl interface to Privileges

Synopsis

use Sun::Solaris::Privilege qw(:ALL);

This module provides wrappers for the Privilege-related system and
library calls. Also provided are constants from the various Privilege-
related headers and dynamically generated constants for all the
privileges and privilege sets.

Functions
"getppriv($which)"

This function returns the process privilege set specified by $which.

"setppriv($op, $which, $set)"

This function modified the privilege set specified by $which in the as
specified by the $op and $set arguments.  If $op is PRIV_ON the
privileges in $set are added to the set specified; if $op is PRIV_OFF,
the privileges in $set are removed from the set specified; if $op is
PRIV_SET, the specified set is made equal to $set.

"getpflags($flag)"

Returns the value associated with process $flag or undef on error.
Possible values for $flag are PRIV_AWARE and PRIV_DEBUG.

"setppflags($flag, $val)"

Sets the process flag $flag to $val.

"priv_fillset()"

This returns a new privilege set with all privileges set.

"priv_emptyset()"

This returns a new empty privilege set.

"priv_isemptyset($set)"

This function returns whether $set is empty or not.

"priv_isfullset($set)"

This function returns whether $set is full or not.

"priv_isequalset($a, $b)"

This function returns whether sets $a and $b are equal.

"priv_issubset($a, $b)"

This function returns whether set $a is a subset of $b.

"priv_ismember($set, $priv)"

This function returns whether $priv is a member of $set.

"priv_ineffect($priv)"

This function returned whether $priv is in the process' effective set.

"priv_intersect($a, $b)"

This function returns a new privilege set which is the intersection of
$a and $b

"priv_union($a, $b)"

This function returns a new privilege set which is the union of $a and
$b

"priv_inverse($a)"

This function returns a new privilege set which is the inverse of $a.

"priv_addset($set, $priv)"

This functon adds the privilege $priv to $set.

"priv_copyset($a)"

This function returns a copy of the privilege set $a.

"priv_delset($set, $priv)"

This function remove the privilege $priv from $set.

Class methods
None.

Object methods
None.

Exports
By default nothing is exported from this module. The following tags can
be used to selectively import constants and functions defined in this
module:

:SYSCALLS    getppriv(), setppriv()

:LIBCALLS    priv_addset(), priv_copyset(), priv_delset(),
priv_emptyset(), priv_fillset(), priv_intersect(),
priv_inverse(), priv_isemptyset(), priv_isequalset(),
priv_isfullset(), priv_ismember(), priv_issubset(),
priv_gettext(), priv_union(), priv_set_to_str(),
priv_str_to_set()

:CONSTANTS   PRIV_STR_SHORT PRIV_STR_LIT PRIV_STR_PORT PRIV_ON PRIV_OFF
PRIV_SET PRIV_ALLSETS PRIV_AWARE PRIV_DEBUG
plus constant for all privileges and privilege sets.

:VARIABLES   %PRIVILEGES, %PRIVSETS

:ALL         :SYSCALLS, :LIBCALLS, :CONSTANTS and :VARIABLES

Description

User Contributed Perl Documentation                          pod::Privilege(3)



NAME
       Sun::Solaris::Privilege - Perl interface to Privileges

SYNOPSIS
        use Sun::Solaris::Privilege qw(:ALL);

       This module provides wrappers for the Privilege-related system and
       library calls. Also provided are constants from the various Privilege-
       related headers and dynamically generated constants for all the
       privileges and privilege sets.

   Functions
       "getppriv($which)"

       This function returns the process privilege set specified by $which.

       "setppriv($op, $which, $set)"

       This function modified the privilege set specified by $which in the as
       specified by the $op and $set arguments.  If $op is PRIV_ON the
       privileges in $set are added to the set specified; if $op is PRIV_OFF,
       the privileges in $set are removed from the set specified; if $op is
       PRIV_SET, the specified set is made equal to $set.

       "getpflags($flag)"

       Returns the value associated with process $flag or undef on error.
       Possible values for $flag are PRIV_AWARE and PRIV_DEBUG.

       "setppflags($flag, $val)"

       Sets the process flag $flag to $val.

       "priv_fillset()"

       This returns a new privilege set with all privileges set.

       "priv_emptyset()"

       This returns a new empty privilege set.

       "priv_isemptyset($set)"

       This function returns whether $set is empty or not.

       "priv_isfullset($set)"

       This function returns whether $set is full or not.

       "priv_isequalset($a, $b)"

       This function returns whether sets $a and $b are equal.

       "priv_issubset($a, $b)"

       This function returns whether set $a is a subset of $b.

       "priv_ismember($set, $priv)"

       This function returns whether $priv is a member of $set.

       "priv_ineffect($priv)"

       This function returned whether $priv is in the process' effective set.

       "priv_intersect($a, $b)"

       This function returns a new privilege set which is the intersection of
       $a and $b

       "priv_union($a, $b)"

       This function returns a new privilege set which is the union of $a and
       $b

       "priv_inverse($a)"

       This function returns a new privilege set which is the inverse of $a.

       "priv_addset($set, $priv)"

       This functon adds the privilege $priv to $set.

       "priv_copyset($a)"

       This function returns a copy of the privilege set $a.

       "priv_delset($set, $priv)"

       This function remove the privilege $priv from $set.

   Class methods
       None.

   Object methods
       None.

   Exports
       By default nothing is exported from this module. The following tags can
       be used to selectively import constants and functions defined in this
       module:

        :SYSCALLS    getppriv(), setppriv()

        :LIBCALLS    priv_addset(), priv_copyset(), priv_delset(),
                     priv_emptyset(), priv_fillset(), priv_intersect(),
                     priv_inverse(), priv_isemptyset(), priv_isequalset(),
                     priv_isfullset(), priv_ismember(), priv_issubset(),
                     priv_gettext(), priv_union(), priv_set_to_str(),
                     priv_str_to_set()

        :CONSTANTS   PRIV_STR_SHORT PRIV_STR_LIT PRIV_STR_PORT PRIV_ON PRIV_OFF
                     PRIV_SET PRIV_ALLSETS PRIV_AWARE PRIV_DEBUG
                     plus constant for all privileges and privilege sets.

        :VARIABLES   %PRIVILEGES, %PRIVSETS

        :ALL         :SYSCALLS, :LIBCALLS, :CONSTANTS and :VARIABLES

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

         ___________________________________________________________
        |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
        |_____________________________|_____________________________|
        | Availability                | CPAN (http://www.cpan.org)  |
        |_____________________________|_____________________________|
        | Interface Stability         | Evolving                    |
        |_____________________________|_____________________________|

SEE ALSO
       getpflags(2), getppriv(2), "priv_addset(3C)", "priv_str_to_set(3C)",
       "priv_set(3C)", privileges(7), attributes(7)



perl v5.32.0                      2022-06-28                 pod::Privilege(3)