IWCONFIG(8) Manualul programatorului Linux IWCONFIG(8) NUME iwconfig - configureaza o interfaa de reea fara fir SINOPSIS iwconfig [interfaa] iwconfig interface [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] [modu M] [commit] iwconfig --help iwconfig --version DESCRIERE iwconfig este similar cu ifconfig(8), dar este dedicat interfeelor fara fir. Este utilizat pentru a configura parametrii interfeei de reea care sunt specifici funcionarii fara fir (de exemplu: frecvena). Iwconfig poate fi, de asemenea, utilizat pentru a afia aceti parametri, precum i statisticile privind conexiunea fara fir (extrase din /proc/net/wireless). Toi aceti parametri i statistici depind de dispozitiv. Fiecare controlor de dispozitiv va furniza doar unele dintre ele, in funcie de suportul hardware, iar gama de valori se poate schimba. Va rugam sa consultai pagina de manual a fiecarui dispozitiv pentru detalii. PARAMETRI essid Stabilete ESSID (sau ,,Network Name" (numele reelei) - in unele produse poate fi numit i ,,Domain ID" (id domeniu)). ESSID este utilizat pentru a identifica celulele care fac parte din aceeai reea virtuala. Spre deosebire de adresa AP (,,Access Point", punctului de acces) sau NWID, care definesc o singura celula, ESSID definete un grup de celule conectate prin repetitori sau infrastructura, unde utilizatorul se poate deplasa in mod transparent. La unele placi, putei dezactiva verificarea ESSID (ESSID promiscuous) cu off sau any (i on pentru a o reactiva). Daca ESSID-ul reelei dumneavoastra este unul dintre cuvintele cheie speciale (off, on sau any), trebuie sa utilizai -- pentru a scapa de el. Exemple: iwconfig eth0 essid any iwconfig eth0 essid "Reeaua mea" iwconfig eth0 essid -- "ANY" nwid Stabilete ID-ul reelei. Deoarece toate reelele fara fir adiacente impart acelai mediu, acest parametru este utilizat pentru a le diferenia (crearea de reele colocatare logic) i pentru a identifica nodurile care aparin aceleiai celule. Acest parametru este utilizat numai pentru hardware pre-802.11, protocolul 802.11 utilizeaza ESSID (identificatorul/numele reelei) i AP Address (adresa punctului de acces) pentru aceasta funcie. La unele placi, putei dezactiva verificarea ID-ului de reea (NWID promiscuous) cu off (i on pentru a o reactiva). Exemple: iwconfig eth0 nwid AB34 iwconfig eth0 nwid off nick[nume] Stabilete porecla sau numele staiei. Unele produse 802.11 o definesc, dar aceasta nu este utilizata in ceea ce privete protocoalele (MAC, IP, TCP) i este complet inutila in ceea ce privete configurarea. Doar unele instrumente de diagnosticare fara fir o pot utiliza. Exemplu: iwconfig eth0 nickname "Maina mea Linux" mode Stabilete modul de funcionare al dispozitivului, care depinde de topologia reelei. Modul poate fi Ad-Hoc (reea compusa dintr-o singura celula i fara punct de acces), Managed (nodul se conecteaza la o reea compusa din mai multe puncte de acces, cu ,,roaming" (de forma itineranta)), Master (nodul este maestru de sincronizare sau acioneaza ca punct de acces), Repeater (nodul redirecioneaza pachete intre alte noduri fara fir), Secondary (nodul acioneaza ca maestru/repetitor de rezerva), Monitor (nodul nu este asociat cu nicio celula i monitorizeaza pasiv toate pachetele de pe frecvena respectiva) sau Auto. Exemplu: iwconfig eth0 mode Managed iwconfig eth0 mode Ad-Hoc freq/channel Stabilete frecvena sau canalul de operare in dispozitiv. O valoare mai mica de 1000 indica un numar de canal, iar o valoare mai mare de 1000 reprezinta o frecvena in Hz. Putei adauga sufixul k, M sau G la valoare (de exemplu, ,,2.46G" pentru frecvena de 2,46 GHz) sau putei adauga numarul potrivit de ,,0"-uri. Canalele sunt de obicei numerotate incepand cu 1 i putei utiliza iwlist(8) pentru a obine numarul total de canale, pentru a lista frecvenele disponibile i pentru a afia frecvena curenta ca un canal. In funcie de reglementari, este posibil ca unele frecvene/canale sa nu fie disponibile. Atunci cand se utilizeaza modul ,,Managed", cel mai adesea punctul de acces dicteaza canalul, iar controlorul poate refuza stabilirea frecvenei. In modul ,,Ad-Hoc", stabilirea frecvenei poate fi utilizata numai la crearea iniiala a celulei i poate fi ignorata atunci cand se alatura unei celule existente. De asemenea, putei utiliza off sau auto pentru a lasa placa sa aleaga cel mai bun canal (atunci cand acest lucru este acceptat). Exemple: iwconfig eth0 freq 2422000000 iwconfig eth0 freq 2.422G iwconfig eth0 channel 3 iwconfig eth0 channel auto ap Foreaza placa sa se inregistreze la punctul de acces ,,Access Point" indicat de adresa, daca acest lucru este posibil. Aceasta adresa este identitatea celulara a punctului de acces, aa cum este raportata de scanarea fara fir, care poate fi diferita de adresa MAC a reelei. Daca legatura fara fir este punct la punct, stabilete adresa celuilalt capat al legaturii. Daca legatura este ad-hoc, stabilete identitatea celulara a reelei ad-hoc. Cand calitatea conexiunii scade prea mult, controlorul poate reveni la modul automat (placa selecteaza cel mai bun punct de acces din raza de aciune). De asemenea, putei utiliza off pentru a reactiva modul automat fara a schimba punctul de acces curent sau putei utiliza any sau auto pentru a fora placa sa se reasocieze cu cel mai bun punct de acces existent. Exemplu: iwconfig eth0 ap 00:60:1D:01:23:45 iwconfig eth0 ap any iwconfig eth0 ap off rate/bit[rate] Pentru placile care accepta mai multe rate de bii, stabilete rata de bii in b/s. Rata de bii este viteza cu care sunt transmii biii pe mediu, viteza de utilizare a legaturii este mai mica din cauza partajarii mediului i a diferitelor costuri suplimentare. Putei adauga sufixul k, M sau G la valoare (multiplicator zecimal: 10^3, 10^6 i 10^9 b/s) sau putei adauga numarul potrivit de ,,0"-uri. Valorile mai mici de 1000 sunt specifice placii, de obicei un index in lista de viteze de bii. Folosii auto pentru a selecta modul automat de rata de bii (revenire la o rata mai mica pe canalele cu zgomot), care este implicit pentru majoritatea placilor, i fixed pentru a reveni la valoarea fixa. Daca specificai o valoare a ratei de bii i adaugai auto, controlorul va utiliza toate ratele de bii mai mici i egale cu aceasta valoare. Exemple: iwconfig eth0 rate 11M iwconfig eth0 rate auto iwconfig eth0 rate 5.5M auto txpower Pentru placile care accepta mai multe puteri de transmisie, stabilete puterea de transmisie in dBm. Daca W este puterea in wai, puterea in dBm este P = 30 + 10.log(W). Daca valoarea este postfixata de mW, aceasta va fi convertita automat in dBm. In plus, on i off activeaza i dezactiveaza receptorul radio, iar auto i fixat activeaza i dezactiveaza controlul puterii (daca aceste funcii sunt disponibile). Exemple: iwconfig eth0 txpower 15 iwconfig eth0 txpower 30mW iwconfig eth0 txpower auto iwconfig eth0 txpower off sens Stabilete pragul de sensibilitate. Acesta definete cat de sensibila este cartela la condiii de funcionare precare (semnal slab, interferene). Se presupune ca valorile pozitive sunt valoarea bruta utilizata de hardware sau un procent, iar valorile negative sunt considerate dBm. In funcie de implementarea hardware, acest parametru poate controla diverse funcii. In cazul placilor moderne, acest parametru controleaza, de obicei, pragul de transfer/roaming, cel mai mic nivel de semnal pentru care hardware-ul ramane asociat cu punctul de acces curent. Cand nivelul semnalului scade sub acest prag, placa incepe sa caute un punct de acces nou/mai bun. Unele placi pot utiliza numarul de radiobalize ratate pentru a declana acest lucru. In cazul unei densitai mari de puncte de acces, un prag mai ridicat asigura ca placa este intotdeauna asociata cu cel mai bun punct de acces, in timp ce in cazul unei densitai scazute de puncte de acces, un prag mai mic reduce la minimum numarul de transferuri euate. Pe o placa mai veche, acest parametru controleaza de obicei pragul de amanare, cel mai mic nivel de semnal pentru care hardware-ul considera canalul ocupat. Nivelurile de semnal care depaesc acest prag fac ca hardware-ul sa ii inhibe propria transmisie, in timp ce semnalele mai slabe decat acesta sunt ignorate, iar hardware-ul este liber sa transmita. Acest parametru este de obicei strans legat de pragul de recepie, cel mai mic nivel de semnal pentru care hardware-ul incearca sa recepioneze pachete. Stabilirea corecta a acestor praguri previne ca placa sa piarda timp cu zgomotul de fond, in timp ce primete in continuare transmisii slabe. Proiectele moderne par sa controleze aceste praguri in mod automat. Exemplu: iwconfig eth0 sens -80 iwconfig eth0 sens 2 retry Majoritatea placilor dispun de retransmisii MAC, iar unele permit stabilirea comportamentului mecanismului de reluare. Pentru a stabili numarul maxim de incercari, introducei limit ,,valoare". Aceasta este o valoare absoluta (fara unitate) i valoarea implicita (atunci cand nu se specifica nimic). Pentru a stabili durata maxima de timp in care MAC ar trebui sa incerce din nou, introducei lifetime ,,valoare". In mod implicit, aceasta valoare este in secunde; adaugai sufixul m sau u pentru a specifica valori in milisecunde sau microsecunde. De asemenea, putei adauga modificatorii short, long, min i max. In cazul in care placa accepta modul automat, acetia definesc marginile limitei sau ale duratei de viaa. Unele alte placi definesc valori diferite in funcie de dimensiunea pachetelor, de exemplu, in 802.11 min limit este limita de reintentare scurta (pachete non RTS/CTS). Exemple: iwconfig eth0 retry 16 iwconfig eth0 retry lifetime 300m iwconfig eth0 retry short 12 iwconfig eth0 retry min limit 8 rts[_threshold] RTS/CTS adauga o negociere inainte de fiecare transmisie de pachete pentru a se asigura ca canalul este liber. Acest lucru adauga costuri suplimentare, dar crete performana in cazul nodurilor ascunse sau al unui numar mare de noduri active. Acest parametru stabilete dimensiunea celui mai mic pachet pentru care nodul trimite RTS; o valoare egala cu dimensiunea maxima a pachetului dezactiveaza mecanismul. De asemenea, putei stabili acest parametru la auto, fixed sau off. Exemple: iwconfig eth0 rts 250 iwconfig eth0 rts off frag[mentation_threshold] Fragmentarea permite imparirea unui pachet IP intr-o rafala de fragmente mai mici transmise pe suport. In cele mai multe cazuri, acest lucru adauga costuri suplimentare, dar intr-un mediu foarte zgomotos, acest lucru reduce penalizarea erorilor i permite pachetelor sa treaca prin rafale de interferene. Acest parametru stabilete dimensiunea maxima a fragmentelor, care este intotdeauna mai mica decat dimensiunea maxima a pachetului. Acest parametru poate controla, de asemenea, Frame Bursting, disponibil pe unele placi, capacitatea de a trimite mai multe pachete IP impreuna. Acest mecanism va fi activat daca dimensiunea fragmentului este mai mare decat dimensiunea maxima a pachetului. De asemenea, putei stabili acest parametru la auto, fixed sau off. Exemple: iwconfig eth0 frag 512 iwconfig eth0 frag off key/enc[ryption] Se utilizeaza pentru a manipula cheile de criptare sau de distorsionare ,,scrambling" i modul de securitate. Pentru a stabili cheia de criptare curenta, trebuie doar sa introducei cheia in cifre hexazecimale sub forma XXXX-XXXX-XXXX-XXXX sau XXXXXXXX. Pentru a stabili o alta cheie decat cheia curenta, antepunei sau adaugai [index] la cheia in sine (acest lucru nu va schimba care este cheia activa). De asemenea, putei introduce cheia sub forma unui ir ASCII, utilizand prefixul s:. In prezent, fraza de trecere nu este acceptata. Pentru a schimba cheia care este cea activa in acel moment, trebuie doar sa introducei [index] (fara a introduce nicio valoare a cheii). off i on dezactiveaza i reactiveaza criptarea. Modul de securitate poate fi open sau restricted, iar semnificaia sa depinde de placa utilizata. In cazul majoritaii placilor, in modul open nu se utilizeaza autentificarea, iar placa poate accepta, de asemenea, sesiuni necriptate, in timp ce in modul restricted sunt acceptate numai sesiuni criptate, iar placa va utiliza autentificarea, daca este disponibila. Daca trebuie sa definii mai multe chei sau sa definii o cheie i sa schimbai cheia activa, trebuie sa utilizai mai multe directive key. Argumentele pot fi puse in orice ordine, ultimul va avea prioritate. Exemple: 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 Utilizat pentru a manipula parametrii i modul schemei de gestionare a energiei. Pentru a stabili perioada dintre treziri, introducei period ,,valoare". Pentru a stabili timpul de ateptare inainte de a reveni la somn, introducei timeout ,,valoare". Pentru a stabili nivelul generic de economisire a energiei, introducei saving ,,valoare". De asemenea, putei adauga modificatorii min i max. In mod implicit, aceste valori sunt in secunde, adaugai sufixul m sau u pentru a specifica valori in milisecunde sau microsecunde. Uneori, aceste valori sunt fara unitai (numar de perioade de radiobalizare, oprire la intervale regulate, procentaj sau similar). off i on dezactiveaza i reactiveaza gestionarea energiei. In cele din urma, putei stabili modul de gestionare a consumului de energie la all (primete toate pachetele), unicast (primete numai pachete unicast, respinge pachete multicast i broadcast) i multicast (primete numai pachete multicast i broadcast, respinge pachete unicast). Exemple: iwconfig eth0 power period 2 iwconfig eth0 power 500m unicast iwconfig eth0 power timeout 300u all iwconfig eth0 power saving 3 iwconfig eth0 power off iwconfig eth0 power min period 2 power max period 4 modu[lation] Foreaza placa sa utilizeze un anumit set de modulaii. Placile moderne accepta diverse modulaii, unele standard, cum ar fi 802.11b sau 802.11g, iar altele proprietare. Aceasta comanda foreaza placa sa utilizeze numai setul specific de modulaii listate in linia de comanda. Aceasta poate fi utilizata pentru a remedia problemele de interoperabilitate. Lista de modulaii disponibile depinde de placa/controlor i poate fi afiata folosind iwlist modulation. Reinei ca este posibil ca unele placi/controlori sa nu poata selecta fiecare modulaie listata in mod independent, ci unele pot fi prezentate ca grup. De asemenea, putei stabili acest parametru la auto, lasand placa/controlorul sa procedeze cat mai bine. Exemple: iwconfig eth0 modu 11g iwconfig eth0 modu CCK OFDMa iwconfig eth0 modu auto commit Este posibil ca unele placi sa nu aplice imediat modificarile efectuate prin Extensiile wireless (acestea pot atepta pentru a agrega modificarile sau le pot aplica numai atunci cand placa este activata prin ifconfig). Aceasta comanda (atunci cand este disponibila) foreaza placa sa aplice toate modificarile in ateptare. In mod normal, acest lucru nu este necesar, deoarece placa va aplica in cele din urma modificarile, dar poate fi util pentru depanare. DISPLAY Pentru fiecare dispozitiv care accepta extensii fara fir, iwconfig va afia numele protocolului MAC MAC protocol utilizat (numele dispozitivului pentru protocoalele proprietare), ESSID (numele reelei), NWID, frequency/channel (frecvena sau canalul), sensitivity (sensibilitatea), modul de funcionare, adresa punctului de acces Access Point, bit-rate (rata de bii), RTS threshold (pragul RTS), fragmentation threshold (pragul de fragmentare), encryption key (cheia de criptare) i parametrii de gestionare a energiei power management (in funcie de disponibilitate). Parametrii afiai au aceeai semnificaie i valori ca i parametrii pe care ii putei configura, va rugam sa consultai partea anterioara pentru o explicaie detaliata a acestora. Unii parametri sunt afiai doar intr-o forma scurta/abreviata (cum ar fi criptarea). Putei utiliza iwlist(8) pentru a obine toate detaliile. Unii parametri au doua moduri (cum ar fi ,,bitrate"). Daca valoarea este prefixata cu ,,=", inseamna ca parametrul este fixat i forat la acea valoare, daca este prefixat cu ,,:", parametrul este in mod automat i este afiata valoarea curenta (i se poate schimba). Access Point/Cell O adresa egala cu 00:00:00:00:00:00 inseamna ca placa nu a reuit sa se asocieze cu un punct de acces (cel mai probabil o problema de configurare). Parametrul Access Point va fi afiat ca Cell in modul ad-hoc (din motive evidente), dar in rest funcioneaza la fel. Daca /proc/net/wireless exista, iwconfig va afia, de asemenea, coninutul acestuia. Reinei ca aceste valori vor depinde de controlor i de particularitaile hardware, aa ca trebuie sa consultai documentaia controlorului pentru interpretarea corecta a acestor valori. Link quality Calitatea generala a legaturii. Se poate baza pe nivelul de contenie sau interferena, rata de eroare pe bit sau pe cadru, calitatea semnalului recepionat, o anumita sincronizare sau o alta masuratoare hardware. Aceasta este o valoare agregata i depinde in totalitate de controlor i de hardware. Signal level Intensitatea semnalului recepionat (RSSI - cat de puternic este semnalul recepionat). Poate fi in unitai arbitrare sau in dBm, iwconfig utilizeaza metainformaiile controlorului pentru a interpreta valoarea bruta data de /proc/net/wireless i pentru a afia unitatea adecvata sau valoarea maxima (utilizand aritmetica pe 8 bii). In modul Ad-Hoc, aceasta poate fi nedefinita i ar trebui sa utilizai iwspy. Noise level Nivelul zgomotului de fond (atunci cand nu se transmite niciun pachet). Comentarii similare celor pentru Signal level (nivelul semnalului). Rx invalid nwid Numarul de pachete primite cu un NWID sau ESSID diferit. Utilizat pentru a detecta probleme de configurare sau existena unei reele adiacente (pe aceeai frecvena). Rx invalid crypt Numarul de pachete pe care hardware-ul nu a reuit sa le decripteze. Acesta poate fi utilizat pentru a detecta configurarile de criptare nevalide. Rx invalid frag Numarul de pachete pentru care hardware-ul nu a reuit sa reasambleze corect fragmentele din stratul de legatura (cel mai probabil lipsea unul). Tx excessive retries Numarul de pachete pe care hardware-ul nu a reuit sa le livreze. Cele mai multe protocoale MAC vor incerca din nou pachetul de mai multe ori inainte de a renuna. Invalid misc Alte pachete pierdute in legatura cu anumite operaii fara fir. Missed beacon Numarul de radiobalize periodice de la celula sau de la punctul de acces pe care le-am ratat. Radiobalizele sunt trimise la intervale regulate pentru a menine coordonarea celulei, neprimirea lor indica de obicei faptul ca placa este in afara razei de aciune. AUTOR Jean Tourrilhes - jt@hpl.hp.com FIIERE /proc/net/wireless CONSULTAI I ifconfig(8), iwspy(8), iwlist(8), iwevent(8), iwpriv(8), wireless(7). TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . wireless-tools 30 martie 2006 IWCONFIG(8)