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)