pppoem-0.2                                     Thomas Schmitt scdbackup@gmx.net

Pppoem monitors the DSL connection of a Linux kernel 2.4.4
by reading the files /proc/net/pppoe and /proc/net/dev .
(For older kernels one may skip /proc/net/pppoe by use
 of option -pretend "on" .)

There is a X11 version 'xpppoem' and a text only version 'pppoem'.

See files  pppoem_helptext  and  xpppoem_helptext  for details.
For the X11 version there also is a manpage xpppoem_dir/xpppoem.1


                            Installation

Unpack the software components by :

  tar xvzf pppoem-0.2.tar.gz


To compile the text version execute in the pppoem-0.2 directory :

  make

and afterwards copy the file pppoem to a directory where it can be found
by your shell. See output of : echo $PATH
Example (you will need to be superuser for that) :
  cp pppoem /usr/local/bin


To compile the X11 version execute 

  make xpppoem

and copy file xpppoem_dir/xpppoem  to a directory where it can be found
by your shell. Example :
  cp xpppoem_dir/xpppoem /usr/local/bin

Copy the file xpppoem_dir/XPppoem to the app-defaults directory. Example :
  cp xpppoem_dir/XPppoem /usr/X11R6/lib/X11/app-defaults

Copy the file xpppoem_dir/xpppoem.1 to the man1 directory of a directory
listed in variable $MANPATH. Example :
  cp xpppoem_dir/xpppoem.1 /usr/share/man/man1 


                              Usage examples

Monitor the DSL connection by text lines :

  pppoem

Monitor the DSL connection by text lines and a histogram window :

  xpppoem

Monitor the DSL connection by histogram window only :

  xpppoem -report off &

Monitor the DSL connection with typical xisdnload colors :

  xpppoem -report off -offline green -online red -busy off &

Monitor and log state changes in $HOME/dsl_logfile :

  xpppoem | tee -a -i $HOME/dsl_logfile

Monitor your LAN running on eth1 :

  pppoem -dev_name eth1 -pretend on

An empty window at the upper right corner of the screen indicating throughput
by color change from light blue to pink

  xpppoem -geometry 100x100-0+0 -nolabel -nograph \
          -report off -online '#8080ff' -busy '#ffa0a0' &

A remote pppoem reporting to a local xpppoem . You will possibly not see
the password prompt due to xpppoem's startup messages. Toggle in your
password as usual with your ssh connection.

  ssh thomas@ts2 pppoem -report forward | xpppoem -listen_stdin on -title ts2