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

FreeBSD Manual Pages

  
 
  

home | help
perpstat(8)		persistent process supervision		   perpstat(8)

NAME
       perpstat	- display current status of perpd(8) services

SYNOPSIS
       perpstat	[-hV] [-b basedir ] sv [sv ...]

DESCRIPTION
       perpstat	 is used to report the current service status of each sv argu-
       ment monitored by an active perpd(8) supervisor.

       Each argument sv	should be a service definition directory running under
       the  supervision	of perpd(8).  perpstat will look for sv	in the basedir
       directory specified with	the -b option, or as set in the	PERP_BASE  en-
       vironmental  variable,  or  in  the current directory if	neither	of the
       previous	is given.

       For each	argument sv found in the base directory, perpstat queries  the
       perpd(8)	supervisor for its runtime status.  It then prints information
       regarding the perpd(8) supervisor itself, the main service, and its log
       service (if any), one line for each process.

OPTIONS
       -b basedir
	      Base  directory.	Sets the base directory	containing the service
	      definitions named	by the sv arguments.   If  not	set,  perpstat
	      will use the value set in	the variable PERP_BASE,	or the current
	      directory	if neither of these are	defined.  On a normal  system,
	      the base directory will be /etc/perp.

       -h     Help.  Print a brief usage message to stderr and exit.

       -V     Version.	Print the version number to stderr and exit.

EXIT STATUS
       perpstat	exits with the following values:

       0      Success.	 The  perpstat	command	successfully processed and re-
	      ported on	each sv	argument given.	 Note that this	status is  re-
	      turned  even if certain problems were found and reported for in-
	      dividual sv arguments.

       100    Usage error.  For	unknown	options	or missing arguments.  Returns
	      100 and prints a brief diagnostic	message	to stderr on exit.

       111    System error.  For system, permission, configuration, and/or re-
	      source failures.	Returns	111 and	prints a brief diagnostic mes-
	      sage to stderr on	exit.

AUTHOR
       Wayne Marshall, http://b0llix.net/perp/

SEE ALSO
       perp_intro(8),	perpboot(8),   perpctl(8),   perpd(8),	perpetrate(5),
       perphup(8), perpls(8), perpok(8), sissylog(8), tinylog(8)

perp-2.07			 January 2013			   perpstat(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | AUTHOR | SEE ALSO

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

home | help