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