summaryrefslogtreecommitdiffstats
path: root/mdk-stage1/rp-pppoe/README
blob: 269fc16be14cd337c7c1c1afd0a7cae8c9cde567 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
pppoe: a PPP-over-Ethernet redirector for pppd
Copyright (C) 2001 Roaring Penguin Software Inc.

Much inspiration from an earlier client by Luke Stras.

The MSS clamping was inspired by mssclampfw by Marc Boucher <marc@mbsi.ca>
with acknowledgements to Rebel.com (http://www.rebel.com).  However, the
actual MSS clamping code is original and is licensed under the GPL, unlike
the original mssclampfw.

Introduction
============

pppoe is a user-space redirector which permits the use of PPPoE
(Point-to-Point Over Ethernet) with Linux.  PPPoE is used by many
ADSL service providers.

Installation
============

Requirements
------------

1) Linux 2.2.9 or later on Intel, Sparc or PowerPC.  It may work on
   Alpha, too -- anyone care to let me know?

	   OR

   Linux 2.0.36 or later.

	   OR

   FreeBSD, NetBSD or OpenBSD with BPF support.  I have access only
   to FreeBSD.  In general, I can't answer questions about the *BSD's
   as well as I can about Linux.


2) pppd 2.3.10 or later.  Versions 2.3.7 and later work unless you use
   demand-dialling.  For demand dialling, you *must* use 2.3.10 or later.

QUICKSTART
----------

If you're lucky, the "quickstart" method will work.  After unpacking
the archive, become root and type:

	./go

This should configure, compile and install the software and set up your
ADSL connection.  You'll have to answer a few questions along the way.

If you want the GUI wrapper, type:

	./go-gui

If ./go and ./go-gui didn't work, read the rest of this README.

Compiling
---------

Compile and install pppd if you don't already have it.  Then:

1) Unpack:

	$ tar xzvf rp-pppoe-xxx.tar.gz

2) Change to source directory:

	$ cd src

3) Configure:

	$ ./configure

4) Compile:

	$ make

4) Install (this step must be done as root)

	# make install

5) Now read doc/HOW-TO-CONNECT

--
David F. Skoll <dfs@roaringpenguin.com> | Roaring Penguin Software Inc.
http://www.roaringpenguin.com           | Linux and UNIX Specialists