Simple mDNS client/server library
Go to file
Red Daly 68622dea49 Make mDNS server response more compatible with RFC 6762 spec.
- dns.Msg construction is now explicit, with comments pointing to the RFC about
  the values of each field.
- dns.Msg responses no longer contain a Question section, which is not allowed
  according to the spec.
- handleQuestion's interface returns both unicast and multicast answer records.
  (Note: These are not yet treated differently by the sendResponse method.)
- removed unused error return value of handleQuestion
2014-10-17 15:42:54 -07:00
.gitignore Updating gitignore 2014-01-29 16:17:00 -08:00
client.go Refactor client.go. 2014-10-15 14:49:00 -07:00
LICENSE Initial commit 2014-01-29 11:39:18 -08:00
README.md Update example in README 2014-09-11 14:18:46 +02:00
server_test.go Update tests to incorporate the latest library changes 2014-09-11 14:18:27 +02:00
server.go Make mDNS server response more compatible with RFC 6762 spec. 2014-10-17 15:42:54 -07:00
zone_test.go Update tests to incorporate the latest library changes 2014-09-11 14:18:27 +02:00
zone.go General bug fixes to pass tests 2014-09-11 14:32:24 +02:00

mdns

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:

// Setup our service export
host, _ := os.Hostname()
service := &mdns.MDNSService{
    Instance: host,
    Service: "_foobar._tcp",
    Port:    8000,
    Info:    "My awesome service",
}
service.Init()

// 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:

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

// Start the lookup
mdns.Lookup("_foobar._tcp", entriesCh)
close(entriesCh)