lecram / isv Goto Github PK

isv - interactive service supervision
=====================================

This is a terminal user interface (TUI) for Runit service control.
It should also be compatible with daemontools, but I haven't tested that.
It's intended  to be a friendlier  version of Runit's sv  and daemontools' svc
programs.


Screenshot
----------

    $ isv
     name   active  main   log uptime
     cgit   no     21637 21636   12 m
    <cron   yes      332   329    3 d>
     rproxy yes      ---   330    ---

On the screen above, we can see that:
  - there are 3 services being currently supervised;
  - the pid of underlying processes are shown in columns "main" & "log";
  - service cgit is disabled (file "down" is present), but it's up;
  - service cron has been up for 3 days;
  - service rproxy is down;
  - service cron is selected to receive control commands.


Interaction
-----------

    KEY       ACTION
    ---       ------
    q         Quit isv
    j/k       Move selection cursor down/up
    SPACE     Enable/disable selected service (del/add "down" file)
    1/2       Send USR1/USR2 signal to selected service
    <UPPER>   Send command to selected service (e.g. 'U' -> 'up')

That is,  to control a  service, we  first move the  cursor (<>) using  j/k to
select it, then we press SHIFT+x, where x is the first character of one of the
commands supported by sv/svc:
    up, down, once, pause, cont, hup, alarm, interrupt, quit, term, kill


Installation
------------

This is just a single C source file with no external dependencies.
Of course we need Runit/daemontools in order to actually use it.

Do something like this to install:
  $ cc -o isv isv.c
  $ sudo mv isv /usr/bin/


Services Directory
------------------

The base directory for service location can be specified in several ways:
  - if an argument is passed to the isv(1) command, it's the base dir;
  - otherwise, if the SVDIR environment variable is set, it's the base dir;
  - otherwise, the base directory is /service/.

Note: make sure the user running isv(1) has access to service directories.


Copying
-------

All of the source  code and documentation for isv is  released into the public
domain and provided without warranty of any kind.