1 ;;; GNU Guix --- Functional package management for GNU
2 ;;; Copyright © 2014, 2015, 2016, 2017, 2018, 2019, 2020 Ludovic Courtès <ludo@gnu.org>
4 ;;; This file is part of GNU Guix.
6 ;;; GNU Guix is free software; you can redistribute it and/or modify it
7 ;;; under the terms of the GNU General Public License as published by
8 ;;; the Free Software Foundation; either version 3 of the License, or (at
9 ;;; your option) any later version.
11 ;;; GNU Guix is distributed in the hope that it will be useful, but
12 ;;; WITHOUT ANY WARRANTY; without even the implied warranty of
13 ;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 ;;; GNU General Public License for more details.
16 ;;; You should have received a copy of the GNU General Public License
17 ;;; along with GNU Guix. If not, see <http://www.gnu.org/licenses/>.
19 (define-module (gnu services avahi)
20 #:use-module (gnu services)
21 #:use-module (gnu services base)
22 #:use-module (gnu services shepherd)
23 #:use-module (gnu services dbus)
24 #:use-module (gnu system shadow)
25 #:use-module (gnu packages avahi)
26 #:use-module (gnu packages admin)
27 #:use-module (guix deprecation)
28 #:use-module (guix records)
29 #:use-module (guix gexp)
30 #:export (avahi-configuration
33 avahi-configuration-avahi
34 avahi-configuration-debug?
35 avahi-configuration-host-name
36 avahi-configuration-publish?
37 avahi-configuration-publish-workstation?
38 avahi-configuration-ipv4?
39 avahi-configuration-ipv6?
40 avahi-configuration-wide-area?
41 avahi-configuration-domains-to-browse
48 ;;; This module provides service definitions for the Avahi
49 ;;; "zero-configuration" tool set.
53 (define-record-type* <avahi-configuration>
54 avahi-configuration make-avahi-configuration
56 (avahi avahi-configuration-avahi ;<package>
58 (debug? avahi-configuration-debug? ;Boolean
60 (host-name avahi-configuration-host-name ;string | #f
62 (publish? avahi-configuration-publish? ;boolean
65 ;; The default for this was #t in Avahi 0.6.31 and became #f in 0.7. For
66 ;; now we stick to the old default.
67 (publish-workstation? avahi-configuration-publish-workstation? ;Boolean
70 (ipv4? avahi-configuration-ipv4? ;Boolean
72 (ipv6? avahi-configuration-ipv6? ;Boolean
74 (wide-area? avahi-configuration-wide-area? ;Boolean
76 (domains-to-browse avahi-configuration-domains-to-browse ;list of strings
79 (define* (configuration-file config)
80 "Return an avahi-daemon configuration file based on CONFIG, an
81 <avahi-configuration>."
83 (if value "yes\n" "no\n"))
85 (define host-name (avahi-configuration-host-name config))
87 (plain-file "avahi-daemon.conf"
91 (string-append "host-name=" host-name "\n")
94 "browse-domains=" (string-join
95 (avahi-configuration-domains-to-browse
98 "use-ipv4=" (bool (avahi-configuration-ipv4? config))
99 "use-ipv6=" (bool (avahi-configuration-ipv6? config))
101 "enable-wide-area=" (bool (avahi-configuration-wide-area? config))
103 "disable-publishing="
104 (bool (not (avahi-configuration-publish? config)))
105 "publish-workstation="
106 (bool (avahi-configuration-publish-workstation? config)))))
108 (define %avahi-accounts
109 ;; Account and group for the Avahi daemon.
110 (list (user-group (name "avahi") (system? #t))
115 (comment "Avahi daemon user")
116 (home-directory "/var/empty")
117 (shell (file-append shadow "/sbin/nologin")))))
119 (define %avahi-activation
122 (use-modules (guix build utils))
123 (mkdir-p "/run/avahi-daemon")))
125 (define (avahi-shepherd-service config)
126 "Return a list of <shepherd-service> for CONFIG."
127 (let ((config (configuration-file config))
128 (debug? (avahi-configuration-debug? config))
129 (avahi (avahi-configuration-avahi config)))
130 (list (shepherd-service
131 (documentation "Run the Avahi mDNS/DNS-SD responder.")
132 (provision '(avahi-daemon))
133 (requirement '(user-processes dbus-system networking))
135 (start #~(make-forkexec-constructor
136 (list #$(file-append avahi "/sbin/avahi-daemon")
138 #$@(if debug? #~("--debug") #~())
140 #:pid-file "/run/avahi-daemon/pid"))
141 (stop #~(make-kill-destructor))))))
143 (define avahi-service-type
144 (let ((avahi-package (compose list avahi-configuration-avahi)))
145 (service-type (name 'avahi)
147 "Run @command{avahi-daemon}, a host and service discovery
148 daemon that implements the multicast DNS (mDNS) and DNS service
149 discovery (DNS-SD) protocols. Additionally, extend the C library's name
150 service switch (NSS) with support for @code{.local} host name resolution.")
152 (list (service-extension shepherd-root-service-type
153 avahi-shepherd-service)
154 (service-extension dbus-root-service-type
156 (service-extension account-service-type
157 (const %avahi-accounts))
158 (service-extension activation-service-type
159 (const %avahi-activation))
160 (service-extension nscd-service-type
161 (const (list nss-mdns)))
163 ;; Provide 'avahi-browse', 'avahi-resolve', etc. in
164 ;; the system profile.
165 (service-extension profile-service-type
167 (default-value (avahi-configuration)))))
169 (define-deprecated (avahi-service #:key (avahi avahi) debug?
172 (ipv4? #t) (ipv6? #t)
174 (domains-to-browse '()))
176 "Return a service that runs @command{avahi-daemon}, a system-wide
177 mDNS/DNS-SD responder that allows for service discovery and
178 \"zero-configuration\" host name lookups (see @uref{https://avahi.org/}), and
179 extends the name service cache daemon (nscd) so that it can resolve
180 @code{.local} host names using
181 @uref{http://0pointer.de/lennart/projects/nss-mdns/, nss-mdns}. Additionally,
182 add the @var{avahi} package to the system profile so that commands such as
183 @command{avahi-browse} are directly usable.
185 If @var{host-name} is different from @code{#f}, use that as the host name to
186 publish for this machine; otherwise, use the machine's actual host name.
188 When @var{publish?} is true, publishing of host names and services is allowed;
189 in particular, avahi-daemon will publish the machine's host name and IP
190 address via mDNS on the local network.
192 When @var{wide-area?} is true, DNS-SD over unicast DNS is enabled.
194 Boolean values @var{ipv4?} and @var{ipv6?} determine whether to use IPv4/IPv6
196 (service avahi-service-type
198 (avahi avahi) (debug? debug?) (host-name host-name)
199 (publish? publish?) (ipv4? ipv4?) (ipv6? ipv6?)
200 (wide-area? wide-area?)
201 (domains-to-browse domains-to-browse))))
203 ;;; avahi.scm ends here