RGPSP(1) User Manuals RGPSP(1)NAME
rgpsp - remote system info polling tool
SYNOPSIS
rgpsp [-p port] [--nodaemon] [ip address] [...]
rgpsp [-h | -v]
DESCRIPTION
This man page documents the rgpsps that accompanies gps version 1.0.1.
rgpsp provides a top-like output through a tcp port, so that remote
machines may gather information about processes and load on the machine
rgpsp is running on.
rgpsp is on most cases a symbolic link to a real poller which will have
other name and depends on the machine's OS.
It is distributed together with gps (1x), which is able to read rgpsp
information and display it graphically in a multitude of ways. See
gps's man page for details.
rgpsp stands for remote gps poller, and gps stands for Graphical
Process Statistics.
COMMAND-LINE OPTIONS
--nodaemon
by default rgpsp runs in daemon mode: it will put itself in
background and write messages and errors to the syslog facility.
In nodaemon mode it will write messages and errors to stderr
instead.
-p listens for connections on TCP port port. When not specified it
will listen to port 24374.
IP addresses
These specify the adresses of client machines allowed to connect
(e.g., the IP of machines running gps). These addresses are
appended to those configured in the /etc/rgpsp.conf file. If no
hosts are in the list (empty /etc/rgpsp.conf and no IPs on com‐
mand line) then any machine may connect. Addresses should be
provided in standard dot notation, e.g., 127.0.0.1 ,
200.246.30.44. The exclamation line in /etc/rgpsp.conf may
inhibit all IP addresses given in the command line.
-v or -h
Displays version information and exits.
/etc/rgpsp.conf
The hosts allowed to connect may be specified in the /etc/rgpsp.conf
file. The configuration file is straightforward:
one address per line. Both hostnames and dot notation IPs are allowed,
but IPs are preferred.
a line starting with an asterisk (*) tells rgpsp to allow any host to
connect, despite any other configurations.
a line starting with an exclamation (!) tells rgpsp not to accept IP
addresses from the command line.
lines starting with # are comments, ignored by rgpsp.
PORTABILITY
rgpsp has ports to Linux and FreeBSD/i386.
CAVEATS
If you are going to run rgpsp on system startup and have hostnames in
the /etc/rgpsp.conf, don't forget to run named (or whichever DNS reso‐
lution daemon you prefer) before running rgpsp. A SysV init script
should have been installed as /etc/rc.d/init.d/rgpsp
UNRESTRICTIONS
rgpsp is free; anyone may redistribute copies of rgpsp to anyone under
the terms stated in the General Public License. A copy of the license
accompanies each copy of rgpsp.
FILES
/etc/rgpsp.conf /usr/local/doc/gps-1.0.0 /etc/rc.d/init.d/rgpsp
AUTHORS
rgpsp was written by Beat Christen <spiff@seul.org> (basic idea, net‐
work code) and Felipe Bergo <bergo@seul.org> (Linux and FreeBSD ports).
WEB SITE
http://gps.seul.org
SEE ALSOgps(1x), ps(1), top(1), named(8)Unix March 2002 RGPSP(1)