show dot11 associations
Displays the list of wireless clients currently associated with a Cisco access point, including their MAC addresses, IP addresses, signal strength, and connection state, used for troubleshooting client connectivity and performance issues.
Definition: show dot11 associations is a Cisco IOS privileged exec command. Displays the list of wireless clients currently associated with a Cisco access point, including their MAC addresses, IP addresses, signal strength, and connection state, used for troubleshooting client connectivity and performance issues.
Overview
The `show dot11 associations` command is a vital diagnostic tool for Cisco wireless networks, specifically for access points (APs) operating in autonomous or lightweight mode (via the IOS-based AP CLI). It displays a real-time list of wireless clients currently associated with the AP, including their MAC addresses, IP addresses (if obtained via DHCP), signal strength (RSSI), signal-to-noise ratio (SNR), connection state, and the radio interface (e.g., Dot11Radio0 for 2.4 GHz, Dot11Radio1 for 5 GHz). This command is essential for troubleshooting client connectivity issues, such as clients failing to associate, experiencing poor performance, or being unable to obtain an IP address.
It provides immediate visibility into which clients are connected, their link quality, and any authentication or association errors. The command operates in privileged EXEC mode (enable) and does not alter the running configuration; it is a read-only show command. However, it may require privilege level 15 on some IOS versions if restricted by privilege levels.
The output is typically brief but can be extensive in dense environments; it is not buffered and refreshes each time the command is executed. Understanding this command is crucial for CCNA and CCNP candidates as it directly relates to wireless LAN fundamentals, client association processes, and RF management. It fits into the broader troubleshooting workflow after verifying AP power, radio status, and SSID configuration, and before deeper packet analysis or debug commands.
Alternatives include `show dot11 client` (more detailed per-client info), `show dot11 statistics` (aggregate counters), and `debug dot11 events` (real-time association/deassociation logs). The command is available on Cisco IOS-based APs (e.g., 1130, 1240, 2600 series) and on controllers via `show client summary` or `show wireless client summary` (IOS-XE). It is not available on IOS-XR or NX-OS platforms.
The output includes fields such as Address (MAC), IP Address, Name (if known), Interface (radio), State (e.g., Assoc, Auth, Run), Signal (RSSI in dBm), Noise (dBm), SNR (dB), and Flags (e.g., E for encryption, W for WPA). A healthy association shows State as 'Run' or 'Assoc', positive SNR (typically >20 dB), and RSSI above -80 dBm. Problem indicators include State 'Auth' (stuck in authentication), 'Assoc' (associated but not authenticated), or 'Idle'; very low RSSI (< -85 dBm) or SNR (< 15 dB); or clients not appearing at all.
The command is often used in conjunction with `show dot11 interface` to check radio status, `show dot11 statistics` for retry and error counts, and `ping` from the client to test IP connectivity. For CCNA/CCNP candidates, mastering this command helps in diagnosing real-world issues like weak signal, interference, DHCP failures, or authentication mismatches.
show dot11 associationsWhen to Use This Command
- Verify if a specific client device is connected to the access point and check its signal strength.
- Troubleshoot a client that is experiencing slow speeds or intermittent disconnections by examining association details.
- Monitor the number of associated clients to assess access point load and capacity.
- Identify unauthorized clients by reviewing MAC addresses of associated devices.
Parameters
| Parameter | Syntax | Description |
|---|---|---|
| client-mac | H.H.H | Specifies the MAC address of a specific client to display detailed association information for that client only. The MAC address must be in dotted hexadecimal format (e.g., aaaa.bbbb.cccc). If omitted, the command shows all associated clients. Common mistake: using colon or hyphen separators instead of dots. |
| interface | interface-type interface-number | Limits the output to clients associated on a specific radio interface, such as Dot11Radio0 (2.4 GHz) or Dot11Radio1 (5 GHz). This is useful for isolating issues to a particular band. If not specified, all interfaces are included. Common mistake: forgetting that the interface must be a Dot11Radio interface, not a GigabitEthernet. |
| detail | detail | Displays extended information for each client, including encryption cipher, authentication method, key management, EAP type, and more. This parameter is often used for in-depth troubleshooting of security-related issues. Common mistake: expecting the detail keyword to work without specifying a client MAC; it works for all clients when used alone. |
Command Examples
Basic show dot11 associations output
show dot11 associations802.11 Client Associations on Dot11Radio0: SSID [Corporate] : MAC Address IP Address Device State CCX CCX Ver RSSI SNR Rate 00:1a:2b:3c:4d:5e 192.168.1.100 Laptop Associated Yes 4 -45 35 54M 00:1a:2b:3c:4d:5f 192.168.1.101 Phone Associated No - -60 20 24M 00:1a:2b:3c:4d:60 192.168.1.102 Tablet Associated Yes 4 -55 28 36M Total Client Associations: 3
Line 1: Indicates the radio interface (Dot11Radio0). Line 2: SSID name. Columns: MAC Address - client's hardware address; IP Address - client's IP (if DHCP); Device - client type (if identified); State - connection status (Associated, Authenticating, etc.); CCX - Cisco Compatible Extensions support; CCX Ver - CCX version; RSSI - Received Signal Strength Indicator in dBm (higher is better, -45 is excellent, -60 is fair); SNR - Signal-to-Noise Ratio in dB (higher is better, >25 is good); Rate - current data rate in Mbps. Last line: total number of associated clients.
Show dot11 associations with client details
show dot11 associations 00:1a:2b:3c:4d:5eClient: 00:1a:2b:3c:4d:5e IP: 192.168.1.100 State: Associated CCX: Yes CCX Version: 4 RSSI: -45 dBm SNR: 35 dB Rate: 54 Mbps SSID: Corporate VLAN: 10 Authentication: Open Encryption: WPA2 Association ID: 1 Channel: 6 Uptime: 0 days 02:15:30
Shows detailed information for a specific client. Fields: Client MAC and IP; State (Associated means fully connected); CCX support; RSSI and SNR (good values: RSSI > -70, SNR > 25); current data rate; SSID; VLAN assigned; authentication and encryption methods; Association ID (unique per client); channel used; uptime (how long client has been associated).
Understanding the Output
The 'show dot11 associations' command output lists all wireless clients associated with the access point. The first line indicates the radio interface. Each SSID is listed with its associated clients.
Key columns: MAC Address (unique client identifier), IP Address (client's IP if DHCP is used), Device (optional client type), State (should be 'Associated' for a fully connected client; other states like 'Authenticating' or 'Disassociated' indicate issues), CCX and CCX Version (Cisco proprietary extensions for enhanced features), RSSI (signal strength in dBm; values closer to 0 are better, -50 to -70 is typical for good connections, below -80 is weak), SNR (signal-to-noise ratio; >25 dB is good, <15 dB may cause problems), Rate (current data rate; lower rates may indicate poor signal or interference). The total count helps assess load. For troubleshooting, look for clients in non-'Associated' states, weak RSSI (< -75), low SNR (< 20), or low data rates.
A high number of clients may indicate capacity issues.
Configuration Scenarios
Verify Client Association and Signal Strength on a 2.4 GHz Radio
A network administrator receives complaints about intermittent connectivity on the 2.4 GHz band. They need to check which clients are associated, their signal strength, and whether any clients are stuck in authentication.
Topology
AP (Dot11Radio0) --- Wireless --- Client1 (MAC: aaaa.bbbb.0001) and Client2 (MAC: aaaa.bbbb.0002)Steps
- 1.Step 1: Enter privileged EXEC mode: AP> enable
- 2.Step 2: View all associations on the 2.4 GHz radio: AP# show dot11 associations interface Dot11Radio0
- 3.Step 3: Examine the output for each client's State, Signal (RSSI), and SNR. For example, look for State 'Run' indicating a fully associated client, RSSI above -80 dBm, and SNR above 20 dB.
- 4.Step 4: If a client shows State 'Auth' or 'Assoc' without transitioning to 'Run', investigate authentication or DHCP issues.
- 5.Step 5: For a specific client with poor signal, use the detail parameter: AP# show dot11 associations aaaa.bbbb.0001 detail
! No configuration is required; this is a verification command. ! Ensure the AP is in privileged EXEC mode. AP> enable AP# show dot11 associations interface Dot11Radio0
Verify: Expected output snippet: Address IP Address Name Interface State Signal Noise SNR Flags aaaa.bbbb.0001 192.168.1.10 Client1 Dot11Radio0 Run -65 -95 30 E aaaa.bbbb.0002 192.168.1.11 Client2 Dot11Radio0 Run -78 -95 17 E Both clients show State 'Run', indicating successful association. Client1 has good signal (-65 dBm) and SNR (30 dB). Client2 has marginal SNR (17 dB) which may cause issues.
Watch out: The output may not show IP addresses if the client has not completed DHCP. In that case, the IP address field will be blank or show 0.0.0.0. Do not assume the client is not associated; check the State field first.
Troubleshoot a Client Stuck in Authentication State
A client with MAC address aaaa.bbbb.0003 is unable to connect to the wireless network. The AP shows the client in 'Auth' state, indicating it has not completed the full association process. The network uses WPA2-PSK.
Topology
AP (Dot11Radio0) --- Wireless --- Client3 (MAC: aaaa.bbbb.0003)Steps
- 1.Step 1: Check the client's association state: AP# show dot11 associations aaaa.bbbb.0003
- 2.Step 2: Observe the State field. If it shows 'Auth', the client is stuck in authentication. Also check the Flags field for encryption type (e.g., 'E' for WEP, 'W' for WPA).
- 3.Step 3: Verify the AP's security configuration: AP# show running-config | include dot11|ssid|authentication|encryption
- 4.Step 4: Ensure the SSID is configured correctly and the security settings match the client (e.g., WPA2-PSK with AES).
- 5.Step 5: Check for client-side issues: verify the client's passphrase, ensure it is not using incompatible security settings (e.g., WPA instead of WPA2).
- 6.Step 6: If configuration matches, enable debug to see authentication failures: AP# debug dot11 events
! Example security configuration on the AP:
interface Dot11Radio0
ssid Courseiva
authentication open
authentication key-management wpa
! For WPA2-PSK:
encryption mode ciphers aes-ccm
! Pre-shared key:
! (configured via wpa-psk ascii 0 CourseivaKey)
! Or via dot11 ssid:
dot11 ssid Courseiva
authentication open
authentication key-management wpa
wpa-psk ascii 0 CourseivaKey
!
! Ensure the SSID is broadcast:
! no shutdownVerify: After correcting the configuration, re-check the client association: AP# show dot11 associations aaaa.bbbb.0003 Expected output: Address IP Address Name Interface State Signal Noise SNR Flags aaaa.bbbb.0003 192.168.1.12 Client3 Dot11Radio0 Run -70 -95 25 W The State should now be 'Run', indicating successful association and authentication.
Watch out: A common mistake is forgetting to enable the SSID on the interface with the 'no shutdown' command. Also, ensure the encryption cipher matches the client; using TKIP instead of AES can cause authentication failures.
Troubleshooting with This Command
When troubleshooting wireless client issues, `show dot11 associations` is often the first command to run after verifying the AP is powered on and the radio is up. A healthy output shows clients in 'Run' state with positive SNR (typically >20 dB) and RSSI above -80 dBm. The 'Flags' column indicates encryption: 'E' for WEP, 'W' for WPA/WPA2, 'N' for no encryption.
If a client is missing, check if the SSID is broadcast and the client is in range. If a client appears but has State 'Auth' or 'Assoc', it indicates incomplete authentication or association. 'Auth' means the client has sent an authentication frame but not completed the process; this often points to a security mismatch (e.g., wrong PSK, unsupported cipher).
'Assoc' means the client has associated but not yet authenticated; this can occur with open authentication but no subsequent key exchange. If the client shows 'Run' but no IP address, DHCP may be failing; check the DHCP server and ensure the AP is not blocking DHCP (e.g., via a VACL). Low RSSI (e.g., -85 dBm or lower) indicates weak signal; consider moving the AP or client, or adjusting antennas.
Low SNR (e.g., <15 dB) indicates high noise; look for interference sources (microwaves, Bluetooth, neighboring APs on the same channel). The 'detail' parameter adds information like encryption cipher (e.g., AES-CCMP), authentication method (e.g., PSK), and key management (e.g., WPA2). Use this when clients fail to connect despite correct SSID and PSK.
Correlate with `show dot11 statistics` to see retry counts, CRC errors, and packet loss. For example, high retry rates (above 10%) suggest RF issues. Also use `show dot11 interface Dot11Radio0` to check channel utilization, noise floor, and associated clients count.
If the AP is in lightweight mode (connected to a WLC), the equivalent command on the controller is `show client summary` or `show wireless client summary` (for IOS-XE). On the AP itself, if it is in autonomous mode, `show dot11 associations` is the primary tool. For deeper debugging, use `debug dot11 events` to see real-time association and authentication messages, but use with caution in production as it can flood the console.
A systematic approach: 1) Check AP radio status (`show dot11 interface`). 2) List associations (`show dot11 associations`). 3) For problem clients, use detail. 4) Check statistics (`show dot11 statistics`). 5) If needed, enable debug for a short period. Always correlate with client-side logs (e.g., Windows event viewer, macOS console). Remember that the command output is instantaneous; if a client is roaming, it may briefly disappear.
Also, the AP may have a maximum association limit (e.g., 200 clients); check with `show dot11 interface` for 'Max Associations'.
CCNA Exam Tips
CCNA exam may ask which command to verify client connectivity; 'show dot11 associations' is the correct answer.
Know that RSSI is measured in dBm and SNR in dB; lower RSSI (more negative) means weaker signal.
Remember that 'Associated' state means the client is fully connected; other states indicate problems.
The command can be filtered by MAC address to get detailed client info.
Common Mistakes
Mistake: Confusing RSSI and SNR; RSSI measures signal strength, SNR measures signal quality relative to noise.
Mistake: Assuming all clients in 'Associated' state have good connectivity; weak RSSI or low SNR can still cause issues.
Mistake: Forgetting that the command shows only clients on the specific radio interface; on dual-band APs, check both Dot11Radio0 (2.4 GHz) and Dot11Radio1 (5 GHz).
show dot11 associations vs show ap summary
Both 'show dot11 associations' and 'show ap summary' are wireless diagnostic commands, but they operate at different layers: the first focuses on individual client connections to an access point, while the second provides an overview of the access points themselves. They are commonly confused because both involve wireless status, yet they serve distinct troubleshooting purposes.
| Aspect | show dot11 associations | show ap summary |
|---|---|---|
| Scope | Wireless clients associated with a specific AP | All access points in the network |
| Output focus | Per-client details: MAC, IP, signal strength, state | Per-AP summary: name, IP, status, model |
| Typical use | Troubleshooting client connectivity or performance | Verifying AP reachability and operational status |
| Configuration mode | Privileged EXEC on the AP or controller | Privileged EXEC on the controller or switch |
| Visibility | Local to the AP where command is issued | Global view of all managed APs |
Use show dot11 associations when a specific client reports poor connectivity or low throughput, to check its signal strength, data rate, and association state.
Use show ap summary when you need a quick check of all access points in the network, for example after a reboot or to confirm all expected APs are online.
Platform Notes
On Cisco IOS-XE platforms (e.g., Catalyst 9800 WLC, embedded wireless on ISR/ASR routers), the equivalent command is `show wireless client summary` or `show wireless client mac-address <mac> detail`. The output format differs significantly: it includes fields like Client MAC, AP Name, WLAN Profile, Protocol (802.11ax/ac/n), RSSI, SNR, and State (e.g., 'Associated', 'Authenticated'). The `show dot11 associations` command is not available on IOS-XE; instead, use the wireless-specific commands.
On NX-OS (Cisco Nexus switches), there is no direct equivalent as NX-OS does not support wireless AP functionality. For ASA firewalls, there is no equivalent; wireless client association is not relevant. On IOS-XR, the command does not exist.
In older IOS versions (12.x), the output format was slightly different: the 'Flags' column might show 'E' for WEP, 'W' for WPA, and 'N' for no encryption. In 15.x and 16.x, the output remains largely consistent but may include additional fields like 'Parent' for mesh APs. On autonomous APs running IOS 15.2(4)JB or later, the command supports the 'detail' keyword for all clients.
On lightweight APs (running IOS-based firmware, e.g., 12.4(21a)JY), the command is still available but the AP must be in 'autonomous' mode; in 'lightweight' mode, the AP does not maintain client association tables locally—all client info is on the controller. Therefore, on a lightweight AP, `show dot11 associations` may return no output or limited info. Always verify the AP mode with `show ap mode` or `show dot11 interface` to ensure the command will work as expected.
For CCNA/CCNP candidates, understanding these platform differences is critical for real-world troubleshooting.
Practice for the CCNA 200-301
Test your knowledge with practice questions covering all CCNA 200-301 exam domains.
Practice CCNA 200-301 Questions