Date: Wed, 14 May 2014 20:33:46 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44833 - head/en_US.ISO8859-1/books/handbook/advanced-networking Message-ID: <201405142033.s4EKXkQ8041609@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201405142033.s4EKXkQ8041609>