Varie correzioni, completata revisione capitolo sull'I/O su file
[gapil.git] / errors.tex
1 %% errors.tex
2 %%
3 %% Copyright (C) 2000-2019 Simone Piccardi.  Permission is granted to
4 %% copy, distribute and/or modify this document under the terms of the GNU Free
5 %% Documentation License, Version 1.1 or any later version published by the
6 %% Free Software Foundation; with the Invariant Sections being "Un preambolo",
7 %% with no Front-Cover Texts, and with no Back-Cover Texts.  A copy of the
8 %% license is included in the section entitled "GNU Free Documentation
9 %% License".
10 %%
11
12 \chapter{I codici di errore}
13 \label{cha:errors}
14
15 Si riportano in questa appendice tutti i codici di errore. Essi sono
16 accessibili attraverso l'inclusione del file di header \headfile{errno.h}, che
17 definisce anche la variabile globale \var{errno}. Per ogni errore definito
18 riporteremo la stringa stampata da \func{perror} ed una breve spiegazione. Si
19 tenga presente che spiegazioni più particolareggiate del significato
20 dell'errore, qualora necessarie per casi specifici, possono essere trovate
21 nella descrizione del prototipo della funzione per cui detto errore si è
22 verificato.
23
24 I codici di errore sono riportati come costanti di tipo \ctyp{int}, i valori
25 delle costanti sono definiti da macro di preprocessore nel file citato, e
26 possono variare da architettura a architettura; è pertanto necessario
27 riferirsi ad essi tramite i nomi simbolici. Le funzioni \func{perror} e
28 \func{strerror} (vedi sez.~\ref{sec:sys_strerror}) possono essere usate per
29 ottenere dei messaggi di errore più espliciti.
30
31
32 \section{Gli errori dei file}
33 \label{sec:err_file_errors}
34
35 In questa sezione sono raccolti i codici restituiti dalle \textit{system call}
36 attinenti ad errori che riguardano operazioni specifiche relative alla
37 gestione dei file.
38
39 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
40 \item[\errcode{EACCES} \textit{Permission denied}.] Permesso negato; l'accesso
41   al file o alla directory non è consentito: i permessi del file o della
42   directory o quelli necessari ad attraversare un \textit{pathname} non
43   consentono l'operazione richiesta. 
44 \item[\errcode{EBADF} \textit{Bad file descriptor}.] File descriptor non
45   valido: si è usato un file descriptor inesistente, o aperto in sola lettura
46   per scrivere, o viceversa, o si è cercato di eseguire un'operazione non
47   consentita per quel tipo di file descriptor.
48 \item[\errcode{EBUSY} \textit{Resource busy}.] Una risorsa di sistema che non
49   può essere condivisa è occupata. Ad esempio si è tentato di cancellare la
50   directory su cui si è montato un filesystem.
51 \item[\errcode{EDQUOT} \textit{Quota exceeded}.] Si è ecceduta la quota di
52   disco dell'utente, usato sia per lo spazio disco che per il numero di
53   \textit{inode}.
54 \item[\errcode{EEXIST} \textit{File exists}.] Si è specificato un file
55   esistente in un contesto in cui ha senso solo specificare un nuovo file.
56 \item[\errcode{EFBIG} \textit{File too big}.] Si è ecceduto il limite imposto
57   dal sistema sulla dimensione massima che un file può avere.
58 \item[\errcode{EFTYPE} \textit{Inappropriate file type or format}.] Il file è
59   di tipo sbagliato rispetto all'operazione richiesta o un file di dati ha un
60   formato sbagliato. Alcuni sistemi restituiscono questo errore quando si
61   cerca di impostare lo \textit{sticky bit} su un file che non è una
62   directory.
63 \item[\errcode{EIO} \textit{Input/output error}.] Errore di input/output:
64   usato per riportare errori hardware in lettura/scrittura su un dispositivo.
65 \item[\errcode{EISDIR} \textit{Is a directory}.] Il file specificato è una
66   directory; non può essere aperto in scrittura, né si possono creare o
67   rimuovere link diretti ad essa.
68 \item[\errcode{ELOOP} \textit{Too many symbolic links encountered}.] Ci sono
69   troppi link simbolici nella risoluzione di un \textit{pathname}.
70 \item[\errcode{EMFILE} \textit{Too many open files}.] Il processo corrente ha
71   troppi file aperti e non può aprirne altri. Anche i descrittori duplicati ed
72   i socket vengono tenuti in conto.\footnote{il numero massimo di file aperti
73     è controllabile dal sistema; in Linux si può impostare usando il comando
74     \cmd{ulimit}, esso è in genere indicato dalla costante \const{OPEN\_MAX},
75     vedi sez.~\ref{sec:sys_limits}.}
76 \item[\errcode{EMLINK} \textit{Too many links}.] Ci sono già troppi link al
77   file, il numero massimo è specificato dalla variabile \const{LINK\_MAX},
78   vedi sez.~\ref{sec:sys_limits}.
79 \item[\errcode{ENAMETOOLONG} \textit{File name too long}.] Si è indicato un
80   \textit{pathname} troppo lungo per un file o una directory.
81 \item[\errcode{ENFILE} \textit{File table overflow}.] Il sistema ha troppi
82   file aperti in contemporanea. Si tenga presente che anche i socket contano
83   come file. Questa è una condizione temporanea, ed è molto difficile che si
84   verifichi nei sistemi moderni.
85 \item[\errcode{ENODEV} \textit{No such device}.] Si è indicato un tipo di
86   device sbagliato ad una funzione che ne richiede uno specifico.
87 \item[\errcode{ENOENT} \textit{No such file or directory}.] Il file indicato
88   dal \textit{pathname} non esiste: o una delle componenti non esiste o il
89   \textit{pathname} contiene un link simbolico spezzato.  Errore tipico di un
90   riferimento ad un file che si suppone erroneamente essere esistente.
91 \item[\errcode{ENOEXEC} \textit{Invalid executable file format}.] Il file non
92   ha un formato eseguibile, è un errore riscontrato dalle funzioni
93   \func{exec}.
94 \item[\errcode{ENOLCK} \textit{No locks available}.] È usato dalle utilità per
95   la gestione del file locking; non viene generato da un sistema GNU, ma può
96   risultare da un'operazione su un server NFS di un altro sistema.
97 \item[\errcode{ENOSPC} \textit{No space left on device}.] La directory in cui
98   si vuole creare il link non ha spazio per ulteriori voci, o si è cercato di
99   scrivere o di creare un nuovo file su un dispositivo che è già pieno.
100 \item[\errcode{ENOTBLK} \textit{Block device required}.] Si è specificato un
101   file che non è un \textit{block device} in un contesto in cui era necessario
102   specificare un \textit{block device} (ad esempio si è tentato di montare un
103   file ordinario).
104 \item[\errcode{ENOTDIR} \textit{Not a directory}.] Si è specificato un file
105   che non è una directory in una operazione che richiede una directory.
106 \item[\errcode{ENOTEMPTY} \textit{Directory not empty}.] La directory non è
107   vuota quando l'operazione richiede che lo sia. È l'errore tipico che si ha
108   quando si cerca di cancellare una directory contenente dei file.
109 \item[\errcode{ENOTTY} \textit{Not a terminal}.] Si è tentata una operazione
110   di controllo relativa ad un terminale su un file che non lo è.
111 \item[\errcode{ENXIO} \textit{No such device or address}.] Dispositivo
112   inesistente: il sistema ha tentato di usare un dispositivo attraverso il
113   file specificato, ma non lo ha trovato. Può significare che il file di
114   dispositivo non è corretto, che il modulo relativo non è stato caricato nel
115   kernel, o che il dispositivo è fisicamente assente o non funzionante.
116 \item[\errcode{EPERM} \textit{Operation not permitted}.] L'operazione non è
117   permessa: solo il proprietario del file o un processo con sufficienti
118   privilegi può eseguire l'operazione.
119 \item[\errcode{EPIPE} \textit{Broken pipe}.] Non c'è un processo che stia
120   leggendo l'altro capo della \textit{pipe}. Ogni funzione che restituisce
121   questo errore genera anche un segnale \signal{SIGPIPE}, la cui azione
122   predefinita è terminare il programma; pertanto non si potrà vedere questo
123   errore fintanto che \signal{SIGPIPE} non viene gestito o bloccato.
124 \item[\errcode{EREMOTE} \textit{Object is remote}.] Si è fatto un tentativo di
125   montare via NFS un filesystem remoto con un nome  che già specifica un
126   filesystem montato via NFS. 
127 \item[\errcode{EROFS} \textit{Read-only file system}.]  Si è cercato di
128   eseguire una operazione di scrittura su un file o una directory che risiede
129   su un filesystem montato un sola lettura.
130 \item[\errcode{ESPIPE} \textit{Invalid seek operation}.] Si cercato di
131   eseguire una \func{lseek} su un file che non supporta questa operazione (ad
132   esempio su una \textit{pipe}, da cui il nome).
133 \item[\errcode{ESTALE} \textit{Stale NFS file handle}.] Indica un problema
134   interno a NFS causato da cambiamenti del filesystem del sistema remoto. Per
135   recuperare questa condizione in genere è necessario smontare e rimontare il
136   filesystem NFS.
137 \item[\errcode{ETXTBSY} \textit{Text file busy}.] Si è cercato di eseguire un
138   file che è aperto in scrittura, o di scrivere su un file che è in
139   esecuzione.
140 \item[\errcode{EUSERS} \textit{Too many users}.] Troppi utenti, il sistema delle
141   quote rileva troppi utenti nel sistema.
142 \item[\errcode{EXDEV} \textit{Cross-device link}.] Si è tentato di creare un
143   link diretto che attraversa due filesystem differenti.
144 \end{basedescript}
145
146 \section{Gli errori dei processi}
147 \label{sec:err_proc_errors}
148
149 In questa sezione sono raccolti i codici restituiti dalle \textit{system call}
150 attinenti ad errori che riguardano operazioni specifiche relative alla
151 gestione dei processi.
152
153 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
154 \item[\errcode{E2BIG} \textit{Argument list too long}.] La lista degli
155   argomenti passati è troppo lunga: è una condizione prevista da POSIX quando
156   la lista degli argomenti passata ad una delle funzioni \func{exec} occupa
157   troppa memoria.
158 \item[\errcode{ECHILD} \textit{There are no child processes}.] Non esistono
159   processi figli di cui attendere la terminazione. Viene rilevato dalle
160   funzioni \func{wait} e \func{waitpid} (vedi sez.~\ref{sec:proc_wait}).
161 \item[\errcode{EPROCLIM} \textit{Too many processes}.]  Il limite dell'utente
162   per nuovi processi (vedi sez.~\ref{sec:sys_resource_limit}) sarà ecceduto
163   alla prossima \func{fork}; è un codice di errore di BSD, che non viene
164   utilizzato al momento su Linux. 
165 \item[\errcode{ESRCH} \textit{No process matches the specified process ID}.]
166   Non esiste un processo o un \textit{process group} corrispondenti al valore
167   dell'identificativo specificato.
168 \end{basedescript}
169
170
171 \section{Gli errori di rete}
172 \label{sec:err_network}
173
174 In questa sezione sono raccolti i codici restituiti dalle \textit{system call}
175 attinenti ad errori che riguardano operazioni specifiche relative alla
176 gestione dei socket e delle connessioni di rete.
177
178 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
179 \item[\errcode{EADDRINUSE} \textit{Address already in use}.] L'indirizzo del
180   socket richiesto è già utilizzato (ad esempio si è eseguita \func{bind}
181   su una porta già in uso).
182 \item[\errcode{EADDRNOTAVAIL} \textit{Cannot assign requested
183     address}.]  L'indirizzo richiesto non è disponibile (ad esempio si
184   è cercato di dare al socket un nome che non corrisponde al nome
185   della stazione locale), o l'interfaccia richiesta non esiste.
186 \item[\errcode{EAFNOSUPPORT} \textit{Address family not supported by
187     protocol}.]  Famiglia di indirizzi non supportata. La famiglia di
188   indirizzi richiesta non è supportata, o è inconsistente con il protocollo
189   usato dal socket.
190 \item[\errcode{ECONNABORTED} \textit{Software caused connection abort}.] Una
191   connessione è stata abortita localmente. 
192 \item[\errcode{ECONNREFUSED} \textit{Connection refused}.] Un host remoto ha
193   rifiutato la connessione (in genere dipende dal fatto che non c'è un server
194   per soddisfare il servizio richiesto).  
195 \item[\errcode{ECONNRESET} \textit{Connection reset by peer}.] Una connessione
196   è stata chiusa per ragioni fuori dal controllo dell'host locale, come il
197   riavvio di una macchina remota o un qualche errore non recuperabile sul
198   protocollo.
199 \item[\errcode{EDESTADDRREQ} \textit{Destination address required}.] Non c'è
200   un indirizzo di destinazione predefinito per il socket. Si ottiene questo
201   errore mandando dato su un socket senza connessione senza averne prima
202   specificato una destinazione.
203 \item[\errcode{EISCONN} \textit{Transport endpoint is already connected}.] Si
204   è tentato di connettere un socket che è già connesso.
205 \item[\errcode{EMSGSIZE} \textit{Message too long}.] Le dimensioni di un
206   messaggio inviato su un socket sono eccedono la massima lunghezza supportata.
207 \item[\errcode{ENETDOWN} \textit{Network is down}.] L'operazione sul socket è
208   fallita perché la rete è sconnessa.
209 \item[\errcode{ENETRESET} \textit{Network dropped connection because of
210     reset}.]  Una connessione è stata cancellata perché l'host remoto è
211   caduto.
212 \item[\errcode{ENETUNREACH} \textit{Network is unreachable}.] L'operazione è
213   fallita perché l'indirizzo richiesto è irraggiungibile (ad esempio la
214   sottorete della stazione remota è irraggiungibile).
215 \item[\errcode{ENOBUFS} \textit{No buffer space available}.] Tutti i buffer per
216   le operazioni di I/O del kernel sono occupati. In generale questo errore è
217   sinonimo di \errcode{ENOMEM}, ma attiene alle funzioni di input/output. In
218   caso di operazioni sulla rete si può ottenere questo errore invece
219   dell'altro.
220 \item[\errcode{ENOPROTOOPT} \textit{Protocol not available}.] Protocollo non
221   disponibile. Si è richiesta un'opzione per il socket non disponibile con il
222   protocollo usato.
223 \item[\errcode{ENOTCONN} \textit{Transport endpoint is not connected}.] Il
224   socket non è connesso a niente. Si ottiene questo errore quando si cerca di
225   trasmettere dati su un socket senza avere specificato in precedenza la loro
226   destinazione. Nel caso di socket senza connessione (ad esempio socket UDP)
227   l'errore che si ottiene è \errcode{EDESTADDRREQ}.
228 \item[\errcode{ENOTSOCK} \textit{Socket operation on non-socket}.] Si è
229   tentata un'operazione su un file descriptor che non è un socket quando
230   invece era richiesto un socket.
231 \item[\errcode{EOPNOTSUPP} \textit{Operation not supported on transport
232     endpoint}.] L'operazione richiesta non è supportata. Alcune funzioni non
233   hanno senso per tutti i tipi di socket, ed altre non sono implementate per
234   tutti i protocolli di trasmissione. Questo errore quando un socket non
235   supporta una particolare operazione, e costituisce una indicazione generica
236   che il server non sa cosa fare per la chiamata effettuata.
237 \item[\errcode{EPFNOSUPPORT} \textit{Protocol family not supported}.] Famiglia
238   di protocolli non supportata. La famiglia di protocolli richiesta non è
239   supportata.
240 \item[\errcode{EPROTONOSUPPORT} \textit{Protocol not supported}.] Protocollo
241   non supportato. Il tipo di socket non supporta il protocollo richiesto (un
242   probabile errore nella specificazione del protocollo).
243 \item[\errcode{EPROTOTYPE} \textit{Protocol wrong type for socket}.]
244   Protocollo sbagliato per il socket. Il socket usato non supporta il
245   protocollo di comunicazione richiesto.
246 \item[\errcode{ESHUTDOWN} \textit{Cannot send after transport endpoint
247     shutdown}.] Il socket su cui si cerca di inviare dei dati ha avuto uno
248   shutdown.
249 \item[\errcode{ESOCKTNOSUPPORT} \textit{Socket type not supported}.] Socket
250   non supportato. Il tipo di socket scelto non è supportato.
251 \item[\errcode{ETIMEDOUT} \textit{Connection timed out}.] Un'operazione sul
252   socket non ha avuto risposta entro il periodo di timeout.
253 \item[\errcode{ETOOMANYREFS} \textit{Too many references: cannot splice}.] La
254   \acr{glibc} dice ???
255 \end{basedescript}
256
257
258 \section{Errori generici}
259
260 In questa sezione sono raccolti i codici restituiti dalle \textit{system call}
261 attinenti ad errori generici, si trovano qui tutti i codici di errore non
262 specificati nelle sezioni precedenti.
263
264 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
265 \item[\errcode{EAGAIN} \textit{Resource temporarily unavailable}.] La funzione è
266   fallita ma potrebbe funzionare se la chiamata fosse ripetuta. Questo errore
267   accade in due tipologie di situazioni:
268   \begin{itemize}
269   \item Si è effettuata un'operazione che si sarebbe bloccata su un oggetto
270     che è stato posto in modalità non bloccante. Nei vecchi sistemi questo era
271     un codice diverso, \errcode{EWOULDBLOCK}. In genere questo ha a che fare
272     con file o socket, per i quali si può usare la funzione \func{select} per
273     vedere quando l'operazione richiesta (lettura, scrittura o connessione)
274     diventa possibile.
275   \item Indica la carenza di una risorsa di sistema che non è al momento
276     disponibile (ad esempio \func{fork} può fallire con questo errore se si è
277     esaurito il numero di processi contemporanei disponibili). La ripetizione
278     della chiamata in un periodo successivo, in cui la carenza della risorsa
279     richiesta può essersi attenuata, può avere successo. Questo tipo di
280     carenza è spesso indice di qualcosa che non va nel sistema, è pertanto
281     opportuno segnalare esplicitamente questo tipo di errori.
282   \end{itemize}
283 \item[\errcode{EALREADY} \textit{Operation already in progress}.] L'operazione è
284   già in corso. Si è tentata un'operazione già in corso su un oggetto posto in
285   modalità non-bloccante.
286 \item[\errcode{EDEADLK} \textit{Deadlock avoided}.] L'allocazione di una
287   risorsa avrebbe causato un \textit{deadlock}. Non sempre il sistema è in
288   grado di riconoscere queste situazioni, nel qual caso si avrebbe il blocco.
289 \item[\errcode{EFAULT} \textit{Bad address}.] Una stringa passata come
290   argomento è fuori dello spazio di indirizzi del processo, in genere questa
291   situazione provoca direttamente l'emissione di un segnale di \textit{segment
292     violation} (\signal{SIGSEGV}).
293 \item[\errcode{EDOM} \textit{Domain error}.] È usato dalle funzioni matematiche
294   quando il valore di un argomento è al di fuori dell'intervallo in cui esse
295   sono definite.
296 \item[\errcode{EILSEQ} \textit{Illegal byte sequence}.] Nella decodifica di un
297   carattere esteso si è avuta una sequenza errata o incompleta o si è
298   specificato un valore non valido.
299 \item[\errcode{EINPROGRESS} \textit{Operation now in progress}.] Operazione in
300   corso. Un'operazione che non può essere completata immediatamente è stata
301   avviata su un oggetto posto in modalità non-bloccante. Questo errore viene
302   riportato per operazioni che si dovrebbero sempre bloccare (come per una
303   \func{connect}) e che pertanto non possono riportare \errcode{EAGAIN},
304   l'errore indica che l'operazione è stata avviata correttamente e occorrerà
305   del tempo perché si possa completare. La ripetizione della chiamata darebbe
306   luogo ad un errore \errcode{EALREADY}.
307 \item[\errcode{EINTR} \textit{Interrupted function call}.] Una funzione di
308   libreria è stata interrotta. In genere questo avviene causa di un segnale
309   asincrono al processo che impedisce la conclusione della chiamata, la
310   funzione ritorna con questo errore una volta che si sia correttamente
311   eseguito il gestore del segnale. In questo caso è necessario ripetere la
312   chiamata alla funzione.
313 \item[\errcode{EINVAL} \textit{Invalid argument}.] Errore utilizzato per
314   segnalare vari tipi di problemi dovuti all'aver passato un argomento
315   sbagliato ad una funzione di libreria.
316 \item[\errcode{ENOMEM} \textit{No memory available}.] Il kernel non è in grado
317   di allocare ulteriore memoria per completare l'operazione richiesta.
318 \item[\errcode{ENOSYS} \textit{Function not implemented}.] Indica che la
319   funzione non è supportata o nelle librerie del C o nel kernel. Può dipendere
320   sia dalla mancanza di una implementazione, che dal fatto che non si è
321   abilitato l'opportuno supporto nel kernel; nel caso di Linux questo può
322   voler dire anche che un modulo necessario non è stato caricato nel sistema.
323 \item[\errcode{ENOTSUP} \textit{Not supported}.] Una funzione ritorna questo
324   errore quando gli argomenti sono validi ma l'operazione richiesta non è
325   supportata. Questo significa che la funzione non implementa quel particolare
326   comando o opzione o che, in caso di oggetti specifici (file descriptor o
327   altro) non è in grado di supportare i parametri richiesti.
328 \item[\errcode{ERANGE} \textit{Range error}.] È usato dalle funzioni
329   matematiche quando il risultato dell'operazione non è rappresentabile nel
330   valore di ritorno a causa di un overflow o di un underflow.
331 \item[\errcode{EWOULDBLOCK} \textit{Operation would block}.] Indica che
332   l'operazione richiesta si bloccherebbe, ad esempio se si apre un file in
333   modalità non bloccante, una \func{read} restituirebbe questo errore per
334   indicare che non ci sono dati; in Linux è identico a \errcode{EAGAIN}, ma in
335   altri sistemi può essere specificato un valore diverso.
336 \end{basedescript}
337
338
339 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
340 % definiti nel manuale delle glibc ma inesistenti in linux/errno.h
341 %\item[\errcode{EBADRPC} \textit{}.] 
342 %\item[\errcode{ERPCMISMATCH} \textit{}.] 
343 %\item[\errcode{EPROGUNAVAIL} \textit{}.] 
344 %\item[\errcode{EPROGMISMATCH} \textit{}.] 
345 %\item[\errcode{EPROCUNAVAIL} \textit{}.] 
346 %\item[\errcode{EAUTH} \textit{}.] 
347 %\item[\errcode{ENEEDAUTH} \textit{}.] 
348 %\item[\errcode{EBACKGROUND} \textit{}.] 
349 %\item[\errcode{EDIED} \textit{}.] 
350 % questi sembrano scherzi, sempre dal manuale delle glibc...
351 %\item[\errcode{ED} \textit{}.] 
352 %\item[\errcode{EGREGIOUS} \textit{}.] 
353 %\item[\errcode{EIEIO} \textit{}.] 
354 %\item[\errcode{EGRATUITOUS} \textit{} roba di Hurd, pare. 
355
356
357 \item[\errcode{EBADMSG} \textit{Not a data message}.] Definito da POSIX come
358 errore che arriva ad una funzione di lettura che opera su uno stream. Non
359 essendo gli stream definiti su Linux il kernel non genera mai questo tipo di
360 messaggio. 
361
362 \item[\errcode{EIDRM} \textit{Identifier removed}.] Indica che l'oggetto del
363   \textit{SysV IPC} a cui si fa riferimento è stato cancellato.
364
365 \item[\errcode{EMULTIHOP} \textit{Multihop attempted}.] Definito da POSIX come
366   errore dovuto all'accesso a file remoti attraverso più macchine, quando ciò
367   non è consentito. Non viene mai generato su Linux.
368
369 \item[\errcode{ENOATTR} \textit{No such attribute}.] È un codice di errore
370   specifico di Linux utilizzato dalle funzioni per la gestione degli attributi
371   estesi dei file (vedi sez.~\ref{sec:file_xattr}) quando il nome
372   dell'attributo richiesto non viene trovato.
373
374 \item[\errcode{ENODATA} \textit{No data available}.] Viene indicato da POSIX
375   come restituito da una \func{read} eseguita su un file descriptor in
376   modalità non bloccante quando non ci sono dati. In realtà in questo caso su
377   Linux viene utilizzato \errcode{EAGAIN}. Lo stesso valore però viene usato
378   come sinonimo di \errcode{ENOATTR}.
379
380 \item[\errcode{ENOLINK} \textit{Link has been severed}.] È un errore il cui
381   valore è indicato come \textsl{riservato} nelle \textit{Single Unix
382     Specification}. Dovrebbe indicare l'impossibilità di accedere ad un file a
383   causa di un errore sul collegamento di rete, ma non ci sono indicazioni
384   precise del suo utilizzo. Per quanto riguarda Linux viene riportato nei
385   sorgenti del kernel in alcune operazioni relative ad operazioni di rete. 
386
387 \item[\errcode{ENOMSG} \textit{No message of desired type}.] Indica che in una
388   coda di messaggi del \textit{SysV IPC} non è presente nessun messaggio del
389   tipo desiderato.
390
391 \item[\errcode{ENOSR} \textit{Out of streams resources}.] Errore relativo agli
392   \textit{STREAMS}, che indica l'assenza di risorse sufficienti a completare
393   l'operazione richiesta. Quella degli \textit{STREAMS}\footnote{che non vanno
394     confusi con gli \textit{stream} di sez.~\ref{sec:files_std_interface}.}  è
395   interfaccia di programmazione originaria di System V, che non è implementata
396   da Linux, per cui questo errore non viene utilizzato.
397
398 \item[\errcode{ENOSTR} \textit{Device not a stream}.] Altro errore relativo
399   agli \textit{STREAMS}, anch'esso non utilizzato da Linux.
400
401 \item[\errcode{EOVERFLOW} \textit{Value too large for defined data type}.] Si è
402   chiesta la lettura di un dato dal \textit{SysV IPC} con \const{IPC\_STAT} ma
403   il valore eccede la dimensione usata nel buffer di lettura.
404
405 \item[\errcode{EPROTO} \textit{Protocol error}.] Indica che c'è stato un errore
406   nel protocollo di rete usato dal socket; viene usato come errore generico
407   dall'interfaccia degli \textit{STREAMS} quando non si è in grado di
408   specificare un altro codice di errore che esprima più accuratamente la
409   situazione.
410
411 \item[\errcode{ETIME} \textit{Timer expired}.] Indica che è avvenuto un timeout
412   nell'accesso ad una risorsa (ad esempio un semaforo). Compare nei sorgenti
413   del kernel (in particolare per le funzioni relativa al bus USB) come
414   indicazione di una mancata risposta di un dispositivo, con una descrizione
415   alternativa di \textit{Device did not respond}.
416 \end{basedescript}
417
418
419
420 % \section{Errori del kernel}
421 % \label{sec:err_kernel_err}
422
423 % In questa sezione sono raccolti i codici di errore interni del kernel. Non
424 % sono usati dalle funzioni di libreria, ma vengono riportati da alcune system
425 % call 
426 % TODO verificare i dettagli degli errori del kernel, eventualmente cassare.
427
428 % \begin{description}
429 % \item[\errcode{ERESTART} \textit{Interrupted system call should be restarted}.] 
430 % \item[\errcode{ECHRNG} \textit{Channel number out of range}.] 
431 % \item[\errcode{EL2NSYNC} \textit{Level 2 not synchronized}.] 
432 % \item[\errcode{EL3HLT} \textit{Level 3 halted}.] 
433 % \item[\errcode{EL3RST} \textit{Level 3 reset}.] 
434 % \item[\errcode{ELNRNG} \textit{Link number out of range}.] 
435 % \item[\errcode{EUNATCH} \textit{Protocol driver not attached}.] 
436 % \item[\errcode{ENOCSI} \textit{No CSI structure available}.] 
437 % \item[\errcode{EL2HLT} \textit{Level 2 halted}.] 
438 % \item[\errcode{EBADE} \textit{Invalid exchange}.] 
439 % \item[\errcode{EBADR} \textit{Invalid request descriptor}.] 
440 % \item[\errcode{EXFULL} \textit{Exchange full}.] 
441 % \item[\errcode{ENOANO} \textit{No anode}.] 
442 % \item[\errcode{EBADRQC} \textit{Invalid request code}.] 
443 % \item[\errcode{EBADSLT} \textit{Invalid slot}.] 
444 % \item[\errcode{EDEADLOCK} Identico a \errcode{EDEADLK}.] 
445 % \item[\errcode{EBFONT} \textit{Bad font file format}.] 
446 % \item[\errcode{ENONET} \textit{Machine is not on the network}.] 
447 % \item[\errcode{ENOPKG} \textit{Package not installed}.] 
448 % \item[\errcode{EADV} \textit{Advertise error}.] 
449 % \item[\errcode{ESRMNT} \textit{Srmount error}.] 
450 % \item[\errcode{ECOMM} \textit{Communication error on send}.] 
451 % \item[\errcode{EDOTDOT} \textit{RFS specific error}.] 
452 % \item[\errcode{ENOTUNIQ} \textit{Name not unique on network}.] 
453 % \item[\errcode{EBADFD} \textit{File descriptor in bad state}.] 
454 % \item[\errcode{EREMCHG} \textit{Remote address changed}.] 
455 % \item[\errcode{ELIBACC} \textit{Can not access a needed shared library}.] 
456 % \item[\errcode{ELIBBAD} \textit{Accessing a corrupted shared library}.] 
457 % \item[\errcode{ELIBSCN} \textit{.lib section in a.out corrupted}.] 
458 % \item[\errcode{ELIBMAX} \textit{Attempting to link in too many shared
459 %     libraries}.]
460 % \item[\errcode{ELIBEXEC} \textit{Cannot exec a shared library directly}.] 
461 % \item[\errcode{ESTRPIPE} \textit{Streams pipe error}.] 
462 % \item[\errcode{EUCLEAN} \textit{Structure needs cleaning}.] 
463 % \item[\errcode{ENAVAIL} \textit{No XENIX semaphores available}.] 
464 % \item[\errcode{EISNAM} \textit{Is a named type file}.] 
465 % \item[\errcode{EREMOTEIO} \textit{Remote I/O error}.] 
466 % \item[\errcode{ENOMEDIUM} \textit{No medium found}.] 
467 % \item[\errcode{EMEDIUMTYPE} \textit{Wrong medium type}.] 
468 % \end{description}
469
470
471 % LocalWords:  header errno perror int strerror sez EPERM Operation not ENOENT
472 % LocalWords:  permitted such pathname EIO error ENXIO device address kernel Is
473 % LocalWords:  ENOEXEC Invalid executable format exec EBADF Bad descriptor Too
474 % LocalWords:  EACCES Permission denied ELOOP many symbolic links encountered
475 % LocalWords:  ENAMETOOLONG name too long ENOTBLK Block required block EEXIST
476 % LocalWords:  exists EBUSY Resource busy filesystem EXDEV ENODEV ENOTDIR files
477 % LocalWords:  EISDIR EMFILE ulimit ENFILE table overflow ENOTTY ETXTBSY Text
478 % LocalWords:  EFBIG big ENOSPC left ESPIPE seek operation EROFS Read only read
479 % LocalWords:  system EMLINK EPIPE Broken SIGPIPE ENOTEMPTY empty EUSERS users
480 % LocalWords:  EDQUOT exceeded ESTALE NFS handle EREMOTE Object is ENOLCK locks
481 % LocalWords:  available locking EFTYPE type sticky ESRCH process matches the
482 % LocalWords:  specified pid Argument list POSIX ECHILD There child processes
483 % LocalWords:  socket ENOTSOCK EMSGSIZE Message EPROTOTYPE Protocol wrong for
484 % LocalWords:  ENOPROTOOPT EPROTONOSUPPORT supported ESOCKTNOSUPPORT EOPNOTSUPP
485 % LocalWords:  transport endpoint EPFNOSUPPORT family EAFNOSUPPORT protocol of
486 % LocalWords:  EADDRINUSE already bind EADDRNOTAVAIL Cannot assign requested to
487 % LocalWords:  ENETDOWN ENETUNREACH unreachable ENETRESET dropped connection
488 % LocalWords:  because reset l'host ECONNABORTED caused abort ECONNRESET peer
489 % LocalWords:  dell'host ENOBUFS ENOMEM EISCONN connected ENOTCONN UDP send now
490 % LocalWords:  EDESTADDRREQ Destination ESHUTDOWN after shutdown ETOOMANYREFS
491 % LocalWords:  references cannot splice glibc ETIMEDOUT timed ECONNREFUSED host
492 % LocalWords:  refused EHOSTDOWN EHOSTUNREACH route EINTR Interrupted function
493 % LocalWords:  call memory EDEADLK Deadlock avoided deadlock EFAULT segment IPC
494 % LocalWords:  violation SIGSEGV EINVAL argument EDOM Domain ERANGE underflow
495 % LocalWords:  EAGAIN temporarily unavailable EWOULDBLOCK select fork would has
496 % LocalWords:  EINPROGRESS progress connect EALREADY ENOSYS implemented ENOTSUP
497 % LocalWords:  EILSEQ Illegal sequence EBADMSG message EIDRM Identifier removed
498 % LocalWords:  SysV EMULTIHOP Multihop attempted ENODATA ENOLINK been severed
499 % LocalWords:  ENOMSG desired ENOSR streams resources ENOSTR stream EOVERFLOW
500 % LocalWords:  Value large defined STAT EPROTO ETIME Timer expired group wait
501 % LocalWords:  waitpid Specification cap USB did respond Stale
502
503
504 %%% Local Variables: 
505 %%% mode: latex
506 %%% TeX-master: "gapil"
507 %%% End: