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]
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.
| -h | Print usage information. |
The following are various modes available for bcfg2-reports.
| -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. |
| -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. |
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. | |
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. |
bcfg2(1), bcfg2-server(8)