1N/A# Copyright (c) 2004, Oracle
and/or its affiliates. All rights reserved.
1N/A# Sun::Solaris::Privilege documentation.
1N/ASun::Solaris::Privilege - Perl interface to Privileges
1N/A use Sun::Solaris::Privilege qw(:ALL);
1N/AThis module provides wrappers for the Privilege-related system and
1N/Alibrary calls. Also provided are constants from the various
1N/APrivilege-related headers and dynamically generated constants for all
1N/Athe privileges and privilege sets.
1N/AB<C<getppriv($which)>>
1N/AThis function returns the process privilege set specified by $which.
1N/AB<C<setppriv($op, $which, $set)>>
1N/AThis function modified the privilege set specified by $which in the
1N/Aas specified by the $op and $set arguments. If $op is PRIV_ON the
1N/Aprivileges in $set are added to the set specified; if $op is PRIV_OFF,
1N/Athe privileges in $set are removed from the set specified; if $op
1N/Ais PRIV_SET, the specified set is made equal to $set.
1N/AB<C<getpflags($flag)>>
1N/AReturns the value associated with process $flag or undef on error.
1N/APossible values for $flag are PRIV_AWARE and PRIV_DEBUG.
1N/AB<C<setppflags($flag, $val)>>
1N/ASets the process flag $flag to $val.
1N/AThis returns a new privilege set with all privileges set.
1N/AB<C<priv_emptyset()>>
1N/AThis returns a new empty privilege set.
1N/AB<C<priv_isemptyset($set)>>
1N/AThis function returns whether $set is empty or not.
1N/AB<C<priv_isfullset($set)>>
1N/AThis function returns whether $set is full or not.
1N/AB<C<priv_isequalset($a, $b)>>
1N/AThis function returns whether sets $a and $b are equal.
1N/AB<C<priv_issubset($a, $b)>>
1N/AThis function returns whether set $a is a subset of $b.
1N/AB<C<priv_ismember($set, $priv)>>
1N/AThis function returns whether $priv is a member of $set.
1N/AB<C<priv_ineffect($priv)>>
1N/AThis function returned whether $priv is in the process' effective set.
1N/AB<C<priv_intersect($a, $b)>>
1N/AThis function returns a new privilege set which is the intersection of $a
1N/AB<C<priv_union($a, $b)>>
1N/AThis function returns a new privilege set which is the union of $a
1N/AB<C<priv_inverse($a)>>
1N/AThis function returns a new privilege set which is the inverse of $a.
1N/AB<C<priv_addset($set, $priv)>>
1N/AThis functon adds the privilege $priv to $set.
1N/AB<C<priv_copyset($a)>>
1N/AThis function returns a copy of the privilege set $a.
1N/AB<C<priv_delset($set, $priv)>>
1N/AThis function remove the privilege $priv from $set.
1N/A=head2 Object methods
1N/ABy default nothing is exported from this module. The following tags can be
1N/Aused to selectively import constants and functions defined in this module:
1N/A :SYSCALLS getppriv(), setppriv()
1N/A :LIBCALLS priv_addset(), priv_copyset(), priv_delset(),
1N/A priv_emptyset(), priv_fillset(), priv_intersect(),
1N/A priv_inverse(), priv_isemptyset(), priv_isequalset(),
1N/A priv_isfullset(), priv_ismember(), priv_issubset(),
1N/A priv_gettext(), priv_union(), priv_set_to_str(),
1N/A :CONSTANTS PRIV_STR_SHORT PRIV_STR_LIT PRIV_STR_PORT PRIV_ON PRIV_OFF
1N/A PRIV_SET PRIV_ALLSETS PRIV_AWARE PRIV_DEBUG
1N/A plus constant for all privileges and privilege sets.
1N/A :VARIABLES %PRIVILEGES, %PRIVSETS
1N/A :ALL :SYSCALLS, :LIBCALLS, :CONSTANTS and :VARIABLES
1N/ASee C<attributes(5)> for descriptions of the following attributes:
1N/A ___________________________________________________________
1N/A | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
1N/A |_____________________________|_____________________________|
1N/A |_____________________________|_____________________________|
1N/A | Interface Stability | Evolving |
1N/A |_____________________________|_____________________________|
1N/AC<getpflags(2)>, C<getppriv(2)>, C<priv_addset(3C)>, C<priv_str_to_set(3C)>,
1N/AC<priv_set(3C)>, C<privileges(5)>, C<attributes(5)>