X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fnss-myhostname.xml;h=cca3a99aaa53dd6247c136ea6c1dec78dcadc132;hp=c0e2b828be13b5d38c8bd0e3b36181a51e0cc24b;hb=848e3e24b00a61130f20226ef5f051433d478c69;hpb=7d7681f70bc8c2140092029ccada9f75510a176b 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.