Molte correzioni a giro e un po' di roba in piu` sui file.

[gapil.git] / signal.tex

diff --git a/signal.tex b/signal.tex
index d3d05b828fd542eee5a7efce47628df941ddca16..897d50611f87000d08fc80f7893616938c7a4a44 100644 (file)
--- a/signal.tex
+++ b/signal.tex
@@ -59,8 +59,8 @@ in cui si vuole che il signal handler esterno resti attivo.
 In questo caso è possibile una situazione in cui i segnali possono essere
 perduti; si consideri il seguente segmento di codice in cui la prima
 operazione del manipolatore è quella di reinstallare se stesso:
-\begin{lstlisting}{showlines=false}
-
+\footnotesize
+\begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
     int sig_handler();            /* handler function */
     ...
     signal(SIGINT, sig_handler);  /* establish handler */
@@ -72,6 +72,7 @@ int sig_handler()
     ...                           /* process signal */
 }
 \end{lstlisting}
+\normalsize
 se un secondo segnale arriva prima che il manipolatore invocato dal primo
 abbia eseguito la re-installazione di se stesso il segnale può essere perso o
 causare il comportamento originale assegnato al segnale (in genere la
@@ -92,7 +93,8 @@ quello in cui si usa il manipolatore per settare un flag che riporta al
 processo l'occorrenza del segnale. Si consideri il seguente segmento di
 codice il cui scopo sarebbe quello di fermare il processo fino all'occorrenza
 di un opportuno segnale:
-\begin{lstlisting}{}
+\footnotesize
+\begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
 int signal_flag = 0;
 main ()
 {
@@ -111,6 +113,7 @@ int sig_handler()
     signal_flag = 1;              /* set flag */
 }
 \end{lstlisting}
+\normalsize
 l'idea è che quando il processo trova il flag a zero viene messo in sleep e
 verrà risvegliato solo dalla ricezione di un segnale. Il manipolatore si
 limita in questo caso a settare il flag a uno; all'uscita dal manipolatore la
@@ -161,7 +164,7 @@ determinare quali segnali sono bloccati e quali sono pendenti.
 
 
 
-\subsubsection{Tipi di segnali}
+\subsection{Tipi di segnali}
 \label{sec:sig_types}
 
 In generale gli eventi che generano i segnali si possono dividere in tre
@@ -273,20 +276,21 @@ sono standardizzati e uniformi rispetto alle varie implementazioni, che si
 devono usare nei programmi. Tutti i nomi e le funzioni che concernono i
 segnali sono definiti nell'header di sistema \texttt{signal.h}.
 
-Il numero totale di segnali presenti è dato dalla macro \texttt{NSIG}, e dato
+Il numero totale di segnali presenti è dato dalla macro \macro{NSIG}, e dato
 che i numeri dei segnali sono allocati progressivamente, essa corrisponde
 anche al successivo del valore numerico assegnato all'ultimo segnale definito.
 In \ntab\ si è riportato l'elenco completo dei segnali definiti in Linux
 (estratto dalle man page), comparati con quelli definiti in vari standard.
 \begin{table}[htb]
+  \footnotesize
   \centering
-  \begin{tabular}[c]{|l|c|c|c||c|p{8cm}|}
+  \begin{tabular}[c]{|l|c|c|c||c|p{6cm}|}
     \hline
     Segnale  & POSIX.1 & SUSv2 & Linux  &Azione &  Descrizione \\
     \hline
     \hline
-    SIGHUP   &$\bullet$&&$\bullet$&  A  & Hangup sul terminale  o
-    morte del processo di controllo  \\
+    SIGHUP   &$\bullet$&&$\bullet$&  A  & Hangup  o
+    fine del processo di controllo  \\
     SIGINT   &$\bullet$&&$\bullet$&  A  & Interrupt da tastiera (\cmd{C-c})\\
     SIGQUIT  &$\bullet$&&$\bullet$&  C  & Quit da tastiera (\cmd{C-y}) \\
     SIGILL   &$\bullet$&&$\bullet$&  C  & Istruzione illegale\\
@@ -305,8 +309,8 @@ In \ntab\ si 
     SIGTSTP  &$\bullet$&&$\bullet$&  D  & Stop typed at tty \\
     SIGTTIN  &$\bullet$&&$\bullet$&  D  & tty input for background process \\
     SIGTTOU  &$\bullet$&&$\bullet$&  D  & tty output for background process \\
-    SIGBUS    &&$\bullet$&$\bullet$& C & Bus error (bad memory access) \\
-    SIGPOLL   &&$\bullet$&$\bullet$& A & Pollable event (Sys V). Synonym of SIGIO\\
+    SIGBUS   &&$\bullet$&$\bullet$& C & Bus error (bad memory access) \\
+    SIGPOLL  &&$\bullet$&$\bullet$& A & Pollable event (Sys V). Synonym of SIGIO\\
     SIGPROF   &&$\bullet$&$\bullet$& A & Profiling timer expired \\
     SIGSYS    &&$\bullet$&$\bullet$& C & Bad argument to routine (SVID)\\
     SIGTRAP   &&$\bullet$&$\bullet$& C & Trace/breakpoint trap \\
@@ -358,7 +362,7 @@ stato dello stack e delle variabili al momento della ricezione del segnale.
 la descrizione dettagliata del significato dei vari segnali, raggruppati per
 tipologia, è a seguire.
 
-\subsubsection{Segnali di errore di programma}
+\subsection{Segnali di errore di programma}
 \label{sec:sig_prog_error}
 
 Questi segnali sono generati quando il sistema, o in certi casi direttamente
@@ -622,6 +626,28 @@ classificabili in maniera omogenea. Questi segnali sono:
 \end{description}
 
 
+\subsection{Le funzioni \func{strsignal} e \func{psignal}}
+\label{sec:sig_strsignal}
+
+Per la descrizione dei segnali il sistema mette a disposizione due funzioni
+che stampano un messaggio di descrizione dato il numero. In genere si usano
+quando si vuole notificare all'utente il segnale avvenuto (nel caso di
+terminazione di un processo figlio o di un manipolatore che gestisce più
+segnali); la prima funzione è una estensione GNU ed è analoga alla funzione
+\func{strerr} per gli errori:
+\begin{prototype}{string.h}{char * strsignal (int signum)} 
+  Ritorna il puntatore ad una stringa allocata staticamente che contiene la
+  descrizione del segnale \var{signum}. 
+\end{prototype}
+
+Dato che la stringa è allocata staticamente non se ne deve modificare il
+contenuto, che resta valido solo fino alla successiva chiamata di
+\func{strsignal}; nel caso si debba mantenere traccia del messaggio sarà
+necessario copiarlo.
+
+La seconda funzione deriva da BSD ed è analoga alla funzione \func{perror}
+descritta in \secref{}
+
 
 \section{La gestione dei segnali}
 \label{sec:sig_handlers}