setauid2
Set audit indentifier
Usage
#include <bsm/audit.h>
int
setauid(au_id_t *auid);
Overview
The setauid() system call sets the active audit identifier for the current process from the au_id_t pointed to by auid. The value of AU_DEFAUDITID (-1) should not be used for auid.
This system call requires an appropriate privilege to complete.
Once the audit identifier is set to some other value than AU_DEAUDITID (-1) then it is immutable. This system call may be used to set the audit identifier after initially setting up the audit session with the setaudit(2), or setaudit_addr(2) system call.
Return values
The setauid() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
Errors
The setauid() function will fail if:
- [EFAULT]
-
A failure occurred while data transferred to the kernel failed.
- [EINVAL]
-
An invalid value for auid was used. auid can be any value of type au_id_t except AU_DEFAUDITID.
- [EPERM]
-
The process does not have sufficient permission to complete the operation.
Releases
112 releases since Mac OS X 10.5; the text changed 1 time.