2 .\" Copyright (c) 2005 Robert N. M. Watson
3 .\" Copyright (c) 2008 Apple Inc.
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 .\" $P4: //depot/projects/trustedbsd/openbsm/man/setaudit.2#10 $
35 .Nd "set audit session state"
39 .Fn setaudit "auditinfo_t *auditinfo"
41 .Fn setaudit_addr "auditinfo_addr_t *auditinfo_addr" "u_int length"
46 sets the active audit session state for the current process via the
53 sets extended state via
60 data structure is defined as follows:
65 au_id_t ai_auid; /* Audit user ID */
66 au_mask_t ai_mask; /* Audit masks */
67 au_tid_t ai_termid; /* Terminal ID */
68 au_asid_t ai_asid; /* Audit session ID */
70 typedef struct auditinfo auditinfo_t;
76 variable contains the audit identifier which is recorded in the audit log for
77 each event the process caused.
82 data structure defines the bit mask for auditing successful and failed events
83 out of the predefined list of event classes. It is defined as follows:
88 unsigned int am_success; /* success bits */
89 unsigned int am_failure; /* failure bits */
91 typedef struct au_mask au_mask_t;
98 data structure defines the Terminal ID recorded with every event caused by the
99 process. It is defined as follows:
107 typedef struct au_tid au_tid_t;
114 variable contains the audit session ID which is recorded with every event
115 caused by the process.
122 data structure supports Terminal IDs with larger addresses such as those used
123 in IP version 6. It is defined as follows:
127 struct auditinfo_addr {
128 au_id_t ai_auid; /* Audit user ID. */
129 au_mask_t ai_mask; /* Audit masks. */
130 au_tid_addr_t ai_termid; /* Terminal ID. */
131 au_asid_t ai_asid; /* Audit session ID. */
133 typedef struct auditinfo_addr auditinfo_addr_t;
139 data structure which includes a larger address storage field and an additional
140 field with the type of address stored:
147 u_int32_t at_addr[4];
149 typedef struct au_tid_addr au_tid_addr_t;
153 These system calls require an appropriate privilege to complete.
155 .Rv -std setaudit setaudit_addr
159 A failure occurred while data transferred to or from
162 Illegal argument was passed by a system call.
164 The process does not have sufficient permission to complete
175 The OpenBSM implementation was created by McAfee Research, the security
176 division of McAfee Inc., under contract to Apple Computer Inc.\& in 2004.
177 It was subsequently adopted by the TrustedBSD Project as the foundation for
178 the OpenBSM distribution.
181 This software was created by McAfee Research, the security research division
182 of McAfee, Inc., under contract to Apple Computer Inc.
183 Additional authors include
188 The Basic Security Module (BSM) interface to audit records and audit event
189 stream format were defined by Sun Microsystems.
191 This manual page was written by
192 .An Robert Watson Aq rwatson@FreeBSD.org .