.Dd 2002-06-22
.Dt DHID 8
.Os "Debian GNU/Linux"
.\" Manual page created by Guus Sliepen <guus@debian.org>
.Sh NAME
.Nm dhid
.Nd Dynamic Host Information System client.
.Sh SYNOPSIS
.Nm
.Op Fl h
.Op Fl p Ar port
.Op Fl P Ar pidfile
.Op Fl f Ar conffile
.Sh DESCRIPTION
.Nm
is the DHIS client daemon. After setting up with a DHIS provider,
each machine may run a
.Nm
daemon (in background) in order to
update its dynamic IP address within the server.
.Pp
.Pa /etc/dhid.conf
should be configured according to the provider's
assigned parameters.
.Pp
Once running,
.Nm
sends echo request packets to the server and
expects a reply. Once received,
.Nm
tries to authenticate at the
server either in secure on insecure mode. From then on, and
providing authentication was successful, the client waits and
replies to queries originated at the server. If the server doesn't
receive acknowledgments of these packets the host is marked offline.
Likewise, if the client doesn't receive queries for a period of time
the offline stage is restored.
.Pp
Therefore, the only thing a DHIS host needs is to run the
.Nm
client.
The server is able to determine when the host is online and the server
tables are updated automatically.
.Sh OPTIONS
.Bl -tag -width indent
.It Fl h
Show usage information.
.It Fl p Ar port
Specify port to listen on. If not specified, the default is port 58800.
.It Fl P Ar pidfile
Use an alternative PID file instead of
.Pa /var/run/dhisd.pid .
.It Fl l Ar conffile
Use an alternative configuration file instead of
.Pa /etc/dhid.conf .
.El
.Sh FILES
.Bl -tag -width indent
.It Pa /etc/dhid.conf
DHIS client configuration.
.El
.Sh AUTHOR
.Nm
has been written by
.An Joao Cabral Aq jcnc@dhis.org .
.Pp
This manual page was written by
.An Guus Sliepen Aq guus@debian.org
for the Debian GNU/Linux system.