# tkpppoe - A GUI for managing PPPoE Connections

# Introduction

TkPPPoE is a graphical user interface for managing PPPoE connections. It performs two different functions:

- TkPPPoE lets you define connection properties. This step must be done as root.
- TkPPPoE lets you start and stop PPPoE connections. This step may be done as a normal user, depending on how you configured the connection.

# Defining Connections

To define connections, start TkPPPoE as root. You can do this from a terminal by typing `tkpppoe`, or from the KDE or GNOME menus by selecting Internet : TkPPPoE. The following window pops up:

Because you have not yet defined any connections, the connection property window also pops up:

You can pop up the connection property window at any time by clicking New Connection... You can edit the properties of an existing connection by selecting the connection's name and clicking Properties...

#### Basic Information

Let's fill in the basic information:

- For Connection Name, enter a unique name for this connection. It can be anything you like, but must contain only letters, numbers, underscores or dashes. In particular, it can't contain spaces. If you have only one PPPoE connection, a good name is Default.
- For User Name, enter the user name supplied by your ISP. Enter only the user name; do not enter an "@isp.com" part.
- For Network, you may have to enter your ISP's domain name. (For example, isp.com.) Some DSL providers add this to your user name; others do not. You may have to experiment a bit. The two most likely choices are your ISP's domain name, or blank. Try both.
- For Password, enter the password your ISP provided you with.

#### NIC and DNS

Click on the NIC and DNS tab:

- For Ethernet Interface, enter the Ethernet interface connected to the DSL modem. It is something like eth0 or eth1. Click on ... to browse a list of detected Ethernet interfaces.
- For DNS Setup, you have three options:
  1. From Server means that the system will obtain DNS information from the PPPoE server. This is the correct choice for most ISPs.
  2. Specify means that you will enter the IP addresses of your DNS servers manually. In this case, enter the addresses in the Primary DNS and Secondary DNS entries.
  3. Do not Adjust means that you want RP-PPPoE to leave your DNS setup alone. Use this if you are running your own caching DNS server or know that you don't want the DNS setup touched.

#### Options

Click on the Options tab:

- If you want ordinary users to be able to start and stop this connection, enable Allow use by non-root users. If you do not enable this, non-root users will be able to monitor the connection, but not control it.
- If you want to use synchronous PPP, enable Use synchronous PPP. This is recommended as it conserves CPU usage, but may not work on some (misconfigured) Linux kernels.
- For Firewalling, you have three options:
  1. Stand-Alone installs a simple firewall ruleset for stand-alone machines. Use this if you have only a single computer connected to the DSL modem.
  2. Masquerading installs a simple firewall ruleset for using your Linux computer as an Internet sharing device. If you have two Ethernet cards, you can connect one card to the DSL modem and the other to an internal LAN. The masquerading firewall ruleset lets internal machines share the DSL connection.
  3. None. If you already have your own firewall rules, or you wish to run servers on your machine, select None. This is not recommended unless you take steps to secure your machine, and know what you are doing.

#### Advanced

Click on the Advanced tab:

In most cases, you can leave AC-Name and Service-Name blank. In some cases, your ISP may require you to enter information in these fields; contact your ISP for more information.

# Controlling Connections

For these examples, run `tkpppoe` as a normal user (not root). The main window appears like this:

- To start a connection, press Start. The two LEDs flash red and grey. If the connection is established, they turn green.
- To stop a connection, press Stop.

The two rectangles to the right of the connection name are the status LEDs. The top LED corresponds to transmitted data and the bottom to received. The LEDs are colored as follows:

- Grey -- connection is not established.
- Flashing red/grey -- connection is being started.
- Green -- connection is up, but idle.
- Yellow -- connection is up and data is being sent or received.
- Red -- connection has been lost, but the system is trying to reestablish it.

When a connection is established, two graphs appear:

The left (red) graph shows transmitted packets and the average transmission speed (in bits per second) over the sample time. The right (green) graph shows received packets.

# Miscellaneous Information

- The connection menu has an entry called User's Manual which will pop up this user manual (if you have Netscape installed.)
- You can define multiple PPPoE connections, but you should not use more than one simultaneuously unless you feel comfortable editing scripts and setting up routing tables. By default, TkPPPoE tries to add a default route for connections. This does not work well with multiple simultaneous connections.
- If you exit from TkPPPoE, connections which are up remain up. You have to explicitly stop connections if you want them terminated.

TkPPPoE is Copyright 2001 by Roaring Penguin Software Inc and is licensed under the GNU General Public License.

Screenshots show TkPPPoE running under the XFCE desktop, a lightweight UNIX and Linux desktop.