other versions
-
stretch 1.4.0~pre2+git141-g6d40dace6358-1
-
testing 1.4.0~pre2+git141-g6d40dace6358-2
-
unstable 1.4.0~pre2+git141-g6d40dace6358-2
Scroll to navigation
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.