INTENTION:

ppplog was written because I wanted to be able to start pppd from
commandline and I have to give up kppp. I missed the
accounting-functionality of kppp badly so I decided to write a
commandline-based accounting-tool. It is for use with Debian GNU/Linux
systems and works at least with pppd 2.4.0 (lower versions have not
been tested, but It should work with 2.3 too). One intention is to
give somthing back to the linux-community that supplied me with a
stable operating-system.


LICENSE: 

ppplog is licensed under the term of the GNU GENERAL PUBLIC LICENSE. 


CONTENT:

ppplog consists of 

- accounting
  a very tiny skript to be placed in /etc/ppp/ip-down.d that adds
  lines to logfiles in /var/log/ppplog for every ppp-connection. The
  logfiles are named YYYY-MM where YYYY is a 4-digit year and MM is a
  2-digit month.

- ppplog
  a tiny programm that reads the logfiles written by the accounting
  script and sums up the connect-times and produces a tabulated list
  of the connect-times, a sum for ever provider and a total sum.
  It should be placed somewhere in the path

- gnome/ppplog.desktop
  small gnome-desktop-file to bring up a gnome-terminal with class
  ppplog that shows the ppplog of this month. Could be used p.e. for a
  panel-menu.

- ppplogconvert (convert.c)
  small utility to convert older (pre 0.9) logfiles to the new
  format. (This solves the problems with timezones and strptime)


BUGS:

- very unspecific error-message if "parsing" failes.

- ambiguous output for connections that have lastet longer than 24h

- probably a lot more


INSTALLATION: 

- take a look at 'makefile'. In the first fwe lines you can alter
  destinations for installation.

- compile ppplog: A simple 'make' should do.

automatic:

- make install 

or by hand:
  
- create a directory .../ppplog writeable for pppd and readable
  for everyone that should be able lock at the logs.

- put accounting into /etc/ppp/ip-down.d

- put ppplog into the path.

convert old logfiles.

- If you want to access the old logs, you have to convert the old 
  logfiles using ppplogconvert. using bash p.e.: 

    for i in ????-??; do
      if [ ! -e $i.old ]; then
	mv -i $i $i.old
      else
	echo "$i.old already exists"
      fi
      ppplogconvert -f $i.old > $i
    done


THANKS:

to W. Crowshaw for testing, bugreports and proposals
