- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-WLAN Interface Commands | 96.71 KB |
WLAN interface configuration commands
display interface wlan-meshlink
shutdown (WLAN-Radio interface view)
shutdown (WLAN-BSS interface view)
default
Use default to restore the default settings for an interface.
Syntax
default
Views
WLAN-BSS interface view, WLAN-Radio interface view, WLAN mesh interface view
Default command level
2: System level
Usage guidelines
This command might fail to restore the default settings for some commands because of command dependencies and system restrictions. You can use the display this command in interface view to check for these commands, and perform their undo forms or follow the command reference to individually restore their default settings. Follow the instructions in the error message to resolve the problem if the restoration attempt fails.
The default command might interrupt ongoing network services. Be fully aware of the impacts of this command when you perform it on a live network.
Examples
# Restore the default settings of WLAN-BSS interface 1.
<Sysname> system-view
[Sysname] interface wlan-bss 1
[Sysname-WLAN-BSS1] default
This command will restore the default settings. Continue? [Y/N]:y
description
Use description to set the description for the current interface.
Use undo description to restore the default.
Syntax
description text
undo description
Default
The description for an interface is interface-name + Interface.
Views
WLAN-BSS interface view, WLAN-Radio interface view, WLAN mesh interface view
Default command level
2: System level
Parameters
text: Description for the current interface, a string of 1 to 80 characters. The device supports the following types of characters or symbols: standard English characters (numbers and case-sensitive letters), special English characters, spaces, and other characters or symbols that conform to the Unicode standard.
Usage guidelines
An interface description can be the mixture of English characters and other Unicode characters. The mixed description cannot exceed the specified length.
To use a type of Unicode characters or symbols in an interface description, you must install the corresponding IME and log in to the device through remote login software that supports this character type.
Each Unicode character or symbol (non-English characters) takes the space of two regular characters. When the length of a description string reaches or exceeds the maximum line width on the terminal software, the software starts a new line, possibly breaking a Unicode character into two parts. As a result, garbled characters may be displayed at the end of a line.
Examples
# Set the description for WLAN-Radio 1/0/1 to To AP1.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] description To AP1
display interface wlan-bss
Use display interface wlan-bss to display information about the specified WLAN-BSS interface or all WLAN-BSS interfaces if no WLAN-BSS interface is specified.
Syntax
display interface [ wlan-bss ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]
display interface wlan-bss interface-number [ brief ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
interface-number: Specifies a WLAN-BSS interface by its number. The value range is 0 to 255.
brief: Displays brief interface information. If you do not provide this keyword, the command displays detailed interface information.
down: Displays down interface information and the cause. If you do not provide this keyword, the command output is not filtered based on the down interface status.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
· If you do not provide the wlan-bss keyword, the command displays information about all interfaces on the device.
· If you provide the wlan-bss keyword, and do not provide the interface-number argument, the command displays information about all WLAN-BSS interfaces.
Examples
# Display information about the interface WLAN-BSS 1.
<Sysname> display interface wlan-bss 1
WLAN-BSS1 current state: DOWN
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e2c0-0110
Description: WLAN-BSS1 Interface
PVID: 1
Port link-type: access
Tagged VLAN ID : none
Untagged VLAN ID : 1
Port priority: 0
Last clearing of counters: Never
Maximum client number: 64
Clients: 0 associating, 0 associated
Input :
Total Frames Count : 0
Total Frames Bytes : 0
Ucast Frames Count : 0
Ucast Frames Bytes : 0
Bcast Frames Count : 0
Bcast Frames Bytes : 0
Output :
Total Frames Count : 0
Total Frames Bytes : 0
Ucast Frames Count : 0
Ucast Frames Bytes : 0
Bcast Frames Count : 0
Bcast Frames Bytes : 0
Field |
Description |
WLAN-BSS1 current state |
Physical link state of a WLAN-BSS interface. |
IP Packet Frame Type |
Output frame encapsulation type. |
Hardware Address |
MAC address of output frames. |
Description |
Description of the interface. |
PVID |
Default VLAN ID of the interface. |
Port link-type |
Port link type, which can be access or hybrid. |
Tagged VLAN ID |
VLANs whose packets are sent through the port with VLAN tag kept. |
Untagged VLAN ID |
VLANs whose packets are sent through the port with VLAN tag stripped off. |
Last clearing of counters: Never |
Time when the reset counts interface command was last used to clear statistics on the interface. Never indicates that the reset counts interface command was never used after the device was started. |
Maximum client number |
Maximum number of clients allowed to access. |
Clients: 0 associating, 0 associated |
Number of clients being associating, number of clients associated. This field is available only if the interface supports traffic statistics collection. |
Input : Total Frames Count : 0 Total Frames Bytes : 0 Ucast Frames Count : 0 Ucast Frames Bytes : 0 Bcast Frames Count : 0 Bcast Frames Bytes : 0 |
Input packet statistics of the interface: · Number of packets · Number of bytes. · Number of unicast packets. · Number of unicast bytes. · Number of multicast/broadcast packets. · Number of multicast/broadcast bytes. |
Output : Total Frames Count : 0 Total Frames Bytes : 0 Ucast Frames Count : 0 Ucast Frames Bytes : 0 Bcast Frames Count : 0 Bcast Frames Bytes : 0 |
Output packet statistics of the interface: · Number of packets. · Number of bytes. · Number of unicast packets · Number of unicast bytes. · Number of multicast/broadcast packets. · Number of multicast/broadcast bytes. |
display interface wlan-mesh
Use display interface wlan-mesh to display information about the specified WLAN mesh interface or all WLAN mesh interfaces that already exist if no interface is specified.
Syntax
display interface [ wlan-mesh ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]
display interface wlan-mesh interface-number [ brief ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1. Monitor level
Parameters
interface-number: Specifies a WLAN mesh interface by its number. The specified interface must be one that already exists.
brief: Displays brief interface information. If you do not provide this keyword, the command displays detailed interface information.
down: Displays down interface information and the cause. If you do not provide this keyword, the command output is not filtered based on the down interface status.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
If you do not specify the wlan-mesh keyword, the command displays information about all interfaces on the device.
If you specify the wlan-mesh keyword, and do not specify the interface-number argument, the command displays information about all WLAN mesh interfaces.
Examples
# Display information about WLAN mesh interface 3.
<Sysname> display interface wlan-mesh 3
WLAN-MESH3 current state: DOWN
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e2c0-0110
Description: WLAN-MESH3 Interface
PVID: 1
Port link-type: access
Tagged VLAN ID : none
Untagged VLAN ID : 1
Port priority: 0
Last clearing of counters: Never
For more information about command output description, see Table 1.
display interface wlan-meshlink
Use display interface wlan-meshlink to display information about the specified WLAN mesh link interface or all WLAN mesh link interfaces that already exist if no interface is specified.
Syntax
display interface [ wlan-meshlink ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]
display interface wlan-meshlink interface-number [ brief ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1. Monitor level
Parameters
interface-number: Specifies a WLAN mesh link interface by its number. The specified interface must be one that already exists.
brief: Displays brief interface information. If you do not provide this keyword, the command displays detailed interface information.
down: Displays down interface information and the cause. If you do not provide this keyword, the command output is not filtered based on the down interface status.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
If you do not specify the wlan-meshlink keyword, the command displays information about all interfaces on the device.
If you specify the wlan-meshlink keyword, and do not specify the interface-number argument, the command displays information about all WLAN mesh link interfaces.
Examples
# Display information about WLAN-MESHLINK1.
<Sysname> display interface WLAN-MESHLINK 1
WLAN-MESHLINK1 current state: UP
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 0000-0000-0000
Description: WLAN-MESHLINK1 Interface
PVID: 1
Port link-type: access
Tagged VLAN ID : none
Untagged VLAN ID : 1
Port priority: 0
Last clearing of counters: Never
Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
9 packets input, 2890 bytes, 0 drops
392 packets output, 63796 bytes, 0 drops
For more information about command output description, see Table 1.
display interface wlan-radio
Use display interface wlan-radio to display information about a WLAN-Radio interface.
Syntax
display interface [ wlan-radio ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]
display interface wlan-radio interface-number [ brief ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
interface-number: Specifies a WLAN-Radio interface by its number. The value range is 1/0/1 to 1/0/n. n represents the maximum number of radio interfaces supported by the device.
brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
down: Displays down interface information and the cause. If you do not specify this keyword, the command output is not filtered based on the down interface status.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
If you do not specify the wlan-radio keyword, the command displays information about all interfaces on the device.
If you specify the wlan-radio keyword, and do not specify the interface-number argument, the command displays information about all WLAN-Radio interfaces.
Examples
# Display information about the interface WLAN-Radio 1/0/1.
<Sysname> display interface wlan-radio 1/0/1
WLAN-Radio1/0/1 current state: UP
IP Packet Frame Type: PKTFMT_IEEE_802.11, Hardware Address: 000f-e2c0-0110
Description: WLAN-Radio1/0/1 Interface
Radio-type dot11ac, channel auto, power(dBm) 23
Antenna Type is Internal Antenna
Resource Usage is 0%
Received: 0 authentication frames, 0 association frames
Sent out: 0 authentication frames, 0 association frames
Stations: 0 associating, 0 associated
Input : 30007 packets, 1536614 bytes
: 13565 unicasts, 520774 bytes
: 16442 multicasts/broadcasts, 1015840 bytes
: 0 fragmented
: 5687 discarded, 263913 bytes
: 0 duplicates, 3054 FCS errors
: 2 decryption errors
Output: 2032 packets, 468562 bytes
: 7 unicasts, 1776 bytes
: 312 multicasts/broadcasts, 40114 bytes
: 1713 others, 426672 bytes
: 0 fragmented
: 0 discarded, 0 bytes
: 0 failed RTS, 335 failed ACK
: 334 transmit retries, 122 multiple transmit retries
Table 2 Command output
Field |
Description |
WLAN-Radio1/0/1 current state |
Physical link state of the WLAN-Radio interface. |
IP Packet Frame Type |
Output frame encapsulation type. |
Hardware Address |
MAC address of the interface. |
Description |
Description of the interface. |
Radio-type |
WLAN protocol type used by the interface. |
channel auto |
Channel used by the interface. The keyword auto means the channel is automatically selected. If the channel is manually selected, the field will be displayed in the format of channel configured-channel. |
power(dBm) 23 |
Transmit power of the interface (in dBm). The value 23 is the transmit power configured by the user. (If spectrum management and power constraint have been configured for the 802.11ac bands, the actual transmit power on the interface may be different from the configured value, depending on the configuration of two commands: max-power and power-constraint.) For more information about the max-power command and the power-constraint command, see WLAN Command Reference. If the protocol being used is not 802.11ac or the power constraint function on the 802.11ac frequencies is not configured even though 802.11ac is used, this field will be displayed as power(dBm) configured-power. |
Received: 0 authentication frames, 0 association frames |
Received: Number of authentication frames, number of association frames. |
Sent out: 0 authentication frames, 0 association frames |
Sent out: Number of authentication frames, number of association frames. |
Stations: 0 associating, 0 associated |
Number of wireless users. |
Input : 30007 packets, 1536614 bytes : 13565 unicasts, 520774 bytes : 16442 multicasts/broadcasts, 1015840 bytes : 0 fragmented : 5687 discarded, 263913 bytes : 0 duplicates, 3054 FCS errors : 2 decryption errors |
Input packet statistics of the interface: · Number of packets, number of bytes. · Number of unicast packets, number of bytes of unicast packets. · Number of multicasts/broadcast packets, number of bytes of multicasts/broadcast packets. · Number of fragmented packets. · Number of discarded packets, number of discarded bytes. · Number of duplicate frames, number of FCS errors. · Number of encryption errors. |
Output: 2032 packets, 468562 bytes : 7 unicasts, 1776 bytes : 312 multicasts/broadcasts, 40114 bytes : 1713 others, 426672 bytes : 0 fragmented : 0 discarded, 0 bytes : 0 failed RTS, 335 failed ACK : 334 transmit retries, 122 multiple transmit retries |
Output packet statistics of the interface: · Number of packets (unicasts + multicasts/broadcasts + others), number of bytes. · Number of unicast packets, number of bytes of unicast packets. · Number of multicasts/broadcast packets, number of bytes of multicasts/broadcast packets. · Number of other types of packets, bytes. · Number of fragmented packets. · Number of discarded packets, number of discarded bytes. · Number of failed RTS packets, number of failed ACK packets. · Number of retransmitted frames, number of transmit retries. |
interface wlan-bss
Use interface wlan-bss to enter WLAN-BSS interface view. If the WLAN-BSS interface identified by the interface-number argument does not exist, this command creates the WLAN-BSS interface first.
Use undo interface wlan-bss to remove a WLAN-BSS interface.
Syntax
interface wlan-bss interface-number
undo interface wlan-bss interface-number
Views
System view
Default command level
2: System level
Parameters
interface-number: Specifies a WLAN-BSS interface by its number. The value range is 0 to 255.
Examples
# Create the WLAN-BSS interface numbered 1.
<Sysname> system-view
[Sysname] interface wlan-bss 1
[Sysname-WLAN-BSS1]
interface wlan-radio
Use interface wlan-radio to enter WLAN-Radio interface view.
Syntax
interface wlan-radio interface-number
Views
System view
Default command level
2: System level
Parameters
interface-number: Specifies a WLAN-Radio interface by its number. The value range is 1/0/1 to 1/0/n. n represents the maximum number of radio interfaces supported by the device.
Examples
# Enter WLAN-Radio 1/0/1 interface view.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1]
interface wlan-mesh
Use interface wlan-mesh to enter WLAN mesh interface view. If the specified WLAN mesh interface does not exist, the command creates the WLAN mesh interface first.
Use undo interface wlan-mesh to delete the specified WLAN mesh interface.
Syntax
interface wlan-mesh interface-number
undo interface wlan-mesh interface-number
Views
System view
Default command level
1. System level
Parameters
interface-number: Specifies a WLAN mesh interface by its number, in the range of 1 to 32.
Examples
# Create WLAN mesh interface 2.
<Sysname> system-view
[Sysname] interface wlan-mesh 2
[Sysname-WLAN-MESH2]
shutdown (WLAN-Radio interface view)
Use shutdown to shut down the current WLAN-Radio interface.
Use undo shutdown to bring up the current WLAN-Radio interface.
Syntax
shutdown
undo shutdown
Default
A WLAN-Radio interface is up.
Views
WLAN-Radio interface view
Default command level
2: System level
Examples
# Shut down interface WLAN-Radio 1/0/1.
<Sysname>system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] shutdown
shutdown (WLAN-BSS interface view)
Use shutdown to shut down the current WLAN-BSS interface.
Use undo shutdown to bring up the current WLAN-BSS interface.
Syntax
shutdown
undo shutdown
Default
A WLAN-BSS interface is up.
Views
WLAN-BSS interface view
Default command level
2: System level
Usage guidelines
After a WLAN-BSS interface is shut down, the connection between the interface and the wireless device will be torn down.
Examples
# Shut down interface WLAN-BSS 1.
<Sysname>system-view
[Sysname] interface wlan-bss 1
[Sysname-WLAN-Bss1] shutdown