NAME

gpd - General Purpose Daemon


SYNOPSIS

gpd [-s server] [-c contact] [-cmd file] [-log file|STDOUT] [-daemon] [-nofork] [-echo] gpd -help gpd -version


DESCRIPTION

A General Purpose Daemon that listens on server sockets accepting new connections and servicing the commands on those sockets. GPD has two command lists, internal commands that are handled by subroutines in GPD and external commands that are handled with a fork-exec.


OPTIONS

-s server

Defines the 'address:port:protocol' server sockets that GPD should open. ``address'' may be: a doted IP address, hostname, or host interface name. If none is specified 0.0.0.0 is assumed and the server will accept connections on ANY host address. If no port is specified a configurable default port will be opened. If no protocol is specified 'tcp' is assumed. Multiple -s server options may be specified.

-c concact

Defines the 'address:port:protocol' of client connections (where GPD is the client to some other server). This capability is being implemented for future use and doesn't have any applications currently. Multiple -c contact options may be specified.

-cmd

Defines a file that contains commands that GPD should process. These commands are processed in the same was as commands received from sockets. Multiple -cmd file options may be specified.

-l file|STDOUT

Tells GPD to log to a specific file or to STDOUT. If not specified logging will go to /var/log/gpd.log if writable, or /tmp/gpd.log otherwise. Note, if you rename GPD the log file will appear under the new/real program name.

-daemon

Makes GPD run as a daemon.

-nofork

Tells GPD to not fork when executing an external commands. In effect this will terminate the main GPD daemon. This is used for debugging.

-echo --echo

Display a string in the form ``host:port:protocol'' for each server port opened.

-h, --help

Prints the usage message.

-v, --version

Prints the version of whatami.


PHILOSOPHY

Haven't had a chance to write down phylosophy yet.


ERRORS

Support for 'udp' datagram sockets isn't complete.


SEE ALSO

http://www.mcs.anl.gov/systems/software/gpd/


AUTHOR

John-Paul Navarro

gpd is part of the Msys Systems Administrator Toolkit, http://www.mcs.anl.gov/msys/ .


COPYRIGHT

Copyright (c) University of Chicago 2000. See the COPYRIGHT file in the distribution or on the web page for details.