1 \chapter{I codici di errore}
4 Si riportano in questa appendice tutti i codici di errore. Essi sono
5 accessibili attraverso l'inclusione del file di header \file{errno.h}, che
6 definisce anche la variabile globale \var{errno}. Per ogni errore definito
7 riporteremo la stringa stampata da \func{perror} ed una breve spiegazione. Si
8 tenga presente che spiegazioni più particolareggiate, qualora necessarie per
9 il caso specifico, possono essere trovate nella descrizione del prototipo
12 I codici di errore sono riportati come costanti di tipo \ctyp{int}, i valori
13 delle costanti sono definiti da macro di preprocessore nel file citato, e
14 possono variare da architettura a architettura; è pertanto necessario
15 riferirsi ad essi tramite i nomi simbolici. Le funzioni \func{perror} e
16 \func{strerror} (vedi \secref{sec:sys_strerror}) possono essere usate per
17 ottenere dei messaggi di errore più espliciti.
20 \section{Gli errori dei file}
21 \label{sec:err_file_errors}
23 In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
24 attinenti ad errori che riguardano operazioni specifiche relative alla
28 \item \macro{EPERM} \textit{Operation not permitted}. L'operazione non è
29 permessa: solo il proprietario del file o un processo con sufficienti
30 privilegi può eseguire l'operazione.
31 \item \macro{ENOENT} \textit{No such file or directory}. Il file indicato dal
32 pathname non esiste: o una delle componenti non esiste o il pathname
33 contiene un link simbolico spezzato. Errore tipico di un riferimento ad un
34 file che si suppone erroneamente essere esistente.
35 \item \macro{EIO} \textit{Input/output error}. Errore di input/output: usato
36 per riportare errori hardware in lettura/scrittura su un dispositivo.
37 \item \macro{ENXIO} \textit{No such device or address}. Device inesistente: il
38 sistema ha tentato di usare un dispositivo attraverso il file specificato,
39 ma non lo ha trovato. Può significare che il file di dispositivo non è
40 corretto, che il modulo relativo non è stato caricato nel kernel, o che il
41 dispositivo è fisicamente assente o non funzionante.
42 \item \macro{ENOEXEC} \textit{Invalid executable file format}. Il file non ha
43 un formato eseguibile, è un errore riscontrato dalle funzioni \func{exec}.
44 \item \macro{EBADF} \textit{Bad file descriptor}. File descriptor non valido:
45 si è usato un file descriptor inesistente, o aperto in sola lettura per
46 scrivere, o viceversa, o si è cercato di eseguire un'operazione non
47 consentita per quel tipo di file descriptor.
48 \item \macro{EACCESS} \textit{Permission denied}. Permesso negato; l'accesso
49 al file non è consentito: i permessi del file o della directory non
50 consentono l'operazione.
51 \item \macro{ELOOP} \textit{Too many symbolic links encountered}. Ci sono
52 troppi link simbolici nella risoluzione di un pathname.
53 \item \macro{ENAMETOOLONG} \textit{File name too long}. Si è indicato un
54 pathname troppo lungo.
55 \item \macro{ENOTBLK} \textit{Block device required}. Si è specificato un file
56 che non è un \textit{block device} in un contesto in cui era necessario
57 specificare un \textit{block device} (ad esempio si è tentato di montare un
59 \item \macro{EEXIST} \textit{File exists}. Si è specificato un file esistente
60 in un contesto in cui ha senso solo specificare un nuovo file.
61 \item \macro{EBUSY} \textit{Resource busy}. Una risorsa di sistema che non può
62 essere condivisa è occupata. Ad esempio si è tentato di cancellare la
63 directory su cui si è montato un filesystem.
64 \item \macro{EXDEV} \textit{Cross-device link}. Si è tentato di creare un link
65 diretto che attraversa due filesystem differenti.
66 \item \macro{ENODEV} \textit{No such device}. Si è indicato un tipo di device
67 sbagliato ad una funzione che ne richiede uno specifico.
68 \item \macro{ENOTDIR} \textit{Not a directory}. Si è specificato un file che
69 non è una directory in una operazione che richiede una directory.
70 \item \macro{EISDIR} \textit{Is a directory}. Il file specificato è una
71 directory, non può essere aperto in scrittura, né si possono creare o
72 rimuovere link diretti ad essa.
73 \item \macro{EMFILE} \textit{Too many open files}. Il processo corrente ha
74 troppi file aperti e non può aprirne altri. Anche i descrittori duplicati
75 vengono tenuti in conto\footnote{Il numero massimo di file aperti è
76 controllabile dal sistema, in Linux si può usare il comando
78 \item \macro{ENFILE} \textit{File table overflow}. Ci sono troppi file aperti
80 \item \macro{ENOTTY} \textit{Not a terminal}. Si è tentata una operazione di
81 controllo relativa ad un terminale su un file che non lo è.
82 \item \macro{ETXTBSY} \textit{Text file busy}. Si è cercato di eseguire un
83 file che è aperto in scrittura, o scrivere un file che è in esecuzione.
84 \item \macro{EFBIG} \textit{File too big}. Si è ecceduto il limite imposto dal
85 sistema sulla dimensione massima che un file può avere.
86 \item \macro{ENOSPC} \textit{No space left on device}. la directory in cui si
87 vuole creare il link non ha spazio per ulteriori voci.
88 \item \macro{ESPIPE} \textit{Invalid seek operation}.
89 \item \macro{EROFS} \textit{Read-only file system}. il file risiede su un filesystem read-only.
90 \item \macro{EMLINK} \textit{Too many links}. Ci sono troppi link al file (il
91 numero massimo è specificato dalla variabile \macro{LINK\_MAX}, vedi
92 \secref{sec:sys_limits}).
93 \item \macro{EPIPE} \textit{Broken pipe}. Non c'è un processo che stia
94 leggendo l'altro capo della pipe. Ogni funzione che restituisce questo
95 errore genera anche un segnale \macro{SIGPIPE}, la cui azione predefinita è
96 terminare il programma; pertanto non si potrà vedere questo errore fintanto
97 che \macro{SIGPIPE} non viene gestito o bloccato.
98 \item \macro{ENOTEMPTY} \textit{Directory not empty}. La directory non è vuota
99 quando l'operazione richiede che lo sia. È l'errore tipico che si ha quando
100 si cerca di cancellare una directory contenente dei file.
101 \item \macro{EUSERS} \textit{Too many users}. Troppi utenti, il sistema delle
102 quote rileva troppi utenti nel sistema.
103 \item \macro{EDQUOT} \textit{Quota exceeded}. Si è ecceduta la quota di disco
105 \item \macro{ESTALE} \textit{Stale NFS file handle}. Indica un problema
106 interno a NFS causato da cambiamenti del filesystem del sistema remoto. Per
107 recuperare questa condizione in genere è necessario smontare e rimontare il
109 \item \macro{EREMOTE} \textit{Object is remote}. Si è fatto un tentativo di
110 montare via NFS un filesystem remoto con un nome che già specifica un
111 filesystem montato via NFS.
112 \item \macro{ENOLCK} \textit{No locks available}. È usato dalle utilità per la
113 gestione del file lock; non viene generato da un sistema GNU, ma può
114 risultare da un'operazione su un server NFS di un altro sistema.
115 \item \macro{EFTYPE} \textit{Inappropriate file type or format}. Il file è di
116 tipo sbagliato rispetto all'operazione richiesta o un file di dati ha un
117 formato sbagliato. Alcuni sistemi restituiscono questo errore quando si
118 cerca di impostare lo \textit{sticky bit} su un file che non è una directory.
123 \section{Gli errori dei processi}
124 \label{sec:err_proc_errors}
126 In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
127 attinenti ad errori che riguardano operazioni specifiche relative alla
128 gestione dei processi.
131 \item \macro{ESRCH} \textit{No process matches the specified process ID}. Non
132 esiste un processo con il \acr{pid} specificato.
133 \item \macro{E2BIG} \textit{Argument list too long}. Lista degli argomenti
134 troppo lunga: è una condizione prevista da POSIX quando la lista degli
135 argomenti passata ad una delle funzioni \func{exec} occupa troppa memoria,
136 non può mai accadere in GNU/Linux.
137 \item \macro{ECHILD} \textit{There are no child processes}. Non esiste un
138 processo figlio. Viene rilevato dalle funzioni per la gestione dei processi
140 %\item \macro{EPROCLIM} \textit{}. Il limite dell'utente per nuovi processi
141 % sarà ecceduto alla prossima \func{fork}. (non credo esista in linux)
145 \section{Gli errori di rete}
146 \label{sec:err_network}
148 In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
149 attinenti ad errori che riguardano operazioni specifiche relative alla
150 gestione dei socket e delle connessioni di rete.
154 \item \macro{ENOTSOCK} \textit{Socket operation on non-socket}. Si è tentata
155 un'operazione su un file descriptor che non è un socket quando invece era
157 \item \macro{EMSGSIZE} \textit{Message too long}. Le dimensioni di un
158 messaggio inviato su un socket sono eccedono la massima lunghezza supportata.
159 \item \macro{EPROTOTYPE} \textit{Protocol wrong type for socket}. Protocollo
160 sbagliato per il socket. Il socket usato non supporta il protocollo di
161 comunicazione richiesto.
162 \item \macro{ENOPROTOOPT} \textit{Protocol not available}. Protocollo non
163 disponibile. Si è richiesta un'opzione per il socket non disponibile con il
165 \item \macro{EPROTONOSUPPORT} \textit{Protocol not supported}. Protocollo non
166 supportato. Il tipo di socket non supporta il protocollo richiesto (un
167 probabile errore nella specificazione del protocollo).
168 \item \macro{ESOCKTNOSUPPORT} \textit{Socket type not supported}. Socket non
169 supportato. Il tipo di socket scelto non è supportato.
170 \item \macro{EOPNOTSUPP} \textit{Operation not supported on transport
171 endpoint}. L'operazione richiesta non è supportata. Alcune funzioni non
172 hanno senso per tutti i tipi di socket, ed altre non sono implementate per
173 tutti i protocolli di trasmissione. Questo errore quando un socket non
174 supporta una particolare operazione, e costituisce una indicazione generica
175 che il server non sa cosa fare per la chiamata effettuata.
176 \item \macro{EPFNOSUPPORT} \textit{Protocol family not supported}. Famiglia di
177 protocolli non supportata. La famiglia di protocolli richiesta non è
179 \item \macro{EAFNOSUPPORT} \textit{Address family not supported by protocol}.
180 Famiglia di indirizzi non supportata. La famiglia di indirizzi richiesta non
181 è supportata, o è inconsistente con il protocollo usato dal socket.
182 \item \macro{EADDRINUSE} \textit{Address already in use}. L'indirizzo del
183 socket richiesto è gia utilizzato (ad esempio si è richiesto il \func{bind}
184 per una porta già in uso).
185 \item \macro{EADDRNOTAVAIL} \textit{Cannot assign requested address}.
186 L'indirizzo richiesto non è disponibile (ad esempio si è cercato di dare al
187 socket un nome che non corrisponde al nome della stazione locale).
188 \item \macro{ENETDOWN} \textit{Network is down}. L'operazione sul socket è
189 fallita perché la rete è sconnessa.
190 \item \macro{ENETUNREACH} \textit{Network is unreachable}. L'operazione è
191 fallita perché l'indirizzo richiesto è irraggiungibile (ad esempio la
192 sottorete della stazione remota è irraggiungibile).
193 \item \macro{ENETRESET} \textit{Network dropped connection because of reset}.
194 Una connessione è stata cancellata perché l'host remoto è caduto.
195 \item \macro{ECONNABORTED} \textit{Software caused connection abort}. Una
196 connessione è stata abortita localmente.
197 \item \macro{ECONNRESET} \textit{Connection reset by peer}. Una connessione è
198 stata chiusa per ragioni fuori dal controllo dell'host locale, come il
199 riavvio di una macchina remota o un qualche errore non recuperabile sul
201 \item \macro{ENOBUFS} \textit{No buffer space available}. Tutti i buffer per
202 le operazioni di I/O del kernel sono occupati. In generale questo errore è
203 sinonimo di \macro{ENOMEM}, ma attiene alle funzioni di input/output. In
204 caso di operazioni sulla rete si può ottenere questo errore invece
206 \item \macro{EISCONN} \textit{Transport endpoint is already connected}. Si è
207 tentato di connettere un socket che è gia connesso.
208 \item \macro{ENOTCONN} \textit{Transport endpoint is not connected}. Il socket
209 non è connesso a niente. Si ottiene questo errore quando si cerca di
210 trasmettere dati su un socket senza avere specificato in precedenza la loro
211 destinazione. Nel caso di socket senza connessione (ad esempio socket UDP)
212 l'errore che si ottiene è \macro{EDESTADDRREQ}.
213 \item \macro{EDESTADDRREQ} \textit{Destination address required}. Non c'è un
214 indirizzo di destinazione predefinito per il socket. Si ottiene questo
215 errore mandando dato su un socket senza connessione senza averne prima
216 specificato una destinazione.
217 \item \macro{ESHUTDOWN} \textit{Cannot send after transport endpoint
218 shutdown}. Il socket su cui si cerca di inviare dei dati ha avuto uno
220 \item \macro{ETOOMANYREFS} \textit{Too many references: cannot splice}. La
222 \item \macro{ETIMEDOUT} \textit{Connection timed out}. Un'operazione sul
223 socket non ha avuto risposta entro il periodo di timeout.
224 \item \macro{ECONNREFUSED} \textit{Connection refused}. Un host remoto ha
225 rifiutato la connessione (in genere dipende dal fatto che non c'è un server
226 per soddisfare il servizio richiesto).
227 \item \macro{EHOSTDOWN} \textit{Host is down}. L'host remoto di una
229 \item \macro{EHOSTUNREACH} \textit{No route to host}. L'host remoto di una
230 connessione non è raggiungibile.
233 \section{Errori generici}
235 In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
236 attinenti ad errori generici, si trovano qui tutti i codici di errore non
237 specificati nelle sezioni precedenti.
240 \item \macro{EINTR} \textit{Interrupted function call}. Una funzione di
241 libreria è stata interrotta. In genere questo avviene causa di un segnale
242 asincrono al processo che impedisce la conclusione della chiamata. In questo
243 caso è necessario ripetere la chiamata alla funzione.
244 \item \macro{ENOMEM} \textit{No memory available}. Il kernel non è in grado di
245 allocare ulteriore memoria per completare l'operazione richiesta.
246 \item \macro{EDEADLK} \textit{Deadlock avoided}. L'allocazione di una risorsa
247 avrebbe causato un deadlock. Non sempre il sistema è in grado di riconoscere
248 queste situazioni, nel qual caso si avrebbe in blocco.
249 \item \macro{EFAULT} \textit{Bad address}. Una stringa passata come parametro
250 è fuori dello spazio di indirizzi del processo, in genere questa situazione
251 provoca l'emissione di un segnale di \textit{segment violation}
253 \item \macro{EINVAL} \textit{Invalid argument}. Errore utilizzato per
254 segnalare vari tipi di problemi dovuti all'aver passato un argomento
255 sbagliato ad una funzione di libreria.
256 \item \macro{EDOM} \textit{Domain error}. È usato dalle funzioni matematiche
257 quando il valore di un argomento è al di fuori dell'intervallo in cui sono
259 \item \macro{ERANGE} \textit{Range error}. È usato dalle funzioni matematiche
260 quando il risultato non è rappresentabile a causa di un overflow o di un
262 \item \macro{EAGAIN} \textit{Resource temporarily unavailable}. La funzione è
263 fallita ma potrebbe funzionare se la chiamata fosse ripetuta. Questo errore
264 accade in due tipologie di situazioni:
266 \item Si è effettuata un'operazione che si sarebbe bloccata su un oggetto
267 che è stato posto in modalità non bloccante. Nei vecchi sistemi questo era
268 un codice diverso, \macro{EWOULDBLOCK}. In genere questo ha a che fare con
269 file o socket, per i quali si può usare la funzione \func{select} per
270 vedere quando l'operazione richiesta (lettura, scrittura o connessione)
272 \item Indica la carenza di una risorsa di sistema che non è al momento
273 disponibile (ad esempio \func{fork} può fallire con questo errore se si è
274 esaurito il numero di processi contemporanei disponibili). La ripetizione
275 della chiamata in un periodo successivo, in cui la carenza della risorsa
276 richiesta può essersi attenuata, può avere successo. Questo tipo di
277 carenza è spesso indice di qualcosa che non va nel sistema, è pertanto
278 opportuno segnalare esplicitamente questo tipo di errori.
280 \item \macro{EWOULDBLOCK} \textit{Operation would block}. In Linux è identico
282 \item \macro{EINPROGRESS} \textit{Operation now in progress}. Operazione in
283 corso. Un'operazione che non può essere completata immediatamente è stata
284 avviata su un oggetto posto in modalità non-bloccante. Questo errore viene
285 riportato per operazioni che si dovrebbero sempre bloccare (come per una
286 \func{connect}) e che pertanto non possono riportare \macro{EAGAIN},
287 l'errore indica che l'operazione è stata avviata correttamente e occorrerà
288 del tempo perché si possa completare. La ripetizione della chiamata darebbe
289 luogo ad un errore \macro{EALREADY}.
290 \item \macro{EALREADY} \textit{Operation already in progress}. L'operazione è
291 già in corso. Si è tentata un'operazione già in corso su un oggetto posto in
292 modalità non-bloccante.
293 \item \macro{ENOSYS} \textit{Function not implemented}. Indica che la funzione
294 non è implementata o nelle librerie del C o nel kernel.
295 \item \macro{ENOTSUP} \textit{Not supported}. Una funzione ritorna questo
296 errore quando i parametri sono validi ma l'operazione richiesta non è
297 supportata. Questo significa che la funzione non implementa quel particolare
298 comando o opzione o che, in caso di oggetti specifici (file descriptor o
299 altro) non è in grado di supportare i parametri richiesti.
300 \item \macro{EILSEQ} \textit{Illegal byte sequence}. Nella decodifica di un
301 carattere multibyte si è avuta una sequenza errata o incompleta o si è
302 specificato un valore non valido.
307 %\item \macro{EBADRPC} \textit{}.
308 %\item \macro{ERPCMISMATCH} \textit{}.
309 %\item \macro{EPROGUNAVAIL} \textit{}.
310 %\item \macro{EPROGMISMATCH} \textit{}.
311 %\item \macro{EPROCUNAVAIL} \textit{}.
312 %\item \macro{EAUTH} \textit{}.
313 %\item \macro{ENEEDAUTH} \textit{}.
314 %\item \macro{EBACKGROUND} \textit{}.
315 %\item \macro{EDIED} \textit{}.
316 %\item \macro{ED} \textit{}.
317 %\item \macro{EGREGIOUS} \textit{}.
318 %\item \macro{EIEIO} \textit{}.
319 %\item \macro{EGRATUITOUS} \textit{}.
320 \item \macro{EBADMSG} \textit{Not a data message}.
321 \item \macro{EIDRM} \textit{Identifier removed}.
322 \item \macro{EMULTIHOP} \textit{Multihop attempted}.
323 \item \macro{ENODATA} \textit{No data available}.
324 \item \macro{ENOLINK} \textit{Link has been severed}.
325 \item \macro{ENOMSG} \textit{No message of desired type}.
326 \item \macro{ENOSR} \textit{Out of streams resources}.
327 \item \macro{ENOSTR} \textit{Device not a stream}.
328 \item \macro{EOVERFLOW} \textit{Value too large for defined data type}.
329 \item \macro{EPROTO} \textit{Protocol error}.
330 \item \macro{ETIME} \textit{Timer expired}.
337 \section{Errori del kernel}
338 \label{sec:err_kernel_err}
340 In questa sezione sono raccolti i codici di errore interni del kernel. Non
341 sono usati dalle funzioni di libreria, ma vengono riportati da alcune system
342 call (TODO verificare i dettagli, eventualmente cassare).
345 \item \macro{ERESTART} \textit{Interrupted system call should be restarted}.
346 \item \macro{ECHRNG} \textit{Channel number out of range}.
347 \item \macro{EL2NSYNC} \textit{Level 2 not synchronized}.
348 \item \macro{EL3HLT} \textit{Level 3 halted}.
349 \item \macro{EL3RST} \textit{Level 3 reset}.
350 \item \macro{ELNRNG} \textit{Link number out of range}.
351 \item \macro{EUNATCH} \textit{Protocol driver not attached}.
352 \item \macro{ENOCSI} \textit{No CSI structure available}.
353 \item \macro{EL2HLT} \textit{Level 2 halted}.
354 \item \macro{EBADE} \textit{Invalid exchange}.
355 \item \macro{EBADR} \textit{Invalid request descriptor}.
356 \item \macro{EXFULL} \textit{Exchange full}.
357 \item \macro{ENOANO} \textit{No anode}.
358 \item \macro{EBADRQC} \textit{Invalid request code}.
359 \item \macro{EBADSLT} \textit{Invalid slot}.
360 \item \macro{EDEADLOCK} Identico a \macro{EDEADLK}.
361 \item \macro{EBFONT} \textit{Bad font file format}.
362 \item \macro{ENONET} \textit{Machine is not on the network}.
363 \item \macro{ENOPKG} \textit{Package not installed}.
364 \item \macro{EADV} \textit{Advertise error}.
365 \item \macro{ESRMNT} \textit{Srmount error}.
366 \item \macro{ECOMM} \textit{Communication error on send}.
367 \item \macro{EDOTDOT} \textit{RFS specific error}.
368 \item \macro{ENOTUNIQ} \textit{Name not unique on network}.
369 \item \macro{EBADFD} \textit{File descriptor in bad state}.
370 \item \macro{EREMCHG} \textit{Remote address changed}.
371 \item \macro{ELIBACC} \textit{Can not access a needed shared library}.
372 \item \macro{ELIBBAD} \textit{Accessing a corrupted shared library}.
373 \item \macro{ELIBSCN} \textit{.lib section in a.out corrupted}.
374 \item \macro{ELIBMAX} \textit{Attempting to link in too many shared libraries}.
375 \item \macro{ELIBEXEC} \textit{Cannot exec a shared library directly}.
376 \item \macro{ESTRPIPE} \textit{Streams pipe error}.
377 \item \macro{EUCLEAN} \textit{Structure needs cleaning}.
378 \item \macro{ENAVAIL} \textit{No XENIX semaphores available}.
379 \item \macro{EISNAM} \textit{Is a named type file}.
380 \item \macro{EREMOTEIO} \textit{Remote I/O error}.
381 \item \macro{ENOMEDIUM} \textit{No medium found}.
382 \item \macro{EMEDIUMTYPE} \textit{Wrong medium type}.
383 \item \macro{} \textit{}.
390 %%% TeX-master: "gapil"