meson_options.txt

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