Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
runsvdir(8)		    System Manager's Manual		   runsvdir(8)

NAME
       runsvdir	- starts and monitors a	collection of runsv(8) processes

SYNOPSIS
       runsvdir	[-P] dir [ log ]

DESCRIPTION
       dir  must  be  a	 directory.  log is a space holder for a readproctitle
       log, and	must be	at least seven characters long or absent.

       runsvdir	starts a runsv(8) process for each subdirectory, or symlink to
       a  directory, in	the services directory dir, up to a limit of 1000 sub-
       directories,  and  restarts  a  runsv(8)	 process  if  it   terminates.
       runsvdir	skips subdirectory names starting with dots.  runsv(8) must be
       in runsvdir's PATH.

       At least	every five seconds runsvdir checks whether the	time  of  last
       modification,  the  inode, or the device, of the	services directory dir
       has changed.  If	so, it re-scans	the service directory, and if it  sees
       a  new subdirectory, or new symlink to a	directory, in dir, it starts a
       new runsv(8) process; if	runsvdir sees  a  subdirectory	being  removed
       that  was previously there, it sends the	corresponding runsv(8) process
       a TERM signal, stops monitoring this process, and so does  not  restart
       the runsv(8) process if it exits.

       If  the log argument is given to	runsvdir, all output to	standard error
       is redirected to	this log, which	is similar to the  daemontools'	 read-
       proctitle  log.	 To see	the most recent	error messages,	use a process-
       listing tool such as ps(1).  runsvdir writes a dot to the readproctitle
       log every 15 minutes so that old	error messages expire.

OPTIONS
       -P     use  setsid(2) to	run each runsv(8) process in a new session and
	      separate process group.

SIGNALS
       If runsvdir receives a TERM signal, it exits with 0 immediately.

       If runsvdir receives a HUP signal, it  sends  a	TERM  signal  to  each
       runsv(8)	process	it is monitoring and then exits	with 111.

SEE ALSO
       sv(8),  runsv(8),  runsvchdir(8),  runit(8),  runit-init(8),  chpst(8),
       svlogd(8), utmpset(8), setsid(2)

       http://smarden.org/runit/

AUTHOR
       Gerrit Pape <pape@smarden.org>

								   runsvdir(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SIGNALS | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=runsvdir&sektion=8&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help