From 1aacce7a450370feff7a5e098c12e915e4f731f8 Mon Sep 17 00:00:00 2001 From: phk Date: Sat, 26 May 2001 09:27:08 +0000 Subject: Currently, each wireless networking driver has it's own control program despite the fact that most people want to set exactly the same settings regardless of which card they have. It has been repeatidly suggested that this configuration should be done via ifconfig. This patch implements the required functionality in ifconfig and add support to the wi and an drivers. It also provides partial, untested support for the awi driver. PR: 25577 Submitted by: Brooks Davis --- sbin/ifconfig/ifconfig.8 | 105 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 105 insertions(+) (limited to 'sbin/ifconfig/ifconfig.8') diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index d49f16d..3382a5d 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -413,6 +413,111 @@ This may be used to enable an interface after an It happens automatically when setting the first address on an interface. If the interface was reset when previously marked down, the hardware will be re-initialized. +.It Cm ssid Ar ssid +For IEEE 802.11 wireless interfaces, set the desired Service Set +Identifier (aka network name.) The SSID is a string up to 32 characters +in length and may be specified as either a normal string or in +hexadecimal when proceeded by +.Sq 0x . +Additionally, the SSID may be cleared by setting it to +.Sq - . +.It Cm nwid Ar ssid +Another name for the +.Dq ssid +parameter. Included for NetBSD compatibility. +.It Cm stationname Ar name +For IEEE 802.11 wireless interfaces, set the name of this station. +It appears that the station name is not really part of the IEEE 802.11 +protocol though all interfaces seem to support it. As such it only +seems to be meaningful to identical or virtually identical equipment. +Setting the station name is identical in syntax to setting the SSID. +.It Cm station Ar name +Another name for the +.Dq stationname +parameter. Included for BSD/OS compatibility. +.It Cm channel Ar number +For IEEE 802.11 wireless interfaces, set the desired channel. +Channels range from 1 to 14, but the exact selection available +depends on the region your adaptor was manufactured for. Setting +the channel to 0 will give you the default for your adaptor. Many +adaptors ignore this setting unless you are in ad-hoc mode. +.It Cm authmode Ar mode +For IEEE 802.11 wireless interfaces, set the desired authentication mode +in infrastructure mode. Not all adaptors support all modes. The set of +valid modes is +.Dq none , +.Dq open , +and +.Dq shared . +Modes are case insensitive. +.It Cm powersave +For IEEE 802.11 wireless interfaces, enable powersave mode. +.It Cm -powersave +For IEEE 802.11 wireless interfaces, disable powersave mode. +.It Cm powersavesleep Ar sleep +For IEEE 802.11 wireless interfaces, set the desired max powersave sleep +time in milliseconds. +.It Cm wepmode Ar mode +For IEEE 802.11 wireless interfaces, set the desired WEP mode. Not all +adaptors support all modes. The set of valid modes is +.Dq off , +.Dq on , +and +.Dq mixed . +.Dq Mixed +mode explicitly tells the adaptor to allow association with access +points which allow both encrypted and unencrypted traffic. On these +adaptors, +.Dq on +means that the access point must only allow encrypted connections. On +other adaptors, +.Dq on +is generally another name for +.Dq mixed . +Modes are case insensitive. +.It Cm weptxkey Ar index +For IEEE 802.11 wireless interfaces, set the WEP key to be used for +transmission. +.It Cm wepkey Ar key|index:key +For IEEE 802.11 wireless interfaces, set the selected WEP key. If +an +.Ar index +is not given, key 1 is set. A WEP key will be either 5 or 13 +characters (40 or 104 bits) depending of the local network and the +capabilities of the adaptor. It may be specified either as a plain +string or as a string of hexadecimal digits proceeded by +.Sq 0x . +A key may be cleared by setting it to +.Sq - . +If WEP is supported then there are at least four keys. Some adaptors +support more then four keys. If that is the case, then the first four keys +(1-4) will be the standard temporary keys and any others will be adaptor +specific keys such as permanent keys stored in NVRAM. +.It Cm wep +Another way of saying +.Dq wepmode on . +Included for BSD/OS compatibility. +.It Cm -wep +Another way of saying +.Dq wepmode off . +Included for BSD/OS compatibility. +.It Cm nwkey key +Another way of saying: +.Pp +``wepmode on weptxkey 1 wepkey 1:key wepkey 2:- wepkey 3:- wepkey 4:-''. +.Pp +Included for NetBSD compatibility. +.It Cm nwkey n:k1,k2,k3,k4 +Another way of saying +.Pp +``wepmode on weptxkey n wepkey 1:k1 wepkey 2:k2 wepkey 3:k3 wepkey 4:k4''. +.Pp +Included for NetBSD compatibility. +.It Cm -nwkey +Another way of saying +.Dq wepmode off . +.Pp +Included for NetBSD compatibility. .El .Pp .Nm Ifconfig -- cgit v1.1