os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add an initial quick start for the wireless networking section.

Browse source
This commit is contained in:
Warren Block 2014-05-14 20:33:46 +00:00
parent 6d8aa3b098
commit cad9394eb5
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=44833
1 changed files with 65 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

65
en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
View file

@ -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>