\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.
\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,
\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}.
\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}.
\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}