From owner-freebsd-doc Sat May 18 8: 0:20 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id CA0CC37B40F for ; Sat, 18 May 2002 08:00:03 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g4IF03B84783; Sat, 18 May 2002 08:00:03 -0700 (PDT) (envelope-from gnats) Received: from host217-41-15-143.in-addr.btopenworld.com (host217-41-15-143.in-addr.btopenworld.com [217.41.15.143]) by hub.freebsd.org (Postfix) with ESMTP id 7DD6A37B404 for ; Sat, 18 May 2002 07:54:42 -0700 (PDT) Received: by host217-41-15-143.in-addr.btopenworld.com (Postfix, from userid 1001) id E39FD2A0; Sat, 18 May 2002 15:54:42 +0100 (BST) Message-Id: <20020518145442.E39FD2A0@host217-41-15-143.in-addr.btopenworld.com> Date: Sat, 18 May 2002 15:54:42 +0100 (BST) From: Dominic Marks Reply-To: Dominic Marks To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/38245: Addition to PPP handbook chapter Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 38245 >Category: docs >Synopsis: Addition to PPP handbook chapter >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sat May 18 08:00:02 PDT 2002 >Closed-Date: >Last-Modified: >Originator: Dominic Marks >Release: FreeBSD 4.6-RC i386 >Organization: Student >Environment: System: FreeBSD gallium 4.6-RC FreeBSD 4.6-RC #4: Thu May 16 22:38:19 BST 2002 dom@gallium:/usr/obj/usr/src/sys/GALLIUM i386 >Description: Extend the PPPoA section I contributed previously with a guide to using mpd as an alternative to pptpclient. >How-To-Repeat: NA. >Fix: Since jade and openjade coredump when trying to build the handbook (yes, all my docproj stuff is fresh) I haven't been able to test this throughly. Although I have had keramida@ review it (briefly). However decides to commit this, please do a test build first. Thanks! Index: chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v retrieving revision 1.75 diff -u -r1.75 chapter.sgml --- chapter.sgml 2002/05/09 21:04:21 1.75 +++ chapter.sgml 2002/05/18 14:49:06 @@ -2127,6 +2127,93 @@ instructions provided with it. + + Using mpd + + 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. + + First you must install the port, and then you can configure + mpd to suit your requirements and + provider settings. The port places a set of sample configuration + files which are well documented in + PREFIX/etc/mpd/. + Note here that PREFIX means the directory + into which your ports are installed, this defaults to + /usr/local/. A complete guide to to + configuring mpd is available in HTML + format once the port has been installed. It is placed in + PREFIX/share/mpd/. + Here is a sample configuration for connecting to an ADSL service + with mpd. The configuration is spread + over two files, first the mpd.conf. + + default: + load adsl + +adsl: + new -i ng0 adsl adsl + set bundle authname username + set bundle password password + set bundle disable multilink + + set link no pap actcomp protocomp + set link disable chap + set link accept chap + set link keep-alive 30 10 + + set ipcp no vjcomp + set ipcp ranges 0.0.0.0/0 0.0.0.0/0 + + set iface route default + set iface disable on-demand + set iface enable proxy-arp + set iface idle 0 + + open + + + + The username used to authenticate with your ISP. + + + The password used to authenticate with your ISP. + + + + The mpd.links file contains information + about the link, or links, you wish to establish. An example + mpd.links to accompany the above example is + given beneath. + + adsl: + set link type pptp + set pptp mode active + set pptp enable originate incoming outcall + set pptp self 10.0.0.140 + set pptp peer 10.0.0.138 + + It is possible to initialise the connection easily by issuing + the following command as root. + + &prompt.root; mpd -badsl + + You can see the status of the connection with the following + command. + + &prompt.user; ifconfig ng0 +ng0: flags=88d1<UP,POINTOPOINT,RUNNING,NOARP,SIMPLEX,MULTICAST> mtu 1500 + inet 216.136.204.117 --> 204.152.186.171 netmask 0xffffffff + + Using mpd is the recommended way to + connect to an ADSL service with &os;. + + + Using pptpclient @@ -2147,16 +2234,16 @@ set log phase chat lcp ipcp ccp tun command set timeout 0 enable dns - set authname username - set authkey password + set authname username + set authkey password set ifaddr 0 0 add default HISADDR - + The username of your account with the DSL provider. - + The password for your account. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message