From 83f6431fae4bf360bf2465eadda3cf7f272a2241 Mon Sep 17 00:00:00 2001 From: fredrik Date: Thu, 12 Jan 2006 17:20:35 +0000 Subject: [PATCH] Initial import. git-svn-id: svn+ssh://svn.dolda2000.com/srv/svn/repos/src/icmp-dn@548 959494ce-11ee-0310-bf91-de5d638817bd --- src/nss-icmp.7 | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 src/nss-icmp.7 diff --git a/src/nss-icmp.7 b/src/nss-icmp.7 new file mode 100644 index 0000000..4d8597f --- /dev/null +++ b/src/nss-icmp.7 @@ -0,0 +1,50 @@ +.\" +.\" Copyright (c) 2006 Fredrik Tolf +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, write to the Free +.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, +.\" USA. +.\" +.TH NSS-ICMP 7 "12 Jan 2006" "icmpdn 0.3" "ICMP Hostname Manual" +.SH NAME +nss-icmp - A nameservice hostname module for ICMP +.SH DESCRIPTION +The \fBnss-icmp\fP nameservice module provides reverse hostname lookup +over ICMP. If installed in \fB/etc/nsswitch.conf\fP, it will act on +programs calling \fBgethostbyaddr\fP(3) and related functions and +attempt to request the specified host's fully qualified domain name +over ICMP. +.P +In order to do so, \fBnss-icmp\fP relies on the \fBidnlookup\fP(1) +program being installed on the system. It also implements a cache, +which will remember the remote host's response for as long as the TTL +(Time-to-Live) value in the response specifies. It will also remember +non-responsive hosts, so that time-outs will not have to happen twice. +.P +The first time \fBnss-icmp\fP is called, it will read a configuration +file, which by default will be named \fB/etc/nss-icmp.conf\fP +(although this name can be changed during compilation). The +configuration file specifies certain parameters to control how +\fBnss-icmp\fP operates. Its file format is described in the +\fBnss-icmp.conf\fP(5) man page. +.SH AUTHOR +Fredrik Tolf +.SH SEE ALSO +\fBidnlookup\fP(1), \fBicmpdnd\fP(8), \fBnsswitch.conf\fP(5), +\fBnss-icmp.conf\fP(5), \fIRFC 1788\fP -- 2.11.0