Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for setpflags (opensolaris section 2)

getpflags(2)				   System Calls 			     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);

DESCRIPTION
       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 privilege debugging enabled. Processes can set and unset
	   this flag at will.

       NET_MAC_AWARE
       NET_MAC_AWARE_INHERIT

	   These flags are available only if the system is configured  with  Trusted  Extensions.
	   These  one bit flags each take the value of 0 (unset) or 1 (set). If the NET_MAC_AWARE
	   flag is set then the current process is allowed to communicate with	peers  at  labels
	   that are different than its own, subject to MAC policy.

	   The	NET_MAC_AWARE_INHERIT  flag  controls  the propagation of the NET_MAC_AWARE flag.
	   When a process performs one of the exec(2) functions, the NET_MAC_AWARE flag is  unset
	   unless  the NET_MAC_AWARE_INHERIT is set. NET_MAC_AWARE_INHERIT is always unset on one
	   of the exec functions. The PRIV_NET_MAC_AWARE privilege is required to set  either  of
	   these flags.

RETURN VALUES
       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.

ERRORS
       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.

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

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

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

SunOS 5.11				    8 Mar 2006				     getpflags(2)


All times are GMT -4. The time now is 10:04 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password