[icmp-dn.git] / README

ICMP host name utilities

Since the Linux kernel does not support the ICMP host name facilities as
described in RFC 1788, I wrote a simple implementation in user-space.
It comprises three parts:

    * icmpdnd – The ICMP Domain Name daemon, which listens to ICMP
      domain name requests and replies to them.

    * idnlookup – A user utility to query a host for its host name over
      ICMP. Like ping and all other utilities that use ICMP, it needs to
      be installed SUID root.

    * libnss_icmp.so.2 – A glibc NSS module, which uses idnlookup to
      perform queries for the gethostbyaddr function.

General information

The NSS module caches all requests (including failures) and honors the
TTL value sent by the responding host. It uses a configuration file called
/etc/nss-icmp.conf, which controls different aspects of its operation:

    * timeout – Sets the timeout in milliseconds for ICMP host name
      queries, by passing the -t option to idnlookup.
    * nocache – Disables the cache.
    * ttlnotfound – Sets the TTL for not-found cache entries is
      seconds. The default is 5 minutes.

Both icmpdnd and idnlookup need to run as root, due to the fact that
they use ICMP. Thus, idnlookup needs be installed SUID root.
Commit	Line	Data
388db563 DC	1	ICMP host name utilities
	2
	3	Since the Linux kernel does not support the ICMP host name facilities as
	4	described in RFC 1788, I wrote a simple implementation in user-space.
	5	It comprises three parts:
	6
	7	* icmpdnd – The ICMP Domain Name daemon, which listens to ICMP
	8	domain name requests and replies to them.
	9
	10	* idnlookup – A user utility to query a host for its host name over
	11	ICMP. Like ping and all other utilities that use ICMP, it needs to
	12	be installed SUID root.
	13
	14	* libnss_icmp.so.2 – A glibc NSS module, which uses idnlookup to
	15	perform queries for the gethostbyaddr function.
	16
	17	General information
	18
	19	The NSS module caches all requests (including failures) and honors the
	20	TTL value sent by the responding host. It uses a configuration file called
	21	/etc/nss-icmp.conf, which controls different aspects of its operation:
	22
	23	* timeout – Sets the timeout in milliseconds for ICMP host name
	24	queries, by passing the -t option to idnlookup.
	25	* nocache – Disables the cache.
	26	* ttlnotfound – Sets the TTL for not-found cache entries is
	27	seconds. The default is 5 minutes.
	28
	29	Both icmpdnd and idnlookup need to run as root, due to the fact that
	30	they use ICMP. Thus, idnlookup needs be installed SUID root.
	31