Correzioni varie
[gapil.git] / session.tex
index 90ecc4874ba96051fedca43c67b023792fe9ff0c..8929b418854739ab772b6e32bc435bba72a5fdf9 100644 (file)
@@ -138,7 +138,8 @@ i cui prototipi sono:
   
   \bodydesc{Le funzioni restituiscono il \acr{pgid} del processo,
     \func{getpgrp} ha sempre successo, mentre \func{getpgid} restituisce -1
   
   \bodydesc{Le funzioni restituiscono il \acr{pgid} del processo,
     \func{getpgrp} ha sempre successo, mentre \func{getpgid} restituisce -1
-    ponendo \var{errno} a \const{ESRCH} se il processo selezionato non esiste.}
+    ponendo \var{errno} a \errval{ESRCH} se il processo selezionato non
+    esiste.}
 \end{functions}
 
 La funzione \func{getpgid} permette di specificare il \acr{pid} del processo
 \end{functions}
 
 La funzione \func{getpgid} permette di specificare il \acr{pid} del processo
@@ -207,7 +208,7 @@ cui prototipo 
     \begin{errlist}
     \item[\errcode{ESRCH}] Il processo selezionato non esiste.
     \item[\errcode{EPERM}] Il cambiamento non è consentito.
     \begin{errlist}
     \item[\errcode{ESRCH}] Il processo selezionato non esiste.
     \item[\errcode{EPERM}] Il cambiamento non è consentito.
-    \item[\errcode{EACCESS}] Il processo ha già eseguito una \func{exec}.
+    \item[\errcode{EACCES}] Il processo ha già eseguito una \func{exec}.
     \item[\errcode{EINVAL}] Il valore di \param{pgid} è negativo.
     \end{errlist}
  }
     \item[\errcode{EINVAL}] Il valore di \param{pgid} è negativo.
     \end{errlist}
  }
@@ -243,7 +244,7 @@ sessione ad un processo 
   \acr{pgid}.
   
   \bodydesc{La funzione ritorna il valore del nuovo \acr{sid}, e -1 in caso di
   \acr{pgid}.
   
   \bodydesc{La funzione ritorna il valore del nuovo \acr{sid}, e -1 in caso di
-    errore, il solo errore possibile è \const{EPERM}, che si ha quando il
+    errore, il solo errore possibile è \errval{EPERM}, che si ha quando il
     \acr{pgid} e \acr{pid} del processo coincidono.}
 \end{prototype}
 
     \acr{pgid} e \acr{pid} del processo coincidono.}
 \end{prototype}
 
@@ -335,7 +336,7 @@ funzione \func{tcsetpgrp}, il cui prototipo 
     \item[\errcode{EPERM}] Il \textit{process group} specificato non è nella
     stessa sessione del processo chiamante.
     \end{errlist}
     \item[\errcode{EPERM}] Il \textit{process group} specificato non è nella
     stessa sessione del processo chiamante.
     \end{errlist}
-    ed inoltre \const{EBADF} ed \const{EINVAL}. 
+    ed inoltre \errval{EBADF} ed \errval{EINVAL}. 
   }
 \end{functions}
 \noindent la funzione può essere eseguita con successo solo da
   }
 \end{functions}
 \noindent la funzione può essere eseguita con successo solo da
@@ -369,7 +370,7 @@ ad un terminale con la funzione \func{tcgetpgrp}, il cui prototipo 
     \item[\errcode{ENOTTY}] Non c'è un terminale di controllo o \param{fd} non
       corrisponde al terminale di controllo del processo chiamante.
     \end{errlist}
     \item[\errcode{ENOTTY}] Non c'è un terminale di controllo o \param{fd} non
       corrisponde al terminale di controllo del processo chiamante.
     \end{errlist}
-    ed inoltre \const{EBADF} ed \const{ENOSYS}. 
+    ed inoltre \errval{EBADF} ed \errval{ENOSYS}. 
   }
 \end{functions}
 
   }
 \end{functions}
 
@@ -821,9 +822,9 @@ Il comportamento della funzione 
 dell'argomento \param{format} è identico a quello descritto nella pagina di
 manuale di quest'ultima (per i valori principali si può vedere la trattazione
 sommaria che se ne è fatto in \secref{sec:file_formatted_io}); l'unica
 dell'argomento \param{format} è identico a quello descritto nella pagina di
 manuale di quest'ultima (per i valori principali si può vedere la trattazione
 sommaria che se ne è fatto in \secref{sec:file_formatted_io}); l'unica
-differenza è che la sequenza \cmd{\%m} viene rimpiazzata dalla stringa
+differenza è che la sequenza \val{\%m} viene rimpiazzata dalla stringa
 restituita da \code{strerror(errno)}. Gli argomenti seguenti i primi due
 restituita da \code{strerror(errno)}. Gli argomenti seguenti i primi due
-devono essere forniti secondo quanto richiesto da \func{format}.
+devono essere forniti secondo quanto richiesto da \param{format}.
 
 L'argomento \param{priority} permette di impostare sia la \textit{facility}
 che la \textit{priority} del messaggio. In realtà viene prevalentemente usato
 
 L'argomento \param{priority} permette di impostare sia la \textit{facility}
 che la \textit{priority} del messaggio. In realtà viene prevalentemente usato
@@ -865,21 +866,20 @@ con la maschera binaria delle costanti di \tabref{tab:sess_syslog_facility}.
 
 Una ulteriore funzione, \func{setlogmask}, permette di filtrare
 preliminarmente i messaggi in base alla loro priorità; il suo prototipo è:
 
 Una ulteriore funzione, \func{setlogmask}, permette di filtrare
 preliminarmente i messaggi in base alla loro priorità; il suo prototipo è:
-\begin{prototype}{syslog.h}
-{int setlogmask(int mask)}
+\begin{prototype}{syslog.h}{int setlogmask(int mask)}
 
 Imposta la maschera dei log al valore specificato.
 
 \bodydesc{La funzione restituisce il precedente valore.}
 \end{prototype}
 
 
 Imposta la maschera dei log al valore specificato.
 
 \bodydesc{La funzione restituisce il precedente valore.}
 \end{prototype}
 
-Le routine di gestione mantengono per ogni processo una maschera che
-determina quale delle chiamate effettuate a \func{syslog} verrà
-effettivamente registrata. La registrazione viene disabilitata per tutte
-quelle priorità che non rientrano nella maschera; questa viene settata
-usando la macro \code{LOG\_MASK(p)} dove \code{p} è una delle costanti di
+Le routine di gestione mantengono per ogni processo una maschera che determina
+quale delle chiamate effettuate a \func{syslog} verrà effettivamente
+registrata. La registrazione viene disabilitata per tutte quelle priorità che
+non rientrano nella maschera; questa viene settata usando la macro
+\macro{LOG\_MASK(p)} dove \code{p} è una delle costanti di
 \secref{tab:sess_syslog_priority}. É inoltre disponibile anche la macro
 \secref{tab:sess_syslog_priority}. É inoltre disponibile anche la macro
-\code{LOG\_UPTO(p)} che permette di specificare automaticamente tutte le
+\macro{LOG\_UPTO(p)} che permette di specificare automaticamente tutte le
 priorità fino ad un certo valore.
 
 
 priorità fino ad un certo valore.
 
 
@@ -1058,7 +1058,7 @@ statica; il suo prototipo 
     \item[\errcode{ERANGE}] la lunghezza del buffer, \param{len}, non è
       sufficiente per contenere la stringa restituita.
     \end{errlist}
     \item[\errcode{ERANGE}] la lunghezza del buffer, \param{len}, non è
       sufficiente per contenere la stringa restituita.
     \end{errlist}
-    ed inoltre \const{EBADF} ed \const{ENOSYS}.
+    ed inoltre \errval{EBADF} ed \errval{ENOSYS}.
 }
 \end{prototype}
 
 }
 \end{prototype}
 
@@ -1238,22 +1238,22 @@ pseudo-terminali usati nelle connessioni di rete.
                     (\texttt{0x3F}), invece che NUL (\texttt{0x00}).\\
     \const{NLDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere di a capo (NL), i valori possibili sono 
                     (\texttt{0x3F}), invece che NUL (\texttt{0x00}).\\
     \const{NLDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere di a capo (NL), i valori possibili sono 
-                    \const{NL0} o \const{NL1}.\\
+                    \val{NL0} o \val{NL1}.\\
     \const{CRDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere ritorno carrello (CR), i valori possibili sono
     \const{CRDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere ritorno carrello (CR), i valori possibili sono
-                    \const{CR0}, \const{CR1}, \const{CR2} o \const{CR3}.\\
+                    \val{CR0}, \val{CR1}, \val{CR2} o \val{CR3}.\\
     \const{TABDLY}& Maschera per i bit che indicano il ritardo per il
                     carattere di tabulazione, i valori possibili sono
     \const{TABDLY}& Maschera per i bit che indicano il ritardo per il
                     carattere di tabulazione, i valori possibili sono
-                    \const{TAB0}, \const{TAB1}, \const{TAB2} o \const{TAB3}.\\
+                    \val{TAB0}, \val{TAB1}, \val{TAB2} o \val{TAB3}.\\
     \const{BSDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere di ritorno indietro (\textit{backspace}), i
     \const{BSDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere di ritorno indietro (\textit{backspace}), i
-                    valori possibili sono \const{BS0} o \const{BS1}.\\
+                    valori possibili sono \val{BS0} o \val{BS1}.\\
     \const{VTDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere di tabulazione verticale, i valori possibili sono
     \const{VTDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere di tabulazione verticale, i valori possibili sono
-                    \const{VT0} o \const{VT1}.\\
+                    \val{VT0} o \val{VT1}.\\
     \const{FFDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere di pagina nuova (\textit{form feed}), i valori
     \const{FFDLY} & Maschera per i bit che indicano il ritardo per il
                     carattere di pagina nuova (\textit{form feed}), i valori
-                    possibili sono \const{FF0} o \const{FF1}.\\
+                    possibili sono \val{FF0} o \val{FF1}.\\
     \hline
   \end{tabular}
   \caption{Costanti identificative dei vari bit del flag di controllo
     \hline
   \end{tabular}
   \caption{Costanti identificative dei vari bit del flag di controllo
@@ -1329,8 +1329,8 @@ valore.
     \const{CSIZE}  & Maschera per i bit usati per specificare la dimensione 
                      del carattere inviato lungo la linea di trasmissione, i
                      valore ne indica la lunghezza (in bit), ed i valori   
     \const{CSIZE}  & Maschera per i bit usati per specificare la dimensione 
                      del carattere inviato lungo la linea di trasmissione, i
                      valore ne indica la lunghezza (in bit), ed i valori   
-                     possibili sono \const{CS5}, \const{CS6}, 
-                     \const{CS7} e \const{CS8}
+                     possibili sono \val{CS5}, \val{CS6}, 
+                     \val{CS7} e \val{CS8}
                      corrispondenti ad un analogo numero di bit.\\
     \const{CBAUD}  & Maschera dei bit (4+1) usati per impostare della velocità
                      della linea (il \textit{baud rate}) in ingresso. 
                      corrispondenti ad un analogo numero di bit.\\
     \const{CBAUD}  & Maschera dei bit (4+1) usati per impostare della velocità
                      della linea (il \textit{baud rate}) in ingresso. 
@@ -1585,7 +1585,7 @@ andranno immagazzinate le impostazioni, il loro prototipo 
     \begin{errlist}
     \item[\errcode{EINTR}] La funzione è stata interrotta. 
     \end{errlist}
     \begin{errlist}
     \item[\errcode{EINTR}] La funzione è stata interrotta. 
     \end{errlist}
-    ed inoltre \const{EBADF}, \const{ENOTTY} ed \const{EINVAL}. 
+    ed inoltre \errval{EBADF}, \errval{ENOTTY} ed \errval{EINVAL}. 
   }
 \end{functions}
 
   }
 \end{functions}
 
@@ -1784,7 +1784,7 @@ la velocit
 del terminale quest'ultimo non potrà funzionare: quando il terminale non è
 seriale il valore non influisce sulla velocità di trasmissione dei dati. 
 
 del terminale quest'ultimo non potrà funzionare: quando il terminale non è
 seriale il valore non influisce sulla velocità di trasmissione dei dati. 
 
-In generale impostare un valore nullo (\const{B0}) sulla linea di output fa si
+In generale impostare un valore nullo (\val{B0}) sulla linea di output fa si
 che il modem non asserisca più le linee di controllo, interrompendo di fatto
 la connessione, qualora invece si utilizzi questo valore per la linea di input
 l'effetto sarà quello di rendere la sua velocità identica a quella della linea
 che il modem non asserisca più le linee di controllo, interrompendo di fatto
 la connessione, qualora invece si utilizzi questo valore per la linea di input
 l'effetto sarà quello di rendere la sua velocità identica a quella della linea
@@ -1843,8 +1843,8 @@ prototipo 
   break inviando un flusso di bit nulli.
   
   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
   break inviando un flusso di bit nulli.
   
   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
-    errore, nel qual caso \var{errno} assumerà i valori \const{EBADF} o
-    \const{ENOTTY}.}
+    errore, nel qual caso \var{errno} assumerà i valori \errval{EBADF} o
+    \errval{ENOTTY}.}
 \end{functions}
 
 La funzione invia un flusso di bit nulli (che genera una condizione di break)
 \end{functions}
 
 La funzione invia un flusso di bit nulli (che genera una condizione di break)
@@ -1865,8 +1865,8 @@ dell'interazione fra le code associate al terminale e l'utente; la prima 
   \funcdecl{int tcdrain(int fd)} Attende lo svuotamento della coda di output.
   
   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
   \funcdecl{int tcdrain(int fd)} Attende lo svuotamento della coda di output.
   
   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
-    errore, nel qual caso \var{errno} assumerà i valori \const{EBADF} o
-    \const{ENOTTY}.}
+    errore, nel qual caso \var{errno} assumerà i valori \errval{EBADF} o
+    \errval{ENOTTY}.}
 \end{functions}
 
 La funzione blocca il processo fino a che tutto l'output presente sulla coda
 \end{functions}
 
 La funzione blocca il processo fino a che tutto l'output presente sulla coda
@@ -1885,8 +1885,8 @@ di cancellando tutti i dati presenti al loro interno; il suo prototipo 
   nelle code di ingresso o di uscita.
   
   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
   nelle code di ingresso o di uscita.
   
   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
-    errore, nel qual caso \var{errno} assumerà i valori \const{EBADF} o
-    \const{ENOTTY}.}
+    errore, nel qual caso \var{errno} assumerà i valori \errval{EBADF} o
+    \errval{ENOTTY}.}
 \end{functions}
 
 La funzione agisce sul terminale associato a \param{fd}, l'argomento
 \end{functions}
 
 La funzione agisce sul terminale associato a \param{fd}, l'argomento
@@ -1927,8 +1927,8 @@ dei dati sul terminale; il suo prototipo 
   Sospende e rivvia il flusso dei dati sul terminale.
 
   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
   Sospende e rivvia il flusso dei dati sul terminale.
 
   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
-    errore, nel qual caso \var{errno} assumerà i valori \const{EBADF} o
-    \const{ENOTTY}.}
+    errore, nel qual caso \var{errno} assumerà i valori \errval{EBADF} o
+    \errval{ENOTTY}.}
 \end{functions}
 
 La funzione permette di controllare (interrompendo e facendo riprendere) il
 \end{functions}
 
 La funzione permette di controllare (interrompendo e facendo riprendere) il