Date: Mon, 3 Feb 2014 03:39:03 +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: r43731 - head/en_US.ISO8859-1/books/handbook/advanced-networking Message-ID: <201402030339.s133d3S2004072@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: wblock Date: Mon Feb 3 03:39:03 2014 New Revision: 43731 URL: http://svnweb.freebsd.org/changeset/doc/43731 Log: Restore <replaceable> tags in the wireless network section that were lost in the DocBook 5 conversion. 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 Mon Feb 3 00:18:59 2014 (r43730) +++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Mon Feb 3 03:39:03 2014 (r43731) @@ -1293,8 +1293,8 @@ wlan0: flags=8843<UP,BROADCAST,RUNNIN after &man.wpa.supplicant.8; has authenticated the station:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.100 netmask 255.255.255.0</userinput> -&prompt.root; <userinput>ifconfig wlan0</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> inet <replaceable>192.168.0.100</replaceable> netmask <replaceable>255.255.255.0</replaceable></userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable></userinput> wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 1500 ether 00:11:95:d5:43:62 inet 192.168.0.100 netmask 0xffffff00 broadcast 192.168.0.255 @@ -1310,8 +1310,8 @@ wlan0: flags=8843<UP,BROADCAST,RUNNIN default gateway and the nameserver also have to be manually set:</para> - <screen>&prompt.root; <userinput>route add default your_default_router</userinput> -&prompt.root; <userinput>echo "nameserver your_DNS_server" >> /etc/resolv.conf</userinput></screen> + <screen>&prompt.root; <userinput>route add default <replaceable>your_default_router</replaceable></userinput> +&prompt.root; <userinput>echo "nameserver <replaceable>your_DNS_server</replaceable>" >> /etc/resolv.conf</userinput></screen> </sect5> <sect5 xml:id="network-wireless-wpa-eap-tls"> @@ -1679,9 +1679,9 @@ wlan0: flags=8843<UP,BROADCAST,RUNNIN <para><acronym>WEP</acronym> can be set up using &man.ifconfig.8;:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0</userinput> -&prompt.root; <userinput>ifconfig wlan0 inet 192.168.1.100 netmask 255.255.255.0 \ - ssid my_net wepmode on weptxkey 3 wepkey 3:0x3456789012</userinput></screen> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable></userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> inet <replaceable>192.168.1.100</replaceable> netmask <replaceable>255.255.255.0</replaceable> \ + ssid <replaceable>my_net</replaceable> wepmode on weptxkey <replaceable>3</replaceable> wepkey <replaceable>3:0x3456789012</replaceable></userinput></screen> <itemizedlist> <listitem> @@ -1729,7 +1729,7 @@ wlan0: flags=8843<UP,BROADCAST,RUNNIN <para>Then:</para> - <screen>&prompt.root; <userinput>wpa_supplicant -i wlan0 -c /etc/wpa_supplicant.conf</userinput> + <screen>&prompt.root; <userinput>wpa_supplicant -i <replaceable>wlan0</replaceable> -c /etc/wpa_supplicant.conf</userinput> Trying to associate with 00:13:46:49:41:76 (SSID='dlinkap' freq=2437 MHz) Associated with 00:13:46:49:41:76</screen> </sect4> @@ -1748,9 +1748,9 @@ Associated with 00:13:46:49:41:76</scree <para>On <systemitem>A</systemitem>:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0 wlanmode adhoc</userinput> -&prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.1 netmask 255.255.255.0 ssid freebsdap</userinput> -&prompt.root; <userinput>ifconfig wlan0</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable> wlanmode adhoc</userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> inet <replaceable>192.168.0.1</replaceable> netmask <replaceable>255.255.255.0</replaceable> ssid <replaceable>freebsdap</replaceable></userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable></userinput> wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 ether 00:11:95:c3:0d:ac inet 192.168.0.1 netmask 0xffffff00 broadcast 192.168.0.255 @@ -1766,8 +1766,8 @@ Associated with 00:13:46:49:41:76</scree <para><systemitem>B</systemitem> should now be able to detect <systemitem>A</systemitem>:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0 wlanmode adhoc</userinput> -&prompt.root; <userinput>ifconfig wlan0 up scan</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable> wlanmode adhoc</userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> up scan</userinput> SSID/MESH ID BSSID CHAN RATE S:N INT CAPS freebsdap 02:11:95:c3:0d:ac 2 54M -64:-96 100 IS WME</screen> @@ -1776,8 +1776,8 @@ Associated with 00:13:46:49:41:76</scree <systemitem>B</systemitem> with a different <acronym>IP</acronym> address:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.2 netmask 255.255.255.0 ssid freebsdap</userinput> -&prompt.root; <userinput>ifconfig wlan0</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> inet <replaceable>192.168.0.2</replaceable> netmask <replaceable>255.255.255.0</replaceable> ssid <replaceable>freebsdap</replaceable></userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable></userinput> wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 ether 00:11:95:d5:43:62 inet 192.168.0.2 netmask 0xffffff00 broadcast 192.168.0.255 @@ -1821,8 +1821,8 @@ Associated with 00:13:46:49:41:76</scree the wireless device supports the host-based access point mode, also known as hostap mode:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0</userinput> -&prompt.root; <userinput>ifconfig wlan0 list caps</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable></userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> list caps</userinput> drivercaps=6f85edc1<STA,FF,TURBOP,IBSS,HOSTAP,AHDEMO,TXPMGT,SHSLOT,SHPREAMBLE,MONITOR,MBSS,WPA1,WPA2,BURST,WME,WDS,BGSCAN,TXFRAG> cryptocaps=1f<WEP,TKIP,AES,AES_CCM,TKIPMIC></screen> @@ -1838,18 +1838,18 @@ cryptocaps=1f<WEP,TKIP,AES,AES_CCM,TK during the creation of the network pseudo-device, so a previously created device must be destroyed first:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 destroy</userinput></screen> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> destroy</userinput></screen> <para>then regenerated with the correct option before setting the other parameters:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0 wlanmode hostap</userinput> -&prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.1 netmask 255.255.255.0 ssid freebsdap mode 11g channel 1</userinput></screen> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable> wlanmode hostap</userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> inet <replaceable>192.168.0.1</replaceable> netmask <replaceable>255.255.255.0</replaceable> ssid <replaceable>freebsdap</replaceable> mode 11g channel 1</userinput></screen> <para>Use &man.ifconfig.8; again to see the status of the <filename>wlan0</filename> interface:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable></userinput> wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 ether 00:11:95:c3:0d:ac inet 192.168.0.1 netmask 0xffffff00 broadcast 192.168.0.255 @@ -1886,16 +1886,16 @@ ifconfig_wlan0="inet <replaceable>192.16 a scan from another wireless machine to find the <acronym>AP</acronym>:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0</userinput> -&prompt.root; <userinput>ifconfig wlan0 up scan</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable></userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> up scan</userinput> SSID/MESH ID BSSID CHAN RATE S:N INT CAPS freebsdap 00:11:95:c3:0d:ac 1 54M -66:-96 100 ES WME</screen> <para>The client machine found the <acronym>AP</acronym> and can be associated with it:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.2 netmask 255.255.255.0 ssid freebsdap</userinput> -&prompt.root; <userinput>ifconfig wlan0</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> inet <replaceable>192.168.0.2</replaceable> netmask <replaceable>255.255.255.0</replaceable> ssid <replaceable>freebsdap</replaceable></userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable></userinput> wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 ether 00:11:95:d5:43:62 inet 192.168.0.2 netmask 0xffffff00 broadcast 192.168.0.255 @@ -2031,7 +2031,7 @@ wpa_pairwise=CCMP TKIP <co xml:id="co-ap <screen>&prompt.root; <userinput>service hostapd forcestart</userinput></screen> - <screen>&prompt.root; <userinput>ifconfig wlan0</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable></userinput> wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 2290 inet 192.168.0.1 netmask 0xffffff00 broadcast 192.168.0.255 inet6 fe80::211:95ff:fec3:dac%ath0 prefixlen 64 scopeid 0x4 @@ -2065,9 +2065,9 @@ wpa_pairwise=CCMP TKIP <co xml:id="co-ap configured with the correct <acronym>SSID</acronym> and <acronym>IP</acronym> address:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0 wlanmode hostap</userinput> -&prompt.root; <userinput>ifconfig wlan0 inet 192.168.0.1 netmask 255.255.255.0 \ - ssid freebsdap wepmode on weptxkey 3 wepkey 3:0x3456789012 mode 11g</userinput></screen> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable> wlanmode hostap</userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> inet <replaceable>192.168.0.1</replaceable> netmask <replaceable>255.255.255.0</replaceable> \ + ssid <replaceable>freebsdap</replaceable> wepmode on weptxkey <replaceable>3</replaceable> wepkey <replaceable>3:0x3456789012</replaceable> mode 11g</userinput></screen> <itemizedlist> <listitem> @@ -2092,7 +2092,7 @@ wpa_pairwise=CCMP TKIP <co xml:id="co-ap <para>Use &man.ifconfig.8; to see the status of the <filename>wlan0</filename> interface:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable></userinput> wlan0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 ether 00:11:95:c3:0d:ac inet 192.168.0.1 netmask 0xffffff00 broadcast 192.168.0.255 @@ -2105,8 +2105,8 @@ wpa_pairwise=CCMP TKIP <co xml:id="co-ap <para>From another wireless machine, it is now possible to initiate a scan to find the <acronym>AP</acronym>:</para> - <screen>&prompt.root; <userinput>ifconfig wlan0 create wlandev ath0</userinput> -&prompt.root; <userinput>ifconfig wlan0 up scan</userinput> + <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable></userinput> +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> up scan</userinput> SSID BSSID CHAN RATE S:N INT CAPS freebsdap 00:11:95:c3:0d:ac 1 54M 22:1 100 EPS</screen> @@ -2181,7 +2181,7 @@ freebsdap 00:11:95:c3:0d:ac 1 scanning for access points and the 802.11 protocol handshakes required to arrange communication:</para> - <screen>&prompt.root; <userinput>wlandebug -i ath0 +scan+auth+debug+assoc</userinput> + <screen>&prompt.root; <userinput>wlandebug -i <replaceable>ath0</replaceable> +scan+auth+debug+assoc</userinput> net.wlan.0.debug: 0 => 0xc80000<assoc,auth,scan></screen> <para>Many useful statistics are maintained by
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201402030339.s133d3S2004072>