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.