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)

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

home | help