mdns

README

Pion mDNS

A Go implementation of mDNS

Go mDNS implementation. The original user is Pion WebRTC, but we would love to see it work for everyone.

Running Server

For a mDNS server that responds to queries for pion-test.local

go run examples/server/main.go

For a mDNS server that responds to queries for pion-test.local with a given address

go run examples/server/publish_ip/main.go -ip=[IP]

If you don't set the ip parameter, "1.2.3.4" will be used instead.

Running Client

To query using Pion you can run the query example

go run examples/query/main.go

You can use the macOS client

dns-sd -q pion-test.local

Or the avahi client

avahi-resolve -a pion-test.local

RFCs

Implemented

• RFC 6762 Multicast DNS
• draft-ietf-rtcweb-mdns-ice-candidates-02 Using Multicast DNS to protect privacy when exposing ICE candidates

Roadmap

The library is used as a part of our WebRTC implementation. Please refer to that roadmap to track our major milestones.

Community

Pion has an active community on the Slack.

Follow the Pion Twitter for project updates and important WebRTC news.

We are always looking to support your projects. Please reach out if you have something to build! If you need commercial support or don't want to use public methods you can contact us at team@pion.ly

Contributing

Check out the contributing wiki to join the group of amazing people making this project possible

License

MIT License - see LICENSE for full text

Documentation

Overview

Package mdns implements mDNS (multicast DNS)

Index

• Constants
• type Config
• type Conn
  • func Server(conn *ipv4.PacketConn, config *Config) (*Conn, error)
  • func (c *Conn) Close() error
  • func (c *Conn) Query(ctx context.Context, name string) (dnsmessage.ResourceHeader, net.Addr, error)

Constants

const (
	// DefaultAddress is the default used by mDNS
	// and in most cases should be the address that the
	// net.Conn passed to Server is bound to
	DefaultAddress = "224.0.0.0:5353"
)

Types

type Config

type Config struct {
	// QueryInterval controls how often we sends Queries until we
	// get a response for the requested name
	QueryInterval time.Duration

	// LocalNames are the names that we will generate answers for
	// when we get questions
	LocalNames []string

	// LocalAddress will override the published address with the given IP
	// when set. Otherwise, the automatically determined address will be used.
	LocalAddress net.IP

	LoggerFactory logging.LoggerFactory

	// IncludeLoopback will include loopback interfaces to be eligble for queries and answers.
	IncludeLoopback bool

	// Interfaces will override the interfaces used for queries and answers.
	Interfaces []net.Interface
}

Config is used to configure a mDNS client or server.

type Conn

type Conn struct {
	// contains filtered or unexported fields
}

Conn represents a mDNS Server

func Server

func Server(conn *ipv4.PacketConn, config *Config) (*Conn, error)

Server establishes a mDNS connection over an existing conn.

Currently, the server only supports listening on an IPv4 connection, but internally it supports answering with IPv6 AAAA records if this were ever to change.

func (*Conn) Close

func (c *Conn) Close() error

Close closes the mDNS Conn

func (*Conn) Query

func (c *Conn) Query(ctx context.Context, name string) (dnsmessage.ResourceHeader, net.Addr, error)

Query sends mDNS Queries for the following name until either the Context is canceled/expires or we get a result