X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fnss-myhostname.xml;h=c7a2cd9ae7b4edf90732a0036656199d095757b7;hb=e28aa588f04ace17ca94e9e0667819bea265fbd9;hp=cca3a99aaa53dd6247c136ea6c1dec78dcadc132;hpb=9fccdb0f64d12bc09a71442dd0af2248c1aa3e89;p=elogind.git
diff --git a/man/nss-myhostname.xml b/man/nss-myhostname.xml
index cca3a99aa..c7a2cd9ae 100644
--- a/man/nss-myhostname.xml
+++ b/man/nss-myhostname.xml
@@ -45,54 +45,88 @@
nss-myhostname
+ libnss_myhostname.so.2Provide hostname resolution for the locally
configured system hostname.
- nss-myhostname.la
+ libnss_myhostname.so.2Description
- nss-myhostname is a plugin for the GNU Name Service Switch
- (NSS) functionality of the GNU C Library (glibc)
- providing hostname resolution for the locally configured system
- hostname as returned by
- gethostname2.
- Various software relies on an always-resolvable local hostname. When
- using dynamic hostnames, this is usually achieved by patching
- /etc/hosts at the same time as changing the host
- name. This however is not ideal since it requires a writable
- /etc file system and is fragile because the file
- might be edited by the administrator at the same time. nss-myhostname
- simply returns all locally configured public IP addresses, or, if none
- are configured, the IPv4 address 127.0.0.2 (which is on the local
- loopback) and the IPv6 address ::1 (which is the local host) for
- whatever system hostname is configured locally. Patching
- /etc/hosts is thus no longer necessary.
-
- To activate the NSS modules,
- has to be added to the line starting with "hosts:" in
- /etc/nsswitch.conf
-
- It is recommended to put
- last in the nsswitch.conf line to make
- sure that this mapping is only used as fallback, and any DNS
- or /etc/hosts based mapping takes precedence.
+ nss-myhostname is a plugin
+ for the GNU Name Service Switch (NSS) functionality of
+ the GNU C Library (glibc) primarily
+ providing hostname resolution for the locally
+ configured system hostname as returned by
+ gethostname2. The
+ precise hostnames resolved by this module are:
+
+
+ The local, configured hostname
+ is resolved to all locally configured IP
+ addresses ordered by their scope, or -- if
+ none are configured -- the IPv4 address
+ 127.0.0.2 (which is on the local loopback) and
+ the IPv6 address ::1 (which is the local
+ host).
+
+ The hostname
+ localhost is resolved to
+ the IP addresses 127.0.0.1 and
+ ::1.
+
+ The hostname
+ gateway is resolved to all
+ current default routing gateway addresses,
+ ordered by their metric. This assigns a stable
+ hostname to the current gateway, useful for
+ referencing it independently of the current
+ network configuration state.
+
+
+
+ Various software relies on an always-resolvable
+ local hostname. When using dynamic hostnames, this is
+ traditionally achieved by patching
+ /etc/hosts at the same time as
+ changing the hostname. This is problematic since it
+ requires a writable /etc file
+ system and is fragile because the file might be edited
+ by the administrator at the same time. With
+ nss-myhostname enabled changing
+ /etc/hosts is unncessary, and on
+ many systems the file becomes entirely optional.
+
+ To activate the NSS modules,
+ myhostname has to be added to the
+ line starting with hosts: in
+ /etc/nsswitch.conf.
+
+ It is recommended to place
+ myhostname last in the
+ nsswitch.conf line to make sure
+ that this mapping is only used as fallback, and any
+ DNS or /etc/hosts based mapping
+ takes precedence.Example
-# /etc/nsswitch.conf
+ Here's an example
+ /etc/nsswitch.conf file, that
+ enables myhostname
+ correctly:
-passwd: compat
+passwd: compat
group: compat
shadow: compat
-hosts: files dns myhostname
+hosts: files dns mymachines myhostname
networks: files
protocols: db files
@@ -120,13 +154,9 @@ netgroup: nisSee Alsosystemd1,
- systemd-logind.service8,
- logind.conf5,
- loginctl1,
- pam.conf5,
- pam.d5,
- pam8,
- pam_loginuid8
+ nss-mymachines8,
+ nsswitch.conf5,
+ getent1