dg_setsmask(2) — DG/UX 5.4.2T



dg_setsmask(2)             C2 Trusted DG/UX 5.4.2T            dg_setsmask(2)


NAME
       dgsetsmask - set the target process (subject) per-process audit
       mask.

SYNOPSIS
       #include <sys/audit.h>

       int  dgsetsmask (pidt  pid, auditmaskt  auditmask);

   where:
       pid         The process ID of the process whose audit mask is to be
                   replaced with auditmask.  When pid is zero the caller's
                   process ID is used.

       auditmask  The address of the audit mask.

DESCRIPTION
       The dgsetsmask() system call sets the per-process audit mask of the
       process whose process ID is given by pid to the value of auditmask.

       The audit mask is inherited by the child process on a fork.

ACCESS CONTROL
       The calling process must have appropriate privilege.

RETURN VALUE
       Upon successful completion dgsetsmask() returns a value of 0.
       Otherwise it returns the value -1 and sets errno to indicate the
       error.

ERRORS
       Errno may be set to one of the following error codes:

       EPERM        The request violates the access control restrictions
                    described above.

       EFAULT       The caller does not have read access to the audit-mask
                    pointed to by auditmask.

       EINVAL       The pid is not with in the range 0 to MAXPID.

       ENOMEM       Memory could not be allocated to satisfy the request.

NOTES
       It is the per-process audit mask, and not the effective audit mask
       that is set by this system call. The effective audit mask is the
       union of the per-process audit mask and the system mask.

SEE ALSO
       dggetsmask(2)

       Audit System Administrator's Guide for the C2 Trusted DG/UX System





Licensed material--property of copyright holder(s)                         1
Museum
