X-Git-Url: https://gapil.gnulinux.it/gitweb/?a=blobdiff_plain;f=errors.tex;h=1fced55630c788c4715595a00ff41bd3e145b9a2;hb=60f259e7ef821c07d1361e44e134b7dbd1184fdb;hp=d560842c013f5b9afc4c10cc84d90211a69f1f42;hpb=a4b228460d4a3710752b2bc66f3c56d72c3ad203;p=gapil.git diff --git a/errors.tex b/errors.tex index d560842..1fced55 100644 --- a/errors.tex +++ b/errors.tex @@ -20,11 +20,11 @@ ottenere dei messaggi di errore pi \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. @@ -89,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, @@ -119,12 +120,10 @@ libreria che operano sui processi. \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{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}. @@ -191,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}. @@ -233,31 +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} - -\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. - - - - \end{description}