[user-guide] Tidy up 'Mobile Broadband' and 'Editing IPv4/IPv6' sections. Draft rewrite of the chapter is now com
Nathan Thomas
nathant at fedoraproject.org
Sat Aug 13 19:15:12 UTC 2011
commit 5e20bfcede25c2c1456b517b11729ba60d4cf66c
Author: Nathan Thomas <nathan at afternoondust.co.uk>
Date: Sat Aug 13 21:12:35 2011 +0200
Tidy up 'Mobile Broadband' and 'Editing IPv4/IPv6' sections. Draft rewrite of the chapter is now complete!
I was unable to test the Mobile Broadband instructions to see if they are still current as I don't have a mobile broadband connection available.
en-US/Connecting_to_the_Internet.xml | 361 ++++++++++------------------------
1 files changed, 103 insertions(+), 258 deletions(-)
---
diff --git a/en-US/Connecting_to_the_Internet.xml b/en-US/Connecting_to_the_Internet.xml
index 51877fb..2151182 100644
--- a/en-US/Connecting_to_the_Internet.xml
+++ b/en-US/Connecting_to_the_Internet.xml
@@ -38,17 +38,17 @@
<itemizedlist>
<listitem>
<para>
- If the computer is connected to a wired network, a picture of a cable is shown.
+ If the computer is connected to a wired network, the icon shows a cable.
</para>
</listitem>
<listitem>
<para>
- If the computer is connected to a wireless network, a picture of curved bands is shown. The color of the bands indicates the strength of the wireless signal - if the signal is at full strength, all of the bands will be white.
+ If the computer is connected to a wireless network, the icon shows curved bands increasing in size from bottom to top. The color of the bands indicates the strength of the wireless signal - if the signal is at full strength, all of the bands will be white.
</para>
</listitem>
<listitem>
<para>
- If the computer is not connected to any networks, a picture of two computers with a white cross between them is shown.
+ If the computer is not connected to any networks, the icon shows two computers with a white cross between them.
</para>
</listitem>
</itemizedlist>
@@ -134,12 +134,12 @@
<itemizedlist>
<listitem>
<para>
- Click on <menuchoice><guilabel>Wired</guilabel></menuchoice> to access detailed information about your wired connection, including hardware and IP addresses. You can configure advanced options, such as IPv4 and IPv6 settings, by clicking on <menuchoice><guilabel>Options...</guilabel></menuchoice>. You can choose whether to connect to a network automatically when you log in, and whether it is available to other users set up on your machine.
+ Click on <menuchoice><guilabel>Wired</guilabel></menuchoice> to access detailed information about your wired connection, including hardware and IP addresses. You can configure advanced options, such as IPv4 and IPv6 settings, by clicking on <menuchoice><guilabel>Options...</guilabel></menuchoice>. You can also choose whether to connect to a network automatically when you log in, and whether it is available to other users set up on your machine.
</para>
</listitem>
<listitem>
<para>
- Click on <menuchoice><guilabel>Wireless</guilabel></menuchoice> to see similar information regarding your wireless connection. Selecting <menuchoice><guilabel>Options...</guilabel></menuchoice> allows you to set the wireless network type, configure IPv4 and IPv6 settings, and enter security details. You can choose whether to connect to a network automatically when you log in, and whether it is available to other users set up on your machine.
+ Click on <menuchoice><guilabel>Wireless</guilabel></menuchoice> to see similar information regarding your wireless connection. Selecting <menuchoice><guilabel>Options...</guilabel></menuchoice> allows you to set the wireless network type, configure IPv4 and IPv6 settings, and enter security details. You can also choose whether to connect to a network automatically when you log in, and whether it is available to other users set up on your machine.
</para>
</listitem>
<listitem>
@@ -161,9 +161,9 @@
</section>
<section id="sect-User_Guide-Connecting_to_the_Internet_-_Using_NetworkManager_In_KDE_">
-
+ <title>Using The KNetworkManager Applet in KDE</title>
<para>
- Just like its GNOME counterpart, KDE provides an applet interface for NetworkManager, known as <application>KNetworkManager</application>. This application development was started by <ulink url="http://www.novell.com">Novell</ulink> and provides an integrated QT-based experience with similar usage and configuration as its GNOME counterpart, <application>nm-applet</application>.
+ Just like its GNOME counterpart, KDE provides an applet interface for NetworkManager, known as <application>KNetworkManager</application>. This application development was started by <ulink url="http://www.novell.com">Novell</ulink> and provides an integrated QT-based experience with similar usage and configuration as its GNOME counterpart.
</para>
<para>
The <application>KNetworkManager</application> applet icon normally resides on the right hand side of the panel. Clicking on the icon brings up a menu showing a list of available network interfaces on the left, and the currently connected network and/or a list of available networks on the right.
@@ -189,12 +189,12 @@
</listitem>
<listitem>
<para>
- Select <menuchoice><guilabel>WLAN interface</guilabel></menuchoice> from the <menuchoice><guilabel>Interfaces</guilabel></menuchoice> list on the left.
+ Select <menuchoice><guilabel>WLAN interface</guilabel></menuchoice> from the <guilabel>Interfaces</guilabel> list on the left.
</para>
</listitem>
<listitem>
<para>
- Select the name of the network you wish to connect to in the <menuchoice><guilabel>Connections</guilabel></menuchoice> list on the right.
+ Select the name of the network you wish to connect to in the <guilabel>Connections</guilabel> list on the right. If the network you want isn't listed, you may need to click on <guilabel>Show More...</guilabel> to show more available networks.
</para>
</listitem>
<listitem>
@@ -220,59 +220,35 @@
</important>
</section>
</section>
-
-<listitem>
-<para>
-<!--
- INSERT a link like when available */en-US/sect-Release_Notes-Networking.html
--->
-<ulink url="http://docs.fedoraproject.org/">Fedora 13 Release Notes</ulink>
-</para>
-</listitem>
-</itemizedlist>
-</section>
+
-<section id="sect-User_Guide-Connecting_to_the_Internet-Mobile_Broadband">
-<title>Mobile Broadband</title>
-<para>
+ <section id="sect-User_Guide-Connecting_to_the_Internet-Mobile_Broadband">
+ <title>Mobile Broadband</title>
+ <para>
<!-- copied & pasted from features 13 -->
- Once your card is inserted, you can easily create a Mobile Broadband connection, as indicated below. For many mobile broadband cards,
-<application>NetworkManager</application>
- can visualize in the NM applet icon, cellular signal strength and technology, and listen for signal strength changes or poll modem-manager for such changes while connected. In this way, you are able to know when the device has a signal and if it is roaming or not.
+ Once your card is inserted, you can easily create a Mobile Broadband connection, as indicated below. For many mobile broadband cards, <application>NetworkManager</application> can visualize in the NM applet icon, cellular signal strength and technology, and listen for signal strength changes or poll modem-manager for such changes while connected. In this way, you are able to know when the device has a signal and if it is roaming or not.
+ </para>
+ <para>
+ If you have a Bluetooth adapter and a mobile phone (GPRS) that supports Bluetooth DUN, you can pair the phone with the computer. If your phone and network provider allow it, you can then use <application>NetworkManager</application> to connect to the Internet using your mobile phone's network connection. First, pair your phone with your computer using the <application>Bluetooth Manager</application> applet in the top bar. In the final screen of the Bluetooth pairing process, tick the checkbox that says <menuchoice><guimenu>Access the Internet using your mobile phone</guimenu></menuchoice>. A <guilabel>Mobile Broadband</guilabel> section will then appear in the <application>NetworkManager</application> applet menu.
+ </para>
+ <note>
+ <title>Supported Mobile Broadband</title>
+ <para>
+ For a list of supported mobile broadband interfaces, look at <ulink url="http://live.gnome.org/NetworkManager/MobileBroadband">NetworkManager - Mobile Broadband</ulink>, on the gnome.org site. If your device is not supported, please contact the <ulink url="http://mail.gnome.org/mailman/listinfo/networkmanager-list">mailing list</ulink> with information on your device.
+ </para>
+ </note>
- </para>
- <para>
- <application>NetworkManager</application>
- uses the gnome-bluetooth plugin to help to configure your Mobile Broadband with the service provider. Also, if you have a Bluetooth adapter and a mobile phone (GPRS) that supports Bluetooth DUN, you can pair the phone with the computer, and let
- <application>NetworkManager</application>
- recognize your mobile phone; at the end of the pairing process you'll see a screen with checkbox that says
- <menuchoice><guimenu>Access the Internet using your mobile phone</guimenu></menuchoice>. After checking that box, a progress indicator will appear and say
-<menuchoice><guimenu>Detecting phone configuration</guimenu></menuchoice>.
- </para>
- <note>
- <title>Supported Mobile Broadband</title>
- <para>
- For a list of supported devices, look at
- <ulink url="http://live.gnome.org/NetworkManager/MobileBroadband">NetworkManager - Mobile Broadband</ulink>
- , on the gnome.org site. If your device is not supported, please contact the
- <ulink url="http://mail.gnome.org/mailman/listinfo/networkmanager-list"> mailing list </ulink>
- with information on your device.
- </para>
- </note>
-<section id="sect-User_Guide-Connecting_to_the_Internet-Mobile_Broadband-New_Connection">
- <title>Create a Mobile Broadband network connection</title>
- <para>
- Right-click on the <application>NetworkManager</application> applet Icon and select
- <menuchoice><guimenu>Edit Connections...</guimenu></menuchoice> then select the
- <guilabel>Mobile Broadband</guilabel> tab, and click on the <guilabel>Add</guilabel> button.
- A wizard will open that will assist you in the configuration and ask for information about your provider. Specifically, you should know:
- </para>
- <itemizedlist>
- <listitem> <para> Broadband Provider's name </para></listitem>
- <listitem> <para> Broadband Billing Plan name </para></listitem>
- <listitem> <para> Broadband Billing Plan APN (Access Point Name) </para></listitem>
- </itemizedlist>
- <para> The wizard displays: </para>
+ <section id="sect-User_Guide-Connecting_to_the_Internet-Mobile_Broadband-New_Connection">
+ <title>Create a Mobile Broadband network connection</title>
+ <para>
+ Click on the <application>NetworkManager</application> applet icon and ensure that the <guilabel>Mobile Broadband</guilabel> section is visible and that the toggle switch is switched to <guibutton>ON</guibutton>. Then click on the name of your mobile broadband interface. A wizard will open that will assist you in the configuration and ask for information about your provider. Specifically, you should know:
+ <itemizedlist>
+ <listitem> <para>Your mobile broadband provider's name </para></listitem>
+ <listitem> <para>The name of your mobile broadband billing plan</para></listitem>
+ <listitem> <para>The name of your broadband billing plan APN (Access Point Name)</para></listitem>
+ </itemizedlist>
+ </para>
+ <para>The wizard displays:
<orderedlist>
<listitem><para>
An information page that let you choose, if more than one are available, the Mobile device to configure.
@@ -293,13 +269,8 @@
</para>
</listitem>
</orderedlist>
-<para>
-
- Then you need to
-<xref linkend="sect-User_Guide-Connecting_to_the_Internet-Mobile_Broadband-Setup"/>
-.
-
</para>
+
<important>
<title>My Service Provider is not listed</title>
<para>
@@ -311,6 +282,7 @@
</para>
</important>
</section>
+
<!--
Mobile_Broadband-Setup
-->
@@ -340,201 +312,71 @@ The tab also specifies the username and password used to authenticate with the n
</section>
</section>
-<section id="sect-User_Guide-Connecting_to_the_Internet-Wired_connection">
-<title>Wired connections</title>
-<para>
-For wired connections, a common user, generally, doesn't need to do any configuration. Most users use DHCP to obtain all configuration information from the network.
-</para>
-<section id="sect-User_Guide-Connecting_to_the_Internet-Items_Editing_Wired">
-<title>Wired Tab</title>
-<itemizedlist>
-<listitem>
-<para>
-<guilabel>Mac Address</guilabel>
-: The HW address of your network card. When the system boots, it recognizes the network card and its HW address. If you need to know the Mac Address of an interface, open a terminal and run <command>ip link</command>
-</para>
-<screen>
-$ ip link show eth0
-2: eth0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc pfifo_fast state DOWN qlen 1000
- link/ether 00:23:8b:dc:ae:67 brd ff:ff:ff:ff:ff:ff
-</screen>
-</listitem>
-<listitem>
-<para>
-<guilabel>MTU</guilabel>
- (Maximum Transmission Unit): If non-zero, the card transmits packets of the specified size or smaller, breaking larger packets up into multiple Ethernet frames. You could set this to
-<guilabel>Automatic</guilabel>
- and les the system determine the MTU for you.
-
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<!--
-cont. Wired Section
--->
-<section id="sect-User_Guide-Wired_Security">
-<title>802.1x Tab</title>
-<para>
-Use this tab if you want to cipher your Ethernet communications (default is unset)
-</para>
-</section>
<section id="sect-User_Guide-Connecting_to_the_Internet-Items_Editing_IPv4">
-<title>IPv4 Tab</title>
-<itemizedlist>
-<listitem>
-<para>
-<guilabel>Automatic (DHCP)</guilabel>
-: Specifying this method, then the O.S. does it all for you (default)
-
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Automatic (DHCP) addresses only</guilabel>
-: Specifying this method, then only automatic DHCP is used and at least one IP address must be given in the
-<guilabel>DNS servers</guilabel>
- entry.
-
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Manual</guilabel>
-: Specifying this method, static IP addressing is used and at least one IP address must be given in the
-<guilabel>DNS servers</guilabel>
- entry.
-
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Link-Local Only</guilabel>
-: Specifying this method, a link-local address in the 169.254/16 range will be assigned to the interface.
-
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Shared to other computers</guilabel>
-: Specifying this method, (indicating that this connection will provide network access to other computers) then the interface is assigned an address in the 10.42.x.1/24 range and a DHCP and forwarding DNS server are started, and the interface is NAT-ed to the current default network connection.
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>DNS Servers</guilabel>
-: List of DNS servers. For the
-<guilabel>Automatic (DHCP)</guilabel>
- method, these DNS servers are appended to those (if any) returned by automatic configuration. DNS servers cannot be used with the
-<guilabel>Shared to other computers</guilabel>
- or
-<guilabel>Link-Local Only</guilabel>
- methods as there is no usptream network. In
-<guilabel>Automatic (DHCP) addresses only</guilabel>
- and
-<guilabel>Manual</guilabel>
- methods, these DNS servers are used as the only DNS servers for this connection.
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Search domains</guilabel>
-: List of DNS search domains. For the
-<guilabel>Automatic (DHCP)</guilabel>
- method, these search domains are appended to those returned by automatic configuration. Search domains cannot be used with the
-<guilabel>Shared to other computers</guilabel>
- or
-<guilabel>Link-Local Only</guilabel>
- methods as there is no upstream network. In
-<guilabel>Automatic (DHCP) addresses only</guilabel>
- and
-<guilabel>Manual</guilabel>
- methods, these search domains are used as the only search domains for this connection.
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Routes...</guilabel>
-: Fowarding table or routing table. Each IPv4 route structure is composed of 4 32-bit values; the first,
-<guilabel>Address</guilabel>
- being the destination IPv4 network; the second,
-<guilabel>Netmask</guilabel>
- the destination network, the third,
-<guilabel>Gateway</guilabel>
- being the next-hop if any, and the fourth,
-<guilabel>Metric</guilabel>
- being the route metric. For the
-<guilabel>Automatic (DHCP)</guilabel>
- method, given IP routes are appended to those returned by automatic configuration. Routes cannot be used with the
-<guilabel>Shared to other computers</guilabel>
- or
-<guilabel>Link-Local Only</guilabel>
- methods as there is no upstream network.
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>DHCP client ID</guilabel>
-: The local machine which the DHCP server may use to customize the DHCP lease and options.
-</para>
-</listitem>
-</itemizedlist>
-</section>
-</section>
-<section id="sect-User_Guide-Setup_VPN">
-<title>VPN connections</title>
-<para>
-Here are some items, depending on the VPN connection type, required when configuring a VPN connection:
-</para>
-<para>
-The <guilabel>VPN</guilabel> tab allows you to specify the <guilabel>Gateway</guilabel>, <guilabel>Type</guilabel>, <guilabel>Username</guilabel>, and <guilabel>CA Certificate</guilabel>.
-</para>
+<title>Editing IPv4 and IPv6 Settings</title>
<para>
- The <guilabel>IPv4 Settings</guilabel> tab configures the Internet settings automatically (default), automatically for the addresses but manually for DNS settings, or completely manually.
- </para>
-</section>
-<!--
-xDSL Setup
--->
-<section id="sect-User_Guide-Setup_xDSL">
-<title>xDSL connections</title>
-<para>
-The items generally used in the xDSL connections are:
-</para>
-<itemizedlist>
-<listitem>
-<para>
-On the <guilabel>xDSL</guilabel> tab specify the <guilabel>Username</guilabel>
-and if needed, the <guilabel>Password</guilabel> used to authenticate with the Service Provider.
-For most providers, the <guilabel>Service</guilabel> entry should be left blank.
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>PPP-Settings</guilabel>
- tab: default values.
-</para>
-</listitem>
-<listitem>
-<para>
-<guilabel>Wired</guilabel>
- tab: View
-<xref linkend="sect-User_Guide-Connecting_to_the_Internet-Items_Editing_Wired"/>
-</para>
-</listitem>
-<listitem>
-<para>
- The IPv4 Settings Tab configures the Internet settings automatically (default), automatically for the addresses but manually for DNS settings, or completely manually.
-</para>
-</listitem>
-</itemizedlist>
-</section>
-<section id="sect-User_Guide-Connecting_to_the_Internet-NM_CLI">
+ <application>NetworkManager</application> automatically configures the IPv4 and IPv6 settings for your networks, but sometimes you may need to edit them by hand. The following options are available:
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Automatic (DHCP)</guilabel>: Specifying this method, NetworkManager handles IP settings for you (this is the default setting).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Automatic (DHCP) addresses only</guilabel>: Specifying this method, then only automatic DHCP is used and at least one IP address must be given in the <guilabel>DNS servers</guilabel> entry field.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Manual</guilabel>: Specifying this method, static IP addressing is used and at least one IP address must be given in the <guilabel>DNS servers</guilabel> entry field.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Link-Local Only</guilabel>: Specifying this method, a link-local address in the 169.254/16 range will be assigned to the interface.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Shared to other computers</guilabel>: When this method is specified (indicating that this connection will provide network access to other computers), the interface is assigned an address in the 10.42.x.1/24 range, a DHCP and forwarding DNS server are started, and the interface is translated via NAT to the current default network connection.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>DNS Servers</guilabel>: List of DNS servers. For the <guilabel>Automatic (DHCP)</guilabel>
+ method, these DNS servers are appended to those (if any) returned by automatic configuration. DNS servers cannot be used with the
+<guilabel>Shared to other computers</guilabel> or <guilabel>Link-Local Only</guilabel> methods as there is no usptream network. In
+<guilabel>Automatic (DHCP) addresses only</guilabel> and <guilabel>Manual</guilabel> methods, these DNS servers are used as the only DNS servers for this connection.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Search domains</guilabel>: List of DNS search domains. For the <guilabel>Automatic (DHCP)</guilabel>
+ method, these search domains are appended to those returned by automatic configuration. Search domains cannot be used with the <guilabel>Shared to other computers</guilabel> or <guilabel>Link-Local Only</guilabel> methods as there is no upstream network. In
+<guilabel>Automatic (DHCP) addresses only</guilabel> and <guilabel>Manual</guilabel> methods, these search domains are used as the only search domains for this connection.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Routes...</guilabel>: Fowarding table or routing table. Each IPv4 route structure is composed of 4 32-bit values; the first, <guilabel>Address</guilabel> being the destination IPv4 network; the second, <guilabel>Netmask</guilabel> the destination network, the third, <guilabel>Gateway</guilabel> being the next-hop if any, and the fourth, <guilabel>Metric</guilabel> being the route metric. For the <guilabel>Automatic (DHCP)</guilabel> method, given IP routes are appended to those returned by automatic configuration. Routes cannot be used with the <guilabel>Shared to other computers</guilabel> or <guilabel>Link-Local Only</guilabel> methods as there is no upstream network.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>DHCP client ID</guilabel>: The local machine which the DHCP server may use to customize the DHCP lease and options.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </section>
+
+<section id="sect-User_Guide-Connecting_to_the_Internet_-_NetworkManager_CLI_">
<title>NetworkManager in a CLI</title>
<para>
-For those users who prefer the command line, Fedora 13 introduced two new tools for managing networks with NetworkManager at the command line.
+For those users who prefer the command line, Fedora includes two new tools for managing networks with NetworkManager at the command line.
</para>
-<section id="sect-User_Guide-Connecting_to_the_Internet-nmcli">
+<section id="sect-User_Guide-Connecting_to_the_Internet_-_NetworkManager_CLI_-_nmcli_">
<title>nmcli</title>
<para>
<command>nmcli</command>
@@ -612,12 +454,13 @@ NM WWAN: enabled
for more information.
</para>
</section>
-<section id="sect-User_Guide-Connecting_to_the_Internet-NM-nm-tools">
+
+<section id="sect-User_Guide-Connecting_to_the_Internet_-_NetworkManager_CLI_-_nm-tools_">
<title>nm-tools</title>
<para>
The
<command>nm-tool</command>
- utility provides information about NetworkManager, device, and wireless networks. For example:
+ utility provides information about <application>NetworkManager</application>, network interfaces, and wireless networks. For example:
</para>
<screen>
$ nm-tool
@@ -649,6 +492,7 @@ State: connected
$
</screen>
</section>
+</section>
<section id="sect-User_Guide-Connecting_to_the_Internet_-_More_Information_About_NetworkManager_">
<title>More Information About NetworkManager</title>
@@ -670,8 +514,9 @@ $
<ulink url="https://fedoraproject.org/wiki/NetworkManager_in_Fedora_13">NetworkManager in Fedora 13</ulink> overview and interview with NetworkManager developer Dan Williams.
</para>
</listitem>
+ </itemizedlist>
</para>
</section>
-</section>
+
</chapter>
More information about the docs-commits
mailing list