Provided by: checkservice_1.1.0-12_all bug

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 PHP-status page) 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 PHP-status page 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 PHP-status page:

           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)