DragonFly On-Line Manual Pages

Search: Section:  


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)

Search: Section: