persistent process supervision
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
       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
       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
              reported on each sv argument given.  Note that  this  status  is
              returned  even  if  certain problems were found and reported for
              individual 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
              resource 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)