doc: man-page for bootefi command
[platform/kernel/u-boot.git] / Kconfig
1 #
2 # For a description of the syntax of this configuration file,
3 # see the file Documentation/kbuild/kconfig-language.txt in the
4 # Linux kernel source tree.
5 #
6 mainmenu "U-Boot $(UBOOTVERSION) Configuration"
7
8 comment "Compiler: $(CC_VERSION_TEXT)"
9
10 source "scripts/Kconfig.include"
11
12 # Allow defaults in arch-specific code to override any given here
13 source "arch/Kconfig"
14
15 menu "General setup"
16
17 config BROKEN
18         bool
19         help
20           This option cannot be enabled. It is used as dependency
21           for broken and incomplete features.
22
23 config DEPRECATED
24         bool
25         help
26           This option cannot be enabled.  It it used as a dependency for
27           code that relies on deprecated features that will be removed and
28           the conversion deadline has passed.
29
30 config LOCALVERSION
31         string "Local version - append to U-Boot release"
32         help
33           Append an extra string to the end of your U-Boot version.
34           This will show up in your boot log, for example.
35           The string you set here will be appended after the contents of
36           any files with a filename matching localversion* in your
37           object and source tree, in that order.  Your total string can
38           be a maximum of 64 characters.
39
40 config LOCALVERSION_AUTO
41         bool "Automatically append version information to the version string"
42         default y
43         help
44           This will try to automatically determine if the current tree is a
45           release tree by looking for Git tags that belong to the current
46           top of tree revision.
47
48           A string of the format -gxxxxxxxx will be added to the localversion
49           if a Git-based tree is found.  The string generated by this will be
50           appended after any matching localversion* files, and after the value
51           set in CONFIG_LOCALVERSION.
52
53           (The actual string used here is the first eight characters produced
54           by running the command:
55
56             $ git rev-parse --verify HEAD
57
58           which is done within the script "scripts/setlocalversion".)
59
60 config CC_OPTIMIZE_FOR_SIZE
61         bool "Optimize for size"
62         default y
63         help
64           Enabling this option will pass "-Os" instead of "-O2" to gcc
65           resulting in a smaller U-Boot image.
66
67           This option is enabled by default for U-Boot.
68
69 config OPTIMIZE_INLINING
70         bool "Allow compiler to uninline functions marked 'inline' in full U-Boot"
71         default n
72         help
73           This option determines if U-Boot forces gcc to inline the functions
74           developers have marked 'inline'. Doing so takes away freedom from gcc to
75           do what it thinks is best, which is desirable in some cases for size
76           reasons.
77
78 config SPL_OPTIMIZE_INLINING
79         bool "Allow compiler to uninline functions marked 'inline' in SPL"
80         depends on SPL
81         default n
82         help
83           This option determines if U-Boot forces gcc to inline the functions
84           developers have marked 'inline'. Doing so takes away freedom from gcc to
85           do what it thinks is best, which is desirable in some cases for size
86           reasons.
87
88 config TPL_OPTIMIZE_INLINING
89         bool "Allow compiler to uninline functions marked 'inline' in TPL"
90         depends on TPL
91         default n
92         help
93           This option determines if U-Boot forces gcc to inline the functions
94           developers have marked 'inline'. Doing so takes away freedom from gcc to
95           do what it thinks is best, which is desirable in some cases for size
96           reasons.
97
98 config CC_COVERAGE
99         bool "Enable code coverage analysis"
100         depends on SANDBOX
101         help
102           Enabling this option will pass "--coverage" to gcc to compile
103           and link code instrumented for coverage analysis.
104
105 config CC_HAS_ASM_INLINE
106         def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null)
107
108 config XEN
109         bool "Select U-Boot be run as a bootloader for XEN Virtual Machine"
110         help
111           Enabling this option will make U-Boot be run as a bootloader
112           for XEN [1] Virtual Machine.
113
114           Xen is a virtual machine monitor (VMM) or a type-1 hypervisor with support
115           for para-virtualization. Xen can organize the safe execution of several
116           virtual machines on the same physical system with performance close to
117           native. It is used as the basis for a number of different commercial and
118           open source applications, such as: server virtualization, Infrastructure
119           as a Service (IaaS), desktop virtualization, security applications,
120           embedded and hardware appliances.
121           Xen has a special VM called Domain-0 that runs the Dom0 kernel and allows
122           Xen to use the device drivers for the Domain-0 kernel by default.
123
124           [1] - https://xenproject.org/
125
126 config DISTRO_DEFAULTS
127         bool "Select defaults suitable for booting general purpose Linux distributions"
128         select AUTO_COMPLETE
129         select CMDLINE_EDITING
130         select CMD_BOOTI if ARM64
131         select CMD_BOOTZ if ARM && !ARM64
132         select CMD_DHCP if CMD_NET
133         select CMD_ENV_EXISTS
134         select CMD_EXT2
135         select CMD_EXT4
136         select CMD_FAT
137         select CMD_FS_GENERIC
138         select CMD_PART if PARTITIONS
139         select CMD_PING if CMD_NET
140         select CMD_PXE if NET
141         select CMD_SYSBOOT
142         select ENV_VARS_UBOOT_CONFIG
143         select HUSH_PARSER
144         select SUPPORT_RAW_INITRD
145         select SYS_LONGHELP
146         imply CMD_MII if NET
147         imply USB_STORAGE
148         imply USE_BOOTCOMMAND
149         help
150           Select this to enable various options and commands which are suitable
151           for building u-boot for booting general purpose Linux distributions.
152
153 config ENV_VARS_UBOOT_CONFIG
154         bool "Add arch, board, vendor and soc variables to default environment"
155         help
156           Define this in order to add variables describing the
157           U-Boot build configuration to the default environment.
158           These will be named arch, cpu, board, vendor, and soc.
159           Enabling this option will cause the following to be defined:
160           - CONFIG_SYS_ARCH
161           - CONFIG_SYS_CPU
162           - CONFIG_SYS_BOARD
163           - CONFIG_SYS_VENDOR
164           - CONFIG_SYS_SOC
165
166 config NR_DRAM_BANKS
167         int "Number of DRAM banks"
168         default 1 if ARCH_SUNXI || ARCH_OWL
169         default 4
170         help
171           This defines the number of DRAM banks.
172
173 config SYS_BOOT_GET_CMDLINE
174         bool "Enable kernel command line setup"
175         help
176           Enables allocating and saving kernel cmdline in space between
177           "bootm_low" and "bootm_low" + BOOTMAPSZ.
178
179 config SYS_BOOT_GET_KBD
180         bool "Enable kernel board information setup"
181         help
182           Enables allocating and saving a kernel copy of the bd_info in
183           space between "bootm_low" and "bootm_low" + BOOTMAPSZ.
184
185 config SYS_MALLOC_F
186         bool "Enable malloc() pool before relocation"
187         default y if DM
188
189         help
190           Before relocation, memory is very limited on many platforms. Still,
191           we can provide a small malloc() pool if needed. Driver model in
192           particular needs this to operate, so that it can allocate the
193           initial serial device and any others that are needed.
194
195 config SYS_MALLOC_F_LEN
196         hex "Size of malloc() pool before relocation"
197         depends on SYS_MALLOC_F
198         default 0x1000 if AM33XX
199         default 0x4000 if SANDBOX
200         default 0x2000 if (ARCH_IMX8 || ARCH_IMX8M || ARCH_MX7 || \
201                            ARCH_MX7ULP || ARCH_MX6 || ARCH_MX5 || \
202                            ARCH_LS1012A || ARCH_LS1021A || ARCH_LS1043A || \
203                            ARCH_LS1046A || ARCH_QEMU || ARCH_SUNXI || ARCH_OWL)
204         default 0x400
205         help
206           Before relocation, memory is very limited on many platforms. Still,
207           we can provide a small malloc() pool if needed. Driver model in
208           particular needs this to operate, so that it can allocate the
209           initial serial device and any others that are needed.
210
211 config SYS_MALLOC_LEN
212         hex "Define memory for Dynamic allocation"
213         depends on ARCH_ZYNQ || ARCH_VERSAL || ARCH_STM32MP || ARCH_ROCKCHIP
214         default 0x2000000 if ARCH_ROCKCHIP
215         help
216           This defines memory to be allocated for Dynamic allocation
217           TODO: Use for other architectures
218
219 config SPL_SYS_MALLOC_F_LEN
220         hex "Size of malloc() pool in SPL before relocation"
221         depends on SYS_MALLOC_F && SPL
222         default 0x2800 if RCAR_GEN3
223         default SYS_MALLOC_F_LEN
224         help
225           Before relocation, memory is very limited on many platforms. Still,
226           we can provide a small malloc() pool if needed. Driver model in
227           particular needs this to operate, so that it can allocate the
228           initial serial device and any others that are needed.
229
230 config TPL_SYS_MALLOC_F_LEN
231         hex "Size of malloc() pool in TPL before relocation"
232         depends on SYS_MALLOC_F && TPL
233         default SYS_MALLOC_F_LEN
234         help
235           Before relocation, memory is very limited on many platforms. Still,
236           we can provide a small malloc() pool if needed. Driver model in
237           particular needs this to operate, so that it can allocate the
238           initial serial device and any others that are needed.
239
240 menuconfig EXPERT
241         bool "Configure standard U-Boot features (expert users)"
242         default y
243         help
244           This option allows certain base U-Boot options and settings
245           to be disabled or tweaked. This is for specialized
246           environments which can tolerate a "non-standard" U-Boot.
247           Use this only if you really know what you are doing.
248
249 if EXPERT
250         config SYS_MALLOC_CLEAR_ON_INIT
251         bool "Init with zeros the memory reserved for malloc (slow)"
252         default y
253         help
254           This setting is enabled by default. The reserved malloc
255           memory is initialized with zeros, so first malloc calls
256           will return the pointer to the zeroed memory. But this
257           slows the boot time.
258
259           It is recommended to disable it, when CONFIG_SYS_MALLOC_LEN
260           value, has more than few MiB, e.g. when uses bzip2 or bmp logo.
261           Then the boot time can be significantly reduced.
262           Warning:
263           When disabling this, please check if malloc calls, maybe
264           should be replaced by calloc - if one expects zeroed memory.
265
266 config SYS_MALLOC_DEFAULT_TO_INIT
267         bool "Default malloc to init while reserving the memory for it"
268         default n
269         help
270           It may happen that one needs to move the dynamic allocation
271           from one to another memory range, eg. when moving the malloc
272           from the limited static to a potentially large dynamic (DDR)
273           memory.
274
275           If so then on top of setting the updated memory aside one
276           needs to bring the malloc init.
277
278           If such a scenario is sought choose yes.
279
280 config TOOLS_DEBUG
281         bool "Enable debug information for tools"
282         help
283           Enable generation of debug information for tools such as mkimage.
284           This can be used for debugging purposes. With debug information
285           it is possible to set breakpoints on particular lines, single-step
286           debug through the source code, etc.
287
288 endif # EXPERT
289
290 config PHYS_64BIT
291         bool "64bit physical address support"
292         help
293           Say Y here to support 64bit physical memory address.
294           This can be used not only for 64bit SoCs, but also for
295           large physical address extension on 32bit SoCs.
296
297 config HAS_ROM
298         bool
299         select BINMAN
300         help
301           Enables building of a u-boot.rom target. This collects U-Boot and
302           any necessary binary blobs.
303
304 config ROM_NEEDS_BLOBS
305         bool
306         depends on HAS_ROM
307         help
308           Enable this if building the u-boot.rom target needs binary blobs, and
309           so cannot be done normally. In this case, U-Boot will only build the
310           ROM if the required blobs exist. If not, you will see an warning like:
311
312             Image 'main-section' is missing external blobs and is non-functional:
313               intel-descriptor intel-me intel-refcode intel-vga intel-mrc
314
315 config BUILD_ROM
316         bool "Build U-Boot as BIOS replacement"
317         depends on HAS_ROM
318         default y if !ROM_NEEDS_BLOBS
319         help
320           This option allows to build a ROM version of U-Boot.
321           The build process generally requires several binary blobs
322           which are not shipped in the U-Boot source tree.
323           Please, see doc/arch/x86.rst for details.
324
325 config SPL_IMAGE
326         string "SPL image used in the combined SPL+U-Boot image"
327         default "spl/boot.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
328         default "spl/u-boot-spl.bin"
329         depends on SPL
330         help
331           Select the SPL build target that shall be generated by the SPL
332           build process (default spl/u-boot-spl.bin). This image will be
333           used to generate a combined image with SPL and main U-Boot
334           proper as one single image.
335
336 config BUILD_TARGET
337         string "Build target special images"
338         default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_ARRIA10
339         default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_GEN5
340         default "u-boot-spl.kwb" if ARCH_MVEBU && SPL
341         default "u-boot-elf.srec" if RCAR_GEN3
342         default "u-boot.itb" if !BINMAN && SPL_LOAD_FIT && (ARCH_ROCKCHIP || \
343                                 ARCH_SUNXI || RISCV || ARCH_ZYNQMP)
344         default "u-boot.kwb" if ARCH_KIRKWOOD
345         default "u-boot-with-spl.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
346         default "u-boot-with-spl.imx" if ARCH_MX6 && SPL
347         help
348           Some SoCs need special image types (e.g. U-Boot binary
349           with a special header) as build targets. By defining
350           CONFIG_BUILD_TARGET in the SoC / board header, this
351           special image will be automatically built upon calling
352           make / buildman.
353
354 config SYS_CUSTOM_LDSCRIPT
355         bool "Use a custom location for the U-Boot linker script"
356         help
357           Normally when linking U-Boot we will look in the board directory,
358           the CPU directory and finally the "cpu" directory of the architecture
359           for the ile "u-boot.lds" and use that as our linker.  However, in
360           some cases we need to provide a different linker script.  To do so,
361           enable this option and then provide the location under
362           CONFIG_SYS_LDSCRIPT.
363
364 config SYS_LDSCRIPT
365         depends on SYS_CUSTOM_LDSCRIPT
366         string "Custom ldscript location"
367         help
368           Path within the source tree to the linker script to use for the
369           main U-Boot binary.
370
371 config ERR_PTR_OFFSET
372         hex
373         default 0x0
374         help
375           Some U-Boot pointers have redundant information, so we can use a
376           scheme where we can return either an error code or a pointer with the
377           same return value. The default implementation just casts the pointer
378           to a number, however, this may fail on platforms where the end of the
379           address range is used for valid pointers (e.g. 0xffffff00 is a valid
380           heap pointer in socfpga SPL).
381           For such platforms, this value provides an upper range of those error
382           pointer values - up to 'MAX_ERRNO' bytes below this value must be
383           unused/invalid addresses.
384
385 config PLATFORM_ELFENTRY
386         string
387         default "__start" if MIPS
388         default "_start"
389
390 config STACK_SIZE
391         hex "Define max stack size that can be used by U-Boot"
392         default 0x4000000 if ARCH_VERSAL || ARCH_ZYNQMP
393         default 0x200000 if MICROBLAZE
394         default 0x1000000
395         help
396           Define Max stack size that can be used by U-Boot. This value is used
397           by the UEFI sub-system. On some boards initrd_high is calculated as
398           base stack pointer minus this stack size.
399
400 config SYS_HAS_SRAM
401         bool
402         default y if TARGET_PIC32MZDASK
403         default y if TARGET_DEVKIT8000
404         default y if TARGET_TRICORDER
405         default n
406         help
407           Enable this to allow support for the on board SRAM.
408           SRAM base address is controlled by CONFIG_SYS_SRAM_BASE.
409           SRAM size is controlled by CONFIG_SYS_SRAM_SIZE.
410
411 config SYS_SRAM_BASE
412         hex
413         default 0x80000000 if TARGET_PIC32MZDASK
414         default 0x40200000 if TARGET_DEVKIT8000
415         default 0x40200000 if TARGET_TRICORDER
416         default 0x0
417
418 config SYS_SRAM_SIZE
419         hex
420         default 0x00080000 if TARGET_PIC32MZDASK
421         default 0x10000 if TARGET_DEVKIT8000
422         default 0x10000 if TARGET_TRICORDER
423         default 0x0
424
425 config EXAMPLES
426         bool "Compile API examples"
427         depends on !SANDBOX
428         default y if ARCH_QEMU
429         help
430           U-Boot provides an API for standalone applications. Examples are
431           provided in directory examples/.
432
433 endmenu         # General setup
434
435 source "api/Kconfig"
436
437 source "common/Kconfig"
438
439 source "cmd/Kconfig"
440
441 source "disk/Kconfig"
442
443 source "dts/Kconfig"
444
445 source "env/Kconfig"
446
447 source "net/Kconfig"
448
449 source "drivers/Kconfig"
450
451 source "fs/Kconfig"
452
453 source "lib/Kconfig"
454
455 source "test/Kconfig"
456
457 source "tools/Kconfig"