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