Introduction

This is a fork from https://bitbucket.org/geekman/tinysvcmdns. It works under Windows, OSX, and Linux (x86, x86_64, arm and aarch64) and with VisualStudio.

I've added a function to stop a registered service, send bye-bye packet and properly release all allocated memory

I've also added a small real responder

Building

The bin/ directory contains pre-built binary, but you can easily re-generate them all. Under lib/, there is a set of libraries that can be used by 3rd party application to incorporate this as a mDNS responder. (see for example https://github.com/philippe44/AirConnect)

To cross-compile, add the following compilers

x86     => sudo apt install gcc make gcc-i686-linux-gnu binutils-i686-linux-gnu
aarch64 => sudo apt install gcc make gcc-aarch64-linux-gnu binutils-aarch64-linux-gnu
arm     => sudo apt install gcc make gcc-arm-linux-gnueabi binutils-aarch64-linux-gnueabi

Do not use gcc-multilib to get arm/aarch64 cross-compile together with x86 on a x86_64 Debian-based distro, it will not work, they are multually exclusive. Instead use "gcc-i86-linux-gnu". Of course, you loose the benefit of compiling with the 64 bits compile and use -m32 switch

----------------------------- original README -----------------------------

tinysvcmdns

tinysvcmdns is a tiny MDNS responder implementation for publishing services.

This implementation is only concerned with publishing services, without a system-wide daemon like Bonjour or Avahi. Its other goal is to be extremely small, embeddable, and have no external dependencies.

It only answers queries related to its own hostname (the A record), the service PTRs, and the "_services.dns-sd._udp.local" name, which advertises all services on a particular host.

Services consist of a single SRV and TXT record.

Decoding of MDNS packets is only done to retrieve the questions and answer RRs. The purpose for decoding answer RRs is to make sure the service PTR is not sent out if it is already included in the answer RRs.

It also only utilizes multicast packets, so no "QU" queries are accepted.

There is no name collision detection, so this means no queries are generated before publishing the services. However compliant responders will avoid using our names, since the implementation will respond to queries that match our name.

TODO

• better, more stable & complete API
• name collision detection

FILES

• mdns.c - provides data structures, parsing & encoding of MDNS packets
• mdnsd.c - implements the server socket, communication and thread
• testmdnsd.c - an example that creates an instance until terminated

LICENSE

tinysvcmdns is licensed under the 3-clause ("modified") BSD License.

Copyright (C) 2011 Darell Tan

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.