3 %% Copyright (C) 2004-2018 Simone Piccardi. Permission is granted to
4 %% copy, distribute and/or modify this document under the terms of the GNU Free
5 %% Documentation License, Version 1.1 or any later version published by the
6 %% Free Software Foundation; with the Invariant Sections being "Prefazione",
7 %% with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the
8 %% license is included in the section entitled "GNU Free Documentation
12 \chapter{La gestione dei socket}
13 \label{cha:sock_generic_management}
15 Esamineremo in questo capitolo una serie di funzionalità aggiuntive relative
16 alla gestione dei socket, come la gestione della risoluzione di nomi e
17 indirizzi, le impostazioni delle varie proprietà ed opzioni relative ai
18 socket, e le funzioni di controllo che permettono di modificarne il
22 \section{La risoluzione dei nomi}
23 \label{sec:sock_name_resolution}
25 Negli esempi dei capitoli precedenti abbiamo sempre identificato le singole
26 macchine attraverso indirizzi numerici, sfruttando al più le funzioni di
27 conversione elementare illustrate in sez.~\ref{sec:sock_addr_func} che
28 permettono di passare da un indirizzo espresso in forma \textit{dotted
29 decimal} ad un numero. Vedremo in questa sezione le funzioni utilizzate per
30 poter utilizzare dei nomi simbolici al posto dei valori numerici, e viceversa
31 quelle che permettono di ottenere i nomi simbolici associati ad indirizzi,
32 porte o altre proprietà del sistema.
35 \subsection{La struttura del \textit{resolver}}
36 \label{sec:sock_resolver}
38 \itindbeg{resolver} La risoluzione dei nomi è associata tradizionalmente al
39 servizio del \itindex{Domain~Name~Service} \textit{Domain Name Service} che
40 permette di identificare le macchine su internet invece che per numero IP
41 attraverso il relativo \textsl{nome a dominio}.\footnote{non staremo ad
42 entrare nei dettagli della definizione di cosa è un nome a dominio, dandolo
43 per noto, una introduzione alla problematica si trova in \cite{AGL} (cap.~9)
44 mentre per una trattazione approfondita di tutte le problematiche relative
45 al DNS si può fare riferimento a \cite{DNSbind}.} In realtà per DNS si
46 intendono spesso i server che forniscono su internet questo servizio, mentre
47 nel nostro caso affronteremo la problematica dal lato client, di un qualunque
48 programma che necessita di compiere questa operazione.
51 \centering \includegraphics[width=11cm]{img/resolver}
52 \caption{Schema di funzionamento delle funzioni del \textit{resolver}.}
53 \label{fig:sock_resolver_schema}
56 Inoltre quella fra nomi a dominio e indirizzi IP non è l'unica corrispondenza
57 possibile fra nomi simbolici e valori numerici, come abbiamo visto anche in
58 sez.~\ref{sec:sys_user_group} per le corrispondenze fra nomi di utenti e
59 gruppi e relativi identificatori numerici; per quanto riguarda però tutti i
60 nomi associati a identificativi o servizi relativi alla rete il servizio di
61 risoluzione è gestito in maniera unificata da un insieme di funzioni fornite
62 con le librerie del C, detto appunto \textit{resolver}.
64 Lo schema di funzionamento del \textit{resolver} è illustrato in
65 fig.~\ref{fig:sock_resolver_schema}; in sostanza i programmi hanno a
66 disposizione un insieme di funzioni di libreria con cui chiamano il
67 \textit{resolver}, indicate con le frecce nere. Ricevuta la richiesta è
68 quest'ultimo che, sulla base della sua configurazione, esegue le operazioni
69 necessarie a fornire la risposta, che possono essere la lettura delle
70 informazioni mantenute nei relativi dei file statici presenti sulla macchina,
71 una interrogazione ad un DNS (che a sua volta, per il funzionamento del
72 protocollo, può interrogarne altri) o la richiesta ad altri server per i quali
73 sia fornito il supporto, come LDAP.\footnote{la sigla LDAP fa riferimento ad
74 un protocollo, il \textit{Lightweight Directory Access Protocol}, che
75 prevede un meccanismo per la gestione di \textsl{elenchi} di informazioni
76 via rete; il contenuto di un elenco può essere assolutamente generico, e
77 questo permette il mantenimento dei più vari tipi di informazioni su una
78 infrastruttura di questo tipo.}
80 La configurazione del \textit{resolver} attiene più alla amministrazione di
81 sistema che alla programmazione, ciò non di meno, prima di trattare le varie
82 funzioni di librerie utilizzate dai programmi, vale la pena fare una
83 panoramica generale. Originariamente la configurazione del \textit{resolver}
84 riguardava esclusivamente le questioni relative alla gestione dei nomi a
85 dominio, e prevedeva solo l'utilizzo del DNS e del file statico
86 \conffile{/etc/hosts}.
88 Per questo aspetto il file di configurazione principale del sistema è
89 \conffile{/etc/resolv.conf} che contiene in sostanza l'elenco degli indirizzi
90 IP dei server DNS da contattare; a questo si affiancava (fino alle \acr{glibc}
91 2.4) il file \conffile{/etc/host.conf} il cui scopo principale era indicare
92 l'ordine in cui eseguire la risoluzione dei nomi (se usare prima i valori di
93 \conffile{/etc/hosts} o quelli del DNS). Tralasciamo i dettagli relativi alle
94 varie direttive che possono essere usate in questi file, che si trovano nelle
95 rispettive pagine di manuale.
97 Con il tempo però è divenuto possibile fornire diversi sostituti per
98 l'utilizzo delle associazione statiche in \conffile{/etc/hosts}, inoltre oltre
99 alla risoluzione dei nomi a dominio ci sono anche altri nomi da risolvere,
100 come quelli che possono essere associati ad una rete (invece che ad una
101 singola macchina) o ai gruppi di macchine definiti dal servizio
102 NIS,\footnote{il \textit{Network Information Service} è un servizio, creato da
103 Sun, e poi diffuso su tutte le piattaforme unix-like, che permette di
104 raggruppare all'interno di una rete (in quelli che appunto vengono chiamati
105 \textit{netgroup}) varie macchine, centralizzando i servizi di definizione
106 di utenti e gruppi e di autenticazione, oggi è sempre più spesso sostituito
107 da LDAP.} o come quelli dei protocolli e dei servizi che sono mantenuti nei
108 file statici \conffile{/etc/protocols} e \conffile{/etc/services}.
110 Molte di queste informazioni non si trovano su un DNS, ma in una rete locale
111 può essere molto utile centralizzare il mantenimento di alcune di esse su
112 opportuni server. Inoltre l'uso di diversi supporti possibili per le stesse
113 informazioni (ad esempio il nome delle macchine può essere mantenuto sia
114 tramite \conffile{/etc/hosts}, che con il DNS, che con NIS) comporta il
115 problema dell'ordine in cui questi vengono interrogati. Con le implementazioni
116 classiche i vari supporti erano introdotti modificando direttamente le
117 funzioni di libreria, prevedendo un ordine di interrogazione predefinito e non
118 modificabile (a meno di una ricompilazione delle librerie stesse).
120 \itindbeg{Name~Service~Switch~(NSS)}
122 Per risolvere questa serie di problemi la risoluzione dei nomi a dominio
123 eseguità dal \textit{resolver} è stata inclusa all'interno di un meccanismo
124 generico per la risoluzione di corrispondenze fra nomi ed informazioni ad essi
125 associate chiamato \textit{Name Service Switch}, cui abbiamo accennato anche in
126 sez.~\ref{sec:sys_user_group} per quanto riguarda la gestione dei dati
127 associati a utenti e gruppi. Il sistema è stato introdotto la prima volta
128 nelle librerie standard di Solaris e le \acr{glibc} hanno ripreso lo stesso
129 schema; si tenga presente che questo sistema non esiste per altre librerie
130 standard come le \acr{libc5} o le \acr{uclib}.
132 Il \textit{Name Service Switch} (cui spesso si fa riferimento con l'acronimo
133 NSS) è un sistema di librerie dinamiche che permette di definire in maniera
134 generica sia i supporti su cui mantenere i dati di corrispondenza fra nomi e
135 valori numerici, sia l'ordine in cui effettuare le ricerche sui vari supporti
136 disponibili. Il sistema prevede una serie di possibili classi di
137 corrispondenza, quelle attualmente definite sono riportate in
138 tab.~\ref{tab:sys_NSS_classes}.
143 \begin{tabular}[c]{|l|p{8cm}|}
145 \textbf{Classe} & \textbf{Tipo di corrispondenza}\\
148 \texttt{passwd} & Corrispondenze fra nome dell'utente e relative
149 proprietà (\ids{UID}, gruppo principale, ecc.).\\
150 \texttt{shadow} & Corrispondenze fra username e password dell'utente
151 (e altre informazioni relative alle password).\\
152 \texttt{group} & Corrispondenze fra nome del gruppo e proprietà dello
154 \texttt{aliases} & Alias per la posta elettronica.\\
155 \texttt{ethers} & Corrispondenze fra numero IP e MAC address della
157 \texttt{hosts} & Corrispondenze fra nome a dominio e numero IP.\\
158 \texttt{netgroup} & Corrispondenze fra gruppo di rete e macchine che lo
160 \texttt{networks} & Corrispondenze fra nome di una rete e suo indirizzo
162 \texttt{protocols}& Corrispondenze fra nome di un protocollo e relativo
163 numero identificativo.\\
164 \texttt{rpc} & Corrispondenze fra nome di un servizio RPC e relativo
165 numero identificativo.\\
166 \texttt{publickey}& Chiavi pubbliche e private usate per gli RFC sicuri,
167 utilizzate da NFS e NIS+. \\
168 \texttt{services} & Corrispondenze fra nome di un servizio e numero di
172 \caption{Le diverse classi di corrispondenze definite
173 all'interno del \textit{Name Service Switch}.}
174 \label{tab:sys_NSS_classes}
177 % TODO rivedere meglio la tabella
179 Il sistema del \textit{Name Service Switch} è controllato dal contenuto del
180 file \conffile{/etc/nsswitch.conf}; questo contiene una riga di configurazione
181 per ciascuna di queste classi, che viene inizia col nome di
182 tab.~\ref{tab:sys_NSS_classes} seguito da un carattere ``\texttt{:}'' e
183 prosegue con la lista dei \textsl{servizi} su cui le relative informazioni
184 sono raggiungibili, scritti nell'ordine in cui si vuole siano interrogati.
185 Pertanto nelle versioni recenti delle librerie è questo file e non
186 \conffile{/etc/host.conf} a indicare l'ordine con cui si esegue la
187 risoluzione dei nomi.
189 Ogni servizio è specificato a sua volta da un nome, come \texttt{file},
190 \texttt{dns}, \texttt{db}, ecc. che identifica la libreria dinamica che
191 realizza l'interfaccia con esso. Per ciascun servizio se \texttt{NAME} è il
192 nome utilizzato dentro \conffile{/etc/nsswitch.conf}, dovrà essere presente
193 (usualmente in \file{/lib}) una libreria \texttt{libnss\_NAME} che ne
194 implementa le funzioni.
196 In ogni caso, qualunque sia la modalità con cui ricevono i dati o il supporto
197 su cui vengono mantenuti, e che si usino o meno funzionalità aggiuntive
198 fornite dal sistema del \textit{Name Service Switch}, dal punto di vista di un
199 programma che deve effettuare la risoluzione di un nome a dominio, tutto
200 quello che conta sono le funzioni classiche che il \textit{resolver} mette a
201 disposizione (è cura delle \acr{glibc} tenere conto della presenza del
202 \textit{Name Service Switch}) e sono queste quelle che tratteremo nelle
205 \itindend{Name~Service~Switch~(NSS)}
208 \subsection{Le funzioni di interrogazione del DNS}
209 \label{sec:sock_resolver_functions}
211 Prima di trattare le funzioni usate normalmente nella risoluzione dei nomi a
212 dominio conviene trattare in maniera più dettagliata il servizio DNS. Come
213 accennato questo, benché esso in teoria sia solo uno dei possibili supporti su
214 cui mantenere le informazioni, in pratica costituisce il meccanismo principale
215 con cui vengono risolti i nomi a dominio. Inolte esso può fornire anche
216 ulteriori informazioni oltre relative alla risoluzione dei nomi a dominio.
217 Per questo motivo esistono una serie di funzioni di libreria che servono
218 specificamente ad eseguire delle interrogazioni verso un server DNS, funzioni
219 che poi vengono utilizzate anche per realizzare le funzioni generiche di
220 libreria usate dal sistema del \textit{resolver}.
222 Il sistema del DNS è in sostanza di un database distribuito organizzato in
223 maniera gerarchica, i dati vengono mantenuti in tanti server distinti ciascuno
224 dei quali si occupa della risoluzione del proprio \textsl{dominio}; i nomi a
225 dominio sono organizzati in una struttura ad albero analoga a quella
226 dell'albero dei file, con domini di primo livello (come i \texttt{.org}),
227 secondo livello (come \texttt{.truelite.it}), ecc. In questo caso le
228 separazioni sono fra i vari livelli sono definite dal carattere ``\texttt{.}''
229 ed i nomi devono essere risolti da destra verso sinistra.\footnote{per chi si
230 stia chiedendo quale sia la radice di questo albero, cioè l'equivalente di
231 ``\texttt{/}'', la risposta è il dominio speciale ``\texttt{.}'', che in
232 genere non viene mai scritto esplicitamente, ma che, come chiunque abbia
233 configurato un server DNS sa bene, esiste ed è gestito dai cosiddetti
234 \textit{root DNS} che risolvono i domini di primo livello.} Il meccanismo
235 funziona con il criterio della \textsl{delegazione}, un server responsabile
236 per un dominio di primo livello può delegare la risoluzione degli indirizzi
237 per un suo dominio di secondo livello ad un altro server, il quale a sua volta
238 potrà delegare la risoluzione di un eventuale sotto-dominio di terzo livello ad
239 un altro server ancora.
241 Come accennato un server DNS è in grado di fare molto altro rispetto alla
242 risoluzione di un nome a dominio in un indirizzo IP: ciascuna voce nel
243 database viene chiamata \textit{resource record}, e può contenere diverse
244 informazioni. In genere i \textit{resource record} vengono classificati per la
245 \textsl{classe di indirizzi} cui i dati contenuti fanno riferimento, e per il
246 \textsl{tipo} di questi ultimi (ritroveremo classi di indirizzi e tipi di
247 record più avanti in tab.~\ref{tab:DNS_address_class} e
248 tab.~\ref{tab:DNS_record_type}). Oggigiorno i dati mantenuti nei server DNS
249 sono quasi esclusivamente relativi ad indirizzi internet, per cui in pratica
250 viene utilizzata soltanto una classe di indirizzi; invece le corrispondenze
251 fra un nome a dominio ed un indirizzo IP sono solo uno fra i vari tipi di
252 informazione che un server DNS fornisce normalmente.
254 L'esistenza di vari tipi di informazioni è un altro dei motivi per cui il
255 \textit{resolver} prevede, oltre a quelle relative alla semplice risoluzione
256 dei nomi, un insieme di funzioni specifiche dedicate all'interrogazione di un
257 server DNS, tutte nella forma \texttt{res\_}\textsl{\texttt{nome}}. La prima
258 di queste funzioni è \funcd{res\_init}, il cui prototipo è:
262 \fhead{arpa/nameser.h}
264 \fdecl{int res\_init(void)}
265 \fdesc{Inizializza il sistema del \textit{resolver}.}
267 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore.
271 La funzione legge il contenuto dei file di configurazione per impostare il
272 dominio di default, gli indirizzi dei server DNS da contattare e l'ordine
273 delle ricerche; se non sono specificati server verrà utilizzato l'indirizzo
274 locale, e se non è definito un dominio di default sarà usato quello associato
275 con l'indirizzo locale (ma questo può essere sovrascritto con l'uso della
276 variabile di ambiente \envvar{LOCALDOMAIN}). In genere non è necessario
277 eseguire questa funzione esplicitamente, in quanto viene automaticamente
278 chiamata la prima volta che si esegue una qualunque delle altre.
280 Le impostazioni e lo stato del \textit{resolver} inizializzati da
281 \func{res\_init} vengono mantenuti in una serie di variabili raggruppate nei
282 campi di una apposita struttura. Questa struttura viene definita in
283 \headfiled{resolv.h} e mantenuta nella variabile globale \var{\_res}, che
284 viene utilizzata internamente da tutte le funzioni dell'interfaccia. Questo
285 consente anche di accedere direttamente al contenuto della variabile
286 all'interno di un qualunque programma, una volta che la sia opportunamente
288 \includecodesnip{listati/resolv_option.c}
290 Dato che l'uso di una variabile globale rende tutte le funzioni
291 dell'interfaccia classica non rientranti, queste sono state deprecate in
292 favore di una nuova interfaccia in cui esse sono state sostituite da
293 altrettante nuove funzioni, il cui nome è ottenuto apponendo una
294 ``\texttt{n}'' al nome di quella tradizionale (cioè nella forma
295 \texttt{res\_n\textsl{nome}}). Tutte le nuove funzioni sono identiche alle
296 precedenti, ma hanno un primo argomento aggiuntivo, \param{statep}, puntatore
297 ad una struttura dello stesso tipo di \var{\_res}. Questo consente di usare
298 una variabile locale per mantenere lo stato del \textit{resolver}, rendendo le
299 nuove funzioni rientranti. In questo caso per poter utilizzare il nuovo
300 argomento occorrerà una opportuna dichiarazione del relativo tipo di dato con:
301 \includecodesnip{listati/resolv_newoption.c}
303 Così la nuova funzione utilizzata per inizializzare il \textit{resolver} (che
304 come la precedente viene chiamata automaticamente da tutte altre funzioni) è
305 \funcd{res\_ninit}, ed il suo prototipo è:
309 \fhead{arpa/nameser.h}
311 \fdecl{int res\_ninit(res\_state statep)}
312 \fdesc{Inizializza il sistema del \textit{resolver}.}
314 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore.
318 Indipendentemente da quale versione delle funzioni si usino, tutti i campi
319 della struttura (\var{\_res} o la variabile puntata da \param{statep}) sono ad
320 uso interno, e vengono usualmente inizializzate da \func{res\_init} o
321 \func{res\_ninit} in base al contenuto dei file di configurazione e ad una
322 serie di valori di default. L'unico campo che può essere utile modificare è
323 \var{\_res.options} (o l'equivalente della variabile puntata
324 da\param{statep}), una maschera binaria che contiene una serie di bit che
325 esprimono le opzioni che permettono di controllare il comportamento del
331 \begin{tabular}[c]{|l|p{8cm}|}
333 \textbf{Costante} & \textbf{Significato} \\
336 \constd{RES\_INIT} & Viene attivato se è stata chiamata
338 \constd{RES\_DEBUG} & Stampa dei messaggi di debug.\\
339 \constd{RES\_AAONLY} & Accetta solo risposte autoritative.\\
340 \constd{RES\_USEVC} & Usa connessioni TCP per contattare i server
341 invece che l'usuale UDP.\\
342 \constd{RES\_PRIMARY} & Interroga soltanto server DNS primari.\\
343 \constd{RES\_IGNTC} & Ignora gli errori di troncamento, non ritenta la
344 richiesta con una connessione TCP.\\
345 \constd{RES\_RECURSE} & Imposta il bit che indica che si desidera
346 eseguire una interrogazione ricorsiva.\\
347 \constd{RES\_DEFNAMES} & Se attivo \func{res\_search} aggiunge il nome
348 del dominio di default ai nomi singoli (che non
349 contengono cioè un ``\texttt{.}'').\\
350 \constd{RES\_STAYOPEN} & Usato con \const{RES\_USEVC} per mantenere
351 aperte le connessioni TCP fra interrogazioni
353 \constd{RES\_DNSRCH} & Se attivo \func{res\_search} esegue le ricerche
354 di nomi di macchine nel dominio corrente o nei
355 domini ad esso sovrastanti.\\
356 \constd{RES\_INSECURE1} & Blocca i controlli di sicurezza di tipo 1.\\
357 \constd{RES\_INSECURE2} & Blocca i controlli di sicurezza di tipo 2.\\
358 \constd{RES\_NOALIASES} & Blocca l'uso della variabile di ambiente
359 \envvar{HOSTALIASES}.\\
360 \constd{RES\_USE\_INET6} & Restituisce indirizzi IPv6 con
361 \func{gethostbyname}. \\
362 \constd{RES\_ROTATE} & Ruota la lista dei server DNS dopo ogni
364 \constd{RES\_NOCHECKNAME}& Non controlla i nomi per verificarne la
365 correttezza sintattica. \\
366 \constd{RES\_KEEPTSIG} & Non elimina i record di tipo \texttt{TSIG}.\\
367 \constd{RES\_BLAST} & Effettua un ``\textit{blast}'' inviando
368 simultaneamente le richieste a tutti i server;
369 non ancora implementata. \\
370 \constd{RES\_DEFAULT} & Combinazione di \const{RES\_RECURSE},
371 \const{RES\_DEFNAMES} e \const{RES\_DNSRCH}.\\
374 \caption{Costanti utilizzabili come valori per \var{\_res.options}.}
375 \label{tab:resolver_option}
378 Per utilizzare questa funzionalità per modificare le impostazioni direttamente
379 da programma occorrerà impostare un opportuno valore per questo campo ed
380 invocare esplicitamente \func{res\_init} o \func{res\_ninit}, dopo di che le
381 altre funzioni prenderanno le nuove impostazioni. Le costanti che definiscono
382 i vari bit di questo campo, ed il relativo significato sono illustrate in
383 tab.~\ref{tab:resolver_option}; trattandosi di una maschera binaria un valore
384 deve essere espresso con un opportuno OR aritmetico di dette costanti; ad
385 esempio il valore di default delle opzioni, espresso dalla costante
386 \const{RES\_DEFAULT}, è definito come:
387 \includecodesnip{listati/resolv_option_def.c}
389 Non tratteremo il significato degli altri campi non essendovi necessità di
390 modificarli direttamente; gran parte di essi sono infatti impostati dal
391 contenuto dei file di configurazione, mentre le funzionalità controllate da
392 alcuni di esse possono essere modificate con l'uso delle opportune variabili
393 di ambiente come abbiamo visto per \envvar{LOCALDOMAIN}. In particolare con
394 \envvar{RES\_RETRY} si soprassiede il valore del campo \var{retry} che
395 controlla quante volte viene ripetuto il tentativo di connettersi ad un server
396 DNS prima di dichiarare fallimento; il valore di default è 4, un valore nullo
397 significa bloccare l'uso del DNS. Infine con \envvar{RES\_TIMEOUT} si
398 soprassiede il valore del campo \var{retrans} (preimpostato al valore della
399 omonima costante \const{RES\_TIMEOUT} di \headfile{resolv.h}) che è il valore
400 preso come base (in numero di secondi) per definire la scadenza di una
401 richiesta, ciascun tentativo di richiesta fallito viene ripetuto raddoppiando
402 il tempo di scadenza per il numero massimo di volte stabilito da
405 La funzione di interrogazione principale è \funcd{res\_query}
406 (\funcd{res\_nquery} per la nuova interfaccia), che serve ad eseguire una
407 richiesta ad un server DNS per un nome a dominio \textsl{completamente
408 specificato} (quello che si chiama
409 \itindex{Fully~Qualified~Domain~Name~(FQDN)} FQDN, \textit{Fully Qualified
410 Domain Name}); il loro prototipo è:
414 \fhead{arpa/nameser.h}
416 \fdecl{int res\_query(const char *dname, int class, int type,
417 unsigned char *answer, int anslen)}
418 \fdecl{int res\_nquery(res\_state statep, const char *dname, int class, int
420 \phantom{int res\_nquery(}unsigned char *answer, int anslen)}
421 \fdesc{Esegue una interrogazione al DNS.}
423 {Le funzioni ritornano un valore positivo pari alla lunghezza dei dati scritti
424 nel buffer \param{answer} in caso di successo e $-1$ per un errore.
428 Le funzioni eseguono una interrogazione ad un server DNS relativa al nome da
429 risolvere passato nella stringa indirizzata da \param{dname}, inoltre deve
430 essere specificata la classe di indirizzi in cui eseguire la ricerca con
431 \param{class}, ed il tipo di \textit{resource record} che si vuole ottenere
432 con \param{type}. Il risultato della ricerca verrà scritto nel buffer di
433 lunghezza \param{anslen} puntato da \param{answer} che si sarà opportunamente
434 allocato in precedenza.
436 Una seconda funzione di ricerca analoga a \func{res\_query}, che prende gli
437 stessi argomenti ma che esegue l'interrogazione con le funzionalità
438 addizionali previste dalle due opzioni \const{RES\_DEFNAMES} e
439 \const{RES\_DNSRCH}, è \funcd{res\_search} (\funcd{res\_nsearch} per la nuova
440 interfaccia), il cui prototipo è:
444 \fhead{arpa/nameser.h}
446 \fdecl{int res\_search(const char *dname, int class, int type,
447 unsigned char *answer, \\
448 \phantom{int res\_search}int anslen)}
449 \fdecl{int res\_nsearch(res\_state statep, const char *dname, int class,
451 \phantom{int res\_nsearch(}unsigned char *answer, int anslen)}
452 \fdesc{Esegue una interrogazione al DNS.}
454 {Le funzioni ritornano un valore positivo pari alla lunghezza dei dati scritti
455 nel buffer \param{answer} in caso di successo e $-1$ per un errore.
459 In sostanza la funzione ripete una serie di chiamate a \func{res\_query}
460 (\func{res\_nquery}) aggiungendo al nome contenuto nella stringa \param{dname}
461 il dominio di default da cercare, fermandosi non appena trova un risultato.
462 Il risultato di entrambe le funzioni viene scritto nel formato opportuno (che
463 sarà diverso a seconda del tipo di record richiesto) nel buffer di ritorno;
464 sarà compito del programma (o di altre funzioni) estrarre i relativi dati,
465 esistono una serie di funzioni interne usate per la scansione di questi dati,
466 per chi fosse interessato una trattazione dettagliata è riportata nel
467 quattordicesimo capitolo di \cite{DNSbind}.
469 Le classi di indirizzi supportate da un server DNS sono tre, ma di queste in
470 pratica oggi viene utilizzata soltanto quella degli indirizzi internet; le
471 costanti che identificano dette classi, da usare come valore per l'argomento
472 \param{class} delle precedenti funzioni, sono riportate in
473 tab.~\ref{tab:DNS_address_class} (esisteva in realtà anche una classe
474 \constd{C\_CSNET} per la omonima rete, ma è stata dichiarata obsoleta).
479 \begin{tabular}[c]{|l|p{8cm}|}
481 \textbf{Costante} & \textbf{Significato} \\
484 \constd{C\_IN} & Indirizzi internet, in pratica i soli utilizzati oggi.\\
485 \constd{C\_HS} & Indirizzi \textit{Hesiod}, utilizzati solo al MIT, oggi
486 completamente estinti. \\
487 \constd{C\_CHAOS}& Indirizzi per la rete \textit{Chaosnet}, un'altra rete
488 sperimentale nata al MIT. \\
489 \constd{C\_ANY} & Indica un indirizzo di classe qualunque.\\
492 \caption{Costanti identificative delle classi di indirizzi per l'argomento
493 \param{class} di \func{res\_query}.}
494 \label{tab:DNS_address_class}
497 Come accennato le tipologie di dati che sono mantenibili su un server DNS sono
498 diverse, ed a ciascuna di essa corrisponde un diverso tipo di \textit{resource
499 record}. L'elenco delle costanti, ripreso dai file di dichiarazione
500 \headfiled{arpa/nameser.h} e \headfiled{arpa/nameser\_compat.h}, che
501 definiscono i valori che si possono usare per l'argomento \param{type} per
502 specificare il tipo di \textit{resource record} da richiedere è riportato in
503 tab.~\ref{tab:DNS_record_type}; le costanti (tolto il \texttt{T\_} iniziale)
504 hanno gli stessi nomi usati per identificare i record nei file di zona di
505 BIND,\footnote{BIND, acronimo di \textit{Berkley Internet Name Domain}, è una
506 implementazione di un server DNS, ed, essendo utilizzata nella stragrande
507 maggioranza dei casi, fa da riferimento; i dati relativi ad un certo dominio
508 (cioè i suoi \textit{resource record} vengono mantenuti in quelli che sono
509 usualmente chiamati \textsl{file di zona}, e in essi ciascun tipo di dominio
510 è identificato da un nome che è appunto identico a quello delle costanti di
511 tab.~\ref{tab:DNS_record_type} senza il \texttt{T\_} iniziale.} e che
512 normalmente sono anche usati come nomi per indicare i record.
517 \begin{tabular}[c]{|l|l|}
519 \textbf{Costante} & \textbf{Significato} \\
522 \constd{T\_A} & Indirizzo di una stazione.\\
523 \constd{T\_NS} & Server DNS autoritativo per il dominio richiesto.\\
524 \constd{T\_MD} & Destinazione per la posta elettronica.\\
525 \constd{T\_MF} & Redistributore per la posta elettronica.\\
526 \constd{T\_CNAME} & Nome canonico.\\
527 \constd{T\_SOA} & Inizio di una zona di autorità.\\
528 \constd{T\_MB} & Nome a dominio di una casella di posta.\\
529 \constd{T\_MG} & Nome di un membro di un gruppo di posta.\\
530 \constd{T\_MR} & Nome di un cambiamento di nome per la posta.\\
531 \constd{T\_NULL} & Record nullo.\\
532 \constd{T\_WKS} & Servizio noto.\\
533 \constd{T\_PTR} & Risoluzione inversa di un indirizzo numerico.\\
534 \constd{T\_HINFO} & Informazione sulla stazione.\\
535 \constd{T\_MINFO} & Informazione sulla casella di posta.\\
536 \constd{T\_MX} & Server cui instradare la posta per il dominio.\\
537 \constd{T\_TXT} & Stringhe di testo (libere).\\
538 \constd{T\_RP} & Nome di un responsabile (\textit{responsible person}).\\
539 \constd{T\_AFSDB} & Database per una cella AFS.\\
540 \constd{T\_X25} & Indirizzo di chiamata per X.25.\\
541 \constd{T\_ISDN} & Indirizzo di chiamata per ISDN.\\
542 \constd{T\_RT} & Router.\\
543 \constd{T\_NSAP} & Indirizzo NSAP.\\
544 \constd{T\_NSAP\_PTR}& Risoluzione inversa per NSAP (deprecato).\\
545 \constd{T\_SIG} & Firma digitale di sicurezza.\\
546 \constd{T\_KEY} & Chiave per firma.\\
547 \constd{T\_PX} & Corrispondenza per la posta X.400.\\
548 \constd{T\_GPOS} & Posizione geografica.\\
549 \constd{T\_AAAA} & Indirizzo IPv6.\\
550 \constd{T\_LOC} & Informazione di collocazione.\\
551 \constd{T\_NXT} & Dominio successivo.\\
552 \constd{T\_EID} & Identificatore di punto conclusivo.\\
553 \constd{T\_NIMLOC}& Posizionatore \textit{nimrod}.\\
554 \constd{T\_SRV} & Servizio.\\
555 \constd{T\_ATMA} & Indirizzo ATM.\\
556 \constd{T\_NAPTR} & Puntatore ad una \textit{naming authority}.\\
557 \constd{T\_TSIG} & Firma di transazione.\\
558 \constd{T\_IXFR} & Trasferimento di zona incrementale.\\
559 \constd{T\_AXFR} & Trasferimento di zona di autorità.\\
560 \constd{T\_MAILB} & Trasferimento di record di caselle di posta.\\
561 \constd{T\_MAILA} & Trasferimento di record di server di posta.\\
562 \constd{T\_ANY} & Valore generico.\\
565 \caption{Costanti identificative del tipo di record per l'argomento
566 \param{type} di \func{res\_query}.}
567 \label{tab:DNS_record_type}
571 L'elenco di tab.~\ref{tab:DNS_record_type} è quello di \textsl{tutti} i
572 \textit{resource record} definiti, con una breve descrizione del relativo
573 significato. Di tutti questi però viene impiegato correntemente solo un
574 piccolo sottoinsieme, alcuni sono obsoleti ed altri fanno riferimento a dati
575 applicativi che non ci interessano non avendo nulla a che fare con la
576 risoluzione degli indirizzi IP, pertanto non entreremo nei dettagli del
577 significato di tutti i \textit{resource record}, ma solo di quelli usati dalle
578 funzioni del \textit{resolver}. Questi sono sostanzialmente i seguenti (per
579 indicarli si è usata la notazione dei file di zona di BIND):
580 \begin{basedescript}{\desclabelwidth{1.2cm}\desclabelstyle{\nextlinelabel}}
581 \item[\texttt{A}] viene usato per indicare la corrispondenza fra un nome a
582 dominio ed un indirizzo IPv4; ad esempio la corrispondenza fra
583 \texttt{jojo.truelite.it} e l'indirizzo IP \texttt{62.48.34.25}.
584 \item[\texttt{AAAA}] viene usato per indicare la corrispondenza fra un nome a
585 dominio ed un indirizzo IPv6; è chiamato in questo modo dato che la
586 dimensione di un indirizzo IPv6 è quattro volte quella di un indirizzo IPv4.
587 \item[\texttt{PTR}] per fornire la corrispondenza inversa fra un indirizzo IP
588 ed un nome a dominio ad esso associato si utilizza questo tipo di record (il
589 cui nome sta per \textit{pointer}).
590 \item[\texttt{CNAME}] qualora si abbiamo più nomi che corrispondono allo
591 stesso indirizzo (come ad esempio \texttt{www.truelite.it} e
592 \texttt{sources.truelite.it}, che fanno entrambi riferimento alla stessa
593 macchina (nel caso \texttt{dodds.truelite.it}) si può usare questo tipo di
594 record per creare degli \textit{alias} in modo da associare un qualunque
595 altro nome al \textsl{nome canonico} della macchina (si chiama così quello
596 associato al record \texttt{A}).
599 Come accennato in caso di successo le due funzioni di richiesta restituiscono
600 il risultato della interrogazione al server, in caso di insuccesso l'errore
601 invece viene segnalato da un valore di ritorno pari a $-1$, ma in questo caso,
602 non può essere utilizzata la variabile \var{errno} per riportare un codice di
603 errore, in quanto questo viene impostato per ciascuna delle chiamate al
604 sistema utilizzate dalle funzioni del \textit{resolver}, non avrà alcun
605 significato nell'indicare quale parte del procedimento di risoluzione è
608 Per questo motivo è stata definita una variabile di errore separata,
609 \var{h\_errno}, che viene utilizzata dalle funzioni del \textit{resolver} per
610 indicare quale problema ha causato il fallimento della risoluzione del nome.
611 Ad essa si può accedere una volta che la si dichiara con:
612 \includecodesnip{listati/herrno.c}
613 ed i valori che può assumere, con il relativo significato, sono riportati in
614 tab.~\ref{tab:h_errno_values}.
619 \begin{tabular}[c]{|l|p{9cm}|}
621 \textbf{Costante} & \textbf{Significato} \\
624 \constd{HOST\_NOT\_FOUND}& L'indirizzo richiesto non è valido e la
625 macchina indicata è sconosciuta.\\
626 \constd{NO\_ADDRESS} & Il nome a dominio richiesto è valido, ma non ha
627 un indirizzo associato ad esso
628 (alternativamente può essere indicato come
629 \constd{NO\_DATA}).\\
630 \constd{NO\_RECOVERY} & Si è avuto un errore non recuperabile
631 nell'interrogazione di un server DNS.\\
632 \constd{TRY\_AGAIN} & Si è avuto un errore temporaneo
633 nell'interrogazione di un server DNS, si può
634 ritentare l'interrogazione in un secondo
638 \caption{Valori possibili della variabile \var{h\_errno}.}
639 \label{tab:h_errno_values}
642 Insieme alla nuova variabile vengono definite anche delle nuove funzioni per
643 stampare l'errore a video, analoghe a quelle di sez.~\ref{sec:sys_strerror}
644 per \var{errno}, ma che usano il valore di \var{h\_errno}; la prima è
645 \funcd{herror} ed il suo prototipo è:
651 \fdecl{void herror(const char *string)}
652 \fdesc{Stampa un errore di risoluzione.}
656 La funzione è l'analoga di \func{perror} e stampa sullo \textit{standard error} un
657 messaggio di errore corrispondente al valore corrente di \var{h\_errno}, a cui
658 viene anteposta la stringa \param{string} passata come argomento. La seconda
659 funzione è \funcd{hstrerror} ed il suo prototipo è:
665 \fdecl{const char *hstrerror(int err)}
666 \fdesc{Restituisce una stringa corrispondente ad un errore di risoluzione.}
670 \noindent che, come l'analoga \func{strerror}, restituisce una stringa con un
671 messaggio di errore già formattato, corrispondente al codice passato come
672 argomento (che si presume sia dato da \var{h\_errno}).
677 \subsection{La vecchia interfaccia per la risoluzione dei nomi a dominio}
678 \label{sec:sock_name_services}
680 La principale funzionalità del \textit{resolver} resta quella di risolvere i
681 nomi a dominio in indirizzi IP, per cui non ci dedicheremo oltre alle funzioni
682 per effetture delle richieste generiche al DNS ed esamineremo invece le
683 funzioni del \textit{resolver} dedicate specificamente a questo. Tratteremo in
684 questa sezione l'interfaccia tradizionale, che ormai è deprecata, mentre
685 vedremo nella sezione seguente la nuova interfaccia.
687 La prima funzione dell'interfaccia tradizionale è \funcd{gethostbyname} il cui
688 scopo è ottenere l'indirizzo di una stazione noto il suo nome a dominio, il
693 \fdecl{struct hostent *gethostbyname(const char *name)}
694 \fdesc{Determina l'indirizzo associato ad un nome a dominio.}
697 {La funzione ritorna il puntatore ad una
698 struttura di tipo \struct{hostent} contenente i dati associati al nome a
699 dominio in caso di successo o un puntatore nullo per un errore.}
702 La funzione prende come argomento una stringa \param{name} contenente il nome
703 a dominio che si vuole risolvere, in caso di successo i dati ad esso relativi
704 vengono memorizzati in una opportuna struttura \struct{hostent} la cui
705 definizione è riportata in fig.~\ref{fig:sock_hostent_struct}.
708 \footnotesize \centering
709 \begin{minipage}[c]{0.80\textwidth}
710 \includestruct{listati/hostent.h}
712 \caption{La struttura \structd{hostent} per la risoluzione dei nomi a
713 dominio e degli indirizzi IP.}
714 \label{fig:sock_hostent_struct}
717 Quando un programma chiama \func{gethostbyname} e questa usa il DNS per
718 effettuare la risoluzione del nome, è con i valori contenuti nei relativi
719 record che vengono riempite le varie parti della struttura \struct{hostent}.
720 Il primo campo della struttura, \var{h\_name} contiene sempre il \textsl{nome
721 canonico}, che nel caso del DNS è appunto il nome associato ad un record
722 \texttt{A}. Il secondo campo della struttura, \var{h\_aliases}, invece è un
723 puntatore ad vettore di puntatori, terminato da un puntatore nullo. Ciascun
724 puntatore del vettore punta ad una stringa contenente uno degli altri
725 possibili nomi associati allo stesso \textsl{nome canonico} (quelli che nel
726 DNS vengono inseriti come record di tipo \texttt{CNAME}).
728 Il terzo campo della struttura, \var{h\_addrtype}, indica il tipo di indirizzo
729 che è stato restituito, e può assumere soltanto i valori \const{AF\_INET} o
730 \const{AF\_INET6}, mentre il quarto campo, \var{h\_length}, indica la
731 lunghezza dell'indirizzo stesso in byte.
733 Infine il campo \var{h\_addr\_list} è il puntatore ad un vettore di puntatori
734 ai singoli indirizzi; il vettore è terminato da un puntatore nullo. Inoltre,
735 come illustrato in fig.~\ref{fig:sock_hostent_struct}, viene definito il campo
736 \var{h\_addr} come sinonimo di \code{h\_addr\_list[0]}, cioè un riferimento
737 diretto al primo indirizzo della lista.
739 Oltre ai normali nomi a dominio la funzione accetta come argomento
740 \param{name} anche indirizzi numerici, in formato dotted decimal per IPv4 o
741 con la notazione illustrata in sez.~\ref{sec:IP_ipv6_notation} per IPv6. In
742 tal caso \func{gethostbyname} non eseguirà nessuna interrogazione remota, ma
743 si limiterà a copiare la stringa nel campo \var{h\_name} ed a creare la
744 corrispondente struttura \var{in\_addr} da indirizzare con
745 \code{h\_addr\_list[0]}.
747 Con l'uso di \func{gethostbyname} si ottengono solo gli indirizzi IPv4, se si
748 vogliono ottenere degli indirizzi IPv6 occorrerà prima impostare l'opzione
749 \const{RES\_USE\_INET6} nel campo \texttt{\_res.options} e poi chiamare
750 \func{res\_init} (vedi sez.~\ref{sec:sock_resolver_functions}) per modificare
751 le opzioni del \textit{resolver}; dato che questo non è molto comodo è stata
752 definita (è una estensione fornita dalle \acr{glibc}, disponibile anche in
753 altri sistemi unix-like) un'altra funzione, \funcd{gethostbyname2}, il cui
759 \fdecl{struct hostent *gethostbyname2(const char *name, int af)}
760 \fdesc{Determina l'indirizzo del tipo scelto associato ad un nome a dominio.}
763 {La funzione ritorna il puntatore ad una
764 struttura di tipo \struct{hostent} contenente i dati associati al nome a
765 dominio in caso di successo e un puntatore nullo per un errore.}
768 In questo caso la funzione prende un secondo argomento \param{af} che indica
769 quale famiglia di indirizzi è quella che dovrà essere utilizzata per
770 selezionare i risultati restituiti dalla funzione; i soli valori consentiti
771 sono \const{AF\_INET} o \const{AF\_INET6} per indicare rispettivamente IPv4 e
772 IPv6 (per questo è necessario l'uso di \headfile{sys/socket.h}). Per tutto il
773 resto la funzione è identica a \func{gethostbyname}, ed identici sono i suoi
777 \footnotesize \centering
778 \begin{minipage}[c]{\codesamplewidth}
779 \includecodesample{listati/mygethost.c}
782 \caption{Esempio di codice per la risoluzione di un indirizzo.}
783 \label{fig:mygethost_example}
786 Vediamo allora un primo esempio dell'uso delle funzioni di risoluzione, in
787 fig.~\ref{fig:mygethost_example} è riportato un estratto del codice di un
788 programma che esegue una semplice interrogazione al \textit{resolver} usando
789 \func{gethostbyname} e poi ne stampa a video i risultati. Al solito il
790 sorgente completo, che comprende il trattamento delle opzioni ed una funzione
791 per stampare un messaggio di aiuto, è nel file \texttt{mygethost.c} dei
792 sorgenti allegati alla guida.
794 Il programma richiede un solo argomento che specifichi il nome da cercare,
795 senza il quale (\texttt{\small 15--18}) esce con un errore. Dopo di che
796 (\texttt{\small 20}) si limita a chiamare \func{gethostbyname}, ricevendo il
797 risultato nel puntatore \var{data}. Questo (\texttt{\small 21--24}) viene
798 controllato per rilevare eventuali errori, nel qual caso il programma esce
799 dopo aver stampato un messaggio con \func{herror}.
801 Se invece la risoluzione è andata a buon fine si inizia (\texttt{\small 25})
802 con lo stampare il nome canonico, dopo di che (\texttt{\small 26--30}) si
803 stampano eventuali altri nomi. Per questo prima (\texttt{\small 26}) si prende
804 il puntatore alla cima della lista che contiene i nomi e poi (\texttt{\small
805 27--30}) si esegue un ciclo che sarà ripetuto fin tanto che nella lista si
806 troveranno dei puntatori validi per le stringhe dei nomi (si ricordi che la
807 lista viene terminata da un puntatore nullo); prima (\texttt{\small 28}) si
808 stamperà la stringa e poi (\texttt{\small 29}) si provvederà ad incrementare
809 il puntatore per passare al successivo elemento della lista.
811 Una volta stampati i nomi si passerà a stampare gli indirizzi, il primo passo
812 (\texttt{\small 31--38}) è allora quello di riconoscere il tipo di indirizzo
813 sulla base del valore del campo \var{h\_addrtype}, stampandolo a video. Si è
814 anche previsto di stampare un errore nel caso (che non dovrebbe mai accadere)
815 di un indirizzo non valido.
817 Infine (\texttt{\small 39--44}) si stamperanno i valori degli indirizzi, di
818 nuovo (\texttt{\small 39}) si inizializzerà un puntatore alla cima della lista
819 e si eseguirà un ciclo fintanto che questo punterà ad indirizzi validi in
820 maniera analoga a quanto fatto in precedenza per i nomi a dominio. Si noti
821 come, essendo il campo \var{h\_addr\_list} un puntatore ad strutture di
822 indirizzi generiche, questo sia ancora di tipo \texttt{char **} e si possa
823 riutilizzare lo stesso puntatore usato per i nomi.
825 Per ciascun indirizzo valido si provvederà (\texttt{\small 41}) ad una
826 conversione con la funzione \func{inet\_ntop} (vedi
827 sez.~\ref{sec:sock_addr_func}) passandole gli opportuni argomenti, questa
828 restituirà la stringa da stampare (\texttt{\small 42}) con il valore
829 dell'indirizzo in \var{buffer}, che si è avuto la cura di dichiarare
830 inizialmente (\texttt{\small 10}) con dimensioni adeguate; dato che la
831 funzione è in grado di tenere conto automaticamente del tipo di indirizzo non
832 ci sono precauzioni particolari da prendere.\footnote{volendo essere pignoli
833 si dovrebbe controllarne lo stato di uscita, lo si è tralasciato per non
834 appesantire il codice, dato che in caso di indirizzi non validi si sarebbe
835 avuto un errore con \func{gethostbyname}, ma si ricordi che la sicurezza non
838 Le funzioni illustrate finora hanno un difetto: utilizzano tutte una area di
839 memoria interna per allocare i contenuti della struttura \struct{hostent} e
840 per questo non possono essere rientranti. L'uso della memoria interna inoltre
841 comporta anche che in due successive chiamate i dati potranno essere
844 Si tenga presente poi che copiare il contenuto della sola struttura non è
845 sufficiente per salvare tutti i dati, in quanto questa contiene puntatori ad
846 altri dati, che pure possono essere sovrascritti; per questo motivo, se si
847 vuole salvare il risultato di una chiamata, occorrerà eseguire quella che si
848 chiama una \itindex{deep~copy} \textit{deep copy}.\footnote{si chiama così
849 quella tecnica per cui, quando si deve copiare il contenuto di una struttura
850 complessa (con puntatori che puntano ad altri dati, che a loro volta possono
851 essere puntatori ad altri dati) si deve copiare non solo il contenuto della
852 struttura, ma eseguire una scansione per risolvere anche tutti i puntatori
853 contenuti in essa (e così via se vi sono altre sotto-strutture con altri
854 puntatori) e copiare anche i dati da questi referenziati.}
856 Per ovviare a questi problemi nelle \acr{glibc} sono definite anche delle
857 versioni rientranti delle precedenti funzioni, al solito queste sono
858 caratterizzate dall'avere un suffisso \texttt{\_r}, pertanto avremo le due
859 funzioni \funcd{gethostbyname\_r} e \funcd{gethostbyname2\_r} i cui prototipi
865 \fdecl{int gethostbyname\_r(const char *name, struct hostent *ret,
866 char *buf, size\_t buflen,\\
867 \phantom{int gethostbyname\_r(}struct hostent **result, int *h\_errnop)}
868 \fdecl{int gethostbyname2\_r(const char *name, int af,
869 struct hostent *ret, char *buf,\\
870 \phantom{int gethostbyname2\_r(}size\_t buflen, struct hostent **result, int *h\_errnop)}
872 \fdesc{Versioni rientranti delle funzioni \func{gethostbyname} e
873 \func{gethostbyname2}.}
876 {Le funzioni ritornano $0$ in caso di successo ed un valore diverso da zero per
880 Gli argomenti \param{name} (e \param{af} per \func{gethostbyname2\_r}) hanno
881 lo stesso significato visto in precedenza. Tutti gli altri argomenti hanno lo
882 stesso significato per entrambe le funzioni. Per evitare l'uso di variabili
883 globali si dovrà allocare preventivamente una struttura \struct{hostent} in
884 cui ricevere il risultato, passandone l'indirizzo alla funzione nell'argomento
885 \param{ret}. Inoltre, dato che \struct{hostent} contiene dei puntatori, dovrà
886 essere allocato anche un buffer in cui le funzioni possano scrivere tutti i
887 dati del risultato dell'interrogazione da questi puntati; l'indirizzo e la
888 lunghezza di questo buffer devono essere indicati con gli argomenti
889 \param{buf} e \param{buflen}.
891 Gli ultimi due argomenti vengono utilizzati per avere indietro i risultati
892 come \textit{value result argument}, si deve specificare l'indirizzo della
893 variabile su cui la funzione dovrà salvare il codice di errore
894 con \param{h\_errnop} e quello su cui dovrà salvare il puntatore che si userà
895 per accedere i dati con \param{result}.
897 In caso di successo entrambe le funzioni restituiscono un valore nullo,
898 altrimenti restituiscono un valore non nulla e all'indirizzo puntato
899 da \param{result} sarà salvato un puntatore nullo, mentre a quello puntato da
900 \param{h\_errnop} sarà salvato il valore del codice di errore, dato che per
901 essere rientrante la funzione non può la variabile globale \var{h\_errno}. In
902 questo caso il codice di errore, oltre ai valori di
903 tab.~\ref{tab:h_errno_values}, può avere anche quello di \errcode{ERANGE}
904 qualora il buffer allocato su \param{buf} non sia sufficiente a contenere i
905 dati, in tal caso si dovrà semplicemente ripetere l'esecuzione della funzione
906 con un buffer di dimensione maggiore.
908 Una delle caratteristiche delle interrogazioni al servizio DNS è che queste
909 sono normalmente eseguite con il protocollo UDP, ci sono casi in cui si
910 preferisce che vengano usate connessioni permanenti con il protocollo TCP. Per
911 ottenere questo sono previste delle funzioni apposite (si potrebbero impostare
912 direttamente le opzioni di \var{\_\_res.options}, ma queste funzioni
913 permettono di semplificare la procedura); la prime sono \funcd{sethostent} e
914 \func{endhostent}, il cui prototipo è:
918 \fdecl{void sethostent(int stayopen)}
919 \fdesc{Richiede l'uso di connessioni TCP per le interrogazioni ad un server DNS.}
920 \fdecl{void endhostent(void)}
921 \fdesc{Disattiva l'uso di connessioni TCP per le interrogazioni ad un server DNS.}
924 {Le funzioni non restituiscono nulla, e non danno errori.}
927 La funzione \func{sethostent} permette di richiedere l'uso di connessioni TCP
928 per la richiesta dei dati, e che queste restino aperte per successive
929 richieste; il valore dell'argomento \param{stayopen} indica se attivare questa
930 funzionalità, un valore diverso da zero, che indica una condizione vera in C,
931 attiva la funzionalità. Per disattivare l'uso delle connessioni TCP si può
932 invece usare \func{endhostent}, e come si vede la funzione è estremamente
933 semplice, non richiedendo nessun argomento.
935 Infine si può richiedere la risoluzione inversa di un indirizzo IP od IPv6,
936 per ottenerne il nome a dominio ad esso associato, per fare questo si può
937 usare la funzione \funcd{gethostbyaddr}, il cui prototipo è:
942 \fdecl{struct hostent *gethostbyaddr(const char *addr, int len, int type)}
943 \fdesc{Richiede la risoluzione inversa di un indirizzo IP.}
946 {La funzione ritorna l'indirizzo ad una struttura \struct{hostent} in caso di
947 successo e \val{NULL} per un errore.}
950 In questo caso l'argomento \param{addr} dovrà essere il puntatore ad una
951 appropriata struttura contenente il valore dell'indirizzo IP (o IPv6) che si
952 vuole risolvere. L'uso del tipo \texttt{char *} per questo argomento è
953 storico, il dato dovrà essere fornito in una struttura \struct{in\_addr} per
954 un indirizzo IPv4 ed una struttura \struct{in6\_addr} per un indirizzo IPv6.
956 Si ricordi inoltre, come illustrato in fig.~\ref{fig:sock_sa_ipv4_struct}, che
957 mentre \struct{in\_addr} corrisponde in realtà ad un oridinario numero intero
958 a 32 bit (da esprimere comunque in \textit{network order}) non altrettanto
959 avviene per \struct{in6\_addr}, pertanto è sempre opportuno inizializzare
960 questi indirizzi con \func{inet\_pton} (vedi
961 sez.~\ref{sec:sock_conv_func_gen}).
963 Nell'argomento \param{len} se ne dovrà poi specificare la dimensione
964 (rispettivamente 4 o 16), infine l'argomento
965 \param{type} deve indicare il tipo di indirizzo, e dovrà essere o
966 \const{AF\_INET} o \const{AF\_INET6}.
968 La funzione restituisce, in caso di successo, un puntatore ad una struttura
969 \struct{hostent}, solo che in questo caso la ricerca viene eseguita
970 richiedendo al DNS un record di tipo \texttt{PTR} corrispondente all'indirizzo
971 specificato. In caso di errore al solito viene usata la variabile
972 \var{h\_errno} per restituire un opportuno codice. In questo caso l'unico
973 campo del risultato che interessa è \var{h\_name} che conterrà il nome a
974 dominio, la funzione comunque inizializza anche il primo campo della lista
975 \var{h\_addr\_list} col valore dell'indirizzo passato come argomento.
977 Dato che \func{gethostbyaddr} usa un buffer statico, anche di questa funzione
978 esiste una versione rientrante \funcd{gethostbyaddr\_r} fornita come
979 estensione dalle \acr{glibc}, il cui prototipo è:
984 \fdecl{struct hostent *gethostbyaddr\_r(const void *addr, socklen\_t len, int type,\\
985 \phantom{struct hostent *gethostbyaddr\_r(}struct hostent *ret, char *buf, size\_t buflen,\\
986 \phantom{struct hostent *gethostbyaddr\_r(}struct hostent **result, int *h\_errnop);}
987 \fdesc{Richiede la risoluzione inversa di un indirizzo IP.}
990 {La funzione ritorna $0$ in caso di successo e un valore non nullo per un errore.}
993 La funzione prende per gli argomenti \param{addr}, \param{len} e \param{type}
994 gli stessi valori di \func{gethostbyaddr} con lo stesso significato, gli
995 argomenti successivi vengono utilizzati per restituire i dati, sono identici a
996 quelli già illustrati in per \func{gethostbyname\_r} e
997 \func{gethostbyname2\_r} e devono essere usati allo stesso modo.
999 Infine lo standard POSIX prevede la presenza della funzione
1000 \funcd{gethostent}, il cui prototipo è:
1004 \fdecl{struct hostent *gethostent(void)}
1005 \fdesc{Ottiene la voce successiva nel database dei nomi a dominio.}
1008 {La funzione ritorna l'indirizzo ad una struttura \struct{hostent} in caso di
1009 successo e \val{NULL} per un errore.}
1012 La funzione dovrebbe ritornare (come puntatore alla solita struttura
1013 \struct{hostent} allocata internamente) la voce successiva nel database dei
1014 nomi a dominio, ma questo ha un significato soltato quando è relativo alla
1015 lettura dei dati da un file come \conffile{/etc/hosts} e non per i risultati
1016 del DNS. Nel caso della \acr{glibc} questa viene usata allora solo per la
1017 lettura delle voci presenti in quest'ultimo, come avviene anche in altri
1018 sistemi unix-like, ed inoltre ignora le voci relative ad indirizzi IPv6.
1020 Della stessa funzione le \acr{glibc} forniscono anche una versione rientrante
1021 \funcd{gethostent\_r}, il cui prototipo è:
1025 \fdecl{struct hostent *gethostent\_r(struct hostent *ret, char *buf, size\_t buflen,\\
1026 \phantom{struct hostent *gethostent\_r(}struct hostent **result, int *h\_errnop);}
1027 \fdesc{Ottiene la voce successiva nel database dei nomi a dominio.}
1030 {La funzione ritorna $0$ in caso di successo e un valore non nullo per un errore.}
1033 La funzione ha lo stesso effetto di \func{gethostent}; gli argomenti servono a
1034 restituire i risultati in maniera rientrante e vanno usati secondo le modalità
1035 già illustrate per \func{gethostbyname\_r} e \func{gethostbyname2\_r}.
1037 Dati i limiti delle funzioni \func{gethostbyname} e \func{gethostbyaddr} con
1038 l'uso di memoria statica che può essere sovrascritta fra due chiamate
1039 successive, e per avere sempre la possibilità di indicare esplicitamente il
1040 tipo di indirizzi voluto (cosa che non è possibile con \func{gethostbyname}),
1041 è stata successivamente proposta,
1042 nell'\href{http://www.ietf.org/rfc/rfc2553.txt}{RFC~2553} un diversa
1043 interfaccia con l'introduzione due nuove funzioni di
1044 risoluzione,\footnote{dette funzioni sono presenti nelle \acr{glibc} versione
1045 2.1.96, ma essendo considerate deprecate (vedi
1046 sez.~\ref{sec:sock_advanced_name_services}) sono state rimosse nelle
1047 versioni successive.} \funcd{getipnodebyname} e \funcd{getipnodebyaddr}, i
1053 \fhead{sys/socket.h}
1054 \fdecl{struct hostent *getipnodebyname(const char *name, int af, int
1055 flags, int *error\_num)}
1056 \fdesc{Richiede la risoluzione di un nome a dominio.}
1057 \fdecl{struct hostent *getipnodebyaddr(const void *addr, size\_t len,
1058 int af, int *error\_num)}
1059 \fdesc{Richiede la risoluzione inversa di un indirizzo IP.}
1062 {Le funzioni ritornano l'indirizzo ad una struttura \struct{hostent} in caso
1063 di successo e \val{NULL} per un errore.}
1066 Entrambe le funzioni supportano esplicitamente la scelta di una famiglia di
1067 indirizzi con l'argomento \param{af} (che può assumere i valori
1068 \const{AF\_INET} o \const{AF\_INET6}), e restituiscono un codice di errore
1069 (con valori identici a quelli precedentemente illustrati in
1070 tab.~\ref{tab:h_errno_values}) nella variabile puntata da \param{error\_num}.
1071 La funzione \func{getipnodebyaddr} richiede poi che si specifichi l'indirizzo
1072 come per \func{gethostbyaddr} passando anche la lunghezza dello stesso
1073 nell'argomento \param{len}.
1075 La funzione \func{getipnodebyname} prende come primo argomento il nome da
1076 risolvere, inoltre prevede un apposito argomento \param{flags}, da usare come
1077 maschera binaria, che permette di specificarne il comportamento nella
1078 risoluzione dei diversi tipi di indirizzi (IPv4 e IPv6); ciascun bit
1079 dell'argomento esprime una diversa opzione, e queste possono essere specificate
1080 con un OR aritmetico delle costanti riportate in
1081 tab.~\ref{tab:sock_getipnodebyname_flags}.
1086 \begin{tabular}[c]{|l|p{8cm}|}
1088 \textbf{Costante} & \textbf{Significato} \\
1091 \constd{AI\_V4MAPPED} & Usato con \const{AF\_INET6} per richiedere una
1092 ricerca su un indirizzo IPv4 invece che IPv6; gli
1093 eventuali risultati saranno rimappati su indirizzi
1095 \constd{AI\_ALL} & Usato con \const{AI\_V4MAPPED}; richiede sia
1096 indirizzi IPv4 che IPv6, e gli indirizzi IPv4
1097 saranno rimappati in IPv6.\\
1098 \constd{AI\_ADDRCONFIG}& Richiede che una richiesta IPv4 o IPv6 venga
1099 eseguita solo se almeno una interfaccia del
1100 sistema è associata ad un indirizzo di tale tipo.\\
1101 \constd{AI\_DEFAULT} & Il valore di default, è equivalente alla
1102 combinazione di \const{AI\_ADDRCONFIG} e di
1103 \const{AI\_V4MAPPED}.\\
1106 \caption{Valori possibili per i bit dell'argomento \param{flags} della
1107 funzione \func{getipnodebyname}.}
1108 \label{tab:sock_getipnodebyname_flags}
1111 Entrambe le funzioni restituiscono un puntatore ad una struttura \var{hostent}
1112 che contiene i risultati della ricerca, che viene allocata dinamicamente
1113 insieme a tutto lo spazio necessario a contenere i dati in essa referenziati;
1114 per questo motivo queste funzioni non soffrono dei problemi dovuti all'uso di
1115 una sezione statica di memoria presenti con le precedenti \func{gethostbyname}
1116 e \func{gethostbyaddr}. L'uso di una allocazione dinamica però comporta anche
1117 la necessità di disallocare esplicitamente la memoria occupata dai risultati
1118 una volta che questi non siano più necessari; a tale scopo viene fornita la
1119 funzione \funcd{freehostent}, il cui prototipo è:
1124 \fhead{sys/socket.h}
1125 \fdecl{void freehostent(struct hostent *ip)}
1126 \fdesc{Disalloca una struttura \var{hostent}.}
1129 {La funzione non ritorna nulla, e non da errori.}
1132 La funzione permette di disallocare una struttura \var{hostent}
1133 precedentemente allocata in una chiamata di \func{getipnodebyname} o
1134 \func{getipnodebyaddr}, e prende come argomento l'indirizzo restituito da una
1137 Infine per concludere la nostra panoramica sulle funzioni di risoluzione dei
1138 nomi dobbiamo citare le funzioni che permettono di interrogare gli altri
1139 servizi di risoluzione dei nomi illustrati in sez.~\ref{sec:sock_resolver}; in
1140 generale infatti ci sono una serie di funzioni nella forma
1141 \texttt{get\textsl{XXX}byname} e \texttt{get\textsl{XXX}byaddr} (dove
1142 \texttt{\textsl{XXX}} indica il servizio) per ciascuna delle informazioni di
1143 rete mantenute dal \textit{Name Service Switch} che permettono rispettivamente
1144 di trovare una corrispondenza cercando per nome o per numero.
1146 L'elenco di queste funzioni è riportato nelle colonne finali di
1147 tab.~\ref{tab:name_resolution_functions}, dove le si sono suddivise rispetto
1148 al tipo di informazione che forniscono (riportato in prima colonna). Nella
1149 tabella si è anche riportato il file su cui vengono ordinariamente mantenute
1150 queste informazioni, che però può essere sostituito da un qualunque supporto
1151 interno al \textit{Name Service Switch} (anche se usualmente questo avviene
1152 solo per la risoluzione degli indirizzi). Ciascuna funzione fa riferimento ad
1153 una sua apposita struttura che contiene i relativi dati, riportata in terza
1159 \begin{tabular}[c]{|l|l|l|l|l|}
1161 \textbf{Informazione}&\textbf{File}&\textbf{Struttura}&
1162 \multicolumn{2}{|c|}{\textbf{Funzioni}}\\
1165 indirizzo &\conffile{/etc/hosts}&\struct{hostent}&\func{gethostbyname}&
1166 \func{gethostbyaddr}\\
1167 servizio &\conffile{/etc/services}&\struct{servent}&\func{getservbyname}&
1168 \func{getservbyport}\\
1169 rete &\conffile{/etc/networks}&\struct{netent}&\funcm{getnetbyname}&
1170 \funcm{getnetbyaddr}\\
1171 protocollo&\conffile{/etc/protocols}&\struct{protoent}&
1172 \funcm{getprotobyname}&\funcm{getprotobyaddr}\\
1175 \caption{Funzioni di risoluzione dei nomi per i vari servizi del
1176 \textit{Name Service Switch} riguardanti la rete.}
1177 \label{tab:name_resolution_functions}
1180 Delle funzioni di tab.~\ref{tab:name_resolution_functions} abbiamo trattato
1181 finora soltanto quelle relative alla risoluzione dei nomi, dato che sono le
1182 più usate, e prevedono praticamente da sempre la necessità di rivolgersi ad
1183 una entità esterna; per le altre invece, estensioni fornite dal \textit{Name
1184 Service Switch} a parte, si fa sempre riferimento ai dati mantenuti nei
1187 Dopo la risoluzione dei nomi a dominio una delle ricerche più comuni è quella
1188 sui nomi dei servizi di rete più comuni (cioè \texttt{http}, \texttt{smtp},
1189 ecc.) da associare alle rispettive porte. Le due funzioni da utilizzare per
1190 questo sono \funcd{getservbyname} e \funcd{getservbyport}, che permettono
1191 rispettivamente di ottenere il numero di porta associato ad un servizio dato
1192 il nome e viceversa; i loro prototipi sono:
1198 \fdecl{struct servent *getservbyname(const char *name, const char *proto)}
1199 \fdecl{struct servent *getservbyport(int port, const char *proto)}
1200 \fdesc{Risolvono il nome di un servizio nel rispettivo numero di porta e viceversa.}
1203 {Le funzioni ritornano il puntatore ad una struttura \struct{servent} con i
1204 risultati in caso di successo e \val{NULL} per un errore.}
1207 Entrambe le funzioni prendono come ultimo argomento una stringa \param{proto}
1208 che indica il protocollo per il quale si intende effettuare la ricerca (le
1209 informazioni mantenute in \conffile{/etc/services} infatti sono relative sia
1210 alle porte usate su UDP che su TCP, occorre quindi specificare a quale dei due
1211 protocolli si fa riferimento) che nel caso di IP può avere come valori
1212 possibili solo \texttt{udp} o \texttt{tcp};\footnote{in teoria si potrebbe
1213 avere un qualunque protocollo fra quelli citati in
1214 \conffile{/etc/protocols}, posto che lo stesso supporti il concetto di
1215 \textsl{porta}, in pratica questi due sono gli unici presenti.} se si
1216 specifica un puntatore nullo la ricerca sarà eseguita su un protocollo
1219 Il primo argomento è il nome del servizio per \func{getservbyname},
1220 specificato tramite la stringa \param{name}, mentre \func{getservbyport}
1221 richiede il numero di porta in \param{port}. Entrambe le funzioni eseguono una
1222 ricerca sul file \conffile{/etc/services}\footnote{il \textit{Name Service
1223 Switch} astrae il concetto a qualunque supporto su cui si possano
1224 mantenere i suddetti dati.} ed estraggono i dati dalla prima riga che
1225 corrisponde agli argomenti specificati; se la risoluzione ha successo viene
1226 restituito un puntatore ad una apposita struttura \struct{servent} contenente
1227 tutti i risultati, altrimenti viene restituito un puntatore nullo. Si tenga
1228 presente che anche in questo caso i dati vengono mantenuti in una area di
1229 memoria statica e che quindi la funzione non è rientrante.
1231 \begin{figure}[!htb]
1232 \footnotesize \centering
1233 \begin{minipage}[c]{0.80\textwidth}
1234 \includestruct{listati/servent.h}
1236 \caption{La struttura \structd{servent} per la risoluzione dei nomi dei
1237 servizi e dei numeri di porta.}
1238 \label{fig:sock_servent_struct}
1241 La definizione della struttura \struct{servent} è riportata in
1242 fig.~\ref{fig:sock_servent_struct}, il primo campo, \var{s\_name} contiene
1243 sempre il nome canonico del servizio, mentre \var{s\_aliases} è un puntatore
1244 ad un vettore di stringhe contenenti gli eventuali nomi alternativi
1245 utilizzabili per identificare lo stesso servizio. Infine \var{s\_port}
1246 contiene il numero di porta e \var{s\_proto} il nome del protocollo.
1248 Come riportato in tab.~\ref{tab:name_resolution_functions} ci sono analoghe
1249 funzioni per la risoluzione del nome dei protocolli e delle reti; non staremo
1250 a descriverle nei dettagli, in quanto il loro uso è molto limitato, esse
1251 comunque utilizzano una loro struttura dedicata del tutto analoga alle
1252 precedenti: tutti i dettagli relativi al loro funzionamento possono essere
1253 trovati nelle rispettive pagine di manuale.
1255 Oltre alle funzioni di ricerca esistono delle ulteriori funzioni che prevedono
1256 una lettura sequenziale delle informazioni mantenute nel \textit{Name Service
1257 Switch} (in sostanza permettono di leggere i file contenenti le informazioni
1258 riga per riga), che sono analoghe a quelle elencate in
1259 tab.~\ref{tab:sys_passwd_func} per le informazioni relative ai dati degli
1260 utenti e dei gruppi. Nel caso specifico dei servizi avremo allora le tre
1261 funzioni \funcd{setservent}, \funcd{getservent} e \funcd{endservent} i cui
1266 \fdecl{struct servent *getservent(void)}
1267 \fdesc{Legge la voce successiva nel file \conffile{/etc/services}.}
1268 \fdecl{void setservent(int stayopen)}
1269 \fdesc{Apre il file \conffile{/etc/services} e si posiziona al suo inizio.}
1270 \fdecl{void endservent(void)}
1271 \fdesc{Chiude il file \conffile{/etc/services}.}
1274 {Le due funzioni \func{setservent} e \func{endservent} non ritornano nulla,
1275 \func{getservent} restituisce il puntatore ad una struttura \struct{servent}
1276 in caso di successo e \val{NULL} per un errore o fine del file.}
1279 La prima funzione, \func{getservent}, legge una singola voce a partire dalla
1280 posizione corrente in \conffile{/etc/services}, pertanto si può eseguire una
1281 lettura sequenziale dello stesso invocandola più volte. Se il file non è
1282 aperto provvede automaticamente ad aprirlo, nel qual caso leggerà la prima
1283 voce. La seconda funzione, \func{setservent}, permette di aprire il file
1284 \conffile{/etc/services} per una successiva lettura, ma se il file è già stato
1285 aperto riporta la posizione di lettura alla prima voce del file, in questo
1286 modo si può far ricominciare da capo una lettura sequenziale.
1291 \begin{tabular}[c]{|l|l|l|l|}
1293 \textbf{Informazione}&\multicolumn{3}{|c|}{\textbf{Funzioni}}\\
1296 indirizzo &\func{sethostent} &\func{gethostent} &\func{endhostent} \\
1297 servizio &\func{setservent} &\func{getservent} &\func{endservent}\\
1298 rete &\funcm{setnetent} &\funcm{getnetent} &\funcm{endnetent}\\
1299 protocollo&\funcm{setprotoent}&\funcm{getprotoent}&\funcm{endprotoent}\\
1302 \caption{Funzioni lettura sequenziale dei dati del
1303 \textit{Name Service Switch}.}
1304 \label{tab:name_sequential_read}
1307 L'argomento \param{stayopen} di \func{setservent}, se diverso da zero, fa sì
1308 che il file resti aperto anche fra diverse chiamate a \func{getservbyname} e
1309 \func{getservbyport}; di default dopo una chiamata a queste funzioni il file
1310 viene chiuso, cosicché una successiva chiamata a \func{getservent} riparte
1311 dall'inizio. La terza funzione, \func{endservent}, provvede semplicemente a
1314 Queste tre funzioni per la lettura sequenziale di nuovo sono presenti per
1315 ciascuno dei vari tipi di informazione relative alle reti di
1316 tab.~\ref{tab:name_resolution_functions}; questo significa che esistono
1317 altrettante funzioni nella forma \texttt{setXXXent}, \texttt{getXXXent} e
1318 \texttt{endXXXent}, analoghe alle precedenti per la risoluzione dei servizi,
1319 che abbiamo riportato in tab.~\ref{tab:name_sequential_read}. Essendo, a
1320 parte il tipo di informazione che viene trattato, sostanzialmente identiche
1321 nel funzionamento e di scarso utilizzo, non staremo a trattarle una per una,
1322 rimandando alle rispettive pagine di manuale.
1325 \subsection{Le funzioni avanzate per la risoluzione dei nomi}
1326 \label{sec:sock_advanced_name_services}
1328 Quelle illustrate nella sezione precedente sono le funzioni classiche per la
1329 risoluzione di nomi ed indirizzi IP, ma abbiamo già visto come esse soffrano
1330 di vari inconvenienti come il fatto che usano informazioni statiche, e non
1331 prevedono la possibilità di avere diverse classi di indirizzi. Anche se sono
1332 state create delle estensioni o metodi diversi che permettono di risolvere
1333 alcuni di questi inconvenienti, comunque esse non forniscono una interfaccia
1334 sufficientemente generica.\footnote{rimane ad esempio il problema generico che
1335 si deve sapere in anticipo quale tipo di indirizzi IP (IPv4 o IPv6)
1336 corrispondono ad un certo nome a dominio.}
1338 Inoltre in genere quando si ha a che fare con i socket non esiste soltanto il
1339 problema della risoluzione del nome che identifica la macchina, ma anche
1340 quello del servizio a cui ci si vuole rivolgere. Per questo motivo con lo
1341 standard POSIX 1003.1-2001 sono state indicate come deprecate le varie
1342 funzioni \func{gethostbyaddr}, \func{gethostbyname}, \var{getipnodebyname} e
1343 \var{getipnodebyaddr} ed è stata introdotta una interfaccia completamente
1346 La prima funzione di questa interfaccia è \funcd{getaddrinfo}, che combina le
1347 funzionalità delle precedenti \func{getipnodebyname}, \func{getipnodebyaddr},
1348 \func{getservbyname} e \func{getservbyport}, consentendo di ottenere
1349 contemporaneamente sia la risoluzione di un indirizzo simbolico che del nome
1350 di un servizio; la funzione è stata introdotta, insieme a \func{getnameinfo}
1351 che vedremo più avanti,
1352 nell'\href{http://www.ietf.org/rfc/rfc2553.txt}{RFC~2553} ed il suo prototipo è:
1357 \fhead{sys/socket.h}
1358 \fdecl{int getaddrinfo(const char *node, const char *service, const
1359 struct addrinfo *hints, \\
1360 \phantom{int getaddrinfo(}struct addrinfo **res)}
1361 \fdesc{Esegue una risoluzione di un nome a dominio e di un nome di servizio.}
1364 {La funzione ritorna $0$ in caso di successo e un codice di errore diverso da
1365 zero per un errore.}
1368 La funzione prende come primo argomento il nome della macchina che si vuole
1369 risolvere, specificato tramite la stringa \param{node}. Questo argomento,
1370 oltre ad un comune nome a dominio, può indicare anche un indirizzo numerico in
1371 forma \textit{dotted-decimal} per IPv4 o in formato esadecimale per IPv6. Si
1372 può anche specificare il nome di una rete invece che di una singola macchina.
1373 Il secondo argomento, \param{service}, specifica invece il nome del servizio
1374 che si intende risolvere. Per uno dei due argomenti si può anche usare il
1375 valore \val{NULL}, nel qual caso la risoluzione verrà effettuata soltanto
1376 sulla base del valore dell'altro.
1378 Il terzo argomento, \param{hints}, deve essere invece un puntatore ad una
1379 struttura \struct{addrinfo} usata per dare dei \textsl{suggerimenti} al
1380 procedimento di risoluzione riguardo al protocollo o del tipo di socket che si
1381 intenderà utilizzare; \func{getaddrinfo} infatti permette di effettuare
1382 ricerche generiche sugli indirizzi, usando sia IPv4 che IPv6, e richiedere
1383 risoluzioni sui nomi dei servizi indipendentemente dal protocollo (ad esempio
1384 TCP o UDP) che questi possono utilizzare.
1386 Come ultimo argomento in \param{res} deve essere passato un puntatore ad una
1387 variabile (di tipo puntatore ad una struttura \struct{addrinfo}) che verrà
1388 utilizzata dalla funzione per riportare (come \textit{value result argument})
1389 i propri risultati. La funzione infatti è rientrante, ed alloca autonomamente
1390 tutta la memoria necessaria in cui verranno riportati i risultati della
1391 risoluzione. La funzione scriverà all'indirizzo puntato da \param{res} il
1392 puntatore iniziale ad una \textit{linked list} di strutture di tipo
1393 \struct{addrinfo} contenenti tutte le informazioni ottenute.
1395 \begin{figure}[!htb]
1396 \footnotesize \centering
1397 \begin{minipage}[c]{0.90\textwidth}
1398 \includestruct{listati/addrinfo.h}
1400 \caption{La struttura \structd{addrinfo} usata nella nuova interfaccia POSIX
1401 per la risoluzione di nomi a dominio e servizi.}
1402 \label{fig:sock_addrinfo_struct}
1405 Come illustrato la struttura \struct{addrinfo}, la cui definizione è riportata
1406 in fig.~\ref{fig:sock_addrinfo_struct}, viene usata sia in ingresso, per
1407 passare dei valori di controllo alla funzione, che in uscita, per ricevere i
1408 risultati. La definizione è ripresa direttamente dal file \headfiled{netdb.h}
1409 in cui questa struttura viene dichiarata, la pagina di manuale riporta
1410 \type{size\_t} come tipo di dato per il campo \var{ai\_addrlen}, qui viene
1411 usata quanto previsto dallo standard POSIX, in cui viene utilizzato
1412 \type{socklen\_t}; i due tipi di dati sono comunque equivalenti.
1414 Il primo campo, \var{ai\_flags}, è una maschera binaria di bit che
1415 permettono di controllare le varie modalità di risoluzione degli indirizzi,
1416 che viene usato soltanto in ingresso. I tre campi successivi \var{ai\_family},
1417 \var{ai\_socktype}, e \var{ai\_protocol} contengono rispettivamente la
1418 famiglia di indirizzi, il tipo di socket e il protocollo, in ingresso vengono
1419 usati per impostare una selezione (impostandone il valore nella struttura
1420 puntata da \param{hints}), mentre in uscita indicano il tipo di risultato
1421 contenuto nella struttura.
1423 Tutti i campi seguenti vengono usati soltanto in uscita e devono essere nulli
1424 o \val{NULL} in ingresso; il campo \var{ai\_addrlen} indica la dimensione
1425 della struttura degli indirizzi ottenuta come risultato, il cui contenuto sarà
1426 memorizzato nella struttura \struct{sockaddr} posta all'indirizzo puntato dal
1427 campo \var{ai\_addr}. Il campo \var{ai\_canonname} è un puntatore alla stringa
1428 contenente il nome canonico della macchina, ed infine, quando la funzione
1429 restituisce più di un risultato, \var{ai\_next} è un puntatore alla successiva
1430 struttura \struct{addrinfo} della lista.
1432 Ovviamente non è necessario dare dei suggerimenti in ingresso, ed usando
1433 \val{NULL} come valore per l'argomento \param{hints} si possono compiere
1434 ricerche generiche. Se però si specifica un valore non nullo questo deve
1435 puntare ad una struttura \struct{addrinfo} precedentemente allocata nella
1436 quale siano stati opportunamente impostati i valori dei campi
1437 \var{ai\_family}, \var{ai\_socktype}, \var{ai\_protocol} ed \var{ai\_flags}.
1439 I due campi \var{ai\_family} e \var{ai\_socktype} prendono gli stessi valori
1440 degli analoghi argomenti della funzione \func{socket}; in particolare per
1441 \var{ai\_family} si possono usare i valori di tab.~\ref{tab:net_pf_names} ma
1442 sono presi in considerazione solo \const{AF\_INET} e \const{AF\_INET6}, mentre
1443 se non si vuole specificare nessuna famiglia di indirizzi si può usare il
1444 valore \const{AF\_UNSPEC}. Allo stesso modo per \var{ai\_socktype} si possono
1445 usare i valori illustrati in sez.~\ref{sec:sock_type} per indicare per quale
1446 tipo di socket si vuole risolvere il servizio indicato, anche se i soli
1447 significativi sono \const{SOCK\_STREAM} e \const{SOCK\_DGRAM}; in questo caso,
1448 se non si vuole effettuare nessuna risoluzione specifica, si potrà usare un
1451 Il campo \var{ai\_protocol} permette invece di effettuare la selezione dei
1452 risultati per il nome del servizio usando il numero identificativo del
1453 rispettivo protocollo di trasporto (i cui valori possibili sono riportati in
1454 \conffile{/etc/protocols}); di nuovo i due soli valori utilizzabili sono quelli
1455 relativi a UDP e TCP, o il valore nullo che indica di ignorare questo campo
1461 \begin{tabular}[c]{|l|p{8cm}|}
1463 \textbf{Costante} & \textbf{Significato} \\
1466 \const{AI\_ADDRCONFIG} & Stesso significato dell'analoga di
1467 tab.~\ref{tab:sock_getipnodebyname_flags}.\\
1468 \const{AI\_ALL} & Stesso significato dell'analoga di
1469 tab.~\ref{tab:sock_getipnodebyname_flags}.\\
1470 \constd{AI\_CANONNAME} & Richiede la restituzione del nome canonico della
1471 macchina, che verrà salvato in una stringa il cui
1472 indirizzo sarà restituito nel campo
1473 \var{ai\_canonname} della prima struttura
1474 \struct{addrinfo} dei risultati. Se il nome
1475 canonico non è disponibile al suo posto
1476 viene restituita una copia di \param{node}. \\
1477 \constd{AI\_NUMERICHOST}& Se impostato il nome della macchina specificato
1478 con \param{node} deve essere espresso in forma
1479 numerica, altrimenti sarà restituito un errore
1480 \const{EAI\_NONAME} (vedi
1481 tab.~\ref{tab:addrinfo_error_code}), in questo
1482 modo si evita ogni chiamata alle funzioni di
1484 \constd{AI\_NUMERICSERVICE}& Analogo di \const{AI\_NUMERICHOST} per la
1485 risoluzione di un servizio, con
1486 \param{service} che deve essere espresso in forma
1488 \constd{AI\_PASSIVE} & Viene utilizzato per ottenere un indirizzo in
1489 formato adatto per una successiva chiamata a
1490 \func{bind}. Se specificato quando si è usato
1491 \val{NULL} come valore per \param{node} gli
1492 indirizzi restituiti saranno inizializzati al
1493 valore generico (\const{INADDR\_ANY} per IPv4 e
1494 \const{IN6ADDR\_ANY\_INIT} per IPv6), altrimenti
1495 verrà usato l'indirizzo dell'interfaccia di
1496 \textit{loopback}. Se invece non è impostato gli
1497 indirizzi verranno restituiti in formato adatto ad
1498 una chiamata a \func{connect} o \func{sendto}.\\
1499 \const{AI\_V4MAPPED} & Stesso significato dell'analoga di
1500 tab.~\ref{tab:sock_getipnodebyname_flags}.\\
1502 \const{AI\_CANONIDN} & Se il nome canonico richiesto con
1503 \const{AI\_CANONNAME} è codificato con questo
1504 flag la codifica viene convertita in forma
1505 leggibile nella localizzazione corrente.\\
1506 \const{AI\_IDN} & Se specificato il nome viene convertito, se
1507 necessario, nella codifica IDN, usando la
1508 localizzazione corrente.\\
1509 \const{AI\_IDN\_ALLOW\_UNASSIGNED} & attiva il controllo
1510 \texttt{IDNA\_ALLOW\_UNASSIGNED}.\\
1511 \const{AI\_AI\_IDN\_USE\_STD3\_ASCII\_RULES} & attiva il controllo
1512 \texttt{IDNA\_USE\_STD3\_ASCII\_RULES}\\
1515 \caption{Costanti associate ai bit del campo \var{ai\_flags} della struttura
1517 \label{tab:ai_flags_values}
1520 % TODO mettere riferimento a IDNA_ALLOW_UNASSIGNED e IDNA_USE_STD3_ASCII_RULES
1522 Infine gli ultimi dettagli si controllano con il campo \var{ai\_flags}; che
1523 deve essere impostato come una maschera binaria; i bit di questa variabile
1524 infatti vengono usati per dare delle indicazioni sul tipo di risoluzione
1525 voluta, ed hanno valori analoghi a quelli visti in
1526 sez.~\ref{sec:sock_name_services} per \func{getipnodebyname}; il valore di
1527 \var{ai\_flags} può essere impostata con un OR aritmetico delle costanti di
1528 tab.~\ref{tab:ai_flags_values}, ciascuna delle quali identifica un bit della
1531 Nella seconda parte della tabella si sono riportati i valori delle costanti
1532 aggiunte a partire dalle \acr{glibc} 2.3.4 per gestire la
1533 internazionalizazione dei nomi a dominio (IDN o \textit{Internationalized
1534 Domain Names}) secondo quanto specificato
1535 nell'\href{http://www.ietf.org/rfc/rfc3490.txt}{RFC~3490} (potendo cioè usare
1536 codifiche di caratteri che consentono l'espressione di nomi a dominio in
1539 Come accennato passando un valore \val{NULL} per l'argomento \param{hints} si
1540 effettua una risuluzione generica, equivalente ad aver impostato un valore
1541 nullo per \var{ai\_family} e \var{ai\_socktype}, un valore \const{AF\_UNSPEC}
1542 per \var{ai\_family} e il valore \code{(AI\_V4MAPPED|AI\_ADDRCONFIG)} per
1545 La funzione restituisce un valore nullo in caso di successo, o un codice in
1546 caso di errore. I valori usati come codice di errore sono riportati in
1547 tab.~\ref{tab:addrinfo_error_code}; dato che la funzione utilizza altre
1548 funzioni e chiamate al sistema per ottenere il suo risultato in generale il
1549 valore di \var{errno} non è significativo, eccetto il caso in cui si sia
1550 ricevuto un errore di \const{EAI\_SYSTEM}, nel qual caso l'errore
1551 corrispondente è riportato tramite \var{errno}.
1556 \begin{tabular}[c]{|l|p{10cm}|}
1558 \textbf{Costante} & \textbf{Significato} \\
1561 \constd{EAI\_ADDRFAMILY}& La richiesta non ha nessun indirizzo di rete
1562 per la famiglia di indirizzi specificata. \\
1563 \constd{EAI\_AGAIN} & Il DNS ha restituito un errore di risoluzione
1564 temporaneo, si può ritentare in seguito. \\
1565 \constd{EAI\_BADFLAGS}& Il campo \var{ai\_flags} contiene dei valori non
1566 validi per i flag o si è richiesto
1567 \const{AI\_CANONNAME} con \param{name} nullo. \\
1568 \constd{EAI\_FAIL} & Il DNS ha restituito un errore di risoluzione
1570 \constd{EAI\_FAMILY} & La famiglia di indirizzi richiesta non è
1572 \constd{EAI\_MEMORY} & È stato impossibile allocare la memoria necessaria
1574 \constd{EAI\_NODATA} & La macchina specificata esiste, ma non ha nessun
1575 indirizzo di rete definito. \\
1576 \constd{EAI\_NONAME} & Il nome a dominio o il servizio non sono noti,
1577 viene usato questo errore anche quando si specifica
1578 il valore \val{NULL} per entrambi gli argomenti
1579 \param{node} e \param{service}. \\
1580 \constd{EAI\_SERVICE} & Il servizio richiesto non è disponibile per il tipo
1581 di socket richiesto, anche se può esistere per
1582 altri tipi di socket. \\
1583 \constd{EAI\_SOCKTYPE}& Il tipo di socket richiesto non è supportato. \\
1584 \constd{EAI\_SYSTEM} & C'è stato un errore di sistema, si può controllare
1585 \var{errno} per i dettagli. \\
1587 % TODO estensioni GNU, trovarne la documentazione
1588 % \constd{EAI\_INPROGRESS}& Richiesta in corso. \\
1589 % \constd{EAI\_CANCELED}& La richiesta è stata cancellata.\\
1590 % \constd{EAI\_NOTCANCELED}& La richiesta non è stata cancellata. \\
1591 % \constd{EAI\_ALLDONE} & Tutte le richieste sono complete. \\
1592 % \constd{EAI\_INTR} & Richiesta interrotta. \\
1595 \caption{Costanti associate ai valori dei codici di errore della funzione
1596 \func{getaddrinfo}.}
1597 \label{tab:addrinfo_error_code}
1600 Come per i codici di errore di \func{gethostbyname} anche in questo caso è
1601 fornita una apposita funzione, simile a \func{strerror}, che consente di
1602 utilizzare direttamente il codice restituito dalla funzione per stampare a
1603 video un messaggio esplicativo; la funzione è \funcd{gai\_strerror} ed il suo
1608 \fdecl{const char *gai\_strerror(int errcode)}
1609 \fdesc{Fornisce il messaggio corrispondente ad un errore di \func{getaddrinfo}.}
1612 {La funzione ritorna il puntatore alla stringa contenente il messaggio di
1616 La funzione restituisce un puntatore alla stringa contenente il messaggio
1617 corrispondente dal codice di errore \param{errcode} ottenuto come valore di
1618 ritorno di \func{getaddrinfo}. La stringa è allocata staticamente, ma essendo
1619 costante ed accessibile in sola lettura, la funzione è rientrante.
1621 Dato che ad un certo nome a dominio possono corrispondere più indirizzi IP
1622 (sia IPv4 che IPv6), e che un certo servizio può essere fornito su protocolli
1623 e tipi di socket diversi, in generale, a meno di non aver eseguito una
1624 selezione specifica attraverso l'uso di \param{hints}, si otterrà una diversa
1625 struttura \struct{addrinfo} per ciascuna possibilità.
1627 Ad esempio se si richiede la risoluzione del servizio \textit{echo} per
1628 l'indirizzo \texttt{www.truelite.it}, e si imposta \const{AI\_CANONNAME} per
1629 avere anche la risoluzione del nome canonico, si avrà come risposta della
1630 funzione la lista illustrata in fig.~\ref{fig:sock_addrinfo_list}.
1632 \begin{figure}[!htb]
1634 \includegraphics[width=10cm]{img/addrinfo_list}
1635 \caption{La \textit{linked list} delle strutture \struct{addrinfo}
1636 restituite da \func{getaddrinfo}.}
1637 \label{fig:sock_addrinfo_list}
1640 Come primo esempio di uso di \func{getaddrinfo} vediamo un programma
1641 elementare di interrogazione del \textit{resolver} basato questa funzione, il
1642 cui corpo principale è riportato in fig.~\ref{fig:mygetaddr_example}. Il
1643 codice completo del programma, compresa la gestione delle opzioni in cui è
1644 gestita l'eventuale inizializzazione dell'argomento \var{hints} per
1645 restringere le ricerche su protocolli, tipi di socket o famiglie di indirizzi,
1646 è disponibile nel file \texttt{mygetaddr.c} dei sorgenti allegati alla guida.
1648 \begin{figure}[!htb]
1649 \footnotesize \centering
1650 \begin{minipage}[c]{\codesamplewidth}
1651 \includecodesample{listati/mygetaddr.c}
1654 \caption{Esempio di codice per la risoluzione di un indirizzo.}
1655 \label{fig:mygetaddr_example}
1658 Il corpo principale inizia controllando (\texttt{\small 1--5}) il numero di
1659 argomenti passati, che devono essere sempre due, e corrispondere
1660 rispettivamente all'indirizzo ed al nome del servizio da risolvere. A questo
1661 segue la chiamata (\texttt{\small 7}) alla funzione \func{getaddrinfo}, ed il
1662 successivo controllo (\texttt{\small 8--11}) del suo corretto funzionamento,
1663 senza il quale si esce immediatamente stampando il relativo codice di errore.
1665 Se la funzione ha restituito un valore nullo il programma prosegue
1666 inizializzando (\texttt{\small 12}) il puntatore \var{ptr} che sarà usato nel
1667 successivo ciclo (\texttt{\small 14--35}) di scansione della lista delle
1668 strutture \struct{addrinfo} restituite dalla funzione. Prima di eseguire
1669 questa scansione (\texttt{\small 12}) viene stampato il valore del nome
1670 canonico che è presente solo nella prima struttura.
1672 La scansione viene ripetuta (\texttt{\small 14}) fintanto che si ha un
1673 puntatore valido. La selezione principale è fatta sul campo \var{ai\_family},
1674 che stabilisce a quale famiglia di indirizzi fa riferimento la struttura in
1675 esame. Le possibilità sono due, un indirizzo IPv4 o IPv6, se nessuna delle due
1676 si verifica si provvede (\texttt{\small 27--30}) a stampare un messaggio di
1677 errore ed uscire (questa eventualità non dovrebbe comunque mai verificarsi,
1678 almeno fintanto che la funzione \func{getaddrinfo} lavora correttamente).
1680 Per ciascuno delle due possibili famiglie di indirizzi si estraggono le
1681 informazioni che poi verranno stampate alla fine del ciclo (\texttt{\small
1682 31--34}). Il primo caso esaminato (\texttt{\small 15--21}) è quello degli
1683 indirizzi IPv4, nel qual caso prima se ne stampa l'identificazione
1684 (\texttt{\small 16}) poi si provvede a ricavare la struttura degli indirizzi
1685 (\texttt{\small 17}) indirizzata dal campo \var{ai\_addr}, eseguendo un
1686 opportuno casting del puntatore per poter estrarre da questa la porta
1687 (\texttt{\small 18}) e poi l'indirizzo (\texttt{\small 19}) che verrà
1688 convertito con una chiamata ad \func{inet\_ntop}.
1690 La stessa operazione (\texttt{\small 21--27}) viene ripetuta per gli indirizzi
1691 IPv6, usando la rispettiva struttura degli indirizzi. Si noti anche come in
1692 entrambi i casi per la chiamata a \func{inet\_ntop} si sia dovuto passare il
1693 puntatore al campo contenente l'indirizzo IP nella struttura puntata dal campo
1694 \var{ai\_addr}.\footnote{il meccanismo è complesso a causa del fatto che al
1695 contrario di IPv4, in cui l'indirizzo IP può essere espresso con un semplice
1696 numero intero, in IPv6 questo deve essere necessariamente fornito come
1697 struttura, e pertanto anche se nella struttura puntata da \var{ai\_addr}
1698 sono presenti direttamente i valori finali, per l'uso con \func{inet\_ntop}
1699 occorre comunque passare un puntatore agli stessi (ed il costrutto
1700 \code{\&addr6->sin6\_addr} è corretto in quanto l'operatore \texttt{->} ha
1701 in questo caso precedenza su \texttt{\&}).}
1703 Una volta estratte dalla struttura \struct{addrinfo} tutte le informazioni
1704 relative alla risoluzione richiesta e stampati i relativi valori, l'ultimo
1705 passo (\texttt{\small 34}) è di estrarre da \var{ai\_next} l'indirizzo della
1706 eventuale successiva struttura presente nella lista e ripetere il ciclo, fin
1707 tanto che, completata la scansione, questo avrà un valore nullo e si potrà
1708 terminare (\texttt{\small 36}) il programma.
1710 Si tenga presente che \func{getaddrinfo} non garantisce nessun particolare
1711 ordinamento della lista delle strutture \struct{addrinfo} restituite, anche se
1712 usualmente i vari indirizzi IP (se ne è presente più di uno) sono forniti
1713 nello stesso ordine in cui vengono inviati dal server DNS. In particolare
1714 nulla garantisce che vengano forniti prima i dati relativi ai servizi di un
1715 determinato protocollo o tipo di socket, se ne sono presenti di diversi. Se
1716 allora utilizziamo il nostro programma potremo verificare il risultato:
1718 [piccardi@gont sources]$ \textbf{./mygetaddr -c gapil.truelite.it echo}
1719 Canonical name sources2.truelite.it
1721 Indirizzo 62.48.34.25
1725 Indirizzo 62.48.34.25
1731 Una volta estratti i risultati dalla \textit{linked list} puntata
1732 da \param{res} se questa non viene più utilizzata si dovrà avere cura di
1733 disallocare opportunamente tutta la memoria, per questo viene fornita
1734 l'apposita funzione \funcd{freeaddrinfo}, il cui prototipo è:
1739 \fdecl{void freeaddrinfo(struct addrinfo *res)}
1740 \fdesc{Libera la memoria allocata da una precedente chiamata a \func{getaddrinfo}.}
1743 {La funzione non restituisce nessun codice di errore.}
1746 La funzione prende come unico argomento il puntatore \param{res}, ottenuto da
1747 una precedente chiamata a \func{getaddrinfo}, e scandisce la lista delle
1748 strutture per liberare tutta la memoria allocata. Dato che la funzione non ha
1749 valori di ritorno deve essere posta molta cura nel passare un valore valido
1750 per \param{res} ed usare un indirizzo non valido o già liberato può avere
1751 conseguenze non prevedibili.
1753 Si tenga presente infine che se si copiano i risultati da una delle strutture
1754 \struct{addrinfo} restituite nella lista indicizzata da \param{res}, occorre
1755 avere cura di eseguire una \textit{deep copy} in cui si copiano anche tutti i
1756 dati presenti agli indirizzi contenuti nella struttura \struct{addrinfo},
1757 perché una volta disallocati i dati con \func{freeaddrinfo} questi non
1758 sarebbero più disponibili.
1760 Anche la nuova interfaccia definita da POSIX prevede una nuova funzione per
1761 eseguire la risoluzione inversa e determinare nomi di servizi e di dominio
1762 dati i rispettivi valori numerici. La funzione che sostituisce le varie
1763 \func{gethostbyname}, \func{getipnodebyname} e \func{getservbyname} è
1764 \funcd{getnameinfo}, ed il suo prototipo è:
1768 \fhead{sys/socket.h}
1769 \fdecl{int getnameinfo(const struct sockaddr *sa, socklen\_t salen, \\
1770 \phantom{int getnameinfo(}char *host, size\_t hostlen, char *serv, size\_t
1771 servlen, int flags)}
1772 \fdesc{Effettua una risoluzione di un indirizzo di rete in maniera
1773 indipendente dal protocollo.}
1776 {La funzione ritorna $0$ in caso di successo e un codice di errore diverso da
1777 zero per un errore.}
1780 La principale caratteristica di \func{getnameinfo} è che la funzione è in
1781 grado di eseguire una risoluzione inversa in maniera indipendente dal
1782 protocollo; il suo primo argomento \param{sa} infatti è il puntatore ad una
1783 struttura degli indirizzi generica, che può contenere sia indirizzi IPv4 che
1784 IPv6, la cui dimensione deve comunque essere specificata con l'argomento
1787 I risultati della funzione saranno restituiti nelle due stringhe puntate da
1788 \param{host} e \param{serv}, che dovranno essere state precedentemente
1789 allocate per una lunghezza massima che deve essere specificata con gli altri
1790 due argomenti \param{hostlen} e \param{servlen}. Quando non si è
1791 interessati ad uno dei due, si può passare il valore \val{NULL} come argomento,
1792 così che la corrispondente informazione non venga richiesta. Infine l'ultimo
1793 argomento \param{flags} è una maschera binaria i cui bit consentono di
1794 impostare le modalità con cui viene eseguita la ricerca, e deve essere
1795 specificato attraverso l'OR aritmetico dei valori illustrati in
1796 tab.~\ref{tab:getnameinfo_flags}, nella seconda parte della tabella si sono
1797 aggiunti i valori introdotto con le \acr{glibc} 2.3.4 per gestire la
1798 internazionalizzione dei nomi a dominio.
1803 \begin{tabular}[c]{|l|p{8cm}|}
1805 \textbf{Costante} & \textbf{Significato} \\
1808 \constd{NI\_DGRAM} & Richiede che venga restituito il nome del
1809 servizio su UDP invece che quello su TCP per quei
1810 pichi servizi (porte 512-214) che soni diversi
1811 nei due protocolli.\\
1812 \constd{NI\_NOFQDN} & Richiede che venga restituita solo il nome della
1813 macchina all'interno del dominio al posto del
1814 nome completo (FQDN).\\
1815 \constd{NI\_NAMEREQD} & Richiede la restituzione di un errore se il nome
1816 non può essere risolto.\\
1817 \constd{NI\_NUMERICHOST}& Richiede che venga restituita la forma numerica
1818 dell'indirizzo (questo succede sempre se il nome
1819 non può essere ottenuto).\\
1820 \constd{NI\_NUMERICSERV}& Richiede che il servizio venga restituito in
1821 forma numerica (attraverso il numero di
1824 \const{NI\_IDN} & Se specificato il nome restituito viene convertito usando la
1825 localizzazione corrente, se necessario, nella
1827 \const{NI\_IDN\_ALLOW\_UNASSIGNED} & attiva il controllo
1828 \texttt{IDNA\_ALLOW\_UNASSIGNED}.\\
1829 \const{NI\_AI\_IDN\_USE\_STD3\_ASCII\_RULES} & attiva il controllo
1830 \texttt{IDNA\_USE\_STD3\_ASCII\_RULES}\\
1833 \caption{Costanti associate ai bit dell'argomento \param{flags} della
1834 funzione \func{getnameinfo}.}
1835 \label{tab:getnameinfo_flags}
1838 La funzione ritorna zero in caso di successo, e scrive i propri risultati agli
1839 indirizzi indicati dagli argomenti \param{host} e \param{serv} come stringhe
1840 terminate dal carattere NUL, a meno che queste non debbano essere troncate
1841 qualora la loro dimensione ecceda quelle specificate dagli argomenti
1842 \param{hostlen} e \param{servlen}. Sono comunque definite le due costanti
1843 \constd{NI\_MAXHOST} e \constd{NI\_MAXSERV}\footnote{in Linux le due costanti
1844 sono definite in \headfile{netdb.h} ed hanno rispettivamente il valore 1024
1845 e 12.} che possono essere utilizzate come limiti massimi. In caso di
1846 errore viene restituito invece un codice che assume gli stessi valori
1847 illustrati in tab.~\ref{tab:addrinfo_error_code}.
1849 A questo punto possiamo fornire degli esempi di utilizzo della nuova
1850 interfaccia, adottandola per le precedenti implementazioni del client e del
1851 server per il servizio \textit{echo}; dato che l'uso delle funzioni appena
1852 illustrate (in particolare di \func{getaddrinfo}) è piuttosto complesso,
1853 essendo necessaria anche una impostazione diretta dei campi dell'argomento
1854 \param{hints}, provvederemo una interfaccia semplificata per i due casi visti
1855 finora, quello in cui si specifica nel client un indirizzo remoto per la
1856 connessione al server, e quello in cui si specifica nel server un indirizzo
1857 locale su cui porsi in ascolto.
1859 La prima funzione della nostra interfaccia semplificata è \texttt{sockconn}
1860 che permette di ottenere un socket, connesso all'indirizzo ed al servizio
1861 specificati. Il corpo della funzione è riportato in
1862 fig.~\ref{fig:sockconn_code}, il codice completo è nel file \file{SockUtil.c}
1863 dei sorgenti allegati alla guida, che contiene varie funzioni di utilità per
1866 \begin{figure}[!htb]
1867 \footnotesize \centering
1868 \begin{minipage}[c]{\codesamplewidth}
1869 \includecodesample{listati/sockconn.c}
1872 \caption{Il codice della funzione \texttt{sockconn}.}
1873 \label{fig:sockconn_code}
1876 La funzione prende quattro argomenti, i primi due sono le stringhe che
1877 indicano il nome della macchina a cui collegarsi ed il relativo servizio su
1878 cui sarà effettuata la risoluzione; seguono il protocollo da usare (da
1879 specificare con il valore numerico di \conffile{/etc/protocols}) ed il tipo di
1880 socket (al solito specificato con i valori illustrati in
1881 sez.~\ref{sec:sock_type}). La funzione ritorna il valore del file descriptor
1882 associato al socket (un numero positivo) in caso di successo, o $-1$ in caso
1885 Per risolvere il problema di non poter passare indietro i valori di ritorno di
1886 \func{getaddrinfo} contenenti i relativi codici di errore si sono stampati i
1887 messaggi d'errore direttamente nella funzione; infatti non si può avere
1888 nessuna certezza che detti valori siano negativi e per cui stampare subito
1889 l'errore diventa necessario per evitare ogni possibile ambiguità nei confronti
1890 del valore di ritorno in caso di successo.
1892 Una volta definite le variabili occorrenti (\texttt{\small 3--5}) la funzione
1893 prima (\texttt{\small 6}) azzera il contenuto della struttura \var{hint} e poi
1894 provvede (\texttt{\small 7--9}) ad inizializzarne i valori necessari per la
1895 chiamata (\texttt{\small 10}) a \func{getaddrinfo}. Di quest'ultima si
1896 controlla (\texttt{\small 12--16}) il codice di ritorno, in modo da stampare
1897 un avviso di errore, azzerare \var{errno} ed uscire in caso di errore.
1899 Dato che ad una macchina possono corrispondere più indirizzi IP, e di tipo
1900 diverso (sia IPv4 che IPv6), mentre il servizio può essere in ascolto soltanto
1901 su uno solo di questi, si provvede a tentare la connessione per ciascun
1902 indirizzo restituito all'interno di un ciclo (\texttt{\small 18--40}) di
1903 scansione della lista restituita da \func{getaddrinfo}, ma prima
1904 (\texttt{\small 17}) si salva il valore del puntatore per poterlo riutilizzare
1905 alla fine per disallocare la lista.
1907 Il ciclo viene ripetuto (\texttt{\small 18}) fintanto che si hanno indirizzi
1908 validi, ed inizia (\texttt{\small 19}) con l'apertura del socket; se questa
1909 fallisce si controlla (\texttt{\small 20}) se sono disponibili altri
1910 indirizzi, nel qual caso si passa al successivo (\texttt{\small 21}) e si
1911 riprende (\texttt{\small 22}) il ciclo da capo; se non ve ne sono si stampa
1912 l'errore ritornando immediatamente (\texttt{\small 24--27}).
1914 Quando la creazione del socket ha avuto successo si procede (\texttt{\small
1915 29}) direttamente con la connessione, di nuovo in caso di fallimento viene
1916 ripetuto (\texttt{\small 30--38}) il controllo se vi sono o no altri indirizzi
1917 da provare nella stessa modalità fatta in precedenza, aggiungendovi però in
1918 entrambi i casi (\texttt{\small 32} e (\texttt{\small 36}) la chiusura del
1919 socket precedentemente aperto, che non è più utilizzabile.
1921 Se la connessione ha avuto successo invece si termina (\texttt{\small 39})
1922 direttamente il ciclo, e prima di ritornare (\texttt{\small 31}) il valore del
1923 file descriptor del socket si provvede (\texttt{\small 30}) a liberare le
1924 strutture \struct{addrinfo} allocate da \func{getaddrinfo} utilizzando il
1925 valore del relativo puntatore precedentemente (\texttt{\small 17}) salvato.
1926 Si noti come per la funzione sia del tutto irrilevante se la struttura
1927 ritornata contiene indirizzi IPv6 o IPv4, in quanto si fa uso direttamente dei
1928 dati relativi alle strutture degli indirizzi di \struct{addrinfo} che sono
1929 opachi rispetto all'uso della funzione \func{connect}.
1931 Per usare questa funzione possiamo allora modificare ulteriormente il nostro
1932 programma client per il servizio \textit{echo}; in questo caso rispetto al
1933 codice usato finora per collegarsi (vedi fig.~\ref{fig:TCP_echo_client_1})
1934 avremo una semplificazione per cui il corpo principale del nostro client
1935 diventerà quello illustrato in fig.~\ref{fig:TCP_echo_fifth}, in cui le
1936 chiamate a \func{socket}, \func{inet\_pton} e \func{connect} sono sostituite
1937 da una singola chiamata a \texttt{sockconn}. Inoltre il nuovo client (il cui
1938 codice completo è nel file \file{TCP\_echo\_fifth.c} dei sorgenti allegati)
1939 consente di utilizzare come argomento del programma un nome a dominio al posto
1940 dell'indirizzo numerico, e può utilizzare sia indirizzi IPv4 che IPv6.
1942 \begin{figure}[!htb]
1943 \footnotesize \centering
1944 \begin{minipage}[c]{\codesamplewidth}
1945 \includecodesample{listati/TCP_echo_fifth.c}
1948 \caption{Il nuovo codice per la connessione del client \textit{echo}.}
1949 \label{fig:TCP_echo_fifth}
1952 La seconda funzione di ausilio che abbiamo creato è \texttt{sockbind}, il cui
1953 corpo principale è riportato in fig.~\ref{fig:sockbind_code} (al solito il
1954 sorgente completo è nel file \file{sockbind.c} dei sorgenti allegati alla
1955 guida). Come si può notare la funzione è del tutto analoga alla precedente
1956 \texttt{sockconn}, e prende gli stessi argomenti, però invece di eseguire una
1957 connessione con \func{connect} si limita a chiamare \func{bind} per collegare
1958 il socket ad una porta.
1960 \begin{figure}[!htb]
1961 \footnotesize \centering
1962 \begin{minipage}[c]{\codesamplewidth}
1963 \includecodesample{listati/sockbind.c}
1966 \caption{Il codice della funzione \texttt{sockbind}.}
1967 \label{fig:sockbind_code}
1970 Dato che la funzione è pensata per essere utilizzata da un server ci si può
1971 chiedere a quale scopo mantenere l'argomento \param{host} quando l'indirizzo
1972 di questo è usualmente noto. Si ricordi però quanto detto in
1973 sez.~\ref{sec:TCP_func_bind}, relativamente al significato della scelta di un
1974 indirizzo specifico come argomento di \func{bind}, che consente di porre il
1975 server in ascolto su uno solo dei possibili diversi indirizzi presenti su di
1976 una macchina. Se non si vuole che la funzione esegua \func{bind} su un
1977 indirizzo specifico, ma utilizzi l'indirizzo generico, occorrerà avere cura di
1978 passare un valore \val{NULL} come valore per l'argomento \var{host}; l'uso
1979 del valore \const{AI\_PASSIVE} serve ad ottenere il valore generico nella
1980 rispettiva struttura degli indirizzi.
1982 Come già detto la funzione è analoga a \texttt{sockconn} ed inizia azzerando
1983 ed inizializzando (\texttt{\small 6--11}) opportunamente la struttura
1984 \var{hint} con i valori ricevuti come argomenti, soltanto che in questo caso
1985 si è usata (\texttt{\small 8}) una impostazione specifica dei flag di
1986 \var{hint} usando \const{AI\_PASSIVE} per indicare che il socket sarà usato
1987 per una apertura passiva. Per il resto la chiamata (\texttt{\small 12--18}) a
1988 \func{getaddrinfo} e ed il ciclo principale (\texttt{\small 20--42}) sono
1989 identici, solo che si è sostituita (\texttt{\small 31}) la chiamata a
1990 \func{connect} con una chiamata a \func{bind}. Anche la conclusione
1991 (\texttt{\small 43--44}) della funzione è identica.
1993 Si noti come anche in questo caso si siano inserite le stampe degli errori
1994 sullo \textit{standard error}, nonostante la funzione possa essere invocata da
1995 un demone. Nel nostro caso questo non è un problema in quanto se la funzione
1996 non ha successo il programma deve uscire immediatamente prima di essere posto
1997 in background, e può quindi scrivere gli errori direttamente sullo
1998 \textit{standard error}.
2000 \begin{figure}[!htbp]
2001 \footnotesize \centering
2002 \begin{minipage}[c]{\codesamplewidth}
2003 \includecodesample{listati/TCP_echod_third.c}
2006 \caption{Nuovo codice per l'apertura passiva del server \textit{echo}.}
2007 \label{fig:TCP_echod_third}
2010 Con l'uso di questa funzione si può modificare anche il codice del nostro
2011 server \textit{echo}, che rispetto a quanto illustrato nella versione iniziale
2012 di fig.~\ref{fig:TCP_echo_server_first_code} viene modificato nella forma
2013 riportata in fig.~\ref{fig:TCP_echod_third}. In questo caso il socket su cui
2014 porsi in ascolto viene ottenuto (\texttt{\small 15--18}) da \texttt{sockbind}
2015 che si cura anche della eventuale risoluzione di un indirizzo specifico sul
2016 quale si voglia far ascoltare il server.
2019 \section{Le opzioni dei socket}
2020 \label{sec:sock_options}
2022 Benché dal punto di vista del loro uso come canali di trasmissione di dati i
2023 socket vengano trattati allo stesso modo dei file, acceduti tramite i file
2024 descriptor, e gestiti con le ordinarie funzioni di lettura e scrittura dei
2025 file, l'interfaccia standard usata per la gestione dei file generici non è
2026 comunque sufficiente a controllare la moltitudine di caratteristiche
2027 specifiche che li contraddistinguono, considerato tra l'altro che queste
2028 possono essere completamente diverse fra loro a seconda del tipo di socket e
2029 della relativa forma di comunicazione sottostante.
2031 In questa sezione vedremo allora quali sono le funzioni dedicate alla gestione
2032 delle caratteristiche specifiche dei vari tipi di socket, che vengono
2033 raggruppate sotto il nome generico di ``\textit{socket options}'', ma
2034 soprattutto analizzaremo quali sono queste opzioni e quali caretteristiche e
2035 comportamenti dei socket permettono di controllare.
2038 \subsection{Le funzioni di gestione delle opzioni dei socket}
2039 \label{sec:sock_setsockopt}
2041 La modalità principale con cui si possono gestire le caratteristiche dei
2042 socket (ne vedremo delle ulteriori nelle prossime sezioni) è quella che passa
2043 attraverso l'uso di due funzioni di sistema generiche che permettono
2044 rispettivamente di impostarle e di recuperarne il valore corrente. La prima di
2045 queste due funzioni, quella usata per impostare le \textit{socket options}, è
2046 \funcd{setsockopt}, ed il suo prototipo è:
2049 \fhead{sys/socket.h}
2051 \fdecl{int setsockopt(int sock, int level, int optname, const void
2052 *optval, socklen\_t optlen)}
2053 \fdesc{Imposta le opzioni di un socket.}
2056 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore, nel qual
2057 caso \var{errno} assumerà uno dei valori:
2059 \item[\errcode{EBADF}] il file descriptor \param{sock} non è valido.
2060 \item[\errcode{EFAULT}] l'indirizzo \param{optval} non è valido.
2061 \item[\errcode{EINVAL}] il valore di \param{optlen} non è valido.
2062 \item[\errcode{ENOPROTOOPT}] l'opzione scelta non esiste per il livello
2064 \item[\errcode{ENOTSOCK}] il file descriptor \param{sock} non corrisponde ad
2070 Il primo argomento della funzione, \param{sock}, indica il socket su cui si
2071 intende operare; per indicare l'opzione da impostare si devono usare i due
2072 argomenti successivi, \param{level} e \param{optname}. Come abbiamo visto in
2073 sez.~\ref{sec:net_protocols} i protocolli di rete sono strutturati su vari
2074 livelli, ed l'interfaccia dei socket può usarne più di uno. Si avranno allora
2075 funzionalità e caratteristiche diverse per ciascun protocollo usato da un
2076 socket, e quindi saranno anche diverse le opzioni che si potranno impostare
2077 per ciascun socket, a seconda del \textsl{livello} (trasporto, rete, ecc.) su
2078 cui si vuole andare ad operare.
2080 Il valore di \param{level} seleziona allora il protocollo su cui vuole
2081 intervenire, mentre \param{optname} permette di scegliere su quale delle
2082 opzioni che sono definite per quel protocollo si vuole operare. In sostanza la
2083 selezione di una specifica opzione viene fatta attraverso una coppia di valori
2084 \param{level} e \param{optname} e chiaramente la funzione avrà successo
2085 soltanto se il protocollo in questione prevede quella opzione ed è utilizzato
2086 dal socket. Infine \param{level} prevede anche il valore speciale
2087 \const{SOL\_SOCKET} usato per le opzioni generiche che sono disponibili per
2088 qualunque tipo di socket.
2093 \begin{tabular}[c]{|l|l|}
2095 \textbf{Livello} & \textbf{Significato} \\
2098 \constd{SOL\_SOCKET}& Opzioni generiche dei socket.\\
2099 \constd{SOL\_IP} & Opzioni specifiche per i socket che usano IPv4.\\
2100 \constd{SOL\_TCP} & Opzioni per i socket che usano TCP.\\
2101 \constd{SOL\_IPV6} & Opzioni specifiche per i socket che usano IPv6.\\
2102 \constd{SOL\_ICMPV6}& Opzioni specifiche per i socket che usano ICMPv6.\\
2105 \caption{Possibili valori dell'argomento \param{level} delle
2106 funzioni \func{setsockopt} e \func{getsockopt}.}
2107 \label{tab:sock_option_levels}
2110 I valori usati per \param{level}, corrispondenti ad un dato protocollo usato
2111 da un socket, sono quelli corrispondenti al valore numerico che identifica il
2112 suddetto protocollo in \conffile{/etc/protocols}; dato che la leggibilità di un
2113 programma non trarrebbe certo beneficio dall'uso diretto dei valori numerici,
2114 più comunemente si indica il protocollo tramite le apposite costanti
2115 \texttt{SOL\_*} riportate in tab.~\ref{tab:sock_option_levels}, dove si sono
2116 riassunti i valori che possono essere usati per l'argomento
2119 La notazione in questo caso è, purtroppo, abbastanza confusa: infatti in Linux
2120 il valore si può impostare sia usando le costanti \texttt{SOL\_*}, che le
2121 analoghe \texttt{IPPROTO\_*} (citate anche da Stevens in \cite{UNP1});
2122 entrambe hanno gli stessi valori che sono equivalenti ai numeri di protocollo
2123 di \conffile{/etc/protocols}, con una eccezione specifica, che è quella del
2124 protocollo ICMP, per la quale non esiste una costante, il che è comprensibile
2125 dato che il suo valore, 1, è quello che viene assegnato a \const{SOL\_SOCKET}.
2127 Il quarto argomento, \param{optval} è un puntatore ad una zona di memoria che
2128 contiene i dati che specificano il valore dell'opzione che si vuole passare al
2129 socket, mentre l'ultimo argomento \param{optlen},\footnote{questo argomento è
2130 in realtà sempre di tipo \ctyp{int}, come era nelle \acr{libc4} e
2131 \acr{libc5}; l'uso di \type{socklen\_t} è stato introdotto da POSIX (valgono
2132 le stesse considerazioni per l'uso di questo tipo di dato fatte in
2133 sez.~\ref{sec:TCP_func_accept}) ed adottato dalle \acr{glibc}.} è la
2134 dimensione in byte dei dati presenti all'indirizzo indicato da \param{optval}.
2135 Dato che il tipo di dati varia a seconda dell'opzione scelta, occorrerà
2136 individuare qual è quello che deve essere usato, ed utilizzare le opportune
2139 La gran parte delle opzioni utilizzano per \param{optval} un valore intero, se
2140 poi l'opzione esprime una condizione logica, il valore è sempre un intero, ma
2141 si dovrà usare un valore non nullo per abilitarla ed un valore nullo per
2142 disabilitarla. Se invece l'opzione non prevede di dover ricevere nessun tipo
2143 di valore si deve impostare \param{optval} a \val{NULL}. Un piccolo numero
2144 di opzioni però usano dei tipi di dati peculiari, è questo il motivo per cui
2145 \param{optval} è stato definito come puntatore generico.
2147 La seconda funzione usata per controllare le proprietà dei socket è
2148 \funcd{getsockopt}, che serve a leggere i valori delle opzioni dei socket ed a
2149 farsi restituire i dati relativi al loro funzionamento; il suo prototipo è:
2153 \fhead{sys/socket.h}
2155 \fdecl{int getsockopt(int s, int level, int optname, void *optval,
2156 socklen\_t *optlen)}
2157 \fdesc{Legge le opzioni di un socket.}
2160 {La funzione ritorna $0$ in caso di successo e $-1$ per un errore, nel qual
2161 caso \var{errno} assumerà uno dei valori:
2163 \item[\errcode{EBADF}] il file descriptor \param{sock} non è valido.
2164 \item[\errcode{EFAULT}] l'indirizzo \param{optval} o quello di
2165 \param{optlen} non è valido.
2166 \item[\errcode{ENOPROTOOPT}] l'opzione scelta non esiste per il livello
2168 \item[\errcode{ENOTSOCK}] il file descriptor \param{sock} non corrisponde ad
2174 I primi tre argomenti sono identici ed hanno lo stesso significato di quelli
2175 di \func{setsockopt}, anche se non è detto che tutte le opzioni siano definite
2176 per entrambe le funzioni. In questo caso \param{optval} viene usato per
2177 ricevere le informazioni ed indica l'indirizzo a cui andranno scritti i dati
2178 letti dal socket, infine \param{optlen} diventa un puntatore ad una variabile
2179 che viene usata come \textit{value result argument} per indicare, prima della
2180 chiamata della funzione, la lunghezza del buffer allocato per \param{optval} e
2181 per ricevere indietro, dopo la chiamata della funzione, la dimensione
2182 effettiva dei dati scritti su di esso. Se la dimensione del buffer allocato
2183 per \param{optval} non è sufficiente si avrà un errore.
2187 \subsection{Le opzioni generiche}
2188 \label{sec:sock_generic_options}
2190 Come accennato esiste un insieme generico di opzioni dei socket che possono
2191 applicarsi a qualunque tipo di socket, indipendentemente da quale protocollo
2192 venga poi utilizzato. Una descrizione di queste opzioni è generalmente
2193 disponibile nella settima sezione delle pagine di manuale; nel caso specifico
2194 la si può consultare con \texttt{man 7 socket}. Se si vuole operare su queste
2195 opzioni generiche il livello da utilizzare è \const{SOL\_SOCKET}; si è
2196 riportato un elenco di queste opzioni in tab.~\ref{tab:sock_opt_socklevel}.
2202 \begin{tabular}[c]{|l|c|c|c|l|l|}
2204 \textbf{Opzione}&\texttt{get}&\texttt{set}&\textbf{flag}&\textbf{Tipo}&
2205 \textbf{Descrizione}\\
2208 \const{SO\_ACCEPTCONN}&$\bullet$& & &\texttt{int}&
2209 Indica se il socket è in ascolto.\\
2210 \const{SO\_ATTACH\_FILTER}& &$\bullet$& &\texttt{sock\_fprog}&
2211 Aggancia un filtro BPF al socket.\\
2212 \const{SO\_BINDTODEVICE}&$\bullet$&$\bullet$& &\texttt{char *}&
2213 Lega il socket ad un dispositivo.\\
2214 \const{SO\_BROADCAST}&$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2215 Attiva o disattiva il \textit{broadcast}.\\
2216 \const{SO\_BSDCOMPAT}&$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2217 Abilita la compatibilità con BSD.\\
2218 \const{SO\_BUSY\_POLL}&$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2219 Attiva il ``\textit{busy poll}'' sul socket.\\
2220 \const{SO\_DEBUG} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2221 Abilita il debugging sul socket.\\
2222 \const{SO\_DETACH\_FILTER}& &$\bullet$&$\bullet$&\texttt{int}&
2223 Rimuove il filtro BPF agganciato al socket.\\
2224 \const{SO\_DOMAIN} &$\bullet$& & &\texttt{int}&
2225 Legge il tipo di socket.\\
2226 \const{SO\_DONTROUTE}&$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2227 Non invia attraverso un gateway.\\
2228 \const{SO\_ERROR} &$\bullet$& & &\texttt{int}&
2229 Riceve e cancella gli errori pendenti.\\
2230 \const{SO\_KEEPALIVE}&$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2231 Controlla l'attività della connessione.\\
2232 \const{SO\_LINGER} &$\bullet$&$\bullet$& &\texttt{linger}&
2233 Indugia nella chiusura con dati da spedire.\\
2234 \const{SO\_LOCK\_FILTER}& &$\bullet$&$\bullet$&\texttt{int}&
2235 Blocca il filtro BPF agganciato al socket.\\
2236 \const{SO\_MARK} &$\bullet$&$\bullet$& &\texttt{int}&
2237 Imposta un ``\textit{firewall mark}'' sul socket.\\
2238 \const{SO\_OOBINLINE}&$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2239 Lascia in linea i dati \textit{out-of-band}.\\
2240 \const{SO\_PASSCRED} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2241 Abilita la ricezione di credenziali.\\
2242 \const{SO\_PEEK\_OFF} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2243 Imposta il valore del ``\textit{peek offset}''.\\
2244 \const{SO\_PEERCRED} &$\bullet$& & &\texttt{ucred}&
2245 Restituisce le credenziali del processo remoto.\\
2246 \const{SO\_PRIORITY} &$\bullet$&$\bullet$& &\texttt{int}&
2247 Imposta la priorità del socket.\\
2248 \const{SO\_PROTOCOL} &$\bullet$& & &\texttt{int}&
2249 Ottiene il protocollo usato dal socket.\\
2250 \const{SO\_RCVBUF} &$\bullet$&$\bullet$& &\texttt{int}&
2251 Imposta dimensione del buffer di ricezione.\\
2252 \const{SO\_RCVBUFFORCE}&$\bullet$&$\bullet$& &\texttt{int}&
2253 Forza dimensione del buffer di ricezione.\\
2254 \const{SO\_RCVLOWAT} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2255 Basso livello sul buffer di ricezione.\\
2256 \const{SO\_RCVTIMEO} &$\bullet$&$\bullet$& &\texttt{timeval}&
2257 Timeout in ricezione.\\
2258 \const{SO\_REUSEADDR}&$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2259 Consente il riutilizzo di un indirizzo locale.\\
2260 \const{SO\_REUSEPORT}&$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2261 Consente il riutilizzo di una porta.\\
2262 \const{SO\_RXQ\_OVFL} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2263 Richiede messaggio ancillare con pacchetti persi.\\
2264 \const{SO\_SNDBUF} &$\bullet$&$\bullet$& &\texttt{int}&
2265 Imposta dimensione del buffer di trasmissione.\\
2266 \const{SO\_SNDBUFFORCE}&$\bullet$&$\bullet$& &\texttt{int}&
2267 Forza dimensione del buffer di trasmissione.\\
2268 \const{SO\_SNDLOWAT} &$\bullet$&$\bullet$& &\texttt{int}&
2269 Basso livello sul buffer di trasmissione.\\
2270 \const{SO\_SNDTIMEO} &$\bullet$&$\bullet$& &\texttt{timeval}&
2271 Timeout in trasmissione.\\
2272 \const{SO\_TIMESTAMP}&$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
2273 Abilita/disabilita la ricezione dei \textit{timestamp}.\\
2274 \const{SO\_TYPE} &$\bullet$& & &\texttt{int}&
2275 Restituisce il tipo di socket.\\
2278 \caption{Le opzioni disponibili al livello \const{SOL\_SOCKET}.}
2279 \label{tab:sock_opt_socklevel}
2282 % TODO aggiungere e documentare SO_ATTACH_BPF, introdotta con il kernel 3.19,
2283 % vedi http://lwn.net/Articles/625224/
2284 % TODO aggiungere e documentare SO_INCOMING_CPU, introdotta con il kernel 3.19,
2285 % TODO documentare SO_PEERGROUPS introdotta con il kernel 4.13, citata
2286 % in https://lwn.net/Articles/727385/
2287 % TODO documentare SO_ZEROCOPY, vedi https://lwn.net/Articles/726917/ (e il
2288 % resto pure) introdotta con il kernel 4.14
2290 La tabella elenca le costanti che identificano le singole opzioni da usare
2291 come valore per \param{optname}; le due colonne seguenti indicano per quali
2292 delle due funzioni (\func{getsockopt} o \func{setsockopt}) l'opzione è
2293 disponibile, mentre la colonna successiva indica, quando si ha a che fare con
2294 un valore di \param{optval} intero, se l'opzione è da considerare un numero o
2295 un valore logico. Si è inoltre riportato sulla quinta colonna il tipo di dato
2296 usato per \param{optval} ed una breve descrizione del significato delle
2297 singole opzioni sulla sesta.
2299 Le descrizioni delle opzioni presenti in tab.~\ref{tab:sock_opt_socklevel}
2300 sono estremamente sommarie, è perciò necessario fornire un po' più di
2301 informazioni. Alcune opzioni inoltre hanno una notevole rilevanza nella
2302 gestione dei socket, e pertanto il loro utilizzo sarà approfondito
2303 separatamente in sez.~\ref{sec:sock_options_main}. Quello che segue è quindi
2304 soltanto un elenco più dettagliato della breve descrizione di
2305 tab.~\ref{tab:sock_opt_socklevel} sul significato delle varie opzioni:
2307 \begin{basedescript}{\desclabelwidth{2.2cm}\desclabelstyle{\nextlinelabel}}
2308 \item[\constd{SO\_ACCEPTCONN}] questa opzione permette di rilevare se il socket
2309 su cui opera è stato posto in modalità di ricezione di eventuali connessioni
2310 con una chiamata a \func{listen}. L'opzione può essere usata soltanto con
2311 \func{getsockopt} ed utilizza per \param{optval} un intero in cui viene
2312 restituito 1 se il socket è in ascolto e 0 altrimenti.
2314 \item[\constd{SO\_ATTACH\_FILTER}] questa opzione permette di agganciare ad un
2315 socket un filtro di selezione dei pacchetti con la stessa sintassi del BPF
2316 (\textit{Berkley Packet Filter}) di BSD, che consente di selezionare, fra
2317 tutti quelli ricevuti, verranno letti. Può essere usata solo con
2318 \func{setsockopt} ed utilizza per \param{optval} un puntatore ad una
2319 struttura \struct{sock\_fprog} (definita in
2320 \headfile{linux/filter.h}). Questa opzione viene usata principalmente con i
2321 socket di tipo \const{PF\_PACKET} (torneremo su questo in
2322 sez.~\ref{sec:packet_socket}) dalla libreria \texttt{libpcap} per
2323 implementare programmi di cattura dei pacchetti, e per questo tipo di
2324 applicazione è opportuno usare sempre quest'ultima.\footnote{la trattazione
2325 del BPF va al di là dell'argomento di questa sezione per la documentazione
2326 si consulti il file \texttt{networking/filter.txt} nella documentazione
2329 \item[\constd{SO\_BINDTODEVICE}] questa opzione permette di \textsl{legare} il
2330 socket ad una particolare interfaccia, in modo che esso possa ricevere ed
2331 inviare pacchetti solo su quella. L'opzione richiede per \param{optval} il
2332 puntatore ad una stringa contenente il nome dell'interfaccia (ad esempio
2333 \texttt{eth0}); utilizzando una stringa nulla o un valore nullo per
2334 \param{optlen} si può rimuovere un precedente collegamento.
2336 Il nome della interfaccia deve essere specificato con una stringa terminata
2337 da uno zero e di lunghezza massima pari a \constd{IFNAMSIZ}; l'opzione è
2338 effettiva solo per alcuni tipi di socket, ed in particolare per quelli della
2339 famiglia \const{AF\_INET}; non è invece supportata per i \textit{packet
2340 socket} (vedi sez.~\ref{sec:socket_raw}).
2342 \item[\constd{SO\_BROADCAST}] questa opzione abilita il \textit{broadcast}:
2343 quando abilitata i socket di tipo \const{SOCK\_DGRAM} riceveranno i
2344 pacchetti inviati all'indirizzo di \textit{broadcast} e potranno scrivere
2345 pacchetti su tale indirizzo. Prende per \param{optval} un intero usato come
2346 valore logico. L'opzione non ha effetti su un socket di tipo
2347 \const{SOCK\_STREAM}.
2349 \item[\constd{SO\_BSDCOMPAT}] questa opzione abilita la compatibilità con il
2350 comportamento di BSD (in particolare ne riproduce alcuni bug). Attualmente è una
2351 opzione usata solo per il protocollo UDP e ne è prevista la rimozione.
2352 L'opzione utilizza per \param{optval} un intero usato come valore logico.
2354 Quando viene abilitata gli errori riportati da messaggi ICMP per un socket
2355 UDP non vengono passati al programma in user space. Con le versioni 2.0.x
2356 del kernel erano anche abilitate altre opzioni di compatibilità per i socket
2357 raw (modifiche casuali agli header, perdita del flag di \textit{broadcast})
2358 che sono state rimosse con il passaggio al 2.2; è consigliato correggere i
2359 programmi piuttosto che usare questa funzione. Dal kernel 2.4 viene
2360 ignorata, e dal 2.6 genera un messaggio di log del kernel.
2362 \item[\constd{SO\_BUSY\_POLL}] questa opzione, presente dal kernel 3.11,
2363 imposta un tempo approssimato in microsecondi, per cui in caso di ricezione
2364 bloccante verrà eseguito un \itindex{busy~poll} ``\textit{busy
2365 poll}'',\footnote{con \textit{busy poll} si fa riferimento al
2366 \textit{polling} su una risorsa occupata; si continuerà cioè a tentare di
2367 leggere anche quando non ci sono dati senza portare il processo stato di
2368 \textit{sleep}, in alcuni casi, quando ci si aspetta che i dati arrivino a
2369 breve, questa tecnica può dare un miglioramento delle prestazioni.} da
2370 indicare in \param{optval} con un valore intero. Si tratta di una opzione
2371 utilizzabile solo con socket che ricevono dati da un dispositivo di rete che
2372 la supporti, e che consente di ridurre la latenza per alcune applicazioni,
2373 ma che comporta un maggiore utilizzo della CPU (e quindi di energia); per
2374 questo il valore può essere aumentato solo da processi con i privilegi di
2375 amministratore (in particolare con la \textit{capability}
2376 \const{CAP\_NET\_ADMIN}). Il valore di default viene controllato dal file
2377 \sysctlrelfile{net/core}{busy\_read} per le funzioni di lettura mentre il
2378 file \sysctlrelfile{net/core}{busy\_poll} controlla il ``\textit{busy
2379 poll}'' per \func{select} e \func{poll}.
2381 \item[\constd{SO\_DEBUG}] questa opzione abilita il debugging delle operazioni
2382 dei socket; l'opzione utilizza per \param{optval} un intero usato come
2383 valore logico, e può essere utilizzata solo da un processo con i privilegi
2384 di amministratore (in particolare con la \textit{capability}
2385 \const{CAP\_NET\_ADMIN}). L'opzione necessita inoltre dell'opportuno
2386 supporto nel kernel;\footnote{deve cioè essere definita la macro di
2387 preprocessore \macrod{SOCK\_DEBUGGING} nel file \file{include/net/sock.h}
2388 dei sorgenti del kernel, questo è sempre vero nei kernel delle serie
2389 superiori alla 2.3, per i kernel delle serie precedenti invece è
2390 necessario aggiungere a mano detta definizione; è inoltre possibile
2391 abilitare anche il tracciamento degli stati del TCP definendo la macro
2392 \macrod{STATE\_TRACE} in \file{include/net/tcp.h}.} quando viene
2393 abilitata una serie di messaggi con le informazioni di debug vengono inviati
2394 direttamente al sistema del kernel log.\footnote{si tenga presente che il
2395 comportamento è diverso da quanto avviene con BSD, dove l'opzione opera
2396 solo sui socket TCP, causando la scrittura di tutti i pacchetti inviati
2397 sulla rete su un buffer circolare che viene letto da un apposito
2398 programma, \cmd{trpt}.}
2400 \item[\constd{SO\_DETACH\_FILTER}] consente di distaccare un filtro
2401 precedentemente aggiunto ad un socket con l'opzione
2402 \const{SO\_ATTACH\_FILTER}, in genere non viene usata direttamente in quanto
2403 i filtri BPF vengono automaticamente rimossi alla chiusura del socket, il
2404 suo utilizzo è pertanto limitato ai rari casi in cui si vuole rimuovere un
2405 precedente filtro per inserirne uno diverso. Come \const{SO\_ATTACH\_FILTER}
2406 può essere usato solo \func{setsockopt} e prende per \param{optval} un
2407 intero usato come valore logico.
2409 \item[\constd{SO\_DOMAIN}] questa opzione, presente dal kernel 2.6.32, legge
2410 il ``\textsl{dominio}'' (la famiglia di indirizzi) del socket.
2411 . Funziona solo con \func{getsockopt}, ed
2412 utilizza per \param{optval} un intero in cui verrà restituito il valore
2413 numerico che lo identifica (ad esempio \texttt{AF\_INET}).
2415 \item[\constd{SO\_DONTROUTE}] questa opzione richiede che l'invio dei
2416 pacchetti del socket sia eseguito soltanto verso una destinazione
2417 direttamente connessa, impedendo l'uso di un \textit{gateway} e saltando
2418 ogni processo relativo all'uso della tabella di routing del kernel. Prende
2419 per \param{optval} un intero usato come valore logico. È equivalente all'uso
2420 del flag \const{MSG\_DONTROUTE} su una \func{send} (vedi
2421 sez.~\ref{sec:net_send_recv}).
2423 \item[\constd{SO\_ERROR}] questa opzione riceve un errore presente sul socket;
2424 può essere utilizzata soltanto con \func{getsockopt} e prende per
2425 \param{optval} un valore intero, nel quale viene restituito il codice di
2426 errore, e la condizione di errore sul socket viene cancellata. Viene
2427 usualmente utilizzata per ricevere il codice di errore, come accennato in
2428 sez.~\ref{sec:TCP_sock_select}, quando si sta osservando il socket con una
2429 \func{select} che ritorna a causa dello stesso.
2431 \item[\const{SO\_KEEPALIVE}] questa opzione abilita un meccanismo di verifica
2432 della persistenza di una connessione associata al socket; è pertanto
2433 effettiva solo sui socket che supportano le connessioni, ed è usata
2434 principalmente con il TCP. L'opzione utilizza per \param{optval} un intero
2435 usato come valore logico. Maggiori dettagli sul suo funzionamento sono
2436 forniti in sez.~\ref{sec:sock_options_main}.
2438 \item[\const{SO\_LINGER}] questa opzione controlla le modalità con cui viene
2439 chiuso un socket quando si utilizza un protocollo che supporta le
2440 connessioni (è pertanto usata con i socket TCP ed ignorata per UDP) e
2441 modifica il comportamento delle funzioni \func{close} e \func{shutdown}.
2442 L'opzione richiede che l'argomento \param{optval} sia una struttura di tipo
2443 \struct{linger}, definita in \headfile{sys/socket.h} ed illustrata in
2444 fig.~\ref{fig:sock_linger_struct}. Maggiori dettagli sul suo funzionamento
2445 sono forniti in sez.~\ref{sec:sock_options_main}.
2447 \item[\constd{SO\_LOCK\_FILTER}] consente di bloccare un filtro
2448 precedentemente aggiunto ad un socket con l'opzione
2449 \const{SO\_ATTACH\_FILTER}, in modo che non possa essere né rimosso né
2450 modificato, questo consente di impostare un filtro su un socket, bloccarlo e
2451 poi cedere i privilegi con la sicurezza che il filtro permarrà fino alla
2452 chiusura del socket. Come \const{SO\_ATTACH\_FILTER} può essere usato solo
2453 \func{setsockopt} e prende per \param{optval} un intero usato come valore
2456 \item[\constd{SO\_MARK}] questa opzione, presente dal kernel 2.6.25, imposta
2457 un valore di marcatura sui pacchetti del socket. Questa è una funzionalità
2458 specifica di Linux, ottenibile anche con l'uso del target \texttt{MARK}
2459 del comando \texttt{iptables} (l'argomento è trattato in sez.~3.3.5 di
2460 \cite{SGL}). Il valore di marcatura viene mantenuto all'interno dello stack
2461 di rete del kernel e può essere usato sia dal \itindex{netfilter}
2462 \textit{netfilter}\footnote{il \textit{netfilter} è l'infrastruttura usata
2463 per il filtraggio dei pacchetti del kernel, per maggiori dettagli si
2464 consulti il cap.~2 di \cite{FwGL}.} di Linux che per impostare politiche
2465 di routing avanzato. Il valore deve essere specificato in \param{optval}
2466 come un intero. L'opzione richiede i privilegi di amministratore con la
2467 \textit{capability} \const{CAP\_NET\_ADMIN}.
2469 \item[\constd{SO\_OOBINLINE}] se questa opzione viene abilitata i dati
2470 \textit{out-of-band} vengono inviati direttamente nel flusso di dati del
2471 socket (e sono quindi letti con una normale \func{read}) invece che restare
2472 disponibili solo per l'accesso con l'uso del flag \const{MSG\_OOB} di
2473 \func{recvmsg}. L'argomento è trattato in dettaglio in
2474 sez.~\ref{sec:TCP_urgent_data}. L'opzione funziona soltanto con socket che
2475 supportino i dati \textit{out-of-band} (non ha senso per socket UDP ad
2476 esempio), ed utilizza per \param{optval} un intero usato come valore logico.
2478 \item[\constd{SO\_PASSCRED}] questa opzione abilita sui socket unix-domain
2479 (vedi sez.~\ref{sec:unix_socket}) la ricezione dei messaggi di controllo di
2480 tipo \const{SCM\_CREDENTIALS}. Prende come \param{optval} un intero usato
2483 \item[\constd{SO\_PEEK\_OFF}] questa opzione, disponibile a partire dal kernel
2484 3.4, imposta un ``\textit{peek offset}'' sul socket (attualmente disponibile
2485 solo per i socket unix-domain (vedi sez.~\ref{sec:unix_socket}). La funzione
2486 serve come ausilio per l'uso del flag \const{MSG\_PEEK} di \func{recv} che
2487 consente di ``\textsl{sbirciare}'' nei dati di un socket, cioè di leggerli
2488 senza rimuoverli dalla coda in cui sono mantenuti, così che vengano
2489 restituiti anche da una successiva lettura ordinaria.
2491 Un valore negativo (il default è $-1$) riporta alla situazione ordinaria in
2492 cui si ``\textsl{sbircia}'' a partire dalla testa della coda, un valore
2493 positivo consente di leggere a partire dalla posizione indicata nella coda e
2494 tutte le volte che si sbirciano dei dati il valore dell'offset viene
2495 automaticamente aumentato della quantità di dati sbirciati, in modo che si
2496 possa proseguire da dove si era arrivati. Il valore deve essere specificato
2497 in \param{optval} come intero.
2499 \item[\constd{SO\_PEERCRED}] questa opzione restituisce le credenziali del
2500 processo remoto connesso al socket; l'opzione è disponibile solo per socket
2501 unix-domain di tipo \textit{stream} e anche per quelli di tipo
2502 \textit{datagram} quando se ne crea una coppia con \func{socketpair}, e può
2503 essere usata solo con \func{getsockopt}. Utilizza per
2504 \param{optval} una apposita struttura \struct{ucred} (vedi
2505 sez.~\ref{sec:unix_socket}).
2507 \item[\constd{SO\_PRIORITY}] questa opzione permette di impostare le priorità
2508 per tutti i pacchetti che sono inviati sul socket, prende per \param{optval}
2509 un valore intero. Con questa opzione il kernel usa il valore per ordinare le
2510 priorità sulle code di rete,\footnote{questo richiede che sia abilitato il
2511 sistema di \textit{Quality of Service} disponibile con le opzioni di
2512 routing avanzato.} i pacchetti con priorità più alta vengono processati
2513 per primi, in modalità che dipendono dalla disciplina di gestione della
2514 coda. Nel caso di protocollo IP questa opzione permette anche di impostare i
2515 valori del campo \textit{type of service} (noto come TOS, vedi
2516 sez.~\ref{sec:IP_header}) per i pacchetti uscenti. Per impostare una
2517 priorità al di fuori dell'intervallo di valori fra 0 e 6 sono richiesti i
2518 privilegi di amministratore con la \textit{capability}
2519 \const{CAP\_NET\_ADMIN}.
2521 \item[\constd{SO\_PROTOCOL}] questa opzione, presente dal kernel 2.6.32, legge
2522 il protocollo usato dal socket. Funziona solo con \func{getsockopt}, ed
2523 utilizza per \param{optval} un intero in cui verrà restituito il valore
2524 numerico che lo identifica (ad esempio \texttt{IPPROTO\_TCP}).
2526 \item[\constd{SO\_RCVBUF}] questa opzione imposta la dimensione del buffer di
2527 ricezione del socket. Prende per \param{optval} un intero indicante il
2528 numero di byte. Il valore di default ed il valore massimo che si può
2529 specificare come argomento per questa opzione sono impostabili tramiti gli
2530 opportuni valori di \func{sysctl} (vedi sez.~\ref{sec:sock_sysctl}).
2532 Si tenga presente che nel caso di socket TCP, per entrambe le opzioni
2533 \const{SO\_RCVBUF} e \const{SO\_SNDBUF}, il kernel alloca effettivamente una
2534 quantità di memoria doppia rispetto a quanto richiesto con
2535 \func{setsockopt}. Questo comporta che una successiva lettura con
2536 \func{getsockopt} riporterà un valore diverso da quello impostato con
2537 \func{setsockopt}. Questo avviene perché TCP necessita dello spazio in più
2538 per mantenere dati amministrativi e strutture interne, e solo una parte
2539 viene usata come buffer per i dati, mentre il valore letto da
2540 \func{getsockopt} e quello riportato nei vari parametri di
2541 \textit{sysctl}\footnote{cioè \sysctlrelfile{net/core}{wmem\_max} e
2542 \sysctlrelfile{net/core}{rmem\_max} in \texttt{/proc/sys/net/core} e
2543 \sysctlrelfile{net/ipv4}{tcp\_wmem} e \sysctlrelfile{net/ipv4}{tcp\_rmem}
2544 in \texttt{/proc/sys/net/ipv4}, vedi sez.~\ref{sec:sock_sysctl}.} indica
2545 la memoria effettivamente impiegata. Si tenga presente inoltre che le
2546 modifiche alle dimensioni dei buffer di ricezione e trasmissione, per poter
2547 essere effettive, devono essere impostate prima della chiamata alle funzioni
2548 \func{listen} o \func{connect}.
2550 \item[\constd{SO\_RCVBUFFORCE}] questa opzione, presente dal kernel 2.6.14, è
2551 identica a \const{SO\_RCVBUF} ma consente ad un processo con i privilegi di
2552 amministratore (con la \textit{capability} \const{CAP\_NET\_ADMIN}) di
2553 impostare in valore maggiore del limite di
2554 \sysctlrelfile{net/core}{rmem\_max}.
2556 \item[\constd{SO\_RCVLOWAT}] questa opzione imposta il valore che indica il
2557 numero minimo di byte che devono essere presenti nel buffer di ricezione
2558 perché il kernel passi i dati all'utente, restituendoli ad una \func{read} o
2559 segnalando ad una \func{select} (vedi sez.~\ref{sec:TCP_sock_select}) che ci
2560 sono dati in ingresso. L'opzione utilizza per \param{optval} un intero che
2561 specifica il numero di byte; con Linux questo valore è sempre 1 e può essere
2562 cambiato solo con i kernel a partire dal 2.4. Si tenga presente però che
2563 \func{poll} e \func{select} non supportano ancora questa funzionalità e
2564 ritornano comunque, indicando il socket come leggibile, non appena almeno un
2565 byte è presente mentre in una successiva lettura \func{read} si bloccherà
2566 fintanto che non siano disponibili la quantità di byte indicati. Con
2567 \func{getsockopt} si può leggere questo valore mentre \func{setsockopt} darà
2568 un errore di \errcode{ENOPROTOOPT} quando il cambiamento non è supportato.
2570 \item[\constd{SO\_RCVTIMEO}] l'opzione permette di impostare un tempo massimo
2571 sulle operazioni di lettura da un socket, e prende per \param{optval} una
2572 struttura di tipo \struct{timeval} (vedi fig.~\ref{fig:sys_timeval_struct})
2573 identica a quella usata con \func{select}. Con \func{getsockopt} si può
2574 leggere il valore attuale, mentre con \func{setsockopt} si imposta il tempo
2575 voluto, usando un valore nullo per \struct{timeval} il timeout viene
2578 Se l'opzione viene attivata tutte le volte che una delle funzioni di lettura
2579 (\func{read}, \func{readv}, \func{recv}, \func{recvfrom} e \func{recvmsg})
2580 si blocca in attesa di dati per un tempo maggiore di quello impostato, essa
2581 ritornerà un valore -1 e la variabile \var{errno} sarà impostata con un
2582 errore di \errcode{EAGAIN} e \errcode{EWOULDBLOCK}, così come sarebbe
2583 avvenuto se si fosse aperto il socket in modalità non bloccante.\footnote{in
2584 teoria, se il numero di byte presenti nel buffer di ricezione fosse
2585 inferiore a quello specificato da \const{SO\_RCVLOWAT}, l'effetto potrebbe
2586 essere semplicemente quello di provocare l'uscita delle funzioni di
2587 lettura restituendo il numero di byte fino ad allora ricevuti.}
2589 In genere questa opzione non è molto utilizzata se si ha a che fare con la
2590 lettura dei dati, in quanto è sempre possibile usare una \func{select} che
2591 consente di specificare un \textit{timeout}; l'uso di \func{select} non
2592 consente però di impostare il timeout per l'uso di \func{connect}, per avere
2593 il quale si può ricorrere a questa opzione (nel qual caso il raggiungimento
2594 del \textit{timeout} restituisce l'errore \errcode{EINPROGRESS}).
2596 \item[\const{SO\_REUSEADDR}] questa opzione permette di eseguire la funzione
2597 \func{bind} su indirizzi locali che siano già in uso da altri socket;
2598 l'opzione utilizza per \param{optval} un intero usato come valore logico.
2599 Questa opzione modifica il comportamento normale dell'interfaccia dei socket
2600 che fa fallire l'esecuzione della funzione \func{bind} con un errore di
2601 \errcode{EADDRINUSE} quando l'indirizzo locale (più propriamente il
2602 controllo viene eseguito sulla porta) è già in uso da parte di un altro
2603 socket. Maggiori dettagli sul suo funzionamento sono forniti in
2604 sez.~\ref{sec:sock_options_main}.
2606 \item[\const{SO\_REUSEPORT}] questa opzione, presente a partire dal kernel
2607 3.9, permette di far usare a più socket di tipo \const{AF\_INET} o
2608 \const{AF\_INET6} lo stesso indirizzo locale, e costituisce una estensione
2609 della precedente \const{SO\_REUSEADDR}. Maggiori dettagli sul suo
2610 funzionamento sono forniti in sez.~\ref{sec:sock_options_main}.
2612 \item[\constd{SO\_RXQ\_OVFL}] questa opzione, presente dal kernel 2.6.33,
2613 permette di abilitare o disabilitare sul socket la ricezione di un messaggio
2614 ancillare (tratteremo l'argomento in sez.~\ref{sec:net_ancillary_data})
2615 contenente un intero senza segno a 32 bit che indica il numero di pacchetti
2616 scartati sul socket fra l'ultimo pacchetto ricevuto e questo. L'opzione
2617 utilizza per \param{optval} un intero usato come valore logico.
2619 % TODO documentare SO_RXQ_OVFL, vedi https://lwn.net/Articles/626150/ capire
2620 % che significa 'questo'
2622 \item[\constd{SO\_SNDLOWAT}] questa opzione imposta il valore che indica il
2623 numero minimo di byte che devono essere presenti nel buffer di trasmissione
2624 perché il kernel li invii al protocollo successivo, consentendo ad una
2625 \func{write} di ritornare o segnalando ad una \func{select} (vedi
2626 sez.~\ref{sec:TCP_sock_select}) che è possibile eseguire una scrittura.
2627 L'opzione utilizza per \param{optval} un intero che specifica il numero di
2628 byte; con Linux questo valore è sempre 1 e non può essere cambiato;
2629 \func{getsockopt} leggerà questo valore mentre \func{setsockopt} darà un
2630 errore di \errcode{ENOPROTOOPT}.
2632 \item[\constd{SO\_SNDBUF}] questa opzione imposta la dimensione del buffer di
2633 trasmissione del socket. Prende per \param{optval} un intero indicante il
2634 numero di byte. Il valore di default ed il valore massimo che si possono
2635 specificare come argomento per questa opzione sono impostabili
2636 rispettivamente tramite gli opportuni valori di \func{sysctl} (vedi
2637 sez.~\ref{sec:sock_sysctl}).
2639 \item[\constd{SO\_SNDBUFFORCE}] questa opzione, presente dal kernel 2.6.14, è
2640 identica a \const{SO\_SNDBUF} ma consente ad un processo con i privilegi di
2641 amministratore (con la \textit{capability} \const{CAP\_NET\_ADMIN}) di
2642 impostare in valore maggiore del limite di
2643 \sysctlrelfile{net/core}{wmem\_max}.
2645 % TODO verificare il timeout con un programma di test
2647 \item[\constd{SO\_SNDTIMEO}] l'opzione permette di impostare un tempo massimo
2648 sulle operazioni di scrittura su un socket, ed usa gli stessi valori di
2649 \const{SO\_RCVTIMEO}. In questo caso però si avrà un errore di
2650 \errcode{EAGAIN} o \errcode{EWOULDBLOCK} per le funzioni di scrittura
2651 \func{write}, \func{writev}, \func{send}, \func{sendto} e \func{sendmsg}
2652 qualora queste restino bloccate per un tempo maggiore di quello specificato.
2654 \item[\constd{SO\_TIMESTAMP}] questa opzione, presente dal kernel 2.6.30,
2655 permette di abilitare o disabilitare sul socket la ricezione di un messaggio
2656 ancillare di tipo \const{SO\_TIMESTAMP}. Il messaggio viene inviato con
2657 livello \const{SOL\_SOCKET} ed nel campo \var{cmsg\_data} (per i dettagli si
2658 veda sez.~\ref{sec:net_ancillary_data}) viene impostata una struttura
2659 \struct{timeval} che indica il tempo di ricezione dell'ultimo pacchetto
2660 passato all'utente. L'opzione utilizza per \param{optval} un intero usato
2663 % TODO capire meglio la tempistica di questi messaggi ancillari
2664 % TODO documentare SO_TIMESTAMP e le altre opzioni di timestamping dei
2665 % pacchetti, introdotte nel 2.6.30, vedi nei sorgenti del kernel:
2666 % Documentation/networking/timestamping.txt
2668 \item[\constd{SO\_TYPE}] questa opzione permette di leggere il tipo di socket
2669 su cui si opera; funziona solo con \func{getsockopt}, ed utilizza per
2670 \param{optval} un intero in cui verrà restituito il valore numerico che lo
2671 identifica (ad esempio \const{SOCK\_STREAM}).
2677 \subsection{L'uso delle principali opzioni dei socket}
2678 \label{sec:sock_options_main}
2680 La descrizione sintetica del significato delle opzioni generiche dei socket,
2681 riportata nell'elenco in sez.~\ref{sec:sock_generic_options}, è
2682 necessariamente sintetica, alcune di queste però possono essere utilizzate
2683 per controllare delle funzionalità che hanno una notevole rilevanza nella
2684 programmazione dei socket. Per questo motivo faremo in questa sezione un
2685 approfondimento sul significato delle opzioni generiche più importanti.
2688 \constbeg{SO\_KEEPALIVE}
2689 \subsubsection{L'opzione \const{SO\_KEEPALIVE}}
2691 La prima opzione da approfondire è \const{SO\_KEEPALIVE} che permette di
2692 tenere sotto controllo lo stato di una connessione. Una connessione infatti
2693 resta attiva anche quando non viene effettuato alcun traffico su di essa; è
2694 allora possibile, in caso di una interruzione completa della rete, che la
2695 caduta della connessione non venga rilevata, dato che sulla stessa non passa
2696 comunque alcun traffico.
2698 Se si imposta questa opzione, è invece cura del kernel inviare degli appositi
2699 messaggi sulla rete, detti appunto \textit{keep-alive}, per verificare se la
2700 connessione è attiva. L'opzione funziona soltanto con i socket che supportano
2701 le connessioni (non ha senso per socket UDP ad esempio) e si applica
2702 principalmente ai socket TCP.
2704 Con le impostazioni di default (che sono riprese da BSD) Linux emette un
2705 messaggio di \textit{keep-alive} (in sostanza un segmento ACK vuoto, cui sarà
2706 risposto con un altro segmento ACK vuoto) verso l'altro capo della connessione
2707 se questa è rimasta senza traffico per più di due ore. Se è tutto a posto il
2708 messaggio viene ricevuto e verrà emesso un segmento ACK di risposta, alla cui
2709 ricezione ripartirà un altro ciclo di attesa per altre due ore di inattività;
2710 il tutto avviene all'interno del kernel e le applicazioni non riceveranno
2713 Qualora ci siano dei problemi di rete si possono invece verificare i due casi
2714 di terminazione precoce del server già illustrati in
2715 sez.~\ref{sec:TCP_conn_crash}. Il primo è quello in cui la macchina remota ha
2716 avuto un crollo del sistema ed è stata riavviata, per cui dopo il riavvio la
2717 connessione non esiste più.\footnote{si ricordi che un normale riavvio o il
2718 crollo dell'applicazione non ha questo effetto, in quanto in tal caso si
2719 passa sempre per la chiusura del processo, e questo, come illustrato in
2720 sez.~\ref{sec:file_open_close}, comporta anche la regolare chiusura del
2721 socket con l'invio di un segmento FIN all'altro capo della connessione.} In
2722 questo caso all'invio del messaggio di \textit{keep-alive} si otterrà come
2723 risposta un segmento RST che indica che l'altro capo non riconosce più
2724 l'esistenza della connessione ed il socket verrà chiuso riportando un errore
2725 di \errcode{ECONNRESET}.
2727 Se invece non viene ricevuta nessuna risposta (indice che la macchina non è
2728 più raggiungibile) l'emissione dei messaggi viene ripetuta ad intervalli di 75
2729 secondi per un massimo di 9 volte\footnote{entrambi questi valori possono
2730 essere modificati a livello di sistema (cioè per tutti i socket) con gli
2731 opportuni parametri illustrati in sez.~\ref{sec:sock_sysctl} ed a livello di
2732 singolo socket con le opzioni \texttt{TCP\_KEEP*} di
2733 sez.~\ref{sec:sock_tcp_udp_options}.} (per un totale di 11 minuti e 15
2734 secondi) dopo di che, se non si è ricevuta nessuna risposta, il socket viene
2735 chiuso dopo aver impostato un errore di \errcode{ETIMEDOUT}. Qualora la
2736 connessione si sia ristabilita e si riceva un successivo messaggio di risposta
2737 il ciclo riparte come se niente fosse avvenuto. Infine se si riceve come
2738 risposta un pacchetto ICMP di destinazione irraggiungibile (vedi
2739 sez.~\ref{sec:ICMP_protocol}), verrà restituito l'errore corrispondente.
2741 In generale questa opzione serve per individuare una caduta della connessione
2742 anche quando non si sta facendo traffico su di essa. Viene usata
2743 principalmente sui server per evitare di mantenere impegnate le risorse che
2744 verrebbero dedicate a trattare delle connessioni che in realtà sono già
2745 terminate (quelle che vengono anche chiamate connessioni
2746 \textsl{semi-aperte}); in tutti quei casi cioè in cui il server si trova in
2747 attesa di dati in ingresso su una connessione che non arriveranno mai o perché
2748 il client sull'altro capo non è più attivo o perché non è più in grado di
2749 comunicare con il server via rete.
2751 \begin{figure}[!htbp]
2752 \footnotesize \centering
2753 \begin{minipage}[c]{\codesamplewidth}
2754 \includecodesample{listati/TCP_echod_fourth.c}
2757 \caption{La sezione della nuova versione del server del servizio
2758 \textit{echo} che prevede l'attivazione del \textit{keepalive} sui
2760 \label{fig:echod_keepalive_code}
2763 Abilitandola dopo un certo tempo le connessioni effettivamente terminate
2764 verranno comunque chiuse per cui, utilizzando ad esempio una \func{select}, se
2765 ne potrà rilevare la conclusione e ricevere il relativo errore. Si tenga
2766 presente però che non può avere la certezza assoluta che un errore di
2767 \errcode{ETIMEDOUT} ottenuto dopo aver abilitato questa opzione corrisponda
2768 necessariamente ad una reale conclusione della connessione, il problema
2769 potrebbe anche essere dovuto ad un problema di routing che perduri per un
2770 tempo maggiore di quello impiegato nei vari tentativi di ritrasmissione del
2771 \textit{keep-alive} (anche se questa non è una condizione molto probabile).
2773 Come esempio dell'utilizzo di questa opzione introduciamo all'interno del
2774 nostro server per il servizio \textit{echo} la nuova opzione \texttt{-k} che
2775 permette di attivare il \textit{keep-alive} sui socket; tralasciando la parte
2776 relativa alla gestione di detta opzione (che si limita ad assegnare ad 1 la
2777 variabile \var{keepalive}) tutte le modifiche al server sono riportate in
2778 fig.~\ref{fig:echod_keepalive_code}. Al solito il codice completo è contenuto
2779 nel file \texttt{TCP\_echod\_fourth.c} dei sorgenti allegati alla guida.
2781 Come si può notare la variabile \var{keepalive} è preimpostata (\texttt{\small
2782 8}) ad un valore nullo; essa viene utilizzata sia come variabile logica per
2783 la condizione (\texttt{\small 14}) che controlla l'attivazione del
2784 \textit{keep-alive} che come valore dell'argomento \param{optval} della
2785 chiamata a \func{setsockopt} (\texttt{\small 16}). A seconda del suo valore
2786 tutte le volte che un processo figlio viene eseguito in risposta ad una
2787 connessione verrà pertanto eseguita o meno la sezione (\texttt{\small 14--17})
2788 che esegue l'impostazione di \const{SO\_KEEPALIVE} sul socket connesso,
2789 attivando il relativo comportamento.
2790 \constend{SO\_KEEPALIVE}
2794 \constbeg{SO\_REUSEADDR}
2795 \subsubsection{Le opzioni \const{SO\_REUSEADDR} e \const{SO\_REUSEPORT}}
2797 La seconda opzione da approfondire è \constd{SO\_REUSEADDR}, che consente di
2798 eseguire \func{bind} su un socket anche quando la porta specificata è già in
2799 uso da parte di un altro socket. Si ricordi infatti che, come accennato in
2800 sez.~\ref{sec:TCP_func_bind}, normalmente la funzione \func{bind} fallisce con
2801 un errore di \errcode{EADDRINUSE} se la porta scelta è già utilizzata da un
2802 altro socket, proprio per evitare che possano essere lanciati due server sullo
2803 stesso indirizzo e la stessa porta, che verrebbero a contendersi i pacchetti
2804 aventi quella destinazione.
2806 Esistono però situazioni ed esigenze particolari in cui non si vuole che
2807 questo comportamento di salvaguardia accada, ed allora si può fare ricorso a
2808 questa opzione. La questione è comunque abbastanza complessa in quanto, come
2809 sottolinea Stevens in \cite{UNP1}, si distinguono ben quattro casi diversi in
2810 cui è prevista la possibilità di un utilizzo di questa opzione, il che la
2811 rende una delle più difficili da capire.
2813 Il primo caso in cui si fa ricorso a \const{SO\_REUSEADDR}, che è anche il più
2814 comune, è quello in cui un server è terminato ma esistono ancora dei processi
2815 figli che mantengono attiva almeno una connessione remota che utilizza
2816 l'indirizzo locale, mantenendo occupata la porta. Quando si riesegue il server
2817 allora questo riceve un errore sulla chiamata a \func{bind} dato che la porta
2818 è ancora utilizzata in una connessione esistente.\footnote{questa è una delle
2819 domande più frequenti relative allo sviluppo, in quanto è piuttosto comune
2820 trovarsi in questa situazione quando si sta sviluppando un server che si
2821 ferma e si riavvia in continuazione dopo aver fatto modifiche.} Inoltre se
2822 si usa il protocollo TCP questo può avvenire anche dopo tutti i processi figli
2823 sono terminati, dato che una connessione può restare attiva anche dopo la
2824 chiusura del socket, mantenendosi nello stato \texttt{TIME\_WAIT} (vedi
2825 sez.~\ref{sec:TCP_time_wait}).
2827 \begin{figure}[!htbp]
2828 \footnotesize \centering
2829 \begin{minipage}[c]{\codesamplewidth}
2830 \includecodesample{listati/sockbindopt.c}
2833 \caption{Le sezioni della funzione \texttt{sockbindopt} modificate rispetto al
2834 codice della precedente \texttt{sockbind}.}
2835 \label{fig:sockbindopt_code}
2838 Usando \const{SO\_REUSEADDR} fra la chiamata a \func{socket} e quella a
2839 \func{bind} si consente a quest'ultima di avere comunque successo anche se la
2840 connessione è attiva (o nello stato \texttt{TIME\_WAIT}). È bene però
2841 ricordare (si riveda quanto detto in sez.~\ref{sec:TCP_time_wait}) che la
2842 presenza dello stato \texttt{TIME\_WAIT} ha una ragione, ed infatti se si usa
2843 questa opzione esiste sempre una probabilità, anche se estremamente
2844 remota,\footnote{perché ciò avvenga infatti non solo devono coincidere gli
2845 indirizzi IP e le porte degli estremi della nuova connessione, ma anche i
2846 numeri di sequenza dei pacchetti, e questo è estremamente improbabile.} che
2847 eventuali pacchetti rimasti intrappolati in una precedente connessione possano
2848 finire fra quelli di una nuova.
2850 Come esempio di uso di questa connessione abbiamo predisposto una nuova
2851 versione della funzione \texttt{sockbind} (vedi fig.~\ref{fig:sockbind_code})
2852 che consenta l'impostazione di questa opzione. La nuova funzione è
2853 \texttt{sockbindopt}, e le principali differenze rispetto alla precedente sono
2854 illustrate in fig.~\ref{fig:sockbindopt_code}, dove si sono riportate le
2855 sezioni di codice modificate rispetto alla versione precedente. Il codice
2856 completo della funzione si trova, insieme alle altre funzioni di servizio dei
2857 socket, all'interno del file \texttt{SockUtils.c} dei sorgenti allegati alla
2860 In realtà tutto quello che si è fatto è stato introdurre nella nuova funzione
2861 (\texttt{\small 1}) un nuovo argomento intero, \param{reuse}, che conterrà il
2862 valore logico da usare nella successiva chiamata (\texttt{\small 14}) a
2863 \func{setsockopt}. Si è poi aggiunta una sezione (\texttt{\small 13--17}) che
2864 esegue l'impostazione dell'opzione fra la chiamata a \func{socket} e quella a
2867 \begin{figure}[!htbp]
2868 \footnotesize \centering
2869 \begin{minipage}[c]{\codesamplewidth}
2870 \includecodesample{listati/TCP_echod_fifth.c}
2873 \caption{Il nuovo codice per l'apertura passiva del server \textit{echo} che
2874 usa la nuova funzione \texttt{sockbindopt}.}
2875 \label{fig:TCP_echod_fifth}
2878 A questo punto basterà modificare il server per utilizzare la nuova
2879 funzione; in fig.~\ref{fig:TCP_echod_fifth} abbiamo riportato le sezioni
2880 modificate rispetto alla precedente versione di
2881 fig.~\ref{fig:TCP_echod_third}. Al solito il codice completo è coi sorgenti
2882 allegati alla guida, nel file \texttt{TCP\_echod\_fifth.c}.
2884 Anche in questo caso si è introdotta (\texttt{\small 8}) una nuova variabile
2885 \var{reuse} che consente di controllare l'uso dell'opzione e che poi sarà
2886 usata (\texttt{\small 14}) come ultimo argomento di \func{setsockopt}. Il
2887 valore di default di questa variabile è nullo, ma usando l'opzione \texttt{-r}
2888 nell'invocazione del server (al solito la gestione delle opzioni non è
2889 riportata in fig.~\ref{fig:TCP_echod_fifth}) se ne potrà impostare ad 1 il
2890 valore, per cui in tal caso la successiva chiamata (\texttt{\small 13--17}) a
2891 \func{setsockopt} attiverà l'opzione \const{SO\_REUSEADDR}.
2893 Il secondo caso in cui viene usata \const{SO\_REUSEADDR} è quando si ha una
2894 macchina cui sono assegnati diversi indirizzi IP (o come suol dirsi
2895 \textit{multi-homed}) e si vuole porre in ascolto sulla stessa porta un
2896 programma diverso (o una istanza diversa dello stesso programma) per indirizzi
2897 IP diversi. Si ricordi infatti che è sempre possibile indicare a \func{bind}
2898 di collegarsi solo su di un indirizzo specifico; in tal caso se un altro
2899 programma cerca di riutilizzare la stessa porta (anche specificando un
2900 indirizzo diverso) otterrà un errore, a meno di non aver preventivamente
2901 impostato \const{SO\_REUSEADDR}.
2903 Usando questa opzione diventa anche possibile eseguire \func{bind}
2904 sull'indirizzo generico, e questo permetterà il collegamento per tutti gli
2905 indirizzi (di quelli presenti) per i quali la porta non risulti occupata da
2906 una precedente chiamata più specifica. Si tenga presente infatti che con il
2907 protocollo TCP non è in genere possibile far partire più server che eseguano
2908 \func{bind} sullo stesso indirizzo e la stessa porta se su di esso c'è già un
2909 socket in ascolto, cioè ottenere quello che viene chiamato un
2910 \itindex{completely~duplicate~binding} \textit{completely duplicate binding}
2911 (per questo è stata introdotta \const{SO\_REUSEPORT}).
2913 Il terzo impiego è simile al precedente e prevede l'uso di \func{bind}
2914 all'interno dello stesso programma per associare indirizzi locali diversi a
2915 socket diversi. In genere questo viene fatto per i socket UDP quando è
2916 necessario ottenere l'indirizzo a cui sono rivolte le richieste del client ed
2917 il sistema non supporta l'opzione \constd{IP\_RECVDSTADDR};\footnote{nel caso
2918 di Linux questa opzione è stata supportata per in certo periodo nello
2919 sviluppo del kernel 2.1.x, ma è in seguito stata soppiantata dall'uso di
2920 \const{IP\_PKTINFO} (vedi sez.~\ref{sec:sock_ipv4_options}).} in tale modo
2921 si può sapere a quale socket corrisponde un certo indirizzo. Non ha senso
2922 fare questa operazione per un socket TCP dato che su di essi si può sempre
2923 invocare \func{getsockname} una volta che si è completata la connessione.
2925 Infine il quarto caso è quello in cui si vuole effettivamente ottenere un
2926 \textit{completely duplicate binding}, quando cioè si vuole eseguire
2927 \func{bind} su un indirizzo ed una porta che sono già ``\textsl{legati}'' ad
2928 un altro socket. Come accennato questo con TCP non è possibile, ed ha anche
2929 poco senso pensare di mettere in ascolto due server sulla stessa porta. Se
2930 però si prende in considerazione il traffico in \textit{multicast}, diventa
2931 assolutamente normale che i pacchetti provenienti dal traffico in
2932 \textit{multicast} possano essere ricevuti da più applicazioni o da diverse
2933 istanze della stessa applicazione sulla stessa porte di un indirizzo di
2936 Un esempio classico è quello di uno streaming di dati (audio, video, ecc.) in
2937 cui l'uso del \textit{multicast} consente di trasmettere un solo pacchetto da
2938 recapitare a tutti i possibili destinatari (invece di inviarne un duplicato a
2939 ciascuno); in questo caso è perfettamente logico aspettarsi che sulla stessa
2940 macchina più utenti possano lanciare un programma che permetta loro di
2941 ricevere gli stessi dati, e quindi effettuare un \textit{completely duplicate
2944 In questo caso utilizzando \const{SO\_REUSEADDR} si può consentire ad una
2945 applicazione eseguire \func{bind} sulla stessa porta ed indirizzo usata da
2946 un'altra, così che anche essa possa ricevere gli stessi pacchetti. Come detto
2947 la cosa non è possibile con i socket TCP (per i quali il \textit{multicast}
2948 comunque non è applicabile), ma lo è per quelli UDP che è il protocollo
2949 normalmente in uso da parte di queste applicazioni. La regola è che quando si
2950 hanno più applicazioni che hanno eseguito \func{bind} sulla stessa porta, di
2951 tutti pacchetti destinati ad un indirizzo di \textit{broadcast} o di
2952 \textit{multicast} viene inviata una copia a ciascuna applicazione. Non è
2953 definito invece cosa accade qualora il pacchetto sia destinato ad un indirizzo
2954 normale (\textit{unicast}).
2956 % TODO documentare SO_REUSEPORT, vedi https://lwn.net/Articles/542260/
2958 \constbeg{SO\_REUSEPORT}
2960 Esistono però dei casi, in particolare per l'uso di programmi
2961 \textit{multithreaded}, in cui può servire un \textit{completely duplicate
2962 binding} anche per delle ordinarie connessioni TCP. Per supportare queste
2963 esigenze a partire dal kernel 3.9 è stata introdotta un'altra opzione,
2964 \const{SO\_REUSEPORT} (già presente in altri sistemi come BSD), che consente
2965 di eseguire il \textit{completely duplicate binding}, fintanto che essa venga
2966 specificata per tutti i socket interessati. Come per \const{SO\_REUSEADDR}
2967 sarà possibile usare l'opzione su un socket legato allo stesso indirizzo e
2968 porta solo se il programma che ha eseguito il primo \func{bind} ha impostato
2971 Nel caso di \const{SO\_REUSEPORT} oltre al fatto che l'opzione deve essere
2972 attivata sul socket prima di chiamare \func{bind} ed attiva su tutti i socket
2973 con \textit{completely duplicate binding}, è richiesto pure che tutti i
2974 processi che si mettono in ascolto sullo stesso indirizzo e porta abbiano lo
2975 stesso \ids{UID} effettivo, per evitare che un altro utente possa ottenere il
2976 relativo traffico (eseguendo quello che viene definito \textit{port hijacking}
2977 o \textit{port stealing}). L'opzione utilizza per \param{optval} un intero
2978 usato come valore logico.
2980 L'opzione si usa sia per socket TCP che UDP, nel primo caso consente un uso
2981 distribuito di \func{accept} in una applicazione \textit{multithreaded}
2982 passando un diverso \textit{listening socket} ad ogni thread, cosa che
2983 migliora le prestazioni rispetto all'approccio tradizionale di usare un thread
2984 per usare \func{accept} e distribuire le connessioni agli altri o avere più
2985 thread che competono per usare \func{accept} sul socket. Nel caso di UDP
2986 l'opzione consente di distribuire meglio i pacchetti su più processi o thread,
2987 rispetto all'approccio tradizionale di far competere gli stessi per l'accesso
2988 in ricezione al socket.
2990 % TODO documentare SO_REUSEPORT introdotta con il kernel 3.9, vedi
2991 % http://git.kernel.org/linus/c617f398edd4db2b8567a28e899a88f8f574798d TODO:
2992 % in cosa differisce da REUSEADDR?
2994 \constend{SO\_REUSEPORT}
2995 \constend{SO\_REUSEADDR}
2998 \constbeg{SO\_LINGER}
2999 \subsubsection{L'opzione \const{SO\_LINGER}}
3001 La terza opzione da approfondire è \const{SO\_LINGER}; essa, come il nome
3002 suggerisce, consente di ``\textsl{indugiare}'' nella chiusura di un socket. Il
3003 comportamento standard sia di \func{close} che \func{shutdown} è infatti
3004 quello di terminare immediatamente dopo la chiamata, mentre il procedimento di
3005 chiusura della connessione (o di un lato di essa) ed il rispettivo invio sulla
3006 rete di tutti i dati ancora presenti nei buffer, viene gestito in sottofondo
3009 \begin{figure}[!htb]
3010 \footnotesize \centering
3011 \begin{minipage}[c]{0.80\textwidth}
3012 \includestruct{listati/linger.h}
3014 \caption{La struttura \structd{linger} richiesta come valore dell'argomento
3015 \param{optval} per l'impostazione dell'opzione dei socket
3016 \const{SO\_LINGER}.}
3017 \label{fig:sock_linger_struct}
3020 L'uso di \const{SO\_LINGER} con \func{setsockopt} permette di modificare (ed
3021 eventualmente ripristinare) questo comportamento in base ai valori passati nei
3022 campi della struttura \struct{linger}, illustrata in
3023 fig.~\ref{fig:sock_linger_struct}. Fintanto che il valore del campo
3024 \var{l\_onoff} di \struct{linger} è nullo la modalità che viene impostata
3025 (qualunque sia il valore di \var{l\_linger}) è quella standard appena
3026 illustrata; questa combinazione viene utilizzata per riportarsi al
3027 comportamento normale qualora esso sia stato cambiato da una precedente
3030 Se si utilizza un valore di \var{l\_onoff} diverso da zero, il comportamento
3031 alla chiusura viene a dipendere dal valore specificato per il campo
3032 \var{l\_linger}; se quest'ultimo è nullo l'uso delle funzioni \func{close} e
3033 \func{shutdown} provoca la terminazione immediata della connessione: nel caso
3034 di TCP cioè non viene eseguito il procedimento di chiusura illustrato in
3035 sez.~\ref{sec:TCP_conn_term}, ma tutti i dati ancora presenti nel buffer
3036 vengono immediatamente scartati e sulla rete viene inviato un segmento di RST
3037 che termina immediatamente la connessione.
3039 Un esempio di questo comportamento si può abilitare nel nostro client del
3040 servizio \textit{echo} utilizzando l'opzione \texttt{-r}; riportiamo in
3041 fig.~\ref{fig:TCP_echo_sixth} la sezione di codice che permette di introdurre
3042 questa funzionalità; al solito il codice completo è disponibile nei sorgenti
3045 \begin{figure}[!htbp]
3046 \footnotesize \centering
3047 \begin{minipage}[c]{\codesamplewidth}
3048 \includecodesample{listati/TCP_echo_sixth.c}
3051 \caption{La sezione del codice del client \textit{echo} che imposta la
3052 terminazione immediata della connessione in caso di chiusura.}
3053 \label{fig:TCP_echo_sixth}
3056 La sezione indicata viene eseguita dopo aver effettuato la connessione e prima
3057 di chiamare la funzione di gestione, cioè fra le righe (\texttt{\small 12}) e
3058 (\texttt{\small 13}) del precedente esempio di fig.~\ref{fig:TCP_echo_fifth}.
3059 Il codice si limita semplicemente a controllare (\texttt{\small 3}) il
3060 valore della variabile \var{reset} che assegnata nella gestione delle opzioni
3061 in corrispondenza all'uso di \texttt{-r} nella chiamata del client. Nel caso
3062 questa sia diversa da zero vengono impostati (\texttt{\small 5--6}) i valori
3063 della struttura \var{ling} che permettono una terminazione immediata della
3064 connessione. Questa viene poi usata nella successiva (\texttt{\small 7})
3065 chiamata a \func{setsockopt}. Al solito si controlla (\texttt{\small 7--10})
3066 il valore di ritorno e si termina il programma in caso di errore, stampandone
3069 Infine l'ultima possibilità, quella in cui si utilizza effettivamente
3070 \const{SO\_LINGER} per \textsl{indugiare} nella chiusura, è quella in cui sia
3071 \var{l\_onoff} che \var{l\_linger} hanno un valore diverso da zero. Se si
3072 esegue l'impostazione con questi valori sia \func{close} che \func{shutdown}
3073 si bloccano, nel frattempo viene eseguita la normale procedura di conclusione
3074 della connessione (quella di sez.~\ref{sec:TCP_conn_term}) ma entrambe le
3075 funzioni non ritornano fintanto che non si sia concluso il procedimento di
3076 chiusura della connessione, o non sia passato un numero di
3077 secondi\footnote{questa è l'unità di misura indicata da POSIX ed adottata da
3078 Linux, altri kernel possono usare unità di misura diverse, oppure usare il
3079 campo \var{l\_linger} come valore logico (ignorandone il valore) per rendere
3080 (quando diverso da zero) \func{close} e \func{shutdown} bloccanti fino al
3081 completamento della trasmissione dei dati sul buffer.} pari al valore
3082 specificato in \var{l\_linger}.
3084 \constend{SO\_LINGER}
3088 \subsection{Le opzioni per il protocollo IPv4}
3089 \label{sec:sock_ipv4_options}
3091 Il secondo insieme di opzioni dei socket che tratteremo è quello relativo ai
3092 socket che usano il protocollo IPv4; come per le precedenti opzioni generiche
3093 una descrizione di esse è disponibile nella settima sezione delle pagine di
3094 manuale, nel caso specifico la documentazione si può consultare con
3100 \begin{tabular}[c]{|l|c|c|c|l|p{5.cm}|}
3102 \textbf{Opzione}&\texttt{get}&\texttt{set}&\textbf{flag}&\textbf{Tipo}&
3103 \textbf{Descrizione}\\
3106 \const{IP\_ADD\_MEMBERSHIP} & &$\bullet$& &\struct{ip\_mreqn}&
3107 Si unisce a un gruppo di \textit{multicast}.\\
3108 \const{IP\_ADD\_SOURCE\_MEMBERSHIP} & &$\bullet$& &\struct{ip\_mreq\_source}&
3109 Si unisce a un gruppo di \textit{multicast} per una sorgente.\\
3110 \const{IP\_BLOCK\_SOURCE} & &$\bullet$& &\struct{ip\_mreq\_source}&
3111 Smette di ricevere dati di \textit{multicast} per una sorgente.\\
3112 \const{IP\_DROP\_MEMBERSHIP}& &$\bullet$& &\struct{ip\_mreqn}&
3113 Si sgancia da un gruppo di \textit{multicast}.\\
3114 \const{IP\_DROP\_SOURCE\_MEMBERSHIP}& &$\bullet$& &\struct{ip\_mreq\_source}&
3115 Si sgancia da un gruppo di \textit{multicast} per una sorgente.\\
3116 \const{IP\_FREEBIND} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3117 Abilita il \textit{binding} a un indirizzo IP non locale ancora non assegnato.\\
3118 \const{IP\_HDRINCL} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3119 Passa l'intestazione di IP nei dati.\\
3120 \const{IP\_MINTTL} &$\bullet$&$\bullet$& &\texttt{int}&
3121 Imposta il valore minimo del TTL per i pacchetti accettati.\\
3122 \const{IP\_MSFILTER} &$\bullet$&$\bullet$& &\struct{ip\_msfilter}&
3123 Accesso completo all'interfaccia per il filtraggio delle sorgenti
3124 \textit{multicast}.\\
3125 \const{IP\_MTU} &$\bullet$& & &\texttt{int}&
3126 Legge il valore attuale della MTU.\\
3127 \const{IP\_MTU\_DISCOVER} &$\bullet$&$\bullet$& &\texttt{int}&
3128 Imposta il \textit{Path MTU Discovery}.\\
3129 \const{IP\_MULTICAST\_ALL} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3130 Imposta l'interfaccia locale di un socket \textit{multicast}.\\
3131 \const{IP\_MULTICAST\_IF} & &$\bullet$& &\struct{ip\_mreqn}&
3132 Imposta l'interfaccia locale di un socket \textit{multicast}.\\
3133 \const{IP\_MULTICAST\_LOOP} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3134 Controlla il reinvio a se stessi dei dati di \textit{multicast}.\\
3135 \const{IP\_MULTICAST\_TTL} &$\bullet$&$\bullet$& &\texttt{int}&
3136 Imposta il TTL per i pacchetti \textit{multicast}.\\
3137 \const{IP\_NODEFRAG} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3138 Disabilita il riassemblaggio di pacchetti frammentati.\\
3139 \const{IP\_OPTIONS} &$\bullet$&$\bullet$&&\texttt{void *}& %???
3140 Imposta o riceve le opzioni di IP.\\
3141 \const{IP\_PKTINFO} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3142 Abilita i messaggi di informazione.\\
3143 \const{IP\_RECVERR} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3144 Abilita i messaggi di errore affidabili.\\
3145 \const{IP\_RECVOPTS} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3146 Passa un messaggio con le opzioni IP.\\
3147 \const{IP\_RECVORIGSTADDR} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3148 Abilita i messaggi con l'indirizzo di destinazione originale.\\
3149 \const{IP\_RECVTOS} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3150 Passa un messaggio col campo TOS.\\
3151 \const{IP\_RECVTTL} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3152 Abilita i messaggi col campo TTL.\\
3153 \const{IP\_RETOPTS} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3154 Abilita i messaggi con le opzioni IP non trattate.\\
3155 \const{IP\_ROUTER\_ALERT} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3156 Imposta l'opzione \textit{IP router alert} sui pacchetti.\\
3157 \const{IP\_TOS} &$\bullet$&$\bullet$& &\texttt{int}&
3158 Imposta il valore del campo TOS.\\
3159 \const{IP\_TRANSPARENT} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3160 Abilita un \textit{proxing} trasparente sul socket.\\
3161 \const{IP\_TTL} &$\bullet$&$\bullet$& &\texttt{int}&
3162 Imposta il valore del campo TTL.\\
3163 \const{IP\_UNBLOCK\_SOURCE} & &$\bullet$& &\struct{ip\_mreq\_source}&
3164 Ricomincia a ricevere dati di \textit{multicast} per una sorgente.\\
3167 \caption{Le opzioni disponibili al livello \const{IPPROTO\_IP}.}
3168 \label{tab:sock_opt_iplevel}
3171 Se si vuole operare su queste opzioni generiche il livello da utilizzare è
3172 \constd{IPPROTO\_IP} (o l'equivalente \const{SOL\_IP}); si è riportato un
3173 elenco di queste opzioni in tab.~\ref{tab:sock_opt_iplevel}. Le costanti
3174 indicanti le opzioni, e tutte le altre costanti ad esse collegate, sono
3175 definite in \headfiled{netinet/ip.h}, ed accessibili includendo detto file.
3177 Le descrizioni riportate in tab.~\ref{tab:sock_opt_iplevel} sono estremamente
3178 succinte, una maggiore quantità di dettagli sulle varie opzioni è fornita nel
3180 \begin{basedescript}{\desclabelwidth{2.0cm}\desclabelstyle{\nextlinelabel}}
3181 \item[\constd{IP\_ADD\_MEMBERSHIP}] L'opzione consente di unirsi ad gruppo di
3182 \textit{multicast}, e può essere usata solo con \func{setsockopt}.
3183 L'argomento \param{optval} in questo caso deve essere una struttura di tipo
3184 \struct{ip\_mreqn}, illustrata in fig.~\ref{fig:ip_mreqn_struct}, che
3185 permette di indicare, con il campo \var{imr\_multiaddr} l'indirizzo del
3186 gruppo di \textit{multicast} a cui ci si vuole unire, con il campo
3187 \var{imr\_address} l'indirizzo dell'interfaccia locale con cui unirsi al
3188 gruppo di \textit{multicast} e con \var{imr\_ifindex} l'indice
3189 dell'interfaccia da utilizzare (un valore nullo indica una interfaccia
3192 \begin{figure}[!htb]
3193 \footnotesize \centering
3194 \begin{minipage}[c]{0.70\textwidth}
3195 \includestruct{listati/ip_mreqn.h}
3197 \caption{La struttura \structd{ip\_mreqn} utilizzata per unirsi a un gruppo di
3198 \textit{multicast}.}
3199 \label{fig:ip_mreqn_struct}
3202 Questa struttura è presente a partire dal kernel 2.2, per compatibilità è
3203 possibile utilizzare anche un argomento di tipo \struct{ip\_mreq}, presente
3204 fino dal kernel 1.2, che differisce da essa soltanto per l'assenza del campo
3205 \var{imr\_ifindex}; il kernel riconosce il tipo di struttura in base alla
3206 differente dimensione passata in \param{optlen}.
3208 \item[\constd{IP\_ADD\_SOURCE\_MEMBERSHIP}] L'opzione consente di unirsi ad
3209 gruppo di \textit{multicast}, ricevendo i dati solo da una sorgente
3210 specifica; come \const{IP\_ADD\_MEMBERSHIP} può essere usata solo con
3213 \begin{figure}[!htb]
3214 \footnotesize \centering
3215 \begin{minipage}[c]{0.70\textwidth}
3216 \includestruct{listati/ip_mreq_source.h}
3218 \caption{La struttura \structd{ip\_mreqn} utilizzata per unirsi a un gruppo di
3219 \textit{multicast} per una specifica sorgente.}
3220 \label{fig:ip_mreq_source_struct}
3223 L'argomento \param{optval} in questo caso è una struttura
3224 \struct{ip\_mreq\_source} illustrata in fig.~\ref{fig:ip_mreq_source_struct},
3225 dove il campo \var{imr\_multiaddr} è l'indirizzo del gruppo di
3226 \textit{multicast}, il campo \var{imr\_interface} l'indirizzo dell'interfaccia
3227 locale che deve essere usata per aggiungersi al gruppo di \textit{multicast} e
3228 il campo \var{imr\_sourceaddr} l'indirizzo della sorgente da cui
3229 l'applicazione vuole ricevere i dati. L'opzione può essere ripetuta più volte
3230 per collegarsi a diverse sorgenti.
3232 \item[\constd{IP\_BLOCK\_SOURCE}] Questa opzione, disponibile dal kernel
3233 2.4.22, consente di smettere di ricevere dati di \textit{multicast} dalla
3234 sorgente (e relativo gruppo) specificati dalla struttura
3235 \struct{ip\_mreq\_source} (vedi fig.~\ref{fig:ip_mreq_source_struct})
3236 passata come argomento \param{optval}. L'opzione è utilizzabile solo se si è
3237 già registrati nel gruppo di \textit{multicast} indicato con un precedente
3238 utilizzo di \const{IP\_ADD\_MEMBERSHIP} o
3239 \const{IP\_ADD\_SOURCE\_MEMBERSHIP}.
3241 \item[\constd{IP\_DROP\_MEMBERSHIP}] Lascia un gruppo di \textit{multicast},
3242 prende per \param{optval} la stessa struttura \struct{ip\_mreqn} (o
3243 \struct{ip\_mreq}) usata per \const{IP\_ADD\_MEMBERSHIP} (vedi
3244 fig.~\ref{fig:ip_mreqn_struct}).
3246 \item[\constd{IP\_DROP\_SOURCE\_MEMBERSHIP}] Lascia un gruppo di
3247 \textit{multicast} per una specifica sorgente, prende per \param{optval} la
3248 stessa struttura \struct{ip\_mreq\_source} usata per
3249 \const{IP\_ADD\_SOURCE\_MEMBERSHIP} (vedi
3250 fig.~\ref{fig:ip_mreq_source_struct}). Se ci si è registrati per più
3251 sorgenti nello stesso gruppo, si continuerà a ricevere dati sulle altre. Per
3252 smettere di ricevere dati da tutte le sorgenti occorre usare l'opzione
3253 \const{IP\_LEAVE\_GROUP}.
3255 \item[\constd{IP\_FREEBIND}] Se abilitata questa opzione, disponibile dal
3256 kernel 2.4, consente di usare \func{bind} anche su un indirizzo IP non
3257 locale o che ancora non è stato assegnato. Questo permette ad una
3258 applicazione di mettersi in ascolto su un socket prima che l'interfaccia
3259 sottostante o l'indirizzo che questa deve usare sia stato configurato. È
3260 l'equivalente a livello di singolo socket dell'uso della \textit{sysctl}
3261 \texttt{ip\_nonlocal\_bind} che vedremo in
3262 sez.~\ref{sec:sock_ipv4_sysctl}. Prende per
3263 \param{optval} un intero usato come valore logico.
3265 \item[\constd{IP\_HDRINCL}] Se viene abilitata questa opzione, presente dal
3266 kernel 2.0, l'utente deve fornire lui stesso l'intestazione del protocollo
3267 IP in testa ai propri dati. L'opzione è valida soltanto per socket di tipo
3268 \const{SOCK\_RAW}, e quando utilizzata eventuali valori impostati con
3269 \const{IP\_OPTIONS}, \const{IP\_TOS} o \const{IP\_TTL} sono ignorati. In
3270 ogni caso prima della spedizione alcuni campi dell'intestazione vengono
3271 comunque modificati dal kernel, torneremo sull'argomento in
3272 sez.~\ref{sec:socket_raw}. Prende per \param{optval} un intero usato come
3275 \item[\constd{IP\_MSFILTER}] L'opzione, introdotta con il kernel 2.4.22,
3276 fornisce accesso completo all'interfaccia per il filtraggio delle sorgenti
3277 di \textit{multicast} (il cosiddetto \textit{multicast source filtering},
3278 definito dall'\href{http://www.ietf.org/rfc/rfc3376.txt}{RFC~3376}).
3280 \begin{figure}[!htb]
3281 \footnotesize \centering
3282 \begin{minipage}[c]{0.70\textwidth}
3283 \includestruct{listati/ip_msfilter.h}
3285 \caption{La struttura \structd{ip\_msfilter} utilizzata per il
3286 \textit{multicast source filtering}.}
3287 \label{fig:ip_msfilter_struct}
3290 L'argomento \param{optval} è una struttura \struct{ip\_msfilter} illustrata in
3291 fig.~\ref{fig:ip_msfilter_struct}, il campo \var{imsf\_multiaddr} è
3292 l'indirizzo del gruppo di \textit{multicast}, il campo \var{imsf\_interface}
3293 l'indirizzo dell'interfaccia locale, il campo \var{imsf\_mode} indica la
3294 modalità di filtraggio e con i campi \var{imsf\_numsrc} e \var{imsf\_slist}
3295 rispettivamente la lunghezza della lista, e la lista stessa, degli indirizzi
3298 Come ausilio all'uso di questa opzione sono disponibili le macro
3299 \macro{MCAST\_INCLUDE} e \macro{MCAST\_EXCLUDE} che si possono usare per
3300 \var{imsf\_mode}. Inoltre si può usare la macro
3301 \macro{IP\_MSFILTER\_SIZE}\texttt{(\textsf{n})} per determinare il valore
3302 di \param{optlen} con una struttura \struct{ip\_msfilter} contenente
3303 \texttt{\textsf{n}} sorgenti in \var{imsf\_slist}.
3305 \item[\constd{IP\_MINTTL}] L'opzione, introdotta con il kernel 2.6.34, imposta
3306 un valore minimo per il campo \textit{Time to Live} dei pacchetti associati
3307 al socket su cui è attivata, che se non rispettato ne causa lo scarto
3308 automatico. L'opzione è nata per implementare
3309 l'\href{http://www.ietf.org/rfc/rfc5082.txt}{RFC~5082} che la prevede come
3310 forma di protezione per i router che usano il protocollo BGP poiché questi,
3311 essendo in genere adiacenti, possono, impostando un valore di 255, scartare
3312 automaticamente tutti gli eventuali pacchetti falsi creati da un attacco a
3313 questo protocollo, senza doversi curare di verificarne la
3314 validità.\footnote{l'attacco viene in genere portato per causare un
3315 \textit{Denial of Service} aumentando il consumo di CPU del router nella
3316 verifica dell'autenticità di un gran numero di pacchetti di pacchetti
3317 falsi; questi, arrivando da sorgenti diverse da un router adiacente, non
3318 potrebbero più avere un TTL di 255 anche qualora questo fosse stato il
3319 valore di partenza, e l'impostazione dell'opzione consente di scartarli
3320 senza carico aggiuntivo sulla CPU (che altrimenti dovrebbe calcolare una
3324 \item[\constd{IP\_MTU}] Permette di leggere il valore della \textit{Path MTU}
3325 di percorso del socket. L'opzione richiede per \param{optval} un intero che
3326 conterrà il valore della \textit{Path MTU} in byte. Questa è una opzione
3327 introdotta con i kernel della serie 2.2.x, ed è specifica di Linux.
3329 È tramite questa opzione che un programma può leggere, quando si è avuto un
3330 errore di \errval{EMSGSIZE}, il valore della MTU corrente del socket. Si
3331 tenga presente che per poter usare questa opzione, oltre ad avere abilitato
3332 la scoperta della \textit{Path MTU}, occorre che il socket sia stato
3333 esplicitamente connesso con \func{connect}.
3335 Ad esempio con i socket UDP si potrà ottenere una stima iniziale della
3336 \textit{Path MTU} eseguendo prima una \func{connect} verso la destinazione,
3337 e poi usando \func{getsockopt} con questa opzione. Si può anche avviare
3338 esplicitamente il procedimento di scoperta inviando un pacchetto di grosse
3339 dimensioni (che verrà scartato) e ripetendo l'invio coi dati aggiornati. Si
3340 tenga infine conto che durante il procedimento i pacchetti iniziali possono
3341 essere perduti, ed è compito dell'applicazione gestirne una eventuale
3344 \item[\constd{IP\_MTU\_DISCOVER}] Questa è una opzione introdotta con i kernel
3345 della serie 2.2.x, ed è specifica di Linux. L'opzione permette di scrivere
3346 o leggere le impostazioni della modalità usata per la determinazione della
3347 \textit{Path MTU} (vedi sez.~\ref{sec:net_lim_dim}) del
3348 socket. L'opzione prende per \param{optval} un valore intero che indica la
3349 modalità usata, da specificare con una delle costanti riportate in
3350 tab.~\ref{tab:sock_ip_mtu_discover}.
3355 \begin{tabular}[c]{|l|r|p{7cm}|}
3357 \multicolumn{2}{|c|}{\textbf{Valore}}&\textbf{Significato} \\
3360 \constd{IP\_PMTUDISC\_DONT}&0& Non effettua la ricerca dalla \textit{Path
3362 \constd{IP\_PMTUDISC\_WANT}&1& Utilizza il valore impostato per la rotta
3363 utilizzata dai pacchetti (dal comando
3365 \constd{IP\_PMTUDISC\_DO} &2& Esegue la procedura di determinazione
3366 della \textit{Path MTU} come richiesto
3367 dall'\href{http://www.ietf.org/rfc/rfc1191.txt}{RFC~1191}.\\
3368 \constd{IP\_PMTUDISC\_PROBE}&?& .\\
3371 \caption{Valori possibili per l'argomento \param{optval} di
3372 \const{IP\_MTU\_DISCOVER}.}
3373 \label{tab:sock_ip_mtu_discover}
3376 Il valore di default applicato ai socket di tipo \const{SOCK\_STREAM} è
3377 determinato dal parametro \texttt{ip\_no\_pmtu\_disc} (vedi
3378 sez.~\ref{sec:sock_sysctl}), mentre per tutti gli altri socket di default la
3379 ricerca è disabilitata ed è responsabilità del programma creare pacchetti di
3380 dimensioni appropriate e ritrasmettere eventuali pacchetti persi. Se
3381 l'opzione viene abilitata, il kernel si incaricherà di tenere traccia
3382 automaticamente della \textit{Path MTU} verso ciascuna destinazione, e
3383 rifiuterà immediatamente la trasmissione di pacchetti di dimensioni maggiori
3384 della MTU con un errore di \errval{EMSGSIZE}.\footnote{in caso contrario la
3385 trasmissione del pacchetto sarebbe effettuata, ottenendo o un fallimento
3386 successivo della trasmissione, o la frammentazione dello stesso.}
3389 \item[\constd{IP\_MULTICAST\_IF}] Imposta l'interfaccia locale per l'utilizzo
3390 del \textit{multicast}, ed utilizza come \param{optval} le stesse strutture
3391 \struct{ip\_mreqn} o \struct{ip\_mreq} delle due precedenti opzioni.
3393 \item[\constd{IP\_MULTICAST\_LOOP}] L'opzione consente di decidere se i dati
3394 che si inviano su un socket usato con il \textit{multicast} vengano ricevuti
3395 anche sulla stessa macchina da cui li si stanno inviando. Prende per
3396 \param{optval} un intero usato come valore logico.
3398 In generale se si vuole che eventuali client possano ricevere i dati che si
3399 inviano occorre che questa funzionalità sia abilitata (come avviene di
3400 default). Qualora però non si voglia generare traffico per dati che già sono
3401 disponibili in locale l'uso di questa opzione permette di disabilitare
3402 questo tipo di traffico.
3404 \item[\constd{IP\_MULTICAST\_TTL}] L'opzione permette di impostare o leggere il
3405 valore del campo TTL per i pacchetti \textit{multicast} in uscita associati
3406 al socket. È importante che questo valore sia il più basso possibile, ed il
3407 default è 1, che significa che i pacchetti non potranno uscire dalla rete
3408 locale. Questa opzione consente ai programmi che lo richiedono di superare
3409 questo limite. L'opzione richiede per
3410 \param{optval} un intero che conterrà il valore del TTL.
3411 % TODO chiarire quale è la struttura \struct{ip\_mreq}
3413 \item[\constd{IP\_OPTIONS}] l'opzione permette di impostare o leggere le
3414 opzioni del protocollo IP (si veda sez.~\ref{sec:IP_options}). L'opzione
3415 prende come valore dell'argomento \param{optval} un puntatore ad un buffer
3416 dove sono mantenute le opzioni, mentre \param{optlen} indica la dimensione
3417 di quest'ultimo. Quando la si usa con \func{getsockopt} vengono lette le
3418 opzioni IP utilizzate per la spedizione, quando la si usa con
3419 \func{setsockopt} vengono impostate le opzioni specificate. L'uso di questa
3420 opzione richiede una profonda conoscenza del funzionamento del protocollo,
3421 torneremo in parte sull'argomento in sez.~\ref{sec:sock_IP_options}.
3423 \item[\constd{IP\_PKTINFO}] Quando abilitata l'opzione permette di ricevere
3424 insieme ai pacchetti un messaggio ancillare (vedi
3425 sez.~\ref{sec:net_ancillary_data}) di tipo \const{IP\_PKTINFO} contenente
3426 una struttura \struct{pktinfo} (vedi fig.~\ref{fig:sock_pktinfo_struct}) che
3427 mantiene una serie di informazioni riguardo i pacchetti in arrivo. In
3428 particolare è possibile conoscere l'interfaccia su cui è stato ricevuto un
3429 pacchetto (nel campo \var{ipi\_ifindex}),\footnote{in questo campo viene
3430 restituito il valore numerico dell'indice dell'interfaccia,
3431 sez.~\ref{sec:sock_ioctl_netdevice}.} l'indirizzo locale da esso
3432 utilizzato (nel campo \var{ipi\_spec\_dst}) e l'indirizzo remoto dello
3433 stesso (nel campo \var{ipi\_addr}).
3435 \begin{figure}[!htb]
3436 \footnotesize \centering
3437 \begin{minipage}[c]{0.80\textwidth}
3438 \includestruct{listati/pktinfo.h}
3440 \caption{La struttura \structd{pktinfo} usata dall'opzione
3441 \const{IP\_PKTINFO} per ricavare informazioni sui pacchetti di un socket
3442 di tipo \const{SOCK\_DGRAM}.}
3443 \label{fig:sock_pktinfo_struct}
3447 L'opzione è utilizzabile solo per socket di tipo \const{SOCK\_DGRAM}. Questa è
3448 una opzione introdotta con i kernel della serie 2.2.x, ed è specifica di
3449 Linux;\footnote{non dovrebbe pertanto essere utilizzata se si ha a cuore la
3450 portabilità.} essa permette di sostituire le opzioni \const{IP\_RECVDSTADDR}
3451 e \const{IP\_RECVIF} presenti in altri Unix (la relativa informazione è quella
3452 ottenibile rispettivamente dai campi \var{ipi\_addr} e \var{ipi\_ifindex} di
3455 L'opzione prende per \param{optval} un intero usato come valore logico, che
3456 specifica soltanto se insieme al pacchetto deve anche essere inviato o
3457 ricevuto il messaggio \const{IP\_PKTINFO} (vedi
3458 sez.~\ref{sec:net_ancillary_data}); il messaggio stesso dovrà poi essere
3459 letto o scritto direttamente con \func{recvmsg} e \func{sendmsg} (vedi
3460 sez.~\ref{sec:net_sendmsg}).
3462 \item[\constd{IP\_RECVERR}] Questa è una opzione introdotta con i kernel della
3463 serie 2.2.x, ed è specifica di Linux. Essa permette di usufruire di un
3464 meccanismo affidabile per ottenere un maggior numero di informazioni in caso
3465 di errori. Se l'opzione è abilitata tutti gli errori generati su un socket
3466 vengono memorizzati su una coda, dalla quale poi possono essere letti con
3467 \func{recvmsg} (vedi sez.~\ref{sec:net_sendmsg}) come messaggi ancillari
3468 (torneremo su questo in sez.~\ref{sec:net_ancillary_data}) di tipo
3469 \const{IP\_RECVERR}. L'opzione richiede per \param{optval} un intero usato
3470 come valore logico e non è applicabile a socket di tipo
3471 \const{SOCK\_STREAM}.
3473 \item[\constd{IP\_RECVOPTS}] Quando abilitata l'opzione permette di ricevere
3474 insieme ai pacchetti un messaggio ancillare (vedi
3475 sez.~\ref{sec:net_ancillary_data}) di tipo \const{IP\_OPTIONS}, contenente
3476 le opzioni IP del protocollo (vedi sez.~\ref{sec:IP_options}). Le
3477 intestazioni di instradamento e le altre opzioni sono già riempite con i
3478 dati locali. L'opzione richiede per \param{optval} un intero usato come
3479 valore logico. L'opzione non è supportata per socket di tipo
3480 \const{SOCK\_STREAM}.
3482 \item[\constd{IP\_RECVTOS}] Quando abilitata l'opzione permette di ricevere
3483 insieme ai pacchetti un messaggio ancillare (vedi
3484 sez.~\ref{sec:net_ancillary_data}) di tipo \const{IP\_TOS}, che contiene un
3485 byte con il valore del campo \textit{Type of Service} dell'intestazione IP
3486 del pacchetto stesso (vedi sez.~\ref{sec:IP_header}). Prende per
3487 \param{optval} un intero usato come valore logico.
3489 \item[\constd{IP\_RECVTTL}] Quando abilitata l'opzione permette di ricevere
3490 insieme ai pacchetti un messaggio ancillare (vedi
3491 sez.~\ref{sec:net_ancillary_data}) di tipo \const{IP\_RECVTTL}, contenente
3492 un byte con il valore del campo \textit{Time to Live} dell'intestazione IP
3493 (vedi sez.~\ref{sec:IP_header}). L'opzione richiede per \param{optval} un
3494 intero usato come valore logico. L'opzione non è supportata per socket di
3495 tipo \const{SOCK\_STREAM}.
3497 \item[\constd{IP\_RETOPTS}] Identica alla precedente \const{IP\_RECVOPTS}, ma
3498 in questo caso restituisce i dati grezzi delle opzioni, senza che siano
3499 riempiti i capi di instradamento e le marche temporali. L'opzione richiede
3500 per \param{optval} un intero usato come valore logico. L'opzione non è
3501 supportata per socket di tipo \const{SOCK\_STREAM}.
3503 \item[\constd{IP\_ROUTER\_ALERT}] Questa è una opzione introdotta con i
3504 kernel della serie 2.2.x, ed è specifica di Linux. Prende per
3505 \param{optval} un intero usato come valore logico. Se abilitata
3506 passa tutti i pacchetti con l'opzione \textit{IP Router Alert} (vedi
3507 sez.~\ref{sec:IP_options}) che devono essere inoltrati al socket
3508 corrente. Può essere usata soltanto per socket di tipo raw.
3510 \item[\constd{IP\_TOS}] L'opzione consente di leggere o impostare il campo
3511 \textit{Type of Service} dell'intestazione IP (per una trattazione più
3512 dettagliata, che riporta anche i valori possibili e le relative costanti di
3513 definizione si veda sez.~\ref{sec:IP_header}) che permette di indicare le
3514 priorità dei pacchetti. Se impostato il valore verrà mantenuto per tutti i
3515 pacchetti del socket; alcuni valori (quelli che aumentano la priorità)
3516 richiedono i privilegi di amministrazione con la \textit{capability}
3517 \const{CAP\_NET\_ADMIN}.
3519 Il campo TOS è di 8 bit e l'opzione richiede per \param{optval} un intero
3520 che ne contenga il valore. Sono definite anche alcune costanti che
3521 definiscono alcuni valori standardizzati per il \textit{Type of Service},
3522 riportate in tab.~\ref{tab:IP_TOS_values}, il valore di default usato da
3523 Linux è \const{IPTOS\_LOWDELAY}, ma esso può essere modificato con le
3524 funzionalità del cosiddetto \textit{Advanced Routing}. Si ricordi che la
3525 priorità dei pacchetti può essere impostata anche in maniera indipendente
3526 dal protocollo utilizzando l'opzione \const{SO\_PRIORITY} illustrata in
3527 sez.~\ref{sec:sock_generic_options}.
3529 \item[\constd{IP\_TTL}] L'opzione consente di leggere o impostare per tutti i
3530 pacchetti associati al socket il campo \textit{Time to Live}
3531 dell'intestazione IP che indica il numero massimo di \textit{hop} (passaggi
3532 da un router ad un altro) restanti al paccheto (per una trattazione più
3533 estesa si veda sez.~\ref{sec:IP_header}). Il campo TTL è di 8 bit e
3534 l'opzione richiede che \param{optval} sia un intero, che ne conterrà il
3540 \subsection{Le opzioni per i protocolli TCP e UDP}
3541 \label{sec:sock_tcp_udp_options}
3543 In questa sezione tratteremo le varie opzioni disponibili per i socket che
3544 usano i due principali protocolli di comunicazione del livello di trasporto;
3545 UDP e TCP.\footnote{come per le precedenti, una descrizione di queste opzioni
3546 è disponibile nella settima sezione delle pagine di manuale, che si può
3547 consultare rispettivamente con \texttt{man 7 tcp} e \texttt{man 7 udp}; le
3548 pagine di manuale però, alla stesura di questa sezione (Agosto 2006) sono
3549 alquanto incomplete.} Dato che questi due protocolli sono entrambi
3550 trasportati su IP,\footnote{qui si sottintende IPv4, ma le opzioni per TCP e
3551 UDP sono le stesse anche quando si usa IPv6.} oltre alle opzioni generiche
3552 di sez.~\ref{sec:sock_generic_options} saranno comunque disponibili anche le
3553 precedenti opzioni di sez.~\ref{sec:sock_ipv4_options}.\footnote{in realtà in
3554 sez.~\ref{sec:sock_ipv4_options} si sono riportate le opzioni per IPv4, al
3555 solito, qualora si stesse utilizzando IPv6, si potrebbero utilizzare le
3556 opzioni di quest'ultimo.}
3558 Il protocollo che supporta il maggior numero di opzioni è TCP; per poterle
3559 utilizzare occorre specificare \const{SOL\_TCP} (o l'equivalente
3560 \constd{IPPROTO\_TCP}) come valore per l'argomento \param{level}. Si sono
3561 riportate le varie opzioni disponibili in tab.~\ref{tab:sock_opt_tcplevel},
3562 dove sono elencate le rispettive costanti da utilizzare come valore per
3563 l'argomento \param{optname}. Dette costanti e tutte le altre costanti e
3564 strutture collegate all'uso delle opzioni TCP sono definite in
3565 \headfiled{netinet/tcp.h}, ed accessibili includendo detto file.\footnote{in
3566 realtà questo è il file usato dalle librerie; la definizione delle opzioni
3567 effettivamente supportate da Linux si trova nel file
3568 \texttt{include/linux/tcp.h} dei sorgenti del kernel, dal quale si sono
3569 estratte le costanti di tab.~\ref{tab:sock_opt_tcplevel}.}
3574 \begin{tabular}[c]{|l|c|c|c|l|l|}
3576 \textbf{Opzione}&\texttt{get}&\texttt{set}&\textbf{flag}&\textbf{Tipo}&
3577 \textbf{Descrizione}\\
3580 \const{TCP\_NODELAY} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3581 Spedisce immediatamente i dati in segmenti singoli.\\
3582 \const{TCP\_MAXSEG} &$\bullet$&$\bullet$& &\texttt{int}&
3583 Valore della MSS per i segmenti in uscita.\\
3584 \const{TCP\_CORK} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3585 Accumula i dati in un unico segmento.\\
3586 \const{TCP\_KEEPIDLE} &$\bullet$&$\bullet$& &\texttt{int}&
3587 Tempo in secondi prima di inviare un \textit{keepalive}.\\
3588 \const{TCP\_KEEPINTVL} &$\bullet$&$\bullet$& &\texttt{int}&
3589 Tempo in secondi prima fra \textit{keepalive} successivi.\\
3590 \const{TCP\_KEEPCNT} &$\bullet$&$\bullet$& &\texttt{int}&
3591 Numero massimo di \textit{keepalive} inviati.\\
3592 \const{TCP\_SYNCNT} &$\bullet$&$\bullet$& &\texttt{int}&
3593 Numero massimo di ritrasmissioni di un SYN.\\
3594 \const{TCP\_LINGER2} &$\bullet$&$\bullet$& &\texttt{int}&
3595 Tempo di vita in stato \texttt{FIN\_WAIT2}.\\
3596 \const{TCP\_DEFER\_ACCEPT}&$\bullet$&$\bullet$& &\texttt{int}&
3597 Ritorna da \func{accept} solo in presenza di dati.\\
3598 \const{TCP\_WINDOW\_CLAMP}&$\bullet$&$\bullet$& &\texttt{int}&
3599 Valore della \textit{advertised window}.\\
3600 \const{TCP\_INFO} &$\bullet$& & &\struct{tcp\_info}&
3601 Restituisce informazioni sul socket.\\
3602 \const{TCP\_QUICKACK} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}&
3603 Abilita la modalità \textit{quickack}.\\
3604 \const{TCP\_CONGESTION} &$\bullet$&$\bullet$& &\texttt{char *}&
3605 Imposta l'algoritmo per il controllo della congestione.\\
3608 \caption{Le opzioni per i socket TCP disponibili al livello
3610 \label{tab:sock_opt_tcplevel}
3613 Le descrizioni delle varie opzioni riportate in
3614 tab.~\ref{tab:sock_opt_tcplevel} sono estremamente sintetiche ed indicative,
3615 la spiegazione del funzionamento delle singole opzioni con una maggiore
3616 quantità di dettagli è fornita nel seguente elenco:
3617 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
3619 \item[\constd{TCP\_NODELAY}] il protocollo TCP utilizza un meccanismo di
3620 bufferizzazione dei dati uscenti, per evitare la trasmissione di tanti
3621 piccoli segmenti con un utilizzo non ottimale della banda
3622 disponibile.\footnote{il problema è chiamato anche
3623 \itindex{silly~window~syndrome} \textit{silly window syndrome}, per averne
3624 un'idea si pensi al risultato che si ottiene quando un programma di
3625 terminale invia un segmento TCP per ogni tasto premuto, 40 byte di
3626 intestazione di protocollo con 1 byte di dati trasmessi; per evitare
3627 situazioni del genere è stato introdotto \index{algoritmo~di~Nagle}
3628 l'\textsl{algoritmo di Nagle}.} Questo meccanismo è controllato da un
3629 apposito algoritmo (detto \textsl{algoritmo di Nagle}, vedi
3630 sez.~\ref{sec:tcp_protocol_xxx}). Il comportamento normale del protocollo
3631 prevede che i dati siano accumulati fintanto che non si raggiunge una
3632 quantità considerata adeguata per eseguire la trasmissione di un singolo
3635 Ci sono però delle situazioni in cui questo comportamento può non essere
3636 desiderabile, ad esempio quando si sa in anticipo che l'applicazione invierà
3637 soltanto un piccolo quantitativo di dati;\footnote{è il caso classico di una
3638 richiesta HTTP.} in tal caso l'attesa introdotta dall'algoritmo di
3639 bufferizzazione non soltanto è inutile, ma peggiora le prestazioni
3640 introducendo un ritardo. Impostando questa opzione si disabilita l'uso
3641 dell'\textsl{algoritmo di Nagle} ed i dati vengono inviati immediatamente in
3642 singoli segmenti, qualunque sia la loro dimensione. Ovviamente l'uso di
3643 questa opzione è dedicato a chi ha esigenze particolari come quella
3644 illustrata, che possono essere stabilite solo per la singola applicazione.
3646 Si tenga conto che questa opzione viene sovrascritta dall'eventuale
3647 impostazione dell'opzione \const{TCP\_CORK} (il cui scopo è sostanzialmente
3648 l'opposto) che blocca l'invio immediato. Tuttavia quando la si abilita viene
3649 sempre forzato lo scaricamento della coda di invio (con conseguente
3650 trasmissione di tutti i dati pendenti), anche qualora si fosse già abilitata
3651 \const{TCP\_CORK}.\footnote{si tenga presente però che \const{TCP\_CORK} può
3652 essere specificata insieme a \const{TCP\_NODELAY} soltanto a partire dal
3655 \item[\constd{TCP\_MAXSEG}] con questa opzione si legge o si imposta il valore
3656 della MSS (\textit{Maximum Segment Size}, vedi sez.~\ref{sec:net_lim_dim} e
3657 sez.~\ref{sec:tcp_protocol_xxx}) dei segmenti TCP uscenti. Se l'opzione è
3658 impostata prima di stabilire la connessione, si cambia anche il valore della
3659 MSS annunciata all'altro capo della connessione. Se si specificano valori
3660 maggiori della MTU questi verranno ignorati, inoltre TCP imporrà anche i
3661 suoi limiti massimo e minimo per questo valore.
3663 \item[\constd{TCP\_CORK}] questa opzione è il complemento naturale di
3664 \const{TCP\_NODELAY} e serve a gestire a livello applicativo la situazione
3665 opposta, cioè quella in cui si sa fin dal principio che si dovranno inviare
3666 grosse quantità di dati. Anche in questo caso l'\textsl{algoritmo di Nagle}
3667 tenderà a suddividerli in dimensioni da lui ritenute
3668 opportune,\footnote{l'algoritmo cerca di tenere conto di queste situazioni,
3669 ma essendo un algoritmo generico tenderà comunque ad introdurre delle
3670 suddivisioni in segmenti diversi, anche quando potrebbero non essere
3671 necessarie, con conseguente spreco di banda.} ma sapendo fin dall'inizio
3672 quale è la dimensione dei dati si potranno di nuovo ottenere delle migliori
3673 prestazioni disabilitandolo, e gestendo direttamente l'invio del nostro
3674 blocco di dati in soluzione unica.
3676 Quando questa opzione viene abilitata non vengono inviati segmenti di dati
3677 fintanto che essa non venga disabilitata; a quel punto tutti i dati rimasti
3678 in coda saranno inviati in un solo segmento TCP. In sostanza con questa
3679 opzione si può controllare il flusso dei dati mettendo una sorta di
3680 ``\textsl{tappo}'' (da cui il nome in inglese) al flusso di uscita, in modo
3681 ottimizzare a mano l'uso della banda. Si tenga presente che per l'effettivo
3682 funzionamento ci si deve ricordare di disattivare l'opzione al termine
3683 dell'invio del blocco dei dati.
3685 Si usa molto spesso \const{TCP\_CORK} quando si effettua il trasferimento
3686 diretto di un blocco di dati da un file ad un socket con \func{sendfile}
3687 (vedi sez.~\ref{sec:file_sendfile_splice}), per inserire una intestazione
3688 prima della chiamata a questa funzione; senza di essa l'intestazione
3689 potrebbe venire spedita in un segmento a parte, che a seconda delle
3690 condizioni potrebbe richiedere anche una risposta di ACK, portando ad una
3691 notevole penalizzazione delle prestazioni.
3693 Si tenga presente che l'implementazione corrente di \const{TCP\_CORK} non
3694 consente di bloccare l'invio dei dati per più di 200 millisecondi, passati i
3695 quali i dati accumulati in coda sanno inviati comunque. Questa opzione è
3696 tipica di Linux\footnote{l'opzione è stata introdotta con i kernel della
3697 serie 2.4.x.} e non è disponibile su tutti i kernel unix-like, pertanto
3698 deve essere evitata se si vuole scrivere codice portabile.
3700 \item[\constd{TCP\_KEEPIDLE}] con questa opzione si legge o si imposta
3701 l'intervallo di tempo, in secondi, che deve trascorrere senza traffico sul
3702 socket prima che vengano inviati, qualora si sia attivata su di esso
3703 l'opzione \const{SO\_KEEPALIVE}, i messaggi di \textit{keep-alive} (si veda
3704 la trattazione relativa al \textit{keep-alive} in
3705 sez.~\ref{sec:sock_options_main}). Anche questa opzione non è disponibile
3706 su tutti i kernel unix-like e deve essere evitata se si vuole scrivere
3709 \item[\constd{TCP\_KEEPINTVL}] con questa opzione si legge o si imposta
3710 l'intervallo di tempo, in secondi, fra due messaggi di \textit{keep-alive}
3711 successivi (si veda sempre quanto illustrato in
3712 sez.~\ref{sec:sock_options_main}). Come la precedente non è disponibile su
3713 tutti i kernel unix-like e deve essere evitata se si vuole scrivere codice
3716 \item[\constd{TCP\_KEEPCNT}] con questa opzione si legge o si imposta il numero
3717 totale di messaggi di \textit{keep-alive} da inviare prima di concludere che
3718 la connessione è caduta per assenza di risposte ad un messaggio di
3719 \textit{keep-alive} (di nuovo vedi sez.~\ref{sec:sock_options_main}). Come
3720 la precedente non è disponibile su tutti i kernel unix-like e deve essere
3721 evitata se si vuole scrivere codice portabile.
3723 \item[\constd{TCP\_SYNCNT}] con questa opzione si legge o si imposta il numero
3724 di tentativi di ritrasmissione dei segmenti SYN usati nel \textit{three way
3725 handshake} prima che il tentativo di connessione venga abortito (si
3726 ricordi quanto accennato in sez.~\ref{sec:TCP_func_connect}). Sovrascrive
3727 per il singolo socket il valore globale impostato con la \textit{sysctl}
3728 \texttt{tcp\_syn\_retries} (vedi sez.~\ref{sec:sock_ipv4_sysctl}). Non
3729 vengono accettati valori maggiori di 255; anche questa opzione non è
3730 standard e deve essere evitata se si vuole scrivere codice portabile.
3732 \item[\constd{TCP\_LINGER2}] con questa opzione si legge o si imposta, in
3733 numero di secondi, il tempo di sussistenza dei socket terminati nello stato
3734 \texttt{FIN\_WAIT2} (si ricordi quanto visto in
3735 sez.~\ref{sec:TCP_conn_term}).\footnote{si tenga ben presente che questa
3736 opzione non ha nulla a che fare con l'opzione \const{SO\_LINGER} che
3737 abbiamo visto in sez.~\ref{sec:sock_options_main}.} Questa opzione
3738 consente di sovrascrivere per il singolo socket il valore globale impostato
3739 con la \textit{sysctl} \texttt{tcp\_fin\_timeout} (vedi
3740 sez.~\ref{sec:sock_ipv4_sysctl}). Anche questa opzione è da evitare se si
3741 ha a cuore la portabilità del codice.
3743 \item[\constd{TCP\_DEFER\_ACCEPT}] questa opzione consente di modificare il
3744 comportamento standard del protocollo TCP nello stabilirsi di una
3745 connessione; se ricordiamo il meccanismo del \textit{three way handshake}
3746 illustrato in fig.~\ref{fig:TCP_TWH} possiamo vedere che in genere un client
3747 inizierà ad inviare i dati ad un server solo dopo l'emissione dell'ultimo
3750 Di nuovo esistono situazioni (e la più tipica è quella di una richiesta
3751 HTTP) in cui sarebbe utile inviare immediatamente la richiesta all'interno
3752 del segmento con l'ultimo ACK del \textit{three way handshake}; si potrebbe
3753 così risparmiare l'invio di un segmento successivo per la richiesta e il
3754 ritardo sul server fra la ricezione dell'ACK e quello della richiesta.
3756 Se si invoca \const{TCP\_DEFER\_ACCEPT} su un socket dal lato client (cioè
3757 dal lato da cui si invoca \func{connect}) si istruisce il kernel a non
3758 inviare immediatamente l'ACK finale del \textit{three way handshake},
3759 attendendo per un po' di tempo la prima scrittura, in modo da inviare i dati
3760 di questa insieme col segmento ACK. Chiaramente la correttezza di questo
3761 comportamento dipende in maniera diretta dal tipo di applicazione che usa il
3762 socket; con HTTP, che invia una breve richiesta, permette di risparmiare un
3763 segmento, con FTP, in cui invece si attende la ricezione del prompt del
3764 server, introduce un inutile ritardo.
3766 Allo stesso tempo il protocollo TCP prevede che sul lato del server la
3767 funzione \func{accept} ritorni dopo la ricezione dell'ACK finale, in tal
3768 caso quello che si fa usualmente è lanciare un nuovo processo per leggere i
3769 successivi dati, che si bloccherà su una \func{read} se questi non sono
3770 disponibili; in questo modo si saranno impiegate delle risorse (per la
3771 creazione del nuovo processo) che non vengono usate immediatamente. L'uso
3772 di \const{TCP\_DEFER\_ACCEPT} consente di intervenire anche in questa
3773 situazione; quando la si invoca sul lato server (vale a dire su un socket in
3774 ascolto) l'opzione fa sì che \func{accept} ritorni soltanto quando sono
3775 presenti dei dati sul socket, e non alla ricezione dell'ACK conclusivo del
3776 \textit{three way handshake}.
3778 L'opzione prende un valore intero che indica il numero massimo di secondi
3779 per cui mantenere il ritardo, sia per quanto riguarda il ritorno di
3780 \func{accept} su un server, che per l'invio dell'ACK finale insieme ai dati
3781 su un client. L'opzione è specifica di Linux non deve essere utilizzata in
3782 codice che vuole essere portabile.\footnote{su FreeBSD è presente una
3783 opzione \texttt{SO\_ACCEPTFILTER} che consente di ottenere lo stesso
3784 comportamento di \const{TCP\_DEFER\_ACCEPT} per quanto riguarda il lato
3787 \item[\constd{TCP\_WINDOW\_CLAMP}] con questa opzione si legge o si imposta
3788 alla dimensione specificata, in byte, il valore dichiarato della
3789 \textit{advertised window} (vedi sez.~\ref{sec:tcp_protocol_xxx}). Il kernel
3790 impone comunque una dimensione minima pari a \texttt{SOCK\_MIN\_RCVBUF/2}.
3791 Questa opzione non deve essere utilizzata in codice che vuole essere
3794 \begin{figure}[!htb]
3795 \footnotesize \centering
3796 \begin{minipage}[c]{0.80\textwidth}
3797 \includestruct{listati/tcp_info.h}
3799 \caption{La struttura \structd{tcp\_info} contenente le informazioni sul
3800 socket restituita dall'opzione \const{TCP\_INFO}.}
3801 \label{fig:tcp_info_struct}
3804 \item[\constd{TCP\_INFO}] questa opzione, specifica di Linux, ma introdotta
3805 anche in altri kernel (ad esempio FreeBSD) permette di controllare lo stato
3806 interno di un socket TCP direttamente da un programma in user space.
3807 L'opzione restituisce in una speciale struttura \struct{tcp\_info}, la cui
3808 definizione è riportata in fig.~\ref{fig:tcp_info_struct}, tutta una serie
3809 di dati che il kernel mantiene, relativi al socket. Anche questa opzione
3810 deve essere evitata se si vuole scrivere codice portabile.
3812 Con questa opzione diventa possibile ricevere una serie di informazioni
3813 relative ad un socket TCP così da poter effettuare dei controlli senza dover
3814 passare attraverso delle operazioni di lettura. Ad esempio si può verificare
3815 se un socket è stato chiuso usando una funzione analoga a quella illustrata
3816 in fig.~\ref{fig:is_closing}, in cui si utilizza il valore del campo
3817 \var{tcpi\_state} di \struct{tcp\_info} per controllare lo stato del socket.
3819 \begin{figure}[!htbp]
3820 \footnotesize \centering
3821 \begin{minipage}[c]{\codesamplewidth}
3822 \includecodesample{listati/is_closing.c}
3824 \caption{Codice della funzione \texttt{is\_closing.c}, che controlla lo stato
3825 di un socket TCP per verificare se si sta chiudendo.}
3826 \label{fig:is_closing}
3829 %Si noti come nell'esempio si sia (
3832 \item[\constd{TCP\_QUICKACK}] con questa opzione è possibile eseguire una forma
3833 di controllo sull'invio dei segmenti ACK all'interno di in flusso di dati su
3834 TCP. In genere questo invio viene gestito direttamente dal kernel, il
3835 comportamento standard, corrispondente la valore logico di vero (in genere
3836 1) per questa opzione, è quello di inviare immediatamente i segmenti ACK, in
3837 quanto normalmente questo significa che si è ricevuto un blocco di dati e si
3838 può passare all'elaborazione del blocco successivo.
3840 Qualora però la nostra applicazione sappia in anticipo che alla ricezione di
3841 un blocco di dati seguirà immediatamente l'invio di un altro
3842 blocco,\footnote{caso tipico ad esempio delle risposte alle richieste HTTP.}
3843 poter accorpare quest'ultimo al segmento ACK permette di risparmiare sia in
3844 termini di dati inviati che di velocità di risposta. Per far questo si può
3845 utilizzare \const{TCP\_QUICKACK} impostando un valore logico falso (cioè 0),
3846 in questo modo il kernel attenderà così da inviare il prossimo segmento di
3847 ACK insieme ai primi dati disponibili.
3849 Si tenga presente che l'opzione non è permanente, vale a dire che una volta
3850 che la si sia impostata a 0 il kernel la riporterà al valore di default dopo
3851 il suo primo utilizzo. Sul lato server la si può impostare anche una volta
3852 sola su un socket in ascolto, ed essa verrà ereditata da tutti i socket che
3853 si otterranno da esso al ritorno di \func{accept}.
3855 % TODO trattare con gli esempi di apache
3857 \item[\constd{TCP\_CONGESTION}] questa opzione permette di impostare quale
3858 algoritmo per il controllo della congestione\footnote{il controllo della
3859 congestione è un meccanismo previsto dal protocollo TCP (vedi
3860 sez.~\ref{sec:tcp_protocol_xxx}) per evitare di trasmettere inutilmente
3861 dati quando una connessione è congestionata; un buon algoritmo è
3862 fondamentale per il funzionamento del protocollo, dato che i pacchetti
3863 persi andrebbero ritrasmessi, per cui inviare un pacchetto su una linea
3864 congestionata potrebbe causare facilmente un peggioramento della
3865 situazione.} utilizzare per il singolo socket. L'opzione è stata
3866 introdotta con il kernel 2.6.13,\footnote{alla data di stesura di queste
3867 note (Set. 2006) è pure scarsamente documentata, tanto che non è neanche
3868 definita nelle intestazioni delle \acr{glibc} per cui occorre definirla a
3869 mano al suo valore che è 13.} e prende come per \param{optval} il
3870 puntatore ad un buffer contenente il nome dell'algoritmo di controllo che
3873 L'uso di un nome anziché di un valore numerico è dovuto al fatto che gli
3874 algoritmi di controllo della congestione sono realizzati attraverso
3875 altrettanti moduli del kernel, e possono pertanto essere attivati a
3876 richiesta; il nome consente di caricare il rispettivo modulo e di introdurre
3877 moduli aggiuntivi che implementino altri meccanismi.
3879 Per poter disporre di questa funzionalità occorre aver compilato il kernel
3880 attivando l'opzione di configurazione generale
3881 \texttt{TCP\_CONG\_ADVANCED},\footnote{disponibile come \textit{TCP:
3882 advanced congestion control} nel menù \textit{Network->Networking
3883 options}, che a sua volta renderà disponibile un ulteriore menù con gli
3884 algoritmi presenti.} e poi abilitare i singoli moduli voluti con le varie
3885 \texttt{TCP\_CONG\_*} presenti per i vari algoritmi disponibili; un elenco
3886 di quelli attualmente supportati nella versione ufficiale del kernel è
3887 riportato in tab.~\ref{tab:sock_tcp_congestion_algo}.\footnote{la lista è
3888 presa dalla versione 2.6.17.}
3891 Si tenga presente che prima della implementazione modulare alcuni di questi
3892 algoritmi erano disponibili soltanto come caratteristiche generali del
3893 sistema, attivabili per tutti i socket, questo è ancora possibile con la
3894 \textit{sysctl} \texttt{tcp\_congestion\_control} (vedi
3895 sez.~\ref{sec:sock_ipv4_sysctl}) che ha sostituito le precedenti
3896 \textit{sysctl}.\footnote{riportate anche, alla data di stesura di queste
3897 pagine (Set. 2006) nelle pagine di manuale, ma non più presenti.}
3902 \begin{tabular}[c]{|l|l|l|}
3904 \textbf{Nome}&\textbf{Configurazione}&\textbf{Riferimento} \\
3907 reno& -- &Algoritmo tradizionale, usato in caso di assenza degli altri.\\
3908 \texttt{bic} &\texttt{TCP\_CONG\_BIC} &
3909 \url{http://www.csc.ncsu.edu/faculty/rhee/export/bitcp/index.htm}.\\
3910 \texttt{cubic} &\texttt{TCP\_CONG\_CUBIC} &
3911 \url{http://www.csc.ncsu.edu/faculty/rhee/export/bitcp/index.htm}.\\
3912 \texttt{highspeed}&\texttt{TCP\_CONG\_HSTCP} &
3913 \url{http://www.icir.org/floyd/hstcp.html}.\\
3914 \texttt{htcp} &\texttt{TCP\_CONG\_HTCP} &
3915 \url{http://www.hamilton.ie/net/htcp/}.\\
3916 \texttt{hybla} &\texttt{TCP\_CONG\_HYBLA} &
3917 \url{http://www.danielinux.net/projects.html}.\\
3918 \texttt{scalable}&\texttt{TCP\_CONG\_SCALABLE}&
3919 \url{http://www.deneholme.net/tom/scalable/}.\\
3920 \texttt{vegas} &\texttt{TCP\_CONG\_VEGAS} &
3921 \url{http://www.cs.arizona.edu/protocols/}.\\
3922 \texttt{westwood}&\texttt{TCP\_CONG\_WESTWOOD}&
3923 \url{http://www.cs.ucla.edu/NRL/hpi/tcpw/}.\\
3924 % \texttt{}&\texttt{}& .\\
3927 \caption{Gli algoritmi per il controllo della congestione disponibili con
3928 Linux con le relative opzioni di configurazione da attivare.}
3929 \label{tab:sock_tcp_congestion_algo}
3935 Il protocollo UDP, anche per la sua maggiore semplicità, supporta un numero
3936 ridotto di opzioni, riportate in tab.~\ref{tab:sock_opt_udplevel}; anche in
3937 questo caso per poterle utilizzare occorrerà impostare l'opportuno valore per
3938 l'argomento \param{level}, che è \const{SOL\_UDP} (o l'equivalente
3939 \constd{IPPROTO\_UDP}). Le costanti che identificano dette opzioni sono
3940 definite in \headfiled{netinet/udp.h}, ed accessibili includendo detto
3941 file.\footnote{come per TCP, la definizione delle opzioni effettivamente
3942 supportate dal kernel si trova in realtà nel file
3943 \texttt{include/linux/udp.h}, dal quale si sono estratte le costanti di
3944 tab.~\ref{tab:sock_opt_udplevel}.}
3949 \begin{tabular}[c]{|l|c|c|c|l|l|}
3951 \textbf{Opzione}&\texttt{get}&\texttt{set}&\textbf{flag}&\textbf{Tipo}&
3952 \textbf{Descrizione}\\
3955 \constd{UDP\_CORK} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}& %???
3956 Accumula tutti i dati su un unico pacchetto.\\
3957 \constd{UDP\_ENCAP} &$\bullet$&$\bullet$&$\bullet$&\texttt{int}& %???
3961 \caption{Le opzioni per i socket UDP disponibili al livello
3963 \label{tab:sock_opt_udplevel}
3966 % TODO documentare \const{UDP\_ENCAP}
3968 Ancora una volta le descrizioni contenute tab.~\ref{tab:sock_opt_udplevel}
3969 sono un semplice riferimento, una maggiore quantità di dettagli sulle
3970 caratteristiche delle opzioni citate è quello dell'elenco seguente:
3971 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
3973 \item[\constd{UDP\_CORK}] questa opzione ha l'identico effetto dell'analoga
3974 \const{TCP\_CORK} vista in precedenza per il protocollo TCP, e quando
3975 abilitata consente di accumulare i dati in uscita su un solo pacchetto che
3976 verrà inviato una volta che la si disabiliti. L'opzione è stata introdotta
3977 con il kernel 2.5.44, e non deve essere utilizzata in codice che vuole
3980 \item[\constd{UDP\_ENCAP}] Questa opzione permette di gestire l'incapsulazione
3981 dei dati nel protocollo UDP. L'opzione è stata introdotta con il kernel
3982 2.5.67, e non è documentata. Come la precedente è specifica di Linux e non
3983 deve essere utilizzata in codice portabile.
3990 \section{La gestione attraverso le funzioni di controllo}
3991 \label{sec:sock_ctrl_func}
3993 Benché la maggior parte delle caratteristiche dei socket sia gestibile con le
3994 funzioni \func{setsockopt} e \func{getsockopt}, alcune proprietà possono
3995 essere impostate attraverso le funzioni \func{fcntl} e \func{ioctl} già
3996 trattate in sez.~\ref{sec:file_fcntl_ioctl}; in quell'occasione abbiamo
3997 parlato di queste funzioni esclusivamente nell'ambito della loro applicazione
3998 a file descriptor associati a dei file normali; qui tratteremo invece i
3999 dettagli del loro utilizzo con file descriptor associati a dei socket.
4002 \subsection{L'uso di \func{ioctl} e \func{fcntl} per i socket generici}
4003 \label{sec:sock_ioctl}
4005 Tratteremo in questa sezione le caratteristiche specifiche delle funzioni
4006 \func{ioctl} e \func{fcntl} quando esse vengono utilizzate con dei socket
4007 generici. Quanto già detto in precedenza sez.~\ref{sec:file_fcntl_ioctl}
4008 continua a valere; quello che tratteremo qui sono le operazioni ed i comandi
4009 che sono validi, o che hanno significati peculiari, quando queste funzioni
4010 vengono applicate a dei socket generici.
4012 Nell'elenco seguente si riportano i valori specifici che può assumere il
4013 secondo argomento della funzione \func{ioctl} (\param{request}, che indica il
4014 tipo di operazione da effettuare) quando essa viene applicata ad un socket
4015 generico. Nell'elenco si illustrerà anche, per ciascuna operazione, il tipo di
4016 dato usato come terzo argomento della funzione ed il significato che esso
4017 viene ad assumere. Dato che in caso di lettura questi dati vengono restituiti
4018 come \textit{value result argument}, con queste operazioni il terzo argomento
4019 deve sempre essere passato come puntatore ad una variabile (o struttura)
4020 precedentemente allocata. Le costanti che identificano le operazioni sono le
4022 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
4023 \item[\constd{SIOCGSTAMP}] restituisce il contenuto di una struttura
4024 \struct{timeval} con la marca temporale dell'ultimo pacchetto ricevuto sul
4025 socket, questa operazione può essere utilizzata per effettuare delle
4026 misurazioni precise del tempo di andata e ritorno\footnote{il \textit{Round
4027 Trip Time} cui abbiamo già accennato in sez.~\ref{sec:net_tcp}.} dei
4028 pacchetti sulla rete.
4030 \item[\constd{SIOCSPGRP}] imposta il processo o il \textit{process group} a
4031 cui inviare i segnali \signal{SIGIO} e \signal{SIGURG} quando viene
4032 completata una operazione di I/O asincrono o arrivano dei dati urgenti
4033 (\texttt{out-of-band}). Il terzo argomento deve essere un puntatore ad una
4034 variabile di tipo \type{pid\_t}; un valore positivo indica direttamente il
4035 \ids{PID} del processo, mentre un valore negativo indica (col valore
4036 assoluto) il \textit{process group}. Senza privilegi di amministratore o la
4037 \textit{capability} \const{CAP\_KILL} si può impostare solo se stessi o il
4038 proprio \textit{process group}.
4040 \item[\constd{SIOCGPGRP}] legge le impostazioni presenti sul socket
4041 relativamente all'eventuale processo o \textit{process group} cui devono
4042 essere inviati i segnali \signal{SIGIO} e \signal{SIGURG}. Come per
4043 \const{SIOCSPGRP} l'argomento passato deve un puntatore ad una variabile di
4044 tipo \type{pid\_t}, con lo stesso significato. Qualora non sia presente
4045 nessuna impostazione verrà restituito un valore nullo.
4047 \item[\const{FIOASYNC}] Abilita o disabilita la modalità di I/O asincrono sul
4048 socket. Questo significa (vedi sez.~\ref{sec:signal_driven_io}) che verrà
4049 inviato il segnale di \signal{SIGIO} (o quanto impostato con
4050 \const{F\_SETSIG}, vedi sez.~\ref{sec:file_fcntl_ioctl}) in caso di eventi
4054 Nel caso dei socket generici anche \func{fcntl} prevede un paio di comandi
4055 specifici; in questo caso il secondo argomento (\param{cmd}, che indica il
4056 comando) può assumere i due valori \const{FIOGETOWN} e \const{FIOSETOWN},
4057 mentre il terzo argomento dovrà essere un puntatore ad una variabile di tipo
4058 \type{pid\_t}. Questi due comandi sono una modalità alternativa di eseguire le
4059 stesse operazioni (lettura o impostazione del processo o del gruppo di
4060 processo che riceve i segnali) che si effettuano chiamando \func{ioctl} con
4061 \const{SIOCGPGRP} e \const{SIOCSPGRP}.
4064 \subsection{L'uso di \func{ioctl} per l'accesso ai dispositivi di rete}
4065 \label{sec:sock_ioctl_netdevice}
4067 Benché non strettamente attinenti alla gestione dei socket, vale la pena di
4068 trattare qui l'interfaccia di accesso a basso livello ai dispositivi di rete
4069 che viene appunto fornita attraverso la funzione \texttt{ioctl}. Questa non è
4070 attinente a caratteristiche specifiche di un qualche protocollo, ma si applica
4071 a tutti i socket, indipendentemente da tipo e famiglia degli stessi, e
4072 permette di impostare e rilevare le funzionalità delle interfacce di rete.
4074 \begin{figure}[!htb]
4075 \footnotesize \centering
4076 \begin{minipage}[c]{0.80\textwidth}
4077 \includestruct{listati/ifreq.h}
4079 \caption{La struttura \structd{ifreq} utilizzata dalle \func{ioctl} per le
4080 operazioni di controllo sui dispositivi di rete.}
4081 \label{fig:netdevice_ifreq_struct}
4084 Tutte le operazioni di questo tipo utilizzano come terzo argomento di
4085 \func{ioctl} il puntatore ad una struttura \struct{ifreq}, la cui definizione
4086 è illustrata in fig.~\ref{fig:netdevice_ifreq_struct}. Normalmente si utilizza
4087 il primo campo della struttura, \var{ifr\_name} per specificare il nome
4088 dell'interfaccia su cui si vuole operare (ad esempio \texttt{eth0},
4089 \texttt{ppp0}, ecc.), e si inseriscono (o ricevono) i valori relativi alle
4090 diversa caratteristiche e funzionalità nel secondo campo, che come si può
4091 notare è definito come una \dirct{union} proprio in quanto il suo significato
4092 varia a secondo dell'operazione scelta.
4094 Si tenga inoltre presente che alcune di queste operazioni (in particolare
4095 quelle che modificano le caratteristiche dell'interfaccia) sono privilegiate e
4096 richiedono i privilegi di amministratore o la \textit{capability}
4097 \const{CAP\_NET\_ADMIN}, altrimenti si otterrà un errore di \errval{EPERM}.
4098 Le costanti che identificano le operazioni disponibili sono le seguenti:
4099 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
4100 \item[\constd{SIOCGIFNAME}] questa è l'unica operazione che usa il campo
4101 \var{ifr\_name} per restituire un risultato, tutte le altre lo utilizzano
4102 per indicare l'interfaccia sulla quale operare. L'operazione richiede che si
4103 indichi nel campo \var{ifr\_ifindex} il valore numerico dell'\textsl{indice}
4104 dell'interfaccia, e restituisce il relativo nome in \var{ifr\_name}.
4106 Il kernel infatti assegna ad ogni interfaccia un numero progressivo, detto
4107 appunto \itindex{interface~index} \textit{interface index}, che è quello che
4108 effettivamente la identifica nelle operazioni a basso livello, il nome
4109 dell'interfaccia è soltanto una etichetta associata a detto \textsl{indice},
4110 che permette di rendere più comprensibile l'indicazione dell'interfaccia
4111 all'interno dei comandi. Una modalità per ottenere questo valore è usare il
4112 comando \cmd{ip link}, che fornisce un elenco delle interfacce presenti
4113 ordinato in base a tale valore (riportato come primo campo).
4116 \item[\constd{SIOCGIFINDEX}] restituisce nel campo \var{ifr\_ifindex} il valore
4117 numerico dell'indice dell'interfaccia specificata con \var{ifr\_name}, è in
4118 sostanza l'operazione inversa di \const{SIOCGIFNAME}.
4120 \item[\constd{SIOCGIFFLAGS}] permette di ottenere nel campo \var{ifr\_flags} il
4121 valore corrente dei flag dell'interfaccia specificata (con \var{ifr\_name}).
4122 Il valore restituito è una maschera binaria i cui bit sono identificabili
4123 attraverso le varie costanti di tab.~\ref{tab:netdevice_iface_flag}.
4128 \begin{tabular}[c]{|l|p{8cm}|}
4130 \textbf{Flag} & \textbf{Significato} \\
4133 \constd{IFF\_UP} & L'interfaccia è attiva.\\
4134 \constd{IFF\_BROADCAST} & L'interfaccia ha impostato un indirizzo di
4135 \textit{broadcast} valido.\\
4136 \constd{IFF\_DEBUG} & È attivo il flag interno di debug.\\
4137 \constd{IFF\_LOOPBACK} & L'interfaccia è una interfaccia di
4138 \textit{loopback}.\\
4139 \constd{IFF\_POINTOPOINT}&L'interfaccia è associata ad un collegamento
4140 \textsl{punto-punto}.\\
4141 \constd{IFF\_RUNNING} & L'interfaccia ha delle risorse allocate (non può
4142 quindi essere disattivata).\\
4143 \constd{IFF\_NOARP} & L'interfaccia ha il protocollo ARP disabilitato o
4144 l'indirizzo del livello di rete non è impostato.\\
4145 \constd{IFF\_PROMISC} & L'interfaccia è nel cosiddetto
4146 \index{modo~promiscuo} \textsl{modo promiscuo},
4147 riceve cioè tutti i pacchetti che vede passare,
4148 compresi quelli non direttamente indirizzati a
4150 \constd{IFF\_NOTRAILERS}& Evita l'uso di \textit{trailer} nei pacchetti.\\
4151 \constd{IFF\_ALLMULTI} & Riceve tutti i pacchetti di \textit{multicast}.\\
4152 \constd{IFF\_MASTER} & L'interfaccia è il master di un bundle per il
4153 bilanciamento di carico.\\
4154 \constd{IFF\_SLAVE} & L'interfaccia è uno slave di un bundle per il
4155 bilanciamento di carico.\\
4156 \constd{IFF\_MULTICAST} & L'interfaccia ha il supporto per il
4157 \textit{multicast} attivo.\\
4158 \constd{IFF\_PORTSEL} & L'interfaccia può impostare i suoi parametri
4159 hardware (con l'uso di \struct{ifmap}).\\
4160 \constd{IFF\_AUTOMEDIA} & L'interfaccia è in grado di selezionare
4161 automaticamente il tipo di collegamento.\\
4162 \constd{IFF\_DYNAMIC} & Gli indirizzi assegnati all'interfaccia vengono
4163 persi quando questa viene disattivata.\\
4164 % \const{IFF\_} & .\\
4167 \caption{Le costanti che identificano i vari bit della maschera binaria
4168 \var{ifr\_flags} che esprime i flag di una interfaccia di rete.}
4169 \label{tab:netdevice_iface_flag}
4173 \item[\constd{SIOCSIFFLAGS}] permette di impostare il valore dei flag
4174 dell'interfaccia specificata (sempre con \var{ifr\_name}, non staremo a
4175 ripeterlo oltre) attraverso il valore della maschera binaria da passare nel
4176 campo \var{ifr\_flags}, che può essere ottenuta con l'OR aritmetico delle
4177 costanti di tab.~\ref{tab:netdevice_iface_flag}; questa operazione è
4180 \item[\constd{SIOCGIFMETRIC}] permette di leggere il valore della metrica del
4181 dispositivo associato all'interfaccia specificata nel campo
4182 \var{ifr\_metric}. Attualmente non è implementato, e l'operazione
4183 restituisce sempre un valore nullo.
4185 \item[\constd{SIOCSIFMETRIC}] permette di impostare il valore della metrica del
4186 dispositivo al valore specificato nel campo \var{ifr\_metric}, attualmente
4187 non ancora implementato, restituisce un errore di \errval{EOPNOTSUPP}.
4189 \item[\constd{SIOCGIFMTU}] permette di leggere il valore della \textit{Maximum
4190 Transfer Unit} del dispositivo nel campo \var{ifr\_mtu}.
4192 \item[\constd{SIOCSIFMTU}] permette di impostare il valore della
4193 \textit{Maximum Transfer Unit} del dispositivo al valore specificato campo
4194 \var{ifr\_mtu}. L'operazione è privilegiata, e si tenga presente che
4195 impostare un valore troppo basso può causare un blocco del kernel.
4197 \item[\constd{SIOCGIFHWADDR}] permette di leggere il valore dell'indirizzo
4198 hardware del dispositivo associato all'interfaccia nel campo
4199 \var{ifr\_hwaddr}; questo viene restituito come struttura \struct{sockaddr}
4200 in cui il campo \var{sa\_family} contiene un valore \texttt{ARPHRD\_*}
4201 indicante il tipo di indirizzo ed il campo \var{sa\_data} il valore binario
4202 dell'indirizzo hardware a partire dal byte 0.
4204 \item[\constd{SIOCSIFHWADDR}] permette di impostare il valore dell'indirizzo
4205 hardware del dispositivo associato all'interfaccia attraverso il valore
4206 della struttura \struct{sockaddr} (con lo stesso formato illustrato per
4207 \const{SIOCGIFHWADDR}) passata nel campo \var{ifr\_hwaddr}. L'operazione è
4210 \item[\constd{SIOCSIFHWBROADCAST}] imposta l'indirizzo \textit{broadcast}
4211 hardware dell'interfaccia al valore specificato dal campo
4212 \var{ifr\_hwaddr}. L'operazione è privilegiata.
4214 \item[\constd{SIOCGIFMAP}] legge alcuni parametri hardware (memoria, interrupt,
4215 canali di DMA) del driver dell'interfaccia specificata, restituendo i
4216 relativi valori nel campo \var{ifr\_map}; quest'ultimo contiene una
4217 struttura di tipo \struct{ifmap}, la cui definizione è illustrata in
4218 fig.~\ref{fig:netdevice_ifmap_struct}.
4220 \begin{figure}[!htb]
4221 \footnotesize \centering
4222 \begin{minipage}[c]{0.80\textwidth}
4223 \includestruct{listati/ifmap.h}
4225 \caption{La struttura \structd{ifmap} utilizzata per leggere ed impostare i
4226 valori dei parametri hardware di un driver di una interfaccia.}
4227 \label{fig:netdevice_ifmap_struct}
4230 \item[\constd{SIOCSIFMAP}] imposta i parametri hardware del driver
4231 dell'interfaccia specificata, restituendo i relativi valori nel campo
4232 \var{ifr\_map}. Come per \const{SIOCGIFMAP} questo deve essere passato come
4233 struttura \struct{ifmap}, secondo la definizione di
4234 fig.~\ref{fig:netdevice_ifmap_struct}.
4236 \item[\constd{SIOCADDMULTI}] aggiunge un indirizzo di \textit{multicast} ai
4237 filtri del livello di collegamento associati dell'interfaccia. Si deve usare
4238 un indirizzo hardware da specificare attraverso il campo \var{ifr\_hwaddr},
4239 che conterrà l'opportuna struttura \struct{sockaddr}; l'operazione è
4240 privilegiata. Per una modalità alternativa per eseguire la stessa operazione
4241 si possono usare i \textit{packet socket}, vedi
4242 sez.~\ref{sec:packet_socket}.
4244 \item[\constd{SIOCDELMULTI}] rimuove un indirizzo di \textit{multicast} ai
4245 filtri del livello di collegamento dell'interfaccia, vuole un indirizzo
4246 hardware specificato come per \const{SIOCADDMULTI}. Anche questa operazione
4247 è privilegiata e può essere eseguita in forma alternativa con i
4248 \textit{packet socket}.
4250 \item[\constd{SIOCGIFTXQLEN}] permette di leggere la lunghezza della coda di
4251 trasmissione del dispositivo associato all'interfaccia specificata nel campo
4254 \item[\constd{SIOCSIFTXQLEN}] permette di impostare il valore della lunghezza
4255 della coda di trasmissione del dispositivo associato all'interfaccia, questo
4256 deve essere specificato nel campo \var{ifr\_qlen}. L'operazione è
4259 \item[\constd{SIOCSIFNAME}] consente di cambiare il nome dell'interfaccia
4260 indicata da \var{ifr\_name} utilizzando il nuovo nome specificato nel campo
4266 % TODO aggiunta con il kernel 3.14 SIOCGHWTSTAMP per ottenere il timestamp
4267 % hardware senza modificarlo
4269 Una ulteriore operazione, che consente di ricavare le caratteristiche delle
4270 interfacce di rete, è \constd{SIOCGIFCONF}; però per ragioni di compatibilità
4271 questa operazione è disponibile soltanto per i socket della famiglia
4272 \const{AF\_INET} (vale ad dire per socket IPv4). In questo caso l'utente dovrà
4273 passare come argomento una struttura \struct{ifconf}, definita in
4274 fig.~\ref{fig:netdevice_ifconf_struct}.
4276 \begin{figure}[!htb]
4277 \footnotesize \centering
4278 \begin{minipage}[c]{0.80\textwidth}
4279 \includestruct{listati/ifconf.h}
4281 \caption{La struttura \structd{ifconf}.}
4282 \label{fig:netdevice_ifconf_struct}
4285 Per eseguire questa operazione occorrerà allocare preventivamente un buffer di
4286 contenente un vettore di strutture \struct{ifreq}. La dimensione (in byte) di
4287 questo buffer deve essere specificata nel campo \var{ifc\_len} di
4288 \struct{ifconf}, mentre il suo indirizzo andrà specificato nel campo
4289 \var{ifc\_req}. Qualora il buffer sia stato allocato come una stringa, il suo
4290 indirizzo potrà essere fornito usando il campo \var{ifc\_buf}.\footnote{si
4291 noti che l'indirizzo del buffer è definito in \struct{ifconf} con una
4292 \dirct{union}, questo consente di utilizzare una delle due forme a piacere.}
4294 La funzione restituisce nel buffer indicato una serie di strutture
4295 \struct{ifreq} contenenti nel campo \var{ifr\_name} il nome dell'interfaccia e
4296 nel campo \var{ifr\_addr} il relativo indirizzo IP. Se lo spazio allocato nel
4297 buffer è sufficiente il kernel scriverà una struttura \struct{ifreq} per
4298 ciascuna interfaccia attiva, restituendo nel campo \var{ifc\_len} il totale
4299 dei byte effettivamente scritti. Il valore di ritorno è 0 se l'operazione ha
4300 avuto successo e negativo in caso contrario.
4302 Si tenga presente che il kernel non scriverà mai sul buffer di uscita dati
4303 eccedenti numero di byte specificato col valore di \var{ifc\_len} impostato
4304 alla chiamata della funzione, troncando il risultato se questi non dovessero
4305 essere sufficienti. Questa condizione non viene segnalata come errore per cui
4306 occorre controllare il valore di \var{ifc\_len} all'uscita della funzione, e
4307 verificare che esso sia inferiore a quello di ingresso. In caso contrario si è
4308 probabilmente\footnote{probabilmente perché si potrebbe essere nella
4309 condizione in cui sono stati usati esattamente quel numero di byte.} avuta
4310 una situazione di troncamento dei dati.
4312 \begin{figure}[!htbp]
4313 \footnotesize \centering
4314 \begin{minipage}[c]{\codesamplewidth}
4315 \includecodesample{listati/iflist.c}
4317 \caption{Il corpo principale del programma \texttt{iflist.c}.}
4318 \label{fig:netdevice_iflist}
4321 Come esempio dell'uso di queste funzioni si è riportato in
4322 fig.~\ref{fig:netdevice_iflist} il corpo principale del programma
4323 \texttt{iflist} in cui si utilizza l'operazione \const{SIOCGIFCONF} per
4324 ottenere una lista delle interfacce attive e dei relativi indirizzi. Al solito
4325 il codice completo è fornito nei sorgenti allegati alla guida.
4327 Il programma inizia (\texttt{\small 7--11}) con la creazione del socket
4328 necessario ad eseguire l'operazione, dopo di che si inizializzano
4329 opportunamente (\texttt{\small 13--14}) i valori della struttura
4330 \struct{ifconf} indicando la dimensione del buffer ed il suo
4331 indirizzo;\footnote{si noti come in questo caso si sia specificato l'indirizzo
4332 usando il campo \var{ifc\_buf}, mentre nel seguito del programma si accederà
4333 ai valori contenuti nel buffer usando \var{ifc\_req}.} si esegue poi
4334 l'operazione invocando \func{ioctl}, controllando come sempre la corretta
4335 esecuzione, ed uscendo in caso di errore (\texttt{\small 15--19}).
4337 Si esegue poi un controllo sulla quantità di dati restituiti segnalando un
4338 eventuale overflow del buffer (\texttt{\small 21--23}); se invece è tutto a
4339 posto (\texttt{\small 24--27}) si calcola e si stampa a video il numero di
4340 interfacce attive trovate. L'ultima parte del programma (\texttt{\small
4341 28--33}) è il ciclo sul contenuto delle varie strutture \struct{ifreq}
4342 restituite in cui si estrae (\texttt{\small 30}) l'indirizzo ad esse
4343 assegnato\footnote{si è definito \var{access} come puntatore ad una struttura
4344 di tipo \struct{sockaddr\_in} per poter eseguire un \textit{casting}
4345 dell'indirizzo del valore restituito nei vari campi \var{ifr\_addr}, così
4346 poi da poterlo poi usare come argomento di \func{inet\_ntoa}.} e lo si
4347 stampa (\texttt{\small 31--32}) insieme al nome dell'interfaccia.
4351 \subsection{L'uso di \func{ioctl} per i socket TCP e UDP}
4352 \label{sec:sock_ioctl_IP}
4354 Non esistono operazioni specifiche per i socket IP in quanto tali,\footnote{a
4355 parte forse \const{SIOCGIFCONF}, che però resta attinente alle proprietà
4356 delle interfacce di rete, per cui l'abbiamo trattata in
4357 sez.~\ref{sec:sock_ioctl_netdevice} insieme alle altre che comunque si
4358 applicano anche ai socket IP.} mentre per i pacchetti di altri protocolli
4359 trasportati su IP, qualora li si gestisca attraverso dei socket, si dovrà fare
4360 riferimento direttamente all'eventuale supporto presente per il tipo di socket
4361 usato: ad esempio si possono ricevere pacchetti ICMP con socket di tipo
4362 \texttt{raw}, nel qual caso si dovrà fare riferimento alle operazioni di
4365 Tuttavia la gran parte dei socket utilizzati nella programmazione di rete
4366 utilizza proprio il protocollo IP, e quello che succede è che in realtà la
4367 funzione \func{ioctl} consente di effettuare alcune operazioni specifiche per
4368 i socket che usano questo protocollo, ma queste vendono eseguite, invece che a
4369 livello di IP, al successivo livello di trasporto, vale a dire in maniera
4370 specifica per i socket TCP e UDP.
4372 Le operazioni di controllo disponibili per i socket TCP sono illustrate dalla
4373 relativa pagina di manuale, accessibile con \texttt{man 7 tcp}, e prevedono
4374 come possibile valore per il secondo argomento della funzione le costanti
4375 illustrate nell'elenco seguente; il terzo argomento della funzione, gestito
4376 come \textit{value result argument}, deve essere sempre il puntatore ad una
4377 variabile di tipo \ctyp{int}:
4378 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
4379 \item[\constd{SIOCINQ}] restituisce la quantità di dati non ancora letti
4380 presenti nel buffer di ricezione; il socket non deve essere in stato
4381 \texttt{LISTEN}, altrimenti si avrà un errore di \errval{EINVAL}.
4382 \item[\constd{SIOCATMARK}] ritorna un intero non nullo, da intendere come
4383 valore logico, se il flusso di dati letti sul socket è arrivato sulla
4384 posizione (detta anche \textit{urgent mark}) in cui sono stati ricevuti dati
4385 urgenti (vedi sez.~\ref{sec:TCP_urgent_data}). Una operazione di lettura da
4386 un socket non attraversa mai questa posizione, per cui è possibile
4387 controllare se la si è raggiunta o meno con questa operazione.
4389 Questo è utile quando si attiva l'opzione \const{SO\_OOBINLINE} (vedi
4390 sez.~\ref{sec:sock_generic_options}) per ricevere i dati urgenti all'interno
4391 del flusso dei dati ordinari del socket;\footnote{vedremo in
4392 sez.~\ref{sec:TCP_urgent_data} che in genere i dati urgenti presenti su un
4393 socket si leggono \textit{out-of-band} usando un opportuno flag per
4394 \func{recvmsg}.} in tal caso quando \const{SIOCATMARK} restituisce un
4395 valore non nullo si saprà che la successiva lettura dal socket restituirà i
4396 dati urgenti e non il normale traffico; torneremo su questo in maggior
4397 dettaglio in sez.~\ref{sec:TCP_urgent_data}.
4399 \item[\constd{SIOCOUTQ}] restituisce la quantità di dati non ancora inviati
4400 presenti nel buffer di spedizione; come per \const{SIOCINQ} il socket non
4401 deve essere in stato \texttt{LISTEN}, altrimenti si avrà un errore di
4405 Le operazioni di controllo disponibili per i socket UDP, anch'esse illustrate
4406 dalla relativa pagina di manuale accessibile con \texttt{man 7 udp}, sono
4407 quelle indicate dalle costanti del seguente elenco; come per i socket TCP il
4408 terzo argomento viene gestito come \textit{value result argument} e deve
4409 essere un puntatore ad una variabile di tipo \ctyp{int}:
4410 \begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
4411 \item[\const{FIONREAD}] restituisce la dimensione in byte del primo pacchetto
4412 in attesa di ricezione, o 0 qualora non ci sia nessun pacchetto.
4413 \item[\const{TIOCOUTQ}] restituisce il numero di byte presenti nella coda di
4414 invio locale; questa opzione è supportata soltanto a partire dal kernel 2.4
4419 \section{La gestione con \func{sysctl} ed il filesystem \texttt{/proc}}
4420 \label{sec:sock_sysctl_proc}
4422 Come ultimo argomento di questo capitolo tratteremo l'uso della funzione
4423 \func{sysctl} (che è stata introdotta nelle sue funzionalità generiche in
4424 sez.~\ref{sec:sys_sysctl}) per quanto riguarda le sue capacità di effettuare
4425 impostazioni relative alle proprietà dei socket. Dato che le stesse
4426 funzionalità sono controllabili direttamente attraverso il filesystem
4427 \texttt{/proc}, le tratteremo attraverso i file presenti in quest'ultimo.
4430 \subsection{L'uso di \func{sysctl} e \texttt{/proc} per le proprietà della
4432 \label{sec:sock_sysctl}
4434 La differenza nell'uso di \func{sysctl} e del filesystem \texttt{/proc}
4435 rispetto a quello delle funzioni \func{ioctl} e \func{fcntl} visto in
4436 sez.~\ref{sec:sock_ctrl_func} o all'uso di \func{getsockopt} e
4437 \func{setsockopt} è che queste funzioni consentono di controllare le proprietà
4438 di un singolo socket, mentre con \func{sysctl} e con \texttt{/proc} si
4439 impostano proprietà (o valori di default) validi a livello dell'intero
4440 sistema, e cioè per tutti i socket.
4442 Le opzioni disponibili per le proprietà della rete, nella gerarchia dei valori
4443 impostabili con \func{sysctl}, sono riportate sotto il nodo \texttt{net}, o,
4444 se acceduti tramite l'interfaccia del filesystem \texttt{/proc}, sotto
4445 \texttt{/proc/sys/net}. In genere sotto questa directory compaiono le
4446 sottodirectory (corrispondenti ad altrettanti sotto-nodi per \func{sysctl})
4447 relative ai vari protocolli e tipi di interfacce su cui è possibile
4448 intervenire per effettuare impostazioni; un contenuto tipico di questa
4449 directory è il seguente:
4460 e sono presenti varie centinaia di parametri, molti dei quali non sono neanche
4461 documentati; nel nostro caso ci limiteremo ad illustrare quelli più
4464 Si tenga presente infine che se è sempre possibile utilizzare il filesystem
4465 \texttt{/proc} come sostituto di \func{sysctl}, dato che i valori di nodi e
4466 sotto-nodi di quest'ultima sono mappati come file e directory sotto
4467 \texttt{/proc/sys/}, non è vero il contrario, ed in particolare Linux consente
4468 di impostare alcuni parametri o leggere lo stato della rete a livello di
4469 sistema sotto \texttt{/proc/net}, dove sono presenti dei file che non
4470 corrispondono a nessun nodo di \func{sysctl}.
4473 \subsection{I valori di controllo per i socket generici}
4474 \label{sec:sock_gen_sysctl}
4476 Nella directory \texttt{/proc/sys/net/core/} sono presenti i file
4477 corrispondenti ai parametri generici di \textit{sysctl} validi per tutti i
4478 socket. Quelli descritti anche nella pagina di manuale, accessibile con
4479 \texttt{man 7 socket} sono i seguenti:
4481 \begin{basedescript}{\desclabelwidth{2.2cm}\desclabelstyle{\nextlinelabel}}
4482 \item[\sysctlrelfiled{net/core}{rmem\_default}] imposta la dimensione
4483 di default del buffer di ricezione (cioè per i dati in ingresso) dei socket.
4484 \item[\sysctlrelfiled{net/core}{rmem\_max}] imposta la dimensione
4485 massima che si può assegnare al buffer di ricezione dei socket attraverso
4486 l'uso dell'opzione \const{SO\_RCVBUF}.
4487 \item[\sysctlrelfiled{net/core}{wmem\_default}] imposta la dimensione
4488 di default del buffer di trasmissione (cioè per i dati in uscita) dei
4490 \item[\sysctlrelfiled{net/core}{wmem\_max}] imposta la dimensione
4491 massima che si può assegnare al buffer di trasmissione dei socket attraverso
4492 l'uso dell'opzione \const{SO\_SNDBUF}.
4493 \item[\sysctlrelfiled{net/core}{message\_cost},
4494 \sysctlrelfiled{net/core}{message\_burst}] contengono le impostazioni del
4495 \textit{bucket filter} che controlla l'emissione di
4496 messaggi di avviso da parte del kernel per eventi relativi a problemi sulla
4497 rete, imponendo un limite che consente di prevenire eventuali attacchi di
4498 \textit{Denial of Service} usando i log.\footnote{senza questo limite un
4499 attaccante potrebbe inviare ad arte un traffico che generi
4500 intenzionalmente messaggi di errore, per saturare il sistema dei log.}
4502 \itindbeg{bucket~filter}
4504 Il \textit{bucket filter} è un algoritmo generico che permette di impostare
4505 dei limiti di flusso su una quantità\footnote{uno analogo viene usato per
4506 imporre dei limiti sul flusso dei pacchetti nel \textit{netfilter} di
4507 Linux.} senza dovere eseguire medie temporali, che verrebbero a dipendere
4508 in misura non controllabile dalla dimensione dell'intervallo su cui si media
4509 e dalla distribuzione degli eventi;\footnote{in caso di un picco di flusso
4510 (il cosiddetto \textit{burst}) il flusso medio verrebbe a dipendere in
4511 maniera esclusiva dalla dimensione dell'intervallo di tempo su cui calcola
4512 la media.} in questo caso si definisce la dimensione di un
4513 ``\textsl{bidone}'' (il \textit{bucket}) e del flusso che da esso può
4514 uscire, la presenza di una dimensione iniziale consente di assorbire
4515 eventuali picchi di emissione, l'aver fissato un flusso di uscita garantisce
4516 che a regime questo sarà il valore medio del flusso ottenibile dal
4519 \itindend{bucket~filter}
4521 I due valori indicano rispettivamente il flusso a regime (non sarà inviato
4522 più di un messaggio per il numero di secondi specificato da
4523 \texttt{message\_cost}) e la dimensione iniziale per in caso di picco di
4524 emissione (verranno accettati inizialmente fino ad un massimo di
4525 \texttt{message\_cost/message\_burst} messaggi).
4527 \item[\sysctlrelfiled{net/core}{netdev\_max\_backlog}] numero massimo
4528 di pacchetti che possono essere contenuti nella coda di ingresso generale.
4530 \item[\sysctlrelfiled{net/core}{optmem\_max}] lunghezza massima dei
4531 dati ancillari e di controllo (vedi sez.~\ref{sec:net_ancillary_data}).
4534 Oltre a questi nella directory \texttt{/proc/sys/net/core} si trovano altri
4535 file, la cui documentazione dovrebbe essere mantenuta nei sorgenti del kernel,
4536 nel file \texttt{Documentation/networking/ip-sysctl.txt}; la maggior parte di
4537 questi però non è documentato:
4538 \begin{basedescript}{\desclabelwidth{2.2cm}\desclabelstyle{\nextlinelabel}}
4539 \item[\sysctlrelfiled{net/core}{dev\_weight}] blocco di lavoro (\textit{work
4540 quantum}) dello \textit{scheduler} di processo dei pacchetti.
4542 % TODO da documentare meglio
4544 \item[\sysctlrelfiled{net/core}{lo\_cong}] valore per l'occupazione
4545 della coda di ricezione sotto la quale si considera di avere una bassa
4548 \item[\sysctlrelfiled{net/core}{mod\_cong}] valore per l'occupazione della
4549 coda di ricezione sotto la quale si considera di avere una congestione
4552 \item[\sysctlrelfiled{net/core}{no\_cong}] valore per l'occupazione della coda
4553 di ricezione sotto la quale si considera di non avere congestione.
4555 \item[\sysctlrelfiled{net/core}{no\_cong\_thresh}] valore minimo (\textit{low
4556 water mark}) per il riavvio dei dispositivi congestionati.
4558 % \item[\sysctlrelfiled{net/core}{netdev\_fastroute}] è presente
4559 % soltanto quando si è compilato il kernel con l'apposita opzione di
4560 % ottimizzazione per l'uso come router.
4562 \item[\sysctlrelfiled{net/core}{somaxconn}] imposta la dimensione massima
4563 utilizzabile per il \textit{backlog} della funzione \func{listen} (vedi
4564 sez.~\ref{sec:TCP_func_listen}), e corrisponde al valore della costante
4565 \constd{SOMAXCONN}; il suo valore di default è 128.
4570 \subsection{I valori di controllo per il protocollo IPv4}
4571 \label{sec:sock_ipv4_sysctl}
4573 Nella directory \texttt{/proc/sys/net/ipv4} sono presenti i file che
4574 corrispondono ai parametri dei socket che usano il protocollo IPv4, relativi
4575 quindi sia alle caratteristiche di IP, che a quelle degli altri protocolli che
4576 vengono usati all'interno di quest'ultimo (come ICMP, TCP e UDP) o a fianco
4577 dello stesso (come ARP).
4579 I file che consentono di controllare le caratteristiche specifiche del
4580 protocollo IP in quanto tale, che sono descritti anche nella relativa pagina
4581 di manuale accessibile con \texttt{man 7 ip}, sono i seguenti:
4582 \begin{basedescript}{\desclabelwidth{2.2cm}\desclabelstyle{\nextlinelabel}}
4584 \item[\sysctlrelfiled{net/ipv4}{ip\_default\_ttl}] imposta il valore di
4585 default per il campo TTL (vedi sez.~\ref{sec:IP_header}) di tutti i
4586 pacchetti uscenti, stabilendo così il numero massimo di router che i
4587 pacchetti possono attraversare. Il valore può essere modificato anche per il
4588 singolo socket con l'opzione \const{IP\_TTL}. Prende un valore intero, ma
4589 dato che il campo citato è di 8 bit hanno senso solo valori fra 0 e 255. Il
4590 valore di default è 64, e normalmente non c'è nessuna necessità di
4591 modificarlo.\footnote{l'unico motivo sarebbe per raggiungere macchine
4592 estremamente ``{lontane}'' in termini di \textit{hop}, ma è praticamente
4593 impossibile trovarne.} Aumentare il valore è una pratica poco gentile, in
4594 quanto in caso di problemi di routing si allunga inutilmente il numero di
4597 \item[\sysctlrelfiled{net/ipv4}{ip\_forward}] abilita l'inoltro dei
4598 pacchetti da una interfaccia ad un altra, e può essere impostato anche per
4599 la singola interfaccia. Prende un valore logico (0 disabilita, diverso da
4600 zero abilita), di default è disabilitato.
4602 \item[\sysctlrelfiled{net/ipv4}{ip\_dynaddr}] abilita la riscrittura
4603 automatica degli indirizzi associati ad un socket quando una interfaccia
4604 cambia indirizzo. Viene usato per le interfacce usate nei collegamenti in
4605 dial-up, il cui indirizzo IP viene assegnato dinamicamente dal provider, e
4606 può essere modificato. Prende un valore intero, con 0 si disabilita la
4607 funzionalità, con 1 la si abilita, con 2 (o con qualunque altro valore
4608 diverso dai precedenti) la si abilità in modalità \textsl{prolissa}; di
4609 default la funzionalità è disabilitata.
4611 \item[\sysctlrelfiled{net/ipv4}{ip\_autoconfig}] specifica se
4612 l'indirizzo IP è stato configurato automaticamente dal kernel all'avvio
4613 attraverso DHCP, BOOTP o RARP. Riporta un valore logico (0 falso, 1 vero)
4614 accessibile solo in lettura, è inutilizzato nei kernel recenti ed eliminato
4615 a partire dal kernel 2.6.18.
4617 \item[\sysctlrelfiled{net/ipv4}{ip\_local\_port\_range}] imposta l'intervallo
4618 dei valori usati per l'assegnazione delle porte effimere, permette cioè di
4619 modificare i valori illustrati in fig.~\ref{fig:TCP_port_alloc}; prende due
4620 valori interi separati da spazi, che indicano gli estremi
4621 dell'intervallo. Si abbia cura di non definire un intervallo che si
4622 sovrappone a quello delle porte usate per il \textit{masquerading}, il
4623 kernel può gestire la sovrapposizione, ma si avrà una perdita di
4624 prestazioni. Si imposti sempre un valore iniziale maggiore di 1024 (o meglio
4625 ancora di 4096) per evitare conflitti con le porte usate dai servizi noti.
4627 \item[\sysctlrelfiled{net/ipv4}{ip\_no\_pmtu\_disc}] permette di disabilitare
4628 per i socket \const{SOCK\_STREAM} la ricerca automatica della \textit{Path
4629 MTU} (vedi sez.~\ref{sec:net_lim_dim} e
4630 sez.~\ref{sec:sock_ipv4_options}). Prende un valore logico, e di default è
4631 disabilitato (cioè la ricerca viene eseguita).
4633 In genere si abilita questo parametro quando per qualche motivo il
4634 procedimento del \textit{Path MTU discovery} fallisce; dato che questo può
4635 avvenire a causa di router\footnote{ad esempio se si scartano tutti i
4636 pacchetti ICMP, il problema è affrontato anche in sez.~3.4.4 di
4637 \cite{SGL}.} o interfacce\footnote{ad esempio se i due capi di un
4638 collegamento \textit{point-to-point} non si accordano sulla stessa MTU.}
4639 mal configurati è opportuno correggere le configurazioni, perché
4640 disabilitare globalmente il procedimento con questo parametro ha pesanti
4641 ripercussioni in termini di prestazioni di rete.
4643 \item[\sysctlrelfiled{net/ipv4}{ip\_always\_defrag}] fa si che tutti i
4644 pacchetti IP frammentati siano riassemblati, anche in caso in successivo
4645 immediato inoltro.\footnote{introdotto con il kernel 2.2.13, nelle versioni
4646 precedenti questo comportamento poteva essere solo stabilito un volta per
4647 tutte in fase di compilazione del kernel con l'opzione
4648 \texttt{CONFIG\_IP\_ALWAYS\_DEFRAG}.} Prende un valore logico e di default
4649 è disabilitato. Con i kernel dalla serie 2.4 in poi la deframmentazione
4650 viene attivata automaticamente quando si utilizza il sistema del
4651 \textit{netfilter}, e questo parametro non è più presente.
4653 \item[\sysctlrelfiled{net/ipv4}{ipfrag\_high\_thresh}] indica il limite
4654 massimo (espresso in numero di byte) sui pacchetti IP frammentati presenti
4655 in coda; quando questo valore viene raggiunta la coda viene ripulita fino al
4656 valore \texttt{ipfrag\_low\_thresh}. Prende un valore intero.
4658 \item[\sysctlrelfiled{net/ipv4}{ipfrag\_low\_thresh}] soglia bassa
4659 (specificata in byte) a cui viene riportata la coda dei pacchetti IP
4660 frammentati quando si raggiunge il valore massimo dato da
4661 \texttt{ipfrag\_high\_thresh}. Prende un valore intero.
4663 \item[\sysctlrelfiled{net/ipv4}{ip\_nonlocal\_bind}] se abilitato rende
4664 possibile ad una applicazione eseguire \func{bind} anche su un indirizzo che
4665 non è presente su nessuna interfaccia locale. Prende un valore logico e di
4666 default è disabilitato. La funzionalità può essere abilitata a livello di
4667 singolo socket con l'opzione \const{IP\_FREEBIND} illustrata in
4668 sez.~\ref{sec:sock_ipv4_options}.
4670 Questo può risultare utile per applicazioni particolari (come gli
4671 \textit{sniffer}) che hanno la necessità di ricevere pacchetti anche non
4672 diretti agli indirizzi presenti sulla macchina, ad esempio per intercettare
4673 il traffico per uno specifico indirizzo che si vuole tenere sotto
4674 controllo. Il suo uso però può creare problemi ad alcune applicazioni.
4676 % \item[\texttt{neigh/*}] La directory contiene i valori
4677 % TODO trattare neigh/* nella parte su arp, da capire dove sarà.
4681 I file di \texttt{/proc/sys/net/ipv4} che invece fanno riferimento alle
4682 caratteristiche specifiche del protocollo TCP, elencati anche nella rispettiva
4683 pagina di manuale (accessibile con \texttt{man 7 tcp}), sono i seguenti:
4684 \begin{basedescript}{\desclabelwidth{2.2cm}\desclabelstyle{\nextlinelabel}}
4686 \item[\sysctlrelfiled{net/ipv4}{tcp\_abort\_on\_overflow}] indica al
4687 kernel di azzerare le connessioni quando il programma che le riceve è troppo
4688 lento ed incapace di accettarle. Prende un valore logico ed è disabilitato
4689 di default. Questo consente di recuperare le connessioni se si è avuto un
4690 eccesso dovuto ad un qualche picco di traffico, ma ovviamente va a discapito
4691 dei client che interrogano il server. Pertanto è da abilitare soltanto
4692 quando si è sicuri che non è possibile ottimizzare il server in modo che sia
4693 in grado di accettare connessioni più rapidamente.
4695 \item[\sysctlrelfiled{net/ipv4}{tcp\_adv\_win\_scale}] indica al kernel quale
4696 frazione del buffer associato ad un socket\footnote{quello impostato con
4697 \sysctlrelfile{net/ipv4}{tcp\_rmem}.} deve essere utilizzata per la
4698 finestra del protocollo TCP\footnote{in sostanza il valore che costituisce
4699 la \textit{advertised window} annunciata all'altro capo del socket.} e
4700 quale come buffer applicativo per isolare la rete dalle latenze
4701 dell'applicazione. Prende un valore intero che determina la suddetta
4702 frazione secondo la formula
4703 $\texttt{buffer}/2^\texttt{tcp\_adv\_win\_scale}$ se positivo o con
4704 $\texttt{buffer}-\texttt{buffer}/2^\texttt{tcp\_adv\_win\_scale}$ se
4705 negativo. Il default è 2 che significa che al buffer dell'applicazione
4706 viene riservato un quarto del totale.
4708 \item[\sysctlrelfiled{net/ipv4}{tcp\_app\_win}] indica la frazione della
4709 finestra TCP che viene riservata per gestire l'overhaed dovuto alla
4710 bufferizzazione. Prende un valore valore intero che consente di calcolare la
4711 dimensione in byte come il massimo fra la MSS e
4712 $\texttt{window}/2^\texttt{tcp\_app\_win}$. Un valore nullo significa che
4713 non viene riservato nessuno spazio; il valore di default è 31.
4715 % vecchi, presumibilmente usati quando gli algoritmi di congestione non erano
4717 % \item[\texttt{tcp\_bic}]
4718 % \item[\texttt{tcp\_bic\_low\_window}]
4719 % \item[\texttt{tcp\_bic\_fast\_convergence}]
4721 \item[\sysctlrelfiled{net/ipv4}{tcp\_dsack}] abilita il supporto,
4722 definito nell'\href{http://www.ietf.org/rfc/rfc2884.txt}{RFC~2884}, per il
4723 cosiddetto \textit{Duplicate SACK}.\footnote{si indica con SACK
4724 (\textit{Selective Acknowledgement}) un'opzione TCP, definita
4725 nell'\href{http://www.ietf.org/rfc/rfc2018.txt}{RFC~2018}, usata per dare
4726 un \textit{acknowledgement} unico su blocchi di pacchetti non contigui,
4727 che consente di diminuire il numero di pacchetti scambiati.} Prende un
4728 valore logico e di default è abilitato.
4729 % TODO documentare o descrivere che cos'è il Duplicate SACK o
4730 % mettere riferimento nelle appendici
4733 \item[\sysctlrelfiled{net/ipv4}{tcp\_ecn}] abilita il meccanismo della
4734 \textit{Explicit Congestion Notification} (in breve ECN) nelle connessioni
4735 TCP. Prende valore logico che di default è disabilitato. La \textit{Explicit
4736 Congestion Notification} \itindex{Explicit~Congestion~Notification} è un
4737 meccanismo che consente di notificare quando una rotta o una rete è
4738 congestionata da un eccesso di traffico,\footnote{il meccanismo è descritto
4739 in dettaglio nell'\href{http://www.ietf.org/rfc/rfc3168.txt}{RFC~3168}
4740 mentre gli effetti sulle prestazioni del suo utilizzo sono documentate
4741 nell'\href{http://www.ietf.org/rfc/rfc2884.txt}{RFC~2884}.} si può così
4742 essere avvisati e cercare rotte alternative oppure diminuire l'emissione di
4743 pacchetti (in modo da non aumentare la congestione).
4745 Si tenga presente che se si abilita questa opzione si possono avere dei
4746 malfunzionamenti apparentemente casuali dipendenti dalla destinazione,
4747 dovuti al fatto che alcuni vecchi router non supportano il meccanismo ed
4748 alla sua attivazione scartano i relativi pacchetti, bloccando completamente
4750 % TODO documentare o descrivere che cos'è l'Explicit Congestion Notification o
4751 % mettere riferimento nelle appendici
4754 \item[\sysctlrelfiled{net/ipv4}{tcp\_fack}] abilita il supporto per il
4755 \textit{TCP Forward Acknowledgement}, un algoritmo per il controllo della
4756 congestione del traffico. Prende un valore logico e di default è abilitato.
4758 % TODO documentare o descrivere che cos'è il TCP Forward Acknowledgement o
4759 % mettere riferimento nelle appendici
4761 \item[\sysctlrelfiled{net/ipv4}{tcp\_fin\_timeout}] specifica il numero di
4762 secondi da passare in stato \texttt{FIN\_WAIT2} nell'attesa delle ricezione
4763 del pacchetto FIN conclusivo, passati quali il socket viene comunque chiuso
4764 forzatamente. Prende un valore intero che indica i secondi e di default è
4765 60.\footnote{nei kernel della serie 2.2.x era il valore utilizzato era
4766 invece di 120 secondi.} L'uso di questa opzione realizza quella che in
4767 sostanza è una violazione delle specifiche del protocollo TCP, ma è utile
4768 per fronteggiare alcuni attacchi di \textit{Denial of Service}.
4770 \item[\sysctlrelfiled{net/ipv4}{tcp\_frto}] abilita il supporto per
4771 l'algoritmo F-RTO, un algoritmo usato per la ritrasmissione dei timeout del
4772 protocollo TCP, che diventa molto utile per le reti wireless dove la perdita
4773 di pacchetti è usualmente dovuta a delle interferenze radio, piuttosto che
4774 alla congestione dei router. Prende un valore logico e di default è
4777 \item[\sysctlrelfiled{net/ipv4}{tcp\_keepalive\_intvl}] indica il
4778 numero di secondi che deve trascorrere fra l'emissione di due successivi
4779 pacchetti di test quando è abilitata la funzionalità del \textit{keepalive}
4780 (vedi sez.~\ref{sec:sock_options_main}). Prende un valore intero che di
4783 \item[\sysctlrelfiled{net/ipv4}{tcp\_keepalive\_probes}] indica il
4784 massimo numero pacchetti di \textit{keepalive} (vedi
4785 sez.~\ref{sec:sock_options_main}) che devono essere inviati senza ricevere
4786 risposta prima che il kernel decida che la connessione è caduta e la
4787 termini. Prende un valore intero che di default è 9.
4789 \item[\sysctlrelfiled{net/ipv4}{tcp\_keepalive\_time}] indica il numero
4790 di secondi che devono passare senza traffico sulla connessione prima che il
4791 kernel inizi ad inviare pacchetti di pacchetti di
4792 \textit{keepalive}.\footnote{ha effetto solo per i socket per cui si è
4793 impostata l'opzione \const{SO\_KEEPALIVE} (vedi
4794 sez.~\ref{sec:sock_options_main}.} Prende un valore intero che di default
4795 è 7200, pari a due ore.
4797 \item[\sysctlrelfiled{net/ipv4}{tcp\_low\_latency}] indica allo stack
4798 TCP del kernel di ottimizzare il comportamento per ottenere tempi di latenza
4799 più bassi a scapito di valori più alti per l'utilizzo della banda. Prende un
4800 valore logico che di default è disabilitato in quanto un maggior utilizzo
4801 della banda è preferito, ma esistono applicazioni particolari in cui la
4802 riduzione della latenza è più importante (ad esempio per i cluster di
4803 calcolo parallelo) nelle quali lo si può abilitare.
4805 \item[\sysctlrelfiled{net/ipv4}{tcp\_max\_orphans}] indica il numero
4806 massimo di socket TCP ``\textsl{orfani}'' (vale a dire non associati a
4807 nessun file descriptor) consentito nel sistema.\footnote{trattasi in genere
4808 delle connessioni relative a socket chiusi che non hanno completato il
4809 processo di chiusura.} Quando il limite viene ecceduto la connessione
4810 orfana viene resettata e viene stampato un avvertimento. Questo limite viene
4811 usato per contrastare alcuni elementari attacchi di \textit{denial of
4812 service}. Diminuire il valore non è mai raccomandato, in certe condizioni
4813 di rete può essere opportuno aumentarlo, ma si deve tenere conto del fatto
4814 che ciascuna connessione orfana può consumare fino a 64K di memoria del
4815 kernel. Prende un valore intero, il valore di default viene impostato
4816 inizialmente al valore del parametro del kernel \texttt{NR\_FILE}, e viene
4817 aggiustato a seconda della memoria disponibile.
4819 % TODO verificare la spiegazione di connessione orfana.
4821 \item[\sysctlrelfiled{net/ipv4}{tcp\_max\_syn\_backlog}] indica la lunghezza
4822 della coda delle connessioni incomplete, cioè delle connessioni per le quali
4823 si è ricevuto un SYN di richiesta ma non l'ACK finale del \textit{three way
4824 handshake} (si riveda quanto illustrato in
4825 sez.~\ref{sec:TCP_func_listen}).
4827 Quando questo valore è superato il kernel scarterà immediatamente ogni
4828 ulteriore richiesta di connessione. Prende un valore intero; il default, che
4829 è 256, viene automaticamente portato a 1024 qualora nel sistema ci sia
4830 sufficiente memoria (se maggiore di 128Mb) e ridotto a 128 qualora la
4831 memoria sia poca (inferiore a 32Mb).\footnote{si raccomanda, qualora si
4832 voglia aumentare il valore oltre 1024, di seguire la procedura citata
4833 nella pagina di manuale di TCP, e modificare il valore della costante
4834 \texttt{TCP\_SYNQ\_HSIZE} nel file \texttt{include/net/tcp.h} dei sorgenti
4835 del kernel, in modo che sia $\mathtt{tcp\_max\_syn\_backlog} \ge
4836 \mathtt{16*TCP\_SYNQ\_HSIZE}$, per poi ricompilare il kernel.}
4838 \item[\sysctlrelfiled{net/ipv4}{tcp\_max\_tw\_buckets}] indica il
4839 numero massimo di socket in stato \texttt{TIME\_WAIT} consentito nel
4840 sistema. Prende un valore intero di default è impostato al doppio del valore
4841 del parametro \texttt{NR\_FILE}, ma che viene aggiustato automaticamente a
4842 seconda della memoria presente. Se il valore viene superato il socket viene
4843 chiuso con la stampa di un avviso; l'uso di questa funzionalità consente di
4844 prevenire alcuni semplici attacchi di \textit{denial of service}.
4847 \item[\sysctlrelfiled{net/ipv4}{tcp\_mem}] viene usato dallo stack TCP
4848 per gestire le modalità con cui esso utilizzerà la memoria. Prende una
4849 tripletta di valori interi, che indicano un numero di pagine:
4852 \item il primo valore, chiamato \textit{low} nelle pagine di manuale, indica
4853 il numero di pagine allocate sotto il quale non viene usato nessun
4854 meccanismo di regolazione dell'uso della memoria.
4856 \item il secondo valore, chiamato \textit{pressure} indica il numero di
4857 pagine allocate passato il quale lo stack TCP inizia a moderare il suo
4858 consumo di memoria; si esce da questo stato di \textsl{pressione} sulla
4859 memoria quando il numero di pagine scende sotto il precedente valore
4862 \item il terzo valore, chiamato \textit{high} indica il numero massimo di
4863 pagine che possono essere utilizzate dallo stack TCP/IP, e soprassiede
4864 ogni altro valore specificato dagli altri limiti del kernel.
4867 \item[\sysctlrelfiled{net/ipv4}{tcp\_orphan\_retries}] indica il numero
4868 massimo di volte che si esegue un tentativo di controllo sull'altro capo di
4869 una connessione che è stata già chiusa dalla nostra parte. Prende un valore
4870 intero che di default è 8.
4872 \item[\sysctlrelfiled{net/ipv4}{tcp\_reordering}] indica il numero
4873 massimo di volte che un pacchetto può essere riordinato nel flusso di dati,
4874 prima che lo stack TCP assuma che è andato perso e si ponga nello stato di
4875 \textit{slow start} (si veda sez.~\ref{sec:tcp_protocol_xxx}) viene usata
4876 questa metrica di riconoscimento dei riordinamenti per evitare inutili
4877 ritrasmissioni provocate dal riordinamento. Prende un valore intero che di
4878 default che è 3, e che non è opportuno modificare.
4880 \item[\sysctlrelfiled{net/ipv4}{tcp\_retrans\_collapse}] in caso di
4881 pacchetti persi durante una connessione, per ottimizzare l'uso della banda
4882 il kernel cerca di eseguire la ritrasmissione inviando pacchetti della
4883 massima dimensione possibile; in sostanza dati che in precedenza erano stati
4884 trasmessi su pacchetti diversi possono essere ritrasmessi riuniti su un solo
4885 pacchetto (o su un numero minore di pacchetti di dimensione
4886 maggiore). Prende un valore logico e di default è abilitato.
4888 \item[\sysctlrelfiled{net/ipv4}{tcp\_retries1}] imposta il massimo
4889 numero di volte che protocollo tenterà la ritrasmissione si un pacchetto su
4890 una connessione stabilita prima di fare ricorso ad ulteriori sforzi che
4891 coinvolgano anche il livello di rete. Passato questo numero di
4892 ritrasmissioni verrà fatto eseguire al livello di rete un tentativo di
4893 aggiornamento della rotta verso la destinazione prima di eseguire ogni
4894 successiva ritrasmissione. Prende un valore intero che di default è 3.
4896 \item[\sysctlrelfiled{net/ipv4}{tcp\_retries2}] imposta il numero di
4897 tentativi di ritrasmissione di un pacchetto inviato su una connessione già
4898 stabilita per il quale non si sia ricevuto una risposta di ACK (si veda
4899 anche quanto illustrato in sez.~\ref{sec:TCP_server_crash}). Prende un
4900 valore intero che di default è 15, il che comporta un tempo variabile fra 13
4901 e 30 minuti; questo non corrisponde a quanto richiesto
4902 nell'\href{http://www.ietf.org/rfc/rfc1122.txt}{RFC~1122} dove è indicato un
4903 massimo di 100 secondi, che però è un valore considerato troppo basso.
4905 \item[\sysctlrelfiled{net/ipv4}{tcp\_rfc1337}] indica al kernel di
4906 abilitare il comportamento richiesto
4907 nell'\href{http://www.ietf.org/rfc/rfc1337.txt}{RFC~1337}. Prende un valore
4908 logico e di default è disabilitato, il che significa che alla ricezione di
4909 un segmento RST in stato \texttt{TIME\_WAIT} il socket viene chiuso
4910 immediatamente senza attendere la conclusione del periodo di
4911 \texttt{TIME\_WAIT}.
4913 \item[\sysctlrelfiled{net/ipv4}{tcp\_rmem}] viene usato dallo stack TCP
4914 per controllare dinamicamente le dimensioni dei propri buffer di ricezione,
4915 anche in rapporto alla memoria disponibile. Prende una tripletta di valori
4916 interi separati da spazi che indicano delle dimensioni in byte:
4919 \item il primo valore, chiamato \textit{min} nelle pagine di manuale, indica
4920 la dimensione minima in byte del buffer di ricezione; il default è 4Kb, ma
4921 in sistemi con poca memoria viene automaticamente ridotto a
4922 \const{PAGE\_SIZE}. Questo valore viene usato per assicurare che anche in
4923 situazioni di pressione sulla memoria (vedi quanto detto per
4924 \sysctlrelfile{net/ipv4}{tcp\_rmem}) le allocazioni al di sotto di
4925 questo limite abbiamo comunque successo. Questo valore non viene comunque
4926 ad incidere sulla dimensione del buffer di ricezione di un singolo socket
4927 dichiarata con l'opzione \const{SO\_RCVBUF}.
4929 \item il secondo valore, denominato \textit{default} nelle pagine di
4930 manuale, indica la dimensione di default, in byte, del buffer di ricezione
4931 di un socket TCP. Questo valore sovrascrive il default iniziale impostato
4932 per tutti i socket con \sysctlfile{net/core/mem\_default} che vale per
4933 qualunque protocollo. Il default è 87380 byte, ridotto a 43689 per sistemi
4934 con poca memoria. Se si desiderano dimensioni più ampie per tutti i socket
4935 si può aumentare questo valore, ma se si vuole che in corrispondenza
4936 aumentino anche le dimensioni usate per la finestra TCP si deve abilitare
4937 il \textit{TCP window scaling} (di default è abilitato, vedi più avanti
4938 \sysctlrelfile{net/ipv4}{tcp\_window\_scaling}).
4940 \item il terzo valore, denominato \textit{max} nelle pagine di manuale,
4941 indica la dimensione massima in byte del buffer di ricezione di un socket
4942 TCP; il default è 174760 byte, che viene ridotto automaticamente a 87380
4943 per sistemi con poca memoria. Il valore non può comunque eccedere il
4944 limite generale per tutti i socket posto con
4945 \sysctlfile{net/core/rmem\_max}. Questo valore non viene ad
4946 incidere sulla dimensione del buffer di ricezione di un singolo socket
4947 dichiarata con l'opzione \const{SO\_RCVBUF}.
4950 \item[\sysctlrelfiled{net/ipv4}{tcp\_sack}] indica al kernel di
4951 utilizzare il meccanismo del \textit{TCP selective acknowledgement} definito
4952 nell'\href{http://www.ietf.org/rfc/rfc2018.txt}{RFC~2018}. Prende un valore
4953 logico e di default è abilitato.
4955 \item[\sysctlrelfiled{net/ipv4}{tcp\_stdurg}] indica al kernel di
4956 utilizzare l'interpretazione che viene data
4957 dall'\href{http://www.ietf.org/rfc/rfc1122.txt}{RFC~1122} del puntatore dei
4958 \textit{dati urgenti} (vedi sez.~\ref{sec:TCP_urgent_data}) in cui questo
4959 punta all'ultimo byte degli stessi; se disabilitato viene usata
4960 l'interpretazione usata da BSD per cui esso punta al primo byte successivo.
4961 Prende un valore logico e di default è disabilitato, perché abilitarlo può
4962 dar luogo a problemi di interoperabilità.
4964 \item[\sysctlrelfiled{net/ipv4}{tcp\_synack\_retries}] indica il numero
4965 massimo di volte che verrà ritrasmesso il segmento SYN/ACK nella creazione di
4966 una connessione (vedi sez.~\ref{sec:TCP_conn_cre}). Prende un valore intero
4967 ed il valore di default è 5; non si deve superare il valore massimo di 255.
4969 \item[\sysctlrelfiled{net/ipv4}{tcp\_syncookies}] abilita i \textit{TCP
4970 syncookies}.\footnote{per poter usare questa funzionalità è necessario
4971 avere abilitato l'opzione \texttt{CONFIG\_SYN\_COOKIES} nella compilazione
4972 del kernel.} Prende un valore logico, e di default è disabilitato. Questa
4973 funzionalità serve a fornire una protezione in caso di un attacco di tipo
4974 \textit{SYN flood}, e deve essere utilizzato come ultima risorsa dato che
4975 costituisce una violazione del protocollo TCP e confligge con altre
4976 funzionalità come le estensioni e può causare problemi per i client ed il
4977 reinoltro dei pacchetti.
4979 \item[\sysctlrelfiled{net/ipv4}{tcp\_syn\_retries}] imposta il numero di
4980 tentativi di ritrasmissione dei pacchetti SYN di inizio connessione del
4981 \textit{three way handshake} (si ricordi quanto illustrato in
4982 sez.~\ref{sec:TCP_func_connect}). Prende un valore intero che di default è
4983 5; non si deve superare il valore massimo di 255.
4985 \item[\sysctlrelfiled{net/ipv4}{tcp\_timestamps}] abilita l'uso dei
4986 \textit{TCP timestamps}, come definiti
4987 nell'\href{http://www.ietf.org/rfc/rfc1323.txt}{RFC~1323}. Prende un valore
4988 logico e di default è abilitato.
4990 \item[\sysctlrelfiled{net/ipv4}{tcp\_tw\_recycle}] abilita il riutilizzo
4991 rapido dei socket in stato \texttt{TIME\_WAIT}. Prende un valore logico e di
4992 default è disabilitato. Non è opportuno abilitare questa opzione che può
4993 causare problemi con il NAT.\footnote{il
4994 \itindex{Network~Address~Translation} \textit{Network Address Translation}
4995 è una tecnica, impiegata nei firewall e nei router, che consente di
4996 modificare al volo gli indirizzi dei pacchetti che transitano per una
4997 macchina, Linux la supporta con il \textit{netfilter}.}
4999 \item[\sysctlrelfiled{net/ipv4}{tcp\_tw\_reuse}] abilita il riutilizzo
5000 dello stato \texttt{TIME\_WAIT} quando questo è sicuro dal punto di vista
5001 del protocollo. Prende un valore logico e di default è disabilitato.
5003 \item[\sysctlrelfiled{net/ipv4}{tcp\_window\_scaling}] un valore
5004 logico, attivo di default, che abilita la funzionalità del
5005 \itindex{TCP~window~scaling} \textit{TCP window scaling} definita
5006 dall'\href{http://www.ietf.org/rfc/rfc1323.txt}{RFC~1323}. Prende un valore
5007 logico e di default è abilitato. Come accennato in
5008 sez.~\ref{sec:TCP_TCP_opt} i 16 bit della finestra TCP comportano un limite
5009 massimo di dimensione di 64Kb, ma esiste una opportuna opzione del
5010 protocollo che permette di applicare un fattore di scale che consente di
5011 aumentarne le dimensioni. Questa è pienamente supportata dallo stack TCP di
5012 Linux, ma se lo si disabilita la negoziazione del
5013 \itindex{TCP~window~scaling} \textit{TCP window scaling} con l'altro capo
5014 della connessione non viene effettuata.
5016 %\item[\sysctlrelfiled{net/ipv4}{tcp\_vegas\_cong\_avoid}]
5017 % TODO: controllare su internet
5019 %\item[\sysctlrelfiled{net/ipv4}{tcp\_westwood}]
5020 % TODO: controllare su internet
5022 \item[\sysctlrelfiled{net/ipv4}{tcp\_wmem}] viene usato dallo stack TCP
5023 per controllare dinamicamente le dimensioni dei propri buffer di spedizione,
5024 adeguandole in rapporto alla memoria disponibile. Prende una tripletta di
5025 valori interi separati da spazi che indicano delle dimensioni in byte:
5028 \item il primo valore, chiamato \textit{min}, indica la dimensione minima in
5029 byte del buffer di spedizione; il default è 4Kb. Come per l'analogo di
5030 \sysctlrelfile{net/ipv4}{tcp\_rmem}) viene usato per assicurare
5031 che anche in situazioni di pressione sulla memoria (vedi
5032 \sysctlrelfile{net/ipv4}{tcp\_mem}) le allocazioni al di sotto di
5033 questo limite abbiamo comunque successo. Di nuovo questo valore non viene
5034 ad incidere sulla dimensione del buffer di trasmissione di un singolo
5035 socket dichiarata con l'opzione \const{SO\_SNDBUF}.
5037 \item il secondo valore, denominato \textit{default}, indica la dimensione
5038 di default in byte del buffer di spedizione di un socket TCP. Questo
5039 valore sovrascrive il default iniziale impostato per tutti i tipi di
5040 socket con \sysctlfile{net/core/wmem\_default}. Il default è 87380 byte,
5041 ridotto a 43689 per sistemi con poca memoria. Si può aumentare questo
5042 valore quando si desiderano dimensioni più ampie del buffer di
5043 trasmissione per i socket TCP, ma come per il precedente
5044 \sysctlrelfile{net/ipv4}{tcp\_rmem}) se si vuole che in corrispondenza
5045 aumentino anche le dimensioni usate per la finestra TCP si deve abilitare
5046 il \textit{TCP window scaling} con
5047 \sysctlrelfile{net/ipv4}{tcp\_window\_scaling}.
5049 \item il terzo valore, denominato \textit{max}, indica la dimensione massima
5050 in byte del buffer di spedizione di un socket TCP; il default è 128Kb, che
5051 viene ridotto automaticamente a 64Kb per sistemi con poca memoria. Il
5052 valore non può comunque eccedere il limite generale per tutti i socket
5053 posto con \sysctlfile{net/core/wmem\_max}. Questo valore non viene
5054 ad incidere sulla dimensione del buffer di trasmissione di un singolo
5055 socket dichiarata con l'opzione \const{SO\_SNDBUF}.
5062 % LocalWords: socket sez dotted decimal resolver Domain Name Service cap DNS
5063 % LocalWords: client fig LDAP Lightweight Access Protocol NIS Information Sun
5064 % LocalWords: like netgroup Switch Solaris glibc libc uclib NSS tab shadow uid
5065 % LocalWords: username group aliases ethers MAC address hosts networks rpc RPC
5066 % LocalWords: protocols services dns db lib libnss org truelite it root res HS
5067 % LocalWords: resource init netinet resolv int void conf host LOCALDOMAIN TCP
5068 % LocalWords: options DEBUG debug AAONLY USEVC UDP PRIMARY IGNTC RECURSE INET
5069 % LocalWords: DEFNAMES search STAYOPEN DNSRCH INSECURE NOALIASES HOSTALIASES
5070 % LocalWords: IPv gethostbyname NOCHECKNAME KEEPTSIG TSIG BLAST RETRY retry NS
5071 % LocalWords: retrans query FQDN Fully Qualified const char dname class type
5072 % LocalWords: unsigned answer anslen CSNET Hesiod MIT CHAOS Chaosnet ANY BIND
5073 % LocalWords: nameser compat Berkley MF CNAME SOA MB MR NULL WKS PTR HINFO TXT
5074 % LocalWords: MINFO RP responsible person AFSDB AFS RT router NSAP SIG KEY PX
5075 % LocalWords: GPOS AAAA LOC NXT EID NIMLOC nimrod SRV ATMA ATM NAPTR naming AF
5076 % LocalWords: authority IXFR AXFR MAILB MAILA errno NOT FOUND RECOVERY TRY err
5077 % LocalWords: AGAIN herror netdb string perror error hstrerror strerror struct
5078 % LocalWords: hostent name addrtype length addr list sys af mygethost inet ret
5079 % LocalWords: ntop deep copy buf size buflen result errnop value argument len
5080 % LocalWords: ERANGE sethostent stayopen endhostent gethostbyaddr order pton
5081 % LocalWords: getipnodebyname getipnodebyaddr flags num MAPPED ALL ADDRCONFIG
5082 % LocalWords: freehostent ip getXXXbyname getXXXbyaddr servent getservbyname
5083 % LocalWords: netent getnetbyname getnetbyaddr protoent smtp udp
5084 % LocalWords: getprotobyname getprotobyaddr getservbyport port tcp setservent
5085 % LocalWords: getservent endservent setXXXent getXXXent endXXXent gethostent
5086 % LocalWords: setnetent getnetent endnetent setprotoent getprotoent POSIX RFC
5087 % LocalWords: endprotoent getaddrinfo getnameinfo nell' node service addrinfo
5088 % LocalWords: hints linked addrlen socklen family socktype protocol sockaddr
5089 % LocalWords: canonname next PF UNSPEC SOCK STREAM DGRAM bind INADDR loopback
5090 % LocalWords: connect sendto NUMERICHOST EAI NONAME SYSTEM BADFLAGS ADDRFAMILY
5091 % LocalWords: NODATA MEMORY FAIL errcode echo mygetaddr ptr casting Canonical
5092 % LocalWords: freeaddrinfo getservname salen hostlen serv servlen l'OR NI NUL
5093 % LocalWords: NOFQDN NAMEREQD NUMERICSERV MAXHOST MAXSERV sockconn SockUtil of
5094 % LocalWords: descriptor hint fifth sockbind setsockopt getsockopt sock level
5095 % LocalWords: optname optval optlen EBADF EFAULT EINVAL ENOPROTOOPT ENOTSOCK
5096 % LocalWords: IPPROTO Stevens ICMP ICMPV ICMPv get KEEPALIVE OOBINLINE timeval
5097 % LocalWords: RCVLOWAT SNDLOWAT RCVTIMEO SNDTIMEO BSDCOMPAT BSD PASSCRED ucred
5098 % LocalWords: PEERCRED BINDTODEVICE REUSEADDR ACCEPTCONN DONTROUTE gateway MSG
5099 % LocalWords: BROADCAST broadcast SNDBUF RCVBUF LINGER linger PRIORITY read IF
5100 % LocalWords: OOB recvmsg kernel select write readv recv recvfrom EAGAIN send
5101 % LocalWords: EWOULDBLOCK writev sendmsg raw domain SCM CREDENTIALS eth packet
5102 % LocalWords: IFNAMSIZ capabilities capability ADMIN log trpt EADDRINUSE close
5103 % LocalWords: listen routing sysctl shutdown Quality TOS keep alive ACK RST to
5104 % LocalWords: ECONNRESET ETIMEDOUT keepalive echod fourth newsgroup WAIT reuse
5105 % LocalWords: sockbindopt SockUtils homed completely binding RECVDSTADDR onoff
5106 % LocalWords: PKTINFO getsockname multicast streaming unicast REUSEPORT reset
5107 % LocalWords: stealing ling RECVTOS RECVTTL TTL RECVOPTS RETOPTS HDRINCL MTU
5108 % LocalWords: RECVERR DISCOVER Path Discovery ALERT alert ADD MEMBERSHIP mreqn
5109 % LocalWords: pktinfo ipi ifindex spec dst RECVIF Live IPTOS LOWDELAY Advanced
5110 % LocalWords: Transfer Unit PMTUDISC DONT WANT route dall' pmtu EMSGSIZE imr
5111 % LocalWords: multiaddr mreq fcntl ioctl request SIOCGSTAMP trip SIOCSPGRP pid
5112 % LocalWords: process SIGIO SIGURG KILL FIOASYNC SIOCGPGRP filesystem proc ttl
5113 % LocalWords: rmem wmem message cost burst bucket filter netdev backlog optmem
5114 % LocalWords: forward dynaddr dial autoconfig local masquerading ipfrag high
5115 % LocalWords: thresh low always defrag CONFIG SETSIG cmd FIOGETOWN FIOSETOWN
5116 % LocalWords: quest'ultime neigh dev weight cong mod somaxconn Di SIOCINQ DoS
5117 % LocalWords: Documentation SIOCATMARK SIOCOUTQ FIONREAD TIOCOUTQ Denial work
5118 % LocalWords: netfilter scheduler mark ARP DHCP BOOTP RARP nonlocal sniffer is
5119 % LocalWords: linux NODELAY MAXSEG CORK KEEPIDLE KEEPINTVL KEEPCNT SYNCNT INFO
5120 % LocalWords: DEFER ACCEPT WINDOW CLAMP QUICKACK CONGESTION ENCAP urgent MSS
5121 % LocalWords: Segment SYN accept advertised window info quickack Nagle ifreq
5122 % LocalWords: ifr ppp union EPERM SIOCGIFNAME dell' interface index IFF NOARP
5123 % LocalWords: SIOCGIFINDEX SIOCGIFFLAGS POINTOPOINT RUNNING PROMISC NOTRAILERS
5124 % LocalWords: ALLMULTI bundle PORTSEL ifmap AUTOMEDIA DYNAMIC SIOCSIFFLAGS way
5125 % LocalWords: SIOCGIFMETRIC SIOCSIFMETRIC SIOCGIFMTU SIOCSIFMTU SIOCGIFHWADDR
5126 % LocalWords: SIOCSIFHWADDR SIOCSIFHWBROADCAST SIOCGIFMAP SIOCSIFMAP sendfile
5127 % LocalWords: SIOCADDMULTI SIOCDELMULTI SIOCGIFTXQLEN SIOCSIFTXQLEN three syn
5128 % LocalWords: SIOCSIFNAME SIOCGIFCONF handshake retries MIN FreeBSD closing Mb
5129 % LocalWords: abort overflow adv win app bic convergence dsack ecn fack frto
5130 % LocalWords: intvl probes latency orphans l'ACK SYNQ HSIZE tw buckets mem rfc
5131 % LocalWords: orphan reordering collapse sack stdurg synack syncookies recycle
5132 % LocalWords: timestamps scaling vegas avoid westwood tcpi l'incapsulazione NR
5133 % LocalWords: metric EOPNOTSUPP mtu hwaddr ARPHRD interrupt DMA map qlen silly
5134 % LocalWords: rename ifconf syndrome dell'ACK FTP ACCEPTFILTER advanced reno
5135 % LocalWords: congestion control Networking cubic CUBIC highspeed HSTCP htcp
5136 % LocalWords: HTCP hybla HYBLA scalable SCALABLE ifc req iflist access ntoa Kb
5137 % LocalWords: hop Selective acknowledgement Explicit RTO stack firewall passwd
5138 % LocalWords: Notification wireless denial pressure ATTACH DETACH publickey
5139 % LocalWords: libpcap discovery point l'overhaed min PAGE flood NFS blast
5140 % LocalWords: selective COOKIES NAT Translation
5142 %%% Local Variables:
5144 %%% TeX-master: "gapil"