X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fnss-myhostname.xml;h=cca3a99aaa53dd6247c136ea6c1dec78dcadc132;hb=3f781aa8a0b4490e00975ebc7d4a7b729c7dd9e8;hp=c0e2b828be13b5d38c8bd0e3b36181a51e0cc24b;hpb=7d7681f70bc8c2140092029ccada9f75510a176b;p=elogind.git
diff --git a/man/nss-myhostname.xml b/man/nss-myhostname.xml
index c0e2b828b..cca3a99aa 100644
--- a/man/nss-myhostname.xml
+++ b/man/nss-myhostname.xml
@@ -45,7 +45,7 @@
nss-myhostname
- Provide host name resolution for the locally
+ Provide hostname resolution for the locally
configured system hostname.
@@ -58,17 +58,17 @@
nss-myhostname is a plugin for the GNU Name Service Switch
(NSS) functionality of the GNU C Library (glibc)
- providing host name resolution for the locally configured system
+ providing hostname resolution for the locally configured system
hostname as returned by
gethostname2.
- Various software relies on an always resolvable local host name. When
- using dynamic hostnames this is usually achieved by patching
+ 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 configure public IP addresses, or -- if none
- are configured -- the IPv4 address 127.0.0.2 (which is on the local
+ 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.
@@ -86,8 +86,7 @@
Example
-
-# /etc/nsswitch.conf
+# /etc/nsswitch.conf
passwd: compat
group: compat
@@ -101,22 +100,19 @@ services: db files
ethers: db files
rpc: db files
-netgroup: nis
-
+netgroup: nis
To test, use glibc's getent tool:
-
-$ getent ahosts `hostname`
+ $ getent ahosts `hostname`
::1 STREAM omega
::1 DGRAM
::1 RAW
127.0.0.2 STREAM
127.0.0.2 DGRAM
-127.0.0.2 RAW
-
+127.0.0.2 RAW
- In this case the local host name is omega.
+ In this case the local hostname is omega.