From owner-svn-doc-projects@FreeBSD.ORG Mon Apr 29 12:49:45 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 9DB43A1E; Mon, 29 Apr 2013 12:49:45 +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 8F31812B0; Mon, 29 Apr 2013 12:49:45 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r3TCnjt7005896; Mon, 29 Apr 2013 12:49:45 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r3TCnj71005895; Mon, 29 Apr 2013 12:49:45 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201304291249.r3TCnj71005895@svn.freebsd.org> From: Dru Lavigne Date: Mon, 29 Apr 2013 12:49:45 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r41514 - 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, 29 Apr 2013 12:49:45 -0000 Author: dru Date: Mon Apr 29 12:49:45 2013 New Revision: 41514 URL: http://svnweb.freebsd.org/changeset/doc/41514 Log: This patch addresses the following: - you - some acronym tags This chapter needs much more work, further patches pending. Approved by: gjb (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 29 12:44:22 2013 (r41513) +++ projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Mon Apr 29 12:49:45 2013 (r41514) @@ -125,7 +125,7 @@ An account with an Internet Service Provider - (ISP) which you connect to using + (ISP) for connecting using PPP. @@ -156,7 +156,7 @@ password - Your login name and password. (Either a + A login name and password. (Either a regular &unix; style login and password pair, or a PAP or CHAP login and password pair). @@ -167,14 +167,14 @@ The IP address of one or more name servers. - Normally, you will be given two IP addresses by your - ISP. If they have not given you at - least one, use the enable dns command - in ppp.conf and - ppp will set the name - servers. This feature depends on the - ISP's PPP - implementation supporting DNS negotiation. + Normally, the ISP will provide two + IP addresses. If it has not provided any IP addresses, + include enable dns in + ppp.conf and + ppp will set the name servers. This + feature requires the ISP's + PPP implementation to support DNS + negotiation. @@ -184,13 +184,13 @@ - 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 + The IP address of the ISP's + gateway. The gateway is the machine to connect to + and will be set up as the default + route. When in doubt, make one up and the ISP's PPP server - will tell us the correct value when we connect. + will set the correct value during connection + setup. This IP number is referred to as HISADDR by @@ -198,9 +198,8 @@ - The netmask you should use. If the - ISP has not provided you with one, - you can safely use The netmask. If the ISP has not + provided one, use 255.255.255.255. @@ -215,8 +214,8 @@ - If you do not have any of the required information, - contact your ISP. + If any of the required information is missing, contact + the ISP. Throughout this section, many of the examples showing @@ -243,13 +242,10 @@ 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). + Configuring ppp requires a number of + files to be edited, depending on the requirements and + whether the ISP allocates IP addresses + statically or dynamically. <acronym>PPP</acronym> and Static IP @@ -260,9 +256,8 @@ <secondary>with static IP addresses</secondary> </indexterm> - <para>You will need to edit the - <filename>/etc/ppp/ppp.conf</filename> configuration file. - It should look similar to the example below.</para> + <para>Edit <filename>/etc/ppp/ppp.conf</filename> so that it + looks similar to the example below.</para> <note> <para>Lines that end in a <literal>:</literal> start in @@ -347,9 +342,10 @@ <term>Line 5:</term> <listitem> - <para>Sets the speed you want to connect at. If - 115200 does not work (it should with any reasonably - new modem), try 38400 instead.</para> + <para>Sets the connection speed. If + <literal>115200</literal> does not work (it should + with any reasonably new modem), try + <literal>38400</literal> instead.</para> </listitem> </varlistentry> @@ -411,10 +407,10 @@ <listitem> <para>Identifies an entry for a provider called <quote>provider</quote>. This could be changed - to the name of your <acronym>ISP</acronym> so - that later you can use the <option>load - <replaceable>ISP</replaceable></option> to start - the connection.</para> + to the name of the <acronym>ISP</acronym> so + that <option>load + <replaceable>ISP</replaceable></option> can be + used to start the connection.</para> </listitem> </varlistentry> @@ -427,17 +423,16 @@ colon (<literal>:</literal>) or pipe character (<literal>|</literal>) as a separator. The difference between the two separators is described - in &man.ppp.8;. To summarize, if you want to rotate - through the numbers, use a colon. If you want to - always attempt to dial the first number first and - only use the other numbers if the first number - fails, use the pipe character. Always quote the - entire set of phone numbers as shown.</para> - - <para>You must enclose the phone number in quotation - marks (<literal>"</literal>) if there is any - intention on using spaces in the phone number. - This can cause a simple, yet subtle error.</para> + in &man.ppp.8;. To summarize, to rotate through the + numbers, use a colon. To always attempt to dial the + first number first and only use the other numbers if + the first number fails, use the pipe character. + Always quote the entire set of phone numbers as + shown.</para> + + <para>The phone number must be enclosed in quotation + marks (<literal>"</literal>) if there are any spaces + in the phone number.</para> </listitem> </varlistentry> @@ -460,10 +455,9 @@ <listitem> <indexterm><primary>PAP</primary></indexterm> <indexterm><primary>CHAP</primary></indexterm> - <para>If you are using PAP or CHAP, there will be no - login at this point, and this line should be - commented out or removed. See <link - linkend="userppp-PAPnCHAP">PAP and CHAP + <para>When using PAP or CHAP, there will be no login + and this line should be commented out or removed. + See <link linkend="userppp-PAPnCHAP">PAP and CHAP authentication</link> for further details.</para> <para>The login string is of the same chat-like @@ -476,11 +470,12 @@ login: <replaceable>foo</replaceable> password: <replaceable>bar</replaceable> protocol: ppp</screen> - <para>You will need to alter this script to suit your - own needs. When you write this script for the first - time, you should ensure that you have enabled - <quote>chat</quote> logging so you can determine if - the conversation is going as expected.</para> + <para>Replace the login and password values with + those required by the <acronym>ISP</acronym>. When + writing this script for the first time, ensure that + <quote>chat</quote> logging is enabled in order to + determine if the conversation is going as + expected.</para> </listitem> </varlistentry> @@ -492,10 +487,9 @@ protocol: ppp</screen> <para>Sets the default idle timeout (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 <option>-ddial</option> command line - switch.</para> + automatically after 300 seconds of inactivity. To + never timeout, set this value to zero or use the + <option>-ddial</option> command line switch.</para> </listitem> </varlistentry> @@ -506,15 +500,15 @@ protocol: ppp</screen> <para>Sets the interface addresses. The string <replaceable>x.x.x.x</replaceable> should be - replaced by the IP address that your provider has - allocated to you. The string + replaced by the IP address the provider has + allocated. The string <replaceable>y.y.y.y</replaceable> should be replaced by the IP address of the <acronym>ISP</acronym>'s gateway. If the ISP has - not given you a gateway address, use <hostid - role="netmask">10.0.0.2/0</hostid>. If you need to - use a <quote>guessed</quote> address, make sure that - you create an entry in + not provided a gateway address, use <hostid + role="netmask">10.0.0.2/0</hostid>. When using a + <quote>guessed</quote> address, make sure to create + an entry in <filename>/etc/ppp/ppp.linkup</filename> as per the instructions for <link linkend="userppp-dynamicIP"><acronym>PPP</acronym> @@ -536,20 +530,19 @@ protocol: ppp</screen> otherwise <literal>HISADDR</literal> will not yet be initialized.</para> - <para>If you do not wish to run <command>ppp</command> - in <option>-auto</option> mode, this line should be - moved to the <filename>ppp.linkup</filename> - file.</para> + <para>When <command>ppp</command> is not run in + <option>-auto</option> mode, this line should be + moved to <filename>ppp.linkup</filename>.</para> </listitem> </varlistentry> </variablelist> <para>It is not necessary to add an entry to - <filename>ppp.linkup</filename> when you have a static - IP address and are running <command>ppp</command> in - <option>-auto</option> mode as your routing table entries - are already correct before you connect. You may however - wish to create an entry to invoke programs after + <filename>ppp.linkup</filename> when using a static + IP address with <command>ppp</command> in + <option>-auto</option> mode as the routing table entries + are already correct before a connection is established. + However, an entry can be created to invoke programs after connection. This is explained later with the sendmail example.</para> @@ -572,7 +565,7 @@ protocol: ppp</screen> <primary>IPCP</primary> </indexterm> - <para>If your service provider does not assign static IP + <para>If the service provider does not assign static IP addresses, <command>ppp</command> can be configured to negotiate the local and remote addresses. This is done by <quote>guessing</quote> an IP address and allowing @@ -596,10 +589,9 @@ protocol: ppp</screen> <listitem> <para>The number after the <literal>/</literal> character is the number of bits of the address that - <command>ppp</command> will insist on. You may wish - to use IP numbers more appropriate to your - circumstances, but the above example will always - work.</para> + <command>ppp</command> will insist on. These + IP numbers can be replaced, but the above example + will always work.</para> <para>The last argument (<literal>0.0.0.0</literal>) tells <acronym>PPP</acronym> to start negotiations @@ -614,8 +606,8 @@ protocol: ppp</screen> </varlistentry> </variablelist> - <para>If you are not running in <option>-auto</option> mode, - you will need to create an entry in + <para>When not running in <option>-auto</option> mode, + create an entry in <filename>/etc/ppp/ppp.linkup</filename>. <filename>ppp.linkup</filename> is used after a connection has been established. At this point, @@ -672,15 +664,14 @@ protocol: ppp</screen> <secondary>receiving incoming calls</secondary> </indexterm> - <para>When you configure <command>ppp</command> 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 - your LAN's subnet, and use the command <command>enable - proxy</command> in your - <filename>/etc/ppp/ppp.conf</filename> file. You should - also confirm that the <filename>/etc/rc.conf</filename> - file contains the following:</para> + <para>When configuring <command>ppp</command> 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 number from the LAN's subnet and use + <command>enable proxy</command> in + <filename>/etc/ppp/ppp.conf</filename>. Also, confirm + that <filename>/etc/rc.conf</filename> contains the + following:</para> <programlisting>gateway_enable="YES"</programlisting> </sect4> @@ -699,15 +690,15 @@ protocol: ppp</screen> designed with dial-up lines in mind.</para> <para>The advantages of using <command>mgetty</command> is - that it actively <emphasis>talks</emphasis> to modems, - meaning if port is turned off in - <filename>/etc/ttys</filename> then your modem will not - answer the phone.</para> + that it actively <emphasis>talks</emphasis> to modems. + If the port is turned off in + <filename>/etc/ttys</filename>, the modem will not answer + the phone.</para> <para>Later versions of <command>mgetty</command> (from 0.99beta onwards) also support the automatic detection of - <acronym>PPP</acronym> streams, allowing your clients - script-less access to your server.</para> + <acronym>PPP</acronym> streams, allowing clients + scriptless access to the server.</para> <para>Refer to <link linkend="userppp-mgetty">Mgetty and AutoPPP</link> for more information on @@ -718,16 +709,14 @@ protocol: ppp</screen> <title><acronym>PPP</acronym> Permissions The ppp command must normally be - run as the root user. If however, - you wish to allow ppp to run in - server mode as a normal user by executing - ppp as described below, 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 give a + user permission to run ppp in server + mode, add their user account to the + network group in + /etc/group. - You will also need to give them access to one or more - sections of the configuration file using the + Then, give the account access to one or more sections + of the configuration file using the allow command: allow users fred mary @@ -769,12 +758,12 @@ exec /usr/sbin/ppp -direct $IDENT&prompt.root; ln -s ppp-shell /etc/ppp/ppp-dialup - You 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 - pchilds (remember do not directly - edit the password file, use &man.vipw.8;). + Use this script as the shell for + all dialup users. This is an example from + /etc/passwd for a dialup + PPP user with the username + pchilds. Do not directly edit this + file, use &man.vipw.8;. pchilds:*:1011:300:Peter Childs PPP:/home/ppp:/etc/ppp/ppp-dialup @@ -803,10 +792,10 @@ exec /usr/sbin/ppp -direct $IDENTppp-shell. - For example, if you have three dialup customers, + Consider three dialup customers, fred, sam, - and mary, that you route /24 CIDR - networks for, you would type the following: + and mary. In order to route /24 + CIDR networks, type the following: &prompt.root; ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-fred &prompt.root; ln -s /etc/ppp/ppp-shell /etc/ppp/ppp-sam @@ -845,7 +834,7 @@ ttyu1: for each session. For each dialup line enabled in /etc/ttys create an entry similar to the one for ttyu0: above. Each - line should get a unique IP address from your pool of + line should get a unique IP address from the pool of IP addresses for dynamic users. @@ -855,10 +844,8 @@ ttyu1: Along with the contents of the sample /usr/share/examples/ppp/ppp.conf - above you should add a section for each of the - statically assigned dialup users. We will continue with - our fred, sam, - and mary example. + above, add a section for each of the statically assigned + dialup users: fred: set ifaddr 203.14.100.1 203.14.101.1 255.255.255.255 @@ -916,9 +903,9 @@ mary: role="package">comms/mgetty+sendfax port on his system. - Make sure your + Make sure /usr/local/etc/mgetty+sendfax/login.config - file has the following in it: + has the following: /AutoPPP/ - - /etc/ppp/ppp-pap-dialup @@ -953,8 +940,8 @@ exec /usr/sbin/ppp -direct pap$IDENTenable passwdauth - If you wish to assign some users a static IP number, - you can specify the number as the third argument in + To assign some users a static IP, specify the IP + address as the third argument in /etc/ppp/ppp.secret. See /usr/share/examples/ppp/ppp.secret.sample for examples. @@ -1015,8 +1002,8 @@ set nbns 203.14.100.5 that the authentication part of the connection is done using either the PAP or CHAP authentication mechanism. If this is the case, the ISP will not give - a login: prompt when you connect, but - will start talking PPP + a login: during connection, but will + start talking PPP immediately. PAP is less secure than CHAP, but security is not @@ -1041,8 +1028,8 @@ set nbns 203.14.100.5 Line 13: - This line specifies your PAP/CHAP user name. - You will need to insert the correct value for + This line specifies the PAP/CHAP user name. + Insert the correct value for MyUserName. @@ -1052,10 +1039,10 @@ set nbns 203.14.100.5 password - This line specifies your PAP/CHAP password. - You will need to insert the correct value for - MyPassword. You may - want to add an additional line, such as: + This line specifies the PAP/CHAP password. + Insert the correct value for + MyPassword. An + additional line can be added, such as: 16 accept PAP @@ -1073,9 +1060,9 @@ set nbns 203.14.100.5 Line 15: - Your ISP will not normally - require you to log into the server when using PAP or - CHAP. You must therefore disable your set + The ISP will not normally + require a login into the server when using PAP or + CHAP. Therefore, disable the set login string. @@ -1083,13 +1070,13 @@ set nbns 203.14.100.5 - Changing Your <command>ppp</command> Configuration + <title>Changing the <command>ppp</command> Configuration on the Fly It is possible to talk to the ppp program while it is running in the background, but only if a suitable diagnostic port has been set up. To do - this, add the following line to your configuration: + this, add the following line to the configuration: set server /var/run/ppp-tun%d DiagnosticPassword 0177 @@ -1127,8 +1114,8 @@ set nbns 203.14.100.5 ppp_nat, which is enabled by default. - If you use this feature, you may also find useful - the following /etc/ppp/ppp.conf options + When using this feature, the following + /etc/ppp/ppp.conf options are useful to enable incoming connections forwarding: nat port tcp 10.0.0.2:ftp ftp @@ -1146,10 +1133,9 @@ nat port tcp 10.0.0.2:http httpPPPconfiguration - You now have ppp configured, but - there are a few more things to do before it is ready to - work. They all involve editing the - /etc/rc.conf file. + Now that ppp is configured, there are + a few more things to edit in + /etc/rc.conf. Working from the top down in this file, make sure the hostname= line is set, e.g.: @@ -1157,11 +1143,11 @@ nat port tcp 10.0.0.2:http httphostname="foo.example.com" If the ISP has supplied a static IP - address and name, it is probably best that you use this name - as your host name. + address and name, it is recommended to use this name as the + host name. Look for the network_interfaces - variable. If you want to configure your system to dial your + variable. To configure the system to dial the ISP on demand, make sure the tun0 device is added to the list, otherwise remove it. @@ -1178,15 +1164,15 @@ ifconfig_tun0= ppp -auto mysystem This script is executed at network configuration time, - starting your ppp daemon in - mode. If you have a LAN for which - this machine is a gateway, you may also wish to use the + starting the ppp daemon in + mode. If the machine functions as + a gateway for a LAN, consider using the switch. Refer to the manual page - for further details. + for details. Make sure that the router program is set to - NO with the following line in your + NO with the following line in /etc/rc.conf: router_enable="NO" @@ -1204,24 +1190,22 @@ ifconfig_tun0= sendmail_flags line does not include the option, otherwise sendmail will attempt to do a network - lookup every now and then, possibly causing your machine - to dial out. You may try: + lookup every now and then, possibly causing the machine + to dial out. Try this command instead: sendmail_flags="-bd" sendmail - The downside of this is that you must force - sendmail to re-examine the mail queue - whenever the PPP link is up by - typing: + The downside is that sendmail must be + forced to re-examine the mail queue whenever the + PPP link is up by typing: &prompt.root; /usr/sbin/sendmail -q - You may wish to use the !bg command - in ppp.linkup to do this - automatically: + To automatically use the !bg command + in ppp.linkup: 1 provider: 2 delete ALL @@ -1232,20 +1216,20 @@ ifconfig_tun0= SMTP - If you do not like this, it is possible to set up a - dfilter to block SMTP traffic. Refer to the - sample files for further details. + It is possible to set up a dfilter to + block SMTP traffic. Refer to the sample files for further + details. All that is left is to reboot the machine. After - rebooting, you can now either type: + rebooting, either type: &prompt.root; ppp and then dial provider to start the - PPP session, or, if you want + PPP session, or, to configure ppp to establish sessions automatically - when there is outbound traffic (and you have not created the - start_if.tun0 script), type: + when there is outbound traffic and there is no existing + start_if.tun0 script, type: &prompt.root; ppp -auto provider @@ -1261,7 +1245,7 @@ ifconfig_tun0= Ensure that the tun device - is built into your kernel. + is built into the kernel. @@ -1279,18 +1263,17 @@ ifconfig_tun0= - If you have a dynamic IP address, create an entry in + When using a dynamic IP address, create an entry in /etc/ppp/ppp.linkup. - Update your /etc/rc.conf - file. + Update /etc/rc.conf. Create a start_if.tun0 script - if you require demand dialing. + if demand dialing is required. @@ -1299,7 +1282,7 @@ ifconfig_tun0= Ensure that the tun device - is built into your kernel. + is built into the kernel. @@ -1334,8 +1317,7 @@ ifconfig_tun0= - Update your /etc/rc.conf - file. + Update /etc/rc.conf. @@ -1361,23 +1343,21 @@ 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 + using PPP over a modem connection. Some ISPs present the ssword prompt, and others will present password; if the ppp script is not written accordingly, the login attempt will fail. The most common way to debug ppp connections is by connecting manually. The following - information will walk you through a manual connection step by + information walks through a manual connection step by step. Check the Device Nodes When using a custom kernel, make sure to include the - following line in your kernel configuration file: + following line in the kernel configuration file: device uart @@ -1389,17 +1369,13 @@ ifconfig_tun0= &prompt.root; dmesg | grep uart - You should get some pertinent output about the - uart devices. These are the COM - ports we need. If your modem acts like a standard serial - port then you should see it listed on + The uart devices should provide + some pertinent output about the COM ports. If the modem acts + like a standard serial port, it should be listed on uart1, or - COM2. If so, you are not required - to rebuild the kernel. When matching up sio modem is on - uart1 or - COM2 if you are in DOS, then your - modem device would be /dev/cuau1. + COM2. If so, a custom kernel is not + needed. In this configuration, the modem device would be + /dev/cuau1. @@ -1407,42 +1383,39 @@ ifconfig_tun0= Connecting to the Internet by manually controlling ppp is quick, easy, and a great way to - debug a connection or just get information on how your + debug a connection or just get information on how the ISP treats ppp client connections. Lets start PPP from - the command line. Note that in all of our examples we will - use example as the hostname of the - machine running PPP. You start - ppp by just typing + the command line. The following examples use + example as the hostname of the + machine running PPP. To start ppp: &prompt.root; ppp - We have now started ppp. - + This sets the modem device to + cuau1: + ppp ON example> set device /dev/cuau1 - We set our modem device, in this case it is - cuau1. + This sets the connection speed to 115,200 + kbps: ppp ON example> set speed 115200 - Set the connection speed, in this case we - are using 115,200 kbps. - - ppp ON example> enable dns - - Tell ppp to configure our + This tells ppp to configure the resolver and add the nameserver lines to /etc/resolv.conf. If - ppp cannot determine our hostname, we can - set one manually later. + ppp cannot determine the hostname, it can + manually be set later. - ppp ON example> term + ppp ON example> enable dns Switch to terminal mode so that we can manually control the modem. + ppp ON example> term + deflink: Entering terminal mode on /dev/cuau1 type '~h' for help @@ -1451,7 +1424,7 @@ OK atdt123456789 Use at to initialize the modem, - then use atdt and the number for your + then use atdt and the number for the ISP to begin the dial in process. CONNECT @@ -1462,8 +1435,8 @@ OK ISP Login:myusername - Here you are prompted for a username, return the - prompt with the username that was provided by the + When prompted for a username, return the prompt with the + username that was provided by the ISP. ISP Pass:mypassword @@ -1475,7 +1448,7 @@ OK Shell or PPP:ppp - Depending on your ISP this prompt + Depending on the ISP, this prompt may never appear. Here we are being asked if we wish to use a shell on the provider, or to start ppp. In this example, we have chosen @@ -1504,47 +1477,45 @@ OK Here we add our default route, we need to do this before we can talk to the outside world as currently the only established connection is with the peer. If this fails due to - existing routes you can put a bang character - ! in front of the . - Alternatively, you can set this before making the actual - connection and it will negotiate a new route - accordingly. + existing routes, put a bang character + (!) in front of the . + Alternatively, set this before making the actual connection + and it will negotiate a new route accordingly. - If everything went good we should now have an active - connection to the Internet, which could be thrown into the + If everything went well, there is now an active + connection to the Internet which can be placed into the background using CTRL - z If you notice the - PPP return to ppp then - we have lost our connection. This is good to know because it - shows our connection status. Capital P's show that we have a - connection to the ISP and lowercase p's - show that the connection has been lost for whatever reason. - ppp only has these 2 states. + z. If + PPP instead returns to + ppp, the connection has been lost. An + uppercase P indicates a + connection to the ISP and a lowercase + p indicates that the connection has been + lost. ppp only has these 2 states. Debugging - If you have a direct line and cannot seem to make a - connection, then turn hardware flow - CTS/RTS to off with the . This is mainly the case if you are + For a direct line that cannot seem to make a connection, + turn hardware flow CTS/RTS to off with + . This can occur when connected to some PPP capable - terminal servers, where PPP hangs - when it tries to write data to your communication link, so - it would be waiting for a CTS, or Clear - To Send signal which may never come. If you use this option - however, you should also use the - option, which may be required to defeat hardware dependent - on passing certain characters from end to end, most of the - time XON/XOFF. See the &man.ppp.8; manual page for more - information on this option, and how it is used. - - If you have an older modem, you may need to use the - . Parity is set at none - be default, but is used for error checking (with a large + terminal servers as PPP hangs + when it tries to write data to the communication link and + then waits for a Clear To Send (CTS) + signal which may never come. When using this option, + include , which may be required + to defeat hardware which is dependent on passing certain + characters from end to end, such as XON/XOFF. See + &man.ppp.8; for more information on how this option is + used. + + For an older modem, may + be needed. Parity is set at none by + default, but is used for error checking (with a large increase in traffic) on older modems and some - ISPs. You may need this option for + ISPs. This option may be needed for the Compuserve ISP. PPP may not return to the @@ -1554,13 +1525,13 @@ OK 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 - CHAP authentication instead of the - &unix; style in the example above. To use - PAP or CHAP just add - the following options to PPP - before going into terminal mode: + If a login prompt never appears, try using + PAP or CHAP + authentication instead of the &unix; style in the example + above. To use PAP or + CHAP, add the following options to + PPP before going into terminal + mode: ppp ON example> set authname myusername @@ -1574,17 +1545,16 @@ OK replaced with the password that was assigned by the ISP. - If you connect fine, but cannot seem to find any domain - name, try to use &man.ping.8; with an IP - address and see if you can get any return information. If - you experience 100 percent (100%) packet loss, then it is - most likely that you were not assigned a default route. - Double check that the option was set during the connection. If you - can connect to a remote IP address then - it is possible that a resolver address has not been added - to the /etc/resolv.conf. This file - should look like: + If the connection is active but cannot resolve any + domain names, try to &man.ping.8; an IP + address. If there is 100% packet loss, it is likely that a + default route was not assigned. Double check that + was set during the + connection. If a connection to a remote + IP address cannot be established, it is + possible that a resolver address has not been added to + /etc/resolv.conf. This file should + look like: domain example.com nameserver x.x.x.x @@ -1592,15 +1562,11 @@ nameserver y.y.y.yWhere x.x.x.x and y.y.y.y should be replaced with - the IP address of your - ISP's DNS servers. This information may - or may not have been provided when you signed up, but a - quick call to your ISP should remedy - that. - - You could also have &man.syslog.3; provide a logging - function for your PPP connection. - Just add: + the IP address of the + ISP's DNS servers. + + To configure &man.syslog.3; to log + PPP connections, add: !ppp *.* /var/log/ppp.log @@ -1677,7 +1643,7 @@ name_of_service_provider: Running <command>ppp</command> - As root, you can run: + As root, run: &prompt.root; ppp -ddial name_of_service_provider @@ -1686,8 +1652,8 @@ name_of_service_provider: Starting <command>ppp</command> at Boot - Add the following to your - /etc/rc.conf file: + Add the following to + /etc/rc.conf: ppp_enable="YES" ppp_mode="ddial" @@ -1699,25 +1665,22 @@ ppp_profile="name_of_service_provider"Using a PPPoE Service Tag Sometimes it will be necessary to use a service tag to - establish your connection. Service tags are used to *** DIFF OUTPUT TRUNCATED AT 1000 LINES ***