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