Errori

diff --git a/errors.tex b/errors.tex
index d560842c013f5b9afc4c10cc84d90211a69f1f42..1fced55630c788c4715595a00ff41bd3e145b9a2 100644 (file)
--- a/errors.tex
+++ b/errors.tex
@@ -20,11 +20,11 @@ ottenere dei messaggi di errore pi
 \section{Gli errori dei file}
 \label{sec:err_file_errors}
 
-In questa sezione riassumeremo gli errori restituiti dalle funzioni di
-libreria che operano sui file.
+In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
+attinenti ad errori che riguardano operazioni specifiche relative alla
+gestione dei file.
 
 \begin{description}
-  
 \item \macro{EPERM} \textit{Operation not permitted}. L'operazione non è
   permessa: solo il proprietario del file o un processo con sufficienti
   privilegi può eseguire l'operazione.
@@ -89,24 +89,25 @@ libreria che operano sui file.
 \item \macro{EMLINK} \textit{Too many links}. Ci sono troppi link al file (il
    numero massimo è specificato dalla variabile \macro{LINK\_MAX}, vedi
   \secref{sec:xxx_limits}).
-\item \macro{EPIPE} \textit{Broken pipe}. 
+\item \macro{EPIPE} \textit{Broken pipe}. Non c'è un processo che stia
+  leggendo l'altro capo della pipe. Ogni funzione che restituisce questo
+  errore genera anche un segnale \macro{SIGPIPE}, la cui azione di default è
+  terminare il programma; pertanto non si potrà vedere questo errore fintanto
+  che \macro{SIGPIPE} non viene gestito o bloccato.
 
 
 
 \section{Gli errori dei processi}
 \label{sec:err_proc_errors}
 
-In questa sezione riassumeremo gli errori restituiti dalle funzioni di
-libreria che operano sui processi.
+In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
+attinenti ad errori che riguardano operazioni specifiche relative alla
+gestione dei processi.
 
 \begin{description}
 
 \item \macro{ESRCH} \textit{No process matches the specified process ID}. Non
   esiste un processo con il \acr{pid} specificato.
-\item \macro{EINTR} \textit{Interrupted function call}. Una funzione di
-  libreria è stata interrotta. In genere questo avviene causa di un segnale
-  asincrono al processo che impedisce la conclusione della chiamata. In questo
-  caso è necessario ripetere la chiamata alla funzione. 
 \item \macro{E2BIG} \textit{Argument list too long}. Lista degli argomenti
   troppo lunga: è una condizione prevista da POSIX quando la lista degli
   argomenti passata ad una delle funzioni \func{exec} occupa troppa memoria,
@@ -119,12 +120,10 @@ libreria che operano sui processi.
 \section{Gli errori di rete}
 \label{sec:err_network}
 
+In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
+attinenti ad errori che riguardano operazioni specifiche relative alla
+gestione dei socket e delle connessioni di rete.
 
-\item \macro{EDOM} \textit{Domain error}. 
-\item \macro{ERANGE} \textit{Range error}. 
-\item \macro{EAGAIN} \textit{Resource temporarily unavailable}. 
-\item \macro{EWOULDBLOCK} \textit{Operation would block}. In Linux è identico
-  a \macro{EAGAIN}.
 \item \macro{EINPROGRESS} \textit{Operation now in progress}. 
 \item \macro{EALREADY} \textit{Operation already in progress}. 
 \item \macro{ENOTSOCK} \textit{Socket operation on non-socket}. 
@@ -191,9 +190,49 @@ libreria che operano sui processi.
 \item \macro{ETIME} \textit{Timer expired}. 
 
 
+\section{Errori generici}
+
+In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
+attinenti ad errori generici, si trovano qui tutti i cosici di errore non
+specificati nelle sezioni precedenti.
+
+\item \macro{EINTR} \textit{Interrupted function call}. Una funzione di
+  libreria è stata interrotta. In genere questo avviene causa di un segnale
+  asincrono al processo che impedisce la conclusione della chiamata. In questo
+  caso è necessario ripetere la chiamata alla funzione. 
+\item \macro{ENOMEM} \textit{No memory available}. Il kernel non è in grado di
+  allocare ulteriore memoria per completare l'operazione richiesta.
+\item \macro{EDEADLK} \textit{Deadlock avoided}. L'allocazione di una risorsa
+  avrebbe causato un deadlock. Non sempre il sistema è in grado di riconoscere
+  queste situazioni, nel qual caso si avrebbe in blocco. 
+\item \macro{EFAULT} \textit{Bad address}. Una stringa passata come parametro
+  è fuori dello spazio di indirizzi del processo, in genere questa situazione
+  provoca l'emissione di un sengale di \textit{segment violation}
+  (\macro{SIGSEGV}).
+\item \macro{EINVAL} \textit{Invalid argument}. Errore utilizzato per
+  segnalare vari tipi di problemi dovuti all'aver passato un argomento
+  sbagliato ad una funzione di libreria.
+\item \macro{EDOM} \textit{Domain error}. È usato dalle funzioni matematiche
+  quando il valore di un argomento è al di fuori dell'intervallo in cui sono
+  definite. 
+\item \macro{ERANGE} \textit{Range error}. È usato dalle funzioni matematiche
+  quando il risultato non è rappresentabile a causa di un overflow o di un
+  underflow.
+\item \macro{EAGAIN} \textit{Resource temporarily unavailable}. La funzione è
+  fallita ma potrebbe funzionare se riprovata. 
+\item \macro{EWOULDBLOCK} \textit{Operation would block}. In Linux è identico
+  a \macro{EAGAIN}.
+\end{description}
+
+
+
 \section{Errori del kernel}
 \label{sec:err_kernel_err}
 
+In questa sezione sono raccolti i codici di errore interni del kernel. Non
+sono usati dalle funzioni di libreria, ma vengono riportati da alcune system
+call (TODO verificare i dettagli, eventualmente cassare).
+
 \item \macro{ERESTART} \textit{Interrupted system call should be restarted}. 
 \item \macro{ECHRNG} \textit{Channel number out of range}. 
 \item \macro{EL2NSYNC} \textit{Level 2 not synchronized}. 
@@ -233,31 +272,6 @@ libreria che operano sui processi.
 \item \macro{ENOMEDIUM} \textit{No medium found}. 
 \item \macro{EMEDIUMTYPE} \textit{Wrong medium type}. 
 \item \macro{} \textit{}. 
-
-
-\end{description}
-
-
-
-\section{Altri errori}
-\label{sec:err_others}
-
-\item \macro{ENOMEM} \textit{No memory available}. Il kernel non è in grado di
-  allocare ulteriore memoria per completare l'operazione richiesta.
-\item \macro{EDEADLK} \textit{Deadlock avoided}. L'allocazione di una risorsa
-  avrebbe causato un deadlock. Non sempre il sistema è in grado di riconoscere
-  queste situazioni, nel qual caso si avrebbe in blocco. 
-\item \macro{EFAULT} \textit{Bad address}. Una stringa passata come parametro
-  è fuori dello spazio di indirizzi del processo, in genere questa situazione
-  provoca l'emissione di un sengale di \textit{segment violation}
-  (\macro{SIGSEGV}).
-\item \macro{EINVAL} \textit{Invalid argument}. Errore utilizzato per
-  segnalare vari tipi di problemi dovuti all'aver passato un argomento
-  sbagliato ad una funzione di libreria.
-
-
-
-
 \end{description}
 
 

diff --git a/prochand.tex b/prochand.tex
index f8c99f2f6fee9b6263852139c93ceebd10845c34..780db5198e5610888fb803ef0da13ef46916188a 100644 (file)
--- a/prochand.tex
+++ b/prochand.tex
@@ -994,15 +994,10 @@ creato un nuovo processo, la funzione semplicemente rimpiazza lo stack, o
 heap, i dati ed il testo del processo corrente con un nuovo programma letto da
 disco. 
 
-Con \func{exec} si chiude il cerchio delle funzioni su cui si basa il
-controllo dei processi in unix: con \func{fork} si crea un nuovo processo, con
-\func{exec} si avvia un nuovo programma, con \func{exit} e\func{wait} si
-effettua e si gestisce la conclusione dei programmi.
-
 Ci sono sei diverse versioni di \func{exec} (per questo la si è chiamata
 famiglia di funzioni) che possono essere usate per questo compito, che in
 realtà (come mostrato in \figref{fig:proc_exec_relat}), costituiscono un
-front-end a \func{execve}. Il suo prototipo è:
+front-end a \func{execve}. Il prototipo  di quest'utiltima è:
 
 \begin{prototype}{unistd.h}
 {int execve(const char * filename, char * const argv [], char * const envp[])}
@@ -1022,19 +1017,29 @@ front-end a \func{execve}. Il suo prototipo 
     montato in \cmd{noexec}, oppure non è un file normale o un interprete.
   \item \macro{EPERM} il file ha i bit \acr{suid} o \acr{sgid} ma l'utente non
     è root o il filesystem è montato con \cmd{nosuid}, oppure
-  \item \macro{ENOEXEC} 
-  \item \macro{ENOENT} 
-  \item \macro{ENOTDIR} 
-  \item \macro{ETXTBSY} 
-  \item \macro{ENFILE} 
-  \item \macro{EMFILE} 
-  \item \macro{EINVAL} 
-  \item \macro{EISDIR} 
-  \item \macro{ELIBBAD} 
+  \item \macro{ENOEXEC} il file è in un formato non eseguibile o non
+    riconosciuto come tale, o compilato per un'altra architettura.
+  \item \macro{ENOENT} il file o una delle librerie dinamiche o l'inteprete
+    necessari per eseguirlo non esistono.
+  \item \macro{ETXTBSY} L'eseguibile è aperto in scrittura da uno o più
+    processi. 
+  \item \macro{EINVAL} L'eseguibile ELF ha più di un segmento
+    \macro{PF\_INTERP}, cioè chiede di essere eseguito da più di un interprete.
+  \item \macro{ELIBBAD} Un interprete ELF non è in un formato  riconoscibile.
   \end{errlist}
-  ed inoltre anche \macro{EFAULT}, \macro{ENOMEM}, \macro{EIO}, \macro{ENAMETOOLONG}, \macro{E2BIG}, \macro{ELOOP}.
+  ed inoltre anche \macro{EFAULT}, \macro{ENOMEM}, \macro{EIO},
+  \macro{ENAMETOOLONG}, \macro{E2BIG}, \macro{ELOOP}, \macro{ENOTDIR},
+  \macro{ENFILE}, \macro{EMFILE}.
 \end{prototype}
 
+Le altre funzioni della famiglia servono per fornire all'utente una serie
+possibile di diverse interfacce per la creazione di un nuovo processo. 
+
+
+Con \func{exec} si chiude il cerchio delle funzioni su cui si basa il
+controllo dei processi in unix: con \func{fork} si crea un nuovo processo, con
+\func{exec} si avvia un nuovo programma, con \func{exit} e \func{wait} si
+effettua e si gestisce la conclusione dei programmi.
 
 
 \section{Il controllo di accesso}