along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->
-<refentry id="hostnamectl">
+<refentry id="hostnamectl" conditional='ENABLE_HOSTNAMED'>
<refentryinfo>
<title>hostnamectl</title>
<para><command>hostnamectl</command> may be used to
query and change the system hostname and related
- settings.</para>
+ settings.</para>
- <para>This tool distuingishes three different host
+ <para>This tool distinguishes three different host
names: the high-level "pretty" hostname which might
- include all all kinds of special characters
+ include all kinds of special characters
(e.g. "Lennart's Laptop"), the static hostname which
is used to initialize the kernel hostname at boot
(e.g. "lennarts-laptop"), and the transient hostname
<para>The static host name is stored in
<filename>/etc/hostname</filename>, see
<citerefentry><refentrytitle>hostname</refentrytitle><manvolnum>5</manvolnum></citerefentry>
- for more information. The pretty host name and icon
- name are stored in
+ for more information. The pretty host name, chassis
+ type and icon name are stored in
<filename>/etc/machine-info</filename>, see
<citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
</refsect1>
<variablelist>
<varlistentry>
- <term><option>--help</option></term>
<term><option>-h</option></term>
+ <term><option>--help</option></term>
<listitem><para>Prints a short help
text and exits.</para></listitem>
<term><option>-H</option></term>
<term><option>--host</option></term>
- <listitem><para>Execute operation
+ <listitem><para>Execute the operation
remotely. Specify a hostname, or
username and hostname separated by @,
to connect to. This will use SSH to
the <ulink
url="http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html">Icon
Naming Specification</ulink>. Pass an
- empty string to this operatoin to
+ empty string to this operation to
reset the icon name to the default
+ value which is determined from chassis
+ type (see below) and possibly other
+ parameters.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><command>set-chassis [TYPE]</command></term>
+
+ <listitem><para>Set the chassis
+ type. The chassis type is used by some
+ graphical applications to visualize
+ the host or alter user
+ interaction. Currently, the following
+ chassis types are defined:
+ <literal>desktop</literal>,
+ <literal>laptop</literal>,
+ <literal>server</literal>,
+ <literal>tablet</literal>,
+ <literal>handset</literal>, as well as
+ the special chassis types
+ <literal>vm</literal> and
+ <literal>container</literal> for
+ virtualized systems that lack an
+ immediate physical chassis. Pass an
+ empty string to this operation to
+ reset the chassis type to the default
value which is determined from the
- system form factor and possibly other
+ firmware and possibly other
parameters.</para></listitem>
</varlistentry>