summaryrefslogtreecommitdiff
path: root/man/hostnamectl.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2012-12-24 19:03:59 +0100
committerLennart Poettering <lennart@poettering.net>2012-12-24 19:03:59 +0100
commit7871c8e9327e4e5b18de9d8081b0f32fa38c2c1f (patch)
tree56dea3f21fcc707ac392696697a50d18c21a09d5 /man/hostnamectl.xml
parentf9ea108e7c3544c03822277a1112a48dc62f6ed4 (diff)
hostnamed: make chassis type configurable via /etc/machine-info
For many usecases it is useful to store the chassis type somewhere, and /etc/machine-info sounds like a good place. Ideally we could always detect the chassis type from firmware, but frequently that's not available and in many embedded devices probably entirely unrealistic. This patch adds a configurable setting CHASSIS= to /etc/machine-info and exposes this via hostnamectl/hostnamed. hostnamed will guess the chassis type from DMI if nothing is set explicitly. I also added support for detecting it from ACPI, which should be more useful as ACPI 5.0 actually knows a "tablet" chassis type, which neither DMI nor previous ACPI versions knew. This also enables DMI-based and ACPI-based detection for non-x86 systems as ACPI is apparently coming to ARM platforms soon. I tried to minimize the vocabulary of chassis types understood and added: desktop, laptop, server, tablet, handset. This is much less than either APCI or DMI know. If we need more types later on we can easily add them.
Diffstat (limited to 'man/hostnamectl.xml')
-rw-r--r--man/hostnamectl.xml32
1 files changed, 29 insertions, 3 deletions
diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml
index c36f522c8e..a29d2f5b75 100644
--- a/man/hostnamectl.xml
+++ b/man/hostnamectl.xml
@@ -80,8 +80,8 @@
<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>
@@ -198,8 +198,34 @@
Naming Specification</ulink>. Pass an
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>