mirror of
https://git.in.rschanz.org/ryan77627/guix.git
synced 2024-12-24 05:18:07 -05:00
services: avahi: Deprecate the 'avahi-service' procedure.
* gnu/services/avahi.scm (<avahi-configuration>): Export getters. Add default values. (avahi-service-type)[default-value]: New field. (avahi-service): Mark as deprecated. * gnu/services/desktop.scm (%desktop-services): Use the 'service' form instead of calling 'avahi-service'. * gnu/tests/base.scm (%avahi-os): Likewise. * doc/guix.texi (Base Services): Adjust example accordingly. (Networking Services): Update accordingly.
This commit is contained in:
Ludovic Courtès
parent
39ad752cf9
commit
2e04ab7147
4 changed files with 86 additions and 40 deletions
|
|
@ -10848,7 +10848,9 @@ system, you will want to append services to @var{%base-services}, like
|
|||
this:
|
||||
|
||||
@example
|
||||
(cons* (avahi-service) (lsh-service) %base-services)
|
||||
(cons* (service avahi-service-type)
|
||||
(service openssh-service-type)
|
||||
%base-services)
|
||||
@end example
|
||||
@end defvr
|
||||
|
||||
|
|
@ -12709,31 +12711,54 @@ browsers, from accessing Facebook.
|
|||
|
||||
The @code{(gnu services avahi)} provides the following definition.
|
||||
|
||||
@deffn {Scheme Procedure} avahi-service [#:avahi @var{avahi}] @
|
||||
[#:host-name #f] [#:publish? #t] [#:ipv4? #t] @
|
||||
[#:ipv6? #t] [#:wide-area? #f] @
|
||||
[#:domains-to-browse '()] [#:debug? #f]
|
||||
Return a service that runs @command{avahi-daemon}, a system-wide
|
||||
@defvr {Scheme Variable} avahi-service-type
|
||||
This is the service that runs @command{avahi-daemon}, a system-wide
|
||||
mDNS/DNS-SD responder that allows for service discovery and
|
||||
"zero-configuration" host name lookups (see @uref{http://avahi.org/}), and
|
||||
extends the name service cache daemon (nscd) so that it can resolve
|
||||
@code{.local} host names using
|
||||
@uref{http://0pointer.de/lennart/projects/nss-mdns/, nss-mdns}. Additionally,
|
||||
add the @var{avahi} package to the system profile so that commands such as
|
||||
@command{avahi-browse} are directly usable.
|
||||
``zero-configuration'' host name lookups (see @uref{http://avahi.org/}).
|
||||
Its value must be a @code{zero-configuration} record---see below.
|
||||
|
||||
If @var{host-name} is different from @code{#f}, use that as the host name to
|
||||
This service extends the name service cache daemon (nscd) so that it can
|
||||
resolve @code{.local} host names using
|
||||
@uref{http://0pointer.de/lennart/projects/nss-mdns/, nss-mdns}. @xref{Name
|
||||
Service Switch}, for information on host name resolution.
|
||||
|
||||
Additionally, add the @var{avahi} package to the system profile so that
|
||||
commands such as @command{avahi-browse} are directly usable.
|
||||
@end defvr
|
||||
|
||||
@deftp {Data Type} avahi-configuration
|
||||
Data type representation the configuration for Avahi.
|
||||
|
||||
@table @asis
|
||||
|
||||
@item @code{host-name} (default: @code{#f})
|
||||
If different from @code{#f}, use that as the host name to
|
||||
publish for this machine; otherwise, use the machine's actual host name.
|
||||
|
||||
When @var{publish?} is true, publishing of host names and services is allowed;
|
||||
in particular, avahi-daemon will publish the machine's host name and IP
|
||||
address via mDNS on the local network.
|
||||
@item @code{publish?} (default: @code{#t})
|
||||
When true, allow host names and services to be published (broadcast) over the
|
||||
network.
|
||||
|
||||
When @var{wide-area?} is true, DNS-SD over unicast DNS is enabled.
|
||||
@item @code{publish-workstation?} (default: @code{#t})
|
||||
When true, @command{avahi-daemon} publishes the machine's host name and IP
|
||||
address via mDNS on the local network. To view the host names published on
|
||||
your local network, you can run:
|
||||
|
||||
Boolean values @var{ipv4?} and @var{ipv6?} determine whether to use IPv4/IPv6
|
||||
sockets.
|
||||
@end deffn
|
||||
@example
|
||||
avahi-browse _workstation._tcp
|
||||
@end example
|
||||
|
||||
@item @code{wide-area?} (default: @code{#f})
|
||||
When true, DNS-SD over unicast DNS is enabled.
|
||||
|
||||
@item @code{ipv4?} (default: @code{#t})
|
||||
@itemx @code{ipv6?} (default: @code{#t})
|
||||
These fields determine whether to use IPv4/IPv6 sockets.
|
||||
|
||||
@item @code{domains-to-browse} (default: @code{'()})
|
||||
This is a list of domains to browse.
|
||||
@end table
|
||||
@end deftp
|
||||
|
||||
@deffn {Scheme Variable} openvswitch-service-type
|
||||
This is the type of the @uref{http://www.openvswitch.org, Open vSwitch}
|
||||
|
|
@ -22303,8 +22328,8 @@ want is to have @code{.local} host lookup working.
|
|||
|
||||
Note that, in this case, in addition to setting the
|
||||
@code{name-service-switch} of the @code{operating-system} declaration,
|
||||
you also need to use @code{avahi-service} (@pxref{Networking Services,
|
||||
@code{avahi-service}}), or @var{%desktop-services}, which includes it
|
||||
you also need to use @code{avahi-service-type} (@pxref{Networking Services,
|
||||
@code{avahi-service-type}}), or @var{%desktop-services}, which includes it
|
||||
(@pxref{Desktop Services}). Doing this makes @code{nss-mdns} accessible
|
||||
to the name service cache daemon (@pxref{Base Services,
|
||||
@code{nscd-service}}).
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
;;; GNU Guix --- Functional package management for GNU
|
||||
;;; Copyright © 2014, 2015, 2016, 2017, 2018 Ludovic Courtès <ludo@gnu.org>
|
||||
;;; Copyright © 2014, 2015, 2016, 2017, 2018, 2019 Ludovic Courtès <ludo@gnu.org>
|
||||
;;;
|
||||
;;; This file is part of GNU Guix.
|
||||
;;;
|
||||
|
|
@ -24,9 +24,22 @@ (define-module (gnu services avahi)
|
|||
#:use-module (gnu system shadow)
|
||||
#:use-module (gnu packages avahi)
|
||||
#:use-module (gnu packages admin)
|
||||
#:use-module (guix deprecation)
|
||||
#:use-module (guix records)
|
||||
#:use-module (guix gexp)
|
||||
#:export (avahi-configuration
|
||||
avahi-configuration?
|
||||
|
||||
avahi-configuration-avahi
|
||||
avahi-configuration-debug?
|
||||
avahi-configuration-host-name
|
||||
avahi-configuration-publish?
|
||||
avahi-configuration-publish-workstation?
|
||||
avahi-configuration-ipv4?
|
||||
avahi-configuration-ipv6?
|
||||
avahi-configuration-wide-area?
|
||||
avahi-configuration-domains-to-browse
|
||||
|
||||
avahi-service
|
||||
avahi-service-type))
|
||||
|
||||
|
|
@ -37,7 +50,6 @@ (define-module (gnu services avahi)
|
|||
;;;
|
||||
;;; Code:
|
||||
|
||||
;; TODO: Export.
|
||||
(define-record-type* <avahi-configuration>
|
||||
avahi-configuration make-avahi-configuration
|
||||
avahi-configuration?
|
||||
|
|
@ -45,18 +57,24 @@ (define-record-type* <avahi-configuration>
|
|||
(default avahi))
|
||||
(debug? avahi-configuration-debug? ;Boolean
|
||||
(default #f))
|
||||
(host-name avahi-configuration-host-name) ;string
|
||||
(publish? avahi-configuration-publish?) ;Boolean
|
||||
(host-name avahi-configuration-host-name ;string | #f
|
||||
(default #f))
|
||||
(publish? avahi-configuration-publish? ;boolean
|
||||
(default #t))
|
||||
|
||||
;; The default for this was #t in Avahi 0.6.31 and became #f in 0.7. For
|
||||
;; now we stick to the old default.
|
||||
(publish-workstation? avahi-configuration-publish-workstation? ;Boolean
|
||||
(default #t))
|
||||
|
||||
(ipv4? avahi-configuration-ipv4?) ;Boolean
|
||||
(ipv6? avahi-configuration-ipv6?) ;Boolean
|
||||
(wide-area? avahi-configuration-wide-area?) ;Boolean
|
||||
(domains-to-browse avahi-configuration-domains-to-browse)) ;list of strings
|
||||
(ipv4? avahi-configuration-ipv4? ;Boolean
|
||||
(default #t))
|
||||
(ipv6? avahi-configuration-ipv6? ;Boolean
|
||||
(default #t))
|
||||
(wide-area? avahi-configuration-wide-area? ;Boolean
|
||||
(default #f))
|
||||
(domains-to-browse avahi-configuration-domains-to-browse ;list of strings
|
||||
(default '())))
|
||||
|
||||
(define* (configuration-file config)
|
||||
"Return an avahi-daemon configuration file based on CONFIG, an
|
||||
|
|
@ -145,14 +163,16 @@ (define avahi-service-type
|
|||
;; Provide 'avahi-browse', 'avahi-resolve', etc. in
|
||||
;; the system profile.
|
||||
(service-extension profile-service-type
|
||||
avahi-package))))))
|
||||
avahi-package)))
|
||||
(default-value (avahi-configuration)))))
|
||||
|
||||
(define* (avahi-service #:key (avahi avahi) debug?
|
||||
(define-deprecated (avahi-service #:key (avahi avahi) debug?
|
||||
host-name
|
||||
(publish? #t)
|
||||
(ipv4? #t) (ipv6? #t)
|
||||
wide-area?
|
||||
(domains-to-browse '()))
|
||||
avahi-service-type
|
||||
"Return a service that runs @command{avahi-daemon}, a system-wide
|
||||
mDNS/DNS-SD responder that allows for service discovery and
|
||||
\"zero-configuration\" host name lookups (see @uref{http://avahi.org/}), and
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
;;; GNU Guix --- Functional package management for GNU
|
||||
;;; Copyright © 2014, 2015, 2016, 2017, 2018 Ludovic Courtès <ludo@gnu.org>
|
||||
;;; Copyright © 2014, 2015, 2016, 2017, 2018, 2019 Ludovic Courtès <ludo@gnu.org>
|
||||
;;; Copyright © 2015 Andy Wingo <wingo@igalia.com>
|
||||
;;; Copyright © 2015 Mark H Weaver <mhw@netris.org>
|
||||
;;; Copyright © 2016 Sou Bunnbu <iyzsong@gmail.com>
|
||||
|
|
@ -986,7 +986,7 @@ (define %desktop-services
|
|||
;; The D-Bus clique.
|
||||
(service network-manager-service-type)
|
||||
(service wpa-supplicant-service-type) ;needed by NetworkManager
|
||||
(avahi-service)
|
||||
(service avahi-service-type)
|
||||
(udisks-service)
|
||||
(upower-service)
|
||||
(accountsservice-service)
|
||||
|
|
|
|||
|
|
@ -706,7 +706,8 @@ (define %avahi-os
|
|||
(operating-system
|
||||
(inherit %simple-os)
|
||||
(name-service-switch %mdns-host-lookup-nss)
|
||||
(services (cons* (avahi-service #:debug? #t)
|
||||
(services (cons* (service avahi-service-type
|
||||
(avahi-configuration (debug? #t)))
|
||||
(dbus-service)
|
||||
(service dhcp-client-service-type) ;needed for multicast
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue