X-Git-Url: https://gapil.gnulinux.it/gitweb/?p=gapil.git;a=blobdiff_plain;f=session.tex;h=675334bf1fce22d974e98bd44fc723f73ec447b8;hp=35ed018b848fdee76abe69346555042ea3390553;hb=7a5080a6a24fe81a8346a67c3454438ba2ef344f;hpb=535a5dfabb91231acc74e81c82425a6d47c355f9 diff --git a/session.tex b/session.tex index 35ed018..675334b 100644 --- a/session.tex +++ b/session.tex @@ -722,13 +722,13 @@ funzione nei successivi messaggi, e se viene cancellata i risultati potranno essere impredicibili, per questo è sempre opportuno usare una stringa costante. -L'argomento \param{facility} permette invece di preimpostare per le successive -chiamate l'omonimo indice che classifica la categoria del messaggio. -L'argomento è interpretato come una maschera binaria, e pertanto è possibile -inviare i messaggi su più categorie alla volta; i valori delle costanti che -identificano ciascuna categoria sono riportati in -\tabref{tab:sess_syslog_facility}, il valore di \param{facility} deve essere -specificato con un OR aritmetico. + L'argomento \param{facility} permette invece di preimpostare per le successive + chiamate l'omonimo indice che classifica la categoria del messaggio. + L'argomento è interpretato come una maschera binaria, e pertanto è possibile + inviare i messaggi su più categorie alla volta; i valori delle costanti che + identificano ciascuna categoria sono riportati in + \tabref{tab:sess_syslog_facility}, il valore di \param{facility} deve essere + specificato con un OR aritmetico. \begin{table}[htb] \centering @@ -807,19 +807,19 @@ differenza restituita da \code{strerror(errno)}. Gli argomenti seguenti i primi due devono essere forniti secondo quanto richiesto da \func{format}. -L'argomento \param{priority} permette di impostare sia la \textit{facility} -che la \textit{priority} del messaggio. In realtà viene prevalentemente usato -per specificare solo quest'ultima in quanto la prima viene di norma -preimpostata con \func{openlog}. La priorità è indicata con un valore -numerico\footnote{le \acr{glibc}, seguendo POSIX.1-2001, prevedono otto - diverse priorità ordinate da 0 a 7, in ordine di importanza decrescente; - questo comporta che i tre bit meno significativi dell'argomento - \param{priority} sono occupati da questo valore, mentre i restanti bit più - significativi vengono usati per specificare la \textit{facility}.} -specificabile attraverso le costanti riportate in -\secref{tab:sess_syslog_priority}. Nel caso si voglia specificare anche la -\textit{facility} basta eseguire un OR aritmetico del valore della priorità -con la maschera binaria delle costanti di \tabref{tab:sess_syslog_facility}. + L'argomento \param{priority} permette di impostare sia la \textit{facility} + che la \textit{priority} del messaggio. In realtà viene prevalentemente usato + per specificare solo quest'ultima in quanto la prima viene di norma + preimpostata con \func{openlog}. La priorità è indicata con un valore + numerico\footnote{le \acr{glibc}, seguendo POSIX.1-2001, prevedono otto + diverse priorità ordinate da 0 a 7, in ordine di importanza decrescente; + questo comporta che i tre bit meno significativi dell'argomento + \param{priority} sono occupati da questo valore, mentre i restanti bit più + significativi vengono usati per specificare la \textit{facility}.} + specificabile attraverso le costanti riportate in + \secref{tab:sess_syslog_priority}. Nel caso si voglia specificare anche la + \textit{facility} basta eseguire un OR aritmetico del valore della priorità + con la maschera binaria delle costanti di \tabref{tab:sess_syslog_facility}. \begin{table}[htb] \centering @@ -838,13 +838,13 @@ con la maschera binaria delle costanti di \tabref{tab:sess_syslog_facility}. \macro{LOG\_DEBUG} & Messaggio di debug.\\ \hline \end{tabular} -\caption{Valori possibili per l'indice di importanza del messaggio da + \caption{Valori possibili per l'indice di importanza del messaggio da specificare nell'argomento \param{priority} di \func{syslog}.} \label{tab:sess_syslog_priority} \end{table} -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)} @@ -853,12 +853,12 @@ 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 -\secref{tab:sess_syslog_priority}. É disponibile anche la macro +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 +\secref{tab:sess_syslog_priority}. É inoltre disponibile anche la macro \code{LOG\_UPTO(p)} che permette di specificare automaticamente tutte le priorità fino ad un certo valore.