Go to file
Markus Armbruster 01fa559826 migration: Use JSON null instead of "" to reset parameter to default
migrate-set-parameters sets migration parameters according to is
arguments like this:

* Present means "set the parameter to this value"

* Absent means "leave the parameter unchanged"

* Except for parameters tls_creds and tls_hostname, "" means "reset
  the parameter to its default value

The first two are perfectly normal: presence of the parameter makes
the command do something.

The third one overloads the parameter with a second meaning.  The
overloading is *implicit*, i.e. it's not visible in the types.  Works
here, because "" is neither a valid TLS credentials ID, nor a valid
host name.

Pressing argument values the schema accepts, but are semantically
invalid, into service to mean "reset to default" is not general, as
suitable invalid values need not exist.  I also find it ugly.

To clean this up, we could add a separate flag argument to ask for
"reset to default", or add a distinct value to @tls_creds and
@tls_hostname.  This commit implements the latter: add JSON null to
the values of @tls_creds and @tls_hostname, deprecate "".

Because we're so close to the 2.10 freeze, implement it in the
stupidest way possible: have qmp_migrate_set_parameters() rewrite null
to "" before anything else can see the null.  The proper way to do it
would be rewriting "" to null, but that requires fixing up code to
work with null.  Add TODO comments for that.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Daniel P. Berrange <berrange@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
2017-07-24 13:35:11 +02:00
accel tcg: Pass generic CPUState to gen_intermediate_code() 2017-07-19 14:45:16 -07:00
audio audio: st_rate_flow exist a infinite loop 2017-07-17 11:08:59 +02:00
backends memory: Rename memory_region_init_ram() to memory_region_init_ram_nomigrate() 2017-07-14 17:59:42 +01:00
block block/vpc: fix uninitialised variable compiler warning 2017-07-21 15:00:07 +01:00
bsd-user bsd-user/main.c: Fix unused variable warning 2017-07-21 15:01:09 +01:00
chardev * gdbstub fixes (Alex) 2017-07-14 12:16:09 +01:00
contrib vhost-user-scsi: Introduce a vhost-user-scsi sample application 2017-06-15 11:18:40 +02:00
crypto crypto: hmac: add af_alg-backend hmac support 2017-07-19 10:11:05 +01:00
default-configs configure: Use an explicit CONFIG_IVSHMEM rather than CONFIG_EVENTFD 2017-07-20 14:58:19 +01:00
disas disas/microblaze: Add missing 'const' attributes 2017-07-04 09:22:20 +02:00
docs qapi: Introduce a first class 'null' type 2017-07-24 13:35:11 +02:00
dtc@558cd81bdd dtc: Revert unintentional submodule downgrade from commit c2cabb3422 2017-03-16 14:11:15 +00:00
fpu softfloat: define floatx80_round() 2017-06-29 20:27:39 +02:00
fsdev block: remove timer canceling in throttle_config() 2017-07-18 15:14:35 +02:00
gdb-xml s390x/gdb: add gs registers 2017-07-14 12:29:49 +02:00
hw qapi: Use QNull for a more regular visit_type_null() 2017-07-24 13:35:11 +02:00
include qapi: Introduce a first class 'null' type 2017-07-24 13:35:11 +02:00
io Merge I/O 2017/07/18 v1 2017-07-19 09:11:38 +01:00
libdecnumber libdecnumber: Clean up includes 2016-02-16 14:29:27 +00:00
linux-headers linux header sync against v4.13-rc1 2017-07-18 10:55:16 +02:00
linux-user Replace 'struct ucontext' with 'ucontext_t' type 2017-07-20 10:10:28 +01:00
migration migration: Use JSON null instead of "" to reset parameter to default 2017-07-24 13:35:11 +02:00
nbd nbd: Fix server reply to NBD_OPT_EXPORT_NAME of older clients 2017-07-17 17:06:46 -05:00
net net/filter-rewriter.c: Make filter-rewriter support vnet_hdr_len 2017-07-17 20:13:53 +08:00
pc-bios keymaps: fr-ca: more fixups 2017-07-20 09:25:44 +02:00
pixman@87eea99e44 pixman: update internal copy to pixman-0.32.6 2014-09-15 08:14:19 +02:00
po po: add missing translations in de, fr, it, zh 2016-12-14 18:47:19 +00:00
qapi block: Use JSON null instead of "" to disable backing file 2017-07-24 13:35:11 +02:00
qga test-qga: add test for guest-get-osinfo 2017-07-18 05:49:01 -05:00
qobject qapi: Separate type QNull from QObject 2017-07-24 13:35:11 +02:00
qom x86 and machine queue, 2017-07-17 2017-07-18 15:24:11 +01:00
replay -----BEGIN PGP SIGNATURE----- 2017-06-05 10:09:14 +01:00
roms Pull request 2017-07-17 15:05:29 +01:00
scripts qapi: Introduce a first class 'null' type 2017-07-24 13:35:11 +02:00
slirp slirp: Handle error returns from sosendoob() 2017-07-15 14:28:25 +02:00
stubs migration: Move check_migratable() into qdev.c 2017-05-17 12:04:59 +02:00
target qapi: Use QNull for a more regular visit_type_null() 2017-07-24 13:35:11 +02:00
tcg tcg/tci: enable bswap16_i64 2017-07-19 14:45:16 -07:00
tests block: Use JSON null instead of "" to disable backing file 2017-07-24 13:35:11 +02:00
trace exec: [tcg] Use different TBs according to the vCPU's dynamic tracing state 2017-07-17 13:11:05 +01:00
ui vnc: Set default kbd delay to 10ms 2017-07-17 11:35:27 +02:00
util util/oslib-posix.c: Avoid warning on NetBSD 2017-07-21 10:32:19 +01:00
.dir-locals.el Add .dir-locals.el file to configure emacs coding style 2015-10-08 19:46:01 +03:00
.editorconfig add editorconfig 2017-07-20 09:56:56 +02:00
.exrc qemu: add .exrc 2012-09-07 09:02:44 +03:00
.gdbinit .gdbinit: load QEMU sub-commands when gdb starts 2017-06-07 14:38:45 +01:00
.gitignore coccinelle: ignore ASTs pre-parsed cached C files 2017-07-19 14:45:15 -07:00
.gitmodules Add QemuMacDrivers as submodule 2017-05-11 09:45:15 +10:00
.mailmap Update mailmap 2013-09-05 09:40:31 -05:00
.shippable.yml shippable: add win32/64 targets 2017-07-18 10:58:36 +01:00
.travis.yml travis: move make -j flag out of script 2017-07-18 09:39:19 +01:00
CODING_STYLE CODING_STYLE: Mention preferred comment form 2017-02-28 09:03:38 +03:00
COPYING
COPYING.LIB
Changelog Use qemu-project.org domain name 2013-10-11 09:34:56 -07:00
HACKING HACKING: document #include order 2017-01-03 16:38:47 +00:00
LICENSE vfio: move hw/misc/vfio.c to hw/vfio/pci.c Move vfio.h into include/hw/vfio 2014-12-19 15:24:06 -07:00
MAINTAINERS MAINTAINERS: Add entries for MPS2 board 2017-07-17 13:36:09 +01:00
Makefile configure: Don't build ivshmem tools unless CONFIG_IVSHMEM is set 2017-07-20 14:58:19 +01:00
Makefile.objs configure: Don't build ivshmem tools unless CONFIG_IVSHMEM is set 2017-07-20 14:58:19 +01:00
Makefile.target tcg: add the CONFIG_TCG into Makefiles 2017-07-05 09:12:44 +02:00
README README: Add linux to macOS build info 2017-01-24 23:26:52 +03:00
VERSION Open 2.10 development tree 2017-04-20 15:42:31 +01:00
arch_init.c audio: Rename hw/audio/audio.h to hw/audio/soundhw.h 2017-05-19 10:48:54 +02:00
atomic_template.h tcg: Add atomic128 helpers 2016-10-26 08:29:01 -07:00
balloon.c trace: switch to modular code generation for sub-directories 2017-01-31 17:11:18 +00:00
block.c qemu-img: Check for backing image if specified during create 2017-07-18 15:27:37 +02:00
blockdev-nbd.c nbd: Fix regression on resiliency to port scan 2017-06-15 11:04:05 +02:00
blockdev.c block: Use JSON null instead of "" to disable backing file 2017-07-24 13:35:11 +02:00
blockjob.c fix: avoid an infinite loop or a dangling pointer problem in img_commit 2017-06-26 14:54:46 +02:00
bootdevice.c Makefile: Move bootdevice.o to common-obj-y 2017-07-04 14:39:27 +02:00
bt-host.c all: Clean up includes 2016-02-04 17:41:30 +00:00
bt-vhci.c all: Clean up includes 2016-02-04 17:41:30 +00:00
configure configure: Drop ancient Solaris 9 and earlier support 2017-07-21 15:04:05 +01:00
cpus-common.c *_run_on_cpu: introduce run_on_cpu_data type 2016-10-31 15:00:25 +01:00
cpus.c Convert error_report() to warn_report() 2017-07-13 13:49:58 +02:00
device-hotplug.c blockdev: Split monitor reference from BB creation 2016-03-17 15:47:56 +01:00
device_tree.c device_tree: fix compiler warnings (clang 5) 2017-05-07 09:57:51 +03:00
disas.c Fix Thumb-1 BE32 execution and disassembly. 2017-02-07 18:29:59 +00:00
dma-helpers.c block: explicitly acquire aiocontext in bottom halves that need it 2017-02-21 11:39:39 +00:00
dump.c dump: Acquire BQL around vm_start() in dump thread 2017-05-05 12:10:00 +02:00
exec.c cpu: Convert to DEFINE_PROP_LINK 2017-07-14 12:04:43 +02:00
gdbstub.c Use qemu_tolower() and qemu_toupper(), not tolower() and toupper() 2017-07-21 10:32:41 +01:00
hax-stub.c Plumb the HAXM-based hardware acceleration support 2017-01-19 22:07:46 +01:00
hmp-commands-info.hx s390x/migration: Monitor commands for storage attributes 2017-07-14 12:29:47 +02:00
hmp-commands.hx s390x/kvm/migration/cpumodel: fixes, enhancements and cleanups 2017-07-14 14:19:35 +01:00
hmp.c migration: Use JSON null instead of "" to reset parameter to default 2017-07-24 13:35:11 +02:00
hmp.h hmp: add hmp analogue for qmp-chardev-change 2017-07-14 11:04:34 +02:00
ioport.c trace: switch to modular code generation for sub-directories 2017-01-31 17:11:18 +00:00
iothread.c monitor: add poll-* properties into query-iothreads result 2017-02-21 18:29:01 +00:00
memory.c memory.h: Add memory_region_init_{ram, rom, rom_device}() handling migration 2017-07-14 17:59:42 +01:00
memory_ldst.inc.c exec: introduce memory_ldst.inc.c 2016-12-22 16:00:23 +01:00
memory_mapping.c dump: fix memory_mapping_filter leak 2017-06-04 18:42:55 +03:00
module-common.c all: Clean up includes 2016-02-04 17:41:30 +00:00
monitor.c s390x/kvm/migration/cpumodel: fixes, enhancements and cleanups 2017-07-14 14:19:35 +01:00
numa.c memory: Rename memory_region_init_ram() to memory_region_init_ram_nomigrate() 2017-07-14 17:59:42 +01:00
os-posix.c use g_path_get_dirname instead of dirname 2016-07-17 09:59:21 +02:00
os-win32.c shutdown: Add source information to SHUTDOWN and RESET 2017-05-23 13:28:17 +02:00
qapi-schema.json migration: Use JSON null instead of "" to reset parameter to default 2017-07-24 13:35:11 +02:00
qdev-monitor.c migration: Move remaining exported functions to migration/misc.h 2017-06-13 11:00:45 +02:00
qdict-test-data.txt
qemu-bridge-helper.c all: Remove unnecessary glib.h includes 2016-06-07 18:19:24 +03:00
qemu-doc.texi docs: document encryption options for qcow, qcow2 and luks 2017-07-11 17:44:57 +02:00
qemu-ga.texi qemu-ga: Remove stray 'q' in documentation 2016-10-28 18:17:23 +03:00
qemu-img-cmds.hx qemu-img: Check for backing image if specified during create 2017-07-18 15:27:37 +02:00
qemu-img.c qemu-img: Check for backing image if specified during create 2017-07-18 15:27:37 +02:00
qemu-img.texi qemu-img: Check for backing image if specified during create 2017-07-18 15:27:37 +02:00
qemu-io-cmds.c block: Add PreallocMode to blk_truncate() 2017-07-11 17:45:01 +02:00
qemu-io.c block: rip out all traces of password prompting 2017-07-11 17:44:56 +02:00
qemu-nbd.c nbd: Implement NBD_INFO_BLOCK_SIZE on client 2017-07-14 12:04:42 +02:00
qemu-nbd.texi nbd: Add qemu-nbd -D for human-readable description 2016-11-02 09:28:55 +01:00
qemu-option-trace.texi docs: update manpage for stderr->log rename 2017-02-13 13:38:31 +00:00
qemu-options-wrapper.h hxtool: emit Texinfo headings as @subsection 2017-01-16 17:52:35 +01:00
qemu-options.h Clean up ill-advised or unusual header guards 2016-07-12 16:20:46 +02:00
qemu-options.hx -----BEGIN PGP SIGNATURE----- 2017-07-18 09:16:43 +01:00
qemu-seccomp.c seccomp: adding getrusage to the whitelist 2016-09-21 11:26:02 +02:00
qemu-tech.texi qemu-doc: merge qemu-tech and qemu-doc 2016-10-07 10:05:54 +02:00
qemu.nsi qemu-doc: merge qemu-tech and qemu-doc 2016-10-07 10:05:54 +02:00
qemu.sasl Default to GSSAPI (Kerberos) instead of DIGEST-MD5 for SASL 2017-05-09 14:41:47 +01:00
qmp.c qmp: Include parent type on 'qom-list-types' output 2017-07-17 15:41:30 -03:00
qtest.c char: add backend hotswap handler 2017-07-14 11:04:33 +02:00
replication.c replication: Introduce new APIs to do replication operation 2016-09-13 11:00:56 +01:00
replication.h replication: Introduce new APIs to do replication operation 2016-09-13 11:00:56 +01:00
rules.mak docs: create interop/ subdirectory 2017-06-15 11:18:39 +02:00
softmmu_template.h cputlb: Tidy some macros 2016-10-26 08:29:00 -07:00
thunk.c thunk: Rename args and fields in host-target bitmask conversion code 2016-06-07 18:19:24 +03:00
tpm.c qapi: Don't special-case simple union wrappers 2016-03-18 10:29:26 +01:00
trace-events trace: [trivial] Statically enable all guest events 2017-07-17 13:11:13 +01:00
user-exec-stub.c stubs: group stubs for user-mode emulation 2017-01-16 17:52:35 +01:00
user-exec.c Replace 'struct ucontext' with 'ucontext_t' type 2017-07-20 10:10:28 +01:00
version.rc Use qemu-project.org domain name 2013-10-11 09:34:56 -07:00
vl.c * gdbstub fixes (Alex) 2017-07-14 12:16:09 +01:00

README

         QEMU README
         ===========

QEMU is a generic and open source machine & userspace emulator and
virtualizer.

QEMU is capable of emulating a complete machine in software without any
need for hardware virtualization support. By using dynamic translation,
it achieves very good performance. QEMU can also integrate with the Xen
and KVM hypervisors to provide emulated hardware while allowing the
hypervisor to manage the CPU. With hypervisor support, QEMU can achieve
near native performance for CPUs. When QEMU emulates CPUs directly it is
capable of running operating systems made for one machine (e.g. an ARMv7
board) on a different machine (e.g. an x86_64 PC board).

QEMU is also capable of providing userspace API virtualization for Linux
and BSD kernel interfaces. This allows binaries compiled against one
architecture ABI (e.g. the Linux PPC64 ABI) to be run on a host using a
different architecture ABI (e.g. the Linux x86_64 ABI). This does not
involve any hardware emulation, simply CPU and syscall emulation.

QEMU aims to fit into a variety of use cases. It can be invoked directly
by users wishing to have full control over its behaviour and settings.
It also aims to facilitate integration into higher level management
layers, by providing a stable command line interface and monitor API.
It is commonly invoked indirectly via the libvirt library when using
open source applications such as oVirt, OpenStack and virt-manager.

QEMU as a whole is released under the GNU General Public License,
version 2. For full licensing details, consult the LICENSE file.


Building
========

QEMU is multi-platform software intended to be buildable on all modern
Linux platforms, OS-X, Win32 (via the Mingw64 toolchain) and a variety
of other UNIX targets. The simple steps to build QEMU are:

  mkdir build
  cd build
  ../configure
  make

Additional information can also be found online via the QEMU website:

  http://qemu-project.org/Hosts/Linux
  http://qemu-project.org/Hosts/Mac
  http://qemu-project.org/Hosts/W32


Submitting patches
==================

The QEMU source code is maintained under the GIT version control system.

   git clone git://git.qemu-project.org/qemu.git

When submitting patches, the preferred approach is to use 'git
format-patch' and/or 'git send-email' to format & send the mail to the
qemu-devel@nongnu.org mailing list. All patches submitted must contain
a 'Signed-off-by' line from the author. Patches should follow the
guidelines set out in the HACKING and CODING_STYLE files.

Additional information on submitting patches can be found online via
the QEMU website

  http://qemu-project.org/Contribute/SubmitAPatch
  http://qemu-project.org/Contribute/TrivialPatches


Bug reporting
=============

The QEMU project uses Launchpad as its primary upstream bug tracker. Bugs
found when running code built from QEMU git or upstream released sources
should be reported via:

  https://bugs.launchpad.net/qemu/

If using QEMU via an operating system vendor pre-built binary package, it
is preferable to report bugs to the vendor's own bug tracker first. If
the bug is also known to affect latest upstream code, it can also be
reported via launchpad.

For additional information on bug reporting consult:

  http://qemu-project.org/Contribute/ReportABug


Contact
=======

The QEMU community can be contacted in a number of ways, with the two
main methods being email and IRC

 - qemu-devel@nongnu.org
   http://lists.nongnu.org/mailman/listinfo/qemu-devel
 - #qemu on irc.oftc.net

Information on additional methods of contacting the community can be
found online via the QEMU website:

  http://qemu-project.org/Contribute/StartHere

-- End