setaudproc(2)setaudproc(2)NAMEsetaudproc() - controls process level auditing for the current process
and its decendents
SYNOPSISDESCRIPTION
controls process level auditing for the current process and its decen‐
dents. It accomplishes this by setting or clearing the flag in the
area of the calling process. When this flag is set, the system audits
the process; when it is cleared, the process is not audited. This call
is restricted to users with the privilege.
One of the following flags must be used for aflag:
Audit the calling process and its decendents.
Do not audit the calling process and its decendents.
The flag is inherited by the descendents of a process. consequently,
the effect of a call to is not limited to the current process, but
propagates to all its decendents as well. For example, if is called
with the flag, all subsequent audited system calls in the current
process are audited until is called with the flag.
Further, performs its action regardless of whether the user executing
the process has been selected to be audited or not. For example, if is
called with the (or the flag, all subsequent audited system calls will
be audited (or not audited), regardless of whether the user executing
the process has been selected for auditing or not.
Due to these features, should not be used in most self-auditing appli‐
cations. should be used (see audswitch(2)) when the objective is to
suspend auditing within a process without affecting its decendents or
overriding the user selection aspect of the auditing system.
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 0; otherwise, it returns −1 and
sets to indicate the error.
AUTHOR
was developed by HP.
SEE ALSOaudevent(1M), audusr(1M), audswitch(2), getaudproc(2), audit(5), privi‐
leges(5).
setaudproc(2)