scripts/Makefile.host

   1 # SPDX-License-Identifier: GPL-2.0
   2
   3 # LEX
   4 # ---------------------------------------------------------------------------
   5 quiet_cmd_flex = LEX     $@
   6       cmd_flex = $(LEX) -o$@ -L $<
   7
   8 $(obj)/%.lex.c: $(src)/%.l FORCE
   9         $(call if_changed,flex)
  10
  11 # YACC
  12 # ---------------------------------------------------------------------------
  13 quiet_cmd_bison = YACC    $(basename $@).[ch]
  14       cmd_bison = $(YACC) -o $(basename $@).c --defines=$(basename $@).h -t -l $<
  15
  16 $(obj)/%.tab.c $(obj)/%.tab.h: $(src)/%.y FORCE
  17         $(call if_changed,bison)
  18
  19 # ==========================================================================
  20 # Building binaries on the host system
  21 # Binaries are used during the compilation of the kernel, for example
  22 # to preprocess a data file.
  23 #
  24 # Both C and C++ are supported, but preferred language is C for such utilities.
  25 # Rust is also supported, but it may only be used in scenarios where a Rust
  26 # toolchain is required to be available (e.g. when  `CONFIG_RUST` is enabled).
  27 #
  28 # Sample syntax (see Documentation/kbuild/makefiles.rst for reference)
  29 # hostprogs := bin2hex
  30 # Will compile bin2hex.c and create an executable named bin2hex
  31 #
  32 # hostprogs     := lxdialog
  33 # lxdialog-objs := checklist.o lxdialog.o
  34 # Will compile lxdialog.c and checklist.c, and then link the executable
  35 # lxdialog, based on checklist.o and lxdialog.o
  36 #
  37 # hostprogs       := qconf
  38 # qconf-cxxobjs   := qconf.o
  39 # qconf-objs      := menu.o
  40 # Will compile qconf as a C++ program, and menu as a C program.
  41 # They are linked as C++ code to the executable qconf
  42 #
  43 # hostprogs   := target
  44 # target-rust := y
  45 # Will compile `target` as a Rust program, using `target.rs` as the crate root.
  46 # The crate may consist of several source files.
  47
  48 # C code
  49 # Executables compiled from a single .c file
  50 host-csingle    := $(foreach m,$(hostprogs), \
  51                         $(if $($(m)-objs)$($(m)-cxxobjs)$($(m)-rust),,$(m)))
  52
  53 # C executables linked based on several .o files
  54 host-cmulti     := $(foreach m,$(hostprogs),\
  55                    $(if $($(m)-cxxobjs)$($(m)-rust),,$(if $($(m)-objs),$(m))))
  56
  57 # Object (.o) files compiled from .c files
  58 host-cobjs      := $(sort $(foreach m,$(hostprogs),$($(m)-objs)))
  59
  60 # C++ code
  61 # C++ executables compiled from at least one .cc file
  62 # and zero or more .c files
  63 host-cxxmulti   := $(foreach m,$(hostprogs),$(if $($(m)-cxxobjs),$(m)))
  64
  65 # C++ Object (.o) files compiled from .cc files
  66 host-cxxobjs    := $(sort $(foreach m,$(host-cxxmulti),$($(m)-cxxobjs)))
  67
  68 # Rust code
  69 # Executables compiled from a single Rust crate (which may consist of
  70 # one or more .rs files)
  71 host-rust       := $(foreach m,$(hostprogs),$(if $($(m)-rust),$(m)))
  72
  73 host-csingle    := $(addprefix $(obj)/,$(host-csingle))
  74 host-cmulti     := $(addprefix $(obj)/,$(host-cmulti))
  75 host-cobjs      := $(addprefix $(obj)/,$(host-cobjs))
  76 host-cxxmulti   := $(addprefix $(obj)/,$(host-cxxmulti))
  77 host-cxxobjs    := $(addprefix $(obj)/,$(host-cxxobjs))
  78 host-rust       := $(addprefix $(obj)/,$(host-rust))
  79
  80 #####
  81 # Handle options to gcc. Support building with separate output directory
  82
  83 _hostc_flags   = $(KBUILD_HOSTCFLAGS)   $(HOST_EXTRACFLAGS)   \
  84                  $(HOSTCFLAGS_$(target-stem).o)
  85 _hostcxx_flags = $(KBUILD_HOSTCXXFLAGS) $(HOST_EXTRACXXFLAGS) \
  86                  $(HOSTCXXFLAGS_$(target-stem).o)
  87 _hostrust_flags = $(KBUILD_HOSTRUSTFLAGS) $(HOST_EXTRARUSTFLAGS) \
  88                   $(HOSTRUSTFLAGS_$(target-stem))
  89
  90 # $(objtree)/$(obj) for including generated headers from checkin source files
  91 ifeq ($(KBUILD_EXTMOD),)
  92 ifdef building_out_of_srctree
  93 _hostc_flags   += -I $(objtree)/$(obj)
  94 _hostcxx_flags += -I $(objtree)/$(obj)
  95 endif
  96 endif
  97
  98 hostc_flags    = -Wp,-MMD,$(depfile) $(_hostc_flags)
  99 hostcxx_flags  = -Wp,-MMD,$(depfile) $(_hostcxx_flags)
 100 hostrust_flags = $(_hostrust_flags)
 101
 102 #####
 103 # Compile programs on the host
 104
 105 # Create executable from a single .c file
 106 # host-csingle -> Executable
 107 quiet_cmd_host-csingle  = HOSTCC  $@
 108       cmd_host-csingle  = $(HOSTCC) $(hostc_flags) $(KBUILD_HOSTLDFLAGS) -o $@ $< \
 109                 $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem))
 110 $(host-csingle): $(obj)/%: $(src)/%.c FORCE
 111         $(call if_changed_dep,host-csingle)
 112
 113 # Link an executable based on list of .o files, all plain c
 114 # host-cmulti -> executable
 115 quiet_cmd_host-cmulti   = HOSTLD  $@
 116       cmd_host-cmulti   = $(HOSTCC) $(KBUILD_HOSTLDFLAGS) -o $@ \
 117                           $(addprefix $(obj)/, $($(target-stem)-objs)) \
 118                           $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem))
 119 $(host-cmulti): FORCE
 120         $(call if_changed,host-cmulti)
 121 $(call multi_depend, $(host-cmulti), , -objs)
 122
 123 # Create .o file from a single .c file
 124 # host-cobjs -> .o
 125 quiet_cmd_host-cobjs    = HOSTCC  $@
 126       cmd_host-cobjs    = $(HOSTCC) $(hostc_flags) -c -o $@ $<
 127 $(host-cobjs): $(obj)/%.o: $(src)/%.c FORCE
 128         $(call if_changed_dep,host-cobjs)
 129
 130 # Link an executable based on list of .o files, a mixture of .c and .cc
 131 # host-cxxmulti -> executable
 132 quiet_cmd_host-cxxmulti = HOSTLD  $@
 133       cmd_host-cxxmulti = $(HOSTCXX) $(KBUILD_HOSTLDFLAGS) -o $@ \
 134                           $(foreach o,objs cxxobjs,\
 135                           $(addprefix $(obj)/, $($(target-stem)-$(o)))) \
 136                           $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem))
 137 $(host-cxxmulti): FORCE
 138         $(call if_changed,host-cxxmulti)
 139 $(call multi_depend, $(host-cxxmulti), , -objs -cxxobjs)
 140
 141 # Create .o file from a single .cc (C++) file
 142 quiet_cmd_host-cxxobjs  = HOSTCXX $@
 143       cmd_host-cxxobjs  = $(HOSTCXX) $(hostcxx_flags) -c -o $@ $<
 144 $(host-cxxobjs): $(obj)/%.o: $(src)/%.cc FORCE
 145         $(call if_changed_dep,host-cxxobjs)
 146
 147 # Create executable from a single Rust crate (which may consist of
 148 # one or more `.rs` files)
 149 # host-rust -> Executable
 150 quiet_cmd_host-rust     = HOSTRUSTC $@
 151       cmd_host-rust     = \
 152         $(HOSTRUSTC) $(hostrust_flags) --emit=dep-info,link \
 153                 --out-dir=$(obj)/ $<; \
 154         mv $(obj)/$(target-stem).d $(depfile); \
 155         sed -i '/^\#/d' $(depfile)
 156 $(host-rust): $(obj)/%: $(src)/%.rs FORCE
 157         $(call if_changed_dep,host-rust)
 158
 159 targets += $(host-csingle) $(host-cmulti) $(host-cobjs) \
 160            $(host-cxxmulti) $(host-cxxobjs) $(host-rust)