CHECKSERVICE(5)

NAME
checkservice - checks the status of services on (remote) hosts

DESCRIPTION
Checkservice uses host-specific configfiles which are located in /etc/checkservice/hosts/. This means that for every hosts precisely can be specified, which service to check, what its short and long name are, what portset should be scanned, if extended, simple or no scan should be performed (method) and optionally which action to undertake when the service is failing.
The name of the file represents the host that should be scanned and the contents of the configfile instructs Checkservice what services to check on that host.

SYNTAX
The syntax used for every line in the configfiles is:

    <key>=<field1>:<field2>:...

The fields are an ordered list, so watch out! To configure a certain service, use:

    service=portset:shortname:method:longname[:action]

Where portset represents one or more ports separated by a comma (no spaces allowed), shortname the short name of the service (mosty the one used in /etc/services), method the check-method that should be used ('n' [None], 's' [Simple] or 'x' [eXtended]), an arbitrary longname (used in the php3-statuspage) and an optional action. That action will be run under the default shell if the service fails. Also commentlines starting with the hash '#' and emptylines are allowed.

If an url is set, the php3-statuspage will create a link to that URL in the title of the statistics-table.

    url=url

The mailto-opion can contain one or more (seperated by colons) emailaddresses that must be notified by mail (providing mailwarning is enabled) when something goes wrong with this host. This option does NOT override the mailto-option in the global conffile but appends to the emailaddress(es) specified there.

    mailto=somebody@somehost.net[:another@somehost.net:...]

EXAMPLES
* Let's check samba (port 137 & 139) using the simple
  check-method (since I have no plugins for it):

    service=137,139:samba:s:Samba Share service

* Apache is vital to me, let's check it thoroughly and
  keep it alive:
    service=80:http:x:Apache Webserver:apachectl restart
* And of course a link to Checkservice homepage in the
  title of the statistics-table of the php3-statuspage:
    url=http://www.linvision.com/checkservice

AUTHOR
This manual page was written by Paul van Tilburg <paul@linvision.com>, for Linvision bv.

SEE ALSO
checkservice(1), services(5)