Simple mDNS client/server library
Go to file
Armon Dadgar 66d411ff65 Merge pull request #9 from richtr/handle_multiple_mdns_questions
Handle multiple mDNS questions as allowed in RFC6762
2014-09-13 15:34:14 -07:00
.gitignore Updating gitignore 2014-01-29 16:17:00 -08:00
client.go Fixing issue with query flooding 2014-07-10 10:58:39 -07:00
LICENSE Initial commit 2014-01-29 11:39:18 -08:00
README.md Filling in the readme 2014-01-29 16:16:47 -08:00
server_test.go Adding ability to set multicast query interface 2014-02-25 14:16:06 -08:00
server.go Handle multiple mDNS questions as allowed in RFC6762 2014-09-11 13:26:27 +02:00
zone_test.go Adding zones with tests 2014-01-29 14:28:46 -08:00
zone.go Increase default TTL to 10 seconds. Fixes #3. 2014-05-23 10:34:25 -07: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",
    Addr:    []byte{127,0,0,1},
    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)