IWCONFIG(8) Podrecznik programisty Linuksa IWCONFIG(8) NAZWA iwconfig - konfiguruje bezprzewodowy interfejs sieciowy SKLADNIA iwconfig [interfejs] iwconfig interfejs [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 OPIS Iwconfig jest podobny do ifconfig(8), lecz przeznaczony do interfejsow bezprzewodowych. Uzywa sie go do ustawiania parametrow interfejsow sieciowych, ktore sa charakterystyczne do dzialan bezprzewodowych (np. czestotliwosc). Iwconfig mozna uzyc rowniez do wyswietlenia tych parametrow oraz statystyk bezprzewodowych (pozyskanych z /proc/net/wireless). Wszystkie parametry i statystyki zaleza od urzadzenia. Kazdy sterownik dostarcza jedynie czesc z nich, w zaleznosci od obslugi sprzetowej, a ich zakres wartosci moze sie zmieniac. Prosze przeczytac strone podrecznika systemowego danego sterownika, aby dowiedziec sie wiecej. PARAMETRY essid Ustawia ESSID (lub nazwe sieci (ang. Network Name) - w czesci produktow moze byc to nazwane rowniez identyfikatorem domeny (ang. Domain ID)). ESSID jest uzywany do identyfikacji komorek, ktore sa czescia tej samej wirtualnej sieci. W przeciwienstwie do adresu AP lub NWID, ktore definiuja pojedyncza komorke, ESSID moga definiowac grupe komorek polaczonych przez powtarzacze lub infrastrukture sieciowa, gdzie uzytkownik moze poruszac sie w sposob przezroczysty. Czesc kart pozwala wylaczyc sprawdzanie ESSID (ESSID promiscuous) za pomoca przelacznika off lub any (i wlaczyc je za pomoca on). Jesli uzywany ESSID jest jedna z tych specjalnych nazw (off, on lub any), nalezy uzyc -- aby je zacytowac. Przyklady : iwconfig eth0 essid any iwconfig eth0 essid "Moja siec" iwconfig eth0 essid -- "ANY" nwid Ustawia identyfikator sieci (Network ID). Wszystkie polaczone sieci dziela to samo medium, a ten parametr jest uzywany do ich rozroznienia (tworzy logicznie wspolistniejace sieci) i zidentyfikowania wezlow nalezacych do tej samej komorki. Parametr jest uzywany tylko do kart przed protokolem 802.11, ktory do tego celu uzywa ESSID-u i adresu AP. Czesc kart pozwala wylaczyc sprawdzanie Network ID (NWID promiscuous) za pomoca przelacznika off (i wlaczyc je za pomoca on). Przyklady : iwconfig eth0 nwid AB34 iwconfig eth0 nwid off nick[name] Ustawia nick lub nazwe sieci. Czesc produktow 802.11 definiuje ja, lecz nie jest one uzywana gdy bierze sie pod uwage protokoly (MAC, IP, TCP) i jest kompletnie bezuzyteczna przy konfiguracji. Uzywa jej jedynie czesc narzedzi diagnostycznych. Przyklad: iwconfig eth0 nickname "Moj wezel Linuksowy" mode Ustawia tryb dzialania urzadzenia, zalezny od topologii sieci. Moze byc to: Ad-Hoc (siec tworzona jedynie z pojedynczej komorki bez punktu dostepowego), Managed (wezel polaczony z siecia utworzona z wielu punktow dostepowych, z wymiana miedzy nimi), Master (wezel odpowiada za synchronizacje lub dziala jako punkt dostepowy), Repeater (wezel przekazuje pakiety miedzy innymi wezlami sieci bezprzewodowej), Secondary (wezel dziala jako zapasowy punkt dostepowy lub synchronizacyjny), Monitor (wezel nie jest zwiazany z zadna komorka i pasywnie monitoruje wszystkie pakiety na danej czestotliwosci) lub Auto. Przyklad: iwconfig eth0 mode Managed iwconfig eth0 mode Ad-Hoc freq/channel Ustawia czestotliwosc lub kanal na ktorym dziala urzadzenie. Wartosc ponizej 1000 jest uwazana za numer kanalu, a wieksza jest czestotliwoscia w Hz. Do wartosci mozna dodac k, M lub G (np. "2.46G" w przypadku czestotliwosci 2.46 GHz) lub odpowiednia liczbe zer. Kanaly numeruje sie zwykle od 1, a do uzyskania calkowitej liczby kanalow, dostepnych czestotliwosci i wyswietlenia biezacej czestotliwosci kanalu mozna uzyc iwlist(8). W zaleznosci od regulacji prawnych, czesc czestotliwosci/kanalow moze byc niedostepna. Przy uzywaniu trybu Managed, wiekszosc punktow dostepowych narzuca kanal, a sterownik moze odmowic ustawienia czestotliwosci. W trybie Ad-Hoc, ustawienie czestotliwosci moze byc uzyte tylko przy inicjowaniu tworzenia komorki i moze zostac zignorowana przy laczeniu sie do istniejacej komorki. Mozna rowniez uzyc off lub auto, aby pozwolic karcie wybrac najlepszy kanal (jesli jest to obslugiwane). Przyklady : iwconfig eth0 freq 2422000000 iwconfig eth0 freq 2.422G iwconfig eth0 channel 3 iwconfig eth0 channel auto ap Wymusza na karcie zarejestrowanie sie w punkcie dostepowym o podanym adresie, jesli to mozliwe. Adres ten jest identyfikatorem komorki punktu dostepowego, zgodnie z wartoscia zwrocona ze skanowania bezprzewodowego, ktora moze roznic sie od jego sieciowego adresu MAC. Jesli lacze bezprzewodowe jest typu punkt-punkt, nalezy ustawic adres drugiego konca polaczenia. W przypadku polaczen ad-hoc, nalezy ustawic identyfikator komorki sieci ad-hoc. Gdy jakosc polaczeniu spadnie do zbyt niskiej wartosci, sterownik moze przywrocic tryb automatyczny (karta wybiera najlepszy punkt dostepowy w zasiegu). Mozna uzyc rowniez przelacznika off, aby ponownie wlaczyc tryb automatyczny bez zmiany biezacego punktu dostepowego albo przelacznika any lub auto, aby wymusic ponowne polaczenie z najlepszym obecnie punktem dostepowym. Przyklad: iwconfig eth0 ap 00:60:1D:01:23:45 iwconfig eth0 ap any iwconfig eth0 ap off rate/bit[rate] W przypadku kart obslugujacych wiele przepustowosci, ustawia zadana w b/s. Przepustowosc jest szybkoscia transmisji bitow przez nosnik, predkosc widoczna dla uzytkownika jest nizsza, z powodu wspoldzielenia nosnika i dodatkowych czynnikow. Do wartosci mozna dodac przyrostek k, M lub G (mnoznik dziesietny: 10^3, 10^6 i 10^9 b/s) lub odpowiednia liczbe zer. Interpretacja wartosci ponizej 1000 jest zalezna od karty, zwykle odnosi sie do indeksu w liscie przepustowosci. Wartosc auto pozwala wybrac automatyczny tryb przepustowosci (zmieniajac sie na nizsza, w zatloczonych kanalach), ktora jest tez wartoscia domyslna dla wiekszosci kart, a fixed pozwala cofnac sie do konkretnego ustawienia. Jesli poda sie wartosc przepustowosci oraz dopisze auto, sterownik bedzie mogl uzyc wszystkich przepustowosci nizszych lub rownych wartosci podanej. Przyklady : iwconfig eth0 rate 11M iwconfig eth0 rate auto iwconfig eth0 rate 5.5M auto txpower W kartach obslugujacych wiele mocy transmisji, ustawia moc transmisji w dBm. Jesli W jest moca w watach, moc w dBm to P = 30 + 10.log(W). Jesli po wartosci dopisze sie mW, zostanie ona automatycznie przeliczona na dBm. Dodatkowo, on i off wlaczaja i wylaczaja radio, a auto oraz fixed wlacza i wylacza kontrole mocy (jesli te funkcje sa dostepne). Przyklady : iwconfig eth0 txpower 15 iwconfig eth0 txpower 30mW iwconfig eth0 txpower auto iwconfig eth0 txpower off sens Ustawia prog czulosci. Okresla sie w ten sposob czulosc karty na zle warunki dzialania (slaby sygnal, interferencje). Wartosci dodatnie sa przyjmowane za surowe wartosci uzywane przez dana karte lub wielkosci procentowe, wartosci ujemne sa traktowane jako dBm. W zaleznosci od implementacji sprzetowej, ten parametr moze byc odpowiedzialny za rozne funkcje. Na nowoczesnych kartach parametr ten kontroluje zwykle prog przelaczenia stacji bazowej, czyli najnizszy poziom sygnalu, przy ktorym karta wciaz pozostaje powiazana z danym punktem dostepowym. Gdy poziom sygnalu spadnie ponizej progu, karta zaczyna wyszukiwac nowy/lepszy punkt dostepowy. Niektore karty moga uzywac do tego celu liczby zgubionych ramek kontrolnych. W przypadku duzego zageszczenia punktow dostepowych, wyzszy prog moze zapewnic sytuacje, gdy karta jest zawsze polaczona z najlepszym punktem dostepowym, natomiast przy nizszej liczbie punktow dostepowych, nizszy prog minimalizuje liczbe nieudanych przelaczen. W starszych kartach parametr ten zwykle kontroluje prog odraczania, najnizszy poziom sygnalu, dla ktorego karta uwaza kanal za zajety. Jesli poziom sygnalu znajduje sie powyzszej tego progu, to powstrzymuje on karte przed wykonywaniem na nim transmisji, natomiast sygnal slabszy od progu skutkuje ignorowaniem go przez karte, ktora moze wykorzystac dany kanal. Zwykle jest to mocno zalezne od progu odbioru, najnizszego poziomu sygnalu, dla ktorego karta przystepuje do odbioru pakietow. Poprawne ustawienie tych progow zapobiega marnowaniu czasu przez karte na szumach tla, jednoczesnie pozwalajac na odbior slabego sygnalu. Nowsze rozwiazania polegaja na automatycznej kontroli opisywanych progow. Przyklad: iwconfig eth0 sens -80 iwconfig eth0 sens 2 retry Wiekszosc kart ma mozliwosc retransmisji MAC, a czesc pozwala na ustawienie zachowania tego mechanizmu. Aby ustawic maksymalna wartosc powtorzen, nalezy uzyc limit wartosc. Jest to wartosc absolutna (bez jednostki) i domyslna (gdy niczego sie nie poda). Aby ustawic maksymalna dlugosc czasu powtorzenia MAC, nalezy wprowadzic lifetime watosc. Domyslnie, wartosc jest wyrazona w sekundach; mozna rowniez dopisac przyrostek m lub u aby okreslic jednostke jako milisekundy lub mikrosekundy. Mozna rowniez dodac modyfikatory short, long, min i max. Jesli karta obsluguje tryb automatyczny, to definiuja one okreslone limity. Czesc innych kart definiuje rozne wartosci w zaleznosci od rozmiaru pakietu, np. w 802.11 min limit jest krotkim limitem ponowienia (pakietow niebedacych RTS/CTS). Przyklady : iwconfig eth0 retry 16 iwconfig eth0 retry lifetime 300m iwconfig eth0 retry short 12 iwconfig eth0 retry min limit 8 rts[_threshold] RTS/CTS dodaje wymiane potwierdzen przed kazda transmisja pakietu, w celu upewnienia sie, ze kanal jest wolny. Dodaje to narzutu, lecz zwieksza wydajnosc w sytuacjach istnienia ukrytych wezlow lub wielu aktywnych wezlow. Parametr ustawia rozmiar najmniejszego pakietu, dla ktorego wezel wysyla RTS; wartosc rowna maksymalnemu rozmiarowi pakietu wylacza mechanizm. Mozna rowniez ustawic ten parametr na auto, fixed lub off. Przyklady : iwconfig eth0 rts 250 iwconfig eth0 rts off frag[mentation_threshold] Fragmentacja pozwala na podzielenie pakietu IP na serie mniejszych, transmitowanych fragmentow. Zwykle zwieksza sie w ten sposob narzut, lecz w bardzo zakloconych miejscach redukuje straty zwiazane z bledami i pozwala pakietom przedostac sie przez serie interferencji. Parametr ustawia maksymalny rozmiar fragmentu, ktory jest zawsze mniejszy niz maksymalny rozmiar pakietu. Parametr moze rowniez kontrolowac technike Frame Bursting dostepna w niektorych kartach, ktora pozwala na rownoczesne wyslanie kilku pakietow IP. Ten mechanizm bedzie wlaczony, jesli rozmiar fragmentu jest wiekszy niz maksymalny rozmiar pakietu. Dostepne sa rowniez nastepujace wartosci: auto, fixed i off. Przyklady : iwconfig eth0 frag 512 iwconfig eth0 frag off key/enc[ryption] Uzywane do ustawiania szyfrowania lub kluczy scrambling i trybu bezpieczenstwa. Aby ustawic biezacy klucz szyfrowania, nalezy go podac w postaci szesnastkowej jako XXXX-XXXX-XXXX-XXXX lub XXXXXXXX. Aby zmienic klucz inny niz biezacy, nalezy dodac do klucza przedrostek lub przyrostek [numer] (nie zmieni sie w ten sposob aktywnego klucza). Mozna rowniez podac klucz bedacy lancuchem ASCII dodajac przedrostek s:. Hasla (passphrase) nie sa obecnie obslugiwane. Aby zmienic to, ktory klucz jest obecnie aktywny nalezy wpisac [numer] (bez zadnej wartosci klucza). Przelacznik off wylacza, a on wlacza szyfrowanie. Trybem bezpieczenstwa moze byc open lub restricted, a jego znaczenie zalezy od uzywanej karty. W wiekszosci kart w trybie open nie uzywa sie uwierzytelniania, a karta moze rowniez akceptowac sesje nieszyfrowane, z kolei w trybie restricted uzywane sa wylacznie sesje szyfrowane, a karta bedzie uzywala uwierzytelniania, jesli jest ono dostepne. Jesli konieczne jest ustawienie wielu kluczy lub ustawienie klucza i zmiana aktywnego klucza, to konieczne bedzie uzycie kilku polecen key. Argumenty moga byc podane w dowolnej kolejnosci, przy czym pierwszenstwo ma ostatnie. Przyklady : 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 Sluzy do zmiany trybu i parametrow schematu zarzadzania energia. Do ustawienia okresu miedzy wybudzeniami, nalezy wpisac period wartosc. Aby ustawic czas oczekiwania przed ponownym przejsciem w tryb uspienia, nalezy wpisac timeout wartosc. Do ustawienia podstawowego poziomu oszczedzania energii sluzy opcja saving wartosc. Mozna rowniez dodac modyfikatory min i max. Domyslnie wartosci te sa sekundowe, przez dodanie przyrostka m mozna uzyskac milisekundy, a u mikrosekundy. Czasami wartosci nie posiadaja jednostki (liczba okresow ramek kontrolnych, dwell, wartosci procentowe itp.) off i on wylaczaja i wlaczaja zarzadzenie energia. Mozna rowniez ustawic tryb zarzadzania energia na all (otrzymywanie wszystkich pakietow), unicast (otrzymywanie tylko pakietow unicast, odrzucanie pakietow multicast i broadcast) i multicast (otrzymywanie pakietow multicast i broadcast, odrzucanie unicast). Przyklady : 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] Wymusza uzycie przez karte okreslonego zestawu modulacji. Nowe karty obsluguja rozne modulacje, z ktorych czesc jest standardowa (np. 802.11b i 802.11g), a czesc zastrzezona. To polecenie wymusza uzywanie wylacznie okreslonego zestawu modulacji podanego w wierszu polecenia. Mozna w ten sposob ominac problemy z kompatybilnoscia. Lista dostepnych modulacji zalezy od karty i sterownika. Mozna ja wyswietlic poleceniem iwlist modulation. Prosze zauwazyc, ze czesc kart i sterownikow moze nie obslugiwac wyboru pojedynczej modulacji, czesc moze funkcjonowac jako grupa. Mozna tez ustawic ten parametr na auto. Przyklady : iwconfig eth0 modu 11g iwconfig eth0 modu CCK OFDMa iwconfig eth0 modu auto commit Czesc kart moze nie wlaczac natychmiast zmian dokonanych za pomoca rozszerzen bezprzewodowych (moze czekac na kolejne zmiany lub aplikowac je jedynie gdy karta jest wlaczana za pomoca ifconfig). To polecenie (gdy to dostepne) wymusza na karcie wprowadzenie w zycie wszystkich oczekujacych zmian. Zwykle nie jest to konieczne, poniewaz karta ostatecznie wprowadzi zmiany w zycie, lecz moze byc przydatne do debugowania. DISPLAY Przy kazdym urzadzeniu obslugujacym rozszerzenia bezprzewodowe, iwconfig bedzie wyswietlal nazwe uzywanego protokolu MAC (pole MAC protocol) - nazwe urzadzenia do protokolow wlasnosciowych, ESSID (nazwe sieciowa), NWID, frequency (czestotliwosc lub kanal), sensitivity (czulosc), mode (tryb dzialania), Access Point (adres punktu dostepowego), bit-rate (przepustowosc), RTS threshold (prog RTS), fragmentation threshold (prog fragmentacji), encryption key (klucz szyfrowania) i power management (ustawienia zarzadzania energia) - w zaleznosci od dostepnosci. Wyswietlane parametry maja takie samo znaczenie i wartosci jak parametry ktore mozna ustawic, prosze przejrzec poprzednia czesc strony podrecznika systemowego, aby przeczytac szczegolowe informacje na ten temat. Czesc parametrow jest wyswietlanych jedynie w skroconej postaci (np. szyfrowanie). Wiecej szczegolow mozna wypisac poleceniem iwlist(8). Czesc parametrow ma dwa tryby (np. przepustowosc). Jesli polecenie jest poprzedzone "=", to oznacza to, ze parametr okreslony i wymuszony do podanej wartosci, natomiast gdy jest poprzedzony ":", wskazuje to na tryb automatyczny parametru i pokazywana jest wartosc biezaca (moze sie zmienic). Access Point/Cell Adres rowny 00:00:00:00:00:00 oznacza, ze karta nie polaczyla sie z punktem dostepowym (z reguly jest to blad konfiguracji). Parametr Access Point (punkt dostepowy) bedzie pokazywany w trybie ad-hoc pod nazwa Cell (komorka - z oczywistych wzgledow), lecz poza nazwa jest taki sam. Jesli /proc/net/wireless istnieje, to iwconfig wyswietli rowniez jego zawartosc. Prosze zauwazyc, ze te wartosci beda zalezec od konkretnej karty i sterownika, tak wiec aby moc je poprawnie interpretowac konieczne jest zapoznanie sie z dokumentacja sterownika. Link quality Ogolna jakosc polaczenia. Moze wyrazac poziom konkurencji lub interferencji, liczbe bledow bitowych lub bledow ramki, jakosc otrzymywanego sygnalu, synchronizacje czasowa lub inne wskazania sprzetowe. Jest to wartosc powstala w oparciu o wiele danych i zalezy calkowicie od sterownika i sprzetu. Signal level Sila sygnalu (RSSI - jak silny jest otrzymywany sygnal). Moze byc wyrazona w arbitralnych jednostkach lub dBm, iwconfig uzywa metainformacji ze sterownika do interpretacji wartosci surowej podanej w /proc/net/wireless i wyswietla wlasciwa jednostke lub wartosc maksymalna (uzywajac arytmetyki osmiobitowej). W trybie Ad-Hoc wartosc moze byc niezdefiniowana - nalezy wowczas skorzystac z iwspy. Noise level Poziom zaklocen tla (gdy pakiety nie sa transmitowane). Tego parametru tycza sie podobne uwagi co Signal level. Rx invalid nwid Liczba pakietow otrzymanych z innym NWID lub ESSID. Uzywana do wykrywania problemow z konfiguracja lub istnienia sasiednich sieci (na tej samej czestotliwosci). Rx invalid crypt Liczba pakietow, ktorych karta nie byla w stanie odszyfrowac. Wartosc mozna wykorzystac do wykrywania nieprawidlowych ustawien szyfrowania. Rx invalid frag Liczba pakietow, dla ktorych karta nie byla w stanie poprawnie polaczyc fragmentow w warstwie lacza danych (najprawdopodobniej brakowalo ktoregos). Tx excessive retries Liczba pakietow, ktorych nie udalo sie dostarczyc karcie. Wiekszosc protokolow MAC bedzie starala sie kilkukrotnie wyslac pakiet ponownie. Invalid misc Inne pakiety zagubione w zwiazku z okreslonymi operacjami bezprzewodowymi. Missed beacon Liczba zagubionych ramek kontrolnych z komorki lub punktu dostepowego. Ramki kontrolne sa wysylane w regularnych odstepach czasu w celu utrzymania koordynacji komorki, niepowodzenie w ich otrzymaniu wskazuje zwykle, ze karta znalazla sie poza zasiegiem. AUTOR Jean Tourrilhes - jt@hpl.hp.com PLIKI /proc/net/wireless ZOBACZ TAKZE ifconfig(8), iwspy(8), iwlist(8), iwevent(8), iwpriv(8), wireless(7). TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . wireless-tools 30 marca 2006 IWCONFIG(8)