DragonFly On-Line Manual Pages


RCONFIG(8)	       DragonFly System Manager's Manual	    RCONFIG(8)

NAME

rconfig -- Remote Configuration Client/Server

SYNOPSIS

rconfig [-a] [-W workdir] [-T tagdir] [-C configfiles] [-s] [-v]

DESCRIPTION

The rconfig utility provides simple remote configurator functionality. In client mode rconfig will broadcast a request for the specified config- uration tag over available interfaces (or you can specify an IP), locate a server capable of supplying the tag, then connect to, download, and run the script associate with the tag. In server mode rconfig will listen on port 257 for broadcast requests (UDP) and connections (TCP). Note that UDP based requests are only responded to if the requested tag is avail- able. You can run the server on multiple machines on the LAN serving different tags or, if you wish to provide a backup, serving the same tags, or a mix. The client will use the first matching tag it encoun- ters. The following command line options are available when operating in client mode: -a rconfig will broadcast a request for the 'auto' tag on all available interfaces. No additional arguments are necessary. -W workdir Specify the working directory for script downloads. The default is /tmp. -v Verbose mode prints additional information during program execution. host[:tag] Specify any number of remote IP addresses or broadcast addresses. If no tag is specified rconfig defaults to 'auto'. If you specify just a tag using :tag the broadcast address for all available interfaces will be used. The -a option should not be used in that case. The following command line options are available when operating in server mode: -a rconfig will bind to and listen on all available interfaces. If this option is not used you must specify a particular IP address or addresses to bind to. The server listens on port 257 for both UDP and TCP. -T tagdir Specify the directory containing the tag scripts. The default is /usr/local/etc/rconfig. Tag scripts are in the form: tagname.sh. -C configfiles Specify server configuration files (currently unused). -s This option is required to operate rconfig as a server. -v Verbose mode prints additional information during program execution. bind_address Specify any number of IP addresses or hostnames corresponding to machine local addresses that the server will bind to and listen on.

FILES

/usr/share/examples/rconfig

SEE ALSO

dhclient(8)

AUTHORS

This program was written by Matthew Dillon. DragonFly 4.1 June 17, 2004 DragonFly 4.1