wmDownload v0.1.2

A WindowMaker dock app written fully in C using the dockapp library
written by Alfredo K. Kojima (required).
wmDownload monitors and displays how much data the user has recieved
on each device since the last machine reboot.


LICENSE

This program is licensed under the terms of the GNU GPL, a copy
of which you should have received with this package.


INSTALLATION:

(I release the source code only.  If you have a binary distribution 
 then see the person you recieved it from for how to do a manual 
 install.)

1. Type 'make' and in theory it will build. If you are using a non-GNU system,
   such as FreeBSD or Solaris, you will need the GNU version of make, often
   installed as `gmake'.
2. As Root: Type 'make install' and wmDownload will be installed (defaults to 
   /usr/bin).

As each user:
3. Type wmDownload and the dockable icon should appear.

wmDownload requires the following:
Some C compiler with proper standard c headers capable of implementing the long long
data type.
Alfredo K. Kojima's dockapp library.

wmDownload has been compiled and run successfully on the following systems at one 
point:
Linux/x86 - under Redhat 6.0, 6.1 and 6.2

CONFIGURATION:

No configuration files needed or used at this point in time.  This may
change.

The program goes through your /proc/net/dev and finds how many eth and ppp devices
you have on your system.  This info is used internally to decide what devices to 
cycle through.


USE:

Type wmDownload -h for commandline help.

Using wmDownload is fairly straight-forward.  wmDownload itself is merely a monitoring
program that reads in the info it needs from /proc/net/dev and translates
that info into the three sets of numbers that appear in the dockapp.
The top row indicates how many gigabytes worth of data you've downloaded, the middle
indicates the number of megabytes and the bottom is the number of kilobytes.

In order to switch the display from a decimal to hexadecimal base, right-click on the dockapp.


PROBLEMS:

See the BUGS file for reports on known bugs and problems.
Good luck.


CONTACTS:

Send any questions, comments, or bug reports to who2go2@hotmail.com
