searchmonitor(8)				 searchmonitor(8)



NAME
       searchmonitor - SWISH++ search daemon monitor

SYNOPSIS
       searchmonitor [ -c conf_file ] [ -s search_path ]

DESCRIPTION
       searchmonitor  is  a process monitor for search(1) when it
       is running as a daemon.	If the process exits because of a
       condition  that	restarting  might cure, it will automati
       cally be restarted.

       searchmonitor is typcially  called  from	 a  system  start
       script  such  as	 searchd(8)  (for  SysV-like  systems) or
       rc.local (for BSD-like systems).

   Restartable Conditions
       The following conditions will cause a restart:

         A create, bind, or listen  to	 a  TCP	 or  Unix  domain
	  socket fails.

         A select or an accept on a socket fails.

         Creating or detaching a thread fails.

         Initializing a thread mutex or condition fails.

         Any unaccounted-for exit status.

       Restartable  conditions	are  logged via syslogd(8) at the
       ERR level.  There is a 5-second sleep before  the  process
       is restarted to prevent tight loops.

   Unrestartable Conditions
       The following conditions will not cause a restart:

         Error in configuration file.

         Error in command-line.

         Reading the index file fails.

         Writing the PID file fails.

         Deleting an old Unix domain socket file fails.

         Changing directory to / fails.

         The  user  or group the process is attempting to change
	  its user and group ID to does not exist.

         The process received a USR2 signal  in  response  to	a
	  manual shutdown request.

       With  the  exception of USR2, unrestartable conditions are
       logged via syslogd(8) at the ALERT level.

OPTIONS
       -cconf_file    The name of the configuration  file,
		      f,   to  use.   If  none	is  given,
		      swish++.conf is tried  both  in  the
		      current directory and in /etc.

       -ssearch_path  The  full	 path  to  the location of
		      search(1).  (Default is whereever it
		      was installed.  The default for that
		      is /usr/local/bin/search.)

FILES
       swish++.conf		   default   configuration
				   file
       /usr/local/bin/search	   Default   location  for
				   search(1)

SEE ALSO
       search(1), swish++.conf(4), searchd(8), syslogd(8)

AUTHOR
       Paul J. Lucas <pauljlucas@mac.com>



SWISH++			November 11, 2001	 searchmonitor(8)
