Commit | Line | Data |
---|---|---|
f4561be2 | 1 | ;;; GNU Guix --- Functional package management for GNU |
a68fdfea | 2 | ;;; Copyright © 2014, 2015, 2016, 2017, 2018 Ludovic Courtès <ludo@gnu.org> |
f4561be2 LC |
3 | ;;; |
4 | ;;; This file is part of GNU Guix. | |
5 | ;;; | |
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. | |
10 | ;;; | |
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. | |
15 | ;;; | |
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/>. | |
18 | ||
19 | (define-module (gnu services avahi) | |
20 | #:use-module (gnu services) | |
0adfe95a | 21 | #:use-module (gnu services base) |
0190c1c0 | 22 | #:use-module (gnu services shepherd) |
0adfe95a | 23 | #:use-module (gnu services dbus) |
f4561be2 LC |
24 | #:use-module (gnu system shadow) |
25 | #:use-module (gnu packages avahi) | |
5e25ebe2 | 26 | #:use-module (gnu packages admin) |
0adfe95a | 27 | #:use-module (guix records) |
f4561be2 | 28 | #:use-module (guix gexp) |
24e96431 TČ |
29 | #:export (avahi-configuration |
30 | avahi-service | |
893106cb | 31 | avahi-service-type)) |
f4561be2 LC |
32 | |
33 | ;;; Commentary: | |
34 | ;;; | |
35 | ;;; This module provides service definitions for the Avahi | |
36 | ;;; "zero-configuration" tool set. | |
37 | ;;; | |
38 | ;;; Code: | |
39 | ||
0adfe95a LC |
40 | ;; TODO: Export. |
41 | (define-record-type* <avahi-configuration> | |
42 | avahi-configuration make-avahi-configuration | |
43 | avahi-configuration? | |
44 | (avahi avahi-configuration-avahi ;<package> | |
45 | (default avahi)) | |
c8695f32 LC |
46 | (debug? avahi-configuration-debug? ;Boolean |
47 | (default #f)) | |
0adfe95a LC |
48 | (host-name avahi-configuration-host-name) ;string |
49 | (publish? avahi-configuration-publish?) ;Boolean | |
37084ba5 LC |
50 | |
51 | ;; The default for this was #t in Avahi 0.6.31 and became #f in 0.7. For | |
52 | ;; now we stick to the old default. | |
53 | (publish-workstation? avahi-configuration-publish-workstation? ;Boolean | |
54 | (default #t)) | |
55 | ||
0adfe95a LC |
56 | (ipv4? avahi-configuration-ipv4?) ;Boolean |
57 | (ipv6? avahi-configuration-ipv6?) ;Boolean | |
58 | (wide-area? avahi-configuration-wide-area?) ;Boolean | |
59 | (domains-to-browse avahi-configuration-domains-to-browse)) ;list of strings | |
60 | ||
61 | (define* (configuration-file config) | |
62 | "Return an avahi-daemon configuration file based on CONFIG, an | |
63 | <avahi-configuration>." | |
f4561be2 LC |
64 | (define (bool value) |
65 | (if value "yes\n" "no\n")) | |
66 | ||
0adfe95a LC |
67 | (define host-name (avahi-configuration-host-name config)) |
68 | ||
be1c2c54 LC |
69 | (plain-file "avahi-daemon.conf" |
70 | (string-append | |
71 | "[server]\n" | |
72 | (if host-name | |
73 | (string-append "host-name=" host-name "\n") | |
74 | "") | |
f4561be2 | 75 | |
0adfe95a LC |
76 | "browse-domains=" (string-join |
77 | (avahi-configuration-domains-to-browse | |
78 | config)) | |
be1c2c54 | 79 | "\n" |
0adfe95a LC |
80 | "use-ipv4=" (bool (avahi-configuration-ipv4? config)) |
81 | "use-ipv6=" (bool (avahi-configuration-ipv6? config)) | |
be1c2c54 | 82 | "[wide-area]\n" |
0adfe95a | 83 | "enable-wide-area=" (bool (avahi-configuration-wide-area? config)) |
be1c2c54 | 84 | "[publish]\n" |
0adfe95a | 85 | "disable-publishing=" |
37084ba5 LC |
86 | (bool (not (avahi-configuration-publish? config))) |
87 | "publish-workstation=" | |
88 | (bool (avahi-configuration-publish-workstation? config))))) | |
0adfe95a LC |
89 | |
90 | (define %avahi-accounts | |
91 | ;; Account and group for the Avahi daemon. | |
92 | (list (user-group (name "avahi") (system? #t)) | |
93 | (user-account | |
94 | (name "avahi") | |
95 | (group "avahi") | |
96 | (system? #t) | |
97 | (comment "Avahi daemon user") | |
98 | (home-directory "/var/empty") | |
9e41130b | 99 | (shell (file-append shadow "/sbin/nologin"))))) |
0adfe95a LC |
100 | |
101 | (define %avahi-activation | |
102 | ;; Activation gexp. | |
103 | #~(begin | |
104 | (use-modules (guix build utils)) | |
ad7a807d | 105 | (mkdir-p "/run/avahi-daemon"))) |
0adfe95a | 106 | |
d4053c71 AK |
107 | (define (avahi-shepherd-service config) |
108 | "Return a list of <shepherd-service> for CONFIG." | |
0adfe95a | 109 | (let ((config (configuration-file config)) |
c8695f32 | 110 | (debug? (avahi-configuration-debug? config)) |
0adfe95a | 111 | (avahi (avahi-configuration-avahi config))) |
d4053c71 | 112 | (list (shepherd-service |
0adfe95a LC |
113 | (documentation "Run the Avahi mDNS/DNS-SD responder.") |
114 | (provision '(avahi-daemon)) | |
115 | (requirement '(dbus-system networking)) | |
116 | ||
117 | (start #~(make-forkexec-constructor | |
9fc037fe | 118 | (list #$(file-append avahi "/sbin/avahi-daemon") |
c8695f32 LC |
119 | "--daemonize" |
120 | #$@(if debug? #~("--debug") #~()) | |
121 | "-f" #$config) | |
ad7a807d | 122 | #:pid-file "/run/avahi-daemon/pid")) |
0adfe95a LC |
123 | (stop #~(make-kill-destructor)))))) |
124 | ||
125 | (define avahi-service-type | |
1065bed9 LC |
126 | (let ((avahi-package (compose list avahi-configuration-avahi))) |
127 | (service-type (name 'avahi) | |
21b71b01 LC |
128 | (description |
129 | "Run @command{avahi-daemon}, a host and service discovery | |
130 | daemon that implements the multicast DNS (mDNS) and DNS service | |
131 | discovery (DNS-SD) protocols. Additionally, extend the C library's name | |
132 | service switch (NSS) with support for @code{.local} host name resolution.") | |
1065bed9 | 133 | (extensions |
d4053c71 AK |
134 | (list (service-extension shepherd-root-service-type |
135 | avahi-shepherd-service) | |
1065bed9 LC |
136 | (service-extension dbus-root-service-type |
137 | avahi-package) | |
138 | (service-extension account-service-type | |
139 | (const %avahi-accounts)) | |
140 | (service-extension activation-service-type | |
141 | (const %avahi-activation)) | |
142 | (service-extension nscd-service-type | |
9859b5c1 | 143 | (const (list nss-mdns))) |
1065bed9 LC |
144 | |
145 | ;; Provide 'avahi-browse', 'avahi-resolve', etc. in | |
146 | ;; the system profile. | |
147 | (service-extension profile-service-type | |
148 | avahi-package)))))) | |
f4561be2 | 149 | |
c8695f32 | 150 | (define* (avahi-service #:key (avahi avahi) debug? |
f4561be2 LC |
151 | host-name |
152 | (publish? #t) | |
153 | (ipv4? #t) (ipv6? #t) | |
154 | wide-area? | |
155 | (domains-to-browse '())) | |
156 | "Return a service that runs @command{avahi-daemon}, a system-wide | |
157 | mDNS/DNS-SD responder that allows for service discovery and | |
cc9c1f39 LC |
158 | \"zero-configuration\" host name lookups (see @uref{http://avahi.org/}), and |
159 | extends the name service cache daemon (nscd) so that it can resolve | |
160 | @code{.local} host names using | |
1065bed9 LC |
161 | @uref{http://0pointer.de/lennart/projects/nss-mdns/, nss-mdns}. Additionally, |
162 | add the @var{avahi} package to the system profile so that commands such as | |
163 | @command{avahi-browse} are directly usable. | |
f4561be2 LC |
164 | |
165 | If @var{host-name} is different from @code{#f}, use that as the host name to | |
166 | publish for this machine; otherwise, use the machine's actual host name. | |
167 | ||
168 | When @var{publish?} is true, publishing of host names and services is allowed; | |
169 | in particular, avahi-daemon will publish the machine's host name and IP | |
170 | address via mDNS on the local network. | |
171 | ||
172 | When @var{wide-area?} is true, DNS-SD over unicast DNS is enabled. | |
173 | ||
174 | Boolean values @var{ipv4?} and @var{ipv6?} determine whether to use IPv4/IPv6 | |
175 | sockets." | |
0adfe95a LC |
176 | (service avahi-service-type |
177 | (avahi-configuration | |
c8695f32 | 178 | (avahi avahi) (debug? debug?) (host-name host-name) |
0adfe95a LC |
179 | (publish? publish?) (ipv4? ipv4?) (ipv6? ipv6?) |
180 | (wide-area? wide-area?) | |
181 | (domains-to-browse domains-to-browse)))) | |
f4561be2 LC |
182 | |
183 | ;;; avahi.scm ends here |