Add reference to nss-icmp.
[icmp-dn.git] / src / icmpdnd.8
1 .\"
2 .\" Copyright (c) 2006 Fredrik Tolf <fredrik@dolda2000.com>
3 .\"
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
8 .\"
9 .\" The GNU General Public License's references to "object code"
10 .\" and "executables" are to be interpreted as the output of any
11 .\" document formatting or typesetting system, including
12 .\" intermediate and printed output.
13 .\"
14 .\" This manual is distributed in the hope that it will be useful,
15 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
16 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 .\" GNU General Public License for more details.
18 .\"
19 .\" You should have received a copy of the GNU General Public
20 .\" License along with this manual; if not, write to the Free
21 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
22 .\" USA.
23 .\"
24 .TH ICMPDND 8 "12 Jan 2006" "icmpdn 0.3" "ICMP Hostname Manual"
25 .SH NAME
26 icmpdnd - ICMP domain name responder
27 .SH SYNOPSIS
28 .B icmpdnd
29 [ \fB-nh\fP ] [ \fB-t\fP \fIttl\fP ] [ \fB-d\fP \fIdomainname\fP ]
30 .SH DESCRIPTION
31 \fBicmpdnd\fP is daemon that answers ICMP host name requests. It is
32 capable of handling requests over both IPv4 and IPv6.
33 .P
34 When called without arguments, \fBicmpdnd\fP will answer requests with
35 the host name that is specified in the operating system through the
36 \fBsethostname\fP(2) and \fBsetdomainname\fP(2) calls. On GNU/Linux,
37 these are normally called by the \fBhostname\fP(1) program.
38 .SH OPTIONS
39 .TP
40 .B -h
41 Print a brief usage message and exit.
42 .TP
43 .B -n
44 Do not daemonize, but continue to run on the calling terminal.
45 .TP
46 .B -t
47 Set the TTL (Time-to-Live) value in responses to \fIttl\fP seconds,
48 rather than the default of 3600 seconds.
49 .TP
50 .B -d
51 Set the domain name in responses to \fIdomainname\fP, rather than the
52 default as described above. This option is useful in case the system
53 is not configured to set up its own hostname.
54 .SH AUTHOR
55 Fredrik Tolf <fredrik@dolda2000.com>
56 .SH SEE ALSO
57 \fBidnlookup\fP(1), \fBhostname\fP(1), \fBnss-icmp\fP(7), \fIRFC
58 1788\fP