1 # SPDX-License-Identifier: GPL-2.0-only
3 # Copyright (C) 2006-2013 OpenWrt.org
4 # Copyright (C) 2016 LEDE Project
7 bool "Enable experimental features by default"
9 Set this option to build with latest bleeding edge features
10 which may or may not work as expected.
11 If you would like to help the development of OpenWrt, you are
12 encouraged to set this option and provide feedback (both
13 positive and negative). But do so only if you know how to
14 recover your device in case of flashing potentially non-working
17 If you plan to use this build in production, say NO!
19 menu "Global build settings"
21 config JSON_OVERVIEW_IMAGE_INFO
22 bool "Create JSON info file overview per target"
25 Create a JSON info file called profiles.json in the target
26 directory containing machine readable list of built profiles
30 bool "Select all target specific packages by default"
35 bool "Select all kernel module packages by default"
38 bool "Select all userspace packages by default"
43 bool "Set build defaults for automatic builds (e.g. via buildbot)"
45 This option changes several defaults to be more suitable for
46 automatic builds. This includes the following changes:
47 - Deleting build directories after compiling (to save space)
48 - Enabling per-device rootfs support
51 config SIGNED_PACKAGES
52 bool "Cryptographically signed package lists"
55 config SIGNATURE_CHECK
56 bool "Enable signature checking in opkg"
57 default SIGNED_PACKAGES
59 config DOWNLOAD_CHECK_CERTIFICATE
60 bool "Enable TLS certificate verification during package download"
63 comment "General build options"
66 bool "Use the testing kernel version"
67 depends on HAS_TESTING_KERNEL
70 If the target supports a newer kernel version than the default,
71 you can use this config option to enable it
74 config DISPLAY_SUPPORT
75 bool "Show packages that require graphics support (local or remote)"
78 bool "Compile with support for patented functionality"
80 When this option is disabled, software which provides patented functionality
81 will not be built. In case software provides optional support for patented
82 functionality, this optional support will get disabled for this package.
85 bool "Compile with full language support"
87 When this option is enabled, packages are built with the full versions of
88 iconv and GNU gettext instead of the default OpenWrt stubs. If uClibc is
89 used, it is also built with locale support.
91 config SHADOW_PASSWORDS
97 prompt "Remove ipkg/opkg status data files in final images"
99 This removes all ipkg/opkg status data files from the target directory
100 before building the root filesystem.
102 config IPK_FILES_CHECKSUMS
104 prompt "Record files checksums in package metadata"
106 This makes file checksums part of package metadata. It increases size
107 but provides you with pkg_check command to check for flash corruptions.
109 config INCLUDE_CONFIG
110 bool "Include build configuration in firmware" if DEVEL
112 If enabled, buildinfo files will be stored in /etc/build.* of firmware.
114 config REPRODUCIBLE_DEBUG_INFO
115 bool "Make debug information reproducible"
118 This strips the local build path out of debug information. This has the
119 advantage of making it reproducible, but the disadvantage of making local
120 debugging using ./scripts/remote-gdb harder, since the debug data will
121 no longer point to the full path on the build host.
123 config COLLECT_KERNEL_DEBUG
125 prompt "Collect kernel debug information"
126 select KERNEL_DEBUG_INFO
129 This collects debugging symbols from the kernel and all compiled modules.
130 Useful for release builds, so that kernel issues can be debugged offline
133 menu "Kernel build options"
135 source "config/Config-kernel.in"
139 comment "Package build options"
143 prompt "Compile packages with debugging info"
145 Adds -g3 to the CFLAGS.
147 config USE_GC_SECTIONS
149 prompt "Dead code and data elimination for all packages (EXPERIMENTAL)"
151 Places functions and data items into its own sections to use the linker's
152 garbage collection capabilites.
153 Packages can choose to opt-out via setting PKG_BUILD_FLAGS:=no-gc-sections
157 prompt "Use the link-time optimizer for all packages (EXPERIMENTAL)"
159 Adds LTO flags to the CFLAGS and LDFLAGS.
160 Packages can choose to opt-out via setting PKG_BUILD_FLAGS:=no-lto
163 depends on (aarch64 || arm || i386 || i686 || m68k || powerpc || powerpc64 || sh4 || x86_64)
164 depends on !GCC_USE_VERSION_11
165 def_bool $(shell, ./config/check-hostcxx.sh 10 2 12)
169 prompt "Use the mold linker for all packages"
172 Link packages with mold, a modern linker
173 Packages can opt-out via setting PKG_BUILD_FLAGS:=no-mold
178 comment "Stripping options"
181 prompt "Binary stripping method"
182 default USE_STRIP if USE_GLIBC
185 Select the binary stripping method you wish to use.
190 This will install unstripped binaries (useful for native
191 compiling/debugging).
196 This will install binaries stripped using strip from binutils.
200 depends on !USE_GLIBC
202 This will install binaries stripped using sstrip.
207 prompt "Strip arguments"
209 default "--strip-unneeded --remove-section=.comment --remove-section=.note" if DEBUG
210 default "--strip-all"
212 Specifies arguments passed to the strip command when stripping binaries.
214 config SSTRIP_DISCARD_TRAILING_ZEROES
215 bool "Strip trailing zero bytes"
216 depends on USE_SSTRIP && !USE_MOLD
219 Use sstrip's -z option to discard trailing zero bytes
221 config STRIP_KERNEL_EXPORTS
222 bool "Strip unnecessary exports from the kernel image"
224 Reduces kernel size by stripping unused kernel exports from the kernel
225 image. Note that this might make the kernel incompatible with any kernel
226 modules that were not selected at the time the kernel image was created.
229 bool "Strip unnecessary functions from libraries"
231 Reduces libraries to only those functions that are necessary for using all
232 selected packages (including those selected as <M>). Note that this will
233 make the system libraries incompatible with most of the packages that are
234 not selected during the build process.
236 comment "Hardening build options"
238 config PKG_CHECK_FORMAT_SECURITY
240 prompt "Enable gcc format-security"
243 Add -Wformat -Werror=format-security to the CFLAGS. You can disable
244 this per package by adding PKG_CHECK_FORMAT_SECURITY:=0 in the package
248 prompt "User space ASLR PIE compilation"
249 default PKG_ASLR_PIE_NONE if ((SMALL_FLASH || LOW_MEMORY_FOOTPRINT) && !SDK)
250 default PKG_ASLR_PIE_REGULAR
252 Add -fPIC to CFLAGS and -specs=hardened-build-ld to LDFLAGS.
253 This enables package build as Position Independent Executables (PIE)
254 to protect against "return-to-text" attacks. This belongs to the
255 feature of Address Space Layout Randomisation (ASLR), which is
256 implemented by the kernel and the ELF loader by randomising the
257 location of memory allocations. This makes memory addresses harder
258 to predict when an attacker is attempting a memory-corruption exploit.
259 You can disable this per package by adding PKG_ASLR_PIE:=0 in the package
261 Be ware that ASLR increases the binary size.
262 config PKG_ASLR_PIE_NONE
265 PIE is deactivated for all applications
266 config PKG_ASLR_PIE_REGULAR
269 PIE is activated for some binaries, mostly network exposed applications
270 config PKG_ASLR_PIE_ALL
272 select BUSYBOX_DEFAULT_PIE
274 PIE is activated for all applications
278 prompt "User space Stack-Smashing Protection"
279 default PKG_CC_STACKPROTECTOR_REGULAR
281 Enable GCC Stack Smashing Protection (SSP) for userspace applications
282 config PKG_CC_STACKPROTECTOR_NONE
284 config PKG_CC_STACKPROTECTOR_REGULAR
286 config PKG_CC_STACKPROTECTOR_STRONG
291 prompt "Kernel space Stack-Smashing Protection"
292 default KERNEL_CC_STACKPROTECTOR_REGULAR
294 Enable GCC Stack-Smashing Protection (SSP) for the kernel
295 config KERNEL_CC_STACKPROTECTOR_NONE
297 config KERNEL_CC_STACKPROTECTOR_REGULAR
299 config KERNEL_CC_STACKPROTECTOR_STRONG
303 config KERNEL_STACKPROTECTOR
305 default KERNEL_CC_STACKPROTECTOR_REGULAR || KERNEL_CC_STACKPROTECTOR_STRONG
307 config KERNEL_STACKPROTECTOR_STRONG
309 default KERNEL_CC_STACKPROTECTOR_STRONG
312 prompt "Enable buffer-overflows detection (FORTIFY_SOURCE)"
313 default PKG_FORTIFY_SOURCE_1
315 Enable the _FORTIFY_SOURCE macro which introduces additional
316 checks to detect buffer-overflows in the following standard library
317 functions: memcpy, mempcpy, memmove, memset, strcpy, stpcpy,
318 strncpy, strcat, strncat, sprintf, vsprintf, snprintf, vsnprintf,
319 gets. "Conservative" (_FORTIFY_SOURCE set to 1) only introduces
320 checks that shouldn't change the behavior of conforming programs,
321 while "aggressive" (_FORTIFY_SOURCES set to 2) some more checking is
322 added, but some conforming programs might fail.
323 config PKG_FORTIFY_SOURCE_NONE
325 config PKG_FORTIFY_SOURCE_1
327 config PKG_FORTIFY_SOURCE_2
332 prompt "Enable RELRO protection"
333 default PKG_RELRO_FULL
335 Enable a link-time protection known as RELRO (Relocation Read Only)
336 which helps to protect from certain type of exploitation techniques
337 altering the content of some ELF sections. "Partial" RELRO makes the
338 .dynamic section not writeable after initialization, introducing
339 almost no performance penalty, while "full" RELRO also marks the GOT
340 as read-only at the cost of initializing all of it at startup.
341 config PKG_RELRO_NONE
343 config PKG_RELRO_PARTIAL
345 config PKG_RELRO_FULL
349 config TARGET_ROOTFS_SECURITY_LABELS
351 select KERNEL_SQUASHFS_XATTR
352 select KERNEL_EXT4_FS_SECURITY
353 select KERNEL_F2FS_FS_SECURITY
354 select KERNEL_UBIFS_FS_SECURITY
355 select KERNEL_JFFS2_FS_SECURITY
358 bool "Enable SELinux"
359 select KERNEL_SECURITY_SELINUX
360 select TARGET_ROOTFS_SECURITY_LABELS
361 select PACKAGE_procd-selinux
362 select PACKAGE_busybox-selinux
364 This option enables SELinux kernel features, applies security labels
365 in squashfs rootfs and selects the selinux-variants of busybox and procd.
367 Selecting this option results in about 0.5MiB of additional flash space
368 usage accounting for increased kernel and rootfs size.
371 prompt "default SELinux type"
372 depends on TARGET_ROOTFS_SECURITY_LABELS
373 default SELINUXTYPE_dssp
375 Select SELinux policy to be installed and used for applying rootfs labels.
377 config SELINUXTYPE_targeted
379 select PACKAGE_refpolicy
381 SELinux Reference Policy (refpolicy)
383 config SELINUXTYPE_dssp
385 select PACKAGE_selinux-policy
387 Defensec SELinux Security Policy -- OpenWrt edition
392 bool "Enable SECCOMP"
393 select KERNEL_SECCOMP
394 select PACKAGE_procd-seccomp
395 depends on (aarch64 || arm || armeb || mips || mipsel || mips64 || mips64el || i386 || powerpc || x86_64)
396 depends on !TARGET_uml
399 This option enables seccomp kernel features to safely
400 execute untrusted bytecode and selects the seccomp-variants