xref: /freebsd/contrib/openbsm/bin/auditd/auditd.8 (revision 2b743a9e9ddc6736208dc8ca1ce06ce64ad20a19)
1.\" Copyright (c) 2004 Apple Computer, Inc.
2.\" All rights reserved.
3.\"
4.\" @APPLE_BSD_LICENSE_HEADER_START@
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\"
10.\" 1.  Redistributions of source code must retain the above copyright
11.\"     notice, this list of conditions and the following disclaimer.
12.\" 2.  Redistributions in binary form must reproduce the above copyright
13.\"     notice, this list of conditions and the following disclaimer in the
14.\"     documentation and/or other materials provided with the distribution.
15.\" 3.  Neither the name of Apple Computer, Inc. ("Apple") nor the names of
16.\"     its contributors may be used to endorse or promote products derived
17.\"     from this software without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
20.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
21.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22.\" DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
23.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
24.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
26.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
28.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29.\"
30.\" @APPLE_BSD_LICENSE_HEADER_END@
31.\"
32.\" $P4: //depot/projects/trustedbsd/openbsm/bin/auditd/auditd.8#9 $
33.\"
34.Dd January 24, 2004
35.Dt AUDITD 8
36.Os
37.Sh NAME
38.Nm auditd
39.Nd audit log management daemon
40.Sh SYNOPSIS
41.Nm auditd
42.Op Fl dhs
43.Sh DESCRIPTION
44The
45.Nm
46daemon responds to requests from the audit(1) utility and notifications
47from the kernel.  It manages the resulting audit log files and specified
48log file locations.
49.Pp
50The options are as follows:
51.Bl -tag -width Ds
52.It Fl d
53Starts the daemon in debug mode - it will not daemonize.
54.El
55.Pp
56The historical
57.Fl h
58and
59.Fl s
60flags are now configured using
61.Xr audit_control 5
62policy flags
63.Dv ahlt
64and
65.Dv cnt ,
66and are no longer available as arguments to
67.Xr auditd 8 .
68.Sh NOTE
69.Pp
70To assure uninterrupted audit support, the
71.Nm auditd
72daemon should not be started and stopped manually.
73Instead, the
74.Xr audit 8
75command
76should be used to inform the daemon to change state/configuration after altering
77the
78.Pa audit_control
79file.
80.Pp
81.\" Sending a SIGHUP to a running
82.\" .Nm auditd
83.\" daemon will force it to exit.
84Sending a SIGTERM to a running
85.Nm auditd
86daemon will force it to exit.
87.Sh FILES
88.Bl -tag -width "/var/audit" -compact
89.It Pa /var/audit
90Default directory for storing audit log files.
91.El
92.Sh SEE ALSO
93.Xr audit 8
94.Sh AUTHORS
95This software was created by McAfee Research, the security research division
96of McAfee, Inc., under contract to Apple Computer Inc.
97Additional authors include Wayne Salamon, Robert Watson, and SPARTA Inc.
98.Pp
99The Basic Security Module (BSM) interface to audit records and audit event
100stream format were defined by Sun Microsystems.
101.Sh HISTORY
102The OpenBSM implementation was created by McAfee Research, the security
103division of McAfee Inc., under contract to Apple Computer Inc. in 2004.
104It was subsequently adopted by the TrustedBSD Project as the foundation for
105the OpenBSM distribution.
106