osf1 man page for privileged

privileged(9r)															    privileged(9r)

NAME
       privileged - General: Checks for proper privileges

SYNOPSIS
       int privileged(
	       int privilege,
	       int error_code );

ARGUMENTS
       Specifies the privilege to check against. This privilege must be one of the constants defined in /usr/sys/include/sys/security.h. For exam-
       ple, you would specify SEC_FILESYS for disk drivers that must manipulate partition tables on disk drives.  Specifies the value used to con-
       trol  auditing.	You can pass one of the system's error codes or one of the following values: -1, 0, 1.	An example of an error code is the
       constant EPERM.

DESCRIPTION
       The privileged routine checks for an appropriate privilege when the security feature is enabled.  Use privileged with  a  privilege  number
       and  with  the  error_code argument set to the constant EPERM to emulate the traditional behavior of the suser routine. Set error_code to a
       value of 0 (zero) if you want to check the privilege but not fail the operation if the user does not have the proper privilege. A value	of
       -1 turns off all auditing as well.

RETURN VALUES
       The  privileged	routine returns the value 0 (zero) if the process does not have privilege. It returns the value 1 if the process does have
       privilege.

FILES
SEE ALSO
       Routines: suser(9r)

																    privileged(9r)