IWCONFIG
Section: Linux Programmer's Manual (8)
Updated: 22 giugno 2004
Index
Return to Main Contents
NOME
iwconfig - configura una interfaccia di rete wireless
SINTASSI
iwconfig [interface]
iwconfig interface [essid X] [nwid N] [freq F] [channel C]
[sens S] [mode M] [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
DESCRIZIONE
Iwconfig
è simile a
ifconfig(8),
ma è dedicato alle interfacce wireless. Viene utilizzato per
impostare i parametri delle interfacce di rete che sono specifici
per le funzioni wireless (ad esempio: la frequenza).
Iwconfig
può anche essere utilizzato per visualizzare questi parametri,
o le statistiche wireless (ottenute da
/proc/net/wireless).
Tutti questi parametri e statistiche dipendono dal dispositivo.
Ogni driver fornirà solo alcuni di questi a seconda del supporto
dell'hardware, e la disponibilità di valori può cambiare.
Per favore riferirsi alle man pages di ogni dispositivo per i dettagli.
PARAMETRI
- essid
-
Imposta l'ESSID (oppure il nome della rete - in alcuni prodotti può
anche essere chiamato Domain ID). L'ESSID è utilizzato per
identificare celle che fanno parte della stessa rete virtuale.
Al contrario dell'indirizzo dell'AP o NWID che definisce una
singola cella, l'ESSID definisce un gruppo di celle connesse
via ripetitori o infrastrutture, dove l'utente può muoversi in modo
trasparente.
Con alcune schede è possibile disabilitare il controllo dell'ESSID
(ESSID promiscuo) con
off o any (e on
per riattivarlo).
Esempi:
iwconfig eth0 essid any
iwconfig eth0 essid My Network
- nwid/domain
-
Imposta il Network ID (in alcuni prodotti può anche essere
chiamato Domain ID). Dato che tutte le reti wireless condividono
lo stesso mezzo, questo parametro viene utilizzato per
differenziarle (creare rete logiche co-locate) e identificare i
nodi che appartengono alla stessa cella.
Questo parametro è utilizzato solo per hardware PRE-802.11,
il protocollo 802.11 utilizza l'ESSID e l'indirizzo AP
(Access Point) per questa funzione.
Con alcune schede, è possibile disabilitare
il controllo del Network ID (NWID promiscuo) con
off (e on
per riattivarlo).
Esempi:
iwconfig eth0 nwid AB34
iwconfig eth0 nwid off
- freq/channel
-
Imposta la frequenza o il canale nel dispositivo. Un valore inferiore
a 1000 indica il numero di un canale, un valore superiore a 1000 è una
frequenza in Hz. È possibile aggiungere il suffisso k, M o G al valore
(per esempio, "2.46G" per una frequenza di 2.46GHz), oppure aggiungere
sufficienti '0'.
I canali sono solitamente numerati partendo dall'1, ed è possibile
utilizzare
iwlist(8)
per ottenere il numero totale di canali, le frequenze disponibili,
e mostrare la frequenza corrente come un canale. A seconda delle leggi
locali, alcune frequenze/canali potrebbero non essere disponibili.
Esempi :
iwconfig eth0 freq 2422000000
iwconfig eth0 freq 2.422G
iwconfig eth0 channel 3
- sens
-
Imposta la soglia di sensibilità. Questo è il più basso livello
di segnale per il quale l'hardware proverà a ricevere pacchetti,
segnali più deboli verranno ignorati. Questo è utilizzato per
evitare il rumore di fondo, e dovrà essere impostato a seconda del
livello di rumore. Valori positivi sono considerati il valore raw
utilizzato dall'hardware o una percentuale, valori negativi sono
considerati in dBm.
Con qualche scheda, questo paramentro controlla inoltre la soglia di
rinvio (il livello di segnale più basso per il quale l'hardware
considera il canale come pieno) e l'handover threshold (il livello di
segnale al quale l'hardware inizia a cercare per un nuovo access point).
Esempi :
iwconfig eth0 sens -80
- mode
-
Imposta la modalità operativa del dispositivo, che dipende dalla
tipologia della rete. La modalità può essere
Ad-Hoc
(rete composta solo da una cella e senza Access Point),
Managed
(il nodo è connesso ad una rete composta da Access Point, con Roaming),
Master
(il nodo fa da riferimento oppure agisce come un Access Point),
Repeater
(il nodo forwarda i pacchetti fra i nodi wireless),
Secondary
(il nodo agisce come un master/repetear di backup),
Monitor
(il nodo non è associato a nessuna cella e controlla passivamente
tutti i pacchetti su tutte le frequenze) oppure
Auto.
Esempi :
iwconfig eth0 mode Managed
iwconfig eth0 mode Ad-Hoc
- ap
-
Forza la scheda a collegarsi all'Access Point fornito con l'indirizzo
se è disponibile. Quando la qualità della connessione è troppo bassa,
il driver può tornare in modalità automatica (la scheda sceglie
il miglior Access Point nelle vicinanze).
È possibile usare
off
per riattivare la modalità automatica senza cambiare l'Access Point
corrente, o è possibile usare
any
o
auto
per forzare la scheda a riassociarsi con l'Access Point migliore.
Esempi :
iwconfig eth0 ap 00:60:1D:01:23:45
iwconfig eth0 ap any
iwconfig eth0 ap off
- nick[name]
-
Imposta il nickname, o il nome della stazione-client. Alcuni prodotti
802.11 lo definiscono, ma questo non è utilizzato spesso come i
protocolli (MAC, IP, TCP) interessati ed è completamente senza utilizzo
per come sia la configurazione. Solo alcuni programmi
disagnostici potrebbero usarlo.
Esempi :
iwconfig eth0 nickname My Linux Node
- rate/bit[rate]
-
Per schede che supportano velocità di trasferimento multipli, imposta
la velocità in b/s. Il bit-rate è la velocità alla quale i
bit sono trasmessi attraverso il mezzo, la velocità del collegamento
può essere più bassa a causa della condivisione del mezzo o per
vari sovraccarichi.
è possibile aggiungere il suffisso k, M o G al valore (multipli
decimali: 10^3, 10^6 e 10^9 b/s), o aggiungere sufficienti '0'.
Valori inferiori a 1000 sono specifici della scheda, di solito un
indice nella lista dei bit-rate. Utilizzare
auto
per scegliere la modalità automatica del bit-rate (scendere ad un
rate minore su canali rumorosi), che è di default per molte schede, e
fixed
per tornare alle impostazioni fisse. Se si specifica un valore del
bit-rate e si aggiunge
auto,
il driver utilizzerà tutti i bit-rate uguali ed inferiori a
quel valore
Esempi :
iwconfig eth0 rate 11M
iwconfig eth0 rate auto
iwconfig eth0 rate 5.5M auto
- rts[_threshold]
-
RTS/CTS aggiunge un handshake("stretta di mano") prima di ogni
trasmissione per essere sicuro che il canale sia libero. Questo aggiunge
un sovraccarico, ma aumenta le performance in caso di nodi scomparsi
o un grande numero di nodi attivi. Questo parametro imposta la
dimensione del più piccolo pacchetto per il quale il nodo manda un RTS;
un valore uguale alla massima dimensione del pacchetto disabilita
il sistema. È possibile inoltre impostare questo parametro a
auto, fixed o off.
Esempi :
iwconfig eth0 rts 250
iwconfig eth0 rts off
- frag[mentation_threshold]
-
La frammentazione permette di separare un pacchetto IP in un flusso
di frammenti più piccoli trasmessi attraverso il mezzo. In molti casi
questo aggiunge un sovraccarico, ma in un ambiente rumoroso questo
riduce le penalità da errori e permette ai pacchetti di viaggiare
attraverso flussi di interferenze. Questo parametro imposta la massima
dimensione del frammento; un valore uguale alla massima dimensione
disabilita il sistema. È possibile impostare il parametro ad
auto, fixed oppure off.
Esempi :
iwconfig eth0 frag 512
iwconfig eth0 frag off
- key/enc[ryption]
-
Utilizzato per manipolare le chiavi di crittografia o "scrambling"
e la modalità di sicurezza.
Per impostare la chiave di crittografia corrente, basta inserirla
in formato esadecimale come
XXXX-XXXX-XXXX-XXXX or XXXXXXXX.
Per impostare una chiave diversa dalla chiave corrente, aggiungere
prima o dopo
[index]
alla chiave stessa (questo non cambierà quale sia la chiave attiva).
È possibile inoltre inserire la chiave come una stringa ASCII
utilizzando il prefisso
s:
Attualmente le passphrase non sono supportate.
Per cambiare quale sia l'attuale chiave attiva, basta inserire
[index]
senza inserire alcuna chiave).
off and on
disabilitano e riabilitano la crittografia.
La modalità di sicurezza può essere
open
o
restricted,
e il suo significato dipende dalla scheda. Con molte schede, in
open
nessuna autenticazione viene utilizzata e la scheda può anche
accettare sessioni non crittografate, mentre in modalità
restricted
sono accettate solo sessioni crittografate e la scheda
utilizzerà l'autenticazione disponibile.
Se è necessario impostare chiavi multiple, o impostare una chiave
e cambiare la chiave corrente, bisogna utilizzare direttive
key
multiple.
Gli argomenti possono essere messi in qualunque ordine, l'ultimo
prenderà la precedenza.
Esempi :
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
-
Utilizzato per manipolare lo schema e la modalità per il
risparmio energetico.
Per impostare il periodo fra la riattivazione, inserire
period `valore'.
Per impostare il timeout prima di tornare in fase
timeout `valore'.
È inoltre possibile usare i modificatori
min and max
Di default, questi valori sono in secondi, aggiungere il
suffisso m o u per specificare millisecondi o microsecondi. Qualche volta
questa valori sono senza unità (numero di beacon periodici,
dwell o altro).
off e on
disabilitaono e riattivano il risparmio energetico.
Infine, è possibile impostare la gestione dei consumi a
all
(ricevi tutti i pacchetti),
unicast
(ricevi solo pacchetti unicast, rifiuta i multicast e broadcast) e
multicast
(ricevi solo pacchetti multicast e broadcast, rifiuta i pacchetti unicast).
Esempi :
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
-
Per schede che supportano capacità multiple di trasmissione, imposta
la potenza di trasmissione in dBm. Se
W
è la potenza in Watt, la potenza in dBm è
P = 30 + 10.log(W).
Se il valore è seguito da
mW,
questo verrà automaticamente convertito in dBm.
Inoltre
on e off
attivano e disattivano la parte radio, e
auto e fixed
attivano e disabilitano il controllo dell'energia (se questa
caratteristica è disponibile).
Esempi :
iwconfig eth0 txpower 15
iwconfig eth0 txpower 30mW
iwconfig eth0 txpower auto
iwconfig eth0 txpower off
- retry
-
Molte schede hanno la ritrasmissione del MAC, e alcune permettono
di impostare preferenze per il meccanismo di ritrasmissione.
Per impostare il massimo numero di prove, inserire
limit `valore'.
Questo è un valore assoluto (senza unità).
Per impostare il massimo periodo che il MAC venga ritrasmesso, inserire
lifetime `valore'.
Di default, questo valore è in secondi, aggiungere m o u per
specificare millisecondi o microsecondi
È possibile anche aggiungere i modificatori
min e max
Se la scheda supporta la modalità automatica, questi definiscono
il limite del limit o del lifetime. Alcune schede definiscono valori
differenti a seconda della dimensione del pacchetto, per esempio nello
standard 802.11
min limit
è il periodo minimo di prova (pacchetti non RTS/CTS).
Esempi :
iwconfig eth0 retry 16
iwconfig eth0 retry lifetime 300m
iwconfig eth0 retry min limit 8
- commit
-
Alcune schede sembra non applichino immediatamente le modifiche fatte
attraverso le Wireless Extensions (potrebbero aspettare di
aggregare le modifiche o applicarle solo quando la scheda è attivata
via ifconfig). Questo comando, quando disponibile, forza la
scheda ad applicare tutte le modifiche in attesa.
Questo solitamente non è necessario, perché la scheda potrà eventualmente
applicare le modifiche, ma può essere utile per il debugging.
DISPLAY
Per ogni dispositivo che supporta le estensioni wireless,
iwconfig
mostrerà il nome del protocollo
MAC protocol
(nome del dispositivo per protocolli proprietari), l'
ESSID
(nome della rete), l'
NWID,
la
frequenza
(or canale), la
sensibilità,
la
modalità
operativa, l'indirizzo dell'
Access Point
il
bit-rate
il
RTS threshold, il fragmentation threshold,
la
chiave di crittografia
e
la gestione energetica
(a seconda dalla disponibilità).
I parametri mostrati hanno lo stesso significato dei valori dei parametri
che è possibile impostare, perfavore riferirsi alle parti
precedenti per una spiegazione dettagliata.
Alcuni parametri sono mostrati solo in forma abbreviata (come la crittografia).
è possibile usare
iwlist(8)
per ottenere questi dettagli.
Alcuni parametri hanno due modalità (come il bitrate). Se
il valore è preceduto da
`=',
significa che il parametro è fisso a quel valore, se è preceduto da
`:',
il parametro è in modalità automatica ed è mostrato il valore
corrente (e potrebbe cambiare).
- Access Point/Cell
-
Un indirizzo uguale ad 00:00:00:00:00:00 significa che la scheda non è
riuscita ad associarsi all'Access Point (spesso per un errore
di configurazione). I parametri dell'
Access Point
saranno mostrati come
Cell
in modalità ad-hoc (per ovvie ragioni), ma comunque funzionerà
allo stesso modo
Se
/proc/net/wireless
è disponibile,
iwconfig
mostrerà anche il suo contenuto. Ricordare che questi valori dipendono
dal driver e dalle specifiche hardware, così sarà necessario riferirsi
alla documentazione dell'hardware per le giuste interpretazioni di
questi valori.
- Link quality
-
In generale la qualità del segnale. Può essere basata sul livello
di conflittualità o interferenza, il bit o il frame error rate,
quanto è buona la ricezione del segnale, qualche sincronizzazione,
o altre questioni dell'hardware. Questo è un valore aggregato, e
dipende totalmente dal driver e dall'hardware.
- Signal level
-
Resistenza del segnale ricevuto (RSSI - quanto è potente il segnale
ricevuto). Potrebbe essere in unità arbitraria o dBm,
iwconfig
utilizza le informazioni del driver per interpretare il valore
grezzo ottenuto da
/proc/net/wireless
mostra l'unità adatta o il valore massimo (utilizzando 8 bit artimetici).
In modalità
Ad-Hoc
questo potrebbe non essere definito e si dovrebbe utilizzare iwspy.
iwspy.
- Noise level
-
Livello di rumore di fondo (quando nessun pacchetto viene trasmesso).
Commenti simili per
Signal level.
- Rx invalid nwid
-
Numero di pacchetti ricevuti con un differente NWID o ESSID. Utilizzato
per verificare errori di configurazione o esistenza di reti
adicenti, operanti sulla stessa frequenza.
- Rx invalid crypt
-
Numero di pacchetti che il sistema non è stato in grado di decrittare.
Questo può essere usato per verificare impostazioni di
crittografia invalide.
- Rx invalid frag
-
Numero di pacchetti che il sistema non è stato in grado di riassemblare
correttamente i frammenti dello strato fisico (solitamente uno
è stato perso).
- Tx excessive retries
-
Numero di pacchetti che il sistema non è stato in grado di spedire.
Molti protocolli MAC riprovano a spedire il pacchetto un numero di
volte prima di rinunciarvi.
- Invalid misc
-
Altri pacchetti persi in specifiche operazioni.
- Missed beacon
-
Numero di beacons periodici in arrivo dalla Cella o dall'Access Point
che sono stati persi. I beacons sono spediti ad un intervallo regolare
per mantenere la coordinazione della cella, la mancata ricezione di
questi solitamente indica che la scheda è fuori campo.
AUTORE
Jean Tourrilhes - jt[AT]hpl.hp.com
TRADUZIONE
Traduzione dall'inglese: Ferronato Claudio (wireless_tools.27)
Questa traduzione è migliorabile. Se hai migliorie da proporre, perfavore
scrivimi all'indirizzo claiudio[AT]libero.it
FILE
/proc/net/wireless
VEDERE ANCHE
ifconfig(8),
iwspy(8),
iwlist(8),
iwevent(8),
iwpriv(8),
wireless(7).
Index
- NOME
-
- SINTASSI
-
- DESCRIZIONE
-
- PARAMETRI
-
- DISPLAY
-
- AUTORE
-
- TRADUZIONE
-
- FILE
-
- VEDERE ANCHE
-
This document was created by
man2html,
using the manual pages.
Time: 23:03:53 GMT, June 17, 2008