1audit(1M)               System Administration Commands               audit(1M)
2
3
4

NAME

6       audit - control the behavior of the audit daemon
7

SYNOPSIS

9       audit -n | -s | -t | -v [path]
10
11

DESCRIPTION

13       The  audit command is the system administrator's interface to maintain‐
14       ing the audit trail. The audit daemon can be notified to read the  con‐
15       tents  of the audit_control(4) file and re-initialize the current audit
16       directory to the first directory listed in the audit_control file or to
17       open  a  new audit file in the current audit directory specified in the
18       audit_control  file,  as  last  read  by  the  audit  daemon.   Reading
19       audit_control also causes the minfree and plugin configuration lines to
20       be re-read and reset within auditd. The audit daemon can also  be  sig‐
21       naled to close the audit trail and disable auditing.
22

OPTIONS

24       -n         Notify  the audit daemon to close the current audit file and
25                  open a new audit file in the current audit directory.
26
27
28       -s         Notify the audit daemon to read the audit control file.  The
29                  audit daemon stores the information internally. If the audit
30                  daemon is not running but audit has been enabled by means of
31                  bsmconv(1M), the audit daemon is started.
32
33
34       -t         Direct  the  audit  daemon  to close the current audit trail
35                  file, disable auditing, and die. Use -s to restart auditing.
36
37
38       -v path    Verify the syntax for the audit control file stored in path.
39                  The  audit  command  displays an approval message or outputs
40                  specific error messages for each error found.
41
42

DIAGNOSTICS

44       The audit command will exit with 0 upon success and a positive  integer
45       upon failure.
46

FILES

48           o      /etc/security/audit_user
49
50           o      /etc/security/audit_control
51

ATTRIBUTES

53       See attributes(5) for descriptions of the following attributes:
54
55
56
57
58       ┌─────────────────────────────┬─────────────────────────────┐
59       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
60       ├─────────────────────────────┼─────────────────────────────┤
61       │Availability                 │SUNWcsu                      │
62       ├─────────────────────────────┼─────────────────────────────┤
63       │Stability                    │Evolving                     │
64       └─────────────────────────────┴─────────────────────────────┘
65

SEE ALSO

67       bsmconv(1M),  praudit(1M),  audit(2),  audit_control(4), audit_user(4),
68       attributes(5)
69
70
71       See the section on Solaris Auditing  in  System  Administration  Guide:
72       Security Services.
73

NOTES

75       The  functionality  described in this man page is available only if the
76       Solaris Auditing feature has been enabled.  See  bsmconv(1M)  for  more
77       information.
78
79
80       The  audit  command  does  not modify a process's preselection mask. It
81       functions are limited to the following:
82
83           o      affects which audit directories  are  used  for  audit  data
84                  storage;
85
86           o      specifies the minimum free space setting;
87
88           o      resets the parameters supplied by means of the plugin direc‐
89                  tive.
90
91
92       For the -s option, audit validates the audit_control  syntax  and  dis‐
93       plays  an  error  message if a syntax error is found. If a syntax error
94       message is displayed, the audit daemon does not re-read  audit_control.
95       Because  audit_control is processed at boot time, the -v option is pro‐
96       vided to allow syntax checking of  an  edited  copy  of  audit_control.
97       Using  -v,  audit  exits with 0 if the syntax is correct; otherwise, it
98       returns a positive integer.
99
100
101       The -v option can be used in any zone, but the -t, -s, and  -n  options
102       are valid only in local zones and, then, only if the perzone audit pol‐
103       icy is set. See auditd(1M) and auditconfig(1M) for per-zone audit  con‐
104       figuration.
105
106
107
108SunOS 5.11                        16 Apr 2008                        audit(1M)
Impressum