MDNSD.SERVICE(5)

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