2012-06-26 02:04:50 +04:00
<?xml version='1.0'?> <!-- * - nxml - * -->
2019-03-14 16:40:58 +03:00
< !DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
2015-06-18 20:47:44 +03:00
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
2019-03-14 16:29:37 +03:00
<!-- SPDX - License - Identifier: LGPL - 2.1+ -->
2012-06-26 02:04:50 +04:00
2013-02-03 07:47:47 +04:00
<refentry id= "systemd-hostnamed.service" conditional= 'ENABLE_HOSTNAMED' >
2012-06-26 02:04:50 +04:00
2015-02-04 05:14:13 +03:00
<refentryinfo >
<title > systemd-hostnamed.service</title>
<productname > systemd</productname>
</refentryinfo>
<refmeta >
<refentrytitle > systemd-hostnamed.service</refentrytitle>
<manvolnum > 8</manvolnum>
</refmeta>
<refnamediv >
<refname > systemd-hostnamed.service</refname>
<refname > systemd-hostnamed</refname>
2020-04-09 16:42:27 +03:00
<refpurpose > Daemon to control system hostname from programs</refpurpose>
2015-02-04 05:14:13 +03:00
</refnamediv>
<refsynopsisdiv >
<para > <filename > systemd-hostnamed.service</filename> </para>
2015-06-18 20:47:44 +03:00
<para > <filename > /usr/lib/systemd/systemd-hostnamed</filename> </para>
2015-02-04 05:14:13 +03:00
</refsynopsisdiv>
<refsect1 >
<title > Description</title>
2020-04-09 16:42:27 +03:00
<para > <filename > systemd-hostnamed.service</filename> is a system service that may be used to change the
2020-04-14 14:43:11 +03:00
system's hostname and related machine metadata from user programs. It is automatically activated on
2020-04-09 16:42:27 +03:00
request and terminates itself when unused.</para>
<para > It currently offers access to five variables:
<itemizedlist >
2020-04-14 14:43:11 +03:00
<listitem > <para > The current hostname (Example: <literal > dhcp-192-168-47-11</literal> )</para>
2020-04-09 16:42:27 +03:00
</listitem>
2020-04-14 14:43:11 +03:00
<listitem > <para > The static (configured) hostname (Example:
2020-04-09 16:42:27 +03:00
<literal > lennarts-computer</literal> )</para> </listitem>
2020-04-14 14:43:11 +03:00
<listitem > <para > The pretty hostname (Example: <literal > Lennart's Computer</literal> )</para>
2020-04-09 16:42:27 +03:00
</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>
2015-02-04 05:14:13 +03:00
<para > The tool
<citerefentry > <refentrytitle > hostnamectl</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry>
is a command line client to this service.</para>
2020-04-14 14:43:11 +03:00
<para > See
2020-04-24 22:04:43 +03:00
<citerefentry > <refentrytitle > org.freedesktop.hostname1</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry>
and
<citerefentry > <refentrytitle > org.freedesktop.LogControl1</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry>
2020-04-09 16:42:27 +03:00
for a description of the D-Bus API.</para>
2015-02-04 05:14:13 +03:00
</refsect1>
<refsect1 >
<title > See Also</title>
<para >
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > hostname</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > machine-info</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > hostnamectl</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > sethostname</refentrytitle> <manvolnum > 2</manvolnum> </citerefentry>
</para>
</refsect1>
2012-06-26 02:04:50 +04:00
</refentry>