.TH nagios-check-diskfree 1 "December 2007" "ngtx"
.SH NAME
nagios-check-diskfree \- show free disk space
.SH SYNOPSIS
.B nagios-check-diskfree
\fIMOUNTPOINT \fR
[...]
.SH DESCRIPTION
This program shows the available diskspace in percent for the
filesystem on the given mountpoint.
.br
On any error like i.e. not existing file/dir it prints "9999".
.br
Its primary purpose is the usage as nagios remote plugin with net-snmp.
Just add to snmpd.conf a single line like this:
.IP
extend .1.3.6.1.4.1.2021.80 dfroot /usr/sbin/nagios-check-diskfree / dfcheck_root
.PP
Any additional arguments are silently ignored and can be used as
a mark for i.e. searching a snmpwalk output with less.
.br
This program can also be used to check the existence of files, sockets, pipes
and more because it just uses one stat-call.
.SH "RETURN VALUE"
The return value is 1 on any errors.
On success 0 is returned.
.SH EXAMPLES
nagios-check-diskfree / snmp_check_df_root
.br
nagios-check-diskfree /var/lib/mysql/mysql.sock dfvarmysql
.SH AUTHOR
Frank Bergmann, http://www.tuxad.com