xref: /freebsd/usr.sbin/setaudit/setaudit.8 (revision dcb0790bad434ace7cf53259e7a9bcefbef1c69b)
1*dcb0790bSMark Johnston.\" Copyright (c) 2018-2022 Mateusz Piotrowski <0mp@FreeBSD.org>
2*dcb0790bSMark Johnston.\"
3*dcb0790bSMark Johnston.\" Redistribution and use in source and binary forms, with or without
4*dcb0790bSMark Johnston.\" modification, are permitted provided that the following conditions
5*dcb0790bSMark Johnston.\" are met:
6*dcb0790bSMark Johnston.\" 1. Redistributions of source code must retain the above copyright
7*dcb0790bSMark Johnston.\"    notice, this list of conditions and the following disclaimer.
8*dcb0790bSMark Johnston.\" 2. Redistributions in binary form must reproduce the above copyright
9*dcb0790bSMark Johnston.\"    notice, this list of conditions and the following disclaimer in the
10*dcb0790bSMark Johnston.\"    documentation and/or other materials provided with the distribution.
11*dcb0790bSMark Johnston.\"
12*dcb0790bSMark Johnston.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
13*dcb0790bSMark Johnston.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
14*dcb0790bSMark Johnston.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15*dcb0790bSMark Johnston.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
16*dcb0790bSMark Johnston.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
17*dcb0790bSMark Johnston.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
18*dcb0790bSMark Johnston.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
19*dcb0790bSMark Johnston.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20*dcb0790bSMark Johnston.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
21*dcb0790bSMark Johnston.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
22*dcb0790bSMark Johnston.\" SUCH DAMAGE.
23*dcb0790bSMark Johnston.Dd March 21, 2018
24*dcb0790bSMark Johnston.Dt SETAUDIT 8
25*dcb0790bSMark Johnston.Os
26*dcb0790bSMark Johnston.Sh NAME
27*dcb0790bSMark Johnston.Nm setaudit
28*dcb0790bSMark Johnston.Nd "specify audit configurations on a process"
29*dcb0790bSMark Johnston.Sh SYNOPSIS
30*dcb0790bSMark Johnston.Nm
31*dcb0790bSMark Johnston.Op Fl 46
32*dcb0790bSMark Johnston.Op Fl a Ar auid
33*dcb0790bSMark Johnston.Op Fl m Ar mask
34*dcb0790bSMark Johnston.Op Fl s Ar source
35*dcb0790bSMark Johnston.Op Fl p Ar port
36*dcb0790bSMark Johnston.Ar command ...
37*dcb0790bSMark Johnston.Sh DESCRIPTION
38*dcb0790bSMark Johnston.Nm
39*dcb0790bSMark Johnstonis a tool to specify audit configurations on a process.
40*dcb0790bSMark Johnston.Pp
41*dcb0790bSMark JohnstonThe following options are available:
42*dcb0790bSMark Johnston.Bl -tag -width ".Fl d Ar argument"
43*dcb0790bSMark Johnston.It Fl 4
44*dcb0790bSMark JohnstonUse IPv4.
45*dcb0790bSMark Johnston.It Fl 6
46*dcb0790bSMark JohnstonUse IPv6.
47*dcb0790bSMark Johnston.It Fl a Ar auid
48*dcb0790bSMark JohnstonAudit user ID.
49*dcb0790bSMark Johnston.It Fl m Ar mask
50*dcb0790bSMark JohnstonString representation of an audit mask.
51*dcb0790bSMark Johnston.It Fl s Ar source
52*dcb0790bSMark JohnstonIPv4 or IPv6 address of a Terminal ID.
53*dcb0790bSMark Johnston.It Fl p Ar port
54*dcb0790bSMark JohnstonPort of a Terminal ID.
55*dcb0790bSMark Johnston.Xr
56*dcb0790bSMark Johnston.El
57*dcb0790bSMark Johnston.Sh EXAMPLES
58*dcb0790bSMark JohnstonEnable all exe related audit events performed by
59*dcb0790bSMark Johnston.Ar command
60*dcb0790bSMark Johnstonand its child processes:
61*dcb0790bSMark Johnston.Pp
62*dcb0790bSMark Johnston.Dl # setaudit -m ex command
63*dcb0790bSMark Johnston.Sh SEE ALSO
64*dcb0790bSMark Johnston.Xr getaudit 2 ,
65*dcb0790bSMark Johnston.Xr setaudit 2 ,
66*dcb0790bSMark Johnston.Xr au_mask 3 ,
67*dcb0790bSMark Johnston.Xr libbsm 3 ,
68*dcb0790bSMark Johnston.Xr audit_user 5 ,
69*dcb0790bSMark Johnston.Xr audit 8
70*dcb0790bSMark Johnston.Sh HISTORY
71*dcb0790bSMark JohnstonThe
72*dcb0790bSMark Johnston.Nm
73*dcb0790bSMark Johnstonutility was written by
74*dcb0790bSMark Johnston.An Christian S.J. Peron Aq Mt csjp@FreeBSD.org .
75*dcb0790bSMark Johnston.Sh AUTHORS
76*dcb0790bSMark JohnstonThis
77*dcb0790bSMark Johnstonmanual page was written by
78*dcb0790bSMark Johnston.An Mateusz Piotrowski Aq Mt 0mp@FreeBSD.org .
79