chiark / gitweb /
man: mention --runtime where appropriate
[elogind.git] / man / nss-myhostname.xml
index bd3f635692246903ed6b293dc4bf2ff47a5c550c..efbadac33fbfc55cb49cf5758a40376389dce559 100644 (file)
@@ -22,7 +22,7 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="nss-myhostname">
+<refentry id="nss-myhostname" conditional='HAVE_MYHOSTNAME'>
 
         <refentryinfo>
                 <title>nss-myhostname</title>
 
         <refnamediv>
                 <refname>nss-myhostname</refname>
-                <refpurpose>Provide host name resolution for the locally
+                <refpurpose>Provide hostname resolution for the locally
                 configured system hostname.</refpurpose>
         </refnamediv>
 
         <refsynopsisdiv>
-                <cmdsynopsis>
-                        <command>nss-myhostname.la</command>
-                </cmdsynopsis>
+                <para><filename>nss-myhostname.la</filename></para>
         </refsynopsisdiv>
 
         <refsect1>
 
                 <para><command>nss-myhostname</command> is a plugin for the GNU Name Service Switch
                 (NSS) functionality of the GNU C Library (<command>glibc</command>)
-                providing host name resolution for the locally configured system
+                providing hostname resolution for the locally configured system
                 hostname as returned by
                 <citerefentry><refentrytitle>gethostname</refentrytitle><manvolnum>2</manvolnum></citerefentry>.
-                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
                 <filename>/etc/hosts</filename> at the same time as changing the host
                 name. This however is not ideal since it requires a writable
                 <filename>/etc</filename> file system and is fragile because the file
                 might be edited by the administrator at the same time. <command>nss-myhostname</command>
-                simply returns all locally configure public IP addresses, or -- if none
-                are configured -- the IPv4 address 127.0.0.2 (wich 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
                 <filename>/etc/hosts</filename> is thus no longer necessary.</para>
@@ -118,7 +116,7 @@ $ getent ahosts `hostname`
 127.0.0.2       RAW
                 </programlisting>
 
-                <para>In this case the local host name is <varname>omega</varname>.</para>
+                <para>In this case the local hostname is <varname>omega</varname>.</para>
 
         </refsect1>