Config.in 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803
  1. menu "System configuration"
  2. # Note on package/skeleton: usually, it is not safe to 'select' a
  3. # provider of a virtual package. But below we have an exception: each
  4. # init system may select one of the virtual skeleton-init-* packages.
  5. # As only one init system may be enabled, only one skeleton-init-* may
  6. # be selected. So this is a safe situation.
  7. choice
  8. prompt "Root FS skeleton"
  9. config BR2_ROOTFS_SKELETON_DEFAULT
  10. bool "default target skeleton"
  11. help
  12. Use default target skeleton for selected init system.
  13. config BR2_ROOTFS_SKELETON_CUSTOM
  14. bool "custom target skeleton"
  15. select BR2_PACKAGE_SKELETON_CUSTOM
  16. help
  17. Use custom target skeleton.
  18. # skeleton from br2-external trees, if any
  19. source "$BR2_BASE_DIR/.br2-external.in.skeleton"
  20. endchoice
  21. if BR2_ROOTFS_SKELETON_CUSTOM
  22. config BR2_ROOTFS_SKELETON_CUSTOM_PATH
  23. string "custom target skeleton path"
  24. help
  25. Path to custom target skeleton.
  26. endif
  27. if BR2_ROOTFS_SKELETON_DEFAULT
  28. config BR2_TARGET_GENERIC_HOSTNAME
  29. string "System hostname"
  30. default "buildroot"
  31. help
  32. Select system hostname to be stored in /etc/hostname.
  33. Leave empty to not create /etc/hostname, or to keep the
  34. one from a custom skeleton.
  35. config BR2_TARGET_GENERIC_ISSUE
  36. string "System banner"
  37. default "Welcome to Buildroot"
  38. help
  39. Select system banner (/etc/issue) to be displayed at login.
  40. Leave empty to not create /etc/issue, or to keep the
  41. one from a custom skeleton.
  42. endif
  43. choice
  44. bool "Passwords encoding"
  45. default BR2_TARGET_GENERIC_PASSWD_SHA256
  46. help
  47. Choose the password encoding scheme to use when Buildroot
  48. needs to encode a password (eg. the root password, below).
  49. Note: this is used at build-time, and *not* at runtime.
  50. config BR2_TARGET_GENERIC_PASSWD_SHA256
  51. bool "sha-256"
  52. help
  53. Use SHA256 to encode passwords which is stronger than MD5.
  54. config BR2_TARGET_GENERIC_PASSWD_SHA512
  55. bool "sha-512"
  56. help
  57. Use SHA512 to encode passwords which is stronger than SHA256
  58. endchoice # Passwd encoding
  59. config BR2_TARGET_GENERIC_PASSWD_METHOD
  60. string
  61. default "sha-256" if BR2_TARGET_GENERIC_PASSWD_SHA256
  62. default "sha-512" if BR2_TARGET_GENERIC_PASSWD_SHA512
  63. # See comment at the top of the file, about selecting individual
  64. # skeletons, which are providers of the virtual skeleton package.
  65. choice
  66. prompt "Init system"
  67. default BR2_INIT_BUSYBOX
  68. comment "General purpose"
  69. config BR2_INIT_BUSYBOX
  70. bool "BusyBox"
  71. select BR2_PACKAGE_BUSYBOX
  72. select BR2_PACKAGE_INITSCRIPTS
  73. select BR2_PACKAGE_SKELETON_INIT_SYSV if BR2_ROOTFS_SKELETON_DEFAULT
  74. config BR2_INIT_SYSV
  75. bool "systemV"
  76. depends on BR2_USE_MMU # sysvinit
  77. select BR2_PACKAGE_BUSYBOX_SHOW_OTHERS # sysvinit
  78. select BR2_PACKAGE_INITSCRIPTS
  79. select BR2_PACKAGE_SYSVINIT
  80. select BR2_PACKAGE_SKELETON_INIT_SYSV if BR2_ROOTFS_SKELETON_DEFAULT
  81. config BR2_INIT_OPENRC
  82. bool "OpenRC"
  83. depends on BR2_USE_MMU
  84. depends on !BR2_STATIC_LIBS
  85. depends on !BR2_TOOLCHAIN_USES_UCLIBC # openrc
  86. select BR2_PACKAGE_OPENRC
  87. select BR2_PACKAGE_SKELETON_INIT_OPENRC if BR2_ROOTFS_SKELETON_DEFAULT
  88. comment "openrc needs a glibc or musl toolchain w/ dynamic library"
  89. depends on BR2_USE_MMU
  90. depends on BR2_STATIC_LIBS && BR2_TOOLCHAIN_USES_UCLIBC
  91. # In Buildroot, we decided not to support a split-usr when systemd is
  92. # used as an init system. This is a design decision, not a systemd
  93. # issue. Thus the select is with BR2_INIT_SYSTEMD (below) rather than
  94. # with BR2_PACKAGE_SYSTEMD.
  95. config BR2_INIT_SYSTEMD
  96. bool "systemd"
  97. depends on BR2_PACKAGE_SYSTEMD_ARCH_SUPPORTS
  98. depends on BR2_USE_MMU
  99. depends on !BR2_STATIC_LIBS
  100. depends on BR2_TOOLCHAIN_USES_GLIBC
  101. depends on BR2_TOOLCHAIN_HAS_SSP
  102. depends on BR2_TOOLCHAIN_HAS_THREADS
  103. depends on BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_15
  104. depends on BR2_TOOLCHAIN_GCC_AT_LEAST_8
  105. depends on BR2_HOST_GCC_AT_LEAST_8
  106. select BR2_ROOTFS_MERGED_USR
  107. select BR2_PACKAGE_SYSTEMD
  108. select BR2_PACKAGE_SKELETON_INIT_SYSTEMD if BR2_ROOTFS_SKELETON_DEFAULT
  109. comment "systemd needs a glibc toolchain w/ SSP, headers >= 3.15, host and target gcc >= 8"
  110. depends on BR2_PACKAGE_SYSTEMD_ARCH_SUPPORTS
  111. depends on BR2_USE_MMU
  112. depends on !BR2_TOOLCHAIN_USES_GLIBC || \
  113. !BR2_TOOLCHAIN_HAS_SSP || \
  114. !BR2_TOOLCHAIN_HEADERS_AT_LEAST_3_15 || \
  115. !BR2_TOOLCHAIN_GCC_AT_LEAST_8 || \
  116. !BR2_HOST_GCC_AT_LEAST_8
  117. comment "systemd highly recommends Linux >= 4.15"
  118. depends on BR2_INIT_SYSTEMD
  119. depends on !BR2_TOOLCHAIN_HEADERS_AT_LEAST_4_15
  120. comment "Special purpose (read help)"
  121. config BR2_INIT_CATATONIT
  122. bool "catatonit"
  123. depends on BR2_USE_MMU # catatonit
  124. select BR2_PACKAGE_CATATONIT
  125. select BR2_PACKAGE_SKELETON_INIT_NONE if BR2_ROOTFS_SKELETON_DEFAULT
  126. help
  127. A container init that is so simple it's effectively
  128. brain-dead.
  129. https://github.com/openSUSE/catatonit
  130. config BR2_INIT_TINI
  131. bool "tini"
  132. depends on BR2_USE_MMU # tini
  133. select BR2_PACKAGE_TINI
  134. select BR2_PACKAGE_SKELETON_INIT_NONE if BR2_ROOTFS_SKELETON_DEFAULT
  135. help
  136. Tini - A tiny but valid init for containers
  137. Tini is the simplest init you could think of.
  138. All Tini does is spawn a single child (Tini is meant to be run
  139. in a container), and wait for it to exit all the while reaping
  140. zombies and performing signal forwarding.
  141. https://github.com/krallin/tini
  142. config BR2_INIT_TINYINIT
  143. bool "tiny init"
  144. select BR2_PACKAGE_TINYINIT
  145. select BR2_PACKAGE_SKELETON_INIT_NONE if BR2_ROOTFS_SKELETON_DEFAULT
  146. help
  147. A Linux tiny initialization script suitable for resource
  148. limited systems, which can be used as an alternative to the
  149. one provided by Busybox.
  150. config BR2_INIT_NONE
  151. bool "Custom (none)"
  152. select BR2_PACKAGE_SKELETON_INIT_NONE if BR2_ROOTFS_SKELETON_DEFAULT
  153. help
  154. Buildroot will not install any init system. You will
  155. have to provide your own, either with a new package
  156. or with a rootfs-overlay.
  157. # Init systems from br2-external trees, if any
  158. source "$BR2_BASE_DIR/.br2-external.in.init"
  159. endchoice
  160. if BR2_INIT_SYSTEMD
  161. choice
  162. bool "/var management"
  163. default BR2_INIT_SYSTEMD_VAR_FACTORY # legacy
  164. depends on !BR2_TARGET_GENERIC_REMOUNT_ROOTFS_RW
  165. help
  166. Select how Buildroot provides a read-write /var when the
  167. rootfs is not remounted read-write.
  168. Note: Buildroot uses a tmpfs, either as a mount point or as
  169. the upper of an overlayfs, so as to at least make the system
  170. bootable out of the box; mounting a filesystem from actual
  171. storage is left to the integration, as it is too specific and
  172. may need preparatory work like partitionning a device and/or
  173. formatting a filesystem first, which falls out of the scope
  174. of Buildroot.
  175. config BR2_INIT_SYSTEMD_VAR_FACTORY
  176. bool "build a factory to populate a tmpfs"
  177. help
  178. Build a factory of the content of /var as installed by
  179. packages, mount a tmpfs on /var at runtime, so that
  180. systemd-tmpfiles can populate it from the factory.
  181. This may help on a read-only rootfs.
  182. It probably does not play very well with triggering a call
  183. to systemd-tmpfiles at build time (below).
  184. To use persistent storage, provide a systemd dropin for the
  185. var.mount unit, that overrides the What and Type, and possibly
  186. the Options and After, fields.
  187. config BR2_INIT_SYSTEMD_VAR_OVERLAYFS
  188. bool "mount an overlayfs backed by a tmpfs"
  189. select BR2_INIT_SYSTEMD_POPULATE_TMPFILES
  190. help
  191. Mount an overlayfs on /var, with the upper as a tmpfs.
  192. To use a persistent storage, provide either a mount unit or a
  193. fstab line to mount it on /run/buildroot/mounts/var, e.g.
  194. /dev/sdc1 /run/buildroot/mounts/var ext4 defaults
  195. config BR2_INIT_SYSTEMD_VAR_NONE
  196. bool "do nothing"
  197. help
  198. Choose this if you have custom dispositions (like one or more
  199. of a post-build script, a fakeroot script, systemd units, an
  200. initramfs, or something else) that prepare /var to be writable
  201. on a read-only rootfs.
  202. endchoice
  203. config BR2_INIT_SYSTEMD_POPULATE_TMPFILES
  204. bool "trigger systemd-tmpfiles during build"
  205. default y # legacy
  206. help
  207. Act on the systemd-tmpfiles.d database at build time, when
  208. assembling the root filesystems.
  209. This may help on a read-only filesystem.
  210. It probably does not play very well with the /var factory
  211. (above).
  212. config BR2_PACKAGE_SYSTEMD_DEFAULT_TARGET
  213. string "The default unit systemd starts at bootup"
  214. default "multi-user.target"
  215. help
  216. Specify the name of the unit configuration file to be started
  217. at bootup by systemd. Should end in ".target".
  218. ex: multi-user.target
  219. https://www.freedesktop.org/software/systemd/man/systemd.special.html#default.target
  220. endif # BR2_INIT_SYSTEMD
  221. choice
  222. prompt "/dev management" if !BR2_INIT_SYSTEMD
  223. default BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_DEVTMPFS
  224. config BR2_ROOTFS_DEVICE_CREATION_STATIC
  225. bool "Static using device table"
  226. config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_DEVTMPFS
  227. bool "Dynamic using devtmpfs only"
  228. config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_MDEV
  229. bool "Dynamic using devtmpfs + mdev"
  230. select BR2_PACKAGE_BUSYBOX
  231. config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_EUDEV
  232. bool "Dynamic using devtmpfs + eudev"
  233. depends on BR2_USE_WCHAR # eudev
  234. depends on !BR2_STATIC_LIBS # eudev
  235. depends on BR2_USE_MMU # eudev
  236. select BR2_PACKAGE_EUDEV
  237. comment "eudev needs a toolchain w/ wchar, dynamic library"
  238. depends on BR2_USE_MMU
  239. depends on !BR2_USE_WCHAR || BR2_STATIC_LIBS
  240. endchoice
  241. comment "/dev management using udev (from systemd)"
  242. depends on BR2_INIT_SYSTEMD
  243. config BR2_ROOTFS_DEVICE_TABLE
  244. string "Path to the permission tables"
  245. default "system/device_table.txt"
  246. help
  247. Specify a space-separated list of permission table locations,
  248. that will be passed to the makedevs utility to assign
  249. correct owners and permissions on various files in the
  250. target filesystem.
  251. See package/makedevs/README for details on the usage and
  252. syntax of these files.
  253. config BR2_ROOTFS_STATIC_DEVICE_TABLE
  254. string "Path to the device tables"
  255. default "system/device_table_dev.txt"
  256. depends on BR2_ROOTFS_DEVICE_CREATION_STATIC
  257. help
  258. Specify a space-separated list of device table locations,
  259. that will be passed to the makedevs utility to create all
  260. the special device files under /dev.
  261. See package/makedevs/README for details on the usage and
  262. syntax of these files.
  263. config BR2_ROOTFS_DEVICE_TABLE_SUPPORTS_EXTENDED_ATTRIBUTES
  264. bool "support extended attributes in device tables"
  265. help
  266. Support extended attributes handling in device tables
  267. config BR2_ROOTFS_MERGED_USR
  268. bool "Use symlinks to /usr for /bin, /sbin and /lib"
  269. help
  270. If you say 'n' here, then /bin, /sbin and /lib and their
  271. counterparts in /usr will be separate directories. This
  272. is the historical UNIX way. In this case, /usr can be a
  273. filesystem on a partition separate from / .
  274. If you say 'y' here, then /bin, /sbin and /lib will be
  275. symlinks to their counterparts in /usr. In this case, /usr can
  276. not be a separate filesystem.
  277. if BR2_ROOTFS_SKELETON_DEFAULT
  278. config BR2_TARGET_ENABLE_ROOT_LOGIN
  279. bool "Enable root login with password"
  280. default y
  281. select BR2_PACKAGE_HOST_MKPASSWD if BR2_TARGET_GENERIC_ROOT_PASSWD != ""
  282. help
  283. Allow root to log in with a password.
  284. If not enabled, root will not be able to log in with a
  285. password. However, if you have an ssh server and you add an
  286. ssh key, you can still allow root to log in. Alternatively,
  287. you can use sudo to become root.
  288. config BR2_TARGET_GENERIC_ROOT_PASSWD
  289. string "Root password"
  290. default ""
  291. depends on BR2_TARGET_ENABLE_ROOT_LOGIN
  292. help
  293. Set the initial root password.
  294. If set to empty (the default), then no root password will be
  295. set, and root will need no password to log in.
  296. If the password starts with any of $1$, $5$ or $6$, it is
  297. considered to be already crypt-encoded with respectively md5,
  298. sha256 or sha512. Any other value is taken to be a clear-text
  299. value, and is crypt-encoded as per the "Passwords encoding"
  300. scheme, above.
  301. Note: "$" signs in the hashed password must be doubled. For
  302. example, if the hashed password is
  303. "$1$longsalt$v35DIIeMo4yUfI23yditq0", then you must enter it
  304. as "$$1$$longsalt$$v35DIIeMo4yUfI23yditq0" (this is necessary
  305. otherwise make would attempt to interpret the $ as a variable
  306. expansion).
  307. WARNING! WARNING!
  308. The password appears as-is in the .config file, and may appear
  309. in the build log! Avoid using a valuable password if either
  310. the .config file or the build log may be distributed, or at
  311. the very least use a strong cryptographic hash for your
  312. password!
  313. choice
  314. bool "/bin/sh"
  315. default BR2_SYSTEM_BIN_SH_DASH if !BR2_PACKAGE_BUSYBOX
  316. help
  317. Select which shell will provide /bin/sh.
  318. # busybox has shells that work on noMMU
  319. config BR2_SYSTEM_BIN_SH_BUSYBOX
  320. bool "busybox' default shell"
  321. depends on BR2_PACKAGE_BUSYBOX
  322. config BR2_SYSTEM_BIN_SH_BASH
  323. bool "bash"
  324. depends on BR2_USE_MMU # bash
  325. depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
  326. select BR2_PACKAGE_BASH
  327. config BR2_SYSTEM_BIN_SH_DASH
  328. bool "dash"
  329. depends on BR2_USE_MMU # dash
  330. depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
  331. select BR2_PACKAGE_DASH
  332. config BR2_SYSTEM_BIN_SH_MKSH
  333. bool "mksh"
  334. depends on BR2_USE_MMU # mksh
  335. depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
  336. select BR2_PACKAGE_MKSH
  337. config BR2_SYSTEM_BIN_SH_ZSH
  338. bool "zsh"
  339. depends on BR2_USE_MMU # zsh
  340. depends on BR2_PACKAGE_BUSYBOX_SHOW_OTHERS
  341. select BR2_PACKAGE_ZSH
  342. comment "bash, dash, mksh, zsh need BR2_PACKAGE_BUSYBOX_SHOW_OTHERS"
  343. depends on !BR2_PACKAGE_BUSYBOX_SHOW_OTHERS && BR2_PACKAGE_BUSYBOX
  344. config BR2_SYSTEM_BIN_SH_NONE
  345. bool "none"
  346. endchoice # /bin/sh
  347. config BR2_SYSTEM_BIN_SH
  348. string
  349. default "bash" if BR2_SYSTEM_BIN_SH_BASH
  350. default "dash" if BR2_SYSTEM_BIN_SH_DASH
  351. default "mksh" if BR2_SYSTEM_BIN_SH_MKSH
  352. default "zsh" if BR2_SYSTEM_BIN_SH_ZSH
  353. menuconfig BR2_TARGET_GENERIC_GETTY
  354. bool "Run a getty (login prompt) after boot"
  355. default y if !BR2_PACKAGE_PETITBOOT
  356. if BR2_TARGET_GENERIC_GETTY
  357. config BR2_TARGET_GENERIC_GETTY_PORT
  358. string "TTY port"
  359. default "console"
  360. help
  361. Specify a port to run a getty on.
  362. choice
  363. prompt "Baudrate"
  364. default BR2_TARGET_GENERIC_GETTY_BAUDRATE_KEEP
  365. help
  366. Select a baudrate to use.
  367. config BR2_TARGET_GENERIC_GETTY_BAUDRATE_KEEP
  368. bool "keep kernel default"
  369. config BR2_TARGET_GENERIC_GETTY_BAUDRATE_9600
  370. bool "9600"
  371. config BR2_TARGET_GENERIC_GETTY_BAUDRATE_19200
  372. bool "19200"
  373. config BR2_TARGET_GENERIC_GETTY_BAUDRATE_38400
  374. bool "38400"
  375. config BR2_TARGET_GENERIC_GETTY_BAUDRATE_57600
  376. bool "57600"
  377. config BR2_TARGET_GENERIC_GETTY_BAUDRATE_115200
  378. bool "115200"
  379. endchoice
  380. config BR2_TARGET_GENERIC_GETTY_BAUDRATE
  381. string
  382. default "0" if BR2_TARGET_GENERIC_GETTY_BAUDRATE_KEEP
  383. default "9600" if BR2_TARGET_GENERIC_GETTY_BAUDRATE_9600
  384. default "19200" if BR2_TARGET_GENERIC_GETTY_BAUDRATE_19200
  385. default "38400" if BR2_TARGET_GENERIC_GETTY_BAUDRATE_38400
  386. default "57600" if BR2_TARGET_GENERIC_GETTY_BAUDRATE_57600
  387. default "115200" if BR2_TARGET_GENERIC_GETTY_BAUDRATE_115200
  388. config BR2_TARGET_GENERIC_GETTY_TERM
  389. string "TERM environment variable"
  390. default "vt100"
  391. # currently observed by all but systemd
  392. depends on !BR2_INIT_SYSTEMD
  393. help
  394. Specify a TERM type.
  395. config BR2_TARGET_GENERIC_GETTY_OPTIONS
  396. string "other options to pass to getty"
  397. default ""
  398. # currently observed by all but systemd
  399. depends on !BR2_INIT_SYSTEMD
  400. help
  401. Any other flags you want to pass to getty,
  402. Refer to getty --help for details.
  403. endif
  404. config BR2_TARGET_GENERIC_REMOUNT_ROOTFS_RW
  405. bool "remount root filesystem read-write during boot"
  406. default y
  407. help
  408. The root filesystem is typically mounted read-only at boot.
  409. By default, buildroot remounts it in read-write mode early
  410. during the boot process.
  411. Say no here if you would rather like your root filesystem to
  412. remain read-only.
  413. If unsure, say Y.
  414. config BR2_SYSTEM_DHCP
  415. string "Network interface to configure through DHCP"
  416. default ""
  417. depends on BR2_PACKAGE_BUSYBOX || BR2_PACKAGE_IFUPDOWN || \
  418. BR2_PACKAGE_SYSTEMD_NETWORKD || BR2_PACKAGE_NETIFRC
  419. help
  420. Enter here the name of the network interface (E.G. eth0) to
  421. automatically configure through DHCP at bootup.
  422. If left empty, no automatic DHCP requests will take place.
  423. For more complicated network setups use an overlay to
  424. overwrite /etc/network/interfaces or add a networkd
  425. configuration file.
  426. comment "automatic network configuration via DHCP needs ifupdown or busybox or networkd or netifrc"
  427. depends on !(BR2_PACKAGE_BUSYBOX || BR2_PACKAGE_IFUPDOWN || \
  428. BR2_PACKAGE_SYSTEMD_NETWORKD || BR2_PACKAGE_NETIFRC)
  429. endif # BR2_ROOTFS_SKELETON_DEFAULT
  430. config BR2_SYSTEM_DEFAULT_PATH
  431. string "Set the system's default PATH"
  432. default "/usr/bin:/usr/sbin" if BR2_ROOTFS_MERGED_USR
  433. default "/bin:/sbin:/usr/bin:/usr/sbin" if !BR2_ROOTFS_MERGED_USR
  434. help
  435. Sets the system's default PATH. It is being used in
  436. /etc/profile in the skeleton-init-common package and by some
  437. daemons.
  438. The default should work in most cases.
  439. config BR2_ENABLE_LOCALE_PURGE
  440. bool "Purge unwanted locales"
  441. default y
  442. help
  443. Explicitly specify what locales to install on target. If N
  444. then all locales supported by packages are installed.
  445. config BR2_ENABLE_LOCALE_WHITELIST
  446. string "Locales to keep"
  447. default "C en_US"
  448. depends on BR2_ENABLE_LOCALE_PURGE
  449. help
  450. Whitespace separated list of locales to allow on target.
  451. Locales not listed here will be removed from the target.
  452. See 'locale -a' on your host for a list of locales available
  453. on your build host, or have a look in /usr/share/locale in
  454. the target file system for available locales.
  455. Notice that listing a locale here doesn't guarantee that it
  456. will be available on the target - That purely depends on the
  457. support for that locale in the selected packages.
  458. config BR2_GENERATE_LOCALE
  459. string "Generate locale data"
  460. default ""
  461. depends on \
  462. (BR2_TOOLCHAIN_BUILDROOT_UCLIBC && BR2_ENABLE_LOCALE) || \
  463. BR2_TOOLCHAIN_USES_GLIBC
  464. help
  465. Generate support for a list of locales. Locales can be
  466. specified with or without encoding, when no encoding is
  467. specified, UTF-8 is assumed. Examples of locales: en_US,
  468. fr_FR.UTF-8.
  469. config BR2_SYSTEM_ENABLE_NLS
  470. bool "Enable Native Language Support (NLS)"
  471. depends on BR2_USE_WCHAR
  472. # - glibc has built-in NLS support, but anyway doesn't
  473. # support static linking
  474. # - musl and uclibc support static linking, but they don't
  475. # have built-in NLS support, which is provided by the
  476. # libintl library from gettext. The fact that it is a
  477. # separate library causes too many problems for static
  478. # linking.
  479. depends on !BR2_STATIC_LIBS
  480. select BR2_PACKAGE_GETTEXT if !BR2_TOOLCHAIN_HAS_FULL_GETTEXT
  481. help
  482. This option will enable Native Language Support, which will
  483. allow software packages to support translations.
  484. comment "NLS support needs a toolchain w/ wchar, dynamic library"
  485. depends on !BR2_USE_WCHAR || BR2_STATIC_LIBS
  486. config BR2_TARGET_TZ_INFO
  487. bool "Install timezone info"
  488. select BR2_PACKAGE_TZDATA if BR2_TOOLCHAIN_USES_GLIBC
  489. select BR2_PACKAGE_TZDATA if BR2_TOOLCHAIN_USES_MUSL
  490. select BR2_PACKAGE_TZ if BR2_TOOLCHAIN_USES_UCLIBC
  491. help
  492. Say 'y' here to install timezone info.
  493. if BR2_TARGET_TZ_INFO
  494. config BR2_TARGET_TZ_ZONELIST
  495. string "timezone list"
  496. default "default"
  497. help
  498. Space-separated list of time zones to compile.
  499. The value "default" includes all commonly used time zones.
  500. Note that this set consumes around 5.5M for glibc and 2.1M for
  501. uClibc.
  502. The full list is the list of files in the time zone database
  503. source, not including the build and .tab files.
  504. config BR2_TARGET_LOCALTIME
  505. string "default local time"
  506. default "Etc/UTC"
  507. help
  508. The time zone to install as the default local time, expressed
  509. as a tzdata location, such as:
  510. Etc/UTC (the default)
  511. GMT
  512. Europe/Paris
  513. America/New_York
  514. Pacific/Wallis
  515. ...
  516. Set to empty to not install a default time zone.
  517. endif # BR2_TARGET_TZ_INFO
  518. config BR2_ROOTFS_USERS_TABLES
  519. string "Path to the users tables"
  520. help
  521. Specify a space-separated list of users table locations,
  522. that will be passed to the mkusers utility to create
  523. users on the system, with home directory, password, etc.
  524. See manual for details on the usage and syntax of these files.
  525. config BR2_ROOTFS_OVERLAY
  526. string "Root filesystem overlay directories"
  527. default ""
  528. help
  529. Specify a list of directories that are copied over the target
  530. root filesystem after the build has finished and before it is
  531. packed into the selected filesystem images.
  532. They are copied as-is into the rootfs, excluding files ending
  533. with ~ and .git, .svn and .hg directories.
  534. config BR2_ROOTFS_PRE_BUILD_SCRIPT
  535. string "Custom scripts to run before commencing the build"
  536. default ""
  537. help
  538. Specify a space-separated list of scripts to be run before the
  539. build commences.
  540. This gives users the opportunity to do board-specific
  541. preparations before starting the build.
  542. config BR2_ROOTFS_POST_BUILD_SCRIPT
  543. string "Custom scripts to run before creating filesystem images"
  544. default ""
  545. help
  546. Specify a space-separated list of scripts to be run after the
  547. build has finished and before Buildroot starts packing the
  548. files into selected filesystem images.
  549. This gives users the opportunity to do board-specific
  550. cleanups, add-ons and the like, so the generated files can be
  551. used directly without further processing.
  552. These scripts are called with the target directory name as
  553. first argument. Make sure the exit code of those scripts are
  554. 0, otherwise make will stop after calling them.
  555. config BR2_ROOTFS_POST_FAKEROOT_SCRIPT
  556. string "Custom scripts to run inside the fakeroot environment"
  557. default ""
  558. help
  559. Specify a space-separated list of scripts to be run at the end
  560. of the fakeroot script right before the image(s) are actually
  561. generated.
  562. This gives users the opportunity to do customisations of the
  563. content of the rootfs, which would otherwise require root
  564. rights.
  565. These scripts are called with the target directory name as
  566. first argument. The build will fail on the first scripts that
  567. exits with a non-zero exit code.
  568. Note that Buildroot already provides mechanisms to customise
  569. the content of the rootfs:
  570. - BR2_ROOTFS_STATIC_DEVICE_TABLE
  571. to create arbitrary entries statically in /dev
  572. - BR2_ROOTFS_DEVICE_TABLE
  573. to set arbitrary permissions as well as extended
  574. attributes (such as capabilities) on files and
  575. directories,
  576. - BR2_ROOTFS_USERS_TABLES:
  577. to create arbitrary users and their home directories
  578. It is highly recommended to use those mechanisms if possible,
  579. rather than using custom fakeroot scripts.
  580. config BR2_ROOTFS_POST_IMAGE_SCRIPT
  581. string "Custom scripts to run after creating filesystem images"
  582. default ""
  583. help
  584. Specify a space-separated list of scripts to be run after
  585. the build has finished and after Buildroot has packed the
  586. files into selected filesystem images.
  587. This can for example be used to call a tool building a
  588. firmware image from different images generated by Buildroot,
  589. or automatically extract the tarball root filesystem image
  590. into some location exported by NFS, or any other custom
  591. action.
  592. These scripts are called with the images directory name as
  593. first argument. The script is executed from the main Buildroot
  594. source directory as the current directory.
  595. config BR2_ROOTFS_POST_SCRIPT_ARGS
  596. string "Extra arguments passed to custom scripts"
  597. depends on BR2_ROOTFS_PRE_BUILD_SCRIPT != "" \
  598. || BR2_ROOTFS_POST_BUILD_SCRIPT != "" \
  599. || BR2_ROOTFS_POST_FAKEROOT_SCRIPT != "" \
  600. || BR2_ROOTFS_POST_IMAGE_SCRIPT != ""
  601. help
  602. Pass these additional arguments to each pre-build, post-build,
  603. post-fakeroot and post-image scripts.
  604. Note that all the post-build and post-image scripts will be
  605. passed the same set of arguments, you can not pass different
  606. arguments to each script.
  607. Note also, as stated in their respective help text, that the
  608. first argument to each script is the target directory / images
  609. directory. The arguments in this option will be passed *after*
  610. those.
  611. config BR2_ROOTFS_PRE_BUILD_SCRIPT_ARGS
  612. string "Extra arguments passed to BR2_ROOTFS_PRE_BUILD_SCRIPT"
  613. depends on BR2_ROOTFS_PRE_BUILD_SCRIPT != ""
  614. help
  615. Pass these additional arguments to the pre-build script.
  616. Note also, as stated in the respective help text, that the
  617. first argument to each script is the target directory, then
  618. the common arguments specified in BR2_ROOTFS_POST_SCRIPT_ARGS
  619. above, and then the arguments in this option will be passed
  620. *after* those.
  621. config BR2_ROOTFS_POST_BUILD_SCRIPT_ARGS
  622. string "Extra arguments passed to BR2_ROOTFS_POST_BUILD_SCRIPT"
  623. depends on BR2_ROOTFS_POST_BUILD_SCRIPT != ""
  624. help
  625. Pass these additional arguments to the post-build script.
  626. Note also, as stated in the respective help text, that the
  627. first argument to each script is the target directory, then
  628. the common arguments specified in BR2_ROOTFS_POST_SCRIPT_ARGS
  629. above, and then the arguments in this option will be passed
  630. *after* those.
  631. config BR2_ROOTFS_POST_FAKEROOT_SCRIPT_ARGS
  632. string "Extra arguments passed to BR2_ROOTFS_POST_FAKEROOT_SCRIPT"
  633. depends on BR2_ROOTFS_POST_FAKEROOT_SCRIPT != ""
  634. help
  635. Pass these additional arguments to the post-fakeroot script.
  636. Note also, as stated in the respective help text, that the
  637. first argument to each script is the target directory, then
  638. the common arguments specified in BR2_ROOTFS_POST_SCRIPT_ARGS
  639. above, and then the arguments in this option will be passed
  640. *after* those.
  641. config BR2_ROOTFS_POST_IMAGE_SCRIPT_ARGS
  642. string "Extra arguments passed to POST_IMAGE_SCRIPT"
  643. depends on BR2_ROOTFS_POST_IMAGE_SCRIPT != ""
  644. help
  645. Pass these additional arguments to the post-image script.
  646. Note also, as stated in the respective help text, that the
  647. first argument to each script is the images directory, then
  648. the common arguments specified in BR2_ROOTFS_POST_SCRIPT_ARGS
  649. above, and then the arguments in this option will be passed
  650. *after* those.
  651. endmenu