scripts/Makefile.build

   1 # ==========================================================================
   2 # Building
   3 # ==========================================================================
   4
   5 src := $(obj)
   6
   7 .PHONY: __build
   8 __build:
   9
  10 ifdef include_config
  11 include .config
  12 endif
  13
  14 include $(obj)/Makefile
  15
  16 include scripts/Makefile.lib
  17
  18 ifdef EXTRA_TARGETS
  19 $(warning kbuild: $(obj)/Makefile - Usage of EXTRA_TARGETS is obsolete in 2.5. Please fix!)
  20 endif
  21
  22 ifdef build-targets
  23 $(warning kbuild: $(obj)/Makefile - Usage of build-targets is obsolete in 2.5. Please fix!)
  24 endif
  25
  26 ifdef export-objs
  27 $(warning kbuild: $(obj)/Makefile - Usage of export-objs is obsolete in 2.5. Please fix!)
  28 endif
  29
  30 ifdef O_TARGET
  31 $(warning kbuild: $(obj)/Makefile - Usage of O_TARGET := $(O_TARGET) is obsolete in 2.5. Please fix!)
  32 endif
  33
  34 ifdef L_TARGET
  35 $(error kbuild: $(obj)/Makefile - Use of L_TARGET is replaced by lib-y in 2.5. Please fix!)
  36 endif
  37
  38 ifdef list-multi
  39 $(warning kbuild: $(obj)/Makefile - list-multi := $(list-multi) is obsolete in 2.5. Please fix!)
  40 endif
  41
  42 ifndef obj
  43 $(warning kbuild: Makefile.build is included improperly)
  44 endif
  45
  46 # ===========================================================================
  47
  48 ifneq ($(strip $(lib-y) $(lib-m) $(lib-n) $(lib-)),)
  49 lib-target := $(obj)/lib.a
  50 endif
  51
  52 ifneq ($(strip $(obj-y) $(obj-m) $(obj-n) $(obj-) $(lib-target)),)
  53 builtin-target := $(obj)/built-in.o
  54 endif
  55
  56 # We keep a list of all modules in $(MODVERDIR)
  57
  58 touch-module = @echo $(@:.o=.ko) > $(MODVERDIR)/$(@F:.o=.mod)
  59
  60 __build: $(if $(KBUILD_BUILTIN),$(builtin-target) $(lib-target) $(extra-y)) \
  61          $(if $(KBUILD_MODULES),$(obj-m)) \
  62          $(subdir-ym) $(always)
  63         @:
  64
  65 # Linus' kernel sanity checking tool
  66 ifneq ($(KBUILD_CHECKSRC),0)
  67 quiet_cmd_checksrc = CHECK   $<
  68       cmd_checksrc = $(CHECK) $(c_flags) $< ;
  69 endif
  70
  71
  72 # Compile C sources (.c)
  73 # ---------------------------------------------------------------------------
  74
  75 # Default is built-in, unless we know otherwise
  76 modkern_cflags := $(CFLAGS_KERNEL)
  77 quiet_modtag := $(empty)   $(empty)
  78
  79 $(real-objs-m)        : modkern_cflags := $(CFLAGS_MODULE)
  80 $(real-objs-m:.o=.i)  : modkern_cflags := $(CFLAGS_MODULE)
  81 $(real-objs-m:.o=.s)  : modkern_cflags := $(CFLAGS_MODULE)
  82 $(real-objs-m:.o=.lst): modkern_cflags := $(CFLAGS_MODULE)
  83
  84 $(real-objs-m)        : quiet_modtag := [M]
  85 $(real-objs-m:.o=.i)  : quiet_modtag := [M]
  86 $(real-objs-m:.o=.s)  : quiet_modtag := [M]
  87 $(real-objs-m:.o=.lst): quiet_modtag := [M]
  88
  89 $(obj-m)              : quiet_modtag := [M]
  90
  91 # Default for not multi-part modules
  92 modname = $(*F)
  93
  94 $(multi-objs-m)         : modname = $(modname-multi)
  95 $(multi-objs-m:.o=.i)   : modname = $(modname-multi)
  96 $(multi-objs-m:.o=.s)   : modname = $(modname-multi)
  97 $(multi-objs-m:.o=.lst) : modname = $(modname-multi)
  98 $(multi-objs-y)         : modname = $(modname-multi)
  99 $(multi-objs-y:.o=.i)   : modname = $(modname-multi)
 100 $(multi-objs-y:.o=.s)   : modname = $(modname-multi)
 101 $(multi-objs-y:.o=.lst) : modname = $(modname-multi)
 102
 103 quiet_cmd_cc_s_c = CC $(quiet_modtag)  $@
 104 cmd_cc_s_c       = $(CC) $(c_flags) -S -o $@ $<
 105
 106 %.s: %.c FORCE
 107         $(call if_changed_dep,cc_s_c)
 108
 109 quiet_cmd_cc_i_c = CPP $(quiet_modtag) $@
 110 cmd_cc_i_c       = $(CPP) $(c_flags)   -o $@ $<
 111
 112 %.i: %.c FORCE
 113         $(call if_changed_dep,cc_i_c)
 114
 115 # C (.c) files
 116 # The C file is compiled and updated dependency information is generated.
 117 # (See cmd_cc_o_c + relevant part of rule_cc_o_c)
 118
 119 quiet_cmd_cc_o_c = CC $(quiet_modtag)  $@
 120
 121 ifndef CONFIG_MODVERSIONS
 122 cmd_cc_o_c = $(CC) $(c_flags) -c -o $@ $<
 123
 124 else
 125 # When module versioning is enabled the following steps are executed:
 126 # o compile a .tmp_<file>.o from <file>.c
 127 # o if .tmp_<file>.o doesn't contain a __ksymtab version, i.e. does
 128 #   not export symbols, we just rename .tmp_<file>.o to <file>.o and
 129 #   are done.
 130 # o otherwise, we calculate symbol versions using the good old
 131 #   genksyms on the preprocessed source and postprocess them in a way
 132 #   that they are usable as a linker script
 133 # o generate <file>.o from .tmp_<file>.o using the linker to
 134 #   replace the unresolved symbols __crc_exported_symbol with
 135 #   the actual value of the checksum generated by genksyms
 136
 137 cmd_cc_o_c = $(CC) $(c_flags) -c -o $(@D)/.tmp_$(@F) $<
 138 cmd_modversions =                                                       \
 139         if ! $(OBJDUMP) -h $(@D)/.tmp_$(@F) | grep -q __ksymtab; then   \
 140                 mv $(@D)/.tmp_$(@F) $@;                                 \
 141         else                                                            \
 142                 $(CPP) -D__GENKSYMS__ $(c_flags) $<                     \
 143                 | $(GENKSYMS)                                           \
 144                 > $(@D)/.tmp_$(@F:.o=.ver);                             \
 145                                                                         \
 146                 $(LD) $(LDFLAGS) -r -o $@ $(@D)/.tmp_$(@F)              \
 147                         -T $(@D)/.tmp_$(@F:.o=.ver);                    \
 148                 rm -f $(@D)/.tmp_$(@F) $(@D)/.tmp_$(@F:.o=.ver);        \
 149         fi;
 150 endif
 151
 152 define rule_cc_o_c
 153         $(if $($(quiet)cmd_checksrc),echo '  $($(quiet)cmd_checksrc)';)   \
 154         $(cmd_checksrc)                                                   \
 155         $(if $($(quiet)cmd_cc_o_c),echo '  $($(quiet)cmd_cc_o_c)';)       \
 156         $(cmd_cc_o_c);                                                    \
 157         $(cmd_modversions)                                                \
 158         scripts/fixdep $(depfile) $@ '$(cmd_cc_o_c)' > $(@D)/.$(@F).tmp;  \
 159         rm -f $(depfile);                                                 \
 160         mv -f $(@D)/.$(@F).tmp $(@D)/.$(@F).cmd
 161 endef
 162
 163 # Built-in and composite module parts
 164
 165 %.o: %.c FORCE
 166         $(call if_changed_rule,cc_o_c)
 167
 168 # Single-part modules are special since we need to mark them in $(MODVERDIR)
 169
 170 $(single-used-m): %.o: %.c FORCE
 171         $(call if_changed_rule,cc_o_c)
 172         $(touch-module)
 173
 174 quiet_cmd_cc_lst_c = MKLST   $@
 175       cmd_cc_lst_c = $(CC) $(c_flags) -g -c -o $*.o $< && \
 176                      $(CONFIG_SHELL) $(srctree)/scripts/makelst $*.o \
 177                                      System.map $(OBJDUMP) > $@
 178
 179 %.lst: %.c FORCE
 180         $(call if_changed_dep,cc_lst_c)
 181
 182 # Compile assembler sources (.S)
 183 # ---------------------------------------------------------------------------
 184
 185 modkern_aflags := $(AFLAGS_KERNEL)
 186
 187 $(real-objs-m)      : modkern_aflags := $(AFLAGS_MODULE)
 188 $(real-objs-m:.o=.s): modkern_aflags := $(AFLAGS_MODULE)
 189
 190 quiet_cmd_as_s_S = CPP $(quiet_modtag) $@
 191 cmd_as_s_S       = $(CPP) $(a_flags)   -o $@ $<
 192
 193 %.s: %.S FORCE
 194         $(call if_changed_dep,as_s_S)
 195
 196 quiet_cmd_as_o_S = AS $(quiet_modtag)  $@
 197 cmd_as_o_S       = $(CC) $(a_flags) -c -o $@ $<
 198
 199 %.o: %.S FORCE
 200         $(call if_changed_dep,as_o_S)
 201
 202 targets += $(real-objs-y) $(real-objs-m) $(lib-y)
 203 targets += $(extra-y) $(MAKECMDGOALS) $(always)
 204
 205 # Build the compiled-in targets
 206 # ---------------------------------------------------------------------------
 207
 208 # To build objects in subdirs, we need to descend into the directories
 209 $(sort $(subdir-obj-y)): $(subdir-ym) ;
 210
 211 #
 212 # Rule to compile a set of .o files into one .o file
 213 #
 214 ifdef builtin-target
 215 quiet_cmd_link_o_target = LD      $@
 216 # If the list of objects to link is empty, just create an empty built-in.o
 217 cmd_link_o_target = $(if $(strip $(obj-y)),\
 218                       $(LD) $(ld_flags) -r -o $@ $(filter $(obj-y), $^),\
 219                       rm -f $@; $(AR) rcs $@)
 220
 221 $(builtin-target): $(obj-y) FORCE
 222         $(call if_changed,link_o_target)
 223
 224 targets += $(builtin-target)
 225 endif # builtin-target
 226
 227 #
 228 # Rule to compile a set of .o files into one .a file
 229 #
 230 ifdef lib-target
 231 quiet_cmd_link_l_target = AR      $@
 232 cmd_link_l_target = rm -f $@; $(AR) $(EXTRA_ARFLAGS) rcs $@ $(lib-y)
 233
 234 $(lib-target): $(lib-y) FORCE
 235         $(call if_changed,link_l_target)
 236
 237 targets += $(lib-target)
 238 endif
 239
 240 #
 241 # Rule to link composite objects
 242 #
 243 #  Composite objects are specified in kbuild makefile as follows:
 244 #    <composite-object>-objs := <list of .o files>
 245 #  or
 246 #    <composite-object>-y    := <list of .o files>
 247 link_multi_deps =                     \
 248 $(filter $(addprefix $(obj)/,         \
 249 $($(subst $(obj)/,,$(@:.o=-objs)))    \
 250 $($(subst $(obj)/,,$(@:.o=-y)))), $^)
 251
 252 quiet_cmd_link_multi-y = LD      $@
 253 cmd_link_multi-y = $(LD) $(ld_flags) -r -o $@ $(link_multi_deps)
 254
 255 quiet_cmd_link_multi-m = LD [M]  $@
 256 cmd_link_multi-m = $(LD) $(ld_flags) $(LDFLAGS_MODULE) -o $@ $(link_multi_deps)
 257
 258 # We would rather have a list of rules like
 259 #       foo.o: $(foo-objs)
 260 # but that's not so easy, so we rather make all composite objects depend
 261 # on the set of all their parts
 262 $(multi-used-y) : %.o: $(multi-objs-y) FORCE
 263         $(call if_changed,link_multi-y)
 264
 265 $(multi-used-m) : %.o: $(multi-objs-m) FORCE
 266         $(call if_changed,link_multi-m)
 267         $(touch-module)
 268
 269 targets += $(multi-used-y) $(multi-used-m)
 270
 271 # Compile programs on the host
 272 # ===========================================================================
 273 # host-progs := bin2hex
 274 # Will compile bin2hex.c and create an executable named bin2hex
 275 #
 276 # host-progs    := lxdialog
 277 # lxdialog-objs := checklist.o lxdialog.o
 278 # Will compile lxdialog.c and checklist.c, and then link the executable
 279 # lxdialog, based on checklist.o and lxdialog.o
 280 #
 281 # host-progs      := qconf
 282 # qconf-cxxobjs   := qconf.o
 283 # qconf-objs      := menu.o
 284 # Will compile qconf as a C++ program, and menu as a C program.
 285 # They are linked as C++ code to the executable qconf
 286
 287 # host-progs := conf
 288 # conf-objs  := conf.o libkconfig.so
 289 # libkconfig-objs := expr.o type.o
 290 # Will create a shared library named libkconfig.so that consist of
 291 # expr.o and type.o (they are both compiled as C code and the object file
 292 # are made as position independent code).
 293 # conf.c is compiled as a c program, and conf.o is linked together with
 294 # libkconfig.so as the executable conf.
 295 # Note: Shared libraries consisting of C++ files are not supported
 296 #
 297
 298 # Create executable from a single .c file
 299 # host-csingle -> Executable
 300 quiet_cmd_host-csingle  = HOSTCC  $@
 301       cmd_host-csingle  = $(HOSTCC) $(hostc_flags) $(HOST_LOADLIBES) -o $@ $<
 302 $(host-csingle): %: %.c FORCE
 303         $(call if_changed_dep,host-csingle)
 304
 305 # Link an executable based on list of .o files, all plain c
 306 # host-cmulti -> executable
 307 quiet_cmd_host-cmulti   = HOSTLD  $@
 308       cmd_host-cmulti   = $(HOSTCC) $(HOSTLDFLAGS) -o $@ \
 309                           $(addprefix $(obj)/,$($(@F)-objs)) \
 310                           $(HOST_LOADLIBES) $(HOSTLOADLIBES_$(@F))
 311 $(host-cmulti): %: $(host-cobjs) $(host-cshlib) FORCE
 312         $(call if_changed,host-cmulti)
 313
 314 # Create .o file from a single .c file
 315 # host-cobjs -> .o
 316 quiet_cmd_host-cobjs    = HOSTCC  $@
 317       cmd_host-cobjs    = $(HOSTCC) $(hostc_flags) -c -o $@ $<
 318 $(host-cobjs): %.o: %.c FORCE
 319         $(call if_changed_dep,host-cobjs)
 320
 321 # Link an executable based on list of .o files, a mixture of .c and .cc
 322 # host-cxxmulti -> executable
 323 quiet_cmd_host-cxxmulti = HOSTLD  $@
 324       cmd_host-cxxmulti = $(HOSTCXX) $(HOSTLDFLAGS) -o $@ \
 325                           $(foreach o,objs cxxobjs,\
 326                           $(addprefix $(obj)/,$($(@F)-$(o)))) \
 327                           $(HOST_LOADLIBES) $(HOSTLOADLIBES_$(@F))
 328 $(host-cxxmulti): %: $(host-cobjs) $(host-cxxobjs) $(host-cshlib) FORCE
 329         $(call if_changed,host-cxxmulti)
 330
 331 # Create .o file from a single .cc (C++) file
 332 quiet_cmd_host-cxxobjs  = HOSTCXX $@
 333       cmd_host-cxxobjs  = $(HOSTCXX) $(hostcxx_flags) -c -o $@ $<
 334 $(host-cxxobjs): %.o: %.cc FORCE
 335         $(call if_changed_dep,host-cxxobjs)
 336
 337 # Compile .c file, create position independent .o file
 338 # host-cshobjs -> .o
 339 quiet_cmd_host-cshobjs  = HOSTCC  -fPIC $@
 340       cmd_host-cshobjs  = $(HOSTCC) $(hostc_flags) -fPIC -c -o $@ $<
 341 $(host-cshobjs): %.o: %.c FORCE
 342         $(call if_changed_dep,host-cshobjs)
 343
 344 # Link a shared library, based on position independent .o files
 345 # *.o -> .so shared library (host-cshlib)
 346 quiet_cmd_host-cshlib   = HOSTLLD -shared $@
 347       cmd_host-cshlib   = $(HOSTCC) $(HOSTLDFLAGS) -shared -o $@ \
 348                           $(addprefix $(obj)/,$($(@F:.so=-objs))) \
 349                           $(HOST_LOADLIBES) $(HOSTLOADLIBES_$(@F))
 350 $(host-cshlib): %: $(host-cshobjs) FORCE
 351         $(call if_changed,host-cshlib)
 352
 353 targets += $(host-csingle)  $(host-cmulti) $(host-cobjs)\
 354            $(host-cxxmulti) $(host-cxxobjs) $(host-cshlib) $(host-cshobjs)
 355
 356 # Descending
 357 # ---------------------------------------------------------------------------
 358
 359 .PHONY: $(subdir-ym)
 360 $(subdir-ym):
 361         $(Q)$(MAKE) $(build)=$@
 362
 363 # Add FORCE to the prequisites of a target to force it to be always rebuilt.
 364 # ---------------------------------------------------------------------------
 365
 366 .PHONY: FORCE
 367
 368 FORCE:
 369
 370 # Read all saved command lines and dependencies for the $(targets) we
 371 # may be building above, using $(if_changed{,_dep}). As an
 372 # optimization, we don't need to read them if the target does not
 373 # exist, we will rebuild anyway in that case.
 374
 375 targets := $(wildcard $(sort $(targets)))
 376 cmd_files := $(wildcard $(foreach f,$(targets),$(dir $(f)).$(notdir $(f)).cmd))
 377
 378 ifneq ($(cmd_files),)
 379   include $(cmd_files)
 380 endif