YAWMPPP version 2.0.2 Yet Another PPP Window Maker dock applet (C) 2000 Felipe Bergo Table of Contents Overview Requirements Installing Features Files Reporting Bugs Usage Hints Programs Interface Guide Window Manager Placement Configuration DNS Servers Modem Ports Login/Password expects Trouble? More Documentation Overview -------- YAWMPPP sits in Window Maker's dock (or AfterStep's Wharf, or keeps standing as a 64x64 window with other Window Managers) and manages PPP connections. For window managers not capable of docking yawmppp also provides a bar shaped version (yawmppp.thin). It includes a GUI to easily setup your ISP entries, so that you don't need to edit CHAT scripts. YAWMPPP is distributed under the terms of the GNU General Public License, version 2 or later (at your choice). A copy of the license is provided in the file COPYING in this same directory. Requirements ------------ YAWMPPP is known to run on Linux (tested with 2.2 kernels) and FreeBSD (tested with 3.4-RELEASE) and has been reported to work with NetBSD 1.5. You'll need: - root access to install YAWMPPP - A kernel with PPP support compiled in. - pppd, the ppp daemon, installed in /usr/sbin/pppd (currently this path mandatory for the builtin scripts to work). If you wish to use YAWMPPP as non-root pppd must have the setuid bit set. The RedHat installation already brings this set. Version 2.3.11 or newer is recommended. - the "chat" program (usually included in the pppd package, comes with the FreeBSD distribution too). - GTK+ 1.2.1 or greater. 1.2.6 recommended. If you don't have it you can grab it from http://www.gtk.org Remember to get the GLib too (needed by GTK+). On RedHat-based systems (RedHat itself, Mandrake, Conectiva, Independence, etc.) you'll need these packages installed to compile YAWMPPP: glib-1.2.x glib-devel-1.2.x gtk+-1.2.x gtk+-devel-1.2.x Author: Felipe Bergo , who built YAWMPPP using code from the WMPPP application developed by Martijn Pieterse and Antoine Nulle. YAWMPPP's web page is located at http://yawmppp.seul.org For more information on WMPPP see http://windowmaker.mezaway.org Installing ---------- Read the file INSTALL for instructions. Be sure to read this file entirely before using YAWMPPP Features -------- YAWMPPP features all things the standard pppd offers and gives you some additional amusements: * Integrated online timer; * Integrated modem RX/TX LED's; * Integrated YAWMPPP status LED; * Integrated autoscaling PPP transfer statistics; * Integrated bytes/second Speed-O-Meter; * Automatic detection of active ppp interfaces; * Several commandline options (try '-h' for help); * Easy ISP configuration GUI * Multiple ISP entries support * Logging facility with GUI viewer Files ----- README This file. INSTALL Installation instructions. CHANGELOG Description of changes. COPYING GNU General Public License Version 2. FAQ Frequently Asked Questions Reporting Bugs -------------- If you discover any bugs in this software, please send a bug report to bergo@seul.org and describe the problem as detailed as you can. Usage Hints ----------- First of all: you can type "man yawmppp" for help at the command line. Programs: --------- yawmppp - The PPP dock applet yawmppp.thin - A PPP applet for non dock-capable window managers (e.g. Enlightenment, Sapphire...) yawmppp.pref - The Dialing setup tool (can be run from yawmppp by clicking the left mouse button in the display area) yawmppp.log - The log view tool (can be run from yawmppp by clicking the middle or right mouse buttons in the display area) Interface guide (yawmppp) ------------------------- Please, don't laugh at the drawing. +-----------------------------+ A : Connection timer |+---------------------------+| ||AAAAAAAAAAA BB CC DD || B : RX LED (blinks when PPP packets ||AAAAAAAAAAA BB CC DD || are received) || || ||EEEEEEEEEEEEEEEEEEEEEEEEEEE|| C : TX LED (blinks when PPP packets ||EEEEEEEEEEEEEEEEEEEEEEEEEEE|| are sent) ||EEEEEEEEEEEEEEEEEEEEEEEEEEE|| ||EEEEEEEEEEEEEEEEEEEEEEEEEEE|| D : ON/OFF LED: dark when there is no || || active connection, GREEN if ||FFFFFFFFFF GGGGGGGGGGGGG|| the connection is up, YELLOW ||FFFFFFFFFF GGGGGGGGGGGGG|| while dialing, RED on error. |+---------------------------+| |+-----++-----+ +-----++-----+| E : Speed history || || | | || || || < || > | | V || X || F : ISP entry name (short) || || | | || || |+-----++-----+ +-----++-----|| G : Connection speed, speed-o-meter, +-----------------------------+ error messages < : selects prior ISP. You can't change the ISP entry while online > : selects next ISP. V : connects to currently selected ISP X : closes current connection. You can click the display area with the left mouse button to open the ISP configuration tool (yawmppp.pref) or with any other mouse button to open the connection log viewer (yawmppp.log). Window Manager Placement ------------------------ Window Maker: Window Maker users simply drag and drop YAWMPPP on the WindowMaker Dock or the Clip. Press the right mouse button on YAWMPPP's outer edges and select "Settings..." from the popup menu that appears. Enable the 'Start when WindowMaker is started' option, then click on the 'OK' button in the Docked Applications Panel. AfterStep: Afterstep users put something like this in their Wharf rc file "Wharf yawmppp - MaxSwallow "yawmppp" yawmppp &" (this should be somewhere under ~/GNUstep/Library/AfterStep) Elsewhere: For other windowmanagers, YAWMPPP runs nicely as a 64x64 pixel shaped icon on your desktop. You may prefer to run yawmppp.thin when not using Window Maker or AfterStep. Configuration ------------- YAWMPPP's configuration files stay beneath ~/.yawmppp2, which will be created as soon as you run yawmppp for the first time. The main configuration file is yawmppprc. You should use the yawmppp.pref application to create your entries. If you're willing to edit entries by hand, create some bogus entries with yawmppp.pref and take a look at the generated files for hints. It should be easy to figure out. The format has changed since YAWMPPP 1.x.x, thus the directory has changed (from ~/.yawmppp to ~/.yawmppp2). Don't try copying files between 1.x.x and 2.x.x versions. Modem ports ----------- On Linux the serial ports are (or at least should be :-) ): /dev/cua0 _or_ /dev/ttyS0 : DOS' COM1 /dev/cua1 _or_ /dev/ttyS1 : " COM2 /dev/cua2 _or_ /dev/ttyS2 : " COM3 /dev/cua3 _or_ /dev/ttyS3 : " COM4 If you don't know where your modem is, type dmesg | grep tty It should print something like ttyS00 at 0x03f8 (irq = 4) is a 16550A ttyS01 at 0x02f8 (irq = 3) is a 16550A ttyS02 at 0x03e8 (irq = 4) is a 16550A If it shows the wrong irq to you, add a setserial command to one of your boot time scripts (maybe /etc/rc.d/rc.local) like: /bin/setserial /dev/ttyS2 irq 10 See "man setserial" for more information. On FreeBSD the dialout serial ports are /dev/cuaa0 (kernel interface sio0) /dev/cuaa1 (kernel interface sio1) /dev/cuaa2 (kernel interface sio2) /dev/cuaa3 (kernel interface sio3) If it fails to recognize your modem's port, or gives it the wrong IRQ, you have to compile a new kernel with the correct settings. Read the FreeBSD handbook if don't know how to do this (/usr/share/doc/books/handbook) Login/Password Expects ---------------------- The supplied expects for login and password are rather common, but if it fails, connect to your ISP using a standard communication program (like minicom) and watch what the ISP sends to ask for login and password. Trouble? -------- Read the FAQ in this same directory. More Documentation ------------------ Linux users can read the ISP-Hookup and PPP howtos. These howtos are available from http://sunsite.unc.edu/LDP/HOWTO/ If you are on a major Linux distribution the HOWTOs should be installed. Try looking beneath /usr/doc. You may also get the ppp source and read the FAQ included, it is at ftp://cs.anu.edu.au/pub/software/ppp