%% 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",
%% license is included in the section entitled "GNU Free Documentation
%% License".
%%
+
\chapter{I codici di errore}
\label{cha:errors}
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
permessa: solo il proprietario del file o un processo con sufficienti
privilegi può eseguire l'operazione.
\item \errcode{ENOENT} \textit{No such file or directory}. Il file indicato
- dal \itindex{pathname}\textit{pathname} non esiste: o una delle
- componenti non esiste o il \textit{pathname} contiene un link simbolico
- spezzato. Errore tipico di un riferimento ad un file che si suppone
- erroneamente essere esistente.
+ dal \itindex{pathname} \textit{pathname} non esiste: o una delle componenti
+ non esiste o il \textit{pathname} contiene un link simbolico spezzato.
+ Errore tipico di un riferimento ad un file che si suppone erroneamente
+ essere esistente.
\item \errcode{EIO} \textit{Input/output error}. Errore di input/output: usato
per riportare errori hardware in lettura/scrittura su un dispositivo.
\item \errcode{ENXIO} \textit{No such device or address}. Dispositivo
scrivere, o viceversa, o si è cercato di eseguire un'operazione non
consentita per quel tipo di file descriptor.
\item \errcode{EACCES} \textit{Permission denied}. Permesso negato; l'accesso
- al file non è consentito: i permessi del file o della directory non
- consentono l'operazione.
+ al file o alla directory non è consentito: i permessi del file o della
+ directory non consentono l'operazione richiesta.
\item \errcode{ELOOP} \textit{Too many symbolic links encountered}. Ci sono
troppi link simbolici nella risoluzione di un
\itindex{pathname}\textit{pathname}.
\item \errcode{ENAMETOOLONG} \textit{File name too long}. Si è indicato un
- \itindex{pathname}\textit{pathname} troppo lungo.
+ \itindex{pathname} \textit{pathname} troppo lungo per un file o una
+ directory.
\item \errcode{ENOTBLK} \textit{Block device required}. Si è specificato un
file che non è un \textit{block device} in un contesto in cui era necessario
specificare un \textit{block device} (ad esempio si è tentato di montare un
\item \errcode{ENOTDIR} \textit{Not a directory}. Si è specificato un file che
non è una directory in una operazione che richiede una directory.
\item \errcode{EISDIR} \textit{Is a directory}. Il file specificato è una
- directory, non può essere aperto in scrittura, né si possono creare o
+ directory; non può essere aperto in scrittura, né si possono creare o
rimuovere link diretti ad essa.
\item \errcode{EMFILE} \textit{Too many open files}. Il processo corrente ha
- troppi file aperti e non può aprirne altri. Anche i descrittori duplicati
- vengono tenuti in conto\footnote{Il numero massimo di file aperti è
- controllabile dal sistema, in Linux si può usare il comando
- \cmd{ulimit}.}.
-\item \errcode{ENFILE} \textit{File table overflow}. Ci sono troppi file aperti
- nel sistema.
+ troppi file aperti e non può aprirne altri. Anche i descrittori duplicati ed
+ i socket vengono tenuti in conto.\footnote{il numero massimo di file aperti
+ è controllabile dal sistema; in Linux si può impostare usando il comando
+ \cmd{ulimit}, esso è in genere indicato dalla costante \const{OPEN\_MAX},
+ vedi sez.~\ref{sec:sys_limits}.}
+\item \errcode{ENFILE} \textit{File table overflow}. Il sistema ha troppi file
+ aperti in contemporanea. Si tenga presente che anche i socket contano come
+ file. Questa è una condizione temporanea, ed è molto difficile che si
+ verifichi nei sistemi moderni.
\item \errcode{ENOTTY} \textit{Not a terminal}. Si è tentata una operazione di
controllo relativa ad un terminale su un file che non lo è.
\item \errcode{ETXTBSY} \textit{Text file busy}. Si è cercato di eseguire un
- file che è aperto in scrittura, o scrivere un file che è in esecuzione.
+ file che è aperto in scrittura, o di scrivere su un file che è in
+ esecuzione.
\item \errcode{EFBIG} \textit{File too big}. Si è ecceduto il limite imposto
dal sistema sulla dimensione massima che un file può avere.
-\item \errcode{ENOSPC} \textit{No space left on device}. la directory in cui si
- vuole creare il link non ha spazio per ulteriori voci.
-\item \errcode{ESPIPE} \textit{Invalid seek operation}.
-\item \errcode{EROFS} \textit{Read-only file system}. il file risiede su un
- filesystem read-only.
-\item \errcode{EMLINK} \textit{Too many links}. Ci sono troppi link al file (il
- numero massimo è specificato dalla variabile \const{LINK\_MAX}, vedi
- sez.~\ref{sec:sys_limits}).
+\item \errcode{ENOSPC} \textit{No space left on device}. La directory in cui si
+ vuole creare il link non ha spazio per ulteriori voci, o si è cercato di
+ scrivere o di creare un nuovo file su un dispositivo che è già pieno.
+\item \errcode{ESPIPE} \textit{Invalid seek operation}. Si cercato di eseguire
+ una \func{seek} su un file che non supporta questa operazione (ad esempio su
+ una pipe).
+\item \errcode{EROFS} \textit{Read-only file system}. Si è cercato di
+ eseguire una operazione di scrittura su un file o una directory che risiede
+ su un filesystem montato un sola lettura.
+\item \errcode{EMLINK} \textit{Too many links}. Ci sono già troppi link al
+ file (il numero massimo è specificato dalla variabile \const{LINK\_MAX},
+ vedi sez.~\ref{sec:sys_limits}).
\item \errcode{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 \const{SIGPIPE}, la cui azione predefinita è
gestione dei processi.
\begin{description}
-\item \errcode{ESRCH} \textit{No process matches the specified process ID}. Non
- esiste un processo con il \acr{pid} specificato.
-\item \errcode{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,
- non può mai accadere in GNU/Linux.
-\item \errcode{ECHILD} \textit{There are no child processes}. Non esiste un
- processo figlio. Viene rilevato dalle funzioni per la gestione dei processi
- figli.
+\item \errcode{ESRCH} \textit{No process matches the specified process ID}.
+ Non esiste un processo o un \itindex{process~group} \textit{process group}
+ corrispondenti al valore dell'identificativo specificato.
+\item \errcode{E2BIG} \textit{Argument list too long}. La lista degli
+ argomenti passati è troppo lunga: è una condizione prevista da POSIX quando
+ la lista degli argomenti passata ad una delle funzioni \func{exec} occupa
+ troppa memoria, non può mai accadere in GNU/Linux.
+\item \errcode{ECHILD} \textit{There are no child processes}. Non esistono
+ processi figli di cui attendere la terminazione. Viene rilevato dalle
+ funzioni \func{wait} e \func{waitpid}.
%\item \errcode{EPROCLIM} \textit{}. Il limite dell'utente per nuovi processi
% sarà ecceduto alla prossima \func{fork}. (non credo esista in Linux)
% TODO verificare EPROCLIM
\begin{description}
\item \errcode{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.
+ asincrono al processo che impedisce la conclusione della chiamata, la
+ funzione ritorna con questo errore una volta che si sia correttamente
+ eseguito il gestore del segnale. In questo caso è necessario ripetere la
+ chiamata alla funzione.
\item \errcode{ENOMEM} \textit{No memory available}. Il kernel non è in grado
di allocare ulteriore memoria per completare l'operazione richiesta.
\item \errcode{EDEADLK} \textit{Deadlock avoided}. L'allocazione di una
- risorsa avrebbe causato un \textit{deadlock}\itindex{deadlock}. Non sempre
+ risorsa avrebbe causato un \itindex{deadlock} \textit{deadlock}. Non sempre
il sistema è in grado di riconoscere queste situazioni, nel qual caso si
avrebbe il blocco.
-\item \errcode{EFAULT} \textit{Bad address}. Una stringa passata come argomento
- è fuori dello spazio di indirizzi del processo, in genere questa situazione
- provoca l'emissione di un segnale di \textit{segment violation}
- (\const{SIGSEGV}).
+\item \errcode{EFAULT} \textit{Bad address}. Una stringa passata come
+ argomento è fuori dello spazio di indirizzi del processo, in genere questa
+ situazione provoca direttamente l'emissione di un segnale di \textit{segment
+ violation} (\const{SIGSEGV}).
\item \errcode{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 \errcode{EDOM} \textit{Domain error}. È usato dalle funzioni matematiche
- quando il valore di un argomento è al di fuori dell'intervallo in cui sono
- definite.
-\item \errcode{ERANGE} \textit{Range error}. È usato dalle funzioni matematiche
- quando il risultato non è rappresentabile a causa di un overflow o di un
- underflow.
+ quando il valore di un argomento è al di fuori dell'intervallo in cui esse
+ sono definite.
+\item \errcode{ERANGE} \textit{Range error}. È usato dalle funzioni
+ matematiche quando il risultato dell'operazione non è rappresentabile nel
+ valore di ritorno a causa di un overflow o di un underflow.
\item \errcode{EAGAIN} \textit{Resource temporarily unavailable}. La funzione è
fallita ma potrebbe funzionare se la chiamata fosse ripetuta. Questo errore
accade in due tipologie di situazioni:
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
specificato un valore non valido.
\end{description}
-
\begin{description}
+
+% definiti nel manuale delle glibc ma inesistenti in linux/errno.h
%\item \errcode{EBADRPC} \textit{}.
%\item \errcode{ERPCMISMATCH} \textit{}.
%\item \errcode{EPROGUNAVAIL} \textit{}.
%\item \errcode{ENEEDAUTH} \textit{}.
%\item \errcode{EBACKGROUND} \textit{}.
%\item \errcode{EDIED} \textit{}.
+% questi sembrano scherzi, sempre dal manuale delle glibc...
%\item \errcode{ED} \textit{}.
%\item \errcode{EGREGIOUS} \textit{}.
%\item \errcode{EIEIO} \textit{}.
-%\item \errcode{EGRATUITOUS} \textit{}.
-\item \errcode{EBADMSG} \textit{Not a data message}.
+%\item \errcode{EGRATUITOUS} \textit{} roba di Hurd, pare.
+
+
+\item \errcode{EBADMSG} \textit{Not a data message}. Definito da POSIX come
+errore che arriva ad una funzione di lettura che opera su uno stream. Non
+essendo gli stream definiti su Linux il kernel non genera mai questo tipo di
+messaggio.
+
+\item \errcode{EMULTIHOP} \textit{Multihop attempted}. Definito da POSIX come
+ errore dovuto all'accesso a file remoti attraverso più macchine, quando ciò
+ 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.
-\item \errcode{EMULTIHOP} \textit{Multihop attempted}.
-\item \errcode{ENODATA} \textit{No data available}.
-\item \errcode{ENOLINK} \textit{Link has been severed}.
-\item \errcode{ENOMSG} \textit{No message of desired type}. Indica che una
+ \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 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}. È 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{ENOSTR} \textit{Device not a stream}.
+
+\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}. 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}.
-\end{description}
-
+\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}
% \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
% LocalWords: EILSEQ Illegal sequence EBADMSG message EIDRM Identifier removed
% 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
+% LocalWords: Value large defined STAT EPROTO ETIME Timer expired group wait
+% LocalWords: waitpid Specification cap USB did respond Stale
+
+
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: "gapil"
+%%% End: