NOTE: this page is for archival only, see the note at the end of the page.

Go back –> ath6kl

'ath6kl wext crap'

Standard IOCTLs

Linux Wireless Extension IOCTLs

IOCTL

Description

SIOCGIWENCODE

Retrieves the WEP key for the AR600x

SIOCSIWENCODE

Sets the WEP key for the AR600x

SIOCGIWESSID

Retrieves the SSID of the network

SIOCSIWESSID

Sets the SSID of the network

SIOCGIWFREQ

Retrieves the frequency of the wireless device

SIOCSIWFREQ

Sets the frequency for the wireless device operate on

SIOCGIWMODE

Retrieves the mode of operation

SIOCSIWMODE

Sets the mode of operation

SIOCGIWNAME

Retrieves the name of the network device

SIOCGIWRANGE

Retrieves network device wireless information

SIOCGIWRETRY

Retrieves max retry value from failure frames (in software version 1.2 or higher.)

SIOCSIWRETRY

Sets max retry value from failure frames (in software version 1.2 or higher).

SIOCGIWAP

Retrieves the desired BSSID

SIOCSIWAP

Sets the desired BSSID for the CONNECT command

SIOCGIWRATE

Retrieves the transmission rate of the AR600x

SIOCSIWRATE

Fixes the transmission rate of the AR6001

SIOCGIWSCAN

Retrieves the list of APs from the SCAN operation

SIOCSIWSCAN

Executes the SCAN command in the AR600x

SIOCGIWTXPOW

Retrieves the transmission rate of the AR600x

SIOCSIWTXPOW

Sets the transmission rate of the AR600x

Name

SIOCGIWNAME

Description

Retrieves the name of the network device

Commands

iwconfig eth1

iwgetid

Argument Type

char *

Arguments

Name of the wireless device

IOCTL Type

get

Class

Wireless extension

Name

SIOCSIWFREQ

Description

Sets the frequency on which the wireless device should operate

Commands

iwlist eth1

freq <freq|channel>

iwconfig eth1

channel <freq|channel>

Argument Type

struct iw_freq *

Arguments

Defined in linux/wireless.h

IOCTL Type

set

Class

Wireless extension

Name

SIOCGIWFREQ

Description

Retrieves the frequency on which the wireless device is operating if the device is connected. If the device is not connected, this command retrieves the range of frequencies in which the device can operate.

Commands

iwlist eth1

freq

iwconfig eth1

channel

Argument Type

struct iw_freq *

Arguments

Defined in linux/wireless.h

IOCTL Type

get

Class

Wireless extension

Name

SIOCSIWMODE

Description

Sets the mode of operation

Commands

iwconfig eth1

mode {ad-hoc | managed | 1 | 2}

Argument Type

unsigned int *

Arguments

n 1 = Ad hoc mode n 2 = Infrastructure mode

IOCTL Type

set

Class

Wireless extension

Name

SIOCGIWMODE

Description

Retrieves the mode of operation

Commands

iwconfig eth1

Argument Type

unsigned int *

Arguments

n 1 = Ad hoc mode

n 2 = Infrastructure mode

IOCTL Type

get

Class

Wireless extension

Name

SIOCGIWRANGE

Description

Retrieves the various wireless information related to the network device

Commands

iwconfig eth1

iwlist eth1

freq

iwlist eth1

channel

Argument Type

struct iw_point *, struct iw_range *

Arguments

1. struct iw_point

Defined in linux/wireless.h

Length = size of argument 2

2. struct iw_range

Defined in linux/wireless.h

Various device information

IOCTL Type

get

Class

Wireless extension

Name

SIOCSIWAP

Description

Sets the desired BSSID for the CONNECT command

Commands

iwconfig eth1

ap {<BSSID>|any|off}

Argument Type

struct sockaddr *

Arguments

MAC address of the BSSID

IOCTL Type

get

Class

Wireless extension

Name

SIOCGIWAP

Description

Retrieves the desired BSSID for the CONNECT command

Commands

iwconfig eth1

Argument Type

struct sockaddr *

Arguments

MAC address of the BSSID

IOCTL Type

get

Class

Wireless extension

Name

SIOCSIWSCAN

Description

Executes the SCAN command in the AR6001

Commands

iwlist eth1

scan

Argument Type

None

Arguments

None

IOCTL Type

set

Class

Wireless extension

Name

SIOCGIWSCAN

Description

Retrieves the list of APs from the SCAN operation

Commands

iwlist eth1

scan

Argument Type

struct ar_giwscan_param {

char

*current_ev;

char

*end_buf;

A_BOOL

*firstpass;

Arguments

current_ev

Beginning of the buffer for the scan data

end_buf

End of the buffer for the scan data

IOCTL Type

get

Class

Wireless extension

Name

SIOCSIWESSID

Description

Sets the SSID of the network the AR6001 should connect to. Usually, the WMI_CONNECT_CMD is called. However, when the STA is already associated to an AP and the SSID to be used is the same as the AP’s (i.e., the same as the previous setting), then the WMI_RECONNECT_CMD is called.

Commands

iwconfig eth1 essid {<ESSID>|any|off} Where ESSID is the ESSID of the AP the STA wants to connect to

Argument Type

struct iw_point *, char *

Arguments

1. struct iw_point

Defines the SSID length

Length = size of argument 2

2. String representation of the SSID

IOCTL Type

set

Class

Wireless extension

Name

SIOCGIWESSID

Description

Retrieves the ESSID of the network the AR6001 is connected to or wants to connect to

Commands

iwconfig eth1

Argument Type

struct iw_point *, char *

Arguments

1. struct iw_point

Defines the ESSID length

Length = size of argument 2

2. String representation of the ESSID

IOCTL Type

get

Class

Wireless extension

Name

SIOCSIWRATE

Description

Fixes the transmission rate of the AR6001

Commands

iwconfig eth1

rate <rate>

Argument Type

struct iw_param *

Arguments

Defined in linux/wireless.h

value

Transmit (Tx) rate in bps

fixed

n TRUE = Software fixes this rate n FALSE = Allow hardware to auto-select the rate

IOCTL Type

set

Class

Wireless extension

Name

SIOCGIWRATE

Description

Retrieves the current transmission rate of the AR6001

Commands

iwconfig eth1

rate

iwlist eth1

rate

Argument Type

struct iw_param *

Arguments

Defined in linux/wireless.h

value

Transmit (Tx) rate in bps

fixed

n TRUE = Software fixes this rate n FALSE = Allow hardware to auto-select the rate

IOCTL Type

get

Class

Wireless extension

Name

SIOCSIWTXPOW

Description

Sets the power of transmitted packets in AR6001

Commands

iwconfig eth1

txpower {txpower in dbM | txpower in mW | auto} {[fixed | auto]}

Argument Type

iw_param *

Arguments

Defined in linux/wireless.h

value

Transmit (Tx) rate in dBm

disabled

n TRUE = Featured not enabled n FALSE = The AR6001 wishes to fix the Tx power

fixed

n TRUE = Software fixes this rate n FALSE = Allow hardware to auto-select the rate

flags

Units of Tx power value n IW_TXPOW_DBM = In dBm n IW_TXPOW_MWATT = Not supported

IOCTL Type

set

Class

Wireless extension

Name

CGIWTXPOW

Description

Retrieves the power of transmitted packet in the AR6001

Commands

iwlist eth1

txpower

Argument Type

struct iw_param *

Arguments

Defined in linux/wireless.h

value

Transmit (Tx) rate in dBm

disabled

n TRUE = Featured not enabled n FALSE = The AR6001 wishes to fix the Tx power

fixed

n TRUE = Software fixes this rate n FALSE = Allow hardware to auto-select the rate

flags

Units of Tx power value n IW_TXPOW_DBM = In dBm

IOCTL Type

get

Class

Wireless extension

Name

SIOCSIWENCODE

Description

Sets the WEP key for the AR6001

Commands

iwconfig eth1

key [key index] <k>

Argument Type

struct iw_point *, char *

Arguments

struct iw_point defines the WEP encryption method and key length

1. flags

IW_ENCODE_DISABLED

No encryption

IW_ENCODE_ENABLED

Encryption enabled

IW_ENCODE_OPEN

Accept non-encoded packets

IW_ENCODE_RESTRICTED

Refuse non-encode packets

IW_ENCODE_INDEX

Key index

IW_ENCODE_NOKEY/IW_ENCODE_TEMP

Not supported

length

5, 13, or 16

Length of valid ASCII WEP key

2. String representation of the WEP key (ASCII)

IOCTL Type

set

Class

Wireless extension

Name

SIOCGIWENCODE

Description

Retrieves the WEP key for the AR6001

Commands

iwlist eth1

key

Argument Type

struct iw_point *, char *

Arguments

struct iw_point defines the WEP encryption method and key length

1. flags

IW_ENCODE_DISABLED

No encryption

IW_ENCODE_ENABLED

Encryption enabled

IW_ENCODE_OPEN

Accept non-encoded packets

IW_ENCODE_RESTRICTED

Refuse non-encode packets

IW_ENCODE_INDEX

Key index

length

5, 13, or 16

Length of valid ASCII WEP key

2. String representation of the WEP key (ASCII)

IOCTL Type

get

Class

Wireless extension

Name

SIOCSIWRETRY

Description

Sets the maximum retry value from the failure frames. Supported in software version 1.2 or higher.

Commands

iwconfig eth1

retry <R>

Argument Type

struct iw_param *, char *

Arguments

struct iw_param

Defines the value of retry number

value

Retry limit

disabled

n TRUE = Featured not enabled n FALSE = The AR6001 wishes to fix the retry limit

flags

IW_RETRY_LIMIT

Maximum number of retries

IW_RETRY_LIFETIME

Maximum duration of retries in ms

IW_RETRY_MIN

The value is a minimum

IW_RETRY_MAX

The value is a maximum

IOCTL Type

set

Class

Wireless extension

Name

SIOCGIWRETRY

Description

Retrieves the maximum retry value from the failure frames. Supported in software version 1.2 or higher.

Commands

iwlist eth1

retry

Argument Type

struct iw_param *, char *

Arguments

struct iw_param

Defines the value of retry number

value

Retry limit

disabled

n TRUE = Featured not enabled n FALSE = The AR6001 wishes to fix the retry limit

flags

IW_RETRY_LIMIT

Maximum number of retries

IW_RETRY_LIFETIME

Maximum duration of retries in ms

IW_RETRY_MIN

The value is a minimum

IW_RETRY_MAX

The value is a maximum

IOCTL Type

get

Class

Wireless extension

Private IOCTLs

These are not documented. Check the ath6kl todo page for information on this and what we need to do to get rid of this.


This is a static dump of the old wiki, taken after locking it in January 2015. The new wiki is at https://wireless.wiki.kernel.org/.
versions of this page: last, v6, v5, v4, v3, v2, v1