IWCONFIG - Documentation
Syntax
The general syntax for the `iwconfig` command is as follows:
iwconfig [interface] [options]
Where:
- `[interface]` refers to the wireless network interface (e.g., `wlan0`, `wlan1`).
- `[options]` are the various parameters you can modify or display.
Common Options
- `essid [SSID]`: Set the SSID (Service Set Identifier) for the wireless network.
iwconfig wlan0 essid "MyNetwork"
- `key [key]`: Set the encryption key for the wireless network (e.g., WEP key, WPA key).
iwconfig wlan0 key s:mysecretpassword
- `mode [mode]`: Set the mode of the wireless network interface (e.g., `Managed`, `Ad-Hoc`, `Master`, `Monitor`).
iwconfig wlan0 mode Managed
- `channel [channel_number]`: Set the wireless channel. The channel number is specific to the frequency band.
iwconfig wlan0 channel 6
- `rate [rate]`: Set the rate for the wireless network interface. This is typically set in terms of Mbps.
iwconfig wlan0 rate 54M
- `ap [MAC_address]`: Connect to a specific Access Point (AP) using its MAC address.
iwconfig wlan0 ap 00:14:22:01:23:45
- `freq [frequency]`: Set the frequency of the wireless connection in Hz.
iwconfig wlan0 freq 2.437G
- `power [power_level]`: Set the power level for the wireless card, controlling how much power is used for transmission.
iwconfig wlan0 power 10
- `txpower [txpower_value]`: Set the transmission power of the wireless interface.
iwconfig wlan0 txpower 20
- `essid off`: Disable the SSID (network disassociation).
iwconfig wlan0 essid off
Display Wireless Information
To display the current wireless configuration of an interface, use the `iwconfig` command without any options or arguments:
iwconfig wlan0
This will show information about: - The current SSID and the signal quality. - The encryption settings (e.g., WEP, WPA). - The current channel and frequency. - The transmission rate and power settings.
Example:
wlan0 IEEE 802.11 ESSID:"MyNetwork" Nickname:"<WIFI@REALTEK>"
Mode:Managed Frequency:2.437 GHz Access Point: 00:14:22:01:23:45
Bit Rate=54 Mb/s Tx-Power=20 dBm
Retry short limit:7 RTS thr:off Fragment thr:off
Power Management:off
Link Quality=70/70 Signal level=-50 dBm Noise level=-95 dBm
Rx invalid nwid:0 Rx invalid crypt:0 Rx invalid frag:0
Tx excessive retries:0 Invalid misc:0 Missed beacon:0
Common Use Cases
- **Connecting to a Wireless Network**:
To connect to a wireless network using the SSID and WEP key:
iwconfig wlan0 essid "MyNetwork" key s:mysecretpassword
- **Switching Between Channels**:
To switch your wireless card to a specific channel (e.g., Channel 11):
iwconfig wlan0 channel 11
- **Setting the Wireless Mode**:
To switch the wireless mode to Ad-Hoc (for peer-to-peer connections):
iwconfig wlan0 mode Ad-Hoc
- **Monitoring Wireless Networks**:
To enable monitor mode to capture wireless packets:
iwconfig wlan0 mode Monitor
Troubleshooting
- **No Network Connection**:
If you are unable to connect to a wireless network, ensure that:
- The wireless interface is enabled.
- The SSID and encryption keys are correctly set.
- The wireless network is within range.
- **Signal Quality Issues**:
If you notice poor signal quality, try changing the wireless channel to avoid interference from nearby networks.
iwconfig wlan0 channel 1
- **Wireless Interface Not Found**:
Ensure that the correct driver is installed for your wireless network card, and check whether the interface exists (e.g., `wlan0` or `wlan1`).
Useful Links
- [iwconfig Manual Page](https://man7.org/linux/man-pages/man8/iwconfig.8.html)
- [Wireless Tools for Linux](https://github.com/jbostian/wireless-tools)
- [Linux Wireless Wiki](https://wireless.wiki.kernel.org/)
- [iwconfig - ArchWiki](https://wiki.archlinux.org/title/Iwconfig)
