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
-ottene dei messaggi di errore.
+ottenere dei messaggi di errore più espliciti.
\section{Gli errori dei file}
\label{sec:err_file_errors}
-In questa sezione riassumeremo gli errori restituiti dalle funzioni di
-libreria che operano sui file.
+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.
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{ENOMEM} \textit{No memory available}. Il kernel non è in grado di
- allocare ulteriore memoria per completare l'operazione richiesta.
\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.
troppi link simbolici nella risoluzione di un pathname.
\item \macro{ENAMETOOLONG} \textit{File name too long}. Si è indicato un
pathname troppo lungo.
-\item \macro{EEXIST} \textit{File exists}.
-\item \macro{ENODEV} \textit{No such device}.
-\item \macro{ENOTDIR} \textit{Not a directory}. Un componente del pathname non
- è una directory.
-\item \macro{EISDIR} \textit{Is a directory}.
-\item \macro{EINVAL} \textit{Invalid argument}.
-\item \macro{EMFILE} \textit{Too many open files}.
-\item \macro{ENFILE} \textit{File table overflow}.
-\item \macro{ENOTTY} \textit{Not a terminal}.
-\item \macro{ETXTBSY} \textit{Text file busy}.
-\item \macro{EFBIG} \textit{File too big}.
+\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{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}.
+\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 riassumeremo gli errori restituiti dalle funzioni di
-libreria che operano sui processi.
+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{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{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,
\item \macro{ECHILD} \textit{There are no child processes}. Non esiste un
processo figlio. Viene rilevato dalle funzioni per la gestione dei processi
figli.
-\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
- provova.
-
-
\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{EXDEV} \textit{Cross-device link}.
-\item \macro{ENOTBLK} \textit{}.
-\item \macro{EBUSY} \textit{Resource busy}.
-\item \macro{EDOM} \textit{Domain error}.
-\item \macro{ERANGE} \textit{Range error}.
-\item \macro{EAGAIN} \textit{Resource temporarily unavailable}.
-\item \macro{EWOULDBLOCK} \textit{Operation would block}. In Linux è identico
- a \macro{EAGAIN}.
\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{EUSERS} \textit{Too many users}.
\item \macro{EDQUOT} \textit{Quota exceeded}.
\item \macro{ESTALE} \textit{Stale NFS file handle}.
-\item \macro{EREMOTE} \textit{}.
-\item \macro{EBADRPC} \textit{}.
-\item \macro{ERPCMISMATCH} \textit{}.
-\item \macro{EPROGUNAVAIL} \textit{}.
-\item \macro{EPROGMISMATCH} \textit{}.
-\item \macro{EPROCUNAVAIL} \textit{}.
+\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{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{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{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{ENOMEDIUM} \textit{No medium found}.
\item \macro{EMEDIUMTYPE} \textit{Wrong medium type}.
\item \macro{} \textit{}.
-
-
-\end{description}
-
-
-
-\section{Altri errori}
-\label{sec:err_others}
-
-
-
-
\end{description}