Risistemata flock, aggiunta figura sulla struttura del sistema
[gapil.git] / errors.tex
1 \chapter{I codici di errore}
2 \label{cha:errors}
3
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
10 della funzione.
11
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.
18
19
20 \section{Gli errori dei file}
21 \label{sec:err_file_errors}
22
23 In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
24 attinenti ad errori che riguardano operazioni specifiche relative alla
25 gestione dei file.
26
27 \begin{description}
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
58   file ordinario).
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
77     \cmd{ulimit}.}.
78 \item \macro{ENFILE} \textit{File table overflow}. Ci sono troppi file aperti
79   nel sistema. 
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
104   dell'utente.
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
108   filesystem NFS.
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.
119 \end{description}
120
121
122
123 \section{Gli errori dei processi}
124 \label{sec:err_proc_errors}
125
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.
129
130 \begin{description}
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
139   figli. 
140 %\item \macro{EPROCLIM} \textit{}.  Il limite dell'utente per nuovi processi
141 %  sarà ecceduto alla prossima \func{fork}. (non credo esista in linux)
142 \end{description}
143
144
145 \section{Gli errori di rete}
146 \label{sec:err_network}
147
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.
151
152
153 \begin{description}
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
156   richiesto un socket.
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
164   protocollo usato.
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 è
178   supportata.
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
200   protocollo.
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
205   dell'altro.
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
219   shutdown.
220 \item \macro{ETOOMANYREFS} \textit{Too many references: cannot splice}. La
221   glibc dice ???
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
228   connessione è giù.
229 \item \macro{EHOSTUNREACH} \textit{No route to host}.  L'host remoto di una
230   connessione non è raggiungibile.
231 \end{description}
232
233 \section{Errori generici}
234
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.
238
239 \begin{description}
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}
252   (\macro{SIGSEGV}).
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
258   definite. 
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
261   underflow.
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:
265   \begin{itemize}
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)
271     diventa possibile.
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.
279   \end{itemize}
280 \item \macro{EWOULDBLOCK} \textit{Operation would block}. In Linux è identico
281   a \macro{EAGAIN}.
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.
303 \end{description}
304
305
306 \begin{description}
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}. 
331 \end{description}
332
333
334
335
336
337 \section{Errori del kernel}
338 \label{sec:err_kernel_err}
339
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).
343
344 \begin{description}
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{}. 
384 \end{description}
385
386
387
388 %%% Local Variables: 
389 %%% mode: latex
390 %%% TeX-master: "gapil"
391 %%% End: