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