.TH NAGIOS-DOWNTIME 1 "Nagios Downtime" "Nagscripts"
.SH NAME
.B ndt, nagios-downtime
\- Pleasant way to script fixed downtime for a Nagios host or service
.SH USAGE
.B nagios-downtime
-h
.br
.B nagios-downtime
.I (HOSTNAME[/SERVICE][,HOSTNAME[,SERVICE],...]|-)
.I START
.I END
.I [COMMENT]
.SH SYNOPSIS
ndt webhost now 10pm 'Upgrading to latest Ubuntu release'
.PP
ndt webhost/HTTP now 10pm 'Upgrading Apache HTTPD'
.br
ndt authns1,authns2,recdns1,recdns2 'sunday 3:00am' 'sunday 4:00am' 'Outage for entire DNS system for upgrades'
.br
nds abc-example | ndt - 9am 10am 'Power problems at abc-example'
.SH DESCRIPTION
.B nagios-downtime
will format and attempt to write a Nagios command to the Nagios commands file
which it expects to find at /usr/local/nagios/var/rw/nagios.cmd to schedule
downtime for given hosts or services.
.PP
Multiple hosts or services can be separated by commas, and the special value -
allows hosts or services to be read from stdin.
.PP
The two date fields
.I START
and
.I END
may be given in any form understood by
.I date(1)
with the
.I --date
option.
.PP
The user's current login name will be used as the author field for the
downtime, taking into account any use of
.I sudo(8)
changes. Note that the
.I COMMENT
parameter is optional.
.SH SEE ALSO
nagios-acknowledge(1), nagios-data-search(1), nagios-descendent-list(1),
nagios-force-check(1), nagios-notification-switch(1), nagios-problem-list(1),
nagios-unhandled-list(1)
.SH AUTHOR
Tom Ryder <tom@sanctum.geek.nz>