X-Git-Url: https://gapil.gnulinux.it/gitweb/?p=gapil.git;a=blobdiff_plain;f=errors.tex;h=1fced55630c788c4715595a00ff41bd3e145b9a2;hp=69b4e3efa9cd7b069b2458e39f73ecec892a30e4;hb=1c947e9304d40b64591837ced98125fa3839126e;hpb=eeb51cd82a56668eff7439a1e7d397e106463cc8 diff --git a/errors.tex b/errors.tex index 69b4e3e..1fced55 100644 --- a/errors.tex +++ b/errors.tex @@ -14,17 +14,17 @@ 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} \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. @@ -45,8 +45,6 @@ libreria che operano sui file. 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. @@ -54,17 +52,36 @@ libreria che operano sui file. 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}. @@ -72,24 +89,25 @@ libreria che operano sui file. \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, @@ -97,28 +115,15 @@ libreria che operano sui processi. \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}. @@ -153,25 +158,25 @@ libreria che operano sui processi. \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}. @@ -185,9 +190,49 @@ libreria che operano sui processi. \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}. @@ -227,18 +272,6 @@ libreria che operano sui processi. \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}