xref: /freebsd/contrib/openbsm/man/auditctl.2 (revision b626f5a73a48f44a31a200291b141e1da408a2ff)
1ca0716f5SRobert Watson.\"-
2ca0716f5SRobert Watson.\" Copyright (c) 2005-2006 Robert N. M. Watson
352267f74SRobert Watson.\" Copyright (c) 2008 Apple Inc.
4ca0716f5SRobert Watson.\" All rights reserved.
5ca0716f5SRobert Watson.\"
6ca0716f5SRobert Watson.\" Redistribution and use in source and binary forms, with or without
7ca0716f5SRobert Watson.\" modification, are permitted provided that the following conditions
8ca0716f5SRobert Watson.\" are met:
9ca0716f5SRobert Watson.\" 1. Redistributions of source code must retain the above copyright
10ca0716f5SRobert Watson.\"    notice, this list of conditions and the following disclaimer.
11ca0716f5SRobert Watson.\" 2. Redistributions in binary form must reproduce the above copyright
12ca0716f5SRobert Watson.\"    notice, this list of conditions and the following disclaimer in the
13ca0716f5SRobert Watson.\"    documentation and/or other materials provided with the distribution.
14ca0716f5SRobert Watson.\"
15ca0716f5SRobert Watson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16ca0716f5SRobert Watson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17ca0716f5SRobert Watson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18ca0716f5SRobert Watson.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19ca0716f5SRobert Watson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20ca0716f5SRobert Watson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21ca0716f5SRobert Watson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22ca0716f5SRobert Watson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23ca0716f5SRobert Watson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24ca0716f5SRobert Watson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25ca0716f5SRobert Watson.\" SUCH DAMAGE.
26ca0716f5SRobert Watson.\"
27ca0716f5SRobert Watson.Dd April 19, 2005
28ca0716f5SRobert Watson.Dt AUDITCTL 2
29ca0716f5SRobert Watson.Os
30ca0716f5SRobert Watson.Sh NAME
31ca0716f5SRobert Watson.Nm auditctl
32bc168a6cSRobert Watson.Nd "configure system audit parameters"
33ca0716f5SRobert Watson.Sh SYNOPSIS
34ca0716f5SRobert Watson.In bsm/audit.h
35ca0716f5SRobert Watson.Ft int
36506764c6SRobert Watson.Fn auditctl "const char *path"
37ca0716f5SRobert Watson.Sh DESCRIPTION
38ca0716f5SRobert WatsonThe
39ca0716f5SRobert Watson.Fn auditctl
40ca0716f5SRobert Watsonsystem call directs the kernel to open a new audit trail log file.
41bc168a6cSRobert WatsonIt requires an appropriate privilege.
4252267f74SRobert WatsonThe
43ca0716f5SRobert Watson.Fn auditctl
4452267f74SRobert Watsonsystem call
45ca0716f5SRobert Watsonopens new files, but
46bc168a6cSRobert Watson.Xr auditon 2
47ca0716f5SRobert Watsonis used to disable the audit log.
48ca0716f5SRobert Watson.Sh RETURN VALUES
49bc168a6cSRobert Watson.Rv -std
5052267f74SRobert Watson.Sh ERRORS
5152267f74SRobert WatsonThe
5252267f74SRobert Watson.Fn auditctl
5352267f74SRobert Watsonsystem call will fail if:
5452267f74SRobert Watson.Bl -tag -width Er
5552267f74SRobert Watson.It Bq Er EINVAL
5652267f74SRobert WatsonThe path is invalid.
5752267f74SRobert Watson.It Bq Er EPERM
5852267f74SRobert WatsonThe process does not have sufficient permission to complete the
5952267f74SRobert Watsonoperation.
6052267f74SRobert Watson.El
61ca0716f5SRobert Watson.Sh SEE ALSO
62bc168a6cSRobert Watson.Xr auditon 2 ,
63ca0716f5SRobert Watson.Xr libbsm 3 ,
64ca0716f5SRobert Watson.Xr auditd 8
65bc168a6cSRobert Watson.Sh HISTORY
66bc168a6cSRobert WatsonThe OpenBSM implementation was created by McAfee Research, the security
67bc168a6cSRobert Watsondivision of McAfee Inc., under contract to Apple Computer Inc.\& in 2004.
68bc168a6cSRobert WatsonIt was subsequently adopted by the TrustedBSD Project as the foundation for
69bc168a6cSRobert Watsonthe OpenBSM distribution.
70ca0716f5SRobert Watson.Sh AUTHORS
71bc168a6cSRobert Watson.An -nosplit
72ca0716f5SRobert WatsonThis software was created by McAfee Research, the security research division
73ca0716f5SRobert Watsonof McAfee, Inc., under contract to Apple Computer Inc.
74bc168a6cSRobert WatsonAdditional authors include
75bc168a6cSRobert Watson.An Wayne Salamon ,
76bc168a6cSRobert Watson.An Robert Watson ,
77bc168a6cSRobert Watsonand SPARTA Inc.
78ca0716f5SRobert Watson.Pp
79ca0716f5SRobert WatsonThe Basic Security Module (BSM) interface to audit records and audit event
80ca0716f5SRobert Watsonstream format were defined by Sun Microsystems.
81ca0716f5SRobert Watson.Pp
82ca0716f5SRobert WatsonThis manual page was written by
83ca0716f5SRobert Watson.An Robert Watson Aq rwatson@FreeBSD.org .
84