eeefd982d7f2115f4b9c100ac905a4151947e3d1
[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 sé 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 essi vengono usati dal kernel per riportare ai processi 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), ecc.
14
15 In questo capitolo esamineremo i vari aspetti della gestione dei segnali,
16 partendo da una introduzione relativa ai concetti base con cui essi vengono
17 realizzati, per poi affrontarne la classificazione a secondo di uso e modalità
18 di generazione fino ad esaminare in dettaglio funzioni e le metodologie di
19 gestione.
20
21
22 \section{Introduzione}
23 \label{sec:sig_intro}
24
25 In questa sezione esamineremo i concetti base dei segnali, introducendo le
26 caratteristiche essenziali con cui il sistema interagisce con i processi
27 attraverso di essi.
28
29
30 \subsection{I concetti base}
31 \label{sec:sig_base}
32
33 Come il nome stesso indica i segnali sono usati per notificare ad un processo
34 l'occorrenza di un qualche evento. Gli eventi che possono generare un segnale
35 sono vari; un breve elenco di possibili cause per l'emissione di un segnale è
36 il seguente:
37
38 \begin{itemize*}
39 \item un errore del programma, come una divisione per zero o un tentativo di
40   accesso alla memoria fuori dai limiti validi.
41 \item la terminazione di un processo figlio.
42 \item la scadenza di un timer o di un allarme.
43 \item il tentativo di effettuare un'operazione di input/output che non può
44   essere eseguita.
45 \item una richiesta dell'utente di terminare o fermare il programma. In genere
46   si realizza attraverso un segnale mandato dalla shell in corrispondenza
47   della pressione di tasti del terminale come \code{C-c} o
48   \code{C-z}.\footnote{indichiamo con \code{C-x} la pressione simultanea al
49     tasto \code{x} del tasto control (ctrl in molte tastiere).}
50 \item l'esecuzione di una \func{kill} o di una \func{raise} da parte del
51   processo stesso o di un'altro (solo nel caso della \func{kill}).
52 \end{itemize*}
53
54 Ciascuno di questi eventi (compresi gli ultimi due che pure sono controllati
55 dall'utente o da un altro processo) comporta l'intervento diretto da parte del
56 kernel che causa la generazione un particolare tipo di segnale.
57
58 Quando un processo riceve un segnale, invece del normale corso del programma,
59 viene eseguita una azione di default o una apposita routine di gestione (il
60 cosiddetto \textit{signal handler} o \textsl{manipolatore}) che può essere
61 stata specificata dall'utente (nel qual caso si dice che si
62 \textsl{intercetta} il segnale).
63
64
65 \subsection{Le modalità di funzionamento}
66 \label{sec:sig_semantics}
67
68 Negli anni il comportamento del sistema in risposta ai segnali è stato
69 modificato in vari modi nelle differenti implementazioni di Unix.  Si possono
70 individuare due tipologie fondamentali di comportamento dei segnali (dette
71 semantiche) che vengono chiamate rispettivamente semantica \textsl{affidabile}
72 (o \textit{reliable}) e semantica \textsl{inaffidabile} (o
73 \textit{unreliable}).
74
75 Nella semantica \textsl{inaffidabile} (quella implementata dalle prime
76 versioni di Unix) la routine di gestione del segnale specificata dall'utente
77 non resta attiva una volta che è stata eseguita; è perciò compito dell'utente
78 stesso ripetere l'installazione della stessa all'interno della routine di
79 gestione, in tutti i casi in cui si vuole che il manipolatore esterno resti
80 attivo.
81
82 In questo caso è possibile una situazione in cui i segnali possono essere
83 perduti; si consideri il seguente segmento di codice in cui la prima
84 operazione del manipolatore è quella di reinstallare se stesso: 
85
86 \footnotesize
87 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
88     int sig_handler();            /* handler function */
89     ...
90     signal(SIGINT, sig_handler);  /* establish handler */
91     ...
92
93 int sig_handler() 
94 {
95     signal(SIGINT, sig_handler);  /* restablish handler */
96     ...                           /* process signal */
97 }
98 \end{lstlisting}
99 \normalsize
100 se un secondo segnale arriva prima che il manipolatore invocato dal primo
101 abbia eseguito la reinstallazione di se stesso il segnale può essere perso o
102 causare il comportamento originale assegnato al segnale (in genere la
103 terminazione del processo).
104
105 Questa è la ragione per cui l'implementazione dei segnali secondo questa
106 semantica viene chiamata \textsl{inaffidabile}, in quanto la ricezione del
107 segnale e la reinstallazione del suo manipolatore non sono operazioni
108 atomiche, e sono sempre possibili delle race condition (sull'argomento vedi
109 quanto detto in \secref{sec:proc_multi_prog}).
110
111 Un'altro problema è che in questa semantica non esiste un modo per bloccare i
112 segnali quando non si vuole che arrivino; i processi possono ignorare il
113 segnale, ma non è possibile istruire il sistema a non fare nulla in occasione
114 di un segnale, pur mantenendo memoria del fatto che è avvenuto.
115
116 Un caso classico in cui si incontra questo problema, è quello in cui si usa il
117 manipolatore per settare un flag che riporta al processo l'occorrenza del
118 segnale, così che questo possa prendere provvedimenti al di fuori del
119 manipolatore. Si consideri il seguente segmento di codice il cui scopo sarebbe
120 quello di fermare il processo fino all'occorrenza di un opportuno segnale:
121
122 \footnotesize
123 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
124 int signal_flag = 0;
125 main()
126 {
127     int sig_handler();            /* handler function */
128     ...
129     signal(SIGINT, sig_handler);  /* establish handler */
130     ...
131     while(signal_flag == 0) {     /* while flag is zero */
132         pause();                  /* go to sleep */
133     }
134     ... 
135 }
136 int sig_handler() 
137 {
138     signal(SIGINT, sig_handler);  /* restablish handler */
139     signal_flag = 1;              /* set flag */
140 }
141 \end{lstlisting}
142 \normalsize
143 l'idea è che quando il processo trova il flag a zero viene messo in sleep e
144 verrà risvegliato solo dalla ricezione di un segnale. Il manipolatore si
145 limita in questo caso a settare il flag a uno; all'uscita dal manipolatore la
146 chiamata a \func{pause} è interrotta ed il processo viene risvegliato e
147 riprende l'esecuzione all'istruzione successiva, ma essendo cambiato il flag
148 la condizione non è più soddisfatta e il programma prosegue.
149
150 Il problema con l'implementazione inaffidabile è che niente ci garantisce che
151 il segnale arrivi fra la valutazione della condizione del \code{while} e la
152 chiamata a \func{pause}, nel qual caso, se il segnale non viene più generato,
153 il processo resterà in sleep permanentemente.
154
155 % Un'altra caratteristica della implementazione inaffidabile è che le chiamate
156 % di sistema non sono fatte ripartire automaticamente quando sono interrotte da
157 % un segnale, per questo un programma deve controllare lo stato di uscita della
158 % chiamata al sistema e ripeterla nel caso l'errore riportato da \texttt{errno}
159 % sia \texttt{EINTR}.
160
161 Questo ci mostra ad esempio come con la semantica inaffidabile non esista una
162 modalità semplice per ottenere una operazione di pausa (cioè mandare in sleep
163 un processo fino all'arrivo di un segnale).
164
165 Nella semantica \textsl{affidabile} (quella utilizzata da Linux e da ogni Unix
166 moderno) il manipolatore una volta installato resta attivo e non si hanno
167 tutti i problemi precedenti. In questa semantica i segnali vengono
168 \textsl{generati} dal kernel per un processo all'occorrenza dell'evento che
169 causa il segnale. In genere questo viene fatto dal kernel settando l'apposito
170 campo della \var{task\_struct} del processo nella process table (si veda
171 \figref{fig:proc_task_struct}).
172
173 Si dice che il segnale viene \textsl{consegnato} al processo (dall'inglese
174 \textit{delivered}) quando viene eseguita l'azione per esso prevista, mentre
175 per tutto il tempo che passa fra la generazione del segnale e la sua consegna
176 esso è detto \textsl{pendente} (o \textit{pending}). In genere questa
177 procedura viene effettuata dallo scheduler quando, riprendendo l'esecuzione
178 del processo in questione, verifica la presenza del segnale nella
179 \var{task\_struct} e mette in esecuzione il manipolatore.
180
181 In questa semantica un processo ha la possibilità di bloccare la consegna dei
182 segnali, in questo caso, se l'azione per il suddetto segnale non è quella di
183 ignorarlo, il segnale resta \textsl{pendente} fintanto che il processo non lo
184 sblocca (nel qual caso viene consegnato) o setta l'azione di default per
185 ignorarlo.
186
187 Si tenga presente che il kernel stabilisce cosa fare con un segnale che è
188 stato bloccato al momento della consegna, non quando viene generato; questo
189 consente di cambiare l'azione per il segnale prima che esso venga consegnato,
190 e si può usare la funzione \func{sigpending} (vedi
191 \secref{sec:sig_sigpending}) per determinare quali segnali sono bloccati e
192 quali sono pendenti.
193
194
195 \subsection{Tipi di segnali}
196 \label{sec:sig_types}
197
198 In generale gli eventi che generano segnali si possono dividere in tre
199 categorie principali: errori, eventi esterni e richieste esplicite.
200
201 Un errore significa che un programma ha fatto qualcosa di sbagliato e non può
202 continuare ad essere eseguito. Non tutti gli errori causano dei segnali, in
203 genere la condizione di errore più comune comporta la restituzione di un
204 codice di errore da parte di una funzione di libreria, sono gli errori che
205 possono avvenire ovunque in un programma che causano l'emissione di un
206 segnale, come le divisioni per zero o l'uso di indirizzi di memoria non validi.
207
208 Un evento esterno ha in genere a che fare con l'I/O o con altri processi;
209 esempi di segnali di questo tipo sono quelli legati all'arrivo di dati di
210 input, scadenze di un timer, terminazione di processi figli.
211
212 Una richiesta esplicita significa l'uso di una chiamata di sistema (come
213 \func{kill} o \func{raise}) per la generazione di un segnale, cosa che
214 viene fatta usualmente dalla shell quando l'utente invoca la sequenza di tasti
215 di stop o di suspend, ma può essere pure inserita all'interno di un programma.
216
217 Si dice poi che i segnali possono essere \textsl{asincroni} o
218 \textsl{sincroni}. Un segnale \textsl{sincrono} è legato ad una azione
219 specifica di un programma ed è inviato (a meno che non sia bloccato) durante
220 tale azione; molti errori generano segnali \textsl{sincroni}, così come la
221 richiesta esplicita da parte del processo tramite le chiamate al sistema.
222 Alcuni errori come la divisione per zero non sono completamente sincroni e
223 possono arrivare dopo qualche istruzione.
224
225 I segnali \textsl{asincroni} sono generati da eventi fuori dal controllo del
226 processo che li riceve, e arrivano in tempi impredicibili nel corso
227 dell'esecuzione del programma. Eventi esterni come la terminazione di un
228 processo figlio generano segnali \textsl{asincroni}, così come le richieste di
229 generazione di un segnale effettuate da altri processi.
230
231 In generale un tipo di segnale o è sincrono o è asincrono, salvo il caso in
232 cui esso sia generato attraverso una richiesta esplicita tramite chiamata al
233 sistema, nel qual caso qualunque tipo di segnale (quello scelto nella
234 chiamata) può diventare sincrono o asincrono a seconda che sia generato
235 internamente o esternamente al processo.
236
237
238 \subsection{La notifica dei segnali}
239 \label{sec:sig_notification}
240
241 Come accennato quando un segnale viene generato, se la sua azione di default
242 non è quella di essere ignorato, il kernel prende nota del fatto nella
243 \var{task\_struct} del processo; si dice così che il segnale diventa
244 \textsl{pendente} (o \textit{pending}), e rimane tale fino al momento in cui
245 verrà notificato al processo (o verrà specificata come azione di default
246 quella di ignorarlo).
247
248 Normalmente l'invio al processo che deve ricevere il segnale è immediato ed
249 avviene non appena questo viene rimesso in esecuzione dallo scheduler che
250 esegue l'azione specificata. Questo a meno che il segnale in questione non sia
251 stato bloccato prima della notifica, nel qual caso l'invio non avviene ed il
252 segnale resta \textsl{pendente} indefinitamente. Quando lo si sblocca il
253 segnale \textsl{pendente} sarà subito notificato.
254
255 Si ricordi però che se l'azione specificata per un segnale è quella di essere
256 ignorato questo sarà scartato immediatamente al momento della sua generazione,
257 e questo anche se in quel momento il segnale è bloccato (perché ciò che viene
258 bloccata è la notifica). Per questo motivo un segnale, fintanto che viene
259 ignorato, non sarà mai notificato, anche se è stato bloccato ed in seguito si
260 è specificata una azione diversa (nel qual caso solo i segnali successivi alla
261 nuova specificazione saranno notificati).
262
263 Una volta che un segnale viene notificato (che questo avvenga subito o dopo
264 una attesa più o meno lunga) viene eseguita l'azione specificata per il
265 segnale. Per alcuni segnali (\macro{SIGKILL} e \macro{SIGSTOP}) questa azione
266 è fissa e non può essere cambiata, ma per tutti gli altri si può selezionare
267 una  delle tre possibilità seguenti:
268
269 \begin{itemize*}
270 \item ignorare il segnale.
271 \item catturare il segnale, ed utilizzare il manipolatore specificato.
272 \item accettare l'azione di default per quel segnale.
273 \end{itemize*}
274
275 Un programma può specificare queste scelte usando le due funzioni
276 \func{signal} e \func{sigaction} (vedi \secref{sec:sig_signal} e
277 \secref{sec:sig_sigaction}); se si è installato un manipolatore sarà
278 quest'ultimo ad essere eseguito alla notifica del segnale.  Inoltre il sistema
279 fa si che mentre viene eseguito il manipolatore di un segnale, questo ultimo
280 venga automaticamente bloccato (così si possono evitare race condition).
281
282 Nel caso non sia stata specificata un'azione, viene utilizzata l'azione
283 standard che (come vedremo in \secref{sec:sig_standard}) è propria di ciascun
284 segnale; nella maggior parte dei casi essa porta alla terminazione del
285 processo, ma alcuni segnali che rappresentano eventi innocui vengono ignorati.
286
287 Quando un segnale termina un processo, il padre può determinare la causa della
288 terminazione esaminando il codice di stato riportato delle funzioni
289 \func{wait} e \func{waitpid} (vedi \secref{sec:proc_wait}); questo è il modo
290 in cui la shell determina i motivi della terminazione di un programma e scrive
291 un eventuale messaggio di errore.
292
293 I segnali che rappresentano errori del programma (divisione per zero o
294 violazioni di accesso) hanno anche la caratteristica di scrivere un file di
295 \textit{core dump} che registra lo stato del processo (ed in particolare della
296 memoria e dello stack) prima della terminazione.  Questo può essere esaminato
297 in seguito con un debugger per investigare sulla causa dell'errore.  Lo stesso
298 avviene se i suddetti segnale vengono generati con una \func{kill}.
299
300
301
302 \section{La classificazione dei segnali}
303 \label{sec:sig_classification}
304
305 Esamineremo in questa sezione quali sono i vari segnali definiti nel sistema,
306 le loro caratteristiche e tipologia, le varie macro e costanti che permettono
307 di identificarli, e le funzioni che ne stampano la descrizione.
308
309
310 \subsection{I segnali standard}
311 \label{sec:sig_standard}
312
313 Ciascun segnale è identificato rispetto al sistema da un numero, ma l'uso
314 diretto di questo numero da parte dei programmi è da evitare, in quanto esso
315 può variare a seconda dell'implementazione del sistema, e nel caso si Linux,
316 anche a seconda dell'architettura hardware. 
317 Per questo motivo ad ogni segnale viene associato un nome, definendo con una
318 macro di preprocessore una costante uguale al suddetto numero. Sono questi
319 nomi, che sono standardizzati e sostanzialmente uniformi rispetto alle varie
320 implementazioni, che si devono usare nei programmi. Tutti i nomi e le funzioni
321 che concernono i segnali sono definiti nell'header di sistema \file{signal.h}.
322
323 Il numero totale di segnali presenti è dato dalla macro \macro{NSIG}, e dato
324 che i numeri dei segnali sono allocati progressivamente, essa corrisponde
325 anche al successivo del valore numerico assegnato all'ultimo segnale definito.
326 In \tabref{tab:sig_signal_list} si è riportato l'elenco completo dei segnali
327 definiti in Linux (estratto dalle man page), comparati con quelli definiti in
328 vari standard.
329
330
331 \begin{table}[htb]
332   \footnotesize
333   \centering
334   \begin{tabular}[c]{|c|p{8cm}|}
335     \hline
336     \textbf{Sigla} & \textbf{Significato} \\
337     \hline
338     \hline
339     A & L'azione di default è terminare il processo. \\
340     B & L'azione di default è ignorare il segnale. \\
341     C & L'azione di default è terminare il processo e scrivere un \textit{core
342         dump}. \\
343     D & L'azione di default è fermare il processo. \\
344     E & Il segnale non può essere intercettato. \\
345     F & Il segnale non può essere ignorato.\\
346     \hline
347   \end{tabular}
348   \caption{Legenda delle azioni di default dei segnali riportate in 
349     \tabref{tab:sig_signal_list}.}
350   \label{tab:sig_action_leg}
351 \end{table}
352
353 In \tabref{tab:sig_signal_list} si sono anche riportate le azioni di default
354 di ciascun segnale (riassunte con delle lettere, la cui legenda completa è in
355 \tabref{tab:sig_action_leg}), quando nessun manipolatore è installato un
356 segnale può essere ignorato o causare la terminazione del processo. Nella
357 colonna standard sono stati indicati anche gli standard in cui ciascun segnale
358 è definito, secondo lo schema di \tabref{tab:sig_standard_leg}.
359
360
361 \begin{table}[htb]
362   \footnotesize
363   \centering
364   \begin{tabular}[c]{|c|l|}
365     \hline
366     \textbf{Sigla} & \textbf{Standard} \\
367     \hline
368     \hline
369     P & POSIX. \\
370     B & BSD. \\
371     L & Linux.\\
372     S & SUSv2.\\
373     \hline
374   \end{tabular}
375   \caption{Legenda dei valori della colonna \textbf{Standard} di 
376     \tabref{tab:sig_signal_list}.}
377   \label{tab:sig_standard_leg}
378 \end{table}
379
380 In alcuni casi alla terminazione del processo è associata la creazione di un
381 file (posto nella directory corrente del processo e chiamato \file{core}) su
382 cui viene salvata un'immagine della memoria del processo (il cosiddetto
383 \textit{core dump}), che può essere usata da un debugger per esaminare lo
384 stato dello stack e delle variabili al momento della ricezione del segnale.
385
386 \begin{table}[htb]
387   \footnotesize
388   \centering
389   \begin{tabular}[c]{|l|c|c|p{8cm}|}
390     \hline
391     \textbf{Segnale}&\textbf{Standard}&\textbf{Azione}&\textbf{Descrizione} \\
392     \hline
393     \hline
394     \macro{SIGHUP}   &PL & A & Hangup o fine del processo di controllo      \\
395     \macro{SIGINT}   &PL & A & Interrupt da tastiera (\cmd{C-c})            \\
396     \macro{SIGQUIT}  &PL & C & Quit da tastiera (\cmd{C-y})                 \\
397     \macro{SIGILL}   &PL & C & Istruzione illegale                          \\
398     \macro{SIGABRT}  &PL & C & Segnale di abort da \func{abort}             \\
399     \macro{SIGFPE}   &PL & C & Errore aritmetico                            \\
400     \macro{SIGKILL}  &PL &AEF& Segnale di terminazione forzata              \\
401     \macro{SIGSEGV}  &PL & C & Errore di accesso in memoria                 \\
402     \macro{SIGPIPE}  &PL & A & Pipe spezzata                                \\
403     \macro{SIGALRM}  &PL & A & Segnale del timer da \func{alarm}             \\
404     \macro{SIGTERM}  &PL & A & Segnale di terminazione \verb|C-\|            \\
405     \macro{SIGUSR1}  &PL & A & Segnale utente numero 1                       \\
406     \macro{SIGUSR2}  &PL & A & Segnale utente numero 2                       \\
407     \macro{SIGCHLD}  &PL & B & Figlio terminato o fermato                    \\
408     \macro{SIGCONT}  &PL &   & Continua se fermato                           \\
409     \macro{SIGSTOP}  &PL &DEF& Ferma il processo                             \\
410     \macro{SIGTSTP}  &PL & D & Stop typed at tty                             \\
411     \macro{SIGTTIN}  &PL & D & Input sul terminale per un processo 
412                                in background                                 \\
413     \macro{SIGTTOU}  &PL & D & Output sul terminale per un processo          
414                                in background                                 \\
415     \macro{SIGBUS}   &SL & C & Errore sul bus (bad memory access)            \\
416     \macro{SIGPOLL}  &SL & A & Pollable event (Sys V).                      
417                                Sinonimo di \macro{SIGIO}                     \\
418     \macro{SIGPROF}  &SL & A & Timer del profiling scaduto                   \\
419     \macro{SIGSYS}   &SL & C & Bad argument to routine (SVID)                \\
420     \macro{SIGTRAP}  &SL & C & Trace/breakpoint trap                         \\
421     \macro{SIGURG}   &SLB& B & Urgent condition on socket                    \\
422     \macro{SIGVTALRM}&SLB& A & Virtual alarm clock                           \\
423     \macro{SIGXCPU}  &SLB& C & Ecceduto il limite sul CPU time               \\
424     \macro{SIGXFSZ}  &SLB& C & Ecceduto il limite sulla dimensione dei file  \\
425     \macro{SIGIOT}   &L  & C & IOT trap. A synonym for \macro{SIGABRT}       \\
426     \macro{SIGEMT}   &L  &   &                                               \\
427     \macro{SIGSTKFLT}&L  & A & Stack fault on coprocessor                    \\
428     \macro{SIGIO}    &LB & A & I/O now possible (4.2 BSD)                    \\
429     \macro{SIGCLD}   &L  &   & A synonym for \macro{SIGCHLD}                 \\
430     \macro{SIGPWR}   &L  & A & Fallimento dell'alimentazione                 \\
431     \macro{SIGINFO}  &L  &   & A synonym for \macro{SIGPWR}                  \\
432     \macro{SIGLOST}  &L  & A & Perso un lock sul file (per NFS)              \\
433     \macro{SIGWINCH} &LB & B & Window resize signal (4.3 BSD, Sun)           \\
434     \macro{SIGUNUSED}&L  & A & Unused signal (will be SIGSYS)                \\
435     \hline
436   \end{tabular}
437   \caption{Lista dei segnali in Linux.}
438   \label{tab:sig_signal_list}
439 \end{table}
440
441 La descrizione dettagliata del significato dei vari segnali, raggruppati per
442 tipologia, verrà affrontate nel seguito.
443
444
445 \subsection{Segnali di errore di programma}
446 \label{sec:sig_prog_error}
447
448 Questi segnali sono generati quando il sistema, o in certi casi direttamente
449 l'hardware (come per i page fault non validi) rileva un qualche errore
450 insanabile nel programma in esecuzione. In generale la generazione di questi
451 segnali significa che il programma ha dei gravi problemi (ad esempio ha
452 dereferenziato un puntatore non valido o ha eseguito una operazione aritmetica
453 proibita) e l'esecuzione non può essere proseguita.
454
455 In genere si intercettano questi segnali per permettere al programma di
456 terminare in maniera pulita, ad esempio per ripristinare i settaggi della
457 console o eliminare i file di lock prima dell'uscita.  In questo caso il
458 manipolatore deve concludersi ripristinando l'azione di default e rialzando il
459 segnale, in questo modo il programma si concluderà senza effetti spiacevoli,
460 ma riportando lo stesso stato di uscita che avrebbe avuto se il manipolatore
461 non ci fosse stato.
462
463 L'azione di default per tutti questi segnali è causare la terminazione del
464 processo che li ha causati. In genere oltre a questo il segnale provoca pure
465 la registrazione su disco di un file di \textit{core dump} che viene scritto
466 in un file \file{core} nella directory corrente del processo al momento
467 dell'errore, che il debugger può usare per ricostruire lo stato del programma
468 al momento della terminazione.
469
470 Questi segnali sono:
471 \begin{basedescript}{\desclabelwidth{2.0cm}}
472 \item[\macro{SIGFPE}] Riporta un errore aritmetico fatale. Benché il nome
473   derivi da \textit{floating point exception} si applica a tutti gli errori
474   aritmetici compresa la divisione per zero e l'overflow. 
475
476 %   Per questo segnale le cose sono complicate dal fatto che possono esserci
477 %   molte diverse eccezioni che \texttt{SIGFPE} non distingue, mentre lo
478 %   standard IEEE per le operazioni in virgola mobile definisce varie eccezioni
479 %   aritmetiche e richiede che esse siano notificate.  
480   
481 \item[\macro{SIGILL}] Il nome deriva da \textit{illegal instruction},
482   significa che il programma sta cercando di eseguire una istruzione
483   privilegiata o inesistente, in generale del codice illegale. Poiché il
484   compilatore del C genera del codice valido si ottiene questo segnale se il
485   file eseguibile è corrotto o si stanno cercando di eseguire dei dati.
486   Quest'ultimo caso può accadere quando si passa un puntatore sbagliato al
487   posto di un puntatore a funzione, o si eccede la scrittura di un vettore di
488   una variabile locale, andando a corrompere lo stack. Lo stesso segnale viene
489   generato in caso di overflow dello stack o di problemi nell'esecuzione di un
490   manipolatore.
491 \item[\macro{SIGSEGV}] Il nome deriva da \textit{segment violation}, e
492   significa che il programma sta cercando di leggere o scrivere in una zona di
493   memoria protetta al di fuori di quella che gli è stata riservata dal
494   sistema. In genere è il meccanismo della protezione della memoria che si
495   accorge dell'errore ed il kernel genera il segnale.
496
497   È tipico ottenere questo segnale dereferenziando un puntatore nullo o non
498   inizializzato leggendo al di la della fine di un vettore. 
499 \item[\macro{SIGBUS}] Il nome deriva da \textit{bus error}. Come
500   \macro{SIGSEGV} questo è un segnale che viene generato di solito quando si
501   dereferenzia un puntatore non inizializzato, la differenza è che
502   \macro{SIGSEGV} indica un accesso non permesso su un indirizzo esistente
503   (tipo fuori dallo heap o dallo stack), mentre \macro{SIGBUS} indica
504   l'accesso ad un indirizzo non valido, come nel caso di un puntatore non
505   allineato.
506 \item[\macro{SIGABRT}] Il nome deriva da \textit{abort}. Il segnale indica che
507   il programma stesso ha rilevato un errore che viene riportato chiamando la
508   funzione \func{abort} che genera questo segnale.
509 \item[\macro{SIGTRAP}] È il segnale generato da un'istruzione di breakpoint o
510   dall'attivazione del tracciamento per il processo. È usato dai programmi per
511   il debugging e se un programma normale non dovrebbe ricevere questo segnale.
512 \item[\macro{SIGSYS}] Sta ad indicare che si è eseguita una istruzione che
513   richiede l'esecuzione di una system call, ma si è fornito un codice
514   sbagliato per quest'ultima.
515 \end{basedescript}
516
517
518 \subsection{I segnali di terminazione}
519 \label{sec:sig_termination}
520
521 Questo tipo di segnali sono usati per terminare un processo; hanno vari nomi a
522 causa del differente uso che se ne può fare, ed i programmi possono
523 trattarli in maniera differente. 
524
525 La ragione per cui può essere necessario trattare questi segnali è che il
526 programma può dover eseguire una serie di azioni di pulizia prima di
527 terminare, come salvare informazioni sullo stato in cui si trova, cancellare
528 file temporanei, o ripristinare delle condizioni alterate durante il
529 funzionamento (come il modo del terminale o i settaggi di una qualche
530 periferica).
531
532 L'azione di default di questi segnali è di terminare il processo, questi
533 segnali sono:
534 \begin{basedescript}{\desclabelwidth{2.0cm}}
535 \item[\macro{SIGTERM}] Il nome sta per \textit{terminate}. È un segnale
536   generico usato per causare la conclusione di un programma. Al contrario di
537   \macro{SIGKILL} può essere intercettato, ignorato, bloccato. In genere lo si
538   usa per chiedere in maniera ``educata'' ad un processo di concludersi.
539 \item[\macro{SIGINT}] Il nome sta per \textit{interrupt}. È il segnale di
540   interruzione per il programma. È quello che viene generato di default dal
541   comando \cmd{kill} o dall'invio sul terminale del carattere di controllo
542   INTR (interrupt, generato dalla sequenza \macro{C-c}).
543 \item[\macro{SIGQUIT}] È analogo a \macro{SIGINT} con la differenze che è
544   controllato da un'altro carattere di controllo, QUIT, corrispondente alla
545   sequenza \verb|C-\|. A differenza del precedente l'azione di default,
546   oltre alla terminazione del processo, comporta anche la creazione di un core
547   dump. 
548
549   In genere lo si può pensare come corrispondente ad una condizione di
550   errore del programma rilevata dall'utente. Per questo motivo non è opportuno
551   fare eseguire al manipolatore di questo segnale le operazioni di pulizia
552   normalmente previste (tipo la cancellazione di file temporanei), dato che in
553   certi casi esse possono eliminare informazioni utili nell'esame dei core
554   dump. 
555 \item[\macro{SIGKILL}] Il nome è utilizzato per terminare in maniera immediata
556   qualunque programma. Questo segnale non può essere né intercettato, né
557   ignorato, né bloccato, per cui causa comunque la terminazione del processo.
558   In genere esso viene generato solo per richiesta esplicita dell'utente dal
559   comando (o tramite la funzione) \cmd{kill}. Dato che non lo si può
560   intercettare è sempre meglio usarlo come ultima risorsa quando metodi meno
561   brutali, come \macro{SIGTERM} o \macro{C-c} non funzionano. 
562
563   Se un processo non risponde a nessun altro segnale \macro{SIGKILL} ne causa
564   sempre la terminazione (in effetti il fallimento della terminazione di un
565   processo da parte di \macro{SIGKILL} costituirebbe un malfunzionamento del
566   kernel). Talvolta è il sistema stesso che può generare questo segnale quando
567   per condizioni particolari il processo non può più essere eseguito neanche
568   per eseguire un manipolatore.
569 \item[\macro{SIGHUP}] Il nome sta per \textit{hang-up}. Segnala che il
570   terminale dell'utente si è disconnesso (ad esempio perché si è interrotta la
571   rete). Viene usato anche per riportare la terminazione del processo di
572   controllo di un terminale a tutti i processi della sessione, in modo che
573   essi possano disconnettersi dal relativo terminale. 
574   
575   Viene inoltre usato in genere per segnalare ai demoni (che non hanno un
576   terminale di controllo) la necessità di reinizializzarsi e rileggere il/i
577   file di configurazione.
578 \end{basedescript}
579
580
581 \subsection{I segnali di allarme}
582 \label{sec:sig_alarm}
583
584 Questi segnali sono generati dalla scadenza di un timer. Il loro comportamento
585 di default è quello di causare la terminazione del programma, ma con questi
586 segnali la scelta di default è irrilevante, in quanto il loro uso presuppone
587 sempre la necessità di un manipolatore.  Questi segnali sono:
588 \begin{basedescript}{\desclabelwidth{2.0cm}}
589 \item[\macro{SIGALRM}] Il nome sta per \textit{alarm}. Segnale la scadenza di
590   un timer misurato sul tempo reale o sull'orologio di sistema. È normalmente
591   usato dalla funzione \func{alarm}.
592 \item[\macro{SIGVTALRM}] Il nome sta per \textit{virtual alarm}. È analogo al
593   precedente ma segnala la scadenza di un timer sul tempo di CPU usato dal
594   processo. 
595 \item[\macro{SIGPROF}] Il nome sta per \textit{profiling}. Indica la scadenza
596   di un timer che misura sia il tempo di CPU speso direttamente dal processo
597   che quello che il sistema ha speso per conto di quest'ultimo. In genere
598   viene usato dai tool che servono a fare il profilo d'uso della CPU da parte
599   del processo.
600 \end{basedescript}
601
602
603 \subsection{I segnali di I/O asincrono}
604 \label{sec:sig_asyncio}
605
606 Questi segnali operano in congiunzione con le funzioni di I/O asincrono. Per
607 questo occorre comunque usare \func{fcntl} per abilitare un file descriptor a
608 generare questi segnali. 
609
610 L'azione di default è di essere ignorati. Questi segnali sono:
611 \begin{basedescript}{\desclabelwidth{2.0cm}}
612 \item[\macro{SIGIO}] Questo segnale viene inviato quando un file descriptor è
613   pronto per eseguire dell'input/output. In molti sistemi solo i socket e i
614   terminali possono generare questo segnale, in Linux questo può essere usato
615   anche per i file, posto che la \func{fcntl} abbia avuto successo.
616 \item[\macro{SIGURG}] Questo segnale è inviato quando arrivano dei dati
617   urgenti o \textit{out of band} su di un socket; per maggiori dettagli al
618   proposito si veda \secref{sec:xxx_urgent_data}.
619 \item[\macro{SIGPOLL}] Questo segnale è equivalente a \macro{SIGIO}, è
620   definito solo per compatibilità con i sistemi System V.
621 \end{basedescript}
622
623
624 \subsection{I segnali per il controllo di sessione}
625 \label{sec:sig_job_control}
626
627 Questi sono i segnali usati dal controllo delle sessioni e dei processi, il
628 loro uso è specifico e viene trattato in maniera specifica nelle sezioni in
629 cui si trattano gli argomenti relativi.  Questi segnali sono:
630 \begin{basedescript}{\desclabelwidth{2.0cm}}
631 \item[\macro{SIGCHLD}] Questo è il segnale mandato al processo padre quando un
632   figlio termina o viene fermato. L'azione di default è di ignorare il
633   segnale, la sua gestione è trattata in \secref{sec:proc_wait}.
634 \item[\macro{SIGCLD}] Per Linux questo è solo un segnale identico al
635   precedente, il nome è obsoleto e andrebbe evitato. 
636 \item[\macro{SIGCONT}] Il nome sta per \textit{continue}. Il segnale viene
637   usato per fare ripartire un programma precedentemente fermato da
638   \macro{SIGSTOP}. Questo segnale ha un comportamento speciale, e fa sempre
639   ripartire il processo prima della sua consegna. Il comportamento di default
640   è di fare solo questo; il segnale non può essere bloccato. Si può anche
641   installare un manipolatore, ma il segnale provoca comunque il riavvio del
642   processo.
643   
644   La maggior pare dei programmi non hanno necessità di intercettare il
645   segnale, in quanto esso è completamente trasparente rispetto all'esecuzione
646   che riparte senza che il programma noti niente. Si possono installare dei
647   manipolatori per far si che un programma produca una qualche azione speciale
648   se viene fermato e riavviato, come per esempio riscrivere un prompt, o
649   inviare un avviso. 
650 \item[\macro{SIGSTOP}] Il segnale ferma un processo (lo porta in uno stato di
651   sleep); il segnale non può essere né intercettato, né ignorato, né bloccato.
652 \item[\macro{SIGTSTP}] Il nome sta per \textit{interactive stop}. Il segnale
653   ferma il processo interattivamente, ed è generato dal carattere SUSP
654   (prodotto dalla combinazione \macro{C-z}), ed al contrario di
655   \macro{SIGSTOP} può essere intercettato e ignorato. In genere un programma
656   installa un manipolatore per questo segnale quando vuole lasciare il sistema
657   o il terminale in uno stato definito prima di fermarsi; se per esempio un
658   programma ha disabilitato l'eco sul terminale può installare un manipolatore
659   per riabilitarlo prima di fermarsi.
660 \item[\macro{SIGTTIN}] Un processo non può leggere dal terminale se esegue una
661   sessione di lavoro in background. Quando un processo in background tenta di
662   leggere da un terminale viene inviato questo segnale a tutti i processi
663   della sessione di lavoro. L'azione di default è di fermare il processo.
664   L'argomento è trattato in \secref{sec:sess_xxx}.
665 \item[\macro{SIGTTOU}] Segnale analogo al precedente \macro{SIGTTIN}, ma
666   generato quando si tenta di scrivere o modificare uno dei modi del
667   terminale. L'azione di default è di fermare il processo, l'argomento è
668   trattato in \secref{sec:sess_xxx}.
669 \end{basedescript}
670
671
672 \subsection{I segnali di operazioni errate}
673 \label{sec:sig_oper_error}
674
675 Questi segnali sono usati per riportare al programma errori generati da
676 operazioni da lui eseguite; non indicano errori del programma quanto errori
677 che impediscono il completamento dell'esecuzione dovute all'interazione con il
678 resto del sistema.
679
680 L'azione di default di questi segnali è di terminare il processo, questi
681 segnali sono:
682 \begin{basedescript}{\desclabelwidth{2.0cm}}
683 \item[\macro{SIGPIPE}] Sta per \textit{Broken pipe}. Se si usano delle pipe o
684   delle FIFO è necessario che, prima che un processo inizi a scrivere su di
685   essa, un'altro abbia aperto la pipe in lettura (si veda
686   \secref{sec:ipc_pipes}). Se il processo in lettura non è partito o è
687   terminato inavvertitamente alla scrittura sulla pipe il kernel genera questo
688   segnale. Se il segnale è bloccato, intercettato o ignorato la chiamata che
689   lo ha causato fallisce restituendo l'errore \macro{EPIPE} 
690 \item[\macro{SIGLOST}] Sta per \textit{Resource lost}. Viene generato quando
691   c'è un advisory lock su un file NFS, ed il server riparte dimenticando la
692   situazione precedente.
693 \item[\macro{SIGXCPU}] Sta per \textit{CPU time limit exceeded}. Questo
694   segnale è generato quando un processo eccede il limite impostato per il
695   tempo di CPU disponibile, vedi \secref{sec:sys_xxx}. 
696 \item[\macro{SIGXFSZ}] Sta per \textit{File size limit exceeded}. Questo
697   segnale è generato quando un processo tenta di estendere un file oltre le
698   dimensioni specificate dal limite impostato per le dimensioni massime di un
699   file, vedi \secref{sec:sys_xxx}. 
700 \end{basedescript}
701
702
703 \subsection{Ulteriori segnali}
704 \label{sec:sig_misc_sig}
705
706 Raccogliamo qui infine usa serie di segnali che hanno scopi differenti non
707 classificabili in maniera omogenea. Questi segnali sono:
708 \begin{basedescript}{\desclabelwidth{2.0cm}}
709 \item[\macro{SIGUSR1} e \macro{SIGUSR2}] Sono due segnali a disposizione
710   dell'utente che li può usare per quello che vuole. Possono essere utili per
711   implementare una comunicazione elementare fra processi diversi, o per
712   eseguire a richiesta una operazione utilizzando un manipolatore. L'azione di
713   default è terminare il processo.
714 \item[\macro{SIGWINCH}] Il nome sta per \textit{window (size) change} ed è
715   generato da molti sistemi (GNU/Linux compreso) quando le dimensioni (in
716   righe e colonne) di un terminale vengono cambiate. Viene usato da alcuni
717   programmi testuali per riformattare l'uscita su schermo quando si cambia
718   dimensione a quest'ultimo. L'azione di default è di essere ignorato.
719 \item[\macro{SIGINFO}] Il segnale indica una richiesta di informazioni. È
720   usato con il controllo di sessione, causa la stampa di informazioni da parte
721   del processo leader del gruppo associato al terminale di controllo, gli
722   altri processi lo ignorano.
723 \end{basedescript}
724
725
726 \subsection{Le funzioni \func{strsignal} e \func{psignal}}
727 \label{sec:sig_strsignal}
728
729 Per la descrizione dei segnali il sistema mette a disposizione due funzioni,
730 \func{strsignal} e \func{psignal}, che stampano un messaggio di descrizione
731 dato il numero. In genere si usano quando si vuole notificare all'utente il
732 segnale avvenuto (nel caso di terminazione di un processo figlio o di un
733 manipolatore che gestisce più segnali); la prima funzione è una estensione
734 GNU, accessibile avendo definito \macro{\_GNU\_SOURCE}, ed è analoga alla
735 funzione \func{strerror} (si veda \secref{sec:sys_strerror}) per gli errori:
736 \begin{prototype}{string.h}{char *strsignal(int signum)} 
737   Ritorna il puntatore ad una stringa che contiene la descrizione del segnale
738   \var{signum}.
739 \end{prototype}
740 \noindent dato che la stringa è allocata staticamente non se ne deve
741 modificare il contenuto, che resta valido solo fino alla successiva chiamata
742 di \func{strsignal}. Nel caso si debba mantenere traccia del messaggio sarà
743 necessario copiarlo.
744
745 La seconda funzione deriva da BSD ed è analoga alla funzione \func{perror}
746 descritta in \secref{sec:sys_strerror}; il suo prototipo è:
747 \begin{prototype}{signal.h}{void psignal(int sig, const char *s)} 
748   Stampa sullo standard error un messaggio costituito dalla stringa \param{s},
749   seguita da due punti ed una descrizione del segnale indicato da \param{sig}.
750 \end{prototype}
751
752 Una modalità alternativa per utilizzare le descrizioni restituite da
753 \func{strsignal} e \func{psignal} è quello di fare usare la variabile
754 \var{sys\_siglist}, che è definita in \file{signal.h} e può essere acceduta
755 con la dichiarazione:
756 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
757     extern const char *const sys_siglist[]
758 \end{lstlisting}
759 l'array \var{sys\_siglist} contiene i puntatori alle stringhe di descrizione,
760 indicizzate per numero di segnale, per cui una chiamata del tipo di \code{char
761   *decr = strsignal(SIGINT)} può essere sostituita dall'equivalente \code{char
762   *decr = sys\_siglist[SIGINT]}.
763
764
765
766 \section{La gestione dei segnali}
767 \label{sec:sig_management}
768
769 I segnali sono il primo e più classico esempio di eventi asincroni, cioè di
770 eventi che possono accadere in un qualunque momento durante l'esecuzione di un
771 programma. Per questa loro caratteristica la loro gestione non può essere
772 effettuata all'interno del normale flusso di esecuzione dello stesso, ma è
773 delegata appunto agli eventuali manipolatori che si sono installati.
774
775 In questa sezione vedremo come si effettua gestione dei segnali, a partire
776 dalla loro interazione con le system call, passando per le varie funzioni che
777 permettono di installare i manipolatori e controllare le reazioni di un
778 processo alla loro occorrenza.
779
780
781 \subsection{Il comportamento generale del sistema.}
782 \label{sec:sig_gen_beha}
783
784 Abbiamo già trattato in \secref{sec:sig_intro} le modalità con cui il sistema
785 gestisce l'interazione fra segnali e processi, ci resta da esaminare però il
786 comportamento delle system call; in particolare due di esse, \func{fork} ed
787 \func{exec}, dovranno essere prese esplicitamente in considerazione, data la
788 loro stretta relazione con la creazione di nuovi processi.
789
790 Come accennato in \secref{sec:proc_fork} quando viene creato un nuovo processo
791 con \func{fork} esso eredita dal padre sia le azioni che sono state settate
792 per i singoli segnali, che la maschera dei segnali bloccati (tratteremo
793 quest'ultimo argomento in \ref{sec:sig_sigpending}). Invece tutti i segnali
794 pendenti e gli allarmi vengono cancellati; essi infatti devono essere
795 recapitati solo al padre, al figlio dovranno arrivare solo i segnali dovuti
796 alle sue azioni.
797
798 Quando si mette in esecuzione un nuovo programma con \func{exec} (si ricordi
799 quanto detto in \secref{sec:proc_exec}) tutti i segnali per i quali è stato
800 installato un manipolatore vengono resettati a \macro{SIG\_DFL}. Non ha più
801 senso infatti fare riferimento a funzioni definite nel programma originario,
802 che non sono presenti nello spazio di indirizzi del nuovo programma.
803
804 Si noti che questo vale solo per le azioni per le quali è stato installato un
805 manipolatore; viene mantenuto invece ogni eventuale settaggio dell'azione a
806 \macro{SIG\_IGN}. Questo permette ad esempio alla shell di settare ad
807 \macro{SIG\_IGN} le risposte per \macro{SIGINT} e \macro{SIGQUIT} per i
808 programmi eseguiti in background, che altrimenti sarebbero interrotti da una
809 successiva pressione di \texttt{C-c} o \texttt{C-y}.
810
811 Per quanto riguarda tutte le altre system call esse vengono tradizionalmente
812 classificate, proprio in base al loro comportamento nei confronti dei segnali,
813 in \textsl{lente} (\textit{slow}) e \textsl{veloci} (\textit{fast}). La gran
814 parte appartiene a quest'ultima categoria che non è influenzata dall'arrivo di
815 un segnale. In tal caso un eventuale manipolatore viene sempre eseguito dopo
816 che la system call è stata completata. Esse sono dette \textsl{veloci} proprio
817 in quanto la loro esecuzione è sostanzialmente immediata e attendere per
818 eseguire un manipolatore non comporta nessun inconveniente.
819
820 Esistono però dei casi in cui questo non è possibile perché renderebbe
821 impossibile una risposta pronta al segnale. In generale questo avviene tutte
822 le volte che si ha a che fare con system call che possono bloccarsi
823 indefinitamente, che per questo vengono chiamate \textsl{lente}. Un elenco
824 dei casi in cui si presenta questa situazione è il seguente:
825 \begin{itemize*}
826 \item lettura da file che possono bloccarsi in attesa di dati non ancora
827   presenti (come per certi file di dispositivo, la rete o le pipe).
828 \item scrittura sugli stessi file, nel caso in cui dati non possano essere
829   accettati immediatamente.
830 \item apertura di un file di dispositivo che richiede operazioni non immediate
831   per una una risposta. 
832 \item operazioni eseguite con \func{ioctl} che non è detto possano essere
833   eseguite immediatamente.
834 \item le funzioni di intercomunicazione che si bloccano in attesa di risposte
835   da altri processi.
836 \item la funzione \func{pause} (usata appunto per attendere l'-arrivo di un
837   segnale).
838 \item la funzione \func{wait} (se nessun processo figlio è ancora terminato).
839 \end{itemize*}
840
841 In questo caso si pone il problema di cosa fare una volta che il manipolatore
842 sia ritornato. La scelta originaria dei primi Unix era quella di far ritornare
843 anche la system call restituendo l'errore di \macro{EINTR}. Questa è a
844 tutt'oggi una scelta corrente, ma comporta che i programmi che usano dei
845 manipolatori controllino lo stato di uscita delle funzioni per ripeterne la
846 chiamata qualora l'errore fosse questo.
847
848 Dimenticarsi di richiamare una system call interrotta da un segnale è un
849 errore comune, tanto che le \acr{glibc} provvedono una macro
850 \code{TEMP\_FAILURE\_RETRY(expr)} che esegue l'operazione automaticamente,
851 ripetendo l'esecuzione dell'espressione \var{expr} fintanto che il risultato
852 non è diverso dall'uscita con un errore \macro{EINTR}.
853
854 La soluzione è comunque poco elegante e BSD ha scelto un approccio molto
855 diverso, che è quello di fare ripartire automaticamente la system call invece
856 di farla fallire. In questo caso ovviamente non c'è da preoccuparsi di
857 controllare il codice di errore; si perde però la possibilità di eseguire
858 azioni specifiche all'occorrenza di questa particolare condizione. 
859
860 Linux e le \acr{glibc} consentono di utilizzare entrambi gli approcci,
861 attraverso una opportuna opzione di \func{sigaction} (vedi
862 \secref{sec:sig_sigaction}). È da chiarire comunque che nel caso di
863 interruzione nel mezzo di un trasferimento parziale di dati, le system call
864 ritornano sempre indicando i byte trasferiti.
865
866
867 \subsection{La funzione \func{signal}}
868 \label{sec:sig_signal}
869
870 L'interfaccia più semplice per la gestione dei segnali è costituita dalla
871 funzione \func{signal} che è definita fin dallo standard ANSI C.  Quest'ultimo
872 però non considera sistemi multitasking, per cui la definizione è tanto vaga
873 da essere del tutto inutile in un sistema Unix; è questo il motivo per cui
874 ogni implementazione successiva ne ha modificato e ridefinito il
875 comportamento, pur mantenendone immutato il prototipo\footnote{in realtà
876   alcune vecchie implementazioni (SVR4 e 4.3+BSD) usano parametri aggiuntivi
877   per definire il comportamento della funzione.} che è:
878 \begin{prototype}{signal.h}
879   {sighandler\_t signal(int signum, sighandler\_t handler)} 
880   
881   Installa la funzione di gestione \param{handler} (il manipolatore) per il
882   segnale \param{signum}.
883   
884   \bodydesc{La funzione ritorna il precedente manipolatore in caso di successo
885     o \macro{SIG\_ERR} in caso di errore.}
886 \end{prototype}
887
888 In questa definizione si è usato il tipo \type{sighandler\_t} che è una
889 estensione GNU, definita dalle \acr{glibc}, che permette di riscrivere il
890 prototipo in una forma più leggibile dell'originario:
891 \begin{verbatim}
892 void (*signal(int signum, void (*handler)(int)))int)
893 \end{verbatim}
894 questa infatti, per la poca chiarezza della sintassi del C quando si vanno a
895 trattare puntatori a funzioni, è molto meno comprensibile.  Da un confronto
896 con il precedente prototipo si può dedurre la definizione di
897 \type{sighandler\_t} che è:
898 \begin{verbatim}
899     typedef void (* sighandler_t)(int) 
900 \end{verbatim}
901 e cioè un puntatore ad una funzione \type{void} (cioè senza valore di ritorno)
902 e che prende un argomento di tipo \type{int}.\footnote{si devono usare le
903   parentesi intorno al nome della funzione per via delle precedenze degli
904   operatori del C, senza di esse si sarebbe definita una funzione che ritorna
905   un puntatore a \type{void} e non un puntatore ad una funzione \type{void}.}
906 La funzione \func{signal} quindi restituisce e prende come secondo argomento
907 un puntatore a una funzione di questo tipo, che è appunto il manipolatore del
908 segnale.
909
910 Il numero di segnale passato in \param{signum} può essere indicato
911 direttamente con una delle costanti definite in \secref{sec:sig_standard}. Il
912 manipolatore \param{handler} invece, oltre all'indirizzo della funzione da
913 chiamare all'occorrenza del segnale, può assumere anche i due valori costanti
914 \macro{SIG\_IGN} con cui si dice ignorare il segnale e \macro{SIG\_DFL} per
915 installare l'azione di di default.\footnote{si ricordi però che i due segnali
916   \macro{SIGKILL} e \macro{SIGSTOP} non possono essere ignorati né
917   intercettati.}
918
919 La funzione restituisce l'indirizzo dell'azione precedente, che può essere
920 salvato per poterlo ripristinare (con un'altra chiamata a \func{signal}) in un
921 secondo tempo. Si ricordi che se si setta come azione \macro{SIG\_IGN} (o si
922 setta un \macro{SIG\_DFL} per un segnale il cui default è di essere ignorato),
923 tutti i segnali pendenti saranno scartati, e non verranno mai notificati.
924
925 L'uso di \func{signal} è soggetto a problemi di compatibilità, dato che essa
926 si comporta in maniera diversa per sistemi derivati da BSD o da System V. In
927 questi ultimi infatti la funzione è conforme al comportamento originale dei
928 primi Unix in cui il manipolatore viene disinstallato alla sua chiamata
929 secondo la semantica inaffidabile; Linux seguiva questa convenzione fino alle
930 \acr{libc5}. Al contrario BSD segue la semantica affidabile, non resettando il
931 manipolatore e bloccando il segnale durante l'esecuzione dello stesso. Con
932 l'utilizzo delle \acr{glibc2} anche Linux è passato a questo comportamento;
933 quello della versione originale della funzione, il cui uso è deprecato per i
934 motivi visti in \secref{sec:sig_semantics}, può essere ottenuto chiamando
935 \func{sysv\_signal}.  In generale, per evitare questi problemi, tutti i nuovi
936 programmi dovrebbero usare \func{sigaction}.
937
938 È da tenere presente che, seguendo lo standard POSIX, il comportamento di un
939 processo che ignora i segnali \macro{SIGFPE}, \macro{SIGILL}, o
940 \macro{SIGSEGV} (qualora non originino da una \func{kill} o una \func{raise})
941 è indefinito. Un manipolatore che ritorna da questi segnali può dare luogo ad
942 un ciclo infinito.
943
944
945 \subsection{Le funzioni \func{kill} e \func{raise}}
946 \label{sec:sig_kill_raise}
947
948 Come accennato in \secref{sec:sig_types}, un segnale può essere generato
949 direttamente da un processo. L'invio di un segnale generico può essere
950 effettuato attraverso delle funzioni \func{kill} e \func{raise}. La prima
951 serve per inviare un segnale al processo corrente, ed il suo prototipo è:
952 \begin{prototype}{signal.h}{int raise(int sig)}
953   Invia il segnale \param{sig} al processo corrente.
954   
955   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
956     errore, il solo errore restituito è \macro{EINVAL} qualora si sia
957     specificato un numero di segnale invalido.}
958 \end{prototype}
959
960 Il valore di \param{sig} specifica il segnale che si vuole inviare e può
961 essere specificato con una delle macro definite in
962 \secref{sec:sig_classification}.  In genere questa funzione viene usata per
963 riprodurre il comportamento di default di un segnale che sia stato
964 intercettato. In questo caso, una volta eseguite le operazioni volute, il
965 manipolatore potrà reinstallare l'azione di default, e attivarla con
966 \func{raise}.
967
968 Se invece si vuole inviare un segnale ad un altro processo occorre utilizzare
969 la funzione \func{kill}; il suo prototipo è:
970 \begin{functions}
971   \headdecl{sys/types.h}
972   \headdecl{signal.h}
973   \funcdecl{int kill(pid\_t pid, int sig)} Invia il segnale \param{sig} al
974   processo specificato con \param{pid}.
975
976   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
977     errore, nel qual caso \var{errno} assumerà i valori:
978   \begin{errlist}
979   \item[\macro{EINVAL}] Si è specificato un numero di segnale invalido.
980   \item[\macro{EPERM}] Il processo non ha il permesso di inviare il segnale
981   alla destinazione specificata.
982   \item[\macro{ESRCH}] Il \acr{pid} o il process group indicati non
983   esistono. Gli zombie (vedi \ref{sec:proc_termination}) sono considerati come
984   processi esistenti.
985   \end{errlist}}
986 \end{functions}
987
988 La funzione \code{raise(sig)} è sostanzialmente equivalente ad una
989 \code{kill(getpid(), sig)}. Siccome \func{raise}, che è definita nello
990 standard ISO C, non esiste in alcune vecchie versioni di Unix, in generale
991 l'uso di \func{kill} finisce per essere più portabile.
992
993 Lo standard POSIX poi prevede che il valore 0 sia usato per specificare il
994 segnale nullo.  Se le funzioni vengono chiamate con questo valore non viene
995 inviato nessun segnale, ma viene eseguito il controllo degli errori, in tal
996 caso si otterrà un errore \macro{EPERM} se non si hanno i permessi necessari
997 ed un errore \macro{ESRCH} se il processo specificato non esiste. Si tenga
998 conto però che il sistema ricicla i \acr{pid} (come accennato in
999 \secref{sec:proc_pid}) per cui l'esistenza di un processo non significa che
1000 esso sia realmente quello a cui si intendeva mandare il segnale.
1001
1002 Il valore dell'argomento \param{pid} specifica il processo (o i processi) di
1003 destinazione a cui il segnale deve essere inviato e può assumere i valori
1004 riportati in \tabref{tab:sig_kill_values}.
1005 \begin{table}[htb]
1006   \centering
1007   \begin{tabular}[c]{|r|l|}
1008     \hline
1009     \textbf{Valore} & \textbf{Significato} \\
1010     \hline
1011     \hline
1012     $>0$ & il segnale è mandato al processo con il \acr{pid} indicato.\\
1013     0    & il segnale è mandato ad ogni processo del \textit{process group}
1014     del chiamante.\\ 
1015     $-1$ & il segnale è mandato ad ogni processo (eccetto \cmd{init}).\\
1016     $<-1$ & il segnale è mandato ad ogni processo del process group 
1017     $|\code{pid}|$.\\
1018     \hline
1019   \end{tabular}
1020   \caption{Valori dell'argomento \param{pid} per la funzione
1021     \func{kill}.}
1022   \label{tab:sig_kill_values}
1023 \end{table}
1024
1025
1026 Solo l'amministratore può inviare un segnale ad un processo qualunque, in
1027 tutti gli altri casi il \textit{real user id} o l'\textit{effective user id}
1028 del processo chiamante devono corrispondere al \textit{real user id} o al
1029 \textit{saved user id} della destinazione. Fa eccezione il caso in cui il
1030 segnale inviato sia \macro{SIGCONT}, nel quale occorre che entrambi i processi
1031 appartengano alla stessa sessione. Inoltre, dato il ruolo fondamentale che
1032 riveste nel sistema (si ricordi quanto visto in \secref{sec:sig_termination}),
1033 non è possibile inviare al processo 1 (cioè a \cmd{init}) segnali per i quali
1034 esso non abbia un manipolatore installato.
1035
1036 Infine, seguendo le specifiche POSIX 1003.1-2001, l'uso della chiamata
1037 \code{kill(-1, sig)} comporta che il segnale sia inviato (con la solita
1038 eccezione di \cmd{init}) a tutti i processi per i quali i permessi lo
1039 consentano. Lo standard permette comunque alle varie implementazione di
1040 escludere alcuni processi specifici: nel caso in questione Linux non invia il
1041 segnale al processo che ha effettuato la chiamata.
1042
1043
1044 \subsection{Le funzioni \func{alarm} e \func{abort}}
1045 \label{sec:sig_alarm_abort}
1046
1047 Un caso particolare di segnali generati a richiesta è quello che riguarda i
1048 segnali di temporizzazione e e \macro{SIGABORT}, per i quali sono previste
1049 funzioni specifiche che ne effettuino l'invio. La prima di queste è
1050 \func{alarm} il cui prototipo è:
1051 \begin{prototype}{unistd.h}{unsigned int alarm(unsigned int seconds)}
1052   Predispone l'invio di \macro{SIGALARM} dopo \param{seconds} secondi.
1053   
1054   \bodydesc{La funzione restituisce il numero di secondi rimanenti ad un
1055     precedente allarme, o zero se non c'erano allarmi pendenti.}
1056 \end{prototype}
1057
1058 La funzione provvede un meccanismo che consente ad un processo di predisporre
1059 un'interruzione nel futuro, (ad esempio per effettuare una qualche operazione
1060 dopo un certo periodo di tempo), programmando l'emissione si un segnale di
1061 \macro{SIGALARM} dopo il numero di secondi specificato da \param{seconds}.
1062
1063 Se si specifica per \param{seconds} un valore nullo non verrà inviato nessun
1064 segnale; siccome alla chiamata viene cancellato ogni precedente allarme,
1065 questo può essere usato per cancellare una programmazione precedente. La
1066 funzione inoltre ritorna il numero di secondi rimanenti all'invio dell'allarme
1067 precedentemente programmato, in modo che sia eventualmente possibile
1068 effettuare delle scelte in caso di necessità di più interruzioni.
1069
1070 In \secref{sec:sys_unix_time} abbiamo visto che ad ogni processo sono
1071 associati tre tempi diversi: \textit{clock time}, \textit{user time} e
1072 \textit{system time}.  Per poterli calcolare il kernel mantiene per ciascun
1073 processo tre diversi timer:
1074 \begin{itemize}
1075 \item un \textit{real-time timer} che calcola il tempo reale trascorso (che
1076   corrisponde al \textit{clock time}). La scadenza di questo timer provoca
1077   l'emissione di \macro{SIGALARM}.
1078 \item un \textit{virtual timer} che calcola il tempo di processore usato dal
1079   processo in user space (che corrisponde all'\textit{user time}). La scadenza
1080   di questo timer provoca l'emissione di \macro{SIGVTALRM}.
1081 \item un \textit{profiling timer} che calcola la somma dei tempi di processore
1082   utilizzati direttamente dal processo in user space, e dal kernel nelle
1083   system call ad esso relative (che corrisponde a quello che in
1084   \secref{sec:sys_unix_time} abbiamo chiamato \textit{CPU time}). La scadenza
1085   di questo timer provoca l'emissione di \macro{SIGPROF}.
1086 \end{itemize}
1087
1088 Il timer usato da \func{alarm} è il \textit{clock time}, e corrisponde cioè al
1089 tempo reale. La funzione, pur essendo molto semplice, presenta numerosi
1090 limiti: non consente di usare gli altri timer, non può specificare intervalli
1091 con precisione maggiore del secondo e genera il segnale una sola volta.
1092
1093 Per ovviare a questi limiti Linux deriva da BSD la funzione \func{setitimer}
1094 che permette di usare un timer qualunque e l'invio di segnali periodici, al
1095 costo però di una maggiore complessità d'uso e di una minore portabilità. Il
1096 suo prototipo è:
1097 \begin{prototype}{sys/time.h}{int setitimer(int which, const struct
1098     itimerval *value, struct itimerval *ovalue)} 
1099   
1100   Predispone l'invio di un segnale di allarme alla scadenza dell'intervallo
1101   \param{value} sul timer specificato da \func{which}.
1102   
1103   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
1104     errore, nel qual caso \var{errno} può assumere i valori \macro{EINVAL} e
1105     \macro{EFAULT}.}
1106 \end{prototype}
1107
1108 Il valore di \param{which} permette di specificare quale dei tre timer
1109 illustrati in precedenza usare; i possibili valori sono riportati in
1110 \tabref{tab:sig_setitimer_values}.
1111 \begin{table}[htb]
1112   \centering
1113   \begin{tabular}[c]{|l|l|}
1114     \hline
1115     \textbf{Valore} & \textbf{Timer} \\
1116     \hline
1117     \hline
1118     \macro{ITIMER\_REAL}    & \textit{real-time timer}\\
1119     \macro{ITIMER\_VIRTUAL} & \textit{virtual timer}\\
1120     \macro{ITIMER\_PROF}    & \textit{profiling timer}\\
1121     \hline
1122   \end{tabular}
1123   \caption{Valori dell'argomento \param{which} per la funzione
1124     \func{setitimer}.}
1125   \label{tab:sig_setitimer_values}
1126 \end{table}
1127
1128 Il valore della struttura specificata \param{value} viene usato per settare il
1129 timer, se il puntatore \param{ovalue} non è nullo il precedente valore viene
1130 salvato qui. I valori dei timer devono essere indicati attraverso una
1131 struttura \var{itimerval}, definita in \ref{fig:file_stat_struct}.
1132
1133 La struttura è composta da due membri, il primo, \var{it\_interval} definisce
1134 il periodo del timer; il secondo, \var{it\_value} il tempo mancante alla
1135 scadenza. Entrambi esprimono i tempi tramite una struttura \var{timeval} che
1136 permette una precisione fino al microsecondo.
1137
1138 Ciascun timer decrementa il valore di \var{it\_value} fino a zero, poi invia
1139 il segnale e resetta \var{it\_value} al valore di \var{it\_interval},
1140 ripetendo il ciclo; se \var{it\_interval} è nullo il timer si ferma.
1141
1142 \begin{figure}[!htb]
1143   \footnotesize \centering
1144   \begin{minipage}[c]{15cm}
1145     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1146 struct itimerval {
1147     struct timeval it_interval; /* next value */
1148     struct timeval it_value;    /* current value */
1149 };
1150 struct timeval {
1151     long tv_sec;                /* seconds */
1152     long tv_usec;               /* microseconds */
1153 };
1154     \end{lstlisting}
1155   \end{minipage} 
1156   \normalsize 
1157   \caption{La struttura \var{itimerval}, che definisce i valori dei timer di
1158     sistema.} 
1159   \label{fig:sig_itimerval}
1160 \end{figure}
1161
1162 L'uso di \func{setitimer} consente dunque un controllo completo di tutte le
1163 caratteristiche dei timer, ed in effetti la stessa \func{alarm}, benché
1164 definita direttamente nello standard POSIX.1, può a sua volta essere espressa
1165 in termini di \func{setitimer}, come evidenziato dal manuale delle \acr{glibc}
1166 \cite{glibc} che ne riporta la definizione in \figref{fig:sig_alarm_def}.
1167
1168 \begin{figure}[!htb]
1169   \footnotesize \centering
1170   \begin{minipage}[c]{15cm}
1171     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1172 unsigned int alarm(unsigned int seconds)
1173 {
1174     struct itimerval old, new;
1175     new.it_interval.tv_usec = 0;
1176     new.it_interval.tv_sec = 0;
1177     new.it_value.tv_usec = 0;
1178     new.it_value.tv_sec = (long int) seconds;
1179     if (setitimer(ITIMER_REAL, &new, &old) < 0)
1180         return 0;
1181     else
1182         return old.it_value.tv_sec;
1183 }
1184     \end{lstlisting}
1185   \end{minipage} 
1186   \normalsize 
1187   \caption{Definizione di \func{alarm} in termini di \func{setitimer}.} 
1188   \label{fig:sig_alarm_def}
1189 \end{figure}
1190
1191 Si deve comunque tenere presente che la precisione di queste funzioni è
1192 limitata da quella del timer di sistema (in genere 10~ms). Il sistema assicura
1193 comunque che il segnale non sarà mai generato prima della scadenza programmata
1194 (l'arrotondamento cioè è sempre effettuato per eccesso). Una seconda causa di
1195 potenziali ritardi è che il segnale viene generato alla scadenza del timer,
1196 ma poi deve essere consegnato; se il processo è attivo (questo è sempre vero
1197 per \macro{ITIMER\_VIRT}) la consegna è immediata, altrimenti può esserci un
1198 ulteriore ritardo che può variare a seconda del carico del sistema.
1199
1200 Dato che sia \func{alarm} che \func{setitimer} non consentono di leggere il
1201 valore corrente di un timer senza modificarlo, è possibile usare la funzione
1202 \func{getitimer}, il cui prototipo è:
1203 \begin{prototype}{sys/time.h}{int getitimer(int which, struct
1204     itimerval *value)}
1205   
1206   Legge in \param{value} il valore del timer specificato da \func{which}.
1207   
1208   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
1209     errore e restituisce gli stessi errori di \func{getitimer}}
1210 \end{prototype}
1211 \noindent i cui parametri hanno lo stesso significato e formato di quelli di
1212 \func{setitimer}. 
1213
1214
1215 L'ultima funzione che permette l'invio diretto di un segnale è \func{abort};
1216 che, come accennato in \ref{sec:proc_termination}, permette di abortire
1217 l'esecuzione di un programma tramite l'invio di \macro{SIGABRT}. Il suo
1218 prototipo è:
1219 \begin{prototype}{stdlib.h}{void abort(void)}
1220   
1221   Abortisce il processo corrente.
1222   
1223   \bodydesc{La funzione non ritorna, il processo è terminato inviando il
1224   segnale di \macro{SIGABRT}.}
1225 \end{prototype}
1226
1227 La differenza fra questa funzione e l'uso di \func{raise} è che anche se il
1228 segnale è bloccato o ignorato, la funzione ha effetto lo stesso. Il segnale
1229 può però essere intercettato per effettuare eventuali operazioni di chiusura
1230 prima della terminazione del processo.
1231
1232 Lo standard ANSI C richiede inoltre che anche se il manipolatore ritorna, la
1233 funzione non ritorni comunque. Lo standard POSIX.1 va oltre e richiede che se
1234 il processo non viene terminato direttamente dal manipolatore sia la stessa
1235 \func{abort} a farlo al ritorno dello stesso. Inoltre, sempre seguendo lo
1236 standard POSIX, prima della terminazione tutti i file aperti e gli stream
1237 saranno chiusi ed i buffer scaricati su disco. Non verranno invece eseguite le
1238 funzioni registrate con \func{at\_exit} e \func{on\_exit}.
1239
1240
1241 \subsection{Le funzioni \func{pause} e \func{sleep}}
1242 \label{sec:sig_pause_sleep}
1243
1244 Il metodo tradizionale per fare attendere ad un processo fino all'arrivo di un
1245 segnale è quello di usare la funzione \func{pause}, il cui prototipo è:
1246 \begin{prototype}{unistd.h}{int pause(void)}
1247   
1248   Pone il processo in stato di sleep fino al ritorno di un manipolatore.
1249   
1250   \bodydesc{La funzione ritorna solo dopo che un segnale è stato ricevuto ed
1251   il relativo manipolatore è ritornato, nel qual caso restituisce -1 e setta
1252   \var{errno} a \macro{EINTR}.}
1253 \end{prototype}
1254
1255 La funzione segnala sempre una condizione di errore (il successo sarebbe
1256 quello di aspettare indefinitamente). In genere si usa questa funzione quando
1257 si vuole mettere un processo in attesa di un qualche evento specifico che non
1258 è sotto il suo diretto controllo (ad esempio la si può usare per far reagire
1259 il processo ad un segnale inviato da un altro processo).
1260
1261
1262 Se invece si vuole fare attendere un processo per un determinato intervallo di
1263 tempo lo standard POSIX.1 definisce la funzione \func{sleep}, il cui prototipo
1264 è:
1265 \begin{prototype}{unistd.h}{unsigned int sleep(unsigned int seconds)}
1266   
1267   Pone il processo in stato di sleep per \param{seconds} secondi.
1268   
1269   \bodydesc{La funzione restituisce zero se l'attesa viene completata, o il
1270   numero di secondi restanti se viene interrotta da un segnale.}
1271 \end{prototype}
1272
1273 La funzione attende per il tempo specificato, a meno di non essere interrotta
1274 da un segnale. In questo caso non è una buona idea ripetere la chiamata per il
1275 tempo rimanente, in quanto la riattivazione del processo può avvenire in un
1276 qualunque momento, ma il valore restituito sarà sempre arrotondato al secondo,
1277 con la conseguenza che, se la successione dei segnali è particolarmente
1278 sfortunata, si potranno avere ritardi anche di parecchi secondi. In genere la
1279 scelta più sicura è quella di stabilire un termine per l'attesa, e ricalcolare
1280 tutte le volte il numero di secondi da aspettare.
1281
1282 In alcune implementazioni inoltre l'uso di \func{sleep} può avere conflitti
1283 con quello di \macro{SIGALRM}, dato che la funzione può essere realizzata
1284 attraverso \func{pause} e \func{alarm} (in maniera analoga all'esempio che
1285 vedremo in \ref{sec:sig_example}). In tal caso mescolare chiamata di
1286 \func{alarm} e \func{sleep} o modificare l'azione di \macro{SIGALRM}, può
1287 causare risultati indefiniti. Nel caso delle \acr{glibc} è stata usata una
1288 implementazione completamente indipendente e questi problemi non ci sono.
1289
1290 La granularità di \func{sleep} permette di specificare attese in secondi, per
1291 questo sia sotto BSD4.3 che in SUSv2 è stata definita la funzione
1292 \func{usleep} (dove la \texttt{u} è intesa come sostituzione di $\mu$); i due
1293 standard hanno delle definizioni diverse, ma le \acr{glibc}
1294 seguono\footnote{secondo la man page almeno dalla versione 2.2.2.} seguono
1295 quella di SUSv2 che prevede il seguente prototipo: 
1296 \begin{prototype}{unistd.h}{int usleep(unsigned long usec)}
1297   
1298   Pone il processo in stato di sleep per \param{usec} microsecondi.
1299   
1300   \bodydesc{La funzione restituisce zero se l'attesa viene completata, o -1 in
1301     caso di errore, nel qual caso \var{errno} è settata a \macro{EINTR}.}
1302
1303 \end{prototype}
1304
1305 Anche questa funzione a seconda delle implementazioni può presentare problemi
1306 nell'interazione con \func{alarm} e \macro{SIGALRM}, ed è pertanto deprecata
1307 in favore di \func{nanosleep}, definita dallo standard POSIX1.b, il cui
1308 prototipo è:
1309 \begin{prototype}{unistd.h}{int nanosleep(const struct timespec *req, struct
1310     timespec *rem)}
1311   
1312   Pone il processo in stato di sleep per il tempo specificato da \param{req}.
1313   In caso di interruzione restituisce il tempo restante in \param{rem}.
1314   
1315   \bodydesc{La funzione restituisce zero se l'attesa viene completata, o -1 in
1316     caso di errore, nel qual caso \var{errno} è settata a 
1317     \begin{errlist}
1318     \item[\macro{EINVAL}] si è specificato un numero di secondi negativo o un
1319       numero di nanosecondi maggiore di 999.999.999.
1320     \item[\macro{EINTR}] la funzione è stata interrotta da un segnale.
1321     \end{errlist}}
1322 \end{prototype}
1323
1324 Lo standard richiede che la funzione sia implementata in maniera del tutto
1325 indipendente da \func{alarm}\footnote{nel caso di Linux questo è fatto
1326   utilizzando direttamente il timer del kernel.} e sia utilizzabile senza
1327 interferenze con l'uso di \macro{SIGALRM}. La funzione prende come parametri
1328 delle strutture di tipo \var{timespec}, la cui definizione è riportata in 
1329 \figref{fig:sig_timespec_def}, che permettono di specificare un tempo con una
1330 precisione (teorica) fino al nanosecondo. 
1331
1332 \begin{figure}[!htb]
1333   \footnotesize \centering
1334   \begin{minipage}[c]{15cm}
1335     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1336 struct timespec
1337 {
1338     time_t  tv_sec;         /* seconds */
1339     long    tv_nsec;        /* nanoseconds */
1340 };
1341     \end{lstlisting}
1342   \end{minipage} 
1343   \normalsize 
1344   \caption{La struttura \var{timespec} di \func{nanosleep}.} 
1345   \label{fig:sig_timespec_def}
1346 \end{figure}
1347
1348 La funzione risolve anche il problema di proseguire l'attesa dopo
1349 l'interruzione dovuta ad un segnale; infatti in tal caso in \param{rem} viene
1350 restituito il tempo rimanente rispetto a quanto richiesto inizialmente, e
1351 basta richiamare la funzione per completare l'attesa. 
1352
1353 Chiaramente, anche se il tempo può essere specificato con risoluzioni fino al
1354 nanosecondo, la precisione di \func{nanosleep} è determinata dalla risoluzione
1355 temporale del timer di sistema. Perciò la funzione attenderà comunque il tempo
1356 specificato, ma prima che il processo possa tornare ad essere eseguito
1357 occorrerà almeno attendere il successivo giro di scheduler e cioè un tempo che
1358 a seconda dei casi può arrivare fino a 1/\macro{HZ}, (sempre che il sistema
1359 sia scarico ed il processa venga immediatamente rimesso in esecuzione); per
1360 questo motivo il valore restituito in \param{rem} è sempre arrotondato al
1361 multiplo successivo di 1/\macro{HZ}.
1362
1363 In realtà è possibile ottenere anche pause più precise del centesimo di
1364 secondo usando politiche di scheduling real time come \macro{SCHED\_FIFO} o
1365 \macro{SCHED\_RR}; in tal caso infatti il meccanismo di scheduling ordinario
1366 viene evitato, e si raggiungono pause fino ai 2~ms con precisioni del $\mu$s.
1367
1368
1369
1370 \subsection{Un esempio elementare}
1371 \label{sec:sig_sigchld}
1372
1373 Un semplice esempio per illustrare il funzionamento di un manipolatore di
1374 segnale è quello della gestione di \macro{SIGCHLD}. Abbiamo visto in
1375 \secref{sec:proc_termination} che una delle azioni eseguite dal kernel alla
1376 conclusione di un processo è quella di inviare questo segnale al
1377 padre;\footnote{in realtà in SRV4 eredita la semantica di System V, in cui il
1378   segnale si chiama \macro{SIGCLD} e viene trattato in maniera speciale; in
1379   System V infatti se si setta esplicitamente l'azione a \macro{SIG\_IGN} il
1380   segnale non viene generato ed il sistema non genera zombie (lo stato di
1381   terminazione viene scartato senza dover chiamare una \func{wait}). L'azione
1382   di default è sempre quella di ignorare il segnale, ma non attiva questo
1383   comportamento. Linux, come BSD e POSIX, non supporta questa semantica ed usa
1384   il nome di \macro{SIGCLD} come sinonimo di \macro{SIGCHLD}.} in questo caso
1385 tutto quello che dovrà fare il manipolatore è ricevere lo stato di
1386 terminazione in modo da evitare la formazione di zombie.
1387
1388 %  è pertanto
1389 % naturale usare un esempio che ci permette di concludere la trattazione della
1390 % terminazione dei processi.
1391 % In questo caso si è tratterà di illustrare un esempio relativo ad un
1392 % manipolatore per che è previsto ritornare,
1393
1394 In 
1395
1396
1397
1398
1399 \begin{figure}[!htb]
1400   \footnotesize \centering
1401   \begin{minipage}[c]{15cm}
1402     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1403 #include <errno.h>       /* error simbol definitions */
1404 #include <signal.h>      /* signal handling declarations */
1405 #include <sys/types.h>
1406 #include <sys/wait.h>
1407 #include "macro.h"
1408
1409 void Hand_CHLD(int sig)
1410 {
1411     int errno_save;
1412     int status;
1413     pid_t pid;
1414     /* save errno current value */
1415     errno_save = errno;
1416     /* loop until no */
1417     do {
1418         errno = 0;
1419         pid = waitpid(WAIT_ANY, &status, WNOHANG);
1420         if (pid > 0) {
1421             debug("child %d terminated with status %x\n", pid, status);
1422         }
1423     } while ((pid > 0) && (errno == EINTR));
1424     /* restore errno value*/
1425     errno = errno_save;
1426     /* return */
1427     return;
1428 }
1429     \end{lstlisting}
1430   \end{minipage} 
1431   \normalsize 
1432   \caption{Una implementazione sbagliata di \func{sleep}.} 
1433   \label{fig:sig_timespec_def}
1434 \end{figure}
1435
1436
1437
1438
1439
1440 \section{Gestione avanzata}
1441 \label{sec:sig_control}
1442
1443 Le funzioni esaminate finora fanno riferimento ad alle modalità più elementari
1444 della gestione dei segnali; non si sono pertanto ancora prese in
1445 considerazione le tematiche più complesse, collegate alle varie race condition
1446 che i segnali possono generare e alla natura asincrona degli stessi.
1447
1448 Affronteremo queste problematiche in questa sezione, partendo da un esempio
1449 che le evidenzi, per poi prendere in esame le varie funzioni che permettono di
1450 risolvere i problemi più complessi connessi alla programmazione con i segnali.
1451
1452
1453 \subsection{Un esempio di problema}
1454 \label{sec:sig_example}
1455
1456 Come accennato in \ref{sec:sig_pause_sleep} è possibile implementare
1457 \func{sleep} a partire da dall'uso di \func{pause} e \func{alarm}. A prima
1458 vista questo può sembrare di implementazione immediata; ad esempio una
1459 semplice versione di \func{sleep} potrebbe essere la seguente:
1460 \begin{figure}[!htb]
1461   \footnotesize \centering
1462   \begin{minipage}[c]{15cm}
1463     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1464 unsigned int sleep(unsigned int seconds)
1465 {
1466     signandler_t prev_handler;
1467     if ((prev_handler = signal(SIGALRM, alarm_hand)) == SIG_ERR) {
1468         printf("Cannot set handler for alarm\n");
1469         exit(1);
1470     }
1471     alarm(second);
1472     pause(); 
1473     /* restore previous signal handler */
1474     signal(SIGALRM, prev_handler);
1475     /* remove alarm, return remaining time */
1476     return alarm(0);
1477 }
1478 void alarm_hand(int sig) {
1479     /* check if the signal is the right one */
1480     if (sig != SIGALRM) { /* if not exit with error */
1481         printf("Something wrong, handler for SIGALRM\n");
1482         exit(1);
1483     } else {    /* do nothing, just interrupt pause */
1484         return;
1485     }
1486 }      
1487     \end{lstlisting}
1488   \end{minipage} 
1489   \normalsize 
1490   \caption{Una implementazione sbagliata di \func{sleep}.} 
1491   \label{fig:sig_timespec_def}
1492 \end{figure}
1493
1494 Ma questa funzione, a parte il non gestire il caso in cui si è avuta una
1495 precedente chiamata a \func{alarm}, presenta una pericolosa race condition.
1496 Infatti se il processo viene interrotto fra la chiamata di \func{alarm} e
1497 \func{pause} può capitare (nel caso il sistema sia molto carico) che
1498 quest'ultima possa essere eseguita dopo l'arrivo di \macro{SIGALRM}. In questo
1499 caso ci si troverebbe di fronte ad un deadlock, in cui \func{pause} non
1500 verrebbe mai interrotta (se non in caso di un altro segnale).
1501
1502 Come abbiamo accennato in \secref{sec:proc_atom_oper} quando si ha a che fare
1503 con i segnali 
1504
1505
1506
1507
1508 \subsection{Le funzioni \func{sigprocmask} e \func{sigpending}}
1509 \label{sec:sig_sigpending}
1510
1511
1512
1513
1514 \subsection{La funzione \func{sigaction}}
1515 \label{sec:sig_sigaction}
1516
1517
1518
1519 \subsection{Funzioni rientranti e default dei segnali}
1520 \label{sec:sig_reentrant}
1521
1522
1523 , affrontando inoltre le varie problematiche di programmazione che si devono
1524 tenere presenti quando si ha a che fare con essi.
1525
1526
1527
1528 %%% Local Variables: 
1529 %%% mode: latex
1530 %%% TeX-master: "gapil"
1531 %%% End: