Rimaneggiamenti generali
[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 generali relativi ai segnali, vedremo
26 le loro caratteristiche di base, introdurremo le nozioni di fondo relative
27 all'architettura del funzionamento dei segnali e alle modalità con cui il
28 sistema gestisce l'interazione fra di essi ed i processi.
29
30
31 \subsection{I concetti base}
32 \label{sec:sig_base}
33
34 Come il nome stesso indica i segnali sono usati per notificare ad un processo
35 l'occorrenza di un qualche evento. Gli eventi che possono generare un segnale
36 sono vari; un breve elenco di possibili cause per l'emissione di un segnale è
37 il seguente:
38
39 \begin{itemize*}
40 \item un errore del programma, come una divisione per zero o un tentativo di
41   accesso alla memoria fuori dai limiti validi.
42 \item la terminazione di un processo figlio.
43 \item la scadenza di un timer o di un allarme.
44 \item il tentativo di effettuare un'operazione di input/output che non può
45   essere eseguita.
46 \item una richiesta dell'utente di terminare o fermare il programma. In genere
47   si realizza attraverso un segnale mandato dalla shell in corrispondenza
48   della pressione di tasti del terminale come \code{C-c} o
49   \code{C-z}.\footnote{indichiamo con \code{C-x} la pressione simultanea al
50     tasto \code{x} del tasto control (ctrl in molte tastiere).}
51 \item l'esecuzione di una \func{kill} o di una \func{raise} da parte del
52   processo stesso o di un'altro (solo nel caso della \func{kill}).
53 \end{itemize*}
54
55 Ciascuno di questi eventi (compresi gli ultimi due che pure sono controllati
56 dall'utente o da un altro processo) comporta l'intervento diretto da parte del
57 kernel che causa la generazione un particolare tipo di segnale.
58
59 Quando un processo riceve un segnale, invece del normale corso del programma,
60 viene eseguita una azione di default o una apposita routine di gestione (il
61 cosiddetto \textit{signal handler} o \textsl{manipolatore}) che può essere
62 stata specificata dall'utente (nel qual caso si dice che si
63 \textsl{intercetta} il segnale).
64
65
66 \subsection{Le modalità di funzionamento}
67 \label{sec:sig_semantics}
68
69 Negli anni il comportamento del sistema in risposta ai segnali è stato
70 modificato in vari modi nelle differenti implementazioni di Unix.  Si possono
71 individuare due tipologie fondamentali di comportamento dei segnali (dette
72 semantiche) che vengono chiamate rispettivamente semantica \textsl{affidabile}
73 (o \textit{reliable}) e semantica \textsl{inaffidabile} (o
74 \textit{unreliable}).
75
76 Nella semantica \textsl{inaffidabile} (quella implementata dalle prime
77 versioni di Unix) la routine di gestione del segnale specificata dall'utente
78 non resta attiva una volta che è stata eseguita; è perciò compito dell'utente
79 stesso ripetere l'installazione della stessa all'interno della routine di
80 gestione, in tutti i casi in cui si vuole che il manipolatore esterno resti
81 attivo.
82
83 In questo caso è possibile una situazione in cui i segnali possono essere
84 perduti. Si consideri il seguente segmento di codice, in cui la prima
85 operazione del manipolatore è quella di reinstallare se stesso: 
86
87 \footnotesize
88 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
89     int sig_handler();            /* handler function */
90     ...
91     signal(SIGINT, sig_handler);  /* establish handler */
92     ...
93
94 int sig_handler() 
95 {
96     signal(SIGINT, sig_handler);  /* restablish handler */
97     ...                           /* process signal */
98 }
99 \end{lstlisting}
100 \normalsize
101 se un secondo segnale arriva prima che il manipolatore invocato dal primo
102 abbia eseguito la reinstallazione di se stesso il segnale può essere perso o
103 causare il comportamento originale assegnato al segnale (in genere la
104 terminazione del processo).
105
106 Questa è la ragione per cui l'implementazione dei segnali secondo questa
107 semantica viene chiamata \textsl{inaffidabile}; infatti la ricezione del
108 segnale e la reinstallazione del suo manipolatore non sono operazioni
109 atomiche, e sono sempre possibili delle race condition (sull'argomento vedi
110 quanto detto in \secref{sec:proc_multi_prog}).
111
112 Un'altro problema è che in questa semantica non esiste un modo per bloccare i
113 segnali quando non si vuole che arrivino; i processi possono ignorare il
114 segnale, ma non è possibile istruire il sistema a non fare nulla in occasione
115 di un segnale, pur mantenendo memoria del fatto che è avvenuto.
116
117 % Un caso classico in cui si incontra questo problema, è quello in cui si usa il
118 % manipolatore per settare un flag che riporta al processo l'occorrenza del
119 % segnale, così che questo possa prendere provvedimenti al di fuori del
120 % manipolatore. Si consideri il seguente segmento di codice il cui scopo sarebbe
121 % quello di fermare il processo fino all'occorrenza di un opportuno segnale:
122
123 % \footnotesize
124 % \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
125 % int signal_flag = 0;
126 % main()
127 % {
128 %     int sig_handler();            /* handler function */
129 %     ...
130 %     signal(SIGINT, sig_handler);  /* establish handler */
131 %     ...
132 %     while(signal_flag == 0) {     /* while flag is zero */
133 %         pause();                  /* go to sleep */
134 %     }
135 %     ... 
136 % }
137 % int sig_handler() 
138 % {
139 %     signal(SIGINT, sig_handler);  /* restablish handler */
140 %     signal_flag = 1;              /* set flag */
141 % }
142 % \end{lstlisting}
143 % \normalsize
144 % l'idea è che quando il processo trova il flag a zero viene messo in sleep e
145 % verrà risvegliato solo dalla ricezione di un segnale. Il manipolatore si
146 % limita in questo caso a settare il flag a uno; all'uscita dal manipolatore la
147 % chiamata a \func{pause} è interrotta ed il processo viene risvegliato e
148 % riprende l'esecuzione all'istruzione successiva, ma essendo cambiato il flag
149 % la condizione non è più soddisfatta e il programma prosegue.
150
151 % Il problema con l'implementazione inaffidabile è che niente ci garantisce che
152 % il segnale arrivi fra la valutazione della condizione del \code{while} e la
153 % chiamata a \func{pause}, nel qual caso, se il segnale non viene più generato,
154 % il processo resterà in sleep permanentemente.
155
156 % % Un'altra caratteristica della implementazione inaffidabile è che le chiamate
157 % % di sistema non sono fatte ripartire automaticamente quando sono interrotte da
158 % % un segnale, per questo un programma deve controllare lo stato di uscita della
159 % % chiamata al sistema e ripeterla nel caso l'errore riportato da \texttt{errno}
160 % % sia \texttt{EINTR}.
161
162 % Questo ci mostra ad esempio come con la semantica inaffidabile non esista una
163 % modalità semplice per ottenere una operazione di attesa mandando in stato di
164 % sleep (vedi \ref{sec:proc_sched}) un processo fino all'arrivo di un segnale.
165
166 Nella semantica \textsl{affidabile} (quella utilizzata da Linux e da ogni Unix
167 moderno) il manipolatore una volta installato resta attivo e non si hanno
168 tutti i problemi precedenti. In questa semantica i segnali vengono
169 \textsl{generati} dal kernel per un processo all'occorrenza dell'evento che
170 causa il segnale. In genere questo viene fatto dal kernel settando l'apposito
171 campo della \var{task\_struct} del processo nella process table (si veda
172 \figref{fig:proc_task_struct}).
173
174 Si dice che il segnale viene \textsl{consegnato} al processo (dall'inglese
175 \textit{delivered}) quando viene eseguita l'azione per esso prevista, mentre
176 per tutto il tempo che passa fra la generazione del segnale e la sua consegna
177 esso è detto \textsl{pendente} (o \textit{pending}). In genere questa
178 procedura viene effettuata dallo scheduler quando, riprendendo l'esecuzione
179 del processo in questione, verifica la presenza del segnale nella
180 \var{task\_struct} e mette in esecuzione il manipolatore.
181
182 In questa semantica un processo ha la possibilità di bloccare la consegna dei
183 segnali, in questo caso, se l'azione per il suddetto segnale non è quella di
184 ignorarlo, il segnale resta \textsl{pendente} fintanto che il processo non lo
185 sblocca (nel qual caso viene consegnato) o setta l'azione di default per
186 ignorarlo.
187
188 Si tenga presente che il kernel stabilisce cosa fare con un segnale che è
189 stato bloccato al momento della consegna, non quando viene generato; questo
190 consente di cambiare l'azione per il segnale prima che esso venga consegnato,
191 e si può usare la funzione \func{sigpending} (vedi
192 \secref{sec:sig_sigpending}) per determinare quali segnali sono bloccati e
193 quali sono pendenti.
194
195
196 \subsection{Tipi di segnali}
197 \label{sec:sig_types}
198
199 In generale gli eventi che generano segnali si possono dividere in tre
200 categorie principali: errori, eventi esterni e richieste esplicite.
201
202 Un errore significa che un programma ha fatto qualcosa di sbagliato e non può
203 continuare ad essere eseguito. Non tutti gli errori causano dei segnali, in
204 genere la condizione di errore più comune comporta la restituzione di un
205 codice di errore da parte di una funzione di libreria, sono gli errori che
206 possono avvenire ovunque in un programma che causano l'emissione di un
207 segnale, come le divisioni per zero o l'uso di indirizzi di memoria non validi.
208
209 Un evento esterno ha in genere a che fare con l'I/O o con altri processi;
210 esempi di segnali di questo tipo sono quelli legati all'arrivo di dati di
211 input, scadenze di un timer, terminazione di processi figli.
212
213 Una richiesta esplicita significa l'uso di una chiamata di sistema (come
214 \func{kill} o \func{raise}) per la generazione di un segnale, cosa che
215 viene fatta usualmente dalla shell quando l'utente invoca la sequenza di tasti
216 di stop o di suspend, ma può essere pure inserita all'interno di un programma.
217
218 Si dice poi che i segnali possono essere \textsl{asincroni} o
219 \textsl{sincroni}. Un segnale \textsl{sincrono} è legato ad una azione
220 specifica di un programma ed è inviato (a meno che non sia bloccato) durante
221 tale azione; molti errori generano segnali \textsl{sincroni}, così come la
222 richiesta esplicita da parte del processo tramite le chiamate al sistema.
223 Alcuni errori come la divisione per zero non sono completamente sincroni e
224 possono arrivare dopo qualche istruzione.
225
226 I segnali \textsl{asincroni} sono generati da eventi fuori dal controllo del
227 processo che li riceve, e arrivano in tempi impredicibili nel corso
228 dell'esecuzione del programma. Eventi esterni come la terminazione di un
229 processo figlio generano segnali \textsl{asincroni}, così come le richieste di
230 generazione di un segnale effettuate da altri processi.
231
232 In generale un tipo di segnale o è sincrono o è asincrono, salvo il caso in
233 cui esso sia generato attraverso una richiesta esplicita tramite chiamata al
234 sistema, nel qual caso qualunque tipo di segnale (quello scelto nella
235 chiamata) può diventare sincrono o asincrono a seconda che sia generato
236 internamente o esternamente al processo.
237
238
239 \subsection{La notifica dei segnali}
240 \label{sec:sig_notification}
241
242 Come accennato quando un segnale viene generato, se la sua azione di default
243 non è quella di essere ignorato, il kernel prende nota del fatto nella
244 \var{task\_struct} del processo; si dice così che il segnale diventa
245 \textsl{pendente} (o \textit{pending}), e rimane tale fino al momento in cui
246 verrà notificato al processo (o verrà specificata come azione di default
247 quella di ignorarlo).
248
249 Normalmente l'invio al processo che deve ricevere il segnale è immediato ed
250 avviene non appena questo viene rimesso in esecuzione dallo scheduler che
251 esegue l'azione specificata. Questo a meno che il segnale in questione non sia
252 stato bloccato prima della notifica, nel qual caso l'invio non avviene ed il
253 segnale resta \textsl{pendente} indefinitamente. Quando lo si sblocca il
254 segnale \textsl{pendente} sarà subito notificato.
255
256 Si ricordi però che se l'azione specificata per un segnale è quella di essere
257 ignorato questo sarà scartato immediatamente al momento della sua generazione,
258 e questo anche se in quel momento il segnale è bloccato (perché ciò che viene
259 bloccata è la notifica). Per questo motivo un segnale, fintanto che viene
260 ignorato, non sarà mai notificato, anche se è stato bloccato ed in seguito si
261 è specificata una azione diversa (nel qual caso solo i segnali successivi alla
262 nuova specificazione saranno notificati).
263
264 Una volta che un segnale viene notificato (che questo avvenga subito o dopo
265 una attesa più o meno lunga) viene eseguita l'azione specificata per il
266 segnale. Per alcuni segnali (\macro{SIGKILL} e \macro{SIGSTOP}) questa azione
267 è fissa e non può essere cambiata, ma per tutti gli altri si può selezionare
268 una  delle tre possibilità seguenti:
269
270 \begin{itemize*}
271 \item ignorare il segnale.
272 \item catturare il segnale, ed utilizzare il manipolatore specificato.
273 \item accettare l'azione di default per quel segnale.
274 \end{itemize*}
275
276 Un programma può specificare queste scelte usando le due funzioni
277 \func{signal} e \func{sigaction} (vedi \secref{sec:sig_signal} e
278 \secref{sec:sig_sigaction}). Se si è installato un manipolatore sarà
279 quest'ultimo ad essere eseguito alla notifica del segnale.  Inoltre il sistema
280 farà si che mentre viene eseguito il manipolatore di un segnale, quest'ultimo
281 venga automaticamente bloccato (così si possono evitare race condition).
282
283 Nel caso non sia stata specificata un'azione, viene utilizzata l'azione
284 standard che (come vedremo in \secref{sec:sig_standard}) è propria di ciascun
285 segnale; nella maggior parte dei casi essa porta alla terminazione del
286 processo, ma alcuni segnali che rappresentano eventi innocui vengono ignorati.
287
288 Quando un segnale termina un processo, il padre può determinare la causa della
289 terminazione esaminando il codice di stato riportato delle funzioni
290 \func{wait} e \func{waitpid} (vedi \secref{sec:proc_wait}); questo è il modo
291 in cui la shell determina i motivi della terminazione di un programma e scrive
292 un eventuale messaggio di errore.
293
294 I segnali che rappresentano errori del programma (divisione per zero o
295 violazioni di accesso) hanno anche la caratteristica di scrivere un file di
296 \textit{core dump} che registra lo stato del processo (ed in particolare della
297 memoria e dello stack) prima della terminazione.  Questo può essere esaminato
298 in seguito con un debugger per investigare sulla causa dell'errore.  Lo stesso
299 avviene se i suddetti segnale vengono generati con una \func{kill}.
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, (quelle che, per questo, vengono chiamate \textsl{lente}). Un
824 elenco 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 \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 di un segnale (in
1061 genere \macro{SIGALARM}) dopo il numero di secondi specificato da
1062 \param{seconds}.
1063
1064 Se si specifica per \param{seconds} un valore nullo non verrà inviato nessun
1065 segnale; siccome alla chiamata viene cancellato ogni precedente allarme,
1066 questo può essere usato per cancellare una programmazione precedente. La
1067 funzione inoltre ritorna il numero di secondi rimanenti all'invio dell'allarme
1068 precedentemente programmato, in modo che sia eventualmente possibile
1069 effettuare delle scelte in caso di necessità di più interruzioni.
1070
1071 In \secref{sec:sys_unix_time} abbiamo visto che ad ogni processo sono
1072 associati tre tempi diversi: \textit{clock time}, \textit{user time} e
1073 \textit{system time}.  Per poterli calcolare il kernel mantiene per ciascun
1074 processo tre diversi timer:
1075 \begin{itemize}
1076 \item un \textit{real-time timer} che calcola il tempo reale trascorso (che
1077   corrisponde al \textit{clock time}). La scadenza di questo timer provoca
1078   l'emissione di \macro{SIGALARM}.
1079 \item un \textit{virtual timer} che calcola il tempo di processore usato dal
1080   processo in user space (che corrisponde all'\textit{user time}). La scadenza
1081   di questo timer provoca l'emissione di \macro{SIGVTALRM}.
1082 \item un \textit{profiling timer} che calcola la somma dei tempi di processore
1083   utilizzati direttamente dal processo in user space, e dal kernel nelle
1084   system call ad esso relative (che corrisponde a quello che in
1085   \secref{sec:sys_unix_time} abbiamo chiamato \textit{CPU time}). La scadenza
1086   di questo timer provoca l'emissione di \macro{SIGPROF}.
1087 \end{itemize}
1088
1089 Il timer usato da \func{alarm} è il \textit{clock time}, e corrisponde cioè al
1090 tempo reale. La funzione come abbiamo visto è molto semplice, ma proprio per
1091 questo presenta numerosi limiti: non consente di usare gli altri timer, non
1092 può specificare intervalli di tempo con precisione maggiore del secondo e
1093 genera il segnale una sola volta.
1094
1095 Per ovviare a questi limiti Linux deriva da BSD la funzione \func{setitimer}
1096 che permette di usare un timer qualunque e l'invio di segnali periodici, al
1097 costo però di una maggiore complessità d'uso e di una minore portabilità. Il
1098 suo prototipo è:
1099 \begin{prototype}{sys/time.h}{int setitimer(int which, const struct
1100     itimerval *value, struct itimerval *ovalue)} 
1101   
1102   Predispone l'invio di un segnale di allarme alla scadenza dell'intervallo
1103   \param{value} sul timer specificato da \func{which}.
1104   
1105   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
1106     errore, nel qual caso \var{errno} può assumere i valori \macro{EINVAL} e
1107     \macro{EFAULT}.}
1108 \end{prototype}
1109
1110 Il valore di \param{which} permette di specificare quale dei tre timer
1111 illustrati in precedenza usare; i possibili valori sono riportati in
1112 \tabref{tab:sig_setitimer_values}.
1113 \begin{table}[htb]
1114   \centering
1115   \begin{tabular}[c]{|l|l|}
1116     \hline
1117     \textbf{Valore} & \textbf{Timer} \\
1118     \hline
1119     \hline
1120     \macro{ITIMER\_REAL}    & \textit{real-time timer}\\
1121     \macro{ITIMER\_VIRTUAL} & \textit{virtual timer}\\
1122     \macro{ITIMER\_PROF}    & \textit{profiling timer}\\
1123     \hline
1124   \end{tabular}
1125   \caption{Valori dell'argomento \param{which} per la funzione
1126     \func{setitimer}.}
1127   \label{tab:sig_setitimer_values}
1128 \end{table}
1129
1130 Il valore della struttura specificata \param{value} viene usato per settare il
1131 timer, se il puntatore \param{ovalue} non è nullo il precedente valore viene
1132 salvato qui. I valori dei timer devono essere indicati attraverso una
1133 struttura \var{itimerval}, definita in \ref{fig:file_stat_struct}.
1134
1135 La struttura è composta da due membri, il primo, \var{it\_interval} definisce
1136 il periodo del timer; il secondo, \var{it\_value} il tempo mancante alla
1137 scadenza. Entrambi esprimono i tempi tramite una struttura \var{timeval} che
1138 permette una precisione fino al microsecondo.
1139
1140 Ciascun timer decrementa il valore di \var{it\_value} fino a zero, poi invia
1141 il segnale e resetta \var{it\_value} al valore di \var{it\_interval},
1142 ripetendo il ciclo; se \var{it\_interval} è nullo il timer si ferma.
1143
1144 \begin{figure}[!htb]
1145   \footnotesize \centering
1146   \begin{minipage}[c]{15cm}
1147     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1148 struct itimerval {
1149     struct timeval it_interval; /* next value */
1150     struct timeval it_value;    /* current value */
1151 };
1152 struct timeval {
1153     long tv_sec;                /* seconds */
1154     long tv_usec;               /* microseconds */
1155 };
1156     \end{lstlisting}
1157   \end{minipage} 
1158   \normalsize 
1159   \caption{La struttura \var{itimerval}, che definisce i valori dei timer di
1160     sistema.} 
1161   \label{fig:sig_itimerval}
1162 \end{figure}
1163
1164 L'uso di \func{setitimer} consente dunque un controllo completo di tutte le
1165 caratteristiche dei timer, ed in effetti la stessa \func{alarm}, benché
1166 definita direttamente nello standard POSIX.1, può a sua volta essere espressa
1167 in termini di \func{setitimer}, come evidenziato dal manuale delle \acr{glibc}
1168 \cite{glibc} che ne riporta la definizione in \figref{fig:sig_alarm_def}.
1169
1170 \begin{figure}[!htb]
1171   \footnotesize \centering
1172   \begin{minipage}[c]{15cm}
1173     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1174 unsigned int alarm(unsigned int seconds)
1175 {
1176     struct itimerval old, new;
1177     new.it_interval.tv_usec = 0;
1178     new.it_interval.tv_sec = 0;
1179     new.it_value.tv_usec = 0;
1180     new.it_value.tv_sec = (long int) seconds;
1181     if (setitimer(ITIMER_REAL, &new, &old) < 0)
1182         return 0;
1183     else
1184         return old.it_value.tv_sec;
1185 }
1186     \end{lstlisting}
1187   \end{minipage} 
1188   \normalsize 
1189   \caption{Definizione di \func{alarm} in termini di \func{setitimer}.} 
1190   \label{fig:sig_alarm_def}
1191 \end{figure}
1192
1193 Si deve comunque tenere presente che la precisione di queste funzioni è
1194 limitata da quella del timer di sistema (in genere 10~ms). Il sistema assicura
1195 comunque che il segnale non sarà mai generato prima della scadenza programmata
1196 (l'arrotondamento cioè è sempre effettuato per eccesso). Una seconda causa di
1197 potenziali ritardi è che il segnale viene generato alla scadenza del timer,
1198 ma poi deve essere consegnato; se il processo è attivo (questo è sempre vero
1199 per \macro{ITIMER\_VIRT}) la consegna è immediata, altrimenti può esserci un
1200 ulteriore ritardo che può variare a seconda del carico del sistema.
1201
1202 Dato che sia \func{alarm} che \func{setitimer} non consentono di leggere il
1203 valore corrente di un timer senza modificarlo, è possibile usare la funzione
1204 \func{getitimer}, il cui prototipo è:
1205 \begin{prototype}{sys/time.h}{int getitimer(int which, struct
1206     itimerval *value)}
1207   
1208   Legge in \param{value} il valore del timer specificato da \func{which}.
1209   
1210   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
1211     errore e restituisce gli stessi errori di \func{getitimer}}
1212 \end{prototype}
1213 \noindent i cui parametri hanno lo stesso significato e formato di quelli di
1214 \func{setitimer}. 
1215
1216
1217 L'ultima funzione che permette l'invio diretto di un segnale è \func{abort};
1218 che, come accennato in \ref{sec:proc_termination}, permette di abortire
1219 l'esecuzione di un programma tramite l'invio di \macro{SIGABRT}. Il suo
1220 prototipo è:
1221 \begin{prototype}{stdlib.h}{void abort(void)}
1222   
1223   Abortisce il processo corrente.
1224   
1225   \bodydesc{La funzione non ritorna, il processo è terminato inviando il
1226   segnale di \macro{SIGABRT}.}
1227 \end{prototype}
1228
1229 La differenza fra questa funzione e l'uso di \func{raise} è che anche se il
1230 segnale è bloccato o ignorato, la funzione ha effetto lo stesso. Il segnale
1231 può però essere intercettato per effettuare eventuali operazioni di chiusura
1232 prima della terminazione del processo.
1233
1234 Lo standard ANSI C richiede inoltre che anche se il manipolatore ritorna, la
1235 funzione non ritorni comunque. Lo standard POSIX.1 va oltre e richiede che se
1236 il processo non viene terminato direttamente dal manipolatore sia la stessa
1237 \func{abort} a farlo al ritorno dello stesso. Inoltre, sempre seguendo lo
1238 standard POSIX, prima della terminazione tutti i file aperti e gli stream
1239 saranno chiusi ed i buffer scaricati su disco. Non verranno invece eseguite le
1240 funzioni registrate con \func{at\_exit} e \func{on\_exit}.
1241
1242
1243 \subsection{Le funzioni \func{pause} e \func{sleep}}
1244 \label{sec:sig_pause_sleep}
1245
1246 Il metodo tradizionale per fare attendere ad un processo fino all'arrivo di un
1247 segnale è quello di usare la funzione \func{pause}, il cui prototipo è:
1248 \begin{prototype}{unistd.h}{int pause(void)}
1249   
1250   Pone il processo in stato di sleep fino al ritorno di un manipolatore.
1251   
1252   \bodydesc{La funzione ritorna solo dopo che un segnale è stato ricevuto ed
1253   il relativo manipolatore è ritornato, nel qual caso restituisce -1 e setta
1254   \var{errno} a \macro{EINTR}.}
1255 \end{prototype}
1256
1257 La funzione segnala sempre una condizione di errore (il successo sarebbe
1258 quello di aspettare indefinitamente). In genere si usa questa funzione quando
1259 si vuole mettere un processo in attesa di un qualche evento specifico che non
1260 è sotto il suo diretto controllo (ad esempio la si può usare per far reagire
1261 il processo ad un segnale inviato da un altro processo).
1262
1263
1264 Se invece si vuole fare attendere un processo per un determinato intervallo di
1265 tempo lo standard POSIX.1 definisce la funzione \func{sleep}, il cui prototipo
1266 è:
1267 \begin{prototype}{unistd.h}{unsigned int sleep(unsigned int seconds)}
1268   
1269   Pone il processo in stato di sleep per \param{seconds} secondi.
1270   
1271   \bodydesc{La funzione restituisce zero se l'attesa viene completata, o il
1272   numero di secondi restanti se viene interrotta da un segnale.}
1273 \end{prototype}
1274
1275 La funzione attende per il tempo specificato, a meno di non essere interrotta
1276 da un segnale. In questo caso non è una buona idea ripetere la chiamata per il
1277 tempo rimanente, in quanto la riattivazione del processo può avvenire in un
1278 qualunque momento, ma il valore restituito sarà sempre arrotondato al secondo,
1279 con la conseguenza che, se la successione dei segnali è particolarmente
1280 sfortunata, si potranno avere ritardi anche di parecchi secondi. In genere la
1281 scelta più sicura è quella di stabilire un termine per l'attesa, e ricalcolare
1282 tutte le volte il numero di secondi da aspettare.
1283
1284 In alcune implementazioni inoltre l'uso di \func{sleep} può avere conflitti
1285 con quello di \macro{SIGALRM}, dato che la funzione può essere realizzata
1286 attraverso \func{pause} e \func{alarm} (in maniera analoga all'esempio che
1287 vedremo in \ref{sec:sig_example}). In tal caso mescolare chiamata di
1288 \func{alarm} e \func{sleep} o modificare l'azione di \macro{SIGALRM}, può
1289 causare risultati indefiniti. Nel caso delle \acr{glibc} è stata usata una
1290 implementazione completamente indipendente e questi problemi non ci sono.
1291
1292 La granularità di \func{sleep} permette di specificare attese in secondi, per
1293 questo sia sotto BSD4.3 che in SUSv2 è stata definita la funzione
1294 \func{usleep} (dove la \texttt{u} è intesa come sostituzione di $\mu$); i due
1295 standard hanno delle definizioni diverse, ma le \acr{glibc}
1296 seguono\footnote{secondo la man page almeno dalla versione 2.2.2.} seguono
1297 quella di SUSv2 che prevede il seguente prototipo: 
1298 \begin{prototype}{unistd.h}{int usleep(unsigned long usec)}
1299   
1300   Pone il processo in stato di sleep per \param{usec} microsecondi.
1301   
1302   \bodydesc{La funzione restituisce zero se l'attesa viene completata, o -1 in
1303     caso di errore, nel qual caso \var{errno} è settata a \macro{EINTR}.}
1304
1305 \end{prototype}
1306
1307 Anche questa funzione a seconda delle implementazioni può presentare problemi
1308 nell'interazione con \func{alarm} e \macro{SIGALRM}, ed è pertanto deprecata
1309 in favore di \func{nanosleep}, definita dallo standard POSIX1.b, il cui
1310 prototipo è:
1311 \begin{prototype}{unistd.h}{int nanosleep(const struct timespec *req, struct
1312     timespec *rem)}
1313   
1314   Pone il processo in stato di sleep per il tempo specificato da \param{req}.
1315   In caso di interruzione restituisce il tempo restante in \param{rem}.
1316   
1317   \bodydesc{La funzione restituisce zero se l'attesa viene completata, o -1 in
1318     caso di errore, nel qual caso \var{errno} è settata a 
1319     \begin{errlist}
1320     \item[\macro{EINVAL}] si è specificato un numero di secondi negativo o un
1321       numero di nanosecondi maggiore di 999.999.999.
1322     \item[\macro{EINTR}] la funzione è stata interrotta da un segnale.
1323     \end{errlist}}
1324 \end{prototype}
1325
1326 Lo standard richiede che la funzione sia implementata in maniera del tutto
1327 indipendente da \func{alarm}\footnote{nel caso di Linux questo è fatto
1328   utilizzando direttamente il timer del kernel.} e sia utilizzabile senza
1329 interferenze con l'uso di \macro{SIGALRM}. La funzione prende come parametri
1330 delle strutture di tipo \var{timespec}, la cui definizione è riportata in 
1331 \figref{fig:sig_timespec_def}, che permettono di specificare un tempo con una
1332 precisione (teorica) fino al nanosecondo. 
1333
1334 \begin{figure}[!htb]
1335   \footnotesize \centering
1336   \begin{minipage}[c]{15cm}
1337     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1338 struct timespec
1339 {
1340     time_t  tv_sec;         /* seconds */
1341     long    tv_nsec;        /* nanoseconds */
1342 };
1343     \end{lstlisting}
1344   \end{minipage} 
1345   \normalsize 
1346   \caption{La struttura \var{timespec} di \func{nanosleep}.} 
1347   \label{fig:sig_timespec_def}
1348 \end{figure}
1349
1350 La funzione risolve anche il problema di proseguire l'attesa dopo
1351 l'interruzione dovuta ad un segnale; infatti in tal caso in \param{rem} viene
1352 restituito il tempo rimanente rispetto a quanto richiesto inizialmente, e
1353 basta richiamare la funzione per completare l'attesa. 
1354
1355 Chiaramente, anche se il tempo può essere specificato con risoluzioni fino al
1356 nanosecondo, la precisione di \func{nanosleep} è determinata dalla risoluzione
1357 temporale del timer di sistema. Perciò la funzione attenderà comunque il tempo
1358 specificato, ma prima che il processo possa tornare ad essere eseguito
1359 occorrerà almeno attendere il successivo giro di scheduler e cioè un tempo che
1360 a seconda dei casi può arrivare fino a 1/\macro{HZ}, (sempre che il sistema
1361 sia scarico ed il processa venga immediatamente rimesso in esecuzione); per
1362 questo motivo il valore restituito in \param{rem} è sempre arrotondato al
1363 multiplo successivo di 1/\macro{HZ}.
1364
1365 In realtà è possibile ottenere anche pause più precise del centesimo di
1366 secondo usando politiche di scheduling real time come \macro{SCHED\_FIFO} o
1367 \macro{SCHED\_RR}; in tal caso infatti il meccanismo di scheduling ordinario
1368 viene evitato, e si raggiungono pause fino ai 2~ms con precisioni del $\mu$s.
1369
1370
1371
1372 \subsection{Un esempio elementare}
1373 \label{sec:sig_sigchld}
1374
1375 Un semplice esempio per illustrare il funzionamento di un manipolatore di
1376 segnale è quello della gestione di \macro{SIGCHLD}. Abbiamo visto in
1377 \secref{sec:proc_termination} che una delle azioni eseguite dal kernel alla
1378 conclusione di un processo è quella di inviare questo segnale al
1379 padre;\footnote{in realtà in SRV4 eredita la semantica di System V, in cui il
1380   segnale si chiama \macro{SIGCLD} e viene trattato in maniera speciale; in
1381   System V infatti se si setta esplicitamente l'azione a \macro{SIG\_IGN} il
1382   segnale non viene generato ed il sistema non genera zombie (lo stato di
1383   terminazione viene scartato senza dover chiamare una \func{wait}). L'azione
1384   di default è sempre quella di ignorare il segnale, ma non attiva questo
1385   comportamento. Linux, come BSD e POSIX, non supporta questa semantica ed usa
1386   il nome di \macro{SIGCLD} come sinonimo di \macro{SIGCHLD}.} in questo caso
1387 tutto quello che dovrà fare il manipolatore è ricevere lo stato di
1388 terminazione in modo da evitare la formazione di zombie.
1389
1390 %  è pertanto
1391 % naturale usare un esempio che ci permette di concludere la trattazione della
1392 % terminazione dei processi.
1393 % In questo caso si è tratterà di illustrare un esempio relativo ad un
1394 % manipolatore per che è previsto ritornare,
1395
1396 In realtà nel caso di \macro{SIGCHLD} occorre tenere conto anche di un altro
1397 aspetto del comportamento dei segnali e cioè del fatto 
1398
1399
1400
1401
1402 \begin{figure}[!htb]
1403   \footnotesize \centering
1404   \begin{minipage}[c]{15cm}
1405     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1406 #include <errno.h>       /* error simbol definitions */
1407 #include <signal.h>      /* signal handling declarations */
1408 #include <sys/types.h>
1409 #include <sys/wait.h>
1410 #include "macro.h"
1411
1412 void Hand_CHLD(int sig)
1413 {
1414     int errno_save;
1415     int status;
1416     pid_t pid;
1417     /* save errno current value */
1418     errno_save = errno;
1419     /* loop until no */
1420     do {
1421         errno = 0;
1422         pid = waitpid(WAIT_ANY, &status, WNOHANG);
1423         if (pid > 0) {
1424             debug("child %d terminated with status %x\n", pid, status);
1425         }
1426     } while ((pid > 0) && (errno == EINTR));
1427     /* restore errno value*/
1428     errno = errno_save;
1429     /* return */
1430     return;
1431 }
1432     \end{lstlisting}
1433   \end{minipage} 
1434   \normalsize 
1435   \caption{Una implementazione sbagliata di \func{sleep}.} 
1436   \label{fig:sig_timespec_def}
1437 \end{figure}
1438
1439
1440
1441
1442
1443 \section{Gestione avanzata}
1444 \label{sec:sig_control}
1445
1446 Le funzioni esaminate finora fanno riferimento ad alle modalità più elementari
1447 della gestione dei segnali; non si sono pertanto ancora prese in
1448 considerazione le tematiche più complesse, collegate alle varie race condition
1449 che i segnali possono generare e alla natura asincrona degli stessi.
1450
1451 Affronteremo queste problematiche in questa sezione, partendo da un esempio
1452 che le evidenzi, per poi prendere in esame le varie funzioni che permettono di
1453 risolvere i problemi più complessi connessi alla programmazione con i segnali.
1454
1455
1456 \subsection{Un esempio di problema}
1457 \label{sec:sig_example}
1458
1459 Come accennato in \ref{sec:sig_pause_sleep} è possibile implementare
1460 \func{sleep} a partire da dall'uso di \func{pause} e \func{alarm}. A prima
1461 vista questo può sembrare di implementazione immediata; ad esempio una
1462 semplice versione di \func{sleep} potrebbe essere la seguente:
1463 \begin{figure}[!htb]
1464   \footnotesize \centering
1465   \begin{minipage}[c]{15cm}
1466     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1467 unsigned int sleep(unsigned int seconds)
1468 {
1469     signandler_t prev_handler;
1470     if ((prev_handler = signal(SIGALRM, alarm_hand)) == SIG_ERR) {
1471         printf("Cannot set handler for alarm\n");
1472         exit(1);
1473     }
1474     alarm(second);
1475     pause(); 
1476     /* restore previous signal handler */
1477     signal(SIGALRM, prev_handler);
1478     /* remove alarm, return remaining time */
1479     return alarm(0);
1480 }
1481 void alarm_hand(int sig) {
1482     /* check if the signal is the right one */
1483     if (sig != SIGALRM) { /* if not exit with error */
1484         printf("Something wrong, handler for SIGALRM\n");
1485         exit(1);
1486     } else {    /* do nothing, just interrupt pause */
1487         return;
1488     }
1489 }      
1490     \end{lstlisting}
1491   \end{minipage} 
1492   \normalsize 
1493   \caption{Una implementazione sbagliata di \func{sleep}.} 
1494   \label{fig:sig_timespec_def}
1495 \end{figure}
1496
1497 Ma questa funzione, a parte il non gestire il caso in cui si è avuta una
1498 precedente chiamata a \func{alarm}, presenta una pericolosa race condition.
1499 Infatti se il processo viene interrotto fra la chiamata di \func{alarm} e
1500 \func{pause} può capitare (nel caso il sistema sia molto carico) che
1501 quest'ultima possa essere eseguita dopo l'arrivo di \macro{SIGALRM}. In questo
1502 caso ci si troverebbe di fronte ad un deadlock, in cui \func{pause} non
1503 verrebbe mai interrotta (se non in caso di un altro segnale).
1504
1505 Come abbiamo accennato in \secref{sec:proc_atom_oper} quando si ha a che fare
1506 con i segnali 
1507
1508
1509
1510
1511 \subsection{Le funzioni \func{sigprocmask} e \func{sigpending}}
1512 \label{sec:sig_sigpending}
1513
1514
1515
1516
1517 \subsection{La funzione \func{sigaction}}
1518 \label{sec:sig_sigaction}
1519
1520
1521
1522 \subsection{Funzioni rientranti e default dei segnali}
1523 \label{sec:sig_reentrant}
1524
1525
1526 , affrontando inoltre le varie problematiche di programmazione che si devono
1527 tenere presenti quando si ha a che fare con essi.
1528
1529
1530
1531 %%% Local Variables: 
1532 %%% mode: latex
1533 %%% TeX-master: "gapil"
1534 %%% End: