From owner-svn-doc-all@FreeBSD.ORG Thu Oct 17 21:56:10 2013 Return-Path: Delivered-To: svn-doc-all@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 816AD750; Thu, 17 Oct 2013 21:56:10 +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 6D80925C1; Thu, 17 Oct 2013 21:56:10 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9HLuAWN069616; Thu, 17 Oct 2013 21:56:10 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9HLuAEU069615; Thu, 17 Oct 2013 21:56:10 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201310172156.r9HLuAEU069615@svn.freebsd.org> From: Dru Lavigne Date: Thu, 17 Oct 2013 21:56:10 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42992 - 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 21:56:10 -0000 Author: dru Date: Thu Oct 17 21:56:10 2013 New Revision: 42992 URL: http://svnweb.freebsd.org/changeset/doc/42992 Log: This patch does the following: - replaces FreeBSD with entity - adds acronym tags for instances of PPP that refer to the protocol, the instances that refer to the app still need to be fixed - comments out "26.5.1. Using PPPoA with the Alcatel SpeedTouch USB" as the port it relies on has been broken for 4 years - fixes internal links This will be followed by a white space fix. 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:22:38 2013 (r42991) +++ head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Thu Oct 17 21:56:10 2013 (r42992) @@ -18,47 +18,40 @@ --> - PPP + <acronym>PPP</acronym> Synopsis - PPP + PPP - FreeBSD has a number of ways to link one computer to + &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 + requires the use of PPP. This chapter describes setting up these modem-based communication services in detail. After reading this chapter, you will know: - How to set up user PPP. + How to set configure PPP. - How to set up PPPoE (PPP over - Ethernet). + How to set up PPP over Ethernet (PPPoE). - How to set up PPPoA (PPP over - ATM). + How to set up PPP over ATM (PPPoA). - PPP - user PPP + PPP - PPP - kernel PPP - - - PPP + PPP over Ethernet @@ -70,7 +63,7 @@ Understand the basics and purpose of a dialup connection - and PPP. + and PPP. @@ -110,14 +103,14 @@ --> - Configuring PPP + Configuring <acronym>PPP</acronym> This document assumes you have the following: - An account with an Internet Service Provider (ISP)ISP - which you connect to using PPPPPP. + An account with an Internet Service Provider (ISP) + which you connect to using PPP. @@ -131,20 +124,18 @@ - Your login namelogin name and passwordpassword. (Either a - regular &unix;UNIX style login and password pair, or a PAPPAP - or CHAPCHAP login and password pair). + The login name and password assigned by the ISP. - The IP address of one or more name serversnameserver. + 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 ISPs - PPP implementation supporting DNS negotiation. + servers for you. This feature depends on your ISP's + PPP implementation supporting DNS negotiation. @@ -313,7 +304,7 @@ Line 6 & 7: - The dial string. User PPPPPPuser PPP uses an expect-send + The dial string. PPP uses an expect-send syntax similar to the &man.chat.8; program. Refer to the manual page for information on the features of this language. @@ -410,9 +401,9 @@ 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 PAP and CHAP - authentication for further details. + 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 @@ -461,9 +452,8 @@ protocol: ppp use a guessed address, make sure that you create an entry in /etc/ppp/ppp.linkup as per the - instructions for PPP and Dynamic IP - addresses. If this line is omitted, + instructions in . If this line is omitted, ppp cannot run in mode. @@ -502,10 +492,10 @@ protocol: ppp - PPP With Dynamic IP Addresses + <acronym>PPP</acronym> With Dynamic IP Addresses - PPP + PPP with dynamic IP addresses @@ -519,9 +509,8 @@ 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 - PPP and Static IP - Addresses, 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 @@ -607,7 +596,7 @@ protocol: ppp Receiving Incoming Calls - PPP + PPP receiving incoming calls @@ -627,8 +616,8 @@ protocol: ppp Which getty? - Configuring FreeBSD for - Dial-up Services provides a good description + + provides a good description on enabling dial-up services using &man.getty.8;. An alternative to getty is Later versions of mgetty (from 0.99beta onwards) also support the automatic detection of - PPP streams, allowing your clients script-less access to + PPP streams, allowing your clients script-less access to your server. - Refer to Mgetty and - AutoPPP for more information on + Refer to + for more information on mgetty. @@ -677,10 +666,10 @@ protocol: ppp - PPP Shells for Dynamic IP Users + <acronym>PPP</acronym> Shells for Dynamic IP Users - PPP shells + PPP shells Create a file called @@ -710,7 +699,7 @@ exec /usr/sbin/ppp -direct $IDENTYou should use this script as the shell for all of your dialup users. This is an example from /etc/passwd - for a dialup PPP user with username + for a dialup PPP user with username pchilds (remember do not directly edit the password file, use &man.vipw.8;). @@ -729,10 +718,10 @@ exec /usr/sbin/ppp -direct $IDENT - PPP Shells for Static IP Users + <acronym>PPP</acronym> Shells for Static IP Users - PPP shells + PPP shells Create the ppp-shell file as @@ -841,7 +830,7 @@ 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 + 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. @@ -859,7 +848,7 @@ mary: This will tell mgetty to run the ppp-pap-dialup script for detected - PPP connections. + PPP connections. Create a file called /etc/ppp/ppp-pap-dialup containing @@ -907,14 +896,14 @@ exec /usr/sbin/ppp -direct pap$IDENT - PPP + PPP Microsoft extensions 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 + To enable these extensions with PPP version 1.x, the following lines might be added to the relevant section of /etc/ppp/ppp.conf. @@ -922,7 +911,7 @@ exec /usr/sbin/ppp -direct pap$IDENT - 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 @@ -933,7 +922,7 @@ set nbns 203.14.100.5 host. In version 2 and above, if the - set dns line is omitted, PPP will + set dns line is omitted, PPP will use the values found in /etc/resolv.conf. @@ -948,7 +937,7 @@ set nbns 203.14.100.5 either of the PAP or CHAP authentication mechanisms. If this is the case, your ISP will not give a login: prompt when you connect, but will - start talking PPP immediately. + start talking PPP immediately. PAP is less secure than CHAP, but security is not normally an issue here as passwords, although being sent @@ -956,11 +945,11 @@ set nbns 203.14.100.5 serial line only. There is not much room for crackers to eavesdrop. - Referring back to the PPP and Static IP - addresses or PPP and Dynamic IP - addresses sections, the following alterations must + Referring back to + or , + the following alterations must be made: 13 set authname MyUserName @@ -1035,11 +1024,11 @@ set nbns 203.14.100.5 - Using PPP Network Address Translation + <title>Using <acronym>PPP</acronym> Network Address Translation Capability - PPPNAT + PPPNAT PPP has ability to use internal NAT without kernel @@ -1049,7 +1038,7 @@ set nbns 203.14.100.5 nat enable yes - Alternatively, PPP NAT may be enabled by command-line + Alternatively, NAT may be enabled by command-line option -nat. There is also /etc/rc.conf knob named ppp_nat, which is enabled by @@ -1071,7 +1060,7 @@ nat port tcp 10.0.0.2:http httpFinal System Configuration - PPPconfiguration + PPPconfiguration You now have ppp configured, but @@ -1167,7 +1156,7 @@ ifconfig_tun0= &prompt.root; ppp and then dial provider to start the - PPP session, or, if you want ppp to + 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: @@ -1281,12 +1270,12 @@ ifconfig_tun0= Troubleshooting <acronym>PPP</acronym> Connections - PPP + PPP troubleshooting This section covers a few issues which may arise when - using PPP over a modem connection. For instance, perhaps you + 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 @@ -1549,14 +1538,14 @@ nameserver y.y.y.y --> - Using PPP over Ethernet (PPPoE) + Using <acronym>PPP</acronym> over Ethernet (PPPoE) - PPP + PPP over 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 @@ -1601,10 +1590,8 @@ ppp_profile="name_of_service_provider" - As a last resort, you could try the method suggested by - the Roaring - Penguin PPPoE program which can be found in the Ports Collection. Bear in mind + 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 @@ -1627,7 +1614,7 @@ ppp_profile="name_of_service_provider"For additional information, refer to Cheaper - Broadband with FreeBSD on DSL by Renaud + Broadband with &os; on DSL by Renaud Waldura. @@ -1639,7 +1626,7 @@ ppp_profile="name_of_service_provider"This modem does not follow RFC 2516 - (A Method for transmitting PPP over Ethernet + (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. @@ -1647,7 +1634,7 @@ ppp_profile="name_of_service_provider"3Com if you think it should comply with the PPPoE specification. - In order to make FreeBSD capable of communicating with + 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: @@ -1671,30 +1658,29 @@ ppp_profile="name_of_service_provider" - PPP + PPP over ATM PPPoA - PPP, over ATM The following describes how to set up PPP over ATM (PPPoA). PPPoA is a popular choice among European DSL providers. - + Using mpd @@ -1740,7 +1727,7 @@ 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/mpd. Many ADSL modems + 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. @@ -1849,7 +1836,7 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN Using pptpclient - It is also possible to use FreeBSD to connect to other + It is also possible to use &os; to connect to other PPPoA services using net/pptpclient. @@ -1896,13 +1883,13 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN - This will open a tunnel for a PPP session to your DSL + 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 + uses. To open the tunnel and start a PPP session execute the following command: &prompt.root; pptp address adsl