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