{"id":16164306,"url":"https://github.com/troglobit/mdnsd","last_synced_at":"2025-03-16T10:30:40.944Z","repository":{"id":43069892,"uuid":"49600446","full_name":"troglobit/mdnsd","owner":"troglobit","description":"Jeremie Miller's original mdnsd","archived":false,"fork":false,"pushed_at":"2023-10-16T04:37:15.000Z","size":447,"stargazers_count":61,"open_issues_count":14,"forks_count":37,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-02-27T07:30:50.880Z","etag":null,"topics":["linux-daemon","mdns","mdns-sd","mdnsresponder","unix-daemon"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/troglobit.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["troglobit"]}},"created_at":"2016-01-13T20:40:04.000Z","updated_at":"2024-12-19T11:03:20.000Z","dependencies_parsed_at":"2023-01-31T00:01:30.004Z","dependency_job_id":null,"html_url":"https://github.com/troglobit/mdnsd","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/troglobit%2Fmdnsd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/troglobit%2Fmdnsd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/troglobit%2Fmdnsd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/troglobit%2Fmdnsd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/troglobit","download_url":"https://codeload.github.com/troglobit/mdnsd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243809888,"owners_count":20351407,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux-daemon","mdns","mdns-sd","mdnsresponder","unix-daemon"],"created_at":"2024-10-10T02:46:08.022Z","updated_at":"2025-03-16T10:30:40.632Z","avatar_url":"https://github.com/troglobit.png","language":"C","funding_links":["https://github.com/sponsors/troglobit"],"categories":[],"sub_categories":[],"readme":"mdnsd - embeddable Multicast DNS Daemon\n=======================================\n[![License svg][]][License] [![Repology svg][]][Repology] [![GitHub svg][]][GitHub] [![Coverity svg][]][Coverity]\n\n- [About](#about)\n- [Usage](#usage)\n  - [Service Records](#service-records)\n- [Build \u0026 Install](#build--install)\n- [Origin \u0026 References](#origin--references)\n\n\nAbout\n-----\n\n[Jeremie Miller's][jeremie] original mDNS/mDNS-SD library daemon.\n\n\u003e Download a [versioned relased tarball][releases] (not a GitHub zip) to\n\u003e unlock a fully supported version.  Hardcore devs. can proceed to clone\n\u003e the GIT repository, see below for help.\n\n\nUsage\n-----\n\nmdnsd by default reads service definitions from `/etc/mdns.d/*`, but a\ndifferent path can be given, which may be a directory or a single file.\n\n    Usage: mdnsd [-hnpsv] [-i IFACE] [-l LEVEL] [-t TTL] [PATH]\n    \n        -h        This help text\n        -i IFACE  Announce services only on this interface, default: all\n        -l LEVEL  Set log level: none, err, notice (default), info, debug\n        -n        Run in foreground, do not detach from controlling terminal\n        -s        Use syslog even if running in foreground\n        -t TTL    Set TTL of mDNS packets, default: 1 (link-local only)\n        -v        Show program version\n    \n    Bug report address: https://github.com/troglobit/mdnsd/issues\n\nBy default mdnsd daemonizes, detaches from the controlling terminal and\ncontinues running in the background, logging errors (or debug messages\nif enabled) to the systmem log.  There is no output to be expected.  On\nGNU/Linux, use `mdns-scan`, the bundled `mquery` tool, or Wireshark to\nverify your setup.  Other operating systems have their own set of tools\nfor mDNS-SD and mdnsd may not even have a place there.\n\nmdnsd runs on all multicast enabled system interfaces.  It can be limted\nto run on only one using the `-i IFACE` command line option.  Starting\nmdnsd early in the boot process, when the interface may not yet have\nacquired an IP address, or the interface itself may not even exist yet,\nmdnsd handles this by periodically probing for interface changes.\n\nSee the file [API.md][] for pointers on how to use the mDNS library.\n\n\n### Service Records\n\nThis section provides a couple of service record examples.  The syntax\nof the files is fairly free form.  Optional directives: `name`, `txt`,\n`target`, and `cname`.\n\n\u003e **Note:** you need at least one service record for `mdnsd` to respond\n\u003e to queries from, e.g., `mdns-scan`.\n\n_FTP service example:_\n\n    # /etc/mdns.d/ftp.service -- mDNS-SD advertisement of FTP service\n    name Troglobit FTP Server\n    type _ftp._tcp\n    port 21\n    txt server=uftpd\n    txt version=2.6\n    target ftp.luthien.local\n    cname ftp.local\n\n_HTTP service example:_\n\n    # /etc/mdns.d/http.service -- mDNS-SD advertisement of HTTP service\n    name Troglobit HTTP Server\n    type _http._tcp\n    port 80\n    txt server=merecat\n    txt version=2.31\n    target www.luthien.local\n    cname home.local\n\n_SSH service example:_\n\n    # /etc/mdns.d/http.service -- mDNS-SD advertisement of SSH service\n    name Dropbear SSH Server\n    type _ssh._tcp\n    port 22\n\n\nBuild \u0026 Install\n---------------\n\nThis project is built for and developed on GNU/Linux systems, but should\nwork on any UNIX[^1] like system.  Use the standard GNU configure script\nto create a Makefile for your system and then call make.\n\n    ./configure\n    make all\n    make install\n\nUsers who checked out the source from GitHub must run `./autogen.sh`\nfirst to create the configure script.  This requires GNU autotools and\n`pkg-config` to be installed on the build system.  For the test suite\nyou also need `libcmocka-dev`.\n\nIf you install to the default location used by the configure script,\nthe library is installed in `/usr/local/lib`, which may not be in\nthe default search path for your system.  Depending on the C library\nused, the file `/etc/ld.so.conf` may exist (there may also be a\nsub-directory).  If `/usr/local/lib` is already listed there, you\nmay need to update the cache:\n\n    ldconfig -v |grep mdnsd\n\nIf you don't get any output from the above command, the ld.so.conf needs\nupdating, or you may not be using the GNU C library.\n\n[^1]: Builds and runs fine on: FreeBSD, NetBSD, OpenBSD, DragonFly BSD,\n    and Illumos/SmartOS.\n\n\nOrigin \u0026 References\n-------------------\n\nThis mDNS-SD implementation was developed by [Jeremie Miller][jeremie]\nin 2003, originally [announced on the rendezvous-dev][announced] mailing\nlist.  The original name was 'mhttp'.  It has many forks and has been\nused by many other applications over the years.\n\nThe GitHub project is an attempt by [Joachim Wiberg][troglobit] to clean\nup the original code base, develop it further, and maintain it for the\nlong haul under the name `mdnsd`.\n\n[jeremie]:      https://github.com/quartzjer\n[troglobit]:    https://github.com/troglobit\n[releases]:     https://github.com/troglobit/mdnsd/releases\n[announced]:    https://web.archive.org/web/20140115142008/http://lists.apple.com/archives/rendezvous-dev/2003/Feb/msg00062.html\n[API.md]:       https://github.com/troglobit/mdnsd/blob/master/API.md\n[License]:      https://en.wikipedia.org/wiki/BSD_licenses\n[License svg]:  https://img.shields.io/badge/License-BSD%203--Clause-blue.svg\n[Repology]:     https://repology.org/project/mdnsd/versions\n[Repology svg]: https://repology.org/badge/tiny-repos/mdnsd.svg\n[GitHub]:       https://github.com/troglobit/mdnsd/actions/workflows/build.yml/\n[GitHub svg]:   https://github.com/troglobit/mdnsd/actions/workflows/build.yml/badge.svg\n[Coverity]:     https://scan.coverity.com/projects/20680\n[Coverity svg]: https://scan.coverity.com/projects/20680/badge.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftroglobit%2Fmdnsd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftroglobit%2Fmdnsd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftroglobit%2Fmdnsd/lists"}