satgetid(2)

NAME
     satgetid, satsetid - get or set audit identity

C SYNOPSIS
     #include <sat.h>

     int satgetid (void);
     int satsetid (int);

DESCRIPTION
     satgetid returns the audit identity of the calling process.  satsetid
     sets the audit identify of the calling process.

     The calling process must have appropriate privilege to successfully call
     satgetid or satsetid. If _POSIX_CAP is in effect, appropriate privilege
     includes CAP_AUDIT_CONTROL capability.

ERRORS
     satgetid and satsetid will fail if one or more of the following are true:

     [ENOPKG]       Audit is not configured on this system.

     [EPERM]        The caller doesn't have CAP_AUDIT_CONTROL capability.

RETURN VALUE
     A return value of -1 indicates an error and errno is set to indicate the
     error.  Otherwise, satgetid returns the audit identity of the calling
     process, and satsetid returns 0 if the audit identity of the calling
     process was successfully set.

SEE ALSO
     satd(1m), satoff(2), saton(2), satstate(2), satwrite(2)

ORIGIN
     Silicon Graphics, Inc.