.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "MUNIN-LIMITS 8"
.TH MUNIN-LIMITS 8 2024-02-28 2.0.75 "Munin Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
munin\-limits \- A program to check for any off\-limit values
.SH SYNOPSIS
.IX Header "SYNOPSIS"
munin-limits [options]
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-\-service <service>\fR" 5
.IX Item "--service <service>"
Limit services to those of <service>. Multiple \-\-service options may be supplied. [unset]
.IP "\fB\-\-host <host>\fR" 5
.IX Item "--host <host>"
Limit hosts to those of <host<gt>. Multiple \-\-host options may be supplied. [unset]
.IP "\fB\-\-contact <contact>\fR" 5
.IX Item "--contact <contact>"
Limit contacts to those of <contact<gt>. Multiple \-\-contact options may be supplied. [unset]
.IP "\fB\-\-config <file>\fR" 5
.IX Item "--config <file>"
Use <file> as configuration file. [/etc/munin/munin.conf]
.IP "\fB\-\-always\-send <severity list>\fR" 5
.IX Item "--always-send <severity list>"
Force sending of messages even if you normally wouldn't.
.Sp
The <severity list> can be a whitespace or comma separated list of the
values "ok", "warning", "critical" or "unknown".
.Sp
This option may be specified several times, to add more values.
.Sp
Use of "\-\-always\-send" overrides the "always_send" value in munin.conf
for configured contacts. See also \-\-force.
.IP \fB\-\-force\fR 5
.IX Item "--force"
Alias for "\-\-always\-send ok,warning,critical,unknown"
.IP \fB\-\-[no]force\-run\-as\-root\fR 5
.IX Item "--[no]force-run-as-root"
Force running as root (stupid and unnecessary). [\-\-noforce\-root]
.IP \fB\-\-help\fR 5
.IX Item "--help"
View help message.
.IP \fB\-\-[no]debug\fR 5
.IX Item "--[no]debug"
If set, view debug messages. [\-\-nodebug]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Munin-limits is a part of the package Munin, which is used in combination
with Munin's node.  Munin is a group of programs to gather data from
Munin's nodes, graph them, create html-pages, and optionally warn Nagios
about any off-limit values.
.PP
Munin-limits checks if any values are above or below the set limits, and saves these notes to a file. This file
is later used by programs like munin-nagios (to warn nagios) and munin-html (to incorporate them in the web
display).
.PP
If a service has fields with "warning" or "critical"\-options (e.g. "load.warning 10"), and the munin-server
configuration file contains the necessary configuration options, munin-limits will check its value.
.SH FILES
.IX Header "FILES"
.Vb 3
\&        /etc/munin/munin.conf
\&        /var/lib/munin/*
\&        /var/run/munin/*
.Ve
.SH VERSION
.IX Header "VERSION"
This is munin-limits version 2.0.75
.SH AUTHORS
.IX Header "AUTHORS"
Knut Haugen, Audun Ytterdal and Jimmy Olsen.
.SH BUGS
.IX Header "BUGS"
munin-limits does, as of now, not check the syntax of the configuration file.
.PP
Please report other bugs in the bug tracker at <http://munin\-monitoring.org/>.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2002\-2006 Knut Haugen, Audun Ytterdal, and Jimmy Olsen / Linpro AS.
.PP
This is free software; see the source for copying conditions. There is
NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.
.PP
This program is released under the GNU General Public License
.SH "SEE ALSO"
.IX Header "SEE ALSO"
For information on configuration options, please refer to the man page for
\&\fImunin.conf\fR.