2 Iwpriv

Name: iwpriv

Configure optionals (private) parameters of a wireless network interface.

Synopsis:

iwpriv [interface]

iwpriv interface private-command [private-parameters]

iwpriv interface private-command [I] [private-parameters]

iwpriv interface --all

iwpriv interface roam {on,off}

iwpriv interface port {ad-hoc,managed,N}

Description: Iwpriv is the companion tool to iwconfig(8). Iwpriv deals with parameters and settings specific to each driver (as opposed to iwconfig which deals with generic ones). Without any argument, iwpriv lists the private commands available on each interface, and the parameters that they require. Using this information, the user may apply those interface specific commands on the specified interface. In theory, the documentation of each device driver should indicate how to use those interface-specific commands and their effect.

Parameters

private-command [private-parameters]

Execute the specified private-command on the interface. The command may optionally take or require arguments, and may display information. Therefore, the command-line parameters may or may not be needed and should match the command expectations. The list of commands that iwpriv displays (when called without argument) should give you some hints about those parameters. However you should refer to the device driver documentation for information on how to properly use the command and the effect.

private-command [I] [private-parameters]

Idem, except that I (an integer) is passed to the command as a Token Index. Only some commands will use the Token Index (most will ignore it), and the driver documentation should tell you when it's needed.

-a/- -all

Execute and display all the private commands that don't take any arguments (i.e., read only).

roam

Enable or disable roaming, if supported. Call the private command setroam. Found in the wavelan_cs driver.

port

Read or configure the port type. Call the private commands gport_type, sport_type, get_port or set_port found in the wave- lan2_cs and wvlan_cs drivers.

Display

For each device that supports private commands, iwpriv will display the list of private commands available. This includes the name of the private command, the number or arguments that may be set and their type, and the number or arguments that may be displayed and their type. For example, you might have the following display:

eth0   Available private ioctl:

     setqualthr (89F0): set  1 byte & get  0

     gethisto (89F7): set  0   & get 16 int

This indicates that you may set the quality threshold and display a histogram of up to 16 values with the following commands:

iwpriv eth0 setqualthr 20

iwpriv eth0 gethisto

Author: Jean Tourrilhes - jt@hpl.hp.com

Files: /proc/net/wireless

See also: ifconfig(8), iwconfig(8), iwlist(8), iwspy(8), wavelan(4), wave- lan_cs(4), wvlan_cs(4), netwave_cs(4).