Ancora reindicizzazioni, più CLONE_VFORK, CLONE_VM, CLONE_PTRACED
[gapil.git] / process.tex
1 %% process.tex
2 %%
3 %% Copyright (C) 2000-2015 by Simone Piccardi.  Permission is granted to
4 %% copy, distribute and/or modify this document under the terms of the GNU Free
5 %% Documentation License, Version 1.1 or any later version published by the
6 %% Free Software Foundation; with the Invariant Sections being "Un preambolo",
7 %% with no Front-Cover Texts, and with no Back-Cover Texts.  A copy of the
8 %% license is included in the section entitled "GNU Free Documentation
9 %% License".
10 %%
11
12 \chapter{L'interfaccia base con i processi}
13 \label{cha:process_interface}
14
15 Come accennato nell'introduzione il \textsl{processo} è l'unità di base con
16 cui un sistema unix-like alloca ed utilizza le risorse.  Questo capitolo
17 tratterà l'interfaccia base fra il sistema e i processi, come vengono passati
18 gli argomenti, come viene gestita e allocata la memoria, come un processo può
19 richiedere servizi al sistema e cosa deve fare quando ha finito la sua
20 esecuzione. Nella sezione finale accenneremo ad alcune problematiche generiche
21 di programmazione.
22
23 In genere un programma viene eseguito quando un processo lo fa partire
24 eseguendo una funzione della famiglia \func{exec}; torneremo su questo e sulla
25 creazione e gestione dei processi nel prossimo capitolo. In questo
26 affronteremo l'avvio e il funzionamento di un singolo processo partendo dal
27 punto di vista del programma che viene messo in esecuzione.
28
29
30 \section{Esecuzione e conclusione di un programma}
31
32 Uno dei concetti base di Unix è che un processo esegue sempre uno ed un solo
33 programma: si possono avere più processi che eseguono lo stesso programma ma
34 ciascun processo vedrà la sua copia del codice (in realtà il kernel fa sì che
35 tutte le parti uguali siano condivise), avrà un suo spazio di indirizzi,
36 variabili proprie e sarà eseguito in maniera completamente indipendente da
37 tutti gli altri. Questo non è del tutto vero nel caso di un programma
38 \textit{multi-thread}, ma la gestione dei \textit{thread} in Linux sarà
39 trattata a parte in cap.~\ref{cha:threads}.
40
41
42 \subsection{L'avvio e l'esecuzione di un programma}
43 \label{sec:proc_main}
44
45 \itindbeg{link-loader}
46 \itindbeg{shared~objects}
47 Quando un programma viene messo in esecuzione cosa che può essere fatta solo
48 con una funzione della famiglia \func{exec} (vedi sez.~\ref{sec:proc_exec}) il
49 kernel esegue un opportuno codice di avvio, il cosiddetto
50 \textit{link-loader}, costituito dal programma \cmd{ld-linux.so}. Questo
51 programma è una parte fondamentale del sistema il cui compito è quello della
52 gestione delle cosiddette \textsl{librerie condivise}, quelle che nel mondo
53 Windows sono chiamate DLL (\textit{Dinamic Link Library}), e che invece in un
54 sistema unix-like vengono chiamate \textit{shared objects}.
55
56 Infatti, a meno di non aver specificato il flag \texttt{-static} durante la
57 compilazione, tutti i programmi in Linux sono compilati facendo riferimento a
58 librerie condivise, in modo da evitare di duplicare lo stesso codice nei
59 relativi eseguibili e consentire un uso più efficiente della memoria, dato che
60 il codice di uno \textit{shared objects} viene caricato in memoria dal kernel
61 una sola volta per tutti i programmi che lo usano.
62 \itindend{shared~objects}
63
64 Questo significa però che normalmente il codice di un programma è incompleto,
65 contenendo solo i riferimenti alle funzioni di libreria che vuole utilizzare e
66 non il relativo codice. Per questo motivo all'avvio del programma è necessario
67 l'intervento del \textit{link-loader} il cui compito è
68 caricare in memoria le librerie condivise eventualmente assenti, ed effettuare
69 poi il collegamento dinamico del codice del programma alle funzioni di
70 libreria da esso utilizzate prima di metterlo in esecuzione.
71
72 Il funzionamento di \cmd{ld-linux.so} è controllato da alcune variabili di
73 ambiente e dal contenuto del file \conffile{/etc/ld.so.conf}, che consentono
74 di elencare le directory un cui cercare le librerie e determinare quali
75 verranno utilizzate.  In particolare con la variabile di ambiente
76 \envvar{LD\_LIBRARY\_PATH} si possono indicare ulteriori directory rispetto a
77 quelle di sistema in cui inserire versioni personali delle librerie che hanno
78 la precedenza su quelle di sistema, mentre con la variabile di ambiente
79 \envvar{LD\_PRELOAD} si può passare direttamente una lista di file di librerie
80 condivise da usare al posto di quelli di sistema. In questo modo è possibile
81 effettuare lo sviluppo o il test di nuove librerie senza dover sostituire
82 quelle di sistema. Ulteriori dettagli sono riportati nella pagina di manuale
83 di \cmd{ld.so} e per un approfondimento dell'argomento si può consultare
84 sez.~3.1.2 di \cite{AGL}.
85
86 Una volta completate le operazioni di inizializzazione di \cmd{ld-linux.so}, il
87 sistema fa partire qualunque programma chiamando la funzione \code{main}. Sta
88 al programmatore chiamare così la funzione principale del programma da cui si
89 suppone che inizi l'esecuzione. In ogni caso senza questa funzione lo stesso
90 \textit{link-loader} darebbe luogo ad errori.  Lo standard ISO C specifica che
91 la funzione \code{main} può non avere argomenti o prendere due argomenti che
92 rappresentano gli argomenti passati da linea di comando (su cui torneremo in
93 sez.~\ref{sec:proc_par_format}), in sostanza un prototipo che va sempre bene è
94 il seguente:
95 \includecodesnip{listati/main_def.c}
96
97 \itindend{link-loader}
98
99 In realtà nei sistemi Unix esiste un altro modo per definire la funzione
100 \code{main}, che prevede la presenza di un terzo argomento, \code{char
101   *envp[]}, che fornisce l'\textsl{ambiente} del programma; questa forma però
102 non è prevista dallo standard POSIX.1 per cui se si vogliono scrivere
103 programmi portabili è meglio evitarla. Per accedere all'ambiente, come vedremo
104 in sez.~\ref{sec:proc_environ} si usa in genere una variabile globale che
105 viene sempre definita automaticamente.
106
107 Ogni programma viene fatto partire mettendo in esecuzione il codice contenuto
108 nella funzione \code{main}, ogni altra funzione usata dal programma, che sia
109 ottenuta da una libreria condivisa, o che sia direttamente definita nel
110 codice, dovrà essere invocata a partire dal codice di \code{main}. Nel caso di
111 funzioni definite nel programma occorre tenere conto che, nel momento stesso
112 in cui si usano le librerie di sistema (vale a dire la \acr{glibc}) alcuni
113 nomi sono riservati e non possono essere utilizzati. 
114
115 In particolare sono riservati a priori e non possono essere mai ridefiniti in
116 nessun caso i nomi di tutte le funzioni, le variabili, le macro di
117 preprocessore, ed i tipi di dati previsti dallo standard ISO C. Lo stesso
118 varrà per tutti i nomi definiti negli \textit{header file} che si sono
119 esplicitamente inclusi nel programma (vedi sez.~\ref{sec:proc_syscall}), ma
120 anche se è possibile riutilizzare nomi definiti in altri \textit{header file}
121 la pratica è da evitare nella maniera più assoluta per non generare ambiguità.
122
123 Oltre ai nomi delle funzioni di libreria sono poi riservati in maniera
124 generica tutti i nomi di variabili o funzioni globali che iniziano con il
125 carattere di sottolineato (``\texttt{\_}''), e qualunque nome che inizi con il
126 doppio sottolineato (``\texttt{\_\_}'') o con il sottolineato seguito da
127 lettera maiuscola. Questi identificativi infatti sono utilizzati per i nomi
128 usati internamente in forma privata dalle librerie, ed evitandone l'uso si
129 elimina il rischio di conflitti.
130
131 Infine esiste una serie di classi di nomi che sono riservati per un loro
132 eventuale uso futuro da parte degli standard ISO C e POSIX.1, questi in teoria
133 possono essere usati senza problemi oggi, ma potrebbero dare un conflitto con
134 una revisione futura di questi standard, per cui è comunque opportuno
135 evitarli, in particolare questi sono:
136 \begin{itemize*}
137 \item i nomi che iniziano per ``\texttt{E}'' costituiti da lettere maiuscole e
138   numeri, che potrebbero essere utilizzati per nuovi codici di errore (vedi
139   sez.~\ref{sec:sys_errors}),
140 \item i nomi che iniziano con ``\texttt{is}'' o ``\texttt{to}'' e costituiti
141   da lettere minuscole che potrebbero essere utilizzati da nuove funzioni per
142   il controllo e la conversione del tipo di caratteri,
143 \item i nomi che iniziano con ``\texttt{LC\_}'' e costituiti
144   da lettere maiuscole che possono essere usato per macro attinenti la
145   localizzazione,% mettere in seguito (vedi sez.~\ref{sec:proc_localization}),
146 \item nomi che iniziano con ``\texttt{SIG}'' o ``\texttt{SIG\_}'' e costituiti
147   da lettere maiuscole che potrebbero essere usati per nuovi nomi di segnale
148   (vedi sez.~\ref{sec:sig_classification}),
149 \item nomi che iniziano con ``\texttt{str}'', ``\texttt{mem}'', o
150   ``\texttt{wcs}'' e costituiti da lettere minuscole che possono essere
151   utilizzati per funzioni attinenti la manipolazione delle stringhe e delle
152   aree di memoria,
153 \item nomi che terminano in ``\texttt{\_t}'' che potrebbero essere utilizzati
154   per la definizione di nuovi tipi di dati di sistema oltre quelli di
155   tab.~\ref{tab:intro_primitive_types}).
156 \end{itemize*}
157
158
159 \subsection{Chiamate a funzioni e \textit{system call}}
160 \label{sec:proc_syscall}
161
162 Come accennato in sez.~\ref{sec:intro_syscall} un programma può utilizzare le
163 risorse che il sistema gli mette a disposizione attraverso l'uso delle
164 opportune \textit{system call}. Abbiamo inoltre appena visto come all'avvio un
165 programma venga messo in grado di chiamare le funzioni fornite da eventuali
166 librerie condivise da esso utilizzate. 
167
168 Vedremo nel resto della guida quali sono le risorse del sistema accessibili
169 attraverso le \textit{system call} e tratteremo buona parte delle funzioni
170 messe a disposizione dalla libreria standard del C, in questa sezione però si
171 forniranno alcune indicazioni generali sul come fare perché un programma possa
172 utilizzare queste funzioni.
173
174 \itindbeg{header~file}
175
176 In sez.~\ref{sec:intro_standard} abbiamo accennato come le funzioni definite
177 nei vari standard siano definite in una serie di \textit{header file} (in
178 italiano \textsl{file di intestazione}).  Vengono chiamati in questo modo quei
179 file, forniti insieme al codice delle librerie, che contengono le
180 dichiarazioni delle variabili, dei tipi di dati, delle macro di preprocessore
181 e soprattutto delle funzioni che fanno parte di una libreria.
182
183 Questi file sono necessari al compilatore del linguaggio C per ottenere i
184 riferimenti ai nomi delle funzioni (e alle altre risorse) definite in una
185 libreria, per questo quando si vogliono usare le funzioni di una libreria
186 occorre includere nel proprio codice gli \textit{header file} che le
187 definiscono con la direttiva \code{\#include}. Dato che le funzioni devono
188 essere definite prima di poterle usare in genere gli \textit{header file}
189 vengono inclusi all'inizio del programma. Se inoltre si vogliono utilizzare le
190 macro di controllo delle funzionalità fornite dai vari standard illustrate in
191 sez.~\ref{sec:intro_gcc_glibc_std} queste, come accennato, dovranno a loro
192 volta essere definite prima delle varie inclusioni.
193
194 Ogni libreria fornisce i propri file di intestazione per i quali si deve
195 consultare la documentazione, ma in tab.~\ref{tab:intro_posix_header} si sono
196 riportati i principali \textit{header file} definiti nella libreria standard
197 del C (nel caso la \acr{glibc}) che contengono le varie funzioni previste
198 negli standard POSIX ed ANSI C, e che prevedono la definizione sia delle
199 funzioni di utilità generica che delle interfacce alle \textit{system call}. In
200 seguito per ciascuna funzione o \textit{system call} che tratteremo
201 indicheremo anche quali sono gli \textit{header file} contenenti le necessarie
202 definizioni.
203
204 \begin{table}[htb]
205   \footnotesize
206   \centering
207   \begin{tabular}[c]{|l|c|c|l|}
208     \hline
209     \multirow{2}{*}{\textbf{Header}}&
210     \multicolumn{2}{|c|}{\textbf{Standard}}&
211     \multirow{2}{*}{\textbf{Contenuto}} \\
212     \cline{2-3}
213     & ANSI C& POSIX& \\
214     \hline
215     \hline
216     \headfile{assert.h}&$\bullet$&    --   & Verifica le asserzioni fatte in un
217                                              programma.\\ 
218     \headfile{ctype.h} &$\bullet$&    --   & Tipi standard.\\
219     \headfile{dirent.h}&   --    &$\bullet$& Manipolazione delle directory.\\
220     \headfile{errno.h} &   --    &$\bullet$& Errori di sistema.\\
221     \headfile{fcntl.h} &   --    &$\bullet$& Controllo sulle opzioni dei file.\\
222     \headfile{limits.h}&   --    &$\bullet$& Limiti e parametri del sistema.\\
223     \headfile{malloc.h}&$\bullet$&    --   & Allocazione della memoria.\\
224     \headfile{setjmp.h}&$\bullet$&    --   & Salti non locali.\\
225     \headfile{signal.h}&   --    &$\bullet$& Gestione dei segnali.\\
226     \headfile{stdarg.h}&$\bullet$&    --   & Gestione di funzioni a argomenti
227                                              variabili.\\ 
228     \headfile{stdio.h} &$\bullet$&    --   & I/O bufferizzato in standard ANSI
229                                              C.\\ 
230     \headfile{stdlib.h}&$\bullet$&    --   & Definizioni della libreria
231                                              standard.\\ 
232     \headfile{string.h}&$\bullet$&    --   & Manipolazione delle stringhe.\\
233     \headfile{time.h}  &   --    &$\bullet$& Gestione dei tempi.\\
234     \headfile{times.h} &$\bullet$&    --   & Gestione dei tempi.\\
235     \headfile{unistd.h}&   --    &$\bullet$& Unix standard library.\\
236     \headfile{utmp.h}  &   --    &$\bullet$& Registro connessioni utenti.\\
237     \hline
238   \end{tabular}
239   \caption{Elenco dei principali \textit{header file} definiti dagli standard
240     POSIX e ANSI C.}
241   \label{tab:intro_posix_header}
242 \end{table}
243
244 Un esempio di inclusione di questi file, preso da uno dei programmi di
245 esempio, è il seguente, e si noti come gli \textit{header file} possano essere
246 referenziati con il nome fra parentesi angolari, nel qual caso si indica l'uso
247 di quelli installati con il sistema,\footnote{in un sistema GNU/Linux che
248   segue le specifiche del \textit{Filesystem Hierarchy Standard} (per maggiori
249   informazioni si consulti sez.~1.2.3 di \cite{AGL}) si trovano sotto
250   \texttt{/usr/include}.}  o fra virgolette, nel qual caso si fa riferimento
251 ad una versione locale, da indicare con un \textit{pathname} relativo:
252 \includecodesnip{listati/main_include.c}
253
254 Si tenga presente che oltre ai nomi riservati a livello generale di cui si è
255 parlato in sez.~\ref{sec:proc_main}, alcuni di questi \textit{header file}
256 riservano degli ulteriori identificativi, il cui uso sarà da evitare, ad
257 esempio si avrà che:
258 \begin{itemize*}
259 \item in \headfile{dirent.h} vengono riservati i nomi che iniziano con
260   ``\texttt{d\_}'' e costituiti da lettere minuscole,
261 \item in \headfile{fcntl.h} vengono riservati i nomi che iniziano con
262   ``\texttt{l\_}'', ``\texttt{F\_}'',``\texttt{O\_}'' e ``\texttt{S\_}'',
263 \item in \headfile{limits.h} vengono riservati i nomi che finiscono in
264   ``\texttt{\_MAX}'',
265 \item in \headfile{signal.h} vengono riservati i nomi che iniziano con
266   ``\texttt{sa\_}'' e ``\texttt{SA\_}'',
267 \item in \headfile{sys/stat.h} vengono riservati i nomi che iniziano con
268   ``\texttt{st\_}'' e ``\texttt{S\_}'',
269 \item in \headfile{sys/times.h} vengono riservati i nomi che iniziano con
270   ``\texttt{tms\_}'',
271 \item in \headfile{termios.h} vengono riservati i nomi che iniziano con
272   ``\texttt{c\_}'', ``\texttt{V}'', ``\texttt{I}'', ``\texttt{O}'' e
273   ``\texttt{TC}'' e con ``\texttt{B}'' seguito da un numero,
274 \item in \headfile{grp.h} vengono riservati i nomi che iniziano con
275   ``\texttt{gr\_}'',
276 \item in \headfile{pwd.h}vengono riservati i nomi che iniziano con
277   ``\texttt{pw\_}'',
278 \end{itemize*}
279
280 \itindend{header~file}
281
282 Una volta inclusi gli \textit{header file} necessari un programma potrà
283 richiamare le funzioni di libreria direttamente nel proprio codice ed accedere
284 ai servizi del kernel; come accennato infatti normalmente ogni \textit{system
285   call} è associata ad una omonima funzione di libreria, che è quella che si
286 usa normalmente per invocarla.
287
288 Occorre però tenere presente che anche se dal punto di vista della scrittura
289 del codice la chiamata di una \textit{system call} non è diversa da quella di
290 una qualunque funzione ordinaria, la situazione è totalmente diversa
291 nell'esecuzione del programma. Una funzione ordinaria infatti viene eseguita,
292 esattamente come il codice che si è scritto nel corpo del programma, in
293 \textit{user space}. Quando invece si esegue una \textit{system call}
294 l'esecuzione ordinaria del programma viene interrotta, i dati forniti (come
295 argomenti della chiamata) vengono trasferiti al kernel che esegue il codice
296 della \textit{system call} (che è codice del kernel) in \textit{kernel space}.
297
298 Dato che il passaggio dei dati ed il salvataggio del contesto di esecuzione
299 del programma che consentirà di riprenderne l'esecuzione ordinaria al
300 completamento della \textit{system call} sono operazioni critiche per le
301 prestazioni del sistema, per rendere il più veloce possibile questa
302 operazione, usualmente chiamata \textit{context switch} sono state sviluppate
303 una serie di ottimizzazioni che richiedono alcune preparazioni abbastanza
304 complesse dei dati, che in genere dipendono dall'architettura del processore
305 sono scritte direttamente in \textit{assembler}.
306
307 %
308 % TODO:trattare qui, quando sarà il momento vsyscall e vDSO, vedi:
309 % http://davisdoesdownunder.blogspot.com/2011/02/linux-syscall-vsyscall-and-vdso-oh-my.html 
310 % http://www.win.tue.nl/~aeb/linux/lk/lk-4.html
311 %
312 % Altro materiale al riguardo http://lwn.net/Articles/615809/
313 % http://man7.org/linux/man-pages/man7/vdso.7.html 
314
315 Inoltre alcune \textit{system call} sono state modificate nel corso degli anni
316 con lo sviluppo del kernel per aggiungere ad esempio funzionalità in forma di
317 nuovi argomenti, o per consolidare diverse varianti in una interfaccia
318 generica.  Per questo motivo dovendo utilizzare una \textit{system call} è
319 sempre preferibile usare l'interfaccia fornita dalla \textsl{glibc}, che si
320 cura di mantenere una uniformità chiamando le versioni più aggiornate.
321
322 Ci sono alcuni casi però in cui può essere necessario evitare questa
323 associazione, e lavorare a basso livello con una specifica versione, oppure si
324 può voler utilizzare una \textit{system call} che non è stata ancora associata
325 ad una funzione di libreria.  In tal caso, per evitare di dover effettuare
326 esplicitamente le operazioni di preparazione citate, all'interno della
327 \textsl{glibc} è fornita una specifica funzione, \funcd{syscall}, che consente
328 eseguire direttamente una \textit{system call}; il suo prototipo, accessibile
329 se si è definita la macro \macro{\_GNU\_SOURCE}, è:
330
331 \begin{funcproto}{
332   \fhead{unistd.h}
333   \fhead{sys/syscall.h}
334   \fdecl{int syscall(int number, ...)}
335   \fdesc{Esegue la \textit{system call} indicata da \param{number}.}
336 }
337 {La funzione ritorna un intero dipendente dalla \textit{system call} invocata,
338  in generale $0$ indica il successo ed un valore negativo un errore.}
339 \end{funcproto}
340
341 La funzione richiede come primo argomento il numero della \textit{system call}
342 da invocare, seguita dagli argomenti da passare alla stessa, che ovviamente
343 dipendono da quest'ultima, e restituisce il codice di ritorno della
344 \textit{system call} invocata. In generale un valore nullo indica il successo
345 ed un valore negativo è un codice di errore che poi viene memorizzato nella
346 variabile \var{errno} (sulla gestione degli errori torneremo in dettaglio in
347 sez.~\ref{sec:sys_errors}).
348
349 Il valore di \param{number} dipende sia dalla versione di kernel che
350 dall'architettura,\footnote{in genere le vecchie \textit{system call} non
351   vengono eliminate e se ne aggiungono di nuove con nuovi numeri.}  ma
352 ciascuna \textit{system call} viene in genere identificata da una costante
353 nella forma \texttt{SYS\_*} dove al prefisso viene aggiunto il nome che spesso
354 corrisponde anche alla omonima funzione di libreria. Queste costanti sono
355 definite nel file \headfile{sys/syscall.h}, ma si possono anche usare
356 direttamente valori numerici.
357
358
359 \subsection{La terminazione di un programma}
360 \label{sec:proc_conclusion}
361
362 Normalmente un programma conclude la sua esecuzione quando si fa ritornare la
363 funzione \code{main}, si usa cioè l'istruzione \instruction{return} del
364 linguaggio C all'interno della stessa, o se si richiede esplicitamente la
365 chiusura invocando direttamente la funzione \func{exit}. Queste due modalità
366 sono assolutamente equivalenti, dato che \func{exit} viene chiamata in maniera
367 trasparente anche quando \code{main} ritorna, passandogli come argomento il
368 valore di ritorno (che essendo .
369
370 La funzione \funcd{exit}, che è completamente generale, essendo definita dallo
371 standard ANSI C, è quella che deve essere invocata per una terminazione
372 ``\textit{normale}'', il suo prototipo è:
373
374 \begin{funcproto}{
375   \fhead{unistd.h}
376   \fdecl{void exit(int status)}
377   \fdesc{Causa la conclusione ordinaria del programma.}
378 }
379 {La funzione non ritorna, il processo viene terminato.}
380 \end{funcproto}
381
382 La funzione è pensata per eseguire una conclusione pulita di un programma che
383 usi la libreria standard del C; essa esegue tutte le funzioni che sono state
384 registrate con \func{atexit} e \func{on\_exit} (vedi
385 sez.~\ref{sec:proc_atexit}), chiude tutti gli \textit{stream} (vedi
386 sez.~\ref{sec:file_stream}) effettuando il salvataggio dei dati sospesi
387 (chiamando \func{fclose}, vedi sez.~\ref{sec:file_fopen}), infine passa il
388 controllo al kernel chiamando la \textit{system call} \func{\_exit} (che
389 vedremo a breve) che completa la terminazione del processo.
390
391 \itindbeg{exit~status}
392
393 Il valore dell'argomento \param{status} o il valore di ritorno di \code{main},
394 costituisce quello che viene chiamato lo \textsl{stato di uscita}
395 (l'\textit{exit status}) del processo. In generale si usa questo valore per
396 fornire al processo padre (come vedremo in sez.~\ref{sec:proc_wait}) delle
397 informazioni generiche sulla riuscita o il fallimento del programma appena
398 terminato.
399
400 Anche se l'argomento \param{status} (ed il valore di ritorno di \code{main})
401 sono numeri interi di tipo \ctyp{int}, si deve tener presente che il valore
402 dello stato di uscita viene comunque troncato ad 8 bit,
403 per cui deve essere sempre compreso fra 0 e 255. Si tenga presente che se si
404 raggiunge la fine della funzione \code{main} senza ritornare esplicitamente si
405 ha un valore di uscita indefinito, è pertanto consigliabile di concludere
406 sempre in maniera esplicita detta funzione.
407
408 Non esiste un valore significato intrinseco della stato di uscita, ma una
409 convenzione in uso pressoché universale è quella di restituire 0 in caso di
410 successo e 1 in caso di fallimento. Una eccezione a questa convenzione è per i
411 programmi che effettuano dei confronti (come \cmd{diff}), che usano 0 per
412 indicare la corrispondenza, 1 per indicare la non corrispondenza e 2 per
413 indicare l'incapacità di effettuare il confronto. Un'altra convenzione riserva
414 i valori da 128 a 256 per usi speciali: ad esempio 128 viene usato per
415 indicare l'incapacità di eseguire un altro programma in un
416 sottoprocesso. Benché le convenzioni citate non siano seguite universalmente è
417 una buona idea tenerle presenti ed adottarle a seconda dei casi.
418
419 Si tenga presente inoltre che non è una buona idea usare eventuali codici di
420 errore restituiti nella variabile \var{errno} (vedi sez.~\ref{sec:sys_errors})
421 come \textit{exit status}. In generale infatti non ci si cura del valore dello
422 stato di uscita di un processo se non per vedere se è diverso da zero, come
423 indicazione di un qualche errore.  Dato che viene troncato ad 8 bit utilizzare
424 un intero di valore generico può comportare il rischio, qualora si vada ad
425 usare un multiplo di 256, di avere uno stato di uscita uguale a zero, che
426 verrebbe interpretato come un successo.
427
428 Per questo motivo in \headfile{stdlib.h} sono definite, seguendo lo standard
429 POSIX, le due costanti \constd{EXIT\_SUCCESS} e \constd{EXIT\_FAILURE}, da
430 usare sempre per specificare lo stato di uscita di un processo. Su Linux, ed
431 in generale in qualunque sistema POSIX, ad esse sono assegnati rispettivamente
432 i valori 0 e 1.
433
434 \itindend{exit~status}
435
436 Una forma alternativa per effettuare una terminazione esplicita di un
437 programma è quella di chiamare direttamente la \textit{system call}
438 \funcd{\_exit},\footnote{la stessa è definita anche come \funcd{\_Exit} in
439   \headfile{stdlib.h}.} che restituisce il controllo direttamente al kernel,
440 concludendo immediatamente il processo, il suo prototipo è:
441
442 \begin{funcproto}{ \fhead{unistd.h} \fdecl{void \_exit(int status)}
443     \fdesc{Causa la conclusione immediata del programma.}  } {La funzione non
444     ritorna, il processo viene terminato.}
445 \end{funcproto}
446
447 La funzione termina immediatamente il processo e le eventuali funzioni
448 registrate con \func{atexit} e \func{on\_exit} non vengono eseguite. La
449 funzione chiude tutti i file descriptor appartenenti al processo, cosa che
450 però non comporta il salvataggio dei dati eventualmente presenti nei buffer
451 degli \textit{stream}, (torneremo sulle due interfacce dei file in
452 sez.~\ref{sec:file_unix_interface} e
453 sez.~\ref{sec:files_std_interface}). Infine fa sì che ogni figlio del processo
454 sia adottato da \cmd{init} (vedi sez.~\ref{sec:proc_termination}), manda un
455 segnale \signal{SIGCHLD} al processo padre (vedi
456 sez.~\ref{sec:sig_job_control}) e ritorna lo stato di uscita specificato
457 in \param{status} che può essere raccolto usando la funzione \func{wait} (vedi
458 sez.~\ref{sec:proc_wait}).
459
460 Si tenga presente infine che oltre alla conclusione ``\textsl{normale}''
461 appena illustrata esiste anche la possibilità di una conclusione
462 ``\textsl{anomala}'' del programma a causa della ricezione di un segnale
463 (tratteremo i segnali in cap.~\ref{cha:signals}) o della chiamata alla
464 funzione \func{abort}; torneremo su questo in sez.~\ref{sec:proc_termination}.
465
466
467 \subsection{Esecuzione di funzioni preliminari all'uscita}
468 \label{sec:proc_atexit}
469
470 Un'esigenza comune che si incontra è quella di dover effettuare una serie di
471 operazioni di pulizia (ad esempio salvare dei dati, ripristinare delle
472 impostazioni, eliminare dei file temporanei, ecc.) prima della conclusione di
473 un programma. In genere queste operazioni vengono fatte in un'apposita sezione
474 del programma, ma quando si realizza una libreria diventa antipatico dover
475 richiedere una chiamata esplicita ad una funzione di pulizia al programmatore
476 che la utilizza.
477
478 È invece molto meno soggetto ad errori, e completamente trasparente
479 all'utente, avere la possibilità di fare effettuare automaticamente la
480 chiamata ad una funzione che effettui tali operazioni all'uscita dal
481 programma. A questo scopo lo standard ANSI C prevede la possibilità di
482 registrare un certo numero di funzioni che verranno eseguite all'uscita dal
483 programma,\footnote{nel caso di \func{atexit} lo standard POSIX.1-2001
484   richiede che siano registrabili almeno \constd{ATEXIT\_MAX} funzioni (il
485   valore può essere ottenuto con \func{sysconf}, vedi
486   sez.~\ref{sec:sys_limits}).} sia per la chiamata ad \func{exit} che per il
487 ritorno di \code{main}. La prima funzione che si può utilizzare a tal fine è
488 \funcd{atexit}, il cui prototipo è:
489
490 \begin{funcproto}{ 
491 \fhead{stdlib.h} 
492 \fdecl{int atexit(void (*function)(void))}
493 \fdesc{Registra la funzione \param{function} per la chiamata all'uscita
494       dal programma.}  
495
496 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore, \var{errno}
497   non viene modificata.}
498 \end{funcproto}
499
500 La funzione richiede come argomento \param{function} l'indirizzo di una
501 opportuna funzione di pulizia da chiamare all'uscita del programma, che non
502 deve prendere argomenti e non deve ritornare niente. In sostanza deve la
503 funzione di pulizia dovrà essere definita come \code{void function(void)}.
504
505 Un'estensione di \func{atexit} è la funzione \funcd{on\_exit}, che le
506 \acr{glibc} includono per compatibilità con SunOS ma che non è detto sia
507 definita su altri sistemi,\footnote{non essendo prevista dallo standard POSIX
508   è in genere preferibile evitarne l'uso.} il suo prototipo è:
509
510 \begin{funcproto}{ 
511 \fhead{stdlib.h} 
512 \fdecl{int on\_exit(void (*function)(int, void *), void *arg))}
513 \fdesc{Registra la funzione \param{function} per la chiamata all'uscita dal
514   programma.} 
515 }
516 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore, \var{errno}
517   non viene modificata.} 
518 \end{funcproto}
519
520 In questo caso la funzione da chiamare all'uscita prende i due argomenti
521 specificati nel prototipo, un intero ed un puntatore; dovrà cioè essere
522 definita come \code{void function(int status, void *argp)}. Il primo argomento
523 sarà inizializzato allo stato di uscita con cui è stata chiamata \func{exit}
524 ed il secondo al puntatore \param{arg} passato come secondo argomento di
525 \func{on\_exit}.  Così diventa possibile passare dei dati alla funzione di
526 chiusura.
527
528 Nella sequenza di chiusura tutte le funzioni registrate verranno chiamate in
529 ordine inverso rispetto a quello di registrazione, ed una stessa funzione
530 registrata più volte sarà chiamata più volte. Siccome entrambe le funzioni
531 \func{atexit} e \func{on\_exit} fanno riferimento alla stessa lista, l'ordine
532 di esecuzione sarà riferito alla registrazione in quanto tale,
533 indipendentemente dalla funzione usata per farla.
534
535 Una volta completata l'esecuzione di tutte le funzioni registrate verranno
536 chiusi tutti gli \textit{stream} aperti ed infine verrà chiamata \func{\_exit}
537 per la terminazione del programma. Questa è la sequenza ordinaria, eseguita a
538 meno che una delle funzioni registrate non esegua al suo interno
539 \func{\_exit}, nel qual caso la terminazione del programma sarà immediata ed
540 anche le successive funzioni registrate non saranno invocate.
541
542 Se invece all'interno di una delle funzioni registrate si chiama un'altra
543 volta \func{exit} lo standard POSIX.1-2001 prescrive un comportamento
544 indefinito, con la possibilità (che su Linux comunque non c'è) di una
545 ripetizione infinita. Pertanto questa eventualità è da evitare nel modo più
546 assoluto. Una altro comportamento indefinito si può avere se si termina
547 l'esecuzione di una delle funzioni registrate con \func{longjmp} (vedi
548 sez.~\ref{sec:proc_longjmp}).
549
550 Si tenga presente infine che in caso di terminazione anomala di un processo
551 (ad esempio a causa di un segnale) nessuna delle funzioni registrate verrà
552 eseguita e che se invece si crea un nuovo processo con \func{fork} (vedi
553 sez.~\ref{sec:proc_fork}) questo manterrà tutte le funzioni già registrate.
554
555
556 \subsection{Un riepilogo}
557 \label{sec:proc_term_conclusion}
558
559 Data l'importanza dell'argomento è opportuno un piccolo riepilogo dei fatti
560 essenziali relativi alla esecuzione di un programma. Il primo punto da
561 sottolineare è che in un sistema unix-like l'unico modo in cui un programma
562 può essere eseguito dal kernel è attraverso la chiamata alla \textit{system
563   call} \func{execve}, sia direttamente che attraverso una delle funzioni
564 della famiglia \func{exec} che ne semplificano l'uso (vedi
565 sez.~\ref{sec:proc_exec}).
566
567 Allo stesso modo l'unico modo in cui un programma può concludere
568 volontariamente la propria esecuzione è attraverso una chiamata alla
569 \textit{system call} \func{\_exit}, sia che questa venga fatta esplicitamente,
570 o in maniera indiretta attraverso l'uso di \func{exit} o il ritorno di
571 \code{main}. 
572
573 Uno schema riassuntivo che illustra le modalità con cui si avvia e conclude
574 normalmente un programma è riportato in fig.~\ref{fig:proc_prog_start_stop}.
575
576 \begin{figure}[htb]
577   \centering
578 %  \includegraphics[width=9cm]{img/proc_beginend}
579   \begin{tikzpicture}[>=stealth]
580     \filldraw[fill=black!35] (-0.3,0) rectangle (12,1);
581     \draw(5.5,0.5) node {\large{\textsf{kernel}}};
582
583     \filldraw[fill=black!15] (1.5,2) rectangle (4,3);
584     \draw (2.75,2.5) node {\texttt{ld-linux.so}};
585     \draw [->] (2.75,1) -- (2.75,2);
586     \draw (2.75,1.5) node [anchor=west]{\texttt{execve}};
587
588     \filldraw[fill=black!15,rounded corners] (1.5,4) rectangle (4,5);
589     \draw (2.75,4.5) node {\texttt{main}};
590
591     \draw [<->, dashed] (2.75,3) -- (2.75,4);
592     \draw [->] (1.5,4.5) -- (0.3,4.5) -- (0.3,1);
593     \draw (0.9,4.5) node [anchor=south] {\texttt{\_exit}};
594
595     \filldraw[fill=black!15,rounded corners] (1.5,6) rectangle (4,7);
596     \draw (2.75,6.5) node {\texttt{funzione}};
597
598     \draw [<->, dashed] (2.75,5) -- (2.75,6);
599     \draw [->] (1.5,6.5) -- (0.05,6.5) -- (0.05,1);
600     \draw (0.9,6.5) node [anchor=south] {\texttt{\_exit}};
601
602     \draw (6.75,4.5) node (exit) [rectangle,fill=black!15,minimum width=2.5cm,minimum height=1cm,rounded corners, draw]{\texttt{exit}};
603
604     \draw[->] (4,6.5) -- node[anchor=south west]{\texttt{exit}} (exit);
605     \draw[->] (4,4.5) -- node[anchor=south]{\texttt{exit}} (exit);
606     \draw[->] (exit) -- node[anchor=east]{\texttt{\_exit}}(6.75,1);
607
608     \draw (10,4.5) node (exithandler1) [rectangle,fill=black!15,rounded corners, draw]{\textsf{exit handler}};
609     \draw (10,5.5) node (exithandler2) [rectangle,fill=black!15,rounded corners, draw]{\textsf{exit handler}};
610     \draw (10,3.5) node (stream) [rectangle,fill=black!15,rounded corners, draw]{\textsf{chiusura stream}};
611
612     \draw[<->, dashed] (exithandler1) -- (exit);
613     \draw[<->, dashed] (exithandler2) -- (exit);
614     \draw[<->, dashed] (stream) -- (exit);
615   \end{tikzpicture}
616   \caption{Schema dell'avvio e della conclusione di un programma.}
617   \label{fig:proc_prog_start_stop}
618 \end{figure}
619
620 Si ricordi infine che un programma può anche essere interrotto dall'esterno
621 attraverso l'uso di un segnale (modalità di conclusione non mostrata in
622 fig.~\ref{fig:proc_prog_start_stop}); tratteremo nei dettagli i segnali e la
623 loro gestione nel capitolo \ref{cha:signals}.
624
625
626
627 \section{I processi e l'uso della memoria}
628 \label{sec:proc_memory}
629
630 Una delle risorse più importanti che ciascun processo ha a disposizione è la
631 memoria, e la gestione della memoria è appunto uno degli aspetti più complessi
632 di un sistema unix-like. In questa sezione, dopo una breve introduzione ai
633 concetti di base, esamineremo come la memoria viene vista da parte di un
634 programma in esecuzione, e le varie funzioni utilizzabili per la sua gestione.
635
636
637 \subsection{I concetti generali}
638 \label{sec:proc_mem_gen}
639
640 \index{memoria~virtuale|(}
641
642 Ci sono vari modi in cui i sistemi operativi organizzano la memoria, ed i
643 dettagli di basso livello dipendono spesso in maniera diretta
644 dall'architettura dell'hardware, ma quello più tipico, usato dai sistemi
645 unix-like come Linux è la cosiddetta \textsl{memoria virtuale} che consiste
646 nell'assegnare ad ogni processo uno spazio virtuale di indirizzamento lineare,
647 in cui gli indirizzi vanno da zero ad un qualche valore massimo.\footnote{nel
648   caso di Linux fino al kernel 2.2 detto massimo era, per macchine a 32bit, di
649   2Gb. Con il kernel 2.4 ed il supporto per la \textit{high-memory} il limite
650   è stato esteso anche per macchine a 32 bit.}  Come accennato nel
651 cap.~\ref{cha:intro_unix} questo spazio di indirizzi è virtuale e non
652 corrisponde all'effettiva posizione dei dati nella RAM del computer. In
653 generale detto spazio non è neppure continuo, cioè non tutti gli indirizzi
654 possibili sono utilizzabili, e quelli usabili non sono necessariamente
655 adiacenti.
656
657 \itindbeg{huge~page}
658
659 Per la gestione da parte del kernel la memoria viene divisa in pagine di
660 dimensione fissa. Inizialmente queste pagine erano di 4kb sulle macchine a 32
661 bit e di 8kb sulle alpha. Con le versioni più recenti del kernel è possibile
662 anche utilizzare pagine di dimensioni maggiori (di 4Mb, dette \textit{huge
663   page}), per sistemi con grandi quantitativi di memoria in cui l'uso di
664 pagine troppo piccole comporta una perdita di prestazioni. In alcuni sistemi
665 la costante \constd{PAGE\_SIZE}, definita in \headfile{limits.h}, indica la
666 dimensione di una pagina in byte, con Linux questo non avviene e per ottenere
667 questa dimensione si deve ricorrere alla funzione \func{getpagesize} (vedi
668 sez.~\ref{sec:sys_memory_res}).
669
670 \itindend{huge~page}
671 \itindbeg{page~table}
672
673 Ciascuna pagina di memoria nello spazio di indirizzi virtuale è associata ad
674 un supporto che può essere una pagina di memoria reale o ad un dispositivo di
675 stoccaggio secondario (come lo spazio disco riservato alla \textit{swap}, o i
676 file che contengono il codice). Per ciascun processo il kernel si cura di
677 mantenere un mappa di queste corrispondenze nella cosiddetta \textit{page
678   table}.\footnote{questa è una semplificazione brutale, il meccanismo è molto
679   più complesso; una buona trattazione di come Linux gestisce la memoria
680   virtuale si trova su \cite{LinVM}.}
681
682 \itindend{page~table}
683
684 Una stessa pagina di memoria reale può fare da supporto a diverse pagine di
685 memoria virtuale appartenenti a processi diversi, come accade in genere per le
686 pagine che contengono il codice delle librerie condivise. Ad esempio il codice
687 della funzione \func{printf} starà su una sola pagina di memoria reale che
688 farà da supporto a tutte le pagine di memoria virtuale di tutti i processi che
689 hanno detta funzione nel loro codice.
690
691 \index{paginazione|(}
692
693 La corrispondenza fra le pagine della memoria virtuale di un processo e quelle
694 della memoria fisica della macchina viene gestita in maniera trasparente dal
695 kernel.\footnote{in genere con l'ausilio dell'hardware di gestione della
696   memoria (la \textit{Memory Management Unit} del processore), con i kernel
697   della serie 2.6 è comunque diventato possibile utilizzare Linux anche su
698   architetture che non dispongono di una MMU.}  Poiché in genere la memoria
699 fisica è solo una piccola frazione della memoria virtuale, è necessario un
700 meccanismo che permetta di trasferire le pagine che servono dal supporto su
701 cui si trovano in memoria, eliminando quelle che non servono.  Questo
702 meccanismo è detto \textsl{paginazione} (o \textit{paging}), ed è uno dei
703 compiti principali del kernel.
704
705 \itindbeg{page~fault} 
706
707 Quando un processo cerca di accedere ad una pagina che non è nella memoria
708 reale, avviene quello che viene chiamato un \textit{page fault}; la gestione
709 della memoria genera un'interruzione e passa il controllo al kernel il quale
710 sospende il processo e si incarica di mettere in RAM la pagina richiesta,
711 effettuando tutte le operazioni necessarie per reperire lo spazio necessario,
712 per poi restituire il controllo al processo.
713
714 Dal punto di vista di un processo questo meccanismo è completamente
715 trasparente, e tutto avviene come se tutte le pagine fossero sempre
716 disponibili in memoria.  L'unica differenza avvertibile è quella dei tempi di
717 esecuzione, che passano dai pochi nanosecondi necessari per l'accesso in RAM
718 se la pagina è direttamente disponibile, a tempi estremamente più lunghi,
719 dovuti all'intervento del kernel, qualora sia necessario reperire pagine
720 riposte nella \textit{swap}.
721
722 \itindend{page~fault} 
723
724 Normalmente questo è il prezzo da pagare per avere un multitasking reale, ed
725 in genere il sistema è molto efficiente in questo lavoro; quando però ci siano
726 esigenze specifiche di prestazioni è possibile usare delle funzioni che
727 permettono di bloccare il meccanismo della paginazione e mantenere fisse delle
728 pagine in memoria (vedi sez.~\ref{sec:proc_mem_lock}).
729
730 \index{paginazione|)}
731 \index{memoria~virtuale|)}
732
733
734 \subsection{La struttura della memoria di un processo}
735 \label{sec:proc_mem_layout}
736
737 \itindbeg{segment~violation}
738
739 Benché lo spazio di indirizzi virtuali copra un intervallo molto ampio, solo
740 una parte di essi è effettivamente allocato ed utilizzabile dal processo; il
741 tentativo di accedere ad un indirizzo non allocato è un tipico errore che si
742 commette quando si è manipolato male un puntatore e genera quella che viene
743 chiamata una \textit{segment violation}. Se si tenta cioè di leggere o
744 scrivere con un indirizzo per il quale non esiste un'associazione nella
745 memoria virtuale, il kernel risponde al relativo \textit{page fault} mandando
746 un segnale \signal{SIGSEGV} al processo, che normalmente ne causa la
747 terminazione immediata.
748
749 \itindend{segment~violation}
750
751 È pertanto importante capire come viene strutturata la memoria virtuale di un
752 processo. Essa viene divisa in \textsl{segmenti}, cioè un insieme contiguo di
753 indirizzi virtuali ai quali il processo può accedere.  Solitamente un
754 programma C viene suddiviso nei seguenti segmenti:
755 \index{segmento!testo|(}
756 \index{segmento!dati|(}
757 \itindbeg{heap} 
758 \itindbeg{stack}
759 \begin{enumerate}
760 \item Il \textsl{segmento di testo} o \textit{text segment}.  Contiene il
761   codice del programma, delle funzioni di librerie da esso utilizzate, e le
762   costanti.  Normalmente viene condiviso fra tutti i processi che eseguono lo
763   stesso programma e nel caso delle librerie anche da processi che eseguono
764   altri programmi.
765
766   Quando l'architettura hardware lo supporta viene marcato in sola lettura per
767   evitare sovrascritture accidentali (o maliziose) che ne modifichino le
768   istruzioni.  Viene allocato da \func{execve} all'avvio del programma e resta
769   invariato per tutto il tempo dell'esecuzione.
770 \index{variabili!globali|(}
771 \index{variabili!statiche|(}
772 \item Il \textsl{segmento dei dati} o \textit{data segment}. Contiene tutti i
773   dati del programma, come le \textsl{variabili globali}, cioè quelle definite
774   al di fuori di tutte le funzioni che compongono il programma, e le
775   \textsl{variabili statiche}, cioè quelle dichiarate con l'attributo
776   \direct{static},\footnote{la direttiva \direct{static} indica al compilatore
777     C che una variabile così dichiarata all'interno di una funzione deve
778     essere mantenuta staticamente in memoria (nel segmento dati appunto);
779     questo significa che la variabile verrà inizializzata una sola volta alla
780     prima invocazione della funzione e che il suo valore sarà mantenuto fra
781     diverse esecuzioni della funzione stessa, la differenza con una variabile
782     globale è che essa può essere vista solo all'interno della funzione in cui
783     è dichiarata.} e la memoria allocata dinamicamente. Di norma è diviso in
784   tre parti:
785   \begin{itemize}
786   \item Il segmento dei dati inizializzati, che contiene le variabili il cui
787     valore è stato assegnato esplicitamente. Ad esempio se si definisce:
788     \includecodesnip{listati/pi.c}
789     questo valore sarà immagazzinato in questo segmento. La memoria di questo
790     segmento viene preallocata all'avvio del programma e inizializzata ai valori
791     specificati.
792   \item Il segmento dei dati non inizializzati, che contiene le variabili il
793     cui valore non è stato assegnato esplicitamente. Ad esempio se si
794     definisce:
795     \includecodesnip{listati/vect.c}
796     questo vettore sarà immagazzinato in questo segmento. Anch'esso viene
797     allocato all'avvio, e tutte le variabili vengono inizializzate a zero (ed
798     i puntatori a \val{NULL}).\footnote{si ricordi che questo vale solo per le
799       variabili che vanno nel segmento dati, e non è affatto vero in
800       generale.}  Storicamente questa seconda parte del segmento dati viene
801     chiamata \itindex{Block~Started~by~Symbol~(BSS)} BSS (da \textit{Block
802       Started by Symbol}). La sua dimensione è fissa.
803     \index{variabili!globali|)} \index{variabili!statiche|)}
804   \item Lo \textit{heap}, detto anche \textit{free store}. Tecnicamente lo si
805     può considerare l'estensione del segmento dei dati non inizializzati, a
806     cui di solito è posto giusto di seguito. Questo è il segmento che viene
807     utilizzato per l'allocazione dinamica della memoria.  Lo \textit{heap} può
808     essere ridimensionato allargandolo e restringendolo per allocare e
809     disallocare la memoria dinamica con le apposite funzioni (vedi
810     sez.~\ref{sec:proc_mem_alloc}), ma il suo limite inferiore, quello
811     adiacente al segmento dei dati non inizializzati, ha una posizione fissa.
812   \end{itemize}
813 \item Il segmento di \textit{stack}, che contiene quello che viene chiamato lo
814   ``\textit{stack}'' del programma.  Tutte le volte che si effettua una
815   chiamata ad una funzione è qui che viene salvato l'indirizzo di ritorno e le
816   informazioni dello stato del chiamante (come il contenuto di alcuni registri
817   della CPU), poi la funzione chiamata alloca qui lo spazio per le sue
818   variabili locali. Tutti questi dati vengono \textit{impilati} (da questo
819   viene il nome \textit{stack}) in sequenza uno sull'altro; in questo modo le
820   funzioni possono essere chiamate ricorsivamente. Al ritorno della funzione
821   lo spazio è automaticamente rilasciato e ``\textsl{ripulito}''.\footnote{il
822     compilatore si incarica di generare automaticamente il codice necessario,
823     seguendo quella che viene chiamata una \textit{calling convention}; quella
824     standard usata con il C ed il C++ è detta \textit{cdecl} e prevede che gli
825     argomenti siano caricati nello \textit{stack} dal chiamante da destra a
826     sinistra, e che sia il chiamante stesso ad eseguire la ripulitura dello
827     \textit{stack} al ritorno della funzione, se ne possono però utilizzare di
828     alternative (ad esempio nel Pascal gli argomenti sono inseriti da sinistra
829     a destra ed è compito del chiamato ripulire lo \textit{stack}), in genere
830     non ci si deve preoccupare di questo fintanto che non si mescolano
831     funzioni scritte con linguaggi diversi.}
832
833   La dimensione di questo segmento aumenta seguendo la crescita dello
834   \textit{stack} del programma, ma non viene ridotta quando quest'ultimo si
835   restringe.
836 \end{enumerate}
837
838 \begin{figure}[htb]
839   \centering
840 %  \includegraphics[height=12cm]{img/memory_layout}
841   \begin{tikzpicture}
842   \draw (0,0) rectangle (4,1);
843   \draw (2,0.5) node {\textit{text}};
844   \draw (0,1) rectangle (4,2.5);
845   \draw (2,1.75) node {dati inizializzati};
846   \draw (0,2.5) rectangle (4,5);
847   \draw (2,3.75) node {dati non inizializzati};
848   \draw (0,5) rectangle (4,9);
849   \draw[dashed] (0,6) -- (4,6);
850   \draw[dashed] (0,8) -- (4,8);
851   \draw (2,5.5) node {\textit{heap}};
852   \draw (2,8.5) node {\textit{stack}};
853   \draw [->] (2,6) -- (2,6.5);
854   \draw [->] (2,8) -- (2,7.5);
855   \draw (0,9) rectangle (4,10);
856   \draw (2,9.5) node {\textit{environment}};
857   \draw (4,0) node [anchor=west] {\texttt{0x08000000}};
858   \draw (4,5) node [anchor=west] {\texttt{0x08xxxxxx}};
859   \draw (4,9) node [anchor=west] {\texttt{0xC0000000}};
860   \end{tikzpicture} 
861   \caption{Disposizione tipica dei segmenti di memoria di un processo.}
862   \label{fig:proc_mem_layout}
863 \end{figure}
864
865 Una disposizione tipica dei vari segmenti (testo, dati inizializzati e non
866 inizializzati, \textit{heap}, \textit{stack}, ecc.) è riportata in
867 fig.~\ref{fig:proc_mem_layout}. Si noti come in figura sia indicata una
868 ulteriore regione, marcata \textit{environment}, che è quella che contiene i
869 dati relativi alle variabili di ambiente passate al programma al suo avvio
870 (torneremo su questo argomento in sez.~\ref{sec:proc_environ}).
871
872 Usando il comando \cmd{size} su un programma se ne può stampare le dimensioni
873 dei segmenti di testo e di dati (solo però per i dati inizializzati ed il BSS,
874 dato che lo \textit{heap} ha una dimensione dinamica). Si tenga presente
875 comunque che il BSS, contrariamente al segmento dei dati inizializzati, non è
876 mai salvato sul file che contiene l'eseguibile, dato che viene sempre
877 inizializzato a zero al caricamento del programma.
878
879 \index{segmento!testo|)}
880 \index{segmento!dati|)}
881 \itindend{heap} 
882 \itindend{stack}
883
884
885 \subsection{Allocazione della memoria per i programmi C}
886 \label{sec:proc_mem_alloc}
887
888 Il C supporta direttamente, come linguaggio di programmazione, soltanto due
889 modalità di allocazione della memoria: l'\textsl{allocazione statica} e
890 l'\textsl{allocazione automatica}.
891
892 L'\textsl{allocazione statica} è quella con cui sono memorizzate le variabili
893 globali e le variabili statiche, cioè le variabili il cui valore deve essere
894 mantenuto per tutta la durata del programma. Come accennato queste variabili
895 vengono allocate nel segmento dei dati all'avvio del programma come parte
896 delle operazioni svolte da \func{exec}, e lo spazio da loro occupato non viene
897 liberato fino alla sua conclusione.
898
899 \index{variabili!automatiche|(}
900
901 L'\textsl{allocazione automatica} è quella che avviene per gli argomenti di
902 una funzione e per le sue variabili locali, quelle che vengono definite
903 all'interno della funzione che esistono solo per la durata della sua
904 esecuzione e che per questo vengono anche dette \textsl{variabili
905   automatiche}.  Lo spazio per queste variabili viene allocato nello
906 \textit{stack} quando viene eseguita la funzione e liberato quando si esce
907 dalla medesima.
908
909 \index{variabili!automatiche|)}
910
911 Esiste però un terzo tipo di allocazione, l'\textsl{allocazione dinamica}
912 della memoria, che non è prevista direttamente all'interno del linguaggio C,
913 ma che è necessaria quando il quantitativo di memoria che serve è
914 determinabile solo durante il corso dell'esecuzione del programma. Il C non
915 consente di usare variabili allocate dinamicamente, non è possibile cioè
916 definire in fase di programmazione una variabile le cui dimensioni possano
917 essere modificate durante l'esecuzione del programma. Per questo la libreria
918 standard del C fornisce una opportuna serie di funzioni per eseguire
919 l'allocazione dinamica di memoria, che come accennato avviene nello
920 \textit{heap}.
921
922 Le variabili il cui contenuto è allocato in questo modo non potranno essere
923 usate direttamente come le altre (quelle nello \textit{stack}), ma l'accesso
924 sarà possibile solo in maniera indiretta, attraverso i puntatori alla memoria
925 loro riservata che si sono ottenuti dalle funzioni di allocazione.
926
927 Le funzioni previste dallo standard ANSI C per la gestione della memoria sono
928 quattro: \func{malloc}, \func{calloc}, \func{realloc} e \func{free}. Le prime
929 due, \funcd{malloc} e \funcd{calloc} allocano nuovo spazio di memoria; i
930 rispettivi prototipi sono:
931
932 \begin{funcproto}{ 
933 \fhead{stdlib.h} 
934 \fdecl{void *calloc(size\_t nmemb, size\_t size)}
935 \fdesc{Alloca un'area di memoria inizializzata a 0.}  
936 \fdecl{void *malloc(size\_t size)}
937 \fdesc{Alloca un'area di memoria non inizializzata.}  
938 }
939 {Entrambe le funzioni restituiscono il puntatore alla zona di memoria allocata
940 in caso di successo e \val{NULL} in caso di fallimento, nel qual caso
941   \var{errno} assumerà il valore \errcode{ENOMEM}.}
942 \end{funcproto}
943
944 In genere si usano \func{malloc} e \func{calloc} per allocare dinamicamente
945 un'area di memoria.\footnote{queste funzioni presentano un comportamento
946   diverso fra le \acr{glibc} e le \acr{uClib} quando il valore di \param{size}
947   è nullo.  Nel primo caso viene comunque restituito un puntatore valido,
948   anche se non è chiaro a cosa esso possa fare riferimento, nel secondo caso
949   viene restituito \val{NULL}. Il comportamento è analogo con
950   \code{realloc(NULL, 0)}.}  Dato che i puntatori ritornati sono di tipo
951 generico non è necessario effettuare un cast per assegnarli a puntatori al
952 tipo di variabile per la quale si effettua l'allocazione, inoltre le funzioni
953 garantiscono che i puntatori siano allineati correttamente per tutti i tipi di
954 dati; ad esempio sulle macchine a 32 bit in genere sono allineati a multipli
955 di 4 byte e sulle macchine a 64 bit a multipli di 8 byte.
956
957 Nel caso di \func{calloc} l'area di memoria viene allocata nello \textit{heap}
958 come un vettore di \param{nmemb} membri di \param{size} byte di dimensione, e
959 preventivamente inizializzata a zero, nel caso di \func{malloc} invece vengono
960 semplicemente allocati \param{size} byte e l'area di memoria non viene
961 inizializzata.
962
963 Una volta che non sia più necessaria la memoria allocata dinamicamente deve
964 essere esplicitamente rilasciata usando la funzione \funcd{free},\footnote{le
965   glibc provvedono anche una funzione \funcm{cfree} definita per compatibilità
966   con SunOS, che è deprecata.} il suo prototipo è:
967
968 \begin{funcproto}{ 
969 \fhead{stdlib.h} 
970 \fdecl{void free(void *ptr)}
971 \fdesc{Disalloca un'area di memoria precedentemente allocata.}  
972 }
973 {La funzione non ritorna nulla e non riporta errori.}
974 \end{funcproto}
975
976 Questa funzione vuole come argomento \var{ptr} il puntatore restituito da una
977 precedente chiamata ad una qualunque delle funzioni di allocazione che non sia
978 già stato liberato da un'altra chiamata a \func{free}. Se il valore
979 di \param{ptr} è \val{NULL} la funzione non fa niente, mentre se l'area di
980 memoria era già stata liberata da un precedente chiamata il comportamento
981 della funzione è dichiarato indefinito, ma in genere comporta la corruzione
982 dei dati di gestione dell'allocazione, che può dar luogo a problemi gravi, ad
983 esempio un \textit{segmentation fault} in una successiva chiamata di una di
984 queste funzioni.
985
986 \itindbeg{double~free}
987
988 Dato che questo errore, chiamato in gergo \textit{double free}, è abbastanza
989 frequente, specie quando si manipolano vettori di puntatori, e dato che le
990 conseguenze possono essere pesanti ed inaspettate, si suggerisce come
991 soluzione precauzionale di assegnare sempre a \val{NULL} ogni puntatore su cui
992 sia stata eseguita \func{free} immediatamente dopo l'esecuzione della
993 funzione. In questo modo, dato che con un puntatore nullo \func{free} non
994 esegue nessuna operazione, si evitano i problemi del \textit{double free}.
995
996 \itindend{double~free}
997
998 Infine la funzione \funcd{realloc} consente di modificare, in genere di
999 aumentare, la dimensione di un'area di memoria precedentemente allocata; il
1000 suo prototipo è:
1001
1002 \begin{funcproto}{ 
1003 \fhead{stdlib.h} 
1004 \fdecl{void *realloc(void *ptr, size\_t size)}
1005 \fdesc{Cambia la dimensione di un'area di memoria precedentemente allocata.}
1006 }  {La funzione ritorna il puntatore alla zona di memoria allocata in caso
1007   di successo e \val{NULL} per un errore, nel qual caso \var{errno}
1008   assumerà il valore \errcode{ENOMEM}.}
1009 \end{funcproto}
1010
1011 La funzione vuole come primo argomento il puntatore restituito da una
1012 precedente chiamata a \func{malloc} o \func{calloc} e come secondo argomento
1013 la nuova dimensione (in byte) che si intende ottenere. Se si passa
1014 per \param{ptr} il valore \val{NULL} allora la funzione si comporta come
1015 \func{malloc}.\footnote{questo è vero per Linux e l'implementazione secondo lo
1016   standard ANSI C, ma non è vero per alcune vecchie implementazioni, inoltre
1017   alcune versioni delle librerie del C consentivano di usare \func{realloc}
1018   anche per un puntatore liberato con \func{free} purché non ci fossero state
1019   nel frattempo altre chiamate a funzioni di allocazione, questa funzionalità
1020   è totalmente deprecata e non è consentita sotto Linux.}
1021
1022 La funzione si usa ad esempio quando si deve far crescere la dimensione di un
1023 vettore. In questo caso se è disponibile dello spazio adiacente al precedente
1024 la funzione lo utilizza, altrimenti rialloca altrove un blocco della
1025 dimensione voluta, copiandoci automaticamente il contenuto; lo spazio aggiunto
1026 non viene inizializzato. Se la funzione fallisce l'area di memoria originale
1027 non viene assolutamente toccata.
1028
1029 Si deve sempre avere ben presente il fatto che il blocco di memoria restituito
1030 da \func{realloc} può non essere un'estensione di quello che gli si è passato
1031 in ingresso; per questo si dovrà \emph{sempre} eseguire la riassegnazione di
1032 \param{ptr} al valore di ritorno della funzione, e reinizializzare o provvedere
1033 ad un adeguato aggiornamento di tutti gli altri puntatori all'interno del
1034 blocco di dati ridimensionato.
1035
1036 La \acr{glibc} ha un'implementazione delle funzioni di allocazione che è
1037 controllabile dall'utente attraverso alcune variabili di ambiente (vedi
1038 sez.~\ref{sec:proc_environ}), in particolare diventa possibile tracciare
1039 questo tipo di errori usando la variabile di ambiente \envvar{MALLOC\_CHECK\_}
1040 che quando viene definita mette in uso una versione meno efficiente delle
1041 funzioni suddette, che però è più tollerante nei confronti di piccoli errori
1042 come quello dei \textit{double free} o i \textit{buffer overrun} di un
1043 byte.\footnote{uno degli errori più comuni, causato ad esempio dalla scrittura
1044   di una stringa di dimensione pari a quella del buffer, in cui ci si
1045   dimentica dello zero di terminazione finale.}  In particolare:
1046 \begin{itemize*}
1047 \item se la variabile è posta a $0$ gli errori vengono ignorati;
1048 \item se la variabile è posta a $1$ viene stampato un avviso sullo
1049   \textit{standard error} (vedi sez.~\ref{sec:file_fd});
1050 \item se la variabile è posta a $2$ viene chiamata la funzione \func{abort}
1051   (vedi sez.~\ref{sec:sig_alarm_abort}), che in genere causa l'immediata
1052   terminazione del programma;
1053 \item se la variabile è posta a $3$ viene stampato l'avviso e chiamata
1054   \func{abort}. 
1055 \end{itemize*}
1056
1057 \itindbeg{memory~leak}
1058
1059 L'errore di programmazione più comune e più difficile da risolvere che si
1060 incontra con le funzioni di allocazione è quando non viene opportunamente
1061 liberata la memoria non più utilizzata, quello che in inglese viene chiamato
1062 \textit{memory leak}, cioè una \textsl{perdita di memoria}.
1063
1064 Un caso tipico che illustra il problema è quello in cui in una propria
1065 funzione si alloca della memoria per uso locale senza liberarla prima di
1066 uscire. La memoria resta così allocata fino alla terminazione del processo.
1067 Chiamate ripetute alla stessa funzione continueranno ad effettuare altre
1068 allocazioni, che si accumuleranno causando a lungo andare un esaurimento della
1069 memoria disponibile e la probabile impossibilità di proseguire l'esecuzione
1070 del programma.
1071
1072 Il problema è che l'esaurimento della memoria può avvenire in qualunque
1073 momento, in corrispondenza ad una qualunque chiamata di \func{malloc} che può
1074 essere in una sezione del codice che non ha alcuna relazione con la funzione
1075 che contiene l'errore. Per questo motivo è sempre molto difficile trovare un
1076 \textit{memory leak}.  In C e C++ il problema è particolarmente sentito. In
1077 C++, per mezzo della programmazione ad oggetti, il problema dei \textit{memory
1078   leak} si può notevolmente ridimensionare attraverso l'uso accurato di
1079 appositi oggetti come gli \textit{smartpointers}.  Questo però in genere va a
1080 scapito delle prestazioni dell'applicazione in esecuzione.
1081
1082 % TODO decidere cosa fare di questo che segue In altri linguaggi come il java
1083 % e recentemente il C\# il problema non si pone nemmeno perché la gestione
1084 % della memoria viene fatta totalmente in maniera automatica, ovvero il
1085 % programmatore non deve minimamente preoccuparsi di liberare la memoria
1086 % allocata precedentemente quando non serve più, poiché l'infrastruttura del
1087 % linguaggio gestisce automaticamente la cosiddetta
1088 % \itindex{garbage~collection} \textit{garbage collection}. In tal caso,
1089 % attraverso meccanismi simili a quelli del \textit{reference counting},
1090 % quando una zona di memoria precedentemente allocata non è più riferita da
1091 % nessuna parte del codice in esecuzione, può essere deallocata
1092 % automaticamente in qualunque momento dall'infrastruttura.
1093
1094 % Anche questo va a scapito delle prestazioni dell'applicazione in esecuzione
1095 % (inoltre le applicazioni sviluppate con tali linguaggi di solito non sono
1096 % eseguibili compilati, come avviene invece per il C ed il C++, ed è necessaria
1097 % la presenza di una infrastruttura per la loro interpretazione e pertanto hanno
1098 % di per sé delle prestazioni più scadenti rispetto alle stesse applicazioni
1099 % compilate direttamente).  Questo comporta però il problema della non
1100 % predicibilità del momento in cui viene deallocata la memoria precedentemente
1101 % allocata da un oggetto.
1102
1103 Per limitare l'impatto di questi problemi, e semplificare la ricerca di
1104 eventuali errori, l'implementazione delle funzioni di allocazione nella
1105 \acr{glibc} mette a disposizione una serie di funzionalità che permettono di
1106 tracciare le allocazioni e le disallocazioni, e definisce anche una serie di
1107 possibili \textit{hook} (\textsl{ganci}) che permettono di sostituire alle
1108 funzioni di libreria una propria versione (che può essere più o meno
1109 specializzata per il debugging). Esistono varie librerie che forniscono dei
1110 sostituti opportuni delle funzioni di allocazione in grado, senza neanche
1111 ricompilare il programma,\footnote{esempi sono \textit{Dmalloc}
1112   \url{http://dmalloc.com/} di Gray Watson ed \textit{Electric Fence} di Bruce
1113   Perens.} di eseguire diagnostiche anche molto complesse riguardo
1114 l'allocazione della memoria. Vedremo alcune delle funzionalità di ausilio
1115 presenti nella \acr{glibc} in sez.~\ref{sec:proc_memory_adv_management}.
1116
1117 \itindend{memory~leak}
1118
1119 Una possibile alternativa all'uso di \func{malloc}, per evitare di soffrire
1120 dei problemi di \textit{memory leak} descritti in precedenza, è di allocare la
1121 memoria nel segmento di \textit{stack} della funzione corrente invece che
1122 nello \textit{heap}. Per farlo si può usare la funzione \funcd{alloca}, la cui
1123 sintassi è identica a quella di \func{malloc}; il suo prototipo è:
1124
1125 \begin{funcproto}{ 
1126 \fhead{stdlib.h} 
1127 \fdecl{void *alloca(size\_t size)}
1128 \fdesc{Alloca un'area di memoria nello \textit{stack}.} 
1129 }
1130 {La funzione ritorna il puntatore alla zona di memoria allocata, in caso
1131   di errore il comportamento è indefinito.}
1132 \end{funcproto}
1133
1134 La funzione alloca la quantità di memoria (non inizializzata) richiesta
1135 dall'argomento \param{size} nel segmento di \textit{stack} della funzione
1136 chiamante. Con questa funzione non è più necessario liberare la memoria
1137 allocata, e quindi non esiste un analogo della \func{free}, in quanto essa
1138 viene rilasciata automaticamente al ritorno della funzione.
1139
1140 Come è evidente questa funzione ha alcuni vantaggi interessanti, anzitutto
1141 permette di evitare alla radice i problemi di \textit{memory leak}, dato che
1142 non serve più la deallocazione esplicita; inoltre la deallocazione automatica
1143 funziona anche quando si usa \func{longjmp} per uscire da una subroutine con
1144 un salto non locale da una funzione (vedi sez.~\ref{sec:proc_longjmp}).  Un
1145 altro vantaggio è che in Linux la funzione è molto più veloce di \func{malloc}
1146 e non viene sprecato spazio, infatti non è necessario gestire un pool di
1147 memoria da riservare e si evitano così anche i problemi di frammentazione di
1148 quest'ultimo, che comportano inefficienze sia nell'allocazione della memoria
1149 che nell'esecuzione dell'allocazione.
1150
1151 Gli svantaggi sono che questa funzione non è disponibile su tutti gli Unix, e
1152 non è inserita né nello standard POSIX né in SUSv3 (ma è presente in BSD), il
1153 suo utilizzo quindi limita la portabilità dei programmi. Inoltre la funzione
1154 non può essere usata nella lista degli argomenti di una funzione, perché lo
1155 spazio verrebbe allocato nel mezzo degli stessi. Inoltre non è chiaramente
1156 possibile usare \func{alloca} per allocare memoria che deve poi essere usata
1157 anche al di fuori della funzione in cui essa viene chiamata, dato che
1158 all'uscita dalla funzione lo spazio allocato diventerebbe libero, e potrebbe
1159 essere sovrascritto all'invocazione di nuove funzioni.  Questo è lo stesso
1160 problema che si può avere con le variabili automatiche, su cui torneremo in
1161 sez.~\ref{sec:proc_var_passing}.
1162
1163 Infine non esiste un modo di sapere se l'allocazione ha avuto successo, la
1164 funzione infatti viene realizzata inserendo del codice \textit{inline} nel
1165 programma\footnote{questo comporta anche il fatto che non è possibile
1166   sostituirla con una propria versione o modificarne il comportamento
1167   collegando il proprio programma con un'altra libreria.} che si limita a
1168 modificare il puntatore nello \textit{stack} e non c'è modo di sapere se se ne
1169 sono superate le dimensioni, per cui in caso di fallimento nell'allocazione il
1170 comportamento del programma può risultare indefinito, dando luogo ad una
1171 \textit{segment violation} la prima volta che cercherà di accedere alla
1172 memoria non effettivamente disponibile.
1173
1174 \index{segmento!dati|(}
1175 \itindbeg{heap} 
1176
1177 Le due funzioni seguenti vengono utilizzate soltanto quando è necessario
1178 effettuare direttamente la gestione della memoria associata allo spazio dati
1179 di un processo,\footnote{le due funzioni sono state definite con BSD 4.3, sono
1180   marcate obsolete in SUSv2 e non fanno parte delle librerie standard del C e
1181   mentre sono state esplicitamente rimosse dallo standard POSIX.1-2001.} per
1182 poterle utilizzare è necessario definire una della macro di funzionalità (vedi
1183 sez.~\ref{sec:intro_gcc_glibc_std}) fra \macro{\_BSD\_SOURCE},
1184 \macro{\_SVID\_SOURCE} e \macro{\_XOPEN\_SOURCE} (ad un valore maggiore o
1185 uguale di 500). La prima funzione è \funcd{brk}, ed il suo prototipo è:
1186
1187 \begin{funcproto}{ 
1188 \fhead{unistd.h} 
1189 \fdecl{int brk(void *addr)}
1190 \fdesc{Sposta la fine del segmento dati del processo.} 
1191 }
1192 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore,
1193   nel qual caso \var{errno} assumerà il valore \errcode{ENOMEM}.}
1194 \end{funcproto}
1195
1196 La funzione è un'interfaccia all'omonima \textit{system call} ed imposta
1197 l'indirizzo finale del segmento dati di un processo (più precisamente dello
1198 \textit{heap}) all'indirizzo specificato da \param{addr}. Quest'ultimo deve
1199 essere un valore ragionevole e la dimensione totale non deve comunque eccedere
1200 un eventuale limite (vedi sez.~\ref{sec:sys_resource_limit}) sulle dimensioni
1201 massime del segmento dati del processo.
1202
1203 Il valore di ritorno della funzione fa riferimento alla versione fornita dalla
1204 \acr{glibc}, in realtà in Linux la \textit{system call} corrispondente
1205 restituisce come valore di ritorno il nuovo valore della fine del segmento
1206 dati in caso di successo e quello corrente in caso di fallimento, è la
1207 funzione di interfaccia usata dalla \acr{glibc} che fornisce i valori di
1208 ritorno appena descritti; se si usano librerie diverse questo potrebbe non
1209 accadere.
1210
1211 Una seconda funzione per la manipolazione diretta delle dimensioni del
1212 segmento dati\footnote{in questo caso si tratta soltanto di una funzione di
1213   libreria, anche se basata sulla stessa \textit{system call}.} è
1214 \funcd{sbrk}, ed il suo prototipo è:
1215
1216 \begin{funcproto}{ 
1217 \fhead{unistd.h} 
1218 \fdecl{void *sbrk(intptr\_t increment)}
1219 \fdesc{Incrementa la dimensione del segmento dati del processo.} 
1220 }
1221 {La funzione ritorna il puntatore all'inizio della nuova zona di memoria
1222   allocata in caso di successo e \val{NULL} per un errore, nel qual
1223   caso \var{errno} assumerà il valore \errcode{ENOMEM}.}
1224 \end{funcproto}
1225
1226 La funzione incrementa la dimensione dello \textit{heap} di un
1227 programma del valore indicato dall'argomento \param{increment}, restituendo il
1228 nuovo indirizzo finale dello stesso.  L'argomento è definito come di tipo
1229 \type{intptr\_t}, ma a seconda della versione delle librerie e del sistema può
1230 essere indicato con una serie di tipi equivalenti come \ctyp{ptrdiff\_t},
1231 \ctyp{ssize\_t}, \ctyp{int}. Se invocata con un valore nullo la funzione
1232 permette di ottenere l'attuale posizione della fine del segmento dati.
1233
1234 Queste due funzioni sono state deliberatamente escluse dallo standard POSIX.1
1235 dato che per i normali programmi è sempre opportuno usare le funzioni di
1236 allocazione standard descritte in precedenza, a meno di non voler realizzare
1237 per proprio conto un diverso meccanismo di gestione della memoria del segmento
1238 dati.
1239 \itindend{heap} 
1240 \index{segmento!dati|)}
1241
1242
1243 \subsection{Il controllo della memoria virtuale}  
1244 \label{sec:proc_mem_lock}
1245
1246 \index{memoria~virtuale|(}
1247
1248 Come spiegato in sez.~\ref{sec:proc_mem_gen} il kernel gestisce la memoria
1249 virtuale in maniera trasparente ai processi, decidendo quando rimuovere pagine
1250 dalla memoria per metterle nell'area di \textit{swap}, sulla base
1251 dell'utilizzo corrente da parte dei vari processi.
1252
1253 Nell'uso comune un processo non deve preoccuparsi di tutto ciò, in quanto il
1254 meccanismo della paginazione riporta in RAM, ed in maniera trasparente, tutte
1255 le pagine che gli occorrono; esistono però esigenze particolari in cui non si
1256 vuole che questo meccanismo si attivi. In generale i motivi per cui si possono
1257 avere di queste necessità sono due:
1258 \begin{itemize*}
1259 \item \textsl{La velocità}. Il processo della paginazione è trasparente solo
1260   se il programma in esecuzione non è sensibile al tempo che occorre a
1261   riportare la pagina in memoria; per questo motivo processi critici che hanno
1262   esigenze di tempo reale o tolleranze critiche nelle risposte (ad esempio
1263   processi che trattano campionamenti sonori) possono non essere in grado di
1264   sopportare le variazioni della velocità di accesso dovuta alla paginazione.
1265   
1266   In certi casi poi un programmatore può conoscere meglio dell'algoritmo di
1267   allocazione delle pagine le esigenze specifiche del suo programma e decidere
1268   quali pagine di memoria è opportuno che restino in memoria per un aumento
1269   delle prestazioni. In genere queste sono esigenze particolari e richiedono
1270   anche un aumento delle priorità in esecuzione del processo (vedi
1271   sez.~\ref{sec:proc_real_time}).
1272   
1273 \item \textsl{La sicurezza}. Se si hanno password o chiavi segrete in chiaro
1274   in memoria queste possono essere portate su disco dal meccanismo della
1275   paginazione. Questo rende più lungo il periodo di tempo in cui detti segreti
1276   sono presenti in chiaro e più complessa la loro cancellazione: un processo
1277   infatti può cancellare la memoria su cui scrive le sue variabili, ma non può
1278   toccare lo spazio disco su cui una pagina di memoria può essere stata
1279   salvata. Per questo motivo di solito i programmi di crittografia richiedono
1280   il blocco di alcune pagine di memoria.
1281 \end{itemize*}
1282
1283 Per ottenere informazioni sulle modalità in cui un programma sta usando la
1284 memoria virtuale è disponibile una apposita funzione di sistema,
1285 \funcd{mincore}, che però non è standardizzata da POSIX e pertanto non è
1286 disponibile su tutte le versioni di kernel unix-like;\footnote{nel caso di
1287   Linux devono essere comunque definite le macro \macro{\_BSD\_SOURCE} e
1288   \macro{\_SVID\_SOURCE}.}  il suo prototipo è:
1289
1290 \begin{funcproto}{
1291 \fhead{unistd.h}
1292 \fhead{sys/mman.h}
1293 \fdecl{int mincore(void *addr, size\_t length, unsigned char *vec)}
1294 \fdesc{Ritorna lo stato delle pagine di memoria occupate da un processo.}
1295 }
1296 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore, nel qual
1297 caso \var{errno} assumerà uno dei valori:
1298 \begin{errlist}
1299    \item[\errcode{EAGAIN}] il kernel è temporaneamente non in grado di fornire
1300      una risposta.
1301    \item[\errcode{EFAULT}] \param{vec} punta ad un indirizzo non valido.
1302    \item[\errcode{EINVAL}] \param{addr} non è un multiplo delle dimensioni di
1303      una pagina.
1304    \item[\errcode{ENOMEM}] o \param{addr}$+$\param{length} eccede la dimensione
1305      della memoria usata dal processo o l'intervallo di indirizzi specificato
1306      non è mappato.
1307 \end{errlist}}
1308 \end{funcproto}
1309
1310 La funzione permette di ottenere le informazioni sullo stato della mappatura
1311 della memoria per il processo chiamante, specificando l'intervallo da
1312 esaminare con l'indirizzo iniziale, indicato con l'argomento \param{addr}, e
1313 la lunghezza, indicata con l'argomento \param{length}. L'indirizzo iniziale
1314 deve essere un multiplo delle dimensioni di una pagina, mentre la lunghezza
1315 può essere qualunque, fintanto che si resta nello spazio di indirizzi del
1316 processo,\footnote{in caso contrario si avrà un errore di \errcode{ENOMEM};
1317   fino al kernel 2.6.11 in questo caso veniva invece restituito
1318   \errcode{EINVAL}, in considerazione che il caso più comune in cui si
1319   verifica questo errore è quando si usa per sbaglio un valore negativo
1320   di \param{length}, che nel caso verrebbe interpretato come un intero
1321   positivo di grandi dimensioni.}  ma il risultato verrà comunque fornito per
1322 l'intervallo compreso fino al multiplo successivo.
1323
1324 I risultati della funzione vengono forniti nel vettore puntato da \param{vec},
1325 che deve essere allocato preventivamente e deve essere di dimensione
1326 sufficiente a contenere tanti byte quante sono le pagine contenute
1327 nell'intervallo di indirizzi specificato, la dimensione cioè deve essere
1328 almeno pari a \code{(length+PAGE\_SIZE-1)/PAGE\_SIZE}.  Al ritorno della
1329 funzione il bit meno significativo di ciascun byte del vettore sarà acceso se
1330 la pagina di memoria corrispondente è al momento residente in memoria, o
1331 cancellato altrimenti. Il comportamento sugli altri bit è indefinito, essendo
1332 questi al momento riservati per usi futuri. Per questo motivo in genere è
1333 comunque opportuno inizializzare a zero il contenuto del vettore, così che le
1334 pagine attualmente residenti in memoria saranno indicata da un valore non
1335 nullo del byte corrispondente.
1336
1337 Dato che lo stato della memoria di un processo può cambiare continuamente, il
1338 risultato di \func{mincore} è assolutamente provvisorio e lo stato delle
1339 pagine potrebbe essere già cambiato al ritorno stesso della funzione, a meno
1340 che, come vedremo ora, non si sia attivato il meccanismo che forza il
1341 mantenimento di una pagina sulla memoria.  
1342
1343 \itindbeg{memory~locking}
1344
1345 Il meccanismo che previene la paginazione di parte della memoria virtuale di
1346 un processo è chiamato \textit{memory locking} (o \textsl{blocco della
1347   memoria}). Il blocco è sempre associato alle pagine della memoria virtuale
1348 del processo, e non al segmento reale di RAM su cui essa viene mantenuta.  La
1349 regola è che se un segmento di RAM fa da supporto ad almeno una pagina
1350 bloccata allora esso viene escluso dal meccanismo della paginazione. I blocchi
1351 non si accumulano, se si blocca due volte la stessa pagina non è necessario
1352 sbloccarla due volte, una pagina o è bloccata oppure no.
1353
1354 Il \textit{memory lock} persiste fintanto che il processo che detiene la
1355 memoria bloccata non la sblocca. Chiaramente la terminazione del processo
1356 comporta anche la fine dell'uso della sua memoria virtuale, e quindi anche di
1357 tutti i suoi \textit{memory lock}.  Inoltre i \textit{memory lock} non sono
1358 ereditati dai processi figli, ma siccome Linux usa il \textit{copy on write}
1359 (vedi sez.~\ref{sec:proc_fork}) gli indirizzi virtuali del figlio sono
1360 mantenuti sullo stesso segmento di RAM del padre, e quindi fintanto che un
1361 figlio non scrive su un segmento bloccato, può usufruire del \textit{memory
1362   lock} del padre. Infine i \textit{memory lock} vengono automaticamente
1363 rimossi se si pone in esecuzione un altro programma con \func{exec} (vedi
1364 sez.~\ref{sec:proc_exec}).
1365
1366 Il sistema pone dei limiti all'ammontare di memoria di un processo che può
1367 essere bloccata e al totale di memoria fisica che si può dedicare a questo, lo
1368 standard POSIX.1 richiede che sia definita in \headfile{unistd.h} la macro
1369 \macrod{\_POSIX\_MEMLOCK\_RANGE} per indicare la capacità di eseguire il
1370 \textit{memory locking}.
1371
1372 Siccome la richiesta di un \textit{memory lock} da parte di un processo riduce
1373 la memoria fisica disponibile nel sistema per gli altri processi, questo ha un
1374 evidente impatto su tutti gli altri processi, per cui fino al kernel 2.6.9
1375 solo un processo dotato di privilegi amministrativi (la \textit{capability}
1376 \const{CAP\_IPC\_LOCK}, vedi sez.~\ref{sec:proc_capabilities}) aveva la
1377 capacità di bloccare una pagina di memoria.
1378
1379 A partire dal kernel 2.6.9 anche un processo normale può bloccare la propria
1380 memoria\footnote{la funzionalità è stata introdotta per non essere costretti a
1381   dare privilegi eccessivi a programmi di crittografia, che necessitano di
1382   questa funzionalità, ma che devono essere usati da utenti normali.} ma
1383 mentre un processo privilegiato non ha limiti sulla quantità di memoria che
1384 può bloccare, un processo normale è soggetto al limite della risorsa
1385 \const{RLIMIT\_MEMLOCK} (vedi sez.~\ref{sec:sys_resource_limit}). In generale
1386 poi ogni processo può sbloccare le pagine relative alla propria memoria, se
1387 però diversi processi bloccano la stessa pagina questa resterà bloccata
1388 fintanto che ci sarà almeno un processo che la blocca.
1389
1390 Le funzioni di sistema per bloccare e sbloccare la paginazione di singole
1391 sezioni di memoria sono rispettivamente \funcd{mlock} e \funcd{munlock}; i
1392 loro prototipi sono:
1393
1394 \begin{funcproto}{
1395   \fhead{sys/mman.h} 
1396   \fdecl{int mlock(const void *addr, size\_t len)}
1397   \fdesc{Blocca la paginazione su un intervallo di memoria.}
1398
1399   \fdecl{int munlock(const void *addr, size\_t len)}
1400   \fdesc{Rimuove il blocco della paginazione su un intervallo di memoria.}
1401   }
1402 {Entrambe le funzioni ritornano $0$ in caso di successo e $-1$ in caso di
1403   errore, nel qual caso \var{errno} assumerà uno dei valori:
1404   \begin{errlist}
1405   \item[\errcode{EINVAL}] \param{len} non è un valore positivo.
1406   \item[\errcode{ENOMEM}] alcuni indirizzi dell’intervallo specificato non
1407     corrispondono allo spazio di indirizzi del processo o si è superato il
1408     limite di \const{RLIMIT\_MEMLOCK} per un processo non privilegiato (solo
1409     per kernel a partire dal 2.6.9). 
1410   \item[\errcode{EPERM}] il processo non è privilegiato (per kernel precedenti
1411     il 2.6.9) o si ha un limite nullo per \const{RLIMIT\_MEMLOCK} e
1412     il processo non è privilegiato (per kernel a partire dal 2.6.9).
1413   \end{errlist}}
1414 \end{funcproto}
1415
1416 Le due funzioni permettono rispettivamente di bloccare e sbloccare la
1417 paginazione per l'intervallo di memoria iniziante all'indirizzo \param{addr} e
1418 lungo \param{len} byte.  Tutte le pagine che contengono una parte
1419 dell'intervallo bloccato sono mantenute in RAM per tutta la durata del
1420 blocco. Con kernel diversi da Linux si può ottenere un errore di
1421 \errcode{EINVAL} se \param{addr} non è un multiplo della dimensione delle
1422 pagine di memoria, pertanto se si ha a cuore la portabilità si deve avere cura
1423 di allinearne correttamente il valore.
1424
1425 Altre due funzioni di sistema, \funcd{mlockall} e \funcd{munlockall},
1426 consentono di bloccare genericamente la paginazione per l'intero spazio di
1427 indirizzi di un processo.  I prototipi di queste funzioni sono:
1428
1429 \begin{funcproto}{ 
1430 \fhead{sys/mman.h} 
1431 \fdecl{int mlockall(int flags)}
1432 \fdesc{Blocca la paginazione per lo spazio di indirizzi del processo corrente.} 
1433 \fdecl{int munlockall(void)}
1434 \fdesc{Sblocca la paginazione per lo spazio di indirizzi del processo corrente.}
1435 }
1436 {Codici di ritorno ed errori sono gli stessi di \func{mlock} e \func{munlock},
1437   tranne per \errcode{EINVAL} che viene restituito solo se si è specificato
1438   con \func{mlockall} un valore sconosciuto per \param{flags}.}
1439 \end{funcproto}
1440
1441 L'argomento \param{flags} di \func{mlockall} permette di controllarne il
1442 comportamento; esso deve essere specificato come maschera binaria dei valori
1443 espressi dalle costanti riportate in tab.~\ref{tab:mlockall_flags}.
1444
1445 \begin{table}[htb]
1446   \footnotesize
1447   \centering
1448   \begin{tabular}[c]{|l|p{8cm}|}
1449     \hline
1450     \textbf{Valore} & \textbf{Significato} \\
1451     \hline
1452     \hline
1453     \constd{MCL\_CURRENT}& blocca tutte le pagine correntemente mappate nello
1454                            spazio di indirizzi del processo.\\
1455     \constd{MCL\_FUTURE} & blocca tutte le pagine che verranno mappate nello
1456                            spazio di indirizzi del processo.\\
1457    \hline
1458   \end{tabular}
1459   \caption{Valori e significato dell'argomento \param{flags} della funzione
1460     \func{mlockall}.}
1461   \label{tab:mlockall_flags}
1462 \end{table}
1463
1464 Con \func{mlockall} si possono bloccare tutte le pagine mappate nello spazio
1465 di indirizzi del processo, sia che comprendano il segmento di testo, di dati,
1466 lo \textit{stack}, lo \textit{heap} e pure le funzioni di libreria chiamate, i
1467 file mappati in memoria, i dati del kernel mappati in user space, la memoria
1468 condivisa.  L'uso dell'argomento \param{flags} permette di selezionare con
1469 maggior finezza le pagine da bloccare, ad esempio usando \const{MCL\_FUTURE}
1470 ci si può limitare a tutte le pagine allocate a partire dalla chiamata della
1471 funzione.
1472
1473 In ogni caso un processo \textit{real-time} che deve entrare in una sezione
1474 critica (vedi sez.~\ref{sec:proc_race_cond}) deve provvedere a riservare
1475 memoria sufficiente prima dell'ingresso, per scongiurare l'occorrenza di un
1476 eventuale \textit{page fault} causato dal meccanismo di \textit{copy on
1477   write}.  Infatti se nella sezione critica si va ad utilizzare memoria che
1478 non è ancora stata riportata in RAM si potrebbe avere un \textit{page fault}
1479 durante l'esecuzione della stessa, con conseguente rallentamento
1480 (probabilmente inaccettabile) dei tempi di esecuzione.
1481
1482 In genere si ovvia a questa problematica chiamando una funzione che ha
1483 allocato una quantità sufficientemente ampia di variabili automatiche, in modo
1484 che esse vengano mappate in RAM dallo \textit{stack}, dopo di che, per essere
1485 sicuri che esse siano state effettivamente portate in memoria, ci si scrive
1486 sopra.
1487
1488 \itindend{memory~locking}
1489 \index{memoria~virtuale|)} 
1490
1491
1492 \subsection{Gestione avanzata dell'allocazione della memoria} 
1493 \label{sec:proc_memory_adv_management}
1494
1495 La trattazione delle funzioni di allocazione di sez.~\ref{sec:proc_mem_alloc}
1496 si è limitata a coprire le esigenze generiche di un programma, in cui non si
1497 hanno dei requisiti specifici e si lascia il controllo delle modalità di
1498 allocazione alle funzioni di libreria.  Tuttavia esistono una serie di casi in
1499 cui può essere necessario avere un controllo più dettagliato delle modalità
1500 con cui la memoria viene allocata; nel qual caso potranno venire in aiuto le
1501 funzioni trattate in questa sezione.
1502
1503 Le prime funzioni che tratteremo sono quelle che consentono di richiedere di
1504 allocare un blocco di memoria ``\textsl{allineato}'' ad un multiplo una certa
1505 dimensione. Questo tipo di esigenza emerge usualmente quando si devono
1506 allocare dei buffer da utilizzare per eseguire dell'I/O diretto su dispositivi
1507 a blocchi. In questo caso infatti il trasferimento di dati viene eseguito per
1508 blocchi di dimensione fissa, ed è richiesto che l'indirizzo di partenza del
1509 buffer sia un multiplo intero di questa dimensione, usualmente 512 byte. In
1510 tal caso l'uso di \func{malloc} non è sufficiente, ed occorre utilizzare una
1511 funzione specifica.
1512
1513 Tradizionalmente per rispondere a questa esigenza sono state create due
1514 funzioni diverse, \funcd{memalign} e \funcd{valloc}, oggi obsolete; i
1515 rispettivi prototipi sono:
1516
1517 \begin{funcproto}{ 
1518 \fhead{malloc.h} 
1519 \fdecl{void *valloc(size\_t size)}
1520 \fdesc{Alloca un blocco di memoria allineato alla dimensione di una pagina di
1521   memoria.}  
1522 \fdecl{void *memalign(size\_t boundary, size\_t size)}
1523 \fdesc{Alloca un blocco di memoria allineato ad un multiplo
1524   di \param{boundary}.} 
1525 }
1526 {Entrambe le funzioni ritornano un puntatore al blocco di memoria allocato in
1527   caso di successo e \val{NULL} in caso di errore, nel qual caso \var{errno}
1528   assumerà uno dei valori:
1529   \begin{errlist}
1530   \item[\errcode{EINVAL}] \param{boundary} non è una potenza di due.
1531   \item[\errcode{ENOMEM}] non c'è memoria sufficiente per l'allocazione.
1532   \end{errlist}}
1533 \end{funcproto}
1534
1535 Le funzioni restituiscono il puntatore al buffer di memoria allocata di
1536 dimensioni pari a \param{size}, che per \func{memalign} sarà un multiplo
1537 di \param{boundary} mentre per \func{valloc} un multiplo della dimensione di
1538 una pagina di memoria. Nel caso della versione fornita dalla \acr{glibc} la
1539 memoria allocata con queste funzioni deve essere liberata con \func{free},
1540 cosa che non è detto accada con altre implementazioni.
1541
1542 Nessuna delle due funzioni ha una chiara standardizzazione e nessuna delle due
1543 compare in POSIX.1, inoltre ci sono indicazioni discordi sui file che ne
1544 contengono la definizione;\footnote{secondo SUSv2 \func{valloc} è definita in
1545   \headfile{stdlib.h}, mentre sia le \acr{glibc} che le precedenti \acr{libc4}
1546   e \acr{libc5} la dichiarano in \headfile{malloc.h}, lo stesso vale per
1547   \func{memalign} che in alcuni sistemi è dichiarata in \headfile{stdlib.h}.}
1548 per questo motivo il loro uso è sconsigliato, essendo state sostituite dalla
1549 nuova \funcd{posix\_memalign}, che è stata standardizzata in POSIX.1d; il suo
1550 prototipo è:
1551
1552 \begin{funcproto}{ 
1553 \fhead{stdlib.h} 
1554 \fdecl{posix\_memalign(void **memptr, size\_t alignment, size\_t size)}
1555 \fdesc{Alloca un buffer di memoria allineato ad un multiplo
1556   di \param{alignment}.}   
1557 }
1558 {Entrambe le funzioni ritornano un puntatore al blocco di memoria allocato in
1559   caso di successo e \val{NULL} in caso di errore, nel qual caso \var{errno}
1560   assumerà uno dei valori:
1561   \begin{errlist}
1562   \item[\errcode{EINVAL}] \param{alignment} non è potenza di due e multiplo
1563     di \code{sizeof(void *)}.
1564   \item[\errcode{ENOMEM}] non c'è memoria sufficiente per l'allocazione.
1565   \end{errlist}}
1566 \end{funcproto}
1567
1568 La funzione restituisce il puntatore al buffer allocato di dimensioni pari
1569 a \param{size} nella variabile (di tipo \texttt{void *}) posta all'indirizzo
1570 indicato da \param{memptr}. La funzione fallisce nelle stesse condizioni delle
1571 due funzioni precedenti, ma a loro differenza restituisce direttamente come
1572 valore di ritorno il codice di errore.  Come per le precedenti la memoria
1573 allocata con \func{posix\_memalign} deve essere disallocata con \func{free},
1574 che in questo caso però è quanto richiesto dallo standard.  Si tenga presente
1575 infine che nessuna di queste funzioni inizializza il buffer di memoria
1576 allocato, il loro comportamento cioè è analogo, allineamento a parte, a quello
1577 di \func{malloc}.
1578
1579 Un secondo caso in cui risulta estremamente utile poter avere un maggior
1580 controllo delle modalità di allocazione della memoria è quello in cui cercano
1581 errori di programmazione. Esempi di questi errori sono i \textit{double free},
1582 o i cosiddetti \itindex{buffer~overrun} \textit{buffer overrun}, cioè le
1583 scritture su un buffer oltre le dimensioni della sua
1584 allocazione,\footnote{entrambe queste operazioni causano in genere la
1585   corruzione dei dati di controllo delle funzioni di allocazione, che vengono
1586   anch'essi mantenuti nello \textit{heap} per tenere traccia delle zone di
1587   memoria allocata.} o i classici \textit{memory leak}.
1588
1589 Abbiamo visto in sez.~\ref{sec:proc_mem_lock} come una prima funzionalità di
1590 ausilio nella ricerca di questi errori sia l'uso della variabile di ambiente
1591 \envvar{MALLOC\_CHECK\_}.  Una modalità alternativa per effettuare dei
1592 controlli di consistenza sullo stato delle allocazioni di memoria eseguite con
1593 \func{malloc}, anche questa fornita come estensione specifica (e non standard)
1594 della \acr{glibc}, è quella di utilizzare la funzione \funcd{mcheck}, che deve
1595 essere chiamata prima di eseguire qualunque allocazione con \func{malloc}; il
1596 suo prototipo è:
1597
1598 \begin{funcproto}{ 
1599 \fhead{mcheck.h} 
1600 \fdecl{int mcheck(void (*abortfn) (enum mcheck\_status status))}
1601 \fdesc{Attiva i controlli di consistenza delle allocazioni di memoria.}   
1602 }
1603 {La funzione ritorna $0$ in caso di successo e $-1$ per un errorre;
1604   \var{errno} non viene impostata.} 
1605 \end{funcproto}
1606
1607 La funzione consente di registrare una funzione di emergenza che verrà
1608 eseguita tutte le volte che, in una successiva esecuzione di \func{malloc},
1609 venissero trovate delle inconsistenze, come delle operazioni di scrittura
1610 oltre i limiti dei buffer allocati. Per questo motivo la funzione deve essere
1611 chiamata prima di qualunque allocazione di memoria, altrimenti fallirà.
1612
1613 Se come primo argomento di \func{mcheck} si passa \val{NULL} verrà utilizzata
1614 una funzione predefinita che stampa un messaggio di errore ed invoca la
1615 funzione \func{abort} (vedi sez.~\ref{sec:sig_alarm_abort}), altrimenti si
1616 dovrà creare una funzione personalizzata in grado di ricevere il tipo di
1617 errore ed agire di conseguenza.
1618
1619 Nonostante la scarsa leggibilità del prototipo si tratta semplicemente di
1620 definire una funzione di tipo \code{void abortfn(enum mcheck\_status status)},
1621 che non deve restituire nulla e che deve avere un unico argomento di tipo
1622 \code{mcheck\_status}. In caso di errore la funzione verrà eseguita ricevendo
1623 un opportuno valore di \param{status} che è un tipo enumerato che può assumere
1624 soltanto i valori di tab.~\ref{tab:mcheck_status_value} che indicano la
1625 tipologia di errore riscontrata.
1626
1627 \begin{table}[htb]
1628   \centering
1629   \footnotesize
1630   \begin{tabular}[c]{|l|p{7cm}|}
1631     \hline
1632     \textbf{Valore} & \textbf{Significato} \\
1633     \hline
1634     \hline
1635     \constd{MCHECK\_OK}      & Riportato a \func{mprobe} se nessuna
1636                                inconsistenza è presente.\\
1637     \constd{MCHECK\_DISABLED}& Riportato a \func{mprobe} se si è chiamata
1638                                \func{mcheck} dopo aver già usato
1639                                \func{malloc}.\\
1640     \constd{MCHECK\_HEAD}    & I dati immediatamente precedenti il buffer sono
1641                                stati modificati, avviene in genere quando si
1642                                decrementa eccessivamente il valore di un
1643                                puntatore scrivendo poi prima dell'inizio del
1644                                buffer.\\
1645     \constd{MCHECK\_TAIL}    & I dati immediatamente seguenti il buffer sono
1646                                stati modificati, succede quando si va scrivere
1647                                oltre la dimensione corretta del buffer.\\
1648     \constd{MCHECK\_FREE}    & Il buffer è già stato disallocato.\\
1649     \hline
1650   \end{tabular}
1651   \caption{Valori dello stato dell'allocazione di memoria ottenibili dalla
1652     funzione di terminazione installata con \func{mcheck}.} 
1653   \label{tab:mcheck_status_value}
1654 \end{table}
1655
1656 Una volta che si sia chiamata \func{mcheck} con successo si può anche
1657 controllare esplicitamente lo stato delle allocazioni senza aspettare un
1658 errore nelle relative funzioni utilizzando la funzione \funcd{mprobe}, il cui
1659 prototipo è:
1660
1661 \begin{funcproto}{ 
1662 \fhead{mcheck.h} 
1663 \fdecl{enum mcheck\_status mprobe(ptr)}
1664 \fdesc{Esegue un controllo di consistenza delle allocazioni.}   
1665 }
1666 {La funzione ritorna un codice fra quelli riportati in
1667    tab.~\ref{tab:mcheck_status_value} e non ha errori.} 
1668 \end{funcproto}
1669
1670 La funzione richiede che si passi come argomento un puntatore ad un blocco di
1671 memoria precedentemente allocato con \func{malloc} o \func{realloc}, e
1672 restituisce lo stesso codice di errore che si avrebbe per la funzione di
1673 emergenza ad una successiva chiamata di una funzione di allocazione, e poi i
1674 primi due codici che indicano rispettivamente quando tutto è a posto o il
1675 controllo non è possibile per non aver chiamato \func{mcheck} in tempo.
1676
1677 % TODO: trattare le altre funzionalità avanzate di \func{malloc}, mallopt,
1678 % mtrace, muntrace, mallinfo e gli hook con le glibc 2.10 c'è pure malloc_info
1679 % a sostituire mallinfo, vedi http://udrepper.livejournal.com/20948.html
1680
1681
1682 \section{Argomenti, ambiente ed altre proprietà di un processo}
1683 \label{sec:proc_options}
1684
1685 In questa sezione esamineremo le funzioni che permettono di gestire gli
1686 argomenti e le opzioni, e quelle che consentono di manipolare ed utilizzare le
1687 variabili di ambiente. Accenneremo infine alle modalità con cui si può gestire
1688 la localizzazione di un programma modificandone il comportamento a seconda
1689 della lingua o del paese a cui si vuole faccia riferimento nelle sue
1690 operazioni. 
1691
1692 \subsection{Il formato degli argomenti}
1693 \label{sec:proc_par_format}
1694
1695 Tutti i programmi hanno la possibilità di ricevere argomenti e opzioni quando
1696 vengono lanciati e come accennato in sez.~\ref{sec:proc_main} questo viene
1697 effettuato attraverso gli argomenti \param{argc} e \param{argv} ricevuti nella
1698 funzione \code{main} all'avvio del programma. Questi argomenti vengono passati
1699 al programma dalla shell o dal processo che esegue la \func{exec} (secondo le
1700 modalità che vedremo in sez.~\ref{sec:proc_exec}) quando questo viene messo in
1701 esecuzione.
1702
1703 Nel caso più comune il passaggio di argomenti ed opzioni viene effettuato
1704 dalla shell, che si incarica di leggere la linea di comando con cui si lancia
1705 il programma e di effettuarne la scansione (il cosiddetto \textit{parsing})
1706 per individuare le parole che la compongono, ciascuna delle quali potrà essere
1707 considerata un argomento o un'opzione. 
1708
1709 Di norma per individuare le parole che andranno a costituire la lista degli
1710 argomenti viene usato come carattere di separazione lo spazio o il tabulatore,
1711 ma la cosa dipende ovviamente dalle modalità con cui si effettua la scansione
1712 e dalle convenzioni adottate dal programma che la esegue: ad esempio la shell
1713 consente di proteggere con opportuni caratteri di controllo argomenti che
1714 contengono degli spazi evitando di spezzarli in parole diverse.
1715
1716 \begin{figure}[htb]
1717   \centering
1718 %  \includegraphics[width=13cm]{img/argv_argc}
1719 %  \includegraphics[width=13cm]{img/argv_argc}
1720   \begin{tikzpicture}[>=stealth]
1721   \draw (0.5,2.5) rectangle (3.5,3);
1722   \draw (2,2.75) node {\texttt{argc = 5}};
1723   \draw (5,2.5) rectangle (8,3);
1724   \draw (6.5,2.75) node {\texttt{argv[0]}};
1725   \draw [->] (8,2.75) -- (9,2.75);
1726   \draw (9,2.75) node [anchor=west] {\texttt{"touch"}};
1727   \draw (5,2) rectangle (8,2.5);
1728   \draw (6.5,2.25) node {\texttt{argv[1]}};
1729   \draw [->] (8,2.25) -- (9,2.25);
1730   \draw (9,2.25) node [anchor=west] {\texttt{"-r"}};
1731   \draw (5,1.5) rectangle (8,2);
1732   \draw (6.5,1.75) node {\texttt{argv[2]}};
1733   \draw [->] (8,1.75) -- (9,1.75);
1734   \draw (9,1.75) node [anchor=west] {\texttt{"riferimento.txt"}};
1735   \draw (5,1.0) rectangle (8,1.5);
1736   \draw (6.5,1.25) node {\texttt{argv[3]}};
1737   \draw [->] (8,1.25) -- (9,1.25);
1738   \draw (9,1.25) node [anchor=west] {\texttt{"-m"}};
1739   \draw (5,0.5) rectangle (8,1.0);
1740   \draw (6.5,0.75) node {\texttt{argv[4]}};
1741   \draw [->] (8,0.75) -- (9,0.75);
1742   \draw (9,0.75) node [anchor=west] {\texttt{"questofile.txt"}};
1743   \draw (4.25,3.5) node{\texttt{"touch -r riferimento.txt -m questofile.txt"}};
1744
1745   \end{tikzpicture}
1746   \caption{Esempio dei valori di \param{argv} e \param{argc} generati nella 
1747     scansione di una riga di comando.}
1748   \label{fig:proc_argv_argc}
1749 \end{figure}
1750
1751 Indipendentemente da come viene eseguita, il risultato finale della scansione
1752 dovrà comunque essere la costruzione del vettore di puntatori \param{argv} in
1753 cui si devono inserire in successione i puntatori alle stringhe costituenti i
1754 vari argomenti ed opzioni da passare al programma, e della
1755 variabile \param{argc} che deve essere inizializzata al numero di stringhe
1756 contenute in \param{argv}. Nel caso della shell questo comporta ad esempio che
1757 il primo argomento sia sempre il nome del programma. Un esempio di questo
1758 meccanismo è mostrato in fig.~\ref{fig:proc_argv_argc}, che illustra il
1759 risultato della scansione di una riga di comando.
1760
1761
1762 \subsection{La gestione delle opzioni}
1763 \label{sec:proc_opt_handling}
1764
1765 In generale un programma Unix riceve da linea di comando sia gli argomenti che
1766 le opzioni, queste ultime sono standardizzate per essere riconosciute come
1767 tali: un elemento di \param{argv} successivo al primo che inizia con il
1768 carattere ``\texttt{-}'' e che non sia un singolo ``\texttt{-}'' o un
1769 ``\texttt{-{}-}'' viene considerato un'opzione.  In genere le opzioni sono
1770 costituite da una lettera singola (preceduta dal carattere ``\texttt{-}'') e
1771 possono avere o no un parametro associato. Un esempio tipico può essere quello
1772 mostrato in fig.~\ref{fig:proc_argv_argc}. In quel caso le opzioni sono
1773 \cmd{-r} e \cmd{-m} e la prima vuole un parametro mentre la seconda no
1774 (\cmd{questofile.txt} è un argomento del programma, non un parametro di
1775 \cmd{-m}).
1776
1777 Per gestire le opzioni all'interno degli argomenti a linea di comando passati
1778 in \param{argv} la libreria standard del C fornisce la funzione
1779 \funcd{getopt}, che ha il seguente prototipo:
1780
1781 \begin{funcproto}{ 
1782 \fhead{unistd.h} 
1783 \fdecl{int getopt(int argc, char * const argv[], const char *optstring)}
1784 \fdesc{Esegue la scansione delle opzioni negli argomenti della funzione
1785   \code{main}.} 
1786 }
1787 {Ritorna il carattere che segue l'opzione, ``\texttt{:}'' se manca un
1788   parametro all'opzione, ``\texttt{?}'' se l'opzione è sconosciuta, e $-1$ se
1789   non esistono altre opzioni.} 
1790 \end{funcproto}
1791
1792 Questa funzione prende come argomenti le due variabili \param{argc} e
1793 \param{argv} che devono essere quelle passate come argomenti di \code{main}
1794 all'esecuzione del programma, ed una stringa \param{optstring} che indica
1795 quali sono le opzioni valide. La funzione effettua la scansione della lista
1796 degli argomenti ricercando ogni stringa che comincia con il carattere
1797 ``\texttt{-}'' e ritorna ogni volta che trova un'opzione valida.
1798
1799 La stringa \param{optstring} indica quali sono le opzioni riconosciute ed è
1800 costituita da tutti i caratteri usati per identificare le singole opzioni, se
1801 l'opzione ha un parametro al carattere deve essere fatto seguire il carattere
1802 di due punti (``\texttt{:}''); nel caso di fig.~\ref{fig:proc_argv_argc} ad
1803 esempio la stringa di opzioni avrebbe dovuto contenere \texttt{"r:m"}.
1804
1805 La modalità di uso di \func{getopt} è pertanto quella di chiamare più volte la
1806 funzione all'interno di un ciclo, fintanto che essa non ritorna il valore $-1$
1807 che indica che non ci sono più opzioni. Nel caso si incontri un'opzione non
1808 dichiarata in \param{optstring} viene ritornato il carattere ``\texttt{?}''
1809 mentre se un'opzione che lo richiede non è seguita da un parametro viene
1810 ritornato il carattere ``\texttt{:}'', infine se viene incontrato il valore
1811 ``\texttt{-{}-}'' la scansione viene considerata conclusa, anche se vi sono
1812 altri elementi di \param{argv} che cominciano con il carattere ``\texttt{-}''.
1813
1814 \begin{figure}[!htb]
1815   \footnotesize \centering
1816   \begin{minipage}[c]{\codesamplewidth}
1817   \includecodesample{listati/option_code.c}
1818   \end{minipage}
1819   \normalsize
1820   \caption{Esempio di codice per la gestione delle opzioni.}
1821   \label{fig:proc_options_code}
1822 \end{figure}
1823
1824 Quando \func{getopt} trova un'opzione fra quelle indicate in \param{optstring}
1825 essa ritorna il valore numerico del carattere, in questo modo si possono
1826 eseguire azioni specifiche usando uno \instruction{switch}; la funzione
1827 inoltre inizializza alcune variabili globali:
1828 \begin{itemize*}
1829 \item \var{char *optarg} contiene il puntatore alla stringa parametro
1830   dell'opzione.
1831 \item \var{int optind} alla fine della scansione restituisce l'indice del
1832   primo elemento di \param{argv} che non è un'opzione.
1833 \item \var{int opterr} previene, se posto a zero, la stampa di un messaggio
1834   di errore in caso di riconoscimento di opzioni non definite.
1835 \item \var{int optopt} contiene il carattere dell'opzione non riconosciuta.
1836 \end{itemize*}
1837
1838 In fig.~\ref{fig:proc_options_code} si è mostrata la sezione del programma
1839 \file{fork\_test.c}, che useremo nel prossimo capitolo per effettuare dei test
1840 sulla creazione dei processi, deputata alla decodifica delle opzioni a riga di
1841 comando da esso supportate.
1842
1843 Si può notare che si è anzitutto (\texttt{\small 1}) disabilitata la stampa di
1844 messaggi di errore per opzioni non riconosciute, per poi passare al ciclo per
1845 la verifica delle opzioni (\texttt{\small 2-27}); per ciascuna delle opzioni
1846 possibili si è poi provveduto ad un'azione opportuna, ad esempio per le tre
1847 opzioni che prevedono un parametro si è effettuata la decodifica del medesimo,
1848 il cui indirizzo è contenuto nella variabile \var{optarg}), avvalorando la
1849 relativa variabile (\texttt{\small 12-14}, \texttt{\small 15-17} e
1850 \texttt{\small 18-20}). Completato il ciclo troveremo in \var{optind}
1851 l'indice in \code{argv[]} del primo degli argomenti rimanenti nella linea di
1852 comando.
1853
1854 Normalmente \func{getopt} compie una permutazione degli elementi di
1855 \param{argv} cosicché alla fine della scansione gli elementi che non sono
1856 opzioni sono spostati in coda al vettore. Oltre a questa esistono altre due
1857 modalità di gestire gli elementi di \param{argv}; se \param{optstring} inizia
1858 con il carattere ``\texttt{+}'' (o è impostata la variabile di ambiente
1859 \cmd{POSIXLY\_CORRECT}) la scansione viene fermata non appena si incontra un
1860 elemento che non è un'opzione.
1861
1862 L'ultima modalità, usata quando un programma può gestire la mescolanza fra
1863 opzioni e argomenti, ma se li aspetta in un ordine definito, si attiva
1864 quando \param{optstring} inizia con il carattere ``\texttt{-}''. In questo caso
1865 ogni elemento che non è un'opzione viene considerato comunque un'opzione e
1866 associato ad un valore di ritorno pari ad 1, questo permette di identificare
1867 gli elementi che non sono opzioni, ma non effettua il riordinamento del
1868 vettore \param{argv}.
1869
1870
1871 \subsection{Le variabili di ambiente}
1872 \label{sec:proc_environ}
1873
1874 \index{variabili!di~ambiente|(}
1875 Oltre agli argomenti passati a linea di comando esiste un'altra modalità che
1876 permette di trasferire ad un processo delle informazioni in modo da
1877 modificarne il comportamento.  Ogni processo infatti riceve dal sistema, oltre
1878 alle variabili \param{argv} e \param{argc} anche un \textsl{ambiente} (in
1879 inglese \textit{environment}); questo viene espresso nella forma di una lista
1880 (chiamata \textit{environment list}) delle cosiddette \textsl{variabili di
1881   ambiente}, i valori di queste variabili possono essere poi usati dal
1882 programma.
1883
1884 Anche in questo caso la lista delle \textsl{variabili di ambiente} deve essere
1885 costruita ed utilizzata nella chiamata alla funzione \func{exec} (torneremo su
1886 questo in sez.~\ref{sec:proc_exec}) quando questo viene lanciato. Come per la
1887 lista degli argomenti anche questa lista è un vettore di puntatori a
1888 caratteri, ciascuno dei quali punta ad una stringa, terminata da un
1889 \val{NULL}. A differenza di \code{argv[]} in questo caso non si ha una
1890 lunghezza del vettore data da un equivalente di \param{argc}, ma la lista è
1891 terminata da un puntatore nullo.
1892
1893 L'indirizzo della lista delle variabili di ambiente è passato attraverso la
1894 variabile globale \var{environ}, che viene definita automaticamente per
1895 ciascun processo, e a cui si può accedere attraverso una semplice
1896 dichiarazione del tipo:
1897 \includecodesnip{listati/env_ptr.c}
1898 un esempio della struttura di questa lista, contenente alcune delle variabili
1899 più comuni che normalmente sono definite dal sistema, è riportato in
1900 fig.~\ref{fig:proc_envirno_list}.
1901 \begin{figure}[htb]
1902   \centering
1903 %  \includegraphics[width=15 cm]{img/environ_var}
1904   \begin{tikzpicture}[>=stealth]
1905   \draw (2,3.5) node {\textsf{Environment pointer}};
1906   \draw (6,3.5) node {\textsf{Environment list}};
1907   \draw (10.5,3.5) node {\textsf{Environment string}};
1908   \draw (0.5,2.5) rectangle (3.5,3);
1909   \draw (2,2.75) node {\texttt{environ}};
1910   \draw [->] (3.5,2.75) -- (4.5,2.75);
1911   \draw (4.5,2.5) rectangle (7.5,3);
1912   \draw (6,2.75) node {\texttt{environ[0]}};
1913   \draw (4.5,2) rectangle (7.5,2.5);
1914   \draw (6,2.25) node {\texttt{environ[1]}};
1915   \draw (4.5,1.5) rectangle (7.5,2);
1916   \draw (4.5,1) rectangle (7.5,1.5);
1917   \draw (4.5,0.5) rectangle (7.5,1);
1918   \draw (4.5,0) rectangle (7.5,0.5);
1919   \draw (6,0.25) node {\texttt{NULL}};
1920   \draw [->] (7.5,2.75) -- (8.5,2.75);
1921   \draw (8.5,2.75) node[right] {\texttt{HOME=/home/piccardi}};
1922   \draw [->] (7.5,2.25) -- (8.5,2.25);
1923   \draw (8.5,2.25) node[right] {\texttt{PATH=:/bin:/usr/bin}};
1924   \draw [->] (7.5,1.75) -- (8.5,1.75);
1925   \draw (8.5,1.75) node[right] {\texttt{SHELL=/bin/bash}};
1926   \draw [->] (7.5,1.25) -- (8.5,1.25);
1927   \draw (8.5,1.25) node[right] {\texttt{EDITOR=emacs}};
1928   \draw [->] (7.5,0.75) -- (8.5,0.75);
1929   \draw (8.5,0.75) node[right] {\texttt{OSTYPE=linux-gnu}};
1930   \end{tikzpicture}
1931   \caption{Esempio di lista delle variabili di ambiente.}
1932   \label{fig:proc_envirno_list}
1933 \end{figure}
1934
1935 Per convenzione le stringhe che definiscono l'ambiente sono tutte del tipo
1936 \textsl{\texttt{NOME=valore}} ed in questa forma che le funzioni di gestione
1937 che vedremo a breve se le aspettano, se pertanto si dovesse costruire
1938 manualmente un ambiente si abbia cura di rispettare questa convenzione.
1939 Inoltre alcune variabili, come quelle elencate in
1940 fig.~\ref{fig:proc_envirno_list}, sono definite dal sistema per essere usate
1941 da diversi programmi e funzioni: per queste c'è l'ulteriore convenzione di
1942 usare nomi espressi in caratteri maiuscoli.\footnote{ma si tratta solo di una
1943   convenzione, niente vieta di usare caratteri minuscoli, come avviene in vari
1944   casi.}
1945
1946 Il kernel non usa mai queste variabili, il loro uso e la loro interpretazione è
1947 riservata alle applicazioni e ad alcune funzioni di libreria; in genere esse
1948 costituiscono un modo comodo per definire un comportamento specifico senza
1949 dover ricorrere all'uso di opzioni a linea di comando o di file di
1950 configurazione. É di norma cura della shell, quando esegue un comando, passare
1951 queste variabili al programma messo in esecuzione attraverso un uso opportuno
1952 delle relative chiamate (si veda sez.~\ref{sec:proc_exec}).
1953
1954 La shell ad esempio ne usa molte per il suo funzionamento, come \envvar{PATH}
1955 per indicare la lista delle directory in cui effettuare la ricerca dei comandi
1956 o \envvar{PS1} per impostare il proprio \textit{prompt}. Alcune di esse, come
1957 \envvar{HOME}, \envvar{USER}, ecc. sono invece definite al login (per i
1958 dettagli si veda sez.~\ref{sec:sess_login}), ed in genere è cura della propria
1959 distribuzione definire le opportune variabili di ambiente in uno script di
1960 avvio. Alcune servono poi come riferimento generico per molti programmi, come
1961 \envvar{EDITOR} che indica l'editor preferito da invocare in caso di
1962 necessità. Una in particolare, \envvar{LANG}, serve a controllare la
1963 localizzazione del programma 
1964 %(su cui torneremo in sez.~\ref{sec:proc_localization}) 
1965 per adattarlo alla lingua ed alle convezioni
1966 dei vari paesi.
1967
1968 Gli standard POSIX e XPG3 definiscono alcune di queste variabili (le più
1969 comuni), come riportato in tab.~\ref{tab:proc_env_var}. GNU/Linux le supporta
1970 tutte e ne definisce anche altre, in particolare poi alcune funzioni di
1971 libreria prevedono la presenza di specifiche variabili di ambiente che ne
1972 modificano il comportamento, come quelle usate per indicare una localizzazione
1973 e quelle per indicare un fuso orario; una lista più completa che comprende
1974 queste ed ulteriori variabili si può ottenere con il comando \cmd{man 7
1975   environ}.
1976
1977 \begin{table}[htb]
1978   \centering
1979   \footnotesize
1980   \begin{tabular}[c]{|l|c|c|c|l|}
1981     \hline
1982     \textbf{Variabile} & \textbf{POSIX} & \textbf{XPG3} 
1983     & \textbf{Linux} & \textbf{Descrizione} \\
1984     \hline
1985     \hline
1986     \texttt{USER}   &$\bullet$&$\bullet$&$\bullet$& Nome utente.\\
1987     \texttt{LOGNAME}&$\bullet$&$\bullet$&$\bullet$& Nome di login.\\
1988     \texttt{HOME}   &$\bullet$&$\bullet$&$\bullet$& Directory base
1989                                                     dell'utente.\\
1990     \texttt{LANG}   &$\bullet$&$\bullet$&$\bullet$& Localizzazione.\\
1991     \texttt{PATH}   &$\bullet$&$\bullet$&$\bullet$& Elenco delle directory
1992                                                     dei programmi.\\
1993     \texttt{PWD}    &$\bullet$&$\bullet$&$\bullet$& Directory corrente.\\
1994     \texttt{SHELL}  &$\bullet$&$\bullet$&$\bullet$& Shell in uso.\\
1995     \texttt{TERM}   &$\bullet$&$\bullet$&$\bullet$& Tipo di terminale.\\
1996     \texttt{PAGER}  &$\bullet$&$\bullet$&$\bullet$& Programma per vedere i
1997                                                     testi.\\
1998     \texttt{EDITOR} &$\bullet$&$\bullet$&$\bullet$& Editor preferito.\\
1999     \texttt{BROWSER}&$\bullet$&$\bullet$&$\bullet$& Browser preferito.\\
2000     \texttt{TMPDIR} &$\bullet$&$\bullet$&$\bullet$& Directory dei file
2001                                                     temporanei.\\
2002     \hline
2003   \end{tabular}
2004   \caption{Esempi delle variabili di ambiente più comuni definite da vari
2005     standard.} 
2006   \label{tab:proc_env_var}
2007 \end{table}
2008
2009 Lo standard ANSI C prevede l'esistenza di un ambiente, e pur non entrando
2010 nelle specifiche di come sono strutturati i contenuti, definisce la funzione
2011 \funcd{getenv} che permette di ottenere i valori delle variabili di ambiente;
2012 il suo prototipo è:
2013
2014 \begin{funcproto}{ 
2015 \fhead{stdlib.h}
2016 \fdecl{char *getenv(const char *name)}
2017 \fdesc{Cerca una variabile di ambiente del processo.} 
2018 }
2019 {La funzione ritorna il puntatore alla stringa contenente il valore della
2020   variabile di ambiente in caso di successo e \val{NULL} per un errore.} 
2021 \end{funcproto}
2022
2023 La funzione effettua una ricerca nell'ambiente del processo cercando una
2024 variabile il cui nome corrisponda a quanto indicato con
2025 l'argomento \param{name}, ed in caso di successo ritorna il puntatore alla
2026 stringa che ne contiene il valore, nella forma ``\texttt{NOME=valore}''.
2027
2028 \begin{table}[htb]
2029   \centering
2030   \footnotesize
2031   \begin{tabular}[c]{|l|c|c|c|c|c|c|}
2032     \hline
2033     \textbf{Funzione} & \textbf{ANSI C} & \textbf{POSIX.1} & \textbf{XPG3} & 
2034     \textbf{SVr4} & \textbf{BSD} & \textbf{Linux} \\
2035     \hline
2036     \hline
2037     \func{getenv}  & $\bullet$ & $\bullet$ & $\bullet$ 
2038                    & $\bullet$ & $\bullet$ & $\bullet$ \\
2039     \func{setenv}  &    --     &    --     &   --      
2040                    &    --     & $\bullet$ & $\bullet$ \\
2041     \func{unsetenv}&    --     &    --     &   --       
2042                    &    --     & $\bullet$ & $\bullet$ \\
2043     \func{putenv}  &    --     & opz.      & $\bullet$ 
2044                    &    --     & $\bullet$ & $\bullet$ \\
2045     \func{clearenv}&    --     & opz.      &   --
2046                    &    --     &    --     & $\bullet$ \\
2047     \hline
2048   \end{tabular}
2049   \caption{Funzioni per la gestione delle variabili di ambiente.}
2050   \label{tab:proc_env_func}
2051 \end{table}
2052
2053 Oltre a questa funzione di lettura, che è l'unica definita dallo standard ANSI
2054 C, nell'evoluzione dei sistemi Unix ne sono state proposte altre, da
2055 utilizzare per impostare, modificare e per cancellare le variabili di
2056 ambiente. Uno schema delle funzioni previste nei vari standard e disponibili
2057 in Linux è riportato in tab.~\ref{tab:proc_env_func}. Tutte le funzioni sono
2058 state comunque inserite nello standard POSIX.1-2001, ad eccetto di
2059 \func{clearenv} che è stata rigettata.
2060
2061 In Linux sono definite tutte le funzioni elencate in
2062 tab.~\ref{tab:proc_env_func},\footnote{in realtà nelle libc4 e libc5 sono
2063   definite solo le prime quattro, \func{clearenv} è stata introdotta con la
2064   \acr{glibc} 2.0.} anche se parte delle funzionalità sono ridondanti. La
2065 prima funzione di manipolazione che prenderemo in considerazione è
2066 \funcd{putenv}, che consente di aggiungere, modificare e cancellare una
2067 variabile di ambiente; il suo prototipo è:
2068
2069 \begin{funcproto}{ 
2070 \fdecl{int putenv(char *string)}
2071 \fdesc{Inserisce, modifica o rimuove una variabile d'ambiente.} 
2072 }
2073 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore, che può
2074   essere solo \errval{ENOMEM}.}
2075 \end{funcproto}
2076
2077 La funzione prende come argomento una stringa analoga a quella restituita da
2078 \func{getenv} e sempre nella forma ``\texttt{NOME=valore}''. Se la variabile
2079 specificata (nel caso \texttt{NOME}) non esiste la stringa sarà aggiunta
2080 all'ambiente, se invece esiste il suo valore sarà impostato a quello
2081 specificato dal contenuto di \param{string} (nel caso \texttt{valore}).  Se
2082 invece si passa come argomento solo il nome di una variabile di ambiente
2083 (cioè \param{string} è nella forma ``\texttt{NOME}'' e non contiene il
2084 carattere ``\texttt{=}'') allora questa, se presente nell'ambiente, verrà
2085 cancellata.
2086
2087 Si tenga presente che, seguendo lo standard SUSv2, le \acr{glibc} successive
2088 alla versione 2.1.2 aggiungono direttamente \param{string} nella lista delle
2089 variabili di ambiente illustrata in fig.~\ref{fig:proc_envirno_list}
2090 sostituendo il relativo puntatore;\footnote{il comportamento è lo stesso delle
2091   vecchie \acr{libc4} e \acr{libc5}; nella \acr{glibc}, dalla versione 2.0
2092   alla 2.1.1, veniva invece fatta una copia, seguendo il comportamento di
2093   BSD4.4; dato che questo può dar luogo a perdite di memoria e non rispetta lo
2094   standard il comportamento è stato modificato a partire dalle 2.1.2,
2095   eliminando anche, sempre in conformità a SUSv2, l'attributo \direct{const}
2096   dal prototipo.}  pertanto ogni cambiamento alla stringa in questione si
2097 riflette automaticamente sull'ambiente, e quindi si deve evitare di passare a
2098 questa funzione una variabile automatica (per evitare i problemi esposti in
2099 sez.~\ref{sec:proc_var_passing}). Benché non sia richiesto dallo standard
2100 nelle versioni della \acr{glibc} a partire dalla 2.1 la funzione è rientrante
2101 (vedi sez.~\ref{sec:proc_reentrant}).
2102
2103 Infine quando una chiamata a \func{putenv} comporta la necessità di creare una
2104 nuova versione del vettore \var{environ} questo sarà allocato automaticamente,
2105 ma la versione corrente sarà deallocata solo se anch'essa è risultante da
2106 un'allocazione fatta in precedenza da un'altra \func{putenv}. Questo avviene
2107 perché il vettore delle variabili di ambiente iniziale, creato dalla chiamata
2108 ad \func{exec} (vedi sez.~\ref{sec:proc_exec}) è piazzato nella memoria al di
2109 sopra dello \textit{stack}, (vedi fig.~\ref{fig:proc_mem_layout}) e non nello
2110 \textit{heap} e quindi non può essere deallocato.  Inoltre la memoria
2111 associata alle variabili di ambiente eliminate non viene liberata.
2112
2113 Come alternativa a \func{putenv} si può usare la funzione \funcd{setenv} che
2114 però consente solo di aggiungere o modificare una variabile di ambiente; il
2115 suo prototipo è:
2116
2117 \begin{funcproto}{ 
2118 \fhead{stdlib.h}
2119 \fdecl{int setenv(const char *name, const char *value, int overwrite)}
2120 \fdesc{Inserisce o modifica una variabile di ambiente.} 
2121 }
2122 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore,
2123   nel qual caso \var{errno} assumerà uno dei valori:
2124   \begin{errlist}
2125   \item[\errcode{EINVAL}] \param{name} è \val{NULL} o una stringa di lunghezza
2126   nulla o che contiene il carattere ``\texttt{=}''.
2127   \item[\errcode{ENOMEM}] non c'è memoria sufficiente per aggiungere una nuova
2128     variabile all'ambiente.
2129 \end{errlist}}
2130 \end{funcproto}
2131
2132 La funzione consente di specificare separatamente nome e valore della
2133 variabile di ambiente da aggiungere negli argomenti \param{name}
2134 e \param{value}. Se la variabile è già presente nell'ambiente
2135 l'argomento \param{overwrite} specifica il comportamento della funzione, se
2136 diverso da zero sarà sovrascritta, se uguale a zero sarà lasciata immutata.  A
2137 differenza di \func{putenv} la funzione esegue delle copie del contenuto degli
2138 argomenti \param{name} e \param{value} e non è necessario preoccuparsi di
2139 allocarli in maniera permanente.
2140
2141 La cancellazione di una variabile di ambiente viene invece gestita
2142 esplicitamente con \funcd{unsetenv}, il cui prototipo è:
2143
2144 \begin{funcproto}{ 
2145 \fhead{stdlib.h}
2146 \fdecl{int unsetenv(const char *name)}
2147 \fdesc{Rimuove una variabile di ambiente.} 
2148 }
2149 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore,
2150   nel qual caso \var{errno} assumerà uno dei valori:
2151   \begin{errlist}
2152   \item[\errcode{EINVAL}] \param{name} è \val{NULL} o una stringa di lunghezza
2153   nulla o che contiene il carattere ``\texttt{=}''.
2154 \end{errlist}}
2155 \end{funcproto}
2156
2157 La funzione richiede soltanto il nome della variabile di ambiente
2158 nell'argomento \param{name}, se la variabile non esiste la funzione ritorna
2159 comunque con un valore di successo.\footnote{questo con le versioni della
2160   \acr{glibc} successive la 2.2.2, per le precedenti \func{unsetenv} era
2161   definita come \texttt{void} e non restituiva nessuna informazione.}
2162
2163 L'ultima funzione per la gestione dell'ambiente è
2164 \funcd{clearenv},\footnote{che come accennato è l'unica non presente nello
2165   standard POSIX.1-2000, ed è disponibili solo per versioni della \acr{glibc}
2166   a partire dalla 2.0; per poterla utilizzare occorre aver definito le macro
2167   \macro{\_SVID\_SOURCE} e \macro{\_XOPEN\_SOURCE}.} che viene usata per
2168 cancellare completamente tutto l'ambiente; il suo prototipo è:
2169
2170 \begin{funcproto}{ 
2171 \fhead{stdlib.h}
2172 \fdecl{int clearenv(void)}
2173 \fdesc{Cancella tutto l'ambiente.} 
2174 }
2175 {La funzione ritorna $0$ in caso di successo e un valore diverso da zero per
2176   un errore.}
2177 \end{funcproto}
2178
2179 In genere si usa questa funzione in maniera precauzionale per evitare i
2180 problemi di sicurezza connessi nel trasmettere ai programmi che si invocano un
2181 ambiente che può contenere dei dati non controllati, le cui variabili possono
2182 causare effetti indesiderati. Con l'uso della funzione si provvede alla
2183 cancellazione di tutto l'ambiente originale in modo da poterne costruirne una
2184 versione ``\textsl{sicura}'' da zero.
2185
2186 \index{variabili!di~ambiente|)}
2187
2188
2189 % \subsection{La localizzazione}
2190 % \label{sec:proc_localization}
2191
2192 % Abbiamo accennato in sez.~\ref{sec:proc_environ} come la variabile di ambiente
2193 % \envvar{LANG} sia usata per indicare ai processi il valore della cosiddetta
2194 % \textsl{localizzazione}. Si tratta di una funzionalità fornita dalle librerie
2195 % di sistema\footnote{prenderemo in esame soltanto il caso della \acr{glibc}.}
2196 % che consente di gestire in maniera automatica sia la lingua in cui vengono
2197 % stampati i vari messaggi (come i messaggi associati agli errori che vedremo in
2198 % sez.~\ref{sec:sys_strerror}) che le convenzioni usate nei vari paesi per una
2199 % serie di aspetti come il formato dell'ora, quello delle date, gli ordinamenti
2200 % alfabetici, le espressioni della valute, ecc.
2201
2202 % Da finire.
2203
2204 % La localizzazione di un programma si può selezionare con la 
2205
2206 % In realtà perché un programma sia effettivamente localizzato non è sufficiente 
2207
2208 % TODO trattare, quando ci sarà tempo, setlocale ed il resto
2209
2210
2211 %\subsection{Opzioni in formato esteso}
2212 %\label{sec:proc_opt_extended}
2213
2214 %Oltre alla modalità ordinaria di gestione delle opzioni trattata in
2215 %sez.~\ref{sec:proc_opt_handling} le \acr{glibc} forniscono una modalità
2216 %alternativa costituita dalle cosiddette \textit{long-options}, che consente di
2217 %esprimere le opzioni in una forma più descrittiva che nel caso più generale è
2218 %qualcosa del tipo di ``\texttt{-{}-option-name=parameter}''.
2219
2220 %(NdA: questa parte verrà inserita in seguito).
2221
2222 % TODO opzioni in formato esteso
2223
2224 % TODO trattare il vettore ausiliario e getauxval (vedi
2225 % http://lwn.net/Articles/519085/)
2226
2227
2228 \section{Problematiche di programmazione generica}
2229 \label{sec:proc_gen_prog}
2230
2231 Benché questo non sia un libro sul linguaggio C, è opportuno affrontare alcune
2232 delle problematiche generali che possono emergere nella programmazione con
2233 questo linguaggio e di quali precauzioni o accorgimenti occorre prendere per
2234 risolverle. Queste problematiche non sono specifiche di sistemi unix-like o
2235 multitasking, ma avendo trattato in questo capitolo il comportamento dei
2236 processi visti come entità a sé stanti, le riportiamo qui.
2237
2238
2239 \subsection{Il passaggio di variabili e valori di ritorno nelle funzioni}
2240 \label{sec:proc_var_passing}
2241
2242 Una delle caratteristiche standard del C è che le variabili vengono passate
2243 alle funzioni che si invocano in un programma attraverso un meccanismo che
2244 viene chiamato \textit{by value}, diverso ad esempio da quanto avviene con il
2245 Fortran, dove le variabili sono passate, come suol dirsi, \textit{by
2246   reference}, o dal C++ dove la modalità del passaggio può essere controllata
2247 con l'operatore \cmd{\&}.
2248
2249 Il passaggio di una variabile \textit{by value} significa che in realtà quello
2250 che viene passato alla funzione è una copia del valore attuale di quella
2251 variabile, copia che la funzione potrà modificare a piacere, senza che il
2252 valore originale nella funzione chiamante venga toccato. In questo modo non
2253 occorre preoccuparsi di eventuali effetti delle operazioni svolte nella
2254 funzione stessa sulla variabile passata come argomento.
2255
2256 Questo però va inteso nella maniera corretta. Il passaggio \textit{by value}
2257 vale per qualunque variabile, puntatori compresi; quando però in una funzione
2258 si usano dei puntatori (ad esempio per scrivere in un buffer) in realtà si va
2259 a modificare la zona di memoria a cui essi puntano, per cui anche se i
2260 puntatori sono copie, i dati a cui essi puntano saranno sempre gli stessi, e
2261 le eventuali modifiche avranno effetto e saranno visibili anche nella funzione
2262 chiamante.
2263
2264 Nella maggior parte delle funzioni di libreria e delle \textit{system call} i
2265 puntatori vengono usati per scambiare dati (attraverso i buffer o le strutture
2266 a cui fanno riferimento) e le variabili normali vengono usate per specificare
2267 argomenti; in genere le informazioni a riguardo dei risultati vengono passate
2268 alla funzione chiamante attraverso il valore di ritorno.  È buona norma
2269 seguire questa pratica anche nella programmazione normale.
2270
2271 \itindbeg{value~result~argument}
2272
2273 Talvolta però è necessario che la funzione possa restituire indietro alla
2274 funzione chiamante un valore relativo ad uno dei suoi argomenti usato anche in
2275 ingresso.  Per far questo si usa il cosiddetto \textit{value result argument},
2276 si passa cioè, invece di una normale variabile, un puntatore alla stessa. Gli
2277 esempi di questa modalità di passaggio sono moltissimi, ad esempio essa viene
2278 usata nelle funzioni che gestiscono i socket (in
2279 sez.~\ref{sec:TCP_functions}), in cui, per permettere al kernel di restituire
2280 informazioni sulle dimensioni delle strutture degli indirizzi utilizzate,
2281 viene usato proprio questo meccanismo.
2282
2283 Occorre tenere ben presente questa differenza, perché le variabili passate in
2284 maniera ordinaria, che vengono inserite nello \textit{stack}, cessano di
2285 esistere al ritorno di una funzione, ed ogni loro eventuale modifica
2286 all'interno della stessa sparisce con la conclusione della stessa, per poter
2287 passare delle informazioni occorre quindi usare un puntatore che faccia
2288 riferimento ad un indirizzo accessibile alla funzione chiamante.
2289
2290 \itindend{value~result~argument}
2291
2292 Questo requisito di accessibilità è fondamentale, infatti dei possibili
2293 problemi che si possono avere con il passaggio dei dati è quello di restituire
2294 alla funzione chiamante dei dati che sono contenuti in una variabile
2295 automatica.  Ovviamente quando la funzione ritorna la sezione dello
2296 \textit{stack} che conteneva la variabile automatica (si ricordi quanto detto
2297 in sez.~\ref{sec:proc_mem_alloc}) verrà liberata automaticamente e potrà
2298 essere riutilizzata all'invocazione di un'altra funzione, con le immaginabili
2299 conseguenze, quasi invariabilmente catastrofiche, di sovrapposizione e
2300 sovrascrittura dei dati.
2301
2302 Per questo una delle regole fondamentali della programmazione in C è che
2303 all'uscita di una funzione non deve restare nessun riferimento alle sue
2304 variabili locali. Qualora sia necessario utilizzare delle variabili che devono
2305 essere viste anche dalla funzione chiamante queste devono essere allocate
2306 esplicitamente, o in maniera statica usando variabili globali o dichiarate
2307 come \direct{extern},\footnote{la direttiva \direct{extern} informa il
2308   compilatore che la variabile che si è dichiarata in una funzione non è da
2309   considerarsi locale, ma globale, e per questo allocata staticamente e
2310   visibile da tutte le funzioni dello stesso programma.} o dinamicamente con
2311 una delle funzioni della famiglia \func{malloc}, passando opportunamente il
2312 relativo puntatore fra le funzioni.
2313
2314
2315 \subsection{Il passaggio di un numero variabile di argomenti}
2316 \label{sec:proc_variadic}
2317
2318 \index{funzioni!\textit{variadic}|(}
2319
2320 Come vedremo nei capitoli successivi, non sempre è possibile specificare un
2321 numero fisso di argomenti per una funzione.  Lo standard ISO C prevede nella
2322 sua sintassi la possibilità di definire delle \textit{variadic function} che
2323 abbiano un numero variabile di argomenti, attraverso l'uso nella dichiarazione
2324 della funzione dello speciale costrutto ``\texttt{...}'', che viene chiamato
2325 \textit{ellipsis}.
2326
2327 Lo standard però non provvede a livello di linguaggio alcun meccanismo con cui
2328 dette funzioni possono accedere ai loro argomenti.  L'accesso viene pertanto
2329 realizzato a livello della libreria standard del C che fornisce gli strumenti
2330 adeguati.  L'uso di una \textit{variadic function} prevede quindi tre punti:
2331 \begin{itemize*}
2332 \item \textsl{dichiarare} la funzione come \textit{variadic} usando un
2333   prototipo che contenga una \textit{ellipsis};
2334 \item \textsl{definire} la funzione come \textit{variadic} usando la stessa
2335   \textit{ellipsis}, ed utilizzare le apposite macro che consentono la
2336   gestione di un numero variabile di argomenti;
2337 \item \textsl{invocare} la funzione specificando prima gli argomenti fissi, ed
2338   a seguire quelli addizionali.
2339 \end{itemize*}
2340
2341 Lo standard ISO C prevede che una \textit{variadic function} abbia sempre
2342 almeno un argomento fisso. Prima di effettuare la dichiarazione deve essere
2343 incluso l'apposito \textit{header file} \headfile{stdarg.h}; un esempio di
2344 dichiarazione è il prototipo della funzione \func{execl} che vedremo in
2345 sez.~\ref{sec:proc_exec}:
2346 \includecodesnip{listati/exec_sample.c}
2347 in questo caso la funzione prende due argomenti fissi ed un numero variabile
2348 di altri argomenti, che andranno a costituire gli elementi successivi al primo
2349 del vettore \param{argv} passato al nuovo processo. Lo standard ISO C richiede
2350 inoltre che l'ultimo degli argomenti fissi sia di tipo
2351 \textit{self-promoting}\footnote{il linguaggio C prevede che quando si
2352   mescolano vari tipi di dati, alcuni di essi possano essere \textsl{promossi}
2353   per compatibilità; ad esempio i tipi \ctyp{float} vengono convertiti
2354   automaticamente a \ctyp{double} ed i \ctyp{char} e gli \ctyp{short} ad
2355   \ctyp{int}. Un tipo \textit{self-promoting} è un tipo che verrebbe promosso
2356   a sé stesso.} il che esclude vettori, puntatori a funzioni e interi di tipo
2357 \ctyp{char} o \ctyp{short} (con segno o meno). Una restrizione ulteriore di
2358 alcuni compilatori è di non dichiarare l'ultimo argomento fisso come variabile
2359 di tipo \direct{register}.\footnote{la direttiva \direct{register} del
2360   compilatore chiede che la variabile dichiarata tale sia mantenuta, nei
2361   limiti del possibile, all'interno di un registro del processore; questa
2362   direttiva è originaria dell'epoca dai primi compilatori, quando stava al
2363   programmatore scrivere codice ottimizzato, riservando esplicitamente alle
2364   variabili più usate l'uso dei registri del processore, oggi questa direttiva
2365   è in disuso pressoché completo dato che tutti i compilatori sono normalmente
2366   in grado di valutare con maggior efficacia degli stessi programmatori quando
2367   sia il caso di eseguire questa ottimizzazione.}
2368
2369 Una volta dichiarata la funzione il secondo passo è accedere ai vari argomenti
2370 quando la si va a definire. Gli argomenti fissi infatti hanno un loro nome, ma
2371 quelli variabili vengono indicati in maniera generica dalla
2372 \textit{ellipsis}. L'unica modalità in cui essi possono essere recuperati è
2373 pertanto quella sequenziale, in cui vengono estratti dallo \textit{stack}
2374 secondo l'ordine in cui sono stati scritti nel prototipo della funzione.
2375
2376 \macrobeg{va\_start}
2377
2378 Per fare questo in \headfile{stdarg.h} sono definite delle macro specifiche,
2379 previste dallo standard ISO C89, che consentono di eseguire questa operazione.
2380 La prima di queste macro è \macro{va\_start}, che inizializza opportunamente
2381 una lista degli argomenti, la sua definizione è:
2382
2383 {\centering
2384 \begin{funcbox}{ 
2385 \fhead{stdarg.h}
2386 \fdecl{void va\_start(va\_list ap, last)}
2387 \fdesc{Inizializza una lista degli argomenti di una funzione
2388   \textit{variadic}.} 
2389 }
2390 \end{funcbox}}
2391
2392 La macro inizializza il puntatore alla lista di argomenti \param{ap} che
2393 deve essere una apposita variabile di tipo \type{va\_list}; il
2394 parametro \param{last} deve indicare il nome dell'ultimo degli argomenti fissi
2395 dichiarati nel prototipo della funzione \textit{variadic}. 
2396
2397 \macrobeg{va\_arg}
2398
2399 La seconda macro di gestione delle liste di argomenti di una funzione
2400 \textit{variadic} è \macro{va\_arg}, che restituisce in successione un
2401 argomento della lista; la sua definizione è:
2402
2403 {\centering
2404 \begin{funcbox}{ 
2405 \fhead{stdarg.h}
2406 \fdecl{type va\_arg(va\_list ap, type)}
2407 \fdesc{Restituisce il valore del successivo argomento opzionale.} 
2408 }
2409 \end{funcbox}}
2410  
2411 La macro restituisce il valore di un argomento, modificando opportunamente la
2412 lista \param{ap} perché una chiamata successiva restituisca l'argomento
2413 seguente. La macro richiede che si specifichi il tipo dell'argomento che si
2414 andrà ad estrarre attraverso il parametro \param{type} che sarà anche il tipo
2415 del valore da essa restituito. Si ricordi che il tipo deve essere
2416 \textit{self-promoting}.
2417
2418 In generale è perfettamente legittimo richiedere meno argomenti di quelli che
2419 potrebbero essere stati effettivamente forniti, per cui nella esecuzione delle
2420 \macro{va\_arg} ci si può fermare in qualunque momento ed i restanti argomenti
2421 saranno ignorati. Se invece si richiedono più argomenti di quelli
2422 effettivamente forniti si otterranno dei valori indefiniti. Si avranno
2423 risultati indefiniti anche quando si chiama \macro{va\_arg} specificando un
2424 tipo che non corrisponde a quello usato per il corrispondente argomento.
2425
2426 \macrobeg{va\_end}
2427
2428 Infine una volta completata l'estrazione occorre indicare che si sono concluse
2429 le operazioni con la macro \macrod{va\_end}, la cui definizione è:
2430
2431 {\centering
2432 \begin{funcbox}{ 
2433 \fhead{stdarg.h}
2434 \fdecl{void va\_end(va\_list ap)}
2435 \fdesc{Conclude l'estrazione degli argomenti di una funzione
2436   \textit{variadic}.} 
2437 }
2438 \end{funcbox}}
2439  
2440 Dopo l'uso di \macro{va\_end} la variabile \param{ap} diventa indefinita e
2441 successive chiamate a \macro{va\_arg} non funzioneranno.  Nel caso del
2442 \cmd{gcc} l'uso di \macro{va\_end} può risultare inutile, ma è comunque
2443 necessario usarla per chiarezza del codice, per compatibilità con diverse
2444 implementazioni e per eventuali eventuali modifiche future a questo
2445 comportamento.
2446
2447 Riassumendo la procedura da seguire per effettuare l'estrazione degli
2448 argomenti di una funzione \textit{variadic} è la seguente:
2449 \begin{enumerate*}
2450 \item inizializzare una lista degli argomenti attraverso la macro
2451   \macro{va\_start};
2452 \item accedere agli argomenti con chiamate successive alla macro
2453   \macro{va\_arg}: la prima chiamata restituirà il primo argomento, la seconda
2454   il secondo e così via;
2455 \item dichiarare la conclusione dell'estrazione degli argomenti invocando la
2456   macro \macro{va\_end}.
2457 \end{enumerate*}
2458
2459 Si tenga presente che si possono usare anche più liste degli argomenti,
2460 ciascuna di esse andrà inizializzata con \macro{va\_start} e letta con
2461 \macro{va\_arg}, e ciascuna potrà essere usata per scandire la lista degli
2462 argomenti in modo indipendente. Infine ciascuna scansione dovrà essere
2463 terminata con \macro{va\_end}.
2464
2465 Un limite di queste macro è che i passi 1) e 3) devono essere eseguiti nel
2466 corpo principale della funzione, il passo 2) invece può essere eseguito anche
2467 in un'altra funzione, passandole lista degli argomenti \param{ap}. In questo
2468 caso però al ritorno della funzione \macro{va\_arg} non può più essere usata
2469 (anche se non si era completata l'estrazione) dato che il valore di \param{ap}
2470 risulterebbe indefinito.
2471
2472 \macroend{va\_start}
2473 \macroend{va\_arg}
2474 \macroend{va\_end}
2475
2476 Esistono dei casi in cui è necessario eseguire più volte la scansione degli
2477 argomenti e poter memorizzare una posizione durante la stessa. In questo caso
2478 sembrerebbe naturale copiarsi la lista degli argomenti \param{ap} con una
2479 semplice assegnazione ad un'altra variabile dello stesso tipo. Dato che una
2480 delle realizzazioni più comuni di \type{va\_list} è quella di un puntatore
2481 nello \textit{stack} all'indirizzo dove sono stati salvati gli argomenti, è
2482 assolutamente normale pensare di poter effettuare questa operazione.
2483
2484 \index{tipo!opaco|(}
2485
2486 In generale però possono esistere anche realizzazioni diverse, ed è per questo
2487 motivo che invece che di un semplice puntatore viene \type{va\_list} è quello
2488 che viene chiamato un \textsl{tipo opaco}. Si chiamano così quei tipi di dati,
2489 in genere usati da una libreria, la cui struttura interna non deve essere
2490 vista dal programma chiamante (da cui deriva il nome opaco) che li devono
2491 utilizzare solo attraverso dalle opportune funzioni di gestione.
2492
2493 \index{tipo!opaco|)}
2494
2495 Per questo motivo una variabile di tipo \type{va\_list} non può essere
2496 assegnata direttamente ad un'altra variabile dello stesso tipo, ma lo standard
2497 ISO C99\footnote{alcuni sistemi che non hanno questa macro provvedono al suo
2498   posto \macrod{\_\_va\_copy} che era il nome proposto in una bozza dello
2499   standard.}  ha previsto una macro ulteriore che permette di eseguire la
2500 copia di una lista degli argomenti:
2501
2502 {\centering
2503 \begin{funcbox}{ 
2504 \fhead{stdarg.h}
2505 \fdecl{void va\_copy(va\_list dest, va\_list src)}
2506 \fdesc{Copia la lista degli argomenti di una funzione \textit{variadic}.} 
2507 }
2508 \end{funcbox}}
2509
2510 La macro copia l'attuale della lista degli argomenti \param{src} su una nuova
2511 lista \param{dest}. Anche in questo caso è buona norma chiudere ogni
2512 esecuzione di una \macrod{va\_copy} con una corrispondente \macro{va\_end} sul
2513 nuovo puntatore alla lista degli argomenti.
2514
2515 La chiamata di una funzione con un numero variabile di argomenti, posto che la
2516 si sia dichiarata e definita come tale, non prevede nulla di particolare;
2517 l'invocazione è identica alle altre, con gli argomenti, sia quelli fissi che
2518 quelli opzionali, separati da virgole. Quello che però è necessario tenere
2519 presente è come verranno convertiti gli argomenti variabili.
2520
2521 In Linux gli argomenti dello stesso tipo sono passati allo stesso modo, sia
2522 che siano fissi sia che siano opzionali (alcuni sistemi trattano diversamente
2523 gli opzionali), ma dato che il prototipo non può specificare il tipo degli
2524 argomenti opzionali, questi verranno sempre promossi, pertanto nella ricezione
2525 dei medesimi occorrerà tenerne conto (ad esempio un \ctyp{char} verrà visto da
2526 \macro{va\_arg} come \ctyp{int}).
2527
2528 Un altro dei problemi che si devono affrontare con le funzioni con un numero
2529 variabile di argomenti è che non esiste un modo generico che permetta di
2530 stabilire quanti sono gli argomenti effettivamente passati in una chiamata.
2531
2532 Esistono varie modalità per affrontare questo problema; una delle più
2533 immediate è quella di specificare il numero degli argomenti opzionali come uno
2534 degli argomenti fissi. Una variazione di questo metodo è l'uso di un argomento
2535 fisso per specificare anche il tipo degli argomenti variabili, come fa la
2536 stringa di formato per \func{printf} (vedi sez.~\ref{sec:file_formatted_io}).
2537
2538 Infine una ulteriore modalità diversa, che può essere applicata solo quando il
2539 tipo degli argomenti lo rende possibile, è quella che prevede di usare un
2540 valore speciale per l'ultimo argomento, come fa ad esempio \func{execl} che
2541 usa un puntatore \val{NULL} per indicare la fine della lista degli argomenti
2542 (vedi sez.~\ref{sec:proc_exec}).
2543
2544 \index{funzioni!\textit{variadic}|)}
2545
2546 \subsection{Il controllo di flusso non locale}
2547 \label{sec:proc_longjmp}
2548
2549 Il controllo del flusso di un programma in genere viene effettuato con le
2550 varie istruzioni del linguaggio C; fra queste la più bistrattata è il
2551 \instruction{goto}, che viene deprecato in favore dei costrutti della
2552 programmazione strutturata, che rendono il codice più leggibile e
2553 mantenibile. Esiste però un caso in cui l'uso di questa istruzione porta
2554 all'implementazione più efficiente e più chiara anche dal punto di vista della
2555 struttura del programma: quello dell'uscita in caso di errore.
2556
2557 \index{salto~non-locale|(} 
2558
2559 Il C però non consente di effettuare un salto ad una etichetta definita in
2560 un'altra funzione, per cui se l'errore avviene in una funzione, e la sua
2561 gestione ordinaria è in un'altra, occorre usare quello che viene chiamato un
2562 \textsl{salto non-locale}.  Il caso classico in cui si ha questa necessità,
2563 citato sia in \cite{APUE} che in \cite{GlibcMan}, è quello di un programma nel
2564 cui corpo principale vengono letti dei dati in ingresso sui quali viene
2565 eseguita, tramite una serie di funzioni di analisi, una scansione dei
2566 contenuti, da cui si ottengono le indicazioni per l'esecuzione di opportune
2567 operazioni.
2568
2569 Dato che l'analisi può risultare molto complessa, ed opportunamente suddivisa
2570 in fasi diverse, la rilevazione di un errore nei dati in ingresso può accadere
2571 all'interno di funzioni profondamente annidate l'una nell'altra. In questo
2572 caso si dovrebbe gestire, per ciascuna fase, tutta la casistica del passaggio
2573 all'indietro di tutti gli errori rilevabili dalle funzioni usate nelle fasi
2574 successive.  Questo comporterebbe una notevole complessità, mentre sarebbe
2575 molto più comodo poter tornare direttamente al ciclo di lettura principale,
2576 scartando l'input come errato.\footnote{a meno che, come precisa
2577   \cite{GlibcMan}, alla chiusura di ciascuna fase non siano associate
2578   operazioni di pulizia specifiche (come deallocazioni, chiusure di file,
2579   ecc.), che non potrebbero essere eseguite con un salto non-locale.}
2580
2581 Tutto ciò può essere realizzato proprio con un salto non-locale; questo di
2582 norma viene realizzato salvando il contesto dello \textit{stack} nel punto in
2583 cui si vuole tornare in caso di errore, e ripristinandolo, in modo da tornare
2584 quando serve nella funzione da cui si era partiti.  La funzione che permette
2585 di salvare il contesto dello \textit{stack} è \funcd{setjmp}, il cui prototipo
2586 è:
2587
2588 \begin{funcproto}{ 
2589 \fhead{setjmp.h}
2590 \fdecl{int setjmp(jmp\_buf env)}
2591 \fdesc{Salva il contesto dello \textit{stack}.} 
2592 }
2593 {La funzione ritorna $0$ quando è chiamata direttamente ed un valore diverso
2594   da zero quando ritorna da una chiamata di \func{longjmp} che usa il contesto
2595   salvato in precedenza.}
2596 \end{funcproto}
2597   
2598 Quando si esegue la funzione il contesto corrente dello \textit{stack} viene
2599 salvato nell'argomento \param{env}, una variabile di tipo
2600 \type{jmp\_buf}\footnote{anche questo è un classico esempio di variabile di
2601   \textsl{tipo opaco}.}  che deve essere stata definita in precedenza. In
2602 genere le variabili di tipo \type{jmp\_buf} vengono definite come variabili
2603 globali in modo da poter essere viste in tutte le funzioni del programma.
2604
2605 Quando viene eseguita direttamente la funzione ritorna sempre zero, un valore
2606 diverso da zero viene restituito solo quando il ritorno è dovuto ad una
2607 chiamata di \func{longjmp} in un'altra parte del programma che ripristina lo
2608 \textit{stack} effettuando il salto non-locale. Si tenga conto che il contesto
2609 salvato in \param{env} viene invalidato se la funzione che ha chiamato
2610 \func{setjmp} ritorna, nel qual caso un successivo uso di \func{longjmp} può
2611 comportare conseguenze imprevedibili (e di norma fatali) per il processo.
2612   
2613 Come accennato per effettuare un salto non-locale ad un punto precedentemente
2614 stabilito con \func{setjmp} si usa la funzione \funcd{longjmp}; il suo
2615 prototipo è:
2616
2617 \begin{funcproto}{ 
2618 \fhead{setjmp.h}
2619 \fdecl{void longjmp(jmp\_buf env, int val)}
2620 \fdesc{Ripristina il contesto dello stack.} 
2621 }
2622 {La funzione non ritorna.}   
2623 \end{funcproto}
2624
2625 La funzione ripristina il contesto dello \textit{stack} salvato da una
2626 chiamata a \func{setjmp} nell'argomento \param{env}. Dopo l'esecuzione della
2627 funzione il programma prosegue nel codice successivo alla chiamata della
2628 \func{setjmp} con cui si era salvato \param{env}, che restituirà il valore
2629 dell'argomento \param{val} invece di zero.  Il valore
2630 dell'argomento \param{val} deve essere sempre diverso da zero, se si è
2631 specificato 0 sarà comunque restituito 1 al suo posto.
2632
2633 In sostanza l'esecuzione di \func{longjmp} è analoga a quella di una
2634 istruzione \instr{return}, solo che invece di ritornare alla riga
2635 successiva della funzione chiamante, il programma in questo caso ritorna alla
2636 posizione della relativa \func{setjmp}. L'altra differenza fondamentale con
2637 \instr{return} è che il ritorno può essere effettuato anche attraverso
2638 diversi livelli di funzioni annidate.
2639
2640 L'implementazione di queste funzioni comporta alcune restrizioni dato che esse
2641 interagiscono direttamente con la gestione dello \textit{stack} ed il
2642 funzionamento del compilatore stesso. In particolare \func{setjmp} è
2643 implementata con una macro, pertanto non si può cercare di ottenerne
2644 l'indirizzo, ed inoltre le chiamate a questa funzione sono sicure solo in uno
2645 dei seguenti casi:
2646 \begin{itemize*}
2647 \item come espressione di controllo in un comando condizionale, di selezione o
2648   di iterazione (come \instruction{if}, \instruction{switch} o
2649   \instruction{while});
2650 \item come operando per un operatore di uguaglianza o confronto in una
2651   espressione di controllo di un comando condizionale, di selezione o di
2652   iterazione;
2653 \item come operando per l'operatore di negazione (\code{!}) in una espressione
2654   di controllo di un comando condizionale, di selezione o di iterazione;
2655 \item come espressione a sé stante.
2656 \end{itemize*}
2657
2658 In generale, dato che l'unica differenza fra la chiamata diretta e quella
2659 ottenuta nell'uscita con un \func{longjmp} è costituita dal valore di ritorno
2660 di \func{setjmp}, pertanto quest'ultima viene usualmente chiamata all'interno
2661 di un una istruzione \instr{if} che permetta di distinguere i due casi.
2662
2663 Uno dei punti critici dei salti non-locali è quello del valore delle
2664 variabili, ed in particolare quello delle variabili automatiche della funzione
2665 a cui si ritorna. In generale le variabili globali e statiche mantengono i
2666 valori che avevano al momento della chiamata di \func{longjmp}, ma quelli
2667 delle variabili automatiche (o di quelle dichiarate \dirct{register}) sono in
2668 genere indeterminati.
2669
2670 Quello che succede infatti è che i valori delle variabili che sono tenute in
2671 memoria manterranno il valore avuto al momento della chiamata di
2672 \func{longjmp}, mentre quelli tenuti nei registri del processore (che nella
2673 chiamata ad un'altra funzione vengono salvati nel contesto nello
2674 \textit{stack}) torneranno al valore avuto al momento della chiamata di
2675 \func{setjmp}; per questo quando si vuole avere un comportamento coerente si
2676 può bloccare l'ottimizzazione che porta le variabili nei registri
2677 dichiarandole tutte come \direct{volatile}.\footnote{la direttiva
2678   \direct{volatile} informa il compilatore che la variabile che è dichiarata
2679   può essere modificata, durante l'esecuzione del nostro, da altri programmi.
2680   Per questo motivo occorre dire al compilatore che non deve essere mai
2681   utilizzata l'ottimizzazione per cui quanto opportuno essa viene mantenuta in
2682   un registro, poiché in questo modo si perderebbero le eventuali modifiche
2683   fatte dagli altri programmi (che avvengono solo in una copia posta in
2684   memoria).}
2685
2686 \index{salto~non-locale|)}
2687
2688
2689 \subsection{La \textit{endianness}}
2690 \label{sec:endianness}
2691
2692 \itindbeg{endianness} 
2693
2694 Un altro dei problemi di programmazione che può dar luogo ad effetti
2695 imprevisti è quello relativo alla cosiddetta \textit{endianness}.  Questa è una
2696 caratteristica generale dell'architettura hardware di un computer che dipende
2697 dal fatto che la rappresentazione di un numero binario può essere fatta in due
2698 modi, chiamati rispettivamente \textit{big endian} e \textit{little endian} a
2699 seconda di come i singoli bit vengono aggregati per formare le variabili
2700 intere (ed in genere in diretta corrispondenza a come sono poi in realtà
2701 cablati sui bus interni del computer).
2702
2703 \begin{figure}[!htb]
2704   \centering \includegraphics[height=3cm]{img/endianness}
2705   \caption{Schema della disposizione dei dati in memoria a seconda della
2706     \textit{endianness}.}
2707   \label{fig:sock_endianness}
2708 \end{figure}
2709
2710 Per capire meglio il problema si consideri un intero a 32 bit scritto in una
2711 locazione di memoria posta ad un certo indirizzo. Come illustrato in
2712 fig.~\ref{fig:sock_endianness} i singoli bit possono essere disposti in memoria
2713 in due modi: a partire dal più significativo o a partire dal meno
2714 significativo.  Così nel primo caso si troverà il byte che contiene i bit più
2715 significativi all'indirizzo menzionato e il byte con i bit meno significativi
2716 nell'indirizzo successivo; questo ordinamento è detto \textit{big endian},
2717 dato che si trova per prima la parte più grande. Il caso opposto, in cui si
2718 parte dal bit meno significativo è detto per lo stesso motivo \textit{little
2719   endian}.
2720
2721 Si può allora verificare quale tipo di \textit{endianness} usa il proprio
2722 computer con un programma elementare che si limita ad assegnare un valore ad
2723 una variabile per poi ristamparne il contenuto leggendolo un byte alla volta.
2724 Il codice di detto programma, \file{endtest.c}, è nei sorgenti allegati,
2725 allora se lo eseguiamo su un normale PC compatibile, che è \textit{little
2726   endian} otterremo qualcosa del tipo:
2727 \begin{Console}
2728 [piccardi@gont sources]$ \textbf{./endtest}
2729 Using value ABCDEF01
2730 val[0]= 1
2731 val[1]=EF
2732 val[2]=CD
2733 val[3]=AB
2734 \end{Console}
2735 %$
2736 mentre su un vecchio Macintosh con PowerPC, che è \textit{big endian} avremo
2737 qualcosa del tipo:
2738 \begin{Console}
2739 piccardi@anarres:~/gapil/sources$ \textbf{./endtest}
2740 Using value ABCDEF01
2741 val[0]=AB
2742 val[1]=CD
2743 val[2]=EF
2744 val[3]= 1
2745 \end{Console}
2746 %$
2747
2748 L'attenzione alla \textit{endianness} nella programmazione è importante, perché
2749 se si fanno assunzioni relative alla propria architettura non è detto che
2750 queste restino valide su un'altra architettura. Inoltre, come vedremo ad
2751 esempio in sez.~\ref{sec:sock_addr_func}, si possono avere problemi quando ci
2752 si trova a usare valori di un formato con una infrastruttura che ne usa
2753 un altro. 
2754
2755 La \textit{endianness} di un computer dipende essenzialmente dalla architettura
2756 hardware usata; Intel e Digital usano il \textit{little endian}, Motorola,
2757 IBM, Sun (sostanzialmente tutti gli altri) usano il \textit{big endian}. Il
2758 formato dei dati contenuti nelle intestazioni dei protocolli di rete (il
2759 cosiddetto \textit{network order}) è anch'esso \textit{big endian}; altri
2760 esempi di uso di questi due diversi formati sono quello del bus PCI, che è
2761 \textit{little endian}, o quello del bus VME che è \textit{big endian}.
2762
2763 Esistono poi anche dei processori che possono scegliere il tipo di formato
2764 all'avvio e alcuni che, come il PowerPC o l'Intel i860, possono pure passare
2765 da un tipo di ordinamento all'altro con una specifica istruzione. In ogni caso
2766 in Linux l'ordinamento è definito dall'architettura e dopo l'avvio del sistema
2767 in genere resta sempre lo stesso,\footnote{su architettura PowerPC è possibile
2768   cambiarlo, si veda sez.~\ref{sec:process_prctl}.} anche quando il processore
2769 permetterebbe di eseguire questi cambiamenti.
2770
2771 \begin{figure}[!htbp]
2772   \footnotesize \centering
2773   \begin{minipage}[c]{\codesamplewidth}
2774     \includecodesample{listati/endian.c}
2775   \end{minipage} 
2776   \normalsize
2777   \caption{La funzione \samplefunc{endian}, usata per controllare il tipo di
2778     architettura della macchina.}
2779   \label{fig:sock_endian_code}
2780 \end{figure}
2781
2782 Per controllare quale tipo di ordinamento si ha sul proprio computer si è
2783 scritta una piccola funzione di controllo, il cui codice è riportato
2784 fig.~\ref{fig:sock_endian_code}, che restituisce un valore nullo (falso) se
2785 l'architettura è \textit{big endian} ed uno non nullo (vero) se l'architettura
2786 è \textit{little endian}.
2787
2788 Come si vede la funzione è molto semplice, e si limita, una volta assegnato
2789 (\texttt{\small 9}) un valore di test pari a \texttt{0xABCD} ad una variabile
2790 di tipo \ctyp{short} (cioè a 16 bit), a ricostruirne una copia byte a byte.
2791 Per questo prima (\texttt{\small 10}) si definisce il puntatore \var{ptr} per
2792 accedere al contenuto della prima variabile, ed infine calcola (\texttt{\small
2793   11}) il valore della seconda assumendo che il primo byte sia quello meno
2794 significativo (cioè, per quanto visto in fig.~\ref{fig:sock_endianness}, che sia
2795 \textit{little endian}). Infine la funzione restituisce (\texttt{\small 12})
2796 il valore del confronto delle due variabili. 
2797
2798 In generale non ci si deve preoccupare della \textit{endianness} all'interno
2799 di un programma fintanto che questo non deve generare o manipolare dei dati
2800 che sono scambiati con altre macchine, ad esempio tramite via rete o tramite
2801 dei file binari. Nel primo caso la scelta è già stata fatta nella
2802 standardizzazione dei protocolli, che hanno adottato il \textit{big endian}
2803 (che viene detto anche per questo \textit{network order} e vedremo in
2804 sez.~\ref{sec:sock_func_ord} le funzioni di conversione che devono essere
2805 usate.
2806
2807 Nel secondo caso occorre sapere quale \textit{endianness} è stata usata nei
2808 dati memorizzati sul file e tenerne conto nella rilettura e nella
2809 manipolazione e relativa modifica (e salvataggio). La gran parte dei formati
2810 binari standardizzati specificano quale \textit{endianness} viene utilizzata e
2811 basterà identificare qual'è, se se ne deve definire uno per i propri scopi
2812 basterà scegliere una volta per tutte quale usare e attenersi alla scelta.
2813
2814 \itindend{endianness}
2815
2816
2817 % LocalWords:  like exec kernel thread main ld linux static linker char envp Gb
2818 % LocalWords:  sez POSIX exit system call cap abort shell diff errno stdlib int
2819 % LocalWords:  SUCCESS FAILURE void atexit stream fclose unistd descriptor init
2820 % LocalWords:  SIGCHLD wait function glibc SunOS arg argp execve fig high kb Mb
2821 % LocalWords:  memory alpha swap table printf Unit MMU paging fault SIGSEGV BSS
2822 % LocalWords:  multitasking text segment NULL Block Started Symbol fill black
2823 % LocalWords:  heap stack calling convention size malloc calloc realloc nmemb
2824 % LocalWords:  ENOMEM ptr uClib cfree error leak smartpointers hook Dmalloc brk
2825 % LocalWords:  Gray Watson Electric Fence Bruce Perens sbrk longjmp SUSv BSD ap
2826 % LocalWords:  ptrdiff increment locking lock copy write capabilities IPC mlock
2827 % LocalWords:  capability MEMLOCK limits getpagesize RLIMIT munlock sys const
2828 % LocalWords:  addr len EINVAL EPERM mlockall munlockall flags l'OR CURRENT IFS
2829 % LocalWords:  argc argv parsing questofile txt getopt optstring switch optarg
2830 % LocalWords:  optind opterr optopt POSIXLY CORRECT long options NdA
2831 % LocalWords:  option parameter list environ PATH HOME XPG tab LOGNAME LANG PWD
2832 % LocalWords:  TERM PAGER TMPDIR getenv name SVr setenv unsetenv putenv opz gcc
2833 % LocalWords:  clearenv libc value overwrite string reference result argument
2834 % LocalWords:  socket variadic ellipsis header stdarg execl self promoting last
2835 % LocalWords:  float double short register type dest src extern setjmp jmp buf
2836 % LocalWords:  env return if while Di page cdecl  rectangle node anchor west PS
2837 % LocalWords:  environment rounded corners dashed south width height draw east
2838 % LocalWords:  exithandler handler violation inline SOURCE SVID XOPEN mincore
2839 % LocalWords:  length unsigned vec EFAULT EAGAIN dell'I memalign valloc posix
2840 % LocalWords:  boundary memptr alignment sizeof overrun mcheck abortfn enum big
2841 % LocalWords:  mprobe DISABLED HEAD TAIL touch right emacs OSTYPE endianness IBM
2842 % LocalWords:  endian little endtest Macintosh PowerPC Intel Digital Motorola
2843 % LocalWords:  Sun order VME  loader Windows DLL shared objects PRELOAD termios
2844 % LocalWords:  is to LC SIG str mem wcs assert ctype dirent fcntl signal stdio
2845 % LocalWords:  times library utmp syscall number Filesystem Hierarchy pathname
2846 % LocalWords:  context assembler sysconf fork Dinamic huge segmentation program
2847 % LocalWords:  break  store Using
2848
2849 %%% Local Variables: 
2850 %%% mode: latex
2851 %%% TeX-master: "gapil"
2852 %%% End: