audswitch(2)audswitch(2)NAMEaudswitch() - suspend or resume auditing on the current process
SYNOPSISDESCRIPTION
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 pre‐
vious 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. Pro‐
cesses owned by other users may have this privilege, depending on sys‐
tem configuration. See privileges(5) for more information about privi‐
leged 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 ALSOaudevent(1M), audusr(1M), setaudproc(2), audit(5), privileges(5).
audswitch(2)