NAME

       bcfg2-reports - Query reporting system for client status

SYNOPSIS

       bcfg2-reports  [-a]  [-b  NAME]  [-c]  [-d]  [-e  NAME] [-h] [-m NAME] [-s NAME] [-x NAME]
       [--badentry=KIND,NAME]          [--extraentry=KIND,NAME]          [--fields=ARG1,ARG2,...]
       [--modifiedentry=KIND,NAME] [--sort=ARG1,ARG2,...] [--stale] [-v]

DESCRIPTION

       bcfg2-reports  allows you to retrieve data from the database about clients, and the states
       of their current interactions. It also allows you to change the expired/unexpired  states.
       The  utility  runs  as  a  standalone  application.  It does, however, use the models from
       src/lib/Bcfg2/Reporting/models.py.

OPTIONS

       -h     Print usage information.

MODES

       The following are various modes available for bcfg2-reports.

   Single-Host Modes
       -b,--bad hostname
              Shows bad entries from the current interaction of hostname.

       -e,--extra hostname
              Shows extra entries from the current interaction of hostname.

       -m,--modified hostname
              Shows modified entries from the current interaction of hostname.

       -s,--show hostname
              Shows bad, modified, and extra entries from the current interaction of hostname.

       -t,--total hostname
              Shows total number of managed and good entries  from  the  current  interaction  of
              hostname.

       -x,--expire hostname
              Toggles expired/unexpired state of hostname.

       -a, --all
              Show all hosts, including expired hosts.

   Host Selection Modes
       -a, --all
              Show all hosts, including expired hosts.

       -c, --clean
              Show only clean hosts.

       -d, --dirty
              Show only dirty hosts.

       --stale
              Show hosts that haven't run in the last 24 hours.

   Entry Modes
       The  following  mode  flags  require either a comma-delimited list of any number of <entry
       type>:<entry name> arguments describing entries, or the --file option.

       --badentry=entrylist
              Shows only hosts whose current interaction has bad entries matching the given entry
              or entries.

       --extraentry=entrylist
              Shows  only  hosts  whose  current interaction has extra entries matching the given
              entry or entries.

       --entrystatus=entry
              Shows the status of the single entry (given by <entry type>:<entry  name>)  on  all
              hosts.

       --modifiedentry=entrylist
              Shows  only hosts whose current interaction has modified entries matching the given
              entry or entries.

   Entry Options
       The following options can be used with the above Entry Modes.

       --fields=fields
              Only display the listed fields.  Takes a comma-delimited list of field names

       --file=file
              Read <entry type>:<entry name> pairs from the specified file instead of the command
              line.

SEE ALSO

       bcfg2(1), bcfg2-server(8)