Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 discus-
		       sion 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 privilege 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)

NAME | SYNOPSIS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getpflags&sektion=2&manpath=SunOS+5.10>

home | help