From 07ca940dc0ab9caa1b9fe18a864697524e05db58 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Mon, 1 Jan 2007 17:20:56 +0000 Subject: update docs for 0.9 git-svn-id: file:///home/lennart/svn/public/nss-mdns/trunk@107 0ee8848e-81ea-0310-a63a-f631d1a40d77 --- doc/README.html.in | 57 ++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 43 insertions(+), 14 deletions(-) diff --git a/doc/README.html.in b/doc/README.html.in index 6a9ea44..01adfa2 100644 --- a/doc/README.html.in +++ b/doc/README.html.in @@ -10,7 +10,7 @@

nss-mdns @PACKAGE_VERSION@

License

News

Mon Jan 1 2007:

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 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:

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!

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:

Version 0.7 @@ -60,7 +85,7 @@ situations properly; if multiple addresses are assigned to the same interface ma href="@PACKAGE_URL@nss-mdns-0.6.tar.gz">Version 0.6 released. Changes include: honour search list in /etc/resolv.conf; try to contact Avahi for +href="http://avahi.org/">Avahi for resolving.

Sat Jun 4 2005:

.loc

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 Avahi.

Avahi

nss-mdns is very lightweight (24 KByte stripped binary +

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.

Optionally nss-mdns can try to contact a running avahi-daemon to -make use of its superior record cacheing.

By default nss-mdns tries to contact a running avahi-daemon for resolving host names and +addresses and making use of its superior record cacheing. Optionally +nss-mdns can be compiled with a mini mDNS stack that can be +used to resolve host names without a local Avahi installation. Both +Avahi support and this mini mDNS stack are optional, however at least one +of them needs to be enabled. If both are enabled a connection to Avahi is +tried first, and if that fails the mini mDNS stack is used.

Current Status

It works!

Although nss-mdns supports resolving IPv6 addresses it does -so via IPv4 multicasts only. (Unless, of course, it finds a running -Avahi daemon which supports IPv6 properly.)

If the mini MDNS stack is used, nss-mdns supports resolving IPv6 addresses but does +so via IPv4 multicasts only. If Avahi is used for resolving IPv6 is supported properly.

Documentation

If the configuration file is existent but empty, mDNS name lookups -are disabled completely.

.local

Requirements

Currently, nss-mdns is tested on Linux only. A fairly modern glibc installation with development headers (2.0 or newer) is required. Not suprisingly nss-mdns requires a -kernel compiled with IPv4 multicasting support enabled.

Avahi

nss-mdns

--enable-legacy

nss-mdns

nss-mdns was developed and tested on Debian GNU/Linux "testing" from December 2004, it should work on most other Linux @@ -260,7 +289,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@>, April 2006

Lennart Poettering <@PACKAGE_BUGREPORT@>, January 2007

$Id$