docs/manual: document the br2-external desc: field
[buildroot-gz.git] / package / Makefile.in
blob5d591e9a43aa452a53531b0f708f3bcde2c3c9d8
1 ifndef MAKE
2 MAKE := make
3 endif
4 ifndef HOSTMAKE
5 HOSTMAKE = $(MAKE)
6 endif
7 HOSTMAKE := $(shell which $(HOSTMAKE) || type -p $(HOSTMAKE) || echo make)
9 # If BR2_JLEVEL is 0, scale the maximum concurrency with the number of
10 # CPUs. An additional job is used in order to keep processors busy
11 # while waiting on I/O.
12 # If the number of processors is not available, assume one.
13 ifeq ($(BR2_JLEVEL),0)
14 PARALLEL_JOBS := $(shell echo \
15 $$((1 + `getconf _NPROCESSORS_ONLN 2>/dev/null || echo 1`)))
16 else
17 PARALLEL_JOBS := $(BR2_JLEVEL)
18 endif
20 MAKE1 := $(HOSTMAKE) -j1
21 override MAKE = $(HOSTMAKE) \
22 $(if $(findstring j,$(filter-out --%,$(MAKEFLAGS))),,-j$(PARALLEL_JOBS))
24 ifeq ($(BR2_TOOLCHAIN_BUILDROOT),y)
25 TARGET_VENDOR = $(call qstrip,$(BR2_TOOLCHAIN_BUILDROOT_VENDOR))
26 else
27 TARGET_VENDOR = buildroot
28 endif
30 # Sanity checks
31 ifeq ($(TARGET_VENDOR),)
32 $(error BR2_TOOLCHAIN_BUILDROOT_VENDOR is not allowed to be empty)
33 endif
34 ifeq ($(TARGET_VENDOR),unknown)
35 $(error BR2_TOOLCHAIN_BUILDROOT_VENDOR cannot be 'unknown'. \
36 It might be confused with the native toolchain)
37 endif
39 # Compute GNU_TARGET_NAME
40 GNU_TARGET_NAME = $(ARCH)-$(TARGET_VENDOR)-$(TARGET_OS)-$(LIBC)$(ABI)
42 # FLAT binary format needs uclinux
43 ifeq ($(BR2_BINFMT_FLAT),y)
44 TARGET_OS = uclinux
45 else
46 TARGET_OS = linux
47 endif
49 ifeq ($(BR2_TOOLCHAIN_USES_UCLIBC),y)
50 LIBC = uclibc
51 else ifeq ($(BR2_TOOLCHAIN_USES_MUSL),y)
52 LIBC = musl
53 else
54 LIBC = gnu
55 endif
57 # The ABI suffix is a bit special on ARM, as it needs to be
58 # -uclibcgnueabi for uClibc EABI, and -gnueabi for glibc EABI.
59 # This means that the LIBC and ABI aren't strictly orthogonal,
60 # which explains why we need the test on LIBC below.
61 ifeq ($(BR2_arm)$(BR2_armeb),y)
62 ifeq ($(LIBC),uclibc)
63 ABI = gnueabi
64 else
65 ABI = eabi
66 endif
68 ifeq ($(BR2_ARM_EABIHF),y)
69 ABI := $(ABI)hf
70 endif
71 endif
73 # For FSL PowerPC there's SPE
74 ifeq ($(BR2_powerpc_SPE),y)
75 ABI = spe
76 # MPC8540s are e500v1 with single precision FP
77 ifeq ($(BR2_powerpc_8540),y)
78 TARGET_ABI += -mabi=spe -mfloat-gprs=single -Wa,-me500
79 endif
80 ifeq ($(BR2_powerpc_8548),y)
81 TARGET_ABI += -mabi=spe -mfloat-gprs=double -Wa,-me500x2
82 endif
83 ifeq ($(BR2_powerpc_e500mc),y)
84 TARGET_ABI += -mabi=spe -mfloat-gprs=double -Wa,-me500mc
85 endif
86 endif
88 # Use longcalls option for Xtensa globally.
89 # The 'longcalls' option allows calls across a greater range of addresses,
90 # and is required for some packages. While this option can degrade both
91 # code size and performance, the linker can usually optimize away the
92 # overhead when a call ends up within a certain range.
94 # Use auto-litpools for Xtensa globally.
95 # Collecting literals into separate section can be advantageous if that
96 # section is placed into DTCM at link time. This is applicable for code
97 # running on bare metal, but makes no sense under linux, where userspace
98 # is isolated from the physical memory details. OTOH placing literals into
99 # separate section breaks build of huge source files, because l32r
100 # instruction can only access literals in 256 KBytes range.
102 ifeq ($(BR2_xtensa),y)
103 TARGET_ABI += -mlongcalls -mauto-litpools
104 endif
106 ifeq ($(BR2_arc)$(BR2_ARC_ATOMIC_EXT),yy)
107 TARGET_ABI += -matomic
108 endif
110 STAGING_SUBDIR = usr/$(GNU_TARGET_NAME)/sysroot
111 STAGING_DIR = $(HOST_DIR)/$(STAGING_SUBDIR)
113 ifeq ($(BR2_OPTIMIZE_0),y)
114 TARGET_OPTIMIZATION = -O0
115 endif
116 ifeq ($(BR2_OPTIMIZE_1),y)
117 TARGET_OPTIMIZATION = -O1
118 endif
119 ifeq ($(BR2_OPTIMIZE_2),y)
120 TARGET_OPTIMIZATION = -O2
121 endif
122 ifeq ($(BR2_OPTIMIZE_3),y)
123 TARGET_OPTIMIZATION = -O3
124 endif
125 ifeq ($(BR2_OPTIMIZE_G),y)
126 TARGET_OPTIMIZATION = -Og
127 endif
128 ifeq ($(BR2_OPTIMIZE_S),y)
129 TARGET_OPTIMIZATION = -Os
130 endif
131 ifeq ($(BR2_DEBUG_1),y)
132 TARGET_DEBUGGING = -g1
133 endif
134 ifeq ($(BR2_DEBUG_2),y)
135 TARGET_DEBUGGING = -g2
136 endif
137 ifeq ($(BR2_DEBUG_3),y)
138 TARGET_DEBUGGING = -g3
139 endif
141 TARGET_CPPFLAGS += -D_LARGEFILE_SOURCE -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64
142 TARGET_CFLAGS = $(TARGET_CPPFLAGS) $(TARGET_ABI) $(TARGET_OPTIMIZATION) $(TARGET_DEBUGGING)
143 TARGET_CXXFLAGS = $(TARGET_CFLAGS)
144 TARGET_FCFLAGS = $(TARGET_ABI) $(TARGET_OPTIMIZATION) $(TARGET_DEBUGGING)
145 TARGET_LDFLAGS = $(call qstrip,$(BR2_TARGET_LDFLAGS))
147 ifeq ($(BR2_BINFMT_FLAT),y)
148 TARGET_CFLAGS += $(if $($(PKG)_FLAT_STACKSIZE),-Wl$(comma)-elf2flt=-s$($(PKG)_FLAT_STACKSIZE),\
149 -Wl$(comma)-elf2flt)
150 TARGET_CXXFLAGS += $(if $($(PKG)_FLAT_STACKSIZE),-Wl$(comma)-elf2flt=-s$($(PKG)_FLAT_STACKSIZE),\
151 -Wl$(comma)-elf2flt)
152 TARGET_FCFLAGS += $(if $($(PKG)_FLAT_STACKSIZE),-Wl$(comma)-elf2flt=-s$($(PKG)_FLAT_STACKSIZE),\
153 -Wl$(comma)-elf2flt)
154 TARGET_LDFLAGS += $(if $($(PKG)_FLAT_STACKSIZE),-Wl$(comma)-elf2flt=-s$($(PKG)_FLAT_STACKSIZE),-Wl$(comma)-elf2flt)
155 endif
157 ifeq ($(BR2_BINFMT_FLAT_SHARED),y)
158 TARGET_LDFLAGS += -mid-shared-library -mshared-library-id=0
159 TARGET_CFLAGS += -mid-shared-library -mshared-library-id=0
160 TARGET_FCFLAGS += -mid-shared-library -mshared-library-id=0
161 TARGET_CXXFLAGS += -mid-shared-library -mshared-library-id=0
162 endif
163 ifeq ($(BR2_BINFMT_FLAT_SEP_DATA),y)
164 TARGET_LDFLAGS += -msep-data
165 TARGET_CFLAGS += -msep-data
166 TARGET_FCFLAGS += -msep-data
167 TARGET_CXXFLAGS += -msep-data
168 endif
170 ifeq ($(BR2_SSP_REGULAR),y)
171 TARGET_CFLAGS += -fstack-protector
172 TARGET_CXXFLAGS += -fstack-protector
173 TARGET_FCFLAGS += -fstack-protector
174 else ifeq ($(BR2_SSP_STRONG),y)
175 TARGET_CFLAGS += -fstack-protector-strong
176 TARGET_CXXFLAGS += -fstack-protector-strong
177 TARGET_FCFLAGS += -fstack-protector-strong
178 else ifeq ($(BR2_SSP_ALL),y)
179 TARGET_CFLAGS += -fstack-protector-all
180 TARGET_CXXFLAGS += -fstack-protector-all
181 TARGET_FCFLAGS += -fstack-protector-all
182 endif
184 ifeq ($(BR2_TOOLCHAIN_BUILDROOT),y)
185 TARGET_CROSS = $(HOST_DIR)/usr/bin/$(GNU_TARGET_NAME)-
186 else
187 TARGET_CROSS = $(HOST_DIR)/usr/bin/$(call qstrip,$(BR2_TOOLCHAIN_EXTERNAL_PREFIX))-
188 endif
190 # Define TARGET_xx variables for all common binutils/gcc
191 TARGET_AR = $(TARGET_CROSS)ar
192 TARGET_AS = $(TARGET_CROSS)as
193 TARGET_CC = $(TARGET_CROSS)gcc
194 TARGET_CPP = $(TARGET_CROSS)cpp
195 TARGET_CXX = $(TARGET_CROSS)g++
196 TARGET_FC = $(TARGET_CROSS)gfortran
197 TARGET_LD = $(TARGET_CROSS)ld
198 TARGET_NM = $(TARGET_CROSS)nm
199 TARGET_RANLIB = $(TARGET_CROSS)ranlib
200 TARGET_READELF = $(TARGET_CROSS)readelf
201 TARGET_OBJCOPY = $(TARGET_CROSS)objcopy
202 TARGET_OBJDUMP = $(TARGET_CROSS)objdump
204 ifeq ($(BR2_STRIP_strip),y)
205 STRIP_STRIP_DEBUG := --strip-debug
206 TARGET_STRIP = $(TARGET_CROSS)strip
207 STRIPCMD = $(TARGET_CROSS)strip --remove-section=.comment --remove-section=.note
208 endif
209 ifeq ($(BR2_STRIP_none),y)
210 TARGET_STRIP = true
211 STRIPCMD = $(TARGET_STRIP)
212 endif
213 INSTALL := $(shell which install || type -p install)
214 FLEX := $(shell which flex || type -p flex)
215 BISON := $(shell which bison || type -p bison)
216 SED := $(shell which sed || type -p sed) -i -e
217 UNZIP := $(shell which unzip || type -p unzip) -q
219 APPLY_PATCHES = support/scripts/apply-patches.sh $(if $(QUIET),-s)
221 HOST_CPPFLAGS = -I$(HOST_DIR)/usr/include
222 HOST_CFLAGS ?= -O2
223 HOST_CFLAGS += $(HOST_CPPFLAGS)
224 HOST_CXXFLAGS += $(HOST_CFLAGS)
225 HOST_LDFLAGS += -L$(HOST_DIR)/lib -L$(HOST_DIR)/usr/lib -Wl,-rpath,$(HOST_DIR)/usr/lib
227 # host-intltool should be executed with the system perl, so we save
228 # the path to the system perl, before a host-perl built by Buildroot
229 # might get installed into $(HOST_DIR)/usr/bin and therefore appears
230 # in our PATH. This system perl will be used as INTLTOOL_PERL.
231 export PERL=$(shell which perl)
233 # host-intltool needs libxml-parser-perl, which Buildroot installs in
234 # $(HOST_DIR)/usr/lib/perl, so we must make sure that the system perl
235 # finds this perl module by exporting the proper value for PERL5LIB.
236 export PERL5LIB=$(HOST_DIR)/usr/lib/perl
238 TARGET_MAKE_ENV = PATH=$(BR_PATH)
240 TARGET_CONFIGURE_OPTS = \
241 $(TARGET_MAKE_ENV) \
242 AR="$(TARGET_AR)" \
243 AS="$(TARGET_AS)" \
244 LD="$(TARGET_LD)" \
245 NM="$(TARGET_NM)" \
246 CC="$(TARGET_CC)" \
247 GCC="$(TARGET_CC)" \
248 CPP="$(TARGET_CPP)" \
249 CXX="$(TARGET_CXX)" \
250 FC="$(TARGET_FC)" \
251 F77="$(TARGET_FC)" \
252 RANLIB="$(TARGET_RANLIB)" \
253 READELF="$(TARGET_READELF)" \
254 STRIP="$(TARGET_STRIP)" \
255 OBJCOPY="$(TARGET_OBJCOPY)" \
256 OBJDUMP="$(TARGET_OBJDUMP)" \
257 AR_FOR_BUILD="$(HOSTAR)" \
258 AS_FOR_BUILD="$(HOSTAS)" \
259 CC_FOR_BUILD="$(HOSTCC)" \
260 GCC_FOR_BUILD="$(HOSTCC)" \
261 CXX_FOR_BUILD="$(HOSTCXX)" \
262 LD_FOR_BUILD="$(HOSTLD)" \
263 CPPFLAGS_FOR_BUILD="$(HOST_CPPFLAGS)" \
264 CFLAGS_FOR_BUILD="$(HOST_CFLAGS)" \
265 CXXFLAGS_FOR_BUILD="$(HOST_CXXFLAGS)" \
266 LDFLAGS_FOR_BUILD="$(HOST_LDFLAGS)" \
267 FCFLAGS_FOR_BUILD="$(HOST_FCFLAGS)" \
268 DEFAULT_ASSEMBLER="$(TARGET_AS)" \
269 DEFAULT_LINKER="$(TARGET_LD)" \
270 CPPFLAGS="$(TARGET_CPPFLAGS)" \
271 CFLAGS="$(TARGET_CFLAGS)" \
272 CXXFLAGS="$(TARGET_CXXFLAGS)" \
273 LDFLAGS="$(TARGET_LDFLAGS)" \
274 FCFLAGS="$(TARGET_FCFLAGS)" \
275 FFLAGS="$(TARGET_FCFLAGS)" \
276 PKG_CONFIG="$(PKG_CONFIG_HOST_BINARY)" \
277 STAGING_DIR="$(STAGING_DIR)" \
278 INTLTOOL_PERL=$(PERL)
281 HOST_MAKE_ENV = \
282 PATH=$(BR_PATH) \
283 PKG_CONFIG="$(PKG_CONFIG_HOST_BINARY)" \
284 PKG_CONFIG_SYSROOT_DIR="/" \
285 PKG_CONFIG_ALLOW_SYSTEM_CFLAGS=1 \
286 PKG_CONFIG_ALLOW_SYSTEM_LIBS=1 \
287 PKG_CONFIG_LIBDIR="$(HOST_DIR)/usr/lib/pkgconfig:$(HOST_DIR)/usr/share/pkgconfig"
289 HOST_CONFIGURE_OPTS = \
290 $(HOST_MAKE_ENV) \
291 AR="$(HOSTAR)" \
292 AS="$(HOSTAS)" \
293 LD="$(HOSTLD)" \
294 NM="$(HOSTNM)" \
295 CC="$(HOSTCC)" \
296 GCC="$(HOSTCC)" \
297 CXX="$(HOSTCXX)" \
298 CPP="$(HOSTCPP)" \
299 OBJCOPY="$(HOSTOBJCOPY)" \
300 RANLIB="$(HOSTRANLIB)" \
301 CPPFLAGS="$(HOST_CPPFLAGS)" \
302 CFLAGS="$(HOST_CFLAGS)" \
303 CXXFLAGS="$(HOST_CXXFLAGS)" \
304 LDFLAGS="$(HOST_LDFLAGS)" \
305 INTLTOOL_PERL=$(PERL)
307 # This is extra environment we can not export ourselves (eg. because some
308 # packages use that variable internally, eg. uboot), so we have to
309 # explicitly pass it to user-supplied external hooks (eg. post-build,
310 # post-images)
311 EXTRA_ENV = \
312 PATH=$(BR_PATH) \
313 BR2_DL_DIR=$(BR2_DL_DIR) \
314 BUILD_DIR=$(BUILD_DIR)
316 ################################################################################
317 # settings we need to pass to configure
319 # does unaligned access trap?
320 BR2_AC_CV_TRAP_CHECK = ac_cv_lbl_unaligned_fail=yes
321 ifeq ($(BR2_i386),y)
322 BR2_AC_CV_TRAP_CHECK = ac_cv_lbl_unaligned_fail=no
323 endif
324 ifeq ($(BR2_x86_64),y)
325 BR2_AC_CV_TRAP_CHECK = ac_cv_lbl_unaligned_fail=no
326 endif
327 ifeq ($(BR2_m68k),y)
328 BR2_AC_CV_TRAP_CHECK = ac_cv_lbl_unaligned_fail=no
329 endif
330 ifeq ($(BR2_powerpc)$(BR2_powerpc64)$(BR2_powerpc64le),y)
331 BR2_AC_CV_TRAP_CHECK = ac_cv_lbl_unaligned_fail=no
332 endif
334 ifeq ($(BR2_ENDIAN),"BIG")
335 BR2_AC_CV_C_BIGENDIAN = ac_cv_c_bigendian=yes
336 else
337 BR2_AC_CV_C_BIGENDIAN = ac_cv_c_bigendian=no
338 endif
340 # AM_GNU_GETTEXT misdetects musl gettext support.
341 # musl currently implements api level 1 and 2 (basic + ngettext)
342 # http://www.openwall.com/lists/musl/2015/04/16/3
343 ifeq ($(BR2_TOOLCHAIN_USES_MUSL),y)
344 BR2_GT_CV_FUNC_GNUGETTEXT_LIBC = \
345 gt_cv_func_gnugettext1_libc=yes \
346 gt_cv_func_gnugettext2_libc=yes
347 endif
349 TARGET_CONFIGURE_ARGS = \
350 $(BR2_AC_CV_TRAP_CHECK) \
351 ac_cv_func_mmap_fixed_mapped=yes \
352 ac_cv_func_memcmp_working=yes \
353 ac_cv_have_decl_malloc=yes \
354 gl_cv_func_malloc_0_nonnull=yes \
355 ac_cv_func_malloc_0_nonnull=yes \
356 ac_cv_func_calloc_0_nonnull=yes \
357 ac_cv_func_realloc_0_nonnull=yes \
358 lt_cv_sys_lib_search_path_spec="" \
359 $(BR2_AC_CV_C_BIGENDIAN) \
360 $(BR2_GT_CV_FUNC_GNUGETTEXT_LIBC)
362 ################################################################################
364 ifeq ($(BR2_ENABLE_LOCALE),y)
365 DISABLE_NLS :=
366 else
367 DISABLE_NLS :=--disable-nls
368 endif
370 ifneq ($(BR2_INSTALL_LIBSTDCPP),y)
371 TARGET_CONFIGURE_OPTS += CXX=false
372 endif
374 ifeq ($(BR2_STATIC_LIBS),y)
375 SHARED_STATIC_LIBS_OPTS = --enable-static --disable-shared
376 TARGET_CFLAGS += -static
377 TARGET_CXXFLAGS += -static
378 TARGET_FCFLAGS += -static
379 TARGET_LDFLAGS += -static
380 else ifeq ($(BR2_SHARED_LIBS),y)
381 SHARED_STATIC_LIBS_OPTS = --disable-static --enable-shared
382 else ifeq ($(BR2_SHARED_STATIC_LIBS),y)
383 SHARED_STATIC_LIBS_OPTS = --enable-static --enable-shared
384 endif
386 ifeq ($(BR2_COMPILER_PARANOID_UNSAFE_PATH),y)
387 export BR_COMPILER_PARANOID_UNSAFE_PATH=enabled
388 endif
390 include package/pkg-download.mk
391 include package/pkg-autotools.mk
392 include package/pkg-cmake.mk
393 include package/pkg-luarocks.mk
394 include package/pkg-perl.mk
395 include package/pkg-python.mk
396 include package/pkg-virtual.mk
397 include package/pkg-generic.mk
398 include package/pkg-kconfig.mk
399 include package/pkg-rebar.mk
400 include package/pkg-kernel-module.mk