1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
|
.TH nsvc 8 "Jan 19, 2010"
.SH NAME
nsvc \- control ninit
.SH SYNOPSIS
.B nsvc
[ -Sservice ]
[
.B \-[uodgpchaitkorRDCLHVWZE]
]
.I service
[\fI...\fR]
.br
.B nsvc -Ppid
.I service
.
.SH DESCRIPTION
.B nsvc
is the management interface to ninit.
.I service
is the service directory name relative to /etc/ninit.
You can also include /etc/ninit/ in the service name.
.PP
Each service directory contains control files.
They are described on
.I http://riemann.fmi.uni-sofia.bg/ninit/
.PP
It is possible to make nsvc SUID.
.PP
.RS
.B chown root.root /bin/nsvc
.br
.B chmod 4711 /bin/nsvc
.RE
.PP
Then nsvc opens the pipes
.IR /etc/ninit/in ,
.I /etc/ninit/out
and switches to real UID.
If UID is nonzero only limited set of operation are allowed.
.
.SH OPTIONS
If no options are given,
.B nsvc
will just print a diagnostic message to stdout, saying if the
service is up, down or finished, which PID it has if it is up, and for
how long it has been in this state.
Only the service name
.B ALL
means all services.
.TP
.B \-Sservice
Skip service. Apply this option immediately after
.B nsvc.
Don't insert space between S and service.
Examples:
.br
.B nsvc
\-Sngetty \-Ssshd \-Slogger \-d ALL
.br
.B nsvc
\-Sngetty \-W3 ALL ||
.B nsvc
\-Sngetty \-k ALL
.TP
.B \-u \-uNumber
Up.
If the service is not running, start it.
If the service stops, restart it. If
.B Number
is nonzero and the service is down start it after
.B Number
seconds.
.TP
.B \-o \-oNumber
Once.
If the service is down, start it.
If the service stops, do not restart it.
If
.B Number
is nonzero and the service is down, start it after
.B Number
seconds; if it is up, restart it later.
.TP
.B \-d
Down.
If the service is running, send it a TERM signal and then a CONT signal.
After it stops, do not restart it.
.TP
.B \-r
Stop respawn.
Set respawn flag to OFF. This does not start/stop the service.
.TP
.B \-R
Start respawn.
Set respawn flag to ON. This does not start/stop the service.
.TP
.B \-p
Pause.
Send the service a STOP signal.
.TP
.B \-c
Continue.
Send the service a CONT signal.
.TP
.B \-h
Hangup.
Send the service a HUP signal.
.TP
.B \-a
Alarm.
Send the service an ALRM signal.
.TP
.B \-i
Interrupt.
Send the service an INT signal.
.TP
.B \-t
Terminate.
Send the service a TERM signal.
.TP
.B \-k
Terminate.
Send the service a KILL signal.
.TP
.B \-g
Get. Output just the PID.
.TP
.B \-Ppid \fIservice\fR
Set pid of service.
.TP
.B \-D \fIservice\fR
Print dependencies.
This will print all the names of all the services that were started
because this services depended on them. Example:
.br
.B nsvc -D default
.TP
.B \-D
Print ninit memory usage statistics.
.TP
.B \-H
Print history.
This will print the names of some recently spawned processes.
This is useful if you see a process looping (initialization fails and
ninit is restarting it all the time).
.TP
.B \-L
Print all services loaded in memory.
.TP
.B \-V
Print version
.TP
.B \-Wnumber
Wait at most
.B number
seconds service(s) to finish. Example:
.br
.B nsvc \-d qmail
.br
.B nsvc \-W180 qmail || nsvc -k qmail
.TP
.B \-Cnumber \-C+number
Tell ninit that the service is in CRON mode.
If
.B number
is zero it disables CRON mode. Let now=`date +%s`.
If
.B number < now
then ninit starts the service immediately,
otherwise ninit will start it latter.
The flag
.B \-C+number
(if the
.B number
is positive)
is equaivalent to the following:
.br
.B t=`expr now + number`
.br
.B nsvc -C$t ...
To stop foo,
which is in CRON mode do:
.br
.B nsvc -C0 foo
.br
.B nsvc -d foo
.br
.\" To see the next CRON timestamp of foo type:
.\" .B nsvc foo
.TP
.B \-Z \-Znumber
Zero (free) a service. This is done with the ninit-reload program.
Example:
.br
.B nsvc -Z30 foo
.br
This removes foo (if such a service exists)
and prepares ninit to accept 30 new services approximately.
.TP
.B \-E \-Enumber
Update ninit environ. This is done by ninit-reload program.
Example:
.br
.B nsvc \-E36 ABC=12 UVW
.br
This updates the variable
.B ABC
and removes
.B UVW.
It prepares ninit to accept 36 new services approximately.
See the environ with:
.br
.B tr '\\\\000' '\\\\012' < /proc/1/environ
.
.SH "RETURN CODES"
Generally,
.B nsvc
returns zero if everything is OK or 1 on error (could not
open /etc/ninit/in or /etc/ninit/out or there is no process with the
given name). In diagnostic mode, it will exit 0 if the service is up, 2
if it is down or 3 if it is finished.
.
.SH "ENVIRON"
.B nsvc
uses the variables
.B NINIT_MEMORY
and
.B NINIT_HOME.
.SH "SEE ALSO"
ninit(8), ninit-scan(8)
.br
ninit-shutdown(8), nkillall(8), svc(8), msvc(8)
|
