X-Git-Url: https://gapil.gnulinux.it/gitweb/?p=gapil.git;a=blobdiff_plain;f=session.tex;h=80e73394504f08e6e97d86eeccc27023465441b0;hp=653ff75f175b3fe0fb0fce4ec4ff8acd510242fb;hb=d46995abfd6f4e2fcd46cdb8ba369dbb6ba36492;hpb=183df5510f320cede12a4d9595bedca8d30ba7a1 diff --git a/session.tex b/session.tex index 653ff75..80e7339 100644 --- a/session.tex +++ b/session.tex @@ -970,12 +970,12 @@ coda pu abilitato il controllo di flusso in ingresso il driver emette i caratteri di STOP e START per bloccare e sbloccare l'ingresso dei dati; altrimenti i caratteri immessi oltre le dimensioni massime vengono persi; in alcuni casi il -driver provvede ad inviare automaticamente un avviso (un carattere di -\textit{BELL}, che provoca un beep) sull'output quando si eccedono le -dimensioni della coda. Se è abilitato il modo canonico i caratteri in ingresso -restano nella coda fintanto che non viene ricevuto un a capo; un'altra -costante, \macro{MAX\_CANON}, specifica la dimensione massima di una riga in -modo canonico. +driver provvede ad inviare automaticamente un avviso (un carattere di BELL, +che provoca un beep) sull'output quando si eccedono le dimensioni della coda. +Se è abilitato il modo canonico i caratteri in ingresso restano nella coda +fintanto che non viene ricevuto un a capo; un'altra costante, +\macro{MAX\_CANON}, specifica la dimensione massima di una riga in modo +canonico. La coda di uscita è analoga a quella di ingresso e contiene i caratteri scritti dai processi ma non ancora inviati al terminale. Se è abilitato il @@ -989,7 +989,6 @@ provvede automaticamente a bloccare la funzione chiamante. \subsection{La gestione delle caratteristiche di un terminale} \label{sec:term_attr} - Data le loro peculiarità, fin dall'inizio si è posto il problema di come gestire le caratteristiche specifiche dei terminali; storicamente i vari dialetti di Unix hanno utilizzato diverse funzioni, alla fine con POSIX.1, è @@ -1057,39 +1056,20 @@ terminale; essi sono realizzati come maschera binaria, pertanto il tipo opportuna. I valori devono essere specificati bit per bit, avendo cura di non modificare i bit su cui non si interviene. -Il primo flag, \var{c\_iflag}, o flag di input, controlla le modalità -dell'ingresso dei dati sul terminale come il controllo di parità, il controllo -di flusso, la gestione dei caratteri speciali; un elenco dei vari bit, del -loro significato e delle costanti utilizzate per identificarli è riportato in -\tabref{tab:sess_termios_iflag}. - -\begin{table}[htb] +\begin{table}[b!ht] \footnotesize \centering - \begin{tabular}[c]{|l|p{10cm}|} + \begin{tabular}[c]{|l|p{13cm}|} \hline \textbf{Valore}& \textbf{Significato}\\ \hline \hline - \macro{IGNBRK} & Ignora le condizioni di \textit{BREAK} sull'input. Una - \textit{condizione di BREAK} è definita nel contesto di - una trasmissione seriale asincrona come una sequenza di - bit nulli più lunga di un byte. \\ - \macro{BRKINT} & Se si è impostato \macro{IGNBRK} un \textit{BREAK} viene - comunque ignorato. Altrimenti se \macro{BRKINT} è - impostato il \textit{BREAK} causa lo scarico delle code, - e se il terminale è il terminale di controllo per un - gruppo in foreground anche l'invio di \macro{SIGINT} ai - processi di quest'ultimo. Se invece \macro{BRKINT} è - impostato un \textit{BREAK} viene letto come un carattere - \textit{NUL}, a meno che non sia settato \macro{PARMRK} - nel qual caso viene letto come la sequenza di caratteri - \texttt{0xFF 0x00 0x00}.\\ \macro{INPCK} & Abilita il controllo di parità in ingresso. Se non viene impostato non viene fatto nessun controllo ed i caratteri vengono passati in input direttamente.\\ - \macro{IGNPAR} & Ignora gli errori di parità. Ha senso solo se si è - impostato \macro{INPCK}.\\ + \macro{IGNPAR} & Ignora gli errori di parità, il carattere viene passato + come ricevuto. Ha senso solo se si è impostato + \macro{INPCK}.\\ \macro{PARMRK} & Controlla come vengono riportati gli errori di parità. Ha senso solo se \macro{INPCK} è impostato e \macro{IGNPAR} no. Se impostato inserisce una sequenza \texttt{0xFF @@ -1097,16 +1077,58 @@ loro significato e delle costanti utilizzate per identificarli parità, se non impostato un carattere con errori di parità viene letto come uno \texttt{0x00}. Se un carattere ha il valore \texttt{0xFF} e \macro{ISTRIP} - non è settato, per evitare ambiguità esso viene \\ - \macro{ISTRIP} & .\\ - \macro{INLCR} & .\\ - \macro{IGNCR} & .\\ - \macro{ICRNL} & .\\ - \macro{IUCLC} & .\\ - \macro{IXON} & .\\ - \macro{IXANY} & .\\ - \macro{IXOFF} & .\\ - \macro{IMAXBEL}& .\\ + non è settato, per evitare ambiguità esso viene sempre + riportato come \texttt{0xFF 0xFF}.\\ + \macro{ISTRIP} & Se impostato i caratteri in input sono tagliati a sette + bit mettendo a zero il bit più significativo, altrimenti + vengono passati tutti gli otto bit.\\ + \macro{IGNBRK} & Ignora le condizioni di BREAK sull'input. Una + \textit{condizione di BREAK} è definita nel contesto di + una trasmissione seriale asincrona come una sequenza di + bit nulli più lunga di un byte. \\ + \macro{BRKINT} & Controlla la reazione ad un BREAK quando + \macro{IGNBRK} non è impostato. Se \macro{BRKINT} è + impostato il BREAK causa lo scarico delle code, + e se il terminale è il terminale di controllo per un + gruppo in foreground anche l'invio di \macro{SIGINT} ai + processi di quest'ultimo. Se invece \macro{BRKINT} non è + impostato un BREAK viene letto come un carattere + NUL, a meno che non sia settato \macro{PARMRK} + nel qual caso viene letto come la sequenza di caratteri + \texttt{0xFF 0x00 0x00}.\\ + \macro{IGNCR} & Se impostato il carattere di ritorno carrello + (\textit{carriage return}, \verb|'\r'|) viene scartato + dall'input. Può essere utile per i terminali che inviano + entrambi i caratteri di ritorno carrello e a capo + (\textit{newline}, \verb|'\n'|). \\ + \macro{ICRNL} & Se impostato un carattere di ritorno carrello + (\verb|'\r'|) sul terminale viene automaticamente + trasformato in un a capo (\verb|'\n'|) sulla coda di + input. \\ + \macro{INLCR} & Se impostato il carattere di a capo + (\verb|'\n'|) viene automaticamente trasformato in un + ritorno carello (\verb|'\r'|).\\ + \macro{IUCLC} & Se impostato trasforma i caratteri maiuscoli dal + terminale in minuscoli sull'ingresso (opzione non + POSIX).\\ + \macro{IXON} & Se impostato attiva il controllo di flusso in uscita con i + caratteri di START e STOP. se si riceve + uno STOP l'output viene bloccato, e viene fatto + ripartire solo da uno START, e questi due + caratteri non vengono passati alla coda di input. Se non + impostato i due caratteri sono passati alla coda di input + insieme agli altri.\\ + \macro{IXANY} & Se impostato con il controllo di flusso permette a + qualunque carattere di far ripartire l'output bloccato da + un carattere di STOP.\\ + \macro{IXOFF} & Se impostato abilita il controllo di flusso in + ingresso. Il computer emette un carattere di STOP per + bloccare l'input dal terminale e lo sblocca con il + carattere START. \\ + \macro{IMAXBEL}& Se impostato fa suonare il cicalino se si riempie la cosa + di ingresso; in Linux non è implementato e il kernel si + comporta cose se fosse sempre settato (è una estensione + BSD). \\ \hline \end{tabular} \caption{Costanti identificative dei vari bit del flag di controllo @@ -1114,35 +1136,66 @@ loro significato e delle costanti utilizzate per identificarli \label{tab:sess_termios_iflag} \end{table} +Il primo flag, mantenuto nel campo \var{c\_iflag}, è detto \textsl{flag di + input} e controlla le modalità di funzionamento dell'input dei caratteri sul +terminale, come il controllo di parità, il controllo di flusso, la gestione +dei caratteri speciali; un elenco dei vari bit, del loro significato e delle +costanti utilizzate per identificarli è riportato in +\tabref{tab:sess_termios_iflag}. -Il secondo flag, \var{c\_oflag}, o flag di output, controlla le modalità di -output, come l'impacchettamento dei caratteri sullo schermo, la traslazione -degli a capo, la conversione dei caratteri speciali; un elenco dei vari bit, -del loro significato e delle costanti utilizzate per identificarli è riportato -in \tabref{tab:sess_termios_oflag}. +Si noti come alcuni di questi flag (come quelli per la gestione del flusso) +fanno riferimento a delle caratteristiche che ormai sono completamente +obsolete; la maggior parte inoltre è tipica di terminali seriali, e non ha +alcun effetto su dispositivi diversi come le console virtuali o gli +pseudo-terminali usati nelle connessioni di rete. \begin{table}[htb] \footnotesize \centering - \begin{tabular}[c]{|l|p{10cm}|} + \begin{tabular}[c]{|l|p{13cm}|} \hline \textbf{Valore}& \textbf{Significato}\\ \hline \hline - \macro{OPOST} & . \\ - \macro{OLCUC} & .\\ - \macro{ONLCR} & .\\ - \macro{OCRNL} & .\\ - \macro{ONOCR} & .\\ - \macro{ONLRET} & .\\ - \macro{OFILL} & . \\ - \macro{OFDEL} & .\\ - \macro{NLDLY} & .\\ - \macro{CRDLY} & .\\ - \macro{TABDLY} & .\\ - \macro{BSDLY} & .\\ - \macro{VTDLY} & .\\ - \macro{FFDLY} & .\\ + \macro{OPOST} & Se impostato i caratteri vengono convertiti opportunamente + (in maniera dipendente dall'implementazione) per la + visualizzazione sul terminale, ad esempio al + carattere di a capo (NL) può venire aggiunto un ritorno + carrello (CR).\\ + \macro{OCRNL} & Se impostato converte automaticamente il carattere di a + capo (NL) nella coppia di caratteri ritorno carrello, a + capo (CR-NL).\\ + \macro{OLCUC} & Se impostato trasforma i caratteri minuscoli in ingresso + in caratteri maiuscoli sull'uscita (non previsto da + POSIX.1).\\ + \macro{ONLCR} & Se impostato converte automaticamente il carattere di a + capo (NL) in un carattere di ritorno carrello (CR).\\ + \macro{ONOCR} & Se impostato converte il carattere di ritorno carrello + (CR) nella coppia di caratteri CR-NL.\\ + \macro{ONLRET}& Se impostato rimuove dall'output il carattere di ritorno + carrello (CR).\\ + \macro{OFILL} & Se impostato in caso di ritardo sulla linea invia dei + caratteri di riempimento invece di attendere.\\ + \macro{OFDEL} & Se impostato il carattere di riempimento è DEL + (\texttt{0x3F}), invece che NUL (\texttt{0x00}).\\ + \macro{NLDLY} & Maschera per i bit che indicano il ritardo per il + carattere di a capo (NL), i valori possibili sono + \macro{NL0} o \macro{NL1}.\\ + \macro{CRDLY} & Maschera per i bit che indicano il ritardo per il + carattere ritorno carrello (CR), i valori possibili sono + \macro{CR0}, \macro{CR1}, \macro{CR2} o \macro{CR3}.\\ + \macro{TABDLY}& Maschera per i bit che indicano il ritardo per il + carattere di tabulazione, i valori possibili sono + \macro{TAB0}, \macro{TAB1}, \macro{TAB2} o \macro{TAB3}.\\ + \macro{BSDLY} & Maschera per i bit che indicano il ritardo per il + carattere di ritorno indietro (\textit{backspace}), i + valori possibili sono \macro{BS0} o \macro{BS1}.\\ + \macro{VTDLY} & Maschera per i bit che indicano il ritardo per il + carattere di tabulazione verticale, i valori possibili sono + \macro{VT0} o \macro{VT1}.\\ + \macro{FFDLY} & Maschera per i bit che indicano il ritardo per il + carattere di pagina nuova (\textit{form feed}), i valori + possibili sono \macro{FF0} o \macro{FF1}.\\ \hline \end{tabular} \caption{Costanti identificative dei vari bit del flag di controllo @@ -1150,32 +1203,89 @@ in \tabref{tab:sess_termios_oflag}. \label{tab:sess_termios_oflag} \end{table} -Il terzo flag, \var{c\_cflag}, o flag di controllo è legato al funzionamento -delle linee seriali permette di impostarne varie caratteristiche, come il -numero di bit di stop, i settaggi della parità, il funzionamento del controllo -di flusso; un elenco dei vari bit, del loro significato e delle costanti -utilizzate per identificarli è riportato in \tabref{tab:sess_termios_cflag}. +Il secondo flag, mantenuto nel campo \var{c\_oflag}, è detto \textsl{flag di + output} e controlla le modalità di funzionamento dell'output dei caratteri, +come l'impacchettamento dei caratteri sullo schermo, la traslazione degli a +capo, la conversione dei caratteri speciali; un elenco dei vari bit, del loro +significato e delle costanti utilizzate per identificarli è riportato in +\tabref{tab:sess_termios_oflag}. + +Si noti come alcuni dei valori riportati in \tabref{tab:sess_termios_oflag} +fanno riferimento a delle maschere di bit; essi infatti vengono utilizzati per +impostare alcuni valori numerici relativi ai ritardi nell'output di alcuni +caratteri: una caratteristica originaria dei primi terminali su telescrivente, +che avevano bisogno di tempistiche diverse per spostare il carrello in +risposta ai caratteri speciali, e che oggi sono completamente in disuso. + +Si tenga presente inoltre che nel caso delle maschere il valore da inserire in +\var{c\_oflag} deve essere fornito avendo cura di cancellare prima tutti i bit +della maschera, i valori da immettere infatti (quelli riportati nella +spiegazione corrispondente) sono numerici e non per bit, per cui possono +sovrapporsi fra di loro. Occorrerà perciò utilizzare un codice del tipo: + +\begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}% + c_oflag &= (~CRDLY); + c_oflag |= CR1; +\end{lstlisting} + +\noindent che prima cancella i bit della maschera in questione e poi setta il +valore. + \begin{table}[htb] \footnotesize \centering - \begin{tabular}[c]{|l|p{10cm}|} + \begin{tabular}[c]{|l|p{13cm}|} \hline \textbf{Valore}& \textbf{Significato}\\ \hline \hline - \macro{CBAUD} & . \\ - \macro{CBAUDEX} & .\\ - \macro{CSIZE} & .\\ - \macro{CSTOPB} & .\\ - \macro{CREAD} & .\\ - \macro{PARENB} & .\\ - \macro{PARODD} & . \\ - \macro{HUPCL} & .\\ - \macro{CLOCAL} & .\\ - \macro{LOBLK} & .\\ - \macro{CIBAUD} & .\\ - \macro{CRTSCTS} & .\\ + \macro{CLOCAL} & Se impostato indica che il terminale è connesso in locale + e che le linee di controllo del modem devono essere + ignorate. Se non impostato effettuando una chiamata ad + \func{open} senza aver specificato il flag di + \macro{O\_NOBLOCK} si bloccherà il processo finché + non si è stabilita una connessione con il modem; inoltre + se viene rilevata una disconessione viene inviato un + \macro{SIGHUP} al processo di controllo del terminale. La + lettura su un terminale sconnesso comporta una condizione + di \textit{end of file} e la scrittura un errore di + \macro{EIO}. \\ + \macro{HUPCL} & Se è impostato viene distaccata la connessione del + modem quando l'ultimo dei processi che ha ancora un file + aperto sul terminale lo chiude o esce.\\ + \macro{CREAD} & Se è impostato si può leggere l'input del terminale, + altrimenti i caratteri in ingresso vengono scartati + quando arrivano.\\ + \macro{CSTOPB} & Se impostato vengono usati due bit di stop sulla linea + seriale, se non impostato ne viene usato soltanto uno.\\ + \macro{PARENB} & Se impostato abilita la generazione il controllo di + parità. La reazione in caso di errori dipende dai + relativi valori per \var{c\_iflag}, riportati in + \tabref{tab:sess_termios_iflag}. Se non è impostato i bit + di parità non vengono + generati e i caratteri non vengono controllati.\\ + \macro{PARODD} & Ha senso solo se è attivo anche \macro{PARENB}. Se + impostato viene usata una parità è dispari, altrimenti + viene usata una parità pari.\\ + \macro{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 \macro{CS5}, \macro{CS6}, + \macro{CS7} e \macro{CS8} + corripondenti ad un analogo numero di bit.\\ + \macro{CBAUD} & Maschera dei bit (4+1) usati per impostare della velocità + della linea (il \textit{baud rate}) in ingresso. + In Linux non è implementato in quanto viene + usato un apposito campo di \var{termios}.\\ + \macro{CBAUDEX}& Bit aggiuntivo per l'impostazione della velocità della + linea, per le stesse motivazioni del precedente non è + implementato in Linux.\\ + \macro{CIBAUD} & Maschera dei bit della velocità della linea in + ingresso. Analogo a \macro{CBAUD}, anch'esso in Linux è + mantenuto in un apposito campo di \var{termios}. \\ + \macro{CRTSCTS}& Abilita il controllo di flusso hardware sulla seriale, + attraverso l'utilizzo delle dei due fili di RTS e CTS.\\ \hline \end{tabular} \caption{Costanti identificative dei vari bit del flag di controllo @@ -1183,37 +1293,96 @@ utilizzate per identificarli \label{tab:sess_termios_cflag} \end{table} - -Il quarto flag, \var{c\_lflag}, o flag locale, serve per modificare il -funzionamento dell'interfaccia fra il driver e l'utente, come abilitare l'eco, -controllare l'emissione dei segnali generati dal terminale, attivare i -caratteri per il job control; un elenco dei vari bit, del loro significato e -delle costanti utilizzate per identificarli è riportato in -\tabref{tab:sess_termios_lflag}. - -\begin{table}[htb] +Il terzo flag, mantenuto nel campo \var{c\_cflag}, è detto \textsl{flag di + controllo} ed è legato al funzionamento delle linee seriali, permettendo di +impostarne varie caratteristiche, come il numero di bit di stop, i settaggi +della parità, il funzionamento del controllo di flusso; esso ha senso solo per +i terminali connessi a linee seriali. Un elenco dei vari bit, del loro +significato e delle costanti utilizzate per identificarli è riportato in +\tabref{tab:sess_termios_cflag}. + +I valori di questo flag sono molto specifici, e completamente indirizzati al +controllo di un terminale mantenuto su una linea seriale; essi pertanto non +hanno nessuna rilevanza per i terminali che usano un'altra interfaccia, come +le console virtuali e gli pseudo-terminali usati dalle connessioni di rete. + +Inoltre alcuni valori sono previsti solo per quelle implementazioni (lo +standard POSIX non specifica nulla riguardo l'implementazione, ma solo delle +funzioni di lettura e scrittura) che mantengono le velocità delle linee +seriali all'interno dei flag; come accennato in Linux questo viene fatto +(seguendo l'esempio di BSD) attraverso due campi aggiuntivi, \var{c\_ispeed} e +\var{c\_ospeed}, nella struttura \var{termios} (non mostrati in +\secref{fig:term_termios}). + +\begin{table}[b!ht] \footnotesize \centering - \begin{tabular}[c]{|l|p{10cm}|} + \begin{tabular}[c]{|l|p{13cm}|} \hline \textbf{Valore}& \textbf{Significato}\\ \hline \hline - \macro{ISIG} & . \\ - \macro{ICANON} & .\\ - \macro{XCASE} & .\\ - \macro{ECHO} & .\\ - \macro{ECHOE} & .\\ - \macro{ECHOK} & .\\ - \macro{ECHONL} & . \\ - \macro{ECHOPRT} & .\\ - \macro{ECHOKE} & .\\ - \macro{DEFECHO} & .\\ - \macro{FLUSHO} & .\\ - \macro{NOFLSH} & .\\ - \macro{TOSTOP} & .\\ - \macro{PENDIN} & .\\ - \macro{IEXTEN} & .\\ + \macro{ICANON} & Se impostato il terminale opera in modo canonico, + altrimenti opera in modo non canonico.\\ + \macro{ECHO} & Se è impostato viene attivato l'eco dei caratteri in + input sull'output del terminale.\\ + \macro{ECHOE} & Se è impostato l'eco mostra la cancellazione di un + carattere in input (in reazione al carattere ERASE) + cancellando l'ultimo carattere della riga corrente dallo + schermo; altrimenti il carattere è rimandato in eco per + mostrare quanto accaduto (usato per i terminali con + l'uscita su una stampante). \\ + \macro{ECHOPRT}& Se impostato abilita la visualizzazione del carattere di + cancellazione in una modalità adatta ai terminali con + l'uscita su stampante; l'invio del carattere di ERASE + comporta la stampa di un \verb|\| seguito dal carattere + cancellato, e così via in caso di successive + cancellazioni, quando si riprende ad immettere carattere + normali prima verrà stampata una \texttt{/}.\\ + \macro{ECHOK} & Se impostato abilita il trattamento della visualizzazione + del carattere KILL, andando a capo dopo aver visualizzato + lo stesso, altrimenti viene solo mostrato il carattere e + sta all'utente ricordare che l'input precedente è stato + cancellato. \\ + \macro{ECHOKE} & Se impostato abilita il trattamento della visualizzazione + del carattere KILL cancellando i caratteri precedenti + nella linea secondo le modalità specificate dai valori di + \macro{ECHOE} e \macro{ECHOPRT}.\\ + \macro{ECHONL} & Se impostato viene effettuato l'eco di un a + capo (\verb|\n|) anche se non è stato impostato + \macro{ECHO}. \\ + \macro{ECHOCTL}& Se impostato insieme ad \macro{ECHO} i caratteri di + controllo ASCII (tranne TAB, NL, START, e STOP) sono + mostrati nella forma che prepende un \verb|^| alla + lettera ottenuta sommando \texttt{0x40} al valore del + carattere (di solito questi si possono ottenere anche + direttamente premendo il tasto \texttt{ctrl} più la + relativa lettera).\\ + \macro{ISIG} & Se impostato abilita il riconoscimento dei caratteri + INTR, QUIT, e SUSP generando il relativo segnale.\\ + \macro{IEXTEN} & Abilita alcune estensioni previste dalla + implementazione. Deve essere impostato perché caratteri + speciali come EOL2, LNEXT, REPRINT e WERASE possano + essere interpretati. \\ + \macro{NOFLSH} & Se impostato disabilita lo scarico delle code di ingresso + e uscita quando vengono emessi i segnali \macro{SIGINT}, + \macro{SIGQUIT} and \macro{SIGSUSP}.\\ + \macro{TOSTOP} & Se abilitato, con il supporto per il job control presente, + genera il segnale \macro{SIGTTOU} per un processo in + background che cerca di scrivere sul terminale.\\ + \macro{XCASE} & Se settato il terminale funziona solo con le + maiuscole. L'input è convertito in minuscole tranne per i + caratteri preceduti da una \verb|\|. In output le + maiuscole sono precedute da una \verb|\| e le minuscole + convertite in maiuscole.\\ + \macro{DEFECHO}& Se impostate effettua l'eco solo se c'è un processo in + lettura.\\ + \macro{FLUSHO} & Effettua la cancellazione della coda di uscita. Viene + attivato dal carattere DISCARD. Non è supportato in + Linux.\\ + \macro{PENDIN} & Indica che la linea deve essere ristampata, viene + attivato dal carattere REPRINT e resta attivo fino alla + fine della ristampa. Non è supportato in Linux.\\ \hline \end{tabular} \caption{Costanti identificative dei vari bit del flag di controllo @@ -1221,15 +1390,258 @@ delle costanti utilizzate per identificarli \label{tab:sess_termios_lflag} \end{table} +Il quarto flag, mantenuto nel campo \var{c\_lflag}, è detto \textsl{flag + locale}, e serve per controllare il funzionamento dell'interfaccia fra il +driver e l'utente, come abilitare l'eco, gestire i caratteri di controllo e +l'emissione dei segnali, impostare modo canonico o non canonico; un elenco dei +vari bit, del loro significato e delle costanti utilizzate per identificarli è +riportato in \tabref{tab:sess_termios_lflag}. + +Si tenga presente che i flag che riguardano le modalità di eco dei caratteri +(\macro{ECHOE}, \macro{ECHOPRT}, \macro{ECHOK}, \macro{ECHOKE}, +\macro{ECHONL}) controllano solo il comportamento della visualizzazione, il +riconoscimento dei vari caratteri dipende dalla modalità di operazione, ed +avviene solo in modo canonico, pertanto questi flag non hanno significato se +non è impostato \macro{ICANON}. + +Con i terminali odierni l'unico flag con cui probabilmente si può avere a che +fare è questo, che è l'unico che concerne le caratteristiche generiche comuni +a tutti i terminali. + +Per impostare tutti questi flag lo standard POSIX prevede due funzioni: +\func{tcgetattr} e \func{tcsetattr}; entrambe prendono come parametro un +puntatore ad struttura \var{termios} che deve essere oportunamente +inizializzata, il loro prototipo è: +\begin{functions} + \headdecl{unistd.h} + \headdecl{termios.h} + \funcdecl{int tcgetattr(int fd, struct termios *termios\_p)} + Legge il valore delle impostazioni di un terminale. + + \funcdecl{int tcsetattr(int fd, int optional\_actions, struct termios + *termios\_p)} + Scrive le impostazioni di un terminale. + + \bodydesc{Entrambe le funzioni restituiscono 0 in caso di successo e -1 in + caso di errore, nel qual caso \var{errno} assumerà i valori: + \begin{errlist} + \item[\macro{EINTR}] La funzione è stata interrotta. + \end{errlist} + ed inoltre \macro{EBADF}, \macro{ENOTTY} ed \macro{EINVAL}. + } +\end{functions} + +Le funzioni operano sul terminale identificato dal file descriptor \param{fd} +utilizzando la struttura specificata dal puntatore \param{termios\_p} per lo +scambio dei dati. Come già accennato i valori di ciascun bit devono essere +specificati avendo cura di mantenere intatti gli altri; per questo motivo in +generale si deve prima leggere il valore corrente delle impostazioni con +\func{tcgetattr} per poi modificare i valori impostati. + +In \figref{fig:term_set_attr} si è riportato il codice delle due funzioni +\func{SetTermAttr} e \func{UnSetTermAttr} che possono essere usate +rispettivamente per impostare o rimuovere un qualunque bit di \var{c\_lflag}, +con le dovute precauzioni. Il codice di entrambe le funzioni può essere +trovato nel file \file{SetTermAttr.c} dei sorgenti allegati. + +\begin{figure}[!htb] + \footnotesize + \begin{lstlisting}{}% +#include +#include +#include + +int SetTermAttr(int fd, tcflag_t flag) +{ + struct termios values; + int res; + + res = tcgetattr (desc, &values); + if (res) { + perror("Cannot get attributes"); + return res; + } + values.c_lflag |= flag; + res = tcsetattr (desc, TCSANOW, &values); + if (res) { + perror("Cannot set attributes"); + return res; + } + return 0; +} +int UnSetTermAttr(int fd, tcflag_t flag) +{ + struct termios values; + int res; + + res = tcgetattr (desc, &values); + if (res) { + perror("Cannot get attributes"); + return res; + } + values.c_lflag &= (~flag); + res = tcsetattr (desc, TCSANOW, &values); + if (res) { + perror("Cannot set attributes"); + return res; + } + return 0; +} + \end{lstlisting} + \caption{Codice delle funzioni \func{SetTermAttr} e \func{UnSetTermAttr} per + impostare o rimuovere uno dei flag di controllo locale del terminale.} + \label{fig:term_set_attr} +\end{figure} + +La prima funzione provvede ad impostare il bit specificato dall'argomento +\param{flag}; prima si leggono i valori correnti (\texttt{\small 10}) con +\func{tcgetattr}, uscendo con un messaggio in caso di errore (\texttt{\small + 11--14}), poi si provvede a impostare solo i bit richiesti (possono essere +più di uno) con un OR binario (\texttt{\small 15}); infine si scrive il nuovo +valore modificato con \func{tcsetattr} (\texttt{\small 16}), notificando un +eventuale errore (\texttt{\small 11--14}) o uscendo normalmente. + +La seconda funzione è identica alla prima, solo che in questo caso +(\texttt{\small 33}) si rimuovono i bit specificati dall'argomento +\param{flag} usando un AND binario del valore negato. + +La funzione \func{tcsetattr} prevede tre diverse modalità di funzionamento, +specificabili attraverso l'argomento \param{optional\_actions}, che permette +di stabilire come viene eseguito il cambiamento delle impostazioni del +terminale, i valori possibili sono riportati in +\ref{tab:sess_tcsetattr_option}; di norma (come fatto per le due funzioni di +esempio) si usa sempre \macro{TCSANOW}, le altre opzioni possono essere utili +qualora si cambino i parametri di output. + +\begin{table}[htb] + \footnotesize + \centering + \begin{tabular}[c]{|l|p{8cm}|} + \hline + \textbf{Valore}& \textbf{Significato}\\ + \hline + \hline + \macro{TCSANOW} & Esegue i cambiamenti in maniera immediata. \\ + \macro{TCSADRAIN}& I cambiamenti vengono eseguiti dopo aver atteso che + tutto l'output presente sulle code è stato scritto. \\ + \macro{TCSAFLUSH}& È identico a \macro{TCSADRAIN}, ma in più scarta + tutti i dati presenti sulla coda di input.\\ + \hline + \end{tabular} + \caption{Possibili valori per l'argomento \param{optional\_actions} della + funzione \func{tcsetattr}.} + \label{tab:sess_tcsetattr_option} +\end{table} + +Infine occorre tenere presente che \func{tcsetattr} ritorna con successo anche +se soltanto uno dei cambiamenti richiesti è stato eseguito. Pertanto se si +effettuano più cambiamenti è buona norma controllare con una ulteriore +chiamata a \func{tcgetattr} che essi siano stati eseguiti tutti quanti. + +Oltre ai vari flag per gestire le varie caratteristiche dei terminali, +\var{termios} contiene pure il campo \var{c\_cc} che viene usato per impostare +i caratteri speciali associati alle varie funzioni di controllo. Il numero di +questi caratteri speciali è indicato dalla costante \macro{NCCS}, POSIX ne +specifica almeno 11, ma molte implementazioni ne definiscono molti +altri.\footnote{in Linux il valore della costante è 32, anche se i caratteri + effettivamente definiti sono solo 17.} + +\begin{table}[htb] + \footnotesize + \centering + \begin{tabular}[c]{|l|c|c|p{9cm}|} + \hline + \textbf{Indice} & \textbf{Valore}&\textbf{Codice} & \textbf{Funzione}\\ + \hline + \hline + \macro{VINTR} &\texttt{0x03}&(\verb|C-c|)& Carattere di interrupt, + provoca l'emissione di + \macro{SIGINT}. \\ + \macro{VQUIT} &\texttt{0x1C}&(\verb|C-\|)& Carattere di uscita provoca + l'emissione di + \macro{SIGQUIT}.\\ + \macro{VERASE} &\texttt{0x7f}& DEL & Carattere di ERASE, cancella + l'ultimo carattere precedente + nella linea.\\ + \macro{VKILL} &\texttt{0x15}&(\verb|C-u|)& Carattere di KILL, cancella + l'intera riga.\\ + \macro{VEOF} &\texttt{0x04}&(\verb|C-d|)& Carattere di + \textit{end-of-file}. Causa + l'invio del contenuto del + buffer di ingresso al + processo in lettura anche se + non è ancora stato ricevuto + un a capo. Se è il primo + carattere immesso comporta il + ritorno di \func{read} con + zero caratteri, cioè la + condizione di + \textit{end-of-file}.\\ + \macro{VTIME} & --- & --- & Timeout, in decimi di secondo, per + una lettura in modo non canonico. \\ + \macro{VMIN} & --- & --- & Numero minimo di caratteri per una + lettura in modo non canonico.\\ + \macro{VSWTC} &\texttt{0x00}& NUL & Carattere di switch. Non supportato + in Linux.\\ + \macro{VSTART} &\texttt{0x21}&(\verb|C-q|)& Carattere di START. Riavvia un + output bloccato da uno STOP.\\ + \macro{VSTOP} &\texttt{0x23}&(\verb|C-s|)& Carattere di STOP. Blocca + l'output fintanto che non + viene premuto un carattere di + START.\\ + \macro{VSUSP} &\texttt{0x1A}&(\verb|C-z|)& Carattere di + sospensione. Invia il segnale + \macro{SIGTSTP}.\\ + \macro{VEOL} &\texttt{0x00}& NUL & Carattere di fine riga. Agisce come + un a capo, ma non viene scartato ed + è letto come l'ultimo carattere + nella riga. \\ + \macro{VREPRINT}&\texttt{0x12}&(\verb|C-r|)& Ristampa i caratteri non + ancora letti. \\ + \macro{VDISCARD}&\texttt{0x07}&(\verb|C-o|)& Non riconosciuto in Linux. \\ + \macro{VWERASE} &\texttt{0x17}&(\verb|C-w|)& Cancellazione di una parola.\\ + \macro{VLNEXT} &\texttt{0x16}&(\verb|C-v|)& Carattere di escape, serve a + quotare il carattere + successivo che non viene + interpretato ma passato + direttamente all'output. \\ + \macro{VEOL2} &\texttt{0x00}& NUL & Ulteriore carattere di fine + riga. Ha lo stesso effetto di + \macro{VEOL} ma può essere un + carattere diverso. \\ + \hline + \end{tabular} + \caption{Valori dei caratteri di controllo mantenuti nel campo \var{c\_cc} + della struttura \var{termios}.} + \label{tab:sess_termios_cc} +\end{table} + + +A ciascuna di queste funzioni di controllo corriponde un elemento del vettore +\var{c\_cc} che specifica quale è il carattere speciale associato; per +portabilità invece di essere indicati con la loro posizione numerica, i vari +elementi vengono indicizzati attraverso delle opportune costanti il cui nome +corrisponde all'azione ad essi associata. Un elenco completo dei caratteri di +controllo, con le costanti e delle funzionalità associate è riportato in +\tabref{tab:sess_termios_cc}, usando quelle definizioni diventa possibile +assegnare un nuovo carattere di controllo con un codice del tipo: +\begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}% + value.c_cc[VEOL2] = '\n'; +\end{lstlisting} +\noindent e si potrà poi ricorrere a \func{tcsetattr} per rendere effettiva la +nuova impostazione. +Come già accennato POSIX.1 prevede due funzioni da utilizzare esplicitamente +per settare la velocità delle linee seriali, \func{cfsetispeed} e +\func{cfsetospeed} \subsection{Il \textsl{modo canonico}} \label{sec:term_canonic_mode} -Il modo canonico +Il modo canonico \subsection{Il \textsl{modo non canonico}}