Debian Codegraph @

upstream/fedora-44/man5/machine-info.5

raw
1 '\" t
2 .TH "MACHINE\-INFO" "5" "" "systemd 259.5" "machine-info"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 machine-info \- Local machine information file
24 .SH "SYNOPSIS"
25 .PP
26 /etc/machine\-info
27 .SH "DESCRIPTION"
28 .PP
29 The
30 /etc/machine\-info
31 file contains machine metadata\&.
32 .PP
33 The format of
34 machine\-info
35 is a newline\-separated list of environment\-like shell\-compatible variable assignments, ignoring comments and empty lines\&. It is possible to source the configuration from shell scripts, however, beyond mere variable assignments no shell features are supported, allowing applications to read the file without implementing a shell compatible execution engine\&. See
36 \fBos-release\fR(5)
37 for a detailed description of the format\&.
38 .PP
39 /etc/machine\-info
40 contains metadata about the machine that is set by the user or administrator\&. The settings configured here have the highest precedence\&. When not set, appropriate values may be determined automatically, based on the information about the hardware or other configuration files\&. It is thus completely fine for this file to not be present\&.
41 .PP
42 You may use
43 \fBhostnamectl\fR(1)
44 to change the settings of this file from the command line\&.
45 .SH "OPTIONS"
46 .PP
47 The following machine metadata parameters may be set using
48 /etc/machine\-info:
49 .SS "Machine Information"
50 .PP
51 \fIPRETTY_HOSTNAME=\fR
52 .RS 4
53 A pretty human\-readable UTF\-8 machine identifier string\&. This should contain a name like
54 "Lennart\*(Aqs Laptop"
55 which is useful to present to the user and does not suffer by the syntax limitations of internet domain names\&. If possible, the internet hostname as configured in
56 /etc/hostname
57 should be kept similar to this one\&. Example: if this value is
58 "Lennart\*(Aqs Computer"
59 an Internet hostname of
60 "lennarts\-computer"
61 might be a good choice\&. If this parameter is not set, an application should fall back to the Internet hostname for presentation purposes\&.
62 .RE
63 .PP
64 \fIICON_NAME=\fR
65 .RS 4
66 An icon identifying this machine according to the
67 \m[blue]\fBXDG Icon Naming Specification\fR\m[]\&\s-2\u[1]\d\s+2\&. If this parameter is not set, an application should fall back to
68 "computer"
69 or a similar icon name\&.
70 .RE
71 .PP
72 \fICHASSIS=\fR
73 .RS 4
74 The chassis type\&. Currently, the following chassis types are defined:
75 "desktop",
76 "laptop",
77 "convertible",
78 "server",
79 "tablet",
80 "handset",
81 "watch", and
82 "embedded", as well as the special chassis types
83 "vm"
84 and
85 "container"
86 for virtualized systems that lack an immediate physical chassis\&.
87 .sp
88 Note that most systems allow detection of the chassis type automatically (based on firmware information or suchlike)\&. This setting should only be used to override a misdetection or to manually configure the chassis type where automatic detection is not available\&.
89 .sp
90 Added in version 197\&.
91 .RE
92 .PP
93 \fIDEPLOYMENT=\fR
94 .RS 4
95 Describes the system deployment environment\&. One of the following is suggested:
96 "development",
97 "integration",
98 "staging",
99 "testing",
100 "production"\&.
101 .sp
102 Added in version 216\&.
103 .RE
104 .PP
105 \fILOCATION=\fR
106 .RS 4
107 Describes the system location if applicable and known\&. Takes a human\-friendly, free\-form string\&. This may be as generic as
108 "Berlin, Germany"
109 or as specific as
110 "Left Rack, 2nd Shelf"\&.
111 .sp
112 Added in version 216\&.
113 .RE
114 .PP
115 \fIHARDWARE_VENDOR=\fR
116 .RS 4
117 Specifies the hardware vendor\&. If unspecified, the hardware vendor set in DMI or
118 \fBhwdb\fR(7)
119 will be used\&.
120 .sp
121 Added in version 251\&.
122 .RE
123 .PP
124 \fIHARDWARE_MODEL=\fR
125 .RS 4
126 Specifies the hardware model\&. If unspecified, the hardware model set in DMI or
127 \fBhwdb\fR(7)
128 will be used\&.
129 .sp
130 Added in version 251\&.
131 .RE
132 .PP
133 \fIHARDWARE_SKU=\fR
134 .RS 4
135 Specifies the hardware SKU (Stock\-Keeping Unit)\&. If unspecified, the hardware SKU set in DMI will be used\&.
136 .sp
137 Added in version 258\&.
138 .RE
139 .PP
140 \fIHARDWARE_VERSION=\fR
141 .RS 4
142 Specifies the hardware version\&. If unspecified, the hardware version set in DMI will be used\&.
143 .sp
144 Added in version 258\&.
145 .RE
146 .SS "Custom Fields"
147 .PP
148 Operating system vendors and systemd administrators may extend the file format and introduce new fields\&. It is highly recommended to prefix new fields with an OS\-specific name in order to avoid name clashes\&. Applications reading this file must ignore unknown fields\&.
149 .PP
150 Example:
151 "_LOCAL_EMERGENCY_CONTACT="user@example\&.org""\&.
152 .SH "EXAMPLE"
153 .sp
154 .if n \{\
155 .RS 4
156 .\}
157 .nf
158 PRETTY_HOSTNAME="Lennart\*(Aqs Tablet"
159 ICON_NAME=computer\-tablet
160 CHASSIS=tablet
161 DEPLOYMENT=production
162 .fi
163 .if n \{\
164 .RE
165 .\}
166 .SH "SEE ALSO"
167 .PP
168 \fBsystemd\fR(1), \fBos-release\fR(5), \fBhostname\fR(5), \fBmachine-id\fR(5), \fBhostnamectl\fR(1), \fBsystemd-hostnamed.service\fR(8)
169 .SH "NOTES"
170 .IP " 1." 4
171 XDG Icon Naming Specification
172 .RS 4
173 \%https://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html
174 .RE