summaryrefslogtreecommitdiffstats
path: root/man/bcfg2-reports.8
diff options
context:
space:
mode:
authorFabian Affolter <fabian@bernewireless.net>2010-10-06 13:04:32 +0000
committerSol Jerome <sol.jerome@gmail.com>2010-10-07 17:14:52 -0500
commit69df7c9907fd99aa10f8e975a17b0114a2bfa33f (patch)
tree11544c50462b92c9f8ef56149ac1a61c694d4636 /man/bcfg2-reports.8
parentf9916614cf3cdc4316ec48c908dfea87f8ba8563 (diff)
downloadbcfg2-69df7c9907fd99aa10f8e975a17b0114a2bfa33f.tar.gz
bcfg2-69df7c9907fd99aa10f8e975a17b0114a2bfa33f.tar.bz2
bcfg2-69df7c9907fd99aa10f8e975a17b0114a2bfa33f.zip
Draft of the bcfg2-reports man page. Just filled with help output from bcfg2-reports. It still needs an update according to ticket #943 .
git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@6089 ce84e21b-d406-0410-9b95-82705330c041
Diffstat (limited to 'man/bcfg2-reports.8')
-rw-r--r--man/bcfg2-reports.880
1 files changed, 80 insertions, 0 deletions
diff --git a/man/bcfg2-reports.8 b/man/bcfg2-reports.8
new file mode 100644
index 000000000..eb9358511
--- /dev/null
+++ b/man/bcfg2-reports.8
@@ -0,0 +1,80 @@
+.TH "bcfg2-reports" 8
+.SH NAME
+bcfg2-reports \- Query reporting system for client status
+.SH SYNOPSIS
+.B bcfg2-reports
+.I [-v]
+.SH DESCRIPTION
+.PP
+.B bcfg2-reports
+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/Server/Reports/reports/models.py.
+.SH OPTIONS
+.PP
+.B "\-a"
+.RS
+Shows all hosts, including expired hosts.
+.RE
+.B "\-b NAME"
+.RS
+Single-host mode \- shows bad entries from the current interaction of
+NAME
+.RE
+.B "-c\"
+.RS
+Shows only clean hosts.
+.RE
+.B "\-d"
+.RS
+Shows only dirty hosts.
+.RE
+.B "\-e NAME"
+.RS
+Single host mode \- shows extra entries from the current interaction
+of NAME
+.RE
+.B "\-h"
+.RS
+Shows help and usage info about bcfg2-reports.
+.RE
+.B "\-s NAME"
+.RS
+Single host mode \- shows bad and extra entries from the current
+interaction of NAME.
+.RE
+.B "\-x NAME"
+.RS
+Toggles expired/unexpired state of NAME.
+.RE
+.B "\-\-badentry=KIND,NAME"
+.RS
+Shows only hosts whose current interaction has bad entries in of KIND
+kind and NAME name; if a single argument ARG1 is given, then KIND,NAME
+pairs will be read from a file of name ARG1.
+.RE
+.B "\-\-extraentry=KIND,NAME "
+.RS
+Shows only hosts whose current interaction has extra entries in of KIND
+kind and NAME name; if a single argument ARG1 is given, then KIND,NAME
+pairs will be read from a file of name ARG1.
+.RE
+.B "\-\-fields=ARG1,ARG2,..."
+.RS
+Only displays the fields ARG1,ARG2,... (name, time, state)
+.RE
+.B "\-\-sort=ARG1,ARG2,..."
+.RS
+Sorts output on ARG1,ARG2,... (name, time, state)
+.RE
+.B "\-\-stale"
+.RS
+Shows hosts which haven't run in the last 24 hours
+.RE
+.SH "SEE ALSO"
+.BR bcfg2(1),
+.BR bcfg2-server(8)
+.SH "BUGS"
+None currently known