Inserite nuove macro per la indicizzazione della definizione delle funzioni
[gapil.git] / session.tex
1 %% session.tex
2 %%
3 %% Copyright (C) 2000-2002 Simone Piccardi.  Permission is granted to
4 %% copy, distribute and/or modify this document under the terms of the GNU Free
5 %% Documentation License, Version 1.1 or any later version published by the
6 %% Free Software Foundation; with the Invariant Sections being "Prefazione",
7 %% with no Front-Cover Texts, and with no Back-Cover Texts.  A copy of the
8 %% license is included in the section entitled "GNU Free Documentation
9 %% License".
10 %%
11 \chapter{Terminali e sessioni di lavoro}
12 \label{cha:session}
13
14 I terminali per lungo tempo tempo sono stati l'unico modo per accedere al
15 sistema, per questo anche oggi che esistono molte altre interfacce, essi
16 continuano a coprire un ruolo particolare, restando strettamente legati al
17 funzionamento dell'interfaccia a linea di comando.
18
19 Nella prima parte del capitolo esamineremo i concetti base del sistema delle
20 sessioni di lavoro, vale a dire il metodo con cui il kernel permette ad un
21 utente di gestire le capacità multitasking del sistema, permettendo di
22 eseguire più programmi in contemporanea.  Nella seconda parte del capitolo
23 tratteremo poi il funzionamento dell'I/O su terminale, e delle varie
24 peculiarità che esso viene ad assumere a causa del suo stretto legame con il
25 suo uso come interfaccia di accesso al sistema da parte degli utenti.
26
27
28 \section{Il \textit{job control}}
29 \label{sec:sess_job_control}
30
31 Viene comunemente chiamato \textit{job control} quell'insieme di funzionalità
32 il cui scopo è quello di permettere ad un utente di poter sfruttare le
33 capacità multitasking di un sistema Unix per eseguire in contemporanea più
34 processi, pur potendo accedere, di solito, ad un solo terminale,\footnote{con
35   X e con i terminali virtuali tutto questo non è più vero, dato che si può
36   accedere a molti terminali in contemporanea da una singola postazione di
37   lavoro, ma il sistema è nato prima dell'esistenza di tutto ciò.} avendo cioè
38 un solo punto in cui si può avere accesso all'input ed all'output degli
39 stessi.
40
41
42 \subsection{Una panoramica introduttiva}
43 \label{sec:sess_job_control_overview}
44
45 Il \textit{job control} è una caratteristica opzionale, introdotta in BSD
46 negli anni '80, e successivamente standardizzata da POSIX.1; la sua
47 disponibilità nel sistema è verificabile attraverso il controllo della macro
48 \macro{\_POSIX\_JOB\_CONTROL}. In generale il \textit{job control} richiede il
49 supporto sia da parte della shell (quasi tutte ormai lo fanno), che da parte
50 del kernel; in particolare il kernel deve assicurare sia la presenza di un
51 driver per i terminali abilitato al \textit{job control} che quella dei
52 relativi segnali illustrati in \secref{sec:sig_job_control}. 
53
54 In un sistema che supporta il \textit{job control}, una volta completato il
55 login, l'utente avrà a disposizione una shell dalla quale eseguire i comandi e
56 potrà iniziare quella che viene chiamata una \textsl{sessione}, che riunisce
57 (vedi \secref{sec:sess_proc_group}) tutti i processi eseguiti all'interno
58 dello stesso login (esamineremo tutto il processo in dettaglio in
59 \secref{sec:sess_login}).
60
61 Siccome la shell è collegata ad un solo terminale, che viene usualmente
62 chiamato \textsl{terminale di controllo}, (vedi \secref{sec:sess_ctrl_term})
63 un solo comando alla volta (quello che viene detto in \textit{foreground}),
64 potrà scrivere e leggere dal terminale. La shell però può eseguire anche più
65 comandi in contemporanea, mandandoli in \textit{background} (aggiungendo una
66 \cmd{\&} alla fine del comando), nel qual caso essi saranno eseguiti senza
67 essere collegati al terminale.
68
69 Si noti come si sia parlato di comandi e non di programmi o processi; fra le
70 funzionalità della shell infatti c'è anche quella di consentire di concatenare
71 più programmi in una sola riga di comando con le pipe, ed in tal caso verranno
72 eseguiti più programmi, inoltre, anche quando si invoca un singolo programma,
73 questo potrà sempre lanciare sottoprocessi per eseguire dei compiti specifici.
74
75 Per questo l'esecuzione di un comando può originare più di un processo; quindi
76 nella gestione del job control non si può far riferimento ai singoli processi.
77 Per questo il kernel prevede la possibilità di raggruppare più processi in un
78 \textit{process group} (detto anche \textsl{raggruppamento di processi}, vedi
79 \secref{sec:sess_proc_group}) e la shell farà sì che tutti i processi che
80 originano da una riga di comando appartengano allo stesso raggruppamento, in
81 modo che le varie funzioni di controllo, ed i segnali inviati dal terminale,
82 possano fare riferimento ad esso.
83
84 In generale allora all'interno di una sessione avremo un eventuale (può non
85 esserci) \textit{process group} in \textit{foreground}, che riunisce i
86 processi che possono accedere al terminale, e più \textit{process group} in
87 \textit{background}, che non possono accedervi. Il job control prevede che
88 quando un processo appartenente ad un raggruppamento in \textit{background}
89 cerca di accedere al terminale, venga inviato un segnale a tutti i processi
90 del raggruppamento, in modo da bloccarli (vedi \secref{sec:sess_ctrl_term}).
91
92 Un comportamento analogo si ha anche per i segnali generati dai comandi di
93 tastiera inviati dal terminale che vengono inviati a tutti i processi del
94 raggruppamento in \textit{foreground}. In particolare \cmd{C-z} interrompe
95 l'esecuzione del comando, che può poi essere mandato in \textit{background}
96 con il comando \cmd{bg}.\footnote{si tenga presente che \cmd{bg} e \cmd{fg}
97   sono parole chiave che indicano comandi interni alla shell, e nel caso non
98   comportano l'esecuzione di un programma esterno.} Il comando \cmd{fg}
99 consente invece di mettere in \textit{foreground} un comando precedentemente
100 lanciato in \textit{background}.
101
102 Di norma la shell si cura anche di notificare all'utente (di solito prima
103 della stampa a video del prompt) lo stato dei vari processi; essa infatti sarà
104 in grado, grazie all'uso di \func{waitpid}, di rilevare sia i processi che
105 sono terminati, sia i raggruppamenti che sono bloccati (in questo caso usando
106 l'opzione \const{WUNTRACED}, secondo quanto illustrato in
107 \secref{sec:proc_wait}).
108
109
110 \subsection{I \textit{process group} e le \textsl{sessioni}}
111 \label{sec:sess_proc_group}
112
113 Come accennato in \secref{sec:sess_job_control_overview} nel job control i
114 processi vengono raggruppati in \textit{process group} e \textit{sessioni};
115 per far questo vengono utilizzati due ulteriori identificatori (oltre quelli
116 visti in \secref{sec:proc_pid}) che il kernel associa a ciascun
117 processo:\footnote{in Linux questi identificatori sono mantenuti nei campi
118   \var{pgrp} e \var{session} della struttura \struct{task\_struct} definita in
119   \file{sched.h}.}  l'identificatore del \textit{process group} e
120 l'identificatore della \textsl{sessione}, che vengono indicati rispettivamente
121 con le sigle \acr{pgid} e \acr{sid}, e sono mantenuti in variabili di tipo
122 \type{pid\_t}. I valori di questi identificatori possono essere visualizzati
123 dal comando \cmd{ps} usando l'opzione \cmd{-j}.
124
125 Un \textit{process group} è pertanto definito da tutti i processi che hanno lo
126 stesso \acr{pgid}; è possibile leggere il valore di questo identificatore con
127 le funzioni \func{getpgid} e \func{getpgrp},\footnote{\func{getpgrp} è
128   definita nello standard POSIX.1, mentre \func{getpgid} è richiesta da SVr4.}
129 i cui prototipi sono:
130 \begin{functions}
131   \headdecl{unistd.h}
132
133   \funcdecl{pid\_t getpgid(pid\_t pid)} 
134   Legge il \acr{pgid} del processo \param{pid}.
135
136   \funcdecl{pid\_t getpgrp(void)}
137   Legge il \acr{pgid} del processo corrente.
138   
139   \bodydesc{Le funzioni restituiscono il \acr{pgid} del processo,
140     \func{getpgrp} ha sempre successo, mentre \func{getpgid} restituisce -1
141     ponendo \var{errno} a \errval{ESRCH} se il processo selezionato non
142     esiste.}
143 \end{functions}
144
145 La funzione \func{getpgid} permette di specificare il \acr{pid} del processo
146 di cui si vuole sapere il \acr{pgid}; un valore nullo per \param{pid}
147 restituisce il \acr{pgid} del processo corrente; \func{getpgrp} è di norma
148 equivalente a \code{getpgid(0)}.
149
150 In maniera analoga l'identificatore della sessione può essere letto dalla
151 funzione \func{getsid}, che però nelle \acr{glibc}\footnote{la system call è
152   stata introdotta in Linux a partire dalla versione 1.3.44, il supporto nelle
153   librerie del C è iniziato dalla versione 5.2.19. La funzione non è prevista
154   da POSIX.1, che parla solo di processi leader di sessione, e non di
155   identificatori di sessione.} è accessibile solo definendo
156 \macro{\_XOPEN\_SOURCE} e \macro{\_XOPEN\_SOURCE\_EXTENDED}; il suo prototipo
157 è:
158 \begin{prototype}{unistd.h}{pid\_t getsid(pid\_t pid)}
159   Legge l'identificatore di sessione del processo \param{pid}.
160   
161   \bodydesc{La funzione restituisce l'identificatore (un numero positivo) in
162   caso di successo, e -1 in caso di errore, nel qual caso \var{errno} assumerà
163   i valori:
164     \begin{errlist}
165     \item[\errcode{ESRCH}] Il processo selezionato non esiste.
166     \item[\errcode{EPERM}] In alcune implementazioni viene restituito quando il
167       processo selezionato non fa parte della stessa sessione del processo
168       corrente.
169     \end{errlist}
170   }
171 \end{prototype}
172
173 Entrambi gli identificatori vengono inizializzati alla creazione di ciascun
174 processo con lo stesso valore che hanno nel processo padre, per cui un
175 processo appena creato appartiene sempre allo stesso raggruppamento e alla
176 stessa sessione del padre. Vedremo poi come sia possibile creare più
177 \textit{process group} all'interno della stessa sessione, e spostare i
178 processi dall'uno all'altro, ma sempre all'interno di una stessa sessione.
179
180 Ciascun raggruppamento di processi ha sempre un processo principale, il
181 cosiddetto \textit{process group leader}, che è identificato dall'avere un
182 \acr{pgid} uguale al suo \acr{pid}, in genere questo è il primo processo del
183 raggruppamento, che si incarica di lanciare tutti gli altri. Un nuovo
184 raggruppamento si crea con la funzione \func{setpgrp},\footnote{questa è la
185   definizione di POSIX.1, BSD definisce una funzione con lo stesso nome, che
186   però è identica a \func{setpgid}; nelle \acr{glibc} viene sempre usata
187   sempre questa definizione, a meno di non richiedere esplicitamente la
188   compatibilità all'indietro con BSD, definendo la macro
189   \macro{\_BSD\_SOURCE}.} il cui prototipo è:
190 \begin{prototype}{unistd.h}{int setpgrp(void)}
191   Modifica il \acr{pgid} al valore del \acr{pid} del processo corrente.
192   
193   \bodydesc{La funzione restituisce il valore del nuovo \textit{process
194       group}.}
195 \end{prototype}
196
197 La funzione, assegnando al \acr{pgid} il valore del \acr{pid} processo
198 corrente, rende questo \textit{group leader} di un nuovo raggruppamento, tutti
199 i successivi processi da esso creati apparterranno (a meno di non cambiare di
200 nuovo il \acr{pgid}) al nuovo raggruppamento. È possibile invece spostare un
201 processo da un raggruppamento ad un altro con la funzione \func{setpgid}, il
202 cui prototipo è:
203 \begin{prototype}{unistd.h}{int setpgid(pid\_t pid, pid\_t pgid)}
204   Assegna al \acr{pgid} del processo \param{pid} il valore \param{pgid}.
205   
206   \bodydesc{La funzione ritorna il valore del nuovo \textit{process group}, e
207   -1 in caso di errore, nel qual caso \var{errno} assumerà i valori:
208     \begin{errlist}
209     \item[\errcode{ESRCH}] Il processo selezionato non esiste.
210     \item[\errcode{EPERM}] Il cambiamento non è consentito.
211     \item[\errcode{EACCES}] Il processo ha già eseguito una \func{exec}.
212     \item[\errcode{EINVAL}] Il valore di \param{pgid} è negativo.
213     \end{errlist}
214  }
215 \end{prototype}
216
217 La funzione permette di cambiare il \acr{pgid} del processo \param{pid}, ma il
218 cambiamento può essere effettuato solo se \param{pgid} indica un
219 \textit{process group} che è nella stessa sessione del processo chiamante.
220 Inoltre la funzione può essere usata soltanto sul processo corrente o su uno
221 dei suoi figli, ed in quest'ultimo caso ha successo soltanto se questo non ha
222 ancora eseguito una \func{exec}.\footnote{questa caratteristica è implementata
223   dal kernel che mantiene allo scopo un altro campo, \var{did\_exec}, in
224   \struct{task\_struct}.}  Specificando un valore nullo per \param{pid} si
225 indica il processo corrente, mentre specificando un valore nullo per
226 \param{pgid} si imposta il \textit{process group} al valore del \acr{pid} del
227 processo selezionato; pertanto \func{setpgrp} è equivalente a \code{setpgid(0,
228   0)}.
229
230 Di norma questa funzione viene usata dalla shell quando si usano delle
231 pipeline, per mettere nello stesso process group tutti i programmi lanciati su
232 ogni linea di comando; essa viene chiamata dopo una \func{fork} sia dal
233 processo padre, per impostare il valore nel figlio, che da quest'ultimo, per
234 sé stesso, in modo che il cambiamento di \textit{process group} sia immediato
235 per entrambi; una delle due chiamate sarà ridondante, ma non potendo
236 determinare quale dei due processi viene eseguito per primo, occorre eseguirle
237 comunque entrambe per evitare di esporsi ad una race condition. 
238
239 Si noti come nessuna delle funzioni esaminate finora permetta di spostare un
240 processo da una sessione ad un altra; infatti l'unico modo di far cambiare
241 sessione ad un processo è quello di crearne una nuova con l'uso di
242 \func{setsid}; il suo prototipo è:
243 \begin{prototype}{unistd.h}{pid\_t setsid(void)}
244   Crea una nuova sessione sul processo corrente impostandone \acr{sid} e
245   \acr{pgid}.
246   
247   \bodydesc{La funzione ritorna il valore del nuovo \acr{sid}, e -1 in caso di
248     errore, il solo errore possibile è \errval{EPERM}, che si ha quando il
249     \acr{pgid} e \acr{pid} del processo coincidono.}
250 \end{prototype}
251
252 La funzione imposta il \acr{pgid} ed il \acr{sid} del processo corrente al
253 valore del suo \acr{pid}, creando così una nuova sessione ed un nuovo
254 \textit{process group} di cui esso diventa leader (come per i \textit{process
255   group} un processo si dice leader di sessione\footnote{in Linux la proprietà
256   è mantenuta in maniera indipendente con un apposito campo \var{leader} in
257   \struct{task\_struct}.} se il suo \acr{sid} è uguale al suo \acr{pid}) ed
258 unico componente.  Inoltre la funzione distacca il processo da ogni terminale
259 di controllo (torneremo sull'argomento in \secref{sec:sess_ctrl_term}) cui
260 fosse in precedenza associato.
261
262 La funzione ha successo soltanto se il processo non è già leader di un
263 \textit{process group}, per cui per usarla di norma si esegue una \func{fork}
264 e si esce, per poi chiamare \func{setsid} nel processo figlio, in modo che,
265 avendo questo lo stesso \acr{pgid} del padre ma un \acr{pid} diverso, non ci
266 siano possibilità di errore.\footnote{potrebbe sorgere il dubbio che, per il
267   riutilizzo dei valori dei \acr{pid} fatto nella creazione dei nuovi processi
268   (vedi \secref{sec:proc_pid}), il figlio venga ad assumere un valore
269   corrispondente ad un process group esistente; questo viene evitato dal
270   kernel che considera come disponibili per un nuovo \acr{pid} solo valori che
271   non corrispondono ad altri \acr{pid}, \acr{pgid} o \acr{sid} in uso nel
272   sistema.} Questa funzione viene usata di solito nel processo di login (per i
273 dettagli vedi \secref{sec:sess_login}) per raggruppare in una sessione tutti i
274 comandi eseguiti da un utente dalla sua shell.
275
276
277
278 \subsection{Il terminale di controllo e il controllo di sessione}
279 \label{sec:sess_ctrl_term}
280
281 Come accennato in \secref{sec:sess_job_control_overview}, nel sistema del
282 \textit{job control} i processi all'interno di una sessione fanno riferimento
283 ad un terminale di controllo (ad esempio quello su cui si è effettuato il
284 login), sul quale effettuano le operazioni di lettura e
285 scrittura,\footnote{nel caso di login grafico la cosa può essere più
286   complessa, e di norma l'I/O è effettuato tramite il server X, ma ad esempio
287   per i programmi, anche grafici, lanciati da un qualunque emulatore di
288   terminale, sarà quest'ultimo a fare da terminale (virtuale) di controllo.} e
289 dal quale ricevono gli eventuali segnali da tastiera.
290
291 A tale scopo lo standard POSIX.1 prevede che ad ogni sessione possa essere
292 associato un terminale di controllo; in Linux questo viene realizzato
293 mantenendo fra gli attributi di ciascun processo anche qual'è il suo terminale
294 di controllo. \footnote{Lo standard POSIX.1 non specifica nulla riguardo
295   l'implementazione; in Linux anch'esso viene mantenuto nella solita struttura
296   \struct{task\_struct}, nel campo \var{tty}.}  In generale ogni processo
297 eredita dal padre, insieme al \acr{pgid} e al \acr{sid} anche il terminale di
298 controllo (vedi \secref{sec:proc_fork}). In questo modo tutti processi
299 originati dallo stesso leader di sessione mantengono lo stesso terminale di
300 controllo.
301
302 Alla creazione di una nuova sessione con \func{setsid} ogni associazione con
303 il precedente terminale di controllo viene cancellata, ed il processo che è
304 divenuto un nuovo leader di sessione dovrà riottenere\footnote{solo quando ciò
305   è necessario, cosa che, come vedremo in \secref{sec:sess_daemon}, non è
306   sempre vera.}, un terminale di controllo. In generale questo viene fatto
307 automaticamente dal sistema\footnote{a meno di non avere richiesto
308   esplicitamente che questo non diventi un terminale di controllo con il flag
309   \const{O\_NOCTTY} (vedi \secref{sec:file_open}). In questo Linux segue la
310   semantica di SVr4; BSD invece richiede che il terminale venga allocato
311   esplicitamente con una \func{ioctl} con il comando \const{TIOCSCTTY}.}
312 quando viene aperto il primo terminale (cioè uno dei vari file di dispositivo
313 \file{/dev/tty*}) che diventa automaticamente il terminale di controllo,
314 mentre il processo diventa il \textsl{processo di controllo} di quella
315 sessione.
316
317 In genere (a meno di redirezioni) nelle sessioni di lavoro questo terminale è
318 associato ai file standard (di input, output ed error) dei processi nella
319 sessione, ma solo quelli che fanno parte del cosiddetto raggruppamento di
320 \textit{foreground}, possono leggere e scrivere in certo istante. Per
321 impostare il raggruppamento di \textit{foreground} di un terminale si usa la
322 funzione \func{tcsetpgrp}, il cui prototipo è:
323 \begin{functions}
324   \headdecl{unistd.h}
325   \headdecl{termios.h}
326   
327   \funcdecl{int tcsetpgrp(int fd, pid\_t pgrpid)} Imposta a \param{pgrpid} il
328   \textit{process group} di \textit{foreground} del terminale associato al
329   file descriptor \param{fd}.
330    
331   \bodydesc{La funzione restituisce 0 in caso di successo, e -1 in caso di
332     errore, nel qual caso \var{errno} assumerà i valori:
333     \begin{errlist}
334     \item[\errcode{ENOTTY}] Il file \param{fd} non corrisponde al terminale di
335       controllo del processo chiamante.
336     \item[\errcode{ENOSYS}] Il sistema non supporta il job control.
337     \item[\errcode{EPERM}] Il \textit{process group} specificato non è nella
338     stessa sessione del processo chiamante.
339     \end{errlist}
340     ed inoltre \errval{EBADF} ed \errval{EINVAL}. 
341   }
342 \end{functions}
343 \noindent la funzione può essere eseguita con successo solo da
344 un processo nella stessa sessione e con lo stesso terminale di controllo. 
345
346 Come accennato in \secref{sec:sess_job_control_overview}, tutti i processi (e
347 relativi raggruppamenti) che non fanno parte del gruppo di \textit{foreground}
348 sono detti in \textit{background}; se uno si essi cerca di accedere al
349 terminale di controllo provocherà l'invio da parte del kernel di uno dei due
350 segnali \const{SIGTTIN} o \const{SIGTTOU} (a seconda che l'accesso sia stato
351 in lettura o scrittura) a tutto il suo \textit{process group}; dato che il
352 comportamento di default di questi segnali (si riveda quanto esposto in
353 \secref{sec:sig_job_control}) è di fermare il processo, di norma questo
354 comporta che tutti i membri del gruppo verranno fermati, ma non si avranno
355 condizioni di errore.\footnote{la shell in genere notifica comunque un
356   avvertimento, avvertendo la presenza di processi bloccati grazie all'uso di
357   \func{waitpid}.} Se però si bloccano o ignorano i due segnali citati, le
358 funzioni di lettura e scrittura falliranno con un errore di \errcode{EIO}.
359
360 Un processo può controllare qual'è il gruppo di \textit{foreground} associato
361 ad un terminale con la funzione \func{tcgetpgrp}, il cui prototipo è:
362 \begin{functions}
363   \headdecl{unistd.h} \headdecl{termios.h}
364   
365   \funcdecl{pid\_t tcgetpgrp(int fd)} Legge il \textit{process group} di
366   \textit{foreground} del terminale associato al file descriptor \param{fd}.
367   \bodydesc{La funzione restituisce in caso di successo il \acr{pgid} del
368     gruppo di \textit{foreground}, e -1 in caso di errore, nel qual caso
369     \var{errno} assumerà i valori:
370     \begin{errlist}
371     \item[\errcode{ENOTTY}] Non c'è un terminale di controllo o \param{fd} non
372       corrisponde al terminale di controllo del processo chiamante.
373     \end{errlist}
374     ed inoltre \errval{EBADF} ed \errval{ENOSYS}. 
375   }
376 \end{functions}
377
378 Si noti come entrambe le funzioni usino come argomento il valore di un file
379 descriptor, il risultato comunque non dipende dal file descriptor che si usa
380 ma solo dal terminale cui fa riferimento; il kernel inoltre permette a ciascun
381 processo di accedere direttamente al suo terminale di controllo attraverso il
382 file speciale \file{/dev/tty}, che per ogni processo è un sinonimo per il
383 proprio terminale di controllo.  Questo consente anche a processi che possono
384 aver rediretto l'output di accedere al terminale di controllo, pur non
385 disponendo più del file descriptor originario; un caso tipico è il programma
386 \cmd{crypt} che accetta la redirezione sullo standard input di un file da
387 decifrare, ma deve poi leggere la password dal terminale.
388
389 Un'altra caratteristica del terminale di controllo usata nel job control è che
390 utilizzando su di esso le combinazioni di tasti speciali (\cmd{C-z},
391 \cmd{C-c}, \cmd{C-y} e \verb|C-\|) si farà sì che il kernel invii i
392 corrispondenti segnali (rispettivamente \const{SIGTSTP}, \const{SIGINT},
393 \const{SIGQUIT} e \const{SIGTERM}, trattati in \secref{sec:sig_job_control}) a
394 tutti i processi del raggruppamento di \textit{foreground}; in questo modo la
395 shell può gestire il blocco e l'interruzione dei vari comandi.
396  
397 Per completare la trattazione delle caratteristiche del job control legate al
398 terminale di controllo, occorre prendere in considerazione i vari casi legati
399 alla terminazione anomala dei processi, che sono di norma gestite attraverso
400 il segnale \const{SIGHUP}. Il nome del segnale deriva da \textit{hungup},
401 termine che viene usato per indicare la condizione in cui il terminale diventa
402 inutilizzabile, (letteralmente sarebbe \textsl{impiccagione}). 
403
404 Quando si verifica questa condizione, ad esempio se si interrompe la linea, o
405 va giù la rete o più semplicemente si chiude forzatamente la finestra di
406 terminale su cui si stava lavorando, il kernel provvederà ad inviare il
407 segnale di \const{SIGHUP} al processo di controllo. L'azione preimpostata in
408 questo caso è la terminazione del processo, il problema che si pone è cosa
409 accade agli altri processi nella sessione, che non han più un processo di
410 controllo che possa gestire l'accesso al terminale, che potrebbe essere
411 riutilizzato per qualche altra sessione.
412
413 Lo standard POSIX.1 prevede che quando il processo di controllo termina, che
414 ciò avvenga o meno per un \textit{hungup} del terminale (ad esempio si
415 potrebbe terminare direttamente la shell con \cmd{kill}) venga inviato un
416 segnale di \const{SIGHUP} ai processi del raggruppamento di foreground. In
417 questo modo essi potranno essere avvisati che non esiste più un processo in
418 grado di gestire il terminale (di norma tutto ciò comporta la terminazione
419 anche di questi ultimi).
420
421 Restano però gli eventuali processi in background, che non ricevono il
422 segnale; in effetti se il terminale non dovesse più servire essi potrebbero
423 proseguire fino al completamento della loro esecuzione; ma si pone il problema
424 di come gestire quelli che sono bloccati, o che si bloccano nell'accesso al
425 terminale, in assenza di un processo che sia in grado di effettuare il
426 controllo dello stesso.
427
428 Questa è la situazione in cui si ha quello che viene chiamato un
429 \textit{orphaned process group}. Lo standard POSIX.1 lo definisce come un
430 \textit{process group} i cui processi hanno come padri esclusivamente o altri
431 processi nel raggruppamento, o processi fuori della sessione.  Lo standard
432 prevede inoltre che se la terminazione di un processo fa sì che un
433 raggruppamento di processi diventi orfano e se i suoi membri sono bloccati, ad
434 essi vengano inviati in sequenza i segnali di \const{SIGHUP} e
435 \const{SIGCONT}.
436
437 La definizione può sembrare complicata, e a prima vista non è chiaro cosa
438 tutto ciò abbia a che fare con il problema della terminazione del processo di
439 controllo.  Consideriamo allora cosa avviene di norma nel \textit{job
440   control}: una sessione viene creata con \func{setsid} che crea anche un
441 nuovo process group: per definizione quest'ultimo è sempre \textsl{orfano},
442 dato che il padre del leader di sessione è fuori dalla stessa e il nuovo
443 process group contiene solo il leader di sessione. Questo è un caso limite, e
444 non viene emesso nessun segnale perché quanto previsto dallo standard riguarda
445 solo i raggruppamenti che diventano orfani in seguito alla terminazione di un
446 processo.\footnote{l'emissione dei segnali infatti avviene solo nella fase di
447   uscita del processo, come una delle operazioni legate all'esecuzione di
448   \func{\_exit}, secondo quanto illustrato in \secref{sec:proc_termination}.}
449
450 Il leader di sessione provvederà a creare nuovi raggruppamenti che a questo
451 punto non sono orfani in quanto esso resta padre per almeno uno dei processi
452 del gruppo (gli altri possono derivare dal primo). Alla terminazione del
453 leader di sessione però avremo che, come visto in
454 \secref{sec:proc_termination}, tutti i suoi figli vengono adottati da
455 \cmd{init}, che è fuori dalla sessione. Questo renderà orfani tutti i process
456 group creati direttamente dal leader di sessione (a meno di non aver spostato
457 con \func{setpgid} un processo da un gruppo ad un altro, cosa che di norma non
458 viene fatta) i quali riceveranno, nel caso siano bloccati, i due segnali;
459 \const{SIGCONT} ne farà proseguire l'esecuzione, ed essendo stato nel
460 frattempo inviato anche \const{SIGHUP}, se non c'è un gestore per
461 quest'ultimo, i processi bloccati verranno automaticamente terminati.
462
463
464
465 \subsection{Dal login alla shell}
466 \label{sec:sess_login}
467
468 L'organizzazione del sistema del job control è strettamente connessa alle
469 modalità con cui un utente accede al sistema per dare comandi, collegandosi ad
470 esso con un terminale, che sia questo realmente tale, come un VT100 collegato
471 ad una seriale o virtuale, come quelli associati a schermo e tastiera o ad una
472 connessione di rete. Dato che i concetti base sono gli stessi, e dato che alla
473 fine le differenze sono\footnote{in generale nel caso di login via rete o di
474   terminali lanciati dall'interfaccia grafica cambia anche il processo da cui
475   ha origine l'esecuzione della shell.} nel dispositivo cui il kernel associa i
476 file standard (vedi \secref{sec:file_std_descr}) per l'I/O, tratteremo solo il
477 caso classico del terminale.
478
479 Abbiamo già brevemente illustrato in \secref{sec:intro_kern_and_sys} le
480 modalità con cui il sistema si avvia, e di come, a partire da \cmd{init},
481 vengano lanciati tutti gli altri processi. Adesso vedremo in maniera più
482 dettagliata le modalità con cui il sistema arriva a fornire ad un utente la
483 shell che gli permette di lanciare i suoi comandi su un terminale.
484
485 Nella maggior parte delle distribuzioni di GNU/Linux\footnote{fa eccezione la
486   distribuzione \textit{Slackware}, come alcune distribuzioni su dischetto, ed
487   altre distribuzioni dedicate a compiti limitati e specifici.}  viene usata
488 la procedura di avvio di System V; questa prevede che \cmd{init} legga dal
489 file di configurazione \file{/etc/inittab} quali programmi devono essere
490 lanciati, ed in quali modalità, a seconda del cosiddetto \textit{run level},
491 anch'esso definito nello stesso file.
492
493 Tralasciando la descrizione del sistema dei run level, (per il quale si
494 rimanda alla lettura delle pagine di manuale di \cmd{init} e di
495 \file{inittab}) quello che comunque viene sempre fatto è di eseguire almeno
496 una istanza di un programma che permetta l'accesso ad un terminale. Uno schema
497 di massima della procedura è riportato in \figref{fig:sess_term_login}.
498
499 \begin{figure}[htb]
500   \centering
501   \includegraphics[width=15cm]{img/tty_login}
502   \caption{Schema della procedura di login su un terminale.}
503   \label{fig:sess_term_login}
504 \end{figure}
505
506 Un terminale, che esso sia un terminale effettivo, attaccato ad una seriale o
507 ad un altro tipo di porta di comunicazione, o una delle console virtuali
508 associate allo schermo, viene sempre visto attraverso attraverso un device
509 driver che ne presenta un'interfaccia comune su un apposito file di
510 dispositivo.
511
512 Per controllare un terminale si usa di solito il programma \cmd{getty} (od una
513 delle sue varianti), che permette di mettersi in ascolto su uno di questi
514 dispositivi. Alla radice della catena che porta ad una shell per i comandi
515 perciò c'è sempre \cmd{init} che esegue prima una \func{fork} e poi una
516 \func{exec} per lanciare una istanza di questo programma su un terminale, il
517 tutto ripetuto per ciascuno dei terminali che si hanno a disposizione (o per
518 un certo numero di essi, nel caso delle console virtuali), secondo quanto
519 indicato dall'amministratore nel file di configurazione del programma,
520 \file{/etc/inittab}.
521
522 Quando viene lanciato da \cmd{init} il programma parte con i privilegi di
523 amministratore e con un ambiente vuoto; \cmd{getty} si cura di chiamare
524 \func{setsid} per creare una nuova sessione ed un nuovo process group, e di
525 aprire il terminale (che così diventa il terminale di controllo della
526 sessione) in lettura sullo standard input ed in scrittura sullo standard
527 output e sullo standard error; inoltre effettuerà, qualora servano, ulteriori
528 settaggi.\footnote{ad esempio, come qualcuno si sarà accorto scrivendo un nome
529   di login in maiuscolo, può effettuare la conversione automatica dell'input
530   in minuscolo, ponendosi in una modalità speciale che non distingue fra i due
531   tipi di caratteri (a beneficio di alcuni vecchi terminali che non
532   supportavano le minuscole).} Alla fine il programma stamperà un messaggio di
533 benvenuto per poi porsi in attesa dell'immissione del nome di un utente.
534
535 Una volta che si sia immesso il nome di login \cmd{getty} esegue direttamente
536 il programma \cmd{login} con una \func{exevle}, passando come argomento la
537 stringa con il nome, ed un ambiente opportunamente costruito che contenga
538 quanto necessario (ad esempio di solito viene opportunamente inizializzata la
539 variabile di ambiente \texttt{TERM}) ad identificare il terminale su cui si
540 sta operando, a beneficio dei programmi che verranno lanciati in seguito.
541
542 A sua volta \cmd{login}, che mantiene i privilegi di amministratore, usa il
543 nome dell'utente per effettuare una ricerca nel database degli
544 utenti,\footnote{in genere viene chiamata \func{getpwnam}, che abbiamo visto
545   in \secref{sec:sys_user_group}, per leggere la password e gli altri dati dal
546   database degli utenti.} e richiede una password. Se l'utente non esiste o se
547 la password non corrisponde\footnote{il confronto non viene effettuato con un
548   valore in chiaro; quanto immesso da terminale viene invece a sua volta
549   criptato, ed è il risultato che viene confrontato con il valore che viene
550   mantenuto nel database degli utenti.} la richiesta viene ripetuta un certo
551 numero di volte dopo di che \cmd{login} esce ed \cmd{init} provvede a
552 rilanciare un'altra istanza di \func{getty}.
553
554 Se invece la password corrisponde \cmd{login} esegue \func{chdir} per settare
555 la \textit{home directory} dell'utente, cambia i diritti di accesso al
556 terminale (con \func{chown} e \func{chmod}) per assegnarne la titolarità
557 all'utente ed al suo gruppo principale, assegnandogli al contempo i diritti di
558 lettura e scrittura. Inoltre il programma provvede a costruire gli opportuni
559 valori per le variabili di ambiente, come \texttt{HOME}, \texttt{SHELL}, ecc.
560 Infine attraverso l'uso di \func{setuid}, \func{setpid} e \func{initgroups}
561 verrà cambiata l'identità del proprietario del processo, infatti, come
562 spiegato in \secref{sec:proc_setuid}, avendo invocato tali funzioni con i
563 privilegi di amministratore, tutti gli userid ed i groupid (reali, effettivi e
564 salvati) saranno settati a quelli dell'utente.
565
566 A questo punto \cmd{login} provvederà (fatte salve eventuali altre azioni
567 iniziali, come la stampa di messaggi di benvenuto o il controllo della posta)
568 ad eseguire con un'altra \func{exec} la shell, che si troverà con un ambiente
569 già pronto con i file standard di \secref{sec:file_std_descr} impostati sul
570 terminale, e pronta, nel ruolo di leader di sessione e di processo di
571 controllo per il terminale, a gestire l'esecuzione dei comandi come illustrato
572 in \secref{sec:sess_job_control_overview}. 
573
574 Dato che il processo padre resta sempre \cmd{init} quest'ultimo potrà
575 provvedere, ricevendo un \const{SIGCHLD} all'uscita della shell quando la
576 sessione di lavoro è terminata, a rilanciare \cmd{getty} sul terminale per
577 ripetere da capo tutto il procedimento. 
578
579
580
581 \subsection{Prescrizioni per un programma \textit{daemon}}
582 \label{sec:sess_daemon}
583
584 Come sottolineato fin da \secref{sec:intro_base_concept}, in un sistema
585 unix-like tutte le operazioni sono eseguite tramite processi, comprese quelle
586 operazioni di sistema (come l'esecuzione dei comandi periodici, o la consegna
587 della posta, ed in generale tutti i programmi di servizio) che non hanno
588 niente a che fare con la gestione diretta dei comandi dell'utente.
589
590 Questi programmi, che devono essere eseguiti in modalità non interattiva e
591 senza nessun intervento dell'utente, sono normalmente chiamati
592 \textsl{demoni}, (o \textit{daemons}), nome ispirato dagli omonimi spiritelli
593 che svolgevano compiti vari, di cui parlava Socrate (che sosteneva di averne
594 uno al suo servizio).\footnote{NdT. ricontrollare, i miei ricordi di filosofia
595   sono piuttosto datati.}
596
597 Se però si lancia un programma demone dalla riga di comando in un sistema che
598 supporta, come Linux, il \textit{job control} esso verrà comunque associato ad
599 un terminale di controllo e mantenuto all'interno di una sessione, e anche se
600 può essere mandato in background e non eseguire più nessun I/O su terminale,
601 si avranno comunque tutte le conseguenze che abbiamo appena visto in
602 \secref{sec:sess_ctrl_term} (in particolare l'invio dei segnali in
603 corrispondenza dell'uscita del leader di sessione).
604
605 Per questo motivo un programma che deve funzionare come demone deve sempre
606 prendere autonomamente i provvedimenti opportuni (come distaccarsi dal
607 terminale e dalla sessione) ad impedire eventuali interferenze da parte del
608 sistema del \textit{job control}; questi sono riassunti in una lista di
609 prescrizioni\footnote{ad esempio sia Stevens in \cite{APUE}, che la
610   \textit{Unix Programming FAQ} \cite{UnixFAQ} ne riportano di sostanzialmente
611   identiche.} da seguire quando si scrive un demone.
612
613 Pertanto, quando si lancia un programma che deve essere eseguito come demone
614 occorrerà predisporlo in modo che esso compia le seguenti azioni:
615 \begin{enumerate}
616 \item Eseguire una \func{fork} e terminare immediatamente il processo padre
617   proseguendo l'esecuzione nel figlio.  In questo modo si ha la certezza che
618   il figlio non è un \textit{process group leader}, (avrà il \acr{pgid} del
619   padre, ma un \acr{pid} diverso) e si può chiamare \func{setsid} con
620   successo. Inoltre la shell considererà terminato il comando all'uscita del
621   padre.
622 \item Eseguire \func{setsid} per creare una nuova sessione ed un nuovo
623   raggruppamento di cui il processo diventa automaticamente il leader, che
624   però non ha associato nessun terminale di controllo.
625 \item Assicurarsi che al processo non venga associato in seguito nessun nuovo
626   terminale di controllo; questo può essere fatto sia avendo cura di usare
627   sempre l'opzione \const{O\_NOCTTY} nell'aprire i file di terminale, che
628   eseguendo una ulteriore \func{fork} uscendo nel padre e proseguendo nel
629   figlio. In questo caso, non essendo più quest'ultimo un leader di sessione
630   non potrà ottenere automaticamente un terminale di controllo.
631 \item Eseguire una \func{chdir} per impostare la directory di lavoro del
632   processo (su \file{/} o su una directory che contenga dei file necessari per
633   il programma), per evitare che la directory da cui si è lanciato il processo
634   resti in uso e non sia possibile rimuoverla o smontare il filesystem che la
635   contiene.
636 \item Impostare la maschera dei permessi (di solito con \code{umask(0)}) in
637   modo da non essere dipendenti dal valore ereditato da chi ha lanciato
638   originariamente il processo. 
639 \item Chiudere tutti i file aperti che non servono più (in generale tutti); in
640   particolare vanno chiusi i file standard che di norma sono ancora associati
641   al terminale (un'altra opzione è quella di redirigerli verso
642   \file{/dev/null}).
643 \end{enumerate}
644
645
646 In Linux buona parte di queste azioni possono venire eseguite invocando la
647 funzione \func{daemon}, introdotta per la prima volta in BSD4.4; il suo
648 prototipo è:
649 \begin{prototype}{unistd.h}{int daemon(int nochdir, int noclose)}
650   Esegue le operazioni che distaccano il processo dal terminale di controllo e
651   lo fanno girare come demone.
652   
653   \bodydesc{La funzione restituisce (nel nuovo processo) 0 in caso di
654     successo, e -1 in caso di errore, nel qual caso \var{errno} assumerà i
655     valori impostati dalle sottostanti \func{fork} e \func{setsid}.}
656 \end{prototype}
657
658 La funzione esegue una \func{fork}, per uscire subito, con \func{\_exit}, nel
659 padre, mentre l'esecuzione prosegue nel figlio che esegue subito una
660 \func{setsid}. In questo modo si compiono automaticamente i passi 1 e 2 della
661 precedente lista. Se \param{nochdir} è nullo la funzione imposta anche la
662 directory di lavoro su \file{/}, se \param{noclose} è nullo i file standard
663 vengono rediretti su \file{/dev/null} (corrispondenti ai passi 4 e 6); in caso
664 di valori non nulli non viene eseguita nessuna altra azione.
665
666 Dato che un programma demone non può più accedere al terminale, si pone il
667 problema di come fare per la notifica di eventuali errori, non potendosi più
668 utilizzare lo standard error; per il normale I/O infatti ciascun demone avrà
669 le sue modalità di interazione col sistema e gli utenti a seconda dei compiti
670 e delle funzionalità che sono sono previste; ma gli errori devono normalmente
671 essere notificati all'amministratore del sistema.
672
673 Una soluzione può essere quella di scrivere gli eventuali messaggi su uno
674 specifico file (cosa che a volte viene fatta comunque) ma questo comporta il
675 grande svantaggio che l'amministratore dovrà tenere sotto controllo un file
676 diverso per ciascun demone, e che possono anche generarsi conflitti di nomi.
677 Per questo in BSD4.2 venne introdotto un servizio di sistema, il
678 \textit{syslog}, che oggi si trova su tutti i sistemi Unix, e che permettesse
679 ai demoni di inviare messaggi all'amministratore in una maniera
680 standardizzata.
681
682 Il servizio prevede vari meccanismi di notifica, e, come ogni altro servizio
683 in un sistema unix-like, viene gestito attraverso un apposito programma,
684 \cmd{syslogd}, che è anch'esso un \textsl{demone}. In generale i messaggi di
685 errore vengono raccolti dal file speciale \file{/dev/log}, un
686 \textit{socket}\index{socket} locale (vedi \secref{sec:sock_sa_local})
687 dedicato a questo scopo, o via rete, con un \textit{socket} UDP, o da un
688 apposito demone, \cmd{klogd}, che estrae i messaggi del kernel.\footnote{i
689   messaggi del kernel sono tenuti in un buffer circolare e scritti tramite la
690   funzione \func{printk}, analoga alla \func{printf} usata in user space; una
691   trattazione eccellente dell'argomento si trova in \cite{LinDevDri}, nel
692   quarto capitolo.}
693
694 Il servizio permette poi di trattare i vari messaggi classificandoli
695 attraverso due indici; il primo, chiamato \textit{facility}, suddivide in
696 diverse categorie i vari demoni in modo di raggruppare i messaggi provenienti
697 da operazioni che hanno attinenza fra loro, ed è organizzato in sottosistemi
698 (kernel, posta elettronica, demoni di stampa, ecc.). Il secondo, chiamato
699 \textit{priority}, identifica l'importanza dei vari messaggi, e permette di
700 classificarli e differenziare le modalità di notifica degli stessi.
701
702 Il sistema di \textit{syslog} attraverso \cmd{syslogd} provvede poi a
703 riportare i messaggi all'amministratore attraverso una serie differenti
704 meccanismi come:
705 \begin{itemize*}
706 \item scrivere sulla console.
707 \item inviare via mail ad uno specifico utente.
708 \item scrivere su un file (comunemente detto \textit{log file}).
709 \item inviare ad un altro demone (anche via rete).
710 \item scartare.
711 \end{itemize*}
712 secondo le modalità che questo preferisce e che possono essere impostate
713 attraverso il file di configurazione \file{/etc/syslog.conf} (maggiori
714 dettagli si possono trovare sulle pagine di manuale per questo file e per
715 \cmd{syslogd}).
716
717 Le \acr{glibc} definiscono una serie di funzioni standard con cui un processo
718 può accedere in maniera generica al servizio di \textit{syslog}, che però
719 funzionano solo localmente; se si vogliono inviare i messaggi ad un'altro
720 sistema occorre farlo esplicitamente con un socket\index{socket} UDP, o
721 utilizzare le capacità di reinvio del servizio.
722
723 La prima funzione definita dall'interfaccia è \func{openlog}, che apre una
724 connessione al servizio di \textit{syslog}; essa in generale non è necessaria
725 per l'uso del servizio, ma permette di impostare alcuni valori che controllano
726 gli effetti delle chiamate successive; il suo prototipo è:
727 \begin{prototype}{syslog.h}{void openlog(const char *ident, int option, 
728 int facility)}
729
730 Apre una connessione al sistema di \textit{syslog}.
731   
732 \bodydesc{La funzione non restituisce nulla.}
733 \end{prototype}
734
735 La funzione permette di specificare, tramite \param{ident}, l'identità di chi
736 ha inviato il messaggio (di norma si passa il nome del programma, come
737 specificato da \code{argv[0]}); la stringa verrà preposta all'inizio di ogni
738 messaggio. Si tenga presente che il valore di \param{ident} che si passa alla
739 funzione è un puntatore, se la stringa cui punta viene cambiata lo sarà pure
740 nei successivi messaggi, e se viene cancellata i risultati potranno essere
741 impredicibili, per questo è sempre opportuno usare una stringa costante. 
742
743 L'argomento \param{facility} permette invece di preimpostare per le successive
744 chiamate l'omonimo indice che classifica la categoria del messaggio.
745 L'argomento è interpretato come una maschera binaria, e pertanto è possibile
746 inviare i messaggi su più categorie alla volta; i valori delle costanti che
747 identificano ciascuna categoria sono riportati in
748 \tabref{tab:sess_syslog_facility}, il valore di \param{facility} deve essere
749 specificato con un OR aritmetico.
750
751 \begin{table}[htb]
752   \footnotesize
753   \centering
754   \begin{tabular}[c]{|l|p{8cm}|}
755     \hline
756     \textbf{Valore}& \textbf{Significato}\\
757     \hline
758     \hline
759     \const{LOG\_AUTH}     & Messaggi relativi ad autenticazione e sicurezza,
760                             obsoleto, è sostituito da \const{LOG\_AUTHPRIV}. \\
761     \const{LOG\_AUTHPRIV} & Sostituisce \const{LOG\_AUTH}.\\
762     \const{LOG\_CRON}     & Messaggi dei demoni di gestione dei comandi
763                             programmati (\cmd{cron} e \cmd{at}).\\
764     \const{LOG\_DAEMON}   & Demoni di sistema.\\
765     \const{LOG\_FTP}      & Server FTP.\\
766     \const{LOG\_KERN}     & Messaggi del kernel\\
767     \const{LOG\_LOCAL0}   & Riservato all'amministratore per uso locale\\
768     --- & \\
769     \const{LOG\_LOCAL7}   & Riservato all'amministratore per uso locale\\
770     \const{LOG\_LPR}      & Messaggi del sistema di gestione delle stampanti \\
771     \const{LOG\_MAIL}     & Messaggi del sistema di posta elettronica\\
772     \const{LOG\_NEWS}     & Messaggi del sistema di gestione delle news 
773                             (USENET) \\
774     \const{LOG\_SYSLOG}   & Messaggi generati dallo stesso \cmd{syslogd}\\
775     \const{LOG\_USER}     & Messaggi generici a livello utente\\
776     \const{LOG\_UUCP}     & Messaggi del sistema UUCP\\
777 \hline
778 \end{tabular}
779 \caption{Valori possibili per l'argomento \param{facility} di \func{openlog}.}
780 \label{tab:sess_syslog_facility}
781 \end{table}
782
783 L'argomento \param{option} serve invece per controllare il comportamento della
784 funzione \func{openlog} e delle modalità con cui le successive chiamate
785 scriveranno i messaggi, esso viene specificato come maschera binaria composta
786 con un OR aritmetico di una qualunque delle costanti riportate in
787 \tabref{tab:sess_openlog_option}.
788
789 \begin{table}[htb]
790   \footnotesize
791 \centering
792 \begin{tabular}[c]{|l|p{8cm}|}
793 \hline
794 \textbf{Valore}& \textbf{Significato}\\
795 \hline
796 \hline
797 \const{LOG\_CONS}   & Scrive sulla console quando. \\
798 \const{LOG\_NDELAY} & Sostituisce \const{LOG\_AUTH}.\\
799 \const{LOG\_NOWAIT} & Messaggi dei demoni di gestione dei comandi
800                       programmati (\cmd{cron} e \cmd{at}).\\
801 \const{LOG\_ODELAY} & .\\
802 \const{LOG\_PERROR} & Stampa anche su \file{stderr}.\\
803 \const{LOG\_PID}    & Inserisce nei messaggi il \acr{pid} del processo
804                       chiamante. \\
805 \hline
806 \end{tabular}
807 \caption{Valori possibili per l'argomento \param{option} di \func{openlog}.}
808 \label{tab:sess_openlog_option}
809 \end{table}
810
811 La funzione che si usa per generare un messaggio è \func{syslog}, dato che
812 l'uso di \func{openlog} è opzionale, sarà quest'ultima a provvede a chiamare la
813 prima qualora ciò non sia stato fatto (nel qual caso il valore di
814 \param{ident} è nullo). Il suo prototipo è:
815 \begin{prototype}{syslog.h}
816 {void syslog(int priority, const char *format, ...)}
817
818 Genera un messaggio di priorità \param{priority}.
819
820 \bodydesc{La funzione non restituisce nulla.}
821 \end{prototype}
822
823 Il comportamento della funzione è analogo quello di \func{printf}, e il valore
824 dell'argomento \param{format} è identico a quello descritto nella pagina di
825 manuale di quest'ultima (per i valori principali si può vedere la trattazione
826 sommaria che se ne è fatto in \secref{sec:file_formatted_io}); l'unica
827 differenza è che la sequenza \val{\%m} viene rimpiazzata dalla stringa
828 restituita da \code{strerror(errno)}. Gli argomenti seguenti i primi due
829 devono essere forniti secondo quanto richiesto da \param{format}.
830
831 L'argomento \param{priority} permette di impostare sia la \textit{facility}
832 che la \textit{priority} del messaggio. In realtà viene prevalentemente usato
833 per specificare solo quest'ultima in quanto la prima viene di norma
834 preimpostata con \func{openlog}. La priorità è indicata con un valore
835 numerico\footnote{le \acr{glibc}, seguendo POSIX.1-2001, prevedono otto
836   diverse priorità ordinate da 0 a 7, in ordine di importanza decrescente;
837   questo comporta che i tre bit meno significativi dell'argomento
838   \param{priority} sono occupati da questo valore, mentre i restanti bit più
839   significativi vengono usati per specificare la \textit{facility}.}
840 specificabile attraverso le costanti riportate in
841 \secref{tab:sess_syslog_priority}.  Nel caso si voglia specificare anche la
842 \textit{facility} basta eseguire un OR aritmetico del valore della priorità
843 con la maschera binaria delle costanti di \tabref{tab:sess_syslog_facility}.
844
845 \begin{table}[htb]
846   \footnotesize
847   \centering
848   \begin{tabular}[c]{|l|p{8cm}|}
849     \hline
850     \textbf{Valore}& \textbf{Significato}\\
851     \hline
852     \hline
853     \const{LOG\_EMERG}   & Il sistema è inutilizzabile. \\
854     \const{LOG\_ALERT}   & C'è una emergenza che richiede intervento
855                            immediato.\\
856     \const{LOG\_CRIT}    & Si è in una condizione critica.\\
857     \const{LOG\_ERR}     & Si è in una condizione di errore.\\
858     \const{LOG\_WARNING} & Messaggio di avvertimento.\\
859     \const{LOG\_NOTICE}  & Notizia significativa relativa al comportamento.\\
860     \const{LOG\_INFO}    & Messaggio informativo. \\
861     \const{LOG\_DEBUG}   & Messaggio di debug.\\
862     \hline
863   \end{tabular}
864   \caption{Valori possibili per l'indice di importanza del messaggio da
865     specificare nell'argomento \param{priority} di \func{syslog}.}
866   \label{tab:sess_syslog_priority}
867 \end{table}
868
869 Una ulteriore funzione, \func{setlogmask}, permette di filtrare
870 preliminarmente i messaggi in base alla loro priorità; il suo prototipo è:
871 \begin{prototype}{syslog.h}{int setlogmask(int mask)}
872
873 Imposta la maschera dei log al valore specificato.
874
875 \bodydesc{La funzione restituisce il precedente valore.}
876 \end{prototype}
877
878 Le routine di gestione mantengono per ogni processo una maschera che determina
879 quale delle chiamate effettuate a \func{syslog} verrà effettivamente
880 registrata. La registrazione viene disabilitata per tutte quelle priorità che
881 non rientrano nella maschera; questa viene settata usando la macro
882 \macro{LOG\_MASK(p)} dove \code{p} è una delle costanti di
883 \secref{tab:sess_syslog_priority}. É inoltre disponibile anche la macro
884 \macro{LOG\_UPTO(p)} che permette di specificare automaticamente tutte le
885 priorità fino ad un certo valore.
886
887
888
889 \section{L'I/O su terminale}
890 \label{sec:sess_terminal_io}
891
892 Benché come ogni altro dispositivo i terminali siano accessibili come file,
893 essi hanno assunto storicamente (essendo stati a lungo l'unico modo di
894 accedere al sistema) una loro rilevanza specifica, che abbiamo già avuto modo
895 di incontrare nella precedente sezione.
896
897 Esamineremo qui le peculiarità dell'I/O eseguito sui terminali, che per la
898 loro particolare natura presenta delle differenze rispetto ai normali file su
899 disco e agli altri dispositivi.
900
901
902
903 \subsection{L'architettura}
904 \label{sec:term_design}
905
906 I terminali sono una classe speciale di dispositivi a caratteri (si ricordi la
907 classificazione di \secref{sec:file_file_types}); un terminale ha infatti una
908 caratteristica che lo contraddistingue da un qualunque altro dispositivo, e
909 cioè che è destinato a gestire l'interazione con un utente (deve essere cioè
910 in grado di fare da terminale di controllo per una sessione), che comporta la
911 presenza di ulteriori capacità.
912
913 L'interfaccia per i terminali è una delle più oscure e complesse, essendosi
914 stratificata dagli inizi dei sistemi Unix fino ad oggi. Questo comporta una
915 grande quantità di opzioni e controlli relativi ad un insieme di
916 caratteristiche (come ad esempio la velocità della linea) necessarie per
917 dispositivi, come i terminali seriali, che al giorno d'oggi sono praticamente
918 in disuso.
919
920 Storicamente i primi terminali erano appunto terminali di telescriventi
921 (\textit{teletype}), da cui deriva sia il nome dell'interfaccia, \textit{TTY},
922 che quello dei relativi file di dispositivo, che sono sempre della forma
923 \texttt{/dev/tty*}.\footnote{ciò vale solo in parte per i terminali virtuali,
924   essi infatti hanno due lati, un \textit{master}, che può assumere i nomi
925   \file{/dev/pty[p-za-e][0-9a-f]} ed un corrispondente \textit{slave} con nome
926   \file{/dev/tty[p-za-e][0-9a-f]}.}  Oggi essi includono le porte seriali, le
927 console virtuali dello schermo, i terminali virtuali che vengono creati come
928 canali di comunicazione dal kernel e che di solito vengono associati alle
929 connessioni di rete (ad esempio per trattare i dati inviati con \cmd{telnet} o
930 \cmd{ssh}).
931
932 L'I/O sui terminali si effettua con le stesse modalità dei file normali: si
933 apre il relativo file di dispositivo, e si leggono e scrivono i dati con le
934 usuali funzioni di lettura e scrittura, così se apriamo una console virtuale
935 avremo che \func{read} leggerà quanto immesso dalla tastiera, mentre
936 \func{write} scriverà sullo schermo.  In realtà questo è vero solo a grandi
937 linee, perché non tiene conto delle caratteristiche specifiche dei terminali;
938 una delle principali infatti è che essi prevedono due modalità di operazione,
939 dette rispettivamente \textsl{modo canonico} e \textsl{modo non canonico}, che
940 comportano dei comportamenti nettamente diversi.
941
942 La modalità preimpostata all'apertura del terminale è quella canonica, in cui
943 le operazioni di lettura vengono sempre effettuate assemblando i dati in una
944 linea;\footnote{per cui eseguendo una \func{read} su un terminale in modo
945   canonico la funzione si bloccherà, anche se si sono scritti dei caratteri,
946   fintanto che non si preme il tasto di ritorno a capo: a questo punto la
947   linea sarà completa e la funzione ritornerà.} ed in cui alcuni caratteri
948 vengono interpretati per compiere operazioni (come la generazione dei segnali
949 illustrati in \secref{sec:sig_job_control}), questa di norma è la modalità in
950 cui funziona la shell.
951
952 Un terminale in modo non canonico invece non effettua nessun accorpamento dei
953 dati in linee né li interpreta; esso viene di solito usato dai programmi (gli
954 editor ad esempio) che necessitano di poter leggere un carattere alla volta e
955 che gestiscono al loro interno i vari comandi.
956
957 Per capire le caratteristiche dell'I/O sui terminali, occorre esaminare le
958 modalità con cui esso viene effettuato; l'accesso, come per tutti i
959 dispositivi, viene gestito da un driver apposito, la cui struttura generica è
960 mostrata in \secref{fig:term_struct}. Ad un terminale sono sempre associate
961 due code per gestire l'input e l'output, che ne implementano una
962 bufferizzazione\footnote{completamente indipendente dalla eventuale ulteriore
963   bufferizzazione fornita dall'interfaccia standard dei file.} all'interno del
964 kernel.
965
966 \begin{figure}[htb]
967   \centering \includegraphics[width=13cm]{img/term_struct}
968   \caption{Struttura interna generica di un driver per un terminale.}
969   \label{fig:term_struct}
970 \end{figure}
971
972 La coda di ingresso mantiene i caratteri che sono stati letti dal terminale ma
973 non ancora letti da un processo, la sua dimensione è definita dal parametro di
974 sistema \const{MAX\_INPUT} (si veda \secref{sec:sys_file_limits}), che ne
975 specifica il limite minimo, in realtà la coda può essere più grande e cambiare
976 dimensione dinamicamente. Se è stato abilitato il controllo di flusso in
977 ingresso il driver emette i caratteri di STOP e START per bloccare e sbloccare
978 l'ingresso dei dati; altrimenti i caratteri immessi oltre le dimensioni
979 massime vengono persi; in alcuni casi il driver provvede ad inviare
980 automaticamente un avviso (un carattere di BELL, che provoca un beep)
981 sull'output quando si eccedono le dimensioni della coda.  Se è abilitato il
982 modo canonico i caratteri in ingresso restano nella coda fintanto che non
983 viene ricevuto un a capo; un'altra parametro del sistema, \const{MAX\_CANON},
984 specifica la dimensione massima di una riga in modo canonico.
985
986 La coda di uscita è analoga a quella di ingresso e contiene i caratteri
987 scritti dai processi ma non ancora inviati al terminale. Se è abilitato il
988 controllo di flusso in uscita il driver risponde ai caratteri di START e STOP
989 inviati dal terminale. Le dimensioni della coda non sono specificate, ma non
990 hanno molta importanza, in quanto qualora esse vengano eccedute il driver
991 provvede automaticamente a bloccare la funzione chiamante.
992
993
994
995 \subsection{La gestione delle caratteristiche di un terminale}
996 \label{sec:term_attr}
997
998 Data le loro peculiarità, fin dall'inizio si è posto il problema di come
999 gestire le caratteristiche specifiche dei terminali; storicamente i vari
1000 dialetti di Unix hanno utilizzato diverse funzioni, alla fine con POSIX.1, è
1001 stata effettuata una standardizzazione, unificando le differenze fra BSD e
1002 System V in una unica interfaccia, che è quella usata dal Linux.
1003
1004 Alcune di queste funzioni prendono come argomento un file descriptor (in
1005 origine molte operazioni venivano effettuate con \func{ioctl}), ma ovviamente
1006 possono essere usate solo con file che corrispondano effettivamente ad un
1007 terminale (altrimenti si otterrà un errore di \errcode{ENOTTY}); questo può
1008 essere evitato utilizzando la funzione \func{isatty}, il cui prototipo è:
1009 \begin{prototype}{unistd.h}{int isatty(int desc)}
1010   
1011   Controlla se il file descriptor \param{desc} è un terminale.
1012   
1013 \bodydesc{La funzione restituisce 1 se \param{desc} è connesso ad un
1014   terminale, 0 altrimenti.}
1015 \end{prototype}
1016
1017 Un'altra funzione che fornisce informazioni su un terminale è \func{ttyname},
1018 che permette di ottenere il nome del terminale associato ad un file
1019 descriptor; il suo prototipo è:
1020 \begin{prototype}{unistd.h}{char *ttyname(int desc)}
1021   
1022   Restituisce il nome del terminale associato al file \param{desc}.
1023   
1024    \bodydesc{La funzione restituisce il puntatore alla stringa contenente il
1025     nome del terminale associato \param{desc} e \val{NULL} in caso di
1026     errore.}
1027 \end{prototype}
1028
1029 Si tenga presente che la funzione restituisce un indirizzo di dati statici,
1030 che pertanto possono essere sovrascritti da successive chiamate. Una funzione
1031 funzione analoga, anch'essa prevista da POSIX.1, è \func{ctermid}, il cui
1032 prototipo è:
1033 \begin{prototype}{stdio.h}{char *ctermid(char *s)}
1034   
1035   Restituisce il nome del terminale di controllo del processo.
1036   
1037   \bodydesc{La funzione restituisce il puntatore alla stringa contenente il
1038     pathname del terminale.}
1039 \end{prototype}
1040
1041 La funzione scrive il pathname del terminale di controllo del processo
1042 chiamante nella stringa posta all'indirizzo specificato dall'argomento
1043 \param{s}.  La memoria per contenere la stringa deve essere stata allocata in
1044 precedenza ed essere lunga almeno
1045 \const{L\_ctermid}\footnote{\const{L\_ctermid} è una delle varie costanti del
1046   sistema, non trattata esplicitamente in \secref{sec:sys_characteristics} che
1047   indica la dimensione che deve avere una stringa per poter contenere il nome
1048   di un terminale.} caratteri. 
1049
1050 Esiste infine una versione rientrante \func{ttyname\_r} della funzione
1051 \func{ttyname}, che non presenta il problema dell'uso di una zona di memoria
1052 statica; il suo prototipo è:
1053 \begin{prototype}{unistd.h}{int ttyname\_r(int desc, char *buff, size\_t len)}
1054   
1055   Restituisce il nome del terminale associato al file \param{desc}.
1056   
1057   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
1058     errore, nel qual caso \var{errno} assumerà i valori:
1059     \begin{errlist}
1060     \item[\errcode{ERANGE}] la lunghezza del buffer, \param{len}, non è
1061       sufficiente per contenere la stringa restituita.
1062     \end{errlist}
1063     ed inoltre \errval{EBADF} ed \errval{ENOSYS}.
1064 }
1065 \end{prototype}
1066
1067 La funzione prende due argomenti, il puntatore alla zona di memoria
1068 \param{buff}, in cui l'utente vuole che il risultato venga scritto (dovrà
1069 ovviamente essere stata allocata in precedenza), e la relativa dimensione,
1070 \param{len}; se la stringa che deve essere restituita eccede questa dimensione
1071 si avrà una condizione di errore.
1072
1073 Se si passa come argomento \val{NULL} la funzione restituisce il puntatore
1074 ad una stringa statica che può essere sovrascritta da chiamate successive. Si
1075 tenga presente che il pathname restituito potrebbe non identificare
1076 univocamente il terminale (ad esempio potrebbe essere \file{/dev/tty}),
1077 inoltre non è detto che il processo possa effettivamente aprire il terminale.
1078
1079 I vari attributi vengono mantenuti per ciascun terminale in una struttura
1080 \struct{termios}, (la cui definizione è riportata in
1081 \figref{fig:term_termios}), usata dalle varie funzioni dell'interfaccia. In
1082 \figref{fig:term_termios} si sono riportati tutti i campi della definizione
1083 usata in Linux; di questi solo i primi cinque sono previsti dallo standard
1084 POSIX.1, ma le varie implementazioni ne aggiungono degli altri per mantenere
1085 ulteriori informazioni.\footnote{la definizione della struttura si trova in
1086   \file{bits/termios.h}, da non includere mai direttamente, Linux, seguendo
1087   l'esempio di BSD, aggiunge i due campi \var{c\_ispeed} e \var{c\_ospeed} per
1088   mantenere le velocità delle linee seriali, ed un campo ulteriore,
1089   \var{c\_line} per ... (NdT, trovare a che serve).}
1090
1091 \begin{figure}[!htb] 
1092   \footnotesize \centering
1093   \begin{minipage}[c]{15cm}
1094     \begin{lstlisting}[labelstep=0]{}
1095 struct termios {
1096     tcflag_t c_iflag;      /* input modes */
1097     tcflag_t c_oflag;      /* output modes */
1098     tcflag_t c_cflag;      /* control modes */
1099     tcflag_t c_lflag;      /* local modes */
1100     cc_t c_cc[NCCS];       /* control characters */
1101     cc_t c_line;           /* line discipline */
1102     speed_t c_ispeed;      /* input speed */
1103     speed_t c_ospeed;      /* output speed */
1104 ;
1105     \end{lstlisting}
1106   \end{minipage} 
1107   \normalsize 
1108   \caption{La struttura \structd{termios}, che identifica le proprietà di un
1109     terminale.}
1110   \label{fig:term_termios}
1111 \end{figure}
1112
1113 I primi quattro campi sono quattro flag che controllano il comportamento del
1114 terminale; essi sono realizzati come maschera binaria, pertanto il tipo
1115 \type{tcflag\_t} è di norma realizzato con un intero senza segno di lunghezza
1116 opportuna. I valori devono essere specificati bit per bit, avendo cura di non
1117 modificare i bit su cui non si interviene.
1118
1119 \begin{table}[b!ht]
1120   \footnotesize
1121   \centering
1122   \begin{tabular}[c]{|l|p{11cm}|}
1123     \hline
1124     \textbf{Valore}& \textbf{Significato}\\
1125     \hline
1126     \hline
1127     \const{INPCK}  & Abilita il controllo di parità in ingresso. Se non viene
1128                      impostato non viene fatto nessun controllo ed i caratteri
1129                      vengono passati in input direttamente.\\
1130     \const{IGNPAR} & Ignora gli errori di parità, il carattere viene passato
1131                      come ricevuto. Ha senso solo se si è impostato 
1132                      \const{INPCK}.\\
1133     \const{PARMRK} & Controlla come vengono riportati gli errori di parità. Ha 
1134                      senso solo se \const{INPCK} è impostato e \const{IGNPAR}
1135                      no. Se impostato inserisce una sequenza \texttt{0xFF
1136                        0x00} prima di ogni carattere che presenta errori di
1137                      parità, se non impostato un carattere con errori di
1138                      parità viene letto come uno \texttt{0x00}. Se un
1139                      carattere ha il valore \texttt{0xFF} e \const{ISTRIP} 
1140                      non è settato, per evitare ambiguità esso viene sempre
1141                      riportato come \texttt{0xFF 0xFF}.\\
1142     \const{ISTRIP} & Se impostato i caratteri in input sono tagliati a sette
1143                      bit mettendo a zero il bit più significativo, altrimenti 
1144                      vengono passati tutti gli otto bit.\\
1145     \const{IGNBRK} & Ignora le condizioni di BREAK sull'input. Una
1146                      \textit{condizione di BREAK} è definita nel contesto di
1147                      una trasmissione seriale asincrona come una sequenza di
1148                      bit nulli più lunga di un byte. \\
1149     \const{BRKINT} & Controlla la reazione ad un BREAK quando
1150                      \const{IGNBRK} non è impostato. Se \const{BRKINT} è
1151                      impostato il BREAK causa lo scarico delle code, 
1152                      e se il terminale è il terminale di controllo per un 
1153                      gruppo in foreground anche l'invio di \const{SIGINT} ai
1154                      processi di quest'ultimo. Se invece \const{BRKINT} non è
1155                      impostato un BREAK viene letto come un carattere
1156                      NUL, a meno che non sia settato \const{PARMRK}
1157                      nel qual caso viene letto come la sequenza di caratteri
1158                      \texttt{0xFF 0x00 0x00}.\\
1159     \const{IGNCR}  & Se impostato il carattere di ritorno carrello 
1160                      (\textit{carriage return}, \verb|'\r'|) viene scartato 
1161                      dall'input. Può essere utile per i terminali che inviano 
1162                      entrambi i caratteri di ritorno carrello e a capo 
1163                      (\textit{newline}, \verb|'\n'|).  \\
1164     \const{ICRNL}  & Se impostato un carattere di ritorno carrello  
1165                      (\verb|'\r'|) sul terminale viene automaticamente 
1166                      trasformato in un a capo (\verb|'\n'|) sulla coda di
1167                      input. \\
1168     \const{INLCR}  & Se impostato il carattere di a capo
1169                      (\verb|'\n'|) viene automaticamente trasformato in un
1170                      ritorno carrello (\verb|'\r'|).\\
1171     \const{IUCLC}  & Se impostato trasforma i caratteri maiuscoli dal
1172                      terminale in minuscoli sull'ingresso (opzione non 
1173                      POSIX).\\
1174     \const{IXON}   & Se impostato attiva il controllo di flusso in uscita con i
1175                      caratteri di START e STOP. se si riceve
1176                      uno STOP l'output viene bloccato, e viene fatto
1177                      ripartire solo da uno START, e questi due
1178                      caratteri non vengono passati alla coda di input. Se non
1179                      impostato i due caratteri sono passati alla coda di input
1180                      insieme agli altri.\\
1181     \const{IXANY}  & Se impostato con il controllo di flusso permette a
1182                      qualunque carattere di far ripartire l'output bloccato da
1183                      un carattere di STOP.\\
1184     \const{IXOFF}  & Se impostato abilita il controllo di flusso in
1185                      ingresso. Il computer emette un carattere di STOP per
1186                      bloccare l'input dal terminale e lo sblocca con il
1187                      carattere START. \\
1188     \const{IMAXBEL}& Se impostato fa suonare il cicalino se si riempie la cosa
1189                      di ingresso; in Linux non è implementato e il kernel si
1190                      comporta cose se fosse sempre settato (è una estensione
1191                      BSD). \\
1192     \hline
1193   \end{tabular}
1194   \caption{Costanti identificative dei vari bit del flag di controllo
1195     \var{c\_iflag} delle modalità di input di un terminale.}
1196   \label{tab:sess_termios_iflag}
1197 \end{table}
1198
1199 Il primo flag, mantenuto nel campo \var{c\_iflag}, è detto \textsl{flag di
1200   input} e controlla le modalità di funzionamento dell'input dei caratteri sul
1201 terminale, come il controllo di parità, il controllo di flusso, la gestione
1202 dei caratteri speciali; un elenco dei vari bit, del loro significato e delle
1203 costanti utilizzate per identificarli è riportato in
1204 \tabref{tab:sess_termios_iflag}.
1205
1206 Si noti come alcuni di questi flag (come quelli per la gestione del flusso)
1207 fanno riferimento a delle caratteristiche che ormai sono completamente
1208 obsolete; la maggior parte inoltre è tipica di terminali seriali, e non ha
1209 alcun effetto su dispositivi diversi come le console virtuali o gli
1210 pseudo-terminali usati nelle connessioni di rete.
1211
1212 \begin{table}[htb]
1213   \footnotesize
1214   \centering
1215   \begin{tabular}[c]{|l|p{11cm}|}
1216     \hline
1217     \textbf{Valore}& \textbf{Significato}\\
1218     \hline
1219     \hline
1220     \const{OPOST} & Se impostato i caratteri vengono convertiti opportunamente
1221                     (in maniera dipendente dall'implementazione) per la 
1222                     visualizzazione sul terminale, ad esempio al
1223                     carattere di a capo (NL) può venire aggiunto un ritorno
1224                     carrello (CR).\\
1225     \const{OCRNL} & Se impostato converte automaticamente il carattere di a
1226                     capo (NL) nella coppia di caratteri ritorno carrello, a 
1227                     capo (CR-NL).\\
1228     \const{OLCUC} & Se impostato trasforma i caratteri minuscoli in ingresso 
1229                     in caratteri maiuscoli sull'uscita (non previsto da
1230                     POSIX.1).\\
1231     \const{ONLCR} & Se impostato converte automaticamente il carattere di a 
1232                     capo (NL) in un carattere di ritorno carrello (CR).\\
1233     \const{ONOCR} & Se impostato converte il carattere di ritorno carrello
1234                     (CR) nella coppia di caratteri CR-NL.\\
1235     \const{ONLRET}& Se impostato rimuove dall'output il carattere di ritorno
1236                     carrello (CR).\\
1237     \const{OFILL} & Se impostato in caso di ritardo sulla linea invia dei
1238                     caratteri di riempimento invece di attendere.\\
1239     \const{OFDEL} & Se impostato il carattere di riempimento è DEL
1240                     (\texttt{0x3F}), invece che NUL (\texttt{0x00}).\\
1241     \const{NLDLY} & Maschera per i bit che indicano il ritardo per il
1242                     carattere di a capo (NL), i valori possibili sono 
1243                     \val{NL0} o \val{NL1}.\\
1244     \const{CRDLY} & Maschera per i bit che indicano il ritardo per il
1245                     carattere ritorno carrello (CR), i valori possibili sono
1246                     \val{CR0}, \val{CR1}, \val{CR2} o \val{CR3}.\\
1247     \const{TABDLY}& Maschera per i bit che indicano il ritardo per il
1248                     carattere di tabulazione, i valori possibili sono
1249                     \val{TAB0}, \val{TAB1}, \val{TAB2} o \val{TAB3}.\\
1250     \const{BSDLY} & Maschera per i bit che indicano il ritardo per il
1251                     carattere di ritorno indietro (\textit{backspace}), i
1252                     valori possibili sono \val{BS0} o \val{BS1}.\\
1253     \const{VTDLY} & Maschera per i bit che indicano il ritardo per il
1254                     carattere di tabulazione verticale, i valori possibili sono
1255                     \val{VT0} o \val{VT1}.\\
1256     \const{FFDLY} & Maschera per i bit che indicano il ritardo per il
1257                     carattere di pagina nuova (\textit{form feed}), i valori
1258                     possibili sono \val{FF0} o \val{FF1}.\\
1259     \hline
1260   \end{tabular}
1261   \caption{Costanti identificative dei vari bit del flag di controllo
1262     \var{c\_oflag} delle modalità di output di un terminale.}
1263   \label{tab:sess_termios_oflag}
1264 \end{table}
1265
1266 Il secondo flag, mantenuto nel campo \var{c\_oflag}, è detto \textsl{flag di
1267   output} e controlla le modalità di funzionamento dell'output dei caratteri,
1268 come l'impacchettamento dei caratteri sullo schermo, la traslazione degli a
1269 capo, la conversione dei caratteri speciali; un elenco dei vari bit, del loro
1270 significato e delle costanti utilizzate per identificarli è riportato in
1271 \tabref{tab:sess_termios_oflag}.
1272
1273 Si noti come alcuni dei valori riportati in \tabref{tab:sess_termios_oflag}
1274 fanno riferimento a delle maschere di bit; essi infatti vengono utilizzati per
1275 impostare alcuni valori numerici relativi ai ritardi nell'output di alcuni
1276 caratteri: una caratteristica originaria dei primi terminali su telescrivente,
1277 che avevano bisogno di tempistiche diverse per spostare il carrello in
1278 risposta ai caratteri speciali, e che oggi sono completamente in disuso.
1279
1280 Si tenga presente inoltre che nel caso delle maschere il valore da inserire in
1281 \var{c\_oflag} deve essere fornito avendo cura di cancellare prima tutti i bit
1282 della maschera, i valori da immettere infatti (quelli riportati nella
1283 spiegazione corrispondente) sono numerici e non per bit, per cui possono
1284 sovrapporsi fra di loro. Occorrerà perciò utilizzare un codice del tipo:
1285
1286 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}%
1287     c_oflag &= (~CRDLY);
1288     c_oflag |= CR1;
1289 \end{lstlisting}
1290
1291 \noindent che prima cancella i bit della maschera in questione e poi setta il
1292 valore.
1293
1294
1295 \begin{table}[htb]
1296   \footnotesize
1297   \centering
1298   \begin{tabular}[c]{|l|p{11cm}|}
1299     \hline
1300     \textbf{Valore}& \textbf{Significato}\\
1301     \hline
1302     \hline
1303     \const{CLOCAL} & Se impostato indica che il terminale è connesso in locale
1304                      e che le linee di controllo del modem devono essere
1305                      ignorate. Se non impostato effettuando una chiamata ad
1306                      \func{open} senza aver specificato il flag di
1307                      \const{O\_NOBLOCK} si bloccherà il processo finché 
1308                      non si è stabilita una connessione con il modem; inoltre 
1309                      se viene rilevata una disconessione viene inviato un
1310                      \const{SIGHUP} al processo di controllo del terminale. La
1311                      lettura su un terminale sconnesso comporta una condizione
1312                      di \textit{end of file} e la scrittura un errore di
1313                      \errcode{EIO}. \\
1314     \const{HUPCL}  & Se è impostato viene distaccata la connessione del
1315                      modem quando l'ultimo dei processi che ha ancora un file
1316                      aperto sul terminale lo chiude o esce.\\
1317     \const{CREAD}  & Se è impostato si può leggere l'input del terminale,
1318                      altrimenti i caratteri in ingresso vengono scartati
1319                      quando arrivano.\\
1320     \const{CSTOPB} & Se impostato vengono usati due bit di stop sulla linea
1321                      seriale, se non impostato ne viene usato soltanto uno.\\
1322     \const{PARENB} & Se impostato abilita la generazione il controllo di
1323                      parità. La reazione in caso di errori dipende dai
1324                      relativi valori per \var{c\_iflag}, riportati in 
1325                      \tabref{tab:sess_termios_iflag}. Se non è impostato i bit
1326                      di parità non vengono
1327                      generati e i caratteri non vengono controllati.\\
1328     \const{PARODD} & Ha senso solo se è attivo anche \const{PARENB}. Se 
1329                      impostato viene usata una parità è dispari, altrimenti 
1330                      viene usata una parità pari.\\
1331     \const{CSIZE}  & Maschera per i bit usati per specificare la dimensione 
1332                      del carattere inviato lungo la linea di trasmissione, i
1333                      valore ne indica la lunghezza (in bit), ed i valori   
1334                      possibili sono \val{CS5}, \val{CS6}, 
1335                      \val{CS7} e \val{CS8}
1336                      corrispondenti ad un analogo numero di bit.\\
1337     \const{CBAUD}  & Maschera dei bit (4+1) usati per impostare della velocità
1338                      della linea (il \textit{baud rate}) in ingresso. 
1339                      In Linux non è implementato in quanto viene 
1340                      usato un apposito campo di \struct{termios}.\\
1341     \const{CBAUDEX}& Bit aggiuntivo per l'impostazione della velocità della
1342                      linea, per le stesse motivazioni del precedente non è
1343                      implementato in Linux.\\
1344     \const{CIBAUD} & Maschera dei bit della velocità della linea in
1345                      ingresso. Analogo a \const{CBAUD}, anch'esso in Linux è
1346                      mantenuto in un apposito campo di \struct{termios}. \\
1347     \const{CRTSCTS}& Abilita il controllo di flusso hardware sulla seriale,
1348                      attraverso l'utilizzo delle dei due fili di RTS e CTS.\\
1349     \hline
1350   \end{tabular}
1351   \caption{Costanti identificative dei vari bit del flag di controllo
1352     \var{c\_cflag} delle modalità di controllo di un terminale.}
1353   \label{tab:sess_termios_cflag}
1354 \end{table}
1355
1356 Il terzo flag, mantenuto nel campo \var{c\_cflag}, è detto \textsl{flag di
1357   controllo} ed è legato al funzionamento delle linee seriali, permettendo di
1358 impostarne varie caratteristiche, come il numero di bit di stop, i settaggi
1359 della parità, il funzionamento del controllo di flusso; esso ha senso solo per
1360 i terminali connessi a linee seriali. Un elenco dei vari bit, del loro
1361 significato e delle costanti utilizzate per identificarli è riportato in
1362 \tabref{tab:sess_termios_cflag}.
1363
1364 I valori di questo flag sono molto specifici, e completamente indirizzati al
1365 controllo di un terminale mantenuto su una linea seriale; essi pertanto non
1366 hanno nessuna rilevanza per i terminali che usano un'altra interfaccia, come
1367 le console virtuali e gli pseudo-terminali usati dalle connessioni di rete.
1368
1369 Inoltre alcuni valori sono previsti solo per quelle implementazioni (lo
1370 standard POSIX non specifica nulla riguardo l'implementazione, ma solo delle
1371 funzioni di lettura e scrittura) che mantengono le velocità delle linee
1372 seriali all'interno dei flag; come accennato in Linux questo viene fatto
1373 (seguendo l'esempio di BSD) attraverso due campi aggiuntivi, \var{c\_ispeed} e
1374 \var{c\_ospeed}, nella struttura \struct{termios} (mostrati in
1375 \figref{fig:term_termios}).
1376
1377 \begin{table}[b!ht]
1378   \footnotesize
1379   \centering
1380   \begin{tabular}[c]{|l|p{11cm}|}
1381     \hline
1382     \textbf{Valore}& \textbf{Significato}\\
1383     \hline
1384     \hline
1385     \const{ICANON} & Se impostato il terminale opera in modo canonico,
1386                      altrimenti opera in modo non canonico.\\
1387     \const{ECHO}   & Se è impostato viene attivato l'eco dei caratteri in
1388                      input sull'output del terminale.\\
1389     \const{ECHOE}  & Se è impostato l'eco mostra la cancellazione di un
1390                      carattere in input (in reazione al carattere ERASE)
1391                      cancellando l'ultimo carattere della riga corrente dallo
1392                      schermo; altrimenti il carattere è rimandato in eco per
1393                      mostrare quanto accaduto (usato per i terminali con
1394                      l'uscita su una stampante). \\
1395     \const{ECHOPRT}& Se impostato abilita la visualizzazione del carattere di
1396                      cancellazione in una modalità adatta ai terminali con
1397                      l'uscita su stampante; l'invio del carattere di ERASE
1398                      comporta la stampa di un \verb|\| seguito dal carattere
1399                      cancellato, e così via in caso di successive
1400                      cancellazioni, quando si riprende ad immettere carattere 
1401                      normali prima verrà stampata una \texttt{/}.\\
1402     \const{ECHOK}  & Se impostato abilita il trattamento della visualizzazione
1403                      del carattere KILL, andando a capo dopo aver visualizzato
1404                      lo stesso, altrimenti viene solo mostrato il carattere e
1405                      sta all'utente ricordare che l'input precedente è stato
1406                      cancellato. \\
1407     \const{ECHOKE} & Se impostato abilita il trattamento della visualizzazione
1408                      del carattere KILL cancellando i caratteri precedenti
1409                      nella linea secondo le modalità specificate dai valori di
1410                      \const{ECHOE} e \const{ECHOPRT}.\\
1411     \const{ECHONL} & Se impostato viene effettuato l'eco di un a
1412                      capo (\verb|\n|) anche se non è stato impostato
1413                      \const{ECHO}. \\
1414     \const{ECHOCTL}& Se impostato insieme ad \const{ECHO} i caratteri di
1415                      controllo ASCII (tranne TAB, NL, START, e STOP) sono
1416                      mostrati nella forma che prepende un \verb|^| alla
1417                      lettera ottenuta sommando \texttt{0x40} al valore del
1418                      carattere (di solito questi si possono ottenere anche
1419                      direttamente premendo il tasto \texttt{ctrl} più la
1420                      relativa lettera).\\
1421     \const{ISIG}   & Se impostato abilita il riconoscimento dei caratteri
1422                      INTR, QUIT, e SUSP generando il relativo segnale.\\
1423     \const{IEXTEN} & Abilita alcune estensioni previste dalla
1424                      implementazione. Deve essere impostato perché caratteri
1425                      speciali come EOL2, LNEXT, REPRINT e WERASE possano
1426                      essere interpretati. \\
1427     \const{NOFLSH} & Se impostato disabilita lo scarico delle code di ingresso
1428                      e uscita quando vengono emessi i segnali \const{SIGINT}, 
1429                      \const{SIGQUIT} and \const{SIGSUSP}.\\
1430     \const{TOSTOP} & Se abilitato, con il supporto per il job control presente,
1431                      genera il segnale \const{SIGTTOU} per un processo in
1432                      background che cerca di scrivere sul terminale.\\
1433     \const{XCASE}  & Se settato il terminale funziona solo con le
1434                      maiuscole. L'input è convertito in minuscole tranne per i
1435                      caratteri preceduti da una \verb|\|. In output le
1436                      maiuscole sono precedute da una \verb|\| e le minuscole
1437                      convertite in maiuscole.\\
1438     \const{DEFECHO}& Se impostate effettua l'eco solo se c'è un processo in
1439                      lettura.\\
1440     \const{FLUSHO} & Effettua la cancellazione della coda di uscita. Viene
1441                      attivato dal carattere DISCARD. Non è supportato in
1442                      Linux.\\
1443     \const{PENDIN} & Indica che la linea deve essere ristampata, viene
1444                      attivato dal carattere REPRINT e resta attivo fino alla
1445                      fine della ristampa. Non è supportato in Linux.\\
1446     \hline
1447   \end{tabular}
1448   \caption{Costanti identificative dei vari bit del flag di controllo
1449     \var{c\_lflag} delle modalità locali di un terminale.}
1450   \label{tab:sess_termios_lflag}
1451 \end{table}
1452
1453 Il quarto flag, mantenuto nel campo \var{c\_lflag}, è detto \textsl{flag
1454   locale}, e serve per controllare il funzionamento dell'interfaccia fra il
1455 driver e l'utente, come abilitare l'eco, gestire i caratteri di controllo e
1456 l'emissione dei segnali, impostare modo canonico o non canonico; un elenco dei
1457 vari bit, del loro significato e delle costanti utilizzate per identificarli è
1458 riportato in \tabref{tab:sess_termios_lflag}. Con i terminali odierni l'unico
1459 flag con cui probabilmente si può avere a che fare è questo, in quanto è con
1460 questo che si impostano le caratteristiche generiche comuni a tutti i
1461 terminali.
1462
1463 Si tenga presente che i flag che riguardano le modalità di eco dei caratteri
1464 (\const{ECHOE}, \const{ECHOPRT}, \const{ECHOK}, \const{ECHOKE},
1465 \const{ECHONL}) controllano solo il comportamento della visualizzazione, il
1466 riconoscimento dei vari caratteri dipende dalla modalità di operazione, ed
1467 avviene solo in modo canonico, pertanto questi flag non hanno significato se
1468 non è impostato \const{ICANON}.
1469
1470 Oltre ai vari flag per gestire le varie caratteristiche dei terminali,
1471 \struct{termios} contiene pure il campo \var{c\_cc} che viene usato per
1472 impostare i caratteri speciali associati alle varie funzioni di controllo. Il
1473 numero di questi caratteri speciali è indicato dalla costante \const{NCCS},
1474 POSIX ne specifica almeno 11, ma molte implementazioni ne definiscono molti
1475 altri.\footnote{in Linux il valore della costante è 32, anche se i caratteri
1476   effettivamente definiti sono solo 17.}
1477
1478 \begin{table}[htb]
1479   \footnotesize
1480   \centering
1481   \begin{tabular}[c]{|l|c|c|p{8cm}|}
1482     \hline
1483     \textbf{Indice} & \textbf{Valore}&\textbf{Codice} & \textbf{Funzione}\\
1484     \hline
1485     \hline
1486     \const{VINTR}   &\texttt{0x03}&(\verb|C-c|)& Carattere di interrupt, 
1487                                                  provoca l'emissione di 
1488                                                  \const{SIGINT}. \\
1489     \const{VQUIT}   &\texttt{0x1C}&(\verb|C-\|)& Carattere di uscita provoca 
1490                                                  l'emissione di 
1491                                                  \const{SIGQUIT}.\\
1492     \const{VERASE}  &\texttt{0x7f}& DEL &  Carattere di ERASE, cancella
1493                                            l'ultimo carattere precedente 
1494                                            nella linea.\\
1495     \const{VKILL}   &\texttt{0x15}&(\verb|C-u|)& Carattere di KILL, cancella
1496                                                  l'intera riga.\\
1497     \const{VEOF}    &\texttt{0x04}&(\verb|C-d|)& Carattere di
1498                                                  \textit{end-of-file}. Causa
1499                                                  l'invio del contenuto del
1500                                                  buffer di ingresso al
1501                                                  processo in lettura anche se
1502                                                  non è ancora stato ricevuto
1503                                                  un a capo. Se è il primo
1504                                                  carattere immesso comporta il
1505                                                  ritorno di \func{read} con
1506                                                  zero caratteri, cioè la
1507                                                  condizione di
1508                                                  \textit{end-of-file}.\\
1509     \const{VTIME}   &   ---       & --- & Timeout, in decimi di secondo, per
1510                                           una lettura in modo non canonico. \\
1511     \const{VMIN}    &   ---       & --- & Numero minimo di caratteri per una 
1512                                           lettura in modo non canonico.\\
1513     \const{VSWTC}   &\texttt{0x00}& NUL & Carattere di switch. Non supportato
1514                                           in Linux.\\
1515     \const{VSTART}  &\texttt{0x21}&(\verb|C-q|)& Carattere di START. Riavvia un
1516                                                  output bloccato da uno STOP.\\
1517     \const{VSTOP}   &\texttt{0x23}&(\verb|C-s|)& Carattere di STOP. Blocca
1518                                                  l'output fintanto che non
1519                                                  viene premuto un carattere di
1520                                                  START.\\
1521     \const{VSUSP}   &\texttt{0x1A}&(\verb|C-z|)& Carattere di
1522                                                  sospensione. Invia il segnale
1523                                                  \const{SIGTSTP}.\\
1524     \const{VEOL}    &\texttt{0x00}& NUL & Carattere di fine riga. Agisce come
1525                                           un a capo, ma non viene scartato ed
1526                                           è letto come l'ultimo carattere
1527                                           nella riga.  \\
1528     \const{VREPRINT}&\texttt{0x12}&(\verb|C-r|)& Ristampa i caratteri non
1529                                                  ancora letti.  \\
1530     \const{VDISCARD}&\texttt{0x07}&(\verb|C-o|)& Non riconosciuto in Linux. \\
1531     \const{VWERASE} &\texttt{0x17}&(\verb|C-w|)& Cancellazione di una parola.\\
1532     \const{VLNEXT}  &\texttt{0x16}&(\verb|C-v|)& Carattere di escape, serve a
1533                                                  quotare il carattere
1534                                                  successivo che non viene
1535                                                  interpretato ma passato
1536                                                  direttamente all'output. \\
1537     \const{VEOL2}   &\texttt{0x00}& NUL & Ulteriore carattere di fine
1538                                           riga. Ha lo stesso effetto di
1539                                           \const{VEOL} ma può essere un
1540                                           carattere diverso. \\
1541     \hline
1542   \end{tabular}
1543   \caption{Valori dei caratteri di controllo mantenuti nel campo \var{c\_cc}
1544     della struttura \struct{termios}.} 
1545   \label{tab:sess_termios_cc}
1546 \end{table}
1547
1548
1549 A ciascuna di queste funzioni di controllo corrisponde un elemento del vettore
1550 \var{c\_cc} che specifica quale è il carattere speciale associato; per
1551 portabilità invece di essere indicati con la loro posizione numerica nel
1552 vettore, i vari elementi vengono indicizzati attraverso delle opportune
1553 costanti, il cui nome corrisponde all'azione ad essi associata. Un elenco
1554 completo dei caratteri di controllo, con le costanti e delle funzionalità
1555 associate è riportato in \tabref{tab:sess_termios_cc}, usando quelle
1556 definizioni diventa possibile assegnare un nuovo carattere di controllo con un
1557 codice del tipo:
1558 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}%
1559     value.c_cc[VEOL2] = '\n';
1560 \end{lstlisting}
1561
1562 La maggior parte di questi caratteri (tutti tranne \const{VTIME} e
1563 \const{VMIN}) hanno effetto solo quando il terminale viene utilizzato in modo
1564 canonico; per alcuni devono essere essere soddisfatte ulteriori richieste, ad
1565 esempio \const{VINTR}, \const{VSUSP}, e \const{VQUIT} richiedono sia settato
1566 \const{ISIG}; \const{VSTART} e \const{VSTOP} richiedono sia settato
1567 \const{IXON}; \const{VLNEXT}, \const{VWERASE}, \const{VREPRINT} richiedono sia
1568 settato \const{IEXTEN}.  In ogni caso quando vengono attivati i caratteri
1569 vengono interpretati e non sono passati sulla coda di ingresso.
1570
1571 Per leggere ed scrivere tutte le impostazioni dei terminali lo standard POSIX
1572 prevede due funzioni, \func{tcgetattr} e \func{tcsetattr}; entrambe utilizzano
1573 come argomento un puntatore ad struttura \struct{termios} che sarà quella in
1574 cui andranno immagazzinate le impostazioni, il loro prototipo è:
1575 \begin{functions}
1576   \headdecl{unistd.h} 
1577   \headdecl{termios.h}  
1578   \funcdecl{int tcgetattr(int fd, struct termios *termios\_p)} 
1579   Legge il valore delle impostazioni di un terminale.
1580   
1581   \funcdecl{int tcsetattr(int fd, int optional\_actions, struct termios
1582     *termios\_p)} 
1583   Scrive le impostazioni di un terminale.
1584   
1585   \bodydesc{Entrambe le funzioni restituiscono 0 in caso di successo e -1 in
1586     caso di errore, nel qual caso \var{errno} assumerà i valori:
1587     \begin{errlist}
1588     \item[\errcode{EINTR}] La funzione è stata interrotta. 
1589     \end{errlist}
1590     ed inoltre \errval{EBADF}, \errval{ENOTTY} ed \errval{EINVAL}. 
1591   }
1592 \end{functions}
1593
1594 Le funzioni operano sul terminale cui fa riferimento il file descriptor
1595 \param{fd} utilizzando la struttura indicata dal puntatore \param{termios\_p}
1596 per lo scambio dei dati. Si tenga presente che le impostazioni sono associate
1597 al terminale e non al file descriptor; questo significa che se si è cambiata
1598 una impostazione un qualunque altro processo che apra lo stesso terminale, od
1599 un qualunque altro file descriptor che vi faccia riferimento, vedrà le nuove
1600 impostazioni pur non avendo nulla a che fare con il file descriptor che si è
1601 usato per effettuare i cambiamenti.
1602
1603 Questo significa che non è possibile usare file descriptor diversi per
1604 utilizzare automaticamente il terminale in modalità diverse, se esiste una
1605 necessità di accesso differenziato di questo tipo occorrerà cambiare
1606 esplicitamente la modalità tutte le volte che si passa da un file descriptor
1607 ad un altro.
1608
1609 La funzione \func{tcgetattr} legge i valori correnti delle impostazioni di un
1610 terminale qualunque nella struttura puntata da \param{termios\_p};
1611 \func{tcsetattr} invece effettua la scrittura delle impostazioni e quando
1612 viene invocata sul proprio terminale di controllo può essere eseguita con
1613 successo solo da un processo in foreground.  Se invocata da un processo in
1614 background infatti tutto il gruppo riceverà un segnale di \const{SIGTTOU} come
1615 se si fosse tentata una scrittura, a meno che il processo chiamante non abbia
1616 \const{SIGTTOU} ignorato o bloccato, nel qual caso l'operazione sarà eseguita.
1617
1618 La funzione \func{tcsetattr} prevede tre diverse modalità di funzionamento,
1619 specificabili attraverso l'argomento \param{optional\_actions}, che permette
1620 di stabilire come viene eseguito il cambiamento delle impostazioni del
1621 terminale, i valori possibili sono riportati in
1622 \tabref{tab:sess_tcsetattr_option}; di norma (come fatto per le due funzioni
1623 di esempio) si usa sempre \const{TCSANOW}, le altre opzioni possono essere
1624 utili qualora si cambino i parametri di output.
1625
1626 \begin{table}[htb]
1627   \footnotesize
1628   \centering
1629   \begin{tabular}[c]{|l|p{8cm}|}
1630     \hline
1631     \textbf{Valore}& \textbf{Significato}\\
1632     \hline
1633     \hline
1634     \const{TCSANOW}  & Esegue i cambiamenti in maniera immediata. \\
1635     \const{TCSADRAIN}& I cambiamenti vengono eseguiti dopo aver atteso che
1636                        tutto l'output presente sulle code è stato scritto. \\
1637     \const{TCSAFLUSH}& È identico a \const{TCSADRAIN}, ma in più scarta
1638                        tutti i dati presenti sulla coda di input.\\
1639     \hline
1640   \end{tabular}
1641   \caption{Possibili valori per l'argomento \param{optional\_actions} della
1642     funzione \func{tcsetattr}.} 
1643   \label{tab:sess_tcsetattr_option}
1644 \end{table}
1645
1646 Occorre infine tenere presente che \func{tcsetattr} ritorna con successo anche
1647 se soltanto uno dei cambiamenti richiesti è stato eseguito. Pertanto se si
1648 effettuano più cambiamenti è buona norma controllare con una ulteriore
1649 chiamata a \func{tcgetattr} che essi siano stati eseguiti tutti quanti.
1650
1651 \begin{figure}[!htb]
1652   \footnotesize 
1653   \begin{lstlisting}{}%
1654 #include <unistd.h>
1655 #include <termios.h>
1656 #include <errno.h>
1657
1658 int SetTermAttr(int fd, tcflag_t flag) 
1659 {
1660     struct termios values;
1661     int res;
1662     res = tcgetattr (desc, &values);
1663     if (res) {
1664         perror("Cannot get attributes");
1665         return res;
1666     }
1667     values.c_lflag |= flag;
1668     res = tcsetattr (desc, TCSANOW, &values);
1669     if (res) {
1670         perror("Cannot set attributes");
1671         return res;
1672     }
1673     return 0;
1674 }
1675   \end{lstlisting}
1676   \caption{Codice della funzione \func{SetTermAttr} che permette di
1677     impostare uno dei flag di controllo locale del terminale.}
1678   \label{fig:term_set_attr}
1679 \end{figure}
1680
1681 Come già accennato per i cambiamenti effettuati ai vari flag di controllo
1682 occorre che i valori di ciascun bit siano specificati avendo cura di mantenere
1683 intatti gli altri; per questo motivo in generale si deve prima leggere il
1684 valore corrente delle impostazioni con \func{tcgetattr} per poi modificare i
1685 valori impostati.
1686
1687 In \figref{fig:term_set_attr} e \figref{fig:term_unset_attr} si è riportato
1688 rispettivamente il codice delle due funzioni \func{SetTermAttr} e
1689 \func{UnSetTermAttr}, che possono essere usate per impostare o rimuovere, con
1690 le dovute precauzioni, un qualunque bit di \var{c\_lflag}. Il codice di
1691 entrambe le funzioni può essere trovato nel file \file{SetTermAttr.c} dei
1692 sorgenti allegati.
1693
1694 La funzione \func{SetTermAttr} provvede ad impostare il bit specificato
1695 dall'argomento \param{flag}; prima si leggono i valori correnti
1696 (\texttt{\small 10}) con \func{tcgetattr}, uscendo con un messaggio in caso di
1697 errore (\texttt{\small 11--14}), poi si provvede a impostare solo i bit
1698 richiesti (possono essere più di uno) con un OR binario (\texttt{\small 15});
1699 infine si scrive il nuovo valore modificato con \func{tcsetattr}
1700 (\texttt{\small 16}), notificando un eventuale errore (\texttt{\small 11--14})
1701 o uscendo normalmente.
1702
1703 \begin{figure}[!htb]
1704   \footnotesize 
1705   \begin{lstlisting}{}%
1706 int UnSetTermAttr(int fd, tcflag_t flag) 
1707 {
1708     struct termios values;
1709     int res;
1710     res = tcgetattr (desc, &values);
1711     if (res) {
1712         perror("Cannot get attributes");
1713         return res;
1714     }
1715     values.c_lflag &= (~flag);
1716     res = tcsetattr (desc, TCSANOW, &values);
1717     if (res) {
1718         perror("Cannot set attributes");
1719         return res;
1720     }
1721     return 0;
1722 }
1723   \end{lstlisting}
1724   \caption{Codice della funzione \func{UnSetTermAttr} che permette di
1725     rimuovere uno dei flag di controllo locale del terminale.} 
1726   \label{fig:term_unset_attr}
1727 \end{figure}
1728
1729 La seconda funzione, \func{UnSetTermAttr}, è assolutamente identica alla
1730 prima, solo che in questo caso (in \texttt{\small 15}) si rimuovono i bit
1731 specificati dall'argomento \param{flag} usando un AND binario del valore
1732 negato.
1733
1734
1735 Al contrario di tutte le altre caratteristiche dei terminali, che possono
1736 essere impostate esplicitamente utilizzando gli opportuni campi di
1737 \struct{termios}, per le velocità della linea (il cosiddetto \textit{baud
1738   rate}) non è prevista una implementazione standardizzata, per cui anche se
1739 in Linux sono mantenute in due campi dedicati nella struttura, questi non
1740 devono essere acceduti direttamente ma solo attraverso le apposite funzioni di
1741 interfaccia provviste da POSIX.1.
1742
1743 Lo standard prevede due funzioni per scrivere la velocità delle linee seriali,
1744 \func{cfsetispeed} per la velocità della linea di ingresso e
1745 \func{cfsetospeed} per la velocità della linea di uscita; i loro prototipi
1746 sono:
1747 \begin{functions}
1748   \headdecl{unistd.h} 
1749   \headdecl{termios.h}  
1750   \funcdecl{int cfsetispeed(struct termios *termios\_p, speed\_t speed)} 
1751   Imposta la velocità delle linee seriali in ingresso.
1752   
1753   \funcdecl{int cfsetospeed(struct termios *termios\_p, speed\_t speed)} 
1754   Imposta la velocità delle linee seriali in uscita.
1755   
1756   \bodydesc{Entrambe le funzioni restituiscono 0 in caso di successo e -1 in
1757     caso di errore, che avviene solo quando il valore specificato non è
1758     valido.}
1759 \end{functions}
1760  
1761 Si noti che le funzioni si limitano a scrivere opportunamente il valore della
1762 velocità prescelta \param{speed} all'interno della struttura puntata da
1763 \param{termios\_p}; per effettuare l'impostazione effettiva occorrerà poi
1764 chiamare \func{tcsetattr}.
1765
1766 Si tenga presente che per le linee seriali solo alcuni valori di velocità sono
1767 validi; questi possono essere specificati direttamente (le \acr{glibc}
1768 prevedono che i valori siano indicati in bit per secondo), ma in generale
1769 altre versioni di librerie possono utilizzare dei valori diversi; per questo
1770 POSIX.1 prevede una serie di costanti che però servono solo per specificare le
1771 velocità tipiche delle linee seriali:
1772 \begin{verbatim}
1773      B0       B50      B75     B110    B134    B150
1774      B200     B300     B600    B1200   B1800   B2400
1775      B4800    B9600    B19200  B38400  B57600  B115200
1776      B230400  B460800
1777 \end{verbatim}
1778
1779 Un terminale può utilizzare solo alcune delle velocità possibili, le funzioni
1780 però non controllano se il valore specificato è valido, dato che non possono
1781 sapere a quale terminale le velocità saranno applicate; sarà l'esecuzione di
1782 \func{tcsetattr} a fallire quando si cercherà di eseguire l'impostazione.
1783
1784 Di norma il valore ha senso solo per i terminali seriali dove indica appunto
1785 la velocità della linea di trasmissione; se questa non corrisponde a quella
1786 del terminale quest'ultimo non potrà funzionare: quando il terminale non è
1787 seriale il valore non influisce sulla velocità di trasmissione dei dati. 
1788
1789 In generale impostare un valore nullo (\val{B0}) sulla linea di output fa si
1790 che il modem non asserisca più le linee di controllo, interrompendo di fatto
1791 la connessione, qualora invece si utilizzi questo valore per la linea di input
1792 l'effetto sarà quello di rendere la sua velocità identica a quella della linea
1793 di output.
1794
1795 Analogamente a quanto avviene per l'impostazione, le velocità possono essere
1796 lette da una struttura \struct{termios} utilizzando altre due funzioni,
1797 \funcd{cfgetispeed} e \funcd{cfgetospeed}, i cui prototipi sono:
1798 \begin{functions}
1799   \headdecl{unistd.h} 
1800   \headdecl{termios.h}  
1801   \funcdecl{speed\_t cfgetispeed(struct termios *termios\_p)} 
1802   Legge la velocità delle linee seriali in ingresso.
1803   
1804   \funcdecl{speed\_t cfgetospeed(struct termios *termios\_p)} 
1805   Legge la velocità delle linee seriali in uscita.
1806   
1807   \bodydesc{Entrambe le funzioni restituiscono la velocità della linea, non
1808   sono previste condizioni di errore.}
1809 \end{functions}
1810
1811 Anche in questo caso le due funzioni estraggono i valori della velocità della
1812 linea da una struttura, il cui indirizzo è specificato dall'argomento
1813 \param{termios\_p} che deve essere stata letta in precedenza con
1814 \func{tcgetaddr}.
1815
1816
1817
1818 \subsection{La gestione della disciplina di linea.}
1819 \label{sec:term_line_discipline}
1820
1821 Come illustrato dalla struttura riportata in \figref{fig:term_struct} tutti i
1822 terminali hanno un insieme di funzionalità comuni, che prevedono la presenza
1823 di code di ingresso ed uscita; in generale si fa riferimento ad esse con il
1824 nome di \textsl{discipline di linea}. 
1825
1826
1827 Lo standard POSIX prevede alcune funzioni che permettono di intervenire
1828 direttamente sulla gestione di quest'ultime e sull'interazione fra i dati in
1829 ingresso ed uscita e le relative code. In generale tutte queste funzioni
1830 vengono considerate, dal punto di vista dell'accesso al terminale, come delle
1831 funzioni di scrittura, pertanto se usate da processi in background sul loro
1832 terminale di controllo provocano l'emissione di \const{SIGTTOU} come
1833 illustrato in \secref{sec:sess_ctrl_term}.\footnote{con la stessa eccezione,
1834   già vista per \func{tcsetaddr}, che quest'ultimo sia bloccato o ignorato dal
1835   processo chiamante.}
1836
1837 Una prima funzione, che è efficace solo in caso di terminali seriali asincroni
1838 (non fa niente per tutti gli altri terminali), è \func{tcsendbreak}; il suo
1839 prototipo è:
1840 \begin{functions}
1841   \headdecl{unistd.h} 
1842   \headdecl{termios.h}  
1843   
1844   \funcdecl{int tcsendbreak(int fd, int duration)} Genera una condizione di
1845   break inviando un flusso di bit nulli.
1846   
1847   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
1848     errore, nel qual caso \var{errno} assumerà i valori \errval{EBADF} o
1849     \errval{ENOTTY}.}
1850 \end{functions}
1851
1852 La funzione invia un flusso di bit nulli (che genera una condizione di break)
1853 sul terminale associato a \param{fd}; un valore nullo di \param{duration}
1854 implica una durata del flusso fra 0.25 e 0.5 secondi, un valore diverso da
1855 zero implica una durata pari a \code{duration*T} dove \code{T} è un valore
1856 compreso fra 0.25 e 0.5.\footnote{POSIX specifica il comportamento solo nel
1857   caso si sia impostato un valore nullo per \param{duration}; il comportamento
1858   negli altri casi può dipendere dalla implementazione.}
1859
1860 Le altre funzioni previste da POSIX servono a controllare il comportamento
1861 dell'interazione fra le code associate al terminale e l'utente; la prima è
1862 \func{tcdrain}, il cui prototipo è:
1863 \begin{functions}
1864   \headdecl{unistd.h} 
1865   \headdecl{termios.h}  
1866   
1867   \funcdecl{int tcdrain(int fd)} Attende lo svuotamento della coda di output.
1868   
1869   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
1870     errore, nel qual caso \var{errno} assumerà i valori \errval{EBADF} o
1871     \errval{ENOTTY}.}
1872 \end{functions}
1873
1874 La funzione blocca il processo fino a che tutto l'output presente sulla coda
1875 di uscita non è stato trasmesso al terminale associato ad \param{fd}. % La
1876                                 % funzione è  un punto di cancellazione per i
1877                                 % programmi multi-thread, in tal caso le
1878                                 % chiamate devono essere protette con dei
1879                                 % gestori di cancellazione. 
1880
1881 Una seconda funzione, \func{tcflush}, permette svuotare immediatamente le code
1882 di cancellando tutti i dati presenti al loro interno; il suo prototipo è:
1883 \begin{functions}
1884   \headdecl{unistd.h} \headdecl{termios.h}
1885   
1886   \funcdecl{int tcflush(int fd, int queue)} Cancella i dati presenti
1887   nelle code di ingresso o di uscita.
1888   
1889   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
1890     errore, nel qual caso \var{errno} assumerà i valori \errval{EBADF} o
1891     \errval{ENOTTY}.}
1892 \end{functions}
1893
1894 La funzione agisce sul terminale associato a \param{fd}, l'argomento
1895 \param{queue} permette di specificare su quale coda (ingresso, uscita o
1896 entrambe), operare. Esso può prendere i valori riportati in
1897 \tabref{tab:sess_tcflush_queue}, nel caso si specifichi la coda di ingresso
1898 cancellerà i dati ricevuti ma non ancora letti, nel caso si specifichi la coda
1899 di uscita cancellerài dati scritti ma non ancora trasmessi.
1900
1901 \begin{table}[htb]
1902   \footnotesize
1903   \centering
1904   \begin{tabular}[c]{|l|p{8cm}|}
1905     \hline
1906     \textbf{Valore}& \textbf{Significato}\\
1907     \hline
1908     \hline
1909     \const{TCIFLUSH} & Cancella i dati sulla coda di ingresso. \\
1910     \const{TCOFLUSH} & Cancella i dati sulla coda di uscita. \\
1911     \const{TCIOFLUSH}& Cancella i dati su entrambe le code.\\
1912     \hline
1913   \end{tabular}
1914   \caption{Possibili valori per l'argomento \param{queue} della
1915     funzione \func{tcflush}.} 
1916   \label{tab:sess_tcflush_queue}
1917 \end{table}
1918
1919
1920 L'ultima funzione dell'interfaccia che interviene sulla disciplina di linea è
1921 \func{tcflow}, che viene usata per sospendere la trasmissione e la ricezione
1922 dei dati sul terminale; il suo prototipo è:
1923 \begin{functions}
1924   \headdecl{unistd.h} 
1925   \headdecl{termios.h}  
1926   
1927   \funcdecl{int tcflow(int fd, int action)} 
1928   
1929   Sospende e rivvia il flusso dei dati sul terminale.
1930
1931   \bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
1932     errore, nel qual caso \var{errno} assumerà i valori \errval{EBADF} o
1933     \errval{ENOTTY}.}
1934 \end{functions}
1935
1936 La funzione permette di controllare (interrompendo e facendo riprendere) il
1937 flusso dei dati fra il terminale ed il sistema sia in ingresso che in uscita.
1938 Il comportamento della funzione è regolato dall'argomento \param{action}, i
1939 cui possibili valori, e relativa azione eseguita dalla funzione, sono
1940 riportati in \secref{tab:sess_tcflow_action}.
1941
1942 \begin{table}[htb]
1943    \footnotesize
1944   \centering
1945   \begin{tabular}[c]{|l|p{8cm}|}
1946     \hline
1947     \textbf{Valore}& \textbf{Azione}\\
1948     \hline
1949     \hline
1950     \const{TCOOFF}& Sospende l'output.\\
1951     \const{TCOON} & Riprende un output precedentemente sospeso.\\
1952     \const{TCIOFF}& Il sistema trasmette un carattere di STOP, che 
1953                     fa interrompere la trasmissione dei dati dal terminale.  \\
1954     \const{TCION} & Il sistema trasmette un carattere di START, che 
1955                     fa riprendere la trasmissione dei dati dal terminale.\\
1956     \hline
1957   \end{tabular}
1958   \caption{Possibili valori per l'argomento \param{action} della
1959     funzione \func{tcflow}.} 
1960   \label{tab:sess_tcflow_action}
1961 \end{table}
1962
1963
1964 \subsection{Operare in \textsl{modo non canonico}}
1965 \label{sec:term_non_canonical}
1966
1967 Operare con un terminale in modo canonico è relativamente semplice; basta
1968 eseguire una lettura e la funzione ritornerà quando una il driver del
1969 terminale avrà completato una linea di input. Non è detto che la linea sia
1970 letta interamente (si può aver richiesto un numero inferiore di byte) ma in
1971 ogni caso nessun dato verrà perso, e il resto della linea sarà letto alla
1972 chiamata successiva.
1973
1974 Inoltre in modo canonico la gestione dell'input è di norma eseguita
1975 direttamente dal driver del terminale, che si incarica (a seconda di quanto
1976 impostato con le funzioni viste nei paragrafi precedenti) di cancellare i
1977 caratteri, bloccare e riavviare il flusso dei dati, terminare la linea quando
1978 viene ricevuti uno dei vari caratteri di terminazione (NL, EOL, EOL2, EOF).
1979
1980 In modo non canonico tocca invece al programma gestire tutto quanto, i
1981 caratteri NL, EOL, EOL2, EOF, ERASE, KILL, CR, REPRINT non vengono
1982 interpretati automaticamente ed inoltre, non dividendo più l'input in linee,
1983 il sistema non ha più un limite definito per quando ritornare i dati ad un
1984 processo. Per questo motivo abbiamo visto che in \var{c\_cc} sono previsti due
1985 caratteri speciali, MIN e TIME (specificati dagli indici \const{VMIN} e
1986 \const{VTIME} in \var{c\_cc}) che dicono al sistema di ritornare da una
1987 \func{read} quando è stata letta una determinata quantità di dati o è passato
1988 un certo tempo.
1989
1990 Come accennato nella relativa spiegazione in \tabref{tab:sess_termios_cc},
1991 TIME e MIN non sono in realtà caratteri ma valori numerici. Il comportamento
1992 del sistema per un terminale in modalità non canonica prevede quattro casi
1993 distinti:
1994 \begin{description}
1995 \item[MIN$>0$, TIME$>0$] In questo caso MIN stabilisce il numero minimo di
1996   caratteri desiderati e TIME un tempo di attesa, in decimi di secondo, fra un
1997   carattere e l'altro. Una \func{read} ritorna se vengono ricevuti almeno MIN
1998   caratteri prima della scadenza di TIME (MIN è solo un limite inferiore, se
1999   la funzione ha richiesto un numero maggiore di caratteri ne possono essere
2000   restituiti di più); se invece TIME scade vengono restituiti i byte ricevuti
2001   fino ad allora (un carattere viene sempre letto, dato che il timer inizia a
2002   scorrere solo dopo la ricezione del primo carattere).
2003 \item[MIN$>0$, TIME$=0$] Una \func{read} ritorna solo dopo che sono stati
2004   ricevuti almeno MIN caratteri. Questo significa che una \func{read} può
2005   bloccarsi indefinitamente. 
2006 \item[MIN$=0$, TIME$>0$] In questo caso TIME indica un tempo di attesa dalla
2007   chiamata di \func{read}, la funzione ritorna non appena viene ricevuto un
2008   carattere o scade il tempo. Si noti che è possibile che \func{read} ritorni
2009   con un valore nullo.
2010 \item[MIN$=0$, TIME$=0$] In questo caso una \func{read} ritorna immediatamente
2011   restituendo tutti i caratteri ricevuti. Anche in questo caso può ritornare
2012   con un valore nullo.
2013 \end{description}
2014
2015
2016
2017 %%% Local Variables: 
2018 %%% mode: latex
2019 %%% TeX-master: "gapil"
2020 %%% End: