From owner-svn-doc-all@FreeBSD.ORG Thu Oct 17 21:22:39 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 18A78511; Thu, 17 Oct 2013 21:22:39 +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 04E7523C8; Thu, 17 Oct 2013 21:22:39 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9HLMcvu053049; Thu, 17 Oct 2013 21:22:38 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9HLMcrw053048; Thu, 17 Oct 2013 21:22:38 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201310172122.r9HLMcrw053048@svn.freebsd.org> From: Dru Lavigne Date: Thu, 17 Oct 2013 21:22:38 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42991 - 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:22:39 -0000 Author: dru Date: Thu Oct 17 21:22:38 2013 New Revision: 42991 URL: http://svnweb.freebsd.org/changeset/doc/42991 Log: Initial header tightening in prep for reviewing this chapter. Many more patches to come. 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 19:42:08 2013 (r42990) +++ head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Thu Oct 17 21:22:38 2013 (r42991) @@ -6,16 +6,17 @@ --> + + Restructured, reorganized, and updated by in Mar 2000 + --> PPP @@ -48,15 +49,15 @@ - + PPP user PPP - + PPP kernel PPP - + PPP over Ethernet @@ -75,6 +76,7 @@ + - Using User PPP - - - User PPP - - - Assumptions + Configuring PPP This document assumes you have the following: @@ -198,17 +195,6 @@ characters is also important. - - - - Automatic <application>PPP</application> - Configuration - - - PPP - configuration - - ppp uses the configuration files located in /etc/ppp. Examples can be found in - - PPP and Static IP Addresses + + PPP With Static IP Addresses PPP @@ -513,10 +499,10 @@ protocol: ppp /usr/share/examples/ppp/ directory. - + - - PPP and Dynamic IP Addresses + + PPP With Dynamic IP Addresses PPP @@ -615,9 +601,9 @@ protocol: ppp and /usr/share/examples/ppp/ppp.linkup.sample for a detailed example. - + - + Receiving Incoming Calls @@ -636,9 +622,9 @@ protocol: ppp file contains the following: gateway_enable="YES" - + - + Which getty? Configuring FreeBSD for @@ -665,9 +651,9 @@ protocol: ppp Refer to Mgetty and AutoPPP for more information on mgetty. - + - + <application>PPP</application> Permissions The ppp command must normally be @@ -688,10 +674,10 @@ protocol: ppp If this command is used in the default section, it gives the specified users access to everything. - + - - PPP Shells for Dynamic-IP Users + + PPP Shells for Dynamic IP Users PPP shells @@ -740,10 +726,10 @@ exec /usr/sbin/ppp -direct $IDENTwhich prevents /etc/motd from being displayed. - + - - PPP Shells for Static-IP Users + + PPP Shells for Static IP Users PPP shells @@ -767,11 +753,11 @@ exec /usr/sbin/ppp -direct $IDENTmary's shell should be /etc/ppp/ppp-mary). - + - + Setting Up <filename>ppp.conf</filename> for - Dynamic-IP Users + Dynamic IP Users The /etc/ppp/ppp.conf file should contain something along the lines of: @@ -798,11 +784,11 @@ ttyu1: to the one for ttyu0: above. Each line should get a unique IP address from your pool of IP addresses for dynamic users. - + - + Setting Up <filename>ppp.conf</filename> for - Static-IP Users + Static IP Users Along with the contents of the sample /usr/share/examples/ppp/ppp.conf @@ -834,9 +820,9 @@ sam: mary: add 203.14.103.0 netmask 255.255.255.0 HISADDR - + - + <command>mgetty</command> and AutoPPP @@ -907,9 +893,9 @@ exec /usr/sbin/ppp -direct pap$IDENT/etc/ppp/ppp.secret. See /usr/share/examples/ppp/ppp.secret.sample for examples. - + - + MS Extensions @@ -950,9 +936,9 @@ set nbns 203.14.100.5 set dns line is omitted, PPP will use the values found in /etc/resolv.conf. - + - + PAP and CHAP Authentication PAP @@ -1023,9 +1009,9 @@ set nbns 203.14.100.5 - + - + Changing Your <command>ppp</command> Configuration on the Fly @@ -1046,10 +1032,9 @@ set nbns 203.14.100.5 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 PPP Network Address Translation Capability @@ -1080,9 +1065,9 @@ nat port tcp 10.0.0.2:http httpor do not trust the outside at all nat deny_incoming yes - + - + Final System Configuration @@ -1188,9 +1173,9 @@ ifconfig_tun0= start_if.tun0 script), type: &prompt.root; ppp -auto provider - + - + Summary To recap, the following steps are necessary when setting @@ -1278,21 +1263,21 @@ ifconfig_tun0= file. - + + --> Troubleshooting <acronym>PPP</acronym> Connections @@ -1460,8 +1445,9 @@ OK connection to the ISP and lowercase p's show that the connection has been lost for whatever reason. ppp only has these 2 states. + - + Debugging If you have a direct line and cannot seem to make a @@ -1546,15 +1532,11 @@ nameserver y.y.y.yto /etc/syslog.conf. In most cases, this functionality already exists. - - - - - + - + --> Using PPP over Ethernet (PPPoE) @@ -1575,26 +1556,9 @@ nameserver y.y.y.yover Ethernet - - PPPoE - PPP, over Ethernet - - This section describes how to set up PPP over Ethernet (PPPoE). - - Configuring the Kernel - - No kernel configuration is necessary for PPPoE any longer. - If the necessary netgraph support is not built into the - kernel, it will be dynamically loaded by - ppp. - - - - Setting Up <filename>ppp.conf</filename> - Here is an example of a working ppp.conf: @@ -1610,18 +1574,10 @@ name_of_service_provider: set login add default HISADDR - - - - Running <application>ppp</application> - As root, you can run: &prompt.root; ppp -ddial name_of_service_provider - - - Starting <application>ppp</application> at Boot Add the following to your @@ -1631,7 +1587,6 @@ name_of_service_provider: ppp_mode="ddial" ppp_nat="YES" # if you want to enable nat for your local network, otherwise NO ppp_profile="name_of_service_provider" - Using a PPPoE Service Tag @@ -1670,16 +1625,10 @@ ppp_profile="name_of_service_provider"Do not forget to change ISP to the profile you have just found above. - For additional information, see: - - - - For additional information, refer to Cheaper Broadband with FreeBSD on DSL by Renaud Waldura. - - @@ -1714,7 +1663,6 @@ ppp_profile="name_of_service_provider"HomeConnect ADSL Modem at the same time. - @@ -1784,7 +1732,6 @@ ppp_profile="adsl" For this to work correctly you will need to have used the sample ppp.conf which is supplied with the net/pppoa port. - @@ -1897,7 +1844,6 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN Using mpd is the recommended way to connect to an ADSL service with &os;. -