X-Git-Url: https://gapil.gnulinux.it/gitweb/?p=gapil.git;a=blobdiff_plain;f=signal.tex;h=3c794a665bf623627a684907ad99f856a2d2551b;hp=2f5516b0fe4f563df3c5cf235e6116d957d0534c;hb=51ac65a077651bde52ce68d43aa61b158f5dbd3d;hpb=c56e6721f8ea10764f29995600f1506e72209423 diff --git a/signal.tex b/signal.tex index 2f5516b..3c794a6 100644 --- a/signal.tex +++ b/signal.tex @@ -457,15 +457,15 @@ tab.~\ref{tab:sig_action_leg}). \end{table} -Si inoltre noti come \const{SIGCONT} sia l'unico segnale a non avere +Si inoltre noti come \signal{SIGCONT} sia l'unico segnale a non avere l'indicazione di una azione predefinita nella terza colonna di tab.~\ref{tab:sig_signal_list}, questo perché il suo effetto è sempre quello di far ripartire un programma in stato \texttt{T} fermato da un segnale di -stop. Inoltre i segnali \const{SIGSTOP} e \const{SIGKILL} si distinguono da +stop. Inoltre i segnali \signal{SIGSTOP} e \signal{SIGKILL} si distinguono da tutti gli altri per la specifica caratteristica di non potere essere né intercettati, né bloccati, né ignorati. -Il numero totale di segnali presenti è dato dalla macro \const{NSIG} (e tiene +Il numero totale di segnali presenti è dato dalla macro \macrod{NSIG} (e tiene conto anche di quelli \textit{real-time}) e dato che i numeri dei segnali sono allocati progressivamente, essa corrisponde anche al successivo del valore numerico assegnato all'ultimo segnale definito. La descrizione dettagliata @@ -665,9 +665,8 @@ segnali sono: avuto successo. \item[\signald{SIGURG}] Questo segnale è inviato quando arrivano dei dati - urgenti o \itindex{out-of-band} \textit{out-of-band} su di un - socket; per maggiori dettagli al proposito si veda - sez.~\ref{sec:TCP_urgent_data}. + urgenti o \textit{out-of-band} su di un socket; per maggiori dettagli al + proposito si veda sez.~\ref{sec:TCP_urgent_data}. \item[\signald{SIGPOLL}] Questo segnale è definito nella standard POSIX.1-2001, ed è equivalente a \signal{SIGIO} che invece deriva da BSD. Su Linux è @@ -906,34 +905,35 @@ figlio dovranno arrivare solo i segnali dovuti alle sue azioni. Quando si mette in esecuzione un nuovo programma con \func{exec} (si ricordi quanto detto in sez.~\ref{sec:proc_exec}) tutti i segnali per i quali è stato -installato un gestore vengono reimpostati a \const{SIG\_DFL}. Non ha più +installato un gestore vengono reimpostati a \constd{SIG\_DFL}. Non ha più senso infatti fare riferimento a funzioni definite nel programma originario, che non sono presenti nello spazio di indirizzi del nuovo programma. Si noti che questo vale solo per le azioni per le quali è stato installato un gestore, viene mantenuto invece ogni eventuale impostazione dell'azione a -\const{SIG\_IGN}. Questo permette ad esempio alla shell di impostare ad +\constd{SIG\_IGN}. Questo permette ad esempio alla shell di impostare ad \const{SIG\_IGN} le risposte per \signal{SIGINT} e \signal{SIGQUIT} per i programmi eseguiti in background, che altrimenti sarebbero interrotti da una successiva pressione di \texttt{C-c} o \texttt{C-y}. Per quanto riguarda il comportamento di tutte le altre \textit{system call} si -danno sostanzialmente due casi, a seconda che esse siano -\index{system~call~lente} \textsl{lente} (\textit{slow}) o \textsl{veloci} -(\textit{fast}). La gran parte di esse appartiene a quest'ultima categoria, -che non è influenzata dall'arrivo di un segnale. Esse sono dette -\textsl{veloci} in quanto la loro esecuzione è sostanzialmente immediata. La -risposta al segnale viene sempre data dopo che la \textit{system call} è stata -completata, in quanto attendere per eseguire un gestore non comporta nessun -inconveniente. +danno sostanzialmente due casi, a seconda che esse siano \textsl{lente} +(\textit{slow}) o \textsl{veloci} (\textit{fast}). La gran parte di esse +appartiene a quest'ultima categoria, che non è influenzata dall'arrivo di un +segnale. Esse sono dette \textsl{veloci} in quanto la loro esecuzione è +sostanzialmente immediata. La risposta al segnale viene sempre data dopo che +la \textit{system call} è stata completata, in quanto attendere per eseguire +un gestore non comporta nessun inconveniente. + +\index{system~call~lente|(} In alcuni casi però alcune \textit{system call} possono bloccarsi -indefinitamente e per questo motivo vengono chiamate \textsl{lente} -\index{system~call~lente} o \textsl{bloccanti}. In questo caso non si può -attendere la conclusione della \textit{system call}, perché questo renderebbe -impossibile una risposta pronta al segnale, per cui il gestore viene eseguito -prima che la \textit{system call} sia ritornata. Un elenco dei casi in cui si -presenta questa situazione è il seguente: +indefinitamente e per questo motivo vengono chiamate \textsl{lente} o +\textsl{bloccanti}. In questo caso non si può attendere la conclusione della +\textit{system call}, perché questo renderebbe impossibile una risposta pronta +al segnale, per cui il gestore viene eseguito prima che la \textit{system + call} sia ritornata. Un elenco dei casi in cui si presenta questa +situazione è il seguente: \begin{itemize*} \item la lettura da file che possono bloccarsi in attesa di dati non ancora presenti (come per certi file di dispositivo, i socket o le \textit{pipe}); @@ -1009,6 +1009,8 @@ possa essere stato richiesto il riavvio automatico, queste funzioni sono: \end{itemize*} +\index{system~call~lente|)} + \subsection{L'installazione di un gestore} \label{sec:sig_signal} @@ -1031,7 +1033,7 @@ comportamento, pur mantenendone immutato il prototipo\footnote{in realtà in } {La funzione ritorna il precedente gestore in caso di successo in caso di - successo e \const{SIG\_ERR} per un errore, nel qual caso \var{errno} + successo e \constd{SIG\_ERR} per un errore, nel qual caso \var{errno} assumerà il valore: \begin{errlist} \item[\errcode{EINVAL}] il numero di segnale \param{signum} non è valido. @@ -1186,13 +1188,12 @@ con \param{pid} non esistono. \hline \hline $>0$ & Il segnale è mandato al processo con \ids{PID} uguale - a \param{pid}.\\ - 0 & Il segnale è mandato ad ogni processo del \itindex{process~group} - \textit{process group} del chiamante.\\ + a \param{pid}.\\ + 0 & Il segnale è mandato ad ogni processo del \textit{process group} + del chiamante.\\ $-1$ & Il segnale è mandato ad ogni processo (eccetto \cmd{init}).\\ $<-1$& Il segnale è mandato ad ogni processo del \textit{process group} - \itindex{process~group} con \ids{PGID} uguale - a $|\param{pid}|$.\\ + con \ids{PGID} uguale a $|\param{pid}|$.\\ \hline \end{tabular} \caption{Valori dell'argomento \param{pid} per la funzione @@ -1237,7 +1238,7 @@ prototipo è: \begin{funcproto}{ \fhead{signal.h} \fdecl{int killpg(pid\_t pidgrp, int signal)} -\fdesc{Invia un segnale ad un \itindex{process~group} \textit{process group}.} +\fdesc{Invia un segnale ad un \textit{process group}.} } { La funzione ritorna $0$ in caso di successo e $-1$ per un errore, e gli @@ -1246,11 +1247,11 @@ prototipo è: \end{funcproto} -La funzione invia il segnale \param{signal} al \itindex{process~group} -\textit{process group} il cui \acr{PGID} (vedi sez.~\ref{sec:sess_proc_group}) -è indicato dall'argomento \param{pidgrp}, che deve essere un intero -positivo. Il suo utilizzo è sostanzialmente equivalente all'esecuzione di -\code{kill(-pidgrp, signal)}. +La funzione invia il segnale \param{signal} al \textit{process group} il cui +\acr{PGID} (vedi sez.~\ref{sec:sess_proc_group}) è indicato +dall'argomento \param{pidgrp}, che deve essere un intero positivo. Il suo +utilizzo è sostanzialmente equivalente all'esecuzione di \code{kill(-pidgrp, + signal)}. Oltre alle precedenti funzioni di base, vedremo più avanti che esistono altre funzioni per inviare segnali generici, come \func{sigqueue} per i segnali @@ -1379,9 +1380,9 @@ tab.~\ref{tab:sig_setitimer_values}. \textbf{Valore} & \textbf{Timer} \\ \hline \hline - \const{ITIMER\_REAL} & \textit{real-time timer}\\ - \const{ITIMER\_VIRTUAL} & \textit{virtual timer}\\ - \const{ITIMER\_PROF} & \textit{profiling timer}\\ + \constd{ITIMER\_REAL} & \textit{real-time timer}\\ + \constd{ITIMER\_VIRTUAL} & \textit{virtual timer}\\ + \constd{ITIMER\_PROF} & \textit{profiling timer}\\ \hline \end{tabular} \caption{Valori dell'argomento \param{which} per la funzione @@ -1446,7 +1447,7 @@ eccesso).\footnote{questo in realtà non è del tutto vero a causa di un bug, L'uso del contatore dei \textit{jiffies}, un intero a 32 bit nella maggior parte dei casi, comportava inoltre l'impossibilità di specificare tempi molto -lunghi. superiori al valore della costante \const{MAX\_SEC\_IN\_JIFFIES}, +lunghi. superiori al valore della costante \constd{MAX\_SEC\_IN\_JIFFIES}, pari, nel caso di default di un valore di \const{HZ} di 250, a circa 99 giorni e mezzo. Con il cambiamento della rappresentazione effettuato nel kernel 2.6.16 questo problema è scomparso e con l'introduzione dei timer ad alta @@ -1455,7 +1456,7 @@ precisione è diventata quella fornita dall'hardware disponibile. Una seconda causa di potenziali ritardi è che il segnale viene generato alla scadenza del timer, ma poi deve essere consegnato al processo; se quest'ultimo -è attivo (questo è sempre vero per \const{ITIMER\_VIRT}) la consegna è +è attivo (questo è sempre vero per \const{ITIMER\_VIRTUAL}) la consegna è immediata, altrimenti può esserci un ulteriore ritardo che può variare a seconda del carico del sistema. @@ -1465,8 +1466,8 @@ in cui un timer scade prima che il segnale di una precedente scadenza sia stato consegnato. In questo caso, per il comportamento dei segnali descritto in sez.~\ref{sec:sig_sigchld}, un solo segnale sarà consegnato. Per questo oggi l'uso di questa funzione è deprecato a favore degli -\textit{high-resolution timer} e della cosiddetta \itindex{POSIX~Timer~API} -\textit{POSIX Timer API}, che tratteremo in sez.~\ref{sec:sig_timer_adv}. +\textit{high-resolution timer} e della cosiddetta \textit{POSIX Timer API}, +che tratteremo in sez.~\ref{sec:sig_timer_adv}. Dato che sia \func{alarm} che \func{setitimer} non consentono di leggere il valore corrente di un timer senza modificarlo, è possibile usare la funzione @@ -2088,44 +2089,44 @@ tab.~\ref{tab:sig_sa_flag}. \textbf{Valore} & \textbf{Significato} \\ \hline \hline - \const{SA\_NOCLDSTOP}& Se il segnale è \signal{SIGCHLD} allora non deve - essere notificato quando il processo figlio viene - fermato da uno dei segnali \signal{SIGSTOP}, - \signal{SIGTSTP}, \signal{SIGTTIN} o - \signal{SIGTTOU}, questo flag ha significato solo - quando si imposta un gestore per \signal{SIGCHLD}.\\ - \const{SA\_NOCLDWAIT}& Se il segnale è \signal{SIGCHLD} e si richiede di - ignorare il segnale con \const{SIG\_IGN} allora i - processi figli non diventano \textit{zombie} quando - terminano; questa funzionalità è stata introdotta - nel kernel 2.6 e va a modificare il comportamento - di \func{waitpid} come illustrato in - sez.~\ref{sec:proc_wait}, se si installa un gestore - con questo flag attivo il segnale \signal{SIGCHLD} - viene comunque generato.\\ - \const{SA\_NODEFER} & Evita che il segnale corrente sia bloccato durante - l'esecuzione del gestore.\\ - \const{SA\_NOMASK} & Nome obsoleto e sinonimo non standard di - \const{SA\_NODEFER}, non deve essere più - utilizzato.\\ - \const{SA\_ONESHOT} & Nome obsoleto e sinonimo non standard di - \const{SA\_RESETHAND}, non deve essere più - utilizzato.\\ - \const{SA\_ONSTACK} & Stabilisce l'uso di uno \textit{stack} alternativo - per l'esecuzione del gestore (vedi - sez.~\ref{sec:sig_specific_features}).\\ - \const{SA\_RESETHAND}& Ristabilisce l'azione per il segnale al valore - predefinito una volta che il gestore è stato - lanciato, riproduce cioè il comportamento della - semantica inaffidabile.\\ - \const{SA\_RESTART} & Riavvia automaticamente le \textit{slow system - call} quando vengono interrotte dal suddetto - segnale, riproduce cioè il comportamento standard - di BSD.\index{system~call~lente}\\ - \const{SA\_SIGINFO} & Deve essere specificato quando si vuole usare un - gestore in forma estesa usando - \var{sa\_sigaction} al posto di - \var{sa\_handler}.\\ + \constd{SA\_NOCLDSTOP}& Se il segnale è \signal{SIGCHLD} allora non deve + essere notificato quando il processo figlio viene + fermato da uno dei segnali \signal{SIGSTOP}, + \signal{SIGTSTP}, \signal{SIGTTIN} o + \signal{SIGTTOU}, questo flag ha significato solo + quando si imposta un gestore per \signal{SIGCHLD}.\\ + \constd{SA\_NOCLDWAIT}& Se il segnale è \signal{SIGCHLD} e si richiede di + ignorare il segnale con \const{SIG\_IGN} allora i + processi figli non diventano \textit{zombie} quando + terminano; questa funzionalità è stata introdotta + nel kernel 2.6 e va a modificare il comportamento + di \func{waitpid} come illustrato in + sez.~\ref{sec:proc_wait}, se si installa un gestore + con questo flag attivo il segnale \signal{SIGCHLD} + viene comunque generato.\\ + \constd{SA\_NODEFER} & Evita che il segnale corrente sia bloccato durante + l'esecuzione del gestore.\\ + \constd{SA\_NOMASK} & Nome obsoleto e sinonimo non standard di + \const{SA\_NODEFER}, non deve essere più + utilizzato.\\ + \constd{SA\_ONESHOT} & Nome obsoleto e sinonimo non standard di + \const{SA\_RESETHAND}, non deve essere più + utilizzato.\\ + \constd{SA\_ONSTACK} & Stabilisce l'uso di uno \textit{stack} alternativo + per l'esecuzione del gestore (vedi + sez.~\ref{sec:sig_specific_features}).\\ + \constd{SA\_RESETHAND}& Ristabilisce l'azione per il segnale al valore + predefinito una volta che il gestore è stato + lanciato, riproduce cioè il comportamento della + semantica inaffidabile.\\ + \constd{SA\_RESTART} & Riavvia automaticamente le \textit{slow system + call} quando vengono interrotte dal suddetto + segnale, riproduce cioè il comportamento standard + di BSD.\\ + \constd{SA\_SIGINFO} & Deve essere specificato quando si vuole usare un + gestore in forma estesa usando + \var{sa\_sigaction} al posto di + \var{sa\_handler}.\\ \hline \end{tabular} \caption{Valori del campo \var{sa\_flag} della struttura \struct{sigaction}.} @@ -2194,23 +2195,23 @@ altre informazioni specifiche. \textbf{Valore} & \textbf{Significato} \\ \hline \hline - \const{SI\_USER} & Generato da \func{kill} o \func{raise} o affini.\\ - \const{SI\_KERNEL} & Inviato direttamente dal kernel.\\ - \const{SI\_QUEUE} & Inviato con \func{sigqueue} (vedi - sez.~\ref{sec:sig_real_time}).\\ - \const{SI\_TIMER} & Scadenza di un\itindex{POSIX~Timer~API} \textit{POSIX - timer} (vedi sez.~\ref{sec:sig_timer_adv}).\\ - \const{SI\_MESGQ} & Inviato al cambiamento di stato di una coda di - messaggi POSIX (vedi sez.~\ref{sec:ipc_posix_mq}), - introdotto con il kernel 2.6.6.\\ - \const{SI\_ASYNCIO}& Una operazione di I/O asincrono (vedi - sez.~\ref{sec:file_asyncronous_io}) è stata - completata.\\ - \const{SI\_SIGIO} & Segnale di \signal{SIGIO} da una coda (vedi - sez.~\ref{sec:file_asyncronous_operation}).\\ - \const{SI\_TKILL} & Inviato da \func{tkill} o \func{tgkill} (vedi - sez.~\ref{cha:thread_xxx}), introdotto con il kernel - 2.4.19.\\ + \constd{SI\_USER} & Generato da \func{kill} o \func{raise} o affini.\\ + \constd{SI\_KERNEL} & Inviato direttamente dal kernel.\\ + \constd{SI\_QUEUE} & Inviato con \func{sigqueue} (vedi + sez.~\ref{sec:sig_real_time}).\\ + \constd{SI\_TIMER} & Scadenza di un \textit{POSIX timer} (vedi + sez.~\ref{sec:sig_timer_adv}).\\ + \constd{SI\_MESGQ} & Inviato al cambiamento di stato di una coda di + messaggi POSIX (vedi sez.~\ref{sec:ipc_posix_mq}), + introdotto con il kernel 2.6.6.\\ + \constd{SI\_ASYNCIO}& Una operazione di I/O asincrono (vedi + sez.~\ref{sec:file_asyncronous_io}) è stata + completata.\\ + \constd{SI\_SIGIO} & Segnale di \signal{SIGIO} da una coda (vedi + sez.~\ref{sec:file_asyncronous_operation}).\\ + \constd{SI\_TKILL} & Inviato da \func{tkill} o \func{tgkill} (vedi + sez.~\ref{cha:thread_xxx}), introdotto con il kernel + 2.4.19.\\ \hline \end{tabular} \caption{Valori del campo \var{si\_code} della struttura \struct{sigaction} @@ -2239,33 +2240,33 @@ riferimento. \textbf{Valore} & \textbf{Significato} \\ \hline \hline - \const{ILL\_ILLOPC} & Codice di operazione illegale.\\ - \const{ILL\_ILLOPN} & Operando illegale.\\ - \const{ILL\_ILLADR} & Modo di indirizzamento illegale.\\ - \const{ILL\_ILLTRP} & Trappola di processore illegale.\\ - \const{ILL\_PRVOPC} & Codice di operazione privilegiato.\\ - \const{ILL\_PRVREG} & Registro privilegiato.\\ - \const{ILL\_COPROC} & Errore del coprocessore.\\ - \const{ILL\_BADSTK} & Errore nello stack interno.\\ + \constd{ILL\_ILLOPC} & Codice di operazione illegale.\\ + \constd{ILL\_ILLOPN} & Operando illegale.\\ + \constd{ILL\_ILLADR} & Modo di indirizzamento illegale.\\ + \constd{ILL\_ILLTRP} & Trappola di processore illegale.\\ + \constd{ILL\_PRVOPC} & Codice di operazione privilegiato.\\ + \constd{ILL\_PRVREG} & Registro privilegiato.\\ + \constd{ILL\_COPROC} & Errore del coprocessore.\\ + \constd{ILL\_BADSTK} & Errore nello stack interno.\\ \hline - \const{FPE\_INTDIV} & Divisione per zero intera.\\ - \const{FPE\_INTOVF} & Overflow intero.\\ - \const{FPE\_FLTDIV} & Divisione per zero in virgola mobile.\\ - \const{FPE\_FLTOVF} & Overflow in virgola mobile.\\ - \const{FPE\_FLTUND} & Underflow in virgola mobile.\\ - \const{FPE\_FLTRES} & Risultato in virgola mobile non esatto.\\ - \const{FPE\_FLTINV} & Operazione in virgola mobile non valida.\\ - \const{FPE\_FLTSUB} & Mantissa? fuori intervallo.\\ + \constd{FPE\_INTDIV} & Divisione per zero intera.\\ + \constd{FPE\_INTOVF} & Overflow intero.\\ + \constd{FPE\_FLTDIV} & Divisione per zero in virgola mobile.\\ + \constd{FPE\_FLTOVF} & Overflow in virgola mobile.\\ + \constd{FPE\_FLTUND} & Underflow in virgola mobile.\\ + \constd{FPE\_FLTRES} & Risultato in virgola mobile non esatto.\\ + \constd{FPE\_FLTINV} & Operazione in virgola mobile non valida.\\ + \constd{FPE\_FLTSUB} & Mantissa? fuori intervallo.\\ \hline - \const{SEGV\_MAPERR} & Indirizzo non mappato.\\ - \const{SEGV\_ACCERR} & Permessi non validi per l'indirizzo.\\ + \constd{SEGV\_MAPERR} & Indirizzo non mappato.\\ + \constd{SEGV\_ACCERR} & Permessi non validi per l'indirizzo.\\ \hline - \const{BUS\_ADRALN} & Allineamento dell'indirizzo non valido.\\ - \const{BUS\_ADRERR} & Indirizzo fisico inesistente.\\ - \const{BUS\_OBJERR} & Errore hardware sull'indirizzo.\\ + \constd{BUS\_ADRALN} & Allineamento dell'indirizzo non valido.\\ + \constd{BUS\_ADRERR} & Indirizzo fisico inesistente.\\ + \constd{BUS\_OBJERR} & Errore hardware sull'indirizzo.\\ \hline - \const{TRAP\_BRKPT} & Breakpoint sul processo.\\ - \const{TRAP\_TRACE} & Trappola di tracciamento del processo.\\ + \constd{TRAP\_BRKPT} & Breakpoint sul processo.\\ + \constd{TRAP\_TRACE} & Trappola di tracciamento del processo.\\ \hline \constd{CLD\_EXITED} & Il figlio è uscito.\\ \constd{CLD\_KILLED} & Il figlio è stato terminato.\\ @@ -2274,12 +2275,12 @@ riferimento. \constd{CLD\_STOPPED} & Il figlio è stato fermato.\\ \constd{CLD\_CONTINUED}& Il figlio è ripartito.\\ \hline - \const{POLL\_IN} & Disponibili dati in ingresso.\\ - \const{POLL\_OUT} & Spazio disponibile sul buffer di uscita.\\ - \const{POLL\_MSG} & Disponibili messaggi in ingresso.\\ - \const{POLL\_ERR} & Errore di I/O.\\ - \const{POLL\_PRI} & Disponibili dati di alta priorità in ingresso.\\ - \const{POLL\_HUP} & Il dispositivo è stato disconnesso.\\ + \constd{POLL\_IN} & Disponibili dati in ingresso.\\ + \constd{POLL\_OUT} & Spazio disponibile sul buffer di uscita.\\ + \constd{POLL\_MSG} & Disponibili messaggi in ingresso.\\ + \constd{POLL\_ERR} & Errore di I/O.\\ + \constd{POLL\_PRI} & Disponibili dati di alta priorità in ingresso.\\ + \constd{POLL\_HUP} & Il dispositivo è stato disconnesso.\\ \hline \end{tabular} \caption{Valori del campo \var{si\_code} della struttura \struct{sigaction} @@ -2289,9 +2290,9 @@ riferimento. \label{tab:sig_si_code_special} \end{table} -Il resto della struttura \struct{siginfo\_t} è definito come una -\dirct{union} ed i valori eventualmente presenti dipendono dal segnale -ricevuto, così \signal{SIGCHLD} ed i segnali \textit{real-time} (vedi +Il resto della struttura \struct{siginfo\_t} è definito come una \dirct{union} +ed i valori eventualmente presenti dipendono dal segnale ricevuto, così +\signal{SIGCHLD} ed i segnali \textit{real-time} (vedi sez.~\ref{sec:sig_real_time}) inviati tramite \func{kill} avvalorano \var{si\_pid} e \var{si\_uid} coi valori corrispondenti al processo che ha emesso il segnale, \signal{SIGCHLD} avvalora anche i campi \var{si\_status}, @@ -2301,11 +2302,10 @@ sez.~\ref{sec:sys_cpu_times}) usati dal processo; \signal{SIGILL}, \signal{SIGFPE}, \signal{SIGSEGV} e \signal{SIGBUS} avvalorano \var{si\_addr} con l'indirizzo in cui è avvenuto l'errore, \signal{SIGIO} (vedi sez.~\ref{sec:file_asyncronous_io}) avvalora \var{si\_fd} con il numero del -file descriptor e \var{si\_band} per i \itindex{out-of-band} dati urgenti -(vedi sez.~\ref{sec:TCP_urgent_data}) su un socket, il segnale inviato alla -scadenza di un \itindex{POSIX~Timer~API} POSIX timer (vedi -sez.~\ref{sec:sig_timer_adv}) avvalora i campi \var{si\_timerid} e -\var{si\_overrun}. +file descriptor e \var{si\_band} per i dati urgenti (vedi +sez.~\ref{sec:TCP_urgent_data}) su un socket, il segnale inviato alla scadenza +di un POSIX timer (vedi sez.~\ref{sec:sig_timer_adv}) avvalora i campi +\var{si\_timerid} e \var{si\_overrun}. Benché sia possibile usare nello stesso programma sia \func{sigaction} che \func{signal} occorre molta attenzione, in quanto le due funzioni possono @@ -2368,13 +2368,15 @@ di problemi di sintassi nel passaggio degli argomenti (si veda ad esempio \label{sec:sig_sigmask} \index{maschera dei segnali|(} -Come spiegato in sez.~\ref{sec:sig_semantics} tutti i moderni sistemi unix-like -permettono di bloccare temporaneamente (o di eliminare completamente, -impostando come azione \const{SIG\_IGN}) la consegna dei segnali ad un -processo. Questo è fatto specificando la cosiddetta \textsl{maschera dei - segnali} (o \textit{signal mask}) del processo\footnote{nel caso di Linux - essa è mantenuta dal campo \var{blocked} della \struct{task\_struct} del - processo.} cioè l'insieme dei segnali la cui consegna è bloccata. + +Come spiegato in sez.~\ref{sec:sig_semantics} tutti i moderni sistemi +unix-like permettono di bloccare temporaneamente (o di eliminare +completamente, impostando come azione \const{SIG\_IGN}) la consegna dei +segnali ad un processo. Questo è fatto specificando la cosiddetta +\textsl{maschera dei segnali} (o \textit{signal mask}) del +processo\footnote{nel caso di Linux essa è mantenuta dal campo \var{blocked} + della \struct{task\_struct} del processo.} cioè l'insieme dei segnali la cui +consegna è bloccata. Abbiamo accennato in sez.~\ref{sec:proc_fork} che la maschera dei segnali viene ereditata dal padre alla creazione di un processo figlio, e abbiamo @@ -2432,13 +2434,13 @@ quell'indirizzo. \textbf{Valore} & \textbf{Significato} \\ \hline \hline - \const{SIG\_BLOCK} & L'insieme dei segnali bloccati è l'unione fra - quello specificato e quello corrente.\\ - \const{SIG\_UNBLOCK} & I segnali specificati in \param{set} sono rimossi - dalla maschera dei segnali, specificare la - cancellazione di un segnale non bloccato è legale.\\ - \const{SIG\_SETMASK} & La maschera dei segnali è impostata al valore - specificato da \param{set}.\\ + \constd{SIG\_BLOCK} & L'insieme dei segnali bloccati è l'unione fra + quello specificato e quello corrente.\\ + \constd{SIG\_UNBLOCK} & I segnali specificati in \param{set} sono rimossi + dalla maschera dei segnali, specificare la + cancellazione di un segnale non bloccato è legale.\\ + \constd{SIG\_SETMASK} & La maschera dei segnali è impostata al valore + specificato da \param{set}.\\ \hline \end{tabular} \caption{Valori e significato dell'argomento \param{how} della funzione @@ -2768,10 +2770,10 @@ se usata nella forma \var{sival\_int}, o un puntatore, se usata nella forma vari meccanismi di notifica per restituire dati al gestore del segnale in \var{si\_value}. Un campo di tipo \type{sigval\_t} è presente anche nella struttura \struct{sigevent} (definita in fig.~\ref{fig:struct_sigevent}) che -viene usata dai meccanismi di notifica come quelli per -\itindex{POSIX~Timer~API} i timer POSIX (vedi sez.~\ref{sec:sig_timer_adv}), -l'I/O asincrono (vedi sez.~\ref{sec:file_asyncronous_io}) o le code di -messaggi POSIX (vedi sez.~\ref{sec:ipc_posix_mq}). +viene usata dai meccanismi di notifica come quelli per i timer POSIX (vedi +sez.~\ref{sec:sig_timer_adv}), l'I/O asincrono (vedi +sez.~\ref{sec:file_asyncronous_io}) o le code di messaggi POSIX (vedi +sez.~\ref{sec:ipc_posix_mq}). A causa delle loro caratteristiche, la funzione \func{kill} non è adatta ad inviare segnali \textit{real-time}, poiché non è in grado di fornire alcun @@ -2819,13 +2821,13 @@ classica il segnale sarà generato, ma tutte le caratteristiche tipiche dei segnali \textit{real-time} (priorità e coda) saranno perse. Secondo lo standard POSIX la profondità della coda è indicata dalla costante -\const{SIGQUEUE\_MAX}, una della tante costanti di sistema definite dallo +\constd{SIGQUEUE\_MAX}, una della tante costanti di sistema definite dallo standard POSIX che non abbiamo riportato esplicitamente in sez.~\ref{sec:sys_limits}. Il suo valore minimo secondo lo standard, -\const{\_POSIX\_SIGQUEUE\_MAX}, è pari a 32. Nel caso di Linux la coda ha una +\constd{\_POSIX\_SIGQUEUE\_MAX}, è pari a 32. Nel caso di Linux la coda ha una dimensione variabile; fino alla versione 2.6.7 c'era un limite massimo globale che poteva essere impostato come parametro del kernel in -\sysctlfile{kernel/rtsig-max} ed il valore predefinito era pari a 1024. A +\sysctlfiled{kernel/rtsig-max} ed il valore predefinito era pari a 1024. A partire dal kernel 2.6.8 il valore globale è stato rimosso e sostituito dalla risorsa \const{RLIMIT\_SIGPENDING} associata al singolo utente, che può essere modificata con \func{setrlimit} come illustrato in @@ -2928,8 +2930,6 @@ riceverlo fra due chiamate successive. \subsection{La gestione avanzata delle temporizzazioni} \label{sec:sig_timer_adv} -% TODO: indicizzare i termini \itindex{POSIX~Timer~API} e HRT - Sia le funzioni per la gestione dei tempi viste in sez.~\ref{sec:sys_cpu_times} che quelle per la gestione dei timer di sez.~\ref{sec:sig_alarm_abort} sono state a lungo limitate dalla risoluzione @@ -2997,43 +2997,43 @@ tab.~\ref{tab:sig_timer_clockid_types}. \textbf{Valore} & \textbf{Significato} \\ \hline \hline - \const{CLOCK\_REALTIME} & Orologio \textit{real-time} di sistema, può + \constd{CLOCK\_REALTIME} & Orologio \textit{real-time} di sistema, può essere impostato solo con privilegi amministrativi.\\ - \const{CLOCK\_MONOTONIC} & Orologio che indica un tempo monotono + \constd{CLOCK\_MONOTONIC} & Orologio che indica un tempo monotono crescente (a partire da un tempo iniziale non specificato) che non può essere modificato e non cambia neanche in caso di reimpostazione dell'orologio di sistema.\\ - \const{CLOCK\_PROCESS\_CPUTIME\_ID}& Contatore del tempo di CPU usato + \constd{CLOCK\_PROCESS\_CPUTIME\_ID}& Contatore del tempo di CPU usato da un processo (il \textit{process time} di sez.~\ref{sec:sys_cpu_times}, nel totale di \textit{system time} e \textit{user time}) comprensivo di tutto il tempo di CPU usato da eventuali \textit{thread}.\\ - \const{CLOCK\_THREAD\_CPUTIME\_ID}& Contatore del tempo di CPU + \constd{CLOCK\_THREAD\_CPUTIME\_ID}& Contatore del tempo di CPU (\textit{user time} e \textit{system time}) usato da un singolo \textit{thread}.\\ \hline - \const{CLOCK\_MONOTONIC\_RAW}&Simile al precedente, ma non subisce gli + \constd{CLOCK\_MONOTONIC\_RAW}&Simile al precedente, ma non subisce gli aggiustamenti dovuti all'uso di NTP (viene usato per fare riferimento ad una fonte hardware). Questo orologio è specifico di Linux, ed è disponibile a partire dal kernel 2.6.28.\\ - \const{CLOCK\_BOOTTIME} & Identico a \const{CLOCK\_MONOTONIC} ma tiene + \constd{CLOCK\_BOOTTIME} & Identico a \const{CLOCK\_MONOTONIC} ma tiene conto anche del tempo durante il quale il sistema è stato sospeso (nel caso di sospensione in RAM o \textsl{ibernazione} su disco. Questo orologio è specifico di Linux, ed è disponibile a partire dal kernel 2.6.39.\\ - \const{CLOCK\_REALTIME\_ALARM}&Identico a \const{CLOCK\_REALTIME}, ma se + \constd{CLOCK\_REALTIME\_ALARM}&Identico a \const{CLOCK\_REALTIME}, ma se usato per un timer il sistema sarà riattivato anche se è in sospensione. Questo orologio è specifico di Linux, ed è disponibile a partire dal kernel 3.0.\\ - \const{CLOCK\_BOOTTIME\_ALARM}&Identico a \const{CLOCK\_BOOTTIME}, ma se + \constd{CLOCK\_BOOTTIME\_ALARM}&Identico a \const{CLOCK\_BOOTTIME}, ma se usato per un timer il sistema sarà riattivato anche se è in sospensione. Questo orologio è specifico di Linux, ed è disponibile a @@ -3058,12 +3058,12 @@ programmi che le usano devono essere collegati con la libreria delle estensioni \textit{real-time} usando esplicitamente l'opzione \texttt{-lrt}. Si tenga presente inoltre che la disponibilità di queste funzionalità avanzate -può essere controllato dalla definizione della macro \macro{\_POSIX\_TIMERS} +può essere controllato dalla definizione della macro \macrod{\_POSIX\_TIMERS} ad un valore maggiore di 0, e che le ulteriori macro -\macro{\_POSIX\_MONOTONIC\_CLOCK}, \macro{\_POSIX\_CPUTIME} e -\macro{\_POSIX\_THREAD\_CPUTIME} indicano la presenza dei rispettivi orologi +\macrod{\_POSIX\_MONOTONIC\_CLOCK}, \macrod{\_POSIX\_CPUTIME} e +\macrod{\_POSIX\_THREAD\_CPUTIME} indicano la presenza dei rispettivi orologi di tipo \const{CLOCK\_MONOTONIC}, \const{CLOCK\_PROCESS\_CPUTIME\_ID} e -\const{CLOCK\_PROCESS\_CPUTIME\_ID}; tutte queste macro sono definite in +\const{CLOCK\_THREAD\_CPUTIME\_ID}; tutte queste macro sono definite in \headfile{unistd.h}, che pertanto deve essere incluso per poterle controllarle. Infine se il kernel ha il supporto per gli \textit{high resolution timer} un elenco degli orologi e dei timer può essere ottenuto @@ -3332,8 +3332,8 @@ effettuata. Diventa così possibile indicare l'uso di un segnale o l'esecuzione \textbf{Valore} & \textbf{Significato} \\ \hline \hline - \const{SIGEV\_NONE} & Non viene inviata nessuna notifica.\\ - \const{SIGEV\_SIGNAL} & La notifica viene effettuata inviando al processo + \constd{SIGEV\_NONE} & Non viene inviata nessuna notifica.\\ + \constd{SIGEV\_SIGNAL} & La notifica viene effettuata inviando al processo chiamante il segnale specificato dal campo \var{sigev\_signo}; se il gestore di questo segnale è stato installato con @@ -3342,7 +3342,7 @@ effettuata. Diventa così possibile indicare l'uso di un segnale o l'esecuzione \dirct{union} \texttt{sigval}, la cui definizione è in fig.~\ref{fig:sig_sigval}) come valore del campo \var{si\_value} di \struct{siginfo\_t}.\\ - \const{SIGEV\_THREAD} & La notifica viene effettuata creando un nuovo + \constd{SIGEV\_THREAD} & La notifica viene effettuata creando un nuovo \textit{thread} che esegue la funzione di notifica specificata da \var{sigev\_notify\_function} con argomento @@ -3350,7 +3350,7 @@ effettuata. Diventa così possibile indicare l'uso di un segnale o l'esecuzione \val{NULL}, il \textit{thread} viene creato con gli attributi specificati da \var{sigev\_notify\_attribute}.\footnotemark\\ - \const{SIGEV\_THREAD\_ID}& Invia la notifica come segnale (con le stesse + \constd{SIGEV\_THREAD\_ID}& Invia la notifica come segnale (con le stesse modalità di \const{SIGEV\_SIGNAL}) che però viene recapitato al \textit{thread} indicato dal campo \var{sigev\_notify\_thread\_id}. Questa modalità @@ -3447,7 +3447,7 @@ con una precisione fino al nanosecondo tramite una struttura \struct{timespec} valore di \param{flags} è nullo, questo valore viene considerato come un intervallo relativo al tempo corrente, il primo allarme scatterà cioè dopo il numero di secondi e nanosecondi indicati da questo campo. Se invece si usa -per \param{flags} il valore \const{TIMER\_ABSTIME}, che al momento è l'unico +per \param{flags} il valore \constd{TIMER\_ABSTIME}, che al momento è l'unico valore valido per \param{flags}, allora \var{it\_value} viene considerato come un valore assoluto rispetto al valore usato dall'orologio a cui è associato il timer. @@ -3632,9 +3632,8 @@ per \param{flags} e si è indicato un tempo assoluto che è già passato la funzione ritorna immediatamente senza nessuna sospensione. In caso di interruzione da parte di un segnale il tempo rimanente viene restituito in \param{remain} soltanto se questo non è un puntatore \val{NULL} e non si è -specificato \const{TIMER\_ABSTIME} per \param{flags} . +specificato \const{TIMER\_ABSTIME} per \param{flags}. -% TODO manca clock_nanosleep, referenziata in sez.~\ref{sec:sig_gen_beha} \itindend{POSIX~Timer~API} @@ -3690,7 +3689,7 @@ gestori, occorre però seguire una certa procedura: In genere il primo passo viene effettuato allocando un'opportuna area di memoria con \code{malloc}; in \headfile{signal.h} sono definite due costanti, -\const{SIGSTKSZ} e \const{MINSIGSTKSZ}, che possono essere utilizzate per +\constd{SIGSTKSZ} e \constd{MINSIGSTKSZ}, che possono essere utilizzate per allocare una quantità di spazio opportuna, in modo da evitare overflow. La prima delle due è la dimensione canonica per uno \textit{stack} di segnali e di norma è sufficiente per tutti gli usi normali. @@ -3748,12 +3747,12 @@ Il campo \var{ss\_sp} di \struct{stack\_t} indica l'indirizzo base dello nuovo \textit{stack} occorre inizializzare \var{ss\_sp} e \var{ss\_size} rispettivamente al puntatore e alla dimensione della memoria allocata, mentre \var{ss\_flags} deve essere nullo. Se invece si vuole disabilitare uno -\textit{stack} occorre indicare \const{SS\_DISABLE} come valore di +\textit{stack} occorre indicare \constd{SS\_DISABLE} come valore di \var{ss\_flags} e gli altri valori saranno ignorati. Se \param{oss} non è nullo verrà restituito dalla funzione indirizzo e dimensione dello \textit{stack} corrente nei relativi campi, mentre -\var{ss\_flags} potrà assumere il valore \const{SS\_ONSTACK} se il processo è +\var{ss\_flags} potrà assumere il valore \constd{SS\_ONSTACK} se il processo è in esecuzione sullo \textit{stack} alternativo (nel qual caso non è possibile cambiarlo) e \const{SS\_DISABLE} se questo non è abilitato.