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
  90 # `--out-dir` is required to avoid temporaries being created by `rustc` in the
  91 # current working directory, which may be not accessible in the out-of-tree
  92 # modules case.
  93 hostrust_flags = --out-dir $(dir $@) --emit=dep-info=$(depfile) \
  94                  -Clinker-flavor=gcc -Clinker=$(HOSTCC) \
  95                  -Clink-args='$(call escsq,$(KBUILD_HOSTLDFLAGS))' \
  96                  $(KBUILD_HOSTRUSTFLAGS) $(HOST_EXTRARUSTFLAGS) \
  97                  $(HOSTRUSTFLAGS_$(target-stem))
  98
  99 # $(objtree)/$(obj) for including generated headers from checkin source files
 100 ifeq ($(KBUILD_EXTMOD),)
 101 ifdef building_out_of_srctree
 102 hostc_flags   += -I $(objtree)/$(obj)
 103 hostcxx_flags += -I $(objtree)/$(obj)
 104 endif
 105 endif
 106
 107 #####
 108 # Compile programs on the host
 109
 110 # Create executable from a single .c file
 111 # host-csingle -> Executable
 112 quiet_cmd_host-csingle  = HOSTCC  $@
 113       cmd_host-csingle  = $(HOSTCC) $(hostc_flags) $(KBUILD_HOSTLDFLAGS) -o $@ $< \
 114                 $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem))
 115 $(host-csingle): $(obj)/%: $(src)/%.c FORCE
 116         $(call if_changed_dep,host-csingle)
 117
 118 # Link an executable based on list of .o files, all plain c
 119 # host-cmulti -> executable
 120 quiet_cmd_host-cmulti   = HOSTLD  $@
 121       cmd_host-cmulti   = $(HOSTCC) $(KBUILD_HOSTLDFLAGS) -o $@ \
 122                           $(addprefix $(obj)/, $($(target-stem)-objs)) \
 123                           $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem))
 124 $(host-cmulti): FORCE
 125         $(call if_changed,host-cmulti)
 126 $(call multi_depend, $(host-cmulti), , -objs)
 127
 128 # Create .o file from a single .c file
 129 # host-cobjs -> .o
 130 quiet_cmd_host-cobjs    = HOSTCC  $@
 131       cmd_host-cobjs    = $(HOSTCC) $(hostc_flags) -c -o $@ $<
 132 $(host-cobjs): $(obj)/%.o: $(src)/%.c FORCE
 133         $(call if_changed_dep,host-cobjs)
 134
 135 # Link an executable based on list of .o files, a mixture of .c and .cc
 136 # host-cxxmulti -> executable
 137 quiet_cmd_host-cxxmulti = HOSTLD  $@
 138       cmd_host-cxxmulti = $(HOSTCXX) $(KBUILD_HOSTLDFLAGS) -o $@ \
 139                           $(foreach o,objs cxxobjs,\
 140                           $(addprefix $(obj)/, $($(target-stem)-$(o)))) \
 141                           $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem))
 142 $(host-cxxmulti): FORCE
 143         $(call if_changed,host-cxxmulti)
 144 $(call multi_depend, $(host-cxxmulti), , -objs -cxxobjs)
 145
 146 # Create .o file from a single .cc (C++) file
 147 quiet_cmd_host-cxxobjs  = HOSTCXX $@
 148       cmd_host-cxxobjs  = $(HOSTCXX) $(hostcxx_flags) -c -o $@ $<
 149 $(host-cxxobjs): $(obj)/%.o: $(src)/%.cc FORCE
 150         $(call if_changed_dep,host-cxxobjs)
 151
 152 # Create executable from a single Rust crate (which may consist of
 153 # one or more `.rs` files)
 154 # host-rust -> Executable
 155 quiet_cmd_host-rust     = HOSTRUSTC $@
 156       cmd_host-rust     = \
 157         $(HOSTRUSTC) $(hostrust_flags) --emit=link=$@ $<
 158 $(host-rust): $(obj)/%: $(src)/%.rs FORCE
 159         +$(call if_changed_dep,host-rust)
 160
 161 targets += $(host-csingle) $(host-cmulti) $(host-cobjs) \
 162            $(host-cxxmulti) $(host-cxxobjs) $(host-rust)