xref: /titanic_44/usr/src/lib/libdns_sd/README (revision 4b22b9337f359bfd063322244f5336cc7c6ffcfa)
1*4b22b933Srs200217#
2*4b22b933Srs200217# Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
3*4b22b933Srs200217# Use is subject to license terms.
4*4b22b933Srs200217#
5*4b22b933Srs200217# CDDL HEADER START
6*4b22b933Srs200217#
7*4b22b933Srs200217# The contents of this file are subject to the terms of the
8*4b22b933Srs200217# Common Development and Distribution License (the "License").
9*4b22b933Srs200217# You may not use this file except in compliance with the License.
10*4b22b933Srs200217#
11*4b22b933Srs200217# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
12*4b22b933Srs200217# or http://www.opensolaris.org/os/licensing.
13*4b22b933Srs200217# See the License for the specific language governing permissions
14*4b22b933Srs200217# and limitations under the License.
15*4b22b933Srs200217#
16*4b22b933Srs200217# When distributing Covered Code, include this CDDL HEADER in each
17*4b22b933Srs200217# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
18*4b22b933Srs200217# If applicable, add the following below this CDDL HEADER, with the
19*4b22b933Srs200217# fields enclosed by brackets "[]" replaced with your own identifying
20*4b22b933Srs200217# information: Portions Copyright [yyyy] [name of copyright owner]
21*4b22b933Srs200217#
22*4b22b933Srs200217# CDDL HEADER END
23*4b22b933Srs200217#
24*4b22b933Srs200217#ident	"%Z%%M%	%I%	%E% SMI"
25*4b22b933Srs200217#
26*4b22b933Srs200217
27*4b22b933Srs200217Multicast DNS and Service Discovery support in Solaris using the
28*4b22b933Srs200217Apple Bonjour source code (v107.6). Apple Bonjour source can be
29*4b22b933Srs200217downloaded from:
30*4b22b933Srs200217 	http://developer.apple.com/networking/bonjour/download/
31*4b22b933Srs200217The following components are integrated from the Apple Bonjour
32*4b22b933Srs200217source in Solaris:
33*4b22b933Srs200217  libdns_sd: 	usr/src/lib/libdns_sd <dns_sd.h>
34*4b22b933Srs200217  libjdns_sd:   usr/src/lib/libdns_sd/java/common
35*4b22b933Srs200217  dnssd.jar:    usr/src/lib/libdns_sd/java/com (incl. examples)
36*4b22b933Srs200217  mdnsd:	usr/src/cmd/cmd-inet/usr.lib/mdnsd
37*4b22b933Srs200217  dns-sd:	usr/src/cmd/cmd-inet/usr.bin/dns-sd.c
38*4b22b933Srs200217
39*4b22b933Srs200217Following fixes have been made to the Apple Bonjour source
40*4b22b933Srs200217integrated in Solaris:
41*4b22b933Srs200217* 64-bit support by adding pad bytes in ipc_msg_hdr_struct
42*4b22b933Srs200217* 64-bit support in libjdns_sd, dnssd.jar (JNISupport.c, DNSSD.java)
43*4b22b933Srs200217* mdnsd switches to user 'noaccess' and not 'nobody' after init
44*4b22b933Srs200217* Fixes to support IPv6 (mDNSPosix.c, mDNSUNP.c)
45*4b22b933Srs200217* Fix error raised when uDNS.c is compiled with Sun Studio compiler
46*4b22b933Srs200217* Fix in dnssd_clientstub.c to not check errno when recvmsg returns 0
47*4b22b933Srs200217* mDNSDebug.c modified to not send msgs directly to console when
48*4b22b933Srs200217  syslog call returns an error. Logs the messages at LOG_INFO level
49*4b22b933Srs200217  and not LOG_ERR
50*4b22b933Srs200217
51*4b22b933Srs200217In addition the project introduces the following changes:
52*4b22b933Srs200217* A new nss_mdns module is introduced to use Multicast DNS (mdns)
53*4b22b933Srs200217  for resolving link-local hostnames and is located at:
54*4b22b933Srs200217    usr/src/lib/nsswitch/mdns
55*4b22b933Srs200217* snoop updated to decode mDNS packets
56*4b22b933Srs200217* updated /etc/services to include mdns
57*4b22b933Srs200217* <netinet/in.h> updated to include mdns
58*4b22b933Srs200217* svc:/network/dns/multicast:default introduced to manage mDNS daemon
59*4b22b933Srs200217* solaris.smf.manage.mdns & solaris.smf.value.mdns authorizations
60*4b22b933Srs200217  to modify nss_mdns configuration in svc:/network/dns/multicast:default
61*4b22b933Srs200217  Both authorizations added in network management execution profile.
62*4b22b933Srs200217* Default nsswitch.dns includes mdns as source for hosts & ipnodes
63*4b22b933Srs200217* nscd daemon updated to support mdns
64*4b22b933Srs200217* SUNWdsdu and SUNWdsdr packages deliver all the new mDNS
65*4b22b933Srs200217  service discovery components.
66