rgpsp - remote system info polling tool

rgpsp [-p port] [--nodaemon] [ip address] [...]

rgpsp [-h | -v]

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.

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

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.

rgpsp has ports to Linux and FreeBSD/i386.

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 resolution daemon you prefer) before running rgpsp. A SysV init script should have been installed as /etc/rc.d/init.d/rgpsp

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.

/etc/rgpsp.conf /usr/local/doc/gps-1.0.0 /etc/rc.d/init.d/rgpsp

rgpsp was written by Beat Christen <spiff@seul.org> (basic idea, network code) and Felipe Bergo <bergo@seul.org> (Linux and FreeBSD ports).

http://gps.seul.org

gps(1x), ps(1), top(1), named(8)