1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
.TH "bcfg2-reports" 8
.SH NAME
bcfg2-reports \- Query reporting system for client status
.SH SYNOPSIS
.B bcfg2-reports
.I [-v]
.SH DESCRIPTION
.PP
\fBbcfg2-reports\fR 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. NAME is the name of the entry.
.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. NAME is the name of the entry.
.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. NAME is the name of the entry.
.RE
.B "\-x NAME"
.RS
Toggles expired/unexpired state of NAME. NAME is the name of the entry.
.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. KIND is the type of entry
(Package, Path, Service, etc). NAME is the name of the entry.
.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. KIND is the type of entry
(Package, Path, Service, etc). NAME is the name of the entry.
.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
|
