diff --git a/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml b/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml index 553e15e371..c70896a3e1 100644 --- a/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml +++ b/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml @@ -715,6 +715,71 @@ route_net2="-net 192.168.1.0/24 192.168.1.1" supported for a limited set of wireless devices. + + Quick Start + + Connecting a computer to an existing wireless network is + a very common situation. This procedure shows the steps + required. + + + + Obtain the SSID (Service Set + Identifier) and PSK (Pre-Shared Key) for + the wireless network from the network administrator. + + + + Identify the wireless adapter. The &os; + GENERIC kernel includes drivers for + many common wireless adapters. If the wireless adapter is + one of those models, it will be shown in the output from + &man.ifconfig.8;: + + &prompt.user; ifconfig | grep -A4 -i wireless + + If a wireless adapter is not listed, an additional + kernel module might be required, or it might be a model + not supported by &os;. + + + This example shows the Atheros ath0 + wireless adapter. + + + + Add an entry for this network to + /etc/wpa_supplicant.conf. If the + file does not exist, create it. Replace + myssid and + mypsk with the + SSID and PSK + provided by the network administrator. + + network={ + ssid="myssid" + psk="mypsk" +} + + + + Add entries to /etc/rc.conf to + configure the network on startup: + + wlans_ath0="wlan0" +ifconfig_wlan0="WPA SYNCDHCP" + + + + Restart the computer, or restart the network service + to connect to the network: + + &prompt.root; service netif restart + + + + Basic Setup