2006-05-14 12:07:53 +00:00
|
|
|
# Makefile for QEMU.
|
|
|
|
|
|
2019-05-26 14:47:47 +00:00
|
|
|
ifneq ($(words $(subst :, ,$(CURDIR))), 1)
|
|
|
|
|
$(error main directory cannot contain spaces nor colons)
|
|
|
|
|
endif
|
|
|
|
|
|
2011-09-16 19:50:43 +00:00
|
|
|
# Always point to the root of the build tree (needs GNU make).
|
|
|
|
|
BUILD_DIR=$(CURDIR)
|
2011-09-15 20:45:35 +00:00
|
|
|
|
2015-05-22 05:35:07 +00:00
|
|
|
# Before including a proper config-host.mak, assume we are in the source tree
|
|
|
|
|
SRC_PATH=.
|
|
|
|
|
|
2017-11-21 03:22:47 +00:00
|
|
|
UNCHECKED_GOALS := %clean TAGS cscope ctags dist \
|
|
|
|
|
html info pdf txt \
|
2018-01-04 16:05:08 +00:00
|
|
|
help check-help print-% \
|
2019-05-31 06:43:41 +00:00
|
|
|
docker docker-% vm-help vm-test vm-build-%
|
2015-05-22 05:35:07 +00:00
|
|
|
|
2012-03-06 18:50:38 +00:00
|
|
|
# All following code might depend on configuration variables
|
2009-04-15 14:42:57 +00:00
|
|
|
ifneq ($(wildcard config-host.mak),)
|
2009-05-19 15:17:58 +00:00
|
|
|
# Put the all: rule here so that config-host.mak can contain dependencies.
|
2012-07-09 18:36:36 +00:00
|
|
|
all:
|
2006-04-16 12:41:07 +00:00
|
|
|
include config-host.mak
|
2012-10-19 13:54:23 +00:00
|
|
|
|
2017-09-29 10:11:56 +00:00
|
|
|
git-submodule-update:
|
|
|
|
|
|
|
|
|
|
.PHONY: git-submodule-update
|
|
|
|
|
|
2017-11-06 11:08:14 +00:00
|
|
|
git_module_status := $(shell \
|
|
|
|
|
cd '$(SRC_PATH)' && \
|
|
|
|
|
GIT="$(GIT)" ./scripts/git-submodule.sh status $(GIT_SUBMODULES); \
|
|
|
|
|
echo $$?; \
|
|
|
|
|
)
|
2017-09-29 10:11:56 +00:00
|
|
|
|
|
|
|
|
ifeq (1,$(git_module_status))
|
2017-10-26 12:52:26 +00:00
|
|
|
ifeq (no,$(GIT_UPDATE))
|
|
|
|
|
git-submodule-update:
|
|
|
|
|
$(call quiet-command, \
|
|
|
|
|
echo && \
|
|
|
|
|
echo "GIT submodule checkout is out of date. Please run" && \
|
|
|
|
|
echo " scripts/git-submodule.sh update $(GIT_SUBMODULES)" && \
|
|
|
|
|
echo "from the source directory checkout $(SRC_PATH)" && \
|
|
|
|
|
echo && \
|
|
|
|
|
exit 1)
|
|
|
|
|
else
|
2017-09-29 10:11:56 +00:00
|
|
|
git-submodule-update:
|
|
|
|
|
$(call quiet-command, \
|
2017-10-20 14:02:43 +00:00
|
|
|
(cd $(SRC_PATH) && GIT="$(GIT)" ./scripts/git-submodule.sh update $(GIT_SUBMODULES)), \
|
2017-09-29 10:11:56 +00:00
|
|
|
"GIT","$(GIT_SUBMODULES)")
|
|
|
|
|
endif
|
|
|
|
|
endif
|
|
|
|
|
|
2019-06-10 10:05:14 +00:00
|
|
|
export NINJA=./ninjatool
|
|
|
|
|
|
|
|
|
|
# Running meson regenerates both build.ninja and ninjatool, and that is
|
|
|
|
|
# enough to prime the rest of the build.
|
|
|
|
|
ninjatool: build.ninja
|
|
|
|
|
|
|
|
|
|
# Only needed in case Makefile.ninja does not exist.
|
|
|
|
|
.PHONY: ninja-clean ninja-distclean clean-ctlist
|
|
|
|
|
clean-ctlist:
|
|
|
|
|
ninja-clean::
|
|
|
|
|
ninja-distclean::
|
|
|
|
|
build.ninja: config-host.mak
|
|
|
|
|
|
|
|
|
|
Makefile.ninja: build.ninja ninjatool
|
|
|
|
|
./ninjatool -t ninja2make --omit clean dist uninstall < $< > $@
|
|
|
|
|
-include Makefile.ninja
|
|
|
|
|
|
|
|
|
|
${ninja-targets-c_COMPILER} ${ninja-targets-cpp_COMPILER}: .var.command += -MP
|
|
|
|
|
|
2020-01-28 13:48:54 +00:00
|
|
|
# If MESON is empty, the rule will be re-evaluated after Makefiles are
|
|
|
|
|
# reread (and MESON won't be empty anymore).
|
|
|
|
|
ifneq ($(MESON),)
|
|
|
|
|
Makefile.mtest: build.ninja scripts/mtest2make.py
|
|
|
|
|
$(MESON) introspect --tests | $(PYTHON) scripts/mtest2make.py > $@
|
|
|
|
|
-include Makefile.mtest
|
|
|
|
|
endif
|
|
|
|
|
|
2017-09-29 10:11:58 +00:00
|
|
|
.git-submodule-status: git-submodule-update config-host.mak
|
2017-09-29 10:11:56 +00:00
|
|
|
|
2012-10-19 13:54:23 +00:00
|
|
|
# Check that we're not trying to do an out-of-tree build from
|
|
|
|
|
# a tree that's been used for an in-tree build.
|
|
|
|
|
ifneq ($(realpath $(SRC_PATH)),$(realpath .))
|
|
|
|
|
ifneq ($(wildcard $(SRC_PATH)/config-host.mak),)
|
|
|
|
|
$(error This is an out of tree build but your source tree ($(SRC_PATH)) \
|
|
|
|
|
seems to have been used for an in-tree build. You can fix this by running \
|
2017-11-21 09:55:10 +00:00
|
|
|
"$(MAKE) distclean && rm -rf *-linux-user *-softmmu" in your source tree)
|
2012-10-19 13:54:23 +00:00
|
|
|
endif
|
|
|
|
|
endif
|
|
|
|
|
|
2018-07-04 06:30:11 +00:00
|
|
|
CONFIG_SOFTMMU := $(if $(filter %-softmmu,$(TARGET_DIRS)),y)
|
|
|
|
|
CONFIG_USER_ONLY := $(if $(filter %-user,$(TARGET_DIRS)),y)
|
2017-03-16 20:01:50 +00:00
|
|
|
CONFIG_XEN := $(CONFIG_XEN_BACKEND)
|
2013-04-16 08:50:38 +00:00
|
|
|
CONFIG_ALL=y
|
|
|
|
|
-include config-all-devices.mak
|
|
|
|
|
-include config-all-disas.mak
|
|
|
|
|
|
2018-12-14 08:47:54 +00:00
|
|
|
config-host.mak: $(SRC_PATH)/configure $(SRC_PATH)/pc-bios $(SRC_PATH)/VERSION
|
2009-10-07 00:40:59 +00:00
|
|
|
@echo $@ is out-of-date, running configure
|
2019-06-10 10:05:14 +00:00
|
|
|
@if test -f meson-private/coredata.dat; then \
|
|
|
|
|
./config.status --skip-meson; \
|
|
|
|
|
else \
|
|
|
|
|
./config.status; \
|
|
|
|
|
fi
|
2018-10-21 17:56:29 +00:00
|
|
|
|
|
|
|
|
# Force configure to re-run if the API symbols are updated
|
|
|
|
|
ifeq ($(CONFIG_PLUGIN),y)
|
|
|
|
|
config-host.mak: $(SRC_PATH)/plugins/qemu-plugins.symbols
|
|
|
|
|
endif
|
|
|
|
|
|
2009-04-15 14:42:57 +00:00
|
|
|
else
|
|
|
|
|
config-host.mak:
|
2015-05-22 05:35:07 +00:00
|
|
|
ifneq ($(filter-out $(UNCHECKED_GOALS),$(MAKECMDGOALS)),$(if $(MAKECMDGOALS),,fail))
|
2009-04-15 14:42:57 +00:00
|
|
|
@echo "Please call configure before running make!"
|
|
|
|
|
@exit 1
|
|
|
|
|
endif
|
2012-09-16 20:07:13 +00:00
|
|
|
endif
|
2003-02-18 23:35:48 +00:00
|
|
|
|
2016-06-01 04:25:16 +00:00
|
|
|
include $(SRC_PATH)/rules.mak
|
|
|
|
|
|
2019-07-18 10:24:29 +00:00
|
|
|
# lor is defined in rules.mak
|
2019-04-01 14:12:22 +00:00
|
|
|
CONFIG_BLOCK := $(call lor,$(CONFIG_SOFTMMU),$(CONFIG_TOOLS))
|
|
|
|
|
|
2019-08-17 10:55:32 +00:00
|
|
|
generated-files-y += target/s390x/gen-features.h
|
|
|
|
|
target/s390x/gen-features.h: Makefile.ninja
|
2016-08-12 13:27:02 +00:00
|
|
|
|
2019-04-01 14:12:19 +00:00
|
|
|
generated-files-y += .git-submodule-status
|
2017-01-25 16:14:15 +00:00
|
|
|
|
2009-10-06 19:11:15 +00:00
|
|
|
# Don't try to regenerate Makefile or configure
|
|
|
|
|
# We don't generate any of them
|
|
|
|
|
Makefile: ;
|
|
|
|
|
configure: ;
|
|
|
|
|
|
2017-01-13 14:41:32 +00:00
|
|
|
.PHONY: all clean cscope distclean html info install install-doc \
|
2017-11-21 14:25:38 +00:00
|
|
|
pdf txt recurse-all dist msi FORCE
|
2006-05-14 12:07:53 +00:00
|
|
|
|
2012-05-29 09:49:50 +00:00
|
|
|
$(call set-vpath, $(SRC_PATH))
|
2007-11-18 21:12:37 +00:00
|
|
|
|
2009-08-03 12:47:06 +00:00
|
|
|
LIBS+=-lz $(LIBS_TOOLS)
|
2009-07-27 14:12:51 +00:00
|
|
|
|
2019-09-19 15:59:57 +00:00
|
|
|
# Sphinx does not allow building manuals into the same directory as
|
|
|
|
|
# the source files, so if we're doing an in-tree QEMU build we must
|
|
|
|
|
# build the manuals into a subdirectory (and then install them from
|
|
|
|
|
# there for 'make install'). For an out-of-tree build we can just
|
|
|
|
|
# use the docs/ subdirectory in the build tree as normal.
|
|
|
|
|
ifeq ($(realpath $(SRC_PATH)),$(realpath .))
|
|
|
|
|
MANUAL_BUILDDIR := docs/built
|
|
|
|
|
else
|
|
|
|
|
MANUAL_BUILDDIR := docs
|
|
|
|
|
endif
|
|
|
|
|
|
2006-04-23 17:57:59 +00:00
|
|
|
ifdef BUILD_DOCS
|
2020-02-28 15:36:15 +00:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/system/qemu.1
|
2020-02-25 10:45:14 +00:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/qemu-img.1
|
|
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/qemu-nbd.8
|
2020-01-23 15:22:39 +00:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/interop/qemu-ga.8
|
2020-02-07 16:29:51 +00:00
|
|
|
ifeq ($(CONFIG_LINUX)$(CONFIG_SECCOMP)$(CONFIG_LIBCAP_NG),yyy)
|
2020-02-25 10:45:14 +00:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/virtiofsd.1
|
2020-02-07 16:29:51 +00:00
|
|
|
endif
|
qemu-block-drivers: Convert to rST
The qemu-block-drivers documentation is currently in
docs/qemu-block-drivers.texi in Texinfo format, which we present
to the user as:
* a qemu-block-drivers manpage
* a section of the main qemu-doc HTML documentation
Convert the documentation to rST format, and present it to
the user as:
* a qemu-block-drivers manpage
* part of the system/ Sphinx manual
This follows the same pattern we've done for qemu-ga and qemu-nbd.
We have to drop a cross-reference from the documentation of the
-cdrom option back to the qemu-block-drivers documentation, since
they're no longer within the same texinfo document.
As noted in a comment, the manpage output is slightly compromised
due to limitations in Sphinx. In an ideal world, the HTML output
would have the various headings like 'Disk image file formats'
as top-level section headings (which then appear in the overall
system manual's table-of-contents), and it would not have the
section headings which make sense only for the manpage like
'synopsis', 'description', and 'see also'. Unfortunately, the
mechanism Sphinx provides for restricting pieces of documentation
is limited to the point of being flawed: the 'only::' directive
is implemented as a filter that is applied at a very late stage
in the document processing pipeline, rather than as an early
equivalent of an #ifdef. This means that Sphinx's process of
identifying which section heading markup styles are which levels
of heading gets confused if the 'only::' directive contains
section headings which would affect the heading-level of a
later heading. I have opted to prioritise making the HTML format
look better, with the compromise being that in the manpage
the 'Disk image file formats' &c headings are top-level headings
rather than being sub-headings under the traditional 'Description'
top-level section title.
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
Message-id: 20200116141511.16849-4-peter.maydell@linaro.org
2020-01-23 15:22:40 +00:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/system/qemu-block-drivers.7
|
2017-06-06 14:55:19 +00:00
|
|
|
DOCS+=docs/interop/qemu-qmp-ref.html docs/interop/qemu-qmp-ref.txt docs/interop/qemu-qmp-ref.7
|
|
|
|
|
DOCS+=docs/interop/qemu-ga-ref.html docs/interop/qemu-ga-ref.txt docs/interop/qemu-ga-ref.7
|
docs/system: Convert qemu-cpu-models.texi to rST
This doc was originally written by Daniel P. Berrangé
<berrange@redhat.com>, introduced via commit[1]: 2544e9e4aa (docs: add
guidance on configuring CPU models for x86, 2018-06-27).
In this patch:
- 1-1 conversion of Texinfo to rST, besides a couple of minor
tweaks that are too trivial to mention. (Thanks to Stephen
Finucane on IRC for the suggestion to use rST "definition lists"
instead of bullets in some places.)
Further modifications will be done via a separate patch.
- rST and related infra changes: manual page generation, Makefile
fixes, clean up references to qemu-cpu-models.texi, update year in
the copyright notice, etc.
[1] https://git.qemu.org/?p=qemu.git;a=commit;h=2544e9e4aa
As part of the conversion, we use a more generic 'author' attribution
for the manpage than we previously had, as agreed with the original
author Dan Berrange.
Signed-off-by: Kashyap Chamarthy <kchamart@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Message-id: 20200228153619.9906-16-peter.maydell@linaro.org
Message-id: 20200226113034.6741-15-pbonzini@redhat.com
[Move macros to defs.rst.inc, split in x86 and MIPS parts,
make qemu-cpu-models.rst a standalone document. - Paolo]
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
[PMM: Move defs.rst.inc setup to its own commit;
fix minor issues with MAINTAINERS file updates;
drop copyright date change; keep capitalization of
"QEMU Project developers" consistent with other uses;
minor Makefile fixups]
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
2020-02-28 15:36:01 +00:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/system/qemu-cpu-models.7
|
2019-12-19 13:56:20 +00:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/index.html
|
2012-02-24 08:30:42 +00:00
|
|
|
ifdef CONFIG_VIRTFS
|
2020-02-25 10:45:14 +00:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/virtfs-proxy-helper.1
|
2012-02-24 08:30:42 +00:00
|
|
|
endif
|
2019-01-23 12:00:16 +00:00
|
|
|
ifdef CONFIG_TRACE_SYSTEMTAP
|
2020-02-25 10:45:14 +00:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/qemu-trace-stap.1
|
2019-01-23 12:00:16 +00:00
|
|
|
endif
|
2006-04-23 17:57:59 +00:00
|
|
|
else
|
|
|
|
|
DOCS=
|
|
|
|
|
endif
|
2003-05-25 16:41:18 +00:00
|
|
|
|
2018-01-23 16:47:17 +00:00
|
|
|
SUBDIR_MAKEFLAGS=$(if $(V),,--no-print-directory --quiet) BUILD_DIR=$(BUILD_DIR)
|
2009-11-22 16:25:30 +00:00
|
|
|
|
2012-12-21 07:34:49 +00:00
|
|
|
ifneq ($(wildcard config-host.mak),)
|
|
|
|
|
include $(SRC_PATH)/Makefile.objs
|
2014-02-10 06:48:52 +00:00
|
|
|
endif
|
|
|
|
|
|
2016-06-01 02:23:31 +00:00
|
|
|
include $(SRC_PATH)/tests/Makefile.include
|
2012-12-21 07:34:49 +00:00
|
|
|
|
2019-07-18 11:21:28 +00:00
|
|
|
all: $(DOCS) $(if $(BUILD_DOCS),sphinxdocs) recurse-all modules
|
2006-05-13 16:54:03 +00:00
|
|
|
|
2009-10-07 00:40:58 +00:00
|
|
|
config-host.h: config-host.h-timestamp
|
|
|
|
|
config-host.h-timestamp: config-host.mak
|
|
|
|
|
|
2020-02-20 04:11:13 +00:00
|
|
|
TARGET_DIRS_RULES := $(foreach t, all fuzz clean install, $(addsuffix /$(t), $(TARGET_DIRS)))
|
2013-02-21 15:26:47 +00:00
|
|
|
|
2019-05-28 08:23:08 +00:00
|
|
|
SOFTMMU_ALL_RULES=$(filter %-softmmu/all, $(TARGET_DIRS_RULES))
|
|
|
|
|
$(SOFTMMU_ALL_RULES): $(authz-obj-y)
|
|
|
|
|
$(SOFTMMU_ALL_RULES): $(block-obj-y)
|
|
|
|
|
$(SOFTMMU_ALL_RULES): $(chardev-obj-y)
|
|
|
|
|
$(SOFTMMU_ALL_RULES): $(crypto-obj-y)
|
|
|
|
|
$(SOFTMMU_ALL_RULES): $(io-obj-y)
|
2019-07-16 15:40:16 +00:00
|
|
|
$(SOFTMMU_ALL_RULES): $(qom-obj-y)
|
2019-05-28 08:23:08 +00:00
|
|
|
$(SOFTMMU_ALL_RULES): config-all-devices.mak
|
2008-05-28 16:44:57 +00:00
|
|
|
|
2020-02-20 04:11:13 +00:00
|
|
|
SOFTMMU_FUZZ_RULES=$(filter %-softmmu/fuzz, $(TARGET_DIRS_RULES))
|
|
|
|
|
$(SOFTMMU_FUZZ_RULES): $(authz-obj-y)
|
|
|
|
|
$(SOFTMMU_FUZZ_RULES): $(block-obj-y)
|
|
|
|
|
$(SOFTMMU_FUZZ_RULES): $(chardev-obj-y)
|
|
|
|
|
$(SOFTMMU_FUZZ_RULES): $(crypto-obj-y)
|
|
|
|
|
$(SOFTMMU_FUZZ_RULES): $(io-obj-y)
|
|
|
|
|
$(SOFTMMU_FUZZ_RULES): config-all-devices.mak
|
|
|
|
|
$(SOFTMMU_FUZZ_RULES): $(edk2-decompressed)
|
|
|
|
|
|
2020-02-03 10:42:03 +00:00
|
|
|
# meson: this is sub-optimal but going away after conversion
|
|
|
|
|
TARGET_DEPS = $(patsubst %,%-config-target.h, $(TARGET_DIRS))
|
|
|
|
|
TARGET_DEPS += $(patsubst %,%-config-devices.h, $(filter %-softmmu,$(TARGET_DIRS)))
|
|
|
|
|
TARGET_DEPS += $(patsubst %,libqemu-%.fa, $(TARGET_DIRS))
|
|
|
|
|
|
2019-05-28 08:23:08 +00:00
|
|
|
.PHONY: $(TARGET_DIRS_RULES)
|
|
|
|
|
# The $(TARGET_DIRS_RULES) are of the form SUBDIR/GOAL, so that
|
|
|
|
|
# $(dir $@) yields the sub-directory, and $(notdir $@) yields the sub-goal
|
2020-02-03 10:42:03 +00:00
|
|
|
$(TARGET_DIRS_RULES): $(TARGET_DEPS)
|
2019-05-28 08:23:08 +00:00
|
|
|
$(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C $(dir $@) V="$(V)" TARGET_DIR="$(dir $@)" $(notdir $@),)
|
2006-05-13 13:55:08 +00:00
|
|
|
|
2020-06-12 19:02:21 +00:00
|
|
|
# LIBFDT_lib="": avoid breaking existing trees with objects requiring -fPIC
|
|
|
|
|
DTC_MAKE_ARGS=-I$(SRC_PATH)/dtc VPATH=$(SRC_PATH)/dtc -C dtc V="$(V)" LIBFDT_lib=""
|
2013-06-21 13:00:17 +00:00
|
|
|
DTC_CFLAGS=$(CFLAGS) $(QEMU_CFLAGS)
|
2020-06-12 19:02:21 +00:00
|
|
|
DTC_CPPFLAGS=-I$(SRC_PATH)/dtc/libfdt
|
2013-04-18 04:47:31 +00:00
|
|
|
|
Makefile: Rename targets for make recursion
We make a few sub-directories recursively, in particular
$(TARGET_DIRS).
For goal "all", we do it the nice way: "all" has a prerequisite
subdir-T for each T in $(TARGET_DIRS), and T's recipe runs make
recursively. Behaves nicely with -j and -k.
For other goals such as "clean" and "install", the recipe runs make
recursively in a for loop. Ignores -j and -k.
The next commit will fix that for "clean" and "install". This commit
prepares the ground by renaming the targets we use for "all" to
include the goal for the sub-make. This will permit reusing them for
goals other than "all".
Targets subdir-T for T in $(TARGET_DIRS) run "make all" in T. Rename
to T/all, and declare phony.
Targets romsubdir-R for R in $(ROMS) run "make" in pc-bios/R. Default
goal is "all" for all R. Rename to pc-bios/R/all, and declare phony.
The remainder are renamed just for consistency.
Target subdir-dtc runs "make libbft/libfdt.a" in dtc. Rename to
dtc/all, and declare phony.
Target subdir-capstone runs make $(BUILD_DIR)/capstone/$(LIBCAPSTONE)
in $(SRC_PATH)/capstone. Rename to capstone/all, and declare phony.
Target subdir-slirp runs "make" in $(SRC_PATH)/slirp. Default goal is
all, which builds $(BUILD_DIR)/libslirp.a. Rename to slirp/all, and
declare phony.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Tested-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Message-Id: <20190528082308.22032-4-armbru@redhat.com>
[Add compatibility gunk to keep make working across the rename]
2019-05-28 08:23:07 +00:00
|
|
|
.PHONY: dtc/all
|
2020-06-12 19:02:21 +00:00
|
|
|
dtc/all: .git-submodule-status dtc/libfdt
|
|
|
|
|
$(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,)
|
2013-04-18 04:47:31 +00:00
|
|
|
|
2017-10-18 18:40:23 +00:00
|
|
|
dtc/%: .git-submodule-status
|
2018-04-15 23:05:22 +00:00
|
|
|
@mkdir -p $@
|
2013-04-18 04:47:31 +00:00
|
|
|
|
2017-09-28 16:01:23 +00:00
|
|
|
# Overriding CFLAGS causes us to lose defines added in the sub-makefile.
|
|
|
|
|
# Not overriding CFLAGS leads to mis-matches between compilation modes.
|
|
|
|
|
# Therefore we replicate some of the logic in the sub-makefile.
|
|
|
|
|
# Remove all the extra -Warning flags that QEMU uses that Capstone doesn't;
|
|
|
|
|
# no need to annoy QEMU developers with such things.
|
|
|
|
|
CAP_CFLAGS = $(patsubst -W%,,$(CFLAGS) $(QEMU_CFLAGS))
|
|
|
|
|
CAP_CFLAGS += -DCAPSTONE_USE_SYS_DYN_MEM
|
|
|
|
|
CAP_CFLAGS += -DCAPSTONE_HAS_ARM
|
|
|
|
|
CAP_CFLAGS += -DCAPSTONE_HAS_ARM64
|
|
|
|
|
CAP_CFLAGS += -DCAPSTONE_HAS_POWERPC
|
|
|
|
|
CAP_CFLAGS += -DCAPSTONE_HAS_X86
|
|
|
|
|
|
Makefile: Rename targets for make recursion
We make a few sub-directories recursively, in particular
$(TARGET_DIRS).
For goal "all", we do it the nice way: "all" has a prerequisite
subdir-T for each T in $(TARGET_DIRS), and T's recipe runs make
recursively. Behaves nicely with -j and -k.
For other goals such as "clean" and "install", the recipe runs make
recursively in a for loop. Ignores -j and -k.
The next commit will fix that for "clean" and "install". This commit
prepares the ground by renaming the targets we use for "all" to
include the goal for the sub-make. This will permit reusing them for
goals other than "all".
Targets subdir-T for T in $(TARGET_DIRS) run "make all" in T. Rename
to T/all, and declare phony.
Targets romsubdir-R for R in $(ROMS) run "make" in pc-bios/R. Default
goal is "all" for all R. Rename to pc-bios/R/all, and declare phony.
The remainder are renamed just for consistency.
Target subdir-dtc runs "make libbft/libfdt.a" in dtc. Rename to
dtc/all, and declare phony.
Target subdir-capstone runs make $(BUILD_DIR)/capstone/$(LIBCAPSTONE)
in $(SRC_PATH)/capstone. Rename to capstone/all, and declare phony.
Target subdir-slirp runs "make" in $(SRC_PATH)/slirp. Default goal is
all, which builds $(BUILD_DIR)/libslirp.a. Rename to slirp/all, and
declare phony.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Tested-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Message-Id: <20190528082308.22032-4-armbru@redhat.com>
[Add compatibility gunk to keep make working across the rename]
2019-05-28 08:23:07 +00:00
|
|
|
.PHONY: capstone/all
|
|
|
|
|
capstone/all: .git-submodule-status
|
2017-11-08 01:10:46 +00:00
|
|
|
$(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))
|
2017-09-28 16:01:23 +00:00
|
|
|
|
Makefile: Rename targets for make recursion
We make a few sub-directories recursively, in particular
$(TARGET_DIRS).
For goal "all", we do it the nice way: "all" has a prerequisite
subdir-T for each T in $(TARGET_DIRS), and T's recipe runs make
recursively. Behaves nicely with -j and -k.
For other goals such as "clean" and "install", the recipe runs make
recursively in a for loop. Ignores -j and -k.
The next commit will fix that for "clean" and "install". This commit
prepares the ground by renaming the targets we use for "all" to
include the goal for the sub-make. This will permit reusing them for
goals other than "all".
Targets subdir-T for T in $(TARGET_DIRS) run "make all" in T. Rename
to T/all, and declare phony.
Targets romsubdir-R for R in $(ROMS) run "make" in pc-bios/R. Default
goal is "all" for all R. Rename to pc-bios/R/all, and declare phony.
The remainder are renamed just for consistency.
Target subdir-dtc runs "make libbft/libfdt.a" in dtc. Rename to
dtc/all, and declare phony.
Target subdir-capstone runs make $(BUILD_DIR)/capstone/$(LIBCAPSTONE)
in $(SRC_PATH)/capstone. Rename to capstone/all, and declare phony.
Target subdir-slirp runs "make" in $(SRC_PATH)/slirp. Default goal is
all, which builds $(BUILD_DIR)/libslirp.a. Rename to slirp/all, and
declare phony.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Tested-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Message-Id: <20190528082308.22032-4-armbru@redhat.com>
[Add compatibility gunk to keep make working across the rename]
2019-05-28 08:23:07 +00:00
|
|
|
.PHONY: slirp/all
|
|
|
|
|
slirp/all: .git-submodule-status
|
2019-09-19 13:07:36 +00:00
|
|
|
$(call quiet-command,$(MAKE) -C $(SRC_PATH)/slirp \
|
|
|
|
|
BUILD_DIR="$(BUILD_DIR)/slirp" \
|
|
|
|
|
PKG_CONFIG="$(PKG_CONFIG)" \
|
|
|
|
|
CC="$(CC)" AR="$(AR)" LD="$(LD)" RANLIB="$(RANLIB)" \
|
build-sys: clean up flags included in the linker command line
Some of the CFLAGS that are discovered during configure, for example
compiler warnings, are being included on the linker command line because
QEMU_CFLAGS is added to it. Other flags, such as the -m32, appear twice
because they are included in both QEMU_CFLAGS and LDFLAGS. All this
leads to confusion with respect to what goes in which Makefile variables
(and we have plenty).
So, introduce QEMU_LDFLAGS for flags discovered by configure, following
the lead of QEMU_CFLAGS, and stop adding to it:
1) options that are already in CFLAGS, for example "-g"
2) duplicate options
At the same time, options that _are_ needed by both compiler and linker
must now be added to both QEMU_CFLAGS and QEMU_LDFLAGS, which is clearer.
This is mostly -fsanitize options. For now, --extra-cflags has this behavior
(but --extra-cxxflags does not).
Meson will not include CFLAGS on the linker command line, do the same in our
build system as well.
Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2019-12-11 14:34:27 +00:00
|
|
|
CFLAGS="$(QEMU_CFLAGS) $(CFLAGS)" LDFLAGS="$(QEMU_LDFLAGS)")
|
2019-02-12 16:25:23 +00:00
|
|
|
|
2019-05-28 08:23:08 +00:00
|
|
|
$(filter %/all, $(TARGET_DIRS_RULES)): libqemuutil.a $(common-obj-y) \
|
2019-08-29 18:07:01 +00:00
|
|
|
$(qom-obj-y) block.syms qemu.syms
|
2009-09-27 16:26:02 +00:00
|
|
|
|
2020-02-20 04:11:13 +00:00
|
|
|
$(filter %/fuzz, $(TARGET_DIRS_RULES)): libqemuutil.a $(common-obj-y) \
|
|
|
|
|
$(qom-obj-y) $(crypto-user-obj-$(CONFIG_USER_ONLY))
|
|
|
|
|
|
Makefile: Rename targets for make recursion
We make a few sub-directories recursively, in particular
$(TARGET_DIRS).
For goal "all", we do it the nice way: "all" has a prerequisite
subdir-T for each T in $(TARGET_DIRS), and T's recipe runs make
recursively. Behaves nicely with -j and -k.
For other goals such as "clean" and "install", the recipe runs make
recursively in a for loop. Ignores -j and -k.
The next commit will fix that for "clean" and "install". This commit
prepares the ground by renaming the targets we use for "all" to
include the goal for the sub-make. This will permit reusing them for
goals other than "all".
Targets subdir-T for T in $(TARGET_DIRS) run "make all" in T. Rename
to T/all, and declare phony.
Targets romsubdir-R for R in $(ROMS) run "make" in pc-bios/R. Default
goal is "all" for all R. Rename to pc-bios/R/all, and declare phony.
The remainder are renamed just for consistency.
Target subdir-dtc runs "make libbft/libfdt.a" in dtc. Rename to
dtc/all, and declare phony.
Target subdir-capstone runs make $(BUILD_DIR)/capstone/$(LIBCAPSTONE)
in $(SRC_PATH)/capstone. Rename to capstone/all, and declare phony.
Target subdir-slirp runs "make" in $(SRC_PATH)/slirp. Default goal is
all, which builds $(BUILD_DIR)/libslirp.a. Rename to slirp/all, and
declare phony.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Tested-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Message-Id: <20190528082308.22032-4-armbru@redhat.com>
[Add compatibility gunk to keep make working across the rename]
2019-05-28 08:23:07 +00:00
|
|
|
ROM_DIRS = $(addprefix pc-bios/, $(ROMS))
|
2019-05-28 08:23:08 +00:00
|
|
|
ROM_DIRS_RULES=$(foreach t, all clean, $(addsuffix /$(t), $(ROM_DIRS)))
|
2016-08-05 08:23:46 +00:00
|
|
|
# Only keep -O and -g cflags
|
2019-05-28 08:23:08 +00:00
|
|
|
.PHONY: $(ROM_DIRS_RULES)
|
|
|
|
|
$(ROM_DIRS_RULES):
|
|
|
|
|
$(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C $(dir $@) V="$(V)" TARGET_DIR="$(dir $@)" CFLAGS="$(filter -O% -g%,$(CFLAGS))" $(notdir $@),)
|
2009-07-31 12:18:32 +00:00
|
|
|
|
2019-07-09 14:38:01 +00:00
|
|
|
.PHONY: recurse-all recurse-clean recurse-install
|
2019-05-28 08:23:08 +00:00
|
|
|
recurse-all: $(addsuffix /all, $(TARGET_DIRS) $(ROM_DIRS))
|
|
|
|
|
recurse-clean: $(addsuffix /clean, $(TARGET_DIRS) $(ROM_DIRS))
|
|
|
|
|
recurse-install: $(addsuffix /install, $(TARGET_DIRS))
|
2019-07-12 05:59:35 +00:00
|
|
|
$(addsuffix /install, $(TARGET_DIRS)): all
|
2006-08-01 16:21:11 +00:00
|
|
|
|
2016-11-08 07:05:13 +00:00
|
|
|
$(BUILD_DIR)/version.o: $(SRC_PATH)/version.rc config-host.h
|
2016-10-04 16:27:21 +00:00
|
|
|
$(call quiet-command,$(WINDRES) -I$(BUILD_DIR) -o $@ $<,"RC","version.o")
|
2013-02-25 22:31:13 +00:00
|
|
|
|
2016-11-08 07:05:13 +00:00
|
|
|
Makefile: $(version-obj-y)
|
2012-11-16 17:35:27 +00:00
|
|
|
|
2011-05-15 08:51:28 +00:00
|
|
|
######################################################################
|
2007-11-07 19:24:02 +00:00
|
|
|
|
2017-09-19 14:20:31 +00:00
|
|
|
COMMON_LDADDS = libqemuutil.a
|
2017-01-25 16:14:15 +00:00
|
|
|
|
2019-06-10 10:05:14 +00:00
|
|
|
clean: recurse-clean ninja-clean clean-ctlist
|
|
|
|
|
-test -f ninjatool && ./ninjatool $(if $(V),-v,) -t clean
|
2003-08-11 23:01:33 +00:00
|
|
|
# avoid old build problems by removing potentially incorrect old files
|
2009-10-07 00:41:00 +00:00
|
|
|
rm -f config.mak op-i386.h opc-i386.h gen-op-i386.h op-arm.h opc-arm.h gen-op-arm.h
|
2019-02-04 16:03:21 +00:00
|
|
|
find . \( -name '*.so' -o -name '*.dll' -o -name '*.mo' -o -name '*.[oda]' \) -type f \
|
|
|
|
|
! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-aarch64.a \
|
|
|
|
|
! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-arm.a \
|
|
|
|
|
! -path ./roms/edk2/BaseTools/Source/Python/UPT/Dll/sqlite3.dll \
|
|
|
|
|
-exec rm {} +
|
2019-07-18 11:21:28 +00:00
|
|
|
rm -f TAGS cscope.* *.pod *~ */*~
|
2017-08-22 04:50:18 +00:00
|
|
|
rm -f fsdev/*.pod scsi/*.pod
|
2019-04-01 14:12:19 +00:00
|
|
|
rm -f $(foreach f,$(generated-files-y),$(f) $(f)-timestamp)
|
2003-02-18 22:55:36 +00:00
|
|
|
|
2012-07-17 18:33:32 +00:00
|
|
|
VERSION ?= $(shell cat VERSION)
|
|
|
|
|
|
|
|
|
|
dist: qemu-$(VERSION).tar.bz2
|
|
|
|
|
|
|
|
|
|
qemu-%.tar.bz2:
|
|
|
|
|
$(SRC_PATH)/scripts/make-release "$(SRC_PATH)" "$(patsubst qemu-%.tar.bz2,%,$@)"
|
|
|
|
|
|
2019-03-07 14:26:46 +00:00
|
|
|
define clean-manual =
|
2019-03-08 13:57:42 +00:00
|
|
|
rm -rf $(MANUAL_BUILDDIR)/$1/_static
|
|
|
|
|
rm -f $(MANUAL_BUILDDIR)/$1/objects.inv $(MANUAL_BUILDDIR)/$1/searchindex.js $(MANUAL_BUILDDIR)/$1/*.html
|
2019-03-07 14:26:46 +00:00
|
|
|
endef
|
|
|
|
|
|
2019-06-10 10:05:14 +00:00
|
|
|
distclean: clean ninja-distclean
|
|
|
|
|
-test -f ninjatool && ./ninjatool $(if $(V),-v,) -t clean -g
|
2019-12-17 23:25:09 +00:00
|
|
|
rm -f config-host.mak config-host.h* $(DOCS)
|
2019-08-07 14:35:23 +00:00
|
|
|
rm -f tests/tcg/config-*.mak
|
2020-02-03 10:42:03 +00:00
|
|
|
rm -f config-all-disas.mak config.status
|
2014-12-15 10:19:46 +00:00
|
|
|
rm -f po/*.mo tests/qemu-iotests/common.env
|
2009-11-13 09:51:05 +00:00
|
|
|
rm -f roms/seabios/config.mak roms/vgabios/config.mak
|
2018-10-21 17:56:29 +00:00
|
|
|
rm -f qemu-plugins-ld.symbols qemu-plugins-ld64.symbols
|
2019-06-10 10:05:14 +00:00
|
|
|
rm -rf meson-private meson-logs meson-info compile_commands.json
|
2020-01-28 13:48:54 +00:00
|
|
|
rm -f Makefile.ninja ninjatool ninjatool.stamp Makefile.mtest
|
2011-07-26 03:56:02 +00:00
|
|
|
rm -f config.log
|
2012-02-01 18:50:42 +00:00
|
|
|
rm -f linux-headers/asm
|
2017-06-06 14:55:19 +00:00
|
|
|
rm -f docs/version.texi
|
|
|
|
|
rm -f docs/interop/qemu-ga-qapi.texi docs/interop/qemu-qmp-qapi.texi
|
|
|
|
|
rm -f docs/interop/qemu-qmp-ref.7 docs/interop/qemu-ga-ref.7
|
|
|
|
|
rm -f docs/interop/qemu-qmp-ref.txt docs/interop/qemu-ga-ref.txt
|
|
|
|
|
rm -f docs/interop/qemu-qmp-ref.pdf docs/interop/qemu-ga-ref.pdf
|
|
|
|
|
rm -f docs/interop/qemu-qmp-ref.html docs/interop/qemu-ga-ref.html
|
2019-03-08 13:57:43 +00:00
|
|
|
rm -rf .doctrees
|
2019-03-07 14:26:46 +00:00
|
|
|
$(call clean-manual,devel)
|
|
|
|
|
$(call clean-manual,interop)
|
2019-06-17 14:35:31 +00:00
|
|
|
$(call clean-manual,specs)
|
2020-01-23 15:22:40 +00:00
|
|
|
$(call clean-manual,system)
|
2020-02-25 10:45:13 +00:00
|
|
|
$(call clean-manual,tools)
|
2020-02-28 15:35:47 +00:00
|
|
|
$(call clean-manual,user)
|
2018-07-04 06:30:11 +00:00
|
|
|
for d in $(TARGET_DIRS); do \
|
2003-10-28 00:12:52 +00:00
|
|
|
rm -rf $$d || exit 1 ; \
|
2003-08-10 23:41:46 +00:00
|
|
|
done
|
2013-08-07 15:40:03 +00:00
|
|
|
rm -Rf .sdk
|
2003-03-06 23:23:54 +00:00
|
|
|
|
2018-11-16 10:43:16 +00:00
|
|
|
KEYMAPS=da en-gb et fr fr-ch is lt no pt-br sv \
|
2004-12-12 22:18:34 +00:00
|
|
|
ar de en-us fi fr-be hr it lv nl pl ru th \
|
2018-11-16 10:43:18 +00:00
|
|
|
de-ch es fo fr-ca hu ja mk pt sl tr \
|
2013-10-16 12:40:04 +00:00
|
|
|
bepo cz
|
2004-12-12 22:18:34 +00:00
|
|
|
|
2008-11-27 15:45:16 +00:00
|
|
|
ifdef INSTALL_BLOBS
|
2019-11-02 11:43:46 +00:00
|
|
|
BLOBS=bios.bin bios-256k.bin bios-microvm.bin sgabios.bin vgabios.bin vgabios-cirrus.bin \
|
2014-09-10 11:04:17 +00:00
|
|
|
vgabios-stdvga.bin vgabios-vmware.bin vgabios-qxl.bin vgabios-virtio.bin \
|
2019-07-03 04:52:12 +00:00
|
|
|
vgabios-ramfb.bin vgabios-bochs-display.bin vgabios-ati.bin \
|
2020-01-14 11:46:17 +00:00
|
|
|
openbios-sparc32 openbios-sparc64 openbios-ppc QEMU,tcx.bin QEMU,cgthree.bin \
|
2011-04-18 17:46:01 +00:00
|
|
|
pxe-e1000.rom pxe-eepro100.rom pxe-ne2k_pci.rom \
|
|
|
|
|
pxe-pcnet.rom pxe-rtl8139.rom pxe-virtio.rom \
|
2013-04-08 21:08:13 +00:00
|
|
|
efi-e1000.rom efi-eepro100.rom efi-ne2k_pci.rom \
|
|
|
|
|
efi-pcnet.rom efi-rtl8139.rom efi-virtio.rom \
|
2016-07-01 11:26:57 +00:00
|
|
|
efi-e1000e.rom efi-vmxnet3.rom \
|
2019-07-15 17:48:14 +00:00
|
|
|
qemu-nsis.bmp \
|
2018-02-19 10:34:25 +00:00
|
|
|
bamboo.dtb canyonlands.dtb petalogix-s3adsp1800.dtb petalogix-ml605.dtb \
|
2019-01-18 12:01:41 +00:00
|
|
|
multiboot.bin linuxboot.bin linuxboot_dma.bin kvmvapic.bin pvh.bin \
|
2017-07-12 14:00:41 +00:00
|
|
|
s390-ccw.img s390-netboot.img \
|
2019-07-16 05:27:43 +00:00
|
|
|
slof.bin skiboot.lid \
|
2014-07-04 19:43:18 +00:00
|
|
|
palcode-clipper \
|
2018-03-02 11:50:14 +00:00
|
|
|
u-boot.e500 u-boot-sam460-20100605.bin \
|
2018-01-21 21:04:45 +00:00
|
|
|
qemu_vga.ndrv \
|
2019-03-08 00:19:35 +00:00
|
|
|
edk2-licenses.txt \
|
2019-07-16 18:47:22 +00:00
|
|
|
hppa-firmware.img \
|
2020-02-24 13:39:42 +00:00
|
|
|
opensbi-riscv32-sifive_u-fw_jump.bin opensbi-riscv32-virt-fw_jump.bin \
|
2019-07-16 18:47:22 +00:00
|
|
|
opensbi-riscv64-sifive_u-fw_jump.bin opensbi-riscv64-virt-fw_jump.bin
|
2008-11-27 15:45:16 +00:00
|
|
|
else
|
|
|
|
|
BLOBS=
|
|
|
|
|
endif
|
|
|
|
|
|
2019-03-08 13:57:44 +00:00
|
|
|
# Note that we manually filter-out the non-Sphinx documentation which
|
2019-09-05 13:10:40 +00:00
|
|
|
# is currently built into the docs/interop directory in the build tree,
|
|
|
|
|
# and also any sphinx-built manpages.
|
2019-03-07 14:26:46 +00:00
|
|
|
define install-manual =
|
2019-03-08 13:57:42 +00:00
|
|
|
for d in $$(cd $(MANUAL_BUILDDIR) && find $1 -type d); do $(INSTALL_DIR) "$(DESTDIR)$(qemu_docdir)/$$d"; done
|
2019-09-05 13:10:40 +00:00
|
|
|
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
|
2019-03-07 14:26:46 +00:00
|
|
|
endef
|
|
|
|
|
|
|
|
|
|
# Note that we deliberately do not install the "devel" manual: it is
|
|
|
|
|
# for QEMU developers, and not interesting to our users.
|
|
|
|
|
.PHONY: install-sphinxdocs
|
|
|
|
|
install-sphinxdocs: sphinxdocs
|
|
|
|
|
$(call install-manual,interop)
|
2019-06-17 14:35:31 +00:00
|
|
|
$(call install-manual,specs)
|
2020-01-23 15:22:40 +00:00
|
|
|
$(call install-manual,system)
|
2020-02-25 10:45:13 +00:00
|
|
|
$(call install-manual,tools)
|
2020-02-28 15:35:47 +00:00
|
|
|
$(call install-manual,user)
|
2019-03-07 14:26:46 +00:00
|
|
|
|
|
|
|
|
install-doc: $(DOCS) install-sphinxdocs
|
2012-04-18 19:55:44 +00:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_docdir)"
|
2019-12-19 13:56:20 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/index.html "$(DESTDIR)$(qemu_docdir)"
|
2020-06-09 00:47:50 +00:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_docdir)/interop"
|
|
|
|
|
$(INSTALL_DATA) docs/interop/qemu-qmp-ref.html "$(DESTDIR)$(qemu_docdir)/interop"
|
|
|
|
|
$(INSTALL_DATA) docs/interop/qemu-qmp-ref.txt "$(DESTDIR)$(qemu_docdir)/interop"
|
2009-08-03 12:47:00 +00:00
|
|
|
ifdef CONFIG_POSIX
|
2009-04-18 15:36:02 +00:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1"
|
2020-02-28 15:36:15 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/system/qemu.1 "$(DESTDIR)$(mandir)/man1"
|
2017-01-13 14:41:35 +00:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(mandir)/man7"
|
2017-06-06 14:55:19 +00:00
|
|
|
$(INSTALL_DATA) docs/interop/qemu-qmp-ref.7 "$(DESTDIR)$(mandir)/man7"
|
qemu-block-drivers: Convert to rST
The qemu-block-drivers documentation is currently in
docs/qemu-block-drivers.texi in Texinfo format, which we present
to the user as:
* a qemu-block-drivers manpage
* a section of the main qemu-doc HTML documentation
Convert the documentation to rST format, and present it to
the user as:
* a qemu-block-drivers manpage
* part of the system/ Sphinx manual
This follows the same pattern we've done for qemu-ga and qemu-nbd.
We have to drop a cross-reference from the documentation of the
-cdrom option back to the qemu-block-drivers documentation, since
they're no longer within the same texinfo document.
As noted in a comment, the manpage output is slightly compromised
due to limitations in Sphinx. In an ideal world, the HTML output
would have the various headings like 'Disk image file formats'
as top-level section headings (which then appear in the overall
system manual's table-of-contents), and it would not have the
section headings which make sense only for the manpage like
'synopsis', 'description', and 'see also'. Unfortunately, the
mechanism Sphinx provides for restricting pieces of documentation
is limited to the point of being flawed: the 'only::' directive
is implemented as a filter that is applied at a very late stage
in the document processing pipeline, rather than as an early
equivalent of an #ifdef. This means that Sphinx's process of
identifying which section heading markup styles are which levels
of heading gets confused if the 'only::' directive contains
section headings which would affect the heading-level of a
later heading. I have opted to prioritise making the HTML format
look better, with the compromise being that in the manpage
the 'Disk image file formats' &c headings are top-level headings
rather than being sub-headings under the traditional 'Description'
top-level section title.
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
Message-id: 20200116141511.16849-4-peter.maydell@linaro.org
2020-01-23 15:22:40 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/system/qemu-block-drivers.7 "$(DESTDIR)$(mandir)/man7"
|
docs/system: Convert qemu-cpu-models.texi to rST
This doc was originally written by Daniel P. Berrangé
<berrange@redhat.com>, introduced via commit[1]: 2544e9e4aa (docs: add
guidance on configuring CPU models for x86, 2018-06-27).
In this patch:
- 1-1 conversion of Texinfo to rST, besides a couple of minor
tweaks that are too trivial to mention. (Thanks to Stephen
Finucane on IRC for the suggestion to use rST "definition lists"
instead of bullets in some places.)
Further modifications will be done via a separate patch.
- rST and related infra changes: manual page generation, Makefile
fixes, clean up references to qemu-cpu-models.texi, update year in
the copyright notice, etc.
[1] https://git.qemu.org/?p=qemu.git;a=commit;h=2544e9e4aa
As part of the conversion, we use a more generic 'author' attribution
for the manpage than we previously had, as agreed with the original
author Dan Berrange.
Signed-off-by: Kashyap Chamarthy <kchamart@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Message-id: 20200228153619.9906-16-peter.maydell@linaro.org
Message-id: 20200226113034.6741-15-pbonzini@redhat.com
[Move macros to defs.rst.inc, split in x86 and MIPS parts,
make qemu-cpu-models.rst a standalone document. - Paolo]
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
[PMM: Move defs.rst.inc setup to its own commit;
fix minor issues with MAINTAINERS file updates;
drop copyright date change; keep capitalization of
"QEMU Project developers" consistent with other uses;
minor Makefile fixups]
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
2020-02-28 15:36:01 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/system/qemu-cpu-models.7 "$(DESTDIR)$(mandir)/man7"
|
2019-07-18 10:24:29 +00:00
|
|
|
ifeq ($(CONFIG_TOOLS),y)
|
2020-02-25 10:45:14 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/qemu-img.1 "$(DESTDIR)$(mandir)/man1"
|
2009-04-18 15:36:02 +00:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(mandir)/man8"
|
2020-02-25 10:45:14 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/qemu-nbd.8 "$(DESTDIR)$(mandir)/man8"
|
2006-04-30 23:54:18 +00:00
|
|
|
endif
|
2019-01-23 12:00:16 +00:00
|
|
|
ifdef CONFIG_TRACE_SYSTEMTAP
|
2020-02-25 10:45:14 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/qemu-trace-stap.1 "$(DESTDIR)$(mandir)/man1"
|
2019-01-23 12:00:16 +00:00
|
|
|
endif
|
2019-07-18 11:19:02 +00:00
|
|
|
ifeq ($(CONFIG_GUEST_AGENT),y)
|
2019-09-19 15:59:57 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/interop/qemu-ga.8 "$(DESTDIR)$(mandir)/man8"
|
2020-06-09 00:47:50 +00:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_docdir)/interop"
|
|
|
|
|
$(INSTALL_DATA) docs/interop/qemu-ga-ref.html "$(DESTDIR)$(qemu_docdir)/interop"
|
|
|
|
|
$(INSTALL_DATA) docs/interop/qemu-ga-ref.txt "$(DESTDIR)$(qemu_docdir)/interop"
|
2017-06-06 14:55:19 +00:00
|
|
|
$(INSTALL_DATA) docs/interop/qemu-ga-ref.7 "$(DESTDIR)$(mandir)/man7"
|
2015-08-26 23:34:59 +00:00
|
|
|
endif
|
2013-06-11 11:13:58 +00:00
|
|
|
endif
|
2011-12-14 08:28:47 +00:00
|
|
|
ifdef CONFIG_VIRTFS
|
|
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1"
|
2020-02-25 10:45:14 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/virtfs-proxy-helper.1 "$(DESTDIR)$(mandir)/man1"
|
2011-12-14 08:28:47 +00:00
|
|
|
endif
|
2020-02-07 16:29:51 +00:00
|
|
|
ifeq ($(CONFIG_LINUX)$(CONFIG_SECCOMP)$(CONFIG_LIBCAP_NG),yyy)
|
2020-02-25 10:45:14 +00:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/virtiofsd.1 "$(DESTDIR)$(mandir)/man1"
|
2020-02-07 16:29:51 +00:00
|
|
|
endif
|
2012-05-02 16:07:30 +00:00
|
|
|
|
|
|
|
|
install-datadir:
|
|
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_datadir)"
|
|
|
|
|
|
2013-05-18 05:13:14 +00:00
|
|
|
install-localstatedir:
|
|
|
|
|
ifdef CONFIG_POSIX
|
2019-07-18 11:19:02 +00:00
|
|
|
ifeq ($(CONFIG_GUEST_AGENT),y)
|
2013-05-18 05:13:14 +00:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_localstatedir)"/run
|
|
|
|
|
endif
|
|
|
|
|
endif
|
|
|
|
|
|
2019-01-10 12:00:45 +00:00
|
|
|
ICON_SIZES=16x16 24x24 32x32 48x48 64x64 128x128 256x256 512x512
|
2012-05-02 16:07:30 +00:00
|
|
|
|
2019-06-10 10:05:14 +00:00
|
|
|
# Needed by "meson install"
|
|
|
|
|
export DESTDIR
|
2017-08-30 22:39:53 +00:00
|
|
|
install: all $(if $(BUILD_DOCS),install-doc) \
|
2020-01-24 12:08:01 +00:00
|
|
|
install-datadir install-localstatedir \
|
2019-05-28 08:23:08 +00:00
|
|
|
recurse-install
|
2019-01-23 12:00:16 +00:00
|
|
|
ifdef CONFIG_TRACE_SYSTEMTAP
|
|
|
|
|
$(INSTALL_PROG) "scripts/qemu-trace-stap" $(DESTDIR)$(bindir)
|
|
|
|
|
endif
|
2008-11-27 15:45:16 +00:00
|
|
|
ifneq ($(BLOBS),)
|
|
|
|
|
set -e; for x in $(BLOBS); do \
|
2012-04-18 19:55:41 +00:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/pc-bios/$$x "$(DESTDIR)$(qemu_datadir)"; \
|
2006-04-16 12:41:07 +00:00
|
|
|
done
|
2013-02-20 13:43:24 +00:00
|
|
|
endif
|
2019-01-10 12:00:45 +00:00
|
|
|
for s in $(ICON_SIZES); do \
|
2019-05-21 14:53:18 +00:00
|
|
|
mkdir -p "$(DESTDIR)$(qemu_icondir)/hicolor/$${s}/apps"; \
|
2019-01-10 12:00:45 +00:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/ui/icons/qemu_$${s}.png \
|
2019-05-21 14:53:18 +00:00
|
|
|
"$(DESTDIR)$(qemu_icondir)/hicolor/$${s}/apps/qemu.png"; \
|
2019-01-10 12:00:45 +00:00
|
|
|
done; \
|
2019-05-21 14:53:18 +00:00
|
|
|
mkdir -p "$(DESTDIR)$(qemu_icondir)/hicolor/32x32/apps"; \
|
2019-01-10 12:00:45 +00:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/ui/icons/qemu_32x32.bmp \
|
2019-05-21 14:53:18 +00:00
|
|
|
"$(DESTDIR)$(qemu_icondir)/hicolor/32x32/apps/qemu.bmp"; \
|
|
|
|
|
mkdir -p "$(DESTDIR)$(qemu_icondir)/hicolor/scalable/apps"; \
|
2019-01-10 12:00:45 +00:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/ui/icons/qemu.svg \
|
2019-05-21 14:53:18 +00:00
|
|
|
"$(DESTDIR)$(qemu_icondir)/hicolor/scalable/apps/qemu.svg"
|
|
|
|
|
mkdir -p "$(DESTDIR)$(qemu_desktopdir)"
|
2019-01-10 12:00:46 +00:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/ui/qemu.desktop \
|
2019-05-21 14:53:18 +00:00
|
|
|
"$(DESTDIR)$(qemu_desktopdir)/qemu.desktop"
|
2018-04-16 09:37:19 +00:00
|
|
|
ifdef CONFIG_GTK
|
2013-02-20 13:43:24 +00:00
|
|
|
$(MAKE) -C po $@
|
2008-11-27 15:45:16 +00:00
|
|
|
endif
|
2012-04-18 19:55:41 +00:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_datadir)/keymaps"
|
2008-03-05 18:16:09 +00:00
|
|
|
set -e; for x in $(KEYMAPS); do \
|
2012-04-18 19:55:41 +00:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/pc-bios/keymaps/$$x "$(DESTDIR)$(qemu_datadir)/keymaps"; \
|
2006-04-16 12:41:07 +00:00
|
|
|
done
|
2020-08-19 12:44:56 +00:00
|
|
|
for d in $(TARGET_DIRS); do \
|
|
|
|
|
$(MAKE) $(SUBDIR_MAKEFLAGS) TARGET_DIR=$$d/ -C $$d $@ || exit 1 ; \
|
|
|
|
|
done
|
2003-03-22 17:31:19 +00:00
|
|
|
|
2003-03-23 20:17:16 +00:00
|
|
|
# documentation
|
2017-01-19 09:06:44 +00:00
|
|
|
MAKEINFO=makeinfo
|
2017-06-06 14:55:19 +00:00
|
|
|
MAKEINFOINCLUDES= -I docs -I $(<D) -I $(@D)
|
|
|
|
|
MAKEINFOFLAGS=--no-split --number-sections $(MAKEINFOINCLUDES)
|
2018-11-26 10:51:25 +00:00
|
|
|
TEXI2PODFLAGS=$(MAKEINFOINCLUDES) -DVERSION="$(VERSION)" -DCONFDIR="$(qemu_confdir)"
|
2017-06-06 14:55:19 +00:00
|
|
|
TEXI2PDFFLAGS=$(if $(V),,--quiet) -I $(SRC_PATH) $(MAKEINFOINCLUDES)
|
2017-01-13 14:41:35 +00:00
|
|
|
|
2018-11-26 10:51:25 +00:00
|
|
|
docs/version.texi: $(SRC_PATH)/VERSION config-host.mak
|
|
|
|
|
$(call quiet-command,(\
|
|
|
|
|
echo "@set VERSION $(VERSION)" && \
|
|
|
|
|
echo "@set CONFDIR $(qemu_confdir)" \
|
|
|
|
|
)> $@,"GEN","$@")
|
2017-02-17 18:59:28 +00:00
|
|
|
|
2017-06-06 14:59:37 +00:00
|
|
|
%.html: %.texi docs/version.texi
|
2017-01-13 14:41:31 +00:00
|
|
|
$(call quiet-command,LC_ALL=C $(MAKEINFO) $(MAKEINFOFLAGS) --no-headers \
|
|
|
|
|
--html $< -o $@,"GEN","$@")
|
2003-03-23 20:17:16 +00:00
|
|
|
|
2017-06-06 14:59:37 +00:00
|
|
|
%.info: %.texi docs/version.texi
|
2017-01-13 14:41:31 +00:00
|
|
|
$(call quiet-command,$(MAKEINFO) $(MAKEINFOFLAGS) $< -o $@,"GEN","$@")
|
2006-04-30 22:51:54 +00:00
|
|
|
|
2017-06-06 14:59:37 +00:00
|
|
|
%.txt: %.texi docs/version.texi
|
2017-01-13 14:41:34 +00:00
|
|
|
$(call quiet-command,LC_ALL=C $(MAKEINFO) $(MAKEINFOFLAGS) --no-headers \
|
|
|
|
|
--plaintext $< -o $@,"GEN","$@")
|
|
|
|
|
|
2017-06-06 14:59:37 +00:00
|
|
|
%.pdf: %.texi docs/version.texi
|
2017-06-06 14:55:19 +00:00
|
|
|
$(call quiet-command,texi2pdf $(TEXI2PDFFLAGS) $< -o $@,"GEN","$@")
|
2017-03-15 12:56:56 +00:00
|
|
|
|
2019-03-07 14:26:46 +00:00
|
|
|
# Sphinx builds all its documentation at once in one invocation
|
|
|
|
|
# and handles "don't rebuild things unless necessary" itself.
|
|
|
|
|
# The '.doctrees' files are cached information to speed this up.
|
|
|
|
|
.PHONY: sphinxdocs
|
2020-01-23 15:22:40 +00:00
|
|
|
sphinxdocs: $(MANUAL_BUILDDIR)/devel/index.html \
|
|
|
|
|
$(MANUAL_BUILDDIR)/interop/index.html \
|
|
|
|
|
$(MANUAL_BUILDDIR)/specs/index.html \
|
2020-02-25 10:45:13 +00:00
|
|
|
$(MANUAL_BUILDDIR)/system/index.html \
|
2020-02-28 15:35:47 +00:00
|
|
|
$(MANUAL_BUILDDIR)/tools/index.html \
|
|
|
|
|
$(MANUAL_BUILDDIR)/user/index.html
|
2019-03-07 14:26:46 +00:00
|
|
|
|
|
|
|
|
# Canned command to build a single manual
|
2019-09-05 13:10:40 +00:00
|
|
|
# Arguments: $1 = manual name, $2 = Sphinx builder ('html' or 'man')
|
2019-10-14 15:01:33 +00:00
|
|
|
# Note the use of different doctree for each (manual, builder) tuple;
|
|
|
|
|
# this works around Sphinx not handling parallel invocation on
|
|
|
|
|
# a single doctree: https://github.com/sphinx-doc/sphinx/issues/2946
|
2020-04-11 18:29:32 +00:00
|
|
|
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")
|
2019-03-07 14:26:46 +00:00
|
|
|
# We assume all RST files in the manual's directory are used in it
|
2020-03-09 21:58:14 +00:00
|
|
|
manual-deps = $(wildcard $(SRC_PATH)/docs/$1/*.rst $(SRC_PATH)/docs/$1/*/*.rst) \
|
2020-02-28 15:36:00 +00:00
|
|
|
$(SRC_PATH)/docs/defs.rst.inc \
|
2020-03-06 17:17:47 +00:00
|
|
|
$(SRC_PATH)/docs/$1/conf.py $(SRC_PATH)/docs/conf.py \
|
|
|
|
|
$(SRC_PATH)/docs/sphinx/*.py
|
2020-01-24 16:25:59 +00:00
|
|
|
# Macro to write out the rule and dependencies for building manpages
|
|
|
|
|
# Usage: $(call define-manpage-rule,manualname,manpage1 manpage2...[,extradeps])
|
|
|
|
|
# 'extradeps' is optional, and specifies extra files (eg .hx files) that
|
|
|
|
|
# the manual page depends on.
|
|
|
|
|
define define-manpage-rule
|
|
|
|
|
$(call atomic,$(foreach manpage,$2,$(MANUAL_BUILDDIR)/$1/$(manpage)),$(call manual-deps,$1) $3)
|
|
|
|
|
$(call build-manual,$1,man)
|
|
|
|
|
endef
|
2019-03-07 14:26:46 +00:00
|
|
|
|
2019-03-08 13:57:42 +00:00
|
|
|
$(MANUAL_BUILDDIR)/devel/index.html: $(call manual-deps,devel)
|
2019-09-05 13:10:40 +00:00
|
|
|
$(call build-manual,devel,html)
|
2019-03-07 14:26:46 +00:00
|
|
|
|
2020-02-25 10:45:14 +00:00
|
|
|
$(MANUAL_BUILDDIR)/interop/index.html: $(call manual-deps,interop)
|
2019-09-05 13:10:40 +00:00
|
|
|
$(call build-manual,interop,html)
|
2019-03-07 14:26:46 +00:00
|
|
|
|
2019-06-17 14:35:31 +00:00
|
|
|
$(MANUAL_BUILDDIR)/specs/index.html: $(call manual-deps,specs)
|
2019-09-05 13:10:40 +00:00
|
|
|
$(call build-manual,specs,html)
|
|
|
|
|
|
2020-02-28 15:36:13 +00:00
|
|
|
$(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
|
2020-01-23 15:22:40 +00:00
|
|
|
$(call build-manual,system,html)
|
|
|
|
|
|
2020-02-25 10:45:14 +00:00
|
|
|
$(MANUAL_BUILDDIR)/tools/index.html: $(call manual-deps,tools) $(SRC_PATH)/qemu-img-cmds.hx $(SRC_PATH)/docs/qemu-option-trace.rst.inc
|
2020-02-25 10:45:13 +00:00
|
|
|
$(call build-manual,tools,html)
|
|
|
|
|
|
2020-02-28 15:35:47 +00:00
|
|
|
$(MANUAL_BUILDDIR)/user/index.html: $(call manual-deps,user)
|
|
|
|
|
$(call build-manual,user,html)
|
|
|
|
|
|
2020-02-25 10:45:14 +00:00
|
|
|
$(call define-manpage-rule,interop,qemu-ga.8)
|
2020-01-23 15:22:39 +00:00
|
|
|
|
2020-02-28 15:36:15 +00:00
|
|
|
$(call define-manpage-rule,system,qemu.1 qemu-block-drivers.7 qemu-cpu-models.7)
|
qemu-block-drivers: Convert to rST
The qemu-block-drivers documentation is currently in
docs/qemu-block-drivers.texi in Texinfo format, which we present
to the user as:
* a qemu-block-drivers manpage
* a section of the main qemu-doc HTML documentation
Convert the documentation to rST format, and present it to
the user as:
* a qemu-block-drivers manpage
* part of the system/ Sphinx manual
This follows the same pattern we've done for qemu-ga and qemu-nbd.
We have to drop a cross-reference from the documentation of the
-cdrom option back to the qemu-block-drivers documentation, since
they're no longer within the same texinfo document.
As noted in a comment, the manpage output is slightly compromised
due to limitations in Sphinx. In an ideal world, the HTML output
would have the various headings like 'Disk image file formats'
as top-level section headings (which then appear in the overall
system manual's table-of-contents), and it would not have the
section headings which make sense only for the manpage like
'synopsis', 'description', and 'see also'. Unfortunately, the
mechanism Sphinx provides for restricting pieces of documentation
is limited to the point of being flawed: the 'only::' directive
is implemented as a filter that is applied at a very late stage
in the document processing pipeline, rather than as an early
equivalent of an #ifdef. This means that Sphinx's process of
identifying which section heading markup styles are which levels
of heading gets confused if the 'only::' directive contains
section headings which would affect the heading-level of a
later heading. I have opted to prioritise making the HTML format
look better, with the compromise being that in the manpage
the 'Disk image file formats' &c headings are top-level headings
rather than being sub-headings under the traditional 'Description'
top-level section title.
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
Message-id: 20200116141511.16849-4-peter.maydell@linaro.org
2020-01-23 15:22:40 +00:00
|
|
|
|
2020-02-25 10:45:14 +00:00
|
|
|
$(call define-manpage-rule,tools,\
|
|
|
|
|
qemu-img.1 qemu-nbd.8 qemu-trace-stap.1\
|
|
|
|
|
virtiofsd.1 virtfs-proxy-helper.1,\
|
|
|
|
|
$(SRC_PATH)/qemu-img-cmds.hx $(SRC_PATH)/docs/qemu-option-trace.rst.inc)
|
|
|
|
|
|
2019-12-19 13:56:20 +00:00
|
|
|
$(MANUAL_BUILDDIR)/index.html: $(SRC_PATH)/docs/index.html.in qemu-version.h
|
2020-01-20 16:34:00 +00:00
|
|
|
@mkdir -p "$(MANUAL_BUILDDIR)"
|
2019-12-19 13:56:20 +00:00
|
|
|
$(call quiet-command, sed "s|@@VERSION@@|${VERSION}|g" $< >$@, \
|
|
|
|
|
"GEN","$@")
|
|
|
|
|
|
2018-02-11 09:36:05 +00:00
|
|
|
docs/interop/qemu-qmp-qapi.texi: qapi/qapi-doc.texi
|
2018-02-26 19:48:58 +00:00
|
|
|
@cp -p $< $@
|
2017-03-20 13:11:50 +00:00
|
|
|
|
2019-07-18 11:19:02 +00:00
|
|
|
docs/interop/qemu-ga-qapi.texi: qga/qga-qapi-doc.texi
|
2018-02-26 19:48:58 +00:00
|
|
|
@cp -p $< $@
|
2017-01-13 14:41:35 +00:00
|
|
|
|
2020-02-28 15:36:17 +00:00
|
|
|
html: docs/interop/qemu-qmp-ref.html docs/interop/qemu-ga-ref.html sphinxdocs
|
|
|
|
|
info: docs/interop/qemu-qmp-ref.info docs/interop/qemu-ga-ref.info
|
|
|
|
|
pdf: docs/interop/qemu-qmp-ref.pdf docs/interop/qemu-ga-ref.pdf
|
|
|
|
|
txt: docs/interop/qemu-qmp-ref.txt docs/interop/qemu-ga-ref.txt
|
2008-09-24 01:13:40 +00:00
|
|
|
|
2017-06-06 14:55:19 +00:00
|
|
|
docs/interop/qemu-ga-ref.dvi docs/interop/qemu-ga-ref.html \
|
|
|
|
|
docs/interop/qemu-ga-ref.info docs/interop/qemu-ga-ref.pdf \
|
|
|
|
|
docs/interop/qemu-ga-ref.txt docs/interop/qemu-ga-ref.7: \
|
|
|
|
|
docs/interop/qemu-ga-ref.texi docs/interop/qemu-ga-qapi.texi
|
2017-01-13 14:41:35 +00:00
|
|
|
|
2017-06-06 14:55:19 +00:00
|
|
|
docs/interop/qemu-qmp-ref.dvi docs/interop/qemu-qmp-ref.html \
|
|
|
|
|
docs/interop/qemu-qmp-ref.info docs/interop/qemu-qmp-ref.pdf \
|
|
|
|
|
docs/interop/qemu-qmp-ref.txt docs/interop/qemu-qmp-ref.7: \
|
|
|
|
|
docs/interop/qemu-qmp-ref.texi docs/interop/qemu-qmp-qapi.texi
|
2017-01-13 14:41:35 +00:00
|
|
|
|
2019-01-17 19:36:39 +00:00
|
|
|
$(filter %.1 %.7 %.8,$(DOCS)): scripts/texi2pod.pl
|
|
|
|
|
|
2018-06-20 13:04:24 +00:00
|
|
|
# Reports/Analysis
|
|
|
|
|
|
|
|
|
|
%/coverage-report.html:
|
|
|
|
|
@mkdir -p $*
|
|
|
|
|
$(call quiet-command,\
|
2019-04-30 15:59:48 +00:00
|
|
|
gcovr -r $(SRC_PATH) \
|
|
|
|
|
$(foreach t, $(TARGET_DIRS), --object-directory $(BUILD_DIR)/$(t)) \
|
|
|
|
|
--object-directory $(BUILD_DIR) \
|
2019-03-12 09:18:31 +00:00
|
|
|
-p --html --html-details -o $@, \
|
2018-06-20 13:04:24 +00:00
|
|
|
"GEN", "coverage-report.html")
|
|
|
|
|
|
|
|
|
|
.PHONY: coverage-report
|
|
|
|
|
coverage-report: $(CURDIR)/reports/coverage/coverage-report.html
|
2017-01-13 14:41:35 +00:00
|
|
|
|
2013-07-15 21:49:57 +00:00
|
|
|
ifdef CONFIG_WIN32
|
|
|
|
|
|
|
|
|
|
INSTALLER = qemu-setup-$(VERSION)$(EXESUF)
|
|
|
|
|
|
|
|
|
|
nsisflags = -V2 -NOCD
|
|
|
|
|
|
|
|
|
|
ifneq ($(wildcard $(SRC_PATH)/dll),)
|
|
|
|
|
ifeq ($(ARCH),x86_64)
|
|
|
|
|
# 64 bit executables
|
|
|
|
|
DLL_PATH = $(SRC_PATH)/dll/w64
|
|
|
|
|
nsisflags += -DW64
|
|
|
|
|
else
|
|
|
|
|
# 32 bit executables
|
|
|
|
|
DLL_PATH = $(SRC_PATH)/dll/w32
|
|
|
|
|
endif
|
|
|
|
|
endif
|
|
|
|
|
|
|
|
|
|
.PHONY: installer
|
|
|
|
|
installer: $(INSTALLER)
|
|
|
|
|
|
|
|
|
|
INSTDIR=/tmp/qemu-nsis
|
|
|
|
|
|
2020-08-10 13:23:28 +00:00
|
|
|
$(INSTALLER): $(SRC_PATH)/qemu.nsi
|
|
|
|
|
$(MAKE) install DESTDIR=${INSTDIR}
|
2013-07-15 21:49:57 +00:00
|
|
|
ifdef SIGNCODE
|
2020-08-10 13:23:28 +00:00
|
|
|
(cd ${INSTDIR}/${bindir}; \
|
2013-07-15 21:49:57 +00:00
|
|
|
for i in *.exe; do \
|
|
|
|
|
$(SIGNCODE) $${i}; \
|
|
|
|
|
done \
|
|
|
|
|
)
|
|
|
|
|
endif # SIGNCODE
|
2020-08-10 13:23:28 +00:00
|
|
|
(cd ${INSTDIR}/${bindir}; \
|
2013-07-15 21:49:57 +00:00
|
|
|
for i in qemu-system-*.exe; do \
|
|
|
|
|
arch=$${i%.exe}; \
|
|
|
|
|
arch=$${arch#qemu-system-}; \
|
|
|
|
|
echo Section \"$$arch\" Section_$$arch; \
|
|
|
|
|
echo SetOutPath \"\$$INSTDIR\"; \
|
|
|
|
|
echo File \"\$${BINDIR}\\$$i\"; \
|
|
|
|
|
echo SectionEnd; \
|
|
|
|
|
done \
|
2020-08-10 13:23:28 +00:00
|
|
|
) >${INSTDIR}/${bindir}/system-emulations.nsh
|
2013-07-15 21:49:57 +00:00
|
|
|
makensis $(nsisflags) \
|
|
|
|
|
$(if $(BUILD_DOCS),-DCONFIG_DOCUMENTATION="y") \
|
|
|
|
|
$(if $(CONFIG_GTK),-DCONFIG_GTK="y") \
|
2020-08-10 13:23:28 +00:00
|
|
|
-DBINDIR="${INSTDIR}/${bindir}" \
|
2013-07-15 21:49:57 +00:00
|
|
|
$(if $(DLL_PATH),-DDLLDIR="$(DLL_PATH)") \
|
|
|
|
|
-DSRCDIR="$(SRC_PATH)" \
|
|
|
|
|
-DOUTFILE="$(INSTALLER)" \
|
2015-05-03 17:57:09 +00:00
|
|
|
-DDISPLAYVERSION="$(VERSION)" \
|
2013-07-15 21:49:57 +00:00
|
|
|
$(SRC_PATH)/qemu.nsi
|
|
|
|
|
rm -r ${INSTDIR}
|
|
|
|
|
ifdef SIGNCODE
|
|
|
|
|
$(SIGNCODE) $(INSTALLER)
|
|
|
|
|
endif # SIGNCODE
|
|
|
|
|
endif # CONFIG_WIN
|
|
|
|
|
|
2012-07-17 23:58:20 +00:00
|
|
|
# Add a dependency on the generated files, so that they are always
|
|
|
|
|
# rebuilt before other object files
|
2017-06-08 12:59:59 +00:00
|
|
|
ifneq ($(wildcard config-host.mak),)
|
2015-05-22 05:35:07 +00:00
|
|
|
ifneq ($(filter-out $(UNCHECKED_GOALS),$(MAKECMDGOALS)),$(if $(MAKECMDGOALS),,fail))
|
2019-04-01 14:12:19 +00:00
|
|
|
Makefile: $(generated-files-y)
|
2012-09-16 20:07:13 +00:00
|
|
|
endif
|
2017-06-08 12:59:59 +00:00
|
|
|
endif
|
2012-07-17 23:58:20 +00:00
|
|
|
|
2007-11-07 19:24:02 +00:00
|
|
|
# Include automatically generated dependency files
|
2012-07-11 14:40:21 +00:00
|
|
|
# Dependencies in Makefile.objs files come from our recursive subdir rules
|
|
|
|
|
-include $(wildcard *.d tests/*.d)
|
Makefile: Rules for docker testing
This adds a group of make targets to run docker tests, all are available
in source tree without running ./configure.
The usage is shown with "make docker".
Besides the fixed ones, dynamic targets for building each image and
running each test in each image are generated automatically by make,
scanning $(SRC_PATH)/tests/docker/ files with specific patterns.
Alternative to manually list particular targets (docker-TEST@IMAGE)
set, you can control which tests/images to run by filtering variables,
TESTS= and IMAGES=, which are expressed in Makefile pattern syntax,
"foo% %bar ...". For example:
$ make docker-test IMAGES="ubuntu fedora"
Unfortunately, it's impossible to propagate "-j $JOBS" into make in
containers, however since each combination is made a first class target
in the top Makefile, "make -j$N docker-test" still parallels the tests
coarsely.
Still, $J is made a magic variable to let all make invocations in
containers to use -j$J.
Instead of providing a live version of the source tree to the docker
container we snapshot it with git-archive. This ensures the tree is in a
pristine state for whatever operations the container is going to run on
them.
Uncommitted changes known to files known by the git index will be
included in the snapshot if there are any.
Signed-off-by: Fam Zheng <famz@redhat.com>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Message-id: 1464755128-32490-5-git-send-email-famz@redhat.com
2016-06-01 04:25:17 +00:00
|
|
|
|
|
|
|
|
include $(SRC_PATH)/tests/docker/Makefile.include
|
2017-09-05 02:11:58 +00:00
|
|
|
include $(SRC_PATH)/tests/vm/Makefile.include
|
2016-09-13 14:20:33 +00:00
|
|
|
|
2020-03-05 00:48:54 +00:00
|
|
|
print-help-run = printf " %-30s - %s\\n" "$1" "$2"
|
|
|
|
|
print-help = $(quiet-@)$(call print-help-run,$1,$2)
|
|
|
|
|
|
2016-09-13 14:20:33 +00:00
|
|
|
.PHONY: help
|
|
|
|
|
help:
|
|
|
|
|
@echo 'Generic targets:'
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,all,Build all)
|
2018-03-06 16:17:28 +00:00
|
|
|
ifdef CONFIG_MODULES
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,modules,Build all modules)
|
2018-03-06 16:17:28 +00:00
|
|
|
endif
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,dir/file.o,Build specified target only)
|
|
|
|
|
$(call print-help,install,Install QEMU, documentation and tools)
|
|
|
|
|
$(call print-help,ctags/TAGS,Generate tags file for editors)
|
|
|
|
|
$(call print-help,cscope,Generate cscope index)
|
2020-02-03 13:45:33 +00:00
|
|
|
$(call print-help,sparse,Run sparse on the QEMU source)
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo ''
|
2018-07-04 06:30:11 +00:00
|
|
|
@$(if $(TARGET_DIRS), \
|
2016-09-13 14:20:33 +00:00
|
|
|
echo 'Architecture specific targets:'; \
|
2018-07-04 06:30:11 +00:00
|
|
|
$(foreach t, $(TARGET_DIRS), \
|
2020-05-14 14:34:29 +00:00
|
|
|
$(call print-help-run,$(t)/all,Build for $(t)); \
|
|
|
|
|
$(if $(CONFIG_FUZZ), \
|
|
|
|
|
$(if $(findstring softmmu,$(t)), \
|
|
|
|
|
$(call print-help-run,$(t)/fuzz,Build fuzzer for $(t)); \
|
|
|
|
|
))) \
|
2016-09-13 14:20:33 +00:00
|
|
|
echo '')
|
|
|
|
|
@echo 'Cleaning targets:'
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,clean,Remove most generated files but keep the config)
|
|
|
|
|
$(call print-help,distclean,Remove all generated files)
|
|
|
|
|
$(call print-help,dist,Build a distributable tarball)
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo ''
|
|
|
|
|
@echo 'Test targets:'
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,check,Run all tests (check-help for details))
|
|
|
|
|
$(call print-help,docker,Help about targets running tests inside containers)
|
|
|
|
|
$(call print-help,vm-help,Help about targets running tests inside VM)
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo ''
|
|
|
|
|
@echo 'Documentation targets:'
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,html info pdf txt,Build documentation in specified format)
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo ''
|
|
|
|
|
ifdef CONFIG_WIN32
|
|
|
|
|
@echo 'Windows targets:'
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,installer,Build NSIS-based installer for QEMU)
|
2016-09-13 14:20:33 +00:00
|
|
|
ifdef QEMU_GA_MSI_ENABLED
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,msi,Build MSI-based installer for qemu-ga)
|
2016-09-13 14:20:33 +00:00
|
|
|
endif
|
|
|
|
|
@echo ''
|
|
|
|
|
endif
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,$(MAKE) [targets],(quiet build, default))
|
|
|
|
|
$(call print-help,$(MAKE) V=1 [targets],(verbose build))
|