X-Git-Url: https://gapil.gnulinux.it/gitweb/?a=blobdiff_plain;f=errors.tex;h=05afbef996c4567b546d5922ecb83215cd530abe;hb=a332430e442c30fa63d82d2a490083c4acdb70dd;hp=e5f9439f6b0194ef7a85ad82c1253ab6fee39a02;hpb=68f626be4f8d5c0816b9b552f744f05f0d72c8dc;p=gapil.git diff --git a/errors.tex b/errors.tex index e5f9439..05afbef 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,99 +30,129 @@ 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 \finc{exec}. + 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. + 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 +\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{EXDEV} \textit{Cross-device link}. -\item \macro{ENOTBLK} \textit{}. -\item \macro{EBUSY} \textit{Resource busy}. +\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{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{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{}. +\item \macro{ETXTBSY} \textit{Text file busy}. \item \macro{EFBIG} \textit{File too big}. - \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{}. il file risiede su un filesystem read-only. - +\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 + numero massimo è specificato dalla variabile \macro{LINK\_MAX}, vedi \secref{sec:xxx_limits}). - \item \macro{EPIPE} \textit{Broken pipe}. + + + +\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} + +\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{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} + + +\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{}. -\item \macro{EINPROGRESS} \textit{}. -\item \macro{EALREADY} \textit{}. -\item \macro{ENOTSOCK} \textit{}. -\item \macro{EMSGSIZE} \textit{}. -\item \macro{EALREADY} \textit{}. -\item \macro{ENOTSOCK} \textit{}. -\item \macro{EMSGSIZE} \textit{}. -\item \macro{EPROTOTYPE} \textit{}. -\item \macro{ENOPROTOOPT} \textit{}. -\item \macro{EPROTONOSUPPORT} \textit{}. -\item \macro{ESOCKTNOSUPPORT} \textit{}. -\item \macro{EOPNOTSUPP} \textit{}. -\item \macro{EPFNOSUPPORT} \textit{}. -\item \macro{EAFNOSUPPORT} \textit{}. -\item \macro{EADDRINUSE} \textit{}. -\item \macro{EADDRNOTAVAIL} \textit{}. -\item \macro{ENETDOWN} \textit{}. -\item \macro{ENETUNREACH} \textit{}. -\item \macro{ENETRESET} \textit{}. -\item \macro{ECONNABORTED} \textit{}. -\item \macro{ECONNRESET} \textit{}. -\item \macro{ENOBUFS} \textit{}. -\item \macro{EISCONN} \textit{}. -\item \macro{ENOTCONN} \textit{}. -\item \macro{EDESTADDRREQ} \textit{}. -\item \macro{ESHUTDOWN} \textit{}. -\item \macro{ETOOMANYREFS} \textit{}. -\item \macro{ETIMEDOUT} \textit{}. -\item \macro{ECONNREFUSED} \textit{}. - -\item \macro{ELOOP} ci sono troppi link simbolici nella risoluzione di un - pathname. - -\item \macro{ENAMETOOLONG} si è indicato un pathname troppo lungo. - -\item \macro{EHOSTDOWN} \textit{}. -\item \macro{EHOSTUNREACH} \textit{}. -\item \macro{ENOTEMPTY} \textit{}. +\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{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{}. -\item \macro{EDQUOT} \textit{}. -\item \macro{ESTALE} \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{}. \item \macro{EBADRPC} \textit{}. \item \macro{ERPCMISMATCH} \textit{}. @@ -135,105 +165,78 @@ libreria che operano sui file. \item \macro{ENEEDAUTH} \textit{}. \item \macro{ENOSYS} \textit{Function not implemented}. \item \macro{ENOTSUP} \textit{Not supported}. -\item \macro{EILSEQ} \textit{}. +\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{}. -\item \macro{EIDRM} \textit{}. -\item \macro{EMULTIHOP} \textit{}. -\item \macro{ENODATA} \textit{}. -\item \macro{ENOLINK} \textit{}. -\item \macro{ENOMSG} \textit{}. -\item \macro{ENOSR} \textit{}. -\item \macro{ENOSTR} \textit{}. -\item \macro{EOVERFLOW} \textit{}. -\item \macro{EPROTO} \textit{}. -\item \macro{ETIME} \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 del kernel} \label{sec:err_kernel_err} - -\item \macro{ERESTART} \textit{}. -\item \macro{ECHRNG} \textit{}. -\item \macro{EL2NSYNC} \textit{}. -\item \macro{EL3HLT} \textit{}. -\item \macro{EL3RST} \textit{}. -\item \macro{ELNRNG} \textit{}. -\item \macro{EUNATCH} \textit{}. -\item \macro{ENOCSI} \textit{}. -\item \macro{EL2HLT} \textit{}. -\item \macro{EBADE} \textit{}. -\item \macro{EBADR} \textit{}. -\item \macro{EXFULL} \textit{}. -\item \macro{ENOANO} \textit{}. -\item \macro{EBADRQC} \textit{}. -\item \macro{EBADSLT} \textit{}. -\item \macro{EDEADLOCK} \textit{}. -\item \macro{EBFONT} \textit{}. -\item \macro{ENONET} \textit{}. -\item \macro{ENOPKG} \textit{}. -\item \macro{EADV} \textit{}. -\item \macro{ESRMNT} \textit{}. -\item \macro{ECOMM} \textit{}. -\item \macro{EDOTDOT} \textit{}. -\item \macro{ENOTUNIQ} \textit{}. -\item \macro{EBADFD} \textit{}. -\item \macro{EREMCHG} \textit{}. -\item \macro{ELIBACC} \textit{}. -\item \macro{ELIBBAD} \textit{}. -\item \macro{ELIBSCN} \textit{}. -\item \macro{ELIBMAX} \textit{}. -\item \macro{ELIBEXEC} \textit{}. -\item \macro{ESTRPIPE} \textit{}. -\item \macro{EUCLEAN} \textit{}. -\item \macro{ENAVAIL} \textit{}. -\item \macro{EISNAM} \textit{}. -\item \macro{EREMOTEIO} \textit{}. -\item \macro{ENOMEDIUM} \textit{}. -\item \macro{EMEDIUMTYPE} \textit{}. -\item \macro{} \textit{}. -\item \macro{} \textit{}. -\item \macro{} \textit{}. -\item \macro{} \textit{}. -\item \macro{} \textit{}. +\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} -\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{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. \end{description}