This file is indexed.

/usr/share/doc/HOWTO/fr-html/Token-Ring.html is in doc-linux-fr-html 2013.01-3.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux (vers 25 March 2009), see www.w3.org">
<meta name="GENERATOR" content="LinuxDoc-Tools 0.9.71">
<title>Token-Ring HOWTO</title>
</head>
<body>
<h1>Token-Ring HOWTO</h1>
<h2>Mike Eckhoff
(<code>meckhoff@zaphod.wayne.esu1.k12.ne.us</code>).<br>
<br>
Version fran&ccedil;aise et adaptation&nbsp;: Etienne BERNARD
(<code>eb@via.ecp.fr</code>)<br>
v1.0, 22 Octobre 1996</h2>
Version 3, 5 Juillet 1995
<hr>
<em>L'Ethernet-HOWTO fait r&eacute;f&eacute;rence au driver Token
Ring qui est en cours d'&eacute;criture. Ce Howto a
&eacute;t&eacute; cr&eacute;&eacute; dans le but de vous aider
&agrave; installer le patch pour le noyau et aussi essayer de
mettre en &eacute;vidence les points &agrave; surveiller. Je
sugg&egrave;re que vous lisiez, au moins rapidement, ce document,
avant d'essayer d'installer quelque partie que ce soit du driver
Token Ring pour Linux.</em>
<hr>
<h2><a name="s1">1. Introduction</a></h2>
<h2><a name="ss1.1">1.1 Remerciements</a></h2>
<p>Remerciements &agrave; Mark Swanson, Peter De Schrijver, David
Morris et toutes les autres personnes que j'aurais pu oublier qui
ont rendu possible le support Token Ring pour Linux.</p>
<p>Remerciements aussi &agrave; Larry Sanders
(<code>lsanders@iadfw.net</code>) qui m'a aid&eacute; &agrave;
corriger ce document.</p>
<h2><a name="ss1.2">1.2 Mise en garde</a></h2>
<p>Nous ne garantissons pas que ce Howto sera valable pour votre
syst&egrave;me. De nombreuses personnes l'ont utilis&eacute; avec
de tr&egrave;s bons r&eacute;sultats pour installer Linux sur un
r&eacute;seau Token Ring.</p>
<p>VOUS UTILISEZ CE DOCUMENT A VOS PROPRES RISQUES&nbsp;! ... Nous
ne sommes responsables d'aucun des probl&egrave;mes pouvant vous
arriver en utilisant ce Howto.</p>
<p>Si vous avez un quelconque probl&egrave;me qui n'est pas
signal&eacute; dans ce document, envoyez moi un mail &agrave;
<code>meckhoff@zaphod.wayne.esu1.k12.ne.us</code>.</p>
<p>Ce document est copyright &copy; 1995 Michael Eckhoff. Vous
pouvez faire des copies de ce document (en entier ou certaines
portions du document), sur quelque support physique ou
&eacute;lectronique que ce soit, du moment que cette notice de
copyright soit incluse dans chaque copie. Une redistribution
commerciale est autoris&eacute;e et encourag&eacute;e&nbsp;;
cependant, veuillez me tenir au courant afin que je v&eacute;rifie
que vous avez la derni&egrave;re version.</p>
<h2><a name="s2">2. Exigences mat&eacute;rielles</a></h2>
<p>V&eacute;rifiez que vous avez une carte Token Ring qui est
support&eacute;e par le driver. Jusqu'&agrave; pr&eacute;sent, les
seules cartes support&eacute;es sont celles qui utilisent le
chipset Tropic.</p>
<p>Les cartes qui sont r&eacute;put&eacute;es marcher sous Linux
sont&nbsp;:</p>
<ul>
<li>IBM Token Ring 16/4 Adapter&nbsp;;</li>
<li>IBM Token Ring Adapter&nbsp;;</li>
<li>IBM Token Ring Adapter II (4 M&eacute;gabit
seulement)&nbsp;;</li>
<li>Carte IBM 16/4 ISA Token Ring (16 bit)&nbsp;;</li>
<li>Carte IBM 16/4 ISA Token Ring (8 bit)&nbsp;;</li>
<li>3Com TokenLink Adapter (mode IBM et 3Com)&nbsp;;</li>
<li>HyperRing Classic 16/4.</li>
</ul>
<p>Veuillez noter qu'IBM fabrique une carte <code>IBM Token-Ring
Network 16/4 Adapter II</code>. Cette carte <b>n'est pas reconnue
sous Linux</b>. Il ne faut pas la confondre avec la carte <code>IBM
Token Ring Adapter II (4mbit)</code>, qui elle est
support&eacute;e.</p>
<p>Si vous trouvez une autre carte qui fonctionne sous Linux,
envoyez-moi un mail d&eacute;crivant la marque et le type de la
carte afin que je puisse l'inclure dans la liste
pr&eacute;c&eacute;dente
(<code>meckhoff@zaphod.wayne.esu1.k12.ne.us</code>).</p>
<h2><a name="s3">3. Les logiciels requis</a></h2>
<p>Si vous utilisez une version du noyau Linux de la s&eacute;rie
1.3 ou sup&eacute;rieur, le support pour le Token Ring y est
d&eacute;j&agrave; inclus.</p>
<p>Sinon, je vous encourage vivement &agrave; mettre &agrave; jour
votre noyau Linux vers un de ceux de la s&eacute;rie 2.0 ou
sup&eacute;rieur.</p>
<h2><a name="s4">4. Installation et configuration</a></h2>
<p>Installez la carte Token Ring dans l'ordinateur et configurez-la
pour les r&eacute;glages que vous voulez utiliser. Il est
conseill&eacute; de v&eacute;rifier que la carte fonctionne sous
Dos ou Windows avant d'essayer de l'utiliser sous Linux. Si elle
marche sous Dos ou Windows, il y a de fortes chances pour que cela
marche sous Linux.</p>
<p>Configurez votre noyau Linux pour l'utilisation de la carte
Token Ring.</p>
<blockquote>
<pre>
<code>cd /usr/src/linux
make config
</code>
</pre></blockquote>
<p>R&eacute;pondre ''y'' (yes) &agrave; la question&nbsp;:</p>
<blockquote>
<pre>
<code>Token Ring support (CONFIG_TR) [N/y/?]
</code>
</pre></blockquote>
<p>Ainsi qu'&agrave; la question&nbsp;:</p>
<blockquote>
<pre>
<code>IBM Tropic chipset based adaptor support (CONFIG_IBMTR) [N/y/m/?] (NEW)
</code>
</pre></blockquote>
<p>Reconstruire le noyau avec les commandes&nbsp;:</p>
<blockquote>
<pre>
<code>make dep
make clean
make zImage
</code>
</pre></blockquote>
<p>Il faut ensuite reconfigurer lilo pour d&eacute;marrer sur ce
nouveau noyau. Pour cela, il faut d'abord renommer votre noyau
<code>/vmlinuz</code> en <code>/vmlinuz.old</code> et copier le
nouveau en <code>/vmlinuz</code>. Sur mon syst&egrave;me, cela
revient &agrave; copier
<code>/usr/src/linux/arch/i386/boot/zImage</code> en
<code>/vmlinuz</code> et &agrave; &eacute;diter
<code>/etc/lilo.conf</code> pour d&eacute;marrer sur ce noyau.
N'oubliez pas de lancer lilo (avec la commande <code>lilo</code>)
afin que les changements de noyau soient pris en compte.</p>
<p>Si ce n'est pas d&eacute;j&agrave; fait, lancez le programme
``netconfig'' sur votre syst&egrave;me. Configurez votre machine
comme si celle-ci se trouvait sur un r&eacute;seau Ethernet.</p>
<p>Editez votre fichier <code>/etc/rc.d/rc.inet1</code> (ou un
fichier dans <code>/etc/init.d</code> pour certaines distributions)
et changez toutes les r&eacute;f&eacute;rences &agrave;
<code>eth0</code> en <code>tr0</code>. Vous devriez avoir une ligne
ressemblant &agrave;</p>
<blockquote>
<pre>
<code>/sbin/ifconfig eth0 ${IPADDR} broadcast ${BROADCAST} netmask ${NETMASK}
</code>
</pre></blockquote>
<p>qu'il faut changer en</p>
<blockquote>
<pre>
<code>/sbin/ifconfig tr0 ${IPADDR} broadcast ${BROADCAST} netmask ${NETMASK}
</code>
</pre></blockquote>
<p>Vous devriez maintenant pouvoir rebooter votre syst&egrave;me et
utiliser la carte Token Ring avec votre ordinateur.</p>
<h2><a name="s5">5. Probl&egrave;mes connus</a></h2>
<p>J'ai personnellement eu quelques petits probl&egrave;mes avec ce
driver. Selon Peter De Schrijver, un des probl&egrave;mes
principaux avec ce driver est le routage.</p>
<blockquote>
<pre>
<code>From: Peter de Schrijver &lt;Peter.DeSchrijver@linux.cc.kuleuven.ac.be&gt;

La cause principale du probl&egrave;me est le routage. Si vous ne pouvez pas
atteindre un noeud du r&eacute;seau situ&eacute; derri&egrave;re un pont,
vous avez un probl&egrave;me
de routage. Contactez-moi si vous rencontrez ce probl&egrave;me, et j'essaierai
de faire ce que je peux. Je n'ai pas moi-m&ecirc;me acc&egrave;s &agrave; un
anneau comportant
un pont, il devrait donc &ecirc;tre difficile de r&eacute;soudre le
probl&egrave;me.

Peter.
</code>
</pre></blockquote>
<p>Notre r&eacute;seau, ici, &agrave; la Wayne Community Schools
est constitu&eacute; de deux anneaux et d'un r&eacute;seau Ethernet
dont le pont est r&eacute;alis&eacute; par des IBM 8229. Je n'ai eu
aucun probl&egrave;me de routage avec ces ponts.</p>
<p>J'ai aussi test&eacute; le driver sur un r&eacute;seau
constitu&eacute; de 7 ponts, reli&eacute;s par une combinaison
d'IBM 8229 et d'IBM PC utilisant le logiciel IBM. Aucun
probl&egrave;me l&agrave; non plus.</p>
<h2><a name="s6">6. Questions</a></h2>
<p>Voici quelques questions que j'ai re&ccedil;ues par mail
&agrave; propos du Token Ring sous Linux.</p>
<ul>
<li>Au d&eacute;marrage, j'ai le message
<blockquote>
<pre>
<code>tr0: Can't assign device to adapter
</code>
</pre></blockquote>
Lorsque c'est le seul message produit au d&eacute;marrage, cela
signifie que la requ&ecirc;te PIO d'information sur l'adaptateur
est tellement en dehors de l'intervalle qu'il n'y a pas de carte
&agrave; cette adresse d'entr&eacute;e-sortie (voir <code>segment =
inb(PIOaddr)</code> dans <code>ibmtr.c</code>).</li>
<li>Ma carte est une <code>Olicom 16/4 Adapter</code>. J'ai le
message suivant dans <code>/var/log/messages</code>&nbsp;:
<blockquote>
<pre>
<code>May  2 10:03:14 linux kernel: tr0: Unable to assign adapter to device.
May  2 10:03:14 linux kernel: tr1: Unable to assign adapter to device.
</code>
</pre></blockquote>
Cette carte ne doit pas utiliser le chipset Tropic. Essayez
d'utiliser une des cartes de la liste du d&eacute;but du
document.</li>
<li>J'ai une carte Token Ring IBM, mais j'ai les messages suivants
au d&eacute;marrage&nbsp;:
<blockquote>
<pre>
<code>May  2 16:23:07 linux kernel: tr0: PIOaddr:  a20 seg/intr: b8 mmio base:
000dc000 intr: 0
May  2 16:23:07 linux kernel: tr0: Channel ID string not found for PIOaddr:  a20
May  2 16:23:07 linux kernel: tr0: Expected for ISA: 5049434f3631313039393020
May  2 16:23:07 linux kernel: tr0:            found: 000902003021111000182000
May  2 16:23:07 linux kernel: tr0: Expected for MCA: 4d4152533633583435313820
May  2 16:23:07 linux kernel: tr0: Unable to assign adapter to device.
May  2 16:23:07 linux kernel: tr1: Unable to assign adapter to device.
</code>
</pre></blockquote>
Ce message indique soit un conflit m&eacute;moire soit une carte
Token Ring qui n'est pas reconnue (la signature de cette carte
n'est en tout cas pas connue).</li>
<li>Je trouve dans mon fichier <code>/var/log/messages</code> des
dizaines de lignes de ce type&nbsp;:
<blockquote>
<pre>
<code>May  3 15:11:47 linux kernel: tr0: Arrg. Transmitter busy for more than 50
msec. Donald resets adapter, but resetting
May  3 15:11:47 linux kernel:  the IBM tokenring adapter takes a long time.
It might not even help when the
May  3 15:11:47 linux kernel:  ring is very busy, so we just wait a little
longer and hope for the best.
</code>
</pre></blockquote>
Ces messages apparaissent lorsque j'essaye un telnet, un rlogin ou
un ftp sur une machine distante. La connexion est alors
bloqu&eacute;e pendant longtemps. Certaines personnes travaillent
&agrave; la correction de ce probl&egrave;me. Je mettrai &agrave;
jour cette r&eacute;ponse lorsqu'une solution sera
trouv&eacute;e.</li>
</ul>
</body>
</html>