


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.



SWISH++			November 11, 2001			1





searchmonitor(8)				 searchmonitor(8)


       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			2


