]> git.ipfire.org Git - thirdparty/systemd.git/blob - meson_options.txt
firstboot: Update help string with --root-shell options
[thirdparty/systemd.git] / meson_options.txt
1 # -*- mode: meson -*-
2 # SPDX-License-Identifier: LGPL-2.1+
3
4 option('version-tag', type : 'string',
5 description : 'override the git version string')
6
7 option('split-usr', type : 'combo', choices : ['auto', 'true', 'false'],
8 description : '''/bin, /sbin aren't symlinks into /usr''')
9 option('split-bin', type : 'combo', choices : ['auto', 'true', 'false'],
10 description : '''sbin is not a symlink to bin''')
11 option('rootlibdir', type : 'string',
12 description : '''[/usr]/lib/x86_64-linux-gnu or such''')
13 option('rootprefix', type : 'string',
14 description : '''override the root prefix [default '/' if split-usr and '/usr' otherwise]''')
15 option('link-udev-shared', type : 'boolean',
16 description : 'link systemd-udev and its helpers to libsystemd-shared.so')
17 option('link-systemctl-shared', type: 'boolean',
18 description : 'link systemctl against libsystemd-shared.so')
19 option('link-networkd-shared', type: 'boolean',
20 description : 'link systemd-networkd and its helpers to libsystemd-shared.so')
21 option('link-timesyncd-shared', type: 'boolean',
22 description : 'link systemd-timesyncd and its helpers to libsystemd-shared.so')
23 option('static-libsystemd', type : 'combo',
24 choices : ['false', 'true', 'pic', 'no-pic'],
25 description : '''install a static library for libsystemd''')
26 option('static-libudev', type : 'combo',
27 choices : ['false', 'true', 'pic', 'no-pic'],
28 description : '''install a static library for libudev''')
29 option('standalone-binaries', type : 'boolean', value : 'false',
30 description : '''also build standalone versions of supported binaries''')
31
32 option('sysvinit-path', type : 'string', value : '/etc/init.d',
33 description : 'the directory where the SysV init scripts are located')
34 option('sysvrcnd-path', type : 'string', value : '/etc/rc.d',
35 description : 'the base directory for SysV rcN.d directories')
36 option('telinit-path', type : 'string', value : '/lib/sysvinit/telinit',
37 description : 'path to telinit')
38 option('rc-local', type : 'string',
39 value : '/etc/rc.local')
40 option('initrd', type: 'boolean',
41 description : 'install services for use when running systemd in initrd')
42
43 option('quotaon-path', type : 'string', description : 'path to quotaon')
44 option('quotacheck-path', type : 'string', description : 'path to quotacheck')
45 option('kmod-path', type : 'string', description : 'path to kmod')
46 option('kexec-path', type : 'string', description : 'path to kexec')
47 option('sulogin-path', type : 'string', description : 'path to sulogin')
48 option('mount-path', type : 'string', description : 'path to mount')
49 option('umount-path', type : 'string', description : 'path to umount')
50 option('loadkeys-path', type : 'string', description : 'path to loadkeys')
51 option('setfont-path', type : 'string', description : 'path to setfont')
52 option('nologin-path', type : 'string', description : 'path to nologin')
53
54 option('debug-shell', type : 'string', value : '/bin/sh',
55 description : 'path to debug shell binary')
56 option('debug-tty', type : 'string', value : '/dev/tty9',
57 description : 'specify the tty device for debug shell')
58 option('debug-extra', type : 'array', choices : ['hashmap', 'mmap-cache', 'siphash'], value : [],
59 description : 'enable extra debugging')
60 option('memory-accounting-default', type : 'boolean',
61 description : 'enable MemoryAccounting= by default')
62 option('bump-proc-sys-fs-file-max', type : 'boolean',
63 description : 'bump /proc/sys/fs/file-max to LONG_MAX')
64 option('bump-proc-sys-fs-nr-open', type : 'boolean',
65 description : 'bump /proc/sys/fs/nr_open to INT_MAX')
66 option('valgrind', type : 'boolean', value : false,
67 description : 'do extra operations to avoid valgrind warnings')
68 option('log-trace', type : 'boolean', value : false,
69 description : 'enable low level debug logging')
70 option('user-path', type : 'string',
71 description : '$PATH to use for user sessions')
72
73 option('utmp', type : 'boolean',
74 description : 'support for utmp/wtmp log handling')
75 option('hibernate', type : 'boolean',
76 description : 'support for hibernation')
77 option('ldconfig', type : 'boolean',
78 description : 'support for dynamic linker cache creation')
79 option('resolve', type : 'boolean',
80 description : 'systemd-resolved stack')
81 option('efi', type : 'boolean',
82 description : 'enable systemd-boot and bootctl')
83 option('tpm', type : 'boolean',
84 description : 'TPM should be used to log events and extend the registers')
85 option('environment-d', type : 'boolean',
86 description : 'support for environment.d')
87 option('binfmt', type : 'boolean',
88 description : 'support for custom binary formats')
89 option('repart', type : 'combo', choices : ['auto', 'true', 'false'],
90 description : 'install the systemd-repart tool')
91 option('coredump', type : 'boolean',
92 description : 'install the coredump handler')
93 option('pstore', type : 'boolean',
94 description : 'install the pstore archival tool')
95 option('logind', type : 'boolean',
96 description : 'install the systemd-logind stack')
97 option('hostnamed', type : 'boolean',
98 description : 'install the systemd-hostnamed stack')
99 option('localed', type : 'boolean',
100 description : 'install the systemd-localed stack')
101 option('machined', type : 'boolean',
102 description : 'install the systemd-machined stack')
103 option('portabled', type : 'boolean',
104 description : 'install the systemd-portabled stack')
105 option('userdb', type : 'boolean',
106 description : 'install the systemd-userdbd stack')
107 option('homed', type : 'combo', choices : ['auto', 'true', 'false'],
108 description : 'install the systemd-homed stack')
109 option('networkd', type : 'boolean',
110 description : 'install the systemd-networkd stack')
111 option('timedated', type : 'boolean',
112 description : 'install the systemd-timedated daemon')
113 option('timesyncd', type : 'boolean',
114 description : 'install the systemd-timesyncd daemon')
115 option('remote', type : 'combo', choices : ['auto', 'true', 'false'],
116 description : 'support for "journal over the network"')
117 option('create-log-dirs', type : 'boolean',
118 description : 'create /var/log/journal{,/remote}')
119 option('nss-myhostname', type : 'boolean',
120 description : 'install nss-myhostname module')
121 option('nss-mymachines', type : 'combo', choices : ['auto', 'true', 'false'],
122 description : 'install nss-mymachines module')
123 option('nss-resolve', type : 'combo', choices : ['auto', 'true', 'false'],
124 description : 'install nss-resolve module')
125 option('nss-systemd', type : 'boolean',
126 description : 'install nss-systemd module')
127 option('firstboot', type : 'boolean',
128 description : 'support for firstboot mechanism')
129 option('randomseed', type : 'boolean',
130 description : 'support for restoring random seed')
131 option('backlight', type : 'boolean',
132 description : 'support for restoring backlight state')
133 option('vconsole', type : 'boolean',
134 description : 'support for vconsole configuration')
135 option('quotacheck', type : 'boolean',
136 description : 'support for the quotacheck tools')
137 option('sysusers', type : 'boolean',
138 description : 'support for the sysusers configuration')
139 option('tmpfiles', type : 'boolean',
140 description : 'support for tmpfiles.d')
141 option('importd', type : 'combo', choices : ['auto', 'true', 'false'],
142 description : 'install the systemd-importd daemon')
143 option('hwdb', type : 'boolean',
144 description : 'support for the hardware database')
145 option('rfkill', type : 'boolean',
146 description : 'support for the rfkill tools')
147 option('xdg-autostart', type : 'boolean',
148 description : 'install the xdg-autostart-generator and unit')
149 option('man', type : 'combo', choices : ['auto', 'true', 'false'],
150 value : 'false',
151 description : 'build and install man pages')
152 option('html', type : 'combo', choices : ['auto', 'true', 'false'],
153 value : 'false',
154 description : 'build and install html pages')
155
156 option('certificate-root', type : 'string', value : '/etc/ssl',
157 description : 'the prefix for TLS certificates')
158 option('dbuspolicydir', type : 'string',
159 description : 'D-Bus policy directory')
160 option('dbussessionservicedir', type : 'string',
161 description : 'D-Bus session service directory')
162 option('dbussystemservicedir', type : 'string',
163 description : 'D-Bus system service directory')
164 option('pkgconfigdatadir', type : 'string', value : '',
165 description : 'directory for arch-independent pkg-config files')
166 option('pkgconfiglibdir', type : 'string', value : '',
167 description : 'directory for standard pkg-config files')
168 option('rpmmacrosdir', type : 'string', value : 'lib/rpm/macros.d',
169 description : 'directory for rpm macros ["no" disables]')
170 option('pamlibdir', type : 'string',
171 description : 'directory for PAM modules')
172 option('pamconfdir', type : 'string',
173 description : 'directory for PAM configuration ["no" disables]')
174 option('docdir', type : 'string',
175 description : 'documentation directory')
176
177 option('fallback-hostname', type : 'string', value : 'localhost',
178 description : 'the hostname used if none configured')
179 option('compat-gateway-hostname', type : 'boolean', value : 'false',
180 description : 'allow "gateway" as the symbolic name for default gateway')
181 option('default-hierarchy', type : 'combo',
182 choices : ['legacy', 'hybrid', 'unified'], value : 'unified',
183 description : 'default cgroup hierarchy')
184 option('default-net-naming-scheme', type : 'combo',
185 choices : ['latest', 'v238', 'v239', 'v240'],
186 description : 'default net.naming-scheme= value')
187 option('status-unit-format-default', type : 'combo',
188 choices : ['description', 'name'],
189 description : 'use unit name or description in messages by default')
190 option('time-epoch', type : 'integer', value : '-1',
191 description : 'time epoch for time clients')
192 option('system-uid-max', type : 'integer', value : '-1',
193 description : 'maximum system UID')
194 option('system-gid-max', type : 'integer', value : '-1',
195 description : 'maximum system GID')
196 option('dynamic-uid-min', type : 'integer', value : 0x0000EF00,
197 description : 'minimum dynamic UID')
198 option('dynamic-uid-max', type : 'integer', value : 0x0000FFEF,
199 description : 'maximum dynamic UID')
200 option('container-uid-base-min', type : 'integer', value : 0x00080000,
201 description : 'minimum container UID base')
202 option('container-uid-base-max', type : 'integer', value : 0x6FFF0000,
203 description : 'maximum container UID base')
204 option('tty-gid', type : 'integer', value : 5,
205 description : 'the numeric GID of the "tty" group')
206 option('users-gid', type : 'integer', value : '-1',
207 description : 'the numeric GID of the "users" group')
208 option('adm-group', type : 'boolean',
209 description : 'the ACL for adm group should be added')
210 option('wheel-group', type : 'boolean',
211 description : 'the ACL for wheel group should be added')
212 option('nobody-user', type : 'string',
213 description : 'The name of the nobody user (the one with UID 65534)',
214 value : 'nobody')
215 option('nobody-group', type : 'string',
216 description : 'The name of the nobody group (the one with GID 65534)',
217 value : 'nobody')
218 option('dev-kvm-mode', type : 'string', value : '0666',
219 description : '/dev/kvm access mode')
220 option('group-render-mode', type : 'string', value : '0666',
221 description : 'Access mode for devices owned by render group (e.g. /dev/dri/renderD*, /dev/kfd).')
222 option('default-kill-user-processes', type : 'boolean',
223 description : 'the default value for KillUserProcesses= setting')
224 option('gshadow', type : 'boolean',
225 description : 'support for shadow group')
226 option('default-locale', type : 'string', value : '',
227 description : 'default locale used when /etc/locale.conf does not exist')
228 option('service-watchdog', type : 'string', value : '3min',
229 description : 'default watchdog setting for systemd services')
230
231 option('default-dnssec', type : 'combo',
232 description : 'default DNSSEC mode',
233 choices : ['yes', 'allow-downgrade', 'no'],
234 value : 'allow-downgrade')
235 option('default-dns-over-tls', type : 'combo',
236 description : 'default DNS-over-TLS mode',
237 choices : ['yes', 'opportunistic', 'no'],
238 value : 'no')
239 option('default-mdns', type : 'combo',
240 choices : ['yes', 'resolve', 'no'],
241 description : 'default MulticastDNS mode',
242 value : 'yes')
243 option('default-llmnr', type : 'combo',
244 choices : ['yes', 'resolve', 'no'],
245 description : 'default LLMNR mode',
246 value : 'yes')
247 option('dns-over-tls', type : 'combo', choices : ['auto', 'gnutls', 'openssl', 'true', 'false'],
248 description : 'DNS-over-TLS support')
249 option('dns-servers', type : 'string',
250 description : 'space-separated list of default DNS servers',
251 value : '1.1.1.1 8.8.8.8 1.0.0.1 8.8.4.4 2606:4700:4700::1111 2001:4860:4860::8888 2606:4700:4700::1001 2001:4860:4860::8844')
252 option('ntp-servers', type : 'string',
253 description : 'space-separated list of default NTP servers',
254 value : 'time1.google.com time2.google.com time3.google.com time4.google.com')
255 option('support-url', type : 'string',
256 description : 'the support URL to show in catalog entries included in systemd',
257 value : 'https://lists.freedesktop.org/mailman/listinfo/systemd-devel')
258 option('www-target', type : 'string',
259 description : 'the address and dir to upload docs too',
260 value : 'www.freedesktop.org:/srv/www.freedesktop.org/www/software/systemd')
261
262 option('seccomp', type : 'combo', choices : ['auto', 'true', 'false'],
263 description : 'SECCOMP support')
264 option('selinux', type : 'combo', choices : ['auto', 'true', 'false'],
265 description : 'SELinux support')
266 option('apparmor', type : 'combo', choices : ['auto', 'true', 'false'],
267 description : 'AppArmor support')
268 option('smack', type : 'boolean',
269 description : 'SMACK support')
270 option('smack-run-label', type : 'string',
271 description : 'run systemd --system itself with a specific SMACK label')
272 option('polkit', type : 'combo', choices : ['auto', 'true', 'false'],
273 description : 'polkit support')
274 option('ima', type : 'boolean',
275 description : 'IMA support')
276
277 option('acl', type : 'combo', choices : ['auto', 'true', 'false'],
278 description : 'libacl support')
279 option('audit', type : 'combo', choices : ['auto', 'true', 'false'],
280 description : 'libaudit support')
281 option('blkid', type : 'combo', choices : ['auto', 'true', 'false'],
282 description : 'libblkid support')
283 option('fdisk', type : 'combo', choices : ['auto', 'true', 'false'],
284 description : 'libfdisk support')
285 option('kmod', type : 'combo', choices : ['auto', 'true', 'false'],
286 description : 'support for loadable modules')
287 option('pam', type : 'combo', choices : ['auto', 'true', 'false'],
288 description : 'PAM support')
289 option('pwquality', type : 'combo', choices : ['auto', 'true', 'false'],
290 description : 'libpwquality support')
291 option('microhttpd', type : 'combo', choices : ['auto', 'true', 'false'],
292 description : 'libµhttpd support')
293 option('libcryptsetup', type : 'combo', choices : ['auto', 'true', 'false'],
294 description : 'libcryptsetup support')
295 option('libcurl', type : 'combo', choices : ['auto', 'true', 'false'],
296 description : 'libcurl support')
297 option('idn', type : 'boolean',
298 description : 'use IDN when printing hostnames')
299 option('libidn2', type : 'combo', choices : ['auto', 'true', 'false'],
300 description : 'libidn2 support')
301 option('libidn', type : 'combo', choices : ['auto', 'true', 'false'],
302 description : 'libidn support')
303 option('libiptc', type : 'combo', choices : ['auto', 'true', 'false'],
304 description : 'libiptc support')
305 option('qrencode', type : 'combo', choices : ['auto', 'true', 'false'],
306 description : 'libqrencode support')
307 option('gcrypt', type : 'combo', choices : ['auto', 'true', 'false'],
308 description : 'gcrypt support')
309 option('gnutls', type : 'combo', choices : ['auto', 'true', 'false'],
310 description : 'gnutls support')
311 option('openssl', type : 'combo', choices : ['auto', 'true', 'false'],
312 description : 'openssl support')
313 option('p11kit', type : 'combo', choices : ['auto', 'true', 'false'],
314 description : 'p11kit support')
315 option('libfido2', type : 'combo', choices : ['auto', 'true', 'false'],
316 description : 'FIDO2 support')
317 option('elfutils', type : 'combo', choices : ['auto', 'true', 'false'],
318 description : 'elfutils support')
319 option('zlib', type : 'combo', choices : ['auto', 'true', 'false'],
320 description : 'zlib compression support')
321 option('bzip2', type : 'combo', choices : ['auto', 'true', 'false'],
322 description : 'bzip2 compression support')
323 option('xz', type : 'combo', choices : ['auto', 'true', 'false'],
324 description : 'xz compression support')
325 option('lz4', type : 'combo', choices : ['auto', 'true', 'false'],
326 description : 'lz4 compression support')
327 option('zstd', type : 'combo', choices : ['auto', 'true', 'false'],
328 description : 'zstd compression support')
329 option('xkbcommon', type : 'combo', choices : ['auto', 'true', 'false'],
330 description : 'xkbcommon keymap support')
331 option('pcre2', type : 'combo', choices : ['auto', 'true', 'false'],
332 description : 'regexp matching support using pcre2')
333 option('glib', type : 'combo', choices : ['auto', 'true', 'false'],
334 description : 'libglib support (for tests only)')
335 option('dbus', type : 'combo', choices : ['auto', 'true', 'false'],
336 description : 'libdbus support (for tests only)')
337
338 option('gnu-efi', type : 'combo', choices : ['auto', 'true', 'false'],
339 description : 'gnu-efi support for sd-boot')
340 option('efi-cc', type : 'array',
341 description : 'the compiler to use for EFI modules')
342 option('efi-ld', type : 'string',
343 description : 'the linker to use for EFI modules')
344 option('efi-libdir', type : 'string',
345 description : 'path to the EFI lib directory')
346 option('efi-includedir', type : 'string', value : '/usr/include/efi',
347 description : 'path to the EFI header directory')
348 option('tpm-pcrindex', type : 'integer', value : 8,
349 description : 'TPM PCR register number to use')
350
351 option('bashcompletiondir', type : 'string',
352 description : 'directory for bash completion scripts ["no" disables]')
353 option('zshcompletiondir', type : 'string',
354 description : 'directory for zsh completion scripts ["no" disables]')
355
356 option('tests', type : 'combo', choices : ['true', 'unsafe', 'false'],
357 description : 'enable extra tests with =unsafe')
358 option('slow-tests', type : 'boolean', value : 'false',
359 description : 'run the slow tests by default')
360 option('fuzz-tests', type : 'boolean', value : 'false',
361 description : 'run the fuzzer regression tests by default')
362 option('install-tests', type : 'boolean', value : 'false',
363 description : 'install test executables')
364
365 option('ok-color', type: 'combo',
366 choices : ['black', 'red', 'green', 'yellow', 'blue', 'magenta', 'cyan',
367 'white', 'highlight-black', 'highlight-red', 'highlight-green',
368 'highlight-yellow', 'highlight-blue', 'highlight-magenta',
369 'highlight-cyan', 'highlight-white'],
370 value : 'green',
371 description: 'color of the "OK" status message')
372
373 option('oss-fuzz', type : 'boolean', value : 'false',
374 description : 'build against oss-fuzz')
375 option('llvm-fuzz', type : 'boolean', value : 'false',
376 description : 'build against LLVM libFuzzer')
377 option('kernel-install', type: 'boolean', value: 'true',
378 description : 'install kernel-install and associated files')
379 option('analyze', type: 'boolean', value: 'true',
380 description : 'install systemd-analyze')