Simple mDNS client/server library
Go to file
Martin Garton 8cfcc9a3d9 Allow timeout and cancellation via context.Context
Introduce context.Context to enable cancellation in addition to the
existing timeout functionality.  To retain compatability, Timeout is
still available but will only be used if Context is not set.

We use x/net/context.Context for the moment instead of context.Context
in order to avoid creating a requirement on Go 1.7
2016-09-29 17:46:10 +01:00
examples Add examples https://github.com/hashicorp/mdns/pull/42 2016-04-29 23:53:34 +01:00
.gitignore Updating gitignore 2014-01-29 16:17:00 -08:00
client.go Allow timeout and cancellation via context.Context 2016-09-29 17:46:10 +01:00
dns_sd_test.go Add https://github.com/hashicorp/mdns/pull/36 RFC-6762-compliant DNS-SD 2016-04-29 23:48:11 +01:00
dns_sd.go Add https://github.com/hashicorp/mdns/pull/36 RFC-6762-compliant DNS-SD 2016-04-29 23:48:11 +01:00
LICENSE There's now no owner... it is owned by the world 2016-04-30 00:08:24 +01:00
README.md godoc link 2016-04-30 10:53:26 +01:00
server_test.go Add https://github.com/hashicorp/mdns/pull/50 2016-04-29 23:34:13 +01:00
server.go Clean up probe goroutine when shutting down 2016-07-06 09:19:32 +01:00
zone_test.go Add unit test 2014-11-07 13:44:29 +01:00
zone.go Fix domain lookup in some cases 2016-07-06 10:54:33 +01:00

MDNS GoDoc

Simple mDNS client/server library in Golang. mDNS or Multicast DNS can be used to discover services on the local network without the use of an authoritative DNS server. This enables peer-to-peer discovery. It is important to note that many networks restrict the use of multicasting, which prevents mDNS from functioning. Notably, multicast cannot be used in any sort of cloud, or shared infrastructure environment. However it works well in most office, home, or private infrastructure environments.

Using the library is very simple, here is an example of publishing a service entry:

package main

import (
	"github.com/micro/mdns"
	"os"
)

func main() {

	// Setup our service export
	host, _ := os.Hostname()
	info := []string{"My awesome service"}
	service, _ := mdns.NewMDNSService(host, "_foobar._tcp", "", "", 8000, nil, info)

	// Create the mDNS server, defer shutdown
	server, _ := mdns.NewServer(&mdns.Config{Zone: service})

	defer server.Shutdown()
}

Doing a lookup for service providers is also very simple:

package main

import (
	"fmt"
	"github.com/micro/mdns"
)

func main() {

	// Make a channel for results and start listening
	entriesCh := make(chan *mdns.ServiceEntry, 8)
	go func() {
		for entry := range entriesCh {
			fmt.Printf("Got new entry: %v\n", entry)
		}
	}()

	// Start the lookup
	err := mdns.Lookup("_foobar._tcp", entriesCh)
	if err != nil {
		fmt.Println(err)
	}

	close(entriesCh)
}