Errori

[gapil.git] / errors.tex

\chapter{I codici di errore}
\label{cha:errors}

Si riportano in questa appendice tutti i codici di errore. Essi sono
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.

I codici di errore sono riportati come costanti di tipo \type{int}, i valori
delle costanti sono definiti da macro di preprocessore nel file citato, e
possono variare da architettura a architettura; è pertanto necessario
riferirsi ad essi tramite i nomi simbolici. Le funzioni \func{perror} e
\func{strerror} (vedi \secref{sec:intro_strerror}) possono essere usate per
ottenere dei messaggi di errore più espliciti.


\section{Gli errori dei file}
\label{sec:err_file_errors}

In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
attinenti ad errori che riguardano operazioni specifiche relative alla
gestione dei file.

\begin{description}
\item \macro{EPERM} \textit{Operation not permitted}. L'operazione non è
  permessa: solo il proprietario del file o un processo con sufficienti
  privilegi può eseguire l'operazione.
\item \macro{ENOENT} \textit{No such file or directory}. Il file indicato dal
  pathname non esiste: o una delle componenti non esiste o il pathname
  contiene un link simbolico spezzato. Errore tipico di un riferimento ad un
  file che si suppone erroneamente essere esistente.
\item \macro{EIO} \textit{Input/output error}. Errore di input/output: usato
  per riportare errori hardware in lettura/scrittura su un dispositivo.
\item \macro{ENXIO} \textit{No such device or address}. Device inesistente: il
  sistema ha tentato di usare un dispositivo attraverso il file specificato,
  ma non lo ha trovato. Può significare che il file di dispositivo non è
  corretto, che il modulo relativo non è stato caricato nel kernel, o che il
  dispositivo è fisicamente assente o non funzionante.
\item \macro{ENOEXEC} \textit{Invalid executable file format}. Il file non ha
  un formato eseguibile, è un errore riscontrato dalle funzioni \func{exec}.
\item \macro{EBADF} \textit{Bad file descriptor}. File descriptor non valido:
  si è usato un file descriptor inesistente, o aperto in sola lettura per
  scrivere, o viceversa, o si è cercato di eseguire un'operazione non
  consentita per quel tipo di file descriptor.
\item \macro{EACCESS} \textit{Permission denied}. Permesso negato; l'accesso
  al file non è consentito: i permessi del file o della directory non
  consentono l'operazione.
\item \macro{ELOOP} \textit{Too many symbolic links encountered}. Ci sono
  troppi link simbolici nella risoluzione di un pathname.  
\item \macro{ENAMETOOLONG} \textit{File name too long}. Si è indicato un
  pathname troppo lungo.
\item \macro{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
  file ordinario).
\item \macro{EEXIST} \textit{File exists}. Si è specficato un file esistente
  in un constesto in cui ha senso solo specificare un nuovo file.
\item \macro{EBUSY} \textit{Resource busy}. Una risorsa di sistema che non può
  essere condivisa è occupata. Ad esempio si è tentato di cancellare la
  directory su cui si è montato un filesistem. 
\item \macro{EXDEV} \textit{Cross-device link}. Si è tentato di creare un link
  diretto che attraversa due filesystem differenti.
\item \macro{ENODEV} \textit{No such device}. Si è indicato un tipo di device
  sbagliato ad una funzione che ne richiede uno specifico.
\item \macro{ENOTDIR} \textit{Not a directory}. Si è specificato un file che
  non è una directory in una operazione che richiede una directory.
\item \macro{EISDIR} \textit{Is a directory}. Il file specificato è una
  directory, non può essere aperto in scrittura, né si possono creare o
  rimuovere link diretti ad essa.
\item \macro{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 \macro{ENFILE} \textit{File table overflow}. Ci sono troppi file aperti
  nel sistema. 
\item \macro{ENOTTY} \textit{Not a terminal}. Si è tentata una operazione di
  controllo relativa ad un terminale su un file che non lo è.
\item \macro{ETXTBSY} \textit{Text file busy}. Si è cercato di eseguire un
  file che è aperto in scrittura, o scrivere un file che è in esecuzione. 
\item \macro{EFBIG} \textit{File too big}. Si è ecceduto il limite imposto dal
  sistema sulla dimensione massima che un file può avere.
\item \macro{ENOSPC} \textit{No space left on device}. la directory in cui si
  vuole creare il link non ha spazio per ulteriori voci.
\item \macro{ESPIPE} \textit{Invalid seek operation}. 
\item \macro{EROFS} \textit{Read-only file system}.  il file risiede su un filesystem read-only.
\item \macro{EMLINK} \textit{Too many links}. Ci sono troppi link al file (il
   numero massimo è specificato dalla variabile \macro{LINK\_MAX}, vedi
  \secref{sec:xxx_limits}).
\item \macro{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 \macro{SIGPIPE}, la cui azione di default è
  terminare il programma; pertanto non si potrà vedere questo errore fintanto
  che \macro{SIGPIPE} non viene gestito o bloccato.



\section{Gli errori dei processi}
\label{sec:err_proc_errors}

In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
attinenti ad errori che riguardano operazioni specifiche relative alla
gestione dei processi.

\begin{description}

\item \macro{ESRCH} \textit{No process matches the specified process ID}. Non
  esiste un processo con il \acr{pid} specificato.
\item \macro{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 \macro{ECHILD} \textit{There are no child processes}. Non esiste un
  processo figlio. Viene rilevato dalle funzioni per la gestione dei processi
  figli. 


\section{Gli errori di rete}
\label{sec:err_network}

In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
attinenti ad errori che riguardano operazioni specifiche relative alla
gestione dei socket e delle connessioni di rete.

\item \macro{EINPROGRESS} \textit{Operation now in progress}. 
\item \macro{EALREADY} \textit{Operation already in progress}. 
\item \macro{ENOTSOCK} \textit{Socket operation on non-socket}. 
\item \macro{EMSGSIZE} \textit{Message too long}. 
\item \macro{EPROTOTYPE} \textit{Protocol wrong type for socket}. 
\item \macro{ENOPROTOOPT} \textit{Protocol not available}. 
\item \macro{EPROTONOSUPPORT} \textit{Protocol not supported}. 
\item \macro{ESOCKTNOSUPPORT} \textit{Socket type not supported}. 
\item \macro{EOPNOTSUPP} \textit{Operation not supported on transport endpoint}. 
\item \macro{EPFNOSUPPORT} \textit{Protocol family not supported}. 
\item \macro{EAFNOSUPPORT} \textit{Address family not supported by protocol}. 
\item \macro{EADDRINUSE} \textit{Address already in use}. 
\item \macro{EADDRNOTAVAIL} \textit{Cannot assign requested address}. 
\item \macro{ENETDOWN} \textit{Network is down}. 
\item \macro{ENETUNREACH} \textit{Network is unreachable}. 
\item \macro{ENETRESET} \textit{Network dropped connection because of reset}. 
\item \macro{ECONNABORTED} \textit{Software caused connection abort}. 
\item \macro{ECONNRESET} \textit{Connection reset by peer}. 
\item \macro{ENOBUFS} \textit{No buffer space available}. 
\item \macro{EISCONN} \textit{Transport endpoint is already connected}. 
\item \macro{ENOTCONN} \textit{Transport endpoint is not connected}. 
\item \macro{EDESTADDRREQ} \textit{Destination address required}. 
\item \macro{ESHUTDOWN} \textit{Cannot send after transport endpoint shutdown}. 
\item \macro{ETOOMANYREFS} \textit{Too many references: cannot splice}. 
\item \macro{ETIMEDOUT} \textit{Connection timed out}. 
\item \macro{ECONNREFUSED} \textit{Connection refused}. 
  
\item \macro{EHOSTDOWN} \textit{Host is down}. 
\item \macro{EHOSTUNREACH} \textit{No route to host}. 
\item \macro{ENOTEMPTY} \textit{Directory not empty}. 
\item \macro{EPROCLIM} \textit{}. 
\item \macro{EUSERS} \textit{Too many users}. 
\item \macro{EDQUOT} \textit{Quota exceeded}. 
\item \macro{ESTALE} \textit{Stale NFS file handle}. 
\item \macro{EREMOTE} \textit{Object is remote}. 
%\item \macro{EBADRPC} \textit{}. 
%\item \macro{ERPCMISMATCH} \textit{}. 
%\item \macro{EPROGUNAVAIL} \textit{}. 
%\item \macro{EPROGMISMATCH} \textit{}. 
%\item \macro{EPROCUNAVAIL} \textit{}. 
\item \macro{ENOLCK} \textit{No locks available}. 
\item \macro{EFTYPE} \textit{Inappropriate file type or format}. 
%\item \macro{EAUTH} \textit{}. 
\item \macro{ENEEDAUTH} \textit{}. 
\item \macro{ENOSYS} \textit{Function not implemented}. 
\item \macro{ENOTSUP} \textit{Not supported}. 
\item \macro{EILSEQ} \textit{Illegal byte sequence}. 
%\item \macro{EBACKGROUND} \textit{}. 
%\item \macro{EDIED} \textit{}. 
%\item \macro{ED} \textit{}. 
%\item \macro{EGREGIOUS} \textit{}. 
%\item \macro{EIEIO} \textit{}. 
%\item \macro{EGRATUITOUS} \textit{}. 
\item \macro{EBADMSG} \textit{Not a data message}. 
\item \macro{EIDRM} \textit{Identifier removed}. 
\item \macro{EMULTIHOP} \textit{Multihop attempted}. 
\item \macro{ENODATA} \textit{No data available}. 
\item \macro{ENOLINK} \textit{Link has been severed}. 
\item \macro{ENOMSG} \textit{No message of desired type}. 
\item \macro{ENOSR} \textit{Out of streams resources}. 
\item \macro{ENOSTR} \textit{Device not a stream}. 
\item \macro{EOVERFLOW} \textit{Value too large for defined data type}. 
\item \macro{EPROTO} \textit{Protocol error}. 
\item \macro{ETIME} \textit{Timer expired}. 


\section{Errori generici}

In questa sezione sono raccolti i codici restituiti dalle funzioni di libreria
attinenti ad errori generici, si trovano qui tutti i cosici di errore non
specificati nelle sezioni precedenti.

\item \macro{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. 
\item \macro{ENOMEM} \textit{No memory available}. Il kernel non è in grado di
  allocare ulteriore memoria per completare l'operazione richiesta.
\item \macro{EDEADLK} \textit{Deadlock avoided}. L'allocazione di una risorsa
  avrebbe causato un deadlock. Non sempre il sistema è in grado di riconoscere
  queste situazioni, nel qual caso si avrebbe in blocco. 
\item \macro{EFAULT} \textit{Bad address}. Una stringa passata come parametro
  è fuori dello spazio di indirizzi del processo, in genere questa situazione
  provoca l'emissione di un sengale di \textit{segment violation}
  (\macro{SIGSEGV}).
\item \macro{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 \macro{EDOM} \textit{Domain error}. È usato dalle funzioni matematiche
  quando il valore di un argomento è al di fuori dell'intervallo in cui sono
  definite. 
\item \macro{ERANGE} \textit{Range error}. È usato dalle funzioni matematiche
  quando il risultato non è rappresentabile a causa di un overflow o di un
  underflow.
\item \macro{EAGAIN} \textit{Resource temporarily unavailable}. La funzione è
  fallita ma potrebbe funzionare se riprovata. 
\item \macro{EWOULDBLOCK} \textit{Operation would block}. In Linux è identico
  a \macro{EAGAIN}.
\end{description}



\section{Errori del kernel}
\label{sec:err_kernel_err}

In questa sezione sono raccolti i codici di errore interni del kernel. Non
sono usati dalle funzioni di libreria, ma vengono riportati da alcune system
call (TODO verificare i dettagli, eventualmente cassare).

\item \macro{ERESTART} \textit{Interrupted system call should be restarted}. 
\item \macro{ECHRNG} \textit{Channel number out of range}. 
\item \macro{EL2NSYNC} \textit{Level 2 not synchronized}. 
\item \macro{EL3HLT} \textit{Level 3 halted}. 
\item \macro{EL3RST} \textit{Level 3 reset}. 
\item \macro{ELNRNG} \textit{Link number out of range}. 
\item \macro{EUNATCH} \textit{Protocol driver not attached}. 
\item \macro{ENOCSI} \textit{No CSI structure available}. 
\item \macro{EL2HLT} \textit{Level 2 halted}. 
\item \macro{EBADE} \textit{Invalid exchange}. 
\item \macro{EBADR} \textit{Invalid request descriptor}. 
\item \macro{EXFULL} \textit{Exchange full}. 
\item \macro{ENOANO} \textit{No anode}. 
\item \macro{EBADRQC} \textit{Invalid request code}. 
\item \macro{EBADSLT} \textit{Invalid slot}. 
\item \macro{EDEADLOCK} Identico a \macro{EDEADLK}. 
\item \macro{EBFONT} \textit{Bad font file format}. 
\item \macro{ENONET} \textit{Machine is not on the network}. 
\item \macro{ENOPKG} \textit{Package not installed}. 
\item \macro{EADV} \textit{Advertise error}. 
\item \macro{ESRMNT} \textit{Srmount error}. 
\item \macro{ECOMM} \textit{Communication error on send}. 
\item \macro{EDOTDOT} \textit{RFS specific error}. 
\item \macro{ENOTUNIQ} \textit{Name not unique on network}. 
\item \macro{EBADFD} \textit{File descriptor in bad state}. 
\item \macro{EREMCHG} \textit{Remote address changed}. 
\item \macro{ELIBACC} \textit{Can not access a needed shared library}. 
\item \macro{ELIBBAD} \textit{Accessing a corrupted shared library}. 
\item \macro{ELIBSCN} \textit{.lib section in a.out corrupted}. 
\item \macro{ELIBMAX} \textit{Attempting to link in too many shared libraries}. 
\item \macro{ELIBEXEC} \textit{Cannot exec a shared library directly}. 
\item \macro{ESTRPIPE} \textit{Streams pipe error}. 
\item \macro{EUCLEAN} \textit{Structure needs cleaning}. 
\item \macro{ENAVAIL} \textit{No XENIX semaphores available}. 
\item \macro{EISNAM} \textit{Is a named type file}. 
\item \macro{EREMOTEIO} \textit{Remote I/O error}. 
\item \macro{ENOMEDIUM} \textit{No medium found}. 
\item \macro{EMEDIUMTYPE} \textit{Wrong medium type}. 
\item \macro{} \textit{}. 
\end{description}