# AUVIRT - a program that shows data related to virtual machines - man(8) - [phpMan]

[_AUVIRT_(8)](https://www.chedong.com/phpMan.php/man/AUVIRT/8/markdown)                          System Administration Utilities                         [_AUVIRT_(8)](https://www.chedong.com/phpMan.php/man/AUVIRT/8/markdown)

## NAME
       auvirt - a program that shows data related to virtual machines


## SYNOPSIS
       **auvirt **[ _OPTIONS_ ]


## DESCRIPTION
       **auvirt  **shows a list of guest sessions found in the audit logs. If a guest is specified, only
       the events related to that guest is considered. To specify a guest, both UUID or VM name  can
       be given.

       For  each  guest session the tool prints a record with the domain name, the user that started
       the guest, the time when the guest was started and the time when the guest was stopped.

       If the option "--all-events" is given a more detailed output is shown.  In  this  mode  other
       records  are shown for guest's stops, resource assignments, AVC and anomaly events. The first
       field indicates the event type and can have the following values: start, stop, res, avc,  and
       anom.

       Resource  assignments have the additional fields: resource type, reason and resource. And AVC
       records have the following additional fields: operation, result, command and target.

       By default, auvirt reads records from the system audit log file. But **--stdin **and  **--file  **op‐
       tions can be specified to change this behavior.


## OPTIONS
### --all-events
              Show records for all virtualization related events.

### --debug
              Print debug messages to stderr.

### -f --file _
              Read records from the given _file_ instead from the system audit log file.

### -h --help
              Print help message and exit.

### --proof
              Add  after  each event a line containing all the identifiers of the audit records used
              to calculate the event. Each identifier consists of unix time, milliseconds and serial
              number.

### --show-uuid
              Add the guest's UUID to each record.

### --stdin
              Read records from the standard input instead from the system audit log file.  This op‐
              tion cannot be specified with **--file**. The audit events must be in the raw format.

### --summary
              Print a summary with information about the events found. The summary contains the con‐
              sidered range of time, the number of guest starts and stops, the  number  of  resource
              assignments,  the  number  of  AVC and anomaly events, and the number of failed opera‐
              tions.

### -te --end 
              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**,  **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**).  **This-month**
              means  1 second after midnight on day 1 of the month. **This-year **means the 1 second af‐
              ter midnight on the first day of the first month.

### -ts --start 
              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  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**, **today**, **yesterday**, **this-week**, **this-month**,
              **this-year**.  **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**).
              **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 --uuid  _
              Only show events related to the guest with the given UUID.

### -v --vm  _
              Only show events related to the guest with the given name.


## EXAMPLES
       To see all the records in this month for a guest

### auvirt --start this-month --vm GuestVmName --all-events


## SEE ALSO
       [**aulast**(8)](https://www.chedong.com/phpMan.php/man/aulast/8/markdown), [**ausearch**(8)](https://www.chedong.com/phpMan.php/man/ausearch/8/markdown), [**aureport**(8)](https://www.chedong.com/phpMan.php/man/aureport/8/markdown).


## AUTHOR
       Marcelo Cerri

IBM Corp                                      Dec 2011                                     [_AUVIRT_(8)](https://www.chedong.com/phpMan.php/man/AUVIRT/8/markdown)