Makefile.build 19.6 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 150
    $(GENKSYMS) $(if $(1), -T $(2))                                         \
     $(patsubst y,-s _,$(CONFIG_HAVE_UNDERSCORE_SYMBOL_PREFIX))             \
151
     $(patsubst y,-R,$(CONFIG_MODULE_REL_CRCS))                             \
S
Sam Ravnborg 已提交
152
     $(if $(KBUILD_PRESERVE),-p)                                            \
153
     -r $(firstword $(wildcard $(2:.symtypes=.symref) /dev/null))
S
Sam Ravnborg 已提交
154

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

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

164 165 166 167 168 169 170 171
# 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 已提交
172 173 174 175 176 177 178 179 180 181 182
# 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:
183 184 185
# 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 已提交
186 187 188
#   are done.
# o otherwise, we calculate symbol versions using the good old
#   genksyms on the preprocessed source and postprocess them in a way
189 190 191 192
#   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 已提交
193

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

cmd_modversions_c =								\
197
	if $(OBJDUMP) -h $(@D)/.tmp_$(@F) | grep -q __ksymtab; then		\
198
		$(call cmd_gensymtypes_c,$(KBUILD_SYMTYPES),$(@:.o=.symtypes))	\
199 200 201 202 203 204 205
		    > $(@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 已提交
206 207 208
	fi;
endif

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

245
ifdef CONFIG_STACK_VALIDATION
246
ifneq ($(SKIP_STACK_VALIDATION),1)
247 248 249

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

250
objtool_args = $(if $(CONFIG_UNWINDER_ORC),orc generate,check)
251

252 253
objtool_args += $(if $(part-of-module), --module,)

254 255 256
ifndef CONFIG_FRAME_POINTER
objtool_args += --no-fp
endif
257 258
ifdef CONFIG_GCOV_KERNEL
objtool_args += --no-unreachable
259 260
else
objtool_args += $(call cc-ifversion, -lt, 0405, --no-unreachable)
261
endif
262
ifdef CONFIG_RETPOLINE
263
ifneq ($(RETPOLINE_CFLAGS),)
264 265
  objtool_args += --retpoline
endif
266
endif
267
endif
268

269

270 271 272 273 274 275
ifdef CONFIG_MODVERSIONS
objtool_o = $(@D)/.tmp_$(@F)
else
objtool_o = $(@)
endif

276 277 278 279 280
# '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), \
281
	$(__objtool_obj) $(objtool_args) "$(objtool_o)";)
282 283 284 285
objtool_obj = $(if $(patsubst y%,, \
	$(OBJECT_FILES_NON_STANDARD_$(basetarget).o)$(OBJECT_FILES_NON_STANDARD)n), \
	$(__objtool_obj))

286
endif # SKIP_STACK_VALIDATION
287 288
endif # CONFIG_STACK_VALIDATION

289 290 291 292 293
# 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 已提交
294
define rule_cc_o_c
295
	$(call echo-cmd,checksrc) $(cmd_checksrc)			  \
296
	$(call cmd_and_fixdep,cc_o_c)					  \
297
	$(cmd_checkdoc)							  \
298
	$(call echo-cmd,objtool) $(cmd_objtool)				  \
299
	$(cmd_modversions_c)						  \
300
	$(call echo-cmd,record_mcount) $(cmd_record_mcount)
L
Linus Torvalds 已提交
301 302
endef

303
define rule_as_o_S
304
	$(call cmd_and_fixdep,as_o_S)					  \
305 306
	$(call echo-cmd,objtool) $(cmd_objtool)				  \
	$(cmd_modversions_S)
307 308
endef

309 310
# List module undefined symbols (or empty line if not enabled)
ifdef CONFIG_TRIM_UNUSED_KSYMS
311
cmd_undef_syms = $(NM) $@ | sed -n 's/^  *U //p' | xargs echo
312 313 314 315
else
cmd_undef_syms = echo
endif

L
Linus Torvalds 已提交
316
# Built-in and composite module parts
317
$(obj)/%.o: $(src)/%.c $(recordmcount_source) $(objtool_dep) FORCE
L
Linus Torvalds 已提交
318 319 320 321 322
	$(call cmd,force_checksrc)
	$(call if_changed_rule,cc_o_c)

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

323
$(single-used-m): $(obj)/%.o: $(src)/%.c $(recordmcount_source) $(objtool_dep) FORCE
L
Linus Torvalds 已提交
324 325
	$(call cmd,force_checksrc)
	$(call if_changed_rule,cc_o_c)
326 327
	@{ echo $(@:.o=.ko); echo $@; \
	   $(cmd_undef_syms); } > $(MODVERDIR)/$(@F:.o=.mod)
L
Linus Torvalds 已提交
328 329 330 331 332 333

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) > $@

334
$(obj)/%.lst: $(src)/%.c FORCE
L
Linus Torvalds 已提交
335 336 337 338 339
	$(call if_changed_dep,cc_lst_c)

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

340
modkern_aflags := $(KBUILD_AFLAGS_KERNEL) $(AFLAGS_KERNEL)
L
Linus Torvalds 已提交
341

342 343
$(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 已提交
344

345 346 347 348 349 350 351 352 353 354 355 356 357 358 359
# .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) $< |                                                  \
360 361
     grep "\<___EXPORT_SYMBOL\>" |                                          \
     sed 's/.*___EXPORT_SYMBOL[[:space:]]*\([a-zA-Z0-9_]*\)[[:space:]]*,.*/EXPORT_SYMBOL(\1);/' ) | \
362 363 364
    $(CPP) -D__GENKSYMS__ $(c_flags) -xc - |                                \
    $(GENKSYMS) $(if $(1), -T $(2))                                         \
     $(patsubst y,-s _,$(CONFIG_HAVE_UNDERSCORE_SYMBOL_PREFIX))             \
365
     $(patsubst y,-R,$(CONFIG_MODULE_REL_CRCS))                             \
366 367 368 369 370 371 372 373 374 375 376 377 378
     $(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)


379 380
quiet_cmd_cpp_s_S = CPP $(quiet_modtag) $@
cmd_cpp_s_S       = $(CPP) $(a_flags) -o $@ $<
L
Linus Torvalds 已提交
381

382
$(obj)/%.s: $(src)/%.S FORCE
383
	$(call if_changed_dep,cpp_s_S)
L
Linus Torvalds 已提交
384 385

quiet_cmd_as_o_S = AS $(quiet_modtag)  $@
386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416

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 已提交
417

418
$(obj)/%.o: $(src)/%.S $(objtool_dep) FORCE
419
	$(call if_changed_rule,as_o_S)
L
Linus Torvalds 已提交
420

421
targets += $(filter-out $(subdir-obj-y), $(real-obj-y)) $(real-obj-m) $(lib-y)
L
Linus Torvalds 已提交
422 423 424 425 426
targets += $(extra-y) $(MAKECMDGOALS) $(always)

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

430
$(obj)/%.lds: $(src)/%.lds.S FORCE
L
Linus Torvalds 已提交
431 432
	$(call if_changed_dep,cpp_lds_S)

433 434 435 436 437 438
# ASN.1 grammar
# ---------------------------------------------------------------------------
quiet_cmd_asn1_compiler = ASN.1   $@
      cmd_asn1_compiler = $(objtree)/scripts/asn1_compiler $< \
				$(subst .h,.c,$@) $(subst .c,.h,$@)

439
$(obj)/%.asn1.c $(obj)/%.asn1.h: $(src)/%.asn1 $(objtree)/scripts/asn1_compiler
440 441
	$(call cmd,asn1_compiler)

L
Linus Torvalds 已提交
442 443 444 445 446 447 448 449 450 451
# 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
452

453
# built-in.a archives are made with no symbol table or index which
454
# makes them small and fast, but unable to be used by the linker.
455
# scripts/link-vmlinux.sh builds an aggregate built-in.a with a symbol
456
# table and index.
457 458 459
quiet_cmd_ar_builtin = AR      $@
      cmd_ar_builtin = rm -f $@; \
                     $(AR) rcSTP$(KBUILD_ARFLAGS) $@ $(filter $(real-obj-y), $^)
L
Linus Torvalds 已提交
460

461
$(builtin-target): $(real-obj-y) FORCE
462
	$(call if_changed,ar_builtin)
L
Linus Torvalds 已提交
463 464 465 466

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

T
Tejun Heo 已提交
467 468 469 470 471 472 473 474 475 476 477 478 479
#
# 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 已提交
480 481 482 483 484
#
# Rule to compile a set of .o files into one .a file
#
ifdef lib-target
quiet_cmd_link_l_target = AR      $@
485

486 487
# 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 已提交
488 489 490 491 492

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

targets += $(lib-target)
493 494 495 496 497 498 499 500 501 502 503

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 $< | \
504
	sed -ne '/___ksymtab/s/.*+\([^ ]*\).*/$(ref_prefix)\1)/p' >$(ksyms-lds);\
505
	rm -f $(dummy-object);\
506
	echo | $(CC) $(a_flags) -c -o $(dummy-object) -x assembler -;\
507 508 509 510 511
	$(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)
512 513 514

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

L
Linus Torvalds 已提交
515 516 517 518 519 520 521 522 523
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>
524 525 526
#  or
#    <composite-object>-m    := <list of .o files>
#  The -m syntax only works if <composite object> is a module
L
Linus Torvalds 已提交
527 528 529
link_multi_deps =                     \
$(filter $(addprefix $(obj)/,         \
$($(subst $(obj)/,,$(@:.o=-objs)))    \
530 531
$($(subst $(obj)/,,$(@:.o=-y)))       \
$($(subst $(obj)/,,$(@:.o=-m)))), $^)
532

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

536
$(multi-used-m): FORCE
L
Linus Torvalds 已提交
537
	$(call if_changed,link_multi-m)
538 539
	@{ echo $(@:.o=.ko); echo $(link_multi_deps); \
	   $(cmd_undef_syms); } > $(MODVERDIR)/$(@F:.o=.mod)
540
$(call multi_depend, $(multi-used-m), .o, -objs -y -m)
L
Linus Torvalds 已提交
541

542
targets += $(multi-used-m)
543
targets := $(filter-out $(PHONY), $(targets))
L
Linus Torvalds 已提交
544

545 546 547 548 549 550
# 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))))
551
# %.asn1.o <- %.asn1.[ch] <- %.asn1
552
# %.dtb.o <- %.dtb.S <- %.dtb <- %.dts
553 554
# %.lex.o <- %.lex.c <- %.l
# %.tab.o <- %.tab.[ch] <- %.y
555 556
targets += $(call intermediate_targets, .asn1.o, .asn1.c .asn1.h) \
	   $(call intermediate_targets, .dtb.o, .dtb.S .dtb) \
557
	   $(call intermediate_targets, .lex.o, .lex.c) \
558 559
	   $(call intermediate_targets, .tab.o, .tab.c .tab.h)

L
Linus Torvalds 已提交
560 561 562
# Descending
# ---------------------------------------------------------------------------

563
PHONY += $(subdir-ym)
L
Linus Torvalds 已提交
564
$(subdir-ym):
565
	$(Q)$(MAKE) $(build)=$@ need-builtin=$(if $(findstring $@,$(subdir-obj-y)),1)
L
Linus Torvalds 已提交
566 567 568 569

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

570
PHONY += FORCE
L
Linus Torvalds 已提交
571 572 573 574 575 576 577 578

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.

579
cmd_files := $(wildcard $(foreach f,$(sort $(targets)),$(dir $(f)).$(notdir $(f)).cmd))
L
Linus Torvalds 已提交
580 581 582 583

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

585 586 587
ifneq ($(KBUILD_SRC),)
# Create directories for object files if they do not exist
obj-dirs := $(sort $(obj) $(patsubst %/,%, $(dir $(targets))))
588 589 590 591
# 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),)
592 593
$(shell mkdir -p $(obj-dirs))
endif
594
endif
595

596 597 598 599
# Some files contained in $(targets) are intermediate artifacts.
# We never want them to be removed automatically.
.SECONDARY: $(targets)

600 601 602 603
# 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)