svn commit: r44833 - head/en_US.ISO8859-1/books/handbook/advanced-networking

[Warren Block]

Author: wblock
Date: Wed May 14 20:33:46 2014
New Revision: 44833
URL: http://svnweb.freebsd.org/changeset/doc/44833

Log:
  Add an initial quick start for the wireless networking section.

Modified:
  head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml	Wed May 14 19:58:50 2014	(r44832)
+++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml	Wed May 14 20:33:46 2014	(r44833)
@@ -715,6 +715,71 @@ route_net2="-net 192.168.1.0/24 192.168.
 	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>