Aggiunta la parte sulle strutture degli indirizzi
[gapil.git] / socket.tex
1 \chapter{Introduzione ai socket}
2 \label{cha:socket_intro}
3
4 Il \textit{socket} (traducibile liberamente come \textsl{manicotto}) è uno dei
5 principali meccanismi di comunicazione fra programmi utilizzato in ambito unix
6 (e non solo). Il socket costituisce in sostanza un canale di comunicazione fra
7 due processi su cui si possono leggere e scrivere dati analogo a quello di una
8 pipe ma a differenza di questa e degli altri meccanismi esaminati nel capitolo
9 \ref{cha:IPC} i socket non sono limitati alla comunicazione fra processi che
10 girano sulla stessa macchina ma possono effettuare la comunicazione anche
11 attraverso la rete.
12
13 Quella dei socket costituisce infatti la principale API (\textit{Application
14   Program Interface}) usata nella programmazione di rete.  La loro origine
15 risale al 1983, quando furono introdotti nel BSD 4.2; l'interfaccia è rimasta
16 sostanzialmente la stessa con piccole modifiche negli anni successivi. Benché
17 siano state sviluppate interfacce alternative, originate dai sistemi SYSV,
18 come la XTI (\textit{X/Open Transport Interface}) nessuna ha mai raggiunto la
19 diffusione e la popolarità di quella dei socket (né tantomeno usabilità e
20 flessibilità).
21
22 La flessibilità e la genericità dell'interfaccia inoltre ha consentito di
23 utilizzare i socket con i più disparati meccanismi di comunicazione, e non
24 solo con la suite dei protocolli TCP/IP, che sarà comunque quella di cui
25 tratteremo in maniera più estesa.
26
27
28 \section{Concetti base}
29 \label{sec:sock_gen}
30
31 Per capire il funzionamento dei socket occorre avere presente il funzionamento
32 dei protocolli di rete (vedi \ref{cha:network}), ma l'interfaccia è del tutto
33 generale e benché le problematiche (e quindi le modalità di risolvere i
34 problemi) siano diverse a seconda del tipo di protocollo di comunicazione
35 usato, le funzioni da usare restano le stesse.
36
37 Per questo motivo una semplice descrizione dell'interfaccia è assolutamente
38 inutile, in quanto il comportamento di quest'ultima e le problematiche da
39 affrontare cambiano radicalmente a seconda dello ``stile'' di comunicazione
40 usato.  La scelta di questo stile va infatti ad incidere sulla semantica che
41 verrà utilizzata a livello utente per gestire la comunicazione (su come
42 inviare e ricevere i dati) e sul comportamento effettivo delle funzioni
43 utilizzate.
44
45 La scelta di uno stile dipende sia dai meccanismi disponibili, sia dal tipo di
46 comunicazione che si vuole effettuare. Ad esempio alcuni stili di
47 comunicazione considerano i dati come una sequenza continua di bytes, altri
48 invece li raggruppano in blocchi (i pacchetti).
49
50 Un'altro esempio di stile concerne la possibilità che la comunicazione possa o
51 meno perdere dati, possa o meno non rispettare l'ordine in cui essi non sono
52 inviati, o inviare dei pacchetti più volte (come nel caso di TCP e UDP).
53
54 Un terzo esempio di stile di comunicazione concerne le modalità in cui essa
55 avviene, in certi casi essa può essere condotta con una connessione diretta
56 con un solo partner come per una telefonata; altri casi possono prevedere una
57 comunicazione come per lettera, in cui si scrive l'indirizzo su ogni
58 pacchetto, altri ancora una comunicazione \textit{broadcast} come per la
59 radio, in cui i pacchetti vengono emessi su appositi ``canali'' dove chiunque
60 si collega possa riceverli.
61
62 É chiaro che ciascuno di questi stili comporta una modalità diversa di gestire
63 la comunicazione, ad esempio se è inaffidabile occorrerà essere in grado di
64 gestire la perdita o il rimescolamento dei dati.
65
66
67 \section{La funzione \texttt{socket}}
68 \label{sec:sock_socket}
69
70 La creazione di un socket avviene attraverso l'uso della funzione
71 \texttt{socket} questa restituisce un \textit{socket descriptor} (un valore
72 intero non negativo) che come gli analoghi file descriptor di files e alle
73 pipes serve come riferimento al socket; in sostanza è l'indice nella tabella
74 dei file che contiene i puntatori alle opportune strutture usate dal kernel ed
75 allocate per ogni processo, (la stessa usata per i files e le pipes [NdA
76 verificare!]).
77
78 Il prototipo della funzione è definito nell'header \texttt{sys/socket.h}, la
79 funzione prende tre parametri, il dominio del socket (che definisce la
80 famiglia di protocolli, vedi \ref{sec:sock_domain}), il tipo di socket (che
81 definisce lo stile di comunicazione vedi \ref{sec:sock_type}) e il protocollo;
82 in genere quest'ultimo è indicato implicitamente dal tipo di socket, per cui
83 viene messo a zero (con l'eccezione dei \textit{raw socket}).
84
85 \begin{itemize}
86 \item \texttt{int socket(int domain, int type, int protocol)}
87   
88   La funzione restituisce un intero positivo se riesce, e -1 se fallisce, in
89   quest'ultimo caso la variabile \texttt{errno} è settata con i seguenti
90   codici di errore:
91
92   \begin{itemize}
93   \item \texttt{EPROTONOSUPPORT} Il tipo di socket o il protocollo scelto non
94     sono supportati nel dominio.
95   \item \texttt{ENFILE} Il kernel non ha memoria sufficiente a creare una
96     nuova struttura per il socket.
97   \item \texttt{EMFILE} Si è ecceduta la tabella dei file.
98   \item \texttt{EACCES} Non si hanno privilegi per creare un socket nel
99     dominio o con il protocollo specificato.
100   \item \texttt{EINVAL} Protocollo sconosciuto o dominio non disponibile.
101   \item \texttt{ENOBUFS} o \texttt{ENOMEM} Non c'è sufficiente memoria per
102     creare il socket.
103   \end{itemize}
104 \end{itemize}
105
106 Si noti che la creazione del socket non comporta nulla riguardo
107 all'indicazione degli indirizzi remoti o locali attraverso i quali si vuole
108 effettuare la comunicazione.
109
110 \subsection{Il dominio, o \textit{protocol family}}
111 \label{sec:sock_domain}
112
113 Dati i tanti e diversi protocolli di comunicazione disponibili, esistono vari
114 tipi di socket, che vengono classificati raggruppandoli in quelli che si
115 chiamano \textsl{domini} (\textit{domains}).  La scelta di un dominio equivale
116 in sostanza alla scelta di una famiglia di protocolli. Ciascun dominio ha un
117 suo nome simbolico che convenzionalmente inizia con \texttt{PF\_} (da
118 \textit{Protocol Family}, altro nome con cui si indicano i domini). 
119
120 A ciascun tipo di dominio corrisponde un analogo nome simbolico che inizia per
121 \texttt{AF\_} da \textit{Address Family}, e che identifica il formato degli
122 indirizzi usati in quel dominio; le man pages di linux si riferiscono a questi
123 anche come \textit{name space}, (nome che però il manuale della glibc riserva
124 ai domini) e che identifica il formato degli indirizzi usati in quel dominio.
125
126 L'idea alla base della distinzione era che una famiglia di protocolli potesse
127 supportare vari tipi di indirizzi, per cui il prefisso \texttt{PF\_} si
128 sarebbe dovuto usare nella creazione dei socket e il prefisso \texttt{AF\_} in
129 quello delle strutture degli indirizzi; questo è quanto specificato anche
130 dallo standard POSIX.1g, ma non esistono a tuttora famiglie di protocolli che
131 supportino diverse strutture di indirizzi, per cui nella pratica questi due
132 nomi sono equivalenti e corrispondono agli stessi valori.
133
134 I domini (e i relativi nomi simbolici), così come i nomi delle famiglie di
135 indirizzi sono definiti dall'header \textit{socket.h}. In linux le famiglie di
136 protocolli disponibili sono riportate in \ntab.
137
138 \begin{table}[htb]
139   \footnotesize
140   \centering
141   \begin{tabular}[c]{lll}
142        Nome               & Utilizzo                       & Man page   \\
143        PF\_UNIX,PF\_LOCAL & Local communication            & unix(7)    \\
144        PF\_INET           & IPv4 Internet protocols        & ip(7)      \\
145        PF\_INET6          & IPv6 Internet protocols        &            \\
146        PF\_IPX            & IPX - Novell protocols         &            \\
147        PF\_NETLINK        & Kernel user interface device   & netlink(7) \\
148        PF\_X25            & ITU-T X.25 / ISO-8208 protocol & x25(7)     \\
149        PF\_AX25           & Amateur radio AX.25 protocol   &            \\
150        PF\_ATMPVC         & Access to raw ATM PVCs         &            \\
151        PF\_APPLETALK      & Appletalk                      & ddp(7)     \\
152        PF\_PACKET         & Low level packet interface     & packet(7)  \\    
153   \end{tabular}
154   \caption{Famiglie di protocolli definiti in linux}
155   \label{tab:net_pf_names}
156 \end{table}
157
158 Non tutte le famiglie di protocolli sono accessibili dall'utente generico, ad
159 esempio in generale tutti i socket di tipo \texttt{SOCK\_RAW} possono essere
160 creati solo da processi che hanno i provilegi di root (cioè effective uid
161 uguale a zero) o la capability \texttt{CAP\_NET\_RAW}.
162
163
164 \subsection{Il tipo, o stile}
165 \label{sec:sock_type}
166
167 La scelta di un dominio non comporta però la scelta dello stile di
168 comunicazione, questo infatti viene a dipendere dal protocollo che si andrà ad
169 utilizzare fra quelli disponibili nella famiglia scelta. Le API permettono di
170 scegliere lo stile di comunicazione indicando il tipo di socket; linux e le
171 glibc mettono a disposizione i seguenti tipi di socket (che il manuale della
172 glibc chiama \textit{styles}) definiti come \texttt{int} in \texttt{socket.h}:
173
174 \begin{list}{}{}
175 \item \texttt{SOCK\_STREAM} Provvede un canale di trasmissione dati
176   bidirezionale, sequenziale e affidabile. Opera su una connessione con un
177   altro socket. I dati vengono ricevuti e trasmessi come un flusso continuo di
178   byte (da cui il nome \textit{stream}). Vedi \ref{sec:sock_stream}.
179 \item \texttt{SOCK\_DGRAM} Viene usato per mandare pacchetti di lunghezza
180   massima fissata (\textit{datagram}) indirizzati singolarmente, senza
181   connessione e in maniera non affidabile. È l'opposto del precedente. Vedi
182   \ref{sec:sock_dgram}.
183 \item \texttt{SOCK\_SEQPACKET} Provvede un canale di trasmissione di dati
184   bidirezionale, sequenziale e affidabile. Opera su una connessione con un
185   altro socket. I dati possono solo essere trasmessi e letti per pacchetti (di
186   dimensione massima fissata).
187 \item \texttt{SOCK\_RAW} Provvede l'accesso a basso livello ai protocolli di
188   rete e alle varie interfacce. I normali programmi di comunicazione non
189   devono usarlo.
190 \item \texttt{SOCK\_RDM} Provvede un canale di trasmissione di pacchetti
191   affidabile ma in cui non è garantito l'ordine di arrivo dei pacchetti.
192 \item \texttt{SOCK\_PACKET} Obsoleto, non deve essere usato.
193 \end{list}
194
195 Si tenga presente che non tutte le combinazioni di famiglia di protocolli e
196 tipo di socket sono valide, in quanto non è detto che nella famiglia esista un
197 protocollo per tutti gli stili di comunicazione indicati qui sopra. Una
198 tabella che mostra le combinazioni valide è la seguente:
199
200 \begin{table}[htb]
201   \footnotesize
202   \centering
203   \begin{tabular}{l|c|c|c|c|c|}
204    \multicolumn{1}{c}{} &\multicolumn{1}{c}{\texttt{SOCK\_STREAM}}& 
205      \multicolumn{1}{c}{\texttt{SOCK\_DGRAM}} & 
206      \multicolumn{1}{c}{\texttt{SOCK\_RAW}} & 
207      \multicolumn{1}{c}{\texttt{SOCK\_PACKET}}& 
208      \multicolumn{1}{c}{\texttt{SOCK\_SEQPACKET}} \\
209      \cline{2-6}
210     \texttt{PF\_UNIX}      &  si & si  &      &     &     \\
211      \cline{2-6}
212     \texttt{PF\_INET}      & TCP & UDP & IPv4 &     &     \\
213      \cline{2-6}
214     \texttt{PF\_INET6}     & TCP & UDP & IPv6 &     &     \\
215      \cline{2-6}
216     \texttt{PF\_IPX}       &     &     &      &     &     \\
217      \cline{2-6}
218     \texttt{PF\_NETLINK}   &     &  si &  si  &     &     \\
219      \cline{2-6}
220     \texttt{PF\_X25}       &     &     &      &     &  si \\
221      \cline{2-6}
222     \texttt{PF\_AX25}      &     &     &      &     &     \\
223      \cline{2-6}
224     \texttt{PF\_ATMPVC}    &     &     &      &     &     \\
225      \cline{2-6}
226     \texttt{PF\_APPLETALK} &     & si  &  si  &     &     \\
227      \cline{2-6}
228     \texttt{PF\_PACKET}    &     & si  & si   &     &     \\    
229      \cline{2-6}
230   \end{tabular}
231   \caption{Combinazioni valide di dominio e tipo di protocollo per la funzione \texttt{socket}.}
232   \label{tab:sock_sock_valid_combinations}
233 \end{table}
234
235 Dove per ogni combinazione valida si è indicato il tipo di protocollo, o la
236 parola \textsl{si} qualora non il protocollo non abbia un nome definito,
237 mentre si sono lasciate vuote le caselle per le combinazioni non supportate.
238
239 \section{Le strutture degli indirizzi dei socket}
240 \label{sec:sock_sockaddr}
241
242 Come si è visto nella creazione di un socket non si specifica nulla oltre al
243 tipo di famiglia di protocolli che si vuole utilizzare, in particolare nessun
244 indirizzo che identifichi i due capi della comunicazione. La funzione infatti
245 si limita ad allocare nel kernel quanto necessario per poter poi realizzare la
246 comunicazione.
247
248 Gli indirizzi vengono specificati attraverso apposite strutture che vengono
249 utilizzate dalle altre funzioni della API dei socket quando la comunicazione
250 viene effettivamente realizzata. 
251
252 Ogni famiglia di protocolli ha ovviamente una sua forma di indirizzamento e in
253 corrispondenza a questa una sua peculiare struttura degli indirizzi; i nomi di
254 tutte queste strutture iniziano per \texttt{sockaddr\_}, quelli propri di
255 ciascuna famiglia vengono identificati dal suffisso finale, aggiunto al nome
256 precedente.
257
258 \subsection{La struttura generica}
259 \label{sec:sock_sa_gen}
260
261 Le strutture degli indirizzi vengono sempre passate alle varie funzioni
262 attraverso puntatori (cioè \textit{by reference}), ma le funzioni devono poter
263 maneggiare puntatori a strutture relative a tutti gli indirizzi possibili
264 nelle varie famiglie di protocolli; questo pone il problema di come passare
265 questi puntatori, il C ANSI risolve questo problema coi i puntatori generici
266 (i \texttt{void *}), ma l'interfaccia dei socket è antecendente alla
267 definizione dello standard ANSI, e per questo nel 1982 fu scelto di definire
268 una struttura generica \texttt{sockaddr} per gli indirizzi dei socket mostrata
269 in \nfig:
270
271 \begin{figure}[!htbp]
272   \footnotesize
273   \begin{lstlisting}{}
274 struct sockaddr {
275     sa_family_t  sa_family;     /* address family: AF_xxx */
276     char         sa_data[14];   /* address (protocol-specific) */
277 };
278   \end{lstlisting}
279   \caption{La struttura generica degli indirizzi dei socket \texttt{sockaddr}}
280   \label{fig:sock_sa_struct}
281 \end{figure}
282
283 Tutte le funzioni dei socket che usano gli indirizzi sono definite usando nel
284 prototipo un puntatore a questa struttura; per questo motivo quando si
285 invocano dette funzioni passando l'indirizzo di un protocollo specifico
286 occorrerà eseguire un casting del relativo puntatore.
287
288 I tipi di dati che compongono la struttura sono stabiliti dallo standard
289 Posix.1g, riassunti in \ntab\ con i rispettivi file di include in cui sono
290 definiti; la struttura è invece definita nell'include file
291 \texttt{sys/socket.h}
292
293 \begin{table}[!htbp]
294   \centering
295   \begin{tabular}{|l|l|l|}
296     \hline
297     \multicolumn{1}{|c|}{Tipo}& \multicolumn{1}{|c|}{Descrizione}& 
298     \multicolumn{1}{|c|}{Header} \\
299     \hline
300     \hline
301     \texttt{int8\_t}   & intero a 8 bit con segno   & \texttt{sys/types.h}\\
302     \texttt{uint8\_t}  & intero a 8 bit senza segno & \texttt{sys/types.h}\\
303     \texttt{int16\_t}  & intero a 16 bit con segno  & \texttt{sys/types.h}\\
304     \texttt{uint16\_t} & intero a 16 bit senza segno& \texttt{sys/types.h}\\
305     \texttt{int32\_t}  & intero a 32 bit con segno  & \texttt{sys/types.h}\\
306     \texttt{uint32\_t} & intero a 32 bit senza segno& \texttt{sys/types.h}\\
307     \hline
308     \texttt{sa\_family\_t} & famiglia degli indirizzi& \texttt{sys/socket.h}\\
309     \texttt{socklen\_t} & lunghezza (\texttt{uint32\_t}) dell'indirizzo di
310     un socket& \texttt{sys/socket.h}\\
311     \hline
312     \texttt{in\_addr\_t} & indirizzo IPv4 (\texttt{uint32\_t}) & 
313     \texttt{netinet/in.h}\\
314     \texttt{in\_port\_t} & porta TCP o UDP (\texttt{uint16\_t})& 
315     \texttt{netinet/in.h}\\
316     \hline
317   \end{tabular}
318   \caption{Tipi di dati usati nelle strutture degli indirizzi, secondo quanto 
319     stabilito dallo standard Posix.1g}
320   \label{tab:sock_data_types}
321 \end{table}
322
323 In alcuni sistemi (per BSD a partire da 4.3BSD-reno) la struttura è
324 leggermente diversa e prevede un primo membro aggiuntivo \texttt{uint8\_t
325   sin\_len} (come riportato da R. Stevens nei suoi libri). Questo campo non
326 verrebbe usato direttamente dal programmatore e non è richiesto dallo standard
327 Posix.1g, in Linux pertanto non sussiste. Il campo \texttt{sa\_family\_t} era
328 storicamente un \texttt{unsigned short}.
329
330 Dal punto di vista del programmatore l'unico uso di questa struttura è quello
331 di fare da riferimento per il casting, per il kernel le cose sono un po'
332 diverse, in quanto esso usa il puntatore per recuperare il campo
333 \texttt{sa\_family} con cui determinare il tipo di indirizzo; per questo
334 motivo, anche se l'uso di un puntatore \texttt{void *} sarebbe più immediato
335 per l'utente (che non dovrebbe più eseguire il casting), è stato mantenuto
336 l'uso di questa struttura.
337
338
339 \subsection{La struttura degli indirizzi IPv4}
340 \label{sec:sock_sa_ipv4}
341
342 I socket di tipo \texttt{PF\_INET} vengono usati per la comunicazione
343 attraverso internet; la struttura per gli indirizzi per un socket internet
344 (IPv4) è definita come \texttt{sockaddr\_in} nell'header file
345 \texttt{netinet/in.h} e secondo le man page ha la forma mostrata in \nfig,
346 conforme allo standard Posix.1g.
347
348
349 \begin{figure}[!htbp]
350   \footnotesize
351   \begin{lstlisting}{}
352 struct sockaddr_in {
353     sa_family_t     sin_family; /* address family: AF_INET */
354     u_int16_t       sin_port;   /* port in network byte order */
355     struct in_addr  sin_addr;   /* internet address */
356 };
357 /* Internet address. */
358 struct in_addr {
359     u_int32_t       s_addr;     /* address in network byte order */
360 };
361   \end{lstlisting}
362   \caption{La struttura degli indirizzi dei socket internet (IPv4)
363     \texttt{sockaddr\_in}.}
364   \label{fig:sock_sa_struct}
365 \end{figure}
366
367 L'indirizzo di un socket internet (secondo IPv4) comprende l'indirizzo
368 internet di un'interfaccia più un numero di porta. Il protocollo IP non
369 prevede numeri di porta, che sono utilizzati solo dai protocolli di livello
370 superiore come TCP e UDP. Questa struttura però viene usata anche per i socket
371 RAW che accedono direttamente al livello di IP, nel qual caso il numero della
372 porta viene settato al numero di protocollo.
373
374 Il membro \texttt{sin\_family} deve essere sempre settato; \texttt{sin\_port}
375 specifica il numero di porta; i numeri di porta sotto il 1024 sono chiamati
376 \textsl{riservati} in quanto utilizzati da servizi standard. Soltanto processi
377 con i privilegi di root (effective uid uguale a zero) o con la capability
378 \texttt{CAP\_NET\_BIND\_SERVICE} possono usare la funzione \texttt{bind} su
379 queste porte.
380
381 Il membro \texttt{sin\_addr} contiene l'indirizzo internet dell'altro capo
382 della comunicazione, e viene acceduto sia come struttura (un resto di una
383 implementazione precedente in cui questa era una union usata per accedere alle
384 diverse classi di indirizzi) che come intero. 
385
386 Infine è da sottolineare che sia gli indirizzi che i numeri di porta devono
387 essere specificati in quello che viene chiamato \textit{network order}, cioè
388 con i bit ordinati in formato \textit{big endian}, questo comporta la
389 necessità di usare apposite funzioni di conversione per mantenere la
390 portabilità del codice (vedi \ref{sec:sock_addr_func} per i dettagli del
391 problema e le relative soluzioni).
392
393 \subsection{La struttura degli indirizzi IPv6}
394 \label{sec:sock_sa_ipv6}
395
396 Essendo IPv6 una estenzione di IPv4 i socket di tipo \texttt{PF\_INET6} sono
397 sostanzialmente identici ai precedenti; la parte in cui si trovano
398 praticamente tutte le differenze è quella della struttura degli indirizzi. La
399 struttura degli indirizzi è definita ancora in \texttt{netinet/in.h}.
400
401 \begin{figure}[!htbp]
402   \footnotesize
403   \begin{lstlisting}{}
404 struct sockaddr_in6 {
405     u_int16_t       sin6_family;   /* AF_INET6 */
406     u_int16_t       sin6_port;     /* port number */
407     u_int32_t       sin6_flowinfo; /* IPv6 flow information */
408     struct in6_addr sin6_addr;     /* IPv6 address */
409     u_int32_t       sin6_scope_id; /* Scope id (new in 2.4) */
410 };
411
412 struct in6_addr {
413     unsigned char   s6_addr[16];   /* IPv6 address */
414 };
415   \end{lstlisting}
416   \caption{La struttura degli indirizzi dei socket IPv6 
417     \texttt{sockaddr\_in6}.}
418   \label{fig:sock_sa_struct}
419 \end{figure}
420
421 Il campo \texttt{sin6\_family} deve essere sempre settato ad
422 \texttt{AF\_INET6}, il campo \texttt{sin6\_port} è analogo a quello di IPv4 e
423 segue le stesse regole; il campo \texttt{sin6\_flowinfo} è a dua volta diviso
424 in tre parti di cui i 24 bit inferiori indicano l'etichetta di flusso, i
425 successivi 4 bit la priorità e gli ultimi 4 sono riservati; questi valori
426 fanno riferimento ad alcuni campi specifici dell'header dei pacchetti IPv6
427 (vedi \ref{sec:appA_ipv6}) ed il loro uso è sperimentale. 
428
429 Il campo \texttt{sin6\_addr} contiene l'indirizzo a 128 bit usato da IPv6,
430 infine il campo \texttt{sin6\_scope\_id} è un campo introdotto con il kernel
431 2.4 per gestire alcune operazioni riguardanti il multicasting.
432  
433 Si noti che questa struttura è più grande di una \texttt{sockaddr} generica,
434 quindi occorre stare attenti a non avere fatto assunzioni riguardo alla
435 possibilità di contenere i dati nelle dimensioni di quest'ultima.
436
437
438  
439 \subsection{La struttura degli indirizzi locali}
440 \label{sec:sock_sa_local}
441
442 I socket di tipo \texttt{PF\_UNIX} vengono usati per una comunicazione
443 efficiente fra processi che stanno sulla stessa macchina; essi rispetto ai
444 precedenti possono essere anche creati in maniera anonima attraverso la
445 funzione \texttt{socketpair}. Quando però si vuole fare riferiemento ad uno di
446 questi socket si deve usare la seguente struttura di indirizzi definita nel
447 file di header \texttt{sys/un.h}.
448
449 \begin{figure}[!htbp]
450   \footnotesize
451   \begin{lstlisting}{}
452 #define UNIX_PATH_MAX    108
453 struct sockaddr_un {
454     sa_family_t  sun_family;              /* AF_UNIX */
455     char         sun_path[UNIX_PATH_MAX]; /* pathname */
456 };
457   \end{lstlisting}
458   \caption{La struttura degli indirizzi dei socket locali 
459     \texttt{sockaddr\_un}.}
460   \label{fig:sock_sa_struct}
461 \end{figure}
462
463 In questo caso il campo \texttt{sun\_family} deve essere \texttt{AF\_UNIX},
464 mentre il campo \texttt{sun\_path} deve specificare un indirizzo; questo ha
465 due forme un file (di tipo socket) nel filesystem o una stringa univoca
466 (tenuta in uno spazio di nomi astratto). Nel primo caso l'indirizzo viene
467 specificato come una stringa (terminata da uno zero) corrispondente al
468 pathname del file; nel secondo qinvece \texttt{sun\_path} inizia con uno zero
469 vegono usati i restanti bytes come stringa (senza terminazione).
470
471
472 \subsection{Il passaggio delle strutture}
473 \label{sec:sock_addr_pass}
474
475 Come detto nelle funzioni della API dei socket le strutture degli indirizzi
476 vengono sempre passate per riferimento usando un puntatore; anche la lunghezza
477 della struttura è passata come argomento, ma in questo caso la modalità del
478 passaggio dipende dalla direzione del medesimo, dal processo al kernel o
479 viceversa.
480
481 In particolare le tre funzioni \texttt{bind}, \texttt{connect} e
482 \texttt{sendto} passano la struttura al kernel, in questo caso è passata
483 \textsl{per valore} anche la dimensione della medesima
484
485
486 Le funzioni \texttt{accept}, \texttt{recvfrom}, \texttt{getsockname} e
487 \texttt{getpeername} 
488
489
490 \section{Le funzioni di conversione degli indirizzi}
491 \label{sec:sock_addr_func}
492
493
494
495
496
497
498 \chapter{Socket TCP elementari}
499 \label{cha:elem_TCP_sock}
500
501 Esamineremo in questo capitolo quanto necessario per capire come scrivere un
502 client e un server TCP, riprendendo quanto visto in \ref{sec:net_cli_sample} e
503 \ref{sec:net_cli_server}. 
504
505
506
507 \subsection{Creazione e terminazione della connessione TCP}
508
509 Per capire il funzionamento delle funzioni della interfaccia dei socket che
510 operano con TCP (le varie \texttt{connect}, \texttt{accept}, \texttt{close}
511 che abbiamo visto negli esempi iniziali e su cui torneremo più avanti) è
512 fodamentale capire come funziona la creazione e la conclusione di una
513 connessione TCP.
514
515 \subsection{Le porte}
516
517