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