2006-05-14 16:07:53 +04:00
|
|
|
# Makefile for QEMU.
|
|
|
|
|
2019-05-26 17:47:47 +03:00
|
|
|
ifneq ($(words $(subst :, ,$(CURDIR))), 1)
|
|
|
|
$(error main directory cannot contain spaces nor colons)
|
|
|
|
endif
|
|
|
|
|
2011-09-16 23:50:43 +04:00
|
|
|
# Always point to the root of the build tree (needs GNU make).
|
|
|
|
BUILD_DIR=$(CURDIR)
|
2011-09-16 00:45:35 +04:00
|
|
|
|
2015-05-22 08:35:07 +03:00
|
|
|
# Before including a proper config-host.mak, assume we are in the source tree
|
|
|
|
SRC_PATH=.
|
|
|
|
|
2017-11-21 06:22:47 +03:00
|
|
|
UNCHECKED_GOALS := %clean TAGS cscope ctags dist \
|
|
|
|
html info pdf txt \
|
2018-01-04 19:05:08 +03:00
|
|
|
help check-help print-% \
|
2019-05-31 09:43:41 +03:00
|
|
|
docker docker-% vm-help vm-test vm-build-%
|
2015-05-22 08:35:07 +03:00
|
|
|
|
2012-03-06 22:50:38 +04:00
|
|
|
# All following code might depend on configuration variables
|
2009-04-15 18:42:57 +04:00
|
|
|
ifneq ($(wildcard config-host.mak),)
|
2009-05-19 19:17:58 +04:00
|
|
|
# Put the all: rule here so that config-host.mak can contain dependencies.
|
2012-07-09 22:36:36 +04:00
|
|
|
all:
|
2006-04-16 16:41:07 +04:00
|
|
|
include config-host.mak
|
2012-10-19 17:54:23 +04:00
|
|
|
|
2017-09-29 13:11:56 +03:00
|
|
|
git-submodule-update:
|
|
|
|
|
|
|
|
.PHONY: git-submodule-update
|
|
|
|
|
2017-11-06 14:08:14 +03:00
|
|
|
git_module_status := $(shell \
|
|
|
|
cd '$(SRC_PATH)' && \
|
|
|
|
GIT="$(GIT)" ./scripts/git-submodule.sh status $(GIT_SUBMODULES); \
|
|
|
|
echo $$?; \
|
|
|
|
)
|
2017-09-29 13:11:56 +03:00
|
|
|
|
|
|
|
ifeq (1,$(git_module_status))
|
2017-10-26 15:52:26 +03: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 13:11:56 +03:00
|
|
|
git-submodule-update:
|
|
|
|
$(call quiet-command, \
|
2017-10-20 17:02:43 +03:00
|
|
|
(cd $(SRC_PATH) && GIT="$(GIT)" ./scripts/git-submodule.sh update $(GIT_SUBMODULES)), \
|
2017-09-29 13:11:56 +03:00
|
|
|
"GIT","$(GIT_SUBMODULES)")
|
|
|
|
endif
|
|
|
|
endif
|
|
|
|
|
2019-06-10 13:05:14 +03: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 16:48:54 +03: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 13:11:58 +03:00
|
|
|
.git-submodule-status: git-submodule-update config-host.mak
|
2017-09-29 13:11:56 +03:00
|
|
|
|
2012-10-19 17:54:23 +04: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 12:55:10 +03:00
|
|
|
"$(MAKE) distclean && rm -rf *-linux-user *-softmmu" in your source tree)
|
2012-10-19 17:54:23 +04:00
|
|
|
endif
|
|
|
|
endif
|
|
|
|
|
2018-07-04 09:30:11 +03:00
|
|
|
CONFIG_SOFTMMU := $(if $(filter %-softmmu,$(TARGET_DIRS)),y)
|
|
|
|
CONFIG_USER_ONLY := $(if $(filter %-user,$(TARGET_DIRS)),y)
|
2017-03-16 23:01:50 +03:00
|
|
|
CONFIG_XEN := $(CONFIG_XEN_BACKEND)
|
2013-04-16 12:50:38 +04:00
|
|
|
CONFIG_ALL=y
|
|
|
|
-include config-all-devices.mak
|
|
|
|
-include config-all-disas.mak
|
|
|
|
|
2018-12-14 11:47:54 +03:00
|
|
|
config-host.mak: $(SRC_PATH)/configure $(SRC_PATH)/pc-bios $(SRC_PATH)/VERSION
|
2009-10-07 04:40:59 +04:00
|
|
|
@echo $@ is out-of-date, running configure
|
2019-06-10 13:05:14 +03:00
|
|
|
@if test -f meson-private/coredata.dat; then \
|
|
|
|
./config.status --skip-meson; \
|
|
|
|
else \
|
|
|
|
./config.status; \
|
|
|
|
fi
|
2018-10-21 20:56:29 +03: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 18:42:57 +04:00
|
|
|
else
|
|
|
|
config-host.mak:
|
2015-05-22 08:35:07 +03:00
|
|
|
ifneq ($(filter-out $(UNCHECKED_GOALS),$(MAKECMDGOALS)),$(if $(MAKECMDGOALS),,fail))
|
2009-04-15 18:42:57 +04:00
|
|
|
@echo "Please call configure before running make!"
|
|
|
|
@exit 1
|
|
|
|
endif
|
2012-09-17 00:07:13 +04:00
|
|
|
endif
|
2003-02-19 02:35:48 +03:00
|
|
|
|
2016-06-01 07:25:16 +03:00
|
|
|
include $(SRC_PATH)/rules.mak
|
|
|
|
|
2019-07-18 13:24:29 +03:00
|
|
|
# lor is defined in rules.mak
|
2019-04-01 17:12:22 +03:00
|
|
|
CONFIG_BLOCK := $(call lor,$(CONFIG_SOFTMMU),$(CONFIG_TOOLS))
|
|
|
|
|
2019-03-07 17:26:47 +03:00
|
|
|
# Create QEMU_PKGVERSION and FULL_VERSION strings
|
|
|
|
# If PKGVERSION is set, use that; otherwise get version and -dirty status from git
|
|
|
|
QEMU_PKGVERSION := $(if $(PKGVERSION),$(PKGVERSION),$(shell \
|
|
|
|
cd $(SRC_PATH); \
|
|
|
|
if test -e .git; then \
|
|
|
|
git describe --match 'v*' 2>/dev/null | tr -d '\n'; \
|
|
|
|
if ! git diff-index --quiet HEAD &>/dev/null; then \
|
|
|
|
echo "-dirty"; \
|
|
|
|
fi; \
|
|
|
|
fi))
|
|
|
|
|
|
|
|
# Either "version (pkgversion)", or just "version" if pkgversion not set
|
|
|
|
FULL_VERSION := $(if $(QEMU_PKGVERSION),$(VERSION) ($(QEMU_PKGVERSION)),$(VERSION))
|
|
|
|
|
2019-04-01 17:12:19 +03:00
|
|
|
generated-files-y = qemu-version.h config-host.h qemu-options.def
|
2018-11-16 23:00:16 +03:00
|
|
|
|
2019-04-01 17:12:19 +03:00
|
|
|
generated-files-y += module_block.h
|
2016-08-12 16:27:02 +03:00
|
|
|
|
2019-04-01 17:12:19 +03:00
|
|
|
generated-files-y += .git-submodule-status
|
2017-01-25 19:14:15 +03:00
|
|
|
|
2017-09-29 13:11:58 +03:00
|
|
|
KEYCODEMAP_GEN = $(SRC_PATH)/ui/keycodemapdb/tools/keymap-gen
|
|
|
|
KEYCODEMAP_CSV = $(SRC_PATH)/ui/keycodemapdb/data/keymaps.csv
|
|
|
|
|
|
|
|
KEYCODEMAP_FILES = \
|
2020-02-04 14:41:01 +03:00
|
|
|
ui/input-keymap-atset1-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-linux-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-qcode-to-atset1.c.inc \
|
|
|
|
ui/input-keymap-qcode-to-atset2.c.inc \
|
|
|
|
ui/input-keymap-qcode-to-atset3.c.inc \
|
|
|
|
ui/input-keymap-qcode-to-linux.c.inc \
|
|
|
|
ui/input-keymap-qcode-to-qnum.c.inc \
|
|
|
|
ui/input-keymap-qcode-to-sun.c.inc \
|
|
|
|
ui/input-keymap-qnum-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-usb-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-win32-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-x11-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-xorgevdev-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-xorgkbd-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-xorgxquartz-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-xorgxwin-to-qcode.c.inc \
|
|
|
|
ui/input-keymap-osx-to-qcode.c.inc \
|
2017-09-29 13:11:58 +03:00
|
|
|
$(NULL)
|
|
|
|
|
2019-04-01 17:12:19 +03:00
|
|
|
generated-files-$(CONFIG_SOFTMMU) += $(KEYCODEMAP_FILES)
|
2017-09-29 13:11:58 +03:00
|
|
|
|
2020-02-04 14:41:01 +03:00
|
|
|
ui/input-keymap-%.c.inc: $(KEYCODEMAP_GEN) $(KEYCODEMAP_CSV) $(SRC_PATH)/ui/Makefile.objs
|
2017-09-29 13:11:58 +03:00
|
|
|
$(call quiet-command,\
|
2018-01-19 10:52:27 +03:00
|
|
|
stem=$* && src=$${stem%-to-*} dst=$${stem#*-to-} && \
|
2017-09-29 13:11:58 +03:00
|
|
|
test -e $(KEYCODEMAP_GEN) && \
|
|
|
|
$(PYTHON) $(KEYCODEMAP_GEN) \
|
|
|
|
--lang glib2 \
|
|
|
|
--varname qemu_input_map_$${src}_to_$${dst} \
|
|
|
|
code-map $(KEYCODEMAP_CSV) $${src} $${dst} \
|
|
|
|
> $@ || rm -f $@, "GEN", "$@")
|
|
|
|
|
|
|
|
$(KEYCODEMAP_GEN): .git-submodule-status
|
|
|
|
$(KEYCODEMAP_CSV): .git-submodule-status
|
|
|
|
|
2019-03-08 03:19:35 +03:00
|
|
|
edk2-decompressed = $(basename $(wildcard pc-bios/edk2-*.fd.bz2))
|
|
|
|
pc-bios/edk2-%.fd: pc-bios/edk2-%.fd.bz2
|
|
|
|
$(call quiet-command,bzip2 -d -c $< > $@,"BUNZIP2",$<)
|
|
|
|
|
2009-10-06 23:11:15 +04:00
|
|
|
# Don't try to regenerate Makefile or configure
|
|
|
|
# We don't generate any of them
|
|
|
|
Makefile: ;
|
|
|
|
configure: ;
|
|
|
|
|
2017-01-13 17:41:32 +03:00
|
|
|
.PHONY: all clean cscope distclean html info install install-doc \
|
2017-11-21 17:25:38 +03:00
|
|
|
pdf txt recurse-all dist msi FORCE
|
2006-05-14 16:07:53 +04:00
|
|
|
|
2012-05-29 13:49:50 +04:00
|
|
|
$(call set-vpath, $(SRC_PATH))
|
2007-11-19 00:12:37 +03:00
|
|
|
|
2009-08-03 16:47:06 +04:00
|
|
|
LIBS+=-lz $(LIBS_TOOLS)
|
2009-07-27 18:12:51 +04:00
|
|
|
|
2020-04-23 13:43:45 +03:00
|
|
|
HELPERS-y = $(HELPERS)
|
2019-05-24 16:09:42 +03:00
|
|
|
|
2020-04-23 13:43:45 +03:00
|
|
|
HELPERS-$(call land,$(CONFIG_SOFTMMU),$(CONFIG_LINUX)) += qemu-bridge-helper$(EXESUF)
|
2012-01-26 18:42:24 +04:00
|
|
|
|
2019-09-19 18:59:57 +03: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 21:57:59 +04:00
|
|
|
ifdef BUILD_DOCS
|
2020-02-28 18:36:15 +03:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/system/qemu.1
|
2020-02-25 13:45:14 +03:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/qemu-img.1
|
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/qemu-nbd.8
|
2020-01-23 18:22:39 +03:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/interop/qemu-ga.8
|
2020-02-07 19:29:51 +03:00
|
|
|
ifeq ($(CONFIG_LINUX)$(CONFIG_SECCOMP)$(CONFIG_LIBCAP_NG),yyy)
|
2020-02-25 13:45:14 +03:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/virtiofsd.1
|
2020-02-07 19:29:51 +03: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 18:22:40 +03:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/system/qemu-block-drivers.7
|
2017-06-06 17:55:19 +03: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 18:36:01 +03:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/system/qemu-cpu-models.7
|
2019-12-19 16:56:20 +03:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/index.html
|
2012-02-24 12:30:42 +04:00
|
|
|
ifdef CONFIG_VIRTFS
|
2020-02-25 13:45:14 +03:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/virtfs-proxy-helper.1
|
2012-02-24 12:30:42 +04:00
|
|
|
endif
|
2019-01-23 15:00:16 +03:00
|
|
|
ifdef CONFIG_TRACE_SYSTEMTAP
|
2020-02-25 13:45:14 +03:00
|
|
|
DOCS+=$(MANUAL_BUILDDIR)/tools/qemu-trace-stap.1
|
2019-01-23 15:00:16 +03:00
|
|
|
endif
|
2006-04-23 21:57:59 +04:00
|
|
|
else
|
|
|
|
DOCS=
|
|
|
|
endif
|
2003-05-25 20:41:18 +04:00
|
|
|
|
2018-01-23 19:47:17 +03:00
|
|
|
SUBDIR_MAKEFLAGS=$(if $(V),,--no-print-directory --quiet) BUILD_DIR=$(BUILD_DIR)
|
2019-01-23 09:56:01 +03:00
|
|
|
SUBDIR_DEVICES_MAK=$(patsubst %, %/config-devices.mak, $(filter %-softmmu, $(TARGET_DIRS)))
|
|
|
|
SUBDIR_DEVICES_MAK_DEP=$(patsubst %, %.d, $(SUBDIR_DEVICES_MAK))
|
2009-10-07 04:41:02 +04:00
|
|
|
|
2012-09-14 21:02:30 +04:00
|
|
|
ifeq ($(SUBDIR_DEVICES_MAK),)
|
2019-03-13 13:51:14 +03:00
|
|
|
config-all-devices.mak: config-host.mak
|
2016-10-04 19:27:21 +03:00
|
|
|
$(call quiet-command,echo '# no devices' > $@,"GEN","$@")
|
2012-09-14 21:02:30 +04:00
|
|
|
else
|
2019-03-13 13:51:14 +03:00
|
|
|
config-all-devices.mak: $(SUBDIR_DEVICES_MAK) config-host.mak
|
2013-04-03 19:53:21 +04:00
|
|
|
$(call quiet-command, sed -n \
|
|
|
|
's|^\([^=]*\)=\(.*\)$$|\1:=$$(findstring y,$$(\1)\2)|p' \
|
|
|
|
$(SUBDIR_DEVICES_MAK) | sort -u > $@, \
|
2016-10-04 19:27:21 +03:00
|
|
|
"GEN","$@")
|
2012-09-14 21:02:30 +04:00
|
|
|
endif
|
2009-10-07 04:41:02 +04:00
|
|
|
|
2010-11-26 21:47:45 +03:00
|
|
|
-include $(SUBDIR_DEVICES_MAK_DEP)
|
|
|
|
|
2019-01-23 09:56:01 +03:00
|
|
|
# This has to be kept in sync with Kconfig.host.
|
|
|
|
MINIKCONF_ARGS = \
|
2019-01-23 09:56:17 +03:00
|
|
|
$(CONFIG_MINIKCONF_MODE) \
|
2020-06-26 14:18:16 +03:00
|
|
|
$@ $*/config-devices.mak.d $< $(SRC_PATH)/Kconfig \
|
2020-06-18 15:33:40 +03:00
|
|
|
CONFIG_TCG=$(CONFIG_TCG) \
|
2019-01-23 09:56:01 +03:00
|
|
|
CONFIG_KVM=$(CONFIG_KVM) \
|
|
|
|
CONFIG_SPICE=$(CONFIG_SPICE) \
|
|
|
|
CONFIG_IVSHMEM=$(CONFIG_IVSHMEM) \
|
|
|
|
CONFIG_TPM=$(CONFIG_TPM) \
|
|
|
|
CONFIG_XEN=$(CONFIG_XEN) \
|
|
|
|
CONFIG_OPENGL=$(CONFIG_OPENGL) \
|
|
|
|
CONFIG_X11=$(CONFIG_X11) \
|
|
|
|
CONFIG_VHOST_USER=$(CONFIG_VHOST_USER) \
|
2019-08-15 16:13:06 +03:00
|
|
|
CONFIG_VHOST_KERNEL=$(CONFIG_VHOST_KERNEL) \
|
2019-01-23 09:56:01 +03:00
|
|
|
CONFIG_VIRTFS=$(CONFIG_VIRTFS) \
|
2019-03-14 16:09:09 +03:00
|
|
|
CONFIG_LINUX=$(CONFIG_LINUX) \
|
|
|
|
CONFIG_PVRDMA=$(CONFIG_PVRDMA)
|
2019-01-23 09:56:01 +03:00
|
|
|
|
2020-06-18 15:33:37 +03:00
|
|
|
MINIKCONF = $(PYTHON) $(SRC_PATH)/scripts/minikconf.py
|
2019-01-23 09:56:01 +03:00
|
|
|
|
2020-06-26 14:18:16 +03:00
|
|
|
$(SUBDIR_DEVICES_MAK): %/config-devices.mak: default-configs/%.mak $(SRC_PATH)/Kconfig $(BUILD_DIR)/config-host.mak
|
2020-06-18 15:33:38 +03:00
|
|
|
$(call quiet-command, $(MINIKCONF) $(MINIKCONF_ARGS) \
|
|
|
|
> $@.tmp, "GEN", "$@.tmp")
|
2015-02-19 10:48:46 +03:00
|
|
|
$(call quiet-command, if test -f $@; then \
|
2010-10-02 18:28:08 +04:00
|
|
|
if cmp -s $@.old $@; then \
|
2010-11-26 21:47:45 +03:00
|
|
|
mv $@.tmp $@; \
|
|
|
|
cp -p $@ $@.old; \
|
2009-12-20 17:39:03 +03:00
|
|
|
else \
|
|
|
|
if test -f $@.old; then \
|
|
|
|
echo "WARNING: $@ (user modified) out of date.";\
|
|
|
|
else \
|
|
|
|
echo "WARNING: $@ out of date.";\
|
|
|
|
fi; \
|
2017-11-21 12:55:10 +03:00
|
|
|
echo "Run \"$(MAKE) defconfig\" to regenerate."; \
|
2009-12-20 17:39:03 +03:00
|
|
|
rm $@.tmp; \
|
|
|
|
fi; \
|
2009-11-22 19:25:30 +03:00
|
|
|
else \
|
2009-12-20 17:39:03 +03:00
|
|
|
mv $@.tmp $@; \
|
|
|
|
cp -p $@ $@.old; \
|
2016-10-04 19:27:21 +03:00
|
|
|
fi,"GEN","$@");
|
2009-11-22 19:25:30 +03:00
|
|
|
|
|
|
|
defconfig:
|
|
|
|
rm -f config-all-devices.mak $(SUBDIR_DEVICES_MAK)
|
|
|
|
|
2012-12-21 11:34:49 +04:00
|
|
|
ifneq ($(wildcard config-host.mak),)
|
|
|
|
include $(SRC_PATH)/Makefile.objs
|
2014-02-10 10:48:52 +04:00
|
|
|
endif
|
|
|
|
|
|
|
|
dummy := $(call unnest-vars,, \
|
2015-10-21 15:16:21 +03:00
|
|
|
authz-obj-y \
|
2016-12-12 15:49:01 +03:00
|
|
|
chardev-obj-y \
|
2014-03-26 22:28:45 +04:00
|
|
|
qga-vss-dll-obj-y \
|
2014-02-10 10:48:52 +04:00
|
|
|
block-obj-y \
|
2014-02-10 10:48:59 +04:00
|
|
|
block-obj-m \
|
2020-02-24 17:29:54 +03:00
|
|
|
storage-daemon-obj-y \
|
|
|
|
storage-daemon-obj-m \
|
2015-09-02 12:57:27 +03:00
|
|
|
crypto-obj-y \
|
2015-09-02 13:18:16 +03:00
|
|
|
qom-obj-y \
|
2015-02-27 19:19:33 +03:00
|
|
|
io-obj-y \
|
2014-02-10 10:48:59 +04:00
|
|
|
common-obj-y \
|
2020-08-19 15:44:56 +03:00
|
|
|
common-obj-m)
|
2020-02-04 14:20:10 +03:00
|
|
|
|
2016-06-01 05:23:31 +03:00
|
|
|
include $(SRC_PATH)/tests/Makefile.include
|
2012-12-21 11:34:49 +04:00
|
|
|
|
2019-07-12 21:23:46 +03:00
|
|
|
all: $(DOCS) $(if $(BUILD_DOCS),sphinxdocs) $(TOOLS) $(HELPERS-y) recurse-all modules
|
2006-05-13 20:54:03 +04:00
|
|
|
|
2016-06-01 12:44:21 +03:00
|
|
|
qemu-version.h: FORCE
|
|
|
|
$(call quiet-command, \
|
2019-03-07 17:26:47 +03:00
|
|
|
(printf '#define QEMU_PKGVERSION "$(QEMU_PKGVERSION)"\n'; \
|
|
|
|
printf '#define QEMU_FULL_VERSION "$(FULL_VERSION)"\n'; \
|
2018-02-15 14:06:47 +03:00
|
|
|
) > $@.tmp)
|
2017-02-15 05:40:30 +03:00
|
|
|
$(call quiet-command, if ! cmp -s $@ $@.tmp; then \
|
|
|
|
mv $@.tmp $@; \
|
|
|
|
else \
|
|
|
|
rm $@.tmp; \
|
|
|
|
fi)
|
2016-06-01 12:44:21 +03:00
|
|
|
|
2009-10-07 04:40:58 +04:00
|
|
|
config-host.h: config-host.h-timestamp
|
|
|
|
config-host.h-timestamp: config-host.mak
|
2016-06-07 14:27:04 +03:00
|
|
|
qemu-options.def: $(SRC_PATH)/qemu-options.hx $(SRC_PATH)/scripts/hxtool
|
2016-10-04 19:27:21 +03:00
|
|
|
$(call quiet-command,sh $(SRC_PATH)/scripts/hxtool -h < $< > $@,"GEN","$@")
|
2009-10-07 04:40:58 +04:00
|
|
|
|
2020-02-20 07:11:13 +03:00
|
|
|
TARGET_DIRS_RULES := $(foreach t, all fuzz clean install, $(addsuffix /$(t), $(TARGET_DIRS)))
|
2013-02-21 19:26:47 +04:00
|
|
|
|
2019-05-28 11:23:08 +03:00
|
|
|
SOFTMMU_ALL_RULES=$(filter %-softmmu/all, $(TARGET_DIRS_RULES))
|
|
|
|
$(SOFTMMU_ALL_RULES): $(authz-obj-y)
|
|
|
|
$(SOFTMMU_ALL_RULES): $(block-obj-y)
|
2020-02-24 17:29:54 +03:00
|
|
|
$(SOFTMMU_ALL_RULES): $(storage-daemon-obj-y)
|
2019-05-28 11:23:08 +03:00
|
|
|
$(SOFTMMU_ALL_RULES): $(chardev-obj-y)
|
|
|
|
$(SOFTMMU_ALL_RULES): $(crypto-obj-y)
|
|
|
|
$(SOFTMMU_ALL_RULES): $(io-obj-y)
|
|
|
|
$(SOFTMMU_ALL_RULES): config-all-devices.mak
|
2019-11-08 14:45:30 +03:00
|
|
|
ifdef DECOMPRESS_EDK2_BLOBS
|
2019-05-28 11:23:08 +03:00
|
|
|
$(SOFTMMU_ALL_RULES): $(edk2-decompressed)
|
2019-11-08 14:45:30 +03:00
|
|
|
endif
|
2008-05-28 20:44:57 +04:00
|
|
|
|
2020-02-20 07:11:13 +03: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)
|
|
|
|
|
2019-05-28 11:23:08 +03: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
|
|
|
|
$(TARGET_DIRS_RULES):
|
|
|
|
$(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C $(dir $@) V="$(V)" TARGET_DIR="$(dir $@)" $(notdir $@),)
|
2006-05-13 17:55:08 +04:00
|
|
|
|
2020-06-12 22:02:21 +03: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 17:00:17 +04:00
|
|
|
DTC_CFLAGS=$(CFLAGS) $(QEMU_CFLAGS)
|
2020-06-12 22:02:21 +03:00
|
|
|
DTC_CPPFLAGS=-I$(SRC_PATH)/dtc/libfdt
|
2013-04-18 08:47:31 +04: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 11:23:07 +03:00
|
|
|
.PHONY: dtc/all
|
2020-06-12 22:02:21 +03: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 08:47:31 +04:00
|
|
|
|
2017-10-18 21:40:23 +03:00
|
|
|
dtc/%: .git-submodule-status
|
2018-04-16 02:05:22 +03:00
|
|
|
@mkdir -p $@
|
2013-04-18 08:47:31 +04:00
|
|
|
|
2017-09-28 19:01:23 +03: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 11:23:07 +03:00
|
|
|
.PHONY: capstone/all
|
|
|
|
capstone/all: .git-submodule-status
|
2017-11-08 04:10:46 +03: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 19:01:23 +03: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 11:23:07 +03:00
|
|
|
.PHONY: slirp/all
|
|
|
|
slirp/all: .git-submodule-status
|
2019-09-19 16:07:36 +03: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 17:34:27 +03:00
|
|
|
CFLAGS="$(QEMU_CFLAGS) $(CFLAGS)" LDFLAGS="$(QEMU_LDFLAGS)")
|
2019-02-12 19:25:23 +03:00
|
|
|
|
2019-05-28 11:23:08 +03:00
|
|
|
$(filter %/all, $(TARGET_DIRS_RULES)): libqemuutil.a $(common-obj-y) \
|
2019-07-29 16:55:47 +03:00
|
|
|
$(qom-obj-y)
|
2009-09-27 20:26:02 +04:00
|
|
|
|
2020-02-20 07:11:13 +03: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 11:23:07 +03:00
|
|
|
ROM_DIRS = $(addprefix pc-bios/, $(ROMS))
|
2019-05-28 11:23:08 +03:00
|
|
|
ROM_DIRS_RULES=$(foreach t, all clean, $(addsuffix /$(t), $(ROM_DIRS)))
|
2016-08-05 11:23:46 +03:00
|
|
|
# Only keep -O and -g cflags
|
2019-05-28 11:23:08 +03: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 16:18:32 +04:00
|
|
|
|
2019-07-09 17:38:01 +03:00
|
|
|
.PHONY: recurse-all recurse-clean recurse-install
|
2019-05-28 11:23:08 +03: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 08:59:35 +03:00
|
|
|
$(addsuffix /install, $(TARGET_DIRS)): all
|
2006-08-01 20:21:11 +04:00
|
|
|
|
2016-11-08 10:05:13 +03:00
|
|
|
$(BUILD_DIR)/version.o: $(SRC_PATH)/version.rc config-host.h
|
2016-10-04 19:27:21 +03:00
|
|
|
$(call quiet-command,$(WINDRES) -I$(BUILD_DIR) -o $@ $<,"RC","version.o")
|
2013-02-26 02:31:13 +04:00
|
|
|
|
2016-11-08 10:05:13 +03:00
|
|
|
Makefile: $(version-obj-y)
|
2012-11-16 21:35:27 +04:00
|
|
|
|
2011-05-15 12:51:28 +04:00
|
|
|
######################################################################
|
2007-11-07 22:24:02 +03:00
|
|
|
|
2017-09-19 17:20:31 +03:00
|
|
|
COMMON_LDADDS = libqemuutil.a
|
2017-01-25 19:14:15 +03:00
|
|
|
|
2010-01-20 22:54:18 +03:00
|
|
|
qemu-img.o: qemu-img-cmds.h
|
2009-06-07 03:42:17 +04:00
|
|
|
|
2015-10-21 15:16:21 +03:00
|
|
|
qemu-img$(EXESUF): qemu-img.o $(authz-obj-y) $(block-obj-y) $(crypto-obj-y) $(io-obj-y) $(qom-obj-y) $(COMMON_LDADDS)
|
|
|
|
qemu-nbd$(EXESUF): qemu-nbd.o $(authz-obj-y) $(block-obj-y) $(crypto-obj-y) $(io-obj-y) $(qom-obj-y) $(COMMON_LDADDS)
|
|
|
|
qemu-io$(EXESUF): qemu-io.o $(authz-obj-y) $(block-obj-y) $(crypto-obj-y) $(io-obj-y) $(qom-obj-y) $(COMMON_LDADDS)
|
2020-02-24 17:30:01 +03:00
|
|
|
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)
|
2009-04-05 22:41:23 +04:00
|
|
|
|
2017-01-25 19:14:15 +03:00
|
|
|
qemu-bridge-helper$(EXESUF): qemu-bridge-helper.o $(COMMON_LDADDS)
|
2012-01-26 18:42:24 +04:00
|
|
|
|
2017-10-05 18:33:28 +03:00
|
|
|
qemu-keymap$(EXESUF): qemu-keymap.o ui/input-keymap.o $(COMMON_LDADDS)
|
|
|
|
|
2018-09-25 10:56:42 +03:00
|
|
|
qemu-edid$(EXESUF): qemu-edid.o hw/display/edid-generate.o $(COMMON_LDADDS)
|
|
|
|
|
2017-01-25 19:14:15 +03:00
|
|
|
fsdev/virtfs-proxy-helper$(EXESUF): fsdev/virtfs-proxy-helper.o fsdev/9p-marshal.o fsdev/9p-iov-marshal.o $(COMMON_LDADDS)
|
2011-12-14 12:28:42 +04:00
|
|
|
|
2015-10-21 15:16:21 +03:00
|
|
|
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)
|
2017-08-22 07:50:55 +03:00
|
|
|
ifdef CONFIG_MPATH
|
|
|
|
scsi/qemu-pr-helper$(EXESUF): LIBS += -ludev -lmultipath -lmpathpersist
|
|
|
|
endif
|
2017-08-22 07:50:18 +03:00
|
|
|
|
2016-06-07 14:27:04 +03:00
|
|
|
qemu-img-cmds.h: $(SRC_PATH)/qemu-img-cmds.hx $(SRC_PATH)/scripts/hxtool
|
2016-10-04 19:27:21 +03:00
|
|
|
$(call quiet-command,sh $(SRC_PATH)/scripts/hxtool -h < $< > $@,"GEN","$@")
|
2009-06-07 03:42:17 +04:00
|
|
|
|
2017-10-05 18:33:28 +03:00
|
|
|
qemu-keymap$(EXESUF): LIBS += $(XKBCOMMON_LIBS)
|
|
|
|
qemu-keymap$(EXESUF): QEMU_CFLAGS += $(XKBCOMMON_CFLAGS)
|
|
|
|
|
2015-05-06 14:57:40 +03:00
|
|
|
ifdef QEMU_GA_MSI_ENABLED
|
|
|
|
QEMU_GA_MSI=qemu-ga-$(ARCH).msi
|
|
|
|
|
2015-07-29 20:10:51 +03:00
|
|
|
msi: $(QEMU_GA_MSI)
|
2015-05-06 14:57:40 +03:00
|
|
|
|
2019-07-18 14:19:02 +03:00
|
|
|
$(QEMU_GA_MSI): qga/qemu-ga.exe $(QGA_VSS_PROVIDER)
|
2015-05-06 14:57:40 +03:00
|
|
|
|
|
|
|
$(QEMU_GA_MSI): config-host.mak
|
|
|
|
|
2015-08-26 15:07:16 +03:00
|
|
|
$(QEMU_GA_MSI): $(SRC_PATH)/qga/installer/qemu-ga.wxs
|
|
|
|
$(call quiet-command,QEMU_GA_VERSION="$(QEMU_GA_VERSION)" QEMU_GA_MANUFACTURER="$(QEMU_GA_MANUFACTURER)" QEMU_GA_DISTRO="$(QEMU_GA_DISTRO)" BUILD_DIR="$(BUILD_DIR)" \
|
2016-10-04 19:27:21 +03:00
|
|
|
wixl -o $@ $(QEMU_GA_MSI_ARCH) $(QEMU_GA_MSI_WITH_VSS) $(QEMU_GA_MSI_MINGW_DLL_PATH) $<,"WIXL","$@")
|
2015-05-06 14:57:40 +03:00
|
|
|
else
|
|
|
|
msi:
|
2015-08-27 01:05:01 +03:00
|
|
|
@echo "MSI build not configured or dependency resolution failed (reconfigure with --enable-guest-agent-msi option)"
|
2015-05-06 14:57:40 +03:00
|
|
|
endif
|
|
|
|
|
build: qemu-ga: add 'qemu-ga' build target for w32
Currently POSIX builds rely on 'qemu-ga' target to do qga-only
distributable build. On w32, as with most standalone binary targets,
we rely on 'qemu-ga.exe' target.
Unlike with POSIX, qemu-ga for w32 has a number of related targets
such as VSS DLL and MSI package. We can do the full distributable
qga-only build on w32 with:
make qemu-ga.exe
or:
make msi
To make that work, we tie VSS dependencies onto qemu-ga.exe.
However, in reality the DLL isn't part of the binary, so we use a
filter to pull them out of the LINK recipe, which attempts to link
against prereqs for binary targets. Additionally, it could be argued
that VSS is a separate distributable, and shouldn't be implied by
qemu-ga.exe binary target.
To avoid this, we can tie the VSS dependencies only to the 'msi'
target, but that would make it impossible to do a qga-only build of
the w32 distributable without building the 'msi' package, which was
supported in the past.
An alternative approach is to add a new target to build the whole
distributable. w32 allows us to use the same build target we use
on POSIX, 'qemu-ga', since the current binary-only target on w32
is 'qemu-ga.exe'.
To further simplify the build, we also make 'qemu-ga' build the MSI
package if the appropriate ./configure options are set, making the
full qga-only build the same on both POSIX and w32: `make qemu-ga`
Cc: Paolo Bonzini <pbonzini@redhat.com>
Cc: Marc-André Lureau <marcandre.lureau@redhat.com>
Signed-off-by: Michael Roth <mdroth@linux.vnet.ibm.com>
2015-09-08 02:47:05 +03:00
|
|
|
ifneq ($(EXESUF),)
|
2019-07-18 14:19:02 +03:00
|
|
|
.PHONY: qga/qemu-ga
|
|
|
|
qga/qemu-ga: qga/qemu-ga$(EXESUF) $(QGA_VSS_PROVIDER) $(QEMU_GA_MSI)
|
build: qemu-ga: add 'qemu-ga' build target for w32
Currently POSIX builds rely on 'qemu-ga' target to do qga-only
distributable build. On w32, as with most standalone binary targets,
we rely on 'qemu-ga.exe' target.
Unlike with POSIX, qemu-ga for w32 has a number of related targets
such as VSS DLL and MSI package. We can do the full distributable
qga-only build on w32 with:
make qemu-ga.exe
or:
make msi
To make that work, we tie VSS dependencies onto qemu-ga.exe.
However, in reality the DLL isn't part of the binary, so we use a
filter to pull them out of the LINK recipe, which attempts to link
against prereqs for binary targets. Additionally, it could be argued
that VSS is a separate distributable, and shouldn't be implied by
qemu-ga.exe binary target.
To avoid this, we can tie the VSS dependencies only to the 'msi'
target, but that would make it impossible to do a qga-only build of
the w32 distributable without building the 'msi' package, which was
supported in the past.
An alternative approach is to add a new target to build the whole
distributable. w32 allows us to use the same build target we use
on POSIX, 'qemu-ga', since the current binary-only target on w32
is 'qemu-ga.exe'.
To further simplify the build, we also make 'qemu-ga' build the MSI
package if the appropriate ./configure options are set, making the
full qga-only build the same on both POSIX and w32: `make qemu-ga`
Cc: Paolo Bonzini <pbonzini@redhat.com>
Cc: Marc-André Lureau <marcandre.lureau@redhat.com>
Signed-off-by: Michael Roth <mdroth@linux.vnet.ibm.com>
2015-09-08 02:47:05 +03:00
|
|
|
endif
|
|
|
|
|
2016-08-12 16:27:02 +03:00
|
|
|
module_block.h: $(SRC_PATH)/scripts/modules/module_block.py config-host.mak
|
|
|
|
$(call quiet-command,$(PYTHON) $< $@ \
|
|
|
|
$(addprefix $(SRC_PATH)/,$(patsubst %.mo,%.c,$(block-obj-m))), \
|
2016-10-04 19:27:21 +03:00
|
|
|
"GEN","$@")
|
2016-08-12 16:27:02 +03:00
|
|
|
|
2019-06-10 13:05:14 +03:00
|
|
|
clean: recurse-clean ninja-clean clean-ctlist
|
|
|
|
-test -f ninjatool && ./ninjatool $(if $(V),-v,) -t clean
|
2003-08-12 03:01:33 +04:00
|
|
|
# avoid old build problems by removing potentially incorrect old files
|
2009-10-07 04:41:00 +04: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
|
2010-10-26 19:53:41 +04:00
|
|
|
rm -f qemu-options.def
|
2015-05-06 14:57:40 +03:00
|
|
|
rm -f *.msi
|
2019-02-04 19:03:21 +03: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-03-08 03:19:35 +03:00
|
|
|
rm -f $(edk2-decompressed)
|
2019-07-18 13:22:01 +03:00
|
|
|
rm -f $(filter-out %.tlb,$(TOOLS)) $(HELPERS-y) TAGS cscope.* *.pod *~ */*~
|
2017-08-22 07:50:18 +03:00
|
|
|
rm -f fsdev/*.pod scsi/*.pod
|
2009-06-09 22:45:16 +04:00
|
|
|
rm -f qemu-img-cmds.h
|
2015-01-16 15:59:17 +03:00
|
|
|
rm -f ui/shader/*-vert.h ui/shader/*-frag.h
|
2019-04-01 17:12:19 +03:00
|
|
|
rm -f $(foreach f,$(generated-files-y),$(f) $(f)-timestamp)
|
2018-07-16 11:41:30 +03:00
|
|
|
rm -f config-all-devices.mak
|
2020-07-17 18:25:08 +03:00
|
|
|
rm -f $(SUBDIR_DEVICES_MAK)
|
2003-02-19 01:55:36 +03:00
|
|
|
|
2012-07-17 22:33:32 +04: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 17:26:46 +03:00
|
|
|
define clean-manual =
|
2019-03-08 16:57:42 +03: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 17:26:46 +03:00
|
|
|
endef
|
|
|
|
|
2019-06-10 13:05:14 +03:00
|
|
|
distclean: clean ninja-distclean
|
|
|
|
-test -f ninjatool && ./ninjatool $(if $(V),-v,) -t clean -g
|
2019-12-18 02:25:09 +03:00
|
|
|
rm -f config-host.mak config-host.h* $(DOCS)
|
2019-08-07 17:35:23 +03:00
|
|
|
rm -f tests/tcg/config-*.mak
|
2014-12-15 13:19:46 +03:00
|
|
|
rm -f config-all-devices.mak config-all-disas.mak config.status
|
2018-07-16 11:41:30 +03:00
|
|
|
rm -f $(SUBDIR_DEVICES_MAK)
|
2014-12-15 13:19:46 +03:00
|
|
|
rm -f po/*.mo tests/qemu-iotests/common.env
|
2009-11-13 12:51:05 +03:00
|
|
|
rm -f roms/seabios/config.mak roms/vgabios/config.mak
|
2018-10-21 20:56:29 +03:00
|
|
|
rm -f qemu-plugins-ld.symbols qemu-plugins-ld64.symbols
|
2019-06-10 13:05:14 +03:00
|
|
|
rm -rf meson-private meson-logs meson-info compile_commands.json
|
2020-01-28 16:48:54 +03:00
|
|
|
rm -f Makefile.ninja ninjatool ninjatool.stamp Makefile.mtest
|
2011-07-26 07:56:02 +04:00
|
|
|
rm -f config.log
|
2012-02-01 22:50:42 +04:00
|
|
|
rm -f linux-headers/asm
|
2017-06-06 17:55:19 +03: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 16:57:43 +03:00
|
|
|
rm -rf .doctrees
|
2019-03-07 17:26:46 +03:00
|
|
|
$(call clean-manual,devel)
|
|
|
|
$(call clean-manual,interop)
|
2019-06-17 17:35:31 +03:00
|
|
|
$(call clean-manual,specs)
|
2020-01-23 18:22:40 +03:00
|
|
|
$(call clean-manual,system)
|
2020-02-25 13:45:13 +03:00
|
|
|
$(call clean-manual,tools)
|
2020-02-28 18:35:47 +03:00
|
|
|
$(call clean-manual,user)
|
2018-07-04 09:30:11 +03:00
|
|
|
for d in $(TARGET_DIRS); do \
|
2003-10-28 03:12:52 +03:00
|
|
|
rm -rf $$d || exit 1 ; \
|
2003-08-11 03:41:46 +04:00
|
|
|
done
|
2013-08-07 19:40:03 +04:00
|
|
|
rm -Rf .sdk
|
2003-03-07 02:23:54 +03:00
|
|
|
|
2018-11-16 13:43:16 +03:00
|
|
|
KEYMAPS=da en-gb et fr fr-ch is lt no pt-br sv \
|
2004-12-13 01:18:34 +03:00
|
|
|
ar de en-us fi fr-be hr it lv nl pl ru th \
|
2018-11-16 13:43:18 +03:00
|
|
|
de-ch es fo fr-ca hu ja mk pt sl tr \
|
2013-10-16 16:40:04 +04:00
|
|
|
bepo cz
|
2004-12-13 01:18:34 +03:00
|
|
|
|
2008-11-27 18:45:16 +03:00
|
|
|
ifdef INSTALL_BLOBS
|
2019-11-02 14:43:46 +03:00
|
|
|
BLOBS=bios.bin bios-256k.bin bios-microvm.bin sgabios.bin vgabios.bin vgabios-cirrus.bin \
|
2014-09-10 15:04:17 +04:00
|
|
|
vgabios-stdvga.bin vgabios-vmware.bin vgabios-qxl.bin vgabios-virtio.bin \
|
2019-07-03 07:52:12 +03:00
|
|
|
vgabios-ramfb.bin vgabios-bochs-display.bin vgabios-ati.bin \
|
2020-01-14 14:46:17 +03:00
|
|
|
openbios-sparc32 openbios-sparc64 openbios-ppc QEMU,tcx.bin QEMU,cgthree.bin \
|
2011-04-18 21:46:01 +04:00
|
|
|
pxe-e1000.rom pxe-eepro100.rom pxe-ne2k_pci.rom \
|
|
|
|
pxe-pcnet.rom pxe-rtl8139.rom pxe-virtio.rom \
|
2013-04-09 01:08:13 +04:00
|
|
|
efi-e1000.rom efi-eepro100.rom efi-ne2k_pci.rom \
|
|
|
|
efi-pcnet.rom efi-rtl8139.rom efi-virtio.rom \
|
2016-07-01 14:26:57 +03:00
|
|
|
efi-e1000e.rom efi-vmxnet3.rom \
|
2019-07-15 20:48:14 +03:00
|
|
|
qemu-nsis.bmp \
|
2018-02-19 13:34:25 +03:00
|
|
|
bamboo.dtb canyonlands.dtb petalogix-s3adsp1800.dtb petalogix-ml605.dtb \
|
2019-01-18 15:01:41 +03:00
|
|
|
multiboot.bin linuxboot.bin linuxboot_dma.bin kvmvapic.bin pvh.bin \
|
2017-07-12 17:00:41 +03:00
|
|
|
s390-ccw.img s390-netboot.img \
|
2019-07-16 08:27:43 +03:00
|
|
|
slof.bin skiboot.lid \
|
2014-07-04 23:43:18 +04:00
|
|
|
palcode-clipper \
|
2018-03-02 14:50:14 +03:00
|
|
|
u-boot.e500 u-boot-sam460-20100605.bin \
|
2018-01-22 00:04:45 +03:00
|
|
|
qemu_vga.ndrv \
|
2019-03-08 03:19:35 +03:00
|
|
|
edk2-licenses.txt \
|
2019-07-16 21:47:22 +03:00
|
|
|
hppa-firmware.img \
|
2020-02-24 16:39:42 +03:00
|
|
|
opensbi-riscv32-sifive_u-fw_jump.bin opensbi-riscv32-virt-fw_jump.bin \
|
2019-07-16 21:47:22 +03:00
|
|
|
opensbi-riscv64-sifive_u-fw_jump.bin opensbi-riscv64-virt-fw_jump.bin
|
|
|
|
|
2019-03-08 03:19:35 +03:00
|
|
|
|
|
|
|
DESCS=50-edk2-i386-secure.json 50-edk2-x86_64-secure.json \
|
|
|
|
60-edk2-aarch64.json 60-edk2-arm.json 60-edk2-i386.json 60-edk2-x86_64.json
|
2008-11-27 18:45:16 +03:00
|
|
|
else
|
|
|
|
BLOBS=
|
2019-03-08 03:19:35 +03:00
|
|
|
DESCS=
|
2008-11-27 18:45:16 +03:00
|
|
|
endif
|
|
|
|
|
2019-03-08 16:57:44 +03:00
|
|
|
# Note that we manually filter-out the non-Sphinx documentation which
|
2019-09-05 16:10:40 +03:00
|
|
|
# is currently built into the docs/interop directory in the build tree,
|
|
|
|
# and also any sphinx-built manpages.
|
2019-03-07 17:26:46 +03:00
|
|
|
define install-manual =
|
2019-03-08 16:57:42 +03:00
|
|
|
for d in $$(cd $(MANUAL_BUILDDIR) && find $1 -type d); do $(INSTALL_DIR) "$(DESTDIR)$(qemu_docdir)/$$d"; done
|
2019-09-05 16:10:40 +03: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 17:26:46 +03: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 17:35:31 +03:00
|
|
|
$(call install-manual,specs)
|
2020-01-23 18:22:40 +03:00
|
|
|
$(call install-manual,system)
|
2020-02-25 13:45:13 +03:00
|
|
|
$(call install-manual,tools)
|
2020-02-28 18:35:47 +03:00
|
|
|
$(call install-manual,user)
|
2019-03-07 17:26:46 +03:00
|
|
|
|
|
|
|
install-doc: $(DOCS) install-sphinxdocs
|
2012-04-18 23:55:44 +04:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_docdir)"
|
2019-12-19 16:56:20 +03:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/index.html "$(DESTDIR)$(qemu_docdir)"
|
2020-06-09 03:47:50 +03: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 16:47:00 +04:00
|
|
|
ifdef CONFIG_POSIX
|
2009-04-18 19:36:02 +04:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1"
|
2020-02-28 18:36:15 +03:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/system/qemu.1 "$(DESTDIR)$(mandir)/man1"
|
2017-01-13 17:41:35 +03:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(mandir)/man7"
|
2017-06-06 17:55:19 +03: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 18:22:40 +03: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 18:36:01 +03:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/system/qemu-cpu-models.7 "$(DESTDIR)$(mandir)/man7"
|
2019-07-18 13:24:29 +03:00
|
|
|
ifeq ($(CONFIG_TOOLS),y)
|
2020-02-25 13:45:14 +03:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/qemu-img.1 "$(DESTDIR)$(mandir)/man1"
|
2009-04-18 19:36:02 +04:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(mandir)/man8"
|
2020-02-25 13:45:14 +03:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/qemu-nbd.8 "$(DESTDIR)$(mandir)/man8"
|
2006-05-01 03:54:18 +04:00
|
|
|
endif
|
2019-01-23 15:00:16 +03:00
|
|
|
ifdef CONFIG_TRACE_SYSTEMTAP
|
2020-02-25 13:45:14 +03:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/qemu-trace-stap.1 "$(DESTDIR)$(mandir)/man1"
|
2019-01-23 15:00:16 +03:00
|
|
|
endif
|
2019-07-18 14:19:02 +03:00
|
|
|
ifeq ($(CONFIG_GUEST_AGENT),y)
|
2019-09-19 18:59:57 +03:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/interop/qemu-ga.8 "$(DESTDIR)$(mandir)/man8"
|
2020-06-09 03:47:50 +03: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 17:55:19 +03:00
|
|
|
$(INSTALL_DATA) docs/interop/qemu-ga-ref.7 "$(DESTDIR)$(mandir)/man7"
|
2015-08-27 02:34:59 +03:00
|
|
|
endif
|
2013-06-11 15:13:58 +04:00
|
|
|
endif
|
2011-12-14 12:28:47 +04:00
|
|
|
ifdef CONFIG_VIRTFS
|
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1"
|
2020-02-25 13:45:14 +03:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/virtfs-proxy-helper.1 "$(DESTDIR)$(mandir)/man1"
|
2011-12-14 12:28:47 +04:00
|
|
|
endif
|
2020-02-07 19:29:51 +03:00
|
|
|
ifeq ($(CONFIG_LINUX)$(CONFIG_SECCOMP)$(CONFIG_LIBCAP_NG),yyy)
|
2020-02-25 13:45:14 +03:00
|
|
|
$(INSTALL_DATA) $(MANUAL_BUILDDIR)/tools/virtiofsd.1 "$(DESTDIR)$(mandir)/man1"
|
2020-02-07 19:29:51 +03:00
|
|
|
endif
|
2012-05-02 20:07:30 +04:00
|
|
|
|
|
|
|
install-datadir:
|
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_datadir)"
|
|
|
|
|
2013-05-18 09:13:14 +04:00
|
|
|
install-localstatedir:
|
|
|
|
ifdef CONFIG_POSIX
|
2019-07-18 14:19:02 +03:00
|
|
|
ifeq ($(CONFIG_GUEST_AGENT),y)
|
2013-05-18 09:13:14 +04:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_localstatedir)"/run
|
|
|
|
endif
|
|
|
|
endif
|
|
|
|
|
2019-01-10 15:00:45 +03:00
|
|
|
ICON_SIZES=16x16 24x24 32x32 48x48 64x64 128x128 256x256 512x512
|
2012-05-02 20:07:30 +04:00
|
|
|
|
2017-08-31 01:39:53 +03:00
|
|
|
install-includedir:
|
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(includedir)"
|
|
|
|
|
2019-06-10 13:05:14 +03:00
|
|
|
# Needed by "meson install"
|
|
|
|
export DESTDIR
|
2017-08-31 01:39:53 +03:00
|
|
|
install: all $(if $(BUILD_DOCS),install-doc) \
|
|
|
|
install-datadir install-localstatedir install-includedir \
|
2019-05-28 11:23:08 +03:00
|
|
|
$(if $(INSTALL_BLOBS),$(edk2-decompressed)) \
|
|
|
|
recurse-install
|
2007-10-20 22:29:34 +04:00
|
|
|
ifneq ($(TOOLS),)
|
2019-07-18 13:22:01 +03:00
|
|
|
$(call install-prog,$(TOOLS),$(DESTDIR)$(bindir))
|
2007-10-20 22:29:34 +04:00
|
|
|
endif
|
2014-02-10 10:48:58 +04:00
|
|
|
ifneq ($(CONFIG_MODULES),)
|
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_moddir)"
|
2014-05-08 14:56:58 +04:00
|
|
|
for s in $(modules-m:.mo=$(DSOSUF)); do \
|
|
|
|
t="$(DESTDIR)$(qemu_moddir)/$$(echo $$s | tr / -)"; \
|
2014-05-08 15:06:03 +04:00
|
|
|
$(INSTALL_LIB) $$s "$$t"; \
|
2014-05-08 14:56:58 +04:00
|
|
|
test -z "$(STRIP)" || $(STRIP) "$$t"; \
|
2014-02-10 10:48:58 +04:00
|
|
|
done
|
|
|
|
endif
|
2012-01-26 18:42:24 +04:00
|
|
|
ifneq ($(HELPERS-y),)
|
2014-06-22 10:55:23 +04:00
|
|
|
$(call install-prog,$(HELPERS-y),$(DESTDIR)$(libexecdir))
|
2012-01-26 18:42:24 +04:00
|
|
|
endif
|
2019-01-23 15:00:16 +03:00
|
|
|
ifdef CONFIG_TRACE_SYSTEMTAP
|
|
|
|
$(INSTALL_PROG) "scripts/qemu-trace-stap" $(DESTDIR)$(bindir)
|
|
|
|
endif
|
2008-11-27 18:45:16 +03:00
|
|
|
ifneq ($(BLOBS),)
|
|
|
|
set -e; for x in $(BLOBS); do \
|
2012-04-18 23:55:41 +04:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/pc-bios/$$x "$(DESTDIR)$(qemu_datadir)"; \
|
2006-04-16 16:41:07 +04:00
|
|
|
done
|
2019-03-08 03:19:35 +03:00
|
|
|
endif
|
|
|
|
ifdef INSTALL_BLOBS
|
|
|
|
set -e; for x in $(edk2-decompressed); do \
|
|
|
|
$(INSTALL_DATA) $$x "$(DESTDIR)$(qemu_datadir)"; \
|
|
|
|
done
|
|
|
|
endif
|
|
|
|
ifneq ($(DESCS),)
|
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_datadir)/firmware"
|
|
|
|
set -e; tmpf=$$(mktemp); trap 'rm -f -- "$$tmpf"' EXIT; \
|
|
|
|
for x in $(DESCS); do \
|
2019-05-30 22:28:11 +03:00
|
|
|
sed -e 's,@DATADIR@,$(qemu_datadir),' \
|
2019-03-08 03:19:35 +03:00
|
|
|
"$(SRC_PATH)/pc-bios/descriptors/$$x" > "$$tmpf"; \
|
|
|
|
$(INSTALL_DATA) "$$tmpf" \
|
|
|
|
"$(DESTDIR)$(qemu_datadir)/firmware/$$x"; \
|
|
|
|
done
|
2013-02-20 17:43:24 +04:00
|
|
|
endif
|
2019-01-10 15:00:45 +03:00
|
|
|
for s in $(ICON_SIZES); do \
|
2019-05-21 17:53:18 +03:00
|
|
|
mkdir -p "$(DESTDIR)$(qemu_icondir)/hicolor/$${s}/apps"; \
|
2019-01-10 15:00:45 +03:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/ui/icons/qemu_$${s}.png \
|
2019-05-21 17:53:18 +03:00
|
|
|
"$(DESTDIR)$(qemu_icondir)/hicolor/$${s}/apps/qemu.png"; \
|
2019-01-10 15:00:45 +03:00
|
|
|
done; \
|
2019-05-21 17:53:18 +03:00
|
|
|
mkdir -p "$(DESTDIR)$(qemu_icondir)/hicolor/32x32/apps"; \
|
2019-01-10 15:00:45 +03:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/ui/icons/qemu_32x32.bmp \
|
2019-05-21 17:53:18 +03:00
|
|
|
"$(DESTDIR)$(qemu_icondir)/hicolor/32x32/apps/qemu.bmp"; \
|
|
|
|
mkdir -p "$(DESTDIR)$(qemu_icondir)/hicolor/scalable/apps"; \
|
2019-01-10 15:00:45 +03:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/ui/icons/qemu.svg \
|
2019-05-21 17:53:18 +03:00
|
|
|
"$(DESTDIR)$(qemu_icondir)/hicolor/scalable/apps/qemu.svg"
|
|
|
|
mkdir -p "$(DESTDIR)$(qemu_desktopdir)"
|
2019-01-10 15:00:46 +03:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/ui/qemu.desktop \
|
2019-05-21 17:53:18 +03:00
|
|
|
"$(DESTDIR)$(qemu_desktopdir)/qemu.desktop"
|
2018-04-16 12:37:19 +03:00
|
|
|
ifdef CONFIG_GTK
|
2013-02-20 17:43:24 +04:00
|
|
|
$(MAKE) -C po $@
|
2017-08-31 01:39:53 +03:00
|
|
|
endif
|
|
|
|
ifeq ($(CONFIG_PLUGIN),y)
|
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/include/qemu/qemu-plugin.h "$(DESTDIR)$(includedir)/qemu-plugin.h"
|
2008-11-27 18:45:16 +03:00
|
|
|
endif
|
2012-04-18 23:55:41 +04:00
|
|
|
$(INSTALL_DIR) "$(DESTDIR)$(qemu_datadir)/keymaps"
|
2008-03-05 21:16:09 +03:00
|
|
|
set -e; for x in $(KEYMAPS); do \
|
2012-04-18 23:55:41 +04:00
|
|
|
$(INSTALL_DATA) $(SRC_PATH)/pc-bios/keymaps/$$x "$(DESTDIR)$(qemu_datadir)/keymaps"; \
|
2006-04-16 16:41:07 +04:00
|
|
|
done
|
2020-08-19 15:44:56 +03:00
|
|
|
for d in $(TARGET_DIRS); do \
|
|
|
|
$(MAKE) $(SUBDIR_MAKEFLAGS) TARGET_DIR=$$d/ -C $$d $@ || exit 1 ; \
|
|
|
|
done
|
2003-03-22 20:31:19 +03:00
|
|
|
|
2015-01-16 15:59:17 +03:00
|
|
|
# opengl shader programs
|
|
|
|
ui/shader/%-vert.h: $(SRC_PATH)/ui/shader/%.vert $(SRC_PATH)/scripts/shaderinclude.pl
|
|
|
|
@mkdir -p $(dir $@)
|
|
|
|
$(call quiet-command,\
|
|
|
|
perl $(SRC_PATH)/scripts/shaderinclude.pl $< > $@,\
|
2016-10-04 19:27:21 +03:00
|
|
|
"VERT","$@")
|
2015-01-16 15:59:17 +03:00
|
|
|
|
|
|
|
ui/shader/%-frag.h: $(SRC_PATH)/ui/shader/%.frag $(SRC_PATH)/scripts/shaderinclude.pl
|
|
|
|
@mkdir -p $(dir $@)
|
|
|
|
$(call quiet-command,\
|
|
|
|
perl $(SRC_PATH)/scripts/shaderinclude.pl $< > $@,\
|
2016-10-04 19:27:21 +03:00
|
|
|
"FRAG","$@")
|
2015-01-16 15:59:17 +03:00
|
|
|
|
2017-10-10 16:54:49 +03:00
|
|
|
ui/shader.o: $(SRC_PATH)/ui/shader.c \
|
2017-10-10 16:54:50 +03:00
|
|
|
ui/shader/texture-blit-vert.h \
|
|
|
|
ui/shader/texture-blit-flip-vert.h \
|
|
|
|
ui/shader/texture-blit-frag.h
|
2015-01-09 13:40:23 +03:00
|
|
|
|
2003-03-23 23:17:16 +03:00
|
|
|
# documentation
|
2017-01-19 12:06:44 +03:00
|
|
|
MAKEINFO=makeinfo
|
2017-06-06 17:55:19 +03:00
|
|
|
MAKEINFOINCLUDES= -I docs -I $(<D) -I $(@D)
|
|
|
|
MAKEINFOFLAGS=--no-split --number-sections $(MAKEINFOINCLUDES)
|
2018-11-26 13:51:25 +03:00
|
|
|
TEXI2PODFLAGS=$(MAKEINFOINCLUDES) -DVERSION="$(VERSION)" -DCONFDIR="$(qemu_confdir)"
|
2017-06-06 17:55:19 +03:00
|
|
|
TEXI2PDFFLAGS=$(if $(V),,--quiet) -I $(SRC_PATH) $(MAKEINFOINCLUDES)
|
2017-01-13 17:41:35 +03:00
|
|
|
|
2018-11-26 13:51:25 +03: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 21:59:28 +03:00
|
|
|
|
2017-06-06 17:59:37 +03:00
|
|
|
%.html: %.texi docs/version.texi
|
2017-01-13 17:41:31 +03:00
|
|
|
$(call quiet-command,LC_ALL=C $(MAKEINFO) $(MAKEINFOFLAGS) --no-headers \
|
|
|
|
--html $< -o $@,"GEN","$@")
|
2003-03-23 23:17:16 +03:00
|
|
|
|
2017-06-06 17:59:37 +03:00
|
|
|
%.info: %.texi docs/version.texi
|
2017-01-13 17:41:31 +03:00
|
|
|
$(call quiet-command,$(MAKEINFO) $(MAKEINFOFLAGS) $< -o $@,"GEN","$@")
|
2006-05-01 02:51:54 +04:00
|
|
|
|
2017-06-06 17:59:37 +03:00
|
|
|
%.txt: %.texi docs/version.texi
|
2017-01-13 17:41:34 +03:00
|
|
|
$(call quiet-command,LC_ALL=C $(MAKEINFO) $(MAKEINFOFLAGS) --no-headers \
|
|
|
|
--plaintext $< -o $@,"GEN","$@")
|
|
|
|
|
2017-06-06 17:59:37 +03:00
|
|
|
%.pdf: %.texi docs/version.texi
|
2017-06-06 17:55:19 +03:00
|
|
|
$(call quiet-command,texi2pdf $(TEXI2PDFFLAGS) $< -o $@,"GEN","$@")
|
2017-03-15 15:56:56 +03:00
|
|
|
|
2019-03-07 17:26:46 +03: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 18:22:40 +03:00
|
|
|
sphinxdocs: $(MANUAL_BUILDDIR)/devel/index.html \
|
|
|
|
$(MANUAL_BUILDDIR)/interop/index.html \
|
|
|
|
$(MANUAL_BUILDDIR)/specs/index.html \
|
2020-02-25 13:45:13 +03:00
|
|
|
$(MANUAL_BUILDDIR)/system/index.html \
|
2020-02-28 18:35:47 +03:00
|
|
|
$(MANUAL_BUILDDIR)/tools/index.html \
|
|
|
|
$(MANUAL_BUILDDIR)/user/index.html
|
2019-03-07 17:26:46 +03:00
|
|
|
|
|
|
|
# Canned command to build a single manual
|
2019-09-05 16:10:40 +03:00
|
|
|
# Arguments: $1 = manual name, $2 = Sphinx builder ('html' or 'man')
|
2019-10-14 18:01:33 +03: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 21:29:32 +03: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 17:26:46 +03:00
|
|
|
# We assume all RST files in the manual's directory are used in it
|
2020-03-10 00:58:14 +03:00
|
|
|
manual-deps = $(wildcard $(SRC_PATH)/docs/$1/*.rst $(SRC_PATH)/docs/$1/*/*.rst) \
|
2020-02-28 18:36:00 +03:00
|
|
|
$(SRC_PATH)/docs/defs.rst.inc \
|
2020-03-06 20:17:47 +03:00
|
|
|
$(SRC_PATH)/docs/$1/conf.py $(SRC_PATH)/docs/conf.py \
|
|
|
|
$(SRC_PATH)/docs/sphinx/*.py
|
2020-01-24 19:25:59 +03: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 17:26:46 +03:00
|
|
|
|
2019-03-08 16:57:42 +03:00
|
|
|
$(MANUAL_BUILDDIR)/devel/index.html: $(call manual-deps,devel)
|
2019-09-05 16:10:40 +03:00
|
|
|
$(call build-manual,devel,html)
|
2019-03-07 17:26:46 +03:00
|
|
|
|
2020-02-25 13:45:14 +03:00
|
|
|
$(MANUAL_BUILDDIR)/interop/index.html: $(call manual-deps,interop)
|
2019-09-05 16:10:40 +03:00
|
|
|
$(call build-manual,interop,html)
|
2019-03-07 17:26:46 +03:00
|
|
|
|
2019-06-17 17:35:31 +03:00
|
|
|
$(MANUAL_BUILDDIR)/specs/index.html: $(call manual-deps,specs)
|
2019-09-05 16:10:40 +03:00
|
|
|
$(call build-manual,specs,html)
|
|
|
|
|
2020-02-28 18:36:13 +03: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 18:22:40 +03:00
|
|
|
$(call build-manual,system,html)
|
|
|
|
|
2020-02-25 13:45:14 +03: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 13:45:13 +03:00
|
|
|
$(call build-manual,tools,html)
|
|
|
|
|
2020-02-28 18:35:47 +03:00
|
|
|
$(MANUAL_BUILDDIR)/user/index.html: $(call manual-deps,user)
|
|
|
|
$(call build-manual,user,html)
|
|
|
|
|
2020-02-25 13:45:14 +03:00
|
|
|
$(call define-manpage-rule,interop,qemu-ga.8)
|
2020-01-23 18:22:39 +03:00
|
|
|
|
2020-02-28 18:36:15 +03: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 18:22:40 +03:00
|
|
|
|
2020-02-25 13:45:14 +03: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 16:56:20 +03:00
|
|
|
$(MANUAL_BUILDDIR)/index.html: $(SRC_PATH)/docs/index.html.in qemu-version.h
|
2020-01-20 19:34:00 +03:00
|
|
|
@mkdir -p "$(MANUAL_BUILDDIR)"
|
2019-12-19 16:56:20 +03:00
|
|
|
$(call quiet-command, sed "s|@@VERSION@@|${VERSION}|g" $< >$@, \
|
|
|
|
"GEN","$@")
|
|
|
|
|
2018-02-11 12:36:05 +03:00
|
|
|
docs/interop/qemu-qmp-qapi.texi: qapi/qapi-doc.texi
|
2018-02-26 22:48:58 +03:00
|
|
|
@cp -p $< $@
|
2017-03-20 16:11:50 +03:00
|
|
|
|
2019-07-18 14:19:02 +03:00
|
|
|
docs/interop/qemu-ga-qapi.texi: qga/qga-qapi-doc.texi
|
2018-02-26 22:48:58 +03:00
|
|
|
@cp -p $< $@
|
2017-01-13 17:41:35 +03:00
|
|
|
|
2020-02-28 18:36:17 +03: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 05:13:40 +04:00
|
|
|
|
2017-06-06 17:55:19 +03: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 17:41:35 +03:00
|
|
|
|
2017-06-06 17:55:19 +03: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 17:41:35 +03:00
|
|
|
|
2019-01-17 22:36:39 +03:00
|
|
|
$(filter %.1 %.7 %.8,$(DOCS)): scripts/texi2pod.pl
|
|
|
|
|
2018-06-20 16:04:24 +03:00
|
|
|
# Reports/Analysis
|
|
|
|
|
|
|
|
%/coverage-report.html:
|
|
|
|
@mkdir -p $*
|
|
|
|
$(call quiet-command,\
|
2019-04-30 18:59:48 +03:00
|
|
|
gcovr -r $(SRC_PATH) \
|
|
|
|
$(foreach t, $(TARGET_DIRS), --object-directory $(BUILD_DIR)/$(t)) \
|
|
|
|
--object-directory $(BUILD_DIR) \
|
2019-03-12 12:18:31 +03:00
|
|
|
-p --html --html-details -o $@, \
|
2018-06-20 16:04:24 +03:00
|
|
|
"GEN", "coverage-report.html")
|
|
|
|
|
|
|
|
.PHONY: coverage-report
|
|
|
|
coverage-report: $(CURDIR)/reports/coverage/coverage-report.html
|
2017-01-13 17:41:35 +03:00
|
|
|
|
2013-07-16 01:49:57 +04: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 16:23:28 +03:00
|
|
|
$(INSTALLER): $(SRC_PATH)/qemu.nsi
|
|
|
|
$(MAKE) install DESTDIR=${INSTDIR}
|
2013-07-16 01:49:57 +04:00
|
|
|
ifdef SIGNCODE
|
2020-08-10 16:23:28 +03:00
|
|
|
(cd ${INSTDIR}/${bindir}; \
|
2013-07-16 01:49:57 +04:00
|
|
|
for i in *.exe; do \
|
|
|
|
$(SIGNCODE) $${i}; \
|
|
|
|
done \
|
|
|
|
)
|
|
|
|
endif # SIGNCODE
|
2020-08-10 16:23:28 +03:00
|
|
|
(cd ${INSTDIR}/${bindir}; \
|
2013-07-16 01:49:57 +04: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 16:23:28 +03:00
|
|
|
) >${INSTDIR}/${bindir}/system-emulations.nsh
|
2013-07-16 01:49:57 +04:00
|
|
|
makensis $(nsisflags) \
|
|
|
|
$(if $(BUILD_DOCS),-DCONFIG_DOCUMENTATION="y") \
|
|
|
|
$(if $(CONFIG_GTK),-DCONFIG_GTK="y") \
|
2020-08-10 16:23:28 +03:00
|
|
|
-DBINDIR="${INSTDIR}/${bindir}" \
|
2013-07-16 01:49:57 +04:00
|
|
|
$(if $(DLL_PATH),-DDLLDIR="$(DLL_PATH)") \
|
|
|
|
-DSRCDIR="$(SRC_PATH)" \
|
|
|
|
-DOUTFILE="$(INSTALLER)" \
|
2015-05-03 20:57:09 +03:00
|
|
|
-DDISPLAYVERSION="$(VERSION)" \
|
2013-07-16 01:49:57 +04:00
|
|
|
$(SRC_PATH)/qemu.nsi
|
|
|
|
rm -r ${INSTDIR}
|
|
|
|
ifdef SIGNCODE
|
|
|
|
$(SIGNCODE) $(INSTALLER)
|
|
|
|
endif # SIGNCODE
|
|
|
|
endif # CONFIG_WIN
|
|
|
|
|
2012-07-18 03:58:20 +04:00
|
|
|
# Add a dependency on the generated files, so that they are always
|
|
|
|
# rebuilt before other object files
|
2017-06-08 15:59:59 +03:00
|
|
|
ifneq ($(wildcard config-host.mak),)
|
2015-05-22 08:35:07 +03:00
|
|
|
ifneq ($(filter-out $(UNCHECKED_GOALS),$(MAKECMDGOALS)),$(if $(MAKECMDGOALS),,fail))
|
2019-04-01 17:12:19 +03:00
|
|
|
Makefile: $(generated-files-y)
|
2012-09-17 00:07:13 +04:00
|
|
|
endif
|
2017-06-08 15:59:59 +03:00
|
|
|
endif
|
2012-07-18 03:58:20 +04:00
|
|
|
|
2007-11-07 22:24:02 +03:00
|
|
|
# Include automatically generated dependency files
|
2012-07-11 18:40:21 +04: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 07:25:17 +03:00
|
|
|
|
|
|
|
include $(SRC_PATH)/tests/docker/Makefile.include
|
2017-09-05 05:11:58 +03:00
|
|
|
include $(SRC_PATH)/tests/vm/Makefile.include
|
2016-09-13 17:20:33 +03:00
|
|
|
|
2020-03-05 03:48:54 +03:00
|
|
|
print-help-run = printf " %-30s - %s\\n" "$1" "$2"
|
|
|
|
print-help = $(quiet-@)$(call print-help-run,$1,$2)
|
|
|
|
|
2016-09-13 17:20:33 +03:00
|
|
|
.PHONY: help
|
|
|
|
help:
|
|
|
|
@echo 'Generic targets:'
|
2020-03-05 03:48:54 +03:00
|
|
|
$(call print-help,all,Build all)
|
2018-03-06 19:17:28 +03:00
|
|
|
ifdef CONFIG_MODULES
|
2020-03-05 03:48:54 +03:00
|
|
|
$(call print-help,modules,Build all modules)
|
2018-03-06 19:17:28 +03:00
|
|
|
endif
|
2020-03-05 03:48:54 +03: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 16:45:33 +03:00
|
|
|
$(call print-help,sparse,Run sparse on the QEMU source)
|
2016-09-13 17:20:33 +03:00
|
|
|
@echo ''
|
2018-07-04 09:30:11 +03:00
|
|
|
@$(if $(TARGET_DIRS), \
|
2016-09-13 17:20:33 +03:00
|
|
|
echo 'Architecture specific targets:'; \
|
2018-07-04 09:30:11 +03:00
|
|
|
$(foreach t, $(TARGET_DIRS), \
|
2020-05-14 17:34:29 +03: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 17:20:33 +03:00
|
|
|
echo '')
|
2020-04-23 13:43:45 +03:00
|
|
|
@$(if $(HELPERS-y), \
|
|
|
|
echo 'Helper targets:'; \
|
|
|
|
$(foreach t, $(HELPERS-y), \
|
|
|
|
$(call print-help-run,$(t),Build $(shell basename $(t)));) \
|
|
|
|
echo '')
|
2020-03-05 03:48:55 +03:00
|
|
|
@$(if $(TOOLS), \
|
|
|
|
echo 'Tools targets:'; \
|
|
|
|
$(foreach t, $(TOOLS), \
|
|
|
|
$(call print-help-run,$(t),Build $(shell basename $(t)) tool);) \
|
2016-09-13 17:20:33 +03:00
|
|
|
echo '')
|
|
|
|
@echo 'Cleaning targets:'
|
2020-03-05 03:48:54 +03: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 17:20:33 +03:00
|
|
|
@echo ''
|
|
|
|
@echo 'Test targets:'
|
2020-03-05 03:48:54 +03: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 17:20:33 +03:00
|
|
|
@echo ''
|
|
|
|
@echo 'Documentation targets:'
|
2020-03-05 03:48:54 +03:00
|
|
|
$(call print-help,html info pdf txt,Build documentation in specified format)
|
2016-09-13 17:20:33 +03:00
|
|
|
@echo ''
|
|
|
|
ifdef CONFIG_WIN32
|
|
|
|
@echo 'Windows targets:'
|
2020-03-05 03:48:54 +03:00
|
|
|
$(call print-help,installer,Build NSIS-based installer for QEMU)
|
2016-09-13 17:20:33 +03:00
|
|
|
ifdef QEMU_GA_MSI_ENABLED
|
2020-03-05 03:48:54 +03:00
|
|
|
$(call print-help,msi,Build MSI-based installer for qemu-ga)
|
2016-09-13 17:20:33 +03:00
|
|
|
endif
|
|
|
|
@echo ''
|
|
|
|
endif
|
2020-03-05 03:48:54 +03:00
|
|
|
$(call print-help,$(MAKE) [targets],(quiet build, default))
|
|
|
|
$(call print-help,$(MAKE) V=1 [targets],(verbose build))
|