carenza è spesso indice di qualcosa che non va nel sistema, è pertanto
opportuno segnalare esplicitamente questo tipo di errori.
\end{itemize}
-\item \errcode{EWOULDBLOCK} \textit{Operation would block}. In Linux è identico
- a \errcode{EAGAIN}.
+\item \errcode{EWOULDBLOCK} \textit{Operation would block}. Indica che
+ l'operazione richiesta si bloccherebbe, ad esempio se si apre un file in
+ modalità non bloccante, una \func{read} restituirebbe questo errore per
+ indicare che non ci sono dati; in Linux è identico a \errcode{EAGAIN}, ma in
+ altri sistemi può essere specificato un valore diverso.
\item \errcode{EINPROGRESS} \textit{Operation now in progress}. Operazione in
corso. Un'operazione che non può essere completata immediatamente è stata
avviata su un oggetto posto in modalità non-bloccante. Questo errore viene
%\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
non è consentito. Non viene mai generato su Linux.
\item \errcode{EIDRM} \textit{Identifier removed}. Indica che l'oggetto del
- \textit{SysV IPC} cui si fa riferimento è stato cancellato.
+ \textit{SysV IPC} a cui si fa riferimento è stato cancellato.
\item \errcode{ENODATA} \textit{No data available}. Viene indicato da Posix
come restituito da una \func{read} eseguita su un file descriptor in
modalità non bloccante quando non ci sono dati. In realtà in questo caso
- viene utilizzato \errcode{EAGAIN}. In Linux viene utilizzato quando dalle
- funzioni per la gestione degli attributi estesi dei file quando il nome
+ viene utilizzato \errcode{EAGAIN}. In Linux viene utilizzato dalle funzioni
+ per la gestione degli attributi estesi dei file quando il nome
dell'attributo richiesto non viene trovato.
% TODO referenziare la trattazione degli attributi estesi dei file
-\item \errcode{ENOLINK} \textit{Link has been severed}.
+\item \errcode{ENOLINK} \textit{Link has been severed}. È un errore il cui
+ valore è indicato come \textsl{riservato} nelle \textit{Single Unix
+ Specification}. Dovrebbe indicare l'impossibilità di accedere ad un file a
+ causa di un errore sul collegamento di rete, ma non ci sono indicazioni
+ precise del suo utilizzo. Per quanto riguarda Linux viene riportato nei
+ sorgenti del kernel in alcune operazioni relative ad operazioni di rete.
\item \errcode{ENOMSG} \textit{No message of desired type}. Indica che in una
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}
projects / gapil.git / blobdiff