From 819a9ab222da57d6064a7cc9ad3e2c9ff0ef2f82 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Wed, 9 Jul 2014 16:04:58 +0200 Subject: Imported Upstream version 0.6 --- downtimed.8 | 147 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 147 insertions(+) create mode 100644 downtimed.8 (limited to 'downtimed.8') diff --git a/downtimed.8 b/downtimed.8 new file mode 100644 index 0000000..032acda --- /dev/null +++ b/downtimed.8 @@ -0,0 +1,147 @@ +.\"- +.\" 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 DOWNTIMED 8 "2013-07-27" "version 0.6" +.SH NAME +downtimed \- system downtime monitoring and reporting daemon +.SH SYNOPSIS +.B downtimed +.RB [\| \-D \|] +.RB [\| \-d +.IR datadir \|] +.RB [\| \-f +.IR timefmt \|] +.RB [\| \-l +.IR log \|] +.RB [\| \-p +.IR pidfile \|] +.RB [\| \-S \|] +.RB [\| \-s +.IR sleep \|] +.br +.B downtimed +.B \-v +.SH DESCRIPTION +The +.B downtimed +daemon waits in the background, frequently updating a time stamp file +on the disk. If the daemon is killed with a signal associated with a +normal system shutdown procedure, it will record the shutdown time on +the disk. +.PP +When the daemon is restarted during the next boot process, +it will report how long the system was down and whether it was properly +shut down or crashed. The downtime report is output to the system log +or to a specified log file. Also a record is appended to the downtime +database. +.SH OPTIONS +.TP +.B \-D +Do not create nor update the downtime database. +.TP +.B \-d \fIdatadir\fR +The directory where the time stamp files as well as the downtime database +are located. The default directory is determined at compile time. +.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 \-l \fIlog\fR +Logging destination. If the argument contains a slash (/) it is interpreted +to be a path name to a log file, which will be created if it does not exist +already. Otherwise it is interpreted as a syslog facility name. The +default logging destination is "daemon" which means that the messages +are written to syslog with the daemon facility code. +.TP +.B \-p \fIpidfile\fR +The location of the file which keeps track of the process ID of the +running daemon process. The system default location is determined at +compile time. +.TP +.B \-S +Normally +.BR fsync (2) +is performed after each update of the time stamp. This option disables the +.BR fsync (2). +It reduces the load on the disk system but makes the downtime +measurement less reliable. +.TP +.B \-s \fIsleep\fR +Defines how long to sleep between each update of the on\-disk time +stamp file. More frequent updates result in more accurate downtime +reporting in the case of a system crash. Less frequent updates decrease +the amount of disk writes performed. The default is to sleep 15 seconds +between each update. If you are using a flash memory based SSD or other +disk which has limited amount of write cycles per block, it might be a +good idea to set the sleep time to a higher value to prolong the +lifetime of the storage device. +.TP +.B \-v +Display the program version number, copyright message and the default +settings. +.SH SIGNALS +.TP +.B SIGHUP +Close and re-open the output log. Use in case you want to rotate +the log file. +.TP +.B SIGTERM and SIGINT +Terminate gracefully. These signals signify that a graceful system +shutdown is in process. +.SH EXIT STATUS +The daemon exits 0 on success, and >0 if an error occurs. +.SH SEE ALSO +.\".BR downtime (1), +.BR downtimes (1), +.BR syslog.conf (5), +.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. +.PP +Finding out the system startup time is very operating system specific. +If the program does not have specific code to support your operating +system, it assumes that the system started when the daemon started. +.PP +Reporting is inaccurate if the system clock changes during system +downtime or startup process. Daylight saving time changes have no +effect as all calculations are done using UTC. +.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 -- cgit v1.2.3