blob: 02a257584ba709f8aec0f575b87ea0f5f3d18a05 [file] [log] [blame]
pbrook0cb3fb12006-05-14 12:07:53 +00001# Makefile for QEMU.
2
Antonio Ospite4ace32e2019-05-26 16:47:47 +02003ifneq ($(words $(subst :, ,$(CURDIR))), 1)
4 $(error main directory cannot contain spaces nor colons)
5endif
6
Stefan Weil519e1692011-09-16 21:50:43 +02007# Always point to the root of the build tree (needs GNU make).
8BUILD_DIR=$(CURDIR)
Lluís Vilanova388d4752011-09-15 22:45:35 +02009
Fam Zhengeaa2ddb2015-05-22 13:35:07 +080010# Before including a proper config-host.mak, assume we are in the source tree
11SRC_PATH=.
12
Paolo Bonzini660f7932020-09-01 12:10:05 -040013# Don't use implicit rules or variables
14# we have explicit rules for everything
15MAKEFLAGS += -rR
16
Thomas Huthbc054392021-07-05 10:25:42 +020017SHELL = bash -o pipefail
Paolo Bonzini3bf45832020-10-14 07:35:13 -040018
Paolo Bonzini660f7932020-09-01 12:10:05 -040019# Usage: $(call quiet-command,command and args,"NAME","args to print")
20# This will run "command and args", and either:
21# if V=1 just print the whole command and args
22# otherwise print the 'quiet' output in the format " NAME args to print"
23# NAME should be a short name of the command, 7 letters or fewer.
24# If called with only a single argument, will print nothing in quiet mode.
25quiet-command-run = $(if $(V),,$(if $2,printf " %-7s %s\n" $2 $3 && ))$1
26quiet-@ = $(if $(V),,@)
27quiet-command = $(quiet-@)$(call quiet-command-run,$1,$2,$3)
28
Steve Sistare6fd87e72023-04-19 06:08:20 -070029UNCHECKED_GOALS := TAGS gtags cscope ctags dist \
Marc-André Lureaude1da442018-01-04 17:05:08 +010030 help check-help print-% \
Alex Bennée369dbbe2023-06-30 19:03:55 +010031 docker docker-% lcitool-refresh vm-help vm-test vm-build-%
Fam Zhengeaa2ddb2015-05-22 13:35:07 +080032
Paolo Bonzini2b8575b2020-10-15 12:20:02 -040033all:
34.PHONY: all clean distclean recurse-all dist msi FORCE
35
36# Don't try to regenerate Makefile or configure
37# We don't generate any of them
38Makefile: ;
39configure: ;
40
Lluís Vilanova250b0862012-03-06 19:50:38 +010041# All following code might depend on configuration variables
aurel3255d7e8f2009-04-15 14:42:57 +000042ifneq ($(wildcard config-host.mak),)
pbrookad064842006-04-16 12:41:07 +000043include config-host.mak
Peter Maydelld1bd2422012-10-19 14:54:23 +010044
Paolo Bonzinib898bf22022-09-29 12:42:05 +010045include Makefile.prereqs
46Makefile.prereqs: config-host.mak
47
Paolo Bonzini09e93322020-08-13 09:28:11 -040048# 0. ensure the build tree is okay
Paolo Bonzinia5665052019-06-10 12:05:14 +020049
Peter Maydelld1bd2422012-10-19 14:54:23 +010050# Check that we're not trying to do an out-of-tree build from
51# a tree that's been used for an in-tree build.
52ifneq ($(realpath $(SRC_PATH)),$(realpath .))
53ifneq ($(wildcard $(SRC_PATH)/config-host.mak),)
54$(error This is an out of tree build but your source tree ($(SRC_PATH)) \
55seems to have been used for an in-tree build. You can fix this by running \
Philippe Mathieu-Daudéb98a3ba2017-11-21 06:55:10 -030056"$(MAKE) distclean && rm -rf *-linux-user *-softmmu" in your source tree)
Peter Maydelld1bd2422012-10-19 14:54:23 +010057endif
58endif
59
Paolo Bonzini2b8575b2020-10-15 12:20:02 -040060# force a rerun of configure if config-host.mak is too old or corrupted
61ifeq ($(MESON),)
62.PHONY: config-host.mak
63x := $(shell rm -rf meson-private meson-info meson-logs)
64endif
65ifeq ($(NINJA),)
66.PHONY: config-host.mak
67x := $(shell rm -rf meson-private meson-info meson-logs)
Paolo Bonzini5914ef72020-10-23 08:34:54 -040068else
69export NINJA
Paolo Bonzini2b8575b2020-10-15 12:20:02 -040070endif
71ifeq ($(wildcard build.ninja),)
72.PHONY: config-host.mak
73x := $(shell rm -rf meson-private meson-info meson-logs)
74endif
Paolo Bonzini16bf7a32020-10-16 03:19:14 -040075ifeq ($(origin prefix),file)
76.PHONY: config-host.mak
77x := $(shell rm -rf meson-private meson-info meson-logs)
78endif
Paolo Bonzini2b8575b2020-10-15 12:20:02 -040079
Paolo Bonzini09e93322020-08-13 09:28:11 -040080# 1. ensure config-host.mak is up-to-date
Akihiko Odaki7e270af2022-06-25 00:02:58 +090081config-host.mak: $(SRC_PATH)/configure $(SRC_PATH)/scripts/meson-buildoptions.sh $(SRC_PATH)/VERSION
Paolo Bonzini5914ef72020-10-23 08:34:54 -040082 @echo config-host.mak is out-of-date, running configure
Paolo Bonzinia5665052019-06-10 12:05:14 +020083 @if test -f meson-private/coredata.dat; then \
84 ./config.status --skip-meson; \
85 else \
Paolo Bonzini6c5f8932023-05-23 17:56:33 +020086 ./config.status; \
Paolo Bonzinia5665052019-06-10 12:05:14 +020087 fi
Emilio G. Cota26fffe22018-10-21 13:56:29 -040088
Paolo Bonzini5914ef72020-10-23 08:34:54 -040089# 2. meson.stamp exists if meson has run at least once (so ninja reconfigure
90# works), but otherwise never needs to be updated
Paolo Bonzini6c5f8932023-05-23 17:56:33 +020091
Paolo Bonzini5914ef72020-10-23 08:34:54 -040092meson-private/coredata.dat: meson.stamp
93meson.stamp: config-host.mak
94 @touch meson.stamp
95
Paolo Bonzini6c5f8932023-05-23 17:56:33 +020096# 3. ensure meson-generated build files are up-to-date
Paolo Bonzini09e93322020-08-13 09:28:11 -040097
98ifneq ($(NINJA),)
Paolo Bonzini09e93322020-08-13 09:28:11 -040099Makefile.ninja: build.ninja
Paolo Bonzini5914ef72020-10-23 08:34:54 -0400100 $(quiet-@){ \
101 echo 'ninja-targets = \'; \
102 $(NINJA) -t targets all | sed 's/:.*//; $$!s/$$/ \\/'; \
103 echo 'build-files = \'; \
104 $(NINJA) -t query build.ninja | sed -n '1,/^ input:/d; /^ outputs:/q; s/$$/ \\/p'; \
105 } > $@.tmp && mv $@.tmp $@
Paolo Bonzini09e93322020-08-13 09:28:11 -0400106-include Makefile.ninja
Paolo Bonzinib0fcc6f2023-05-19 19:32:56 +0200107endif
Paolo Bonzini5914ef72020-10-23 08:34:54 -0400108
Paolo Bonzinib0fcc6f2023-05-19 19:32:56 +0200109ifneq ($(MESON),)
Paolo Bonzini6c5f8932023-05-23 17:56:33 +0200110# The path to meson always points to pyvenv/bin/meson, but the absolute
111# paths could change. In that case, force a regeneration of build.ninja.
112# Note that this invocation of $(NINJA), just like when Make rebuilds
113# Makefiles, does not include -n.
Paolo Bonzini5914ef72020-10-23 08:34:54 -0400114build.ninja: build.ninja.stamp
Paolo Bonzinifc5db022020-12-16 13:13:40 +0100115$(build-files):
Paolo Bonzini5914ef72020-10-23 08:34:54 -0400116build.ninja.stamp: meson.stamp $(build-files)
Paolo Bonzini6c5f8932023-05-23 17:56:33 +0200117 @if test "$$(cat build.ninja.stamp)" = "$(MESON)" && test -n "$(NINJA)"; then \
118 $(NINJA) build.ninja; \
119 else \
120 echo "$(MESON) setup --reconfigure $(SRC_PATH)"; \
121 $(MESON) setup --reconfigure $(SRC_PATH); \
122 fi && echo "$(MESON)" > $@
Paolo Bonzini09e93322020-08-13 09:28:11 -0400123
Paolo Bonzini5914ef72020-10-23 08:34:54 -0400124Makefile.mtest: build.ninja scripts/mtest2make.py
Paolo Bonzini09e93322020-08-13 09:28:11 -0400125 $(MESON) introspect --targets --tests --benchmarks | $(PYTHON) scripts/mtest2make.py > $@
126-include Makefile.mtest
Paolo Bonzini61d63092021-10-07 15:08:28 +0200127
128.PHONY: update-buildoptions
129all update-buildoptions: $(SRC_PATH)/scripts/meson-buildoptions.sh
130$(SRC_PATH)/scripts/meson-buildoptions.sh: $(SRC_PATH)/meson_options.txt
131 $(MESON) introspect --buildoptions $(SRC_PATH)/meson.build | $(PYTHON) \
132 scripts/meson-buildoptions.py > $@.tmp && mv $@.tmp $@
Paolo Bonzini09e93322020-08-13 09:28:11 -0400133endif
134
Paolo Bonzini5914ef72020-10-23 08:34:54 -0400135# 4. Rules to bridge to other makefiles
Paolo Bonzini09e93322020-08-13 09:28:11 -0400136
137ifneq ($(NINJA),)
Alexey Neyman14833e22021-07-21 19:08:46 -0700138# Filter out long options to avoid flags like --no-print-directory which
139# may result in false positive match for MAKE.n
140MAKE.n = $(findstring n,$(firstword $(filter-out --%,$(MAKEFLAGS))))
141MAKE.k = $(findstring k,$(firstword $(filter-out --%,$(MAKEFLAGS))))
142MAKE.q = $(findstring q,$(firstword $(filter-out --%,$(MAKEFLAGS))))
Paolo Bonzinic8e6cfb2020-10-26 11:58:54 -0400143MAKE.nq = $(if $(word 2, $(MAKE.n) $(MAKE.q)),nq)
Matheus Tavares Bernardinof9a7c442024-04-12 09:58:38 +0200144NINJAFLAGS = \
145 $(if $V,-v) \
146 $(if $(MAKE.n), -n) \
147 $(if $(MAKE.k), -k0) \
148 $(filter-out -j, \
149 $(or $(filter -l% -j%, $(MAKEFLAGS)), \
150 $(if $(filter --jobserver-auth=%, $(MAKEFLAGS)),, -j1))) \
Paolo Bonzini231ca962022-05-27 16:35:43 +0100151 -d keepdepfile
Paolo Bonzini09e93322020-08-13 09:28:11 -0400152ninja-cmd-goals = $(or $(MAKECMDGOALS), all)
Paolo Bonzini9ee37d32022-09-14 16:19:36 +0200153ninja-cmd-goals += $(foreach g, $(MAKECMDGOALS), $(.ninja-goals.$g))
Paolo Bonzini09e93322020-08-13 09:28:11 -0400154
Peter Maydell6e6761d2023-01-10 15:12:50 +0000155makefile-targets := build.ninja ctags TAGS cscope dist clean
Paolo Bonzini5914ef72020-10-23 08:34:54 -0400156# "ninja -t targets" also lists all prerequisites. If build system
157# files are marked as PHONY, however, Make will always try to execute
158# "ninja build.ninja".
159ninja-targets := $(filter-out $(build-files) $(makefile-targets), $(ninja-targets))
Paolo Bonzini09e93322020-08-13 09:28:11 -0400160.PHONY: $(ninja-targets) run-ninja
161$(ninja-targets): run-ninja
162
163# Use "| cat" to give Ninja a more "make-y" output. Use "+" to bypass the
164# --output-sync line.
165run-ninja: config-host.mak
166ifneq ($(filter $(ninja-targets), $(ninja-cmd-goals)),)
Paolo Bonzini231ca962022-05-27 16:35:43 +0100167 +$(if $(MAKE.nq),@:,$(quiet-@)$(NINJA) $(NINJAFLAGS) \
168 $(sort $(filter $(ninja-targets), $(ninja-cmd-goals))) | cat)
Paolo Bonzini09e93322020-08-13 09:28:11 -0400169endif
170endif
171
Paolo Bonzini2b8575b2020-10-15 12:20:02 -0400172else # config-host.mak does not exist
Fam Zhengeaa2ddb2015-05-22 13:35:07 +0800173ifneq ($(filter-out $(UNCHECKED_GOALS),$(MAKECMDGOALS)),$(if $(MAKECMDGOALS),,fail))
Steve Sistare6fd87e72023-04-19 06:08:20 -0700174$(error Please call configure before running make)
aurel3255d7e8f2009-04-15 14:42:57 +0000175endif
Paolo Bonzini2b8575b2020-10-15 12:20:02 -0400176endif # config-host.mak does not exist
bellard766a4872003-02-18 23:35:48 +0000177
Paolo Bonzini660f7932020-09-01 12:10:05 -0400178SUBDIR_MAKEFLAGS=$(if $(V),,--no-print-directory --quiet)
Paul Brooka992fe32009-11-22 16:25:30 +0000179
Fam Zheng46e7b702016-06-01 10:23:31 +0800180include $(SRC_PATH)/tests/Makefile.include
Paolo Bonzini992aeb82012-12-21 08:34:49 +0100181
Paolo Bonzini484e2cc2019-12-12 13:30:36 +0100182all: recurse-all
Marc-André Lureau675b9b52019-02-12 17:25:23 +0100183
Paolo Bonzini2a5919a2023-08-30 12:05:08 +0200184SUBDIR_RULES=$(foreach t, all clean distclean, $(addsuffix /$(t), $(SUBDIRS)))
185.PHONY: $(SUBDIR_RULES)
186$(SUBDIR_RULES):
Paolo Bonzini49b7d742020-08-31 08:36:27 -0400187 $(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C $(dir $@) V="$(V)" TARGET_DIR="$(dir $@)" $(notdir $@),)
Paul Brookc05ac892009-07-31 13:18:32 +0100188
Paolo Bonzini2a5919a2023-08-30 12:05:08 +0200189ifneq ($(filter contrib/plugins, $(SUBDIRS)),)
190.PHONY: plugins
191plugins: contrib/plugins/all
192endif
193
Paolo Bonzini5e6d1572020-08-05 13:05:13 +0200194.PHONY: recurse-all recurse-clean
Paolo Bonzini2a5919a2023-08-30 12:05:08 +0200195recurse-all: $(addsuffix /all, $(SUBDIRS))
196recurse-clean: $(addsuffix /clean, $(SUBDIRS))
197recurse-distclean: $(addsuffix /distclean, $(SUBDIRS))
bellard83f64092006-08-01 16:21:11 +0000198
Paolo Bonzini3bc2f572012-11-16 18:35:27 +0100199######################################################################
bellard4fb240a2007-11-07 19:24:02 +0000200
Paolo Bonzini09e93322020-08-13 09:28:11 -0400201clean: recurse-clean
Paolo Bonzini1023e002020-11-05 07:44:56 -0500202 -$(quiet-@)test -f build.ninja && $(NINJA) $(NINJAFLAGS) -t clean || :
203 -$(quiet-@)test -f build.ninja && $(NINJA) $(NINJAFLAGS) clean-ctlist || :
Alex Bennée029e2da2022-02-04 20:43:12 +0000204 find . \( -name '*.so' -o -name '*.dll' -o \
205 -name '*.[oda]' -o -name '*.gcno' \) -type f \
Laszlo Ersek23858f42019-02-04 17:03:21 +0100206 ! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-aarch64.a \
207 ! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-arm.a \
Laszlo Ersek23858f42019-02-04 17:03:21 +0100208 -exec rm {} +
Paolo Bonzini9da9be22021-10-13 13:51:32 +0200209 rm -f TAGS cscope.* *~ */*~
Paolo Bonzinic7e618d2023-11-03 10:00:04 +0100210 @$(MAKE) -Ctests/qemu-iotests clean
bellard31e31b82003-02-18 22:55:36 +0000211
Paolo Bonzini859aef02020-08-04 18:14:26 +0200212VERSION = $(shell cat $(SRC_PATH)/VERSION)
Anthony Liguori34bb4432012-07-17 13:33:32 -0500213
214dist: qemu-$(VERSION).tar.bz2
215
216qemu-%.tar.bz2:
217 $(SRC_PATH)/scripts/make-release "$(SRC_PATH)" "$(patsubst qemu-%.tar.bz2,%,$@)"
218
Paolo Bonzini4a3447e2022-09-29 12:41:56 +0100219distclean: clean recurse-distclean
Paolo Bonzini1023e002020-11-05 07:44:56 -0500220 -$(quiet-@)test -f build.ninja && $(NINJA) $(NINJAFLAGS) -t clean -g || :
Juan Quintelad31d2402023-03-01 12:19:10 +0100221 rm -f config-host.mak Makefile.prereqs
Paolo Bonzinic7022a72022-09-29 12:42:07 +0100222 rm -f tests/tcg/*/config-target.mak tests/tcg/config-host.mak
Paolo Bonzini9da9be22021-10-13 13:51:32 +0200223 rm -f config.status
224 rm -f roms/seabios/config.mak
Emilio G. Cota26fffe22018-10-21 13:56:29 -0400225 rm -f qemu-plugins-ld.symbols qemu-plugins-ld64.symbols
Paolo Bonzini64ed6f92020-08-03 17:04:25 +0200226 rm -f *-config-target.h *-config-devices.mak *-config-devices.h
Paolo Bonzinia5665052019-06-10 12:05:14 +0200227 rm -rf meson-private meson-logs meson-info compile_commands.json
Paolo Bonzini5914ef72020-10-23 08:34:54 -0400228 rm -f Makefile.ninja Makefile.mtest build.ninja.stamp meson.stamp
Alexandre Raymond793553a2011-07-25 23:56:02 -0400229 rm -f config.log
Peter Maydell67ed96f2012-02-01 18:50:42 +0000230 rm -f linux-headers/asm
Juan Quintelad31d2402023-03-01 12:19:10 +0100231 rm -Rf .sdk qemu-bundle
bellard7d132992003-03-06 23:23:54 +0000232
Peter Xuaf7d1062021-08-04 09:23:28 -0400233find-src-path = find "$(SRC_PATH)" -path "$(SRC_PATH)/meson" -prune -o \
234 -type l -prune -o \( -name "*.[chsS]" -o -name "*.[ch].inc" \)
Greg Kurzc857f902020-09-03 21:47:55 +0200235
Greg Kurzd7986402020-09-01 16:20:10 +0200236.PHONY: ctags
237ctags:
Alex Bennéef2c78152021-01-14 16:57:23 +0000238 $(call quiet-command, \
239 rm -f "$(SRC_PATH)/"tags, \
240 "CTAGS", "Remove old tags")
241 $(call quiet-command, \
242 $(find-src-path) -exec ctags \
243 -f "$(SRC_PATH)/"tags --append {} +, \
244 "CTAGS", "Re-index $(SRC_PATH)")
Greg Kurzd7986402020-09-01 16:20:10 +0200245
Alex Bennéeb8a32252021-01-14 16:57:20 +0000246.PHONY: gtags
247gtags:
248 $(call quiet-command, \
249 rm -f "$(SRC_PATH)/"GTAGS; \
250 rm -f "$(SRC_PATH)/"GRTAGS; \
251 rm -f "$(SRC_PATH)/"GPATH, \
252 "GTAGS", "Remove old $@ files")
253 $(call quiet-command, \
254 (cd $(SRC_PATH) && \
Peter Xub8c9ed12021-08-04 09:23:27 -0400255 $(find-src-path) -print | gtags -f -), \
Alex Bennéeb8a32252021-01-14 16:57:20 +0000256 "GTAGS", "Re-index $(SRC_PATH)")
257
Greg Kurzd7986402020-09-01 16:20:10 +0200258.PHONY: TAGS
259TAGS:
Alex Bennéeaf5d5762021-01-14 16:57:24 +0000260 $(call quiet-command, \
261 rm -f "$(SRC_PATH)/"TAGS, \
262 "TAGS", "Remove old $@")
263 $(call quiet-command, \
264 $(find-src-path) -exec etags \
265 -f "$(SRC_PATH)/"TAGS --append {} +, \
266 "TAGS", "Re-index $(SRC_PATH)")
Greg Kurzd7986402020-09-01 16:20:10 +0200267
268.PHONY: cscope
269cscope:
Alex Bennée3e6c1472021-01-14 16:57:25 +0000270 $(call quiet-command, \
271 rm -f "$(SRC_PATH)/"cscope.* , \
272 "cscope", "Remove old $@ files")
273 $(call quiet-command, \
274 ($(find-src-path) -print | sed -e 's,^\./,,' \
275 > "$(SRC_PATH)/cscope.files"), \
276 "cscope", "Create file list")
277 $(call quiet-command, \
278 cscope -b -i"$(SRC_PATH)/cscope.files" \
279 -f"$(SRC_PATH)"/cscope.out, \
280 "cscope", "Re-index $(SRC_PATH)")
Greg Kurzd7986402020-09-01 16:20:10 +0200281
Paolo Bonzinia5665052019-06-10 12:05:14 +0200282# Needed by "meson install"
283export DESTDIR
bellard612384d2003-03-22 17:31:19 +0000284
Daniel P. Berrangé4ebb0402022-01-05 13:49:42 +0000285include $(SRC_PATH)/tests/lcitool/Makefile.include
Fam Zheng324027c2016-06-01 12:25:17 +0800286include $(SRC_PATH)/tests/docker/Makefile.include
Fam Zhengb1fb9a62017-09-05 10:11:58 +0800287include $(SRC_PATH)/tests/vm/Makefile.include
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400288
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100289print-help-run = printf " %-30s - %s\\n" "$1" "$2"
Greg Kurz784106e2020-11-05 16:47:00 +0100290print-help = @$(call print-help-run,$1,$2)
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100291
Richard Henderson335b8f72023-09-29 13:43:50 -0700292.PHONY: update-linux-vdso
293update-linux-vdso:
294 @for m in $(SRC_PATH)/linux-user/*/Makefile.vdso; do \
295 $(MAKE) $(SUBDIR_MAKEFLAGS) -C $$(dirname $$m) -f Makefile.vdso \
296 SRC_PATH=$(SRC_PATH) BUILD_DIR=$(BUILD_DIR); \
297 done
298
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400299.PHONY: help
300help:
301 @echo 'Generic targets:'
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100302 $(call print-help,all,Build all)
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100303 $(call print-help,dir/file.o,Build specified target only)
304 $(call print-help,install,Install QEMU, documentation and tools)
Alex Bennéeb8a32252021-01-14 16:57:20 +0000305 $(call print-help,ctags/gtags/TAGS,Generate tags file for editors)
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100306 $(call print-help,cscope,Generate cscope index)
Paolo Bonzini968b4db2020-02-03 14:45:33 +0100307 $(call print-help,sparse,Run sparse on the QEMU source)
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400308 @echo ''
Paolo Bonzini2a5919a2023-08-30 12:05:08 +0200309ifneq ($(filter contrib/plugins, $(SUBDIRS)),)
Alex Bennéec17a3862020-09-09 12:27:41 +0100310 @echo 'Plugin targets:'
311 $(call print-help,plugins,Build the example TCG plugins)
312 @echo ''
313endif
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400314 @echo 'Cleaning targets:'
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100315 $(call print-help,clean,Remove most generated files but keep the config)
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100316 $(call print-help,distclean,Remove all generated files)
317 $(call print-help,dist,Build a distributable tarball)
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400318 @echo ''
Richard Henderson335b8f72023-09-29 13:43:50 -0700319 @echo 'Linux-user targets:'
320 $(call print-help,update-linux-vdso,Build linux-user vdso images)
321 @echo ''
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400322 @echo 'Test targets:'
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100323 $(call print-help,check,Run all tests (check-help for details))
Paolo Bonzini9ed72472020-09-02 07:25:19 -0400324 $(call print-help,bench,Run all benchmarks)
Daniel P. Berrangé4ebb0402022-01-05 13:49:42 +0000325 $(call print-help,lcitool-help,Help about targets for managing build environment manifests)
Alex Bennée6147c242021-02-02 13:39:50 +0000326 $(call print-help,docker-help,Help about targets running tests inside containers)
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100327 $(call print-help,vm-help,Help about targets running tests inside VM)
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400328 @echo ''
329 @echo 'Documentation targets:'
Peter Maydell4ac2ee12020-09-25 17:23:04 +0100330 $(call print-help,html man,Build documentation in specified format)
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400331 @echo ''
Paolo Bonzini1f2146f2023-08-30 11:39:45 +0200332ifneq ($(filter msi, $(ninja-targets)),)
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400333 @echo 'Windows targets:'
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100334 $(call print-help,installer,Build NSIS-based installer for QEMU)
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100335 $(call print-help,msi,Build MSI-based installer for qemu-ga)
Marc-André Lureau0d8e0652016-09-13 18:20:33 +0400336 @echo ''
337endif
Philippe Mathieu-Daudéc355de52020-03-05 01:48:54 +0100338 $(call print-help,$(MAKE) [targets],(quiet build, default))
339 $(call print-help,$(MAKE) V=1 [targets],(verbose build))
Paolo Bonzini660f7932020-09-01 12:10:05 -0400340
341# will delete the target of a rule if commands exit with a nonzero exit status
342.DELETE_ON_ERROR:
343
344print-%:
345 @echo '$*=$($*)'