Makefile.build 19.2 KB
Newer Older
1
# SPDX-License-Identifier: GPL-2.0
L
Linus Torvalds 已提交
2 3 4 5 6 7
# ==========================================================================
# Building
# ==========================================================================

src := $(obj)

8
PHONY := __build
L
Linus Torvalds 已提交
9 10
__build:

11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
# Init all relevant variables used in kbuild files so
# 1) they have correct type
# 2) they do not inherit any value from the environment
obj-y :=
obj-m :=
lib-y :=
lib-m :=
always :=
targets :=
subdir-y :=
subdir-m :=
EXTRA_AFLAGS   :=
EXTRA_CFLAGS   :=
EXTRA_CPPFLAGS :=
EXTRA_LDFLAGS  :=
26 27 28 29
asflags-y  :=
ccflags-y  :=
cppflags-y :=
ldflags-y  :=
30

31 32 33
subdir-asflags-y :=
subdir-ccflags-y :=

R
Robert P. J. Day 已提交
34
# Read auto.conf if it exists, otherwise ignore
R
Roman Zippel 已提交
35
-include include/config/auto.conf
L
Linus Torvalds 已提交
36

37 38
include scripts/Kbuild.include

R
Robert P. J. Day 已提交
39
# For backward compatibility check that these variables do not change
40 41
save-cflags := $(CFLAGS)

S
Sam Ravnborg 已提交
42
# The filename Kbuild has precedence over Makefile
43
kbuild-dir := $(if $(filter /%,$(src)),$(src),$(srctree)/$(src))
44 45 46 47 48 49
kbuild-file := $(if $(wildcard $(kbuild-dir)/Kbuild),$(kbuild-dir)/Kbuild,$(kbuild-dir)/Makefile)
include $(kbuild-file)

# If the save-* variables changed error out
ifeq ($(KBUILD_NOPEDANTIC),)
        ifneq ("$(save-cflags)","$(CFLAGS)")
50
                $(error CFLAGS was changed in "$(kbuild-file)". Fix it to use ccflags-y)
51 52
        endif
endif
B
Borislav Petkov 已提交
53

L
Linus Torvalds 已提交
54 55 56 57 58 59 60 61 62
include scripts/Makefile.lib

ifdef host-progs
ifneq ($(hostprogs-y),$(host-progs))
$(warning kbuild: $(obj)/Makefile - Usage of host-progs is deprecated. Please replace with hostprogs-y!)
hostprogs-y += $(host-progs)
endif
endif

R
Robert P. J. Day 已提交
63
# Do not include host rules unless needed
E
Emese Revfy 已提交
64
ifneq ($(hostprogs-y)$(hostprogs-m)$(hostlibs-y)$(hostlibs-m)$(hostcxxlibs-y)$(hostcxxlibs-m),)
L
Linus Torvalds 已提交
65 66 67 68 69 70 71 72 73
include scripts/Makefile.host
endif

ifndef obj
$(warning kbuild: Makefile.build is included improperly)
endif

# ===========================================================================

74
ifneq ($(strip $(lib-y) $(lib-m) $(lib-)),)
L
Linus Torvalds 已提交
75
lib-target := $(obj)/lib.a
76
real-obj-y += $(obj)/lib-ksyms.o
L
Linus Torvalds 已提交
77 78
endif

79
ifneq ($(strip $(real-obj-y) $(need-builtin)),)
80
builtin-target := $(obj)/built-in.a
L
Linus Torvalds 已提交
81 82
endif

T
Tejun Heo 已提交
83 84
modorder-target := $(obj)/modules.order

L
Linus Torvalds 已提交
85 86 87
# We keep a list of all modules in $(MODVERDIR)

__build: $(if $(KBUILD_BUILTIN),$(builtin-target) $(lib-target) $(extra-y)) \
T
Tejun Heo 已提交
88
	 $(if $(KBUILD_MODULES),$(obj-m) $(modorder-target)) \
L
Linus Torvalds 已提交
89 90 91 92 93 94 95 96 97 98 99 100 101 102
	 $(subdir-ym) $(always)
	@:

# Linus' kernel sanity checking tool
ifneq ($(KBUILD_CHECKSRC),0)
  ifeq ($(KBUILD_CHECKSRC),2)
    quiet_cmd_force_checksrc = CHECK   $<
          cmd_force_checksrc = $(CHECK) $(CHECKFLAGS) $(c_flags) $< ;
  else
      quiet_cmd_checksrc     = CHECK   $<
            cmd_checksrc     = $(CHECK) $(CHECKFLAGS) $(c_flags) $< ;
  endif
endif

103 104 105 106
ifneq ($(KBUILD_ENABLE_EXTRA_GCC_CHECKS),)
  cmd_checkdoc = $(srctree)/scripts/kernel-doc -none $< ;
endif

107
# Do section mismatch analysis for each module/built-in.a
108 109 110
ifdef CONFIG_DEBUG_SECTION_MISMATCH
  cmd_secanalysis = ; scripts/mod/modpost $@
endif
L
Linus Torvalds 已提交
111 112 113 114 115

# Compile C sources (.c)
# ---------------------------------------------------------------------------

# Default is built-in, unless we know otherwise
116 117 118
modkern_cflags =                                          \
	$(if $(part-of-module),                           \
		$(KBUILD_CFLAGS_MODULE) $(CFLAGS_MODULE), \
119
		$(KBUILD_CFLAGS_KERNEL) $(CFLAGS_KERNEL))
L
Linus Torvalds 已提交
120 121
quiet_modtag := $(empty)   $(empty)

122 123 124 125
$(real-obj-m)        : part-of-module := y
$(real-obj-m:.o=.i)  : part-of-module := y
$(real-obj-m:.o=.s)  : part-of-module := y
$(real-obj-m:.o=.lst): part-of-module := y
L
Linus Torvalds 已提交
126

127 128 129 130
$(real-obj-m)        : quiet_modtag := [M]
$(real-obj-m:.o=.i)  : quiet_modtag := [M]
$(real-obj-m:.o=.s)  : quiet_modtag := [M]
$(real-obj-m:.o=.lst): quiet_modtag := [M]
L
Linus Torvalds 已提交
131

132
$(obj-m)             : quiet_modtag := [M]
L
Linus Torvalds 已提交
133 134

quiet_cmd_cc_s_c = CC $(quiet_modtag)  $@
135
cmd_cc_s_c       = $(CC) $(c_flags) $(DISABLE_LTO) -fverbose-asm -S -o $@ $<
L
Linus Torvalds 已提交
136

137
$(obj)/%.s: $(src)/%.c FORCE
L
Linus Torvalds 已提交
138 139
	$(call if_changed_dep,cc_s_c)

140 141
quiet_cmd_cpp_i_c = CPP $(quiet_modtag) $@
cmd_cpp_i_c       = $(CPP) $(c_flags) -o $@ $<
L
Linus Torvalds 已提交
142

143
$(obj)/%.i: $(src)/%.c FORCE
144
	$(call if_changed_dep,cpp_i_c)
L
Linus Torvalds 已提交
145

146 147
# These mirror gensymtypes_S and co below, keep them in synch.
cmd_gensymtypes_c =                                                         \
S
Sam Ravnborg 已提交
148
    $(CPP) -D__GENKSYMS__ $(c_flags) $< |                                   \
149
    $(GENKSYMS) $(if $(1), -T $(2))                                         \
150
     $(patsubst y,-R,$(CONFIG_MODULE_REL_CRCS))                             \
S
Sam Ravnborg 已提交
151
     $(if $(KBUILD_PRESERVE),-p)                                            \
152
     -r $(firstword $(wildcard $(2:.symtypes=.symref) /dev/null))
S
Sam Ravnborg 已提交
153

154
quiet_cmd_cc_symtypes_c = SYM $(quiet_modtag) $@
S
Sam Ravnborg 已提交
155 156
cmd_cc_symtypes_c =                                                         \
    set -e;                                                                 \
157
    $(call cmd_gensymtypes_c,true,$@) >/dev/null;                           \
S
Sam Ravnborg 已提交
158
    test -s $@ || rm -f $@
159

160
$(obj)/%.symtypes : $(src)/%.c FORCE
161
	$(call cmd,cc_symtypes_c)
162

163 164 165 166 167 168 169 170
# LLVM assembly
# Generate .ll files from .c
quiet_cmd_cc_ll_c = CC $(quiet_modtag)  $@
      cmd_cc_ll_c = $(CC) $(c_flags) -emit-llvm -S -o $@ $<

$(obj)/%.ll: $(src)/%.c FORCE
	$(call if_changed_dep,cc_ll_c)

L
Linus Torvalds 已提交
171 172 173 174 175 176 177 178 179 180 181
# C (.c) files
# The C file is compiled and updated dependency information is generated.
# (See cmd_cc_o_c + relevant part of rule_cc_o_c)

quiet_cmd_cc_o_c = CC $(quiet_modtag)  $@

ifndef CONFIG_MODVERSIONS
cmd_cc_o_c = $(CC) $(c_flags) -c -o $@ $<

else
# When module versioning is enabled the following steps are executed:
182 183 184
# o compile a .tmp_<file>.o from <file>.c
# o if .tmp_<file>.o doesn't contain a __ksymtab version, i.e. does
#   not export symbols, we just rename .tmp_<file>.o to <file>.o and
L
Linus Torvalds 已提交
185 186 187
#   are done.
# o otherwise, we calculate symbol versions using the good old
#   genksyms on the preprocessed source and postprocess them in a way
188 189 190 191
#   that they are usable as a linker script
# o generate <file>.o from .tmp_<file>.o using the linker to
#   replace the unresolved symbols __crc_exported_symbol with
#   the actual value of the checksum generated by genksyms
L
Linus Torvalds 已提交
192

193
cmd_cc_o_c = $(CC) $(c_flags) -c -o $(@D)/.tmp_$(@F) $<
194 195

cmd_modversions_c =								\
196
	if $(OBJDUMP) -h $(@D)/.tmp_$(@F) | grep -q __ksymtab; then		\
197
		$(call cmd_gensymtypes_c,$(KBUILD_SYMTYPES),$(@:.o=.symtypes))	\
198 199 200 201 202 203 204
		    > $(@D)/.tmp_$(@F:.o=.ver);					\
										\
		$(LD) $(LDFLAGS) -r -o $@ $(@D)/.tmp_$(@F) 			\
			-T $(@D)/.tmp_$(@F:.o=.ver);				\
		rm -f $(@D)/.tmp_$(@F) $(@D)/.tmp_$(@F:.o=.ver);		\
	else									\
		mv -f $(@D)/.tmp_$(@F) $@;					\
L
Linus Torvalds 已提交
205 206 207
	fi;
endif

208
ifdef CONFIG_FTRACE_MCOUNT_RECORD
209
ifdef BUILD_C_RECORDMCOUNT
210 211 212
ifeq ("$(origin RECORDMCOUNT_WARN)", "command line")
  RECORDMCOUNT_FLAGS = -w
endif
213 214
# Due to recursion, we must skip empty.o.
# The empty.o file is created in the make process in order to determine
215 216
# the target endianness and word size. It is made before all other C
# files, including recordmcount.
W
Wu Zhangjin 已提交
217 218
sub_cmd_record_mcount =					\
	if [ $(@) != "scripts/mod/empty.o" ]; then	\
219
		$(objtree)/scripts/recordmcount $(RECORDMCOUNT_FLAGS) "$(@)";	\
W
Wu Zhangjin 已提交
220
	fi;
221 222
recordmcount_source := $(srctree)/scripts/recordmcount.c \
		    $(srctree)/scripts/recordmcount.h
223
else
W
Wu Zhangjin 已提交
224
sub_cmd_record_mcount = set -e ; perl $(srctree)/scripts/recordmcount.pl "$(ARCH)" \
225
	"$(if $(CONFIG_CPU_BIG_ENDIAN),big,little)" \
226
	"$(if $(CONFIG_64BIT),64,32)" \
227 228
	"$(OBJDUMP)" "$(OBJCOPY)" "$(CC) $(KBUILD_CFLAGS)" \
	"$(LD)" "$(NM)" "$(RM)" "$(MV)" \
229
	"$(if $(part-of-module),1,0)" "$(@)";
230
recordmcount_source := $(srctree)/scripts/recordmcount.pl
231
endif # BUILD_C_RECORDMCOUNT
232 233 234
cmd_record_mcount =						\
	if [ "$(findstring $(CC_FLAGS_FTRACE),$(_c_flags))" =	\
	     "$(CC_FLAGS_FTRACE)" ]; then			\
W
Wu Zhangjin 已提交
235 236
		$(sub_cmd_record_mcount)			\
	fi;
237
endif # CONFIG_FTRACE_MCOUNT_RECORD
238

239
ifdef CONFIG_STACK_VALIDATION
240
ifneq ($(SKIP_STACK_VALIDATION),1)
241 242 243

__objtool_obj := $(objtree)/tools/objtool/objtool

244
objtool_args = $(if $(CONFIG_UNWINDER_ORC),orc generate,check)
245

246 247
objtool_args += $(if $(part-of-module), --module,)

248 249 250
ifndef CONFIG_FRAME_POINTER
objtool_args += --no-fp
endif
251 252
ifdef CONFIG_GCOV_KERNEL
objtool_args += --no-unreachable
253 254
else
objtool_args += $(call cc-ifversion, -lt, 0405, --no-unreachable)
255
endif
256
ifdef CONFIG_RETPOLINE
257
ifneq ($(RETPOLINE_CFLAGS),)
258 259
  objtool_args += --retpoline
endif
260
endif
261

262

263 264 265 266 267 268
ifdef CONFIG_MODVERSIONS
objtool_o = $(@D)/.tmp_$(@F)
else
objtool_o = $(@)
endif

269 270 271 272 273
# 'OBJECT_FILES_NON_STANDARD := y': skip objtool checking for a directory
# 'OBJECT_FILES_NON_STANDARD_foo.o := 'y': skip objtool checking for a file
# 'OBJECT_FILES_NON_STANDARD_foo.o := 'n': override directory skip for a file
cmd_objtool = $(if $(patsubst y%,, \
	$(OBJECT_FILES_NON_STANDARD_$(basetarget).o)$(OBJECT_FILES_NON_STANDARD)n), \
274
	$(__objtool_obj) $(objtool_args) "$(objtool_o)";)
275 276 277 278
objtool_obj = $(if $(patsubst y%,, \
	$(OBJECT_FILES_NON_STANDARD_$(basetarget).o)$(OBJECT_FILES_NON_STANDARD)n), \
	$(__objtool_obj))

279
endif # SKIP_STACK_VALIDATION
280 281
endif # CONFIG_STACK_VALIDATION

282 283 284 285 286
# Rebuild all objects when objtool changes, or is enabled/disabled.
objtool_dep = $(objtool_obj)					\
	      $(wildcard include/config/orc/unwinder.h		\
			 include/config/stack/validation.h)

L
Linus Torvalds 已提交
287
define rule_cc_o_c
288
	$(call echo-cmd,checksrc) $(cmd_checksrc)			  \
289
	$(call cmd_and_fixdep,cc_o_c)					  \
290
	$(cmd_checkdoc)							  \
291
	$(call echo-cmd,objtool) $(cmd_objtool)				  \
292
	$(cmd_modversions_c)						  \
293
	$(call echo-cmd,record_mcount) $(cmd_record_mcount)
L
Linus Torvalds 已提交
294 295
endef

296
define rule_as_o_S
297
	$(call cmd_and_fixdep,as_o_S)					  \
298 299
	$(call echo-cmd,objtool) $(cmd_objtool)				  \
	$(cmd_modversions_S)
300 301
endef

302 303
# List module undefined symbols (or empty line if not enabled)
ifdef CONFIG_TRIM_UNUSED_KSYMS
304
cmd_undef_syms = $(NM) $@ | sed -n 's/^  *U //p' | xargs echo
305 306 307 308
else
cmd_undef_syms = echo
endif

L
Linus Torvalds 已提交
309
# Built-in and composite module parts
310
$(obj)/%.o: $(src)/%.c $(recordmcount_source) $(objtool_dep) FORCE
L
Linus Torvalds 已提交
311 312 313 314 315
	$(call cmd,force_checksrc)
	$(call if_changed_rule,cc_o_c)

# Single-part modules are special since we need to mark them in $(MODVERDIR)

316
$(single-used-m): $(obj)/%.o: $(src)/%.c $(recordmcount_source) $(objtool_dep) FORCE
L
Linus Torvalds 已提交
317 318
	$(call cmd,force_checksrc)
	$(call if_changed_rule,cc_o_c)
319 320
	@{ echo $(@:.o=.ko); echo $@; \
	   $(cmd_undef_syms); } > $(MODVERDIR)/$(@F:.o=.mod)
L
Linus Torvalds 已提交
321 322 323 324 325 326

quiet_cmd_cc_lst_c = MKLST   $@
      cmd_cc_lst_c = $(CC) $(c_flags) -g -c -o $*.o $< && \
		     $(CONFIG_SHELL) $(srctree)/scripts/makelst $*.o \
				     System.map $(OBJDUMP) > $@

327
$(obj)/%.lst: $(src)/%.c FORCE
L
Linus Torvalds 已提交
328 329 330 331 332
	$(call if_changed_dep,cc_lst_c)

# Compile assembler sources (.S)
# ---------------------------------------------------------------------------

333
modkern_aflags := $(KBUILD_AFLAGS_KERNEL) $(AFLAGS_KERNEL)
L
Linus Torvalds 已提交
334

335 336
$(real-obj-m)      : modkern_aflags := $(KBUILD_AFLAGS_MODULE) $(AFLAGS_MODULE)
$(real-obj-m:.o=.s): modkern_aflags := $(KBUILD_AFLAGS_MODULE) $(AFLAGS_MODULE)
L
Linus Torvalds 已提交
337

338 339 340 341 342 343 344 345 346 347 348 349 350 351 352
# .S file exports must have their C prototypes defined in asm/asm-prototypes.h
# or a file that it includes, in order to get versioned symbols. We build a
# dummy C file that includes asm-prototypes and the EXPORT_SYMBOL lines from
# the .S file (with trailing ';'), and run genksyms on that, to extract vers.
#
# This is convoluted. The .S file must first be preprocessed to run guards and
# expand names, then the resulting exports must be constructed into plain
# EXPORT_SYMBOL(symbol); to build our dummy C file, and that gets preprocessed
# to make the genksyms input.
#
# These mirror gensymtypes_c and co above, keep them in synch.
cmd_gensymtypes_S =                                                         \
    (echo "\#include <linux/kernel.h>" ;                                    \
     echo "\#include <asm/asm-prototypes.h>" ;                              \
    $(CPP) $(a_flags) $< |                                                  \
353 354
     grep "\<___EXPORT_SYMBOL\>" |                                          \
     sed 's/.*___EXPORT_SYMBOL[[:space:]]*\([a-zA-Z0-9_]*\)[[:space:]]*,.*/EXPORT_SYMBOL(\1);/' ) | \
355 356
    $(CPP) -D__GENKSYMS__ $(c_flags) -xc - |                                \
    $(GENKSYMS) $(if $(1), -T $(2))                                         \
357
     $(patsubst y,-R,$(CONFIG_MODULE_REL_CRCS))                             \
358 359 360 361 362 363 364 365 366 367 368 369 370
     $(if $(KBUILD_PRESERVE),-p)                                            \
     -r $(firstword $(wildcard $(2:.symtypes=.symref) /dev/null))

quiet_cmd_cc_symtypes_S = SYM $(quiet_modtag) $@
cmd_cc_symtypes_S =                                                         \
    set -e;                                                                 \
    $(call cmd_gensymtypes_S,true,$@) >/dev/null;                           \
    test -s $@ || rm -f $@

$(obj)/%.symtypes : $(src)/%.S FORCE
	$(call cmd,cc_symtypes_S)


371 372
quiet_cmd_cpp_s_S = CPP $(quiet_modtag) $@
cmd_cpp_s_S       = $(CPP) $(a_flags) -o $@ $<
L
Linus Torvalds 已提交
373

374
$(obj)/%.s: $(src)/%.S FORCE
375
	$(call if_changed_dep,cpp_s_S)
L
Linus Torvalds 已提交
376 377

quiet_cmd_as_o_S = AS $(quiet_modtag)  $@
378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408

ifndef CONFIG_MODVERSIONS
cmd_as_o_S = $(CC) $(a_flags) -c -o $@ $<

else

ASM_PROTOTYPES := $(wildcard $(srctree)/arch/$(SRCARCH)/include/asm/asm-prototypes.h)

ifeq ($(ASM_PROTOTYPES),)
cmd_as_o_S = $(CC) $(a_flags) -c -o $@ $<

else

# versioning matches the C process described above, with difference that
# we parse asm-prototypes.h C header to get function definitions.

cmd_as_o_S = $(CC) $(a_flags) -c -o $(@D)/.tmp_$(@F) $<

cmd_modversions_S =								\
	if $(OBJDUMP) -h $(@D)/.tmp_$(@F) | grep -q __ksymtab; then		\
		$(call cmd_gensymtypes_S,$(KBUILD_SYMTYPES),$(@:.o=.symtypes))	\
		    > $(@D)/.tmp_$(@F:.o=.ver);					\
										\
		$(LD) $(LDFLAGS) -r -o $@ $(@D)/.tmp_$(@F) 			\
			-T $(@D)/.tmp_$(@F:.o=.ver);				\
		rm -f $(@D)/.tmp_$(@F) $(@D)/.tmp_$(@F:.o=.ver);		\
	else									\
		mv -f $(@D)/.tmp_$(@F) $@;					\
	fi;
endif
endif
L
Linus Torvalds 已提交
409

410
$(obj)/%.o: $(src)/%.S $(objtool_dep) FORCE
411
	$(call if_changed_rule,as_o_S)
L
Linus Torvalds 已提交
412

413
targets += $(filter-out $(subdir-obj-y), $(real-obj-y)) $(real-obj-m) $(lib-y)
L
Linus Torvalds 已提交
414 415 416 417 418
targets += $(extra-y) $(MAKECMDGOALS) $(always)

# Linker scripts preprocessor (.lds.S -> .lds)
# ---------------------------------------------------------------------------
quiet_cmd_cpp_lds_S = LDS     $@
419
      cmd_cpp_lds_S = $(CPP) $(cpp_flags) -P -U$(ARCH) \
420
	                     -D__ASSEMBLY__ -DLINKER_SCRIPT -o $@ $<
L
Linus Torvalds 已提交
421

422
$(obj)/%.lds: $(src)/%.lds.S FORCE
L
Linus Torvalds 已提交
423 424
	$(call if_changed_dep,cpp_lds_S)

425 426 427 428 429 430
# ASN.1 grammar
# ---------------------------------------------------------------------------
quiet_cmd_asn1_compiler = ASN.1   $@
      cmd_asn1_compiler = $(objtree)/scripts/asn1_compiler $< \
				$(subst .h,.c,$@) $(subst .c,.h,$@)

431
$(obj)/%.asn1.c $(obj)/%.asn1.h: $(src)/%.asn1 $(objtree)/scripts/asn1_compiler
432 433
	$(call cmd,asn1_compiler)

L
Linus Torvalds 已提交
434 435 436 437 438 439 440 441 442 443
# Build the compiled-in targets
# ---------------------------------------------------------------------------

# To build objects in subdirs, we need to descend into the directories
$(sort $(subdir-obj-y)): $(subdir-ym) ;

#
# Rule to compile a set of .o files into one .o file
#
ifdef builtin-target
444

445
# built-in.a archives are made with no symbol table or index which
446
# makes them small and fast, but unable to be used by the linker.
447
# scripts/link-vmlinux.sh builds an aggregate built-in.a with a symbol
448
# table and index.
449 450 451
quiet_cmd_ar_builtin = AR      $@
      cmd_ar_builtin = rm -f $@; \
                     $(AR) rcSTP$(KBUILD_ARFLAGS) $@ $(filter $(real-obj-y), $^)
L
Linus Torvalds 已提交
452

453
$(builtin-target): $(real-obj-y) FORCE
454
	$(call if_changed,ar_builtin)
L
Linus Torvalds 已提交
455 456 457 458

targets += $(builtin-target)
endif # builtin-target

T
Tejun Heo 已提交
459 460 461 462 463 464 465 466 467 468 469 470 471
#
# Rule to create modules.order file
#
# Create commands to either record .ko file or cat modules.order from
# a subdirectory
modorder-cmds =						\
	$(foreach m, $(modorder),			\
		$(if $(filter %/modules.order, $m),	\
			cat $m;, echo kernel/$m;))

$(modorder-target): $(subdir-ym) FORCE
	$(Q)(cat /dev/null; $(modorder-cmds)) > $@

L
Linus Torvalds 已提交
472 473 474 475 476
#
# Rule to compile a set of .o files into one .a file
#
ifdef lib-target
quiet_cmd_link_l_target = AR      $@
477

478 479
# lib target archives do get a symbol table and index
cmd_link_l_target = rm -f $@; $(AR) rcsTP$(KBUILD_ARFLAGS) $@ $(lib-y)
L
Linus Torvalds 已提交
480 481 482 483 484

$(lib-target): $(lib-y) FORCE
	$(call if_changed,link_l_target)

targets += $(lib-target)
485 486 487 488 489 490 491 492 493 494 495

dummy-object = $(obj)/.lib_exports.o
ksyms-lds = $(dot-target).lds
ifdef CONFIG_HAVE_UNDERSCORE_SYMBOL_PREFIX
ref_prefix = EXTERN(_
else
ref_prefix = EXTERN(
endif

quiet_cmd_export_list = EXPORTS $@
cmd_export_list = $(OBJDUMP) -h $< | \
496
	sed -ne '/___ksymtab/s/.*+\([^ ]*\).*/$(ref_prefix)\1)/p' >$(ksyms-lds);\
497
	rm -f $(dummy-object);\
498
	echo | $(CC) $(a_flags) -c -o $(dummy-object) -x assembler -;\
499 500 501 502 503
	$(LD) $(ld_flags) -r -o $@ -T $(ksyms-lds) $(dummy-object);\
	rm $(dummy-object) $(ksyms-lds)

$(obj)/lib-ksyms.o: $(lib-target) FORCE
	$(call if_changed,export_list)
504 505 506

targets += $(obj)/lib-ksyms.o

L
Linus Torvalds 已提交
507 508 509 510 511 512 513 514 515
endif

#
# Rule to link composite objects
#
#  Composite objects are specified in kbuild makefile as follows:
#    <composite-object>-objs := <list of .o files>
#  or
#    <composite-object>-y    := <list of .o files>
516 517 518
#  or
#    <composite-object>-m    := <list of .o files>
#  The -m syntax only works if <composite object> is a module
L
Linus Torvalds 已提交
519 520 521
link_multi_deps =                     \
$(filter $(addprefix $(obj)/,         \
$($(subst $(obj)/,,$(@:.o=-objs)))    \
522 523
$($(subst $(obj)/,,$(@:.o=-y)))       \
$($(subst $(obj)/,,$(@:.o=-m)))), $^)
524

L
Linus Torvalds 已提交
525
quiet_cmd_link_multi-m = LD [M]  $@
526
cmd_link_multi-m = $(LD) $(ld_flags) -r -o $@ $(link_multi_deps) $(cmd_secanalysis)
L
Linus Torvalds 已提交
527

528
$(multi-used-m): FORCE
L
Linus Torvalds 已提交
529
	$(call if_changed,link_multi-m)
530 531
	@{ echo $(@:.o=.ko); echo $(link_multi_deps); \
	   $(cmd_undef_syms); } > $(MODVERDIR)/$(@F:.o=.mod)
532
$(call multi_depend, $(multi-used-m), .o, -objs -y -m)
L
Linus Torvalds 已提交
533

534
targets += $(multi-used-m)
535
targets := $(filter-out $(PHONY), $(targets))
L
Linus Torvalds 已提交
536

537 538 539 540 541 542
# Add intermediate targets:
# When building objects with specific suffix patterns, add intermediate
# targets that the final targets are derived from.
intermediate_targets = $(foreach sfx, $(2), \
				$(patsubst %$(strip $(1)),%$(sfx), \
					$(filter %$(strip $(1)), $(targets))))
543
# %.asn1.o <- %.asn1.[ch] <- %.asn1
544
# %.dtb.o <- %.dtb.S <- %.dtb <- %.dts
545 546
# %.lex.o <- %.lex.c <- %.l
# %.tab.o <- %.tab.[ch] <- %.y
547 548
targets += $(call intermediate_targets, .asn1.o, .asn1.c .asn1.h) \
	   $(call intermediate_targets, .dtb.o, .dtb.S .dtb) \
549
	   $(call intermediate_targets, .lex.o, .lex.c) \
550 551
	   $(call intermediate_targets, .tab.o, .tab.c .tab.h)

L
Linus Torvalds 已提交
552 553 554
# Descending
# ---------------------------------------------------------------------------

555
PHONY += $(subdir-ym)
L
Linus Torvalds 已提交
556
$(subdir-ym):
557
	$(Q)$(MAKE) $(build)=$@ need-builtin=$(if $(findstring $@,$(subdir-obj-y)),1)
L
Linus Torvalds 已提交
558 559 560 561

# Add FORCE to the prequisites of a target to force it to be always rebuilt.
# ---------------------------------------------------------------------------

562
PHONY += FORCE
L
Linus Torvalds 已提交
563 564 565 566 567 568 569 570

FORCE:

# Read all saved command lines and dependencies for the $(targets) we
# may be building above, using $(if_changed{,_dep}). As an
# optimization, we don't need to read them if the target does not
# exist, we will rebuild anyway in that case.

571
cmd_files := $(wildcard $(foreach f,$(sort $(targets)),$(dir $(f)).$(notdir $(f)).cmd))
L
Linus Torvalds 已提交
572 573 574 575

ifneq ($(cmd_files),)
  include $(cmd_files)
endif
576

577 578 579
ifneq ($(KBUILD_SRC),)
# Create directories for object files if they do not exist
obj-dirs := $(sort $(obj) $(patsubst %/,%, $(dir $(targets))))
580 581 582 583
# If cmd_files exist, their directories apparently exist.  Skip mkdir.
exist-dirs := $(sort $(patsubst %/,%, $(dir $(cmd_files))))
obj-dirs := $(strip $(filter-out $(exist-dirs), $(obj-dirs)))
ifneq ($(obj-dirs),)
584 585
$(shell mkdir -p $(obj-dirs))
endif
586
endif
587

588 589 590 591
# Some files contained in $(targets) are intermediate artifacts.
# We never want them to be removed automatically.
.SECONDARY: $(targets)

592 593 594 595
# Declare the contents of the .PHONY variable as phony.  We keep that
# information in a variable se we can use it in if_changed and friends.

.PHONY: $(PHONY)