dg_getsmask(2) DG/UX B2 Security R4.12MU02 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, audmaskt 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 audmaskt into which the
audit mask is copied.
DESCRIPTION
The dggetsmask system call gets 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.
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/write access to the memory
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
dgsetsmask(2), capdefaults(5).
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.
Licensed material--property of copyright holder(s)