From owner-svn-doc-head@FreeBSD.ORG Wed May 14 20:33:47 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 12EA9CFF; Wed, 14 May 2014 20:33:47 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id E882E2790; Wed, 14 May 2014 20:33:46 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s4EKXkG0041610; Wed, 14 May 2014 20:33:46 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s4EKXkQ8041609; Wed, 14 May 2014 20:33:46 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201405142033.s4EKXkQ8041609@svn.freebsd.org> From: Warren Block Date: Wed, 14 May 2014 20:33:46 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 May 2014 20:33:47 -0000 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. + + 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