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.\" 26bc168a6cSRobert Watson.\" $P4: //depot/projects/trustedbsd/openbsm/man/getaudit.2#7 $ 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 34bc168a6cSRobert 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 42bc168a6cSRobert WatsonThe 43ca0716f5SRobert Watson.Fn getaudit 44bc168a6cSRobert Watsonsystem call 45ca0716f5SRobert Watsonretrieves the active audit session state for the current process via the 46ca0716f5SRobert Watson.Vt auditinfo_t 47ca0716f5SRobert Watsonpointed to by 48bc168a6cSRobert Watson.Fa auditinfo . 49bc168a6cSRobert WatsonThe 50ca0716f5SRobert Watson.Fn getaudit_addr 51bc168a6cSRobert Watsonsystem call 52ca0716f5SRobert Watsonretrieves extended state via 53bc168a6cSRobert Watson.Fa auditinfo_addr 54ca0716f5SRobert Watsonand 55bc168a6cSRobert Watson.Fa length . 56ca0716f5SRobert Watson.Pp 57bc168a6cSRobert WatsonThese system calls require an appropriate privilege to complete. 58ca0716f5SRobert Watson.Sh RETURN VALUES 59bc168a6cSRobert Watson.Rv -std getaudit getaudit_addr 60ca0716f5SRobert Watson.Sh SEE ALSO 61ca0716f5SRobert Watson.Xr audit 2 , 62ca0716f5SRobert Watson.Xr auditon 2 , 63ca0716f5SRobert Watson.Xr getauid 2 , 64ca0716f5SRobert Watson.Xr setaudit 2 , 65bc168a6cSRobert Watson.Xr setauid 2 , 66ca0716f5SRobert Watson.Xr libbsm 3 67bc168a6cSRobert Watson.Sh HISTORY 68bc168a6cSRobert WatsonThe OpenBSM implementation was created by McAfee Research, the security 69bc168a6cSRobert Watsondivision of McAfee Inc., under contract to Apple Computer Inc.\& in 2004. 70bc168a6cSRobert WatsonIt was subsequently adopted by the TrustedBSD Project as the foundation for 71bc168a6cSRobert Watsonthe OpenBSM distribution. 72ca0716f5SRobert Watson.Sh AUTHORS 73bc168a6cSRobert Watson.An -nosplit 74ca0716f5SRobert WatsonThis software was created by McAfee Research, the security research division 75ca0716f5SRobert Watsonof McAfee, Inc., under contract to Apple Computer Inc. 76bc168a6cSRobert WatsonAdditional authors include 77bc168a6cSRobert Watson.An Wayne Salamon , 78bc168a6cSRobert Watson.An Robert Watson , 79bc168a6cSRobert Watsonand SPARTA Inc. 80ca0716f5SRobert Watson.Pp 81ca0716f5SRobert WatsonThe Basic Security Module (BSM) interface to audit records and audit event 82ca0716f5SRobert Watsonstream format were defined by Sun Microsystems. 83ca0716f5SRobert Watson.Pp 84ca0716f5SRobert WatsonThis manual page was written by 85ca0716f5SRobert Watson.An Robert Watson Aq rwatson@FreeBSD.org . 86