janbajanadaqri / servus

Zeroconf discovery in C++

[TOC]

Introduction

Servus is a small C++ network utility library that provides a zeroconf API, URI parsing and UUIDs.

Servus can be retrieved by cloning the source code. Please file a Bug Report if you find any issues with this release.

Features

Servus provides classes for:

• 128 bit UUIDs
• An URI class to parse strings using generic syntax from RFC3986
• Zeroconf announcement and browsing using Avahi or DNSSD
• Detailed @ref Changelog

Building

Servus is a cross-platform library, the only mandatory dependency is a C++11 compiler. Zeroconf will be available in those platforms were either Avahi or DNSSD are available, otherwise an empty dummy backend is used. Servus uses CMake to provide a platform-independent build configuration. The following platforms and build environments have been tested:

• Linux: Ubuntu 16.04, RHEL 6.8 (Makefile, Ninja)
• Windows: 7 (Visual Studio 2012)
• Mac OS X: 10.9 (Makefile, Ninja)

The following external, pre-installed optional dependencies are used:

• Boost.Test to build unit tests
• Avahi (avahi-client) or DNSSD (Apple Bonjour) for zeroconf
• Qt5 Core for servus::qt::ItemModel
• Qt5 Widgets for servusBrowser tool

Developement Dependencies

Linux:

Avahi SDK, client and utils

sudo apt-get install avahi-daemon avahi-discover avahi-utils libnss-mdns mdns-scan
sudo apt install libavahi-client-dev
sudo apt install libavahi-core-dev

Windows:

• Cmake: https://cmake.org/download/
• Bonjour DNSSD SDK 3.0.: https://developer.apple.com/download/more/?=Bonjour%20SDK%20for%20Windows
• Microsoft Visual Studio - recomanded to build.

MAC:

• Cmake: brew install cmake
• Xcode - Bonjour DNSSD SDK is coming with Xcode.
• CLion can be used to build.

Building from source is as simple as:

git clone --recursive https://github.com/janbajanadaqri/Servus.git
git submodule update --init
mkdir Servus/build
cd Servus/build
---linux and MAC makefile
cmake ..
make -j 8
---linux and MAC Ninja
cmake -GNinja ..
ninja
---windows Microsoft Visual Studio is recomanded.

Zeroconf Browsers

Linux:

• Avahi Zeroconf Browser - desktop app

or

avahi-browse -d local _daqri-test._tcp --resolve

MAC and Windows:

dns-sd -B _daqri-test._tcp .
dns-sd -R JanBajana-test _daqri-test local 4710 []