DragonFly On-Line Manual Pages

Search: Section:  

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


NAME

     rconfig - Remote Configuration Client/Server


SYNOPSIS

     rconfig [-a] [-v] [-W workdir] [host[:tag] ...]
     rconfig -s [-a] [-C configfiles] [-T tagdir] [-v] [bind_address ...]


DESCRIPTION

     The rconfig utility provides simple remote configurator functionality.
     In client mode rconfig will broadcast a request for the specified
     configuration 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 available.  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
     encounters.

     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:

     -s          This option is required to operate rconfig as a server.

     -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.  The tag name can only consist of alphabets
                 (lower and upper letters), digits (zero to nine), underscore
                 (_), dot (.), minus (-) and plus (+) symbols.

     -C configfiles
                 Specify server configuration files (currently unused).

     -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 6.3-DEVELOPMENT        June 16, 2019       DragonFly 6.3-DEVELOPMENT

Search: Section: