diff options
| author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2020-04-09 15:42:27 +0200 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2020-04-12 19:48:01 +0200 |
| commit | e09a36bd4617dc6e4dfc447b62affba0d112a0e6 (patch) | |
| tree | 0c93efe719c84d49a1bfb86b2fe67adcec1bf6c5 /man/systemd-hostnamed.service.xml | |
| parent | 956ecd3cd31ac3ab3c6d622b501cf9aa5b528807 (diff) | |
| download | systemd-e09a36bd4617dc6e4dfc447b62affba0d112a0e6.tar.gz | |
man: import org.freedesktop.hostname1(3) from the wiki
Diffstat (limited to 'man/systemd-hostnamed.service.xml')
| -rw-r--r-- | man/systemd-hostnamed.service.xml | 34 |
1 files changed, 25 insertions, 9 deletions
diff --git a/man/systemd-hostnamed.service.xml b/man/systemd-hostnamed.service.xml index 19bd4c06f2..185e038809 100644 --- a/man/systemd-hostnamed.service.xml +++ b/man/systemd-hostnamed.service.xml @@ -18,7 +18,7 @@ <refnamediv> <refname>systemd-hostnamed.service</refname> <refname>systemd-hostnamed</refname> - <refpurpose>Host name bus mechanism</refpurpose> + <refpurpose>Daemon to control system hostname from programs</refpurpose> </refnamediv> <refsynopsisdiv> @@ -29,19 +29,35 @@ <refsect1> <title>Description</title> - <para><filename>systemd-hostnamed</filename> is a system service - that may be used as a mechanism to change the system's hostname. - <filename>systemd-hostnamed</filename> is automatically activated - on request and terminates itself when it is unused.</para> + <para><filename>systemd-hostnamed.service</filename> is a system service that may be used to change the + system's hostname and related machine meta data from user programs. It is automatically activated on + request and terminates itself when unused.</para> + + <para>It currently offers access to five variables: + <itemizedlist> + <listitem><para>The current host name (Example: <literal>dhcp-192-168-47-11</literal>)</para> + </listitem> + + <listitem><para>The static (configured) host name (Example: + <literal>lennarts-computer</literal>)</para></listitem> + + <listitem><para>The pretty host name (Example: <literal>Lennart's Computer</literal>)</para> + </listitem> + + <listitem><para>A suitable icon name for the local host (Example: + <literal>computer-laptop</literal>)</para></listitem> + + <listitem><para>A chassis type (Example: <literal>tablet</literal>)</para> + </listitem> + </itemizedlist></para> <para>The tool <citerefentry><refentrytitle>hostnamectl</refentrytitle><manvolnum>1</manvolnum></citerefentry> is a command line client to this service.</para> - <para>See the <ulink - url="https://www.freedesktop.org/wiki/Software/systemd/hostnamed"> - developer documentation</ulink> for information about the APIs - <filename>systemd-hostnamed</filename> provides.</para> + <para>See the + <citerefentry><refentrytitle>org.freedesktop.hostname1</refentrytitle><manvolnum>1</manvolnum></citerefentry> + for a description of the D-Bus API.</para> </refsect1> <refsect1> |