NAME

au_getpmask, au_setpmask − gets/sets the audit mask of the process

SYNOPSIS

#include <sys/types.h>
#include <sys/audit.h>
 int au_getpmask (mask)
aumask_t ∗mask;
 int au_setpmask (mask)
aumask_t ∗mask;

DESCRIPTION

The au_getpmask system call is used to get (read) the audit mask of the calling process.  The audit mask of the calling process is returned in a structure pointed to by mask. 

The au_setpmask system call is used to set (modify) the audit mask of the calling process.  The audit mask of the calling process is set to mask. 

Both system calls require the root privilege (user ID 0). 

Both system calls will fail if any of the following are true:

[EPERM] The calling process is not privileged. 

[EFAULT] mask points outside the allocated address space of the process. 
 

DIAGNOSTICS

Upon successful completion, a value of 0 is returned.  Otherwise, a value of −1 is returned and errno is set to indicate the error. 

SEE ALSO

audit(4)

(Security Enhancement)