Privilege(3PERL)					      Perl Library Functions						  Privilege(3PERL)

NAME

       Privilege - Perl interface to Privileges

SYNOPSIS

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

DESCRIPTION

       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.

   Constants
       PRIV_STR_SHORT, PRIV_STR_LIT, PRIV_STR_PORT, PRIV_ON, PRIV_OFF, PRIV_SET, PRIV_AWARE, and PRIV_DEBUG.

   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)

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

       setppflags($flag, $val)

	   This function sets the process flag $flag to $val.

       priv_fillset()

	   This function returns a new privilege set with all privileges set.

       priv_emptyset()

	   This function returns a new empty privilege set.

       priv_isemptyset($set)

	   This function returns whether or not $set is empty.

       priv_isfullset($set)

	   This function returns whether or not $set is full.

       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's 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_AWARE, PRIV_DEBUG, plus  constants  for  all
		       privileges and privilege sets.

       :VARIABLES      %PRIVILEGES, %PRIVSETS

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

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWpl5u			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       getpflags(2), getppriv(2), priv_addset(3C), priv_set(3C), priv_str_to_set(3C), attributes(5), privileges(5)

SunOS 5.10							    30 Jan 2004 						  Privilege(3PERL)