summaryrefslogtreecommitdiff
path: root/downtimes.1
diff options
context:
space:
mode:
Diffstat (limited to 'downtimes.1')
-rw-r--r--downtimes.1122
1 files changed, 122 insertions, 0 deletions
diff --git a/downtimes.1 b/downtimes.1
new file mode 100644
index 0000000..4d5e87b
--- /dev/null
+++ b/downtimes.1
@@ -0,0 +1,122 @@
+.\"-
+.\" Copyright (c) 2009-2013 EPIPE Communications. All rights reserved.
+.\"
+.\" This software is licensed under the terms and conditions of the FreeBSD
+.\" License which is also known as the Simplified BSD License. You should have
+.\" received a copy of that license along with this software.
+.\"
+.TH DOWNTIMES 1 "2013-07-27" "version 0.6"
+.SH NAME
+downtimes \- display system downtime records made by
+.BR downtimed (8)
+.SH SYNOPSIS
+.B downtimes
+.RB [\| \-d
+.IR downtimedbfile \|]
+.RB [\| \-f
+.IR timefmt \|]
+.RB [\| \-n
+.IR num \|]
+.RB [\| \-s
+.IR sleep \|]
+.RB [\| \-u \|]
+.br
+.\".B downtime
+.\".RB [\| \-d
+.\".IR downtimedbfile \|]
+.\".RB [\| \-f
+.\".IR timefmt \|]
+.\".RB [\| \-n
+.\".IR num \|]
+.\".RB [\| \-s
+.\".IR sleep \|]
+.\".RB [\| \-u \|]
+.\".br
+.B downtimes
+.B \-v
+.\".br
+.\".B downtime
+.\".B \-v
+.SH DESCRIPTION
+The
+.B downtimes
+command displays the contents of the downtime database in human readable
+format. The downtime database is maintained by
+.BR downtimed (8).
+.PP
+.\"The singular form
+.\".B downtime
+.\"displays only details about the last time the system was down where
+.\"as the plural form
+.\".B downtimes
+.\"displays all the records in the database.
+The
+.B \-n
+option can be used to specify the number of downtime
+records to display.
+.SH OPTIONS
+.TP
+.B \-d \fIdowntimedbfile\fR
+Use the specified downtime database file instead of the system default.
+.TP
+.B \-f \fItimefmt\fR
+Specify the time and date format to use when reporting using
+.BR strftime (3)
+syntax. The default is "%F %T".
+.TP
+.B \-n \fInum\fR
+Define how many latest downtime records to output. Default is all.
+.TP
+.B \-s \fIsleep\fR
+Calculate the approximate crash time by specifying what was the
+sleep value of
+.BR downtimed (8).
+.TP
+.B \-u
+Display times in UTC.
+.TP
+.B \-v
+Display the program version number, copyright message and the default
+settings.
+.SH EXIT STATUS
+The program exits 0 on success, and >0 if an error occurs.
+.SH SEE ALSO
+.BR downtimed (8),
+.BR uptime (1),
+.ie !d pdfhref \
+http://dist.epipe.com/downtimed/
+.el \
+.pdfhref W http://dist.epipe.com/downtimed/
+.SH BUGS
+The reporting accuracy in case of a system crash depends on how often the
+time stamp is updated.
+.SH COPYRIGHT
+Copyright \(co 2009\-2013 EPIPE Communications. All rights reserved.
+.PP
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+.PP
+1. Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+.PP
+2. Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+.PP
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.
+.PP
+The views and conclusions contained in the software and documentation are
+those of the authors and should not be interpreted as representing official
+policies, either expressed or implied, of EPIPE Communications.
+.\" eof