diff options
author | Warren Block <wblock@FreeBSD.org> | 2014-05-14 20:33:46 +0000 |
---|---|---|
committer | Warren Block <wblock@FreeBSD.org> | 2014-05-14 20:33:46 +0000 |
commit | cad9394eb526bdd913f7b8315f1d8f620809f24e (patch) | |
tree | 94c924cbd9079fc71a74bf82369a182d90d60d9e /en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml | |
parent | 6d8aa3b0988548c8b9ff1b475d9e301d8b517f72 (diff) | |
download | doc-cad9394eb526bdd913f7b8315f1d8f620809f24e.tar.gz doc-cad9394eb526bdd913f7b8315f1d8f620809f24e.zip |
Add an initial quick start for the wireless networking section.
Notes
Notes:
svn path=/head/; revision=44833
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml')
-rw-r--r-- | en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml | 65 |
1 files changed, 65 insertions, 0 deletions
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"</programlisting> supported for a limited set of wireless devices.</para> </sect2> + <sect2 xml:id="network-wireless-quick-start"> + <title>Quick Start</title> + + <para>Connecting a computer to an existing wireless network is + a very common situation. This procedure shows the steps + required.</para> + + <procedure> + <step> + <para>Obtain the <acronym>SSID</acronym> (Service Set + Identifier) and <acronym>PSK</acronym> (Pre-Shared Key) for + the wireless network from the network administrator.</para> + </step> + + <step> + <para>Identify the wireless adapter. The &os; + <filename>GENERIC</filename> 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;:</para> + + <screen>&prompt.user; <userinput>ifconfig | grep -A4 -i wireless</userinput></screen> + + <para>If a wireless adapter is not listed, an additional + kernel module might be required, or it might be a model + not supported by &os;.</para> + <!-- WB: refer to section that shows how to identify a + wireless adapter and load the kernel modules for it. --> + + <para>This example shows the Atheros <literal>ath0</literal> + wireless adapter.</para> + </step> + + <step> + <para>Add an entry for this network to + <filename>/etc/wpa_supplicant.conf</filename>. If the + file does not exist, create it. Replace + <replaceable>myssid</replaceable> and + <replaceable>mypsk</replaceable> with the + <acronym>SSID</acronym> and <acronym>PSK</acronym> + provided by the network administrator.</para> + + <programlisting>network={ + ssid="<replaceable>myssid</replaceable>" + psk="<replaceable>mypsk</replaceable>" +}</programlisting> + </step> + + <step> + <para>Add entries to <filename>/etc/rc.conf</filename> to + configure the network on startup:</para> + + <programlisting>wlans_<replaceable>ath0</replaceable>="wlan0" +ifconfig_wlan0="WPA SYNCDHCP"</programlisting> + </step> + + <step> + <para>Restart the computer, or restart the network service + to connect to the network:</para> + + <screen>&prompt.root; <userinput>service netif restart</userinput></screen> + </step> + </procedure> + </sect2> + <sect2 xml:id="network-wireless-basic"> <title>Basic Setup</title> |