fine revisione di \macro{}, piu' una serie di correzioni nella rilettura.
[gapil.git] / session.tex
index 90ecc4874ba96051fedca43c67b023792fe9ff0c..dd948afbbeb3e8977ea96a7bfeccf8e9c500cfb1 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
-    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
@@ -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
-    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}
 
@@ -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}
-    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
@@ -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}
-    ed inoltre \const{EBADF} ed \const{ENOSYS}. 
+    ed inoltre \errval{EBADF} ed \errval{ENOSYS}. 
   }
 \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
-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
-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
@@ -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 è:
-\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}
 
-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
-\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.
 
 
@@ -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}
-    ed inoltre \const{EBADF} ed \const{ENOSYS}.
+    ed inoltre \errval{EBADF} ed \errval{ENOSYS}.
 }
 \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 
-                    \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{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{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
-                    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{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
-                    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
@@ -1585,7 +1585,7 @@ andranno immagazzinate le impostazioni, il loro prototipo 
     \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}
 
@@ -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. 
 
-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
@@ -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
-    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)
@@ -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
-    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
@@ -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
-    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
@@ -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
-    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