aureport(top10.html) - phpMan

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  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 pre-
              ceding 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 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  analy-
              sis. 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  pro-
              cessing  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 spec-
              ify  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 sec-
              ond after midnight exactly 7 days ago. This-month means 1 second
              after midnight on day 1 of the month. This-year means the 1 sec-
              ond 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
              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
       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  cal-
       culation  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)