NAME

       mdnsd.service — mdnsd service configuration file

SYNOPSIS

       /etc/mdns.d/*.service

DESCRIPTION

       mdnsd  needs  at  least  one  .service  file to actively announce itself.  The systems that mdnsd targets
       usually have an SSH or HTTP/HTTPS service, which can be located by end-users with mDNS-SD.   E.g.,  mdnsd
       may  be  embedded  in  your  printer,  an  access  point, an industrial switch, or other headless network
       connected device.

       Services are defined one per .service file and only two fields are mandatory:

       type TYPE
             The TYPE can be any service type from /etc/services, prefixed with an underscore.  E.g.,  'ipp'  is
             port 631/tcp, which gives the type _ipp._tcp

       port PORT
             The port is the UDP or TCP port to announce.  This can also be found in the file /etc/services.

       There are also a few optional fields supported, see below for examples:

       name STRING
             Free form string to describe service.  Usually what is presented to end users by discovery agents.

       txt STRING
             Text  records  are  free-form  strings  that  are  included  in  service announcements.  Useful for
             announcing meta data about your service.

       target URL
             URL to announce as canonical for this service.

       cname URL
             A cname is an alias that can be announced for unique service  reqords.   E.g.,  if  only  one  HTTP
             service is available on the LAN it can be reached through the full name, or using the cname alias.

EXAMPLES

       This section has some examples of mDNS service definitions.

   SSH
             # mDNS-SD advertisement of SSH service
             type _ssh._tcp
             port 22

   FTP
             # mDNS-SD advertisement of FTP service
             name Troglobit FTP Server
             type _ftp._tcp
             port 21
             txt server=uftpd
             txt version=2.6
             target ftp.luthien.local

   HTTP
             # mDNS-SD advertisement of HTTP service
             type _http._tcp
             port 80
             txt server=merecat
             txt version=2.31
             cname home.local

   Printer
             # mDNS-SD advertisement of foo._printer._tcp.local.
             type _printer._tcp
             port 515

   IPP
             # mDNS-SD advertisement of foo._ipp._tcp.local.
             type _ipp._tcp
             port 631

FILES

       /etc/services  List of standard service definitions in UNIX

SEE ALSO

       mquery(1), mdnsd(8)

AUTHORS

       This  mDNS-SD  implementation  was  initially developed by Jeremie Miller <jer@jabber.org> in 2003.  Much
       later
       Joachim Wiberg <troglobit@gmail.com> adopted it for further development and maintenance mdnsd.service  at
       GitHub: https://github.com/troglobit/mdnsd

Debian                                             Jan 4 2022                                   MDNSD.SERVICE(5)