AUREPORT(8) System Administration Utilities AUREPORT(8)
NAME
aureport - a tool that produces summary reports of audit daemon logs
SYNOPSIS
aureport [options]
DESCRIPTION
aureport is a tool that produces summary reports of the audit system
logs. The aureport utility can also take input from stdin as long as the
input is the raw log data. The reports have a column label at the top to
help with interpretation of the various fields. Except for the main sum-
mary report, all reports have the audit event number. You can subse-
quently lookup the full event with ausearch -a event number. You may
need to specify start & stop times if you get multiple hits. The reports
produced by aureport can be used as building blocks for more complicated
analysis.
OPTIONS
-au, --auth
Report about authentication attempts
-a, --avc
Report about avc messages
--comm Report about commands run
-c, --config
Report about config changes
-cr, --crypto
Report about crypto events
--debug
Write malformed events that are skipped to stderr.
--eoe-timeout seconds
Set the end of event parsing timeout. See end_of_event_timeout in
auditd.conf(5) for details. Note that setting this value will
override any configured value found in /etc/auditd/auditd.conf.
-e, --event
Report about events
--escape option
This option determines if the output is escaped to make the con-
tent safer for certain uses. The options are raw , tty , shell ,
and shell_quote. Each mode includes the characters of the preced-
ing mode and escapes more characters. That is to say shell in-
cludes all characters escaped by tty and adds more. tty is the
default.
-f, --file
Report about files and af_unix sockets
--failed
Only select failed events for processing in the reports. The de-
fault is both success and failed events.
-h, --host
Report about hosts
--help Print brief command summary
-i, --interpret
Interpret numeric entities into text. For example, uid is con-
verted to account name. The conversion is done using the current
resources of the machine where the search is being run. If you
have renamed the accounts, or don't have the same accounts on
your machine, you could get misleading results.
-if, --input file | directory
Use the given file or directory instead of the logs. This is to
aid analysis where the logs have been moved to another machine or
only part of a log was saved. The path length is limited to 4064
bytes.
--input-logs
Use the log file location from auditd.conf as input for analysis.
This is needed if you are using aureport from a cron job.
--integrity
Report about integrity events
-k, --key
Report about audit rule keys
-l, --login
Report about logins
-m, --mods
Report about account modifications
-ma, --mac
Report about Mandatory Access Control (MAC) events
-n, --anomaly
Report about anomaly events. These events include NIC going into
promiscuous mode and programs segfaulting.
--node node-name
Only select events originating from node name string for process-
ing in the reports. The default is to include all nodes. Multiple
nodes are allowed.
-nc, --no-config
Do not include the CONFIG_CHANGE event. This is particularly use-
ful for the key report because audit rules have key labels in
many cases. Using this option gets rid of these false positives.
-p, --pid
Report about processes
-r, --response
Report about responses to anomaly events
-s, --syscall
Report about syscalls
--success
Only select successful events for processing in the reports. The
default is both success and failed events.
--summary
Run the summary report that gives a total of the elements of the
main report. Not all reports have a summary.
-t, --log
This option will output a report of the start and end times for
each log.
--tty Report about tty keystrokes
-te, --end [end-date] [end-time]
Search for events with time stamps equal to or before the given
end time. The format of end time depends on your locale. If the
date is omitted, today is assumed. If the time is omitted, now is
assumed. Use 24 hour clock time rather than AM or PM to specify
time. An example date using the en_US.utf8 locale is 09/03/2009.
An example of time is 18:00:00. The date format accepted is in-
fluenced by the LC_TIME environmental variable.
You may also use the word: now, recent, this-hour, boot, today,
yesterday, this-week, week-ago, this-month, this-year. Now means
starting now. Recent is 10 minutes ago. Boot means the time of
day to the second when the system last booted. Today means now.
Yesterday is 1 second after midnight the previous day. This-week
means starting 1 second after midnight on day 0 of the week de-
termined by your locale (see localtime). Week-ago means 1 second
after midnight exactly 7 days ago. This-month means 1 second af-
ter midnight on day 1 of the month. This-year means the 1 second
after midnight on the first day of the first month.
-tm, --terminal
Report about terminals
-ts, --start [start-date] [start-time]
Search for events with time stamps equal to or after the given
end time. The format of end time depends on your locale. If the
date is omitted, today is assumed. If the time is omitted, mid-
night is assumed. Use 24 hour clock time rather than AM or PM to
specify time. An example date using the en_US.utf8 locale is
09/03/2009. An example of time is 18:00:00. The date format ac-
cepted is influenced by the LC_TIME environmental variable.
You may also use the word: now, recent, this-hour, boot, today,
yesterday, this-week, week-ago, this-month, this-year. Boot means
the time of day to the second when the system last booted. Today
means starting at 1 second after midnight. Recent is 10 minutes
ago. Yesterday is 1 second after midnight the previous day.
This-week means starting 1 second after midnight on day 0 of the
week determined by your locale (see localtime). Week-ago means
starting 1 second after midnight exactly 7 days ago. This-month
means 1 second after midnight on day 1 of the month. This-year
means the 1 second after midnight on the first day of the first
month.
-u, --user
Report about users
-v, --version
Print the version and exit
--virt Report about Virtualization events
-x, --executable
Report about executables
NOTE
The boot time option is a convenience function and has limitations. The
time it calculates is based on time now minus /proc/uptime. If after
boot the system clock has been adjusted, perhaps by ntp, then the calcu-
lation may be wrong. In that case you'll need to fully specify the time.
You can check the time it would use by running:
date -d "`cut -f1 -d. /proc/uptime` seconds ago"
SEE ALSO
ausearch(8), auditd(8), auditd.conf(5).
Red Hat February 2023 AUREPORT(8)
Generated by dwww version 1.16 on Tue Dec 16 04:50:54 CET 2025.