From ed1ead5e488292bf34301bced4f486a76c6c4821 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Sat, 29 Apr 2006 20:31:10 +0000 Subject: final documentation cleanups git-svn-id: file:///home/lennart/svn/public/nss-mdns/trunk@96 0ee8848e-81ea-0310-a63a-f631d1a40d77 --- doc/README.html.in | 42 ++++++++++++++++++++++++++++++------------ 1 file changed, 30 insertions(+), 12 deletions(-) diff --git a/doc/README.html.in b/doc/README.html.in index 5dbfd85..5ccf8fa 100644 --- a/doc/README.html.in +++ b/doc/README.html.in @@ -42,10 +42,10 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

News

-
Fri Apr 28 2006:

Sat Apr 29 2006:

Version 0.8 -released. Changes include: Build time option to disable legacy mDNS -request, i.e. resolve exclusively with Avahi; buil a special +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!

@@ -122,11 +122,17 @@ Avahi daemon which supports IPv6 properly.)

Documentation

-

After compiling and installing nss-mdns you'll find three +

After compiling and installing nss-mdns you'll find six new NSS modules in /lib:

- +

libnss_mdns.so.2 resolves both IPv6 and IPv4 addresses, libnss_mdns4.so.2 only IPv4 addresses and libnss_mdns6.so.2 only IPv6 addresses. Due to the fact that most mDNS responders only register local IPv4 @@ -137,10 +143,22 @@ situation causes long timeouts when resolving hosts since most modern Unix/Linux applications check for IPv6 addresses first, followed by a lookup for IPv4.

+

libnss_mdns{4,6,}_minimal.so (new in version 0.8) is mostly identical to the +versions without _minimal. However, they differ in one +way. The minimal versions will always deny to resolve host names that +don't end in .local or addresses that aren't in the range +169.254.x.x (the range used by IPV4LL/APIPA/RFC3927.) +Combining the _minimal and the normal NSS modules allows us +to make mDNS authoritative for ZeroConf host names and addresses (and +thus creating no extra burden on DNS servers with always failing +requests) and use it as fallback for everything else.

+

To activate one of the NSS modules you have to edit -/etc/nsswitch.conf and add mdns4 -(resp. mdns, mdns6) to the line starting with -"hosts:". On Debian this looks like this:

+/etc/nsswitch.conf and add mdns4 and +mdns4_minimal (resp. mdns, mdns6) to the +line starting with "hosts:". On Debian this looks like +this:

# /etc/nsswitch.conf
 
@@ -148,7 +166,7 @@ passwd:         compat
 group:          compat
 shadow:         compat
 
-hosts:          files dns mdns4
+hosts:          files mdns4_minimal [NOTFOUND=return] dns mdns4
 networks:       files
 
 protocols:      db files
@@ -219,7 +237,7 @@ compilation and make install (as root) for installation of
 
 
Acknowledgements

 
-
SHIROYAMA Takayuki for a patch.

+
SHIROYAMA Takayuki, Anand Kumria and Bastien Nocera for patches.

 
 
Sean Meiners for search list support.

 
@@ -240,7 +258,7 @@ compilation and make install (as root) for installation of
 
If you want to be notified whenever I release a new version of this software use the subscription feature of Freshmeat.

 
 

-
Lennart Poettering <@PACKAGE_BUGREPORT@>, Nov 2005

+
Lennart Poettering <@PACKAGE_BUGREPORT@>, April 2006

 
$Id$

 
 
-- 
cgit