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% "suite dpkg" | |
29 | .nh | |
30 | .SH NOME | |
31 | start\-stop\-daemon \- avvia e ferma i programmi demone di sistema | |
32 | . | |
33 | .SH SINTASSI | |
34 | \fBstart\-stop\-daemon\fP [\fIopzione\fP...] \fIcomando\fP | |
35 | . | |
36 | .SH DESCRIZIONE | |
37 | \fBstart\-stop\-daemon\fP viene usato per controllare la creazione e la | |
38 | terminazione dei processi a livello di sistema. Usando una delle opzioni | |
39 | corrispondenti, \fBstart\-stop\-daemon\fP può essere configurato per trovare le | |
40 | istanze esistenti di un processo in esecuzione. | |
41 | .PP | |
42 | Nota: a meno che non venga specificata l'opzione \fB\-\-pid\fP o \fB\-\-pidfile\fP, | |
43 | \fBstart\-stop\-daemon\fP si comporta in modo simile a | |
44 | \fBkillall\fP(1). \fBstart\-stop\-daemon\fP analizza la tabella dei processi | |
45 | cercando qualsiasi processo che corrisponde al nome, PID del genitore, UID o | |
46 | GID (se specificati) di processo. Ogni processo che corrisponde impedirà a | |
47 | \fB\-\-start\fP di avviare il demone. Se viene specificata l'opzione \fB\-\-stop\fP a | |
48 | tutti i processi che corrispondono verrà inviato il segnale TERM (o quello | |
49 | specificato con \fB\-\-signal\fP o \fB\-\-retry\fP). Per i demoni che hanno processi | |
50 | figli di lunga vita che devono sopravvivere ad uno \fB\-\-stop\fP è necessario | |
51 | specificare un file PID. | |
52 | . | |
53 | .SH COMANDI | |
54 | .TP | |
55 | \fB\-S\fP, \fB\-\-start\fP [\fB\-\-\fP] \fIargomenti\fP | |
56 | Controlla l'esistenza di un processo specifico. Se tale processo esiste, | |
57 | \fBstart\-stop\-daemon\fP non fa nulla ed esce con lo stato di errore 1 (0 se | |
58 | viene specificato \fB\-\-oknodo\fP). Se tale processo non esiste, viene avviata | |
59 | un'istanza usando l'eseguibile specificato da \fB\-\-exec\fP oppure, se presente, | |
60 | da \fB\-\-startas\fP. Tutti gli argomenti specificati dopo \fB\-\-\fP sulla riga di | |
61 | comando vengono passati immutati al programma che viene avviato. | |
62 | .TP | |
63 | \fB\-K\fP, \fB\-\-stop\fP | |
64 | Controlla l'esistenza di un processo specificato. Se un tale processo | |
65 | esiste, \fBstart\-stop\-daemon\fP gli invia il segnale specificato da \fB\-\-signal\fP | |
66 | ed esce con lo stato di errore 0. Se tale processo non esiste, | |
67 | \fBstart\-stop\-daemon\fP esce con stato di errore 1 (0 se viene specificato | |
68 | \fB\-\-oknodo\fP). Se viene usata l'opzione \fB\-\-retry\fP, allora | |
69 | \fBstart\-stop\-daemon\fP controllerà che i processi siano stati terminati. | |
70 | .TP | |
71 | \fB\-T\fP, \fB\-\-status\fP | |
72 | Check for the existence of a specified process, and returns an exit status | |
73 | code, according to the LSB Init Script Actions (since version 1.16.1). | |
74 | .TP | |
75 | \fB\-H\fP, \fB\-\-help\fP | |
76 | Visualizza informazioni sull'uso ed esce. | |
77 | .TP | |
78 | \fB\-V\fP, \fB\-\-version\fP | |
79 | Visualizza la versione del programma ed esce. | |
80 | . | |
81 | .SH OPZIONI | |
82 | .SS "Opzioni per corrispondenze" | |
83 | .TP | |
84 | \fB\-\-pid\fP \fIpid\fP | |
85 | Check for a process with the specified \fIpid\fP (since version 1.17.6). The | |
86 | \fIpid\fP must be a number greater than 0. | |
87 | .TP | |
88 | \fB\-\-ppid\fP \fIppid\fP | |
89 | Check for a process with the specified parent pid \fIppid\fP (since version | |
90 | 1.17.7). The \fIppid\fP must be a number greater than 0. | |
91 | .TP | |
92 | \fB\-p\fP, \fB\-\-pidfile\fP \fIfile\-pid\fP | |
93 | Controlla se un processo ha creato il file \fIfile\-pid\fP. Nota: usare questa | |
94 | opzione di corrispondenza da sola può causare effetti su processi non | |
95 | desiderati, se il vecchio processo è stato terminato senza aver potuto | |
96 | rimuovere il \fIfile\-pid\fP. | |
97 | .TP | |
98 | \fB\-x\fP, \fB\-\-exec\fP \fIeseguibile\fP | |
99 | Cerca i processi che sono istanze di questo \fIeseguibile\fP. L'argomento | |
100 | \fIeseguibile\fP dovrebbe essere un nome di percorso assoluto. Nota: questo | |
101 | potrebbe non funzionare come atteso con gli script interpretati, dato che | |
102 | l'eseguibile punterà all'interprete. Tenere in considerazione che faranno | |
103 | corrispondenza anche i processi in esecuzione in una chroot, perciò | |
104 | potrebbero essere necessarie altre restrizioni della corrispondenza. | |
105 | .TP | |
106 | \fB\-n\fP, \fB\-\-name\fP \fInome\-processo\fP | |
107 | Cerca i processi con nome \fInome\-processo\fP. Questo è solitamente il nome del | |
108 | file del processo, ma potrebbe essere stato cambiato dal processo | |
109 | stesso. Nota: nella maggior parte dei sistemi questa informazione viene | |
110 | recuperata del nome comm del processo nel kernel, che tende ad avere limiti | |
111 | di lunghezza piuttosto limitati (nell'assunzione che più di 15 caratteri non | |
112 | siano portabili). | |
113 | .TP | |
114 | \fB\-u\fP, \fB\-\-user\fP \fInomeutente\fP|\fIuid\fP | |
115 | Cerca i processi di proprietà dell'utente specificato da \fInomeutente\fP o | |
116 | \fIuid\fP. Nota: l'uso di questa opzione di corrispondenza da sola farà sì che | |
117 | l'azione abbia effetto su tutti i processi corrispondenti all'utente. | |
118 | . | |
119 | .SS "Opzioni generiche" | |
120 | .TP | |
121 | \fB\-g\fP, \fB\-\-group\fP \fIgruppo\fP|\fIgid\fP | |
122 | Modifica in \fIgroup\fP o \fIgid\fP quando avvia il processo. | |
123 | .TP | |
124 | \fB\-s\fP, \fB\-\-signal\fP \fIsegnale\fP | |
125 | Con \fB\-\-stop\fP specifica il segnale da inviare ai processi che vengono | |
126 | fermati (quello predefinito è TERM). | |
127 | .TP | |
128 | \fB\-R\fP, \fB\-\-retry\fP \fIscadenza\fP|\fIpianificazione\fP | |
129 | Con \fB\-\-stop\fP specifica che \fBstart\-stop\-daemon\fP deve controllare se i | |
130 | processi terminano effettivamente. Controlla ripetutamente se qualsiasi | |
131 | processo corrispondente è in esecuzione fino a che nessuno lo è più. Se i | |
132 | processi non terminano, effettua altre azioni in base alla pianificazione. | |
133 | ||
134 | Se viene specificata una \fIscadenza\fP invece di una \fIpianificazione\fP, allora | |
135 | viene usata la pianificazione \fIsegnale\fP\fB/\fP\fIscadenza\fP\fB/KILL/\fP\fIscadenza\fP, | |
136 | dove \fIsegnale\fP è il segnale specificato da \fB\-\-signal\fP. | |
137 | ||
138 | \fIpianificazione\fP è un elenco di almeno due elementi separati da barre | |
139 | (\fB/\fP); ciascun elemento può essere \fB\-\fP\fInumero\-segnale\fP o | |
140 | [\fB\-\fP]\fInome\-segnale\fP, che significa inviare quel segnale, o \fIscadenza\fP, | |
141 | che significa aspettare che il processo termini per quel numero di secondi, | |
142 | oppure \fBforever\fP, che significa ripetere il resto della pianificazione | |
143 | all'infinito, se necessario. | |
144 | ||
145 | Se viene raggiunta la fine della pianificazione e non viene specificato | |
146 | \fBforever\fP, allora \fBstart\-stop\-daemon\fP esce con stato di errore 2. Se viene | |
147 | specificata una pianificazione, allora viene ignorato qualsiasi segnale | |
148 | specificato con \fB\-\-signal\fP. | |
149 | .TP | |
150 | \fB\-a\fP, \fB\-\-startas\fP \fInomepercorso\fP | |
151 | Con \fB\-\-start\fP, avvia il processo specificato da \fInomepercorso\fP. Se non | |
152 | specificato, viene usato in modo predefinito l'argomento fornito a | |
153 | \fB\-\-exec\fP. | |
154 | .TP | |
155 | \fB\-t\fP, \fB\-\-test\fP | |
156 | Visualizza le azioni che sarebbero effettuate e imposta il valore restituito | |
157 | appropriato, ma non fa alcuna azione. | |
158 | .TP | |
159 | \fB\-o\fP, \fB\-\-oknodo\fP | |
160 | Restituisce lo stato di uscita 0 invece di 1 se non viene (o non verrebbe) | |
161 | fatta alcuna azione. | |
162 | .TP | |
163 | \fB\-q\fP, \fB\-\-quiet\fP | |
164 | Non visualizza messaggi informativi; mostra solo i messaggi di errore. | |
165 | .TP | |
166 | \fB\-c\fP, \fB\-\-chuid\fP \fInomeutente\fP|\fIuid\fP[\fB:\fP\fIgruppo\fP|\fIgid\fP] | |
167 | Change to this username/uid before starting the process. You can also | |
168 | specify a group by appending a \fB:\fP, then the group or gid in the same way | |
169 | as you would for the \fBchown\fP(1) command (\fIuser\fP\fB:\fP\fIgroup\fP). If a user | |
170 | is specified without a group, the primary GID for that user is used. When | |
171 | using this option you must realize that the primary and supplemental groups | |
172 | are set as well, even if the \fB\-\-group\fP option is not specified. The | |
173 | \fB\-\-group\fP option is only for groups that the user isn't normally a member | |
174 | of (like adding per process group membership for generic users like | |
175 | \fBnobody\fP). | |
176 | .TP | |
177 | \fB\-r\fP, \fB\-\-chroot\fP \fIroot\fP | |
178 | Cambia la directory e la chroot a \fIroot\fP prima di avviare il | |
179 | processo. Notare che anche il filepid viene scritto dopo chroot. | |
180 | .TP | |
181 | \fB\-d\fP, \fB\-\-chdir\fP \fIpercorso\fP | |
182 | Cambia la directory a \fIpercorso\fP prima di avviare il processo. Questo viene | |
183 | fatto dopo chroot, se viene usata l'opzione \fB\-r\fP|\fB\-\-chroot\fP. Quando non | |
184 | specificato, \fBstart\-stop\-daemon\fP cambia la directory in quella root prima | |
185 | di avviare il processo. | |
186 | .TP | |
187 | \fB\-b\fP, \fB\-\-background\fP | |
188 | Typically used with programs that don't detach on their own. This option | |
189 | will force \fBstart\-stop\-daemon\fP to fork before starting the process, and | |
190 | force it into the background. \fBWarning: start\-stop\-daemon\fP cannot check | |
191 | the exit status if the process fails to execute for \fBany\fP reason. This is a | |
192 | last resort, and is only meant for programs that either make no sense | |
193 | forking on their own, or where it's not feasible to add the code for them to | |
194 | do this themselves. | |
195 | .TP | |
196 | \fB\-C\fP, \fB\-\-no\-close\fP | |
197 | Do not close any file descriptor when forcing the daemon into the background | |
198 | (since version 1.16.5). Used for debugging purposes to see the process | |
199 | output, or to redirect file descriptors to log the process output. Only | |
200 | relevant when using \fB\-\-background\fP. | |
201 | .TP | |
202 | \fB\-N\fP, \fB\-\-nicelevel\fP \fIint\fP | |
203 | Modifica la priorità del processo prima di avviarlo. | |
204 | .TP | |
205 | \fB\-P\fP, \fB\-\-procsched\fP \fIpolitica\fP\fB:\fP\fIpriorità\fP | |
206 | This alters the process scheduler policy and priority of the process before | |
207 | starting it (since version 1.15.0). The priority can be optionally | |
208 | specified by appending a \fB:\fP followed by the value. The default \fIpriority\fP | |
209 | is 0. The currently supported policy values are \fBother\fP, \fBfifo\fP and \fBrr\fP. | |
210 | .TP | |
211 | \fB\-I\fP, \fB\-\-iosched\fP \fIclasse\fP\fB:\fP\fIpriorità\fP | |
212 | This alters the IO scheduler class and priority of the process before | |
213 | starting it (since version 1.15.0). The priority can be optionally | |
214 | specified by appending a \fB:\fP followed by the value. The default \fIpriority\fP | |
215 | is 4, unless \fIclass\fP is \fBidle\fP, then \fIpriority\fP will always be 7. The | |
216 | currently supported values for \fIclass\fP are \fBidle\fP, \fBbest\-effort\fP and | |
217 | \fBreal\-time\fP. | |
218 | .TP | |
219 | \fB\-k\fP, \fB\-\-umask\fP \fImaschera\fP | |
220 | This sets the umask of the process before starting it (since version | |
221 | 1.13.22). | |
222 | .TP | |
223 | \fB\-m\fP, \fB\-\-make\-pidfile\fP | |
224 | Used when starting a program that does not create its own pid file. This | |
225 | option will make \fBstart\-stop\-daemon\fP create the file referenced with | |
226 | \fB\-\-pidfile\fP and place the pid into it just before executing the | |
227 | process. Note, the file will only be removed when stopping the program if | |
228 | \fB\-\-remove\-pidfile\fP is used. \fBNote:\fP This feature may not work in all | |
229 | cases. Most notably when the program being executed forks from its main | |
230 | process. Because of this, it is usually only useful when combined with the | |
231 | \fB\-\-background\fP option. | |
232 | .TP | |
233 | \fB\-\-remove\-pidfile\fP | |
234 | Used when stopping a program that does not remove its own pid file (since | |
235 | version 1.17.19). This option will make \fBstart\-stop\-daemon\fP remove the | |
236 | file referenced with \fB\-\-pidfile\fP after terminating the process. | |
237 | .TP | |
238 | \fB\-v\fP, \fB\-\-verbose\fP | |
239 | Visualizza messaggi informativi dettagliati. | |
240 | . | |
241 | .SH "STATO D'USCITA" | |
242 | .TP | |
243 | \fB0\fP | |
244 | L'azione richiesta è stata effettuata. Se è stata specificata \fB\-\-oknodo\fP, è | |
245 | anche possibile che non sia stato necessario fare nulla. Ciò può avvenire | |
246 | quando viene specificata l'opzione \fB\-\-start\fP e un processo corrispondente è | |
247 | già in esecuzione, oppure quando viene specificata \fB\-\-stop\fP e non c'è alcun | |
248 | processo corrispondente. | |
249 | .TP | |
250 | \fB1\fP | |
251 | Se non è stata specificata \fB\-\-oknodo\fP e non è stato fatto nulla. | |
252 | .TP | |
253 | \fB2\fP | |
254 | Se sono state specificate \fB\-\-stop\fP e \fB\-\-retry\fP, ma è stata raggiunta la | |
255 | fine della pianificazione e il processo era ancora in esecuzione. | |
256 | .TP | |
257 | \fB3\fP | |
258 | Qualsiasi altro errore. | |
259 | .PP | |
260 | Quando si usa il comando \fB\-\-status\fP, vengono restituiti i seguenti codici | |
261 | di stato: | |
262 | .TP | |
263 | \fB0\fP | |
264 | Il programma è in esecuzione. | |
265 | .TP | |
266 | \fB1\fP | |
267 | Il programma non è in esecuzione e il file PID esiste. | |
268 | .TP | |
269 | \fB3\fP | |
270 | Il programma non è in esecuzione. | |
271 | .TP | |
272 | \fB4\fP | |
273 | Non è stato possibile determinare lo stato del programma. | |
274 | . | |
275 | .SH ESEMPIO | |
276 | Avvia il demone \fBpippod\fP, a meno che uno non sia già in esecuzione (un | |
277 | processo chiamato pippod, in esecuzione come utente pippod, con PID in | |
278 | pippod.pid): | |
279 | .IP | |
280 | .nf | |
281 | start\-stop\-daemon \-\-start \-\-oknodo \-\-user pippod \-\-name pippod \e | |
282 | \-\-pidfile /run/pippod.pid \-\-startas /usr/sbin/pippod \e | |
283 | \-\-chuid pippod \-\- \-\-daemon | |
284 | .fi | |
285 | .PP | |
286 | Invia \fBSIGTERM\fP a \fBpippod\fP e attende fino a 5 secondi che esso si fermi: | |
287 | .IP | |
288 | .nf | |
289 | start\-stop\-daemon \-\-stop \-\-oknodo \-\-user pippod \-\-name pippod \e | |
290 | \-\-pidfile /run/pippod.pid \-\-retry 5 | |
291 | .fi | |
292 | .PP | |
293 | Dimostrazione di una pianificazione personalizzata per fermare \fBpippod\fP: | |
294 | .IP | |
295 | .nf | |
296 | start\-stop\-daemon \-\-stop \-\-oknodo \-\-user pippod \-\-name pippod \e | |
297 | \-\-pidfile /run/pippod.pid \-\-retry=TERM/30/KILL/5 | |
298 | .fi |