Company Products/Technology Services News/Events Support Contact Partners Customers

CLI Class and Property Documentation

Class Index

Class
Description
An access-point.
An associated station.
A radio rate.
A port that is a member of a bridge.
bss
A BSS of a radio.
Stores arbitrary data.
Controls channel planner parameters.
Config settings.
A detected access point.
The DHCP client.
802.11 settings (all radios).
Upgrade the firmware of the AP through HTTP.
IP host settings.
A network interface.
A bridge interface.
An Ethernet interface.
A loopback interface.
A service set interface.
A VLAN interface.
A WDS interface.
An IP route.
log
Access point log settings.
An entry in the log.
A MAC access list entry.
ntp
Network Time Protocol client settings.
Guest captive portal settings.
A physical radio.
A local authentication server user.
Serial access to the CLI.
SNMP server.
ssh
SSH access to the CLI.
A radio rate.
System-wide settings.
Telnet access to the CLI.
A transmission queue.
vwn
A Virtual Wireless Network.
A web server.
A WME station queue.


Class:

access-point

Persistent: Yes.
Purpose: Access Point

Description:

Enables access point configuration for Guest and VWN.

Property Index

Property
Description
Determines whether guest access is enabled or not.
Determines whether guest access uses the second Ethernet port, or a VLAN on the first Ethernet port.
Determines whether Virtual Wireless Networks are enabled.

guest-status

Purpose

Determines whether guest access is enabled or not.

Valid values

"up" or "down".

guest-via

Purpose

Determines whether guest access uses the second Ethernet port, or a VLAN on the first Ethernet port.

Valid values

"ethernet" or "vlan".

vwn-status

Purpose

Determines whether the Virtual Wireless Networks are enabled.

Valid values

"up" or "down"



Class:

association

Persistent: No.
Purpose:

An associated station.

Property Index

Property
Description
The interface with which the station is associated.
The MAC address of the station.
Whether the station is authenticated.
Whether the station is associated.
The number of packets received from the station.
The number of packets transmitted by the station.
The number of bytes received from the station.
The number of bytes transmitted by the station.
The transmission rate.
The listen interval.

interface

Purpose

The interface with which the station is associated.

Valid values

Linux network interface name.

station

Purpose

The MAC address of the station.

Valid values

Six colon-separated octets in hexadecimal.

authenticated

Purpose

Whether the station is authenticated.

Valid values

"Yes" or "-".

associated

Purpose

Whether the station is associated.

Valid values

"Yes" or "-".

rx-packets

Purpose

The number of packets received from the station.

Valid values

Positive integer.

tx-packets

Purpose

The number of packets transmitted by the station.

Valid values

Positive integer.

rx-bytes

Purpose

The number of bytes received from the station.

Valid values

Positive integer.

tx-bytes

Purpose

The number of bytes transmitted by the station.

Valid values

Positive integer.

tx-rate

Purpose

The transmission rate.

Valid values

A rate, in 100 kbps.

listen-interval

Purpose

The listen interval.

Valid values

A time, in ms.



Class:

basic-rate

Persistent: Yes.
Purpose:

A radio rate.

Description:

Used to set the rate sets of radios.

Property Index

Property
Description
A radio rate in MBps.

rate

Purpose

A radio rate in MBps. Note that you cannot change an existing rate property; you can only insert or delete the entire instance.

Valid values

Positive integer, or 5.5.



Class:

bridge-port

Persistent: Yes.
Purpose:

A port that is a member of a bridge.

Property Index

Property
Description
The path cost.
The port priority.

path-cost

Purpose

The path cost. Used only when STP is on.

Valid values

1-65535.

priority

Purpose

The port priority. Used only when STP is on.

Valid values

0-255.



Class:

bss

Persistent: Yes.
Purpose:

A BSS of a radio.

Description:

Represents a basic service set.

Property Index

Property
Description
Controls whether this is on or off.
A human-readable description of the interface.
The radio this is part of.
The service-set interface to send beacons for.
mac
The MAC address of the interface.
Delivery Traffic Information Map period.
Maximum number of stations.
Do not send SSID in beacons and ignore probe requests.
MAC address Access Control List mode.
The name of the mac access control list to use.
Whether RADIUS accounting is enabled.
The port to use for RADIUS accounting.
The port to use for RADIUS authentication.
The RADIUS server shared secret.
Whether Open System authentication is permitted.
Whether Shared Key authentication is permitted.
Whether non-WPA stations can associate during WPA.
Whether TKIP is permitted as a WPA cipher.
Whether CCMP is permitted as a WPA cipher.

status

Purpose

Controls whether this is on or off.

Valid values

"up" or "down".

description

Purpose

A human-readable description of the interface.

Valid values

An ASCII string.

radio

Purpose

The radio this is part of.

Valid values

The name of an existing radio instance.

beacon-interface

Purpose

The service-set interface to send beacons for.

Valid values

The name of an existing interface instance with type of service-set.

mac

Purpose

The MAC address of the interface. Read-only; value is determined by the starting MAC of the radio.

Valid values

6 colon-separated hexadecimal digit pairs.

dtim-period

Purpose

Delivery Traffic Information Map period.

Valid values

1-225.

max-stations

Purpose

Maximum number of stations.

Valid values

0-2007.

ignore-broadcast-ssid

Purpose

Do not send SSID in beacons and ignore probe requests.

Valid values

"on" or "off".

mac-acl-mode

Purpose

MAC address Access Control List mode.

Valid values

"deny-list": deny only stations in list.
"accept-list": accept only stations in list.

mac-acl-name

Purpose

The name of the mac access control list to use.

Valid values

The name of existing mac-acl instances.

radius-accounting

Purpose

Whether RADIUS accounting is enabled. If unset defaults to "off".

Valid values

"on" or "off".

radius-accounting-port

Purpose

The port to use for RADIUS accounting.

Valid values

0-65535.

radius-port

Purpose

The port to use for RADIUS authentication.

Valid values

0-65535.

radius-ip

Purpose

The RADIUS server IP address.

Valid values

An IP address.

radius-key

Purpose

The RADIUS server shared secret.

Valid values

A string.

open-system-authentication

Purpose

Whether Open System authentication is permitted.

Valid values

"on" or "off".

shared-key-authentication

Purpose

Whether Shared Key authentication is permitted.

Valid values

"on" or "off".

wpa-allow-non-wpa-stations

Purpose

Whether non-WPA stations can associate during WPA. If unset defaults to "off".

Valid values

"on" or "off".

wpa-cipher-tkip

Purpose

Whether TKIP is permitted as a WPA cipher.

Valid values

"on" or "off".

wpa-cipher-ccmp

Purpose

Whether CCMP is permitted as a WPA cipher.

Valid values

"on" or "off".


Class:

cluster

Persistent: Yes.
Purpose:

The set of APs, identified by IP addresses, that share configuration information.

Description:

Stores data relating to clustering.

Property Index

Property
Description
Determines whether clustering is enabled on this node.
The location of the cluster member.
The name of the cluster to join.

clustered

Purpose

Determines whether clustering is enabled on this node..

Valid values

"0": Disable clustering (clustering is OFF).
"1": Enable clustering (clustering is ON).

location

Purpose

The location of the cluster member.

Valid values

Any string. If the string includes spaces or special characters, enclose it in double quotes.

cluster-name

Purpose

The name of the cluster to join.

Valid values

Any string. If the string includes spaces or special characters, enclose it in double quotes.



Class:

channel-planner

Persistent: Yes.
Purpose:

Description:

Controls channel planner parameters.

Property Index

Property
Description
Determines whether channel planning is enabled.
The percentage change in error required to propagate new channel assignments.
Minutes between each attempt to optimize channel assignments..
Comma delimited list of APs whose channels' channel planner will not change.

status

Purpose

Determines whether channel planning is enabled or not.

Valid values

"0": Disable channel planning (channel planning is OFF).
"1": Enable channel planning (channel planning is ON).

change-threshold

Purpose

The percentage change in error required to propagate new channel assignments.

Valid values

0-100

interval

Purpose

Minutes between each attempt to optimize channel assignments.

Valid values

1 + minutes. A reasonable maximum of 2880 minutes.

locked-ips

Purpose

Comma-delimited list of APs whose channels' channel planner will not change.

Valid values

A valid IP address.



Class:

config

Persistent: Yes.
Purpose:

Config settings.

Description:

Used for config properties.

Property Index

Property
Description
Configuration at boot time.
Configuration after factory reset.
Prevent external configuration updates.
Version of configuration.
Format of backup configuration file.

startup

Purpose

Configuration at boot time. Write-only.

Valid values

"default": Reset to factory defaults.
"rescue": Reset to rescue.
"running": Save running config.

default

Purpose

Configuration after factory reset. Write-only.

Valid values

"rescue": Reset to rescue.
"running": Save running config.

no-external-updates

Purpose

Prevent external configuration updates.

Valid values

"up" or "down".

version

Purpose

Shows version of AP configuration.

Valid values

Numeric string such as 1.03.

backup-file-format

Purpose

Shows file format of backup configuration file.

Valid values

"plain" or "encrypted"



Class:

detected-ap

Persistent: No.
Purpose:

A detected access point.

Description:

Represents an access point that has been detected by passive scanning.

Property Index

Property
Description
mac
The MAC address of the AP.
The radio that detected the AP.
The beacon interval for this radio in kus (1.024 ms).
The capabilities of the AP.
The type of device detected.
Whether privacy (WEP or WPA) is enabled.
The SSID of the AP.
wpa
Whether WPA security is enabled.
The mode our radio was in when the AP was detected.
The RF band the AP was detected in.
The channel of the AP.
The rate of the AP.
The signal of the AP.
erp
The ERP of the AP.
The number of beacons received from this AP.
The time of the last beacon received from this AP.
The supported rates of the AP.

mac

Purpose

The MAC address of the AP.

Valid values

Six colon-separated octets in hexadecimal.

radio

Purpose

The radio that detected the AP.

Valid values

Linux network interface name.

beacon-interval

Purpose

The beacon interval of the AP in kus (1.024 ms).

Valid values

Positive integer.

capability

Purpose

The capabilities of the AP.

Valid values

C-formatted hexadecmial bitflag.

type

Purpose

The type of device detected.

Valid values

"AP", "Ad hoc", or "Other".

privacy

Purpose

Whether privacy (WEP or WPA) is enabled.

Valid values

"On" or "Off".

ssid

Purpose

The SSID of the AP.

Valid values

String of up to 32 octets.

wpa

Purpose

Whether WPA security is enabled.

Valid values

"On" or "Off".

phy-type

Purpose

The mode our radio was in when the AP was detected. Note that in B or G mode, it is possible to detect both B and G APs, therefore the distinction between B and G is not useful information.

Valid values

4: IEEE 802.11b.
7: IEEE 802.11g.
8: IEEE 802.11a.
256: Atheros Turbo.

band

Purpose

The RF band the AP was detected in.

Valid values

"2.4", "5", or "5 Turbo".

channel

Purpose

The channel of the AP.

Valid values

Positive integer.

rate

Purpose

The rate of the AP.

Valid values

Positive integer.

signal

Purpose

The signal of the AP.

Valid values

Positive integer.

erp

Purpose

The ERP of the AP.

Valid values

C-formatted hexadecimal number.

beacons

Purpose

The number of beacons received from this AP.

Valid values

Positive integer.

last-beacon

Purpose

The time of the last beacon received from this AP.

Valid values

Date and time, in Unix time format.

supported-rates

Purpose

The supported rates of the AP.

Valid values

Bracketed list of hexadecimal rate codes.



Class:

dhcp-client

Persistent: Yes.
Purpose:

The DHCP client.

Description:

Represents a DHCP client.

Property Index

Property
Description
Controls whether this is on or off.
The interface to perform DHCP on.

status

Purpose

Controls whether this is on or off.

Valid values

"up" or "down".

interface

Purpose

The interface to perform DHCP on.

Valid values

The name of an existing interface instance.



Class:

dot11

Persistent: Yes.
Purpose:

802.11 settings (all radios).

Description:

Represents the wireless functions of the access point.

Property Index

Property
Description
Controls whether 802.11 is in use.
The debugging level for 802.11.
Whether AP should enable 802.11d.

status

Purpose

Controls whether 802.11 is in use.

Valid values

"up" or "down".

debug

Purpose

The debugging level for 802.11.

Valid values

0-3.

dot11d

Purpose

Whether AP should enable 802.11d

Valid values

"up" or "down".



Class:

firmware-upgrade

Persistent: Yes.
Purpose:

Upgrade the firmware of the AP through HTTP.

Description:

Enables the upgrade to the latest version of firmware.

Property Index

Property
Description
Indicates the progress of the firmware upgrade.
Starts the firmware upgrade through HTTP.
The url to the location of the firmware upgrade file.
Checks the validity of the upgrade file.

progress

Purpose

Indicates the progress of the firmware upgrade .

Valid values

Progress time in seconds.

start

Purpose

Starts the firmware upgrade.

Valid values

"yes" or "no".

upgrade-url

Purpose

The url to the location of the upgrade file.

Valid values

http://<server IP>[<server port>]/filename

validate

Purpose

Checks the validity of the upgrade file

Valid values

"yes" or "no".



Class:

host

Persistent: Yes.
Purpose:

IP host settings.

Description:

Used for IP host properties.

Property Index

Property
Description
Domain name servers in use.
Domain name in use.
id
The host name.
Domain name servers to use when not obtained through DHCP.
Domain name to use when not obtained through DHCP.
Whether DNS parameters are obtained through DHCP.

dns-[12]

Purpose

Domain name servers in use.

Valid values

IP address.

domain

Purpose

Domain name in use.

Valid values

DNS domain name.

id

Purpose

The host name.

Valid values

DNS domain name.

static-dns-[12]

Purpose

Domain name servers to use when not obtained through DHCP.

Valid values

IP address.

static-domain

Purpose

Domain name to use when not obtained through DHCP.

Valid values

DNS domain name.

dns-via-dhcp

Purpose

Whether DNS parameters are obtained through DHCP.

Valid values

"up" or "down".



Class:

interface

Persistent: Yes.
Purpose:

A network interface.

Description:

Used for per-interface properties.

Property Index

Property
Description
ip
The actual IP address of this interface.
The actual netmask of this interface.
Controls whether this is on or off.
The type of the interface.
A human-readable description of the interface.
mac
The MAC address of the interface.
The static IP address of this interface.
The static netmask of this interface.
Received bytes.
Received packets.
Received packets with errors.
Received packets that were dropped.
Received packets with FIFO overflows.
Received packets with frame errors.
Received packets with compression.
Received packets that were multicast.
Transmitted bytes.
Transmitted packets.
Transmitted packets with errors.
Transmitted packets that were dropped.
Transmitted packets with FIFO overflows.
Transmitted packets will collisions.
Transmitted packets with carrier errors.
Transmitted packets with compression.

ip

Purpose

The actual IP address of this interface. Read-only.

Valid values

IP address.

mask

Purpose

The actual netmask of this interface. Read-only.

Valid values

Netmask in dotted-decimal notation.

status

Purpose

Controls whether this is on or off.

Valid values

"up" or "down".

type

Purpose

The type of the interface. Used to determine what additional properties are available. Read-only.

Valid values

"ethernet", "loopback", "service-set", "bridge", "vlan", "wds".

description

Purpose

A human-readable description of the interface.

Valid values

An ASCII string.

mac

Purpose

The MAC address of the interface.

Valid values

6 colon-separated hexadecimal digit pairs.

static-ip

Purpose

The static IP address of this interface. Used when DHCP is not in use.

Valid values

IP address.

static-mask

Purpose

The static netmask of this interface. Used when DHCP is not in use.

Valid values

Netmask in dotted-decimal notation.

rx-bytes

Purpose

Received bytes.

Valid values

Integer.

rx-packets

Purpose

Received packets.

Valid values

Integer.

rx-errors

Purpose

Received packets with errors.

Valid values

Integer.

rx-drop

Purpose

Received packets that were dropped.

Valid values

Integer.

rx-fifo

Purpose

Received packets with FIFO overflows.

Valid values

Integer.

rx-frame

Purpose

Received packets with frame errors.

Valid values

Integer.

rx-compressed

Purpose

Received packets with compression.

Valid values

Integer.

rx-multicast

Purpose

Received packets that were multicast.

Valid values

Integer.

tx-bytes

Purpose

Transmitted bytes.

Valid values

Integer.

tx-packets

Purpose

Transmitted packets.

Valid values

Integer.

tx-errors

Purpose

Transmitted packets with errors.

Valid values

Integer.

tx-drop

Purpose

Transmitted packets that were dropped.

Valid values

Integer.

tx-fifo

Purpose

Transmitted packets with FIFO overflows.

Valid values

Integer.

tx-colls

Purpose

Transmitted packets will collisions.

Valid values

Integer.

tx-carrier

Purpose

Transmitted packets with carrier errors.

Valid values

Integer.

tx-compressed

Purpose

Transmitted packets with compression.

Valid values

Integer.



Class:

interface (bridge)

Extends: interface

Persistent: Yes.
Purpose:

A bridge interface.

Property Index

Property
Description
stp
Whether the Spanning Tree Protocol is in use.
The hello time.
fd
The forward delay.
The bridge priority.
Whether ports are isolated.

stp

Purpose

Whether the Spanning Tree Protocol is in use.

Valid values

"on" or "off".

hello

Purpose

The hello time. Only used when stp is on.

Valid values

1.0-10.0.

fd

Purpose

The forward delay. Only used when stp is on.

Valid values

4.0-30.0.

priority

Purpose

The bridge priority. Only used when stp is on.

Valid values

0-65535.

port-isolation

Purpose

Whether ports are isolated. If on, then isolated ports on this bridge can only exchange data with