SATELLITE(8)

NAME
satellite - inform server of current ip address

SYNOPSIS

satellite [ -h ]

satellite [ -v ] [ -f file ] [ -p port ] [ -m message ] host token [ secret ]

DESCRIPTION
satellite is used to keep a server aware of a client's IP address. To notify the server run satellite everytime you connect to the net. If you are using pppd(8) you can add the command to /etc/ppp/ip-up or /etc/ppp/ip-up.local. If you don't want the secret on the command line you can hide it in a configuration file (see satcfg(8)).

OPTIONS

  -h
Show brief help and exit.

  -v
Verbose. Normally nothing is shown on success which is useful when running satellite from crond(8) or other mail happy systems.

  -f file
Use a different configuration file. This can be useful when the secret is omitted. The default is /usr/local/etc/satellite.db.

  -p port
Port number to use when contacting the remote server. The default is found in /etc/services if possible, otherwise 1764 is used.

  -m message
Send a message to be logged along with the IP address. The message is not encrypted and shouldn't be used for sending sensitive information. Messages should be kept short, satellite is not intended for general purpose communication.

  host token [ secret ]
Contact host using token. host can be a dotted quad address or a hostname. Using a hostname will let you move the server easily, but adds an extra layer (DNS) that can fail. If secret is omitted, find the corresponding secret from the configuration file. The configuration file has restrictive permissions by default. If you omit secret make sure satellite can read the configuration file.

FILES
/usr/local/etc/satellite.db

AUTHOR
Mark Pulford <mark@kyne.com.au>

SEE ALSO
satcfg(8), satellited(8), satwatch(8).