Provided by: freebsd-manpages_7.2-1_all bug

NAME

     getaudit, getaudit_addr - retrieve audit session state

SYNOPSIS

     #include <bsm/audit.h>

     int
     getaudit(auditinfo_t *auditinfo);

     int
     getaudit_addr(auditinfo_addr_t *auditinfo_addr, u_int length);

DESCRIPTION

     The getaudit() system call retrieves the active audit session state for
     the current process via the auditinfo_t pointed to by auditinfo.  The
     getaudit_addr() system call retrieves extended state via auditinfo_addr
     and length.

     These system calls require an appropriate privilege to complete.

RETURN VALUES

     The getaudit() and getaudit_addr() functions return the value 0 if
     successful; otherwise the value -1 is returned and the global variable
     errno is set to indicate the error.

SEE ALSO

     audit(2), auditon(2), getauid(2), setaudit(2), setauid(2), libbsm(3)

HISTORY

     The OpenBSM implementation was created by McAfee Research, the security
     division of McAfee Inc., under contract to Apple Computer Inc. in 2004.
     It was subsequently adopted by the TrustedBSD Project as the foundation
     for the OpenBSM distribution.

AUTHORS

     This software was created by McAfee Research, the security research
     division of McAfee, Inc., under contract to Apple Computer Inc.
     Additional authors include Wayne Salamon, Robert Watson, and SPARTA Inc.

     The Basic Security Module (BSM) interface to audit records and audit
     event stream format were defined by Sun Microsystems.

     This manual page was written by Robert Watson 〈rwatson@FreeBSD.org〉.