Multicast DNS
In computer networking, the multicast DNS protocol resolves hostnames to IP addresses within small networks that do not include a local name server. It is a zero-configuration service, using essentially the same programming interfaces, packet formats and operating semantics as the unicast Domain Name System. Although Stuart Cheshire designed mDNS as a stand-alone protocol, it can work in concert with standard DNS servers.
The mDNS protocol is published as, uses IP multicast User Datagram Protocol packets, and is implemented by the Apple Bonjour and open source Avahi software packages, included in most Linux distributions. mDNS has also been implemented in Windows 10, initially limited to discovering networked printers, later becoming capable of resolving hostnames as well.
mDNS can work in conjunction with DNS Service Discovery, a companion zero-configuration networking technique specified separately in RFC 6763.
Protocol overview
When an mDNS client needs to resolve a hostname, it sends an IP multicast query message that asks the host having that name to identify itself. That target machine then multicasts a message that includes its IP address. All machines in that subnet can then use that information to update their mDNS caches. Any host can relinquish its claim to a name by sending a response packet with a time to live equal to zero.By default, mDNS exclusively resolves hostnames ending with the
.local top-level domain. This can cause problems if that domain includes hosts which do not implement mDNS but which can be found via a conventional unicast DNS server. Resolving such conflicts requires network-configuration changes that violate the zero-configuration goal.Packet structure
An mDNS message is a multicast UDP packet sent using the following addressing:- IPv4 address or IPv6 address
- UDP port 5353
- When using Ethernet frames, the standard IP multicast MAC address or
The header is identical to that found in unicast DNS, as are the sub-sections in the data part: queries, answers, authoritative-nameservers, and additional records. The number of records in each sub-section matches the value of the corresponding *COUNT field in the header.
Queries
The wire format for records in the query section is slightly modified from that in unicast DNS, adding the single-bit UNICAST-RESPONSE field.| Field | Description | Length bits |
| QNAME | Name of the node to which the query pertains | Variable |
| QTYPE | The type of the query, i.e. the type of RR which should be returned in responses. | 16 |
| UNICAST-RESPONSE | Boolean flag indicating whether a unicast-response is desired | 1 |
| QCLASS | Class code, 1 a.k.a. "IN" for the Internet and IP networks | 15 |
As in unicast DNS, the QNAME field consists of a series of length/value sub-fields called "labels". Each label represents one of the dot-separated substrings in a fully qualified domain name. The list is terminated by a single null-byte, representing the "root" of the DNS.
The UNICAST-RESPONSE field is used to minimize unnecessary broadcasts on the network: if the bit is set, responders SHOULD send a directed-unicast response directly to the inquiring node rather than broadcasting the response to the entire network.
The QCLASS field is identical to that found in unicast DNS.
Resource Records
All records in the answers, authoritative-nameservers, and additional records sections have the same format and are collectively known as Resource Records.Resource Records in mDNS also have a slightly modified general format compared to unicast DNS:
| Field | Description | Length bits |
| RRNAME | Name of the node to which the record pertains | Variable |
| RRTYPE | The type of the Resource Record | 16 |
| CACHE-FLUSH | Boolean flag indicating whether outdated cached records should be purged | 1 |
| RRCLASS | Class code, 1 a.k.a. "IN" for the Internet and IP networks | 15 |
| TTL | Time interval that the RR should be cached | 32 |
| RDLENGTH | Integer representing the length of the RDATA field | 16 |
| RDATA | Resource data; internal structure varies by RRTYPE | Variable |
The CACHE-FLUSH bit is used to instruct neighbor nodes that the record should overwrite, rather than be appended onto, any existing cached entries for this RRNAME and RRTYPE.
The formats of the RDATA fields are the same as those found in unicast DNS. However, DNS Service Discovery, the most common use-case for mDNS, specifies slight modifications to some of their formats.