---
name: "rgpsp"
section: "1"
platform: "linux"
package: "rgpsp"
version: "1.1.0.0-2"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/rgpsp"
---

# rgpsp(1)

remote system info polling tool

## 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 **r**emote **gps p**oller, 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 port

  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.

## /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 resolution 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, network code) and Felipe Bergo \<bergo@seul.org\> (Linux and FreeBSD ports).

## WEB SITE

http://gps.seul.org

## SEE ALSO

[**gps**(1x)](/gps/1x.md), [**ps**(1)](/ps/1.md), [**top**(1)](/top/1.md), [**named**(8)](/named/8.md)