aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2015-10-12 21:24:59 +0200
committerLudovic Courtès <ludo@gnu.org>2015-10-13 00:06:11 +0200
commitcc9c1f39350233bb3f22f01f942466a5cc7851f0 (patch)
treeefaec43531a901a0e3122c3195f1e00160c9af4f
parent92e75d1e9ad0bd02fe2a63700772db9269342f44 (diff)
downloadguix-cc9c1f39350233bb3f22f01f942466a5cc7851f0.tar
guix-cc9c1f39350233bb3f22f01f942466a5cc7851f0.tar.gz
doc: Update "Name Service Switch" to new service framework.
* gnu/services/avahi.scm (avahi-service): Mention the extension of nscd. * doc/guix.texi (Networking Services): Update accordingly. (Name Service Switch): Remove '%my-base-services' example and explanation.
-rw-r--r--doc/guix.texi35
-rw-r--r--gnu/services/avahi.scm5
2 files changed, 13 insertions, 27 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 709ec0ff70..9956887b96 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -6109,7 +6109,10 @@ The @code{(gnu services avahi)} provides the following definition.
[#:domains-to-browse '()]
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/}).
+"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}.
If @var{host-name} is different from @code{#f}, use that as the host name to
publish for this machine; otherwise, use the machine's actual host name.
@@ -6587,31 +6590,11 @@ 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,
-@code{nscd-service} must be told where to find the @code{nss-mdns}
-shared library (@pxref{Base Services, @code{nscd-service}}). Since the
-@code{nscd} service is part of @var{%base-services}, you may want to
-customize it by adding this snippet in the operating system
-configuration file:
-
-@example
-(use-modules (guix) (gnu))
-
-(define %my-base-services
- ;; Replace the default nscd service with one that knows
- ;; about nss-mdns.
- (map (lambda (service)
- (if (member 'nscd (service-provision service))
- (nscd-service (nscd-configuration
- (name-services (list nss-mdns))))
- service))
- %base-services))
-@end example
-
-@noindent
-@dots{} and then refer to @var{%my-base-services} instead of
-@var{%base-services} in the @code{operating-system} declaration.
-Lastly, this relies on the availability of the Avahi service
-(@pxref{Networking Services, @code{avahi-service}}).
+you also need to use @code{avahi-service} (@pxref{Networking Services,
+@code{avahi-service}}), 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}}).
For convenience, the following variables provide typical NSS
configurations.
diff --git a/gnu/services/avahi.scm b/gnu/services/avahi.scm
index b576c395ff..18131fe561 100644
--- a/gnu/services/avahi.scm
+++ b/gnu/services/avahi.scm
@@ -129,7 +129,10 @@
(domains-to-browse '()))
"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/}).
+\"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}.
If @var{host-name} is different from @code{#f}, use that as the host name to
publish for this machine; otherwise, use the machine's actual host name.