From a3e1645556c933f9c430c507db629e31027c4dd9 Mon Sep 17 00:00:00 2001
From: Simone Piccardi <piccardi@gnulinux.it>
Date: Sun, 7 Nov 2004 23:19:20 +0000
Subject: [PATCH 1/1] Iniziata trattazione di getaddrinfo, aggiunte figure e
 definizione di addrinfo, modificato il Makefile per produrre il PDF dall'EPS
 diretto.

---
 Makefile              |   2 +-
 img/addrinfo_list.dia | Bin 0 -> 3501 bytes
 listati/addrinfo.h    |  11 ++
 sockctrl.tex          | 249 ++++++++++++++++++++++++++++++++++++++++--
 socket.tex            |   2 +-
 5 files changed, 251 insertions(+), 13 deletions(-)
 create mode 100644 img/addrinfo_list.dia
 create mode 100644 listati/addrinfo.h

diff --git a/Makefile b/Makefile
index a3f6a9f..ce650d6 100644
--- a/Makefile
+++ b/Makefile
@@ -16,7 +16,7 @@ $(HTML_C):  %.c.html: %.c
 $(HTML_H):  %.h.html: %.h
 	source-highlight -f html -s cpp $<
 
-$(PDF_IMG): %.pdf: %.ps
+$(PDF_IMG): %.pdf: %.eps
 	epstopdf $< --outfile=$@
 
 $(PS_IMG): %.ps : %.eps
diff --git a/img/addrinfo_list.dia b/img/addrinfo_list.dia
new file mode 100644
index 0000000000000000000000000000000000000000..a399fb22e337633c7822518313e1cabfd376603c
GIT binary patch
literal 3501
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
bhq!qAs{TR$n-tN_+gJYwwHqL~89V_1eoKLe

literal 0
HcmV?d00001

diff --git a/listati/addrinfo.h b/listati/addrinfo.h
new file mode 100644
index 0000000..7bd9408
--- /dev/null
+++ b/listati/addrinfo.h
@@ -0,0 +1,11 @@
+struct addrinfo
+{
+  int ai_flags;                 /* Input flags.  */
+  int ai_family;                /* Protocol family for socket.  */
+  int ai_socktype;              /* Socket type.  */
+  int ai_protocol;              /* Protocol for socket.  */
+  socklen_t ai_addrlen;         /* Length of socket address.  */
+  struct sockaddr *ai_addr;     /* Socket address for socket.  */
+  char *ai_canonname;           /* Canonical name for service location.  */
+  struct addrinfo *ai_next;     /* Pointer to next in list.  */
+};
diff --git a/sockctrl.tex b/sockctrl.tex
index dbe5af3..a6eabcd 100644
--- a/sockctrl.tex
+++ b/sockctrl.tex
@@ -1204,11 +1204,11 @@ funzioni \func{gethostbyaddr}, \func{gethostbyname}, \var{getipnodebyname} e
 \var{getipnodebyaddr} ed è stata introdotta una interfaccia completamente
 nuova.
 
-La prima funzione di questa interfaccia, che combina le funzionalità di
-\func{getipnodebyname}, \func{getipnodebyaddr}, \func{getservbyname} e
-\func{getservbyport}, consentendo di ottenere contemporaneamente la
-risoluzione di un indirizzo e di un servizio, è \funcd{getaddrinfo}, il cui
-prototipo è:
+La prima funzione di questa interfaccia è \funcd{getaddrinfo}, che combina le
+funzionalità delle precedenti \func{getipnodebyname}, \func{getipnodebyaddr},
+\func{getservbyname} e \func{getservbyport}, consentendo di ottenere
+contemporaneamente sia la risoluzione di un indirizzo simbolico che del nome
+un servizio; il suo prototipo è:
 \begin{functions}
   \headdecl{netdb.h} 
   \headdecl{sys/socket.h} 
@@ -1224,12 +1224,239 @@ prototipo 
 \end{functions}
 
 La funzione prende come primo argomento il nome della macchina che si vuole
-risolvere. Questo, oltre ad un comune nome a dominio, può essere anche un
-indirizzo numerico in forma \textit{dotted-decimal} per IPv4 o in formato
-esadecimale per IPv6.  Si può anche specificare il nome di una rete invece che
-di una singola macchina. Il secondo argomento specifica invece il nome del
-servizio che si intende risolvere. Uno di questi due argomenti può essere
-anche inizializzato a \const{NULL}
+risolvere, specificato tramite la stringa \param{node}. Questo argomento,
+oltre ad un comune nome a dominio, può indicare anche un indirizzo numerico in
+forma \textit{dotted-decimal} per IPv4 o in formato esadecimale per IPv6.  Si
+può anche specificare il nome di una rete invece che di una singola macchina.
+Il secondo argomento, \param{service}, specifica invece il nome del servizio
+che si intende risolvere. Per uno dei due argomenti si può anche usare il
+valore \const{NULL}, nel qual caso la risoluzione verrà effettuata utilizzando
+soltantoo sulla base del valore dell'altro.
+
+Il terzo argomento, \param{hints}, deve essere invece un puntatore ad una
+struttura \struct{addrinfo} usata per dare dei \textsl{suggerimenti} al
+procedimento di risoluzione riguardo al protocollo o del tipo di socket che si
+intenderà utilizzare; la funzione infatti permette di effettuare ricerche
+generiche sugli indirizzi, usando sia IPv4 che IPv6, e richiedere risoluzioni
+sui nomi dei servizi indipendentemente dal protocollo (ad esempio TCP o UDP)
+che questi possono utilizzare.
+
+\begin{figure}[!htb]
+  \footnotesize \centering
+  \begin{minipage}[c]{15cm}
+    \includestruct{listati/addrinfo.h}
+  \end{minipage}
+  \caption{La struttura \structd{addrinfo} usata nella nuova interfaccia POSIX
+    per la risoluzione di nomi a dominio e servizi.}
+  \label{fig:sock_addrinfo_struct}
+\end{figure}
+
+La struttura \struct{addrinfo}, la cui definizione\footnote{la definizione è
+  ripresa direttamente dal file \texttt{netdb.h} in questa struttura viene
+  dichiarata, la pagina di manuale riporta \type{size\_t} come tipo di dato
+  per il campo \var{ai\_addrlen}, qui viene usata quanto previsto dallo
+  standard POSIX, in cui viene utilizzato \type{socklen\_t}; i due tipi di
+  dati sono comunque equivalenti.} è riportata in
+fig.~\ref{fig:sock_addrinfo_struct} viene usata sia in ingresso, per passare
+dei valori di controllo alla funzione, che in uscita, per ricevere i
+risultati. Il primo campo, \var{ai\_flags}, è una maschera binaria di bit che
+permettono di controllare le varie modalità di risoluzione degli indirizzi,
+che viene usato soltanto in ingresso. I tre campi successivi \var{ai\_family},
+\var{ai\_socktype}, e \var{ai\_protocol} contengono rispettivamente la
+famiglia di indirizzi, il tipo di socket e il protocollo, in ingresso vengono
+usati per impostare una selezione (impostandone il valore nella struttura
+puntata da \param{hints}), mentre in uscita indicano il tipo di risultato
+contenuto nella struttura. 
+
+Tutti i campi seguenti vengono usati soltanto in uscita; il campo
+\var{ai\_addrlen} indica la dimensione della struttura degli indirizzi
+ottenuta come risultato, il cui contenuto sarà memorizzato nella struttura
+\struct{sockaddr} posta all'indirizzo puntato dal campo \var{ai\_addr}. Il
+campo \var{ai\_canonname} è il puntatore alla stringa contenente il nome
+canonico della macchina, ed infine, quando la funzione restituisce più di un
+risultato, \var{ai\_next} è il puntatore alla struttura \struct{addrinfo}
+successiva della lista.
+
+Ovviamente non è necessario dare dei suggerimenti in ingresso, ed usando
+\const{NULL} come valore per l'argomento \param{hints} si possono compiere
+ricerche generiche.  Se però si specifica un valore non nullo questo deve
+puntare ad una struttura \struct{addrinfo} precedentemente allocata nella
+quale siano stati opportunamente impostati i valori dei campi
+\var{ai\_family}, \var{ai\_socktype}, \var{ai\_protocol} ed \var{ai\_flags}.
+
+I due campi \var{ai\_family} e \var{ai\_socktype} prendono gli stessi valori
+degli analoghi argomenti della funzione \func{socket}; in particolare per
+\var{ai\_family} si possono usare i valori di tab.~\ref{tab:net_pf_names} ma
+sono presi in considerazione solo \const{PF\_INET} e \const{PF\_INET6}, mentre
+se non si vuole specificare questo nessuna famiglia di indirizzi si può usare
+il valore \const{PF\_UNSPEC}.  Allo stesso modo per \var{ai\_socktype} si
+possono usare i valori illustrati sez.~\ref{sec:sock_type} per indicare per
+quale tipo di socket si vuole risolvere il servizio indicato, anche se i soli
+significativi sono \const{SOCK\_STREAM} e \const{SOCK\_DGRAM}; in questo caso,
+se non si vuole effettuare nessuna risoluzione specifica, si potrà usare un
+valore nullo.
+
+Il campo \var{ai\_protocol} permette invece di effettuare la selezione dei
+risultati per il nome del servizio usando il numero identificativo del
+rispettivo protocollo di trasporto (i cui valori possibili sono riportati in
+\file{/etc/protocols}); di nuovo i due soli valori utilizzabili sono quelli
+relativi a UDP e TCP, o il valore nullo che indica di ignorare questo campo
+nella selezione.
+
+Infine l'ultimo campo è \var{ai\_flags}; che deve essere impostato come una
+maschera binaria; i bit di questa variabile infatti vengono usati per dare
+delle indicazioni sul tipo di risoluzione voluta, ed hanno valori analoghi a
+quelli visti in sez.~\ref{sec:sock_name_services} per \func{getipnodebyname};
+il valore di \var{ai\_flags} può essere impostata con un OR aritmetico delle
+costanti di tab.~\ref{tab:ai_flags_values}, ciascuna delle quali identifica un
+bit della maschera.
+
+\begin{table}[!htb]
+  \centering
+  \footnotesize
+  \begin{tabular}[c]{|l|p{10cm}|}
+    \hline
+    \textbf{Costante} & \textbf{Significato} \\
+    \hline
+    \hline
+    \const{AI\_PASSIVE}    & viene utilizzato per ottenere un indirizzo in
+                             formato adatto per una successiva chiamata a
+                             \func{bind}. Se specificato quando si è usato 
+                             \const{NULL} come valore per \param{node} gli
+                             indirizzi restituiti saranno inizializzati al
+                             valore generico (\const{INADDR\_ANY} per IPv4 e
+                             \const{IN6ADDR\_ANY\_INIT} per IPv6), altrimenti
+                             verrà usato l'indirizzo dell'interfaccia di
+                             \textit{loopback}. Se invece non è impostato gli
+                             indirizzi verrano restituiti in formato adatto ad
+                             una chiamata a \func{connect} o \func{sendto}.\\
+    \const{AI\_CANONNAME}  & richiede la restituzione del nome canonico della
+                             macchina, che verrà salvato in una stringa il cui
+                             indirizzo sarà restituito nel campo
+                             \var{ai\_canonname} della prima struttura
+                             \struct{addrinfo} dei risultati. Se il nome
+                             canonico non è disponibile al suo posto
+                             viene restituita una copia di \param{node}. \\ 
+    \const{AI\_NUMERICHOST}& se impostato il nome della macchina specificato
+                             con \param{node} deve essere espresso in forma
+                             numerica, altrimenti sarà restituito un errore
+                             \const{EAI\_NONAME} (vedi
+                             tab.~\ref{tab:addrinfo_error_code}), in questo
+                             modo si evita ogni chiamata alle funzioni di
+                             risoluzione.\\ 
+    \const{AI\_V4MAPPED}   & stesso significato dell'analoga di
+                             tab.~\ref{tab:sock_getipnodebyname_flags}.\\  
+    \const{AI\_ALL}        & stesso significato dell'analoga di
+                             tab.~\ref{tab:sock_getipnodebyname_flags}.\\ 
+    \const{AI\_ADDRCONFIG} & stesso significato dell'analoga di
+                             tab.~\ref{tab:sock_getipnodebyname_flags}.\\ 
+    \hline
+  \end{tabular}
+  \caption{Costanti associate ai bit del campo \var{ai\_flags} della struttura 
+    \struct{addrinfo}.} 
+  \label{tab:ai_flags_values}
+\end{table}
+
+Come ultimo argomento di \func{getaddrinfo} deve essere passato un puntatore
+ad una variabile (di tipo puntatore ad una struttura \struct{addrinfo}) che
+verrà utilizzata dalla funzione per restituire (come \textit{value result
+  argument}) i propri risultati. La funzione infatti è rientrante, ed alloca
+autonomamente tutta la memoria necessaria in cui verranno riportati i
+risultati della risoluzione.  La funzione restituisce in \param{res} il
+puntatore alla prima di una \textit{linked list} di strutture di tipo
+\struct{addrinfo} contenenti tutte le informazioni ottenute.
+
+La funzione restituisce un valore nullo in caso di successo, o un codice in
+caso di errore. I valori usati come codice di errore sono riportati in
+tab.~\ref{tab:addrinfo_error_code}; dato che la funzione utilizza altre
+funzioni e chiamate al sistema per ottenere il suo risultato in generale il
+valore di \var{errno} non è significativo, eccetto il caso in cui si sia
+ricevuto un errore di \const{EAI\_SYSTEM}, nel qual caso l'errore
+corrispondente è riportato tramite \var{errno}.
+
+\begin{table}[!htb]
+  \centering
+  \footnotesize
+  \begin{tabular}[c]{|l|p{10cm}|}
+    \hline
+    \textbf{Costante} & \textbf{Significato} \\
+    \hline
+    \hline
+    \const{EAI\_FAMILY}  & la famiglia di indirizzi richiesta non è
+                           supportata. \\ 
+    \const{EAI\_SOCKTYPE}& il tipo di socket richiesto non è supportato. \\
+    \const{EAI\_BADFLAGS}& il campo \var{ai\_flags} contiene dei valori non
+                           validi. \\
+    \const{EAI\_NONAME}  & il nome a dominio o il servizio non sono noti,
+                           viene usato questo errore anche quando si specifica
+                           il valore \const{NULL} per entrambi gli argomenti
+                           \param{node} e \param{service}. \\
+    \const{EAI\_SERVICE} & il servizio richiesto non è disponibile per il tipo
+                           di socket richiesto, anche se può esistere per
+                           altri tipi di socket. \\
+    \const{EAI\_ADDRFAMILY}& la rete richiesta non ha nessun indirizzo di rete
+                           per la famiglia di indirizzi specificata. \\
+    \const{EAI\_NODATA}  & la . \\
+    \const{EAI\_MEMORY}  & è stato impossibile allocare la memoria necessaria
+                           alle operazioni. \\
+    \const{EAI\_FAIL}    & il DNS ha restituito un errore di risoluzione  
+                           permanente. \\
+    \const{EAI\_AGAIN}   & il DNS ha restituito un errore di risoluzione  
+                           temporaneo, si può ritentare in seguito. \\
+    \const{EAI\_SYSTEM}  & c'è stato un errore di sistema, si può controllare
+                           \var{errno} per i dettagli. \\
+%    \hline
+% estensioni GNU, trovarne la documentazione
+%    \const{EAI\_INPROGRESS}& richiesta in corso. \\
+%    \const{EAI\_CANCELED}& la richiesta è stata cancellata.\\
+%    \const{EAI\_NOTCANCELED}& la richiesta non è stata cancellata. \\
+%    \const{EAI\_ALLDONE} & tutte le richieste sono complete. \\
+%    \const{EAI\_INTR}    & richiesta interrotta. \\
+    \hline
+  \end{tabular}
+  \caption{Costanti associate ai valori dei codici di errore della funzione
+    \func{getaddrinfo}.} 
+  \label{tab:addrinfo_error_code}
+\end{table}
+
+
+Dato che più di un indirizzo possono corrispondere ad un certo nome a dominio,
+e più di un servizio possono essere associati ad un certo nome (in genere su
+due protocolli diversi) è assolutamente normale ricevere come risposta una
+lista di più strutture \struct{addrinfo}, a meno di non avere usato una
+selezione specifica. Ad esempio se si richiede la risoluzione del servizio
+\textit{echo} si avrà come risposta la lista illustrata in
+fig.~\ref{fig:sock_addrinfo_list}.
+
+\begin{figure}[!htb]
+  \centering
+  \includegraphics[width=10cm]{img/addrinfo_list}
+  \caption{La \textit{linked list} delle strutture \struct{addrinfo}
+    restituite da \func{getaddrinfo}.}
+  \label{fig:sock_addrinfo_list}
+\end{figure}
+
+
+Una volta estratti i risultati dalla \textit{linked list} puntata da
+\param{res} si dovrà avere cura di disallocare opportunamente tutta la
+memoria, per questo viene fornita l'apposita funzione \funcd{freeaddrinfo}, il
+cui prototipo è:
+\begin{functions}
+  \headdecl{netdb.h} 
+
+  \funcdecl{void freeaddrinfo(struct addrinfo *res)}
+
+  Libera la memoria allocata da una precedente chiamata a \func{getaddrinfo}.
+
+  \bodydesc{La funzione non restituisce nessun codice di errore.}
+\end{functions}
+
+La funzione prende come unico argomento il puntatore \param{res}, ottenuto da
+una precedente chiamata a \func{getaddrinfo}, e scandisce la lista delle
+strutture per liberare tutta la memoria allocata. Dato che la funzione non ha
+valori di ritorno deve essere posta molta cura nel passare un valore valido
+per \param{res}.
+
 
 
 
diff --git a/socket.tex b/socket.tex
index 968a18c..9d86a3e 100644
--- a/socket.tex
+++ b/socket.tex
@@ -228,7 +228,7 @@ valori numerici.\footnote{in Linux, come si pu
   lo stesso nome.}
 
 I domini (e i relativi nomi simbolici), così come i nomi delle famiglie di
-indirizzi, sono definiti dall'header \textit{socket.h}. Un elenco delle
+indirizzi, sono definiti dall'header \texttt{socket.h}. Un elenco delle
 famiglie di protocolli disponibili in Linux è riportato in
 tab.~\ref{tab:net_pf_names}.\footnote{l'elenco indica tutti i protocolli
   definiti; fra questi però saranno utilizzabili solo quelli per i quali si è
-- 
2.30.2