SIMPLE SOLUTIONS

BCFG2-REPORTS - reference manual online

Query reporting system for client status.

Chapter
March 18, 2013
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,...] [--modifiedenā€ try=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)
This manual Reference Other manuals
bcfg2-reports(8) referred by bcfg2-report-collector(8)
refer to bcfg2(1) | bcfg2-server(8)