From owner-svn-doc-all@FreeBSD.ORG Thu Oct 17 22:33:33 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id F1ECB8AD; Thu, 17 Oct 2013 22:33:32 +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 DDCC327F4; Thu, 17 Oct 2013 22:33:32 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9HMXW0Q090648; Thu, 17 Oct 2013 22:33:32 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9HMXWQT090647; Thu, 17 Oct 2013 22:33:32 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201310172233.r9HMXWQT090647@svn.freebsd.org> From: Dru Lavigne Date: Thu, 17 Oct 2013 22:33:32 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42993 - 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-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 Oct 2013 22:33:33 -0000 Author: dru Date: Thu Oct 17 22:33:32 2013 New Revision: 42993 URL: http://svnweb.freebsd.org/changeset/doc/42993 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 21:56:10 2013 (r42992) +++ head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Thu Oct 17 22:33:32 2013 (r42993) @@ -27,11 +27,11 @@ PPP - &os; has a number of ways to link one computer to - another. To establish a network or Internet connection through - a dial-up modem, or to allow others to do so through you, - requires the use of PPP. This chapter describes setting - up these modem-based communication services in detail. + &os; has a number of ways to link one computer to another. + To establish a network or Internet connection through a dial-up + modem, or to allow others to do so through you, requires the use + of PPP. This chapter describes setting u + p these modem-based communication services in detail. After reading this chapter, you will know: @@ -40,10 +40,12 @@ How to set configure PPP. - How to set up PPP over Ethernet (PPPoE). + How to set up PPP over Ethernet + (PPPoE). - How to set up PPP over ATM (PPPoA). + How to set up PPP over ATM + (PPPoA). @@ -105,120 +107,119 @@ Configuring <acronym>PPP</acronym> - This document assumes you have the following: + This document assumes you have the following: - - - An account with an Internet Service Provider (ISP) - which you connect to using PPP. - - - - A modem or - other device connected to your system and properly - configured to allow you to connect to your ISP. - - - - The dial-up number(s) of your ISP. - - - - The login name and password assigned by the ISP. - - - - The IP address of one or more name servers. - Normally, you will be given two IP addresses by your - ISP to use for this. If they have not given you at - least one, then you can use the enable - dns command in ppp.conf - and ppp will set the name - servers for you. This feature depends on your ISP's - PPP implementation supporting DNS negotiation. - - - - The following information may be supplied by your ISP, - but is not completely necessary: - - - - The IP address of your ISP's gateway. The gateway - is the machine to which you will connect and will be - set up as your default route. If - you do not have this information, we can make one up - and your ISP's PPP server will tell us the correct value - when we connect. - - This IP number is referred to as - HISADDR by - ppp. - - - - The netmask you should use. If your ISP has not - provided you with one, you can safely use 255.255.255.255. - - - - - static IP address - + + + An account with an Internet Service Provider + (ISP) which you connect to using + PPP. + - If your ISP provides you with a static IP address - and hostname, you can enter it. Otherwise, we simply - let the peer assign whatever IP address it sees - fit. - - + + A modem or other device connected to your system and + properly configured to allow you to connect to your + ISP. + - If you do not have any of the required information, - contact your ISP. + + The dial-up number(s) of your ISP. + - - Throughout this section, many of the examples showing - the contents of configuration files are numbered by line. - These numbers serve to aid in the presentation and - discussion only and are not meant to be placed in the - actual file. Proper indentation with tab and space - characters is also important. - + + The login name and password assigned by the ISP. + - ppp uses the configuration files - located in /etc/ppp. - Examples can be found in /usr/share/examples/ppp/. - - Configuring ppp requires that you - edit a number of files, depending on your requirements. - What you put in them depends to some extent on whether your - ISP allocates IP addresses statically (i.e., you get given - one IP address, and always use that one) or dynamically - (i.e., your IP address changes each time you connect to - your ISP). + + The IP address of one or more name servers. + Normally, you will be given two IP addresses by your + ISP to use for this. If they have not given you at + least one, then you can use the enable + dns command in ppp.conf + and ppp will set the name + servers for you. This feature depends on your ISP's + PPP implementation supporting DNS + negotiation. + + - - PPP With Static IP Addresses + The following information may be supplied by your ISP, but + is not completely necessary: - - PPP - with static IP addresses - + + + The IP address of your ISP's gateway. The gateway is + the machine to which you will connect and will be set up as + your default route. If you do not have + this information, we can make one up and your ISP's PPP + server will tell us the correct value when we + connect. + + This IP number is referred to as + HISADDR by + ppp. + - You will need to edit the - /etc/ppp/ppp.conf configuration file. - It should look similar to the example below. - - - Lines that end in a : start in - the first column (beginning of the line)— all - other lines should be indented as shown using spaces - or tabs. - + + The netmask you should use. If your ISP has not + provided you with one, you can safely use 255.255.255.255. + - 1 default: + + + static IP address + + + If your ISP provides you with a static IP address and + hostname, you can enter it. Otherwise, we simply let the + peer assign whatever IP address it sees fit. + + + + If you do not have any of the required information, contact + your ISP. + + + Throughout this section, many of the examples showing the + contents of configuration files are numbered by line. These + numbers serve to aid in the presentation and discussion only + and are not meant to be placed in the actual file. Proper + indentation with tab and space characters is also + important. + + + ppp uses the configuration files located + in /etc/ppp. Examples + can be found in /usr/share/examples/ppp/. + + Configuring ppp requires that you edit a + number of files, depending on your requirements. What you put + in them depends to some extent on whether your ISP allocates IP + addresses statically (i.e., you get given one IP address, and + always use that one) or dynamically (i.e., your IP address + changes each time you connect to your ISP). + + + PPP With Static IP Addresses + + + PPP + with static IP addresses + + + You will need to edit the + /etc/ppp/ppp.conf configuration file. + It should look similar to the example below. + + + Lines that end in a : start in the + first column (beginning of the line)— all other lines + should be indented as shown using spaces or tabs. + + + 1 default: 2 set log Phase Chat LCP IPCP CCP tun command 3 ident user-ppp VERSION (built COMPILATIONDATE) 4 set device /dev/cuau0 @@ -399,11 +400,13 @@ Line 15: - If you are using PAPPAP or CHAPCHAP, there will be no - login at this point, and this line should be - commented out or removed. See - for further details. + If you are using + PAPPAP or + CHAPCHAP, + there will be no login at this point, and this line + should be commented out or removed. See for further + details. The login string is of the same chat-like syntax as the dial string. In this example, the @@ -427,12 +430,13 @@ protocol: ppp Line 16: - Sets the default idle timeouttimeout (in seconds) for - the connection. Here, the connection will be closed - automatically after 300 seconds of inactivity. If - you never want to timeout, set this value to zero - or use the command line - switch. + Sets the default idle + timeouttimeout + (in seconds) for the connection. Here, the + connection will be closed automatically after 300 + seconds of inactivity. If you never want to + timeout, set this value to zero or use the + command line switch. @@ -441,20 +445,21 @@ protocol: ppp Sets the interface addresses. The string x.x.x.x should be - replaced by the IP address that your providerISP has - allocated to you. The string + replaced by the IP address that your + providerISP + has allocated to you. The string y.y.y.y should be replaced by the IP address that your ISP indicated for their gateway (the machine to which you connect). If your ISP has not given you a gateway address, use 10.0.0.2/0. If you need to - use a guessed address, make sure that - you create an entry in + role="netmask">10.0.0.2/0. If you need + to use a guessed address, make sure + that you create an entry in /etc/ppp/ppp.linkup as per the instructions in . If this line is omitted, - ppp cannot run in + linkend="userppp-dynamicIP"/>. If this line is + omitted, ppp cannot run in mode. @@ -492,7 +497,8 @@ protocol: ppp - <acronym>PPP</acronym> With Dynamic IP Addresses + <acronym>PPP</acronym> With Dynamic IP + Addresses PPP @@ -509,8 +515,10 @@ protocol: ppp 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: + ppp.conf configuration is the same as + 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 @@ -634,12 +642,11 @@ protocol: ppp Later versions of mgetty (from 0.99beta onwards) also support the automatic detection of - PPP streams, allowing your clients script-less access to - your server. + PPP streams, allowing your clients + script-less access to your server. - Refer to - for more information on - mgetty. + Refer to for more + information on mgetty. @@ -666,7 +673,8 @@ protocol: ppp - <acronym>PPP</acronym> Shells for Dynamic IP Users + <acronym>PPP</acronym> Shells for Dynamic IP + Users PPP shells @@ -718,7 +726,8 @@ exec /usr/sbin/ppp -direct $IDENT - <acronym>PPP</acronym> Shells for Static IP Users + <acronym>PPP</acronym> Shells for Static IP + Users PPP shells @@ -830,10 +839,11 @@ mary: role="package">comms/mgetty+sendfax port comes with the AUTO_PPP option enabled allowing mgetty to detect the LCP - phase of PPP connections and automatically spawn off a - ppp shell. However, since the default login/password - sequence does not occur it is necessary to authenticate - users using either PAP or CHAP. + phase of PPP connections and + automatically spawn off a ppp shell. However, since the + default login/password sequence does not occur it is + necessary to authenticate users using either PAP or + CHAP. This section assumes the user has successfully compiled, and installed the It is possible to configure PPP to supply DNS and NetBIOS nameserver addresses on demand. - To enable these extensions with PPP version 1.x, the - following lines might be added to the relevant section - of /etc/ppp/ppp.conf. + To enable these extensions with + PPP version 1.x, the following lines + might be added to the relevant section of + /etc/ppp/ppp.conf. enable msext set ns 203.14.100.1 203.14.100.2 set nbns 203.14.100.5 - And for PPP version 2 and above: + And for PPP version 2 and + above: accept dns set dns 203.14.100.1 203.14.100.2 @@ -922,8 +934,8 @@ set nbns 203.14.100.5 host. In version 2 and above, if the - set dns line is omitted, PPP will - use the values found in + set dns line is omitted, + PPP will use the values found in /etc/resolv.conf. @@ -970,7 +982,8 @@ set nbns 203.14.100.5 Line 14: - This line specifies your PAP/CHAP passwordpassword. + This line specifies your PAP/CHAP + passwordpassword. You will need to insert the correct value for MyPassword. You may want to add an additional line, such as: @@ -1024,8 +1037,8 @@ set nbns 203.14.100.5 - Using <acronym>PPP</acronym> Network Address Translation - Capability + Using <acronym>PPP</acronym> Network Address + Translation Capability PPPNAT @@ -1156,9 +1169,9 @@ ifconfig_tun0= &prompt.root; ppp and then dial provider to start the - PPP session, or, if you want ppp to - establish sessions automatically when there is outbound - traffic (and you have not created the + PPP session, or, if you want + ppp to establish sessions automatically + when there is outbound traffic (and you have not created the start_if.tun0 script), type: &prompt.root; ppp -auto provider @@ -1275,9 +1288,10 @@ ifconfig_tun0= This section covers a few issues which may arise when - using PPP over a modem connection. For instance, perhaps you - need to know exactly what prompts the system you are dialing - into will present. Some ISPs present the + using PPP over a modem connection. For + instance, perhaps you need to know exactly what prompts the + system you are dialing into will present. Some + ISPs present the ssword prompt, and others will present password; if the ppp script is not written accordingly, the login attempt will @@ -1519,8 +1533,8 @@ nameserver y.y.y.y!ppp *.* /var/log/ppp.log - to /etc/syslog.conf. In most - cases, this functionality already exists. + to /etc/syslog.conf. In most + cases, this functionality already exists. @@ -1545,7 +1559,8 @@ nameserver y.y.y.yover Ethernet - This section describes how to set up PPP over Ethernet + This section describes how to set up + PPP over Ethernet (PPPoE). Here is an example of a working @@ -1590,14 +1605,14 @@ ppp_profile="name_of_service_provider" - As a last resort, you 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 by your provider. Then, access the - System menu from the program. The name - of your profile should be listed there. It is usually - ISP. + As a last resort, you 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 by your provider. + Then, access the System menu from the + program. The name of your 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 @@ -1609,13 +1624,14 @@ ppp_profile="name_of_service_provider"Do not forget to change xl1 to the proper device for your Ethernet card. + Do not forget to change ISP to the profile you have just found above. For additional information, refer to Cheaper - Broadband with &os; on DSL by Renaud - Waldura. + url="http://renaud.waldura.com/doc/freebsd/pppoe/">Cheaper + Broadband with &os; on DSL by Renaud + Waldura. @@ -1626,11 +1642,11 @@ ppp_profile="name_of_service_provider"This modem does not follow RFC 2516 - (A Method for transmitting PPP over Ethernet - (PPPoE), written by L. Mamakos, K. Lidl, J. Evarts, - D. Carrel, D. Simone, and R. Wheeler). Instead, different - packet type codes have been used for the Ethernet frames. - Please complain to A Method for transmitting PPP + over Ethernet (PPPoE), written by L. Mamakos, K. + Lidl, J. Evarts, D. Carrel, D. Simone, and R. Wheeler). + Instead, different packet type codes have been used for the + Ethernet frames. Please complain to 3Com if you think it should comply with the PPPoE specification. @@ -1727,9 +1743,9 @@ ppp_profile="adsl" You can use mpd to connect to a variety of services, in particular PPTP services. You can find mpd in the Ports Collection, - net/mpd5. Many ADSL modems - require that a PPTP tunnel is created between the modem and - computer, one such modem is the Alcatel &speedtouch; + net/mpd5. Many ADSL + modems require that a PPTP tunnel is created between the modem + and computer, one such modem is the Alcatel &speedtouch; Home. First you must install the port, and then you can @@ -1883,14 +1899,14 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN - This will open a tunnel for a PPP session to your DSL - router. Ethernet DSL modems have a preconfigured LAN IP - address which you connect to. In the case of the Alcatel - &speedtouch; Home this address is This will open a tunnel for a PPP + session to your DSL router. Ethernet DSL modems have a + preconfigured LAN IP address which you connect to. In the + case of the Alcatel &speedtouch; Home this address is 10.0.0.138. Your router documentation should tell you which address your device - uses. To open the tunnel and start a PPP session execute - the following command: + uses. To open the tunnel and start a PPP + session execute the following command: &prompt.root; pptp address adsl