NAME

       uniconfd - a daemon program for the UniConf configuration system

SYNOPSIS

       uniconfd [ OPTIONS ] MOUNT ...

DESCRIPTION

       UniConf  is  the One True Configuration system that includes all the others because it has
       plugin backends and frontends. Or, less  grandiosely,  it's  a  lightweight,  distributed,
       cacheable tree of strings.

       It supports:

       •   retrieving,  storing,  and enumerating key/value pairs (where both keys and values are
           strings).

       •   multiple backends where the actual key/value pairs are stored.

       •   multiple frontends for tying it to other configuration architectures.

       It operates locally, and  across  a  network,  allowing  you  to  tie  multiple  different
       applications  together  for distributed computing.  Also, it provides notifications in the
       form of callbacks, so your application can be notified if a configuration key has changed.

       uniconfd is necessary when you have more than one application, or multiple instances of an
       application,  sharing  one  configuration.   UniConf-enabled applications contact uniconfd
       which provides notifications when any of their watched keys change.

       You tell uniconfd which UniConf MOUNT you want it to manage.  See the MOUNTS  section  for
       more information.

OPTIONS

       -f     Run in the foreground.  Do not fork into a separate daemon process.

       -d, -dd
              Print  debugging  messages to the console.  The second d increases the verbosity of
              the messages.

       -V     Print the version number and exit.

       -a     Require authentication on incoming connections.

       -A     Check all accesses against a perms moniker.

       -p port
              Listen on a given TCP port.  The default is 4111.  If port is 0, then listening  on
              TCP is disabled.

       -s port
              Listen  on  a  given  TCP port wrapped in SSL.  The default is 4112.  If port is 0,
              then listening on SSL-over-TCP is disabled.

       -u filename
              Listen on a given Unix socket filename.  This is disabled by default.

MOUNTS

       Mounts are UniConf path monikers which are in the form:
              /SUBTREE=GENERATORS:PATH

       SUBTREE
              This is the tree to manage.  All trees are descended from the root tree,  indicated
              by a bare slash (/).

       GENERATORS
              These  are  the  generators  used to read and write key/value pairs.  You can chain
              them with colons.  For example, the generator chain: cache:retry:ini will cache the
              configuration  for  speed,  retry  persistently  if the data source disappears, and
              store the data in an INI-formatted file.

       PATH   This is the location where the data is stored.  It is dependent on which GENERATORS
              were    specified.     For    instance,    it    could    be:    •    a    filename
              (ini:/var/lib/app/config.ini),
              • a network address, (tcp:open.nit.ca:4111),
              • or even an empty string (tmp:).

       Examples:
              /=tmp:
              /ca/nit=ssl:open.nit.ca
              /ca/nit/uniconfd=ini:/var/lib/uniconfd/uniconfd.ini
              /apps=cache:retry:unix:/var/lib/apps/socket

FILES

       /etc/uniconfd.conf
       /var/lib/uniconf/uniconfd.ini
       /var/lib/uniconf/uniconf.ini

AUTHORS

       This software was written by the hackers at Net Integration Technologies.  Contact  us  at
       <wvstreams-dev@lists.nit.ca>