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


NAME
       dggetsmask - get a copy of a process (subject) per-process audit
       mask.

SYNOPSIS
       #include <sys/audit.h>

       int  dggetsmask (pidt  pid, auditmaskt  auditmask);

   where:
       pid         The process ID of the process whose audit mask is to be
                   returned in auditmask.  As a special case, when pid is
                   zero (0), the process ID of the calling process is used.

       auditmask  Points to an object of type auditmaskt into which the
                   audit mask is copied.

DESCRIPTION
       The dggetsmask() system call is used to get a copy of the audit mask
       of the process whose process ID is pid, subject to the access control
       constraints described below.

ACCESS CONTROL
       The calling process must have appropriate privilege.

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

ERRORS
       Under the following conditions, dggetsmask() fails and sets errno
       to:

       EPERM        The request violates the access control restrictions
                    described above.

       EFAULT       The caller does not have read/write access to the memory
                    pointed to by auditmask.

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

       EINVAL       The process associated with pid does not exist.

       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 returned by this system call. The effective audit mask is the
       union of the per-process audit mask and the system mask.

SEE ALSO
       dgsetsmask(2)




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

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


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
























































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