nexmon – Blame information for rev 1

Subversion Repositories:
Rev:
Rev Author Line No. Line
1 office 1 .\" Jean II - HPLB - 1996 => HPL - 2004
2 .\" iwconfig.8
3 .\"
4 .TH IWCONFIG 8 "22.června 2004" "wireless-tools" "Linux - Manuál programátora"
5 .\"
6 .\" NAME part
7 .\"
8 .SH JMÉNO
9 iwconfig \- nastavuje rozhraní bezdrátové sítě
10 .\"
11 .\" SYNOPSIS part
12 .\"
13 .SH SYNTAXE
14 .BI "iwconfig [" rozhraní ]
15 .br
16 .BI "iwconfig " rozhraní " [essid " X "] [nwid " N "] [mode " M "] [freq " F "]
17 .br
18 .BI " [channel " C ] [sens " S "] [ap " A "] [nick " NN ]
19 .br
20 .BI " [rate " R "] [rts " RT "] [frag " FT "] [txpower " T ]
21 .br
22 .BI " [enc " E "] [key " K "] [power " P "] [retry " R ]
23 .br
24 .BI " [commit]
25 .br
26 .BI "iwconfig --help"
27 .br
28 .BI "iwconfig --version"
29 .\"
30 .\" DESCRIPTION part
31 .\"
32 .SH POPIS
33 .B Iwconfig
34 je podobný příkazu
35 .IR ifconfig (8),
36 ale je věnovaný bezdrátovým rozhraním. Je používán k nastavení těch parametrů
37 síťových rozhraní, které jsou specifické pro bezdrátový provoz (např. frekvence).
38 .B Iwconfig
39 může být také použit k zobrazení těchto parametrů a bezdrátových
40 statistik (získaných z
41 .IR /proc/net/wireless ).
42 .PP
43 Všechny tyto parametry a statistiky jsou závislé na zařízení. Každý ovladač
44 poskytuje, v závislosti na hardwarové podpoře, jen některé z nich
45 a rozsah hodnot se může měnit. Prosím obracejte se na manuálové stránky
46 jednotlivých zařízení pro další detaily.
47 .\"
48 .\" PARAMETER part
49 .\"
50 .SH PARAMETRY
51 .TP
52 .B essid
53 Nastaví ESSID (nebo Network Name - u některých produktů může být nazváno
54 Domain ID). ESSID se používá k identifikaci buněk, které jsou
55 součástí stejné virtuální sítě.
56 .br
57 Na rozdíl od adresy AP nebo NWID, která určuje jedinou buňku, ESSID
58 určuje skupinu buněk, spojených opakovači (repeater) nebo infrastrukturou,
59 mezi kterými může uživatel transparentně přecházet.
60 .br
61 U některých karet je možné vypnout kontrolu ESSID (promiskuitní ESSID)
62 pomocí
63 .IR off " nebo " any " (a " on
64 k opětovnému zapnutí).
65 .br
66 Pokud je ESSID sítě jedním z klíčových slov
67 .RI ( off ", " on " nebo " any ),
68 použije se
69 .I --
70 .br
71 .B Příklady:
72 .br
73 .I " iwconfig eth0 essid any"
74 .br
75 .I " iwconfig eth0 essid ""Moje sit""
76 .br
77 .I " iwconfig eth0 essid -- ""ANY""
78 .TP
79 .BR nwid / domain
80 Nastaví Network ID (u některých produktů může být nazváno Domain ID).
81 Protože všechny sousedící bezdrátové sítě sdílejí stejné médium, je
82 tento parametr používán k jejich rozlišení (tvorbě logických kolokovaných
83 sítí) a identifikaci nodů patřících do stejné buňky.
84 .br
85 Tento parametr se používá pouze u pre-802.11 zařízení. Protokol 802.11
86 používá pro tuto funkci ESSID a adresu AP.
87 .br
88 U některých karet je možné vypnout kontrolu Network ID (promiskuitní NWID)
89 pomocí
90 .IR off " (a " on
91 k opětovnému zapnutí).
92 .br
93 .B Příklady:
94 .br
95 .I " iwconfig eth0 nwid AB34
96 .br
97 .I " iwconfig eth0 nwid off"
98 .TP
99 .BR freq / channel
100 Nastaví pracovní frekvenci nebo kanál zařízení. Hodnota nižší než 1000
101 znamená číslo kanálu, hodnota vyšší než 1000 je frekvence v Hz.
102 Je možné připojit k hodnotě příponu k, M nebo G (například "2.46G" pro
103 frekvenci 2,46 GHz), nebo doplnit dostatečný počet nul.
104 .br
105 Kanály jsou obvykle číslovány od 1, je možné použít
106 .IR iwlist (8)
107 k získání celkového počtu kanálů, seznamu dostupných frekvencí a zobrazení současné
108 frekvence jako kanálu. V závislosti na předpisech mohou být některé frekvence/kanály
109 nedostupné.
110 .br
111 .B Příklady:
112 .br
113 .I " iwconfig eth0 freq 2422000000"
114 .br
115 .I " iwconfig eth0 freq 2.422G"
116 .br
117 .I " iwconfig eth0 channel 3"
118 .TP
119 .B sens
120 Nastaví práh citlivosti. To je nejnižší úroveň síly signálu při které
121 hardware považuje přijaté pakety za použitelné. Kladné hodnoty jsou
122 interpretovány jako hodnota používaná hardwarem nebo jako procenta,
123 negativní hodnoty jako dBm. V závislosti na hardwarové implementaci může
124 mít tento parametr další funkce.
125 .br
126 Tento parametr může ovládat práh příjmu (receive threshold) - nejnižší úroveň signálu
127 při které se hardware pokusí o příjem paketu, slabší signál je ignorován. Může také
128 nastavovat práh ústupu (defer threshold) - nejnižší úroveň signálu, od které hardware
129 považuje kanál za obsazený. Při správném nastavení těchto prahů karta neztrácí čas
130 příjmen šumu. U moderních zařízení se zdá, že tyto prahy regulují automaticky.
131 .br
132 U moderních karet může tento parametr ovládat práh předání (handover/roaming
133 threshold) - nejnižší úroveň signálu při které hardware ještě zůstane asociováno se
134 současným přístupovým bodem. Pokud úroveň signálu poklesne pod tuto hodnotu,
135 začne karta hledat nový/lepší přístupový bod.
136 .br
137 .B Příklad:
138 .br
139 .I " iwconfig eth0 sens -80"
140 .TP
141 .B mode
142 nastaví pracovní režim zařízení, což závisí na topologii sítě.
143 Režim může být
144 .I Ad-Hoc
145 (síť složená pouze z jedné buňky a bez přístupového bodu),
146 .I Managed
147 (node se připojuje do sítě složené z mnoha přístupových bodů, s roamingem),
148 .I Master
149 (node je synchronisation master nebo slouží jako přístupový bod),
150 .I Repeater
151 (node předává pakety mezi ostatními bezdrátovými nody),
152 .I Secondary
153 (node slouží jako záložní master/repeater),
154 .I Monitor
155 (node není asociován s žádnou buňkou a pasivně monitoruje pakety na frekvenci) nebo
156 .IR Auto .
157 .br
158 .B příklad:
159 .br
160 .I " iwconfig eth0 mode Managed"
161 .br
162 .I " iwconfig eth0 mode Ad-Hoc"
163 .TP
164 .B ap
165 Nařídí kartě připojit se k přístupovému bodu určenému adresou,
166 pokud je to možné. Pokud se kvalita spojení příliš sníží,
167 může se ovladač vrátit do automatického módu (karta vybere
168 nejlepší přístupový bod v dosahu).
169 .br
170 Je také možné použít
171 .I off
172 k opětovnému zapnutí automatického módu beze změny současného přístupového bodu
173 nebo
174 .I any
175 či
176 .I auto
177 k vynucení opětovné asociace karty s momentálně nejlepším přístupovým bodem.
178 .br
179 .B Příklad :
180 .br
181 .I " iwconfig eth0 ap 00:60:1D:01:23:45"
182 .br
183 .I " iwconfig eth0 ap any"
184 .br
185 .I " iwconfig eth0 ap off"
186 .TP
187 .BR nick [name]
188 Nastaví přezdívku neboli station name. Některé 802.11 produkty ji definují,
189 ale co se týká protokolů (MAC, IP, TCP), není používána a při konfiguraci je
190 zcela nepotřebná. Používají ji pouze některé diagnostické nástroje.
191 .br
192 .B Příklad:
193 .br
194 .I " iwconfig eth0 nickname ""Muj linuxovy node""
195 .TP
196 .BR rate / bit [rate]
197 U karet, které podporují více přenosových rychlostí, nastaví rychlost přenosu v b/s.
198 Rychlost přenosu je rychlost, kterou jsou bity přenášeny médiem,
199 rychlost pro uživatele je nižší kvůli sdílení média a různé režii.
200 .br
201 Je možné připojit k hodnotě příponu k, M nebo G (dekadický násobitel:
202 10^3, 10^6 a 10^9 b/s), nebo doplnit dostatečný počet nul. Význam hodnoty nižší než
203 1000 závisí na použité kartě, obvykle znamená index v seznamu přenosových rychlostí.
204 Je možné použít
205 .I auto
206 ke zvolení režimu automatické přenosové rychlosti (ústup na nižší rychlost v zašuměných
207 kanálech), což je u většiny karet výchozí nastavení, a
208 .I fixed
209 k návratu k pevnému nastavení. Pokud je určena přenosová rychlost a
210 .IR auto ,
211 může ovladač použít všechny přenosové rychlosti rovné této hodnotě a nižší.
212 .br
213 .B Příklady:
214 .br
215 .I " iwconfig eth0 rate 11M"
216 .br
217 .I " iwconfig eth0 rate auto"
218 .br
219 .I " iwconfig eth0 rate 5.5M auto"
220 .TP
221 .BR rts [_threshold]
222 RTS/CTS přidá handshake před každým přenosem paketů, aby se zajistilo,
223 že je kanál volný. To zvýší režii, ale také výkon v případě skrytých nodů
224 nebo velkého počtu aktivních nodů. Tento parametr nastavuje velikost nejmenšího
225 paketu, pro který node vysílá RTS; hodnota rovná maximální velikosti paketu
226 tento mechanismus vypne. Je také možné nastavit tento parametr na
227 .IR auto ", " fixed " nebo " off .
228 .br
229 .B Příklady:
230 .br
231 .I " iwconfig eth0 rts 250"
232 .br
233 .I " iwconfig eth0 rts off"
234 .TP
235 .BR frag [mentation_threshold]
236 Fragmentace dovoluje rozdělit IP paket na dávku několika menších částí
237 přenesených médiem. To ve většině případů zvětší režii, ale ve velmi zašuměněm
238 prostředí sníží ztráty způsobené chybami a umožní paketům projít
239 při zarušení. Tento parametr nastaví maximální velikost fragmentu; hodnota
240 rovná maximální velikosti paketu tento mechanismus vypne. Je také
241 možné nastavit tento mechanismus na
242 .IR auto ", " fixed " nebo " off .
243 .br
244 .B Příklady:
245 .br
246 .I " iwconfig eth0 frag 512"
247 .br
248 .I " iwconfig eth0 frag off"
249 .TP
250 .BR key / enc [ryption]
251 Používá se k nastavení šifrovacích klíčů a bezpečnostního režimu.
252 .br
253 Pro nastavení aktuálního šifrovacího klíče se pouze zadá klíč v hexadecimální podobě jako
254 .IR XXXX-XXXX-XXXX-XXXX " nebo " XXXXXXXX .
255 Pro nastavení jiného než aktuálního klíče přidejte před nebo za vlastní klíč
256 .I [index]
257 (tím se nezmění aktuální klíč). Je také možné zadat klíč
258 jako řetězec ASCII znaků pomocí předpony
259 .I s:
260 . Passphrase není v současnosti podporovaná.
261 .br
262 Pro určení, který klíč má být aktivní, se vloží
263 .I [index]
264 (bez zadání hodnoty klíče).
265 .br
266 .IR off " a " on
267 Vypnou a znovu zapnou šifrování.
268 .br
269 Bezpečnostní režim může být
270 .I open
271 (otevřený) nebo
272 .IR restricted ,
273 (uzavřený) a jeho význam závisí na použité kartě. Většina karet nepoužívá v
274 .I open
275 (otevřeném) režimu žádnou autentizaci a karta může také přijímat
276 nezašifrované relace, zatímco v
277 .I restricted
278 (uzavřeném) režimu jsou akceptovány pouze zašifrované relace a karta použije autentizaci,
279 pokud je k dispozici.
280 .br
281 Pokud je třeba nastavit více klíčů, nebo nastavit klíč a určit aktivní klíč,
282 je nutné použít více přepínačů
283 .B key
284 . Parametry mohou být v jakémkoliv pořadí, poslední má přednost.
285 .br
286 .B Příklady:
287 .br
288 .I " iwconfig eth0 key 0123-4567-89"
289 .br
290 .I " iwconfig eth0 key [3] 0123-4567-89"
291 .br
292 .I " iwconfig eth0 key s:password [2]"
293 .br
294 .I " iwconfig eth0 key [2]"
295 .br
296 .I " iwconfig eth0 key open"
297 .br
298 .I " iwconfig eth0 key off"
299 .br
300 .I " iwconfig eth0 key restricted [3] 0123456789"
301 .br
302 .I " iwconfig eth0 key 01-23 key 45-67 [4] key [4]"
303 .TP
304 .BR power
305 Nastavuje režim řízení spotřeby a jeho parametry.
306 .br
307 Pro nastavení času mezi probuzeními se vloží
308 .IR "period `hodnota'" .
309 Pro nastavení prodlevy před návratem do spánku se vloží
310 .IR "timeout `hodnota'" .
311 Je také možné přidat modifikátory
312 .IR min " a " max
313 . Hodnoty znamenají počet sekund, pro určení v milisekundách
314 nebo mikrosekundách se použije přípona m nebo u. Někdy jsou
315 tyto hodnoty bez jednotek (počet období mezi beacons a podobně).
316 .br
317 .IR off " a " on
318 vypne a novu zapne řízení spotřeby. Je také možné nastavit
319 režim řízení spotřeby na
320 .I all
321 (přijímá všechny pakety),
322 .I unicast
323 (přijímá pouze unicast pakety, zahazuje multicast a broadcast) a
324 .I multicast
325 (přijímá pouze multicast a broadcast, zahazuje unicast pakety).
326 .br
327 .B Příklady:
328 .br
329 .I " iwconfig eth0 power period 2"
330 .br
331 .I " iwconfig eth0 power 500m unicast"
332 .br
333 .I " iwconfig eth0 power timeout 300u all"
334 .br
335 .I " iwconfig eth0 power off"
336 .br
337 .I " iwconfig eth0 power min period 2 power max period 4"
338 .TP
339 .BR txpower
340 U karet podporujících rozdílné vysílací výkony nastavuje vysílací výkon v dBm. Je-li dán výkon
341 .I W
342 ve Wattech, je výkon v dBm roven
343 .IR "P = 30 + 10.log(W)" .
344 Pokud je hodnota doplněna příponou
345 .IR mW ,
346 je automaticky převedena na dBm.
347 .br
348 Navíc volby
349 .IR on " a " off
350 povolí a zakážou vysílání,
351 .IR auto " a " fixed
352 povolí a zakážou možnost měnit výkon (pokud je tato vlastnost k dispozici).
353 .br
354 .B Příklady:
355 .br
356 .I " iwconfig eth0 txpower 15"
357 .br
358 .I " iwconfig eth0 txpower 30mW"
359 .br
360 .I " iwconfig eth0 txpower auto"
361 .br
362 .I " iwconfig eth0 txpower off"
363 .TP
364 .BR retry
365 Většina karet umí MAC retransmisi a některé umožňují nastavit
366 chování tohoto mechanismu.
367 .br
368 pro nastavení maximálního počtu pokusů o zaslání se zadá
369 .IR "limit `hodnota'" .
370 Toto je absolutní hodnota (bez jednotky).
371 Pro nastavení nejdelšího období, ve kterém se má MAC pokoušet o zaslání, se zadá
372 .IR "lifetime `hodnota'" .
373 Hodnoty znamenají počet sekund, pro určení v milisekundách
374 nebo mikrosekundách se použije přípona m nebo u.
375 .br
376 je také možné přidat modifikátory
377 .IR min " a " max
378 . Pokud karta podporuje automatický režim, určují tyto modifikátory rozmezí pro limit nebo lifetime.
379 Některé karty definují různé hodnoty v závislosti na velikosti
380 paketů, např. v 802.11 určuje
381 .I min limit
382 tzv. "short retry limit" - limit pro pakety, na které není aplikováno RTS/CTS.
383 .br
384 .B Příklady:
385 .br
386 .I " iwconfig eth0 retry 16"
387 .br
388 .I " iwconfig eth0 retry lifetime 300m"
389 .br
390 .I " iwconfig eth0 retry min limit 8"
391 .TP
392 .BR commit
393 Některé karty nemusí provést změny zadané přes Wireless Extensions
394 okamžitě (mohou čekat na nashromáždění změn a přijmout je
395 až když je karta aktivována pomocí ifconfig). Tento příkaz (pokud
396 je dostupný) přinutí kartu k přijetí všech nevyřízených změn.
397 .br
398 To není většinou potřeba, protože karta časem změny přijme, ale může to
399 být užitečné při ladění.
400 .\"
401 .\" DISPLAY part
402 .\"
403 .SH ZOBRAZENÍ
404 Pro každé zařízení, které podporuje wireless extensions, zobrazí
405 .I iwconfig
406 název použitého
407 .B MAC protokolu
408 (název zařízení u proprietárních protokolů),
409 .B ESSID
410 (Network Name),
411 .BR NWID ,
412 .B frekvenci
413 (nebo kanál),
414 .BR sensitivity
415 (citlivost),
416 .B mode
417 (pracovní režim),
418 .B Access Point
419 (adresu přístupového bodu),
420 .B bit-rate
421 (přenosovou rychlost),
422 .BR "RTS threshold"
423 (práh RTS),
424 .BR "fragmentation threshold"
425 (práh fragmentace),
426 .B encryption key
427 (šifrovací klíč) a nastavení
428 .B power management
429 (řízení spotřeby)(pokud je k dispozici).
430 .PP
431 Zobrazené parametry mají stejný význam a hodnoty jako parametry,
432 které mohou být nastaveny, pro jejich podrobnější vysvětlení se prosím
433 obraťte se na předchozí část.
434 .br
435 Některé parametry jsou zobrazeny pouze ve své krátké/zkrácené podobě
436 (např. šifrování). Je možné použít
437 .IR iwlist (8)
438 k získání detailů.
439 .br
440 Některé parametry mají dva režimy (např. přenosová rychlost). Pokud
441 hodnotu uvozuje
442 .RB ` = ',
443 znamená to, že parametr je pevný a daný touto hodnotou, pokud
444 ji uvozuje
445 .RB ` : ',
446 je parametr v automatickém režimu a je zobrazena aktuální hodnota (a
447 může se změnit).
448 .TP
449 .BR "Access Point" / Cell
450 Adresa rovná 00:00:00:00:00:00 znamená, že se karta nedokázala asociovat
451 s přístupovým bodem (nejspíše problém v nastavení).
452 Parametr
453 .B Access Point
454 bude zobrazen jako
455 .B Cell
456 v režimu ad-hoc (ze zřejmých důvodů), ale jinak znamená to samé.
457 .PP
458 Pokud existuje
459 .IR "/proc/net/wireless" ,
460 .I iwconfig
461 se také pokusí zobrazit jeho obsah. Nicméně tyto hodnoty závisí na
462 ovladači a zvláštnostech hardware, takže pro jejich správnou interpretaci je nutné obrátit se na
463 dokumentaci ovladače.
464 .TP
465 .B Link quality
466 Celková kvalita spoje. Může být založena na úrovni rušení
467 či interference, počtu chyb na úrovni bitů nebo rámců, síle přijímaného
468 signálu, synchronizaci časování nebo dalších hardwarových měřeních. Je to
469 celková hodnota a zcela záleží na ovladači a hardware.
470 .TP
471 .B Signal level
472 Received signal strength (RSSI - indikátor síly přijímaného signálu).
473 Může být v libovolných jednotkách nebo dBm,
474 .I iwconfig
475 používá informace z ovladače k interpretaci surových dat v
476 .I /proc/net/wireless
477 a zobrazení správné jednotky nebo maximální hodnoty (pomocí 8 bitových výpočtů). V
478 .I Ad-Hoc
479 režimu může být nedefinovaná a měl by být použit
480 .IR iwspy .
481 .TP
482 .B Noise level
483 Úroveň šumu pozadí (když není přenášen žádný paket). Platí stejné poznámky
484 jako pro
485 .BR "Signal level" .
486 .TP
487 .B Rx invalid nwid
488 Počet přijatých paketů s odlišným NWID nebo ESSID. Používá se
489 k detekci problémů v nastavení nebo existence sousední sítě
490 (na stejné frekvuenci).
491 .TP
492 .B Rx invalid crypt
493 Počet paketů, které hardware nedokázal dešifrovat. Může indikovat
494 neplatné nastavení šifrování.
495 .TP
496 .B Rx invalid frag
497 Počet paketů, pro které hardware nedokázal správně znovu sestavit
498 jednotlivé fragmenty na fyzické vrstvě (nejspíše jeden chyběl).
499 .TP
500 .B Tx excessive retries
501 Počet paketů, které hardware nedokázal odeslat. Většina MAC
502 protokolů zkusí poslat paket několikrát, než to vzdá.
503 .TP
504 .B Invalid misc
505 Ostatní pakety ztracené v souvislosti s určitými bezdrátovými operacemi.
506 .TP
507 .B Missed beacon
508 Počet pravidelných beacons z buňky nebo přístupového bodu, které nebyly zachyceny.
509 Beacons jsou vysílány v pravidelných intervalech pro udržení koordinace a
510 pokud nejsou zachyceny, většinou to znamená, že je karta mimo dosah.
511 .\"
512 .\" AUTHOR part
513 .\"
514 .SH AUTOR
515 Jean Tourrilhes \- jt@hpl.hp.com
516 .\"
517 .\" TRANSLATION part
518 .\"
519 .SH PŘEKLAD
520 Pavel Heimlich \- tropikhajma@seznam.cz, březen 2005 (wireless_tools.28pre4).
521 .\"
522 .\" FILES part
523 .\"
524 .SH SOUBORY
525 .I /proc/net/wireless
526 .\"
527 .\" SEE ALSO part
528 .\"
529 .SH DALŠÍ INFORMACE
530 .BR ifconfig (8),
531 .BR iwspy (8),
532 .BR iwlist (8),
533 .BR iwevent (8),
534 .BR iwpriv (8),
535 .BR wireless (7).