Commit | Line | Data |
---|---|---|
b2441318 | 1 | # SPDX-License-Identifier: GPL-2.0 |
cf8dfd15 MY |
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 | ||
1da177e4 LT |
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 | # | |
3156fd05 | 24 | # Both C and C++ are supported, but preferred language is C for such utilities. |
2f7ab126 MO |
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). | |
1da177e4 | 27 | # |
cd238eff | 28 | # Sample syntax (see Documentation/kbuild/makefiles.rst for reference) |
5f2fb52f | 29 | # hostprogs := bin2hex |
1da177e4 LT |
30 | # Will compile bin2hex.c and create an executable named bin2hex |
31 | # | |
5f2fb52f | 32 | # hostprogs := lxdialog |
1da177e4 LT |
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 | # | |
5f2fb52f | 37 | # hostprogs := qconf |
1da177e4 LT |
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 | |
2f7ab126 MO |
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. | |
1da177e4 | 47 | |
1da177e4 LT |
48 | # C code |
49 | # Executables compiled from a single .c file | |
85569d19 | 50 | host-csingle := $(foreach m,$(hostprogs), \ |
2f7ab126 | 51 | $(if $($(m)-objs)$($(m)-cxxobjs)$($(m)-rust),,$(m))) |
1da177e4 LT |
52 | |
53 | # C executables linked based on several .o files | |
85569d19 | 54 | host-cmulti := $(foreach m,$(hostprogs),\ |
2f7ab126 | 55 | $(if $($(m)-cxxobjs)$($(m)-rust),,$(if $($(m)-objs),$(m)))) |
1da177e4 LT |
56 | |
57 | # Object (.o) files compiled from .c files | |
85569d19 | 58 | host-cobjs := $(sort $(foreach m,$(hostprogs),$($(m)-objs))) |
1da177e4 LT |
59 | |
60 | # C++ code | |
d8d9efe2 | 61 | # C++ executables compiled from at least one .cc file |
1da177e4 | 62 | # and zero or more .c files |
85569d19 | 63 | host-cxxmulti := $(foreach m,$(hostprogs),$(if $($(m)-cxxobjs),$(m))) |
1da177e4 LT |
64 | |
65 | # C++ Object (.o) files compiled from .cc files | |
66 | host-cxxobjs := $(sort $(foreach m,$(host-cxxmulti),$($(m)-cxxobjs))) | |
67 | ||
2f7ab126 MO |
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 | ||
1da177e4 LT |
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)) | |
2f7ab126 | 78 | host-rust := $(addprefix $(obj)/,$(host-rust)) |
1da177e4 LT |
79 | |
80 | ##### | |
81 | # Handle options to gcc. Support building with separate output directory | |
82 | ||
16169a47 MY |
83 | hostc_flags = -Wp,-MMD,$(depfile) \ |
84 | $(KBUILD_HOSTCFLAGS) $(HOST_EXTRACFLAGS) \ | |
54b8ae66 | 85 | $(HOSTCFLAGS_$(target-stem).o) |
16169a47 MY |
86 | hostcxx_flags = -Wp,-MMD,$(depfile) \ |
87 | $(KBUILD_HOSTCXXFLAGS) $(HOST_EXTRACXXFLAGS) \ | |
54b8ae66 | 88 | $(HOSTCXXFLAGS_$(target-stem).o) |
df01b7cf MO |
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) \ | |
295d8398 | 94 | $(KBUILD_HOSTRUSTFLAGS) $(HOST_EXTRARUSTFLAGS) \ |
16169a47 | 95 | $(HOSTRUSTFLAGS_$(target-stem)) |
1da177e4 | 96 | |
cdd750bf | 97 | # $(objtree)/$(obj) for including generated headers from checkin source files |
58156ba4 | 98 | ifeq ($(KBUILD_EXTMOD),) |
051f278e | 99 | ifdef building_out_of_srctree |
16169a47 MY |
100 | hostc_flags += -I $(objtree)/$(obj) |
101 | hostcxx_flags += -I $(objtree)/$(obj) | |
1da177e4 | 102 | endif |
58156ba4 | 103 | endif |
1da177e4 | 104 | |
1da177e4 LT |
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 $@ | |
b90a3680 | 111 | cmd_host-csingle = $(HOSTCC) $(hostc_flags) $(KBUILD_HOSTLDFLAGS) -o $@ $< \ |
54b8ae66 | 112 | $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem)) |
767e581d | 113 | $(host-csingle): $(obj)/%: $(src)/%.c FORCE |
1da177e4 LT |
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 $@ | |
b90a3680 | 119 | cmd_host-cmulti = $(HOSTCC) $(KBUILD_HOSTLDFLAGS) -o $@ \ |
54b8ae66 MY |
120 | $(addprefix $(obj)/, $($(target-stem)-objs)) \ |
121 | $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem)) | |
97e3226e | 122 | $(host-cmulti): FORCE |
1da177e4 | 123 | $(call if_changed,host-cmulti) |
97e3226e | 124 | $(call multi_depend, $(host-cmulti), , -objs) |
1da177e4 LT |
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 $@ $< | |
767e581d | 130 | $(host-cobjs): $(obj)/%.o: $(src)/%.c FORCE |
1da177e4 LT |
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 $@ | |
b90a3680 | 136 | cmd_host-cxxmulti = $(HOSTCXX) $(KBUILD_HOSTLDFLAGS) -o $@ \ |
1da177e4 | 137 | $(foreach o,objs cxxobjs,\ |
54b8ae66 MY |
138 | $(addprefix $(obj)/, $($(target-stem)-$(o)))) \ |
139 | $(KBUILD_HOSTLDLIBS) $(HOSTLDLIBS_$(target-stem)) | |
97e3226e | 140 | $(host-cxxmulti): FORCE |
1da177e4 | 141 | $(call if_changed,host-cxxmulti) |
97e3226e | 142 | $(call multi_depend, $(host-cxxmulti), , -objs -cxxobjs) |
1da177e4 LT |
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 $@ $< | |
767e581d | 147 | $(host-cxxobjs): $(obj)/%.o: $(src)/%.cc FORCE |
1da177e4 LT |
148 | $(call if_changed_dep,host-cxxobjs) |
149 | ||
2f7ab126 MO |
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 = \ | |
2185242f | 155 | $(HOSTRUSTC) $(hostrust_flags) --emit=link=$@ $< |
2f7ab126 MO |
156 | $(host-rust): $(obj)/%: $(src)/%.rs FORCE |
157 | $(call if_changed_dep,host-rust) | |
158 | ||
42640b13 | 159 | targets += $(host-csingle) $(host-cmulti) $(host-cobjs) \ |
2f7ab126 | 160 | $(host-cxxmulti) $(host-cxxobjs) $(host-rust) |