1ca0716f5SRobert Watson.\"- 2ca0716f5SRobert Watson.\" Copyright (c) 2005 Robert N. M. Watson 3ca0716f5SRobert Watson.\" All rights reserved. 4ca0716f5SRobert Watson.\" 5ca0716f5SRobert Watson.\" Redistribution and use in source and binary forms, with or without 6ca0716f5SRobert Watson.\" modification, are permitted provided that the following conditions 7ca0716f5SRobert Watson.\" are met: 8ca0716f5SRobert Watson.\" 1. Redistributions of source code must retain the above copyright 9ca0716f5SRobert Watson.\" notice, this list of conditions and the following disclaimer. 10ca0716f5SRobert Watson.\" 2. Redistributions in binary form must reproduce the above copyright 11ca0716f5SRobert Watson.\" notice, this list of conditions and the following disclaimer in the 12ca0716f5SRobert Watson.\" documentation and/or other materials provided with the distribution. 13ca0716f5SRobert Watson.\" 14ca0716f5SRobert Watson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15ca0716f5SRobert Watson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16ca0716f5SRobert Watson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17ca0716f5SRobert Watson.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18ca0716f5SRobert Watson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19ca0716f5SRobert Watson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20ca0716f5SRobert Watson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21ca0716f5SRobert Watson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22ca0716f5SRobert Watson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23ca0716f5SRobert Watson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24ca0716f5SRobert Watson.\" SUCH DAMAGE. 25ca0716f5SRobert Watson.\" 26ca0716f5SRobert Watson.\" $P4: //depot/projects/trustedbsd/openbsm/man/getaudit.2#4 $ 27ca0716f5SRobert Watson.\" 28ca0716f5SRobert Watson.Dd April 19, 2005 29ca0716f5SRobert Watson.Dt GETAUDIT 2 30ca0716f5SRobert Watson.Os 31ca0716f5SRobert Watson.Sh NAME 32ca0716f5SRobert Watson.Nm getaudit , 33ca0716f5SRobert Watson.Nm getaudit_addr 34ca0716f5SRobert Watson.Nd "Retrieve audit session state" 35ca0716f5SRobert Watson.Sh SYNOPSIS 36ca0716f5SRobert Watson.In bsm/audit.h 37ca0716f5SRobert Watson.Ft int 38ca0716f5SRobert Watson.Fn getaudit "auditinfo_t *auditinfo" 39ca0716f5SRobert Watson.Ft int 40ca0716f5SRobert Watson.Fn getaudit_addr "auditinfo_addr_t *auditinfo_addr" "u_int length" 41ca0716f5SRobert Watson.Sh DESCRIPTION 42ca0716f5SRobert Watson.Fn getaudit 43ca0716f5SRobert Watsonretrieves the active audit session state for the current process via the 44ca0716f5SRobert Watson.Vt auditinfo_t 45ca0716f5SRobert Watsonpointed to by 46ca0716f5SRobert Watson.Va auditinfo . 47ca0716f5SRobert Watson.Fn getaudit_addr 48ca0716f5SRobert Watsonretrieves extended state via 49ca0716f5SRobert Watson.Va auditinfo_addr 50ca0716f5SRobert Watsonand 51ca0716f5SRobert Watson.Va length . 52ca0716f5SRobert Watson.Pp 53ca0716f5SRobert WatsonThis system call required appropriate privilege to complete. 54ca0716f5SRobert Watson.Sh RETURN VALUES 55ca0716f5SRobert Watson.Nm 56ca0716f5SRobert Watsonreturns 0 on success, or returns -1 on failure, providing additional error 57ca0716f5SRobert Watsoninformation via 58ca0716f5SRobert Watson.Va errno . 59ca0716f5SRobert Watson.Sh SEE ALSO 60ca0716f5SRobert Watson.Xr audit 2 , 61ca0716f5SRobert Watson.Xr auditon 2 , 62ca0716f5SRobert Watson.Xr getauid 2 , 63ca0716f5SRobert Watson.Xr setauid 2 , 64ca0716f5SRobert Watson.Xr setaudit 2 , 65ca0716f5SRobert Watson.Xr libbsm 3 66ca0716f5SRobert Watson.Sh AUTHORS 67ca0716f5SRobert WatsonThis software was created by McAfee Research, the security research division 68ca0716f5SRobert Watsonof McAfee, Inc., under contract to Apple Computer Inc. 69ca0716f5SRobert WatsonAdditional authors include Wayne Salamon, Robert Watson, and SPARTA Inc. 70ca0716f5SRobert Watson.Pp 71ca0716f5SRobert WatsonThe Basic Security Module (BSM) interface to audit records and audit event 72ca0716f5SRobert Watsonstream format were defined by Sun Microsystems. 73ca0716f5SRobert Watson.Pp 74ca0716f5SRobert WatsonThis manual page was written by 75ca0716f5SRobert Watson.An Robert Watson Aq rwatson@FreeBSD.org . 76ca0716f5SRobert Watson.Sh HISTORY 77ca0716f5SRobert WatsonThe OpenBSM implementation was created by McAfee Research, the security 78ca0716f5SRobert Watsondivision of McAfee Inc., under contract to Apple Computer Inc. in 2004. 79ca0716f5SRobert WatsonIt was subsequently adopted by the TrustedBSD Project as the foundation for 80ca0716f5SRobert Watsonthe OpenBSM distribution. 81