The highest tagged major version is
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 [email protected]
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 ¶
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" )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
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
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
examples
|
|
|
query
This example program showcases the use of the mDNS client by querying a previously published address
|
This example program showcases the use of the mDNS client by querying a previously published address |
|
server
This example program showcases the use of the mDNS server by publishing "pion-test.local"
|
This example program showcases the use of the mDNS server by publishing "pion-test.local" |
|
server/publish_ip
This example program allows to set an IP that deviates from the automatically determined interface address.
|
This example program allows to set an IP that deviates from the automatically determined interface address. |