Config.in 19 KB

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