Commit | Line | Data |
---|---|---|
1479465f GJ |
1 | .\" dpkg manual page - start-stop-daemon(8) |
2 | .\" | |
3 | .\" Copyright © 1999 Klee Dienes <klee@mit.edu> | |
4 | .\" Copyright © 1999 Ben Collins <bcollins@debian.org> | |
5 | .\" Copyright © 2000-2001 Wichert Akkerman <wakkerma@debian.org> | |
6 | .\" Copyright © 2002-2003 Adam Heath <doogie@debian.org> | |
7 | .\" Copyright © 2004 Scott James Remnant <keybuk@debian.org> | |
8 | .\" Copyright © 2008-2015 Guillem Jover <guillem@debian.org> | |
9 | .\" | |
10 | .\" This is free software; you can redistribute it and/or modify | |
11 | .\" it under the terms of the GNU General Public License as published by | |
12 | .\" the Free Software Foundation; either version 2 of the License, or | |
13 | .\" (at your option) any later version. | |
14 | .\" | |
15 | .\" This is distributed in the hope that it will be useful, | |
16 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 | .\" GNU General Public License for more details. | |
19 | .\" | |
20 | .\" You should have received a copy of the GNU General Public License | |
21 | .\" along with this program. If not, see <https://www.gnu.org/licenses/>. | |
22 | . | |
23 | .\"******************************************************************* | |
24 | .\" | |
25 | .\" This file was generated with po4a. Translate the source file. | |
26 | .\" | |
27 | .\"******************************************************************* | |
28 | .TH start\-stop\-daemon 8 %RELEASE_DATE% %VERSION% Dpkg\-sviten | |
29 | .nh | |
30 | .SH NAMN | |
31 | start\-stop\-daemon \- startar och stoppar bakgrundsprocesser | |
32 | . | |
33 | .SH SYNOPS | |
34 | \fBstart\-stop\-daemon\fP [\fIflagga\fP...] \fIåtgärd\fP | |
35 | . | |
36 | .SH BESKRIVNING | |
37 | \fBstart\-stop\-daemon\fP används för att kontrollera hur processer på systemnivå | |
38 | skapas och avslutas. Med hjälp av en av sökflaggorna kan | |
39 | \fBstart\-stop\-daemon\fP ställas in att hitta befintliga instanser av en körande | |
40 | process. | |
41 | .PP | |
42 | Observera att om inte \fB\-\-pid\fP eller \fB\-\-pidfile\fP anges kommer | |
43 | \fBstart\-stop\-daemon\fP att jobba på ett sätt som liknar \fBkillall(1).\fP | |
44 | \fBstart\-stop\-daemon\fP kommer att söka i processtabellen efter processer med | |
45 | motsvarande namn på processen, användar\-id och/eller grupp\-id (om sådant | |
46 | anges). Alla processer som stämmer överens kommer tillsändas signalen TERM | |
47 | (eller den som anges med \fB\-\-signal\fP eller \fB\-\-retry\fP) om \fB\-\-stop\fP | |
48 | anges. För processer som har långlivade barn som måste överleva en | |
49 | \fB\-\-stop\fP, måste du ange en pidfil. | |
50 | . | |
51 | .SH KOMMANDON | |
52 | .TP | |
53 | \fB\-S\fP, \fB\-\-start\fP [\fB\-\-\fP] \fIargument\fP | |
54 | Se om en angiven process existerar, och om så är fallet gör | |
55 | \fBstart\-stop\-daemon\fP ingenting och avslutar med status 1 (0 om \fB\-\-oknodo\fP | |
56 | anges). Om en sådan process inte existerar startas en instans, antingen med | |
57 | programfilen som anges med \fB\-\-exec\fP eller, om den anges, med | |
58 | \fB\-\-startas\fP. Eventuella argument som ges efter \fB\-\-\fP på kommandoraden | |
59 | skickas utan ändring till programmet som startas. | |
60 | .TP | |
61 | \fB\-K\fP, \fB\-\-stop\fP | |
62 | Testa om den angivna processen existerar. Om så är fallet sänder | |
63 | \fBstart\-stop\-daemon\fP den signal som anges av \fB\-\-signal\fP till processen, och | |
64 | avslutar med status 0. Om processen inte finns avslutar \fBstart\-stop\-daemon\fP | |
65 | med status 1 (0 om \fB\-\-oknodo\fP anges). Om \fB\-\-retry\fP anges kommer | |
66 | \fBstart\-stop\-daemon\fP kontrollera att processen har avslutats. | |
67 | .TP | |
68 | \fB\-T\fP, \fB\-\-status\fP | |
69 | Check for the existence of a specified process, and returns an exit status | |
70 | code, according to the LSB Init Script Actions (since version 1.16.1). | |
71 | .TP | |
72 | \fB\-H\fP, \fB\-\-help\fP | |
73 | Visa hjälpskärm och avsluta. | |
74 | .TP | |
75 | \fB\-V\fP, \fB\-\-version\fP | |
76 | Visa programversion och avsluta. | |
77 | . | |
78 | .SH FLAGGOR | |
79 | .SS Matchingsflaggor | |
80 | .TP | |
81 | \fB\-\-pid\fP \fIpid\fP | |
82 | Check for a process with the specified \fIpid\fP (since version 1.17.6). The | |
83 | \fIpid\fP must be a number greater than 0. | |
84 | .TP | |
85 | \fB\-\-ppid\fP \fIppid\fP | |
86 | Check for a process with the specified parent pid \fIppid\fP (since version | |
87 | 1.17.7). The \fIppid\fP must be a number greater than 0. | |
88 | .TP | |
89 | \fB\-p\fP, \fB\-\-pidfile\fP \fIpidfil\fP | |
90 | Kontrollera om en process har skapat filen \fIpidfil\fP. Observera: om flaggan | |
91 | används på egen hand kan den orsaka att oönskade processer berörs, om den | |
92 | gamla processen avslutats utan att kunna ta bort \fIpidfil\fP. | |
93 | .TP | |
94 | \fB\-x\fP, \fB\-\-exec\fP \fIprogramfil\fP | |
95 | Se efter processer som är instanser av \fIprogramfil\fP. Flaggan \fIprogramfil\fP | |
96 | bör vara en absolut sökväg. Observera: detta fungerar kanske inte som det | |
97 | ska för tolkade skript eftersom programfilen kommer peka på tolken. Notera | |
98 | att processer som körs inuti en chroot också kommer att träffas, så andra | |
99 | begränsningar kan behövas. | |
100 | .TP | |
101 | \fB\-n\fP, \fB\-\-name\fP \fIprocessnamn\fP | |
102 | Se efter processer med namnet \fIprocessnamn\fP. \fIProcessnamn\fP är vanligtvis | |
103 | processens filnamn, men kan ha ändrats av processen själv. Observera: på de | |
104 | flesta system hämtas informationen från processens comm\-namn från kärnan, | |
105 | vilket ofta har en relativt kort längdbegränsning (det är inte portablet att | |
106 | anta fler än 15 tecken). | |
107 | .TP | |
108 | \fB\-u\fP, \fB\-\-user\fP \fIanvändarnamn\fP|\fIanvändar\-id\fP | |
109 | Se efter processer som ägs av användaren som anges av \fIanvändarnamn\fP eller | |
110 | \fIanvänder\-id\fP. Observera: om den här flaggan används på egen hand träffas | |
111 | alla processer som motsvarar användaren. | |
112 | . | |
113 | .SS "Generiska flaggor" | |
114 | .TP | |
115 | \fB\-g\fP, \fB\-\-group\fP \fIgrupp\fP|\fIgrupp\-id\fP | |
116 | Byt till \fIgrupp\fP eller \fIgrupp\-id\fP när processen startas. | |
117 | .TP | |
118 | \fB\-s\fP, \fB\-\-signal\fP \fIsignal\fP | |
119 | Tillsammans med \fB\-\-stop\fP anger detta den signal som skall sändas till | |
120 | processen som stoppas (förval är TERM). | |
121 | .TP | |
122 | \fB\-R\fP, \fB\-\-retry\fP \fItidsgräns\fP|\fIschema\fP | |
123 | Tillsammans med \fB\-\-stop\fP anger detta att \fBstart\-stop\-daemon\fP skall | |
124 | kontrollera att processen avslutas. Den testar flera gånger efter matchande | |
125 | processer som körs, tills ingen längre finns kvar. Om processerna inte | |
126 | avslutar kommer programmet utföra ytterligare kommandon enligt schemat. | |
127 | ||
128 | Om \fItidsgräns\fP anges istället för \fIschema\fP kommer schemat | |
129 | \fIsignal\fP\fB/\fP\fItimeout\fP\fB/KILL/\fP\fItimeout\fP att användas, där \fIsignal\fP är | |
130 | den signal som anges med \fB\-\-signal\fP. | |
131 | ||
132 | \fIschema\fP är den lista med åtminstone två poster avdelade med snedstreck | |
133 | (\fB/\fP); varje post är antingen \fB\-\fP\fIsignalnummer\fP eller | |
134 | [\fB\-\fP]\fIsignalnamn\fP, vilket betyder att signalen skall sändas, eller | |
135 | \fItimeout\fP, vilket anger det antal sekunder programmet skall vänta på att | |
136 | processen avslutar, eller \fBforever\fP, vilket betyder att resten av schemat | |
137 | skall repetera för evigt om så behövs. | |
138 | ||
139 | Om slutet på schemat nås och \fBforever\fP inte anges kommer | |
140 | \fBstart\-stop\-daemon\fP avslutas med felkod 2. Om ett schema anges kommer | |
141 | eventuell signal angiven med \fB\-\-signal\fP att ignoreras. | |
142 | .TP | |
143 | \fB\-a\fP, \fB\-\-startas\fP \fIsökväg\fP | |
144 | Tillsammans med \fB\-\-start\fP anger detta att processen som anges med \fIsökväg\fP | |
145 | skall startas. Om den inte anges används argumentet som gavs till \fB\-\-exec\fP. | |
146 | .TP | |
147 | \fB\-t\fP, \fB\-\-test\fP | |
148 | Skriver ut vad som skulle ha utförts och sätter returvärdet, men utför | |
149 | ingenting. | |
150 | .TP | |
151 | \fB\-o\fP, \fB\-\-oknodo\fP | |
152 | Returnerar felstatus 0 i stället för 1 om ingen åtgärd utförs/skulle | |
153 | utförts. | |
154 | .TP | |
155 | \fB\-q\fP, \fB\-\-quiet\fP | |
156 | Skriv inte informationsmeddelanden; visa endast felmeddelanden. | |
157 | .TP | |
158 | \fB\-c\fP, \fB\-\-chuid\fP \fIanvändarnamn\fP|\fIanvändar\-id\fP[\fB:\fP\fIgrupp\fP|\fIgrupp\-id\fP] | |
159 | Change to this username/uid before starting the process. You can also | |
160 | specify a group by appending a \fB:\fP, then the group or gid in the same way | |
161 | as you would for the \fBchown\fP(1) command (\fIuser\fP\fB:\fP\fIgroup\fP). If a user | |
162 | is specified without a group, the primary GID for that user is used. When | |
163 | using this option you must realize that the primary and supplemental groups | |
164 | are set as well, even if the \fB\-\-group\fP option is not specified. The | |
165 | \fB\-\-group\fP option is only for groups that the user isn't normally a member | |
166 | of (like adding per process group membership for generic users like | |
167 | \fBnobody\fP). | |
168 | .TP | |
169 | \fB\-r\fP, \fB\-\-chroot\fP \fIrot\fP | |
170 | Byt katalog och rot till \fBrot\fP innan processen startas. Observera att även | |
171 | pidfilen skrivs efter chroot har utförts. | |
172 | .TP | |
173 | \fB\-d\fP, \fB\-\-chdir\fP \fIsökväg\fP | |
174 | Byt katalog till \fIsökväg\fP innan processen startas. Detta görs efter byte av | |
175 | rot om \fB\-r\fP|\fB\-\-chroot\fP\-flaggan anges. Om flaggan inte anges kommer | |
176 | \fBstart\-stop\-daemon\fP byta till rotkatalogen innan processen startas. | |
177 | .TP | |
178 | \fB\-b\fP, \fB\-\-background\fP | |
179 | Typically used with programs that don't detach on their own. This option | |
180 | will force \fBstart\-stop\-daemon\fP to fork before starting the process, and | |
181 | force it into the background. \fBWarning: start\-stop\-daemon\fP cannot check | |
182 | the exit status if the process fails to execute for \fBany\fP reason. This is a | |
183 | last resort, and is only meant for programs that either make no sense | |
184 | forking on their own, or where it's not feasible to add the code for them to | |
185 | do this themselves. | |
186 | .TP | |
187 | \fB\-C\fP, \fB\-\-no\-close\fP | |
188 | Do not close any file descriptor when forcing the daemon into the background | |
189 | (since version 1.16.5). Used for debugging purposes to see the process | |
190 | output, or to redirect file descriptors to log the process output. Only | |
191 | relevant when using \fB\-\-background\fP. | |
192 | .TP | |
193 | \fB\-N\fP, \fB\-\-nicelevel\fP \fIheltal\fP | |
194 | Ändrar prioriteten på processen innan den startas. | |
195 | .TP | |
196 | \fB\-P\fP, \fB\-\-procsched\fP \fIpolicy\fP\fB:\fP\fIprioritet\fP | |
197 | This alters the process scheduler policy and priority of the process before | |
198 | starting it (since version 1.15.0). The priority can be optionally | |
199 | specified by appending a \fB:\fP followed by the value. The default \fIpriority\fP | |
200 | is 0. The currently supported policy values are \fBother\fP, \fBfifo\fP and \fBrr\fP. | |
201 | .TP | |
202 | \fB\-I\fP, \fB\-\-iosched\fP \fIklass\fP\fB:\fP\fIprioritet\fP | |
203 | This alters the IO scheduler class and priority of the process before | |
204 | starting it (since version 1.15.0). The priority can be optionally | |
205 | specified by appending a \fB:\fP followed by the value. The default \fIpriority\fP | |
206 | is 4, unless \fIclass\fP is \fBidle\fP, then \fIpriority\fP will always be 7. The | |
207 | currently supported values for \fIclass\fP are \fBidle\fP, \fBbest\-effort\fP and | |
208 | \fBreal\-time\fP. | |
209 | .TP | |
210 | \fB\-k\fP, \fB\-\-umask\fP \fImaskvärde\fP | |
211 | This sets the umask of the process before starting it (since version | |
212 | 1.13.22). | |
213 | .TP | |
214 | \fB\-m\fP, \fB\-\-make\-pidfile\fP | |
215 | Used when starting a program that does not create its own pid file. This | |
216 | option will make \fBstart\-stop\-daemon\fP create the file referenced with | |
217 | \fB\-\-pidfile\fP and place the pid into it just before executing the | |
218 | process. Note, the file will only be removed when stopping the program if | |
219 | \fB\-\-remove\-pidfile\fP is used. \fBNote:\fP This feature may not work in all | |
220 | cases. Most notably when the program being executed forks from its main | |
221 | process. Because of this, it is usually only useful when combined with the | |
222 | \fB\-\-background\fP option. | |
223 | .TP | |
224 | \fB\-\-remove\-pidfile\fP | |
225 | Used when stopping a program that does not remove its own pid file (since | |
226 | version 1.17.19). This option will make \fBstart\-stop\-daemon\fP remove the | |
227 | file referenced with \fB\-\-pidfile\fP after terminating the process. | |
228 | .TP | |
229 | \fB\-v\fP, \fB\-\-verbose\fP | |
230 | Skriv ut pratsamma informationsmeddelanden. | |
231 | . | |
232 | .SH RETURVÄRDE | |
233 | .TP | |
234 | \fB0\fP | |
235 | Efterfrågad åtgärd utfördes. Om \fB\-\-oknodo\fP angavs är det även möjligt att | |
236 | ingenting behövde utföras. Det kan hända när \fB\-\-start\fP angavs och en | |
237 | motsvarande process redan körde, eller när \fB\-\-stop\fP angavs och det inte | |
238 | fanns någon motsvarande process. | |
239 | .TP | |
240 | \fB1\fP | |
241 | Om \fB\-\-oknodo\fP inte angavs och ingenting gjordes. | |
242 | .TP | |
243 | \fB2\fP | |
244 | Om \fB\-\-stop\fP och \fB\-\-retry\fP angavs, men slutet på tidtabellen nåddes och | |
245 | processen fortfarande kördes. | |
246 | .TP | |
247 | \fB3\fP | |
248 | Alla andra fel. | |
249 | .PP | |
250 | Med \fB\-\-status\fP\-åtgärden returneras följande statuskoder: | |
251 | .TP | |
252 | \fB0\fP | |
253 | Programmet kör. | |
254 | .TP | |
255 | \fB1\fP | |
256 | Programmet kör inte och pid\-filen finns. | |
257 | .TP | |
258 | \fB3\fP | |
259 | Programmet kör inte. | |
260 | .TP | |
261 | \fB4\fP | |
262 | Kan inte ta reda på programmets status. | |
263 | . | |
264 | .SH EXEMPEL | |
265 | Starta serverprocessen \fBfood\fP, såvida inte en redan kör (en process med | |
266 | namnet food, som körs som användaren food, med process\-id i food.pid): | |
267 | .IP | |
268 | .nf | |
269 | start\-stop\-daemon \-\-start \-\-oknodo \-\-user food \-\-name food \e | |
270 | \-\-pidfile /run/food.pid \-\-startas /usr/sbin/food \e | |
271 | \-\-chuid food \-\- \-\-daemon | |
272 | .fi | |
273 | .PP | |
274 | Sänd \fBSIGTERM\fP till \fBfood\fP och vänta upp till fem sekunder på att den | |
275 | skall avslutas: | |
276 | .IP | |
277 | .nf | |
278 | start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e | |
279 | \-\-pidfile /run/food.pid \-\-retry 5 | |
280 | .fi | |
281 | .PP | |
282 | Demonstration av ett skräddarsytt schema för att avsluta \fBfood\fP: | |
283 | .IP | |
284 | .nf | |
285 | start\-stop\-daemon \-\-stop \-\-oknodo \-\-user food \-\-name food \e | |
286 | \-\-pidfile /run/food.pid \-\-retry=TERM/30/KILL/5 | |
287 | .fi | |
288 | .SH ÖVERSÄTTNING | |
289 | Peter Krefting och Daniel Nylander. |