Aggiornamenti del copyright all'anno nuovo, e risistemazione delle

[gapil.git] / errors.tex

diff --git a/errors.tex b/errors.tex
index 3028dc6cff6c56120ada38d10d35bf4468051062..193145531b5a5fc1503e402b797dead9be0de311 100644 (file)
--- a/errors.tex
+++ b/errors.tex
@@ -1,6 +1,6 @@
 %% errors.tex
 %%
-%% Copyright (C) 2000-2006 Simone Piccardi.  Permission is granted to
+%% Copyright (C) 2000-2007 Simone Piccardi.  Permission is granted to
 %% copy, distribute and/or modify this document under the terms of the GNU Free
 %% Documentation License, Version 1.1 or any later version published by the
 %% Free Software Foundation; with the Invariant Sections being "Un preambolo",
@@ -8,6 +8,7 @@
 %% license is included in the section entitled "GNU Free Documentation
 %% License".
 %%
+
 \chapter{I codici di errore}
 \label{cha:errors}
 
@@ -15,9 +16,10 @@ Si riportano in questa appendice tutti i codici di errore. Essi sono
 accessibili attraverso l'inclusione del file di header \file{errno.h}, che
 definisce anche la variabile globale \var{errno}. Per ogni errore definito
 riporteremo la stringa stampata da \func{perror} ed una breve spiegazione. Si
-tenga presente che spiegazioni più particolareggiate, qualora necessarie per
-il caso specifico, possono essere trovate nella descrizione del prototipo
-della funzione.
+tenga presente che spiegazioni più particolareggiate del significato
+dell'errore, qualora necessarie per casi specifici, possono essere trovate
+nella descrizione del prototipo della funzione per cui detto errore si è
+verificato.
 
 I codici di errore sono riportati come costanti di tipo \ctyp{int}, i valori
 delle costanti sono definiti da macro di preprocessore nel file citato, e
@@ -353,7 +355,7 @@ specificati nelle sezioni precedenti.
 %\item \errcode{ED} \textit{}. 
 %\item \errcode{EGREGIOUS} \textit{}. 
 %\item \errcode{EIEIO} \textit{}. 
-%\item \errcode{EGRATUITOUS} \textit{}. 
+%\item \errcode{EGRATUITOUS} \textit{} roba di Hurd, pare. 
 
 
 \item \errcode{EBADMSG} \textit{Not a data message}. Definito da Posix come
@@ -388,24 +390,35 @@ messaggio.
   coda di messaggi del \textit{SysV IPC} non è presente nessun messaggio del
   tipo desiderato.
 
-\item \errcode{ENOSR} \textit{Out of streams resources}. 
+\item \errcode{ENOSR} \textit{Out of streams resources}. Errore relativo agli
+  \textit{STREAMS}, che indica l'assenza di risorse sufficienti a completare
+  l'operazione richiesta. Quella degli \textit{STREAMS}\footnote{che non vanno
+    confusi con gli \textit{stream} di cap.~\ref{cha:files_std_interface}.}  è
+  interfaccia di programmazione originaria di System V, che non è implementata
+  da Linux, per cui questo errore non viene utilizzato.
 
-\item \errcode{ENOSTR} \textit{Device not a stream}. 
+\item \errcode{ENOSTR} \textit{Device not a stream}. Altro errore relativo
+  agli \textit{STREAMS}, anch'esso non utilizzato da Linux.
 
 \item \errcode{EOVERFLOW} \textit{Value too large for defined data type}. Si è
   chiesta la lettura di un dato dal \textit{SysV IPC} con \const{IPC\_STAT} ma
   il valore eccede la dimensione usata nel buffer di lettura.
 
-\item \errcode{EPROTO} \textit{Protocol error}. C'è stato un errore nel 
-  protocollo di rete usato dal socket.
-
-\item \errcode{ETIME} \textit{Timer expired}. 
+\item \errcode{EPROTO} \textit{Protocol error}. Indica che c'è stato un errore
+  nel protocollo di rete usato dal socket; viene usato come errore generico
+  dall'interfaccia degli \textit{STREAMS} quando non si è in grado di
+  specificare un altro codice di errore che esprima più accuratamente la
+  situazione.
+
+\item \errcode{ETIME} \textit{Timer expired}. Indica che è avvenuto un timeout
+  nell'accesso ad una risorsa (ad esempio un semaforo). Compare nei sorgenti
+  del kernel (in particolare per le funzioni relativa al bus USB) come
+  indicazione di una mancata risposta di un dispositivo, con una descrizione
+  alternativa di \textit{Device did not respond}.
 \end{description}
 
 
 
-
-
 % \section{Errori del kernel}
 % \label{sec:err_kernel_err}
 
@@ -457,12 +470,6 @@ messaggio.
 % \end{description}
 
 
-
-%%% Local Variables: 
-%%% mode: latex
-%%% TeX-master: "gapil"
-%%% End: 
-
 % LocalWords:  header errno perror int strerror sez EPERM Operation not ENOENT
 % LocalWords:  permitted such pathname EIO error ENXIO device address kernel Is
 % LocalWords:  ENOEXEC Invalid executable format exec EBADF Bad descriptor Too
@@ -493,3 +500,9 @@ messaggio.
 % LocalWords:  SysV EMULTIHOP Multihop attempted ENODATA ENOLINK been severed
 % LocalWords:  ENOMSG desired ENOSR streams resources ENOSTR stream EOVERFLOW
 % LocalWords:  Value large defined STAT EPROTO ETIME Timer expired
+
+
+%%% Local Variables: 
+%%% mode: latex
+%%% TeX-master: "gapil"
+%%% End: