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