Greg Kroah-Hartman | b244131 | 2017-11-01 15:07:57 +0100 | [diff] [blame] | 1 | # SPDX-License-Identifier: GPL-2.0 |
Masahiro Yamada | cf8dfd1 | 2019-07-21 01:27:40 +0900 | [diff] [blame] | 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 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 | # |
Robert P. J. Day | 3156fd0 | 2008-02-18 04:48:20 -0500 | [diff] [blame] | 24 | # Both C and C++ are supported, but preferred language is C for such utilities. |
Miguel Ojeda | 2f7ab12 | 2021-07-03 16:42:57 +0200 | [diff] [blame] | 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). |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 27 | # |
Mauro Carvalho Chehab | cd238ef | 2019-06-12 14:52:48 -0300 | [diff] [blame] | 28 | # Sample syntax (see Documentation/kbuild/makefiles.rst for reference) |
Masahiro Yamada | 5f2fb52 | 2020-02-02 01:49:24 +0900 | [diff] [blame] | 29 | # hostprogs := bin2hex |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 30 | # Will compile bin2hex.c and create an executable named bin2hex |
| 31 | # |
Masahiro Yamada | 5f2fb52 | 2020-02-02 01:49:24 +0900 | [diff] [blame] | 32 | # hostprogs := lxdialog |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 | # |
Masahiro Yamada | 5f2fb52 | 2020-02-02 01:49:24 +0900 | [diff] [blame] | 37 | # hostprogs := qconf |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 |
Miguel Ojeda | 2f7ab12 | 2021-07-03 16:42:57 +0200 | [diff] [blame] | 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. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 47 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 48 | # C code |
| 49 | # Executables compiled from a single .c file |
Masahiro Yamada | 85569d1 | 2020-07-29 12:15:37 +0900 | [diff] [blame] | 50 | host-csingle := $(foreach m,$(hostprogs), \ |
Miguel Ojeda | 2f7ab12 | 2021-07-03 16:42:57 +0200 | [diff] [blame] | 51 | $(if $($(m)-objs)$($(m)-cxxobjs)$($(m)-rust),,$(m))) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 52 | |
| 53 | # C executables linked based on several .o files |
Masahiro Yamada | 85569d1 | 2020-07-29 12:15:37 +0900 | [diff] [blame] | 54 | host-cmulti := $(foreach m,$(hostprogs),\ |
Miguel Ojeda | 2f7ab12 | 2021-07-03 16:42:57 +0200 | [diff] [blame] | 55 | $(if $($(m)-cxxobjs)$($(m)-rust),,$(if $($(m)-objs),$(m)))) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 56 | |
| 57 | # Object (.o) files compiled from .c files |
Masahiro Yamada | 85569d1 | 2020-07-29 12:15:37 +0900 | [diff] [blame] | 58 | host-cobjs := $(sort $(foreach m,$(hostprogs),$($(m)-objs))) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 59 | |
| 60 | # C++ code |
Masahiro Yamada | d8d9efe | 2014-07-16 16:12:19 +0900 | [diff] [blame] | 61 | # C++ executables compiled from at least one .cc file |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 62 | # and zero or more .c files |
Masahiro Yamada | 85569d1 | 2020-07-29 12:15:37 +0900 | [diff] [blame] | 63 | host-cxxmulti := $(foreach m,$(hostprogs),$(if $($(m)-cxxobjs),$(m))) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 64 | |
| 65 | # C++ Object (.o) files compiled from .cc files |
| 66 | host-cxxobjs := $(sort $(foreach m,$(host-cxxmulti),$($(m)-cxxobjs))) |
| 67 | |
Miguel Ojeda | 2f7ab12 | 2021-07-03 16:42:57 +0200 | [diff] [blame] | 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 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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)) |
Miguel Ojeda | 2f7ab12 | 2021-07-03 16:42:57 +0200 | [diff] [blame] | 78 | host-rust := $(addprefix $(obj)/,$(host-rust)) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 79 | |
| 80 | ##### |
| 81 | # Handle options to gcc. Support building with separate output directory |
| 82 | |
Masahiro Yamada | 16169a4 | 2023-01-07 18:18:14 +0900 | [diff] [blame] | 83 | hostc_flags = -Wp,-MMD,$(depfile) \ |
| 84 | $(KBUILD_HOSTCFLAGS) $(HOST_EXTRACFLAGS) \ |
Masahiro Yamada | 54b8ae6 | 2019-08-30 13:34:01 +0900 | [diff] [blame] | 85 | $(HOSTCFLAGS_$(target-stem).o) |
Masahiro Yamada | 16169a4 | 2023-01-07 18:18:14 +0900 | [diff] [blame] | 86 | hostcxx_flags = -Wp,-MMD,$(depfile) \ |
| 87 | $(KBUILD_HOSTCXXFLAGS) $(HOST_EXTRACXXFLAGS) \ |
Masahiro Yamada | 54b8ae6 | 2019-08-30 13:34:01 +0900 | [diff] [blame] | 88 | $(HOSTCXXFLAGS_$(target-stem).o) |
Miguel Ojeda | df01b7c | 2023-07-23 16:21:28 +0200 | [diff] [blame] | 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) \ |
Masahiro Yamada | 295d839 | 2023-01-07 18:18:15 +0900 | [diff] [blame] | 94 | $(KBUILD_HOSTRUSTFLAGS) $(HOST_EXTRARUSTFLAGS) \ |
Masahiro Yamada | 16169a4 | 2023-01-07 18:18:14 +0900 | [diff] [blame] | 95 | $(HOSTRUSTFLAGS_$(target-stem)) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 96 | |
Masahiro Yamada | cdd750b | 2019-05-13 15:22:17 +0900 | [diff] [blame] | 97 | # $(objtree)/$(obj) for including generated headers from checkin source files |
Masahiro Yamada | 58156ba | 2019-01-16 11:56:40 +0900 | [diff] [blame] | 98 | ifeq ($(KBUILD_EXTMOD),) |
Masahiro Yamada | 051f278 | 2019-07-06 12:07:12 +0900 | [diff] [blame] | 99 | ifdef building_out_of_srctree |
Masahiro Yamada | 16169a4 | 2023-01-07 18:18:14 +0900 | [diff] [blame] | 100 | hostc_flags += -I $(objtree)/$(obj) |
| 101 | hostcxx_flags += -I $(objtree)/$(obj) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 102 | endif |
Masahiro Yamada | 58156ba | 2019-01-16 11:56:40 +0900 | [diff] [blame] | 103 | endif |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 104 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 105 | ##### |
| 106 | # Compile programs on the host |
| 107 | |
| 108 | # Create executable from a single .c file |
| 109 | # host-csingle -> Executable |
| 110 | quiet_cmd_host-csingle = HOSTCC $@ |
Laura Abbott | b90a368 | 2018-07-09 17:46:00 -0700 | [diff] [blame] | 111 | cmd_host-csingle = $(HOSTCC) $(hostc_flags) $(KBUILD_HOSTLDFLAGS) -o $@ $< \ |
Masahiro Yamada | 54b8ae6 | 2019-08-30 13:34:01 +0900 | [diff] [blame] | 112 | $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem)) |
Sam Ravnborg | 767e581 | 2007-05-06 09:23:45 +0200 | [diff] [blame] | 113 | $(host-csingle): $(obj)/%: $(src)/%.c FORCE |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 114 | $(call if_changed_dep,host-csingle) |
| 115 | |
| 116 | # Link an executable based on list of .o files, all plain c |
| 117 | # host-cmulti -> executable |
| 118 | quiet_cmd_host-cmulti = HOSTLD $@ |
Laura Abbott | b90a368 | 2018-07-09 17:46:00 -0700 | [diff] [blame] | 119 | cmd_host-cmulti = $(HOSTCC) $(KBUILD_HOSTLDFLAGS) -o $@ \ |
Masahiro Yamada | 54b8ae6 | 2019-08-30 13:34:01 +0900 | [diff] [blame] | 120 | $(addprefix $(obj)/, $($(target-stem)-objs)) \ |
| 121 | $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem)) |
Masahiro Yamada | 97e3226 | 2014-08-19 16:34:21 +0900 | [diff] [blame] | 122 | $(host-cmulti): FORCE |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 123 | $(call if_changed,host-cmulti) |
Masahiro Yamada | 97e3226 | 2014-08-19 16:34:21 +0900 | [diff] [blame] | 124 | $(call multi_depend, $(host-cmulti), , -objs) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 125 | |
| 126 | # Create .o file from a single .c file |
| 127 | # host-cobjs -> .o |
| 128 | quiet_cmd_host-cobjs = HOSTCC $@ |
| 129 | cmd_host-cobjs = $(HOSTCC) $(hostc_flags) -c -o $@ $< |
Sam Ravnborg | 767e581 | 2007-05-06 09:23:45 +0200 | [diff] [blame] | 130 | $(host-cobjs): $(obj)/%.o: $(src)/%.c FORCE |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 131 | $(call if_changed_dep,host-cobjs) |
| 132 | |
| 133 | # Link an executable based on list of .o files, a mixture of .c and .cc |
| 134 | # host-cxxmulti -> executable |
| 135 | quiet_cmd_host-cxxmulti = HOSTLD $@ |
Laura Abbott | b90a368 | 2018-07-09 17:46:00 -0700 | [diff] [blame] | 136 | cmd_host-cxxmulti = $(HOSTCXX) $(KBUILD_HOSTLDFLAGS) -o $@ \ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 137 | $(foreach o,objs cxxobjs,\ |
Masahiro Yamada | 54b8ae6 | 2019-08-30 13:34:01 +0900 | [diff] [blame] | 138 | $(addprefix $(obj)/, $($(target-stem)-$(o)))) \ |
| 139 | $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem)) |
Masahiro Yamada | 97e3226 | 2014-08-19 16:34:21 +0900 | [diff] [blame] | 140 | $(host-cxxmulti): FORCE |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 141 | $(call if_changed,host-cxxmulti) |
Masahiro Yamada | 97e3226 | 2014-08-19 16:34:21 +0900 | [diff] [blame] | 142 | $(call multi_depend, $(host-cxxmulti), , -objs -cxxobjs) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 143 | |
| 144 | # Create .o file from a single .cc (C++) file |
| 145 | quiet_cmd_host-cxxobjs = HOSTCXX $@ |
| 146 | cmd_host-cxxobjs = $(HOSTCXX) $(hostcxx_flags) -c -o $@ $< |
Sam Ravnborg | 767e581 | 2007-05-06 09:23:45 +0200 | [diff] [blame] | 147 | $(host-cxxobjs): $(obj)/%.o: $(src)/%.cc FORCE |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 148 | $(call if_changed_dep,host-cxxobjs) |
| 149 | |
Miguel Ojeda | 2f7ab12 | 2021-07-03 16:42:57 +0200 | [diff] [blame] | 150 | # Create executable from a single Rust crate (which may consist of |
| 151 | # one or more `.rs` files) |
| 152 | # host-rust -> Executable |
| 153 | quiet_cmd_host-rust = HOSTRUSTC $@ |
| 154 | cmd_host-rust = \ |
Masahiro Yamada | 2185242 | 2023-01-07 18:18:17 +0900 | [diff] [blame] | 155 | $(HOSTRUSTC) $(hostrust_flags) --emit=link=$@ $< |
Miguel Ojeda | 2f7ab12 | 2021-07-03 16:42:57 +0200 | [diff] [blame] | 156 | $(host-rust): $(obj)/%: $(src)/%.rs FORCE |
| 157 | $(call if_changed_dep,host-rust) |
| 158 | |
Masahiro Yamada | 42640b13 | 2020-07-29 12:15:36 +0900 | [diff] [blame] | 159 | targets += $(host-csingle) $(host-cmulti) $(host-cobjs) \ |
Miguel Ojeda | 2f7ab12 | 2021-07-03 16:42:57 +0200 | [diff] [blame] | 160 | $(host-cxxmulti) $(host-cxxobjs) $(host-rust) |