www.Lucq.org

Supporting ADSL technology under OpenBSD

Introduction and disclaimer

This page deals with setting up and using ADSL connections under OpenBSD. It is the result of some personal experience in this area, discussions with other people, and information found on the Internet. If you feel something is incorrect, or if you think you have useful information which should be on this page, feel free to drop me a note.

Also, I cannot be held responsible for direct or indirect damage or any other consequence of using, or not using, or using incorrectly, the information contained on this page. Further, I also cannot be held responsible for the content on pages I link to.

Problem description

In order to use a typical ADSL connection, two problems need to be solved. First of all, you need to have some sort of ADSL modem, to perform the physical signal modulation and line handling. Secondly, usually some form of authentication will be needed in order to use the connection, and you will need to have software capable of performing this authentication on your platform.

ADSL Modems

The problem with different ADSL modems is whether or not you need a specific software driver on your platform in order to be able to use the modem, and whether or not such a driver exists for OpenBSD.

Ethernet bridges

Ethernet-bridging modems are a first type of ADSL modem. These modems are external modems, that bridge an ethernet connection over an ADSL line. In other words, all you have to do is connect your machine or network via the ethernet connection to the modem, and plug the ADSL line into the modem. The advantage is that no specialized driver is needed for this type of modem, so in principle all modems in the class should be usable with OpenBSD.

Manufacturer Modem Status Links
Alcatel SpeedTouch Home
Fully functional (this is the modem I use at home). Note that this modem can also be used as a mini-router with integrated NAT-box. Please check the “Routers, DSL firewalls, and related devices” section.

Routers, DSL firewalls, and related devices

These devices act as non-transparent gateways for your network or machine. Simply plug your network into the device via an ethernet interface, and the device handles all the other details. Since no driver is needed, they are also fully compatible with OpenBSD. Beware though, that the device must be able to interface with the chosen authentication method of your ADSL provider (e.g. if your ADSL provider requires you to use PPTP for authentication purposes, the device you purchase must be able to use this method).

Manufacturer Modem Status Links
Alcatel SpeedTouch Home
Fully functional. This is actually the same modem as in the “Ethernet bridges” section, but used as a mini-router.
Check the entry for this modem in the “Ethernet bridges” section.
Alcatel SpeedTouch Pro
Fully functional (I manage several networks of OpenBSD machines behind this type of modem at work).
Linksys BEFSR11, BEFSR41, BEFSR41W, BEFSR81 Fully functional.

USB modems

This type of modem connects via USB to your machine. In other words, you do not need a separate network card to connect to this type of modem. The downside, however, is that you need a software driver compatible with your operating system for this type of modem.

Manufacturer Modem Status Links
Alcatel SpeedTouch USB
This modem used to be a problem since the Linux driver provided by Alcatel was (partially) closed-source. However, an open-source driver for BSD is now available at http://speedtouch.sourceforge.net/

PCI modems

(under construction)

Authentication

(under construction)

Specific ADSL providers

Provider Links Comments
Belgacom Turboline (Belgium) local
How to set up a Belgacom Turboline ADSL connection using PPPoE and an external Alcatel SpeedTouch Home modem.
Inode (Austria) https://project.packetst0rm.net/openbsd_adsl/openbsd-adsl-howto.html
Deals with making a PPTP-based connection using Alcatel modems. Also see the OpenBSD FAQ, section 6.9.
Verizon (USA) http://www.princeton.edu/~ferguson/adw/pppoe.shtml
PPPoE with Verizon (formerly Bell-Atlantic) ADSL.
Sympatico (Canada) http://real.ath.cx/BSDinstall.html
Detailed set-up instructions for an OpenBSD ADSL gateway with PPPoE and Sympatico ADSL.
Earthlink (USA) http://home.sprynet.com/~minaret/pppoe/
PPPoE using the Roaring Pengiun PPPoE client and Earthlink ADSL.
KPN MxStream (Netherlands) http://www.xs4all.nl/~rbdebeer/
Set up a KPN MxStream ADSL connection using PPTP. Note that this page is in Dutch.
T-Online T-DSL (Germany) http://www.3d-crew.com/unixtexte/openbsd/HOWTO_-_T-DSL_Router_mit_OpenBSD_3_0.html
Set up a T-Online T-DSL connection using PPPoE. Note that this page is in German.

Other links

http://www.thought.net/jason/pppoe/
Jason Wright's OpenBSD userland PPPoE client. As of OpenBSD 2.8, this client is included with the base operating system.
http://www.roaringpenguin.com/pppoe/
The Roaring Penguin PPPoE client.