NAME

       update-service - add/remove a service to/from system-wide service supervision

SYNOPSIS

       update-service --add|--remove service-directory [service-name]

       update-service --list|--check [service-name]

DESCRIPTION

       service-directory  must  be  a directory to be used by supervise(8), service-name must not
       start with a dot, and must not contain a slash.

       update-service  adds  or  removes  the  service-directory  to  the   system-wide   service
       supervision  provided  through  daemontools'  svscan(8),  lists all registered system-wide
       services, or checks for a specific service-name whether it is registered.

       When adding a service, and the service-directory resides in  /etc/,  update-service  makes
       sure  that  the  ./supervise/  subdirectories  in  the service-directory, and the optional
       service-directory/log/, are symbolic links pointing into /var/lib/supervise/, unless  they
       already are symbolic links.

OPTIONS

       --add | -a
              Add the service directory service-directory to the system-wide service supervision,
              under the name service-name.  If service-name is not specified, update-service will
              use  the  basename of service-directory.  You can use the svc(8) program to control
              the newly added service, and the svstat(8) program to query its status, e.g.:

              # svstat /etc/service/service-name

       --remove | -r
              Remove the service directory service-directory, which has been added under the name
              service-name,  from  the  system-wide  service supervision.  If service-name is not
              specified,  update-service  will  use  the  basename  of  service-directory.   When
              removing  the  service-directory,  the  exit  command  is sent to the corresponding
              supervise(8) process, telling it to take the service down and exit afterwards.  You
              can  use the svc(8) and svstat(8) programs to control the removed service, or query
              its status, e.g.:

              # svstat service-directory

       --list | -l
              If  service-name  is  specified,  update-service  checks  whether  service-name  is
              registered  as  system-wide service, prints a message and exits non-zero if not, or
              prints the service-name and the directory it points to and exits zero if  yes.   If
              service-name  is not specified, it prints the names of all system-widely registered
              services, one per line.

       --check | -c
              The same as --list, but update-service doesn't print anything to  standard  out  or
              standard error.

ENVIRONMENT

       SVDIR  The   environment   variable   $SVDIR  overrides  the  default  services  directory
              /etc/service/.

FILES

       /etc/service/

SEE ALSO

       svc(8), svstat(8), svscan(8), svscanboot(8)

AUTHOR

       Gerrit Pape <pape@smarden.org>

                                                                                update-service(8)