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