File: ipv6.7

package info (click to toggle)
manpages-fr 0.9.3-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 7,052 kB
  • ctags: 4
  • sloc: makefile: 58; sh: 8
file content (272 lines) | stat: -rw-r--r-- 9,344 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
.\" This man page is Copyright (C) 2000 Andi Kleen <ak@muc.de>.
.\" Permission is granted to distribute possibly modified copies
.\" of this page provided the header is included verbatim,
.\" and in case of nontrivial modification author and date
.\" of the modification is added to the header.
.\" $Id: ipv6.7,v 1.3 2000/12/20 18:10:31 ak Exp $
.\" Traduction Christophe Blaess <ccb@club-internet.fr> 
.\" 11/06/2001 - LDP-man-pages-1.37
.TH IPV6 7 "11 juin 2001" Linux "Manuel de l'administrateur Linux"
.SH NOM
ipv6, PF_INET6 \- Impl�mentation Linux du protocole IPv6
.SH SYNOPSIS
.B #include <sys/socket.h>
.br
.B #include <netinet/in.h> 
.sp
.sp
.IB tcp6_socket " = socket(PF_INET6, SOCK_STREAM, 0);"
.br 
.IB raw6_socket " = socket(PF_INET6, SOCK_RAW, " protocol ");"
.br
.IB udp6_socket " = socket(PF_INET6, SOCK_DGRAM, " protocol ");"
.SH DESCRIPTION
Linux 2.2 impl�mente en option le protocole internet version 6 (IPv6).
Cette page de manuel contient la description de l'API IPv6 de base, telle
qu'impl�ment�e dans le noyau Linux et la GlibC 2.1 L'interface est 
bas�e sur l'interface des sockets BSD. Voir
.BR socket (7). 
.PP
L'API IPv6 est con�ue pour �tre essentiellement compatible avec l'API
.BR ip (7) 
v4. Seules les diff�rences sont d�crites dans cette page de manuel.
.PP
pour attacher une socket
.IR AF_INET6 ,
l'adresse locale doit �tre copi�e dans une variable
.B in6addr_any
qui a le
type
.IR in6_addr .
Dans les initialisations statiques,
.B IN6ADDR_ANY_INIT
peut servir aussi et se d�veloppe en une expression constante.
may also be used, which expands to a constant expression.
Toutes les valeurs sont dans l'ordre des octets du r�seau.
.PP
L'adresse de boucle IPv6 (::1) est disponible dans la variable globale
.BR in6addr_loopback .
Pour les initialisation, on doit
utiliser
.BR IN6ADDR_LOOPBACK_INIT .
.PP
Les connexions IPv4 peuvent �tre trait�e avec l'API v6 en utilisant le type d'adresse
v4-projet�-dans-v6. Ainsi un programme n'a qu'un seul type d'API � utiliser pour
supporter les deux protocoles. Ceci est g�r� de mani�re transparente par les fonctions
d'adressage de la LibC.
.PP
IPv4 et IPv6 partagent l'espace des ports locaux. Lorsqu'une connection IPv4 ou un paquet 
est obtenu sur une socket IPv6, son adresse source sera projet�e
en v6.
.SH "FORMAT D'ADRESSE"
.sp
.RS
.nf
.ta 4n 5n 20n
struct sockaddr_in6 {
	u_int16_t	sin6_family;	/* AF_INET6 */
	u_int16_t	sin6_port;	/* num�ro port */
	u_int32_t	sin6_flowinfo;	/* information flux IPv6 */
	struct in6_addr	sin6_addr;	/* adresse IPv6 */
	u_int32_t   sin6_scope_id;  /* Scope id (nouveaut� 2.4) */ 
};

struct in6_addr {
	unsigned char	s6_addr[16];	/* adresse IPv6 */
};
.ta
.fi
.RE
.sp
.B sin6_family 
est toujours rempli avec 
.BR AF_INET6 " ;"
.B sin6_port 
est le port du protocole (voir
.B sin_port
dans
.BR ip (7));
.B sin6_flowinfo
est l'identificateur de flux IPv6,
.B sin6_addr
est l'adresse IPv6 sur 128 bits.
.B sin6_scope_id 
est un identificateur qui d�pend de la port�e de l'adresse. C'est une nouveaut� Linux 2.4.
Linux ne le supporte que pour les adresse ayant une port�e liaison, dans ce cas
.I sin6_scope_id
contient le num�ro d'interface (voir
.BR netdevice (7))
.PP
IPv6 supporte plusieurs types d'adresses : unicast pour repr�senter un h�te unique,
multicast pour un groupe d'h�te, anycast pour indiquer le membre le plus proche d'un
groupe d'h�te (non impl�ment� sous Linux), IPv4-on-IPv6 pour un h�te
IPv4, et d'autres types d'adresse r�serv�s.
.PP
La notation d'adresse pour l'IPv6 est un groupe de 16 nombres hexad�cimaux sur 2 chiffres,
s�par�s par un deux-points `:'. Un `::' repr�sente une cha�ne de z�ros. Les adresses sp�ciales
sont ::1 pour le bouclage loopback et FFFF::<adresse IPv4> pour les projections d'adresses IPv4
sur l'IPv6.
.PP
L'espace des ports de l'IPv6 est partag� avec l'IPv4.
.SH "OPTIONS DES SOCKETS"
IPv6 supporte quelques options des sockets sp�cifiques du protocole, qui peuvent �tre fix�es avec
.BR setsockopt (2)
et consult�es avec
.BR getsockopt (2).
Le niveau d'option de socket pour l'IPv6 est
.BR IPPROTO_IPV6 .
Un entier bool�en est faux quand il est nul et vrai sinon.
.TP
.B IPV6_UNICAST_HOPS
Fixe la limite du nombre de sauts (hops) unicast. L'argument est un pointeur sur un entier.
La valeur \-1 correspond � la valeur par d�faut de routage, sinon il doit s'agir
d'un entier entre 0 et 255.
.TP
.B IPV6_MULTICAST_HOPS
Fixe la limite du nombre de sauts (hops) multicast. L'argument est un pointeur sur un entier.
La valeur \-1 correspond � la valeur par d�faut de routage, sinon il doit s'agir
d'un entier entre 0 et 255.
.TP 
.B IPV6_MULTICAST_IF
Fixe le p�riph�rique pour les paquets multicasts sortants de la socket.
Ceci n'est permis
que pour les
sockets
.I SOCK_DGRAM
et
.IR SOCK_RAW .
L'argument est un pointeur sur un num�ro d'interface (voir
.BR netdevice (7))
dans un entier.
.TP
.B IPV6_ADDRFORM
Transformer une socket
.I AF_INET6
en une socket d'une famille d'adresse diff�rente. Seul
.I AF_INET
est actuellement support� pour cela. Cela n'est autoris� que pour les sockets
IPv6 connect�es et attach�es � une adresse v4-sur-v6. L'argument est un pointeur
sur un entier contenan
.B AF_INET. 
Cela est utile pour passer des sockets projet�es en v4 comme descripteurs � des
programmes ne sachant pas manipuler l'API IPv6.
.TP 
.B IPV6_PKTINFO
Fixe la distribution des messages de contr�le
.B IPV6_PKTINFO 
des datagrammes entrants. Uniquement autoris� pour les sockets
.B SOCK_DGRAM
ou
.BR SOCK_RAW .
L'argument est un pointeur sur une valeur bool�enne dans un entier.
.TP
.nh
.B IPV6_RTHDR, IPV6_AUTHHDR, IPV6_DSTOPS, IPV6_HOPOPTS, IPV6_FLOWINFO, IPV6_HOPLIMIT
.hy
Fixe la distribution des messages de contr�le des datagrammes entrants contenant les
ent�tes d'extensions
.I IPV6_RTHDR
d�livre l'ent�te de routage,
.I IPV6_AUTHHDR
d�livre l'ent�te d'authentification,
.I IPV6_DSTOPTS
d�livre les options de destination,
.I IPV6_HOPOPTS
d�livre les options de saut,
.I IPV6_FLOWINFO
d�livre un entier contenant l'identificateur de flux,
.I IPV6_HOPLIMIT
d�livre un entier contenant le nombre de sauts du paquet.
Les messages de contr�le ont le m�me type que l'option de socket. Toutes ces options
d'ent�te peuvent aussi �tre fix�es pour les paquets sortants en mettant le message
de contr�le appropri� dans le buffer de
.BR sendmsg (2).
Uniquement autoris� pour les sockets
.B SOCK_DGRAM
ou
.B SOCK_RAW
L'argument est un pointeur sur une valeur bool�enne.
.TP
.B IPV6_MULTICAST_LOOP
D�termine si la socket voit les paquets multicast qu'elle a elle-m�me �mis.
L'argument est un pointeur sur une valeur bool�enne.
.TP
.B IPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP
D�termine l'appartenance aux groupes multicast. L'argument est un pointeur sur
une structure
.BR struct ipv6_mreq .
.TP
.B IPV6_MTU
Fixe le MTU � utiliser pour la socket. Le MTU est limit� par celui du p�riph�rique
ou celui du chemin lorsque la recherche du MTU par chemin est activ�e.
L'argument est un pointeur sur un entier.
.TP
.B IPV6_MTU_DISCOVER
Commander la recherche du MTU par chemin sur la socket. Voir l'option
.I IP_MTU_DISCOVER
dans
.BR ip (7)
pour plus de pr�cisions.
.TP
.B IPV6_RECVERR
Commande la r�ception des erreurs asynchrones. Voir
.I IP_RECVERR
dans
.BR ip (7)
pour plus de pr�cisions.
L'argument est un pointeur sur un bool�en.
.TP
.B IPV6_ROUTER_ALERT
Passer sur cette socket tous les paquets redirig�s (forwarded) contenant une option d'alerte du routeur.
Uniquement autoris� pour les sockets datagrammes, et pour roor. L'argument est un pointeur
vers un bool�en.
.\" FLOWLABEL_MGR, FLOWINFO_SEND
.SH VERSIONS
L'ancienne impl�mentatioin IPv6 pour Linux bas�e sur
.I libinet6
de la LibC5 n'est pas d�crite ici, et peut �tre l�g�rement
diff�rente.
.PP
Linux 2.4 rompt la compatibilit� binaire pour la structure sockaddr_in6
des h�tes sur 64 bits, en modifiant l'alignement de
.I in6_addr 
et en ajoutant un champ
.I sin6_scope_id
suppl�mentaire. Les interfaces du noyau restent compatible, mais un programme contenant
des sockaddr_in6 ou des in6_addr dans d'autres structures ne l'est peut �tre pas. Ce n'est
pas un probl�me pour les h�tes sur 32 bits comme les i386.
.PP
Le champ
.B sin6_flowinfo
est une nouveaut� Linux 2.4. Il est �crit/lu de mani�re transparente par le noyau
quand la longueur de l'adresse pass�e le contient. Certains programmes qui passent
un buffer d'adresse plus long et v�rifient ensuite la longueur de l'adresse renvoy�e peuvent �chouer.
.SH "NOTES DE PORTABILIT�"
La structure
.B sockaddr_in6
est plus grande que la structure
.B sockaddr
g�n�rique. Les programmes qui supposent que tous les types d'adresses peuvent �tre stock�s dans une
.B struct sockaddr
doivent �tre modifi�s pour utiliser
.B struct sockaddr_storage
� la place.
.SH BOGUES
L'API IPv6 �tendue, telle que dans la RFC 2292, n'est encore que partiellement impl�ment�e.
Bien que les noyaux 2.2 ont un support pratiquement complet pour les options de r�ception,
les macros d�clarant les options IPv6 manquent dans la GlibC 2.1.
.PP
Le support IPSec pour les ent�tes EH et AH est manquant.
.PP
La gestion des �tiquettes de flux n'est pas compl�te, ni document�e ici.
.PP
Cette page de manuel n'est pas compl�te.
.SH "VOIR AUSSI"
.BR ip (7),
.BR cmsg (3)
.PP
RFC2553: API IPv6 de base, avec laquelle Linux essaye d'�tre compatible.
.PP
RFC2460: Sp�cifications IPv6
.SH TRADUCTION
Christophe Blaess, 2001.