From owner-svn-doc-head@FreeBSD.ORG Fri Oct 18 02:29:59 2013 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 ESMTP id 4328C1F0; Fri, 18 Oct 2013 02:29:59 +0000 (UTC) (envelope-from dru@FreeBSD.org) 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)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 2DB5E23CD; Fri, 18 Oct 2013 02:29:59 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9I2TxFw017467; Fri, 18 Oct 2013 02:29:59 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9I2Tx8T017466; Fri, 18 Oct 2013 02:29:59 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201310180229.r9I2Tx8T017466@svn.freebsd.org> From: Dru Lavigne Date: Fri, 18 Oct 2013 02:29:59 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42995 - head/en_US.ISO8859-1/books/handbook/ppp-and-slip 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.14 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: Fri, 18 Oct 2013 02:29:59 -0000 Author: dru Date: Fri Oct 18 02:29:58 2013 New Revision: 42995 URL: http://svnweb.freebsd.org/changeset/doc/42995 Log: White space fix only. Translators can ignore. Modified: head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Thu Oct 17 23:57:36 2013 (r42994) +++ head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Fri Oct 18 02:29:58 2013 (r42995) @@ -63,8 +63,8 @@ Be familiar with basic network terminology. - Understand the basics and purpose of a dial-up connection - and PPP. + Understand the basics and purpose of a dial-up + connection and PPP. @@ -120,35 +120,35 @@ - The dial-up number for the ISP. + The dial-up number for the + ISP. - The login name and password assigned by the ISP. + The login name and password assigned by the + ISP. - The IP address of one or more name servers. - Normally, an ISP provides these addresses. - If not, use enable - dns in ppp.conf - and ppp will set the name - servers. This feature requires the ISP - to supporting DNS - negotiation. + The IP address of one or more name + servers. Normally, an ISP provides these + addresses. If not, use enable dns in + ppp.conf and + ppp will set the name servers. + This feature requires the ISP to + supporting DNS negotiation. - The following information may be supplied by the ISP, but - is not necessary: + The following information may be supplied by the + ISP, but is not necessary: - The IP address of the default gateway. - If this information is missing - the ISP's PPP - server will provide the correct value during - connection setup. + The IP address of the default + gateway. If this information is missing the + ISP's PPP server will + provide the correct value during connection setup. This IP number is referred to as HISADDR by @@ -166,9 +166,10 @@ static IP address - If the ISP has assigned a static IP address and - hostname, enter it. Otherwise, this information will be provided - during connection setup. + If the ISP has assigned a static + IP address and hostname, enter it. + Otherwise, this information will be provided during + connection setup. @@ -191,20 +192,22 @@ A number of files are edited when configuring ppp. The edits - depend to some extent on whether the ISP allocates IP - addresses statically or dynamically. + depend to some extent on whether the ISP + allocates IP addresses statically or + dynamically. PPP With Static <acronym>IP</acronym> Addresses PPP - with static IP addresses + with static IP + addresses - If the ISP has provided an address that does not change, edit - /etc/ppp/ppp.conf as described - in the example below. + If the ISP has provided an address that does not change, + edit /etc/ppp/ppp.conf as described in + the example below. Lines that end in a : start in the @@ -346,10 +349,10 @@ Identifies an entry for a provider called provider. This could be changed - to the name of the ISP so - that can be used to start - the connection. + to the name of the ISP so that + can be + used to start the connection. @@ -393,11 +396,10 @@ Line 15: - If - PAP or - CHAP are used, - there will be no login at this point, and this line - should be commented out or removed. See If PAP or + CHAP are used, there will be no + login at this point, and this line should be + commented out or removed. See for further details. @@ -438,21 +440,18 @@ protocol: ppp Sets the interface addresses. The string x.x.x.x should be - replaced by the IP address that the - ISP - has allocated. The string - y.y.y.y should be + replaced by the IP address that + the ISP has allocated. The + string y.y.y.y should be replaced by the IP address of the - gateway. If the ISP has not provided a gateway - address, use 10.0.0.2/0. When - using a guessed address, - create an entry in + gateway. If the ISP has not + provided a gateway address, use 10.0.0.2/0. When using a + guessed address, create an entry in /etc/ppp/ppp.linkup as per the - instructions in . If this line is - omitted, ppp cannot run in - mode. + instructions in . + If this line is omitted, ppp + cannot run in mode. @@ -467,20 +466,20 @@ protocol: ppp otherwise HISADDR will not yet be initialized. - When - is not used, this line should be moved - to the ppp.linkup file. + When is not used, this + line should be moved to the + ppp.linkup file. It is not necessary to add an entry to ppp.linkup when using a static - IP address and when running ppp in - mode as the routing table entries are already correct. - However, an - entry can be created to invoke programs after connection. This is - explained later with the sendmail example. + IP address and when running ppp in + mode as the routing table entries + are already correct. However, an entry can be created to + invoke programs after connection. This is explained later + with the sendmail example. Example configuration files can be found in the - <acronym>PPP</acronym> With Dynamic <acronym>IP</acronym> - Addresses + <acronym>PPP</acronym> With Dynamic + <acronym>IP</acronym> Addresses PPP - with dynamic IP addresses + with dynamic IP + addresses IPCP - If the IP - address changes whenever a connection is made, configure ppp to + If the IP address changes whenever + a connection is made, configure ppp to negotiate the local and remote addresses. This is done by - guessing an IP address and allowing - ppp to set it up correctly using the IP - Configuration Protocol (IPCP) after connecting. The + guessing an IP address + and allowing ppp to set it up correctly + using the IP Configuration Protocol + (IPCP) after connecting. The ppp.conf configuration is the same as - that described in , with the following - change: + that described in , with + the following change: 17 set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.255 0.0.0.0 @@ -525,16 +525,16 @@ protocol: ppp The number after the / character is the number of bits of the address that - ppp will insist on. Other IP addresses - can be used, but the - above example will always work. + ppp will insist on. Other IP + addresses can be used, but the above example will + always work. The last argument (0.0.0.0) tells PPP to start negotiations using address 0.0.0.0 rather than 10.0.0.1 and is - necessary for some ISPs. Do not use - 0.0.0.0 as the first argument + necessary for some ISPs. Do not + use 0.0.0.0 as the first argument to set ifaddr as it prevents PPP from setting up an initial route in mode. @@ -544,12 +544,11 @@ protocol: ppp When not running in mode, create an entry in - /etc/ppp/ppp.linkup as this file - is used after a connection - has been established. At this point, - ppp will have assigned the interface - addresses and it will now be possible to add the routing - table entries: + /etc/ppp/ppp.linkup as this file is + used after a connection has been established. At this + point, ppp will have assigned the + interface addresses and it will now be possible to add the + routing table entries: 1 provider: 2 add default HISADDR @@ -564,8 +563,9 @@ protocol: ppp ppp.linkup according to the following rules: First, try to match the same label as we used in ppp.conf. If - that fails, look for an entry for the IP address of - our gateway. This entry is a four-octet IP style + that fails, look for an entry for the + IP address of our gateway. This + entry is a four-octet IP style label. If we still have not found an entry, look for the MYADDR entry. @@ -579,8 +579,8 @@ protocol: ppp default route that points to HISADDR. HISADDR will be replaced with the - IP number of the gateway as negotiated by the - IPCP. + IP number of the gateway as + negotiated by the IPCP. @@ -602,8 +602,8 @@ protocol: ppp When configuring ppp to receive incoming calls on a machine connected to a LAN, - decide if packets should be forwarded to the LAN. - If so, allocate the peer an IP address from + decide if packets should be forwarded to the LAN. If so, + allocate the peer an IP address from the LAN's subnet, and use enable proxy in the /etc/ppp/ppp.conf. @@ -616,8 +616,7 @@ protocol: ppp Which getty? - - provides a good description + provides a good description on enabling dial-up services using &man.getty.8;. An alternative to getty is <application>PPP</application> Permissions The ppp command must normally be - run as the root user. - To instead allow ppp to run in - server mode as a normal user, that user - must be given permission to run ppp - by adding them to the network - group in /etc/group. + run as the root user. To instead + allow ppp to run in server mode as a + normal user, that user must be given permission to run + ppp by adding them to the + network group in + /etc/group. - The user also needs access to one or more - sections of the configuration file using the + The user also needs access to one or more sections of + the configuration file using the allow command: allow users fred mary @@ -664,8 +663,8 @@ protocol: ppp - <acronym>PPP</acronym> Shells for Dynamic <acronym>IP</acronym> - Users + <acronym>PPP</acronym> Shells for Dynamic + <acronym>IP</acronym> Users PPP shells @@ -696,9 +695,9 @@ exec /usr/sbin/ppp -direct $IDENT&prompt.root; ln -s ppp-shell /etc/ppp/ppp-dialup Use this script as the - shell for all of dial-up users. - This is an example from /etc/passwd - for a dial-up PPP: + shell for all of dial-up users. This + is an example from /etc/passwd for a + dial-up PPP: pchilds:*:1011:300:Peter Childs PPP:/home/ppp:/etc/ppp/ppp-dialup @@ -715,8 +714,8 @@ exec /usr/sbin/ppp -direct $IDENT - <acronym>PPP</acronym> Shells for Static <acronym>IP</acronym> - Users + <acronym>PPP</acronym> Shells for Static + <acronym>IP</acronym> Users PPP shells @@ -727,10 +726,10 @@ exec /usr/sbin/ppp -direct $IDENTIPs create a symbolic link to ppp-shell. - For example, to route /24 CIDR - networks for the dial-up customers - fred, sam, - and mary, type: + For example, to route /24 CIDR networks for the + dial-up customers fred, + sam, and + mary, type: &prompt.root; ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-fred &prompt.root; ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-sam @@ -769,8 +768,9 @@ ttyu1: for each session. For each dial-up line enabled in /etc/ttys create an entry similar to the one for ttyu0: above. Each - line should get a unique IP address from the pool of - IP addresses for dynamic users. + line should get a unique IP address + from the pool of IP addresses for + dynamic users. @@ -779,8 +779,8 @@ ttyu1: Along with the contents of the sample /usr/share/examples/ppp/ppp.conf - above, add a section for each of the - statically assigned dial-up users:. + above, add a section for each of the statically assigned + dial-up users:. fred: set ifaddr 203.14.100.1 203.14.101.1 255.255.255.255 @@ -793,9 +793,10 @@ mary: The file /etc/ppp/ppp.linkup should also contain routing information for each static - IP user if required. The line below would add a route - for the 203.14.101.0/24 - network via the client's ppp link. + IP user if required. The line below + would add a route for the 203.14.101.0/24 network via the + client's ppp link. fred: add 203.14.101.0 netmask 255.255.255.0 HISADDR @@ -874,8 +875,8 @@ exec /usr/sbin/ppp -direct pap$IDENTenable passwdauth - To assign some users a static IP number, - specify the number as the third argument in + To assign some users a static IP + number, specify the number as the third argument in /etc/ppp/ppp.secret. See /usr/share/examples/ppp/ppp.secret.sample for examples. @@ -920,8 +921,8 @@ set nbns 203.14.100.5 name server addresses, and a NetBIOS nameserver host. - In version 2 and above, if the - set dns line is omitted, + In version 2 and above, if the set + dns line is omitted, PPP will use the values found in /etc/resolv.conf. @@ -931,12 +932,13 @@ set nbns 203.14.100.5 PAP CHAP - Some ISPs set their system up so that the - authentication part of the connection is done using - either of the PAP or CHAP authentication mechanisms. If - this is the case, the ISP will not give a - login: prompt at connection, but will - start talking PPP immediately. + Some ISPs set their system up so + that the authentication part of the connection is done + using either of the PAP or CHAP authentication mechanisms. + If this is the case, the ISP will not + give a login: prompt at connection, but + will start talking PPP + immediately. PAP is less secure than CHAP, but security is not normally an issue here as passwords, although being sent @@ -944,12 +946,9 @@ set nbns 203.14.100.5 serial line only. There is not much room for crackers to eavesdrop. - Referring back to - or , - the following alterations must - be made: + Referring back to + or , the following + alterations must be made: 13 set authname MyUserName 14 set authkey MyPassword @@ -991,10 +990,10 @@ set nbns 203.14.100.5 Line 15: - The ISP will not normally require a login - to the server when using PAP or CHAP. - Therefore, disable the set login - string. + The ISP will not normally + require a login to the server when using PAP or + CHAP. Therefore, disable the set + login string. @@ -1011,17 +1010,17 @@ set nbns 203.14.100.5 set server /var/run/ppp-tun%d DiagnosticPassword 0177 - This will tell PPP to listen to the specified - &unix; domain socket, asking clients for the specified - password before allowing access. The - %d in the name is replaced with the - tun device number that is in - use. - - Once a socket has been set up, the &man.pppctl.8; - program may be used in scripts that wish to manipulate - the running program. - + This will tell PPP to listen to the specified + &unix; domain socket, asking clients for the specified + password before allowing access. The + %d in the name is replaced with the + tun device number that is in + use. + + Once a socket has been set up, the &man.pppctl.8; + program may be used in scripts that wish to manipulate + the running program. + Using <acronym>PPP</acronym> Network Address @@ -1072,14 +1071,15 @@ nat port tcp 10.0.0.2:http http</program <programlisting>hostname="foo.example.com"</programlisting> - <para>If the <acronym>ISP</acronym> has supplied a static <acronym>IP</acronym> address - and name, use this name as the + <para>If the <acronym>ISP</acronym> has supplied a static + <acronym>IP</acronym> address and name, use this name as the host name.</para> <para>Look for the <literal>network_interfaces</literal> variable. To configure the system to dial the - <acronym>ISP</acronym> on demand, make sure the <devicename>tun0</devicename> - device is added to the list, otherwise remove it.</para> + <acronym>ISP</acronym> on demand, make sure the + <devicename>tun0</devicename> device is added to the list, + otherwise remove it.</para> <programlisting>network_interfaces="lo0 tun0" ifconfig_tun0=</programlisting> @@ -1093,10 +1093,10 @@ ifconfig_tun0=</programlisting> <programlisting>ppp -auto mysystem</programlisting> <para>This script is executed at network configuration time, - starting the ppp daemon in automatic mode. If - this machine acts as a gateway, consider including - <option>-alias</option>. Refer - to the manual page for further details.</para> + starting the ppp daemon in automatic mode. If this + machine acts as a gateway, consider including + <option>-alias</option>. Refer to the manual page for + further details.</para> </note> <para>Make sure that the router program is set to @@ -1126,10 +1126,10 @@ ifconfig_tun0=</programlisting> <indexterm> <primary><application>sendmail</application></primary> </indexterm> - <para>The downside is that - <command>sendmail</command> is forced to re-examine the mail queue - whenever the ppp link. To automate this, include <command>!bg</command> - in <filename>ppp.linkup</filename>:</para> + <para>The downside is that <command>sendmail</command> is + forced to re-examine the mail queue whenever the ppp link. + To automate this, include <command>!bg</command> in + <filename>ppp.linkup</filename>:</para> <programlisting>1 provider: 2 delete ALL @@ -1153,7 +1153,8 @@ ifconfig_tun0=</programlisting> <acronym>PPP</acronym> session, or, to configure <command>ppp</command> to establish sessions automatically when there is outbound traffic and - <filename>start_if.tun0</filename> does not exist, type:</para> + <filename>start_if.tun0</filename> does not exist, + type:</para> <screen>&prompt.root; <userinput>ppp -auto provider</userinput></screen> </sect2> @@ -1187,7 +1188,8 @@ ifconfig_tun0=</programlisting> </step> <step> - <para>When using a dynamic <acronym>IP</acronym> address, create an entry in + <para>When using a dynamic <acronym>IP</acronym> address, + create an entry in <filename>/etc/ppp/ppp.linkup</filename>.</para> </step> @@ -1295,14 +1297,12 @@ ifconfig_tun0=</programlisting> <para>This should display some pertinent output about the <devicename>uart</devicename> devices. These are the COM - ports we need. If the modem acts like a standard serial - port, it should be listed on - <devicename>uart1</devicename>, or - <devicename>COM2</devicename>. If so, - a kernel rebuild is not required. When matching up, if the modem is on - <devicename>uart1</devicename>, the - modem device would be <filename - class="devicefile">/dev/cuau1</filename>.</para> + ports we need. If the modem acts like a standard serial port, + it should be listed on <devicename>uart1</devicename>, or + <devicename>COM2</devicename>. If so, a kernel rebuild is not + required. When matching up, if the modem is on + <devicename>uart1</devicename>, the modem device would be + <filename class="devicefile">/dev/cuau1</filename>.</para> </sect2> <sect2> @@ -1350,8 +1350,8 @@ type '~h' for help</programlisting> OK <userinput>atdt<replaceable>123456789</replaceable></userinput></screen> - <para>Use <command>at</command> to initialize the modem, - then use <command>atdt</command> and the number for the + <para>Use <command>at</command> to initialize the modem, then + use <command>atdt</command> and the number for the <acronym>ISP</acronym> to begin the dial in process.</para> <screen>CONNECT</screen> @@ -1362,25 +1362,23 @@ OK <screen>ISP Login:<userinput>myusername</userinput></screen> - <para>At this prompt, return the - prompt with the username that was provided by the - <acronym>ISP</acronym>.</para> + <para>At this prompt, return the prompt with the username that + was provided by the <acronym>ISP</acronym>.</para> <screen>ISP Pass:<userinput>mypassword</userinput></screen> - <para>At this prompt, - reply with the password that was provided by the - <acronym>ISP</acronym>. Just like logging into - &os;, the password will not echo.</para> + <para>At this prompt, reply with the password that was provided + by the <acronym>ISP</acronym>. Just like logging into &os;, + the password will not echo.</para> <screen>Shell or PPP:<userinput>ppp</userinput></screen> <para>Depending on the <acronym>ISP</acronym>, this prompt - might not appear. If it does, it is asking whether to - use a shell on the provider or to start + might not appear. If it does, it is asking whether to use a + shell on the provider or to start <command>ppp</command>. In this example, - <command>ppp</command> was selected in order to establish an Internet - connection.</para> + <command>ppp</command> was selected in order to establish an + Internet connection.</para> <screen>Ppp ON example></screen> @@ -1391,8 +1389,8 @@ OK <screen>PPp ON example></screen> <para>We have successfully authenticated with our - <acronym>ISP</acronym> and are waiting for the - assigned <acronym>IP</acronym> address.</para> + <acronym>ISP</acronym> and are waiting for the assigned + <acronym>IP</acronym> address.</para> <screen>PPP ON example></screen> @@ -1425,40 +1423,36 @@ OK <sect2> <title>Debugging - If a - connection cannot be established, turn hardware flow - CTS/RTS to off using . This is mainly the case when + If a connection cannot be established, turn hardware + flow CTS/RTS to off using . This is mainly the case when connected to some PPP-capable terminal servers, where PPP hangs when it tries to write data to the communication link, and - waits for a Clear - To Send (CTS) signal which may never come. When using this option, - include - as it may be required to defeat hardware dependent - on passing certain characters from end to end, most of the - time XON/XOFF. Refer to &man.ppp.8; for more - information on this option and how it is used. - - An older modem may need - . Parity is set at none - be default, but is used for error checkingm with a large - increase in traffic, on older modems. + waits for a Clear To Send (CTS) signal + which may never come. When using this option, include + as it may be required to defeat + hardware dependent on passing certain characters from end to + end, most of the time XON/XOFF. Refer to &man.ppp.8; for + more information on this option and how it is used. + + An older modem may need . Parity is set at none be default, but is + used for error checkingm with a large increase in traffic, + on older modems. PPP may not return to the - command mode, which is usually a negotiation error where - the ISP is waiting for - negotiating to begin. At this point, using ~p - will force ppp to start sending the configuration - information. - - If a login prompt never appears, - PAP or - CHAP authentication is most likely required. - To use - PAP or CHAP, add - the following options to PPP - before going into terminal mode: + command mode, which is usually a negotiation error where the + ISP is waiting for negotiating to begin. + At this point, using ~p will force ppp + to start sending the configuration information. + + If a login prompt never appears, PAP + or CHAP authentication is most likely + required. To use PAP or + CHAP, add the following options to + PPP before going into terminal + mode: ppp ON example> set authname myusername @@ -1472,16 +1466,15 @@ OK replaced with the password that was assigned by the ISP. - If a connection is established, but cannot seem to find any domain - name, try to &man.ping.8; an IP - address. If - there is 100 percent (100%) packet loss, it is - likely that a default route was not assigned. - Double check that - To configure &man.syslog.3; to provide logging - for the PPP connection, make sure - this line exists in /etc/syslog.conf: + To configure &man.syslog.3; to provide logging for the + PPP connection, make sure this + line exists in /etc/syslog.conf: !ppp *.* /var/log/ppp.log @@ -1524,14 +1517,13 @@ nameserver y.y.y.yover Ethernet - This section describes how to set up - PPP over Ethernet - (PPPoE). + This section describes how to set up PPP + over Ethernet (PPPoE). - Here is an example of a working - ppp.conf: + Here is an example of a working + ppp.conf: - default: + default: set log Phase tun command # you can add more detailed logging if you wish set ifaddr 10.0.0.1/0 10.0.0.2/0 @@ -1565,17 +1557,17 @@ ppp_profile="name_of_service_provider" - Any required service tag - information should be in the documentation provided by the ISP. + Any required service tag information should be in the + documentation provided by the ISP. As a last resort, one could try installing the net/rr-pppoe package or port. Bear in mind however, this may de-program your modem and render it useless, so think twice before doing it. Simply - install the program shipped with the modem. - Then, access the System menu from the - program. The name of the profile should be listed there. It - is usually ISP. + install the program shipped with the modem. Then, access the + System menu from the program. The name of + the profile should be listed there. It is usually + ISP. The profile name (service tag) will be used in the PPPoE configuration entry in ppp.conf as the @@ -1585,11 +1577,11 @@ ppp_profile="name_of_service_provider"set device PPPoE:xl1:ISP - Do not forget to change xl1 - to the proper device for the Ethernet card. + Do not forget to change xl1 to + the proper device for the Ethernet card. - Do not forget to change ISP - to the profile. + Do not forget to change ISP to + the profile. For additional information, refer to Cheaper @@ -1603,12 +1595,14 @@ ppp_profile="name_of_service_provider"HomeConnect ADSL Modem Dual Link - This modem does not follow the PPPoE specification defined in RFC 2516. - - In order to make &os; capable of communicating with - this device, a sysctl must be set. This can be done - automatically at boot time by updating + This modem does not follow the PPPoE specification defined + in RFC + 2516. + + In order to make &os; capable of communicating with this + device, a sysctl must be set. This can be done automatically + at boot time by updating /etc/sysctl.conf: net.graph.nonstandard_pppoe=1 @@ -1617,8 +1611,8 @@ ppp_profile="name_of_service_provider"&prompt.root; sysctl net.graph.nonstandard_pppoe=1 - Unfortunately, because this is a system-wide setting, - it is not possible to talk to a normal PPPoE client or server + Unfortunately, because this is a system-wide setting, it + is not possible to talk to a normal PPPoE client or server and a &tm.3com; HomeConnect ADSL Modem at the same time. @@ -1696,20 +1690,18 @@ ppp_profile="adsl" Using mpd - The mpd application can be used to connect to a - variety of services, in particular PPTP services. It can be installed using the - net/mpd5 package or port. Many ADSL - modems require that a PPTP tunnel is created between the modem - and computer. - - Once installed, - configure mpd to suit the - provider's settings. The port places a set - of sample configuration files which are well documented in - /usr/local/etc/mpd/. - A - complete guide to configure mpd + The mpd application can be used + to connect to a variety of services, in particular PPTP + services. It can be installed using the net/mpd5 package or port. Many + ADSL modems require that a PPTP tunnel is created between the + modem and computer. + + Once installed, configure mpd + to suit the provider's settings. The port places a set of + sample configuration files which are well documented in + /usr/local/etc/mpd/. + A complete guide to configure mpd is available in HTML format in /usr/ports/share/doc/mpd/. Here is a sample configuration for connecting to an ADSL @@ -1750,10 +1742,12 @@ adsl: - The username used to authenticate with your ISP. + The username used to authenticate with your + ISP. - The password used to authenticate with your ISP. + The password used to authenticate with your + ISP. @@ -1773,12 +1767,12 @@ adsl: - The IP address of &os; computer running - mpd. + The IP address of &os; computer + running mpd. - The IP address of the ADSL modem. The Alcatel - &speedtouch; Home defaults to The IP address of the ADSL modem. + The Alcatel &speedtouch; Home defaults to 10.0.0.138. @@ -1808,10 +1802,10 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN To use net/pptpclient to connect to a DSL service, install the port or package, then - edit /etc/ppp/ppp.conf. - An example section of ppp.conf - is given below. For further information on - ppp.conf options consult &man.ppp.8;. + edit /etc/ppp/ppp.conf. An example section + of ppp.conf is given below. For further + information on ppp.conf options consult + &man.ppp.8;. adsl: set log phase chat lcp ipcp ccp tun command @@ -1824,8 +1818,7 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN - The username for the DSL - provider. + The username for the DSL provider. @@ -1835,9 +1828,8 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN Since the account's password is added to - ppp.confin plain text form, - make sure nobody can read the contents of this - file: + ppp.confin plain text form, make sure + nobody can read the contents of this file: &prompt.root; chown root:wheel /etc/ppp/ppp.conf &prompt.root; chmod 600 /etc/ppp/ppp.conf @@ -1846,11 +1838,11 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN This will open a tunnel for a PPP session to the DSL router. Ethernet DSL modems have a - preconfigured LAN IP address to connect to. In the - case of the Alcatel &speedtouch; Home, this address is 10.0.0.138. The router's - documentation should list the address the device - uses. To open the tunnel and start a PPP + preconfigured LAN IP address to connect to. + In the case of the Alcatel &speedtouch; Home, this address is + 10.0.0.138. The router's + documentation should list the address the device uses. To + open the tunnel and start a PPP session: *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***