fiss-minit

A standalone service supervisor based on minit
Log | Files | Refs | README | LICENSE

msvc.8 (2348B)

      1 .TH msvc 8
      2 .SH NAME
      3 msvc \- control minit
      4 .SH SYNOPSIS
      5 .B msvc
      6 [
      7 .B \-[uodpchaitko]
      8 ] [
      9 .B \-P
     10 .I pid
     11 ]
     12 .I service
     13 [\fI...\fR]
     14 .SH DESCRIPTION
     15 .B msvc
     16 is the management interface to minit.
     17 .I service
     18 is the service directory name relative to /etc/minit.  Starting with
     19 minit 0.9 you can also include /etc/minit/ in the service name.
     20 .SH OPTIONS
     21 If no option is given,
     22 .B msvc
     23 will just print a small diagnostic message to stdout, saying if the
     24 service is up, down or finished, which PID it has if it is up, and for
     25 how long it has been in this state.
     26 .TP 5
     27 .B \-u
     28 Up.
     29 If the service is not running, start it.
     30 If the service stops, restart it.
     31 .TP
     32 .B \-o
     33 Once.
     34 If the service is not running, start it.
     35 If the service stops, do not restart it.
     36 .TP
     37 .B \-d
     38 Down.
     39 If the service is running, send it a TERM signal and then a CONT signal.
     40 After it stops, do not restart it.
     41 .TP
     42 .B \-p
     43 Pause.
     44 Send the service a STOP signal.
     45 .TP
     46 .B \-c
     47 Continue.
     48 Send the service a CONT signal.
     49 .TP
     50 .B \-h
     51 Hangup.
     52 Send the service a HUP signal.
     53 .TP
     54 .B \-a
     55 Alarm.
     56 Send the service an ALRM signal.
     57 .TP
     58 .B \-i
     59 Interrupt.
     60 Send the service an INT signal.
     61 .TP
     62 .B \-t
     63 Terminate.
     64 Send the service a TERM signal.
     65 .TP
     66 .B \-k
     67 Terminate.
     68 Send the service a KILL signal.
     69 .TP
     70 .B \-P \fIpid\fR
     71 Set PID.
     72 Tell minit the PID of the service is really \fIpid\fR.  This is useful
     73 for services that fork themselves in the background but put their real
     74 PID in a file, typically called /var/run/\fIservice\fR.pid.  Used by
     75 \fBpidfilehack\fR.
     76 .TP
     77 .B \-D \fIservice\fR
     78 Print dependencies.
     79 This will print all the names of all the services that were started
     80 because this services depended on them.  Please note that this is not
     81 done recursively (i.e. if default depends on qmail and qmail depends on
     82 log, this will print qmail, not qmail/log.  But msvc -D qmail will print
     83 qmail/log).
     84 .TP
     85 .B \-H
     86 Print history.
     87 This will print the names of the ten least recently spawned processes.
     88 This is useful if you see a process looping (initialization fails and
     89 minit is restarting it all the time).
     90 .SH "RETURN CODES"
     91 Generally, msvc return zero if everything is OK or 1 on error (could not
     92 open /etc/minit/in or /etc/minit/out or there is no process with the
     93 given name).  In diagnostic mode, it will exit 0 if the service is up, 2
     94 if it is down or 3 if it is finished.
     95 .SH "SEE ALSO"
     96 pidfilehack(8), svc(8)