xref: /freebsd/contrib/openbsm/man/audit_warn.5 (revision b626f5a73a48f44a31a200291b141e1da408a2ff)
152267f74SRobert Watson.\" Copyright (c) 2004 Apple Inc.
2ca0716f5SRobert Watson.\" All rights reserved.
3ca0716f5SRobert Watson.\"
4ca0716f5SRobert Watson.\" Redistribution and use in source and binary forms, with or without
5ca0716f5SRobert Watson.\" modification, are permitted provided that the following conditions
6ca0716f5SRobert Watson.\" are met:
7ca0716f5SRobert Watson.\" 1.  Redistributions of source code must retain the above copyright
8ca0716f5SRobert Watson.\"     notice, this list of conditions and the following disclaimer.
9ca0716f5SRobert Watson.\" 2.  Redistributions in binary form must reproduce the above copyright
10ca0716f5SRobert Watson.\"     notice, this list of conditions and the following disclaimer in the
11ca0716f5SRobert Watson.\"     documentation and/or other materials provided with the distribution.
1252267f74SRobert Watson.\" 3.  Neither the name of Apple Inc. ("Apple") nor the names of
13ca0716f5SRobert Watson.\"     its contributors may be used to endorse or promote products derived
14ca0716f5SRobert Watson.\"     from this software without specific prior written permission.
15ca0716f5SRobert Watson.\"
16ca0716f5SRobert Watson.\" THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND
17ca0716f5SRobert Watson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18ca0716f5SRobert Watson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19ca0716f5SRobert Watson.\" ARE DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR
20ca0716f5SRobert Watson.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21ca0716f5SRobert Watson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22ca0716f5SRobert Watson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23ca0716f5SRobert Watson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
24ca0716f5SRobert Watson.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
25ca0716f5SRobert Watson.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26ca0716f5SRobert Watson.\" POSSIBILITY OF SUCH DAMAGE.
27ca0716f5SRobert Watson.\"
2823bf6e20SRobert Watson.Dd March 17, 2004
29ca0716f5SRobert Watson.Dt AUDIT_WARN 5
30ca0716f5SRobert Watson.Os
31ca0716f5SRobert Watson.Sh NAME
32ca0716f5SRobert Watson.Nm audit_warn
33ca0716f5SRobert Watson.Nd "alert when audit daemon issues warnings"
34ca0716f5SRobert Watson.Sh DESCRIPTION
35bc168a6cSRobert WatsonThe
36ca0716f5SRobert Watson.Nm
37bc168a6cSRobert Watsonscript
38ca0716f5SRobert Watsonruns when
39ca0716f5SRobert Watson.Xr auditd 8
40ca0716f5SRobert Watsongenerates warning messages.
41ca0716f5SRobert Watson.Pp
42ca0716f5SRobert WatsonThe default
43ca0716f5SRobert Watson.Nm
44ca0716f5SRobert Watsonis a script whose first parameter is the type of warning; the script
45ca0716f5SRobert Watsonappends its arguments to
46ca0716f5SRobert Watson.Pa /etc/security/audit_messages .
47ca0716f5SRobert WatsonAdministrators may replace this script: a more comprehensive one would take
48ca0716f5SRobert Watsondifferent actions based on the type of warning.
49ca0716f5SRobert WatsonFor example, a low-space warning
50ca0716f5SRobert Watsoncould result in an email message being sent to the administrator.
51ca0716f5SRobert Watson.Sh FILES
52bc168a6cSRobert Watson.Bl -tag -width ".Pa /etc/security/audit_messages" -compact
53ca0716f5SRobert Watson.It Pa /etc/security/audit_warn
54ca0716f5SRobert Watson.It Pa /etc/security/audit_messages
55ca0716f5SRobert Watson.El
56ca0716f5SRobert Watson.Sh SEE ALSO
57bc168a6cSRobert Watson.Xr audit 4 ,
58ca0716f5SRobert Watson.Xr auditd 8
59bc168a6cSRobert Watson.Sh HISTORY
60bc168a6cSRobert WatsonThe OpenBSM implementation was created by McAfee Research, the security
61bc168a6cSRobert Watsondivision of McAfee Inc., under contract to Apple Computer Inc.\& in 2004.
62bc168a6cSRobert WatsonIt was subsequently adopted by the TrustedBSD Project as the foundation for
63bc168a6cSRobert Watsonthe OpenBSM distribution.
64ca0716f5SRobert Watson.Sh AUTHORS
65bc168a6cSRobert Watson.An -nosplit
66ca0716f5SRobert WatsonThis software was created by McAfee Research, the security research division
67ca0716f5SRobert Watsonof McAfee, Inc., under contract to Apple Computer Inc.
68bc168a6cSRobert WatsonAdditional authors include
69bc168a6cSRobert Watson.An Wayne Salamon ,
70bc168a6cSRobert Watson.An Robert Watson ,
71bc168a6cSRobert Watsonand SPARTA Inc.
72ca0716f5SRobert Watson.Pp
73ca0716f5SRobert WatsonThe Basic Security Module (BSM) interface to audit records and audit event
74ca0716f5SRobert Watsonstream format were defined by Sun Microsystems.
75