IWCONFIG(8) Linux - Manual programatora IWCONFIG(8) JMENO iwconfig - nastavuje rozhrani bezdratove siti SYNTAXE iwconfig [rozhrani] iwconfig rozhrani [essid X] [nwid N] [mode M] [freq F] [channel C][sens S ][ap A ][nick NN ] [rate R] [rts RT] [frag FT] [txpower T] [enc E] [key K] [power P] [retry R] [commit] iwconfig --help iwconfig --version POPIS Iwconfig je podobny poikazu ifconfig(8), ale je vinovany bezdratovym rozhranim. Je pou3/4ivan k nastaveni tich parametru si>>ovych rozhrani, ktere jsou specificke pro bezdratovy provoz (napo. frekvence). Iwconfig mu3/4e byt take pou3/4it k zobrazeni tichto parametru a bezdratovych statistik (ziskanych z /proc/net/wireless). V^1echny tyto parametry a statistiky jsou zavisle na zaoizeni. Ka3/4dy ovladae poskytuje, v zavislosti na hardwarove podpooe, jen niktere z nich a rozsah hodnot se mu3/4e minit. Prosim obracejte se na manualove stranky jednotlivych zaoizeni pro dal^1i detaily. PARAMETRY essid Nastavi ESSID (nebo Network Name - u nikterych produktu mu3/4e byt nazvano Domain ID). ESSID se pou3/4iva k identifikaci bunik, ktere jsou soueasti stejne virtualni siti. Na rozdil od adresy AP nebo NWID, ktera ureuje jedinou buoku, ESSID ureuje skupinu bunik, spojenych opakovaei (repeater) nebo infrastrukturou, mezi kterymi mu3/4e u3/4ivatel transparentni poechazet. U nikterych karet je mo3/4ne vypnout kontrolu ESSID (promiskuitni ESSID) pomoci off nebo any (a on k opitovnemu zapnuti). Pokud je ESSID siti jednim z klieovych slov (off, on nebo any), pou3/4ije se -- Poiklady: iwconfig eth0 essid any iwconfig eth0 essid "Moje sit" iwconfig eth0 essid -- "ANY" nwid/domain Nastavi Network ID (u nikterych produktu mu3/4e byt nazvano Domain ID). Proto3/4e v^1echny sousedici bezdratove siti sdileji stejne medium, je tento parametr pou3/4ivan k jejich rozli^1eni (tvorbi logickych kolokovanych siti) a identifikaci nodu patoicich do stejne buoky. Tento parametr se pou3/4iva pouze u pre-802.11 zaoizeni. Protokol 802.11 pou3/4iva pro tuto funkci ESSID a adresu AP. U nikterych karet je mo3/4ne vypnout kontrolu Network ID (promiskuitni NWID) pomoci off (a on k opitovnemu zapnuti). Poiklady: iwconfig eth0 nwid AB34 iwconfig eth0 nwid off freq/channel Nastavi pracovni frekvenci nebo kanal zaoizeni. Hodnota ni3/4^1i ne3/4 1000 znamena eislo kanalu, hodnota vy^1^1i ne3/4 1000 je frekvence v Hz. Je mo3/4ne poipojit k hodnoti poiponu k, M nebo G (napoiklad "2.46G" pro frekvenci 2,46 GHz), nebo doplnit dostateeny poeet nul. Kanaly jsou obvykle eislovany od 1, je mo3/4ne pou3/4it iwlist(8) k ziskani celkoveho poetu kanalu, seznamu dostupnych frekvenci a zobrazeni soueasne frekvence jako kanalu. V zavislosti na poedpisech mohou byt niktere frekvence/kanaly nedostupne. Poiklady: iwconfig eth0 freq 2422000000 iwconfig eth0 freq 2.422G iwconfig eth0 channel 3 sens Nastavi prah citlivosti. To je nejni3/4^1i uroveo sily signalu poi ktere hardware pova3/4uje poijate pakety za pou3/4itelne. Kladne hodnoty jsou interpretovany jako hodnota pou3/4ivana hardwarem nebo jako procenta, negativni hodnoty jako dBm. V zavislosti na hardwarove implementaci mu3/4e mit tento parametr dal^1i funkce. Tento parametr mu3/4e ovladat prah poijmu (receive threshold) - nejni3/4^1i uroveo signalu poi ktere se hardware pokusi o poijem paketu, slab^1i signal je ignorovan. Mu3/4e take nastavovat prah ustupu (defer threshold) - nejni3/4^1i uroveo signalu, od ktere hardware pova3/4uje kanal za obsazeny. Poi spravnem nastaveni tichto prahu karta neztraci eas poijmen ^1umu. U modernich zaoizeni se zda, 3/4e tyto prahy reguluji automaticky. U modernich karet mu3/4e tento parametr ovladat prah poedani (handover/roaming threshold) - nejni3/4^1i uroveo signalu poi ktere hardware je^1ti zustane asociovano se soueasnym poistupovym bodem. Pokud uroveo signalu poklesne pod tuto hodnotu, zaene karta hledat novy/lep^1i poistupovy bod. Poiklad: iwconfig eth0 sens -80 mode nastavi pracovni re3/4im zaoizeni, co3/4 zavisi na topologii siti. Re3/4im mu3/4e byt Ad-Hoc (si>> slo3/4ena pouze z jedne buoky a bez poistupoveho bodu), Managed (node se poipojuje do siti slo3/4ene z mnoha poistupovych bodu, s roamingem), Master (node je synchronisation master nebo slou3/4i jako poistupovy bod), Repeater (node poedava pakety mezi ostatnimi bezdratovymi nody), Secondary (node slou3/4i jako zalo3/4ni master/repeater), Monitor (node neni asociovan s 3/4adnou buokou a pasivni monitoruje pakety na frekvenci) nebo Auto. poiklad: iwconfig eth0 mode Managed iwconfig eth0 mode Ad-Hoc ap Naoidi karti poipojit se k poistupovemu bodu ureenemu adresou, pokud je to mo3/4ne. Pokud se kvalita spojeni poili^1 sni3/4i, mu3/4e se ovladae vratit do automatickeho modu (karta vybere nejlep^1i poistupovy bod v dosahu). Je take mo3/4ne pou3/4it off k opitovnemu zapnuti automatickeho modu beze zminy soueasneho poistupoveho bodu nebo any ei auto k vynuceni opitovne asociace karty s momentalni nejlep^1im poistupovym bodem. Poiklad : iwconfig eth0 ap 00:60:1D:01:23:45 iwconfig eth0 ap any iwconfig eth0 ap off nick[name] Nastavi poezdivku neboli station name. Niktere 802.11 produkty ji definuji, ale co se tyka protokolu (MAC, IP, TCP), neni pou3/4ivana a poi konfiguraci je zcela nepotoebna. Pou3/4ivaji ji pouze niktere diagnosticke nastroje. Poiklad: iwconfig eth0 nickname "Muj linuxovy node" rate/bit[rate] U karet, ktere podporuji vice poenosovych rychlosti, nastavi rychlost poenosu v b/s. Rychlost poenosu je rychlost, kterou jsou bity poena^1eny mediem, rychlost pro u3/4ivatele je ni3/4^1i kvuli sdileni media a ruzne re3/4ii. Je mo3/4ne poipojit k hodnoti poiponu k, M nebo G (dekadicky nasobitel: 10^3, 10^6 a 10^9 b/s), nebo doplnit dostateeny poeet nul. Vyznam hodnoty ni3/4^1i ne3/4 1000 zavisi na pou3/4ite karti, obvykle znamena index v seznamu poenosovych rychlosti. Je mo3/4ne pou3/4it auto ke zvoleni re3/4imu automaticke poenosove rychlosti (ustup na ni3/4^1i rychlost v za^1uminych kanalech), co3/4 je u vit^1iny karet vychozi nastaveni, a fixed k navratu k pevnemu nastaveni. Pokud je ureena poenosova rychlost a auto, mu3/4e ovladae pou3/4it v^1echny poenosove rychlosti rovne teto hodnoti a ni3/4^1i. Poiklady: iwconfig eth0 rate 11M iwconfig eth0 rate auto iwconfig eth0 rate 5.5M auto rts[_threshold] RTS/CTS poida handshake poed ka3/4dym poenosem paketu, aby se zajistilo, 3/4e je kanal volny. To zvy^1i re3/4ii, ale take vykon v poipadi skrytych nodu nebo velkeho poetu aktivnich nodu. Tento parametr nastavuje velikost nejmen^1iho paketu, pro ktery node vysila RTS; hodnota rovna maximalni velikosti paketu tento mechanismus vypne. Je take mo3/4ne nastavit tento parametr na auto, fixed nebo off. Poiklady: iwconfig eth0 rts 250 iwconfig eth0 rts off frag[mentation_threshold] Fragmentace dovoluje rozdilit IP paket na davku nikolika men^1ich easti poenesenych mediem. To ve vit^1ini poipadu zvit^1i re3/4ii, ale ve velmi za^1uminim prostoedi sni3/4i ztraty zpusobene chybami a umo3/4ni paketum projit poi zaru^1eni. Tento parametr nastavi maximalni velikost fragmentu; hodnota rovna maximalni velikosti paketu tento mechanismus vypne. Je take mo3/4ne nastavit tento mechanismus na auto, fixed nebo off. Poiklady: iwconfig eth0 frag 512 iwconfig eth0 frag off key/enc[ryption] Pou3/4iva se k nastaveni ^1ifrovacich klieu a bezpeenostniho re3/4imu. Pro nastaveni aktualniho ^1ifrovaciho kliee se pouze zada klie v hexadecimalni podobi jako XXXX-XXXX-XXXX-XXXX nebo XXXXXXXX. Pro nastaveni jineho ne3/4 aktualniho kliee poidejte poed nebo za vlastni klie [index] (tim se nezmini aktualni klie). Je take mo3/4ne zadat klie jako oetizec ASCII znaku pomoci poedpony s: Passphrase neni v soueasnosti podporovana. Pro ureeni, ktery klie ma byt aktivni, se vlo3/4i [index] (bez zadani hodnoty kliee). off a on Vypnou a znovu zapnou ^1ifrovani. Bezpeenostni re3/4im mu3/4e byt open (otevoeny) nebo restricted, (uzavoeny) a jeho vyznam zavisi na pou3/4ite karti. Vit^1ina karet nepou3/4iva v open (otevoenem) re3/4imu 3/4adnou autentizaci a karta mu3/4e take poijimat neza^1ifrovane relace, zatimco v restricted (uzavoenem) re3/4imu jsou akceptovany pouze za^1ifrovane relace a karta pou3/4ije autentizaci, pokud je k dispozici. Pokud je toeba nastavit vice klieu, nebo nastavit klie a ureit aktivni klie, je nutne pou3/4it vice poepinaeu key Parametry mohou byt v jakemkoliv pooadi, posledni ma poednost. Poiklady: iwconfig eth0 key 0123-4567-89 iwconfig eth0 key [3] 0123-4567-89 iwconfig eth0 key s:password [2] iwconfig eth0 key [2] iwconfig eth0 key open iwconfig eth0 key off iwconfig eth0 key restricted [3] 0123456789 iwconfig eth0 key 01-23 key 45-67 [4] key [4] power Nastavuje re3/4im oizeni spotoeby a jeho parametry. Pro nastaveni easu mezi probuzenimi se vlo3/4i period `hodnota'. Pro nastaveni prodlevy poed navratem do spanku se vlo3/4i timeout `hodnota'. Je take mo3/4ne poidat modifikatory min a max Hodnoty znamenaji poeet sekund, pro ureeni v milisekundach nebo mikrosekundach se pou3/4ije poipona m nebo u. Nikdy jsou tyto hodnoty bez jednotek (poeet obdobi mezi beacons a podobni). off a on vypne a novu zapne oizeni spotoeby. Je take mo3/4ne nastavit re3/4im oizeni spotoeby na all (poijima v^1echny pakety), unicast (poijima pouze unicast pakety, zahazuje multicast a broadcast) a multicast (poijima pouze multicast a broadcast, zahazuje unicast pakety). Poiklady: iwconfig eth0 power period 2 iwconfig eth0 power 500m unicast iwconfig eth0 power timeout 300u all iwconfig eth0 power off iwconfig eth0 power min period 2 power max period 4 txpower U karet podporujicich rozdilne vysilaci vykony nastavuje vysilaci vykon v dBm. Je-li dan vykon W ve Wattech, je vykon v dBm roven P = 30 + 10.log(W). Pokud je hodnota doplnina poiponou mW, je automaticky poevedena na dBm. Navic volby on a off povoli a zaka3/4ou vysilani, auto a fixed povoli a zaka3/4ou mo3/4nost minit vykon (pokud je tato vlastnost k dispozici). Poiklady: iwconfig eth0 txpower 15 iwconfig eth0 txpower 30mW iwconfig eth0 txpower auto iwconfig eth0 txpower off retry Vit^1ina karet umi MAC retransmisi a niktere umo3/4ouji nastavit chovani tohoto mechanismu. pro nastaveni maximalniho poetu pokusu o zaslani se zada limit `hodnota'. Toto je absolutni hodnota (bez jednotky). Pro nastaveni nejdel^1iho obdobi, ve kterem se ma MAC pokou^1et o zaslani, se zada lifetime `hodnota'. Hodnoty znamenaji poeet sekund, pro ureeni v milisekundach nebo mikrosekundach se pou3/4ije poipona m nebo u. je take mo3/4ne poidat modifikatory min a max Pokud karta podporuje automaticky re3/4im, ureuji tyto modifikatory rozmezi pro limit nebo lifetime. Niktere karty definuji ruzne hodnoty v zavislosti na velikosti paketu, napo. v 802.11 ureuje min limit tzv. "short retry limit" - limit pro pakety, na ktere neni aplikovano RTS/CTS. Poiklady: iwconfig eth0 retry 16 iwconfig eth0 retry lifetime 300m iwconfig eth0 retry min limit 8 commit Niktere karty nemusi provest zminy zadane poes Wireless Extensions okam3/4iti (mohou eekat na nashroma3/4dini zmin a poijmout je a3/4 kdy3/4 je karta aktivovana pomoci ifconfig). Tento poikaz (pokud je dostupny) poinuti kartu k poijeti v^1ech nevyoizenych zmin. To neni vit^1inou potoeba, proto3/4e karta easem zminy poijme, ale mu3/4e to byt u3/4iteene poi ladini. ZOBRAZENI Pro ka3/4de zaoizeni, ktere podporuje wireless extensions, zobrazi iwconfig nazev pou3/4iteho MAC protokolu (nazev zaoizeni u proprietarnich protokolu), ESSID (Network Name), NWID, frekvenci (nebo kanal), sensitivity (citlivost), mode (pracovni re3/4im), Access Point (adresu poistupoveho bodu), bit-rate (poenosovou rychlost), RTS threshold (prah RTS), fragmentation threshold (prah fragmentace), encryption key (^1ifrovaci klie) a nastaveni power management (oizeni spotoeby)(pokud je k dispozici). Zobrazene parametry maji stejny vyznam a hodnoty jako parametry, ktere mohou byt nastaveny, pro jejich podrobnij^1i vysvitleni se prosim obra>>te se na poedchozi east. Niktere parametry jsou zobrazeny pouze ve sve kratke/zkracene podobi (napo. ^1ifrovani). Je mo3/4ne pou3/4it iwlist(8) k ziskani detailu. Niktere parametry maji dva re3/4imy (napo. poenosova rychlost). Pokud hodnotu uvozuje `=', znamena to, 3/4e parametr je pevny a dany touto hodnotou, pokud ji uvozuje `:', je parametr v automatickem re3/4imu a je zobrazena aktualni hodnota (a mu3/4e se zminit). Access Point/Cell Adresa rovna 00:00:00:00:00:00 znamena, 3/4e se karta nedokazala asociovat s poistupovym bodem (nejspi^1e problem v nastaveni). Parametr Access Point bude zobrazen jako Cell v re3/4imu ad-hoc (ze zoejmych duvodu), ale jinak znamena to same. Pokud existuje /proc/net/wireless, iwconfig se take pokusi zobrazit jeho obsah. Nicmeni tyto hodnoty zavisi na ovladaei a zvla^1tnostech hardware, tak3/4e pro jejich spravnou interpretaci je nutne obratit se na dokumentaci ovladaee. Link quality Celkova kvalita spoje. Mu3/4e byt zalo3/4ena na urovni ru^1eni ei interference, poetu chyb na urovni bitu nebo ramcu, sile poijimaneho signalu, synchronizaci easovani nebo dal^1ich hardwarovych mioenich. Je to celkova hodnota a zcela zale3/4i na ovladaei a hardware. Signal level Received signal strength (RSSI - indikator sily poijimaneho signalu). Mu3/4e byt v libovolnych jednotkach nebo dBm, iwconfig pou3/4iva informace z ovladaee k interpretaci surovych dat v /proc/net/wireless a zobrazeni spravne jednotky nebo maximalni hodnoty (pomoci 8 bitovych vypoetu). V Ad-Hoc re3/4imu mu3/4e byt nedefinovana a mil by byt pou3/4it iwspy. Noise level Uroveo ^1umu pozadi (kdy3/4 neni poena^1en 3/4adny paket). Plati stejne poznamky jako pro Signal level. Rx invalid nwid Poeet poijatych paketu s odli^1nym NWID nebo ESSID. Pou3/4iva se k detekci problemu v nastaveni nebo existence sousedni siti (na stejne frekvuenci). Rx invalid crypt Poeet paketu, ktere hardware nedokazal de^1ifrovat. Mu3/4e indikovat neplatne nastaveni ^1ifrovani. Rx invalid frag Poeet paketu, pro ktere hardware nedokazal spravni znovu sestavit jednotlive fragmenty na fyzicke vrstvi (nejspi^1e jeden chybil). Tx excessive retries Poeet paketu, ktere hardware nedokazal odeslat. Vit^1ina MAC protokolu zkusi poslat paket nikolikrat, ne3/4 to vzda. Invalid misc Ostatni pakety ztracene v souvislosti s ureitymi bezdratovymi operacemi. Missed beacon Poeet pravidelnych beacons z buoky nebo poistupoveho bodu, ktere nebyly zachyceny. Beacons jsou vysilany v pravidelnych intervalech pro udr3/4eni koordinace a pokud nejsou zachyceny, vit^1inou to znamena, 3/4e je karta mimo dosah. AUTOR Jean Tourrilhes - jt@hpl.hp.com POEKLAD Pavel Heimlich - tropikhajma@seznam.cz, boezen 2005 (wireless_tools.28pre4). SOUBORY /proc/net/wireless DAL(C)I INFORMACE ifconfig(8), iwspy(8), iwlist(8), iwevent(8), iwpriv(8), wireless(7). wireless-tools 22.eervna 2004 IWCONFIG(8)