react-native-zeroconf 0.15.2 → 0.16.0

package/android/src/main/jni/mdnsresponder/mDNSPosix/ProxyResponder.c

@@ -1,300 +0,0 @@
-/* -*- Mode: C; tab-width: 4 -*-
- *
- * Copyright (c) 2002-2004 Apple Computer, Inc. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- * 
- *     http://www.apache.org/licenses/LICENSE-2.0
- * 
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#include <stdio.h>				// For printf()
-#include <stdlib.h>				// For exit() etc.
-#include <string.h>				// For strlen() etc.
-#include <unistd.h>				// For select()
-#include <signal.h>				// For SIGINT, SIGTERM
-#include <errno.h>				// For errno, EINTR
-#include <netinet/in.h>			// For INADDR_NONE
-#include <arpa/inet.h>			// For inet_addr()
-#include <netdb.h>				// For gethostbyname()
-
-#include "mDNSEmbeddedAPI.h"	// Defines the interface to the client layer above
-#include "mDNSPosix.h"			// Defines the specific types needed to run mDNS on this platform
-#include "ExampleClientApp.h"
-
-// Compatibility workaround: Solaris 2.5 has no INADDR_NONE
-#ifndef	INADDR_NONE
-#define	INADDR_NONE	(mDNSu32)0xffffffff
-#endif
-
-//*************************************************************************************************************
-// Globals
-static mDNS mDNSStorage;       // mDNS core uses this to store its globals
-static mDNS_PlatformSupport PlatformStorage;  // Stores this platform's globals
-mDNSexport const char ProgramName[] = "mDNSProxyResponderPosix";
-
-//*************************************************************************************************************
-// Proxy Host Registration
-
-typedef struct
-	{
-	mDNSv4Addr ip;
-	domainlabel hostlabel;		// Conforms to standard DNS letter-digit-hyphen host name rules
-	AuthRecord RR_A;		// 'A' (address) record for our ".local" name
-	AuthRecord RR_PTR;		// PTR (reverse lookup) record
-	} ProxyHost;
-
-mDNSlocal void HostNameCallback(mDNS *const m, AuthRecord *const rr, mStatus result)
-	{
-	ProxyHost *f = (ProxyHost*)rr->RecordContext;
-	if (result == mStatus_NoError)
-		debugf("Host name successfully registered: %##s", rr->resrec.name->c);
-	else
-		{
-		debugf("Host name conflict for %##s", rr->resrec.name->c);
-		mDNS_Deregister(m, &f->RR_A);
-		mDNS_Deregister(m, &f->RR_PTR);
-		exit(-1);
-		}
-	}
-
-mDNSlocal mStatus mDNS_RegisterProxyHost(mDNS *m, ProxyHost *p)
-	{
-	char buffer[32];
-	
-	mDNS_SetupResourceRecord(&p->RR_A,   mDNSNULL, mDNSInterface_Any, kDNSType_A,   60, kDNSRecordTypeUnique,      AuthRecordAny, HostNameCallback, p);
-	mDNS_SetupResourceRecord(&p->RR_PTR, mDNSNULL, mDNSInterface_Any, kDNSType_PTR, 60, kDNSRecordTypeKnownUnique, AuthRecordAny, HostNameCallback, p);
-
-	p->RR_A.namestorage.c[0] = 0;
-	AppendDomainLabel(&p->RR_A.namestorage, &p->hostlabel);
-	AppendLiteralLabelString(&p->RR_A.namestorage, "local");
-
-	// Note: This is reverse order compared to a normal dotted-decimal IP address, so we can't use our customary "%.4a" format code
-	mDNS_snprintf(buffer, sizeof(buffer), "%d.%d.%d.%d.in-addr.arpa.", p->ip.b[3], p->ip.b[2], p->ip.b[1], p->ip.b[0]);
-	MakeDomainNameFromDNSNameString(&p->RR_PTR.namestorage, buffer);
-	p->RR_PTR.ForceMCast = mDNStrue; // This PTR points to our dot-local name, so don't ever try to write it into a uDNS server
-
-	p->RR_A.  resrec.rdata->u.ipv4 = p->ip;
-	AssignDomainName(&p->RR_PTR.resrec.rdata->u.name, p->RR_A.resrec.name);
-
-	mDNS_Register(m, &p->RR_A);
-	mDNS_Register(m, &p->RR_PTR);
-
-	debugf("Made Proxy Host Records for %##s", p->RR_A.resrec.name->c);
-	
-	return(mStatus_NoError);
-	}
-
-//*************************************************************************************************************
-// Service Registration
-
-// This sample ServiceCallback just calls mDNS_RenameAndReregisterService to automatically pick a new
-// unique name for the service. For a device such as a printer, this may be appropriate.
-// For a device with a user interface, and a screen, and a keyboard, the appropriate
-// response may be to prompt the user and ask them to choose a new name for the service.
-mDNSlocal void ServiceCallback(mDNS *const m, ServiceRecordSet *const sr, mStatus result)
-	{
-	switch (result)
-		{
-		case mStatus_NoError:      debugf("Callback: %##s Name Registered",    sr->RR_SRV.resrec.name->c); break;
-		case mStatus_NameConflict: debugf("Callback: %##s Name Conflict",      sr->RR_SRV.resrec.name->c); break;
-		case mStatus_MemFree:      debugf("Callback: %##s Memory Free",        sr->RR_SRV.resrec.name->c); break;
-		default:                   debugf("Callback: %##s Unknown Result %ld", sr->RR_SRV.resrec.name->c, result); break;
-		}
-
-	if (result == mStatus_NoError)
-		{
-		char buffer[MAX_ESCAPED_DOMAIN_NAME];
-		ConvertDomainNameToCString(sr->RR_SRV.resrec.name, buffer);
-		printf("Service %s now registered and active\n", buffer);
-		}
-
-	if (result == mStatus_NameConflict)
-		{
-		char buffer1[MAX_ESCAPED_DOMAIN_NAME], buffer2[MAX_ESCAPED_DOMAIN_NAME];
-		ConvertDomainNameToCString(sr->RR_SRV.resrec.name, buffer1);
-		mDNS_RenameAndReregisterService(m, sr, mDNSNULL);
-		ConvertDomainNameToCString(sr->RR_SRV.resrec.name, buffer2);
-		printf("Name Conflict! %s renamed as %s\n", buffer1, buffer2);
-		}
-	}
-
-// RegisterService() is a simple wrapper function which takes C string
-// parameters, converts them to domainname parameters, and calls mDNS_RegisterService()
-mDNSlocal void RegisterService(mDNS *m, ServiceRecordSet *recordset,
-	const char name[], const char type[], const char domain[],
-	const domainname *host, mDNSu16 PortAsNumber, int argc, char **argv)
-	{
-	domainlabel n;
-	domainname t, d;
-	unsigned char txtbuffer[1024], *bptr = txtbuffer;
-	char buffer[MAX_ESCAPED_DOMAIN_NAME];
-
-	MakeDomainLabelFromLiteralString(&n, name);
-	MakeDomainNameFromDNSNameString(&t, type);
-	MakeDomainNameFromDNSNameString(&d, domain);
-	while (argc)
-		{
-		int len = strlen(argv[0]);
-		if (len > 255 || bptr + 1 + len >= txtbuffer + sizeof(txtbuffer)) break;
-		printf("STR: %s\n", argv[0]);
-		bptr[0] = len;
-		strcpy((char*)(bptr+1), argv[0]);
-		bptr += 1 + len;
-		argc--;
-		argv++;
-		}
-	
-	mDNS_RegisterService(m, recordset,
-		&n, &t, &d,					// Name, type, domain
-		host, mDNSOpaque16fromIntVal(PortAsNumber),
-		txtbuffer, bptr-txtbuffer,	// TXT data, length
-		mDNSNULL, 0,				// Subtypes
-		mDNSInterface_Any,			// Interface ID
-		ServiceCallback, mDNSNULL, 0);	// Callback, context, flags
-
-	ConvertDomainNameToCString(recordset->RR_SRV.resrec.name, buffer);
-	printf("Made Service Records for %s\n", buffer);
-	}
-
-//*************************************************************************************************************
-// Service non-existence assertion
-// (claiming a service name without actually providing a service at that name, to prevent anyone else using that name)
-// This is useful to avoid confusion between similar services
-// e.g. A printer that implements IPP printing service using the name "My Printer", but doesn't implement LPR service,
-// should also claim the LPR service name "My Printer" to stop a different printer offering LPR service under the same name,
-// since it would be confusing to users to have two equivalent services with the same name.
-
-mDNSlocal void NoSuchServiceCallback(mDNS *const m, AuthRecord *const rr, mStatus result)
-	{
-	const domainname *proxyhostname = (const domainname *)rr->RecordContext;
-	switch (result)
-		{
-		case mStatus_NoError:      debugf("Callback: %##s Name Registered",    rr->resrec.name->c); break;
-		case mStatus_NameConflict: debugf("Callback: %##s Name Conflict",      rr->resrec.name->c); break;
-		case mStatus_MemFree:      debugf("Callback: %##s Memory Free",        rr->resrec.name->c); break;
-		default:                   debugf("Callback: %##s Unknown Result %ld", rr->resrec.name->c, result); break;
-		}
-
-	if (result == mStatus_NoError)
-		{
-		char buffer[MAX_ESCAPED_DOMAIN_NAME];
-		ConvertDomainNameToCString(rr->resrec.name, buffer);
-		printf("Non-existence assertion %s now registered and active\n", buffer);
-		}
-
-	if (result == mStatus_NameConflict)
-		{
-		domainlabel n;
-		domainname t, d;
-		char buffer1[MAX_ESCAPED_DOMAIN_NAME], buffer2[MAX_ESCAPED_DOMAIN_NAME];
-		ConvertDomainNameToCString(rr->resrec.name, buffer1);
-		DeconstructServiceName(rr->resrec.name, &n, &t, &d);
-		IncrementLabelSuffix(&n, mDNStrue);
-		mDNS_RegisterNoSuchService(m, rr, &n, &t, &d, proxyhostname, mDNSInterface_Any, NoSuchServiceCallback, mDNSNULL, mDNSfalse);
-		ConvertDomainNameToCString(rr->resrec.name, buffer2);
-		printf("Name Conflict! %s renamed as %s\n", buffer1, buffer2);
-		}
-	}
-
-mDNSlocal void RegisterNoSuchService(mDNS *m, AuthRecord *const rr, domainname *proxyhostname,
-	const char name[], const char type[], const char domain[])
-	{
-	domainlabel n;
-	domainname t, d;
-	char buffer[MAX_ESCAPED_DOMAIN_NAME];
-	MakeDomainLabelFromLiteralString(&n, name);
-	MakeDomainNameFromDNSNameString(&t, type);
-	MakeDomainNameFromDNSNameString(&d, domain);
-	mDNS_RegisterNoSuchService(m, rr, &n, &t, &d, proxyhostname, mDNSInterface_Any, NoSuchServiceCallback, proxyhostname, mDNSfalse);
-	ConvertDomainNameToCString(rr->resrec.name, buffer);
-	printf("Made Non-existence Record for %s\n", buffer);
-	}
-
-//*************************************************************************************************************
-// Main
-
-mDNSexport int main(int argc, char **argv)
-	{
-	mStatus			status;
-	sigset_t		signals;
-	
-	if (argc < 3) goto usage;
-	
-	status = mDNS_Init(&mDNSStorage, &PlatformStorage,
-		mDNS_Init_NoCache, mDNS_Init_ZeroCacheSize,
-		mDNS_Init_DontAdvertiseLocalAddresses,
-		mDNS_Init_NoInitCallback, mDNS_Init_NoInitCallbackContext);
-	if (status) { fprintf(stderr, "Daemon start: mDNS_Init failed %d\n", (int)status); return(status); }
-
-	mDNSPosixListenForSignalInEventLoop(SIGINT);
-	mDNSPosixListenForSignalInEventLoop(SIGTERM);
-
-	if (!strcmp(argv[1], "-"))
-		{
-		domainname proxyhostname;
-		AuthRecord proxyrecord;
-		if (argc < 5) goto usage;
-		proxyhostname.c[0] = 0;
-		AppendLiteralLabelString(&proxyhostname, argv[2]);
-		AppendLiteralLabelString(&proxyhostname, "local");
-		RegisterNoSuchService(&mDNSStorage, &proxyrecord, &proxyhostname, argv[3], argv[4], "local.");
-		}
-	else
-		{
-		ProxyHost proxyhost;
-		ServiceRecordSet proxyservice;
-
-		proxyhost.ip.NotAnInteger = inet_addr(argv[1]);
-		if (proxyhost.ip.NotAnInteger == INADDR_NONE)	// INADDR_NONE is 0xFFFFFFFF
-			{
-			struct hostent *h = gethostbyname(argv[1]);
-			if (h) proxyhost.ip.NotAnInteger = *(long*)h->h_addr;
-			}
-		if (proxyhost.ip.NotAnInteger == INADDR_NONE)	// INADDR_NONE is 0xFFFFFFFF
-			{
-			fprintf(stderr, "%s is not valid host address\n", argv[1]);
-			return(-1);
-			}
-	
-		MakeDomainLabelFromLiteralString(&proxyhost.hostlabel, argv[2]);
-
-		mDNS_RegisterProxyHost(&mDNSStorage, &proxyhost);
-
-		if (argc >=6)
-			RegisterService(&mDNSStorage, &proxyservice, argv[3], argv[4], "local.",
-							proxyhost.RR_A.resrec.name, atoi(argv[5]), argc-6, &argv[6]);
-		}
-
-	do 
-		{
-		struct timeval	timeout = { 0x3FFFFFFF, 0 };	// wait until SIGINT or SIGTERM
-		mDNSBool		gotSomething;
-		mDNSPosixRunEventLoopOnce(&mDNSStorage, &timeout, &signals, &gotSomething);
-		}
-	while ( !( sigismember( &signals, SIGINT) || sigismember( &signals, SIGTERM)));
-
-	mDNS_Close(&mDNSStorage);
-
-	return(0);
-
-usage:
-	fprintf(stderr, "%s ip hostlabel [srvname srvtype port txt [txt ...]]\n", argv[0]);
-	fprintf(stderr, "ip        Real IP address (or valid host name) of the host where the service actually resides\n");
-	fprintf(stderr, "hostlabel First label of the dot-local host name to create for this host, e.g. \"foo\" for \"foo.local.\"\n");
-	fprintf(stderr, "srvname   Descriptive name of service, e.g. \"Stuart's Ink Jet Printer\"\n");
-	fprintf(stderr, "srvtype   IANA service type, e.g. \"_ipp._tcp\" or \"_ssh._tcp\", etc.\n");
-	fprintf(stderr, "port      Port number where the service resides (1-65535)\n");
-	fprintf(stderr, "txt       Additional name/value pairs specified in service definition, e.g. \"pdl=application/postscript\"\n");
-	fprintf(stderr, "e.g. %s 169.254.12.34 thehost                                (just create a dot-local host name)\n", argv[0]);
-	fprintf(stderr, "or   %s 169.254.12.34 thehost \"My Printer\" _printer._tcp. 515 rp=lpt1 pdl=application/postscript\n", argv[0]);
-	fprintf(stderr, "or   %s -             thehost \"My Printer\" _printer._tcp.           (assertion of non-existence)\n", argv[0]);
-	return(-1);
-	}

package/android/src/main/jni/mdnsresponder/mDNSPosix/ReadMe.txt

@@ -1,314 +0,0 @@
-ReadMe About mDNSPosix
-----------------------
-
-mDNSPosix is a port of Apple's Multicast DNS and DNS Service Discovery
-code to Posix platforms.
-
-Multicast DNS and DNS Service Discovery are technologies that allow you
-to register IP-based services and browse the network for those services.
-For more information about mDNS, see the mDNS web site.
-
-  <http://www.multicastdns.org/>
-
-Multicast DNS is part of a family of technologies resulting from the
-efforts of the IETF Zeroconf working group.  For information about
-other Zeroconf technologies, see the Zeroconf web site.
-
-  <http://www.zeroconf.org/>
-
-Apple uses the trade mark "Bonjour" to describe our implementation of
-Zeroconf technologies.  This sample is designed to show how easy it is
-to make a device "Bonjour compatible".
-
-The "Bonjour" trade mark can also be licensed at no charge for
-inclusion on your own products, packaging, manuals, promotional
-materials, or web site. For details and licensing terms, see
-
-  <http://developer.apple.com/bonjour/>
-
-The code in this sample was compiled and tested on Mac OS X (10.1.x,
-10.2, 10.3), Solaris (SunOS 5.8), Linux (Redhat 2.4.9-21, Fedora Core 1), 
-and OpenBSD (2.9). YMMV.
-
-
-Packing List
-------------
-
-The sample uses the following directories:
-
-o mDNSCore -- A directory containing the core mDNS code.  This code
-  is written in pure ANSI C and has proved to be very portable.
-  Every platform needs this core protocol engine code.
-
-o mDNSShared -- A directory containing useful code that's not core to
-  the main protocol engine itself, but nonetheless useful, and used by
-  more than one (but not necessarily all) platforms.
-
-o mDNSPosix -- The files that are specific to Posix platforms: Linux,
-  Solaris, FreeBSD, NetBSD, OpenBSD, etc. This code will also work on
-  OS X, though that's not its primary purpose.
-
-o Clients -- Example client code showing how to use the API to the
-  services provided by the daemon.
-
-
-Building the Code
------------------
-
-The sample does not use autoconf technology, primarily because I didn't
-want to delay shipping while I learnt how to use it.  Thus the code
-builds using a very simple make file.  To build the sample you should
-cd to the mDNSPosix directory and type "make os=myos", e.g.
-
-    make os=panther
-
-For Linux you would change that to:
-
-    make os=linux
-
-There are definitions for each of the platforms I ported to.  If you're
-porting to any other platform please add appropriate definitions for it
-and send us the diffs so they can be incorporated into the main
-distribution.
-
-
-Using the Sample
-----------------
-When you compile, you will get:
-
-o Main products for general-purpose use (e.g. on a desktop computer):
-  - mdnsd
-  - libmdns
-  - nss_mdns (See nss_ReadMe.txt for important information about nss_mdns)
-
-o Standalone products for dedicated devices (printer, network camera, etc.)
-  - mDNSClientPosix
-  - mDNSResponderPosix
-  - mDNSProxyResponderPosix
-
-o Testing and Debugging tools
-  - dns-sd command-line tool (from the "Clients" folder)
-  - mDNSNetMonitor
-  - mDNSIdentify
-
-As root type "make install" to install eight things:
-o mdnsd                   (usually in /usr/sbin)
-o libmdns                 (usually in /usr/lib)
-o dns_sd.h                (usually in /usr/include)
-o startup scripts         (e.g. in /etc/rc.d)
-o manual pages            (usually in /usr/share/man)
-o dns-sd tool             (usually in /usr/bin)
-o nss_mdns                (usually in /lib)
-o nss configuration files (usually in /etc)
-
-The "make install" concludes by executing the startup script
-(usually "/etc/init.d/mdns start") to start the daemon running.
-You shouldn't need to reboot unless you really want to.
-
-Once the daemon is running, you can use the dns-sd test tool
-to exercise all the major functionality of the daemon. Running
-"dns-sd" with no arguments gives a summary of the available options.
-This test tool is also described in detail, with several examples,
-in Chapter 6 of the O'Reilly "Zero Configuration Networking" book.
-
-
-How It Works
-------------
-                                                   +--------------------+
-                                                   | Client Application |
-   +----------------+                              +--------------------+
-   |  uds_daemon.c  | <--- Unix Domain Socket ---> |      libmdns       |
-   +----------------+                              +--------------------+
-   |    mDNSCore    |
-   +----------------+
-   |  mDNSPosix.c   |
-   +----------------+
-
-mdnsd is divided into three sections.
-
-o mDNSCore is the main protocol engine
-o mDNSPosix.c provides the glue it needs to run on a Posix OS
-o uds_daemon.c exports a Unix Domain Socket interface to
-  the services provided by mDNSCore
-
-Client applications link with the libmdns, which implements the functions
-defined in the dns_sd.h header file, and implements the IPC protocol
-used to communicate over the Unix Domain Socket interface to the daemon.
-
-Note that, strictly speaking, nss_mdns could be just another client of
-mdnsd, linking with libmdns just like any other client. However, because
-of its central role in the normal operation of multicast DNS, it is built
-and installed along with the other essential system support components.
-
-
-Clients for Embedded Systems
-----------------------------
-
-For small devices with very constrained resources, with a single address
-space and (typically) no virtual memory, the uds_daemon.c/UDS/libmdns
-layer may be eliminated, and the Client Application may live directly
-on top of mDNSCore:
-
-    +--------------------+
-    | Client Application |
-    +--------------------+
-    |      mDNSCore      |
-    +--------------------+
-    |    mDNSPosix.c     |
-    +--------------------+
-
-Programming to this model is more work, so using the daemon and its
-library is recommended if your platform is capable of that.
-
-The runtime behaviour when using the embedded model is as follows:
-
-1. The application calls mDNS_Init, which in turns calls the platform
-   (mDNSPlatformInit).
-
-2. mDNSPlatformInit gets a list of interfaces (get_ifi_info) and registers
-   each one with the core (mDNS_RegisterInterface).  For each interface
-   it also creates a multicast socket (SetupSocket).
-
-3. The application then calls select() repeatedly to handle file descriptor
-   events. Before calling select() each time, the application calls
-   mDNSPosixGetFDSet() to give mDNSPosix.c a chance to add its own file
-   descriptors to the set, and then after select() returns, it calls
-   mDNSPosixProcessFDSet() to give mDNSPosix.c a chance to receive and
-   process any packets that may have arrived.
-
-4. When the core needs to send a UDP packet it calls
-   mDNSPlatformSendUDP.  That routines finds the interface that
-   corresponds to the source address requested by the core, and
-   sends the datagram using the UDP socket created for the
-   interface.  If the socket is flow send-side controlled it just
-   drops the packet.
-
-5. When SocketDataReady runs it uses a complex routine,
-   "recvfrom_flags", to actually receive the packet.  This is required
-   because the core needs information about the packet that is
-   only available via the "recvmsg" call, and that call is complex
-   to implement in a portable way.  I got my implementation of
-   "recvfrom_flags" from Stevens' "UNIX Network Programming", but
-   I had to modify it further to work with Linux.
-
-One thing to note is that the Posix platform code is very deliberately
-not multi-threaded.  I do everything from a main loop that calls
-"select()".  This is good because it avoids all the problems that often
-accompany multi-threaded code. If you decide to use threads in your
-platform, you will have to implement the mDNSPlatformLock() and
-mDNSPlatformUnlock() calls which are currently no-ops in mDNSPosix.c.
-
-
-Once you've built the embedded samples you can test them by first
-running the client, as shown below.
-
-  quinn% build/mDNSClientPosix
-  Hit ^C when you're bored waiting for responses.
-
-By default the client starts a search for AppleShare servers and then
-sits and waits, printing a message when services appear and disappear.
-
-To continue with the test you should start the responder in another
-shell window.
-
-  quinn% build/mDNSResponderPosix -n Foo
-
-This will start the responder and tell it to advertise a AppleShare
-service "Foo".  In the client window you will see the client print out
-the following as the service shows up on the network.
-
-  quinn% build/mDNSClientPosix
-  Hit ^C when you're bored waiting for responses.
-  *** Found name = 'Foo', type = '_afpovertcp._tcp.', domain = 'local.'
-
-Back in the responder window you can quit the responder cleanly using
-SIGINT (typically ^C).
-
-  quinn% build/mDNSResponderPosix -n Foo
-  ^C
-  quinn%
-
-As the responder quits it will multicast that the "Foo" service is
-disappearing and the client will see that notification and print a
-message to that effect (shown below).  Finally, when you're done with
-the client you can use SIGINT to quit it.
-
-  quinn% build/mDNSClientPosix
-  Hit ^C when you're bored waiting for responses.
-  *** Found name = 'Foo', type = '_afpovertcp._tcp.', domain = 'local.'
-  *** Lost  name = 'Foo', type = '_afpovertcp._tcp.', domain = 'local.'
-  ^C
-  quinn%
-
-If things don't work, try starting each program in verbose mode (using
-the "-v 1" option, or very verbose mode with "-v 2") to see if there's
-an obvious cause.
-
-That's it for the core functionality.  Each program supports a variety
-of other options.  For example, you can advertise and browse for a
-different service type using the "-t type" option.  Use the "-?" option
-on each program for more user-level information.
-
-
-Caveats
--------
-Currently the program uses a simple make file.
-
-The Multicast DNS protocol can also operate locally over the loopback
-interface, but this exposed some problems with the underlying network
-stack in early versions of Mac OS X and may expose problems with other
-network stacks too.
-
-o On Mac OS X 10.1.x the code failed to start on the loopback interface
-  because the IP_ADD_MEMBERSHIP option returns ENOBUFS.
-
-o On Mac OS X 10.2 the loopback-only case failed because
-  "sendto" calls fails with error EHOSTUNREACH. (3016042)
-
-Consequently, the code will attempt service discovery on the loopback
-interface only if no other interfaces are available.
-
-I haven't been able to test the loopback-only case on other platforms
-because I don't have access to the physical machine.
-
-
-Licencing
----------
-This source code is Open Source; for details see the "LICENSE" file.
-
-Credits and Version History
----------------------------
-If you find any problems with this sample, mail <dts@apple.com> and I
-will try to fix them up.
-
-1.0a1 (Jul 2002) was a prerelease version that was distributed
-internally at Apple.
-
-1.0a2 (Jul 2002) was a prerelease version that was distributed
-internally at Apple.
-
-1.0a3 (Aug 2002) was the first shipping version.  The core mDNS code is
-the code from Mac OS 10.2 (Jaguar) GM.
-
-Share and Enjoy
-
-Apple Developer Technical Support
-Networking, Communications, Hardware
-
-6 Aug 2002
-
-Impact: A local network user may cause a denial of the Bonjour service
-Description: An error handling issue exists in the Bonjour Namespace
-Provider. A local network user may send a maliciously crafted multicast
-DNS packet leading to an unexpected termination of the Bonjour service.
-This update addresses the issue by performing additional validation of
-multicast DNS packets. This issue does not affect systems running Mac OS
-X or Windows.
-CVE-ID
-CVE-2011-0220 : JaeSeung Song of the Department of Computing at Imperial
-College London
-
-To Do List
-----------
-• port to a System V that's not Solaris
-• use sig_atomic_t for signal to main thread flags