X-Git-Url: https://gapil.gnulinux.it/gitweb/?p=gapil.git;a=blobdiff_plain;f=session.tex;h=8929b418854739ab772b6e32bc435bba72a5fdf9;hp=90ecc4874ba96051fedca43c67b023792fe9ff0c;hb=718a0a24b34dce09e40eafc33c02ae494d100181;hpb=d88ea986fbf6b84a802fd8a5665af4324a6c89b3 diff --git a/session.tex b/session.tex index 90ecc48..8929b41 100644 --- a/session.tex +++ b/session.tex @@ -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 @@ -207,7 +208,7 @@ cui prototipo \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} } @@ -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 @@ -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 - 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. @@ -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