From owner-svn-doc-projects@FreeBSD.ORG Thu May 9 20:51:47 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 4F2CDF3; Thu, 9 May 2013 20:51:47 +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 3F608131; Thu, 9 May 2013 20:51:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r49Kpkgm035674; Thu, 9 May 2013 20:51:46 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r49Kpk2U035673; Thu, 9 May 2013 20:51:46 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201305092051.r49Kpk2U035673@svn.freebsd.org> From: Dru Lavigne Date: Thu, 9 May 2013 20:51:46 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r41582 - 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: Thu, 09 May 2013 20:51:47 -0000 Author: dru Date: Thu May 9 20:51:46 2013 New Revision: 41582 URL: http://svnweb.freebsd.org/changeset/doc/41582 Log: White space fix only. Translators can ignore. 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 Thu May 9 18:37:36 2013 (r41581) +++ projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Thu May 9 20:51:46 2013 (r41582) @@ -122,7 +122,7 @@ An account with an Internet Service Provider - (ISP) for connecting using + (ISP) for connecting using PPP. @@ -166,16 +166,14 @@ The IP address of one or more - name servers. - Normally, the ISP will provide the - addresses for two + name servers. Normally, the ISP + will provide the addresses for two DNS servers. If it has not, include enable dns in - ppp.conf and - &man.ppp.8; will set the name servers. This - feature requires the ISP's - PPP implementation to support DNS - negotiation. + ppp.conf and &man.ppp.8; will set + the name servers. This feature requires the + ISP's PPP + implementation to support DNS negotiation. @@ -186,17 +184,15 @@ 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 set the correct value during connection - setup. + 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 set the correct + value during connection setup. This IP number is referred to as - HISADDR by - &man.ppp.8;. + HISADDR by &man.ppp.8;. @@ -211,9 +207,9 @@ If the ISP provides a static - IP - address and hostname, enter it. Otherwise, let the peer - assign the IP address. + IP address and hostname, enter it. + Otherwise, let the peer assign the IP + address. @@ -242,15 +238,13 @@ Several files located in /etc/ppp are used to - configure &man.ppp.8;. - Examples can be found in /usr/share/examples/ppp/. - Configuring &man.ppp.8; requires a number of - files to be edited, depending on the requirements and - whether the ISP allocates - IP addresses - statically or dynamically. + Configuring &man.ppp.8; 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 @@ -297,9 +291,8 @@ <listitem> <para>Identifies the default entry. Commands in this - entry are executed automatically when - &man.ppp.8; is - run.</para> + entry are executed automatically when &man.ppp.8; + is run.</para> </listitem> </varlistentry> @@ -337,9 +330,7 @@ <para>Identifies the device to which the modem is connected. <devicename>COM1</devicename> is <filename class="devicefile">/dev/cuau0</filename> - and - <devicename>COM2</devicename> is - <filename + and <devicename>COM2</devicename> is <filename class="devicefile">/dev/cuau1</filename>.</para> </listitem> </varlistentry> @@ -451,9 +442,9 @@ values are referred to by the <command>set login</command> command using the \U and \P variables. When connecting using - <acronym>PAP</acronym> - or <acronym>CHAP</acronym>, these - values are used at authentication time.</para> + <acronym>PAP</acronym> or + <acronym>CHAP</acronym>, these values are used at + authentication time.</para> </listitem> </varlistentry> @@ -464,8 +455,7 @@ <indexterm><primary>PAP</primary></indexterm> <indexterm><primary>CHAP</primary></indexterm> <para>When using <acronym>PAP</acronym> or - <acronym>CHAP</acronym>, - there will be no login + <acronym>CHAP</acronym>, there will be no login and this line should be commented out or removed. See <xref linkend="userppp-PAPnCHAP"/> for further details.</para> @@ -511,19 +501,17 @@ protocol: ppp</screen> <para>Sets the interface addresses. The string <replaceable>x.x.x.x</replaceable> should be replaced by the <acronym>IP</acronym> address the - provider has - allocated. The string + provider has allocated. The string <replaceable>y.y.y.y</replaceable> should be replaced by the <acronym>IP</acronym> address of the <acronym>ISP</acronym>'s gateway. If the ISP has not provided a gateway address, use <hostid - role="netmask">10.0.0.2/0</hostid>. When using a + 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 in <xref linkend="userppp-dynamicIP"/>. - If this line is - omitted, &man.ppp.8; cannot run in + If this line is omitted, &man.ppp.8; cannot run in <option>-auto</option> mode.</para> </listitem> </varlistentry> @@ -551,7 +539,7 @@ protocol: ppp</screen> <filename>ppp.linkup</filename> when using a static <acronym>IP</acronym> address with &man.ppp.8; in <option>-auto</option> mode as the routing table entries - are already correct before a connection is established. + 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> @@ -577,18 +565,16 @@ protocol: ppp</screen> </indexterm> <para>If the service provider does not assign static - <acronym>IP</acronym> - addresses, &man.ppp.8; can be configured to - negotiate the local and remote addresses. This is done by - <quote>guessing</quote> an <acronym>IP</acronym> address - and allowing - &man.ppp.8; to set it up correctly using the + <acronym>IP</acronym> addresses, &man.ppp.8; can be + configured to negotiate the local and remote addresses. + This is done by <quote>guessing</quote> an + <acronym>IP</acronym> address and allowing &man.ppp.8; + to set it up correctly using the <acronym>IP</acronym> Configuration Protocol (<acronym>IPCP</acronym>) after - connecting. The - <filename>ppp.conf</filename> configuration is the same as - that described in <xref linkend="userppp-staticIP"/>, with - the following + connecting. The <filename>ppp.conf</filename> + configuration is the same as that described in <xref + linkend="userppp-staticIP"/>, with the following change:</para> <programlisting>17 set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.255 0.0.0.0</programlisting> @@ -606,8 +592,7 @@ protocol: ppp</screen> character is the number of bits of the address that &man.ppp.8; will insist on. These <acronym>IP</acronym> numbers can be replaced, but - the above example - will always work.</para> + the above example will always work.</para> <para>The last argument (<literal>0.0.0.0</literal>) tells <acronym>PPP</acronym> to start negotiations @@ -626,10 +611,9 @@ protocol: ppp</screen> 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, - &man.ppp.8; will have assigned the interface - addresses and it will now be possible to add the routing - table entries:</para> + has been established. At this point, &man.ppp.8; will + have assigned the interface addresses and it will now be + possible to add the routing table entries:</para> <programlisting>1 provider: 2 add default HISADDR</programlisting> @@ -639,15 +623,15 @@ protocol: ppp</screen> <term>Line 1:</term> <listitem> - <para>On establishing a connection, - &man.ppp.8; will look for an entry in - <filename>ppp.linkup</filename> according to the - following rules. First, try to match the same label - used in <filename>ppp.conf</filename>. If - that fails, look for an entry for the four-octet - <acronym>IP</acronym> address of - the gateway. If an entry is still not found, look - for the <literal>MYADDR</literal> entry.</para> + <para>On establishing a connection, &man.ppp.8; will + look for an entry in <filename>ppp.linkup</filename> + according to the following rules. First, try to + match the same label used in + <filename>ppp.conf</filename>. If that fails, look + for an entry for the four-octet + <acronym>IP</acronym> address of the gateway. If + an entry is still not found, look for the + <literal>MYADDR</literal> entry.</para> </listitem> </varlistentry> @@ -655,13 +639,11 @@ protocol: ppp</screen> <term>Line 2:</term> <listitem> - <para>This line tells &man.ppp.8; to add a - default route that points to - <literal>HISADDR</literal>. + <para>This line tells &man.ppp.8; to add a default + route that points to <literal>HISADDR</literal>. <literal>HISADDR</literal> will be replaced with the <acronym>IP</acronym> number of the gateway as - negotiated by - <acronym>IPCP</acronym>.</para> + negotiated by <acronym>IPCP</acronym>.</para> </listitem> </varlistentry> </variablelist> @@ -681,14 +663,12 @@ protocol: ppp</screen> <secondary>receiving incoming calls</secondary> </indexterm> - <para>When configuring &man.ppp.8; to receive - incoming calls on a machine connected to a - <acronym>LAN</acronym>, decide if - packets should be forwarded to the local network. - If so, allocate + <para>When configuring &man.ppp.8; to receive incoming + calls on a machine connected to a + <acronym>LAN</acronym>, decide if packets should be + forwarded to the local network. If so, allocate the peer an <acronym>IP</acronym> number from the local - subnet and use - <command>enable proxy</command> in + 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> @@ -704,36 +684,32 @@ protocol: ppp</screen> <para>An alternative to &man.getty.8; is <ulink url="http://mgetty.greenie.net/">mgetty</ulink>, a - smarter version of &man.getty.8; - designed with dialup lines in mind. It can be installed - from the <filename + smarter version of &man.getty.8; designed with dialup + lines in mind. It can be installed from the <filename role="package">comms/mgetty+sendfax</filename> package or port.</para> - <para>The advantages of using &man.getty.8; is - that it actively <emphasis>talks</emphasis> to modems. - If the port is turned off in + <para>The advantages of using &man.getty.8; is 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>The &os; version of &man.getty.8; - supports the automatic detection of - <acronym>PPP</acronym> streams, allowing clients - scriptless access to the server.</para> - - <para>Refer to <xref linkend="userppp-mgetty"/> - for more information on - &man.getty.8;.</para> + <para>The &os; version of &man.getty.8; supports the + automatic detection of <acronym>PPP</acronym> streams, + allowing clients scriptless access to the server.</para> + + <para>Refer to <xref linkend="userppp-mgetty"/> for more + information on &man.getty.8;.</para> </sect4> <sect4> <title><acronym>PPP</acronym> Permissions - Typically, &man.ppp.8; is - run as the root user. To give a - user permission to run &man.ppp.8; in server - mode, add their user account to the - network group in + Typically, &man.ppp.8; is run as the + root user. To give a user permission + to run &man.ppp.8; in server mode, add their user account + to the network group in /etc/group. Then, give the account access to one or more sections @@ -749,8 +725,7 @@ protocol: ppp <acronym>PPP</acronym> Shells for - Dynamic-<acronym>IP</acronym> - Users + Dynamic-IP Users PPP shells @@ -803,8 +778,7 @@ exec /usr/sbin/ppp -direct $IDENT <acronym>PPP</acronym> Shells for - Static-<acronym>IP</acronym> - Users + Static-IP Users PPP shells @@ -858,8 +832,8 @@ ttyu1: /etc/ttys create an entry similar to the one for ttyu0: above. Each line should get a unique IP address - from the pool of - IP addresses for dynamic users. + from the pool of IP addresses for + dynamic users. @@ -883,10 +857,9 @@ mary: The file /etc/ppp/ppp.linkup 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. + would add a route for the 203.14.101.0/24 network via + the client's PPP link. fred: add 203.14.101.0 netmask 255.255.255.0 HISADDR @@ -916,13 +889,12 @@ mary: By default the comms/mgetty+sendfax port comes with the AUTO_PPP option enabled - allowing &man.getty.8; to detect the LCP - phase of PPP connections and - automatically spawn off a &man.ppp.8; shell. - However, since the default login/password sequence does - not occur it is necessary to authenticate users using - either PAP or - CHAP. + allowing &man.getty.8; to detect the LCP phase of + PPP connections and automatically + spawn off a &man.ppp.8; 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 enable passwdauth To assign some users a static IP, - specify the IP - address as the third argument in - /etc/ppp/ppp.secret. See + specify the IP address as the third + argument in /etc/ppp/ppp.secret. + See /usr/share/examples/ppp/ppp.secret.sample for examples. @@ -1027,18 +999,15 @@ set nbns 203.14.100.5 Some ISPs set their system up so that the authentication part of the connection is done using either the PAP or - CHAP - authentication mechanism. If + CHAP authentication mechanism. If this is the case, the ISP will not give a login: during connection, but will start talking PPP immediately. While PAP is less secure than - CHAP, - security is not - normally an issue as the clear text passwords are - transmitted down a + CHAP, security is not normally an + issue as the clear text passwords are transmitted down a serial line only. There is not much room for crackers to eavesdrop. @@ -1057,8 +1026,8 @@ set nbns 203.14.100.5 This line specifies the - PAP/CHAP user name. - Insert the correct value for + PAP/CHAP user name. Insert the + correct value for MyUserName. @@ -1069,9 +1038,8 @@ set nbns 203.14.100.5 password This line specifies the - PAP/CHAP - password. - Insert the correct value for + PAP/CHAP password. Insert the + correct value for MyPassword. An additional line can be added, such as: @@ -1083,9 +1051,7 @@ set nbns 203.14.100.5 to make it obvious that this is the intention, but PAP and - CHAP - are both accepted - by + CHAP are both accepted by default. @@ -1098,8 +1064,7 @@ set nbns 203.14.100.5 require a login into the server when using PAP or CHAP. Therefore, disable the - set - login string. + set login string. @@ -1109,10 +1074,10 @@ set nbns 203.14.100.5 Changing the &man.ppp.8; Configuration on the Fly - It is possible to talk to &man.ppp.8; - 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 the configuration: + It is possible to talk to &man.ppp.8; 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 the configuration: set server /var/run/ppp-tun%d DiagnosticPassword 0177 @@ -1169,8 +1134,8 @@ nat port tcp 10.0.0.2:http httpPPPconfiguration - Now that &man.ppp.8; is configured, there are - a few more things to edit in + Now that &man.ppp.8; 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 @@ -1179,9 +1144,8 @@ 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 recommended to use this name as the - host name. + IP address and name, it is recommended + to use this name as the host name. Look for the network_interfaces variable. To configure the system to dial the @@ -1218,31 +1182,30 @@ ifconfig_tun0= routed - It is important that the &man.routed.8; - daemon is not started, as &man.routed.8; tends - to delete the default routing table entries created by - &man.ppp.8;. + It is important that the &man.routed.8; daemon is not + started, as &man.routed.8; tends to delete the default + routing table entries created by &man.ppp.8;. It is probably a good idea to ensure that the sendmail_flags line does not include - ; otherwise, - &man.sendmail.8; will attempt to do a network - lookup every now and then, possibly causing the machine - to dial out. Try this command instead: + ; otherwise, &man.sendmail.8; will + attempt to do a network lookup every now and then, possibly + causing the machine to dial out. Try this command + instead: sendmail_flags="-bd" Sendmail - The downside is that &man.sendmail.8; must be - forced to re-examine the mail queue whenever the + The downside is that &man.sendmail.8; must be forced + to re-examine the mail queue whenever the PPP link is up by typing: &prompt.root; /usr/sbin/sendmail -q - To automatically use !bg - in ppp.linkup: + To automatically use !bg in + ppp.linkup: 1 provider: 2 delete ALL @@ -1264,8 +1227,8 @@ ifconfig_tun0= and then dial provider to start the PPP session, or, to configure - &man.ppp.8; to establish sessions automatically - when there is outbound traffic and there is no existing + &man.ppp.8; to establish sessions automatically when there + is outbound traffic and there is no existing start_if.tun0 script, type: &prompt.root; ppp -auto provider @@ -1324,8 +1287,7 @@ ifconfig_tun0= - Ensure that the - Ensure that the tunN device file is available in the /dev directory. @@ -1384,12 +1346,11 @@ ifconfig_tun0= using PPP over a modem connection. Some ISPs present the ssword prompt, and others will present - password; if the &man.ppp.8; - script is not written accordingly, the login attempt will - fail. The most common way to debug &man.ppp.8; - connections is by connecting manually. The following - information walks through a manual connection step by - step. + password; if the &man.ppp.8; script is not + written accordingly, the login attempt will fail. The most + common way to debug &man.ppp.8; connections is by connecting + manually. The following information walks through a manual + connection step by step. Check the Device Nodes @@ -1401,9 +1362,8 @@ ifconfig_tun0= The uart device is already included in the GENERIC kernel, so no - additional steps are necessary in this case. Just - check the &man.dmesg.8; output for the modem - device with: + additional steps are necessary in this case. Just check the + &man.dmesg.8; output for the modem device with: &prompt.root; dmesg | grep uart @@ -1420,19 +1380,18 @@ ifconfig_tun0= Connecting Manually Connecting to the Internet by manually controlling - &man.ppp.8; is quick, easy, and a great way to - debug a connection or just get information on how the + &man.ppp.8; is quick, easy, and a great way to debug a + connection or just get information on how the ISP treats &man.ppp.8; client connections. The following examples use example as the hostname of the - machine running &man.ppp.8;. To start - &man.ppp.8;: + machine running &man.ppp.8;. To start &man.ppp.8;: &prompt.root; ppp This sets the modem device to cuau1: - + ppp ON example> set device /dev/cuau1 This sets the connection speed to 115,200 @@ -1440,16 +1399,15 @@ ifconfig_tun0= ppp ON example> set speed 115200 - This tells &man.ppp.8; to configure the - resolver and add the nameserver lines to - /etc/resolv.conf. If - &man.ppp.8; cannot determine the hostname, it can - manually be set later. + This tells &man.ppp.8; to configure the resolver and add + the nameserver lines to + /etc/resolv.conf. If &man.ppp.8; cannot + determine the hostname, it can manually be set later. ppp ON example> enable dns - Switch to terminal mode to - manually control the modem. + Switch to terminal mode to manually + control the modem. ppp ON example> term @@ -1460,16 +1418,15 @@ type '~h' for help OK atdt123456789 - Use &man.at.1; to initialize the modem, - then type atdt and the number for the + Use &man.at.1; to initialize the modem, then type + atdt and the number for the ISP to begin the dial in process. CONNECT This message confirms the connection. If there are any connection problems, unrelated to hardware, this is the - time to - attempt to resolve them. + time to attempt to resolve them. ISP Login:myusername @@ -1479,25 +1436,23 @@ OK ISP Pass:mypassword - At this password prompt, - enter the password that was provided by the - ISP. Just like logging into - &os;, the password will not echo. + At this password prompt, enter the password that was + provided by the ISP. Just like logging + into &os;, the password will not echo. Shell or PPP:ppp Depending on the ISP, this prompt may never appear. If it does, it provides a choice to - use a shell on the provider or to start - &man.ppp.8;. This example chooses - to use &man.ppp.8; in order to create an Internet - connection. + use a shell on the provider or to start &man.ppp.8;. This + example chooses to use &man.ppp.8; in order to create an + Internet connection. Ppp ON example> - In this example, the first - has been capitalized. This indicates a successful - connection to the ISP. + In this example, the first has been + capitalized. This indicates a successful connection to the + ISP. PPp ON example> @@ -1508,15 +1463,14 @@ OK PPP ON example> - This indicates an IP - address has been assigned and the - connection has successfully completed. + This indicates an IP address has been + assigned and the connection has successfully completed. PPP ON example>add default HISADDR This adds a default route which is needed for successful - communication. Until this is added, the only - established connection is with the peer. If this fails due to + communication. Until this is added, the only established + connection is with the peer. If this fails due to existing routes, put a bang character (!) in front of the . Alternatively, set this before making the actual connection @@ -1529,8 +1483,8 @@ OK z. If PPP instead returns to ppp, the connection has been lost. An - uppercase P indicates a - connection to the ISP and a lowercase + uppercase P indicates a connection to the + ISP and a lowercase p indicates that the connection has been lost. &man.ppp.8; only has these 2 states. @@ -1541,12 +1495,12 @@ OK turn hardware flow CTS/RTS to off with . This can occur when connected to some PPP capable - terminal servers as &man.ppp.8; 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 + terminal servers as &man.ppp.8; 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. @@ -1558,20 +1512,19 @@ OK ISPs. This option may be needed for the Compuserve ISP. - &man.ppp.8; may not return to the - command mode, which is usually a negotiation error where - the ISP is waiting for your side to start + &man.ppp.8; may not return to the command mode, which + is usually a negotiation error where the + ISP is waiting for your side to start negotiating. At this point, using ~p - will force &man.ppp.8; to start - sending the configuration information. + will force &man.ppp.8; to start sending the configuration + information. 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 - &man.ppp.8; before going into terminal - mode: + &man.ppp.8; before going into terminal mode: ppp ON example> set authname myusername @@ -1605,8 +1558,8 @@ nameserver y.y.y.yIP address of the ISP's DNS servers. - To configure &man.syslog.3; to log - &man.ppp.8; connections, add: + To configure &man.syslog.3; to log &man.ppp.8; + connections, add: !ppp *.* /var/log/ppp.log @@ -1726,34 +1679,33 @@ ppp_profile="name_of_service_provider"PPPoE configuration entry in ppp.conf as the provider part of set device, as described in &man.ppp.8;. - It should look like - this: + It should look like this: set device PPPoE:xl1:ISP Do not forget to change xl1 to the proper device for the Ethernet card. + Do not forget to change ISP to the profile found above. For additional information, see Cheaper - Broadband with &os; on - DSL. + url="http://renaud.waldura.com/doc/freebsd/pppoe/">Cheaper + Broadband with &os; on + DSL. <acronym>PPPoE</acronym> with a &tm.3com; <trademark class="registered">HomeConnect</trademark> - <acronym>ADSL</acronym> - Modem Dual Link + ADSL Modem Dual Link This modem does not follow RFC 2516. - 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. @@ -1773,8 +1725,7 @@ ppp_profile="name_of_service_provider"PPPoE client or server and a &tm.3com; HomeConnect - ADSL - modem at the same time. + ADSL modem at the same time. @@ -1807,9 +1758,9 @@ ppp_profile="name_of_service_provider"/etc/usbd.conf to - enable this automatic firmware transfer. This file must be - edited as the root user. + added to /etc/usbd.conf to enable this + automatic firmware transfer. This file must be edited as + the root user. device "Alcatel SpeedTouch USB" devname "ugen[0-9]+" @@ -1823,9 +1774,8 @@ ppp_profile="name_of_service_provider"usbd_enable="YES" - It is also possible to set up - &man.ppp.8; to dial up at startup. To do - this add the following lines to + It is also possible to set up &man.ppp.8; to dial up at + startup. To do this add the following lines to /etc/rc.conf: ppp_enable="YES" @@ -1843,19 +1793,14 @@ ppp_profile="adsl" mpd can be used to connect to a variety of services, in particular passwd - services. - mpd can be installed from the - net/mpd5 package or port. - Many - ADSL modems require a - PPTP tunnel between the - modem and computer. One such modem is the Alcatel - &speedtouch; - Home. + services. mpd can be installed + from the net/mpd5 package + or port. Many ADSL modems require a + PPTP tunnel between the modem and computer. + One such modem is the Alcatel &speedtouch; Home. The installation of the port places a set of well - commented, sample - configuration files in /usr/local/etc/mpd5/. Copy mpd.conf.sample, removing the .sample extension, and edit it to suit the @@ -1863,8 +1808,7 @@ ppp_profile="adsl" guide in HTML format is installed to /usr/local/share/doc/mpd5/. - After saving the edits, - initialize the connection as + After saving the edits, initialize the connection as root: &prompt.root; service mpd5 start @@ -1909,8 +1853,7 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN The username of the account with the - DSL - provider. + DSL provider. @@ -1932,15 +1875,14 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN This will open a tunnel for a PPP session to the DSL router. Ethernet - DSL modems have a - preconfigured LAN IP - address to connect to. - In the case of - the Alcatel &speedtouch; Home, this address is 10.0.0.138. The router - documentation should indicate which address the device - uses. To open the tunnel and start a PPP - session execute the following command: + DSL modems have a preconfigured + LAN IP address to + connect to. In the case of the Alcatel &speedtouch; Home, + this address is 10.0.0.138. + The router documentation should indicate which address the + device uses. To open the tunnel and start a + PPP session execute the following + command: &prompt.root; pptp address adsl @@ -1953,10 +1895,10 @@ ng0: flags=88d1<UP,POINTOPOINT,RUNNIN A tun virtual tunnel device will be created for interaction between the - pptp and - &man.ppp.8; processes. Once the prompt is - returned, or the pptp process has - confirmed a connection, examine the tunnel: + pptp and &man.ppp.8; processes. + Once the prompt is returned, or the + pptp process has confirmed a + connection, examine the tunnel: &prompt.user; ifconfig tun0 tun0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 1500 @@ -1964,10 +1906,10 @@ tun0: flags=8051<UP,POINTOPOINT,RUNNI Opened by PID 918 If unable to connect, check the router configuration, - which is usually accessible via - &man.telnet.1; or a web browser. Examine - the output of pptp and the contents of - /var/log/ppp.log for clues. + which is usually accessible via &man.telnet.1; or a web + browser. Examine the output of pptp and + the contents of /var/log/ppp.log for + clues.