KSermon Version 0.2.2
=====================

ksermon is an system-utility to watch the activities on a given serial
port. The current state of the TX,RX,CTS,RTS,DTR,DSR,DCD and RI lines are
shown by some kind of LEDs. Furthermore, the current TX/RX transfer rates
are visualisized using bars and within an osziloscope (this is nice to
analyse the transfer characteristics). Additionaly, the count of received
and transmitted data since programm start is displayed.

Also take a look at the homepage of ksermon:

http://www.lpr.e-technik.tu-muenchen.de/~kuhn/ksermon/



Usage
=====

As ksermon uses the session-management system from KDE, the user
has only to start the programm, and then choose the
device to observe from the Options->Preferences menu.
It is also possible to change the update interval and the
maximum displayed transfer-rate during runtime within the
Preferences



Compiling
=========

For proper compilation, you will have to install the kernel-patch included
in sermon-0.20; For proper execution, will have to recompile the kernel!

Then, just type "make", but be shure, that Qt and KDE are installed and
$QTDIR and $KDEDIR are set properly.

Type "make install" to install the binary and the Manual-pages (html).
Be sure that you are superuser, when doing this.

The program has been compiled for linux-2.0.33 and later, using the
GUI-Toolkit Qt 1.31 and sermon-0.20 from Peter Fox (fox@roestock.demon.co.uk).



Bugs
====

- Errors are displayed in the terminal, if the size to small
  to draw an osziloscope.
- Better start ksermon, before using a serial line (i.e. with kppp).
  Doing it vice verca may hang uo the line (don't know why).
- Sometimes ksermon needs the suid-bit set. This is the case,
  when the process using the serial line has suid (i.e. pppd).

Tell me, if you find more :-)



Copyright
=========

This program and documentation is copyright B. Kuhn
(kuhn@eikon.e-technik.tu-muenchen.de) and distributed under the GPL
(see COPYING).

Copyright notices are not to be removed or altered.



Warranty
========

There is NO WARRANTY for this program.

This program has been compiled on my machine using gcc 2.7.2, Qt 1.31,
sermon-0.20 and linux 2.0.33, and it seems to work for me.

Thanks
======

Thanks to Peter Fox for his excelent serial device extension !


Bernhard Kuhn

Tue Jan 13 01:58:28 MET 1998



History
=======

0.2 	inital version
0.2.1	minor bugfixes
0.2.2	smif: reopen line, when have been hunged up
	pref: set correct initial values for sliders
	oszi: pixmap-resize is done nicer now 
