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 argument
     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  direc-
     tory specified with the -b option, or as set in the PERP_BASE environmental
     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 re-
     garding the perpd(8) supervisor itself, the main service, and its log  ser-
     vice (if any), one line for each process.

OPTIONS
     -b basedir
	    Base directory.  Sets the base directory containing the service def-
	    initions  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  direc-
	    tory 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 reported
	    on each sv argument given.	Note that this status is  returned  even
	    if	certain problems were found and reported for individual sv argu-
	    ments.

     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 message
	    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+15.1.quarterly>

home | help