|
|
HP-UX Reference > Aaudswitch(2)HP-UX 11i Version 2: December 2007 Update |
|
NAMEaudswitch() — suspend or resume auditing on the current process DESCRIPTIONaudswitch() suspends or resumes auditing within the current process. This call is restricted to users with the SELFAUDIT privilege. One of the following aflags must be used:
audswitch() can be used in processes with the SELFAUDIT privilege to temporarily suspend auditing during intervals where auditing is to be handled by the process itself. Auditing is suspended by a call to audswitch() with the AUD_SUSPEND parameter and resumed later by a call to audswitch() with the AUD_RESUME parameter. An audswitch() call to resume auditing serves only to reverse the action of a previous audswitch() call to suspend auditing. A call to audswitch() to resume auditing when auditing is not suspended has no effect. audswitch() affects only the current process. For example, audswitch() cannot suspend auditing for processes exec'ed from the current process. (Use setaudproc (see setaudproc(2)) to enable or disable auditing for a process and its children). Security RestrictionsSome or all of the actions associated with this system call require the SELFAUDIT 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 VALUEUpon successful completion, audswitch() returns 0. If an error occurs, -1 is returned and the global variable errno is set to indicate the error. |
|