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    = -Wp,-MMD,$(depfile) \
  84                  $(KBUILD_HOSTCFLAGS) $(HOST_EXTRACFLAGS) \
  85                  $(HOSTCFLAGS_$(target-stem).o)
  86 hostcxx_flags  = -Wp,-MMD,$(depfile) \
  87                  $(KBUILD_HOSTCXXFLAGS) $(HOST_EXTRACXXFLAGS) \
  88                  $(HOSTCXXFLAGS_$(target-stem).o)
  89 hostrust_flags = --emit=dep-info=$(depfile) \
  90                  $(KBUILD_HOSTRUSTFLAGS) $(HOST_EXTRARUSTFLAGS) \
  91                  $(HOSTRUSTFLAGS_$(target-stem))
  92
  93 # $(objtree)/$(obj) for including generated headers from checkin source files
  94 ifeq ($(KBUILD_EXTMOD),)
  95 ifdef building_out_of_srctree
  96 hostc_flags   += -I $(objtree)/$(obj)
  97 hostcxx_flags += -I $(objtree)/$(obj)
  98 endif
  99 endif
 100
 101 #####
 102 # Compile programs on the host
 103
 104 # Create executable from a single .c file
 105 # host-csingle -> Executable
 106 quiet_cmd_host-csingle  = HOSTCC  $@
 107       cmd_host-csingle  = $(HOSTCC) $(hostc_flags) $(KBUILD_HOSTLDFLAGS) -o $@ $< \
 108                 $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem))
 109 $(host-csingle): $(obj)/%: $(src)/%.c FORCE
 110         $(call if_changed_dep,host-csingle)
 111
 112 # Link an executable based on list of .o files, all plain c
 113 # host-cmulti -> executable
 114 quiet_cmd_host-cmulti   = HOSTLD  $@
 115       cmd_host-cmulti   = $(HOSTCC) $(KBUILD_HOSTLDFLAGS) -o $@ \
 116                           $(addprefix $(obj)/, $($(target-stem)-objs)) \
 117                           $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem))
 118 $(host-cmulti): FORCE
 119         $(call if_changed,host-cmulti)
 120 $(call multi_depend, $(host-cmulti), , -objs)
 121
 122 # Create .o file from a single .c file
 123 # host-cobjs -> .o
 124 quiet_cmd_host-cobjs    = HOSTCC  $@
 125       cmd_host-cobjs    = $(HOSTCC) $(hostc_flags) -c -o $@ $<
 126 $(host-cobjs): $(obj)/%.o: $(src)/%.c FORCE
 127         $(call if_changed_dep,host-cobjs)
 128
 129 # Link an executable based on list of .o files, a mixture of .c and .cc
 130 # host-cxxmulti -> executable
 131 quiet_cmd_host-cxxmulti = HOSTLD  $@
 132       cmd_host-cxxmulti = $(HOSTCXX) $(KBUILD_HOSTLDFLAGS) -o $@ \
 133                           $(foreach o,objs cxxobjs,\
 134                           $(addprefix $(obj)/, $($(target-stem)-$(o)))) \
 135                           $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem))
 136 $(host-cxxmulti): FORCE
 137         $(call if_changed,host-cxxmulti)
 138 $(call multi_depend, $(host-cxxmulti), , -objs -cxxobjs)
 139
 140 # Create .o file from a single .cc (C++) file
 141 quiet_cmd_host-cxxobjs  = HOSTCXX $@
 142       cmd_host-cxxobjs  = $(HOSTCXX) $(hostcxx_flags) -c -o $@ $<
 143 $(host-cxxobjs): $(obj)/%.o: $(src)/%.cc FORCE
 144         $(call if_changed_dep,host-cxxobjs)
 145
 146 # Create executable from a single Rust crate (which may consist of
 147 # one or more `.rs` files)
 148 # host-rust -> Executable
 149 quiet_cmd_host-rust     = HOSTRUSTC $@
 150       cmd_host-rust     = \
 151         $(HOSTRUSTC) $(hostrust_flags) --emit=link=$@ $<
 152 $(host-rust): $(obj)/%: $(src)/%.rs FORCE
 153         $(call if_changed_dep,host-rust)
 154
 155 targets += $(host-csingle) $(host-cmulti) $(host-cobjs) \
 156            $(host-cxxmulti) $(host-cxxobjs) $(host-rust)