privileged(9r) [osf1 man page]

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)

audswitch(2)							System Calls Manual						      audswitch(2)

NAME

       audswitch() - suspend or resume auditing on the current process

SYNOPSIS

DESCRIPTION

       suspends or resumes auditing within the current process.  This call is restricted to users with the privilege.

       One of the following flags must be used for aflag:

	  Suspend auditing on the current process.

	  Resume auditing on the current process.

       can be used in processes with the privilege to temporarily suspend auditing during intervals where auditing is to be handled by the process
       itself.	Auditing is suspended by a call to with the parameter and resumed later by a call to with the parameter.

       An call to resume auditing serves only to reverse the action of a previous call to suspend auditing.  A call to	to  resume  auditing  when
       auditing is not suspended has no effect.

       affects	only  the current process.  For example, cannot suspend auditing for processes from the current process.  (Use (see setaudproc(2))
       to enable or disable auditing for a process and its children).

   Security Restrictions
       Some or all of the actions associated with this system call require the privilege.  Processes owned by the superuser have  this	privilege.
       Processes  owned  by  other users may have this privilege, depending on system configuration.  See privileges(5) for more information about
       privileged access on systems that support fine-grained privileges.

RETURN VALUE

       Upon successful completion, returns If an error occurs, is returned and the global variable is set to indicate the error.

ERRORS

       fails if one of the following is true:

       The user does not possess the
		      privilege.

       The input parameter is neither
		      nor

AUTHOR

       was developed by HP.

SEE ALSO

       audevent(1M), audusr(1M), setaudproc(2), audit(5), privileges(5).

																      audswitch(2)