Back to main site | Back to man page index

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 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  spec‐
       ify  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

       -e, --event
              Report about events

       -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.

       --input-logs
              Use the log file location from auditd.conf as input for analysis. This is needed if you are using aure‐
              port from a cron job.

       -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  seg‐
              faulting.

       --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, today, yesterday, this-week, week-ago, this-month, this-year.
              Today means starting now. 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 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
              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


SEE ALSO
       ausearch(8), auditd(8).



Red Hat                                               July 2016                                          AUREPORT:(8)