Provided by: manpages-it_3.73-2_all 
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).