EFI: Update the documentation to reflect the correct value of OsIndications
[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_IS_GCC
61         def_bool $(success,$(CC) --version | head -n 1 | grep -q gcc)
62
63 config GCC_VERSION
64         int
65         default $(shell,$(srctree)/scripts/gcc-version.sh -p $(CC) | sed 's/^0*//') if CC_IS_GCC
66         default 0
67
68 config CC_IS_CLANG
69         def_bool $(success,$(CC) --version | head -n 1 | grep -q clang)
70
71 config CLANG_VERSION
72         int
73         default $(shell,$(srctree)/scripts/clang-version.sh $(CC))
74
75 choice
76         prompt "Optimization level"
77         default CC_OPTIMIZE_FOR_SIZE
78
79 config CC_OPTIMIZE_FOR_SIZE
80         bool "Optimize for size"
81         help
82           Enabling this option will pass "-Os" to gcc, resulting in a smaller
83           U-Boot image.
84
85           This option is enabled by default for U-Boot.
86
87 config CC_OPTIMIZE_FOR_SPEED
88         bool "Optimize for speed"
89         help
90           Enabling this option will pass "-O2" to gcc, resulting in a faster
91           U-Boot image.
92
93 config CC_OPTIMIZE_FOR_DEBUG
94         bool "Optimize for debugging"
95         help
96           Enabling this option will pass "-Og" to gcc, enabling optimizations
97           which don't interfere with debugging.
98
99 endchoice
100
101 config OPTIMIZE_INLINING
102         bool "Allow compiler to uninline functions marked 'inline' in full U-Boot"
103         help
104           This option determines if U-Boot forces gcc to inline the functions
105           developers have marked 'inline'. Doing so takes away freedom from gcc to
106           do what it thinks is best, which is desirable in some cases for size
107           reasons.
108
109 config SPL_OPTIMIZE_INLINING
110         bool "Allow compiler to uninline functions marked 'inline' in SPL"
111         depends on SPL
112         help
113           This option determines if U-Boot forces gcc to inline the functions
114           developers have marked 'inline'. Doing so takes away freedom from gcc to
115           do what it thinks is best, which is desirable in some cases for size
116           reasons.
117
118 config ARCH_SUPPORTS_LTO
119         bool
120
121 config LTO
122         bool "Enable Link Time Optimizations"
123         depends on ARCH_SUPPORTS_LTO
124         help
125           This option enables Link Time Optimization (LTO), a mechanism which
126           allows the compiler to optimize between different compilation units.
127
128           This can optimize away dead code paths, resulting in smaller binary
129           size (if CC_OPTIMIZE_FOR_SIZE is enabled).
130
131           This option is not available for every architecture and may
132           introduce bugs.
133
134           Currently, when compiling with GCC, due to a weird bug regarding
135           jobserver, the final linking will not respect make's --jobs argument.
136           Instead all available processors will be used (as reported by the
137           nproc command).
138
139           If unsure, say n.
140
141 config TPL_OPTIMIZE_INLINING
142         bool "Allow compiler to uninline functions marked 'inline' in TPL"
143         depends on TPL
144         help
145           This option determines if U-Boot forces gcc to inline the functions
146           developers have marked 'inline'. Doing so takes away freedom from gcc to
147           do what it thinks is best, which is desirable in some cases for size
148           reasons.
149
150 config CC_COVERAGE
151         bool "Enable code coverage analysis"
152         depends on SANDBOX
153         help
154           Enabling this option will pass "--coverage" to gcc to compile
155           and link code instrumented for coverage analysis.
156
157 config CC_HAS_ASM_INLINE
158         def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null)
159
160 config XEN
161         bool "Select U-Boot be run as a bootloader for XEN Virtual Machine"
162         help
163           Enabling this option will make U-Boot be run as a bootloader
164           for XEN [1] Virtual Machine.
165
166           Xen is a virtual machine monitor (VMM) or a type-1 hypervisor with support
167           for para-virtualization. Xen can organize the safe execution of several
168           virtual machines on the same physical system with performance close to
169           native. It is used as the basis for a number of different commercial and
170           open source applications, such as: server virtualization, Infrastructure
171           as a Service (IaaS), desktop virtualization, security applications,
172           embedded and hardware appliances.
173           Xen has a special VM called Domain-0 that runs the Dom0 kernel and allows
174           Xen to use the device drivers for the Domain-0 kernel by default.
175
176           [1] - https://xenproject.org/
177
178 config DISTRO_DEFAULTS
179         bool "Select defaults suitable for booting general purpose Linux distributions"
180         select AUTO_COMPLETE
181         select CMDLINE_EDITING
182         select CMD_BOOTI if ARM64
183         select CMD_BOOTZ if ARM && !ARM64
184         select CMD_DHCP if CMD_NET
185         select CMD_ENV_EXISTS
186         select CMD_EXT2
187         select CMD_EXT4
188         select CMD_FAT
189         select CMD_FS_GENERIC
190         select CMD_PART if PARTITIONS
191         select CMD_PING if CMD_NET
192         select CMD_PXE if NET
193         select CMD_SYSBOOT
194         select ENV_VARS_UBOOT_CONFIG
195         select HUSH_PARSER
196         select SUPPORT_RAW_INITRD
197         select SYS_LONGHELP
198         imply CMD_MII if NET
199         imply USB_STORAGE
200         imply USE_BOOTCOMMAND
201         help
202           Select this to enable various options and commands which are suitable
203           for building u-boot for booting general purpose Linux distributions.
204
205 config ENV_VARS_UBOOT_CONFIG
206         bool "Add arch, board, vendor and soc variables to default environment"
207         help
208           Define this in order to add variables describing the
209           U-Boot build configuration to the default environment.
210           These will be named arch, cpu, board, vendor, and soc.
211           Enabling this option will cause the following to be defined:
212           - CONFIG_SYS_ARCH
213           - CONFIG_SYS_CPU
214           - CONFIG_SYS_BOARD
215           - CONFIG_SYS_VENDOR
216           - CONFIG_SYS_SOC
217
218 config NR_DRAM_BANKS
219         int "Number of DRAM banks"
220         default 1 if ARCH_SUNXI || ARCH_OWL
221         default 4
222         help
223           This defines the number of DRAM banks.
224
225 config SYS_BOOT_GET_CMDLINE
226         bool "Enable kernel command line setup"
227         help
228           Enables allocating and saving kernel cmdline in space between
229           "bootm_low" and "bootm_low" + BOOTMAPSZ.
230
231 config SYS_BOOT_GET_KBD
232         bool "Enable kernel board information setup"
233         help
234           Enables allocating and saving a kernel copy of the bd_info in
235           space between "bootm_low" and "bootm_low" + BOOTMAPSZ.
236
237 config SYS_MALLOC_F
238         bool "Enable malloc() pool before relocation"
239         default y if DM
240
241         help
242           Before relocation, memory is very limited on many platforms. Still,
243           we can provide a small malloc() pool if needed. Driver model in
244           particular needs this to operate, so that it can allocate the
245           initial serial device and any others that are needed.
246
247 config SYS_MALLOC_F_LEN
248         hex "Size of malloc() pool before relocation"
249         depends on SYS_MALLOC_F
250         default 0x400 if M68K || PPC || ROCKCHIP_PX30 || ROCKCHIP_RK3036 || \
251                          ROCKCHIP_RK3308 || ROCKCHIP_RV1108
252         default 0x600 if ARCH_ZYNQMP_R5 || ARCH_ZYNQMP
253         default 0x800 if ARCH_ZYNQ || ROCKCHIP_RK3128 || ROCKCHIP_RK3188 || \
254                          ROCKCHIP_RK322X || X86
255         default 0x1000 if ARCH_MESON || ARCH_BMIPS || ARCH_MTMIPS
256         default 0x1800 if ARCH_TEGRA
257         default 0x4000 if SANDBOX || RISCV || ARCH_APPLE || ROCKCHIP_RK3368 || \
258                           ROCKCHIP_RK3399
259         default 0x8000 if RCAR_GEN3
260         default 0x10000 if ARCH_IMX8 || (ARCH_IMX8M && !IMX8MQ)
261         default 0x2000
262         help
263           Before relocation, memory is very limited on many platforms. Still,
264           we can provide a small malloc() pool if needed. Driver model in
265           particular needs this to operate, so that it can allocate the
266           initial serial device and any others that are needed.
267
268 config SYS_MALLOC_LEN
269         hex "Define memory for Dynamic allocation"
270         default 0x4000000 if SANDBOX
271         default 0x2000000 if ARCH_ROCKCHIP || ARCH_OMAP2PLUS || ARCH_MESON
272         default 0x200000 if ARCH_BMIPS || X86
273         default 0x120000 if MACH_SUNIV
274         default 0x220000 if MACH_SUN8I_V3S
275         default 0x4020000 if ARCH_SUNXI
276         default 0x400000
277         help
278           This defines memory to be allocated for Dynamic allocation
279           TODO: Use for other architectures
280
281 config SPL_SYS_MALLOC_F_LEN
282         hex "Size of malloc() pool in SPL"
283         depends on SYS_MALLOC_F && SPL
284         default 0 if !SPL_FRAMEWORK
285         default 0x2800 if RCAR_GEN3
286         default SYS_MALLOC_F_LEN
287         help
288           In SPL memory is very limited on many platforms. Still,
289           we can provide a small malloc() pool if needed. Driver model in
290           particular needs this to operate, so that it can allocate the
291           initial serial device and any others that are needed.
292
293           It is possible to enable CONFIG_SYS_SPL_MALLOC_START to start a new
294           malloc() region in SDRAM once it is inited.
295
296 config TPL_SYS_MALLOC_F_LEN
297         hex "Size of malloc() pool in TPL"
298         depends on SYS_MALLOC_F && TPL
299         default SPL_SYS_MALLOC_F_LEN
300         help
301           In TPL memory is very limited on many platforms. Still,
302           we can provide a small malloc() pool if needed. Driver model in
303           particular needs this to operate, so that it can allocate the
304           initial serial device and any others that are needed.
305
306 config VALGRIND
307         bool "Inform valgrind about memory allocations"
308         depends on !RISCV
309         help
310           Valgrind is an instrumentation framework for building dynamic analysis
311           tools. In particular, it may be used to detect memory management bugs
312           in U-Boot. It relies on knowing when heap blocks are allocated in
313           order to give accurate results. This happens automatically for
314           standard allocator functions provided by the host OS. However, this
315           doesn't automatically happen for U-Boot's malloc implementation.
316
317           Enable this option to annotate U-Boot's malloc implementation so that
318           it can be handled accurately by Valgrind. If you aren't planning on
319           using valgrind to debug U-Boot, say 'n'.
320
321 config VPL_SYS_MALLOC_F_LEN
322         hex "Size of malloc() pool in VPL before relocation"
323         depends on SYS_MALLOC_F && VPL
324         default SYS_MALLOC_F_LEN
325         help
326           Before relocation, memory is very limited on many platforms. Still,
327           we can provide a small malloc() pool if needed. Driver model in
328           particular needs this to operate, so that it can allocate the
329           initial serial device and any others that are needed.
330
331 menuconfig EXPERT
332         bool "Configure standard U-Boot features (expert users)"
333         default y
334         help
335           This option allows certain base U-Boot options and settings
336           to be disabled or tweaked. This is for specialized
337           environments which can tolerate a "non-standard" U-Boot.
338           Use this only if you really know what you are doing.
339
340 if EXPERT
341         config SYS_MALLOC_CLEAR_ON_INIT
342         bool "Init with zeros the memory reserved for malloc (slow)"
343         default y
344         help
345           This setting is enabled by default. The reserved malloc
346           memory is initialized with zeros, so first malloc calls
347           will return the pointer to the zeroed memory. But this
348           slows the boot time.
349
350           It is recommended to disable it, when CONFIG_SYS_MALLOC_LEN
351           value, has more than few MiB, e.g. when uses bzip2 or bmp logo.
352           Then the boot time can be significantly reduced.
353           Warning:
354           When disabling this, please check if malloc calls, maybe
355           should be replaced by calloc - if one expects zeroed memory.
356
357 config SYS_MALLOC_DEFAULT_TO_INIT
358         bool "Default malloc to init while reserving the memory for it"
359         help
360           It may happen that one needs to move the dynamic allocation
361           from one to another memory range, eg. when moving the malloc
362           from the limited static to a potentially large dynamic (DDR)
363           memory.
364
365           If so then on top of setting the updated memory aside one
366           needs to bring the malloc init.
367
368           If such a scenario is sought choose yes.
369
370 config TOOLS_DEBUG
371         bool "Enable debug information for tools"
372         help
373           Enable generation of debug information for tools such as mkimage.
374           This can be used for debugging purposes. With debug information
375           it is possible to set breakpoints on particular lines, single-step
376           debug through the source code, etc.
377
378 endif # EXPERT
379
380 config PHYS_64BIT
381         bool "64bit physical address support"
382         help
383           Say Y here to support 64bit physical memory address.
384           This can be used not only for 64bit SoCs, but also for
385           large physical address extension on 32bit SoCs.
386
387 config HAS_ROM
388         bool
389         select BINMAN
390         help
391           Enables building of a u-boot.rom target. This collects U-Boot and
392           any necessary binary blobs.
393
394 config SPL_IMAGE
395         string "SPL image used in the combined SPL+U-Boot image"
396         default "spl/boot.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
397         default "spl/u-boot-spl.bin"
398         depends on SPL
399         help
400           Select the SPL build target that shall be generated by the SPL
401           build process (default spl/u-boot-spl.bin). This image will be
402           used to generate a combined image with SPL and main U-Boot
403           proper as one single image.
404
405 config REMAKE_ELF
406         bool "Recreate an ELF image from raw U-Boot binary"
407         help
408           Enable this to recreate an ELF image (u-boot.elf) from the raw
409           U-Boot binary (u-boot.bin), which may already have been statically
410           relocated and may already have a device-tree appended to it.
411
412 config BUILD_TARGET
413         string "Build target special images"
414         default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_ARRIA10
415         default "u-boot-with-spl.sfp" if TARGET_SOCFPGA_GEN5
416         default "u-boot-spl.kwb" if ARCH_MVEBU && SPL
417         default "u-boot-elf.srec" if RCAR_GEN3
418         default "u-boot.itb" if !BINMAN && SPL_LOAD_FIT && (ARCH_ROCKCHIP || \
419                                 ARCH_SUNXI || RISCV || ARCH_ZYNQMP)
420         default "u-boot.kwb" if ARCH_KIRKWOOD
421         default "u-boot-with-spl.bin" if ARCH_AT91 && SPL_NAND_SUPPORT
422         default "u-boot-with-spl.imx" if ARCH_MX6 && SPL
423         help
424           Some SoCs need special image types (e.g. U-Boot binary
425           with a special header) as build targets. By defining
426           CONFIG_BUILD_TARGET in the SoC / board header, this
427           special image will be automatically built upon calling
428           make / buildman.
429
430 config HAS_BOARD_SIZE_LIMIT
431         bool "Define a maximum size for the U-Boot image"
432         default y if RCAR_GEN3
433         help
434           In some cases, we need to enforce a hard limit on how big the U-Boot
435           image itself can be.
436
437 config BOARD_SIZE_LIMIT
438         int "Maximum size of the U-Boot image in bytes"
439         default 1048576 if RCAR_GEN3
440         depends on HAS_BOARD_SIZE_LIMIT
441         help
442           Maximum size of the U-Boot image. When defined, the build system
443           checks that the actual size does not exceed it.  This does not
444           include SPL nor TPL, on platforms that use that functionality, they
445           have a separate option to restict size.
446
447 config SYS_CUSTOM_LDSCRIPT
448         bool "Use a custom location for the U-Boot linker script"
449         help
450           Normally when linking U-Boot we will look in the board directory,
451           the CPU directory and finally the "cpu" directory of the architecture
452           for the ile "u-boot.lds" and use that as our linker.  However, in
453           some cases we need to provide a different linker script.  To do so,
454           enable this option and then provide the location under
455           CONFIG_SYS_LDSCRIPT.
456
457 config SYS_LDSCRIPT
458         depends on SYS_CUSTOM_LDSCRIPT
459         string "Custom ldscript location"
460         help
461           Path within the source tree to the linker script to use for the
462           main U-Boot binary.
463
464 config SYS_LOAD_ADDR
465         hex "Address in memory to use by default"
466         default 0x01000000 if ARCH_SOCFPGA
467         default 0x02000000 if PPC || X86
468         default 0x81000000 if MACH_SUNIV
469         default 0x22000000 if MACH_SUN9I
470         default 0x42000000 if ARCH_SUNXI
471         default 0x82000000 if ARCH_KEYSTONE || ARCH_OMAP2PLUS || ARCH_K3
472         default 0x82000000 if ARCH_MX6 && (MX6SL || MX6SLL  || MX6SX || MX6UL || MX6ULL)
473         default 0x12000000 if ARCH_MX6 && !(MX6SL || MX6SLL  || MX6SX || MX6UL || MX6ULL)
474         default 0x80800000 if ARCH_MX7
475         default 0x90000000 if FSL_LSCH2 || FSL_LSCH3
476         help
477           Address in memory to use as the default safe load address.
478
479 config ERR_PTR_OFFSET
480         hex
481         default 0x0
482         help
483           Some U-Boot pointers have redundant information, so we can use a
484           scheme where we can return either an error code or a pointer with the
485           same return value. The default implementation just casts the pointer
486           to a number, however, this may fail on platforms where the end of the
487           address range is used for valid pointers (e.g. 0xffffff00 is a valid
488           heap pointer in socfpga SPL).
489           For such platforms, this value provides an upper range of those error
490           pointer values - up to 'MAX_ERRNO' bytes below this value must be
491           unused/invalid addresses.
492
493 config PLATFORM_ELFENTRY
494         string
495         default "__start" if MIPS
496         default "_start"
497
498 config STACK_SIZE
499         hex "Define max stack size that can be used by U-Boot"
500         default 0x4000000 if ARCH_VERSAL || ARCH_ZYNQMP
501         default 0x200000 if MICROBLAZE
502         default 0x1000000
503         help
504           Define Max stack size that can be used by U-Boot. This value is used
505           by the UEFI sub-system. On some boards initrd_high is calculated as
506           base stack pointer minus this stack size.
507
508 config SYS_MEM_TOP_HIDE
509         hex "Exclude some memory from U-Boot / OS information"
510         default 0x0
511         help
512           If set, this specified memory area will get subtracted from the top
513           (end) of RAM and won't get "touched" at all by U-Boot. By fixing up
514           gd->ram_size the OS / next stage should gets passed the now
515           "corrected" memory size and won't touch it either.
516           WARNING: Please make sure that this value is a multiple of the OS
517           page size.
518
519 config SYS_HAS_SRAM
520         bool
521         default y if TARGET_PIC32MZDASK
522         default y if TARGET_DEVKIT8000
523         default y if TARGET_TRICORDER
524         help
525           Enable this to allow support for the on board SRAM.
526           SRAM base address is controlled by CONFIG_SYS_SRAM_BASE.
527           SRAM size is controlled by CONFIG_SYS_SRAM_SIZE.
528
529 config SYS_SRAM_BASE
530         hex
531         default 0x80000000 if TARGET_PIC32MZDASK
532         default 0x40200000 if TARGET_DEVKIT8000
533         default 0x40200000 if TARGET_TRICORDER
534         default 0x0
535
536 config SYS_SRAM_SIZE
537         hex
538         default 0x00080000 if TARGET_PIC32MZDASK
539         default 0x10000 if TARGET_DEVKIT8000
540         default 0x10000 if TARGET_TRICORDER
541         default 0x0
542
543 config MP
544         bool "Support for multiprocessor"
545         help
546           This provides an option to bringup different processors
547           in multiprocessor cases.
548
549 config EXAMPLES
550         bool "Compile API examples"
551         depends on !SANDBOX
552         default y if ARCH_QEMU
553         help
554           U-Boot provides an API for standalone applications. Examples are
555           provided in directory examples/.
556
557 endmenu         # General setup
558
559 source "api/Kconfig"
560
561 source "boot/Kconfig"
562
563 source "common/Kconfig"
564
565 source "cmd/Kconfig"
566
567 source "disk/Kconfig"
568
569 source "dts/Kconfig"
570
571 source "env/Kconfig"
572
573 source "net/Kconfig"
574
575 source "drivers/Kconfig"
576
577 source "fs/Kconfig"
578
579 source "lib/Kconfig"
580
581 source "test/Kconfig"
582
583 source "tools/Kconfig"