satgetid(2)							   satgetid(2)

NAME    [Toc]    [Back]

     satgetid, satsetid	- get or set audit identity

C SYNOPSIS    [Toc]    [Back]

     #include <sat.h>

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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

ORIGIN    [Toc]    [Back]

     Silicon Graphics, Inc.


									PPPPaaaaggggeeee 1111