X-Git-Url: https://gapil.gnulinux.it/gitweb/?p=gapil.git;a=blobdiff_plain;f=errors.tex;h=d560842c013f5b9afc4c10cc84d90211a69f1f42;hp=d0f8513618586d8cd131ea1a586193c56d73711e;hb=0697eab692e2d8e66f736e5be01648198aa83332;hpb=58a735ea918f55e7eb99dee2052da1b4899e4954 diff --git a/errors.tex b/errors.tex index d0f8513..d560842 100644 --- a/errors.tex +++ b/errors.tex @@ -14,7 +14,7 @@ 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 -ottene dei messaggi di errore. +ottenere dei messaggi di errore più espliciti. \section{Gli errori dei file} @@ -30,57 +30,96 @@ libreria che operano sui file. 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. + 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). + 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 - dispositico è fisicamente assente o non funzionante. + 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. -\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 + 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}. -\section{Gli errori di rete} -\label{sec:err_network} +\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. -\item \macro{EXDEV} \textit{Cross-device link}. -\item \macro{ENOTBLK} \textit{}. -\item \macro{EBUSY} \textit{Resource busy}. -\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. +\begin{description} -\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{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, + 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. -\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}). +\section{Gli errori di rete} +\label{sec:err_network} + -\item \macro{EPIPE} \textit{Broken pipe}. \item \macro{EDOM} \textit{Domain error}. \item \macro{ERANGE} \textit{Range error}. \item \macro{EAGAIN} \textit{Resource temporarily unavailable}. @@ -113,12 +152,6 @@ libreria che operano sui file. \item \macro{ETIMEDOUT} \textit{Connection timed out}. \item \macro{ECONNREFUSED} \textit{Connection refused}. -\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{EHOSTDOWN} \textit{Host is down}. \item \macro{EHOSTUNREACH} \textit{No route to host}. \item \macro{ENOTEMPTY} \textit{Directory not empty}. @@ -126,25 +159,25 @@ libreria che operano sui file. \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}. @@ -204,38 +237,23 @@ libreria che operano sui file. \end{description} -\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. -\begin{description} +\section{Altri errori} +\label{sec:err_others} -\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, - 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. +\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 - provova. - - - -\section{Altri errori} -\label{sec:err_others} +\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.