.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]
.I START
.I END
.I [COMMENT]
.SH SYNOPSIS
.B ndt
webhost now 10pm 'Upgrading to latest OS release'
.PP
.B ndt
webhost/HTTP now 10pm 'Upgrading Apache HTTPD'
.PP
for hostname in ns{1..3} ; do
.br
.B
    ndt
"$hostname" 'sunday 3:00am' 'sunday 4:00am' 'Outage for entire DNS system for upgrades'
.br
done
.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 a particular host or service. 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-force-check(1)
.SH AUTHOR
Tom Ryder <tom@sanctum.geek.nz>
.PP