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.
This commit is contained in:
parent
92e75d1e9a
commit
cc9c1f3935
|
@ -6109,7 +6109,10 @@ The @code{(gnu services avahi)} provides the following definition.
|
||||||
[#:domains-to-browse '()]
|
[#:domains-to-browse '()]
|
||||||
Return a service that runs @command{avahi-daemon}, a system-wide
|
Return a service that runs @command{avahi-daemon}, a system-wide
|
||||||
mDNS/DNS-SD responder that allows for service discovery and
|
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
|
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.
|
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
|
Note that, in this case, in addition to setting the
|
||||||
@code{name-service-switch} of the @code{operating-system} declaration,
|
@code{name-service-switch} of the @code{operating-system} declaration,
|
||||||
@code{nscd-service} must be told where to find the @code{nss-mdns}
|
you also need to use @code{avahi-service} (@pxref{Networking Services,
|
||||||
shared library (@pxref{Base Services, @code{nscd-service}}). Since the
|
@code{avahi-service}}), or @var{%desktop-services}, which includes it
|
||||||
@code{nscd} service is part of @var{%base-services}, you may want to
|
(@pxref{Desktop Services}). Doing this makes @code{nss-mdns} accessible
|
||||||
customize it by adding this snippet in the operating system
|
to the name service cache daemon (@pxref{Base Services,
|
||||||
configuration file:
|
@code{nscd-service}}).
|
||||||
|
|
||||||
@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}}).
|
|
||||||
|
|
||||||
For convenience, the following variables provide typical NSS
|
For convenience, the following variables provide typical NSS
|
||||||
configurations.
|
configurations.
|
||||||
|
|
|
@ -129,7 +129,10 @@
|
||||||
(domains-to-browse '()))
|
(domains-to-browse '()))
|
||||||
"Return a service that runs @command{avahi-daemon}, a system-wide
|
"Return a service that runs @command{avahi-daemon}, a system-wide
|
||||||
mDNS/DNS-SD responder that allows for service discovery and
|
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
|
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.
|
publish for this machine; otherwise, use the machine's actual host name.
|
||||||
|
|
Loading…
Reference in New Issue