wireless_tools/iwpriv.8

   1 .\" Jean II - HPLB - 96
   2 .\" iwpriv.8
   3 .\"
   4 .TH IWPRIV 8 "31 October 1996" "net-tools" "Linux Programmer's Manual"
   5 .\"
   6 .\" NAME part
   7 .\"
   8 .SH NAME
   9 iwpriv \- configure optionals (private) parameters of a wireless
  10 network interface
  11 .\"
  12 .\" SYNOPSIS part
  13 .\"
  14 .SH SYNOPSIS
  15 .BI "iwpriv [" interface ]
  16 .br
  17 .BI "iwpriv " interface " " private-command " [" private-parameters ]
  18 .br
  19 .BI "iwpriv " interface " roam " {on,off}
  20 .br
  21 .BI "iwpriv " interface " port " {ad-hoc,managed,N}
  22 .\"
  23 .\" DESCRIPTION part
  24 .\"
  25 .SH DESCRIPTION
  26 .B Iwpriv
  27 is the companion tool to
  28 .IR iwconfig (8).
  29 .B Iwpriv
  30 deals with parameters and setting specific to each driver (as opposed to
  31 .I iwconfig
  32 which deals with generic ones) and a few commands that doesn't fit well in
  33 .I iwconfig
  34 (like listing the available frequencies).
  35 .PP
  36 Without any argument,
  37 .B iwpriv
  38 list the available private commands available on each interface, and
  39 the parameters that they require. Using this information, the user may
  40 apply those interface specific commands on the specified interface.
  41 .PP
  42 In theory, the documentation of each device driver should indicate how
  43 to use those interface specific commands and their effect.
  44 .\"
  45 .\" PARAMETER part
  46 .\"
  47 .SH PARAMETERS
  48 .TP
  49 .B roam
  50 Enable or disable roaming, if supported. Call the private command
  51 .IR setroam .
  52 Found in the
  53 .I wavelan_cs
  54 driver.
  55 .TP
  56 .B port
  57 Read or configure the port type. Call the private commands
  58 .IR gport_type ", " sport_type ", " get_port " or " set_port
  59 found in the
  60 .IR wavelan2_cs " and " wvlan_cs " drivers."
  61 .TP
  62 .I private-command
  63 Execute the specified
  64 .I private-command
  65 on the interface. The command may take or require arguments, and may
  66 display information. Refer to the device driver documentation for
  67 information on how to use and the effect.
  68 .\"
  69 .\" DISPLAY part
  70 .\"
  71 .SH DISPLAY
  72 For each device which support private commands,
  73 .I iwpriv
  74 will display the list of private commands available.
  75 .PP
  76 This include the name of the private command, the number or arguments
  77 that may be set and their type, and the number or arguments that may
  78 be display and their type.
  79 .PP
  80 For example, you may have the following display :
  81 .br
  82 .B "eth0      Available private ioctl :"
  83 .br
  84 .B "          setqualthr (89F0) : set   1 byte & get   0"
  85 .br
  86 .B "          gethisto (89F7) : set   0      & get  16 int"
  87 .PP
  88 This indicate that you may set the quality threshold and display an
  89 histogram of up to 16 values with the following commands :
  90 .br
  91 .I "  iwpriv eth0 setqualthr 20"
  92 .br
  93 .I "  iwpriv eth0 gethisto"
  94 .\"
  95 .\" AUTHOR part
  96 .\"
  97 .SH AUTHOR
  98 Jean Tourrilhes \- jt@hpl.hp.com
  99 .\"
 100 .\" FILES part
 101 .\"
 102 .SH FILES
 103 .I /proc/net/wireless
 104 .\"
 105 .\" SEE ALSO part
 106 .\"
 107 .SH SEE ALSO
 108 .BR ifconfig (8),
 109 .BR iwconfig (8),
 110 .BR iwlist (8),
 111 .BR iwspy (8),
 112 .BR wavelan (4),
 113 .BR wavelan_cs (4),
 114 .BR wvlan_cs (4),
 115 .BR netwave_cs (4).