3 ifneq ($(words $(subst :, ,$(CURDIR
))), 1)
4 $(error main directory cannot contain spaces nor colons
)
7 # Always point to the root of the build tree (needs GNU make).
10 # Before including a proper config-host.mak, assume we are in the source tree
13 UNCHECKED_GOALS
:= %clean TAGS cscope ctags
dist \
15 help check-help print-
% \
16 docker docker-
% vm-help vm-test vm-build-
%
18 # All following code might depend on configuration variables
19 ifneq ($(wildcard config-host.mak
),)
20 # Put the all: rule here so that config-host.mak can contain dependencies.
22 include config-host.mak
26 .PHONY
: git-submodule-update
28 git_module_status
:= $(shell \
30 GIT
="$(GIT)" .
/scripts
/git-submodule.sh status
$(GIT_SUBMODULES
); \
34 ifeq (1,$(git_module_status
))
35 ifeq (no
,$(GIT_UPDATE
))
37 $(call quiet-command
, \
39 echo
"GIT submodule checkout is out of date. Please run" && \
40 echo
" scripts/git-submodule.sh update $(GIT_SUBMODULES)" && \
41 echo
"from the source directory checkout $(SRC_PATH)" && \
46 $(call quiet-command
, \
47 (cd
$(SRC_PATH
) && GIT
="$(GIT)" .
/scripts
/git-submodule.sh update
$(GIT_SUBMODULES
)), \
48 "GIT","$(GIT_SUBMODULES)")
52 export NINJA
=.
/ninjatool
54 # Running meson regenerates both build.ninja and ninjatool, and that is
55 # enough to prime the rest of the build.
56 ninjatool
: build.ninja
58 # Only needed in case Makefile.ninja does not exist.
59 .PHONY
: ninja-clean ninja-distclean clean-ctlist
63 build.ninja
: config-host.mak
65 Makefile.ninja
: build.ninja ninjatool
66 .
/ninjatool
-t ninja2make
--omit
clean dist uninstall < $< > $@
67 -include Makefile.ninja
69 ${ninja-targets-c_COMPILER
} ${ninja-targets-cpp_COMPILER
}: .var.command
+= -MP
71 # If MESON is empty, the rule will be re-evaluated after Makefiles are
72 # reread (and MESON won't be empty anymore).
74 Makefile.mtest
: build.ninja scripts
/mtest2make.py
75 $(MESON
) introspect
--tests |
$(PYTHON
) scripts
/mtest2make.py
> $@
76 -include Makefile.mtest
79 .git-submodule-status
: git-submodule-update config-host.mak
81 # Check that we're not trying to do an out-of-tree build from
82 # a tree that's been used for an in-tree build.
83 ifneq ($(realpath
$(SRC_PATH
)),$(realpath .
))
84 ifneq ($(wildcard $(SRC_PATH
)/config-host.mak
),)
85 $(error This is an out of tree build but your source tree
($(SRC_PATH
)) \
86 seems to have been used for an in-tree build. You can fix this by running \
87 "$(MAKE) distclean && rm -rf *-linux-user *-softmmu" in your source tree
)
91 CONFIG_SOFTMMU
:= $(if
$(filter %-softmmu
,$(TARGET_DIRS
)),y
)
92 CONFIG_USER_ONLY
:= $(if
$(filter %-user
,$(TARGET_DIRS
)),y
)
93 CONFIG_XEN
:= $(CONFIG_XEN_BACKEND
)
95 -include config-all-devices.mak
96 -include config-all-disas.mak
98 config-host.mak
: $(SRC_PATH
)/configure
$(SRC_PATH
)/pc-bios
$(SRC_PATH
)/VERSION
99 @echo
$@ is out-of-date
, running configure
100 @if
test -f meson-private
/coredata.dat
; then \
101 .
/config.status
--skip-meson
; \
106 # Force configure to re-run if the API symbols are updated
107 ifeq ($(CONFIG_PLUGIN
),y
)
108 config-host.mak
: $(SRC_PATH
)/plugins
/qemu-plugins.symbols
113 ifneq ($(filter-out $(UNCHECKED_GOALS
),$(MAKECMDGOALS
)),$(if
$(MAKECMDGOALS
),,fail
))
114 @echo
"Please call configure before running make!"
119 include $(SRC_PATH
)/rules.mak
121 # lor is defined in rules.mak
122 CONFIG_BLOCK
:= $(call lor
,$(CONFIG_SOFTMMU
),$(CONFIG_TOOLS
))
124 # Create QEMU_PKGVERSION and FULL_VERSION strings
125 # If PKGVERSION is set, use that; otherwise get version and -dirty status from git
126 QEMU_PKGVERSION
:= $(if
$(PKGVERSION
),$(PKGVERSION
),$(shell \
128 if
test -e .git
; then \
129 git describe
--match
'v*' 2>/dev
/null | tr
-d
'\n'; \
130 if
! git diff-index
--quiet HEAD
&>/dev
/null
; then \
135 # Either "version (pkgversion)", or just "version" if pkgversion not set
136 FULL_VERSION
:= $(if
$(QEMU_PKGVERSION
),$(VERSION
) ($(QEMU_PKGVERSION
)),$(VERSION
))
138 generated-files-y
= qemu-version.h config-host.h qemu-options.def
140 generated-files-y
+= module_block.h
142 generated-files-y
+= .git-submodule-status
144 edk2-decompressed
= $(basename $(wildcard pc-bios
/edk2-
*.fd.bz2
))
145 pc-bios
/edk2-
%.fd
: pc-bios
/edk2-
%.fd.bz2
146 $(call quiet-command
,bzip2
-d
-c
$< > $@
,"BUNZIP2",$<)
148 # Don't try to regenerate Makefile or configure
149 # We don't generate any of them
153 .PHONY
: all clean cscope
distclean html
info install install-doc \
154 pdf txt recurse-all
dist msi FORCE
156 $(call set-vpath
, $(SRC_PATH
))
158 LIBS
+=-lz
$(LIBS_TOOLS
)
160 HELPERS-y
= $(HELPERS
)
162 # Sphinx does not allow building manuals into the same directory as
163 # the source files, so if we're doing an in-tree QEMU build we must
164 # build the manuals into a subdirectory (and then install them from
165 # there for 'make install'). For an out-of-tree build we can just
166 # use the docs/ subdirectory in the build tree as normal.
167 ifeq ($(realpath
$(SRC_PATH
)),$(realpath .
))
168 MANUAL_BUILDDIR
:= docs
/built
170 MANUAL_BUILDDIR
:= docs
174 DOCS
+=$(MANUAL_BUILDDIR
)/system
/qemu
.1
175 DOCS
+=$(MANUAL_BUILDDIR
)/tools
/qemu-img
.1
176 DOCS
+=$(MANUAL_BUILDDIR
)/tools
/qemu-nbd
.8
177 DOCS
+=$(MANUAL_BUILDDIR
)/interop
/qemu-ga
.8
178 ifeq ($(CONFIG_LINUX
)$(CONFIG_SECCOMP
)$(CONFIG_LIBCAP_NG
),yyy
)
179 DOCS
+=$(MANUAL_BUILDDIR
)/tools
/virtiofsd
.1
181 DOCS
+=$(MANUAL_BUILDDIR
)/system
/qemu-block-drivers
.7
182 DOCS
+=docs
/interop
/qemu-qmp-ref.html docs
/interop
/qemu-qmp-ref.txt docs
/interop
/qemu-qmp-ref
.7
183 DOCS
+=docs
/interop
/qemu-ga-ref.html docs
/interop
/qemu-ga-ref.txt docs
/interop
/qemu-ga-ref
.7
184 DOCS
+=$(MANUAL_BUILDDIR
)/system
/qemu-cpu-models
.7
185 DOCS
+=$(MANUAL_BUILDDIR
)/index.html
187 DOCS
+=$(MANUAL_BUILDDIR
)/tools
/virtfs-proxy-helper
.1
189 ifdef CONFIG_TRACE_SYSTEMTAP
190 DOCS
+=$(MANUAL_BUILDDIR
)/tools
/qemu-trace-stap
.1
196 SUBDIR_MAKEFLAGS
=$(if
$(V
),,--no-print-directory
--quiet
) BUILD_DIR
=$(BUILD_DIR
)
197 SUBDIR_DEVICES_MAK
=$(patsubst %, %/config-devices.mak
, $(filter %-softmmu
, $(TARGET_DIRS
)))
198 SUBDIR_DEVICES_MAK_DEP
=$(patsubst %, %.d
, $(SUBDIR_DEVICES_MAK
))
200 ifeq ($(SUBDIR_DEVICES_MAK
),)
201 config-all-devices.mak
: config-host.mak
202 $(call quiet-command
,echo
'# no devices' > $@
,"GEN","$@")
204 config-all-devices.mak
: $(SUBDIR_DEVICES_MAK
) config-host.mak
205 $(call quiet-command
, sed
-n \
206 's|^\([^=]*\)=\(.*\)$$|\1:=$$(findstring y,$$(\1)\2)|p' \
207 $(SUBDIR_DEVICES_MAK
) |
sort -u
> $@
, \
211 -include $(SUBDIR_DEVICES_MAK_DEP
)
213 # This has to be kept in sync with Kconfig.host.
215 $(CONFIG_MINIKCONF_MODE
) \
216 $@
$*/config-devices.mak.d
$< $(SRC_PATH
)/Kconfig \
217 CONFIG_TCG
=$(CONFIG_TCG
) \
218 CONFIG_KVM
=$(CONFIG_KVM
) \
219 CONFIG_SPICE
=$(CONFIG_SPICE
) \
220 CONFIG_IVSHMEM
=$(CONFIG_IVSHMEM
) \
221 CONFIG_TPM
=$(CONFIG_TPM
) \
222 CONFIG_XEN
=$(CONFIG_XEN
) \
223 CONFIG_OPENGL
=$(CONFIG_OPENGL
) \
224 CONFIG_X11
=$(CONFIG_X11
) \
225 CONFIG_VHOST_USER
=$(CONFIG_VHOST_USER
) \
226 CONFIG_VHOST_KERNEL
=$(CONFIG_VHOST_KERNEL
) \
227 CONFIG_VIRTFS
=$(CONFIG_VIRTFS
) \
228 CONFIG_LINUX
=$(CONFIG_LINUX
) \
229 CONFIG_PVRDMA
=$(CONFIG_PVRDMA
)
231 MINIKCONF
= $(PYTHON
) $(SRC_PATH
)/scripts
/minikconf.py
233 $(SUBDIR_DEVICES_MAK
): %/config-devices.mak
: default-configs
/%.mak
$(SRC_PATH
)/Kconfig
$(BUILD_DIR
)/config-host.mak
234 $(call quiet-command
, $(MINIKCONF
) $(MINIKCONF_ARGS
) \
235 > $@.tmp
, "GEN", "$@.tmp")
236 $(call quiet-command
, if
test -f
$@
; then \
237 if cmp
-s
$@.old
$@
; then \
241 if
test -f
$@.old
; then \
242 echo
"WARNING: $@ (user modified) out of date.";\
244 echo
"WARNING: $@ out of date.";\
246 echo
"Run \"$(MAKE) defconfig\" to regenerate."; \
255 rm -f config-all-devices.mak
$(SUBDIR_DEVICES_MAK
)
257 ifneq ($(wildcard config-host.mak
),)
258 include $(SRC_PATH
)/Makefile.objs
261 dummy
:= $(call unnest-vars
,, \
266 storage-daemon-obj-y \
267 storage-daemon-obj-m \
274 include $(SRC_PATH
)/tests
/Makefile.
include
276 all: $(DOCS
) $(if
$(BUILD_DOCS
),sphinxdocs
) $(TOOLS
) $(HELPERS-y
) recurse-all modules
278 qemu-version.h
: FORCE
279 $(call quiet-command
, \
280 (printf
'#define QEMU_PKGVERSION "$(QEMU_PKGVERSION)"\n'; \
281 printf
'#define QEMU_FULL_VERSION "$(FULL_VERSION)"\n'; \
283 $(call quiet-command
, if
! cmp
-s
$@
$@.tmp
; then \
289 config-host.h
: config-host.h-timestamp
290 config-host.h-timestamp
: config-host.mak
291 qemu-options.def
: $(SRC_PATH
)/qemu-options.hx
$(SRC_PATH
)/scripts
/hxtool
292 $(call quiet-command
,sh
$(SRC_PATH
)/scripts
/hxtool
-h
< $< > $@
,"GEN","$@")
294 TARGET_DIRS_RULES
:= $(foreach t
, all fuzz
clean install, $(addsuffix /$(t
), $(TARGET_DIRS
)))
296 SOFTMMU_ALL_RULES
=$(filter %-softmmu
/all, $(TARGET_DIRS_RULES
))
297 $(SOFTMMU_ALL_RULES
): $(authz-obj-y
)
298 $(SOFTMMU_ALL_RULES
): $(block-obj-y
)
299 $(SOFTMMU_ALL_RULES
): $(storage-daemon-obj-y
)
300 $(SOFTMMU_ALL_RULES
): $(chardev-obj-y
)
301 $(SOFTMMU_ALL_RULES
): $(crypto-obj-y
)
302 $(SOFTMMU_ALL_RULES
): $(io-obj-y
)
303 $(SOFTMMU_ALL_RULES
): config-all-devices.mak
304 ifdef DECOMPRESS_EDK2_BLOBS
305 $(SOFTMMU_ALL_RULES
): $(edk2-decompressed
)
308 SOFTMMU_FUZZ_RULES
=$(filter %-softmmu
/fuzz
, $(TARGET_DIRS_RULES
))
309 $(SOFTMMU_FUZZ_RULES
): $(authz-obj-y
)
310 $(SOFTMMU_FUZZ_RULES
): $(block-obj-y
)
311 $(SOFTMMU_FUZZ_RULES
): $(chardev-obj-y
)
312 $(SOFTMMU_FUZZ_RULES
): $(crypto-obj-y
)
313 $(SOFTMMU_FUZZ_RULES
): $(io-obj-y
)
314 $(SOFTMMU_FUZZ_RULES
): config-all-devices.mak
315 $(SOFTMMU_FUZZ_RULES
): $(edk2-decompressed
)
317 .PHONY
: $(TARGET_DIRS_RULES
)
318 # The $(TARGET_DIRS_RULES) are of the form SUBDIR/GOAL, so that
319 # $(dir $@) yields the sub-directory, and $(notdir $@) yields the sub-goal
320 $(TARGET_DIRS_RULES
):
321 $(call quiet-command
,$(MAKE
) $(SUBDIR_MAKEFLAGS
) -C
$(dir $@
) V
="$(V)" TARGET_DIR
="$(dir $@)" $(notdir $@
),)
323 # LIBFDT_lib="": avoid breaking existing trees with objects requiring -fPIC
324 DTC_MAKE_ARGS
=-I
$(SRC_PATH
)/dtc VPATH
=$(SRC_PATH
)/dtc
-C dtc V
="$(V)" LIBFDT_lib
=""
325 DTC_CFLAGS
=$(CFLAGS
) $(QEMU_CFLAGS
)
326 DTC_CPPFLAGS
=-I
$(SRC_PATH
)/dtc
/libfdt
329 dtc
/all: .git-submodule-status dtc
/libfdt
330 $(call quiet-command
,$(MAKE
) $(DTC_MAKE_ARGS
) CPPFLAGS
="$(DTC_CPPFLAGS)" CFLAGS
="$(DTC_CFLAGS)" LDFLAGS
="$(QEMU_LDFLAGS)" ARFLAGS
="$(ARFLAGS)" CC
="$(CC)" AR
="$(AR)" LD
="$(LD)" $(SUBDIR_MAKEFLAGS
) libfdt
,)
332 dtc
/%: .git-submodule-status
335 # Overriding CFLAGS causes us to lose defines added in the sub-makefile.
336 # Not overriding CFLAGS leads to mis-matches between compilation modes.
337 # Therefore we replicate some of the logic in the sub-makefile.
338 # Remove all the extra -Warning flags that QEMU uses that Capstone doesn't;
339 # no need to annoy QEMU developers with such things.
340 CAP_CFLAGS
= $(patsubst -W
%,,$(CFLAGS
) $(QEMU_CFLAGS
))
341 CAP_CFLAGS
+= -DCAPSTONE_USE_SYS_DYN_MEM
342 CAP_CFLAGS
+= -DCAPSTONE_HAS_ARM
343 CAP_CFLAGS
+= -DCAPSTONE_HAS_ARM64
344 CAP_CFLAGS
+= -DCAPSTONE_HAS_POWERPC
345 CAP_CFLAGS
+= -DCAPSTONE_HAS_X86
348 capstone
/all: .git-submodule-status
349 $(call quiet-command
,$(MAKE
) -C
$(SRC_PATH
)/capstone CAPSTONE_SHARED
=no BUILDDIR
="$(BUILD_DIR)/capstone" CC
="$(CC)" AR
="$(AR)" LD
="$(LD)" RANLIB
="$(RANLIB)" CFLAGS
="$(CAP_CFLAGS)" $(SUBDIR_MAKEFLAGS
) $(BUILD_DIR
)/capstone
/$(LIBCAPSTONE
))
352 slirp
/all: .git-submodule-status
353 $(call quiet-command
,$(MAKE
) -C
$(SRC_PATH
)/slirp \
354 BUILD_DIR
="$(BUILD_DIR)/slirp" \
355 PKG_CONFIG
="$(PKG_CONFIG)" \
356 CC
="$(CC)" AR
="$(AR)" LD
="$(LD)" RANLIB
="$(RANLIB)" \
357 CFLAGS
="$(QEMU_CFLAGS) $(CFLAGS)" LDFLAGS
="$(QEMU_LDFLAGS)")
359 $(filter %/all, $(TARGET_DIRS_RULES
)): libqemuutil.a
$(common-obj-y
) \
362 $(filter %/fuzz
, $(TARGET_DIRS_RULES
)): libqemuutil.a
$(common-obj-y
) \
363 $(qom-obj-y
) $(crypto-user-obj-
$(CONFIG_USER_ONLY
))
365 ROM_DIRS
= $(addprefix pc-bios
/, $(ROMS
))
366 ROM_DIRS_RULES
=$(foreach t
, all clean, $(addsuffix /$(t
), $(ROM_DIRS
)))
367 # Only keep -O and -g cflags
368 .PHONY
: $(ROM_DIRS_RULES
)
370 $(call quiet-command
,$(MAKE
) $(SUBDIR_MAKEFLAGS
) -C
$(dir $@
) V
="$(V)" TARGET_DIR
="$(dir $@)" CFLAGS
="$(filter -O% -g%,$(CFLAGS))" $(notdir $@
),)
372 .PHONY
: recurse-all recurse-clean recurse-install
373 recurse-all
: $(addsuffix /all, $(TARGET_DIRS
) $(ROM_DIRS
))
374 recurse-clean
: $(addsuffix /clean, $(TARGET_DIRS
) $(ROM_DIRS
))
375 recurse-install
: $(addsuffix /install, $(TARGET_DIRS
))
376 $(addsuffix /install, $(TARGET_DIRS
)): all
378 $(BUILD_DIR
)/version.o
: $(SRC_PATH
)/version.rc config-host.h
379 $(call quiet-command
,$(WINDRES
) -I
$(BUILD_DIR
) -o
$@
$<,"RC","version.o")
381 Makefile
: $(version-obj-y
)
383 ######################################################################
385 COMMON_LDADDS
= libqemuutil.a
387 qemu-img.o
: qemu-img-cmds.h
389 qemu-img
$(EXESUF
): qemu-img.o
$(authz-obj-y
) $(block-obj-y
) $(crypto-obj-y
) $(io-obj-y
) $(qom-obj-y
) $(COMMON_LDADDS
)
390 qemu-nbd
$(EXESUF
): qemu-nbd.o
$(authz-obj-y
) $(block-obj-y
) $(crypto-obj-y
) $(io-obj-y
) $(qom-obj-y
) $(COMMON_LDADDS
)
391 qemu-io
$(EXESUF
): qemu-io.o
$(authz-obj-y
) $(block-obj-y
) $(crypto-obj-y
) $(io-obj-y
) $(qom-obj-y
) $(COMMON_LDADDS
)
392 qemu-storage-daemon
$(EXESUF
): qemu-storage-daemon.o
$(authz-obj-y
) $(block-obj-y
) $(crypto-obj-y
) $(chardev-obj-y
) $(io-obj-y
) $(qom-obj-y
) $(storage-daemon-obj-y
) $(COMMON_LDADDS
)
394 scsi
/qemu-pr-helper
$(EXESUF
): scsi
/qemu-pr-helper.o scsi
/utils.o
$(authz-obj-y
) $(crypto-obj-y
) $(io-obj-y
) $(qom-obj-y
) $(COMMON_LDADDS
)
396 scsi
/qemu-pr-helper
$(EXESUF
): LIBS
+= -ludev
-lmultipath
-lmpathpersist
399 qemu-img-cmds.h
: $(SRC_PATH
)/qemu-img-cmds.hx
$(SRC_PATH
)/scripts
/hxtool
400 $(call quiet-command
,sh
$(SRC_PATH
)/scripts
/hxtool
-h
< $< > $@
,"GEN","$@")
402 module_block.h
: $(SRC_PATH
)/scripts
/modules
/module_block.py config-host.mak
403 $(call quiet-command
,$(PYTHON
) $< $@ \
404 $(addprefix $(SRC_PATH
)/,$(patsubst %.mo
,%.c
,$(block-obj-m
))), \
407 clean: recurse-clean ninja-clean clean-ctlist
408 -test -f ninjatool
&& .
/ninjatool
$(if
$(V
),-v
,) -t
clean
409 # avoid old build problems by removing potentially incorrect old files
410 rm -f config.mak op-i386.h opc-i386.h gen-op-i386.h op-arm.h opc-arm.h gen-op-arm.h
411 rm -f qemu-options.def
412 find . \
( -name
'*.so' -o
-name
'*.dll' -o
-name
'*.mo' -o
-name
'*.[oda]' \
) -type f \
413 ! -path .
/roms
/edk2
/ArmPkg
/Library
/GccLto
/liblto-aarch64.a \
414 ! -path .
/roms
/edk2
/ArmPkg
/Library
/GccLto
/liblto-arm.a \
415 ! -path .
/roms
/edk2
/BaseTools
/Source
/Python
/UPT
/Dll
/sqlite3.dll \
417 rm -f
$(edk2-decompressed
)
418 rm -f
$(filter-out %.tlb
,$(TOOLS
)) $(HELPERS-y
) TAGS cscope.
* *.pod
*~
*/*~
419 rm -f fsdev
/*.pod scsi
/*.pod
420 rm -f qemu-img-cmds.h
421 rm -f ui
/shader
/*-vert.h ui
/shader
/*-frag.h
422 rm -f
$(foreach f
,$(generated-files-y
),$(f
) $(f
)-timestamp
)
423 rm -f config-all-devices.mak
424 rm -f
$(SUBDIR_DEVICES_MAK
)
426 VERSION ?
= $(shell cat VERSION
)
428 dist: qemu-
$(VERSION
).
tar.bz2
431 $(SRC_PATH
)/scripts
/make-release
"$(SRC_PATH)" "$(patsubst qemu-%.tar.bz2,%,$@)"
433 define clean-manual
=
434 rm -rf
$(MANUAL_BUILDDIR
)/$1/_static
435 rm -f
$(MANUAL_BUILDDIR
)/$1/objects.inv
$(MANUAL_BUILDDIR
)/$1/searchindex.js
$(MANUAL_BUILDDIR
)/$1/*.html
438 distclean: clean ninja-distclean
439 -test -f ninjatool
&& .
/ninjatool
$(if
$(V
),-v
,) -t
clean -g
440 rm -f config-host.mak config-host.h
* $(DOCS
)
441 rm -f tests
/tcg
/config-
*.mak
442 rm -f config-all-devices.mak config-all-disas.mak config.status
443 rm -f
$(SUBDIR_DEVICES_MAK
)
444 rm -f po
/*.mo tests
/qemu-iotests
/common.env
445 rm -f roms
/seabios
/config.mak roms
/vgabios
/config.mak
446 rm -f qemu-plugins-ld.symbols qemu-plugins-ld64.symbols
447 rm -rf meson-private meson-logs meson-info compile_commands.json
448 rm -f Makefile.ninja ninjatool ninjatool.stamp Makefile.mtest
450 rm -f linux-headers
/asm
451 rm -f docs
/version.texi
452 rm -f docs
/interop
/qemu-ga-qapi.texi docs
/interop
/qemu-qmp-qapi.texi
453 rm -f docs
/interop
/qemu-qmp-ref
.7 docs
/interop
/qemu-ga-ref
.7
454 rm -f docs
/interop
/qemu-qmp-ref.txt docs
/interop
/qemu-ga-ref.txt
455 rm -f docs
/interop
/qemu-qmp-ref.pdf docs
/interop
/qemu-ga-ref.pdf
456 rm -f docs
/interop
/qemu-qmp-ref.html docs
/interop
/qemu-ga-ref.html
458 $(call clean-manual
,devel
)
459 $(call clean-manual
,interop
)
460 $(call clean-manual
,specs
)
461 $(call clean-manual
,system
)
462 $(call clean-manual
,tools
)
463 $(call clean-manual
,user
)
464 for d in
$(TARGET_DIRS
); do \
465 rm -rf
$$d || exit
1 ; \
469 KEYMAPS
=da en-gb et fr fr-ch is lt no pt-br sv \
470 ar de en-us fi fr-be hr it lv nl pl ru th \
471 de-ch es fo fr-ca hu ja mk pt sl tr \
475 BLOBS
=bios.bin bios-256k.bin bios-microvm.bin sgabios.bin vgabios.bin vgabios-cirrus.bin \
476 vgabios-stdvga.bin vgabios-vmware.bin vgabios-qxl.bin vgabios-virtio.bin \
477 vgabios-ramfb.bin vgabios-bochs-display.bin vgabios-ati.bin \
478 openbios-sparc32 openbios-sparc64 openbios-ppc QEMU
,tcx.bin QEMU
,cgthree.bin \
479 pxe-e1000.rom pxe-eepro100.rom pxe-ne2k_pci.rom \
480 pxe-pcnet.rom pxe-rtl8139.rom pxe-virtio.rom \
481 efi-e1000.rom efi-eepro100.rom efi-ne2k_pci.rom \
482 efi-pcnet.rom efi-rtl8139.rom efi-virtio.rom \
483 efi-e1000e.rom efi-vmxnet3.rom \
485 bamboo.dtb canyonlands.dtb petalogix-s3adsp1800.dtb petalogix-ml605.dtb \
486 multiboot.bin linuxboot.bin linuxboot_dma.bin kvmvapic.bin pvh.bin \
487 s390-ccw.img s390-netboot.img \
488 slof.bin skiboot.lid \
490 u-boot.e500 u-boot-sam460-20100605.bin \
494 opensbi-riscv32-sifive_u-fw_jump.bin opensbi-riscv32-virt-fw_jump.bin \
495 opensbi-riscv64-sifive_u-fw_jump.bin opensbi-riscv64-virt-fw_jump.bin
498 DESCS
=50-edk2-i386-secure.json
50-edk2-x86_64-secure.json \
499 60-edk2-aarch64.json
60-edk2-arm.json
60-edk2-i386.json
60-edk2-x86_64.json
505 # Note that we manually filter-out the non-Sphinx documentation which
506 # is currently built into the docs/interop directory in the build tree,
507 # and also any sphinx-built manpages.
508 define install-manual
=
509 for d in
$$(cd
$(MANUAL_BUILDDIR
) && find
$1 -type d
); do
$(INSTALL_DIR
) "$(DESTDIR)$(qemu_docdir)/$$d"; done
510 for f in
$$(cd
$(MANUAL_BUILDDIR
) && find
$1 -type f
-a
'!' '(' -name
'*.[0-9]' -o
-name
'qemu-*-qapi.*' -o
-name
'qemu-*-ref.*' ')' ); do
$(INSTALL_DATA
) "$(MANUAL_BUILDDIR)/$$f" "$(DESTDIR)$(qemu_docdir)/$$f"; done
513 # Note that we deliberately do not install the "devel" manual: it is
514 # for QEMU developers, and not interesting to our users.
515 .PHONY
: install-sphinxdocs
516 install-sphinxdocs
: sphinxdocs
517 $(call install-manual
,interop
)
518 $(call install-manual
,specs
)
519 $(call install-manual
,system
)
520 $(call install-manual
,tools
)
521 $(call install-manual
,user
)
523 install-doc
: $(DOCS
) install-sphinxdocs
524 $(INSTALL_DIR
) "$(DESTDIR)$(qemu_docdir)"
525 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/index.html
"$(DESTDIR)$(qemu_docdir)"
526 $(INSTALL_DIR
) "$(DESTDIR)$(qemu_docdir)/interop"
527 $(INSTALL_DATA
) docs
/interop
/qemu-qmp-ref.html
"$(DESTDIR)$(qemu_docdir)/interop"
528 $(INSTALL_DATA
) docs
/interop
/qemu-qmp-ref.txt
"$(DESTDIR)$(qemu_docdir)/interop"
530 $(INSTALL_DIR
) "$(DESTDIR)$(mandir)/man1"
531 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/system
/qemu
.1 "$(DESTDIR)$(mandir)/man1"
532 $(INSTALL_DIR
) "$(DESTDIR)$(mandir)/man7"
533 $(INSTALL_DATA
) docs
/interop
/qemu-qmp-ref
.7 "$(DESTDIR)$(mandir)/man7"
534 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/system
/qemu-block-drivers
.7 "$(DESTDIR)$(mandir)/man7"
535 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/system
/qemu-cpu-models
.7 "$(DESTDIR)$(mandir)/man7"
536 ifeq ($(CONFIG_TOOLS
),y
)
537 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/tools
/qemu-img
.1 "$(DESTDIR)$(mandir)/man1"
538 $(INSTALL_DIR
) "$(DESTDIR)$(mandir)/man8"
539 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/tools
/qemu-nbd
.8 "$(DESTDIR)$(mandir)/man8"
541 ifdef CONFIG_TRACE_SYSTEMTAP
542 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/tools
/qemu-trace-stap
.1 "$(DESTDIR)$(mandir)/man1"
544 ifeq ($(CONFIG_GUEST_AGENT
),y
)
545 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/interop
/qemu-ga
.8 "$(DESTDIR)$(mandir)/man8"
546 $(INSTALL_DIR
) "$(DESTDIR)$(qemu_docdir)/interop"
547 $(INSTALL_DATA
) docs
/interop
/qemu-ga-ref.html
"$(DESTDIR)$(qemu_docdir)/interop"
548 $(INSTALL_DATA
) docs
/interop
/qemu-ga-ref.txt
"$(DESTDIR)$(qemu_docdir)/interop"
549 $(INSTALL_DATA
) docs
/interop
/qemu-ga-ref
.7 "$(DESTDIR)$(mandir)/man7"
553 $(INSTALL_DIR
) "$(DESTDIR)$(mandir)/man1"
554 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/tools
/virtfs-proxy-helper
.1 "$(DESTDIR)$(mandir)/man1"
556 ifeq ($(CONFIG_LINUX
)$(CONFIG_SECCOMP
)$(CONFIG_LIBCAP_NG
),yyy
)
557 $(INSTALL_DATA
) $(MANUAL_BUILDDIR
)/tools
/virtiofsd
.1 "$(DESTDIR)$(mandir)/man1"
561 $(INSTALL_DIR
) "$(DESTDIR)$(qemu_datadir)"
563 install-localstatedir
:
565 ifeq ($(CONFIG_GUEST_AGENT
),y
)
566 $(INSTALL_DIR
) "$(DESTDIR)$(qemu_localstatedir)"/run
570 ICON_SIZES
=16x16
24x24
32x32
48x48
64x64
128x128
256x256
512x512
573 $(INSTALL_DIR
) "$(DESTDIR)$(includedir)"
575 # Needed by "meson install"
577 install: all $(if
$(BUILD_DOCS
),install-doc
) \
578 install-datadir install-localstatedir install-includedir \
579 $(if
$(INSTALL_BLOBS
),$(edk2-decompressed
)) \
582 $(call install-prog
,$(TOOLS
),$(DESTDIR
)$(bindir))
584 ifneq ($(CONFIG_MODULES
),)
585 $(INSTALL_DIR
) "$(DESTDIR)$(qemu_moddir)"
586 for s in
$(modules-m
:.mo
=$(DSOSUF
)); do \
587 t
="$(DESTDIR)$(qemu_moddir)/$$(echo $$s | tr / -)"; \
588 $(INSTALL_LIB
) $$s "$$t"; \
589 test -z
"$(STRIP)" ||
$(STRIP
) "$$t"; \
592 ifneq ($(HELPERS-y
),)
593 $(call install-prog
,$(HELPERS-y
),$(DESTDIR
)$(libexecdir
))
595 ifdef CONFIG_TRACE_SYSTEMTAP
596 $(INSTALL_PROG
) "scripts/qemu-trace-stap" $(DESTDIR
)$(bindir)
599 set
-e
; for x in
$(BLOBS
); do \
600 $(INSTALL_DATA
) $(SRC_PATH
)/pc-bios
/$$x "$(DESTDIR)$(qemu_datadir)"; \
604 set
-e
; for x in
$(edk2-decompressed
); do \
605 $(INSTALL_DATA
) $$x "$(DESTDIR)$(qemu_datadir)"; \
609 $(INSTALL_DIR
) "$(DESTDIR)$(qemu_datadir)/firmware"
610 set
-e
; tmpf
=$$(mktemp
); trap
'rm -f -- "$$tmpf"' EXIT
; \
611 for x in
$(DESCS
); do \
612 sed
-e
's,@DATADIR@,$(qemu_datadir),' \
613 "$(SRC_PATH)/pc-bios/descriptors/$$x" > "$$tmpf"; \
614 $(INSTALL_DATA
) "$$tmpf" \
615 "$(DESTDIR)$(qemu_datadir)/firmware/$$x"; \
618 for s in
$(ICON_SIZES
); do \
619 mkdir
-p
"$(DESTDIR)$(qemu_icondir)/hicolor/$${s}/apps"; \
620 $(INSTALL_DATA
) $(SRC_PATH
)/ui
/icons
/qemu_
$${s}.png \
621 "$(DESTDIR)$(qemu_icondir)/hicolor/$${s}/apps/qemu.png"; \
623 mkdir
-p
"$(DESTDIR)$(qemu_icondir)/hicolor/32x32/apps"; \
624 $(INSTALL_DATA
) $(SRC_PATH
)/ui
/icons
/qemu_32x32.bmp \
625 "$(DESTDIR)$(qemu_icondir)/hicolor/32x32/apps/qemu.bmp"; \
626 mkdir
-p
"$(DESTDIR)$(qemu_icondir)/hicolor/scalable/apps"; \
627 $(INSTALL_DATA
) $(SRC_PATH
)/ui
/icons
/qemu.svg \
628 "$(DESTDIR)$(qemu_icondir)/hicolor/scalable/apps/qemu.svg"
629 mkdir
-p
"$(DESTDIR)$(qemu_desktopdir)"
630 $(INSTALL_DATA
) $(SRC_PATH
)/ui
/qemu.desktop \
631 "$(DESTDIR)$(qemu_desktopdir)/qemu.desktop"
635 ifeq ($(CONFIG_PLUGIN
),y
)
636 $(INSTALL_DATA
) $(SRC_PATH
)/include/qemu
/qemu-plugin.h
"$(DESTDIR)$(includedir)/qemu-plugin.h"
638 $(INSTALL_DIR
) "$(DESTDIR)$(qemu_datadir)/keymaps"
639 set
-e
; for x in
$(KEYMAPS
); do \
640 $(INSTALL_DATA
) $(SRC_PATH
)/pc-bios
/keymaps
/$$x "$(DESTDIR)$(qemu_datadir)/keymaps"; \
642 for d in
$(TARGET_DIRS
); do \
643 $(MAKE
) $(SUBDIR_MAKEFLAGS
) TARGET_DIR
=$$d/ -C
$$d $@ || exit
1 ; \
646 # opengl shader programs
647 ui
/shader
/%-vert.h
: $(SRC_PATH
)/ui
/shader
/%.vert
$(SRC_PATH
)/scripts
/shaderinclude.pl
649 $(call quiet-command
,\
650 perl
$(SRC_PATH
)/scripts
/shaderinclude.pl
$< > $@
,\
653 ui
/shader
/%-frag.h
: $(SRC_PATH
)/ui
/shader
/%.frag
$(SRC_PATH
)/scripts
/shaderinclude.pl
655 $(call quiet-command
,\
656 perl
$(SRC_PATH
)/scripts
/shaderinclude.pl
$< > $@
,\
659 ui
/shader.o
: $(SRC_PATH
)/ui
/shader.c \
660 ui
/shader
/texture-blit-vert.h \
661 ui
/shader
/texture-blit-flip-vert.h \
662 ui
/shader
/texture-blit-frag.h
666 MAKEINFOINCLUDES
= -I docs
-I
$(<D
) -I
$(@D
)
667 MAKEINFOFLAGS
=--no-split
--number-sections
$(MAKEINFOINCLUDES
)
668 TEXI2PODFLAGS
=$(MAKEINFOINCLUDES
) -DVERSION
="$(VERSION)" -DCONFDIR
="$(qemu_confdir)"
669 TEXI2PDFFLAGS
=$(if
$(V
),,--quiet
) -I
$(SRC_PATH
) $(MAKEINFOINCLUDES
)
671 docs
/version.texi
: $(SRC_PATH
)/VERSION config-host.mak
672 $(call quiet-command
,(\
673 echo
"@set VERSION $(VERSION)" && \
674 echo
"@set CONFDIR $(qemu_confdir)" \
677 %.html
: %.texi docs
/version.texi
678 $(call quiet-command
,LC_ALL
=C
$(MAKEINFO
) $(MAKEINFOFLAGS
) --no-headers \
679 --html
$< -o
$@
,"GEN","$@")
681 %.
info: %.texi docs
/version.texi
682 $(call quiet-command
,$(MAKEINFO
) $(MAKEINFOFLAGS
) $< -o
$@
,"GEN","$@")
684 %.txt
: %.texi docs
/version.texi
685 $(call quiet-command
,LC_ALL
=C
$(MAKEINFO
) $(MAKEINFOFLAGS
) --no-headers \
686 --plaintext
$< -o
$@
,"GEN","$@")
688 %.pdf
: %.texi docs
/version.texi
689 $(call quiet-command
,texi2pdf
$(TEXI2PDFFLAGS
) $< -o
$@
,"GEN","$@")
691 # Sphinx builds all its documentation at once in one invocation
692 # and handles "don't rebuild things unless necessary" itself.
693 # The '.doctrees' files are cached information to speed this up.
695 sphinxdocs
: $(MANUAL_BUILDDIR
)/devel
/index.html \
696 $(MANUAL_BUILDDIR
)/interop
/index.html \
697 $(MANUAL_BUILDDIR
)/specs
/index.html \
698 $(MANUAL_BUILDDIR
)/system
/index.html \
699 $(MANUAL_BUILDDIR
)/tools
/index.html \
700 $(MANUAL_BUILDDIR
)/user
/index.html
702 # Canned command to build a single manual
703 # Arguments: $1 = manual name, $2 = Sphinx builder ('html' or 'man')
704 # Note the use of different doctree for each (manual, builder) tuple;
705 # this works around Sphinx not handling parallel invocation on
706 # a single doctree: https://github.com/sphinx-doc/sphinx/issues/2946
707 build-manual
= $(call quiet-command
,CONFDIR
="$(qemu_confdir)" $(SPHINX_BUILD
) $(if
$(V
),,-q
) $(SPHINX_WERROR
) -b
$2 -D version
=$(VERSION
) -D release
="$(FULL_VERSION)" -d .doctrees
/$1-$2 $(SRC_PATH
)/docs
/$1 $(MANUAL_BUILDDIR
)/$1 ,"SPHINX","$(MANUAL_BUILDDIR)/$1")
708 # We assume all RST files in the manual's directory are used in it
709 manual-deps
= $(wildcard $(SRC_PATH
)/docs
/$1/*.rst
$(SRC_PATH
)/docs
/$1/*/*.rst
) \
710 $(SRC_PATH
)/docs
/defs.rst.inc \
711 $(SRC_PATH
)/docs
/$1/conf.py
$(SRC_PATH
)/docs
/conf.py \
712 $(SRC_PATH
)/docs
/sphinx
/*.py
713 # Macro to write out the rule and dependencies for building manpages
714 # Usage: $(call define-manpage-rule,manualname,manpage1 manpage2...[,extradeps])
715 # 'extradeps' is optional, and specifies extra files (eg .hx files) that
716 # the manual page depends on.
717 define define-manpage-rule
718 $(call atomic
,$(foreach manpage
,$2,$(MANUAL_BUILDDIR
)/$1/$(manpage
)),$(call manual-deps
,$1) $3)
719 $(call build-manual
,$1,man
)
722 $(MANUAL_BUILDDIR
)/devel
/index.html
: $(call manual-deps
,devel
)
723 $(call build-manual
,devel
,html
)
725 $(MANUAL_BUILDDIR
)/interop
/index.html
: $(call manual-deps
,interop
)
726 $(call build-manual
,interop
,html
)
728 $(MANUAL_BUILDDIR
)/specs
/index.html
: $(call manual-deps
,specs
)
729 $(call build-manual
,specs
,html
)
731 $(MANUAL_BUILDDIR
)/system
/index.html
: $(call manual-deps
,system
) $(SRC_PATH
)/hmp-commands.hx
$(SRC_PATH
)/hmp-commands-info.hx
$(SRC_PATH
)/qemu-options.hx
732 $(call build-manual
,system
,html
)
734 $(MANUAL_BUILDDIR
)/tools
/index.html
: $(call manual-deps
,tools
) $(SRC_PATH
)/qemu-img-cmds.hx
$(SRC_PATH
)/docs
/qemu-option-trace.rst.inc
735 $(call build-manual
,tools
,html
)
737 $(MANUAL_BUILDDIR
)/user
/index.html
: $(call manual-deps
,user
)
738 $(call build-manual
,user
,html
)
740 $(call define-manpage-rule
,interop
,qemu-ga
.8)
742 $(call define-manpage-rule
,system
,qemu
.1 qemu-block-drivers
.7 qemu-cpu-models
.7)
744 $(call define-manpage-rule
,tools
,\
745 qemu-img
.1 qemu-nbd
.8 qemu-trace-stap
.1\
746 virtiofsd
.1 virtfs-proxy-helper
.1,\
747 $(SRC_PATH
)/qemu-img-cmds.hx
$(SRC_PATH
)/docs
/qemu-option-trace.rst.inc
)
749 $(MANUAL_BUILDDIR
)/index.html
: $(SRC_PATH
)/docs
/index.html.in qemu-version.h
750 @mkdir
-p
"$(MANUAL_BUILDDIR)"
751 $(call quiet-command
, sed
"s|@@VERSION@@|${VERSION}|g" $< >$@
, \
754 docs
/interop
/qemu-qmp-qapi.texi
: qapi
/qapi-doc.texi
757 docs
/interop
/qemu-ga-qapi.texi
: qga
/qga-qapi-doc.texi
760 html
: docs
/interop
/qemu-qmp-ref.html docs
/interop
/qemu-ga-ref.html sphinxdocs
761 info: docs
/interop
/qemu-qmp-ref.
info docs
/interop
/qemu-ga-ref.
info
762 pdf
: docs
/interop
/qemu-qmp-ref.pdf docs
/interop
/qemu-ga-ref.pdf
763 txt
: docs
/interop
/qemu-qmp-ref.txt docs
/interop
/qemu-ga-ref.txt
765 docs
/interop
/qemu-ga-ref.
dvi docs
/interop
/qemu-ga-ref.html \
766 docs
/interop
/qemu-ga-ref.
info docs
/interop
/qemu-ga-ref.pdf \
767 docs
/interop
/qemu-ga-ref.txt docs
/interop
/qemu-ga-ref
.7: \
768 docs
/interop
/qemu-ga-ref.texi docs
/interop
/qemu-ga-qapi.texi
770 docs
/interop
/qemu-qmp-ref.
dvi docs
/interop
/qemu-qmp-ref.html \
771 docs
/interop
/qemu-qmp-ref.
info docs
/interop
/qemu-qmp-ref.pdf \
772 docs
/interop
/qemu-qmp-ref.txt docs
/interop
/qemu-qmp-ref
.7: \
773 docs
/interop
/qemu-qmp-ref.texi docs
/interop
/qemu-qmp-qapi.texi
775 $(filter %.1 %.7 %.8,$(DOCS
)): scripts
/texi2pod.pl
779 %/coverage-report.html
:
781 $(call quiet-command
,\
782 gcovr
-r
$(SRC_PATH
) \
783 $(foreach t
, $(TARGET_DIRS
), --object-directory
$(BUILD_DIR
)/$(t
)) \
784 --object-directory
$(BUILD_DIR
) \
785 -p
--html
--html-details
-o
$@
, \
786 "GEN", "coverage-report.html")
788 .PHONY
: coverage-report
789 coverage-report
: $(CURDIR
)/reports
/coverage
/coverage-report.html
793 INSTALLER
= qemu-setup-
$(VERSION
)$(EXESUF
)
795 nsisflags
= -V2
-NOCD
797 ifneq ($(wildcard $(SRC_PATH
)/dll
),)
798 ifeq ($(ARCH
),x86_64
)
800 DLL_PATH
= $(SRC_PATH
)/dll
/w64
804 DLL_PATH
= $(SRC_PATH
)/dll
/w32
809 installer
: $(INSTALLER
)
811 INSTDIR
=/tmp
/qemu-nsis
813 $(INSTALLER
): $(SRC_PATH
)/qemu.nsi
814 $(MAKE
) install DESTDIR
=${INSTDIR}
816 (cd
${INSTDIR}/${bindir}; \
822 (cd
${INSTDIR}/${bindir}; \
823 for i in qemu-system-
*.exe
; do \
825 arch
=$${arch
#qemu-system-}; \
826 echo Section
\"$$arch\" Section_
$$arch; \
827 echo SetOutPath
\"\
$$INSTDIR\"; \
828 echo File
\"\
$${BINDIR}\\$$i\"; \
831 ) >${INSTDIR}/${bindir}/system-emulations.nsh
832 makensis
$(nsisflags
) \
833 $(if
$(BUILD_DOCS
),-DCONFIG_DOCUMENTATION
="y") \
834 $(if
$(CONFIG_GTK
),-DCONFIG_GTK
="y") \
835 -DBINDIR
="${INSTDIR}/${bindir}" \
836 $(if
$(DLL_PATH
),-DDLLDIR
="$(DLL_PATH)") \
837 -DSRCDIR
="$(SRC_PATH)" \
838 -DOUTFILE
="$(INSTALLER)" \
839 -DDISPLAYVERSION
="$(VERSION)" \
843 $(SIGNCODE
) $(INSTALLER
)
847 # Add a dependency on the generated files, so that they are always
848 # rebuilt before other object files
849 ifneq ($(wildcard config-host.mak
),)
850 ifneq ($(filter-out $(UNCHECKED_GOALS
),$(MAKECMDGOALS
)),$(if
$(MAKECMDGOALS
),,fail
))
851 Makefile
: $(generated-files-y
)
855 # Include automatically generated dependency files
856 # Dependencies in Makefile.objs files come from our recursive subdir rules
857 -include $(wildcard *.d tests
/*.d
)
859 include $(SRC_PATH
)/tests
/docker
/Makefile.
include
860 include $(SRC_PATH
)/tests
/vm
/Makefile.
include
862 print-help-run
= printf
" %-30s - %s\\n" "$1" "$2"
863 print-help
= $(quiet-@
)$(call print-help-run
,$1,$2)
867 @echo
'Generic targets:'
868 $(call print-help
,all,Build
all)
870 $(call print-help
,modules
,Build
all modules
)
872 $(call print-help
,dir/file.o
,Build specified target only
)
873 $(call print-help
,install,Install QEMU
, documentation and tools
)
874 $(call print-help
,ctags
/TAGS
,Generate
tags file for editors
)
875 $(call print-help
,cscope
,Generate cscope index
)
876 $(call print-help
,sparse
,Run sparse on the QEMU source
)
878 @
$(if
$(TARGET_DIRS
), \
879 echo
'Architecture specific targets:'; \
880 $(foreach t
, $(TARGET_DIRS
), \
881 $(call print-help-run
,$(t
)/all,Build for
$(t
)); \
882 $(if
$(CONFIG_FUZZ
), \
883 $(if
$(findstring softmmu
,$(t
)), \
884 $(call print-help-run
,$(t
)/fuzz
,Build fuzzer for
$(t
)); \
887 @
$(if
$(HELPERS-y
), \
888 echo
'Helper targets:'; \
889 $(foreach t
, $(HELPERS-y
), \
890 $(call print-help-run
,$(t
),Build
$(shell basename $(t
)));) \
893 echo
'Tools targets:'; \
894 $(foreach t
, $(TOOLS
), \
895 $(call print-help-run
,$(t
),Build
$(shell basename $(t
)) tool
);) \
897 @echo
'Cleaning targets:'
898 $(call print-help
,clean,Remove most generated files but keep the config
)
899 $(call print-help
,distclean,Remove
all generated files
)
900 $(call print-help
,dist,Build a distributable tarball
)
902 @echo
'Test targets:'
903 $(call print-help
,check,Run
all tests
(check-help for details
))
904 $(call print-help
,docker
,Help about targets running tests inside containers
)
905 $(call print-help
,vm-help
,Help about targets running tests inside VM
)
907 @echo
'Documentation targets:'
908 $(call print-help
,html
info pdf txt
,Build documentation in specified format
)
911 @echo
'Windows targets:'
912 $(call print-help
,installer
,Build NSIS-based installer for QEMU
)
913 ifdef QEMU_GA_MSI_ENABLED
914 $(call print-help
,msi
,Build MSI-based installer for qemu-ga
)
918 $(call print-help
,$(MAKE
) [targets
],(quiet build
, default
))
919 $(call print-help
,$(MAKE
) V
=1 [targets
],(verbose build
))