2012-06-25 22:04:50 +00:00
|
|
|
<?xml version='1.0'?> <!--*-nxml-*-->
|
2019-03-14 13:40:58 +00:00
|
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
2023-12-25 14:48:33 +00:00
|
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
2020-11-09 04:23:58 +00:00
|
|
|
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
|
2012-06-25 22:04:50 +00:00
|
|
|
|
2013-02-03 03:47:47 +00:00
|
|
|
<refentry id="systemd-hostnamed.service" conditional='ENABLE_HOSTNAMED'>
|
2012-06-25 22:04:50 +00:00
|
|
|
|
2015-02-04 02:14:13 +00: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 13:42:27 +00:00
|
|
|
<refpurpose>Daemon to control system hostname from programs</refpurpose>
|
2015-02-04 02:14:13 +00:00
|
|
|
</refnamediv>
|
|
|
|
|
|
|
|
<refsynopsisdiv>
|
|
|
|
<para><filename>systemd-hostnamed.service</filename></para>
|
2015-06-18 17:47:44 +00:00
|
|
|
<para><filename>/usr/lib/systemd/systemd-hostnamed</filename></para>
|
2015-02-04 02:14:13 +00:00
|
|
|
</refsynopsisdiv>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>Description</title>
|
|
|
|
|
2020-04-09 13:42:27 +00:00
|
|
|
<para><filename>systemd-hostnamed.service</filename> is a system service that may be used to change the
|
2020-04-14 11:43:11 +00:00
|
|
|
system's hostname and related machine metadata from user programs. It is automatically activated on
|
2020-04-09 13:42:27 +00:00
|
|
|
request and terminates itself when unused.</para>
|
|
|
|
|
|
|
|
<para>It currently offers access to five variables:
|
|
|
|
<itemizedlist>
|
2020-04-14 11:43:11 +00:00
|
|
|
<listitem><para>The current hostname (Example: <literal>dhcp-192-168-47-11</literal>)</para>
|
2020-04-09 13:42:27 +00:00
|
|
|
</listitem>
|
|
|
|
|
2020-04-14 11:43:11 +00:00
|
|
|
<listitem><para>The static (configured) hostname (Example:
|
2020-04-09 13:42:27 +00:00
|
|
|
<literal>lennarts-computer</literal>)</para></listitem>
|
|
|
|
|
2020-04-14 11:43:11 +00:00
|
|
|
<listitem><para>The pretty hostname (Example: <literal>Lennart's Computer</literal>)</para>
|
2020-04-09 13:42:27 +00: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 02:14:13 +00:00
|
|
|
|
2020-12-04 14:16:24 +00:00
|
|
|
<para>The static hostname is stored in <filename>/etc/hostname</filename>, see
|
|
|
|
<citerefentry><refentrytitle>hostname</refentrytitle><manvolnum>5</manvolnum></citerefentry> for more
|
|
|
|
information. The pretty hostname, chassis type, and icon name are stored in
|
|
|
|
<filename>/etc/machine-info</filename>, see
|
|
|
|
<citerefentry><refentrytitle>machine-info</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
|
|
|
|
|
2015-02-04 02:14:13 +00:00
|
|
|
<para>The tool
|
2020-12-04 14:16:24 +00:00
|
|
|
<citerefentry><refentrytitle>hostnamectl</refentrytitle><manvolnum>1</manvolnum></citerefentry> is a
|
|
|
|
command line client to this service.</para>
|
2015-02-04 02:14:13 +00:00
|
|
|
|
2020-04-14 11:43:11 +00:00
|
|
|
<para>See
|
2020-04-24 19:04:43 +00: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 13:42:27 +00:00
|
|
|
for a description of the D-Bus API.</para>
|
2015-02-04 02:14:13 +00:00
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>See Also</title>
|
2023-12-22 18:09:32 +00:00
|
|
|
<para><simplelist type="inline">
|
|
|
|
<member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
|
|
|
|
<member><citerefentry><refentrytitle>hostname</refentrytitle><manvolnum>5</manvolnum></citerefentry></member>
|
|
|
|
<member><citerefentry><refentrytitle>machine-info</refentrytitle><manvolnum>5</manvolnum></citerefentry></member>
|
|
|
|
<member><citerefentry><refentrytitle>hostnamectl</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
|
|
|
|
<member><citerefentry><refentrytitle>sethostname</refentrytitle><manvolnum>2</manvolnum></citerefentry></member>
|
|
|
|
</simplelist></para>
|
2015-02-04 02:14:13 +00:00
|
|
|
</refsect1>
|
2012-06-25 22:04:50 +00:00
|
|
|
|
|
|
|
</refentry>
|