getpflags(2)															      getpflags(2)

NAME

       getpflags, setpflags - get or set process flags

SYNOPSIS

       #include <sys/types.h>
       #include <priv.h>

       uint_t getpflags(uint_t flag);

       int setpflags(uint_t flag, uint_t value);

       The getpflags() and setpflags() functions obtain and modify the current per-process flags.

       The following values for flag are supported:

       PRIV_AWARE      This  one  bit  flag  takes  the value of 0 (unset) or 1 (set).	Only if this flag is set is the current process privilege-
		       aware. A process can attempt to unset this flag but might fail silently if the observed set invariance condition cannot	be
		       met. Setting this flag is always successful. See privileges(5) for a discussion of this flag.

       PRIV_DEBUG      This  one  bit flag takes the value of 0 (unset) or 1 (set).  Only if this flag is set does the current process have privi-
		       lege debugging enabled. Processes can set and unset this flag at will.

       The getpflags() returns the value associated with a given per-process flag. If the flag argument is invalid,  (uint_t)-1  is  returned  and
       errno is set to indicate the error.

       Upon successful completion, setpflags() returns 0. Otherwise, -1 is returned and errno is set to indicate the error.

       The getpflags() and setpflags() functions will fail if:

       EINVAL	       The value of flag or the value to which the flag is set is out of range.

       The setpflags() function will fail if:

       EPERM	       An attempt was made to unset PRIV_AWARE but the observed set invariance condition was not met.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Async-Signal-Safe 	   |
       +-----------------------------+-----------------------------+

       ppriv(1), attributes(5), privileges(5)

								    7 Mar 2005							      getpflags(2)