config/Config-build.in

   1 # SPDX-License-Identifier: GPL-2.0-only
   2 #
   3 # Copyright (C) 2006-2013 OpenWrt.org
   4 # Copyright (C) 2016 LEDE Project
   5
   6 config EXPERIMENTAL
   7         bool "Enable experimental features by default"
   8         help
   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
  15           firmware.
  16
  17           If you plan to use this build in production, say NO!
  18
  19 menu "Global build settings"
  20
  21         config JSON_OVERVIEW_IMAGE_INFO
  22                 bool "Create JSON info file overview per target"
  23                 default y
  24                 help
  25                   Create a JSON info file called profiles.json in the target
  26                   directory containing machine readable list of built profiles
  27                   and resulting images.
  28
  29         config ALL_NONSHARED
  30                 bool "Select all target specific packages by default"
  31                 select ALL_KMODS
  32                 default BUILDBOT
  33
  34         config ALL_KMODS
  35                 bool "Select all kernel module packages by default"
  36
  37         config ALL
  38                 bool "Select all userspace packages by default"
  39                 select ALL_KMODS
  40                 select ALL_NONSHARED
  41
  42         config BUILDBOT
  43                 bool "Set build defaults for automatic builds (e.g. via buildbot)"
  44                 help
  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
  49                   ...
  50
  51         config SIGNED_PACKAGES
  52                 bool "Cryptographically signed package lists"
  53                 default y
  54
  55         config SIGNATURE_CHECK
  56                 bool "Enable signature checking in opkg"
  57                 default SIGNED_PACKAGES
  58
  59         config DOWNLOAD_CHECK_CERTIFICATE
  60                 bool "Enable TLS certificate verification during package download"
  61                 default y
  62
  63         comment "General build options"
  64
  65         config TESTING_KERNEL
  66                 bool "Use the testing kernel version"
  67                 depends on HAS_TESTING_KERNEL
  68                 default EXPERIMENTAL
  69                 help
  70                   If the target supports a newer kernel version than the default,
  71                   you can use this config option to enable it
  72
  73
  74         config DISPLAY_SUPPORT
  75                 bool "Show packages that require graphics support (local or remote)"
  76
  77         config BUILD_PATENTED
  78                 bool "Compile with support for patented functionality"
  79                 help
  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.
  83
  84         config BUILD_NLS
  85                 bool "Compile with full language support"
  86                 help
  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.
  90
  91         config SHADOW_PASSWORDS
  92                 bool
  93                 default y
  94
  95         config CLEAN_IPKG
  96                 bool
  97                 prompt "Remove ipkg/opkg status data files in final images"
  98                 help
  99                   This removes all ipkg/opkg status data files from the target directory
 100                   before building the root filesystem.
 101
 102         config IPK_FILES_CHECKSUMS
 103                 bool
 104                 prompt "Record files checksums in package metadata"
 105                 help
 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.
 108
 109         config INCLUDE_CONFIG
 110                 bool "Include build configuration in firmware" if DEVEL
 111                 help
 112                   If enabled, buildinfo files will be stored in /etc/build.* of firmware.
 113
 114         config REPRODUCIBLE_DEBUG_INFO
 115                 bool "Make debug information reproducible"
 116                 default BUILDBOT
 117                 help
 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.
 122
 123         config COLLECT_KERNEL_DEBUG
 124                 bool
 125                 prompt "Collect kernel debug information"
 126                 select KERNEL_DEBUG_INFO
 127                 default BUILDBOT
 128                 help
 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
 131                   later.
 132
 133         menu "Kernel build options"
 134
 135         source "config/Config-kernel.in"
 136
 137         endmenu
 138
 139         comment "Package build options"
 140
 141         config DEBUG
 142                 bool
 143                 prompt "Compile packages with debugging info"
 144                 help
 145                   Adds -g3 to the CFLAGS.
 146
 147         config USE_GC_SECTIONS
 148                 bool
 149                 prompt "Dead code and data elimination for all packages (EXPERIMENTAL)"
 150                 help
 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
 154
 155         config USE_LTO
 156                 bool
 157                 prompt "Use the link-time optimizer for all packages (EXPERIMENTAL)"
 158                 help
 159                   Adds LTO flags to the CFLAGS and LDFLAGS.
 160                   Packages can choose to opt-out via setting PKG_BUILD_FLAGS:=no-lto
 161
 162         config MOLD
 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)
 166
 167         config USE_MOLD
 168                 bool
 169                 prompt "Use the mold linker for all packages"
 170                 depends on MOLD
 171                 help
 172                   Link packages with mold, a modern linker
 173                   Packages can opt-out via setting PKG_BUILD_FLAGS:=no-mold
 174
 175         config IPV6
 176                 def_bool y
 177
 178         comment "Stripping options"
 179
 180         choice
 181                 prompt "Binary stripping method"
 182                 default USE_STRIP   if USE_GLIBC
 183                 default USE_SSTRIP
 184                 help
 185                   Select the binary stripping method you wish to use.
 186
 187                 config NO_STRIP
 188                         bool "none"
 189                         help
 190                           This will install unstripped binaries (useful for native
 191                           compiling/debugging).
 192
 193                 config USE_STRIP
 194                         bool "strip"
 195                         help
 196                           This will install binaries stripped using strip from binutils.
 197
 198                 config USE_SSTRIP
 199                         bool "sstrip"
 200                         depends on !USE_GLIBC
 201                         help
 202                           This will install binaries stripped using sstrip.
 203         endchoice
 204
 205         config STRIP_ARGS
 206                 string
 207                 prompt "Strip arguments"
 208                 depends on USE_STRIP
 209                 default "--strip-unneeded --remove-section=.comment --remove-section=.note" if DEBUG
 210                 default "--strip-all"
 211                 help
 212                   Specifies arguments passed to the strip command when stripping binaries.
 213
 214         config SSTRIP_DISCARD_TRAILING_ZEROES
 215                 bool "Strip trailing zero bytes"
 216                 depends on USE_SSTRIP && !USE_MOLD
 217                 default y
 218                 help
 219                   Use sstrip's -z option to discard trailing zero bytes
 220
 221         config STRIP_KERNEL_EXPORTS
 222                 bool "Strip unnecessary exports from the kernel image"
 223                 help
 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.
 227
 228         config USE_MKLIBS
 229                 bool "Strip unnecessary functions from libraries"
 230                 help
 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.
 235
 236         comment "Hardening build options"
 237
 238         config PKG_CHECK_FORMAT_SECURITY
 239                 bool
 240                 prompt "Enable gcc format-security"
 241                 default y
 242                 help
 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
 245                   Makefile.
 246
 247         choice
 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
 251                 help
 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
 260                   Makefile.
 261                   Be ware that ASLR increases the binary size.
 262                 config PKG_ASLR_PIE_NONE
 263                         bool "None"
 264                         help
 265                           PIE is deactivated for all applications
 266                 config PKG_ASLR_PIE_REGULAR
 267                         bool "Regular"
 268                         help
 269                           PIE is activated for some binaries, mostly network exposed applications
 270                 config PKG_ASLR_PIE_ALL
 271                         bool "All"
 272                         select BUSYBOX_DEFAULT_PIE
 273                         help
 274                           PIE is activated for all applications
 275         endchoice
 276
 277         choice
 278                 prompt "User space Stack-Smashing Protection"
 279                 default PKG_CC_STACKPROTECTOR_REGULAR
 280                 help
 281                   Enable GCC Stack Smashing Protection (SSP) for userspace applications
 282                 config PKG_CC_STACKPROTECTOR_NONE
 283                         bool "None"
 284                 config PKG_CC_STACKPROTECTOR_REGULAR
 285                         bool "Regular"
 286                 config PKG_CC_STACKPROTECTOR_STRONG
 287                         bool "Strong"
 288         endchoice
 289
 290         choice
 291                 prompt "Kernel space Stack-Smashing Protection"
 292                 default KERNEL_CC_STACKPROTECTOR_REGULAR
 293                 help
 294                   Enable GCC Stack-Smashing Protection (SSP) for the kernel
 295                 config KERNEL_CC_STACKPROTECTOR_NONE
 296                         bool "None"
 297                 config KERNEL_CC_STACKPROTECTOR_REGULAR
 298                         bool "Regular"
 299                 config KERNEL_CC_STACKPROTECTOR_STRONG
 300                         bool "Strong"
 301         endchoice
 302
 303         config KERNEL_STACKPROTECTOR
 304                 bool
 305                 default KERNEL_CC_STACKPROTECTOR_REGULAR || KERNEL_CC_STACKPROTECTOR_STRONG
 306
 307         config KERNEL_STACKPROTECTOR_STRONG
 308                 bool
 309                 default KERNEL_CC_STACKPROTECTOR_STRONG
 310
 311         choice
 312                 prompt "Enable buffer-overflows detection (FORTIFY_SOURCE)"
 313                 default PKG_FORTIFY_SOURCE_1
 314                 help
 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
 324                         bool "None"
 325                 config PKG_FORTIFY_SOURCE_1
 326                         bool "Conservative"
 327                 config PKG_FORTIFY_SOURCE_2
 328                         bool "Aggressive"
 329         endchoice
 330
 331         choice
 332                 prompt "Enable RELRO protection"
 333                 default PKG_RELRO_FULL
 334                 help
 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
 342                         bool "None"
 343                 config PKG_RELRO_PARTIAL
 344                         bool "Partial"
 345                 config PKG_RELRO_FULL
 346                         bool "Full"
 347         endchoice
 348
 349         config TARGET_ROOTFS_SECURITY_LABELS
 350                 bool
 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
 356
 357         config SELINUX
 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
 363                 help
 364                   This option enables SELinux kernel features, applies security labels
 365                   in squashfs rootfs and selects the selinux-variants of busybox and procd.
 366
 367                   Selecting this option results in about 0.5MiB of additional flash space
 368                   usage accounting for increased kernel and rootfs size.
 369
 370         choice
 371                 prompt "default SELinux type"
 372                 depends on TARGET_ROOTFS_SECURITY_LABELS
 373                 default SELINUXTYPE_dssp
 374                 help
 375                   Select SELinux policy to be installed and used for applying rootfs labels.
 376
 377                 config SELINUXTYPE_targeted
 378                         bool "targeted"
 379                         select PACKAGE_refpolicy
 380                         help
 381                           SELinux Reference Policy (refpolicy)
 382
 383                 config SELINUXTYPE_dssp
 384                         bool "dssp"
 385                         select PACKAGE_selinux-policy
 386                         help
 387                           Defensec SELinux Security Policy -- OpenWrt edition
 388
 389         endchoice
 390
 391         config SECCOMP
 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
 397                 default y
 398                 help
 399                   This option enables seccomp kernel features to safely
 400                   execute untrusted bytecode and selects the seccomp-variants
 401                   of procd
 402
 403 endmenu