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 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)