perpls(8)               persistent process supervision               perpls(8)



NAME
       perpls - persistent process service lister

SYNOPSIS
       perpls [-hV] [-b basedir ] [-cGgrt] [ sv ...  ]

DESCRIPTION
       perpls is used to list the current status of each sv argument monitored
       by an active perpd(8) supervisor.

       perpls looks for sv in the directory  basedir  if  given  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.   If  no  sv  is
       given,  perpls  reports  on  all  the  subdirectories found in the base
       directory not beginning with `.'.

       For each service sv, perpls prints a single line reporting on the  sta-
       tus  of  the service.  The report for each service is given in a format
       similar to the following:

              # perpls foo
              [+ +++ +++]  foo  uptime: 5s/5s  pids: 278/269

       The line begins with a ``panel'' for the service, followed by the  name
       of  the  service  sv,  followed by the current uptimes for the main/log
       processes, followed by the pids for the main/log processes.

       The ``panel'' is a compact representation of the service status.  It is
       displayed  as  a  sequence of nine-characters within square brackets: a
       single character for the status of the perpd(8) supervisor itself, fol-
       lowed by a pair of triple-character sequences representing the main and
       log processes under its supervision.

       The following characters are used in the panel:

       +      Ok.  The process is up and  running.   In  the  first  position,
              shows that the perpd(8) supervisor itself is up and running.  If
              the panel is all `+', it means all systems are go.

       .      Down.  The process is currently down.

              # perpctl down foo && perpls foo
              [+ ... +++]  foo  uptime: -s/90s  pids -/269

       !      Attention.  Appears in the first position of a triplet  sequence
              when  the  service is currently in a state it doesn't want to be
              in.  There is a problem somewhere, often indicating that a  run-
              script is not executable.  For example, a service currently down
              but ``wants'' to be up:

              # perpctl down foo
              # chmod -x foo/rc.main
              # perpctl up foo && perpls foo
              [+ !.. +++]  foo  uptime: -s/90s  pids 299/269

       o      Once.  Appears in the second position of a triplet sequence when
              the process is up and running, but flagged to run only once:

              # perpctl once foo && perpls foo
              [+ +o+ +++]  foo  uptime: 90s/90s  pids 278/269

       p      Paused.   Appears  in  the  third position of a triplet sequence
              when the process is currently paused:

              # perpctl pause foo && perpls foo
              [+ ++p +++]  foo  uptime: 90s/90s  pids 278/269

       r      Resetting.  Appears in the third position of a triplet  sequence
              when the service is currently resetting:

              # perpctl pause foo && perpls foo
              [+ ++r +++]  foo  uptime: 1s/90s  pids 299/269

       -      Not active/available.  In the first position of the panel, indi-