%% socket.tex
%%
-%% Copyright (C) 2000-2015 Simone Piccardi. Permission is granted to
+%% Copyright (C) 2000-2016 Simone Piccardi. Permission is granted to
%% copy, distribute and/or modify this document under the terms of the GNU Free
%% Documentation License, Version 1.1 or any later version published by the
%% Free Software Foundation; with the Invariant Sections being "Un preambolo",
\textbf{Nome}&\textbf{Valore}&\textbf{Utilizzo}&\textbf{Man page} \\
\hline
\hline
- \const{PF\_UNSPEC} & 0& Non specificato & \\
- \const{PF\_LOCAL} & 1& Local communication & unix(7) \\
- \const{PF\_UNIX}, \const{PF\_FILE}&1&Sinonimi di \const{PF\_LOCAL}& \\
- \const{PF\_INET} & 2& IPv4 Internet protocols & ip(7) \\
- \const{PF\_AX25} & 3& Amateur radio AX.25 protocol & \\
- \const{PF\_IPX} & 4& IPX - Novell protocols & \\
- \const{PF\_APPLETALK}& 5& Appletalk & ddp(7) \\
- \const{PF\_NETROM} & 6& Amateur radio NetROM & \\
- \const{PF\_BRIDGE} & 7& Multiprotocol bridge & \\
- \const{PF\_ATMPVC} & 8& Access to raw ATM PVCs & \\
- \const{PF\_X25} & 9& ITU-T X.25 / ISO-8208 protocol& x25(7) \\
- \const{PF\_INET6} &10& IPv6 Internet protocols & ipv6(7) \\
- \const{PF\_ROSE} &11& Amateur Radio X.25 PLP & \\
- \const{PF\_DECnet} &12& Reserved for DECnet project & \\
- \const{PF\_NETBEUI} &13& Reserved for 802.2LLC project & \\
- \const{PF\_SECURITY} &14& Security callback pseudo AF & \\
- \const{PF\_KEY} &15& PF\_KEY key management API & \\
- \const{PF\_NETLINK} &16& Kernel user interface device & netlink(7) \\
- \const{PF\_ROUTE} &16& Sinonimo di \const{PF\_NETLINK} emula BSD.&\\
- \const{PF\_PACKET} &17& Low level packet interface & packet(7) \\
- \const{PF\_ASH} &18& Ash & \\
- \const{PF\_ECONET} &19& Acorn Econet & \\
- \const{PF\_ATMSVC} &20& ATM SVCs & \\
- \const{PF\_SNA} &22& Linux SNA Project & \\
- \const{PF\_IRDA} &23& IRDA socket (infrarossi) & \\
- \const{PF\_PPPOX} &24& PPPoX socket & \\
- \const{PF\_WANPIPE} &25& Wanpipe API socket & \\
- \const{PF\_LLC} &26& Linux LLC & \\
- \const{PF\_CAN} &29& Controller Are network & \\
- \const{PF\_BLUETOOTH}&31& Bluetooth socket & \\
+ \constd{PF\_UNSPEC} & 0& Non specificato & \\
+ \constd{PF\_LOCAL} & 1& Local communication & unix(7) \\
+ \constd{PF\_UNIX}, \constd{PF\_FILE}&1&Sinonimi di \const{PF\_LOCAL}& \\
+ \constd{PF\_INET} & 2& IPv4 Internet protocols & ip(7) \\
+ \constd{PF\_AX25} & 3& Amateur radio AX.25 protocol & \\
+ \constd{PF\_IPX} & 4& IPX - Novell protocols & \\
+ \constd{PF\_APPLETALK}& 5& Appletalk & ddp(7) \\
+ \constd{PF\_NETROM} & 6& Amateur radio NetROM & \\
+ \constd{PF\_BRIDGE} & 7& Multiprotocol bridge & \\
+ \constd{PF\_ATMPVC} & 8& Access to raw ATM PVCs & \\
+ \constd{PF\_X25} & 9& ITU-T X.25 / ISO-8208 protocol& x25(7) \\
+ \constd{PF\_INET6} &10& IPv6 Internet protocols & ipv6(7) \\
+ \constd{PF\_ROSE} &11& Amateur Radio X.25 PLP & \\
+ \constd{PF\_DECnet} &12& Reserved for DECnet project & \\
+ \constd{PF\_NETBEUI} &13& Reserved for 802.2LLC project & \\
+ \constd{PF\_SECURITY} &14& Security callback pseudo AF & \\
+ \constd{PF\_KEY} &15& PF\_KEY key management API & \\
+ \constd{PF\_NETLINK} &16& Kernel user interface device & netlink(7) \\
+ \constd{PF\_ROUTE} &16& Sinonimo di \const{PF\_NETLINK} emula BSD.&\\
+ \constd{PF\_PACKET} &17& Low level packet interface & packet(7) \\
+ \constd{PF\_ASH} &18& Ash & \\
+ \constd{PF\_ECONET} &19& Acorn Econet & \\
+ \constd{PF\_ATMSVC} &20& ATM SVCs & \\
+ \constd{PF\_SNA} &22& Linux SNA Project & \\
+ \constd{PF\_IRDA} &23& IRDA socket (infrarossi) & \\
+ \constd{PF\_PPPOX} &24& PPPoX socket & \\
+ \constd{PF\_WANPIPE} &25& Wanpipe API socket & \\
+ \constd{PF\_LLC} &26& Linux LLC & \\
+ \constd{PF\_CAN} &29& Controller Are Network & \\
+ \constd{PF\_BLUETOOTH}&31& Bluetooth socket & \\
\hline
\end{tabular}
\caption{Famiglie di protocolli definiti in Linux.}
seguendo la convenzione usata nelle pagine di manuale.
I domini (e i relativi nomi simbolici), così come i nomi delle famiglie di
-indirizzi, sono definiti dall'\textit{header file} \headfile{socket.h}. Un
+indirizzi, sono definiti dall'\textit{header file} \headfiled{socket.h}. Un
elenco delle famiglie di protocolli disponibili in Linux è riportato in
tab.~\ref{tab:net_pf_names}. L'elenco indica tutti i protocolli definiti; fra
questi però saranno utilizzabili solo quelli per i quali si è compilato il
supporto nel kernel (o si sono caricati gli opportuni moduli), viene definita
-anche una costante \const{PF\_MAX} che indica il valore massimo associabile ad
-un dominio.
+anche una costante \constd{PF\_MAX} che indica il valore massimo associabile
+ad un dominio.
Si tenga presente che non tutte le famiglie di protocolli sono utilizzabili
dall'utente generico, ad esempio in generale tutti i socket di tipo
\texttt{include/linux/net.h} dei sorgenti del kernel.}
\begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
-\item[\const{SOCK\_STREAM}] Provvede un canale di trasmissione dati
+\item[\constd{SOCK\_STREAM}] Provvede un canale di trasmissione dati
bidirezionale, sequenziale e affidabile. Opera su una connessione con un
altro socket. I dati vengono ricevuti e trasmessi come un flusso continuo di
byte (da cui il nome \textit{stream}) e possono essere letti in blocchi di
dimensioni qualunque. Può supportare la trasmissione dei cosiddetti dati
- urgenti (o \itindex{out-of-band} \textit{out-of-band}, vedi
- sez.~\ref{sec:TCP_urgent_data}).
-\item[\const{SOCK\_DGRAM}] Viene usato per trasmettere pacchetti di dati
+ urgenti (o \textit{out-of-band}, vedi sez.~\ref{sec:TCP_urgent_data}).
+\item[\constd{SOCK\_DGRAM}] Viene usato per trasmettere pacchetti di dati
(\textit{datagram}) di lunghezza massima prefissata, indirizzati
singolarmente. Non esiste una connessione e la trasmissione è effettuata in
maniera non affidabile.
-\item[\const{SOCK\_SEQPACKET}] Provvede un canale di trasmissione di dati
+\item[\constd{SOCK\_SEQPACKET}] Provvede un canale di trasmissione di dati
bidirezionale, sequenziale e affidabile. Opera su una connessione con un
altro socket. I dati possono vengono trasmessi per pacchetti di dimensione
massima fissata, e devono essere letti integralmente da ciascuna chiamata a
\func{read}.
-\item[\const{SOCK\_RAW}] Provvede l'accesso a basso livello ai protocolli di
+\item[\constd{SOCK\_RAW}] Provvede l'accesso a basso livello ai protocolli di
rete e alle varie interfacce. I normali programmi di comunicazione non
devono usarlo, è riservato all'uso di sistema.
-\item[\const{SOCK\_RDM}] Provvede un canale di trasmissione di dati
+\item[\constd{SOCK\_RDM}] Provvede un canale di trasmissione di dati
affidabile, ma in cui non è garantito l'ordine di arrivo dei pacchetti.
-\item[\const{SOCK\_PACKET}] Obsoleto, non deve essere più usato (e pertanto
+\item[\constd{SOCK\_PACKET}] Obsoleto, non deve essere più usato (e pertanto
non ne parleremo ulteriormente).
\end{basedescript}
illustrati. Essi infatti possono essere combinati con un OR aritmetico delle
ulteriori costanti:
\begin{basedescript}{\desclabelwidth{1.5cm}\desclabelstyle{\nextlinelabel}}
-\item[\const{SOCK\_CLOEXEC}] imposta il flag di \textit{close-on-exec} sul
+\item[\constd{SOCK\_CLOEXEC}] imposta il flag di \textit{close-on-exec} sul
file descriptor del socket, ottenendo lo stesso effetto del flag
\const{O\_CLOEXEC} di \func{open} (vedi tab.~\ref{tab:open_operation_flag}),
di cui costituisce l'analogo.
-\item[\const{SOCK\_NONBLOCK}] crea il socket in modalità non-bloccante, con
+\item[\constd{SOCK\_NONBLOCK}] crea il socket in modalità non-bloccante, con
effetti identici ad una successiva chiamata a \func{fcntl} per impostare il
flag di \const{O\_NONBLOCK} sul file descriptor (si faccia di nuovo
riferimenti al significato di quest'ultimo come spiegato in
&\const{SOCK\_STREAM} &\const{SOCK\_DGRAM} &\const{SOCK\_RAW}&
\const{SOCK\_RDM}&\const{SOCK\_SEQPACKET} \\
\hline
- \const{PF\_LOCAL} & si & si & & & \\
+ \const{PF\_UNIX} & si & si & -- & -- & si\footnotemark \\
\hline
-% \const{PF\_UNIX}&\multicolumn{5}{|l|}{sinonimo di \const{PF\_LOCAL}.}\\
-% \hline
- \const{PF\_INET} & TCP & UDP & IPv4 & & \\
+ \const{PF\_LOCAL}&\multicolumn{5}{|c|}{sinonimo di \const{PF\_UNIX}}\\
\hline
- \const{PF\_INET6} & TCP & UDP & IPv6 & & \\
+ \const{PF\_INET} & TCP & UDP & IPv4 & -- & -- \\
\hline
- \const{PF\_IPX} & & & & & \\
+ \const{PF\_INET6} & TCP & UDP & IPv6 & -- & -- \\
\hline
- \const{PF\_NETLINK} & & si & si & & \\
+ \const{PF\_IPX} & -- & -- & -- & -- & -- \\
\hline
- \const{PF\_X25} & & & & & si \\
+ \const{PF\_NETLINK} & -- & si & si & -- & -- \\
\hline
- \const{PF\_AX25} & & & & & \\
+ \const{PF\_X25} & -- & -- & -- & -- & si \\
\hline
- \const{PF\_ATMPVC} & & & & & \\
+ \const{PF\_AX25} & -- & -- & -- & -- & -- \\
\hline
- \const{PF\_APPLETALK} & & si & si & & \\
+ \const{PF\_ATMPVC} & -- & -- & -- & -- & -- \\
\hline
- \const{PF\_PACKET} & & si & si & & \\
+ \const{PF\_APPLETALK} & -- & si & si & -- & -- \\
+ \hline
+ \const{PF\_PACKET} & -- & si & si & -- & -- \\
\hline
\end{tabular}
\caption{Combinazioni valide di dominio e tipo di protocollo per la
\label{tab:sock_sock_valid_combinations}
\end{table}
+\footnotetext{supportati a partire dal kernel 2.6.4 per socket che conservano
+ i limiti dei messaggi e li consegnano in sequenza ordinata.}
+
In tab.~\ref{tab:sock_sock_valid_combinations} sono mostrate le combinazioni
valide possibili per le principali famiglie di protocolli. Per ogni
combinazione valida si è indicato il tipo di protocollo, o la parola
-\textsl{si} qualora non il protocollo non abbia un nome definito, mentre si
-sono lasciate vuote le caselle per le combinazioni non supportate.
+\textsl{si} qualora il protocollo non abbia un nome definito, mentre si sono
+lasciate vuote le caselle per le combinazioni non supportate.
\section{Le strutture degli indirizzi dei socket}
\multicolumn{1}{|c|}{\textbf{Header}} \\
\hline
\hline
- \type{int8\_t} & intero a 8 bit con segno & \headfile{sys/types.h}\\
- \type{uint8\_t} & intero a 8 bit senza segno & \headfile{sys/types.h}\\
- \type{int16\_t} & intero a 16 bit con segno & \headfile{sys/types.h}\\
- \type{uint16\_t} & intero a 16 bit senza segno& \headfile{sys/types.h}\\
- \type{int32\_t} & intero a 32 bit con segno & \headfile{sys/types.h}\\
- \type{uint32\_t} & intero a 32 bit senza segno& \headfile{sys/types.h}\\
+ \typed{int8\_t} & intero a 8 bit con segno & \headfile{sys/types.h}\\
+ \typed{uint8\_t} & intero a 8 bit senza segno & \headfile{sys/types.h}\\
+ \typed{int16\_t} & intero a 16 bit con segno & \headfile{sys/types.h}\\
+ \typed{uint16\_t} & intero a 16 bit senza segno& \headfile{sys/types.h}\\
+ \typed{int32\_t} & intero a 32 bit con segno & \headfile{sys/types.h}\\
+ \typed{uint32\_t} & intero a 32 bit senza segno& \headfile{sys/types.h}\\
\hline
- \type{sa\_family\_t} & famiglia degli indirizzi&\headfile{sys/socket.h}\\
- \type{socklen\_t} & lunghezza (\type{uint32\_t}) dell'indirizzo di
+ \typed{sa\_family\_t} & famiglia degli indirizzi&\headfile{sys/socket.h}\\
+ \typed{socklen\_t} & lunghezza (\type{uint32\_t}) dell'indirizzo di
un socket& \headfile{sys/socket.h}\\
\hline
- \type{in\_addr\_t} & indirizzo IPv4 (\type{uint32\_t}) &
+ \typed{in\_addr\_t} & indirizzo IPv4 (\type{uint32\_t}) &
\headfile{netinet/in.h}\\
- \type{in\_port\_t} & porta TCP o UDP (\type{uint16\_t})&
+ \typed{in\_port\_t} & porta TCP o UDP (\type{uint16\_t})&
\headfile{netinet/in.h}\\
\hline
\end{tabular}
sarebbe più immediato per l'utente (che non dovrebbe più eseguire il casting),
è stato mantenuto l'uso di questa struttura.
+Se si usa una struttura \struct{sockaddr} per allocare delle variabili
+generiche da usare in seguito per degli indirizzi si pone il problema che
+niente assicura che i dati necessari per le varie famiglie di indirizzi
+possano rientrare nella dimensione del campo \var{sa\_data}, anzi, come
+vedremo in sez.~\ref{sec:sock_sa_ipv6}, nel caso di indirizzi IPv6 questa
+non è proprio sufficiente. Per questo l'interfaccia di programmazione dei
+socket prevede la defizione di una speciale struttura
+\struct{sockaddr\_storage} per la quale è assicurato che la dimensione sia
+sufficiente per qualunque
+
\subsection{La struttura degli indirizzi IPv4}
\label{sec:sock_sa_ipv4}
I socket di tipo \const{PF\_INET} vengono usati per la comunicazione
-attraverso internet; la struttura per gli indirizzi per un socket internet (se
+attraverso Internet; la struttura per gli indirizzi per un socket Internet (se
si usa IPv4) è definita come \struct{sockaddr\_in} nell'header file
-\headfile{netinet/in.h} ed ha la forma mostrata in
+\headfiled{netinet/in.h} ed ha la forma mostrata in
fig.~\ref{fig:sock_sa_ipv4_struct}, conforme allo standard POSIX.1g.
\begin{figure}[!htb]
\includestruct{listati/sockaddr_in.h}
\end{minipage}
\caption{La struttura \structd{sockaddr\_in} degli indirizzi dei socket
- internet (IPv4) e la struttura \structd{in\_addr} degli indirizzi IPv4.}
+ Internet (IPv4) e la struttura \structd{in\_addr} degli indirizzi IPv4.}
\label{fig:sock_sa_ipv4_struct}
\end{figure}
-L'indirizzo di un socket internet (secondo IPv4) comprende l'indirizzo
-internet di un'interfaccia più un \textsl{numero di porta} (affronteremo in
+L'indirizzo di un socket Internet (secondo IPv4) comprende l'indirizzo
+Internet di un'interfaccia più un \textsl{numero di porta} (affronteremo in
dettaglio il significato di questi numeri in sez.~\ref{sec:TCP_port_num}). Il
protocollo IP non prevede numeri di porta, che sono utilizzati solo dai
protocolli di livello superiore come TCP e UDP. Questa struttura però viene
usata anche per i socket RAW che accedono direttamente al livello di IP, nel
qual caso il numero della porta viene impostato al numero di protocollo.
-Il membro \var{sin\_family} deve essere sempre impostato a \const{AF\_INET},
+Il membro \var{sin\_family} deve essere sempre impostato a \constd{AF\_INET},
altrimenti si avrà un errore di \errcode{EINVAL}; il membro \var{sin\_port}
specifica il \textsl{numero di porta}. I numeri di porta sotto il 1024 sono
chiamati \textsl{riservati} in quanto utilizzati da servizi standard e
possono usare la funzione \func{bind} (che vedremo in
sez.~\ref{sec:TCP_func_bind}) su queste porte.
-Il membro \var{sin\_addr} contiene un indirizzo internet, e viene acceduto sia
+Il membro \var{sin\_addr} contiene un indirizzo Internet, e viene acceduto sia
come struttura (un resto di una implementazione precedente in cui questa era
una \dirct{union} usata per accedere alle diverse classi di indirizzi) che
direttamente come intero. In \headfile{netinet/in.h} vengono definite anche
\label{fig:sock_sa_ipv6_struct}
\end{figure}
-Il campo \var{sin6\_family} deve essere sempre impostato ad \const{AF\_INET6},
+Il campo \var{sin6\_family} deve essere sempre impostato ad \constd{AF\_INET6},
il campo \var{sin6\_port} è analogo a quello di IPv4 e segue le stesse regole;
il campo \var{sin6\_flowinfo} è a sua volta diviso in tre parti di cui i 24
bit inferiori indicano l'etichetta di flusso, i successivi 4 bit la priorità e
\end{minipage}
\caption{La struttura \structd{sockaddr\_un} degli indirizzi dei socket
locali (detti anche \textit{unix domain}) definita in
- \headfile{sys/un.h}.}
+ \headfiled{sys/un.h}.}
\label{fig:sock_sa_local_struct}
\end{figure}
-In questo caso il campo \var{sun\_family} deve essere \const{AF\_UNIX}, mentre
+In questo caso il campo \var{sun\_family} deve essere \constd{AF\_UNIX}, mentre
il campo \var{sun\_path} deve specificare un indirizzo. Questo ha due forme;
può essere un file (di tipo socket) nel filesystem o una stringa univoca
(mantenuta in uno spazio di nomi astratto). Nel primo caso l'indirizzo viene
a pacchetto, di tipo \const{SOCK\_DGRAM}; l'argomento \param{protocol} di
\func{socket} deve essere nullo. È altresì possibile usare i socket raw
specificando un tipo \const{SOCK\_RAW}, nel qual caso l'unico valore valido
-per \param{protocol} è \const{ATPROTO\_DDP}.
+per \param{protocol} è \constd{ATPROTO\_DDP}.
Gli indirizzi AppleTalk devono essere specificati tramite una struttura
\struct{sockaddr\_atalk}, la cui definizione è riportata in
fig.~\ref{fig:sock_sa_atalk_struct}; la struttura viene dichiarata includendo
-il file \headfile{netatalk/at.h}.
+il file \headfiled{netatalk/at.h}.
\begin{figure}[!htb]
\footnotesize \centering
\label{fig:sock_sa_atalk_struct}
\end{figure}
-Il campo \var{sat\_family} deve essere sempre \const{AF\_APPLETALK}, mentre il
-campo \var{sat\_port} specifica la porta che identifica i vari servizi. Valori
-inferiori a 129 sono usati per le \textsl{porte riservate}, e possono essere
-usati solo da processi con i privilegi di amministratore o con la
-\textit{capability} \const{CAP\_NET\_BIND\_SERVICE}. L'indirizzo remoto è
+Il campo \var{sat\_family} deve essere sempre \constd{AF\_APPLETALK}, mentre
+il campo \var{sat\_port} specifica la porta che identifica i vari
+servizi. Valori inferiori a 129 sono usati per le \textsl{porte riservate}, e
+possono essere usati solo da processi con i privilegi di amministratore o con
+la \textit{capability} \const{CAP\_NET\_BIND\_SERVICE}. L'indirizzo remoto è
specificato nella struttura \var{sat\_addr}, e deve essere in \textit{network
- order} (vedi sez.~\ref{sec:endianness}); esso è composto da un parte di
-rete data dal campo \var{s\_net}, che può assumere il valore
-\const{AT\_ANYNET}, che indica una rete generica e vale anche per indicare la
-rete su cui si è, il singolo nodo è indicato da \var{s\_node}, e può prendere
-il valore generico \const{AT\_ANYNODE} che indica anche il nodo corrente, ed
-il valore \const{ATADDR\_BCAST} che indica tutti i nodi della rete.
+ order} (vedi sez.~\ref{sec:endianness}); esso è composto da un parte di rete
+data dal campo \var{s\_net}, che può assumere il valore \constd{AT\_ANYNET},
+che indica una rete generica e vale anche per indicare la rete su cui si è, il
+singolo nodo è indicato da \var{s\_node}, e può prendere il valore generico
+\constd{AT\_ANYNODE} che indica anche il nodo corrente, ed il valore
+\constd{ATADDR\_BCAST} che indica tutti i nodi della rete.
\subsection{La struttura degli indirizzi dei \textit{packet socket}}
utilizzare. I valori possibili sono definiti secondo lo standard IEEE 802.3, e
quelli disponibili in Linux sono accessibili attraverso opportune costanti
simboliche definite nel file \file{linux/if\_ether.h}. Se si usa il valore
-speciale \const{ETH\_P\_ALL} passeranno sul \textit{packet socket} tutti i
+speciale \constd{ETH\_P\_ALL} passeranno sul \textit{packet socket} tutti i
pacchetti, qualunque sia il loro protocollo di collegamento. Ovviamente l'uso
di questi socket è una operazione privilegiata e può essere effettuati solo da
un processo con i privilegi di amministratore (\ids{UID} effettivo nullo) o
pacchetto.
Al solito il campo \var{sll\_family} deve essere sempre impostato al valore
-\const{AF\_PACKET}. Il campo \var{sll\_protocol} indica il protocollo scelto,
+\constd{AF\_PACKET}. Il campo \var{sll\_protocol} indica il protocollo scelto,
e deve essere indicato in \textit{network order}, facendo uso delle costanti
simboliche definite in \file{linux/if\_ether.h}. Il campo \var{sll\_ifindex} è
l'indice dell'interfaccia, che, in caso di presenza di più interfacce dello
-stesso tipo (se ad esempio si hanno più schede ethernet), permette di
+stesso tipo (se ad esempio si hanno più schede Ethernet), permette di
selezionare quella con cui si vuole operare (un valore nullo indica qualunque
interfaccia). Questi sono i due soli campi che devono essere specificati
quando si vuole selezionare una interfaccia specifica, usando questa struttura
I campi \var{sll\_halen} e \var{sll\_addr} indicano rispettivamente
l'indirizzo associato all'interfaccia sul protocollo di collegamento e la
relativa lunghezza; ovviamente questi valori cambiano a seconda del tipo di
-collegamento che si usa, ad esempio, nel caso di ethernet, questi saranno il
+collegamento che si usa, ad esempio, nel caso di Ethernet, questi saranno il
MAC address della scheda e la relativa lunghezza. Essi vengono usati, insieme
ai campi \var{sll\_family} e \var{sll\_ifindex} quando si inviano dei
pacchetti, in questo caso tutti gli altri campi devono essere nulli.
\file{linux/if\_arp.h}, mentre il campo \var{sll\_pkttype} indica il tipo di
pacchetto; entrambi vengono impostati alla ricezione di un pacchetto ed han
senso solo in questo caso. In particolare \var{sll\_pkttype} può assumere i
-seguenti valori: \const{PACKET\_HOST} per un pacchetto indirizzato alla
-macchina ricevente, \const{PACKET\_BROADCAST} per un pacchetto di
-\textit{broadcast}, \const{PACKET\_MULTICAST} per un pacchetto inviato ad un
-indirizzo fisico di \textit{multicast}, \const{PACKET\_OTHERHOST} per un
-pacchetto inviato ad un'altra stazione (e ricevuto su un'interfaccia in
-\index{modo~promiscuo} modo promiscuo), \const{PACKET\_OUTGOING} per un
-pacchetto originato dalla propria macchina che torna indietro sul socket.
-
+seguenti valori: \constd{PACKET\_HOST} per un pacchetto indirizzato alla
+macchina ricevente, \constd{PACKET\_BROADCAST} per un pacchetto di
+\textit{broadcast}, \constd{PACKET\_MULTICAST} per un pacchetto inviato ad un
+indirizzo fisico di \textit{multicast}, \constd{PACKET\_OTHERHOST} per un
+pacchetto inviato ad un'altra stazione (e ricevuto su un'interfaccia in modo
+promiscuo), \constd{PACKET\_OUTGOING} per un pacchetto originato dalla propria
+macchina che torna indietro sul socket.
Si tenga presente infine che in fase di ricezione, anche se si richiede il
troncamento del pacchetto, le funzioni \func{recv}, \func{recvfrom} e
\label{sec:sock_addr_func}
In questa sezione tratteremo delle varie funzioni usate per manipolare gli
-indirizzi, limitandoci però agli indirizzi internet. Come accennato gli
+indirizzi, limitandoci però agli indirizzi Internet. Come accennato gli
indirizzi e i numeri di porta usati nella rete devono essere forniti nel
cosiddetto \textit{network order}, che corrisponde al formato \textit{big
- endian}, anche quando la proprio macchina non usa questo formati, cosa che
-può comportare la necessità di eseguire delle conversioni.
+ endian} (vedi sez.~\ref{sec:endianness}), anche quando la proprio macchina
+non usa questo formato, cosa che può comportare la necessità di eseguire delle
+conversioni.
\subsection{Le funzioni per il riordinamento}
all'\textit{endianness} è che quando si passano dei dati da un tipo di
architettura all'altra i dati vengono interpretati in maniera diversa, e ad
esempio nel caso dell'intero a 16 bit ci si ritroverà con i due byte in cui è
-suddiviso scambiati di posto. Per questo motivo si usano delle funzioni di
-conversione che servono a tener conto automaticamente della possibile
-differenza fra l'ordinamento usato sul computer e quello che viene usato nelle
-trasmissione sulla rete; queste funzioni sono \funcd{htonl}, \funcd{htons},
-\funcd{ntohl} e \funcd{ntohs} ed i rispettivi prototipi sono:
-\begin{functions}
- \headdecl{netinet/in.h}
- \funcdecl{unsigned long int htonl(unsigned long int hostlong)}
- Converte l'intero a 32 bit \param{hostlong} dal formato della macchina a
- quello della rete.
-
- \funcdecl{unsigned short int htons(unsigned short int hostshort)}
- Converte l'intero a 16 bit \param{hostshort} dal formato della macchina a
- quello della rete.
+suddiviso scambiati di posto.
- \funcdecl{unsigned long int ntohl(unsigned long int netlong)}
- Converte l'intero a 32 bit \param{netlong} dal formato della rete a quello
- della macchina.
+Per questo motivo si usano delle funzioni di conversione che servono a tener
+conto automaticamente della possibile differenza fra l'ordinamento usato sul
+computer e quello che viene usato nelle trasmissione sulla rete; queste
+funzioni sono \funcd{htonl}, \funcd{htons}, \funcd{ntohl} e \funcd{ntohs} ed i
+rispettivi prototipi sono:
- \funcdecl{unsigned sort int ntohs(unsigned short int netshort)}
- Converte l'intero a 16 bit \param{netshort} dal formato della rete a quello
- della macchina.
-
- \bodydesc{Tutte le funzioni restituiscono il valore convertito, e non
- prevedono errori.}
-\end{functions}
+\begin{funcproto}{
+\fhead{netinet/in.h}
+\fdecl{unsigned long int htonl(unsigned long int hostlong)}
+\fdesc{Converte l'intero a 32 bit \param{hostlong} dal formato della macchina a
+ quello della rete.}
+\fdecl{unsigned short int htons(unsigned short int hostshort)}
+\fdesc{Converte l'intero a 16 bit \param{hostshort} dal formato della macchina a
+ quello della rete.}
+\fdecl{unsigned long int ntohl(unsigned long int netlong)}
+\fdesc{Converte l'intero a 32 bit \param{netlong} dal formato della rete a quello
+ della macchina.}
+\fdecl{unsigned sort int ntohs(unsigned short int netshort)}
+\fdesc{Converte l'intero a 16 bit \param{netshort} dal formato della rete a quello
+ della macchina.}
+}
+
+{Tutte le funzioni restituiscono il valore convertito, e non prevedono
+ errori.}
+\end{funcproto}
I nomi sono assegnati usando la lettera \texttt{n} come mnemonico per indicare
l'ordinamento usato sulla rete (da \textit{network order}) e la lettera
La funzione converte la struttura dell'indirizzo puntata da \param{addr\_ptr}
in una stringa che viene copiata nel buffer puntato dall'indirizzo
\param{dest}; questo deve essere preallocato dall'utente e la lunghezza deve
-essere almeno \const{INET\_ADDRSTRLEN} in caso di indirizzi IPv4 e
-\const{INET6\_ADDRSTRLEN} per indirizzi IPv6; la lunghezza del buffer deve
+essere almeno \constd{INET\_ADDRSTRLEN} in caso di indirizzi IPv4 e
+\constd{INET6\_ADDRSTRLEN} per indirizzi IPv6; la lunghezza del buffer deve
comunque venire specificata attraverso il parametro \param{len}.
Gli indirizzi vengono convertiti da/alle rispettive strutture di indirizzo
-
% LocalWords: socket sez cap BSD SVr XTI Transport Interface TCP stream UDP PF
% LocalWords: datagram broadcast descriptor sys int domain type protocol errno
% LocalWords: EPROTONOSUPPORT ENFILE kernel EMFILE EACCES EINVAL ENOBUFS raw
projects / gapil.git / blobdiff