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 in-
		       variance	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 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 re-
       turned 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 ob-
		       served 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=setpflags&sektion=2&manpath=SunOS+5.10>

home | help