Support for building an hardened OpenWRT
[openwrt.git] / config / Config-build.in
1 # Copyright (C) 2006-2013 OpenWrt.org
2 #
3 # This is free software, licensed under the GNU General Public License v2.
4 # See /LICENSE for more information.
5 #
6
7 menu "Global build settings"
8
9         config ALL
10                 bool "Select all packages by default"
11                 default n
12
13         comment "General build options"
14
15         config DISPLAY_SUPPORT
16                 bool "Show packages that require graphics support (local or remote)"
17                 default n
18
19         config BUILD_PATENTED
20                 default y
21                 bool "Compile with support for patented functionality"
22                 help
23                   When this option is disabled, software which provides patented functionality
24                   will not be built.  In case software provides optional support for patented
25                   functionality, this optional support will get disabled for this package.
26
27         config BUILD_NLS
28                 default n
29                 bool "Compile with full language support"
30                 help
31                   When this option is enabled, packages are built with the full versions of
32                   iconv and GNU gettext instead of the default OpenWrt stubs. If uClibc is
33                   used, it is also built with locale support.
34
35         config BUILD_STATIC_TOOLS
36                 default n
37                 bool "Attempt to link host utilities statically"
38                 help
39                   Linking host utilities like sed or firmware-utils statically increases the
40                   portability of the generated ImageBuilder and SDK tarballs; however, it may
41                   fail on some Linux distributions.
42
43         config SHADOW_PASSWORDS
44                 bool
45                 prompt "Enable shadow password support"
46                 default y
47                 help
48                   Enable shadow password support.
49
50         config CLEAN_IPKG
51                 bool
52                 prompt "Remove ipkg/opkg status data files in final images"
53                 default n
54                 help
55                   This removes all ipkg/opkg status data files from the target directory
56                   before building the root filesystem.
57
58         config COLLECT_KERNEL_DEBUG
59                 bool
60                 prompt "Collect kernel debug information"
61                 select KERNEL_DEBUG_INFO
62                 default n
63                 help
64                   This collects debugging symbols from the kernel and all compiled modules.
65                   Useful for release builds, so that kernel issues can be debugged offline
66                   later.
67
68         comment "Kernel build options"
69
70         source "config/Config-kernel.in"
71
72         comment "Package build options"
73
74         config DEBUG
75                 bool
76                 prompt "Compile packages with debugging info"
77                 default n
78                 help
79                   Adds -g3 to the CFLAGS.
80
81         config IPV6
82                 bool
83                 prompt "Enable IPv6 support in packages"
84                 default y
85                 help
86                   Enable IPv6 support in packages (passes --enable-ipv6 to configure scripts).
87
88         config PKG_BUILD_PARALLEL
89                 bool
90                 prompt "Compile certain packages parallelized"
91                 default y
92                 help
93                   This adds a -jX option to certain packages that are known to behave well
94                   for parallel build. By default, the package make processes use the main
95                   jobserver, in which case this option only takes effect when you add -jX
96                   to the make command.
97
98                   If you are unsure, select N.
99
100         config PKG_BUILD_USE_JOBSERVER
101                 bool
102                 prompt "Use top-level make jobserver for packages"
103                 depends on PKG_BUILD_PARALLEL
104                 default y
105                 help
106                   This passes the main make process jobserver fds to package builds,
107                   enabling full parallelization across different packages.
108
109                   Note that disabling this may overcommit CPU resources depending on the
110                   -j level of the main make process, the number of package submake jobs
111                   selected below and the number of actual CPUs present.
112                   Example: If the main make is passed a -j4 and the submake -j
113                   is also set to 4, we may end up with 16 parallel make processes
114                   in the worst case.
115
116         config PKG_BUILD_JOBS
117                 int
118                 prompt "Number of package submake jobs (2-512)"
119                 range 2 512
120                 default 2
121                 depends on PKG_BUILD_PARALLEL && !PKG_BUILD_USE_JOBSERVER
122                 help
123                   The number of jobs (-jX) to pass to packages submake.
124
125         config PKG_DEFAULT_PARALLEL
126                 bool
127                 prompt "Parallelize the default package build rule (May break build)"
128                 depends on PKG_BUILD_PARALLEL
129                 depends on BROKEN
130                 default n
131                 help
132                   Always set the default package build rules to parallel build.
133
134                   WARNING: This may break build or kill your cat, as it builds packages
135                   with multiple jobs that are probably not tested in a parallel build
136                   environment.
137
138                   Only say Y if you don't mind fixing broken packages.  Before reporting
139                   build bugs, set this to N and re-run the build.
140
141         comment "Stripping options"
142
143         choice
144                 prompt "Binary stripping method"
145                 default USE_STRIP   if EXTERNAL_TOOLCHAIN
146                 default USE_STRIP   if USE_GLIBC || USE_EGLIBC || USE_MUSL
147                 default USE_SSTRIP
148                 help
149                   Select the binary stripping method you wish to use.
150
151                 config NO_STRIP
152                         bool "none"
153                         help
154                           This will install unstripped binaries (useful for native
155                           compiling/debugging).
156
157                 config USE_STRIP
158                         bool "strip"
159                         help
160                           This will install binaries stripped using strip from binutils.
161
162
163                 config USE_SSTRIP
164                         bool "sstrip"
165                         depends on !DEBUG
166                         depends on !USE_GLIBC
167                         depends on !USE_EGLIBC
168                         help
169                           This will install binaries stripped using sstrip.
170         endchoice
171
172         config STRIP_ARGS
173                 string
174                 prompt "Strip arguments"
175                 depends on USE_STRIP
176                 default "--strip-unneeded --remove-section=.comment --remove-section=.note" if DEBUG
177                 default "--strip-all"
178                 help
179                   Specifies arguments passed to the strip command when stripping binaries.
180
181         config STRIP_KERNEL_EXPORTS
182                 bool "Strip unnecessary exports from the kernel image"
183                 help
184                   Reduces kernel size by stripping unused kernel exports from the kernel
185                   image.  Note that this might make the kernel incompatible with any kernel
186                   modules that were not selected at the time the kernel image was created.
187
188         config USE_MKLIBS
189                 bool "Strip unnecessary functions from libraries"
190                 help
191                   Reduces libraries to only those functions that are necessary for using all
192                   selected packages (including those selected as <M>).  Note that this will
193                   make the system libraries incompatible with most of the packages that are
194                   not selected during the build process.
195
196         choice
197                 prompt "Preferred standard C++ library"
198                 default USE_LIBSTDCXX if USE_EGLIBC
199                 default USE_UCLIBCXX
200                 help
201                   Select the preferred standard C++ library for all packages that support this.
202
203                 config USE_UCLIBCXX
204                         bool "uClibc++"
205
206                 config USE_LIBSTDCXX
207                         bool "libstdc++"
208         endchoice
209
210         comment "Hardening build options"
211
212         config PKG_CHECK_FORMAT_SECURITY
213                 bool
214                 prompt "Enable gcc format-security"
215                 default n
216                 help
217                   Add -Wformat -Werror=format-security to the CFLAGS.  You can disable
218                   this per package by adding PKG_CHECK_FORMAT_SECURITY:=0 in the package
219                   Makefile.
220
221         choice
222                 prompt "User space Stack-Smashing Protection"
223                 default PKG_CC_STACKPROTECTOR_NONE
224                 help
225                   Enable GCC Stack Smashing Protection (SSP) for userspace applications
226                 config PKG_CC_STACKPROTECTOR_NONE
227                         bool "None"
228                 config PKG_CC_STACKPROTECTOR_REGULAR
229                         bool "Regular"
230                         select SSP_SUPPORT
231                         depends on KERNEL_CC_STACKPROTECTOR_REGULAR
232                 config PKG_CC_STACKPROTECTOR_STRONG
233                         bool "Strong"
234                         select SSP_SUPPORT
235                         depends on GCC_VERSION_4_9_LINARO
236                         depends on KERNEL_CC_STACKPROTECTOR_STRONG
237         endchoice
238
239         choice
240                 prompt "Kernel space Stack-Smashing Protection"
241                 default KERNEL_CC_STACKPROTECTOR_NONE
242                 help
243                   Enable GCC Stack-Smashing Protection (SSP) for the kernel
244                 config KERNEL_CC_STACKPROTECTOR_NONE
245                         bool "None"
246                 config KERNEL_CC_STACKPROTECTOR_REGULAR
247                         bool "Regular"
248                 config KERNEL_CC_STACKPROTECTOR_STRONG
249                         depends on GCC_VERSION_4_9_LINARO
250                         bool "Strong"
251         endchoice
252
253         choice
254                 prompt "Enable buffer-overflows detction (FORTIFY_SOURCE)"
255                 help
256                   Enable the _FORTIFY_SOURCE macro which introduces additional
257                   checks to detect buffer-overflows in the following standard library
258                   functions: memcpy, mempcpy, memmove, memset, strcpy, stpcpy,
259                   strncpy, strcat, strncat, sprintf, vsprintf, snprintf, vsnprintf,
260                   gets.  "Conservative" (_FORTIFY_SOURCE set to 1) only introduces
261                   checks that sholdn't change the behavior of conforming programs,
262                   while "aggressive" (_FORTIFY_SOURCES set to 2) some more checking is
263                   added, but some conforming programs might fail.
264                 config PKG_FORTIFY_SOURCE_NONE
265                         bool "None"
266                 config PKG_FORTIFY_SOURCE_1
267                         bool "Conservative"
268                 config PKG_FORTIFY_SOURCE_2
269                         bool "Aggressive"
270         endchoice
271
272         choice
273                 prompt "Enable RELRO protection"
274                 help
275                   Enable a link-time protection know as RELRO (Relocation Read Only)
276                   which helps to protect from certain type of exploitation techniques
277                   altering the content of some ELF sections. "Partial" RELRO makes the
278                   .dynamic section not writeable after initialization, introducing
279                   almost no performance penalty, while "full" RELRO also marks the GOT
280                   as read-only at the cost of initializing all of it at startup.
281                 config PKG_RELRO_NONE
282                         bool "None"
283                 config PKG_RELRO_PARTIAL
284                         bool "Partial"
285                 config PKG_RELRO_FULL
286                         bool "Full"
287         endchoice
288
289 endmenu