← Back to branch summary

~ubuntu-branches/ubuntu/precise/nss-mdns/precise

« back to all changes in this revision

Viewing changes to doc/README.html

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2007-01-02 12:45:26 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20070102124526-sszufqkz15vord81
Tags: 0.9-0ubuntu1
* New upstream bugfix release:
  - 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.
  - Do not build legacy internal DNS stack by default any more.
  - Do not honour /etc/resolv.conf domain search lists by default anymore.
    It created a lot of problems and was never recommended anyway.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/README.html
3
3
<html xmlns="http://www.w3.org/1999/xhtml">
4
4
 
5
5
<head>
6
 
<title>nss-mdns 0.8</title>
 
6
<title>nss-mdns 0.9</title>
7
7
<link rel="stylesheet" type="text/css" href="style.css" />
8
8
</head>
9
9
 
10
10
<body>
11
 
<h1><a name="top">nss-mdns 0.8</a></h1>
 
11
<h1><a name="top">nss-mdns 0.9</a></h1>
12
12
 
13
 
<p><i>Copyright 2004-2006 Lennart Poettering &lt;mzaffzqaf (at) 0pointer (dot) de&gt;</i></p>
 
13
<p><i>Copyright 2004-2007 Lennart Poettering &lt;mzaffzqaf (at) 0pointer (dot) de&gt;</i></p>
14
14
 
15
15
<ul class="toc">
16
16
    <li><a href="#license">License</a></li>
42
42
 
43
43
<h2><a name="news">News</a></h2>
44
44
 
 
45
<div class="news-date">Mon Jan 1 2007: </div>
 
46
 
 
47
<p class="news-text"><a
 
48
href="http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.9.tar.gz">Version 0.9</a>
 
49
released. Changes include: Make most shared library symbols private to
 
50
not conflict with any symbols of the program we're loaded into. Fix a
 
51
potential endless loop in the mDNS packet parsing code.</p>
 
52
 
 
53
<p class="news-text"><b>Please note that due to security reasons from
 
54
this release on the minimal mDNS stack included in <tt>nss-mdns</tt>
 
55
(dubbed "legacy") is no longer built by default. Thus,
 
56
<tt>nss-mdns</tt> will not work unless <a
 
57
href="http://avahi.org/">Avahi</a> is running! That makes Avahi
 
58
essentially a hard dependency of <tt>nss-mdns</tt>. Pass
 
59
<tt>--enable-legacy</tt> to reenable the mini mDNS stack again. Please
 
60
note as well that this release does not honour
 
61
<tt>/etc/resolv.conf</tt> domain search lists by default anymore. It
 
62
created a lot of problems and was never recommended anyway. You may
 
63
reenable this functionality by passing
 
64
<tt>--enable-search-domains</tt>.</b></p>
 
65
 
45
66
<div class="news-date">Sat Apr 29 2006: </div> <p class="news-text"><a
46
67
href="http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.8.tar.gz">Version 0.8</a>
47
68
released. Changes include: Build time option to disable "legacy unicast" mDNS
48
69
requests, i.e. resolve exclusively with Avahi; build a special
49
70
<tt>_minimal</tt> flavour of the shared objects to minimize
50
71
unnecessary name lookup timeouts; fix IPv6 resolving when using
51
 
Avahi; <b>Please note that starting with nss-mdns 0.8 we encourage you to use a different <tt>/etc/nsswitch.conf</tt> configuration line. See below for more information!</b></p>
 
72
Avahi.</p>
 
73
 
 
74
<p class="news-text"><b>Please note that starting with nss-mdns 0.8 we encourage you to use
 
75
a different <tt>/etc/nsswitch.conf</tt> configuration line. See below
 
76
for more information!</b></p>
52
77
 
53
78
<div class="news-date">Sat Nov 19 2005: </div> <p class="news-text"><a
54
79
href="http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.7.tar.gz">Version 0.7</a>
60
85
href="http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.6.tar.gz">Version 0.6</a>
61
86
released. Changes include: honour search list in
62
87
<tt>/etc/resolv.conf</tt>; try to contact <a
63
 
href="http://www.freedesktop.org/Software/Avahi">Avahi</a> for
 
88
href="http://avahi.org/">Avahi</a> for
64
89
resolving.</p>
65
90
 
66
91
<div class="news-date">Sat Jun 4 2005: </div> <p class="news-text"><a
101
126
<p><tt>nss-mdns</tt> provides client functionality only, which
102
127
means that you have to run a mDNS responder daemon seperately
103
128
from <tt>nss-mdns</tt> if you want to register the local host name via
104
 
mDNS. I recommend <a href="http://www.freedesktop.org/Software/Avahi">Avahi</a>.</p>
 
129
mDNS. I recommend <a href="http://avahi.org/">Avahi</a>.</p>
105
130
 
106
 
<p><tt>nss-mdns</tt> is very lightweight (24 KByte stripped binary
 
131
<p><tt>nss-mdns</tt> is very lightweight (9 KByte stripped binary
107
132
<tt>.so</tt> compiled with <tt>-DNDEBUG=1 -Os</tt> on i386, <tt>gcc</tt>
108
133
4.0), has no dependencies besides the <tt>glibc</tt> and requires only
109
134
minimal configuration.</p>
110
135
 
111
 
<p>Optionally <tt>nss-mdns</tt> can try to contact a running <a
112
 
href="http://www.freedesktop.org/Software/Avahi">avahi-daemon</a> to
113
 
make use of its superior record cacheing.</p>
 
136
<p>By default <tt>nss-mdns</tt> tries to contact a running <a
 
137
href="http://avahi.org/">avahi-daemon</a> for resolving host names and
 
138
addresses and making use of its superior record cacheing. Optionally
 
139
<tt>nss-mdns</tt> can be compiled with a mini mDNS stack that can be
 
140
used to resolve host names without a local Avahi installation. Both
 
141
Avahi support and this mini mDNS stack are optional, however at least one
 
142
of them needs to be enabled. If both are enabled a connection to Avahi is
 
143
tried first, and if that fails the mini mDNS stack is used.</p>
114
144
 
115
145
<h2><a name="status">Current Status</a></h2>
116
146
 
117
147
<p>It works!</p>
118
148
 
119
 
<p>Although <tt>nss-mdns</tt> supports resolving IPv6 addresses it does
120
 
so via IPv4 multicasts only. (Unless, of course, it finds a running
121
 
Avahi daemon which supports IPv6 properly.)</p>
 
149
<p>If the mini MDNS stack is used, <tt>nss-mdns</tt> supports resolving IPv6 addresses but does
 
150
so via IPv4 multicasts only. If Avahi is used for resolving IPv6 is supported properly.</p>
122
151
 
123
152
<h2><a name="documentation">Documentation</a></h2>
124
153
 
191
220
<p>If you run a firewall, don't forget to allow UDP traffic to the the
192
221
mDNS multicast address <tt>224.0.0.251</tt> on port 5353.</p>
193
222
 
 
223
<p><b>Please note:</b> The line above makes <tt>nss-mdns</tt>
 
224
authoritative for the <tt>.local</tt> domain. If you have a unicast
 
225
DNS domain with the same name you will no longer be able to resolve
 
226
hosts from it. mDNS and a unicast DNS domain named <tt>.local</tt> are
 
227
inherently incompatible. Please contact your local admistrator and ask
 
228
him to move to a different domain name since <tt>.local</tt> is to be
 
229
used exclusively for Zeroconf technology. <a
 
230
href="http://avahi.org/wiki/AvahiAndUnicastDotLocal">Further
 
231
information</a>.</p>
 
232
 
194
233
<p>Starting with version 0.5, <tt>nss-mdns</tt> has a simple
195
234
configuration file <tt>/etc/mdns.allow</tt> for enabling name lookups
196
235
via mDNS in other domains than <tt>.local</tt>. The file contains
214
253
mDNS.</p>
215
254
 
216
255
<p>If the configuration file is existent but empty, mDNS name lookups
217
 
are disabled completely.</p>
 
256
are disabled completely. Please note that usually mDNS is not used for anything but <tt>.local</tt>, hence you usually don't want to touch this file.</p>
218
257
 
219
258
<h2><a name="requirements">Requirements</a></h2>
220
259
 
221
260
<p>Currently, <tt>nss-mdns</tt> is tested on Linux only. A fairly
222
261
modern <tt>glibc</tt> installation with development headers (2.0 or
223
262
newer) is required. Not suprisingly <tt>nss-mdns</tt> requires a
224
 
kernel compiled with IPv4 multicasting support enabled.</p>
 
263
kernel compiled with IPv4 multicasting support enabled. <a href="http://avahi.org/">Avahi</a> is recommended for its superior cacheing capabilities and for security reasons. Unless you compile <tt>nss-mdns</tt> with <tt>--enable-legacy</tt> Avahi is a hard dependency when <tt>nss-mdns</tt> is used, however not a build-time requirement.</p>
225
264
 
226
265
<p><tt>nss-mdns</tt> was developed and tested on Debian GNU/Linux
227
266
"testing" from December 2004, it should work on most other Linux
249
288
 
250
289
<p>The newest release is always available from <a href="http://0pointer.de/lennart/projects/nss-mdns/">http://0pointer.de/lennart/projects/nss-mdns/</a></p>
251
290
 
252
 
<p>The current release is <a href="http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.8.tar.gz">0.8</a></p>
 
291
<p>The current release is <a href="http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.9.tar.gz">0.9</a></p>
253
292
 
254
293
<p>Get <tt>nss-mdns</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="svn://svn.0pointer.de/nss-mdns">repository</a> (<a href="http://0pointer.de/cgi-bin/viewcvs.cgi/?root=nss-mdns">viewcvs</a>): </p>
255
294
 
260
299
<p>If you want to be notified whenever I release a new version of this software use the subscription feature of <a href="http://freshmeat.net/projects/nss-mdns/">Freshmeat</a>.</p>
261
300
 
262
301
<hr/>
263
 
<address class="grey">Lennart Poettering &lt;mzaffzqaf (at) 0pointer (dot) de&gt;, April 2006</address>
264
 
<div class="grey"><i>$Id: README.html.in 98 2006-04-29 20:49:19Z lennart $</i></div>
 
302
<address class="grey">Lennart Poettering &lt;mzaffzqaf (at) 0pointer (dot) de&gt;, January 2007</address>
 
303
<div class="grey"><i>$Id: README.html.in 110 2007-01-01 18:31:50Z lennart $</i></div>
265
304
 
266
305
</body>
267
306
</html>