https://github.com/troglobit/mdns-alias
mDNS-SD CNAME Publisher in C
https://github.com/troglobit/mdns-alias
avahi avahi-aliases cname cname-record mdns mdns-sd
Last synced: about 1 month ago
JSON representation
mDNS-SD CNAME Publisher in C
- Host: GitHub
- URL: https://github.com/troglobit/mdns-alias
- Owner: troglobit
- License: isc
- Created: 2024-04-13T12:36:26.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-14T10:54:55.000Z (over 1 year ago)
- Last Synced: 2024-11-22T01:01:59.713Z (11 months ago)
- Topics: avahi, avahi-aliases, cname, cname-record, mdns, mdns-sd
- Language: C
- Homepage:
- Size: 21.5 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
Publish mDNS-SD Aliases
===================================
[![][3]][4] [![][5]][6] [![][7]][8]
This is a small C program that publishes mDNS CNAMEs using Avahi. It
runs as a UNIX daemon, ensuring the CNAME records are published as long
as the daemon runs.
Currently the program takes its CNAME aliases on the command line:
mdns-alias foo.local bar.local
At least one name, including `.local`, must be given on the command line.
Dependencies
------------
At run time: a running `avahi-daemon`
Build time: avahi client library and header files, and to detect it, the
`pkg-config` tool. You also need a C compiler and `make`.
Ubuntu, Mint, or other Debian based Linux distributions:
sudo apt install libavahi-client-dev pkg-config
Building
--------
This project is built using `configure` and `make`. The configure
script generates the `Makefile` for your host system, or your embedded
[target system][2]. Usually setting `--host=toolchain-prefix-` is all
you need for the `configure` script to find your cross compiler.
./configure
make
By default the configure script prepares for installing in `/usr/local`,
if you want to change that, please see `./configure --help`. To install
type:
sudo make install
Some systems no longer have `sudo`, alternatives include `su` to root,
or tools like `doas`.
> **Note:** if you do not like pre-packaged, and properly versioned,
> release tarballs, you need to have GNU autoconf and automake installed
> to be able run the `autogen.sh` script. It creates the `configure`
> script and Makefile template, which are included in the portable
> release tarballs.
Motivation
----------
For some reason the de facto standard mDNS-SD daemon in Linux, Avahi,
does not support CNAME (DNS alias) records in the configuration files
or using any of its tools. This has been covered in many repos, but
none did it better than [George Hawkins][1], I believe.
[1]: https://github.com/george-hawkins/avahi-aliases-notes
[2]: https://www.gnu.org/software/automake/manual/html_node/Cross_002dCompilation.html
[3]: https://img.shields.io/badge/License-ISC-blue.svg
[4]: https://en.wikipedia.org/wiki/ISC_license
[5]: https://github.com/troglobit/mdns-alias/actions/workflows/build.yml/badge.svg
[6]: https://github.com/troglobit/mdns-alias/actions/workflows/build.yml/
[7]: https://scan.coverity.com/projects/30083/badge.svg
[8]: https://scan.coverity.com/projects/30083