system/Config.in

   1 menu "System configuration"
   2
   3 choice
   4         prompt "Root FS skeleton"
   5
   6 config BR2_ROOTFS_SKELETON_DEFAULT
   7         bool "default target skeleton"
   8         help
   9           Use default target skeleton
  10
  11 config BR2_ROOTFS_SKELETON_CUSTOM
  12         bool "custom target skeleton"
  13         help
  14           Use custom target skeleton.
  15
  16 endchoice
  17
  18 if BR2_ROOTFS_SKELETON_CUSTOM
  19
  20 config BR2_ROOTFS_SKELETON_CUSTOM_PATH
  21         string "custom target skeleton path"
  22         help
  23           Path to custom target skeleton.
  24
  25 # dummy config so merged /usr workarounds can also be activated for
  26 # custom rootfs skeleton
  27 config BR2_ROOTFS_MERGED_USR
  28
  29 endif
  30
  31 if BR2_ROOTFS_SKELETON_DEFAULT
  32
  33 config BR2_TARGET_GENERIC_HOSTNAME
  34         string "System hostname"
  35         default "buildroot"
  36         help
  37           Select system hostname to be stored in /etc/hostname.
  38
  39           Leave empty to not create /etc/hostname, or to keep the
  40           one from a custom skeleton.
  41
  42 config BR2_TARGET_GENERIC_ISSUE
  43         string "System banner"
  44         default "Welcome to Buildroot"
  45         help
  46           Select system banner (/etc/issue) to be displayed at login.
  47
  48           Leave empty to not create /etc/issue, or to keep the
  49           one from a custom skeleton.
  50
  51 endif
  52
  53 choice
  54         bool "Passwords encoding"
  55         default BR2_TARGET_GENERIC_PASSWD_MD5
  56         help
  57           Choose the password encoding scheme to use when Buildroot
  58           needs to encode a password (eg. the root password, below).
  59
  60           Note: this is used at build-time, and *not* at runtime.
  61
  62 config BR2_TARGET_GENERIC_PASSWD_MD5
  63         bool "md5"
  64         help
  65           Use MD5 to encode passwords.
  66
  67           The default. Wildly available, and pretty good.
  68           Although pretty strong, MD5 is now an old hash function, and
  69           suffers from some weaknesses, which makes it susceptible to
  70           brute-force attacks.
  71
  72 config BR2_TARGET_GENERIC_PASSWD_SHA256
  73         bool "sha-256"
  74         help
  75           Use SHA256 to encode passwords.
  76
  77           Very strong, but not ubiquitous, although available in glibc
  78           for some time now. Choose only if you are sure your C library
  79           understands SHA256 passwords.
  80
  81 config BR2_TARGET_GENERIC_PASSWD_SHA512
  82         bool "sha-512"
  83         help
  84           Use SHA512 to encode passwords.
  85
  86           Extremely strong, but not ubiquitous, although available in glibc
  87           for some time now. Choose only if you are sure your C library
  88           understands SHA512 passwords.
  89
  90 endchoice # Passwd encoding
  91
  92 config BR2_TARGET_GENERIC_PASSWD_METHOD
  93         string
  94         default "md5"       if BR2_TARGET_GENERIC_PASSWD_MD5
  95         default "sha-256"   if BR2_TARGET_GENERIC_PASSWD_SHA256
  96         default "sha-512"   if BR2_TARGET_GENERIC_PASSWD_SHA512
  97
  98 choice
  99         prompt "Init system"
 100         default BR2_INIT_BUSYBOX
 101
 102 config BR2_INIT_BUSYBOX
 103         bool "BusyBox"
 104         select BR2_PACKAGE_BUSYBOX
 105         select BR2_PACKAGE_INITSCRIPTS
 106
 107 config BR2_INIT_SYSV
 108         bool "systemV"
 109         select BR2_PACKAGE_BUSYBOX_SHOW_OTHERS # sysvinit
 110         select BR2_PACKAGE_INITSCRIPTS
 111         select BR2_PACKAGE_SYSVINIT
 112
 113 # In Buildroot, we decided not to support a split-usr when systemd is
 114 # used as an init system. This is a design decision, not a systemd
 115 # issue. Thus the select is with BR2_INIT_SYSTEMD (below) rather than
 116 # with BR2_PACKAGE_SYSTEMD.
 117 config BR2_INIT_SYSTEMD
 118         bool "systemd"
 119         depends on BR2_PACKAGE_SYSTEMD_ARCH_SUPPORTS
 120         depends on BR2_TOOLCHAIN_USES_GLIBC
 121         depends on BR2_USE_WCHAR
 122         depends on BR2_TOOLCHAIN_HAS_THREADS
 123         depends on BR2_TOOLCHAIN_HAS_SSP
 124         depends on BR2_USE_MMU
 125         depends on !BR2_STATIC_LIBS
 126         depends on BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_10
 127         select BR2_ROOTFS_MERGED_USR
 128         select BR2_PACKAGE_SYSTEMD
 129         select BR2_TARGET_GENERIC_REMOUNT_ROOTFS_RW
 130
 131 comment "systemd needs a glibc toolchain, headers >= 3.10"
 132         depends on !(BR2_TOOLCHAIN_USES_GLIBC \
 133                 && BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_10)
 134
 135 config BR2_INIT_NONE
 136         bool "None"
 137         help
 138           Buildroot will not install any init system. You will
 139           have to provide your own, either with a new package
 140           or with a rootfs-overlay.
 141
 142 endchoice
 143
 144 choice
 145         prompt "/dev management" if !BR2_INIT_SYSTEMD
 146         default BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_DEVTMPFS
 147
 148 config BR2_ROOTFS_DEVICE_CREATION_STATIC
 149         bool "Static using device table"
 150
 151 config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_DEVTMPFS
 152         bool "Dynamic using devtmpfs only"
 153
 154 config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_MDEV
 155         bool "Dynamic using devtmpfs + mdev"
 156         select BR2_PACKAGE_BUSYBOX
 157
 158 config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_EUDEV
 159         bool "Dynamic using devtmpfs + eudev"
 160         depends on BR2_USE_WCHAR
 161         depends on !BR2_STATIC_LIBS
 162         depends on BR2_USE_MMU # eudev
 163         select BR2_PACKAGE_EUDEV
 164
 165 comment "eudev needs a toolchain w/ wchar, dynamic library"
 166         depends on BR2_USE_MMU
 167         depends on !BR2_USE_WCHAR || BR2_STATIC_LIBS
 168
 169 endchoice
 170
 171 comment "/dev management using udev (from systemd)"
 172         depends on BR2_INIT_SYSTEMD
 173
 174 config BR2_ROOTFS_DEVICE_TABLE
 175         string "Path to the permission tables"
 176         default "system/device_table.txt"
 177         help
 178           Specify a space-separated list of permission table locations,
 179           that will be passed to the makedevs utility to assign
 180           correct owners and permissions on various files in the
 181           target filesystem.
 182
 183           See package/makedevs/README for details on the usage and
 184           syntax of these files.
 185
 186 config BR2_ROOTFS_STATIC_DEVICE_TABLE
 187         string "Path to the device tables"
 188         default "system/device_table_dev.txt"
 189         depends on BR2_ROOTFS_DEVICE_CREATION_STATIC
 190         help
 191           Specify a space-separated list of device table locations,
 192           that will be passed to the makedevs utility to create all
 193           the special device files under /dev.
 194
 195           See package/makedevs/README for details on the usage and
 196           syntax of these files.
 197
 198 config BR2_ROOTFS_DEVICE_TABLE_SUPPORTS_EXTENDED_ATTRIBUTES
 199         bool "support extended attributes in device tables"
 200         help
 201           Support extended attributes handling in device tables
 202
 203 if BR2_ROOTFS_SKELETON_DEFAULT
 204
 205 config BR2_ROOTFS_MERGED_USR
 206         bool "Use symlinks to /usr for /bin, /sbin and /lib"
 207         help
 208           If you say 'n' here, then /bin, /sbin and /lib and their
 209           counterparts in /usr will be separate directories. This
 210           is the historical UNIX way. In this case, /usr can be a
 211           filesystem on a partition separate from / .
 212
 213           If you say 'y' here, then /bin, /sbin and /lib will be symlinks
 214           to their counterparts in /usr. In this case, /usr can not be a
 215           separate filesystem.
 216
 217 config BR2_TARGET_ENABLE_ROOT_LOGIN
 218         bool "Enable root login with password"
 219         default y
 220         help
 221           Allow root to log in with a password.
 222
 223           If not enabled, root will not be able to log in with a password.
 224           However, if you have an ssh server and you add an ssh key, you
 225           can still allow root to log in. Alternatively, you can use sudo
 226           to become root.
 227
 228 config BR2_TARGET_GENERIC_ROOT_PASSWD
 229         string "Root password"
 230         default ""
 231         depends on BR2_TARGET_ENABLE_ROOT_LOGIN
 232         help
 233           Set the initial root password.
 234
 235           If set to empty (the default), then no root password will be set,
 236           and root will need no password to log in.
 237
 238           If the password starts with any of $1$, $5$ or $6$, it is considered
 239           to be already crypt-encoded with respectively md5, sha256 or sha512.
 240           Any other value is taken to be a clear-text value, and is crypt-encoded
 241           as per the "Passwords encoding" scheme, above.
 242
 243           Note: "$" signs in the hashed password must be doubled. For example,
 244           if the hashed password is "$1$longsalt$v35DIIeMo4yUfI23yditq0",
 245           then you must enter it as "$$1$$longsalt$$v35DIIeMo4yUfI23yditq0"
 246           (this is necessary otherwise make would attempt to interpret the $
 247           as a variable expansion).
 248
 249           WARNING! WARNING!
 250           The password appears as-is in the .config file, and may appear
 251           in the build log! Avoid using a valuable password if either the
 252           .config file or the build log may be distributed, or at the
 253           very least use a strong cryptographic hash for your password!
 254
 255 choice
 256         bool "/bin/sh"
 257         default BR2_SYSTEM_BIN_SH_DASH if !BR2_PACKAGE_BUSYBOX
 258         help
 259           Select which shell will provide /bin/sh.
 260
 261 # busybox has shells that work on noMMU
 262 config BR2_SYSTEM_BIN_SH_BUSYBOX
 263         bool "busybox' default shell"
 264         depends on BR2_PACKAGE_BUSYBOX
 265
 266 config BR2_SYSTEM_BIN_SH_BASH
 267         bool "bash"
 268         depends on BR2_USE_MMU # bash
 269         depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
 270         select BR2_PACKAGE_BASH
 271
 272 config BR2_SYSTEM_BIN_SH_DASH
 273         bool "dash"
 274         depends on BR2_USE_MMU # dash
 275         depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
 276         select BR2_PACKAGE_DASH
 277
 278 config BR2_SYSTEM_BIN_SH_ZSH
 279         bool "zsh"
 280         depends on BR2_USE_MMU # zsh
 281         depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
 282         select BR2_PACKAGE_ZSH
 283
 284 comment "bash, dash, zsh need BR2_PACKAGE_BUSYBOX_SHOW_OTHERS"
 285         depends on !BR2_PACKAGE_BUSYBOX_SHOW_OTHERS && BR2_PACKAGE_BUSYBOX
 286
 287 config BR2_SYSTEM_BIN_SH_NONE
 288         bool "none"
 289
 290 endchoice # /bin/sh
 291
 292 config BR2_SYSTEM_BIN_SH
 293         string
 294         default "busybox" if BR2_SYSTEM_BIN_SH_BUSYBOX
 295         default "bash"    if BR2_SYSTEM_BIN_SH_BASH
 296         default "dash"    if BR2_SYSTEM_BIN_SH_DASH
 297         default "zsh"     if BR2_SYSTEM_BIN_SH_ZSH
 298
 299 menuconfig BR2_TARGET_GENERIC_GETTY
 300         bool "Run a getty (login prompt) after boot"
 301         default y
 302
 303 if BR2_TARGET_GENERIC_GETTY
 304 config BR2_TARGET_GENERIC_GETTY_PORT
 305         string "TTY port"
 306         default "console"
 307         help
 308           Specify a port to run a getty on.
 309
 310 choice
 311         prompt "Baudrate"
 312         default BR2_TARGET_GENERIC_GETTY_BAUDRATE_KEEP
 313         help
 314           Select a baudrate to use.
 315
 316 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_KEEP
 317         bool "keep kernel default"
 318 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_9600
 319         bool "9600"
 320 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_19200
 321         bool "19200"
 322 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_38400
 323         bool "38400"
 324 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_57600
 325         bool "57600"
 326 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_115200
 327         bool "115200"
 328 endchoice
 329
 330 config BR2_TARGET_GENERIC_GETTY_BAUDRATE
 331         string
 332         default "0"             if BR2_TARGET_GENERIC_GETTY_BAUDRATE_KEEP
 333         default "9600"          if BR2_TARGET_GENERIC_GETTY_BAUDRATE_9600
 334         default "19200"         if BR2_TARGET_GENERIC_GETTY_BAUDRATE_19200
 335         default "38400"         if BR2_TARGET_GENERIC_GETTY_BAUDRATE_38400
 336         default "57600"         if BR2_TARGET_GENERIC_GETTY_BAUDRATE_57600
 337         default "115200"        if BR2_TARGET_GENERIC_GETTY_BAUDRATE_115200
 338
 339 config BR2_TARGET_GENERIC_GETTY_TERM
 340         string "TERM environment variable"
 341         default "vt100"
 342         help
 343           Specify a TERM type.
 344
 345 config BR2_TARGET_GENERIC_GETTY_OPTIONS
 346         string "other options to pass to getty"
 347         default ""
 348         help
 349           Any other flags you want to pass to getty,
 350           Refer to getty --help for details.
 351 endif
 352
 353 config BR2_TARGET_GENERIC_REMOUNT_ROOTFS_RW
 354         bool "remount root filesystem read-write during boot"
 355         default y
 356         help
 357           The root filesystem is typically mounted read-only at boot.
 358           By default, buildroot remounts it in read-write mode early during the
 359           boot process.
 360           Say no here if you would rather like your root filesystem to remain
 361           read-only.
 362           If unsure, say Y.
 363
 364 config BR2_SYSTEM_DHCP
 365         string "Network interface to configure through DHCP"
 366         default ""
 367         depends on !BR2_PACKAGE_SYSTEMD_NETWORKD && (BR2_PACKAGE_BUSYBOX || BR2_PACKAGE_IFUPDOWN)
 368         help
 369           Enter here the name of the network interface (E.G. eth0) to
 370           automatically configure through DHCP at bootup.
 371
 372           If left empty, no automatic DHCP requests will take place.
 373
 374           For more complicated network setups use an overlay to overwrite
 375           /etc/network/interfaces or add a networkd configuration file.
 376
 377 comment "automatic network configuration via DHCP is not compatible with networkd"
 378         depends on BR2_PACKAGE_SYSTEMD_NETWORKD
 379
 380 comment "automatic network configuration via DHCP needs ifupdown or busybox"
 381         depends on !(BR2_PACKAGE_BUSYBOX || BR2_PACKAGE_IFUPDOWN)
 382
 383 endif # BR2_ROOTFS_SKELETON_DEFAULT
 384
 385 config BR2_ENABLE_LOCALE_PURGE
 386         bool "Purge unwanted locales"
 387         default y
 388         help
 389           Explicitly specify what locales to install on target. If N
 390           then all locales supported by packages are installed.
 391
 392 config BR2_ENABLE_LOCALE_WHITELIST
 393         string "Locales to keep"
 394         default "C en_US"
 395         depends on BR2_ENABLE_LOCALE_PURGE
 396         help
 397           Whitespace seperated list of locales to allow on target.
 398           Locales not listed here will be removed from the target.
 399           See 'locale -a' on your host for a list of locales available
 400           on your build host, or have a look in /usr/share/locale in
 401           the target file system for available locales.
 402
 403           Notice that listing a locale here doesn't guarantee that it
 404           will be available on the target - That purely depends on the
 405           support for that locale in the selected packages.
 406
 407 config BR2_GENERATE_LOCALE
 408         string "Generate locale data"
 409         default ""
 410         depends on \
 411                 (BR2_TOOLCHAIN_BUILDROOT_UCLIBC && BR2_ENABLE_LOCALE) || \
 412                 BR2_TOOLCHAIN_USES_GLIBC
 413         help
 414           Generate support for a list of locales. Locales can be
 415           specified with or without encoding, when no encoding is
 416           specified, UTF-8 is assumed. Examples of locales: en_US,
 417           fr_FR.UTF-8.
 418
 419 config BR2_TARGET_TZ_INFO
 420         bool "Install timezone info"
 421         # No timezone for musl; only for uClibc or glibc.
 422         depends on BR2_TOOLCHAIN_USES_GLIBC || BR2_TOOLCHAIN_USES_UCLIBC
 423         select BR2_PACKAGE_TZDATA if BR2_TOOLCHAIN_USES_GLIBC
 424         select BR2_PACKAGE_TZ if BR2_TOOLCHAIN_USES_UCLIBC
 425         help
 426           Say 'y' here to install timezone info.
 427
 428 if BR2_TARGET_TZ_INFO
 429
 430 config BR2_TARGET_TZ_ZONELIST
 431         string "timezone list"
 432         default "default"
 433         help
 434           Space-separated list of time zones to compile.
 435
 436           The value "default" includes all commonly used time zones. Note
 437           that this set consumes around 5.5M for glibc and 2.1M for uClibc.
 438
 439           The full list is the list of files in the time zone database source,
 440           not including the build and .tab files.
 441
 442 config BR2_TARGET_LOCALTIME
 443         string "default local time"
 444         default "Etc/UTC"
 445         help
 446           The time zone to install as the default local time, expressed as a
 447           tzdata location, such as:
 448             GMT
 449             Europe/Paris
 450             America/New_York
 451             Pacific/Wallis
 452             ...
 453
 454           If empty, no local time will be set, and the dates will be
 455           expressed in UTC.
 456
 457 endif # BR2_TARGET_TZ_INFO
 458
 459 config BR2_ROOTFS_USERS_TABLES
 460         string "Path to the users tables"
 461         help
 462           Specify a space-separated list of users table locations,
 463           that will be passed to the mkusers utility to create
 464           users on the system, with home directory, password, etc.
 465
 466           See manual for details on the usage and syntax of these files.
 467
 468 config BR2_ROOTFS_OVERLAY
 469         string "Root filesystem overlay directories"
 470         default ""
 471         help
 472           Specify a list of directories that are copied over the target
 473           root filesystem after the build has finished and before it is
 474           packed into the selected filesystem images.
 475
 476           They are copied as-is into the rootfs, excluding files ending with
 477           ~ and .git, .svn and .hg directories.
 478
 479 config BR2_ROOTFS_POST_BUILD_SCRIPT
 480         string "Custom scripts to run before creating filesystem images"
 481         default ""
 482         help
 483           Specify a space-separated list of scripts to be run after the build
 484           has finished and before Buildroot starts packing the files into
 485           selected filesystem images.
 486
 487           This gives users the opportunity to do board-specific cleanups,
 488           add-ons and the like, so the generated files can be used directly
 489           without further processing.
 490
 491           These scripts are called with the target directory name as first
 492           argument. Make sure the exit code of those scripts are 0, otherwise
 493           make will stop after calling them.
 494
 495 config BR2_ROOTFS_POST_FAKEROOT_SCRIPT
 496         string "Custom scripts to run inside the fakeroot environment"
 497         default ""
 498         help
 499           Specify a space-separated list of scripts to be run at the end
 500           of the fakeroot script right before the image(s) are actually
 501           generated.
 502
 503           This gives users the opportunity to do customisations of the
 504           content of the rootfs, which would otherwise require root
 505           rigths.
 506
 507           These scripts are called with the target directory name as
 508           first argument. The build will fail on the first scripts that
 509           exits with a non-zero exit code.
 510
 511           Note that Buildroot already provides mechanisms to customise
 512           the content of the rootfs:
 513
 514             - BR2_ROOTFS_STATIC_DEVICE_TABLE
 515                 to create arbitrary entries statically in /dev
 516
 517             - BR2_ROOTFS_DEVICE_TABLE
 518                 to set arbitrary permissions as well as extended attributes
 519                 (such as capabilities) on files and directories,
 520
 521             - BR2_ROOTFS_USERS_TABLES:
 522                 to create arbitrary users and their home directories
 523
 524           It is highly recommended to use those mechanisms if possible,
 525           rather than using custom fakeroot scripts.
 526
 527 config BR2_ROOTFS_POST_IMAGE_SCRIPT
 528         string "Custom scripts to run after creating filesystem images"
 529         default ""
 530         help
 531           Specify a space-separated list of scripts to be run after
 532           the build has finished and after Buildroot has packed the
 533           files into selected filesystem images.
 534
 535           This can for example be used to call a tool building a
 536           firmware image from different images generated by Buildroot,
 537           or automatically extract the tarball root filesystem image
 538           into some location exported by NFS, or any other custom
 539           action.
 540
 541           These scripts are called with the images directory name as
 542           first argument. The script is executed from the main Buildroot
 543           source directory as the current directory.
 544
 545 config BR2_ROOTFS_POST_SCRIPT_ARGS
 546         string "Extra arguments passed to custom scripts"
 547         depends on BR2_ROOTFS_POST_BUILD_SCRIPT != "" \
 548                 || BR2_ROOTFS_POST_FAKEROOT_SCRIPT != "" \
 549                 || BR2_ROOTFS_POST_IMAGE_SCRIPT != ""
 550         help
 551           Pass these additional arguments to each post-build or post-image
 552           scripts.
 553
 554           Note that all the post-build and post-image scripts will be passed
 555           the same set of arguments, you can not pass different arguments to
 556           each script.
 557
 558           Note also, as stated in their respective help text, that the first
 559           argument to each post-build or post-image script is the target
 560           directory / images directory. The arguments in this option will be
 561           passed *after* those.
 562
 563 endmenu