dg_setsmask(2) — DG/UX R4.11MU05



dg_setsmask(2)           DG/UX B2 Security R4.12MU02          dg_setsmask(2)


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

SYNOPSIS
       #include <sys/audit.h>

       int  dgsetsmask (pidt  pid, audmaskt  auditmask);

   where:
       pid         The process ID of the process whose audit mask is to be
                   replaced with auditmask.  When pid is zero (0), 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.

       For systems supporting the DG/UX Capability Option, appropriate
       privilege is defined as having one or more specific capabilities
       enabled in the effective capability set of the calling process.  See
       capdefaults(5) for the default capability for this system call.  On
       systems without the DG/UX Capability Option, appropriate privilege
       means that the process has an effective UID of root. See the
       appropriateprivilege(5) man page for more information.

RETURN VALUE
       0      Successful completion
       -1     An error occurred.  errno is set 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.

       ESRCH   The process associated with pid does not exist.

       ENOMEM  Memory could not be allocated to satisfy the request.

SEE ALSO
       dggetsmask(2), capdefaults(5).

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.


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