NAME

       dhisd — Dynamic Host Information System server.

SYNOPSIS

       dhisd [-D] [-p port] [-d database] [-s services] [-l logfile] [-P pidfile]

DESCRIPTION

       DHIS  is  a client-server architecture meant to update databases for systems which are assigned a dynamic
       IP[v4] address.

       By the means of a DHIS client a host which is assigned a dynamic IP address (either from its ISP or  from
       DHCP) is able to communicate with a DHIS server in order to advertise its newly acquired IP address.

       DHIS comprises a UDP based protocol to achieve this purpose.

       A  DHIS  client  has a unique identification number and a set of authentication keys, runs in background,
       and attempts to reach its server.

       The DHIS server (permanently online) listens to UDP messages from its  clients  and  authenticates  these
       against  its  knowledge  of  keys.  When authentication is successful the DHIS server updates one or more
       databases with the newly received IP address for the given client.

       The server then keeps sending, every period of time, check requests to each  of  its  connected  clients.
       These  need  to be acknowledged. If not the server will consider, on an individual basis, that the client
       has disconnected and will again update the databases to an offline state.

       Alternativelly the server may receive an OFFLINE_REQ packet from the client, in which case the DNS record
       is updated at once and the online state droped.

OPTIONS

       -D      Increase debug level.

       -p port
               Specify port to listen on. If not specified, the default is port 58800.

       -d database
               Use an alternative database file instead of /etc/dhis-server/dhis.db.

       -s services
               Use an alternative database file instead of /etc/dhis-server/services.db.

       -l logfile
               Use an alternative log file instead of /var/log/dhisd.log.

       -P pidfile
               Use an alternative PID file instead of /var/run/dhisd.pid.

FILES

       /etc/dhis-server/dhis.db
               DHIS client database.  Contains the credentials of clients.

       /etc/dhis-server/services.db
               DHIS service database.  Contains a list of services and the location of  the  corresponding  DHIS
               engine plugins.

SEE ALSO

       dhis-genkeys(8)

AUTHOR

       dhisd has been written by Joao Cabral <jcnc@dhis.org>.

       This manual page was written by Guus Sliepen <guus@debian.org> for the Debian GNU/Linux system.

Debian GNU/Linux                                   2002-06-22                                           DHISD(8)