|
@@ -1,22 +1,13 @@
|
|
|
'\" t
|
|
|
.\" Title: b10-stats
|
|
|
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
|
|
|
-.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
|
|
|
-.\" Date: Oct 15, 2010
|
|
|
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
|
|
|
+.\" Date: August 11, 2011
|
|
|
.\" Manual: BIND10
|
|
|
.\" Source: BIND10
|
|
|
.\" Language: English
|
|
|
.\"
|
|
|
-.TH "B10\-STATS" "8" "Oct 15, 2010" "BIND10" "BIND10"
|
|
|
-.\" -----------------------------------------------------------------
|
|
|
-.\" * Define some portability stuff
|
|
|
-.\" -----------------------------------------------------------------
|
|
|
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
-.\" http://bugs.debian.org/507673
|
|
|
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
|
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
-.ie \n(.g .ds Aq \(aq
|
|
|
-.el .ds Aq '
|
|
|
+.TH "B10\-STATS" "8" "August 11, 2011" "BIND10" "BIND10"
|
|
|
.\" -----------------------------------------------------------------
|
|
|
.\" * set default formatting
|
|
|
.\" -----------------------------------------------------------------
|
|
@@ -47,7 +38,7 @@ and so on\&. It waits for coming data from other modules, then other modules sen
|
|
|
\fBb10\-stats\fR
|
|
|
invokes "sendstats" command for
|
|
|
\fBbind10\fR
|
|
|
-after its initial starting because it\*(Aqs sure to collect statistics data from
|
|
|
+after its initial starting because it\'s sure to collect statistics data from
|
|
|
\fBbind10\fR\&.
|
|
|
.SH "OPTIONS"
|
|
|
.PP
|
|
@@ -59,6 +50,84 @@ This
|
|
|
\fBb10\-stats\fR
|
|
|
switches to verbose mode\&. It sends verbose messages to STDOUT\&.
|
|
|
.RE
|
|
|
+.SH "CONFIGURATION AND COMMANDS"
|
|
|
+.PP
|
|
|
+The
|
|
|
+\fBb10\-stats\fR
|
|
|
+command does not have any configurable settings\&.
|
|
|
+.PP
|
|
|
+The configuration commands are:
|
|
|
+.PP
|
|
|
+
|
|
|
+
|
|
|
+\fBremove\fR
|
|
|
+removes the named statistics name and data\&.
|
|
|
+.PP
|
|
|
+
|
|
|
+
|
|
|
+\fBreset\fR
|
|
|
+will reset all statistics data to default values except for constant names\&. This may re\-add previously removed statistics names\&.
|
|
|
+.PP
|
|
|
+
|
|
|
+\fBset\fR
|
|
|
+.PP
|
|
|
+
|
|
|
+\fBshow\fR
|
|
|
+will send the statistics data in JSON format\&. By default, it outputs all the statistics data it has collected\&. An optional item name may be specified to receive individual output\&.
|
|
|
+.PP
|
|
|
+
|
|
|
+\fBshutdown\fR
|
|
|
+will shutdown the
|
|
|
+\fBb10\-stats\fR
|
|
|
+process\&. (Note that the
|
|
|
+\fBbind10\fR
|
|
|
+parent may restart it\&.)
|
|
|
+.PP
|
|
|
+
|
|
|
+\fBstatus\fR
|
|
|
+simply indicates that the daemon is running\&.
|
|
|
+.SH "STATISTICS DATA"
|
|
|
+.PP
|
|
|
+The
|
|
|
+\fBb10\-stats\fR
|
|
|
+daemon contains these statistics:
|
|
|
+.PP
|
|
|
+report_time
|
|
|
+.RS 4
|
|
|
+The latest report date and time in ISO 8601 format\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+stats\&.boot_time
|
|
|
+.RS 4
|
|
|
+The date and time when this daemon was started in ISO 8601 format\&. This is a constant which can\'t be reset except by restarting
|
|
|
+\fBb10\-stats\fR\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+stats\&.last_update_time
|
|
|
+.RS 4
|
|
|
+The date and time (in ISO 8601 format) when this daemon last received data from another component\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+stats\&.lname
|
|
|
+.RS 4
|
|
|
+This is the name used for the
|
|
|
+\fBb10\-msgq\fR
|
|
|
+command\-control channel\&. (This is a constant which can\'t be reset except by restarting
|
|
|
+\fBb10\-stats\fR\&.)
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+stats\&.start_time
|
|
|
+.RS 4
|
|
|
+This is the date and time (in ISO 8601 format) when this daemon started collecting data\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+stats\&.timestamp
|
|
|
+.RS 4
|
|
|
+The current date and time represented in seconds since UNIX epoch (1970\-01\-01T0 0:00:00Z) with precision (delimited with a period) up to one hundred thousandth of second\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+See other manual pages for explanations for their statistics that are kept track by
|
|
|
+\fBb10\-stats\fR\&.
|
|
|
.SH "FILES"
|
|
|
.PP
|
|
|
/usr/local/share/bind10\-devel/stats\&.spec
|
|
@@ -82,7 +151,7 @@ BIND 10 Guide\&.
|
|
|
.PP
|
|
|
The
|
|
|
\fBb10\-stats\fR
|
|
|
-daemon was initially designed and implemented by Naoki Kambe of JPRS in Oct 2010\&.
|
|
|
+daemon was initially designed and implemented by Naoki Kambe of JPRS in October 2010\&.
|
|
|
.SH "COPYRIGHT"
|
|
|
.br
|
|
|
Copyright \(co 2010 Internet Systems Consortium, Inc. ("ISC")
|