Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-pppoe.mdwn
1 \r
2 \r
3 ## 18.5 Using PPP over Ethernet (PPPoE) \r
4 \r
5 ***Contributed (from http://node.to/freebsd/how-tos/how-to-freebsd-pppoe.html) by Jim Mock. ***\r
6 \r
7 This section describes how to set up PPP over Ethernet (PPPoE).\r
8 \r
9 ### 18.5.1 Configuring the Kernel \r
10 \r
11 No kernel configuration is necessary for PPPoE any longer. If the necessary netgraph support is not built into the kernel, it will be dynamically loaded by  **ppp** .\r
12 \r
13 ### 18.5.2 Setting Up `ppp.conf` \r
14 \r
15 Here is an example of a working `ppp.conf`:\r
16 \r
17     \r
18     default:\r
19       set log Phase tun command # you can add more detailed logging if you wish\r
20       set ifaddr 10.0.0.1/0 10.0.0.2/0\r
21     \r
22     name_of_service_provider:\r
23       set device PPPoE:`***xl1***` # replace xl1 with your ethernet device\r
24       set authname YOURLOGINNAME\r
25       set authkey YOURPASSWORD\r
26       set dial\r
27       set login\r
28       add default HISADDR\r
29 \r
30 \r
31 ### 18.5.3 Running  **ppp**  \r
32 \r
33 As `root`, you can run:\r
34 \r
35     \r
36     # ppp -ddial name_of_service_provider\r
37 \r
38 \r
39 ### 18.5.4 Starting  **ppp**  at Boot \r
40 \r
41 Add the following to your `/etc/rc.conf` file:\r
42 \r
43     \r
44     ppp_enable="YES"\r
45     ppp_mode="ddial"\r
46     ppp_nat="YES"       # if you want to enable nat for your local network, otherwise NO\r
47     ppp_profile="name_of_service_provider"\r
48 \r
49 \r
50 ### 18.5.5 Using a PPPoE Service Tag \r
51 \r
52 Sometimes it will be necessary to use a service tag to establish your connection. Service tags are used to distinguish between different PPPoE servers attached to a given network.\r
53 \r
54 You should have been given any required service tag information in the documentation provided by your ISP. If you cannot locate it there, ask your ISP's tech support personnel.\r
55 \r
56 As a last resort, you could try the method suggested by the [Roaring Penguin PPPoE](http://www.roaringpenguin.com/pppoe/) program which can be found in the [pkgsrc.html pkgsrc collection]. Bear in mind however, this may de-program your modem and render it useless, so think twice before doing it. Simply install the program shipped with the modem by your provider. Then, access the System menu from the program. The name of your profile should be listed there. It is usually ***ISP***.\r
57 \r
58 The profile name (service tag) will be used in the PPPoE configuration entry in `ppp.conf` as the provider part of the `set device` command (see the [ppp(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#ppp&section8) manual page for full details). It should look like this:\r
59 \r
60     \r
61     set device PPPoE:`***xl1***`:`***ISP***`\r
62 \r
63 \r
64 Do not forget to change `***xl1***` to the proper device for your Ethernet card.\r
65 \r
66 Do not forget to change `***ISP***` to the profile you have just found above.\r
67 \r
68 For additional information, see:\r
69 \r
70
71 * [Cheaper Broadband with FreeBSD on DSL](http://renaud.waldura.com/doc/freebsd/pppoe/) by Renaud Waldura.\r
72
73 * [Nutzung von T-DSL und T-Online mit FreeBSD](http://www.ruhr.de/home/nathan/FreeBSD/tdsl-freebsd.html) by Udo Erdelhoff (in German).\r
74 \r
75 ### 18.5.6 PPPoE with a 3Com® HomeConnect® ADSL Modem Dual Link \r
76 \r
77 This modem does not follow [RFC 2516](http://www.faqs.org/rfcs/rfc2516.html) (***A Method for transmitting PPP over Ethernet (PPPoE)***, written by L. Mamakos, K. Lidl, J. Evarts, D. Carrel, D. Simone, and R. Wheeler). Instead, different packet type codes have been used for the Ethernet frames. Please complain to [3Com](http://www.3com.com/) if you think it should comply with the PPPoE specification.\r
78 \r
79 In order to make DragonFly capable of communicating with this device, a sysctl must be set. This can be done automatically at boot time by updating `/etc/sysctl.conf`:\r
80 \r
81     \r
82     net.graph.nonstandard_pppoe=1\r
83 \r
84 \r
85 or can be done for immediate effect with the command `sysctl net.graph.nonstandard_pppoe=1`.\r
86 \r
87 Unfortunately, because this is a system-wide setting, it is not possible to talk to a normal PPPoE client or server and a 3Com® HomeConnect® ADSL Modem at the same time.\r
88 \r
89 \r
90 \r
91 CategoryHandbook\r
92 CategoryHandbook-pppandslip\r