aureport(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTE | SEE ALSO | COLOPHON

AUREPORT(8)          System Administration Utilities         AUREPORT(8)

NAME         top

       aureport - a tool that produces summary reports of audit daemon
       logs

SYNOPSIS         top

       aureport [options]

DESCRIPTION         top

       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 summary report, all reports
       have the audit event number. You can subsequently 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         top

       -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 content safer for certain uses. The options are raw ,
              tty , shell , and shell_quote. Each mode includes the
              characters of the preceding mode and escapes more
              characters. That is to say shell includes 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 default 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 converted 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
              processing 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 useful 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 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. 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 determined by
              your locale (see localtime). Week-ago means 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.

       -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, midnight 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 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         top

       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 calculation 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         top

       ausearch(8), auditd(8), auditd.conf(5).

COLOPHON         top

       This page is part of the audit (Linux Audit) project.
       Information about the project can be found at 
       ⟨http://people.redhat.com/sgrubb/audit/⟩.  If you have a bug
       report for this manual page, send it to linux-audit@redhat.com.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/linux-audit/audit-userspace.git⟩ on
       2023-12-22.  (At that time, the date of the most recent commit
       that was found in the repository was 2023-11-30.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to man-pages@man7.org

Red Hat                       February 2023                  AUREPORT(8)

Pages that refer to this page: auditd.conf(5)auditctl(8)auditd(8)ausearch(8)pam_tty_audit(8)