
                                 nss-mdns 0.10

   Copyright 2004-2007 Lennart Poettering <mzaffzqaf (at) 0pointer (dot)
   de>
     * [1]License
     * [2]News
     * [3]Overview
     * [4]Current Status
     * [5]Documentation
     * [6]Requirements
     * [7]Installation
     * [8]Acknowledgements
     * [9]Download

License

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU Lesser General Public License as
   published by the Free Software Foundation; either version 2 of the
   License, or (at your option) any later version.

   This program 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
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this program; if not, write to the Free Software
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

News

   Sat May 12 2007:

   [10]Version 0.10 released. Changes include: Ported to FreeBSD;
   alignment fixes for SPARC.

   Mon Jan 1 2007:

   [11]Version 0.9 released. Changes include: Make most shared library
   symbols private to not conflict with any symbols of the program we're
   loaded into. Fix a potential endless loop in the mDNS packet parsing
   code.

   Please note that due to security reasons from this release on the
   minimal mDNS stack included in nss-mdns (dubbed "legacy") is no longer
   built by default. Thus, nss-mdns will not work unless [12]Avahi is
   running! That makes Avahi essentially a hard dependency of nss-mdns.
   Pass --enable-legacy to reenable the mini mDNS stack again. Please
   note as well that this release does not honour /etc/resolv.conf domain
   search lists by default anymore. It created a lot of problems and was
   never recommended anyway. You may reenable this functionality by
   passing --enable-search-domains.

   Sat Apr 29 2006:

   [13]Version 0.8 released. Changes include: Build time option to
   disable "legacy unicast" mDNS requests, i.e. resolve exclusively with
   Avahi; build a special _minimal flavour of the shared objects to
   minimize unnecessary name lookup timeouts; fix IPv6 resolving when
   using Avahi.

   Please note that starting with nss-mdns 0.8 we encourage you to use a
   different /etc/nsswitch.conf configuration line. See below for more
   information!

   Sat Nov 19 2005:

   [14]Version 0.7 released. Changes include: Portability patch for ARM
   from Philipp Zabel; make sure not to print any messages to STDERR;
   deal with OOM situations properly; if multiple addresses are assigned
   to the same interface make sure to send a query packet only once;
   other cleanups

   Sun Aug 21 2005:

   [15]Version 0.6 released. Changes include: honour search list in
   /etc/resolv.conf; try to contact [16]Avahi for resolving.

   Sat Jun 4 2005:

   [17]Version 0.5 released. Changes include: only lookup hostnames
   ending in .local; add support for a configuration file
   (/etc/mdns.allow) to allow lookups for other names.

   Sun May 15 2005:

   [18]Version 0.4 released. Changes include: small portability fix for
   big endian architectures; send "legacy unicast" packets instead of
   normal mDNS packets (this should reduce traffic and improve response
   time)

   Jan Sun 16 2005:

   [19]Version 0.3 released. Changes include: add Debianization; use
   ip6.arpa instead of ip6.int for reverse IPv6 lookups.

   Fri Dec 17 2004:

   [20]Version 0.2 released. Changes include: send mDNS queries on every
   interface that supports multicasts, instead of only the one with the
   default route, making nss-mdns more robust on multi-homed hosts; gcc
   2.95 compatiblity.

   Mon Dec 6 2004:

   [21]Version 0.1 released

Overview

   nss-mdns is a plugin for the GNU Name Service Switch (NSS)
   functionality of the GNU C Library (glibc) providing host name
   resolution via [22]Multicast DNS (aka Zeroconf, aka Apple Rendezvous,
   aka Apple Bonjour), effectively allowing name resolution by common
   Unix/Linux programs in the ad-hoc mDNS domain .local.

   nss-mdns provides client functionality only, which means that you have
   to run a mDNS responder daemon seperately from nss-mdns if you want to
   register the local host name via mDNS. I recommend [23]Avahi.

   nss-mdns is very lightweight (9 KByte stripped binary .so compiled
   with -DNDEBUG=1 -Os on i386, gcc 4.0), has no dependencies besides the
   glibc and requires only minimal configuration.

   By default nss-mdns tries to contact a running [24]avahi-daemon for
   resolving host names and addresses and making use of its superior
   record cacheing. Optionally nss-mdns can be c                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  