OSDN Git Service

v27
[android-x86/external-wireless-tools.git] / wireless_tools / README.fr
1         Wireless Tools
2         --------------
3
4         Ce paquetage contient les Wireless Tools (Outils Wireless), utilisé pour
5 manipuler les Wireless Extensions. Les Wireless Extensions sont une interface
6 vous permettant de manier les paramètres spécifiques aux Wireless LAN (réseaux
7 sans fil) et d'obtenir les statistiques spécifiques.
8
9 page web :
10 --------
11         Vous trouverez beaucoup d'informations utiles sur :
12                 http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Tools.html
13                 http://web.hpl.hp.com/personal/Jean_Tourrilhes/Linux/
14
15 version pré compilée
16 --------------------
17         La plupart des distributions Linux fournit un paquetage pré compilé
18 contenant ces outils. Et beaucoup d'entre elles les pré installent par défaut.
19 Par ailleurs, l'installation de ce paquetage est (maintenant) facile et vous
20 permet d'obtenir une version plus à jour.
21
22 INSTALL
23 -------
24         Ce fichier contient les instructions et les requis pour l'installation.
25         *Doit* être lu.
26
27 DISTRIBUTION.txt
28 ----------------
29         Ce fichier documente la manière de configurer les cartes wireless au
30 démarrage avec différentes distributions Linux (en utilisant les Wireless
31 Extensions). Veuillez le lire attentivement avant de poser des questions.
32         Dans ce fichier, j'essaye de rassembler toutes les spécificités de
33 l'intégration des Wireless Extensions dans les ditributions Linux les plus
34 courantes. J'ai besoin de votre aide pour compléter ce fichier.
35
36 HOTPLUG.txt
37 -----------
38         Ce fichier documente la manière de gérer et configurer les cartes
39 wireless éjectables utilisant Hotplug. Il est plus avancé que les simples
40 procédures de DISTRIBUTIONS.txt. Pour l'instant, il est principalement orienté
41 Debian, mais j'espère que vous contribuerez pour d'autres distributions.
42
43 PCMCIA.txt
44 ----------
45         Ce fichier décrit comment utiliser le script init PCMCIA pour configurer
46 les Wireless Extensions et comment utiliser les schemes PCMCIA (NDT : procédures
47 automatiques).
48
49 pages man (iwconfig.8, iwlist.8, iwpriv.8, iwspy.8)
50 ---------
51         TRÈS IMPORTANT : J'essaye de garder les pages man à jour, ainsi vous
52 devriez les lire avant de poser des questions.
53         TRÈS IMPORTANT : Ces pages man décrivent les fonctionnalités des outils,
54 pas un périphérique n'en implémente toute l'étendue (et les pilotes en
55 implémentent souvent encore moins).
56
57         Pour autant que je sache, les pages man constituent la plus complète, la
58 plus à jour et la plus précise des documentations des Wireless Tools. Une mise
59 à jour de la page web concernant les Wireless Extensions a été faite il y a fort
60 longtemps. Envoyez-moi vos retours.
61
62         Les pages man peuvent aussi bien être copiées dans un endroit où la
63 commande « man » les trouvera, comme /usr/local/man/man8, ou peut être lue
64 localement avec la commande :
65                 nroff -man xxx.8 | less
66 (NDT : ou plus simplement avec « man ./xxx.8 »)
67
68 pages man localisées (fr/*)
69 --------------------
70         Les pages de man localisées ne sont pas écrites par moi (NDT\ : ainsi
71 que ce document), par conséquent les seules disponibles sont celles qui me sont
72 envoyées par de courageux volontaires et il faut s'attendre à ce que ces pages
73 man soient en décalage par rapport à la version anglaise (c.-à-d. qu'elles
74 n'aient pas toutes les mises à jour). La traduction des pages man n'est pas une
75 tâche très gratifiante, sans compter mon anglais bancal et un certain nombre
76 de termes techniques difficilement traduisibles vers d'autres langues, donc
77 référez-vous à la version anglaise en cas de doute.
78
79 iwconfig.c
80 ----------
81         L'outil wireless principal. Utilisé pour la configuration du matériel et
82 pour voir les paramètres wireless les plus communs.
83
84 iwlist.c
85 --------
86         Affiche une grosse quantité d'information qui ne l'est pas par iwconfig.
87         Par exemple, tous les débits, toutes les fréquences, toutes les clefs...
88
89 iwspy.c
90 -------
91         Test de support Mobile IP et autorise la récupération de statistiques
92 par adresse MAC (au lieu des stats globales). Aussi, pour certains
93 pilotes/périphériques, c'est la seule manière d'obtenir des stats en mode
94 Ad-Hoc.
95
96 iwpriv.c
97 --------
98         Manipule les ioctls privées des pilotes (« driver private ioctls ») :
99 tous les paramètres qui sont spécifiques à un pilote ou à un périphérique et
100 qui, par conséquent, ne font pas partie de iwconfig.
101
102 iwgetid.c
103 ---------
104         Affiche l'ESSID ou le NWID du périphérique spécifié.
105         Peut aussi l'afficher dans un format pouvant être utilisé comme un
106 « PCMCIA Scheme ».
107
108 iwevent.c
109 ---------
110         Affiche les « Wireless Events » (Événements Wireless). Cela est
111 nouveau, il n'y a donc pas encore beaucoup de pilotes qui le supportent...
112
113 ifrename.c :
114 ----------
115         Renomme les interfaces réseau basées sur différents attributs.
116
117 iwlib.c
118 -------
119         Les librairies « helper » Wireless Tools. Peuvent être utiles si vous
120 voulez créer votre propre application en utilisant les Wireless Extensions.
121
122 Changelog, contributions :
123 ------------------------
124         Voir CHANGELOG.h
125
126 wireless.h
127 ----------
128         Définition des Wireless Extensions. Gardez à l'esprit que la définition
129 utilisée par les pilotes et les outils (Wireless Tools) doivent correspondre,
130 sinon de drôles de choses peuvent arriver. Les outils essayent de le vérifier.
131         Depuis les Wireless Extensions v12, vous ne pouvez plus mettre ce
132 fichier dans les entêtes de votre noyau pour mettre à jour les Wireless
133 Extensions, vous avez besoin d'utiliser les patches complets disponibles sur ma
134 page web. Donc, son utilité est plus pour le cas où vous prévoyez de faire de
135 la compilation transverse (if you plan to do some « cross compile ») ou quelque
136 chose de similaire.
137 Juste pour votre plaisir, il y en a différentes versions. Si vos noyau/pilotes
138 sont anciens, vous voudrez peut-être essayer les anciennes versions...
139
140 sample_xxx.c :
141 ------------
142         Différents échantillons de code montrant comment implémenter quelques
143 unes des caractéristiques les plus intéressantes des Wireless Extensions dans
144 votre pilote.
145         Notez qu'il n'y a pas d'assurance que ce code compile, laissez-le tel
146 quel, mais cela devrait vous orienter dans la bonne direction.
147         Aussi, jetez un ½il aux pilotes existant dans le noyau Linux.
148
149 Autres outils :
150 -------------
151         Ma page web liste bien d'autres outils utilisant les Wireless
152 Extensions que vous pourriez trouver utiles...
153         http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Tools.html#links
154
155 Autres questions :
156 ----------------
157         Vous avez le source, et il est documenté. Dans 99% des cas, vous y
158 trouverez votre réponse.
159
160         Bonne chance...
161
162         Jean <jt@hpl.hp.com>