
                     gPS - Graphical Process Status
                             version 0.8.1
        (C) 1999-2000 Felipe Paulo Guazzi Bergo <bergo@seul.org>
                    Beat Christen <spiff@seul.org>

                       graphical ps-like applet

RELEASE INFORMATION
Please read the CHANGELOG file for information on changes
from release to release.

LICENSE:
 gPS is distributed under the terms of the GNU Public License, version 2
 or later. Read the file COPYING in this same directory for details.

FEATURES:
 * Process Filtering
 * Continuous refresh (top-like) mode
 * Information is grabbed directly from /proc filesystem
   (on Linux)
 * Easy sorting on any field
 * SIGKILL and SIGHUP signals    (0.2.1)
 * Renice'ing processes          (0.2.1)
 * Process details               (0.3.1)
 * POSIX signals                 (0.3.4)
 * CPU and memory usage          (0.4.1)
 * Process watching across
   a Network                     (0.5.1)
 * Process Tree view and
   signal multicasting           (0.6.1)
 * FreeBSD support (on the i386) (0.7.1)

HARDWARE/OS REQUIREMENTS:

 * Unix. Although gPS will provide more detailed information under
   Linux and FreeBSD/i386, now (from 0.5.x up) it may also gather
   information from the top program, so if you have a top program
   compatible with William LeFebvre's top, you may be able
   to run gPS.

 * X11 Server

 * GNU make (FreeBSD's make won't do it)

LIBRARY REQUIREMENTS
 * Gtk+ 1.2.1 or later release. It's available from www.gtk.org

 Notice: we're using GTK+ 1.2.6 for development, so if you experience
         strange behavior with GTK+ < 1.2.6, upgrading to 1.2.6
         is advised before reporting a bug. However, until gPS 0.5.2
         GTK+ 1.2.1 worked fine.

 * Gtk+ requires Gdk and Glib, which are available from www.gtk.org too.

If you are on a RedHat or RedHat-based distribution (Mandrake, Conectiva,
Independence, etc.) you'll need the glib, gtk, glib-devel and gtk-devel RPM
installed to compile. To install a binary RPM package of gPS you don't need
the -devel packages.

INSTALL DIRECTIONS
 Read the INSTALL file. It also contains information on uninstalling and
 installing over previous releases of gPS.

USING gPS

 To run gPS type:

  gps & 

 from a terminal window. For help, type:

  man gps

 If you aren't able to run gPS after it's been installed maybe gps's
 binary directory (usually /usr/local/bin if you didn't explicitly
 choose another one) is not in your PATH environment variable.

 General guidelines:

 * To sort on a field click on the column title. If you click it again
   it will sort in reverse order
 * For continuous refresh use the View menu or the -c command line option.
 * To filter do Filter|Set filter..."
 * The Close button on the bottom will exit gPS.

DOWNLOAD SITES:
 
 http://gps.seul.org                   (U.S.)
 http://www.dcc.unicamp.br/~guazzibe/gPS   (Brazil)

USEFUL SITES:

 http://www.gtk.org              - Gtk+Gdk+Glib, required libraries
 ftp://ftp.groupsys.com/pub/top  - William LeFebvre's top, required to
                                   run gPS on non-Linux systems.
                                   (try installing before downloading a
                                    new top, yours may be already
                                    compatible)

REPORTING BUGS:

 * When reporting unusual behavior / crashes (hope it doesn't happen!)
   please include the following information:

   - Operating System (e.g.: Linux, FreeBSD, Solaris...)
   - Kernel/OS version. (These two items can be obtained with the
                         command "uname -a" )
   - GTK+ version (This can be obtained with "gtk-config --version")

   If something strange is displayed, a screenshot is welcome. 
 
   If the problem is a crash and you are able to compile gPS with
   debugging options ( -ggdb ) and trace the crash point with
   gdb / xxgdb, this information is welcome too (screenshots of
   xxgdb at the crash point showing the "stack" output is still
   better).


Feedback is welcome. Enjoy!

---
bergo@seul.org
$Id: README,v 1.9 2000/04/15 14:12:30 bergo Exp $
