- trixie 0.12-5
- trixie-backports 1.2-1~bpo13+1
- testing 1.2-1
- unstable 1.2-1
| MDNSD(8) | System Manager's Manual (smm) | MDNSD(8) |
NAME¶
mdnsd — small
multicast DNS daemon
SYNOPSIS¶
mdnsd |
[-hnsv] [-g
GROUP] [-H
NAME] [-i
IFACE] [-l
LEVEL] [-p
FILE] [-t
TTL] [-u
USER] [PATH] |
DESCRIPTION¶
mdnsd is a small mDNS-SD daemon for UNIX
like systems. It is based on an original implementation made by Jeremie
Miller in 2003. Multicast DNS is an open standard defined in RFC6762, with
service discovery (-SD) in RFC6763, commonly known to end-users as Bonjour
or Avahi, depending on the operating system.
mdnsd reads service definitions of
services to announce from /etc/mdns.d/*.service, a
different path may be given on the command line, which can be a directory or
a single service file.
mdnsd by default runs on all multicast
capable interfaces on a system, over both IPv4 and IPv6. Use
-i IFACE to only run on a
single interface.
mdnsd advertises and answers for the local
host and its services; it does not make the system resolver mDNS-aware. To
resolve .local names on the host, install
libnss-mdns and add it to nsswitch.conf(5).
OPTIONS¶
This program follows the usual UNIX command line syntax. The options are as follows:
-gGROUP- Group to drop privileges to after start. See
-ufor details. -HNAME- Hostname to advertise, default: the system hostname.
-h- Print a help message and exit.
-iIFACE- Interface to announce services on. By default
mdnsdruns on all interfaces.Only available on Linux.
-lLEVEL- Set log level: none, err, notice (default), info, debug.
-n- Run in foreground, do not detach from controlling terminal.
-pFILE- Path to the pid file, default: /run/mdnsd.pid.
When dropping privileges, point this at a directory the target user may
write to, so the file can be updated on
SIGHUPand removed at exit. -s- Use syslog even if running in foreground.
-tTTL- Set TTL of mDNS packets, default: 1 (link-local only).
-uUSER- User to drop privileges to after start. Must be started as root.
mdnsdneeds no special privileges to answer over mDNS, so it can also be started directly as a non-root user. The only privileged operation is the-iIFACE filter, which usesSO_BINDTODEVICEand thus needs theCAP_NET_RAWcapability; grant it out-of-band, e.g. withAmbientCapabilities=CAP_NET_RAWin the systemd unit. Without it the daemon still runs, but listens on all interfaces and logs a warning. -v- Show program version, along with the project homepage and the address for bug reports.
FILES¶
- /etc/mdns.d/*.service
- mDNS-SD services to announce.
- /run/mdnsd.pid
- Process ID of the running daemon, see
-p.
SEE ALSO¶
AUTHORS¶
This mDNS-SD implementation was created in 2003 by
Jeremie Miller ⟨jer@jabber.org⟩. Much
later, in 2016, it was adopted by
Joachim Wiberg ⟨troglobit@gmail.com⟩ for
further development and maintenance at GitHub:
⟨https://github.com/troglobit/mdnsd⟩.
| Jul 24 2026 | Nixpkgs |