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         depends on BR2_USE_MMU # sysvinit
 110         select BR2_PACKAGE_BUSYBOX_SHOW_OTHERS # sysvinit
 111         select BR2_PACKAGE_INITSCRIPTS
 112         select BR2_PACKAGE_SYSVINIT
 113
 114 # In Buildroot, we decided not to support a split-usr when systemd is
 115 # used as an init system. This is a design decision, not a systemd
 116 # issue. Thus the select is with BR2_INIT_SYSTEMD (below) rather than
 117 # with BR2_PACKAGE_SYSTEMD.
 118 config BR2_INIT_SYSTEMD
 119         bool "systemd"
 120         depends on BR2_PACKAGE_SYSTEMD_ARCH_SUPPORTS
 121         depends on BR2_TOOLCHAIN_USES_GLIBC
 122         depends on BR2_USE_WCHAR
 123         depends on BR2_TOOLCHAIN_HAS_THREADS
 124         depends on BR2_TOOLCHAIN_HAS_SSP
 125         depends on BR2_USE_MMU
 126         depends on !BR2_STATIC_LIBS
 127         depends on BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_10
 128         select BR2_ROOTFS_MERGED_USR
 129         select BR2_PACKAGE_SYSTEMD
 130         select BR2_TARGET_GENERIC_REMOUNT_ROOTFS_RW
 131
 132 comment "systemd needs a glibc toolchain, headers >= 3.10"
 133         depends on !(BR2_TOOLCHAIN_USES_GLIBC \
 134                 && BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_10)
 135
 136 config BR2_INIT_NONE
 137         bool "None"
 138         help
 139           Buildroot will not install any init system. You will
 140           have to provide your own, either with a new package
 141           or with a rootfs-overlay.
 142
 143 endchoice
 144
 145 choice
 146         prompt "/dev management" if !BR2_INIT_SYSTEMD
 147         default BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_DEVTMPFS
 148
 149 config BR2_ROOTFS_DEVICE_CREATION_STATIC
 150         bool "Static using device table"
 151
 152 config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_DEVTMPFS
 153         bool "Dynamic using devtmpfs only"
 154
 155 config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_MDEV
 156         bool "Dynamic using devtmpfs + mdev"
 157         select BR2_PACKAGE_BUSYBOX
 158
 159 config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_EUDEV
 160         bool "Dynamic using devtmpfs + eudev"
 161         depends on BR2_USE_WCHAR
 162         depends on !BR2_STATIC_LIBS
 163         depends on BR2_USE_MMU # eudev
 164         select BR2_PACKAGE_EUDEV
 165
 166 comment "eudev needs a toolchain w/ wchar, dynamic library"
 167         depends on BR2_USE_MMU
 168         depends on !BR2_USE_WCHAR || BR2_STATIC_LIBS
 169
 170 endchoice
 171
 172 comment "/dev management using udev (from systemd)"
 173         depends on BR2_INIT_SYSTEMD
 174
 175 config BR2_ROOTFS_DEVICE_TABLE
 176         string "Path to the permission tables"
 177         default "system/device_table.txt"
 178         help
 179           Specify a space-separated list of permission table locations,
 180           that will be passed to the makedevs utility to assign
 181           correct owners and permissions on various files in the
 182           target filesystem.
 183
 184           See package/makedevs/README for details on the usage and
 185           syntax of these files.
 186
 187 config BR2_ROOTFS_STATIC_DEVICE_TABLE
 188         string "Path to the device tables"
 189         default "system/device_table_dev.txt"
 190         depends on BR2_ROOTFS_DEVICE_CREATION_STATIC
 191         help
 192           Specify a space-separated list of device table locations,
 193           that will be passed to the makedevs utility to create all
 194           the special device files under /dev.
 195
 196           See package/makedevs/README for details on the usage and
 197           syntax of these files.
 198
 199 config BR2_ROOTFS_DEVICE_TABLE_SUPPORTS_EXTENDED_ATTRIBUTES
 200         bool "support extended attributes in device tables"
 201         help
 202           Support extended attributes handling in device tables
 203
 204 if BR2_ROOTFS_SKELETON_DEFAULT
 205
 206 config BR2_ROOTFS_MERGED_USR
 207         bool "Use symlinks to /usr for /bin, /sbin and /lib"
 208         help
 209           If you say 'n' here, then /bin, /sbin and /lib and their
 210           counterparts in /usr will be separate directories. This
 211           is the historical UNIX way. In this case, /usr can be a
 212           filesystem on a partition separate from / .
 213
 214           If you say 'y' here, then /bin, /sbin and /lib will be symlinks
 215           to their counterparts in /usr. In this case, /usr can not be a
 216           separate filesystem.
 217
 218 config BR2_TARGET_ENABLE_ROOT_LOGIN
 219         bool "Enable root login with password"
 220         default y
 221         help
 222           Allow root to log in with a password.
 223
 224           If not enabled, root will not be able to log in with a password.
 225           However, if you have an ssh server and you add an ssh key, you
 226           can still allow root to log in. Alternatively, you can use sudo
 227           to become root.
 228
 229 config BR2_TARGET_GENERIC_ROOT_PASSWD
 230         string "Root password"
 231         default ""
 232         depends on BR2_TARGET_ENABLE_ROOT_LOGIN
 233         help
 234           Set the initial root password.
 235
 236           If set to empty (the default), then no root password will be set,
 237           and root will need no password to log in.
 238
 239           If the password starts with any of $1$, $5$ or $6$, it is considered
 240           to be already crypt-encoded with respectively md5, sha256 or sha512.
 241           Any other value is taken to be a clear-text value, and is crypt-encoded
 242           as per the "Passwords encoding" scheme, above.
 243
 244           Note: "$" signs in the hashed password must be doubled. For example,
 245           if the hashed password is "$1$longsalt$v35DIIeMo4yUfI23yditq0",
 246           then you must enter it as "$$1$$longsalt$$v35DIIeMo4yUfI23yditq0"
 247           (this is necessary otherwise make would attempt to interpret the $
 248           as a variable expansion).
 249
 250           WARNING! WARNING!
 251           The password appears as-is in the .config file, and may appear
 252           in the build log! Avoid using a valuable password if either the
 253           .config file or the build log may be distributed, or at the
 254           very least use a strong cryptographic hash for your password!
 255
 256 choice
 257         bool "/bin/sh"
 258         default BR2_SYSTEM_BIN_SH_DASH if !BR2_PACKAGE_BUSYBOX
 259         help
 260           Select which shell will provide /bin/sh.
 261
 262 # busybox has shells that work on noMMU
 263 config BR2_SYSTEM_BIN_SH_BUSYBOX
 264         bool "busybox' default shell"
 265         depends on BR2_PACKAGE_BUSYBOX
 266
 267 config BR2_SYSTEM_BIN_SH_BASH
 268         bool "bash"
 269         depends on BR2_USE_MMU # bash
 270         depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
 271         select BR2_PACKAGE_BASH
 272
 273 config BR2_SYSTEM_BIN_SH_DASH
 274         bool "dash"
 275         depends on BR2_USE_MMU # dash
 276         depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
 277         select BR2_PACKAGE_DASH
 278
 279 config BR2_SYSTEM_BIN_SH_ZSH
 280         bool "zsh"
 281         depends on BR2_USE_MMU # zsh
 282         depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
 283         select BR2_PACKAGE_ZSH
 284
 285 comment "bash, dash, zsh need BR2_PACKAGE_BUSYBOX_SHOW_OTHERS"
 286         depends on !BR2_PACKAGE_BUSYBOX_SHOW_OTHERS && BR2_PACKAGE_BUSYBOX
 287
 288 config BR2_SYSTEM_BIN_SH_NONE
 289         bool "none"
 290
 291 endchoice # /bin/sh
 292
 293 config BR2_SYSTEM_BIN_SH
 294         string
 295         default "busybox" if BR2_SYSTEM_BIN_SH_BUSYBOX
 296         default "bash"    if BR2_SYSTEM_BIN_SH_BASH
 297         default "dash"    if BR2_SYSTEM_BIN_SH_DASH
 298         default "zsh"     if BR2_SYSTEM_BIN_SH_ZSH
 299
 300 menuconfig BR2_TARGET_GENERIC_GETTY
 301         bool "Run a getty (login prompt) after boot"
 302         default y
 303
 304 if BR2_TARGET_GENERIC_GETTY
 305 config BR2_TARGET_GENERIC_GETTY_PORT
 306         string "TTY port"
 307         default "console"
 308         help
 309           Specify a port to run a getty on.
 310
 311 choice
 312         prompt "Baudrate"
 313         default BR2_TARGET_GENERIC_GETTY_BAUDRATE_KEEP
 314         help
 315           Select a baudrate to use.
 316
 317 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_KEEP
 318         bool "keep kernel default"
 319 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_9600
 320         bool "9600"
 321 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_19200
 322         bool "19200"
 323 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_38400
 324         bool "38400"
 325 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_57600
 326         bool "57600"
 327 config BR2_TARGET_GENERIC_GETTY_BAUDRATE_115200
 328         bool "115200"
 329 endchoice
 330
 331 config BR2_TARGET_GENERIC_GETTY_BAUDRATE
 332         string
 333         default "0"             if BR2_TARGET_GENERIC_GETTY_BAUDRATE_KEEP
 334         default "9600"          if BR2_TARGET_GENERIC_GETTY_BAUDRATE_9600
 335         default "19200"         if BR2_TARGET_GENERIC_GETTY_BAUDRATE_19200
 336         default "38400"         if BR2_TARGET_GENERIC_GETTY_BAUDRATE_38400
 337         default "57600"         if BR2_TARGET_GENERIC_GETTY_BAUDRATE_57600
 338         default "115200"        if BR2_TARGET_GENERIC_GETTY_BAUDRATE_115200
 339
 340 config BR2_TARGET_GENERIC_GETTY_TERM
 341         string "TERM environment variable"
 342         default "vt100"
 343         help
 344           Specify a TERM type.
 345
 346 config BR2_TARGET_GENERIC_GETTY_OPTIONS
 347         string "other options to pass to getty"
 348         default ""
 349         help
 350           Any other flags you want to pass to getty,
 351           Refer to getty --help for details.
 352 endif
 353
 354 config BR2_TARGET_GENERIC_REMOUNT_ROOTFS_RW
 355         bool "remount root filesystem read-write during boot"
 356         default y
 357         help
 358           The root filesystem is typically mounted read-only at boot.
 359           By default, buildroot remounts it in read-write mode early during the
 360           boot process.
 361           Say no here if you would rather like your root filesystem to remain
 362           read-only.
 363           If unsure, say Y.
 364
 365 config BR2_SYSTEM_DHCP
 366         string "Network interface to configure through DHCP"
 367         default ""
 368         depends on !BR2_PACKAGE_SYSTEMD_NETWORKD && (BR2_PACKAGE_BUSYBOX || BR2_PACKAGE_IFUPDOWN)
 369         help
 370           Enter here the name of the network interface (E.G. eth0) to
 371           automatically configure through DHCP at bootup.
 372
 373           If left empty, no automatic DHCP requests will take place.
 374
 375           For more complicated network setups use an overlay to overwrite
 376           /etc/network/interfaces or add a networkd configuration file.
 377
 378 comment "automatic network configuration via DHCP is not compatible with networkd"
 379         depends on BR2_PACKAGE_SYSTEMD_NETWORKD
 380
 381 comment "automatic network configuration via DHCP needs ifupdown or busybox"
 382         depends on !(BR2_PACKAGE_BUSYBOX || BR2_PACKAGE_IFUPDOWN)
 383
 384 endif # BR2_ROOTFS_SKELETON_DEFAULT
 385
 386 config BR2_ENABLE_LOCALE_PURGE
 387         bool "Purge unwanted locales"
 388         default y
 389         help
 390           Explicitly specify what locales to install on target. If N
 391           then all locales supported by packages are installed.
 392
 393 config BR2_ENABLE_LOCALE_WHITELIST
 394         string "Locales to keep"
 395         default "C en_US"
 396         depends on BR2_ENABLE_LOCALE_PURGE
 397         help
 398           Whitespace seperated list of locales to allow on target.
 399           Locales not listed here will be removed from the target.
 400           See 'locale -a' on your host for a list of locales available
 401           on your build host, or have a look in /usr/share/locale in
 402           the target file system for available locales.
 403
 404           Notice that listing a locale here doesn't guarantee that it
 405           will be available on the target - That purely depends on the
 406           support for that locale in the selected packages.
 407
 408 config BR2_GENERATE_LOCALE
 409         string "Generate locale data"
 410         default ""
 411         depends on \
 412                 (BR2_TOOLCHAIN_BUILDROOT_UCLIBC && BR2_ENABLE_LOCALE) || \
 413                 BR2_TOOLCHAIN_USES_GLIBC
 414         help
 415           Generate support for a list of locales. Locales can be
 416           specified with or without encoding, when no encoding is
 417           specified, UTF-8 is assumed. Examples of locales: en_US,
 418           fr_FR.UTF-8.
 419
 420 config BR2_TARGET_TZ_INFO
 421         bool "Install timezone info"
 422         select BR2_PACKAGE_TZDATA if BR2_TOOLCHAIN_USES_GLIBC
 423         select BR2_PACKAGE_TZDATA if BR2_TOOLCHAIN_USES_MUSL
 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