NAZWA
iwconfig - konfiguruje bezprzewodowy interfejs sieciowy
SKŁADNIA
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 interfejsów bezprzewodowych. Używa się go do ustawiania parametrów interfejsów sieciowych, które są charakterystyczne do działań bezprzewodowych (np. częstotliwość). Iwconfig można użyć również do wyświetlenia tych parametrów oraz statystyk bezprzewodowych (pozyskanych z /proc/net/wireless).
Wszystkie parametry i statystyki zależą od urządzenia. Każdy sterownik dostarcza jedynie część z nich, w zależności od obsługi sprzętowej, a ich zakres wartości może się zmieniać. Proszę przeczytać stronę podręcznika systemowego danego sterownika, aby dowiedzieć się więcej.
PARAMETRY
essid |
Ustawia ESSID (lub nazwę sieci (ang. Network Name) - w części produktów może być to nazwane również identyfikatorem domeny (ang. Domain ID)). ESSID jest używany do identyfikacji komórek, które są częścią tej samej wirtualnej sieci. |
W przeciwieństwie do
adresu AP lub NWID, które definiują
pojedynczą komórkę, ESSID mogą
definiować grupę komórek
połączonych przez powtarzacze lub
infrastrukturę sieciową, gdzie użytkownik
może poruszać się w sposób
przezroczysty.
Część kart pozwala wyłączyć
sprawdzanie ESSID (ESSID promiscuous) za pomocą
przełącznika off lub any (i
włączyć je za pomocą on).
Jeśli używany ESSID jest jedną z tych
specjalnych nazw (off, on lub any),
należy użyć -- aby je zacytować.
Przykłady :
iwconfig eth0 essid any
iwconfig eth0 essid "Moja siec"
iwconfig eth0 essid -- "ANY"
nwid |
Ustawia identyfikator sieci (Network ID). Wszystkie połączone sieci dzielą to samo medium, a ten parametr jest używany do ich rozróżnienia (tworzy logicznie współistniejące sieci) i zidentyfikowania węzłów należących do tej samej komórki. |
Parametr jest używany
tylko do kart przed protokołem 802.11, który do
tego celu używa ESSID-u i adresu AP.
Część kart pozwala wyłączyć
sprawdzanie Network ID (NWID promiscuous) za pomocą
przełącznika off (i włączyć
je za pomocą on).
Przykłady :
iwconfig eth0 nwid AB34
iwconfig eth0 nwid off
nick[name]
Ustawia nick lub nazwę
sieci. Część produktów 802.11
definiuje ją, lecz nie jest one używana gdy bierze
się pod uwagę protokoły (MAC, IP, TCP) i jest
kompletnie bezużyteczna przy konfiguracji. Używa
jej jedynie część narzędzi
diagnostycznych.
Przykład:
iwconfig eth0 nickname "Moj wezel
Linuksowy"
mode |
Ustawia tryb działania urządzenia, zależny od topologii sieci. Może być to: Ad-Hoc (sieć tworzona jedynie z pojedynczej komórki bez punktu dostępowego), Managed (węzeł połączony z siecią utworzoną z wielu punktów dostępowych, z wymianą między nimi), Master (węzeł odpowiada za synchronizację lub działa jako punkt dostępowy), Repeater (węzeł przekazuje pakiety między innymi węzłami sieci bezprzewodowej), Secondary (węzeł działa jako zapasowy punkt dostępowy lub synchronizacyjny), Monitor (węzeł nie jest związany z żadną komórką i pasywnie monitoruje wszystkie pakiety na danej częstotliwości) lub Auto. |
Przykład:
iwconfig eth0 mode Managed
iwconfig eth0 mode Ad-Hoc
freq/channel
Ustawia
częstotliwość lub kanał na którym
działa urządzenie. Wartość poniżej
1000 jest uważana za numer kanału, a większa
jest częstotliwością w Hz. Do wartości
można dodać k, M lub G (np.
"2.46G" w przypadku częstotliwości 2.46
GHz) lub odpowiednią liczbę zer.
Kanały numeruje się zwykle od 1, a do uzyskania
całkowitej liczby kanałów, dostępnych
częstotliwości i wyświetlenia
bieżącej częstotliwości kanału
można użyć iwlist(8). W
zależności od regulacji prawnych,
część
częstotliwości/kanałów może
być niedostępna.
Przy używaniu trybu Managed, większość
punktów dostępowych narzuca kanał, a
sterownik może odmówić ustawienia
częstotliwości. W trybie Ad-Hoc, ustawienie
częstotliwości może być użyte tylko
przy inicjowaniu tworzenia komórki i może
zostać zignorowana przy łączeniu się do
istniejącej komórki.
Można również użyć off lub
auto, aby pozwolić karcie wybrać najlepszy
kanał (jeśli jest to obsługiwane).
Przykłady :
iwconfig eth0 freq 2422000000
iwconfig eth0 freq 2.422G
iwconfig eth0 channel 3
iwconfig eth0 channel auto
ap |
Wymusza na karcie zarejestrowanie się w punkcie dostępowym o podanym adresie, jeśli to możliwe. Adres ten jest identyfikatorem komórki punktu dostępowego, zgodnie z wartością zwróconą ze skanowania bezprzewodowego, która może różnić się od jego sieciowego adresu MAC. Jeśli łącze bezprzewodowe jest typu punkt-punkt, należy ustawić adres drugiego końca połączenia. W przypadku połączeń ad-hoc, należy ustawić identyfikator komórki sieci ad-hoc. |
Gdy jakość
połączeniu spadnie do zbyt niskiej wartości,
sterownik może przywrócić tryb automatyczny
(karta wybiera najlepszy punkt dostępowy w
zasięgu).
Można użyć również
przełącznika off, aby ponownie
włączyć tryb automatyczny bez zmiany
bieżącego punktu dostępowego albo
przełącznika any lub auto, aby
wymusić ponowne połączenie z najlepszym
obecnie punktem dostępowym.
Przykład:
iwconfig eth0 ap 00:60:1D:01:23:45
iwconfig eth0 ap any
iwconfig eth0 ap off
rate/bit[rate]
W przypadku kart
obsługujących wiele przepustowości, ustawia
żądaną w b/s. Przepustowość jest
szybkością transmisji bitów przez
nośnik, prędkość widoczna dla
użytkownika jest niższa, z powodu
współdzielenia nośnika i dodatkowych
czynników.
Do wartości można dodać przyrostek k,
M lub G (mnożnik dziesiętny: 10^3,
10^6 i 10^9 b/s) lub odpowiednią liczbę zer.
Interpretacja wartości poniżej 1000 jest
zależna od karty, zwykle odnosi się do indeksu w
liście przepustowości. Wartość
auto pozwala wybrać automatyczny tryb
przepustowości (zmieniając się na
niższą, w zatłoczonych kanałach),
która jest też wartością
domyślną dla większości kart, a
fixed pozwala cofnąć się do
konkretnego ustawienia. Jeśli poda się
wartość przepustowości oraz dopisze
auto, sterownik będzie mógł
użyć wszystkich przepustowości niższych
lub równych wartości podanej.
Przykłady :
iwconfig eth0 rate 11M
iwconfig eth0 rate auto
iwconfig eth0 rate 5.5M auto
txpower
W kartach
obsługujących wiele mocy transmisji, ustawia moc
transmisji w dBm. Jeśli W jest mocą w
watach, moc w dBm to P = 30 + 10.log(W). Jeśli
po wartości dopisze się mW, zostanie ona
automatycznie przeliczona na dBm.
Dodatkowo, on i off włączają i
wyłączają radio, a auto oraz
fixed włącza i wyłącza
kontrolę mocy (jeśli te funkcje są
dostępne).
Przykłady :
iwconfig eth0 txpower 15
iwconfig eth0 txpower 30mW
iwconfig eth0 txpower auto
iwconfig eth0 txpower off
sens |
Ustawia próg czułości. Określa się w ten sposób czułość karty na złe warunki działania (słaby sygnał, interferencje). Wartości dodatnie są przyjmowane za surowe wartości używane przez daną kartę lub wielkości procentowe, wartości ujemne są traktowane jako dBm. W zależności od implementacji sprzętowej, ten parametr może być odpowiedzialny za różne funkcje. |
Na nowoczesnych kartach
parametr ten kontroluje zwykle próg
przełączenia stacji bazowej, czyli najniższy
poziom sygnału, przy którym karta
wciąż pozostaje powiązana z danym punktem
dostępowym. Gdy poziom sygnału spadnie
poniżej progu, karta zaczyna wyszukiwać
nowy/lepszy punkt dostępowy. Niektóre karty
mogą używać do tego celu liczby zgubionych
ramek kontrolnych. W przypadku dużego zagęszczenia
punktów dostępowych, wyższy próg
może zapewnić sytuację, gdy karta jest zawsze
połączona z najlepszym punktem dostępowym,
natomiast przy niższej liczbie punktów
dostępowych, niższy próg minimalizuje
liczbę nieudanych przełączeń.
W starszych kartach parametr ten zwykle kontroluje
próg odraczania, najniższy poziom sygnału,
dla którego karta uważa kanał za
zajęty. Jeśli poziom sygnału znajduje
się powyższej tego progu, to powstrzymuje on
kartę przed wykonywaniem na nim transmisji, natomiast
sygnał słabszy od progu skutkuje ignorowaniem go
przez kartę, która może wykorzystać
dany kanał. Zwykle jest to mocno zależne od progu
odbioru, najniższego poziomu sygnału, dla
którego karta przystępuje do odbioru
pakietów. Poprawne ustawienie tych progów
zapobiega marnowaniu czasu przez kartę na szumach
tła, jednocześnie pozwalając na odbiór
słabego sygnału. Nowsze rozwiązania
polegają na automatycznej kontroli opisywanych
progów.
Przykład:
iwconfig eth0 sens -80
iwconfig eth0 sens 2
retry |
Większość kart ma możliwość retransmisji MAC, a część pozwala na ustawienie zachowania tego mechanizmu. |
Aby ustawić
maksymalną wartość powtórzeń,
należy użyć limit
wartość. Jest to wartość
absolutna (bez jednostki) i domyślna (gdy niczego
się nie poda). Aby ustawić maksymalną
długość czasu powtórzenia MAC,
należy wprowadzić lifetime
watość. Domyślnie, wartość
jest wyrażona w sekundach; można
również dopisać przyrostek m lub
u aby określić jednostkę jako
milisekundy lub mikrosekundy.
Można również dodać modyfikatory
short, long, min i max.
Jeśli karta obsługuje tryb automatyczny, to
definiują one określone limity.
Część innych kart definiuje różne
wartości w zależności od rozmiaru pakietu,
np. w 802.11 min limit jest krótkim limitem
ponowienia (pakietów niebędących RTS/CTS).
Przykłady :
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 wymianę
potwierdzeń przed każdą transmisją
pakietu, w celu upewnienia się, że kanał jest
wolny. Dodaje to narzutu, lecz zwiększa
wydajność w sytuacjach istnienia ukrytych
węzłów lub wielu aktywnych
węzłów. Parametr ustawia rozmiar
najmniejszego pakietu, dla którego węzeł
wysyła RTS; wartość równa maksymalnemu
rozmiarowi pakietu wyłącza mechanizm. Można
również ustawić ten parametr na
auto, fixed lub off.
Przykłady :
iwconfig eth0 rts 250
iwconfig eth0 rts off
frag[mentation_threshold]
Fragmentacja pozwala na
podzielenie pakietu IP na serię mniejszych,
transmitowanych fragmentów. Zwykle zwiększa
się w ten sposób narzut, lecz w bardzo
zakłóconych miejscach redukuje straty
związane z błędami i pozwala pakietom
przedostać się przez serie interferencji. Parametr
ustawia maksymalny rozmiar fragmentu, który jest
zawsze mniejszy niż maksymalny rozmiar pakietu.
Parametr może również kontrolować
technikę Frame Bursting dostępną w
niektórych kartach, która pozwala na
równoczesne wysłanie kilku pakietów IP.
Ten mechanizm będzie włączony, jeśli
rozmiar fragmentu jest większy niż maksymalny
rozmiar pakietu.
Dostępne są również
następujące wartości: auto,
fixed i off.
Przykłady :
iwconfig eth0 frag 512
iwconfig eth0 frag off
key/enc[ryption]
Używane do ustawiania
szyfrowania lub kluczy scrambling i trybu
bezpieczeństwa.
Aby ustawić bieżący klucz szyfrowania,
należy go podać w postaci szesnastkowej jako
XXXX-XXXX-XXXX-XXXX lub XXXXXXXX. Aby
zmienić klucz inny niż bieżący,
należy dodać do klucza przedrostek lub przyrostek
[numer] (nie zmieni się w ten
sposób aktywnego klucza). Można
również podać klucz będący
łańcuchem ASCII dodając przedrostek
s:. Hasła (passphrase) nie są obecnie
obsługiwane.
Aby zmienić to, który klucz jest obecnie aktywny
należy wpisać [numer] (bez
żadnej wartości klucza).
Przełącznik off wyłącza, a
on włącza szyfrowanie.
Trybem bezpieczeństwa może być open
lub restricted, a jego znaczenie zależy od
używanej karty. W większości kart w trybie
open nie używa się uwierzytelniania, a
karta może również akceptować sesje
nieszyfrowane, z kolei w trybie restricted
używane są wyłącznie sesje szyfrowane, a
karta będzie używała uwierzytelniania,
jeśli jest ono dostępne.
Jeśli konieczne jest ustawienie wielu kluczy lub
ustawienie klucza i zmiana aktywnego klucza, to konieczne
będzie użycie kilku poleceń key.
Argumenty mogą być podane w dowolnej
kolejności, przy czym pierwszeństwo ma ostatnie.
Przykłady :
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 |
Służy do zmiany trybu i parametrów schematu zarządzania energią. |
Do ustawienia okresu
między wybudzeniami, należy wpisać
period wartość. Aby ustawić
czas oczekiwania przed ponownym przejściem w tryb
uśpienia, należy wpisać timeout
wartość. Do ustawienia podstawowego poziomu
oszczędzania energii służy opcja
saving wartość. Można
również dodać modyfikatory min i
max. Domyślnie wartości te są
sekundowe, przez dodanie przyrostka m można
uzyskać milisekundy, a u mikrosekundy. Czasami
wartości nie posiadają jednostki (liczba
okresów ramek kontrolnych, dwell, wartości
procentowe itp.)
off i on wyłączają i
włączają zarządzenie energią.
Można również ustawić tryb
zarządzania energią na all (otrzymywanie
wszystkich pakietów), unicast (otrzymywanie
tylko pakietów unicast, odrzucanie pakietów
multicast i broadcast) i multicast (otrzymywanie
pakietów multicast i broadcast, odrzucanie unicast).
Przykłady :
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 użycie przez
kartę określonego zestawu modulacji. Nowe karty
obsługują różne modulacje, z
których część jest standardowa (np.
802.11b i 802.11g), a część zastrzeżona.
To polecenie wymusza używanie wyłącznie
określonego zestawu modulacji podanego w wierszu
polecenia. Można w ten sposób ominąć
problemy z kompatybilnością.
Lista dostępnych modulacji zależy od karty i
sterownika. Można ją wyświetlić
poleceniem iwlist modulation. Proszę
zauważyć, że część kart i
sterowników może nie obsługiwać wyboru
pojedynczej modulacji, część może
funkcjonować jako grupa. Można też
ustawić ten parametr na auto.
Przykłady :
iwconfig eth0 modu 11g
iwconfig eth0 modu CCK OFDMa
iwconfig eth0 modu auto
commit |
Część kart może nie włączać natychmiast zmian dokonanych za pomocą rozszerzeń bezprzewodowych (może czekać na kolejne zmiany lub aplikować je jedynie gdy karta jest włączana za pomocą ifconfig). To polecenie (gdy to dostępne) wymusza na karcie wprowadzenie w życie wszystkich oczekujących zmian. |
Zwykle nie jest to konieczne, ponieważ karta ostatecznie wprowadzi zmiany w życie, lecz może być przydatne do debugowania.
DISPLAY
Przy każdym urządzeniu obsługującym rozszerzenia bezprzewodowe, iwconfig będzie wyświetlał nazwę używanego protokołu MAC (pole MAC protocol) - nazwę urządzenia do protokołów własnościowych, ESSID (nazwę sieciową), NWID, frequency (częstotliwość lub kanał), sensitivity (czułość), mode (tryb działania), Access Point (adres punktu dostępowego), bit-rate (przepustowość), RTS threshold (próg RTS), fragmentation threshold (próg fragmentacji), encryption key (klucz szyfrowania) i power management (ustawienia zarządzania energią) - w zależności od dostępności.
Wyświetlane
parametry mają takie samo znaczenie i wartości jak
parametry które można ustawić, proszę
przejrzeć poprzednią część strony
podręcznika systemowego, aby przeczytać
szczegółowe informacje na ten temat.
Część parametrów jest
wyświetlanych jedynie w skróconej postaci (np.
szyfrowanie). Więcej szczegółów
można wypisać poleceniem iwlist(8).
Część parametrów ma dwa tryby (np.
przepustowość). Jeśli polecenie jest
poprzedzone "=", to oznacza to, że
parametr określony i wymuszony do podanej
wartości, natomiast gdy jest poprzedzony
":", wskazuje to na tryb automatyczny
parametru i pokazywana jest wartość
bieżąca (może się zmienić).
Access Point/Cell
Adres równy 00:00:00:00:00:00 oznacza, że karta nie połączyła się z punktem dostępowym (z reguły jest to błąd konfiguracji). Parametr Access Point (punkt dostępowy) będzie pokazywany w trybie ad-hoc pod nazwą Cell (komórka - z oczywistych względów), lecz poza nazwą jest taki sam.
Jeśli
/proc/net/wireless istnieje, to iwconfig
wyświetli również jego zawartość.
Proszę zauważyć, że te wartości
będą zależeć od konkretnej karty i
sterownika, tak więc aby móc je poprawnie
interpretować konieczne jest zapoznanie się z
dokumentacją sterownika.
Link quality
Ogólna jakość połączenia. Może wyrażać poziom konkurencji lub interferencji, liczbę błędów bitowych lub błędów ramki, jakość otrzymywanego sygnału, synchronizację czasową lub inne wskazania sprzętowe. Jest to wartość powstała w oparciu o wiele danych i zależy całkowicie od sterownika i sprzętu.
Signal level
Siła sygnału (RSSI - jak silny jest otrzymywany sygnał). Może być wyrażona w arbitralnych jednostkach lub dBm, iwconfig używa metainformacji ze sterownika do interpretacji wartości surowej podanej w /proc/net/wireless i wyświetla właściwą jednostkę lub wartość maksymalną (używając arytmetyki ośmiobitowej). W trybie Ad-Hoc wartość może być niezdefiniowana - należy wówczas skorzystać z iwspy.
Noise level
Poziom zakłóceń tła (gdy pakiety nie są transmitowane). Tego parametru tyczą się podobne uwagi co Signal level.
Rx invalid nwid
Liczba pakietów otrzymanych z innym NWID lub ESSID. Używana do wykrywania problemów z konfiguracją lub istnienia sąsiednich sieci (na tej samej częstotliwości).
Rx invalid crypt
Liczba pakietów, których karta nie była w stanie odszyfrować. Wartość można wykorzystać do wykrywania nieprawidłowych ustawień szyfrowania.
Rx invalid frag
Liczba pakietów, dla których karta nie była w stanie poprawnie połączyć fragmentów w warstwie łącza danych (najprawdopodobniej brakowało któregoś).
Tx excessive retries
Liczba pakietów, których nie udało się dostarczyć karcie. Większość protokołów MAC będzie starała się kilkukrotnie wysłać pakiet ponownie.
Invalid misc
Inne pakiety zagubione w związku z określonymi operacjami bezprzewodowymi.
Missed beacon
Liczba zagubionych ramek kontrolnych z komórki lub punktu dostępowego. Ramki kontrolne są wysyłane w regularnych odstępach czasu w celu utrzymania koordynacji komórki, niepowodzenie w ich otrzymaniu wskazuje zwykle, że karta znalazła się poza zasięgiem.
AUTOR
Jean Tourrilhes - jt [AT] hpl.com
PLIKI
/proc/net/wireless
ZOBACZ TAKŻE
ifconfig(8), iwspy(8), iwlist(8), iwevent(8), iwpriv(8), wireless(7).
TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Michał Kułach <michal.kulach [AT] gmail.com>
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres <manpages-pl-list [AT] lists.net>.