From owner-svn-doc-projects@FreeBSD.ORG Mon Apr 22 18:01:08 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 757036BE; Mon, 22 Apr 2013 18:01:08 +0000 (UTC) (envelope-from dru@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 674C11AD3; Mon, 22 Apr 2013 18:01:08 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r3MI18L1043891; Mon, 22 Apr 2013 18:01:08 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r3MI182f043890; Mon, 22 Apr 2013 18:01:08 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201304221801.r3MI182f043890@svn.freebsd.org> From: Dru Lavigne Date: Mon, 22 Apr 2013 18:01:08 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r41471 - projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ppp-and-slip X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 22 Apr 2013 18:01:08 -0000 Author: dru Date: Mon Apr 22 18:01:07 2013 New Revision: 41471 URL: http://svnweb.freebsd.org/changeset/doc/41471 Log: Make formatting for ppp command more consistent. Approved by: bcr (mentor) Modified: projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Modified: projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml ============================================================================== --- projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Mon Apr 22 16:14:28 2013 (r41470) +++ projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Mon Apr 22 18:01:07 2013 (r41471) @@ -171,7 +171,7 @@ ISP. If they have not given you at least one, use the enable dns command in ppp.conf and - ppp will set the name + ppp will set the name servers. This feature depends on the ISP's PPP implementation supporting DNS negotiation. @@ -194,7 +194,7 @@ This IP number is referred to as HISADDR by - ppp. + ppp. @@ -296,7 +296,8 @@ Identifies the default entry. Commands in this - entry are executed automatically when ppp is + entry are executed automatically when + ppp is run. @@ -535,8 +536,8 @@ protocol: ppp otherwise HISADDR will not yet be initialized. - If you do not wish to run ppp in - , this line should be moved + If you do not wish to run ppp + in , this line should be moved to the ppp.linkup file. @@ -544,11 +545,12 @@ protocol: ppp It is not necessary to add an entry to ppp.linkup when you have a static - IP address and are running ppp in - mode as your routing table entries are already correct - before you connect. You may however wish to create an - entry to invoke programs after connection. This is - explained later with the sendmail example. + IP address and are running ppp in + mode as your routing table entries + are already correct before you connect. You may however + wish to create an entry to invoke programs after + connection. This is explained later with the sendmail + example. Example configuration files can be found in the The number after the / character is the number of bits of the address that - ppp will insist on. You may wish to use IP numbers - more appropriate to your circumstances, but the - above example will always work. + ppp will insist on. You may wish + to use IP numbers more appropriate to your + circumstances, but the above example will always + work. The last argument (0.0.0.0) tells PPP to start negotiations @@ -668,7 +671,7 @@ protocol: ppp receiving incoming calls - When you configure ppp to + When you configure ppp to receive incoming calls on a machine connected to a LAN, you must decide if you wish to forward packets to the LAN. If you do, you should allocate the peer an IP number from @@ -869,7 +872,8 @@ mary: 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. + network via the client's PPP + link. fred: add 203.14.101.0 netmask 255.255.255.0 HISADDR @@ -901,10 +905,10 @@ mary: 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. + 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 ppp -auto mysystem This script is executed at network configuration time, - starting your ppp daemon in automatic mode. If you have - a LAN for which this machine is a gateway, you may also - wish to use the switch. Refer - to the manual page for further details. + starting your ppp daemon in automatic + mode. If you have a LAN for which this machine is a + gateway, you may also wish to use the + switch. Refer to the manual page + for further details. Make sure that the router program is set to @@ -1208,7 +1213,8 @@ ifconfig_tun0= The downside of this is that you must force sendmail to re-examine the mail queue - whenever the ppp link is up by typing: + whenever the PPP link is up by + typing: &prompt.root; /usr/sbin/sendmail -q @@ -1247,7 +1253,7 @@ ifconfig_tun0= Summary To recap, the following steps are necessary when setting - up ppp for the first time: + up PPP for the first time: Client side: @@ -1544,8 +1550,8 @@ OK command mode, which is usually a negotiation error where the ISP is waiting for your side to start negotiating. At this point, using the ~p - command will force ppp to start sending the configuration - information. + command will force ppp to start + sending the configuration information. If you never obtain a login prompt, then most likely you need to use PAP or @@ -1644,7 +1650,7 @@ nameserver y.y.y.yNo kernel configuration is necessary for PPPoE. If the necessary netgraph support is not built into the kernel, it will be dynamically loaded by - ppp. + ppp. @@ -1668,7 +1674,7 @@ name_of_service_provider: - Running <application>ppp</application> + Running <command>ppp</command> As root, you can run: @@ -1677,7 +1683,7 @@ name_of_service_provider: - Starting <application>ppp</application> at Boot + Starting <command>ppp</command> at Boot Add the following to your /etc/rc.conf file: @@ -1831,7 +1837,7 @@ ppp_profile="name_of_service_provider"usbd_enable="YES" It is also possible to set up - ppp to dial up at startup. To do + ppp to dial up at startup. To do this add the following lines to /etc/rc.conf. Again, for this procedure you will need to be logged in as the root @@ -1975,8 +1981,8 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN need to be root to perform both of these operations. An example section of ppp.conf is given below. For further information on - ppp.conf options consult the - ppp manual page, &man.ppp.8;. + ppp.conf options consult + &man.ppp.8;. adsl: set log phase chat lcp ipcp ccp tun command @@ -2033,7 +2039,7 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN A tun virtual tunnel device will be created for interaction between the pptp and - ppp processes. Once you have been + ppp processes. Once you have been returned to your prompt, or the pptp process has confirmed a connection you can examine the tunnel like so: @@ -2048,7 +2054,7 @@ tun0: flags=8051<UP,POINTOPOINT,RUNNI telnet or with a web browser. If you still cannot connect you should examine the output of the pptp command and the contents of the - ppp log file, + ppp log file, /var/log/ppp.log for clues.