82e1452c45460739a2cbcd2947c3e49378fdc68d
[gapil.git] / signal.tex
1 \chapter{I segnali}
2 \label{cha:signals}
3
4 I segnali sono il primo e più semplice meccanismo di comunicazione nei
5 confronti dei processi. Non portano con se nessuna informazione che non sia il
6 loro tipo, si tratta in sostanza di un'interruzione software portata ad un
7 processo.
8
9 In genere i segnali vengono usati dal kernel per riportare situazioni
10 eccezionali (come errori di accesso, eccezioni aritmetiche, etc.) ma possono
11 anche essere usati come forma elementare di comunicazione fra processi (ad
12 esempio vengono usati per il controllo di sessione), per notificare eventi
13 (come la terminazione di un processo figlio), etc.
14
15 \section{I concetti base}
16 \label{sec:sig_base}
17
18 Come il nome stesso indica i segnali sono usati per notificare ad un processo
19 l'occorrenza di un evento eccezionale. Gli eventi che possono generare un
20 segnale sono vari; un breve elenco di possibile cause è il seguente:
21
22 \begin{itemize}
23 \item un errore del programma, come una divisione per zero o un tentativo di
24   accesso alla memoria fuori dai limiti validi.
25 \item la terminazione di un processo figlio.
26 \item la scadenza di un timer o di un allarme.
27 \item il tentativo di effettuare un'operazione di input/output che non può
28   essere eseguita.
29 \item una richiesta dell'utente di terminare o fermare il programma. In genere
30   si realizza attraverso un segnale mandato dalla shell in corrispondenza
31   della pressione di tasti del terminale come 'ctrl-c' o 'ctrl-z'.
32 \item l'esecuzione di una \texttt{kill} o di una \texttt{raise} da parte del
33   processo stesso o di un'altro (solo nel caso della \texttt{kill}).
34 \end{itemize}
35
36 Ciascuno di questi eventi (tranne gli ultimi due che sono controllati
37 dall'utente) comporta l'intervento diretto da parte del kernel che causa la
38 generazione un particolare tipo di segnale.
39
40
41 \subsection{Le modalità di funzionamento}
42 \label{sec:sig_semantics}
43
44 Quando un processo riceve un segnale il kernel esegue una azione di default o
45 una apposita routine di gestione (il cosiddetto \textit{signal handler} o
46 \textsl{manipolatore}) che può essere specificata dall'utente (nel qual caso
47 si dice che si \textsl{intercetta} il segnale).  Negli anni il comportamento
48 del sistema in risposta ai segnali è stato modificato in vari modi nelle
49 differenti implementazioni di unix.  Si possono individuare due tipologie
50 fondamentali di comportamento dei segnali (dette semantiche) che vengono
51 chiamate rispettivamente \textit{reliable} e \textit{unreliable}.
52
53 Nella semantica \textit{unreliable} (quella implementata dalle prime versioni
54 di unix) la routine di gestione del segnale specificata dall'utente non resta
55 installata una volta chiamata; è perciò a carico dell'utente stesso ripetere
56 l'installazione all'interno della routine di gestione stessa in tutti i casi
57 in cui si vuole che il signal handler esterno resti attivo.
58
59 In questo caso è possibile una situazione in cui i segnali possono essere
60 perduti; si consideri il seguente segmento di codice in cui la prima
61 operazione del manipolatore è quella di reinstallare se stesso:
62 \footnotesize
63 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
64     int sig_handler();            /* handler function */
65     ...
66     signal(SIGINT, sig_handler);  /* establish handler */
67     ...
68
69 int sig_handler() 
70 {
71     signal(SIGINT, sig_handler);  /* restablish handler */
72     ...                           /* process signal */
73 }
74 \end{lstlisting}
75 \normalsize
76 se un secondo segnale arriva prima che il manipolatore invocato dal primo
77 abbia eseguito la re-installazione di se stesso il segnale può essere perso o
78 causare il comportamento originale assegnato al segnale (in genere la
79 terminazione del processo).
80
81 Questa è la ragione per cui l'implementazione dei segnali secondo questa
82 semantica viene chiamata \textit{inaffidabile}, in quanto la ricezione del
83 segnale e la reinstallazione del suo manipolatore non sono operazioni
84 atomiche.
85
86 Un'altro problema è che in questa semantica è che non esiste un modo per
87 bloccare i segnali quando non si vuole che arrivino; i processi possono si
88 ignorare il segnale, ma non è possibile istruire il sistema a non fare nulla
89 in occasione di un segnale, pur mantenendo memoria del fatto che è avvenuto.
90
91 Un caso classico, riportato da Stevens, in cui si incontra questo problema, è
92 quello in cui si usa il manipolatore per settare un flag che riporta al
93 processo l'occorrenza del segnale. Si consideri il seguente segmento di
94 codice il cui scopo sarebbe quello di fermare il processo fino all'occorrenza
95 di un opportuno segnale:
96 \footnotesize
97 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
98 int signal_flag = 0;
99 main ()
100 {
101     int sig_handler();            /* handler function */
102     ...
103     signal(SIGINT, sig_handler);  /* establish handler */
104     ...
105     while(signal_flag == 0) {     /* while flag is zero */
106         pause();                  /* go to sleep */
107     }
108     ... 
109 }
110 int sig_handler() 
111 {
112     signal(SIGINT, sig_handler);  /* restablish handler */
113     signal_flag = 1;              /* set flag */
114 }
115 \end{lstlisting}
116 \normalsize
117 l'idea è che quando il processo trova il flag a zero viene messo in sleep e
118 verrà risvegliato solo dalla ricezione di un segnale. Il manipolatore si
119 limita in questo caso a settare il flag a uno; all'uscita dal manipolatore la
120 chiamata a \func{pause} è interrotta ed il processo viene risvegliato e
121 riprende l'esecuzione all'istruzione successiva, ma essendo cambiato il flag
122 la condizione non è più soddisfatta e il programma prosegue.
123
124 Il problema con l'implementazione inaffidabile è che niente ci garantisce che
125 il segnale arrivi fra la valutazione della condizione del \func{while} e la
126 chiamata a \func{pause}, nel qual caso, se il segnale non viene più generato,
127 il processo resterà in sleep permanentemente.
128
129 % Un'altra caratteristica della implementazione inaffidabile è che le chiamate
130 % di sistema non sono fatte ripartire automaticamente quando sono interrotte da
131 % un segnale, per questo un programma deve controllare lo stato di uscita della
132 % chiamata al sistema e riperterla nel caso l'errore riportato da \texttt{errno}
133 % sia \texttt{EINTR}.
134
135 Questo ci mostra ad esempio come con la semantica inaffidabile non esista una
136 modalità semplice per ottenere una operazione di pausa atomica (cioè mandare
137 in sleep un processo fino all'arrivo di un segnale).
138
139 Nella semantica \textit{reliable} (quella utilizzata da Linux e da ogni Unix
140 moderno) invece il signal handler una volta installato resta attivo e non si
141 hanno tutti i problemi precedenti. In questa semantica i segnali vengono
142 \textsl{generati} dal kernel per un processo all'occorrenza dell'evento che
143 causa il segnale. In genere questo viene fatto dal kernel settando un flag
144 nella process table del processo.
145
146 Si dice che il segnale viene \textsl{consegnato} al processo (dall'inglese
147 \textit{delivered}) quando viene eseguita l'azione per esso prevista, mentre
148 per tutto il tempo che passa fra la generazione del segnale e la sua consegna
149 esso è detto \textsl{pendente}. In genere questa procedura viene effettuata
150 dal kernel quando, riprendendo l'esecuzione del processo in questione, verifica
151 la presenza del flag del segnale nella process table.
152
153 In questa semantica un processo ha la possibilità di bloccare la consegna dei
154 segnali, in questo caso se l'azione per il suddetto segnale non è quella di
155 ignorarlo, il segnale resta \textsl{pendente} fintanto che il processo non lo
156 sblocca (nel qual caso viene consegnato) o setta l'azione di default per
157 ignorarlo. 
158
159 Si tenga presente kernel stabilisce cosa fare con un segnale che è stato
160 bloccato al momento della consegna, non quando viene generato; questo consente
161 di cambiare l'azione per il segnale prima che esso venga consegnato, e si può
162 usare la funzione \func{sigpending} (vedi \secref{sec:sig_sigpending}) per
163 determinare quali segnali sono bloccati e quali sono pendenti.
164
165
166
167 \subsection{Tipi di segnali}
168 \label{sec:sig_types}
169
170 In generale gli eventi che generano i segnali si possono dividere in tre
171 categorie principali: errori, eventi e richieste esplicite. 
172
173 Un errore significa che un programma ha fatto qualcosa di sbagliato e non può
174 continuare ad essere eseguito. Non tutti gli errori causano dei segnali, in
175 genere la condizione di errore più comune comporta la restituzione di un
176 codice di errore da parte di una funzione di libreria, sono gli errori che
177 possono avvenire ovunque in un programma che causano l'emissione di un
178 segnale, come le divisioni per zero o l'uso di indirizzi di memoria non validi.
179
180 Un evento esterno ha in genere a che fare con l'I/O o con altri processi;
181 esempi di segnali di questo tipo sono quelli legati all'arrivo di dati di
182 input, scadenze di un timer, terminazione di processi figli.
183
184 Una richiesta esplicita significa l'uso di una chiamata di sistema (come
185 \texttt{kill} o \texttt{raise}) per la generazione di un segnale, cosa che
186 viene fatta usualmente dalla shell quando l'utente invoca la sequenza di tasti
187 di stop o di suspend, ma può essere pure inserita all'interno di un programma.
188
189 Si dice poi che i segnali possono essere \textit{asincroni} o
190 \textit{sincroni}. Un segnale sincrono è legato ad una azione specifica di un
191 programma ed è inviato (a meno che non sia bloccato) durante tale azione;
192 molti errori generano segnali sincroni, così come la richiesta esplicita da
193 parte del processo tramite le chiamate al sistema. Alcuni errori come la
194 divisione per zero non sono completamente sincroni e possono arrivare dopo
195 qualche istruzione.
196
197 I segnali asincroni sono generati da eventi fuori dal controllo del processo
198 che li riceve e arrivano in tempi impredicibili nel corso dell'esecuzione del
199 programma. Eventi esterni come la terminazione di un processo figlio generano
200 segnali asincroni, così come le richieste di generazione di un segnale
201 effettuate da altri processi.
202
203 In generale un tipo di segnale o è sincrono o è asincrono, salvo il caso in
204 cui esso sia generato attraverso una richiesta esplicita tramite chiamata al
205 sistema, nel qual caso qualunque tipo di segnale (quello scelto nella
206 chiamata) può diventare sincrono o asincrono a seconda che sia generato
207 internamente o esternamente al processo.
208
209 \subsection{La notifica dei segnali}
210 \label{sec:sig_notification}
211
212 Quando un segnale viene generato il kernel prende nota del fatto; si dice così
213 che diventa \textit{pending} (sospeso), e rimarrà tale fino al momento in cui
214 verrà notificato al processo a cui deve essere inviato.
215
216 Normalmente l'invio al processo che deve ricevere il segnale è immediato, a
217 meno che il segnale in questione non sia stato bloccato (\textit{blocked}) nel
218 qual caso l'invio non avviene ed il segnale resta sospeso indefinitamente. Una
219 volta però che esso venga sbloccato il segnale sarà subito notificato.
220
221 Una volta che il segnale viene notificato (che questo avvenga subito o dopo
222 una attesa più o meno lunga) viene eseguita l'azione specificata per detto
223 segnale. Per alcuni segnali (\texttt{SIGKILL} e \texttt{SIGSTOP}) questa azione
224 è fissa e non può essere cambiata, ma per tutti gli altri il programma può
225 specificare una scelta fra le tre seguenti:
226
227 \begin{itemize}
228 \item ignorare il segnale.
229 \item catturare il segnale, ed utilizzare il manipolatore (\textit{signal
230     handler}) specificato.
231 \item accettare l'azione di default per quel segnale.
232 \end{itemize}
233
234 Il programma può specificare queste scelte usano le due routine
235 \texttt{signal} e \texttt{sigaction}; se si è installato un manipolatore sarà
236 quest'ultimo a intercettare il segnale ed ad essere eseguito, e mentre viene
237 eseguito (onde evitare race conditions) il segnale viene bloccato.
238
239 Se l'azione specificata per un certo tipo di segnale è quella di ignorarlo
240 questo sarà scartato immediatamente ogni volta che verrà generato, e questo
241 avverrà anche se in quel momento il segnale è bloccato. Per questo un segnale
242 ignorato non sarà mai notificato, anche se in seguito si sarà specificata una
243 diversa azione per lo stesso segnale.
244
245 Se arriva un segnale per il quale non è stato specificata un'azione viene
246 utilizzata l'azione standard. Questa è diversa da segnale a segnale (come
247 vedremo in \secref{sec:sig_standard}) ma per la maggior parte essa comporta la
248 terminazione del processo, per alcuni che invece rappresentano eventi innocui
249 l'azione standard è di non fare nulla.
250
251 Quando un segnale termina un processo, il padre può determinare la causa della
252 terminazione esaminando il codice di stato riportato delle funzioni
253 \texttt{wait} e \texttt{waitpid} in cui è riportato anche se la causa è un
254 segnale e nel caso quale; questo è il modo in cui la shell determina i motivi
255 della terminazione di un programma e scrive un eventuale messaggio di errore.
256
257 I segnali che rappresentano errori del programma (divisione per zero o
258 violazioni di accesso) hanno anche la caratteristica di scrivere un file
259 \textit{core dump} che registra lo stato del processo prima della terminazione
260 e può essere esaminato da un debugger per investigare sulla causa dell'errore.
261 Lo stesso avviene se i suddetti segnale vengono generati artificialmente con
262 una \texttt{kill}.
263
264
265
266 \section{I segnali standard}
267 \label{sec:sig_standard}
268
269 Esaminiamo ora i vari segnali disponibili e le loro caratteristiche. 
270 Ciascun segnale è identificato rispetto al sistema da un numero, ma l'uso
271 diretto di questo numero da parte dei programmi è da evitare, in quanto esso
272 può variare a seconda dell'implementazione del sistema.
273
274 Per questo ad ogni tipo di segnale viene associato un nome, che corrisponde,
275 tramite una macro di preprocessore, al suddetto numero. Sono questi nomi, che
276 sono standardizzati e uniformi rispetto alle varie implementazioni, che si
277 devono usare nei programmi. Tutti i nomi e le funzioni che concernono i
278 segnali sono definiti nell'header di sistema \texttt{signal.h}.
279
280 Il numero totale di segnali presenti è dato dalla macro \macro{NSIG}, e dato
281 che i numeri dei segnali sono allocati progressivamente, essa corrisponde
282 anche al successivo del valore numerico assegnato all'ultimo segnale definito.
283 In \ntab\ si è riportato l'elenco completo dei segnali definiti in Linux
284 (estratto dalle man page), comparati con quelli definiti in vari standard.
285 \begin{table}[htb]
286   \footnotesize
287   \centering
288   \begin{tabular}[c]{|l|c|c|c||c|p{6cm}|}
289     \hline
290     Segnale  & POSIX.1 & SUSv2 & Linux  &Azione &  Descrizione \\
291     \hline
292     \hline
293     SIGHUP   &$\bullet$&&$\bullet$&  A  & Hangup  o
294     fine del processo di controllo  \\
295     SIGINT   &$\bullet$&&$\bullet$&  A  & Interrupt da tastiera (\cmd{C-c})\\
296     SIGQUIT  &$\bullet$&&$\bullet$&  C  & Quit da tastiera (\cmd{C-y}) \\
297     SIGILL   &$\bullet$&&$\bullet$&  C  & Istruzione illegale\\
298     SIGABRT  &$\bullet$&&$\bullet$&  C  & Segnale di Abort da \func{abort} \\
299     SIGFPE   &$\bullet$&&$\bullet$&  C  & Errore aritmetico\\
300     SIGKILL  &$\bullet$&&$\bullet$& AEF & Segnale di terminazione forzata \\
301     SIGSEGV  &$\bullet$&&$\bullet$&  C  & Errore di accesso in memoria\\
302     SIGPIPE  &$\bullet$&&$\bullet$&  A  & Pipe spezzata\\
303     SIGALRM  &$\bullet$&&$\bullet$&  A  & Segnale del timer da \func{alarm} \\
304     SIGTERM  &$\bullet$&&$\bullet$&  A  & Segnale di terminazione \verb|C-\|\\
305     SIGUSR1  &$\bullet$&&$\bullet$&  A  & User-defined signal 1\\
306     SIGUSR2  &$\bullet$&&$\bullet$&  A  & User-defined signal 2\\
307     SIGCHLD  &$\bullet$&&$\bullet$&  B  & Child stopped or terminated\\
308     SIGCONT  &$\bullet$&&$\bullet$&     & Continue if stopped\\
309     SIGSTOP  &$\bullet$&&$\bullet$& DEF & Stop process\\
310     SIGTSTP  &$\bullet$&&$\bullet$&  D  & Stop typed at tty \\
311     SIGTTIN  &$\bullet$&&$\bullet$&  D  & tty input for background process \\
312     SIGTTOU  &$\bullet$&&$\bullet$&  D  & tty output for background process \\
313     SIGBUS   &&$\bullet$&$\bullet$& C & Bus error (bad memory access) \\
314     SIGPOLL  &&$\bullet$&$\bullet$& A & Pollable event (Sys V). Synonym of SIGIO\\
315     SIGPROF   &&$\bullet$&$\bullet$& A & Profiling timer expired \\
316     SIGSYS    &&$\bullet$&$\bullet$& C & Bad argument to routine (SVID)\\
317     SIGTRAP   &&$\bullet$&$\bullet$& C & Trace/breakpoint trap \\
318     SIGURG    &&$\bullet$&$\bullet$& B & Urgent condition on socket (4.2 BSD)\\
319     SIGVTALRM &&$\bullet$&$\bullet$& A & Virtual alarm clock (4.2 BSD) \\
320     SIGXCPU   &&$\bullet$&$\bullet$& C & CPU time limit exceeded (4.2 BSD)  \\
321     SIGXFSZ   &&$\bullet$&$\bullet$& C & File size limit exceeded (4.2 BSD)\\
322     SIGIOT    &&&$\bullet$& C &     IOT trap. A synonym for SIGABRT        \\
323     SIGEMT    &&&$\bullet$&   &                                            \\
324     SIGSTKFLT &&&$\bullet$& A &     Stack fault on coprocessor             \\
325     SIGIO     &&&$\bullet$& A &     I/O now possible (4.2 BSD)             \\
326     SIGCLD    &&&$\bullet$&   &     A synonym for SIGCHLD                  \\
327     SIGPWR    &&&$\bullet$& A &     Power failure (System V)               \\
328     SIGINFO   &&&$\bullet$&   &     A synonym for SIGPWR                   \\
329     SIGLOST   &&&$\bullet$& A &     File lock lost                         \\
330     SIGWINCH  &&&$\bullet$& B &     Window resize signal (4.3 BSD, Sun)    \\
331     SIGUNUSED &&&$\bullet$& A &     Unused signal (will be SIGSYS)         \\
332     \hline
333   \end{tabular}
334   \caption{Lista dei segnali in Linux}
335   \label{tab:sig_signal_list}
336 \end{table}
337 in \curtab\ si sono riportate le azioni di default di ciascun segnale
338 (riassunte con delle lettere, la cui legenda completa è in \ntab), quando
339 nessun manipolatore è installato un segnale può essere ignorato o causare la
340 terminazione del processo.
341
342 In alcuni casi alla terminazione del processo è associata la creazione di un
343 file (posto nella directory corrente del processo e chiamato \file{core}) su
344 cui viene salvata un'immagine della memoria del processo (il cosiddetto
345 \textit{core dump}), che può essere usata da un debugger per esaminare lo
346 stato dello stack e delle variabili al momento della ricezione del segnale.
347
348 \begin{table}[htb]
349   \centering
350   \begin{tabular}[c]{|c|p{8cm}|}
351     \hline
352     Sigla & Significato \\
353     \hline
354     \hline
355     A & L'azione di default è terminare il processo. \\
356     B & L'azione di default è ignorare il segnale. \\
357     C & L'azione di default è terminare il processo e scrivere un \textit{core
358         dump}. \\
359     D & L'azione di default è fermare il processo. \\
360     E & Il segnale non può essere intercettato. \\
361     F & Il segnale non può essere ignorato.\\
362     \hline
363   \end{tabular}
364   \caption{Legenda delle caratteristiche dei segnali riportate in 
365     \tabref{tab:sig_signal_list}. }
366   \label{tab:sig_action_leg}
367 \end{table}
368
369 La descrizione dettagliata del significato dei vari segnali, raggruppati per
370 tipologia, verrà affrontate nel seguito.
371
372 \subsection{Segnali di errore di programma}
373 \label{sec:sig_prog_error}
374
375 Questi segnali sono generati quando il sistema, o in certi casi direttamente
376 l'hardware (come per i page fault non validi) rileva un qualche errore
377 insanabile nel programma in esecuzione. In generale la generazione di questi
378 segnali significa che il programma ha dei gravi problemi (ad esempio ha
379 dereferenziato un puntatore non valido o ha eseguito una operazione aritmetica
380 proibita) e l'esecuzione non può essere proseguita.
381
382 In genere si intercettano questi segnali per permettere al programma di
383 terminare in maniera pulita, ad esempio per ripristinare i settaggi della
384 console o eliminare i file di lock prima dell'uscita.  In questo caso il
385 manipolatore deve concludersi ripristinando l'azione di default e rialzando il
386 segnale, in questo modo il programma si concluderà senza effetti spiacevoli,
387 ma riportando lo stesso stato di uscita che avrebbe avuto se il manipolatore
388 non ci fosse stato.
389
390 L'azione di default per tutti questi segnali è causare la terminazione del
391 processo che li ha causati. In genere oltre a questo il segnale provoca pure
392 la registrazione su disco di un file di \textit{core dump} che viene scritto
393 in un file \file{core} nella directory corrente del processo al momento
394 dell'errore, che il debugger può usare per ricostruire lo stato del programma
395 al momento della terminazione.
396
397 Questi segnali sono:
398 \begin{description}
399 \item \macro{SIGFPE} Riporta un errore aritmetico fatale. Benché il nome
400   derivi da \textit{floating point exception} si applica a tutti gli errori
401   aritmetici compresa la divisione per zero e l'overflow. 
402
403 %   Per questo segnale le cose sono complicate dal fatto che possono esserci
404 %   molte diverse eccezioni che \texttt{SIGFPE} non distingue, mentre lo
405 %   standard IEEE per le operazioni in virgola mobile definisce vaire eccezioni
406 %   aritmetiche e richiede che esse siano notificate.  
407
408 \item \macro{SIGILL} Il nome deriva da \textit{illegal instruction},
409   significa che il programma sta cercando di eseguire una istruzione
410   privilegiata o inesistente, in generale del codice illegale. Poiché il
411   compilatore del C genera del codice valido si ottiene questo segnale se il
412   file eseguibile è corrotto o si stanno cercando di eseguire dei dati.
413   Quest'ultimo caso può accadere quando si passa un puntatore sbagliato al
414   posto di un puntatore a funzione, o si eccede la scrittura di un vettore di
415   una variabile locale, andando a corrompere lo stack. Lo stesso segnale viene
416   generato in caso di overflow dello stack o di problemi nell'esecuzione di di
417   un signal handler.
418 \item \macro{SIGSEGV} Il nome deriva da \textit{segment violation}, e
419   significa che il programma sta cercando di leggere o scrivere in una zona di
420   memoria protetta al di fuori di quella che gli è stata riservata dal
421   sistema. In genere è il meccanismo della protezione della memoria che si
422   accorge dell'errore ed il kernel genera il segnale.
423
424   È tipico ottenere questo segnale dereferenziando un puntatore nullo o non
425   inizializzato leggendo al di la della fine di un vettore. 
426 \item \macro{SIGBUS} Il nome deriva da \textit{bus error}. Come
427   \macro{SIGSEGV} questo è un segnale che viene generato di solito quando si
428   dereferenzia un puntatore non inzializzato, la differenza è che
429   \macro{SIGSEGV} indica un accesso non permesso su un indirizzo esistente
430   (tipo fuori dallo heap o dallo stack), mentre \macro{SIGBUS} indica
431   l'accesso ad un indirizzo non valido, come nel caso di un puntatore non
432   allineato.
433 \item \macro{SIGABRT} Il nome deriva da \textit{abort}. Il segnale indica che
434   il programma stesso ha rilevato un errore che viene riportato chiamando la
435   funzione \func{abort} che genera questo segnale.
436 \item \macro{SIGTRAP} È il segnale generato da un'istruzione di breakpoint o
437   dall'attivazione del tracciamento per il processo. È usato dai programmi per
438   il debugging e se un programma normale non dovrebbe ricevere questo segnale.
439 \item \macro{SIGSYS} Sta ad indicare che si è eseguita una istruzione che
440   richiede l'esecuzione di una system call, ma si è fornito un codice
441   sbagliato per quest'ultima.
442 \end{description}
443
444
445 \subsection{I segnali di terminazione}
446 \label{sec:sig_termination}
447
448 Questo tipo di segnali sono usati per terminare un processo; hanno vari nomi a
449 causa del differente uso che se ne può fare, ed i programmi possono
450 trattarli in maniera differente. 
451
452 La ragione per cui può essere necessario trattare questi segnali è che il
453 programma può dover eseguire una serie di azioni di pulizia prima di
454 terminare, come salvare informazioni sullo stato in cui si trova, cancellare
455 file temporanei, o ripristinare delle condizioni alterate durante il
456 funzionamento (tipi il modo del terminale o i settaggi di una qualche
457 periferica).
458
459 L'azione di default di questi segnali è di terminare il processo, questi
460 segnali sono:
461 \begin{description}
462 \item \macro{SIGTERM} Il nome sta per \textit{terminate}. È un segnale
463   generico usato per causare la conclusione di un programma. Al contrario di
464   \macro{SIGKILL} può essere intercettato, ignorato, bloccato. In genere lo si
465   usa per chiedere in maniera ``educata'' ad un processo di concludersi.
466 \item \macro{SIGINT} Il nome sta per \textit{interrupt}. È il segnale di
467   interruzione per il programma. È quello che viene generato di default dal
468   comando \cmd{kill} o dall'invio sul terminale del carattere di controllo
469   INTR (interrupt, generato dalla sequenza \macro{C-c}).
470 \item  \macro{SIGQUIT} È analogo a \macro{SIGINT} con la differenze che è
471   controllato da un'altro carattere di controllo, QUIT, corrispondente alla
472   sequenza \macro{C-\\}. A differenza del precedente l'azione di default,
473   oltre alla terminazione del processo, comporta anche la creazione di un core
474   dump. 
475
476   In genere lo si può pensare come corrispondente ad una condizione di
477   errore del programma rilevata dall'utente. Per questo motivo non è opportuno
478   fare eseguire al manipolatore di questo segnale le operazioni di pulizia
479   normalmente previste (tipo la cancellazione di file temporanei), dato che in
480   certi casi esse possono eliminare informazioni utili nell'esame dei core
481   dump. 
482 \item \macro{SIGKILL} Il nome è utilizzato per terminare in maniera immediata
483   qualunque programma. Questo segnale non può essere né intercettato, né
484   ignorato, né bloccato, per cui causa comunque la terminazione del processo.
485   In genere esso viene generato solo per richiesta esplicita dell'utente dal
486   comando (o tramite la funzione) \cmd{kill}. Dato che non lo si può
487   intercettare è sempre meglio usarlo come ultima risorsa quando metodi meno
488   brutali, come \macro{SIGTERM} o \macro{C-c} non funzionano. 
489
490   Se un processo non risponde a nessun altro segnale \macro{SIGKILL} ne causa
491   sempre la terminazione (in effetti il fallimento della terminazione di un
492   processo da parte di \macro{SIGKILL} costituirebbe un funzionamento del
493   kernel). Talvolta è il sistema stesso che può generare questo segnale quando
494   per condizioni particolari il processo non può più essere eseguito neanche
495   per eseguire il manipolatore.
496 \item \macro{SIGHUP} Il nome sta per \textit{hang-up}. Segnala che il
497   terminale dell'utente si è disconnesso (ad esempio perché si è interrotta la
498   rete). Viene usato anche per riportare la terminazione del processo di
499   controllo di un terminale a tutti i processi della sessione, in modo che
500   essi possano disconnettersi dal relativo terminale. 
501   
502   Viene inoltre usato in genere per segnalare ai demoni (che non hanno un
503   terminale di controllo) la necessità di reinizializzarsi e rileggere il/i
504   file di configurazione.
505 \end{description}
506
507 \subsection{I segnali di allarme}
508 \label{sec:sig_alarm}
509
510 Questi segnali sono generati dalla scadenza di un timer. Il loro comportamento
511 di default è quello di causare la terminazione del programma, ma con questi
512 segnali la scelta di default è irrilevante, in quanto il loro uso presuppone
513 sempre la necessità di un manipolatore.  Questi segnali sono:
514 \begin{description}
515 \item \macro{SIGALRM} Il nome sta per \textit{alarm}. Segnale la scadenza di
516   un timer misurato sul tempo reale o sull'orologio di sistema. È normalmente
517   usato dalla funzione \func{alarm}.
518 \item  \macro{SIGVTALRM} Il nome sta per \textit{virtual alarm}. È analogo al
519   precedente ma segnala la scadenza di un timer sul tempo di CPU usato dal
520   processo. 
521 \item \macro{SIGPROF} Il nome sta per \textit{profiling}. Indica la scadenza
522   di un timer che misura sia il tempo di CPU speso direttamente dal processo
523   che quello che il sistema ha speso per conto di quest'ultimo. In genere
524   viene usato dai tool che servono a fare il profilo d'uso della CPU da parte
525   del processo.
526 \end{description}
527
528
529 \subsection{I segnali di I/O asincrono}
530 \label{sec:sig_asyncio}
531
532 Questi segnali operano in congiunzione con le funzioni di I/O asincrono. Per
533 questo occorre comunque usare \func{fcntl} per abilitare un file descriptor a
534 generare questi segnali. 
535
536 L'azione di default è di essere ignorati. Questi segnali sono:
537 \begin{description}
538 \item \macro{SIGIO} Questo segnale viene inviato quando un file descriptor è
539   pronto per eseguire dell'input/output. In molti sistemi solo i socket e i
540   terminali possono generare questo segnale, in Linux questo può essere usato
541   anche per i file, posto che la \func{fcntl} abbia avuto successo.
542 \item \macro{SIGURG} Questo segnale è inviato quando arrivano dei dati
543   urgenti o \textit{out of band} su di un socket; per maggiori dettagli al
544   proposito si veda \secref{sec:xxx_urgent_data}.
545 \item \macro{SIGPOLL} Questo segnale è equivalente a \macro{SIGIO}, è
546   definito solo per compatibilità con i sistemi System V.
547 \end{description}
548
549 \subsection{I segnali per il controllo di sessione}
550 \label{sec:sig_job_control}
551
552 Questi sono i segnali usati dal controllo delle sessioni e dei processi, il
553 loro uso è specifico e viene trattato in maniera specifica nelle sezioni in
554 cui si trattano gli argomenti relativi.  Questi segnali sono:
555 \begin{description} 
556 \item \macro{SIGCHLD} Questo è il segnale mandato al processo padre quando un
557   figlio termina o viene fermato. L'azione di default è di ignorare il
558   segnale, la sua gestione è trattata in \secref{sec:proc_wait}.
559 \item \macro{SIGCLD} Per Linux questo è solo un segnale identico al
560   precedente, il nome è obsoleto e andrebbe evitato. 
561 \item \macro{SIGCONT} Il nome sta per \textit{continue}. Il segnale viene
562   usato per fare ripartire un programma precedentemente fermato da
563   \macro{SIGSTOP}. Questo segnale ha un comportamento speciale, e fa sempre
564   ripartire il processo prima della sua consegna. Il comportamento di default
565   è di fare solo questo; il segnale non può essere bloccato. Si può anche
566   installare un manipolatore, ma il segnale provoca comunque il riavvio del
567   processo.
568   
569   La maggior pare dei programmi non hanno necessità di intercettare il
570   segnale, in quanto esso è completamente trasparente rispetto all'esecuzione
571   che riparte senza che il programma noti niente. Si possono installare dei
572   manipolatori per far si che un programma produca una qualche azione speciale
573   se viene fermato e riavviato, come per esempio riscrivere un prompt, o
574   inviare un avviso. 
575 \item \macro{SIGSTOP} Il segnale ferma un processo (lo porta in uno stato di
576   sleep); il segnale non può essere né intercettato, né ignorato, né bloccato.
577 \item \macro{SIGTSTP} Il nome sta per \textit{interactive stop}. Il segnale
578   ferma il processo interattivamente, ed è generato dal carattere SUSP
579   (prodotto dalla combinazione \macro{C-z}), ed al contrario di
580   \macro{SIGSTOP} può essere intercettato e ignorato. In genere un programma
581   installa un manipolatore per questo segnale quando vuole lasciare il sistema
582   o il terminale in uno stato definito prima di fermarsi; se per esempio un
583   programma ha disabilitato l'eco sul terminale può installare un manipolatore
584   per riabilitarlo prima di fermarsi.
585 \item \macro{SIGTTIN} 
586 \item \macro{SIGTTOU}
587 \end{description}
588
589 \subsection{I segnali di operazioni errate}
590 \label{sec:sig_oper_error}
591
592 Questi segnali sono usati per riportare al programma errori generati da
593 operazioni da lui eseguite; non indicano errori del programma quanto errori
594 che impediscono il completamento dell'esecuzione dovute all'interazione con il
595 resto del sistema.
596
597 L'azione di default di questi segnali è di terminare il processo, questi
598 segnali sono:
599 \begin{description}
600 \item \macro{SIGPIPE} Sta per \textit{Broken pipe}. Se si usano delle pipe o
601   delle FIFO è necessario che, prima che un processo inizi a scrivere su di
602   essa, un'altro abbia aperto la pipe in lettura (si veda
603   \secref{sec:ipc_pipes}). Se il processo in lettura non è partito o è
604   terminato inavvertitamente alla scrittura sulla pipe il kernel genera questo
605   segnale. Se il segnale è bloccato, intercettato o ignorato la chiamata che
606   lo ha causato fallisce restituendo l'errore \macro{EPIPE} 
607 \item \macro{SIGLOST} Sta per \textit{Resource lost}.
608 \item \macro{SIGXCPU} Sta per \textit{CPU time limit exceeded}.
609 \item \macro{SIGXFSZ} Sta per \textit{File size limit exceeded}.
610 \end{description}
611
612
613 \subsection{Ulteriori segnali}
614 \label{sec:sig_misc_sig}
615
616 Raccogliamo qui infine usa serie di segnali che hanno scopi differenti non
617 classificabili in maniera omogenea. Questi segnali sono:
618 \begin{description}
619 \item \macro{SIGUSR1} e \macro{SIGUSR2} Sono due segnali a disposizione
620   dell'utente che li può usare per quello che vuole. Possono essere utili per
621   implementare una comunicazione elementare fra processi diversi, o per
622   eseguire a richiesta una operazione utilizzando un manipolatore. L'azione di
623   default è terminare il processo.
624 \item \macro{SIGWINCH} Il nome sta per \textit{window (size) change} ed è
625   generato da molti sistemi (GNU/Linux compreso) quando le dimensioni (in
626   righe e colonne) di un terminale vengono cambiate. Viene usato da alcuni
627   programmi testuali per riformattare l'uscita su schermo quando si cambia
628   dimensione a quest'ultimo. L'azione di default è di essere ignorato.
629 \item  \macro{SIGINFO} Il segnale indica una richiesta di informazioni. È
630   usato con il controllo di sessione, causa la stampa di informazioni da parte
631   del processo leader del gruppo associato al terminale di controllo, gli
632   altri processi lo ignorano.
633 \end{description}
634
635
636 \subsection{Le funzioni \func{strsignal} e \func{psignal}}
637 \label{sec:sig_strsignal}
638
639 Per la descrizione dei segnali il sistema mette a disposizione due funzioni
640 che stampano un messaggio di descrizione dato il numero. In genere si usano
641 quando si vuole notificare all'utente il segnale avvenuto (nel caso di
642 terminazione di un processo figlio o di un manipolatore che gestisce più
643 segnali); la prima funzione è una estensione GNU ed è analoga alla funzione
644 \func{strerr} per gli errori:
645 \begin{prototype}{string.h}{char * strsignal (int signum)} 
646   Ritorna il puntatore ad una stringa allocata staticamente che contiene la
647   descrizione del segnale \var{signum}. 
648 \end{prototype}
649
650 Dato che la stringa è allocata staticamente non se ne deve modificare il
651 contenuto, che resta valido solo fino alla successiva chiamata di
652 \func{strsignal}; nel caso si debba mantenere traccia del messaggio sarà
653 necessario copiarlo.
654
655 La seconda funzione deriva da BSD ed è analoga alla funzione \func{perror}
656 descritta in \secref{sec:intro_strerror}.
657
658
659 \section{La gestione dei segnali}
660 \label{sec:sig_handlers}
661
662 I segnali sono il primo e più classico esempio di eventi asincroni, che
663 possono accadere in un qualunque momento durante l'esecuzione di un programma.
664 Non essendo sotto il controllo del programma la gestione dei segnali non potrà
665 essere controllata all'interno del flusso di esecuzione di quest'ultimo, ma
666 tutto quello che si potrà fare è di specificare (al kernel, che li genera)
667 quale azione andrà intrapresa quando essi si verificano.
668
669 In questa sezione vedremo allora come si gestiscono i segnali, esaminando le
670 funzioni che si usano per effettuare la gestione dei segnali ed analizzando le
671 problematiche relative alla gestione di eventi asincroni di questo tipo.
672
673
674 \subsection{La funzione \func{signal}}
675 \label{sec:sig_signal}
676
677 L'interfaccia più semplice alla manipolazione dei segnali è costituita dalla
678 funzione \func{signal}; questa funzione è definita fin dallo standard ANSI C
679 che però non considera sistemi multitasking, per cui la sua definizione in
680 tale standard è tanto vaga da essere del tutto inutile in un sistema unix, per
681 questo ogni implementazione successiva ne ha modificato e ridefinito il
682 comportamento, pur mantenendone immutato il prototipo\footnote{in realtà
683   alcune vecchie implementazioni (SVR4 e 4.3+BSD) usano parametri aggiuntivi
684   per definire il comportamento della funzione} che è:
685 \begin{prototype}{signal.h}
686   {sighandler\_t signal(int signum, sighandler\_t handler)} 
687   
688   Installa una nuova funzione di gestione (manipolatore) per il segnale
689   \param{signum}, usando il manipolatore \param{handler}.
690   
691   La funzione ritorna il precedente manipolatore in caso di successo o
692   \macro{SIG\_ERR} in caso di errore.
693 \end{prototype}
694
695 In questa definizione si è usato il tipo \type{sighandler\_t} che è una
696 estensione GNU definita in Linux che permette di riscrivere il prototipo in
697 forma più leggibile dell'originario \func{void (*signal(int signum, void
698   (*handler)(int)))int)}, e che è sostanzialmente equivalente alla
699 definizione:
700 \begin{verbatim}
701 typedef void (* sighandler_t)(int) 
702 \end{verbatim}
703 cioè un puntatore ad una funzione di tipo \type{void} con un parametro di tipo
704 \type{int}\footnote{si devono usare le parentesi intorno al nome della
705   funzione per via delle precedenze degli operatori del C, senza di esse si
706   sarebbe definita una funzione che ritorna un puntatore a \type{void} e non
707   un puntatore ad una funzione \type{void}}.
708
709 Il numero di segnale passato in \param{signum} segnale può essere indicato
710 direttamente con una delle costanti definite in \secref{sec:sig_standard}, il
711 manipolatore \param{handler} invece, oltre all'indirizzo della funzione da
712 chiamare all'occorrenza del segnale, può assumere anche i valori costanti
713 \macro{SIG\_IGN} con cui si dice ignorare il segnale e \macro{SIG\_DFL} per
714 installare l'azione di di default (si ricordi però che i due segnali
715 \macro{SIGKILL} e \macro{SIGSTOP} non possono essere ignorati né
716 intercettati).
717
718
719 \subsection{Funzioni rientranti e default dei segnali}
720 \label{sec:sig_reentrant}
721