File: README

package info (click to toggle)
gps 1.1.0.0-2
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 1,212 kB
  • ctags: 987
  • sloc: cpp: 11,600; sh: 381; makefile: 319; ansic: 227; perl: 17
file content (141 lines) | stat: -rw-r--r-- 4,827 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

                     gPS - Graphical Process Status
                             version 1.1.0
        (C) 1999-2002 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)
 * command-line process killing
   with a multitude of filtering
   options, featuring the best
   Unix pipes can provide.       (0.9.1)
 * [Linux] SMP CPU monitoring    (0.9.3)
 * xload/gkrellm-like graph 
   mode (-qb)                    (0.10.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.

OS-Specific issues:
gPS's native platform is Linux. For issues on running on other
platforms, see the files README.FreeBSD and README.Solaris.

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.)

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 systems without
                                   native support (Linux and FreeBSD have
                                   native support)
                                   (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, Uzix...)
   - 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 even
   better).


Feedback is welcome. Enjoy!

If you are including gPS in a CD distribution (be it for a magazine
or for a major OS distro) I'd like to know! If you can send
me a copy of the magazine issue I'd be very thankful, contact me by
email to get my (snail) mail address.

---
bergo@seul.org
$Id: README,v 1.19 2002/04/28 19:33:21 bergo Exp $