DragonFly On-Line Manual Pages

BCFG2-REPORTS(8)                     Bcfg2                    BCFG2-REPORTS(8)

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)

1.3                             March 18, 2013                BCFG2-REPORTS(8)