Correzioni a referenze e aggiunte alla sezione errori
authorSimone Piccardi <piccardi@gnulinux.it>
Sun, 19 May 2002 13:25:04 +0000 (13:25 +0000)
committerSimone Piccardi <piccardi@gnulinux.it>
Sun, 19 May 2002 13:25:04 +0000 (13:25 +0000)
gapil.tex
prochand.tex
signal.tex
sources/TestRen.c
system.tex

index d05eb76392421a6ad8820ca79900caba129a87cc..f4a3dd3363cf51cd917c8687a15b67624028960b 100644 (file)
--- a/gapil.tex
+++ b/gapil.tex
 % distance from margins for boxedminipage
 %\fboxsep=6pt
 
-
-
 \include{intro}
 \include{process}
 \include{prochand}
 \include{fileunix}
 \include{filestd}
 \include{system}
-\include{session}
 \include{signal}
+\include{session}
 \include{fileadv}
 \include{ipc}
 \include{network}
index 7e4c8431bf70fddafaf04fc318b40fa4cebd67db..ba6161970ba489b275e26698814deba11adcc262 100644 (file)
@@ -379,7 +379,9 @@ int main(int argc, char *argv[])
 Normalmente la chiamata a \func{fork} può fallire solo per due ragioni, o ci
 sono già troppi processi nel sistema (il che di solito è sintomo che
 qualcos'altro non sta andando per il verso giusto) o si è ecceduto il limite
-sul numero totale di processi permessi all'utente (vedi \secref{sec:sys_xxx}).
+sul numero totale di processi permessi all'utente (vedi
+\secref{sec:sys_resource_limit}, ed in particolare
+\tabref{tab:sys_rlimit_values}).
 
 L'uso di \func{fork} avviene secondo due modalità principali; la prima è
 quella in cui all'interno di un programma si creano processi figli cui viene
@@ -1211,9 +1213,9 @@ la lista completa 
   \secref{sec:file_locking}).
 \item i segnali sospesi (\textit{pending}) e la maschera dei segnali (si veda
   \secref{sec:sig_sigmask}).
-\item i limiti sulle risorse (vedi \secref{sec:sys_resource_limits}).
+\item i limiti sulle risorse (vedi \secref{sec:sys_resource_limit}).
 \item i valori delle variabili \var{tms\_utime}, \var{tms\_stime},
-  \var{tms\_cutime}, \var{tms\_ustime} (vedi \secref{sec:sys_xxx}).
+  \var{tms\_cutime}, \var{tms\_ustime} (vedi \secref{sec:sys_cpu_times}).
 \end{itemize*}
 
 Inoltre i segnali che sono stati settati per essere ignorati nel processo
index 09f8325543a3370c5247a3f9877952a6502e02e6..2f3b75b8c002272cb102ff8d78842a5ce008d10e 100644 (file)
@@ -662,11 +662,11 @@ segnali sono:
   situazione precedente.
 \item[\macro{SIGXCPU}] Sta per \textit{CPU time limit exceeded}. Questo
   segnale è generato quando un processo eccede il limite impostato per il
-  tempo di CPU disponibile, vedi \secref{sec:sys_xxx}. 
+  tempo di CPU disponibile, vedi \secref{sec:sys_resource_limit}. 
 \item[\macro{SIGXFSZ}] Sta per \textit{File size limit exceeded}. Questo
   segnale è generato quando un processo tenta di estendere un file oltre le
   dimensioni specificate dal limite impostato per le dimensioni massime di un
-  file, vedi \secref{sec:sys_xxx}. 
+  file, vedi \secref{sec:sys_resource_limit}. 
 \end{basedescript}
 
 
@@ -714,7 +714,7 @@ di \func{strsignal}. Nel caso si debba mantenere traccia del messaggio sar
 necessario copiarlo.
 
 La seconda funzione deriva da BSD ed è analoga alla funzione \func{perror}
-descritta in \secref{sec:sys_strerror}; il suo prototipo è:
+descritta sempre in \secref{sec:sys_strerror}; il suo prototipo è:
 \begin{prototype}{signal.h}{void psignal(int sig, const char *s)} 
   Stampa sullo standard error un messaggio costituito dalla stringa \param{s},
   seguita da due punti ed una descrizione del segnale indicato da \param{sig}.
index 9e736defd574ab9a0c6551569b2c1e413840f010..805bfda2b2410279bc7b5b188aeb4581e50861fc 100644 (file)
@@ -26,7 +26,7 @@
  *
  * Usage: testrem -h give all info's
  *
- * $Id: TestRen.c,v 1.1 2002/01/03 23:44:14 piccardi Exp $
+ * $Id: TestRen.c,v 1.2 2002/05/19 13:25:04 piccardi Exp $
  *
  ****************************************************************/
 /* 
@@ -47,10 +47,13 @@ int main(int argc, char *argv[])
  * Variables definition  
  */
     int i;
+    char *buf,*copy;
     /*
      * Input section: decode command line parameters 
      * Use getopt function
      */
+    buf = malloc(100);
+
     opterr = 0;         /* don't want writing to stderr */
     while ( (i = getopt(argc, argv, "h")) != -1) {
        switch (i) {
@@ -82,6 +85,7 @@ int main(int argc, char *argv[])
        usage();
     }
     if ( rename(argv[optind], argv[optind+1]) ) {
+       copy = strerror_r(errno, NULL, 0);
        perror("cannot rename");
        exit(1);
     }
index 18cee493a4d73befeffd46495823ddb867ee9cd8..a2cff143b24fcbf2fb55fe7623850151d292638a 100644 (file)
@@ -903,14 +903,14 @@ struct statfs {
 
 
 Le \acr{glibc} provvedono infine una serie di funzioni per la gestione dei due
-file standard \file{/etc/fstab} e \file{/etc/mtab}, che convenzionalmente sono
-usati in quasi tutti i sistemi unix-like per mantenere rispettivamente le
-informazioni riguardo ai filesystem da montare e a quelli correntemente
-montati. Le funzioni servono a leggere il contenuto di questi file in
-opportune strutture \var{struct fstab} e \var{struct mntent}, e, per
-\file{/etc/mtab} per inserire e rimuovere le voci presenti nel file.  
-
-In generale si dovrebbero usare queste funzioni (in particolar modo quelle
+file \file{/etc/fstab} ed \file{/etc/mtab}, che convenzionalmente sono usati in
+quasi tutti i sistemi unix-like per mantenere rispettivamente le informazioni
+riguardo ai filesystem da montare e a quelli correntemente montati. Le
+funzioni servono a leggere il contenuto di questi file in opportune strutture
+\var{struct fstab} e \var{struct mntent}, e, per \file{/etc/mtab} per inserire
+e rimuovere le voci presenti nel file.
+
+In generale si dovrebbero usare queste funzioni (in particolare quelle
 relative a \file{/etc/mtab}), quando si debba scrivere un programma che
 effettua il montaggio di un filesystem; in realtà in questi casi è molto più
 semplice invocare direttamente il programma \cmd{mount}, per cui ne
@@ -1848,8 +1848,8 @@ norma l'uso delle funzioni precedenti 
 sostituite da \func{gettimeofday} e \func{settimeofday},\footnote{le due
   funzioni \func{time} e \func{stime} sono più antiche e derivano da SVr4,
   \func{gettimeofday} e \func{settimeofday} sono state introdotte da BSD, ed
-  in BSD4.3 sono indicate come sostitute delle precedenti.}  mentre i cui
-prototipi sono:
+  in BSD4.3 sono indicate come sostitute delle precedenti.} i cui prototipi
+sono:
 \begin{functions}
   \headdecl{sys/time.h}
   \headdecl{time.h}
@@ -1871,7 +1871,7 @@ prototipi sono:
 
 Queste funzioni utilizzano una struttura di tipo \var{timeval}, la cui
 definizione, insieme a quella della analoga \var{timespec}, è riportata in
-\figref{fig:sys_timeval_struct}. Le \acr{glibc} infatti provvedono queste due
+\figref{fig:sys_timeval_struct}. Le \acr{glibc} infatti forniscono queste due
 rappresentazioni alternative del \textit{calendar time} che rispetto a
 \type{time\_t} consentono rispettivamente precisioni del microsecondo e del
 nanosecondo.\footnote{la precisione è solo teorica, la precisione reale della
@@ -1911,11 +1911,12 @@ non 
 pertanto deve essere sempre settato a \macro{NULL}.
 
 Modificare l'orologio di sistema con queste funzioni è comunque problematico,
-in quanto esse effettuano un cambiamento immediato. Ad esempio se si porta
-avanti l'orologio si possono perdere delle esecuzioni di \cmd{cron}
-programmate nell'intervallo che si è saltato. Per questo motivo la modalità
-più corretta per settare l'ora è quella di usare la funzione \func{adjtime},
-il cui prototipo è:
+in quanto esse effettuano un cambiamento immediato. Questo può creare dei
+buchi o delle ripetizioni nello scorrere dell'orologio di sistema, con
+conseguenze indesiderate; ad esempio se si porta avanti l'orologio si possono
+perdere delle esecuzioni di \cmd{cron} programmate nell'intervallo che si è
+saltato. Per questo motivo la modalità più corretta per settare l'ora è quella
+di usare la funzione \func{adjtime}, il cui prototipo è:
 \begin{prototype}{sys/time.h}
 {int adjtime(const struct timeval *delta, struct timeval *olddelta)} 
   
@@ -1926,8 +1927,8 @@ il cui prototipo 
 \end{prototype}
 
 Questa funzione permette di avere un aggiustamento graduale del tempo di
-sistema in modo che esso sia sempre monotonicamente crescente. Il valore di
-\param{delta} esprime il valore di cui si vuole spostare l'orologio; se è
+sistema in modo che esso sia sempre crescente in maniera monotona. Il valore
+di \param{delta} esprime il valore di cui si vuole spostare l'orologio; se è
 positivo l'orologio sarà accelerato per un certo tempo in modo da guadagnare
 il tempo richiesto, altrimenti sarà rallentato. Il secondo parametro viene
 usato, se non nullo, per ricevere il valore dell'ultimo aggiustamento
@@ -2289,39 +2290,59 @@ riportare in opportuni messaggi le condizioni di errore verificatesi.  La
 prima funzione che si può usare per ricavare i messaggi di errore è
 \func{strerror}, il cui prototipo è:
 \begin{prototype}{string.h}{char *strerror(int errnum)} 
-  Ritorna una stringa (statica) che descrive l'errore il cui codice è passato
-  come parametro.
+  Restituisce una stringa con il messaggio di errore relativo ad
+  \param{errnum}.
+  
+  \bodydesc{La funzione ritorna il puntatore alla stringa col messaggio di
+    errore in caso di successo e \macro{NULL} in caso di errore, nel qual caso
+    \var{errno} sarà settata a \macro{EINVAL} se si è specificato un numero di
+    errore non valido.}
 \end{prototype}
 
 In generale \func{strerror} viene usata passando \var{errno} come parametro;
 nel caso si specifichi un codice sbagliato verrà restituito un messaggio di
-errore sconosciuto. La funzione utilizza una stringa statica che non deve
-essere modificata dal programma e che è utilizzabile solo fino ad una chiamata
-successiva a \func{strerror}; nel caso si usino i thread è
-provvista\footnote{questa funzione è una estensione GNU, non fa parte dello
-  standard POSIX.} una versione apposita:
+errore sconosciuto, e la funzione restituirà come errore \macro{EINVAL}. La
+funzione tiene conto del valore della variabile di ambiente
+\macro{LC\_MESSAGES} per usare eventuali traduzioni dei messaggi d'errore
+nella localizzazione presente. 
+
+La funzione utilizza una stringa statica che non deve essere modificata dal
+programma e che è utilizzabile solo fino ad una chiamata successiva a
+\func{strerror}; per questo motivo non è rientrante e nel caso si usino i
+thread è provvista\footnote{questa funzione è la versione prevista dalle
+  \acr{glibc}, ed effettivamente definita in \file{string.h}, ne esiste una
+  analoga nello standard SUSv3 (quella riportata dalla man page), che
+  restituisce \code{int} al posto di \code{char *}, e che tronca la stringa
+  restituita a \param{size}.} una versione apposita:
 \begin{prototype}{string.h}
-{char *strerror\_r(int errnum, char *buff, size\_t size)} 
-  Analoga a \func{strerror} ma ritorna il messaggio in un buffer
-  specificato da \param{buff} di lunghezza massima (compreso il terminatore)
-  \param{size}.
+  {char * strerror\_r(int errnum, char *buf, size\_t size)} 
+  
+  Analoga a \func{strerror} ma usa il buffer \param{buf} di lunghezza massima
+  (compreso il terminatore) \param{size}.
+  
+  \bodydesc{La funzione restitusce il puntatore alla stringa; in caso di
+    errore \var{errno} oltre a \macro{EINVAL} può assumere anche il valore
+    \macro{ERANGE} per indicare che non c'è sufficiente memoria per contenere
+    la stringa di descrizione.}
 \end{prototype}
 \noindent
 che utilizza un buffer che il singolo thread deve allocare, per evitare i
-problemi connessi alla condivisione del buffer statico. Infine, per completare
-la caratterizzazione dell'errore, si può usare anche la variabile
-globale\footnote{anche questa è un'estensione GNU.}
-\var{program\_invocation\_short\_name} che riporta il nome del programma
-attualmente in esecuzione.
+problemi connessi alla condivisione del buffer statico. La funzione
+restituisce l'indirizzo della stringa usata, che può essere contenuta nel
+buffer specificato da \param{buf}, per una lunghezza non superiore a
+\param{size}, nel qual caso la stringa sarebbe troncata e terminata con
+\macro{NUL}.
+
 
 Una seconda funzione usata per riportare i codici di errore in maniera
 automatizzata sullo standard error (vedi \secref{sec:file_std_descr}) è
 \func{perror}, il cui prototipo è:
-\begin{prototype}{stdio.h}{void perror (const char *message)} 
+\begin{prototype}{stdio.h}{void perror(const char *message)} 
   Stampa il messaggio di errore relativo al valore corrente di \var{errno}
   sullo standard error; preceduto dalla stringa \var{message}.
 \end{prototype}
-i messaggi di errore stampati sono gli stessi di \func{strerror}, (riportati
+
+I messaggi di errore stampati sono gli stessi di \func{strerror}, (riportati
 in \capref{cha:errors}), e, usando il valore corrente di \var{errno}, si
 riferiscono all'ultimo errore avvenuto. La stringa specificata con
 \var{message} viene stampato prime del messaggio d'errore, seguita dai due
@@ -2338,18 +2359,6 @@ la prima contiene i puntatori alle stringhe di errore indicizzati da
 l'utilizzo di questa stringa è sostanzialmente equivalente a quello di
 \func{strerror}.
 
-In \nfig\ è riportata la sezione attinente del codice del programma
-\cmd{errcode}, che può essere usato per stampare i messaggi di errore e le
-costanti usate per identificare i singoli errori; il sorgente completo del
-programma è allegato nel file \file{ErrCode.c} e contiene pure la gestione
-delle opzioni e tutte le definizioni necessarie ad associare il valore
-numerico alla costante simbolica. In particolare si è riportata la sezione che
-converte la stringa passata come parametro in un intero (\texttt{\small
-  1--2}), controllando con i valori di ritorno di \func{strtol} che la
-conversione sia avvenuta correttamente (\texttt{\small 4--10}), e poi stampa,
-a seconda dell'opzione scelta il messaggio di errore (\texttt{\small 11--14})
-o la macro (\texttt{\small 15--17}) associate a quel codice.
-
 \begin{figure}[!htb]
   \footnotesize
   \begin{lstlisting}{}
@@ -2375,6 +2384,56 @@ o la macro (\texttt{\small 15--17}) associate a quel codice.
   \label{fig:sys_err_mess}
 \end{figure}
 
+In \figref{fig:sys_err_mess} è riportata la sezione attinente del codice del
+programma \cmd{errcode}, che può essere usato per stampare i messaggi di
+errore e le costanti usate per identificare i singoli errori; il sorgente
+completo del programma è allegato nel file \file{ErrCode.c} e contiene pure la
+gestione delle opzioni e tutte le definizioni necessarie ad associare il
+valore numerico alla costante simbolica. In particolare si è riportata la
+sezione che converte la stringa passata come parametro in un intero
+(\texttt{\small 1--2}), controllando con i valori di ritorno di \func{strtol}
+che la conversione sia avvenuta correttamente (\texttt{\small 4--10}), e poi
+stampa, a seconda dell'opzione scelta il messaggio di errore (\texttt{\small
+  11--14}) o la macro (\texttt{\small 15--17}) associate a quel codice.
+
+
+
+\subsection{Alcune estensioni GNU}
+\label{sec:sys_err_GNU}
+
+Le precedenti funzioni sono quelle definite ed usate nei vari standard; le
+\acr{glibc} hanno però introdotto una serie di estensioni ``GNU'' che
+forniscono alcune funzionalità aggiuntive per una gestione degli errori
+semplificata e più efficiente. 
+
+La prima estenzione consiste in due variabili, \code{char *
+  program\_invocation\_name} e \code{char * program\_invocation\_short\_name}
+servono per ricavare il nome del programma; queste sono utili quando si deve
+aggiungere il nome del programma (cosa comune quando si ha un programma che
+non viene lanciato da linea di comando e salva gli errori in un file di log)
+al messaggio d'errore. La prima contiene il nome usato per lanciare il
+programma (ed è equivalente ad \code{argv[0]}); la seconda mantiene solo il
+nome del programma (senza eventuali directory in testa).
+
+Uno dei problemi che si hanno con l'uso di \func{perror} è che non c'è
+flessibilità su quello che si può aggiungere al messaggio di errore, che può
+essere solo una stringa. In molte occasioni invece serve poter scrivere dei
+messaggi con maggiore informazione; ad esempio negli standard di
+programmazione GNU si richiede che ogni messaggio di errore sia preceduto dal
+nome del programma, ed in generale si può voler stampare il contenuto di
+qualche variabile; per questo le \acr{glibc} definiscono la funzione
+\func{error}, il cui prototipo è:
+\begin{prototype}{stdio.h}
+{void error(int status, int errnum, const char *format, ...)} 
+
+Stampa un messaggio di errore formattato.
+
+\bodydesc{La funzione non restituisce nulla e non riporta errori.}
+\end{prototype}
+
+
+
+
 
 
 %%% Local Variables: