questa opzione ciascun capo della connessione annuncia all'altro il massimo
ammontare di dati che vorrebbe accettare per ciascun segmento nella
connessione corrente. È possibile leggere e scrivere questo valore
- attraverso l'opzione del socket \macro{TCP\_MAXSEG}.
+ attraverso l'opzione del socket \const{TCP\_MAXSEG}.
\item \textit{window scale option}; come spiegato in \capref{cha:tcp_protocol}
il protocollo TCP implementa il controllo di flusso attraverso una
\begin{figure}[!htb]
\centering
- \includegraphics[width=10cm]{img/port_alloc}
+ \includegraphics[width=15cm]{img/port_alloc}
\caption{Allocazione dei numeri di porta}
\label{fig:TCPel_port_alloc}
\end{figure}
posto in ascolto per connessioni provenienti da uno qualunque degli indirizzi
associati alle interfacce locali; la notazione 0.0.0.0 usata da netstat è
equivalente all'asterisco utilizzato per il numero di porta ed indica il
-valore generico, e corrisponde al valore \macro{INADDR\_ANY} definito in
+valore generico, e corrisponde al valore \const{INADDR\_ANY} definito in
\file{arpa/inet.h}.
Inoltre la porta e l'indirizzo di ogni eventuale connessione esterna non sono
\begin{prototype}{sys/socket.h}
{int bind(int sockfd, const struct sockaddr *serv\_addr, socklen\_t addrlen)}
- Il primo argomento è un file descriptor ottenuto da una precedente chiamata
- a \func{socket}, mentre il secondo e terzo argomento sono rispettivamente
- l'indirizzo (locale) del socket e la dimensione della struttura che lo
- contiene, secondo quanto già trattato in \secref{sec:sock_sockaddr}.
+ Assegna un indirizzo ad un socket.
\bodydesc{La funzione restituisce zero in caso di successo e -1 per un
errore; in caso di errore la variabile \var{errno} viene impostata secondo
i seguenti codici di errore:
\begin{errlist}
- \item[\macro{EBADF}] il file descriptor non è valido.
- \item[\macro{EINVAL}] il socket ha già un indirizzo assegnato.
- \item[\macro{ENOTSOCK}] il file descriptor non è associato ad un socket.
- \item[\macro{EACCESS}] si è cercato di usare una porta riservata senza
- sufficienti privilegi.
+ \item[\errcode{EBADF}] il file descriptor non è valido.
+ \item[\errcode{EINVAL}] il socket ha già un indirizzo assegnato.
+ \item[\errcode{ENOTSOCK}] il file descriptor non è associato ad un socket.
+ \item[\errcode{EACCES}] si è cercato di usare una porta riservata senza
+ sufficienti privilegi.
\end{errlist}}
\end{prototype}
+Il primo argomento è un file descriptor ottenuto da una precedente chiamata a
+\func{socket}, mentre il secondo e terzo argomento sono rispettivamente
+l'indirizzo (locale) del socket e la dimensione della struttura che lo
+contiene, secondo quanto già trattato in \secref{sec:sock_sockaddr}.
+
Con il TCP la chiamata \func{bind} permette di specificare l'indirizzo, la
porta, entrambi o nessuno dei due. In genere i server utilizzano una porta
nota che assegnano all'avvio, se questo non viene fatto è il kernel a
viene registrata presso il \textit{portmapper}; quest'ultimo è un altro
demone che deve essere contattato dai client per ottenere la porta effimera
su cui si trova il server.} che in genere viene identificato dalla porta su
-cui risponde.
+cui risponde (l'elenco di queste porte, e dei relativi servizi, è in
+\file{/etc/services}).
Con \func{bind} si può assegnare un IP specifico ad un socket, purché questo
appartenga ad una interfaccia della macchina. Per un client TCP questo
client.
Per specificare un indirizzo generico con IPv4 si usa il valore
-\macro{INADDR\_ANY}, il cui valore, come visto anche negli esempi precedenti
+\const{INADDR\_ANY}, il cui valore, come visto anche negli esempi precedenti
è pari a zero, nell'esempio \figref{fig:net_serv_code} si è usata
un'assegnazione immediata del tipo:
-\footnotesize
\begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
- serv_add.sin_addr.s_addr = htonl(INADDR_ANY); /* connect from anywhere */
+serv_add.sin_addr.s_addr = htonl(INADDR_ANY); /* connect from anywhere */
\end{lstlisting}
-\normalsize
Si noti che si è usato \func{htonl} per assegnare il valore
-\macro{INADDR\_ANY}; benché essendo questo pari a zero il riordinamento sia
-inutile; ma dato che tutte le costanti \macro{INADDR\_} sono definite
-secondo l'ordinamento della macchina è buona norma usare sempre la funzione
-\macro{htonl}.
-
-L'esempio precedete funziona con IPv4 dato che l'indirizzo è rappresentabile
-anche con un intero a 32 bit; non si può usare lo stesso metodo con IPv6,
-in cui l'indirizzo è specificato come struttura, perché il linguaggio C non
-consente l'uso di una struttura costante come operando a destra in una
-assegnazione.
-
-Per questo nell'header \file{netinet/in.h} è definita una variabile
+\const{INADDR\_ANY}, benché essendo questo pari a zero il riordinamento sia
+inutile. Si tenga presente comunque che tutte le costanti \val{INADDR\_}
+(riportate in ) sono definite secondo l'ordinamento della macchina, ed anche
+se esse possono essere invarianti rispetto all'ordinamento, è comunque buona
+norma usare sempre la funzione \func{htonl}.
+
+\begin{table}[htb]
+ \centering
+ \footnotesize
+ \begin{tabular}[c]{|l|l|}
+ \hline
+ \textbf{Costante} & \textbf{Significato} \\
+ \hline
+ \hline
+ \const{INADDR\_ANY} & Indirizzo generico (\texttt{0.0.0.0})\\
+ \const{INADDR\_BROADCAST}& Indirizzo di \textit{broadcast}.\\
+ \const{INADDR\_LOOPBACK} & Indirizzo di \textit{loopback}
+ (\texttt{127.0.0.1}).\\
+ \const{INADDR\_NONE} & Indirizzo errato.\\
+ \hline
+ \end{tabular}
+ \caption{Costanti di definizione di alcuni indirizzi generici per IPv4.}
+ \label{tab:TCPel_ipv4_addr}
+\end{table}
+
+L'esempio precedente funziona correttamente con IPv4 poiché che l'indirizzo è
+rappresentabile anche con un intero a 32 bit; non si può usare lo stesso
+metodo con IPv6, in cui l'indirizzo deve necessariamente essere specificato
+con una struttura, perché il linguaggio C non consente l'uso di una struttura
+costante come operando a destra in una assegnazione.
+
+Per questo motivo nell'header \file{netinet/in.h} è definita una variabile
\type{in6addr\_any} (dichiarata come \ctyp{extern}, ed inizializzata dal
-sistema al valore \macro{IN6ADRR\_ANY\_INIT}) che permette di effettuare una
-assegnazione del tipo:
+sistema al valore \const{IN6ADRR\_ANY\_INIT}) che permette di effettuare una
+assegnazione del tipo:
-\footnotesize
\begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
- serv_add.sin6_addr = in6addr_any; /* connect from anywhere */
+serv_add.sin6_addr = in6addr_any; /* connect from anywhere */
\end{lstlisting}
-\normalsize
\subsection{La funzione \func{connect}}
\begin{prototype}{sys/socket.h}
{int connect(int sockfd, const struct sockaddr *servaddr, socklen\_t addrlen)}
- Il primo argomento è un file descriptor ottenuto da una precedente chiamata
- a \func{socket}, mentre il secondo e terzo argomento sono rispettivamente
- l'indirizzo e la dimensione della struttura che contiene l'indirizzo del
- socket, già descritta in \secref{sec:sock_sockaddr}.
+ Stabilisce una connessione fra due socket.
\bodydesc{La funzione restituisce zero in caso di successo e -1 per un
- errore, in caso di errore la variabile \var{errno} viene impostata secondo
- i seguenti codici di errore:
+ errore, in caso di errore \var{errno} assumerà i valori:
\begin{errlist}
- \item[\macro{ECONNREFUSED}] non c'è nessuno in ascolto sull'indirizzo remoto.
- \item[\macro{ETIMEDOUT}] si è avuto timeout durante il tentativo di
+ \item[\errcode{ECONNREFUSED}] non c'è nessuno in ascolto sull'indirizzo
+ remoto.
+ \item[\errcode{ETIMEDOUT}] si è avuto timeout durante il tentativo di
connessione.
- \item[\macro{ENETUNREACH}] la rete non è raggiungibile.
- \item[\macro{EINPROGRESS}] il socket è non bloccante (vedi
+ \item[\errcode{ENETUNREACH}] la rete non è raggiungibile.
+ \item[\errcode{EINPROGRESS}] il socket è non bloccante (vedi
\secref{sec:file_noblocking}) e la connessione non può essere conclusa
immediatamente.
- \item[\macro{EALREADY}] il socket è non bloccante (vedi
+ \item[\errcode{EALREADY}] il socket è non bloccante (vedi
\secref{sec:file_noblocking}) e un tentativo precedente di connessione non
si è ancora concluso.
- \item[\macro{EAGAIN}] non ci sono più porte locali libere.
- \item[\macro{EAFNOSUPPORT}] l'indirizzo non ha una famiglia di indirizzi
+ \item[\errcode{EAGAIN}] non ci sono più porte locali libere.
+ \item[\errcode{EAFNOSUPPORT}] l'indirizzo non ha una famiglia di indirizzi
corretta nel relativo campo.
- \item[\macro{EACCESS, EPERM}] si è tentato di eseguire una connessione ad un
- indirizzo broadcast senza che il socket fosse stato abilitato per il
- broadcast.
+ \item[\errcode{EACCES}, \errcode{EPERM}] si è tentato di eseguire una
+ connessione ad un indirizzo broadcast senza che il socket fosse stato
+ abilitato per il broadcast.
\end{errlist}
- altri errori possibili sono: \macro{EFAULT}, \macro{EBADF},
- \macro{ENOTSOCK}, \macro{EISCONN} e \macro{EADDRINUSE}.}
+ altri errori possibili sono: \errval{EFAULT}, \errval{EBADF},
+ \errval{ENOTSOCK}, \errval{EISCONN} e \errval{EADDRINUSE}.}
\end{prototype}
+Il primo argomento è un file descriptor ottenuto da una precedente chiamata a
+\func{socket}, mentre il secondo e terzo argomento sono rispettivamente
+l'indirizzo e la dimensione della struttura che contiene l'indirizzo del
+socket, già descritta in \secref{sec:sock_sockaddr}.
+
La struttura dell'indirizzo deve essere inizializzata con l'indirizzo IP e il
numero di porta del server a cui ci si vuole connettere, come mostrato
nell'esempio \secref{sec:net_cli_sample} usando le funzioni illustrate in
seguenti:
\begin{enumerate}
\item Il client non riceve risposta al SYN: l'errore restituito è
- \macro{ETIMEDOUT}. Stevens riporta che BSD invia un primo SYN alla chiamata
+ \errcode{ETIMEDOUT}. Stevens riporta che BSD invia un primo SYN alla chiamata
di \func{connect}, un'altro dopo 6 secondi, un terzo dopo 24 secondi, se
dopo 75 secondi non ha ricevuto risposta viene ritornato l'errore. Linux
invece ripete l'emissione del SYN ad intervalli di 30 secondi per un numero
che vuol dire probabilmente che o si è sbagliato il numero della porta o che
non è stato avviato il server), questo è un errore fatale e la funzione
ritorna non appena il RST viene ricevuto riportando un errore
- \macro{ECONNREFUSED}.
+ \errcode{ECONNREFUSED}.
Il flag RST sta per \textit{reset} ed è un segmento inviato direttamente
dal TCP quando qualcosa non va. Tre condizioni che generano un RST sono:
essere dovuto ad una condizione transitoria si ripete l'emissione dei SYN
come nel caso precedente, fino al timeout, e solo allora si restituisce il
codice di errore dovuto al messaggio ICMP, che da luogo ad un
- \macro{ENETUNREACH}.
+ \errcode{ENETUNREACH}.
\end{enumerate}
chiamata ad \func{accept}. Il prototipo della funzione come definito dalla
pagina di manuale è:
\begin{prototype}{sys/socket.h}{int listen(int sockfd, int backlog)}
- La funzione pone il socket specificato da \var{sockfd} in modalità
- passiva e predispone una coda per le connessioni in arrivo di lunghezza pari
- a \var{backlog}. La funzione si può applicare solo a socket di tipo
- \macro{SOCK\_STREAM} o \macro{SOCK\_SEQPACKET}.
+ Pone un socket in attesa di una connessione.
\bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
errore. I codici di errore restituiti in \var{errno} sono i seguenti:
\begin{errlist}
- \item[\macro{EBADF}] l'argomento \var{sockfd} non è un file descriptor
+ \item[\errcode{EBADF}] l'argomento \var{sockfd} non è un file descriptor
valido.
- \item[\macro{ENOTSOCK}] l'argomento \var{sockfd} non è un socket.
- \item[\macro{EOPNOTSUPP}] il socket è di un tipo che non supporta questa
+ \item[\errcode{ENOTSOCK}] l'argomento \var{sockfd} non è un socket.
+ \item[\errcode{EOPNOTSUPP}] il socket è di un tipo che non supporta questa
operazione.
\end{errlist}}
\end{prototype}
+La funzione pone il socket specificato da \var{sockfd} in modalità passiva e
+predispone una coda per le connessioni in arrivo di lunghezza pari a
+\var{backlog}. La funzione si può applicare solo a socket di tipo
+\const{SOCK\_STREAM} o \const{SOCK\_SEQPACKET}.
Il parametro \var{backlog} indica il numero massimo di connessioni pendenti
-accettate; se esso viene ecceduto il client riceverà una errore di tipo
-\macro{ECONNREFUSED}, o se il protocollo, come nel caso del TCP, supporta la
-ritrasmissione, la richiesta sarà ignorata in modo che la connessione possa
-essere ritentata.
+accettate; se esso viene ecceduto il client al momento della richiesta della
+connessione riceverà un errore di tipo \errcode{ECONNREFUSED}, o se il
+protocollo, come accade nel caso del TCP, supporta la ritrasmissione, la
+richiesta sarà ignorata in modo che la connessione possa venire ritentata.
Per capire meglio il significato di tutto ciò occorre approfondire la modalità
con cui il kernel tratta le connessioni in arrivo. Per ogni socket in ascolto
protezione dei syncookies però (con l'opzione da compilare nel kernel e da
attivare usando \file{/proc/sys/net/ipv4/tcp\_syncookies}) questo valore
viene ignorato e non esiste più un valore massimo. In ogni caso in Linux il
-valore di \var{backlog} viene troncato ad un massimo di \macro{SOMAXCONN}
+valore di \var{backlog} viene troncato ad un massimo di \const{SOMAXCONN}
se è superiore a detta costante (che di default vale 128).
La scelta storica per il valore di questo parametro è di 5, e alcuni vecchi
viene messo in attesa. Il prototipo della funzione è il seguente:
\begin{prototype}{sys/socket.h}
{int accept(int sockfd, struct sockaddr *addr, socklen\_t *addrlen)}
- Estrae la prima connessione relativa al socket \var{sockfd}
- in attesa sulla coda delle connessioni complete, che associa ad nuovo socket
- con le stesse caratteristiche di \var{sockfd} (restituito dalla funzione
- stessa). Il socket originale non viene toccato. Nella struttura
- \var{addr} e nella variabile \var{addrlen} vengono restituiti
- indirizzo e relativa lunghezza del client che si è connesso.
+ Accetta una connessione sul socket specificato.
+
\bodydesc{La funzione restituisce un numero di socket descriptor positivo in
caso di successo e -1 in caso di errore, nel qual caso la variabile
\var{errno} viene impostata ai seguenti valori:
\begin{errlist}
- \item[\macro{EBADF}] l'argomento \var{sockfd} non è un file descriptor
+ \item[\errcode{EBADF}] l'argomento \var{sockfd} non è un file descriptor
valido.
- \item[\macro{ENOTSOCK}] l'argomento \var{sockfd} non è un socket.
- \item[\macro{EOPNOTSUPP}] il socket è di un tipo che non supporta questa
- operazione.
- \item[\macro{EAGAIN} o \macro{EWOULDBLOCK}] il socket è stato impostato come
- non bloccante (vedi \secref{sec:file_noblocking}), e non ci sono
+ \item[\errcode{ENOTSOCK}] l'argomento \var{sockfd} non è un socket.
+ \item[\errcode{EOPNOTSUPP}] il socket è di un tipo che non supporta questa
+ operazione.
+ \item[\errcode{EAGAIN} o \errcode{EWOULDBLOCK}] il socket è stato impostato
+ come non bloccante (vedi \secref{sec:file_noblocking}), e non ci sono
connessioni in attesa di essere accettate.
- \item[\macro{EPERM}] Le regole del firewall non consentono la connessione.
- \item[\macro{ENOBUFS, ENOMEM}] questo spesso significa che l'allocazione
- della memoria è limitata dai limiti sui buffer dei socket, non dalla
- memoria di sistema.
+ \item[\errcode{EPERM}] Le regole del firewall non consentono la connessione.
+ \item[\errcode{ENOBUFS}, \errcode{ENOMEM}] questo spesso significa che
+ l'allocazione della memoria è limitata dai limiti sui buffer dei socket,
+ non dalla memoria di sistema.
\end{errlist}
Inoltre possono essere restituiti gli errori di rete relativi al nuovo
- socket come: \macro{EMFILE}, \macro{EINVAL}, \macro{ENOSR}, \macro{ENOBUFS},
- \macro{EFAULT}, \macro{EPERM}, \macro{ECONNABORTED},
- \macro{ESOCKTNOSUPPORT}, \macro{EPROTONOSUPPORT}, \macro{ETIMEDOUT},
- \macro{ERESTARTSYS}.}
+ socket come: \errval{EMFILE}, \errval{EINVAL}, \errval{ENOSR},
+ \errval{ENOBUFS}, \errval{EFAULT}, \errval{EPERM}, \errval{ECONNABORTED},
+ \errval{ESOCKTNOSUPPORT}, \errval{EPROTONOSUPPORT}, \errval{ETIMEDOUT},
+ \errval{ERESTARTSYS}.}
\end{prototype}
+Estrae la prima connessione relativa al socket \var{sockfd} in attesa sulla
+coda delle connessioni complete, che associa ad nuovo socket con le stesse
+caratteristiche di \var{sockfd} (restituito dalla funzione stessa). Il socket
+originale non viene toccato. Nella struttura \var{addr} e nella variabile
+\var{addrlen} vengono restituiti indirizzo e relativa lunghezza del client che
+si è connesso.
+
La funzione può essere usata solo con socket che supportino la connessione
-(cioè di tipo \macro{SOCK\_STREAM}, \macro{SOCK\_SEQPACKET} o
-\macro{SOCK\_RDM}). Per alcuni protocolli che richiedono una conferma
+(cioè di tipo \const{SOCK\_STREAM}, \const{SOCK\_SEQPACKET} o
+\const{SOCK\_RDM}). Per alcuni protocolli che richiedono una conferma
esplicita della connessione, (attualmente in Linux solo DECnet ha questo
comportamento), la funzione opera solo l'estrazione dalla coda delle
connessioni, la conferma della connessione viene fatta implicitamente dalla
errori rispetto ad altre implementazioni dei socket BSD, infatti la funzione
\func{accept} passa gli errori di rete pendenti sul nuovo socket come codici
di errore per \func{accept}. Inoltre la funzione non fa ereditare ai nuovi
-socket flag come \macro{O\_NONBLOCK}, che devono essere rispecificati volta
+socket flag come \const{O\_NONBLOCK}, che devono essere rispecificati volta
volta, questo è un comportamento diverso rispetto a quanto accade con BSD e
deve essere tenuto in conto per scrivere programmi portabili.
cui indirizzo è passato come argomento in \var{cliaddr}, al ritorno della
funzione \var{addrlen} conterrà il numero di byte scritti dentro
\var{cliaddr}. Se questa informazione non interessa basterà inizializzare a
-\macro{NULL} detti puntatori.
+\val{NULL} detti puntatori.
Se la funzione ha successo restituisce il descrittore di un nuovo socket
creato dal kernel (detto \textit{connected socket}) a cui viene associata la
dalla funzione. Se non ci sono connessioni pendenti da accettare la funzione
mette in attesa il processo\footnote{a meno che non si sia imopstato il socket
per essere non bloccante (vedi \secref{sec:file_noblocking}), nel qual caso
- ritorna con l'errore \macro{EAGAIN}. Torneremo su questa modalità di
+ ritorna con l'errore \errcode{EAGAIN}. Torneremo su questa modalità di
operazione in \secref{sec:xxx_sock_noblock}.} fintanto che non ne arriva
una.
\bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
errore. I codici di errore restituiti in \var{errno} sono i seguenti:
\begin{errlist}
- \item[\macro{EBADF}] l'argomento \var{sockfd} non è un file descriptor
+ \item[\errcode{EBADF}] l'argomento \var{sockfd} non è un file descriptor
valido.
- \item[\macro{ENOTSOCK}] l'argomento \var{sockfd} non è un socket.
- \item[\macro{ENOBUFS}] non ci sono risorse sufficienti nel sistema per
+ \item[\errcode{ENOTSOCK}] l'argomento \var{sockfd} non è un socket.
+ \item[\errcode{ENOBUFS}] non ci sono risorse sufficienti nel sistema per
eseguire l'operazione.
- \item[\macro{EFAULT}] l'argomento \var{name} punta al di fuori dello
+ \item[\errcode{EFAULT}] l'argomento \var{name} punta al di fuori dello
spazio di indirizzi del processo.
\end{errlist}}
\end{prototype}
\bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di
errore. I codici di errore restituiti in \var{errno} sono i seguenti:
\begin{errlist}
- \item[\macro{EBADF}] l'argomento \var{sockfd} non è un file descriptor
+ \item[\errcode{EBADF}] l'argomento \var{sockfd} non è un file descriptor
valido.
- \item[\macro{ENOTSOCK}] l'argomento \var{sockfd} non è un socket.
- \item[\macro{ENOTCONN}] il socket non è connesso.
- \item[\macro{ENOBUFS}] non ci sono risorse sufficienti nel sistema per
+ \item[\errcode{ENOTSOCK}] l'argomento \var{sockfd} non è un socket.
+ \item[\errcode{ENOTCONN}] il socket non è connesso.
+ \item[\errcode{ENOBUFS}] non ci sono risorse sufficienti nel sistema per
eseguire l'operazione.
- \item[\macro{EFAULT}] l'argomento \var{name} punta al di fuori dello
+ \item[\errcode{EFAULT}] l'argomento \var{name} punta al di fuori dello
spazio di indirizzi del processo.
\end{errlist}}
\end{prototype}
projects / gapil.git / blobdiff