~ubuntu-branches/ubuntu/precise/nss-mdns/precise : revision 11

1

2

nss-mdns 0.9

2

nss-mdns 0.10

3

4

5

de>

31

32

News

33

34

Sat May 12 2007:

35

36

[10]Version 0.10 released. Changes include: Ported to FreeBSD;

37

alignment fixes for SPARC.

38

34

39

Mon Jan 1 2007:

35

40

36

[10]Version 0.9 released. Changes include: Make most shared library

41

[11]Version 0.9 released. Changes include: Make most shared library

37

42

symbols private to not conflict with any symbols of the program we're

38

43

loaded into. Fix a potential endless loop in the mDNS packet parsing

39

44

code.

40

45

41

46

Please note that due to security reasons from this release on the

42

47

minimal mDNS stack included in nss-mdns (dubbed "legacy") is no longer

43

built by default. Thus, nss-mdns will not work unless [11]Avahi is

48

built by default. Thus, nss-mdns will not work unless [12]Avahi is

44

49

running! That makes Avahi essentially a hard dependency of nss-mdns.

45

50

Pass --enable-legacy to reenable the mini mDNS stack again. Please

46

51

note as well that this release does not honour /etc/resolv.conf domain

50

55

51

56

Sat Apr 29 2006:

52

57

53

[12]Version 0.8 released. Changes include: Build time option to

58

[13]Version 0.8 released. Changes include: Build time option to

54

59

disable "legacy unicast" mDNS requests, i.e. resolve exclusively with

55

60

Avahi; build a special _minimal flavour of the shared objects to

56

61

minimize unnecessary name lookup timeouts; fix IPv6 resolving when

62

67

63

68

Sat Nov 19 2005:

64

69

65

[13]Version 0.7 released. Changes include: Portability patch for ARM

70

[14]Version 0.7 released. Changes include: Portability patch for ARM

66

71

from Philipp Zabel; make sure not to print any messages to STDERR;

67

72

deal with OOM situations properly; if multiple addresses are assigned

68

73

to the same interface make sure to send a query packet only once;

70

75

71

76

Sun Aug 21 2005:

72

77

73

[14]Version 0.6 released. Changes include: honour search list in

74

/etc/resolv.conf; try to contact [15]Avahi for resolving.

78

[15]Version 0.6 released. Changes include: honour search list in

79

/etc/resolv.conf; try to contact [16]Avahi for resolving.

75

80

76

81

Sat Jun 4 2005:

77

82

78

[16]Version 0.5 released. Changes include: only lookup hostnames

83

[17]Version 0.5 released. Changes include: only lookup hostnames

79

84

ending in .local; add support for a configuration file

80

85

(/etc/mdns.allow) to allow lookups for other names.

81

86

82

87

Sun May 15 2005:

83

88

84

[17]Version 0.4 released. Changes include: small portability fix for

89

[18]Version 0.4 released. Changes include: small portability fix for

85

90

big endian architectures; send "legacy unicast" packets instead of

86

91

normal mDNS packets (this should reduce traffic and improve response

87

92

time)

88

93

89

94

Jan Sun 16 2005:

90

95

91

[18]Version 0.3 released. Changes include: add Debianization; use

96

[19]Version 0.3 released. Changes include: add Debianization; use

92

97

ip6.arpa instead of ip6.int for reverse IPv6 lookups.

93

98

94

99

Fri Dec 17 2004:

95

100

96

[19]Version 0.2 released. Changes include: send mDNS queries on every

101

[20]Version 0.2 released. Changes include: send mDNS queries on every

97

102

interface that supports multicasts, instead of only the one with the

98

103

default route, making nss-mdns more robust on multi-homed hosts; gcc

99

104

2.95 compatiblity.

100

105

101

106

Mon Dec 6 2004:

102

107

103

[20]Version 0.1 released

108

[21]Version 0.1 released

104

109

105

110

Overview

106

111

107

112

nss-mdns is a plugin for the GNU Name Service Switch (NSS)

108

113

functionality of the GNU C Library (glibc) providing host name

109

resolution via [21]Multicast DNS (aka Zeroconf, aka Apple Rendezvous,

114

resolution via [22]Multicast DNS (aka Zeroconf, aka Apple Rendezvous,

110

115

aka Apple Bonjour), effectively allowing name resolution by common

111

116

Unix/Linux programs in the ad-hoc mDNS domain .local.

112

117

113

118

nss-mdns provides client functionality only, which means that you have

114

119

to run a mDNS responder daemon seperately from nss-mdns if you want to

115

register the local host name via mDNS. I recommend [22]Avahi.

120

register the local host name via mDNS. I recommend [23]Avahi.

116

121

117

122

nss-mdns is very lightweight (9 KByte stripped binary .so compiled

118

123

with -DNDEBUG=1 -Os on i386, gcc 4.0), has no dependencies besides the

119

124

glibc and requires only minimal configuration.

120

125

121

By default nss-mdns tries to contact a running [23]avahi-daemon for

126

By default nss-mdns tries to contact a running [24]avahi-daemon for

122

127

resolving host names and addresses and making use of its superior

123

128

record cacheing. Optionally nss-mdns can be compiled with a mini mDNS

124

129

stack that can be used to resolve host names without a local Avahi

159

164

to the versions without _minimal. However, they differ in one way. The

160

165

minimal versions will always deny to resolve host names that don't end

161

166

in .local or addresses that aren't in the range 169.254.x.x (the range

162

used by [24]IPV4LL/APIPA/RFC3927.) Combining the _minimal and the

167

used by [25]IPV4LL/APIPA/RFC3927.) Combining the _minimal and the

163

168

normal NSS modules allows us to make mDNS authoritative for Zeroconf

164

169

host names and addresses (and thus creating no extra burden on DNS

165

170

servers with always failing requests) and use it as fallback for

204

209

DNS domain named .local are inherently incompatible. Please contact

205

210

your local admistrator and ask him to move to a different domain name

206

211

since .local is to be used exclusively for Zeroconf technology.

207

[25]Further information.

212

[26]Further information.

208

213

209

214

Starting with version 0.5, nss-mdns has a simple configuration file

210

215

/etc/mdns.allow for enabling name lookups via mDNS in other domains

233

238

Currently, nss-mdns is tested on Linux only. A fairly modern glibc

234

239

installation with development headers (2.0 or newer) is required. Not

235

240

suprisingly nss-mdns requires a kernel compiled with IPv4 multicasting

236

support enabled. [26]Avahi is recommended for its superior cacheing

241

support enabled. [27]Avahi is recommended for its superior cacheing

237

242

capabilities and for security reasons. Unless you compile nss-mdns

238

243

with --enable-legacy Avahi is a hard dependency when nss-mdns is used,

239

244

however not a build-time requirement.

252

257

253

258

Acknowledgements

254

259

255

SHIROYAMA Takayuki, Anand Kumria and Bastien Nocera for patches.

260

SHIROYAMA Takayuki, Anand Kumria and Bastien Nocera, Sjoerd Simons for

261

patches.

256

262

257

263

Sean Meiners for search list support.

258

264

259

265

Philipp Zabel for ARM support.

260

266

267

Bruce M Simpson for porting it to FreeBSD.

268

261

269

Download

262

270

263

271

The newest release is always available from

264

[27]http://0pointer.de/lennart/projects/nss-mdns/

265

266

The current release is [28]0.9

267

268

Get nss-mdns's development sources from the [29]Subversion

269

[30]repository ([31]viewcvs):

272

[28]http://0pointer.de/lennart/projects/nss-mdns/

273

274

The current release is [29]0.10

275

276

Get nss-mdns's development sources from the [30]Subversion

277

[31]repository ([32]viewcvs):

270

278

svn checkout svn://svn.0pointer.de/nss-mdns/trunk nss-mdns

271

279

272

280

You may find an up to date Debian package of nss-mdns on the

273

[32]Debian package repository. Many other distributions ship it, too.

281

[33]Debian package repository. Many other distributions ship it, too.

274

282

275

283

If you want to be notified whenever I release a new version of this

276

software use the subscription feature of [33]Freshmeat.

284

software use the subscription feature of [34]Freshmeat.

277

285

_________________________________________________________________

278

286

279

287

280

Lennart Poettering <mzaffzqaf (at) 0pointer (dot) de>, January 2007

288

Lennart Poettering <mzaffzqaf (at) 0pointer (dot) de>, May 2007

281

289

282

$Id: README.html.in 110 2007-01-01 18:31:50Z lennart $

290

$Id: README.html.in 116 2007-05-12 14:54:24Z lennart $

283

291

284

292

References

285

293

292

300

7. README#installation

293

301

8. README#acks

294

302

9. README#download

295

10. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.9.tar.gz

296

11. http://avahi.org/

297

12. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.8.tar.gz

298

13. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.7.tar.gz

299

14. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.6.tar.gz

300

15. http://avahi.org/

301

16. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.5.tar.gz

302

17. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.4.tar.gz

303

18. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.3.tar.gz

304

19. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.2.tar.gz

305

20. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.1.tar.gz

306

21. http://www.multicastdns.org/

307

22. http://avahi.org/

303

10. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.10.tar.gz

304

11. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.9.tar.gz

305

12. http://avahi.org/

306

13. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.8.tar.gz

307

14. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.7.tar.gz

308

15. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.6.tar.gz

309

16. http://avahi.org/

310

17. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.5.tar.gz

311

18. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.4.tar.gz

312

19. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.3.tar.gz

313

20. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.2.tar.gz

314

21. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.1.tar.gz

315

22. http://www.multicastdns.org/

308

316

23. http://avahi.org/

309

24. http://files.zeroconf.org/rfc3927.txt

310

25. http://avahi.org/wiki/AvahiAndUnicastDotLocal

311

26. http://avahi.org/

312

27. http://0pointer.de/lennart/projects/nss-mdns/

313

28. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.9.tar.gz

314

29. http://subversion.tigris.org/

315

30. svn://svn.0pointer.de/nss-mdns

316

31. http://0pointer.de/cgi-bin/viewcvs.cgi/?root=nss-mdns

317

32. http://packages.debian.org/libnss-mdns

318

33. http://freshmeat.net/projects/nss-mdns/

317

24. http://avahi.org/

318

25. http://files.zeroconf.org/rfc3927.txt

319

26. http://avahi.org/wiki/AvahiAndUnicastDotLocal

320

27. http://avahi.org/

321

28. http://0pointer.de/lennart/projects/nss-mdns/

322

29. http://0pointer.de/lennart/projects/nss-mdns/nss-mdns-0.10.tar.gz

323

30. http://subversion.tigris.org/

324

31. svn://svn.0pointer.de/nss-mdns

325

32. http://0pointer.de/cgi-bin/viewcvs.cgi/?root=nss-mdns

326

33. http://packages.debian.org/libnss-mdns

327

34. http://freshmeat.net/projects/nss-mdns/