QEMU With E2K User Support
Go to file
Markus Armbruster e43bfd9c87 error: Use error_prepend() where it makes obvious sense
Done with this Coccinelle semantic patch

    @@
    expression FMT, E1, E2;
    expression list ARGS;
    @@
    -    error_setg(E1, FMT, ARGS, error_get_pretty(E2));
    +    error_propagate(E1, E2);/*###*/
    +    error_prepend(E1, FMT/*@@@*/, ARGS);

followed by manual cleanup, first because I can't figure out how to
make Coccinelle transform strings, and second to get rid of now
superfluous error_propagate().

We now use or propagate the original error whole instead of just its
message obtained with error_get_pretty().  This avoids suppressing its
hint (see commit 50b7b00), but I can't see how the errors touched in
this commit could come with hints.  It also improves the message
printed with &error_abort when we screw up (see commit 1e9b65b).

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
2016-01-13 15:16:17 +01:00
audio audio: Clean up inappropriate and unreachable use of hw_error() 2016-01-13 15:16:16 +01:00
backends hostmem: Ignore ENOSYS while setting MPOL_DEFAULT 2015-11-23 10:43:38 -02:00
block error: Use error_prepend() where it makes obvious sense 2016-01-13 15:16:17 +01:00
bsd-user linux-user: convert DEBUG_SIGNAL logging to tracepoints 2015-12-17 17:33:48 +01:00
contrib error: Use error_report_err() instead of ad hoc prints 2016-01-13 15:16:16 +01:00
crypto crypto: fix transposed arguments in cipher error message 2015-12-23 11:02:20 +00:00
default-configs nvdimm acpi: build ACPI NFIT table 2015-12-22 18:39:20 +02:00
disas disas/libvixl: Suppress gcc 4.6.3 sign-compare warnings 2016-01-12 16:45:45 +00:00
docs docs/pci_expander_bridge: fix typo 2015-12-22 18:39:20 +02:00
dtc@65cc4d2748 dtc: Update dtc / libfdt submodule to version 1.4.0 2015-06-03 23:56:49 +02:00
fpu target-s390x: define default NaN values 2015-06-05 01:37:58 +02:00
fsdev 9pfs: make pdu_{,un}marshal proper functions 2016-01-08 14:53:39 +05:30
gdb-xml s390x/gdb: expose virtualization specific registers 2015-10-02 13:31:52 +02:00
hw error: Use error_prepend() where it makes obvious sense 2016-01-13 15:16:17 +01:00
include error: New error_prepend(), error_reportf_err() 2016-01-13 15:16:17 +01:00
io io: fix stack allocation when sending of file descriptors 2015-12-23 10:53:03 +00:00
libdecnumber typofixes - v4 2015-09-11 10:45:43 +03:00
linux-headers linux-headers: update from kvm/next 2015-12-17 15:24:34 +01:00
linux-user January 2016 Linux-user queque 2016-01-11 14:22:04 +00:00
migration error: Use error_report_err() instead of monitor_printf() 2016-01-13 15:16:16 +01:00
net trivial patches for 2016-01-11 2016-01-11 12:56:58 +00:00
pc-bios seabios: update binaries to release 1.9.0 2016-01-05 13:04:15 +01:00
pixman@87eea99e44
po Update language files for QEMU 2.5.0 2015-12-10 13:50:45 +00:00
qapi qmp: Add blockdev-mirror command 2016-01-07 21:30:18 +01:00
qga qga: convert to use error checked base64 decode 2015-12-18 16:25:08 +00:00
qobject qapi: Convert QType into QAPI built-in enum type 2015-12-17 08:21:28 +01:00
qom qom: Clean up assertions to display values on failure 2015-11-19 15:15:33 +01:00
replay error: Use error_reportf_err() where it makes obvious sense 2016-01-13 15:16:17 +01:00
roms seabios: stop updating aml files 2016-01-05 13:04:14 +01:00
scripts trivial patches for 2016-01-11 2016-01-11 12:56:58 +00:00
slirp ether/slirp: Avoid redefinition of the same constants 2016-01-11 11:01:35 +08:00
stubs kvm: x86: add support for KVM_CAP_SPLIT_IRQCHIP 2015-12-17 17:33:47 +01:00
target-alpha target-alpha: fix uninitialized variable 2015-11-06 15:42:38 +03:00
target-arm kvm: x86: add support for KVM_CAP_SPLIT_IRQCHIP 2015-12-17 17:33:47 +01:00
target-cris cris: avoid "naked" qemu_log 2015-12-17 17:33:47 +01:00
target-i386 target-i386: kvm: clear unusable segments' flags in migration 2015-12-17 17:33:49 +01:00
target-lm32 target-*: Advance pc after recognizing a breakpoint 2015-10-28 10:57:16 -07:00
target-m68k target-*: Advance pc after recognizing a breakpoint 2015-10-28 10:57:16 -07:00
target-microblaze microblaze: avoid "naked" qemu_log 2015-12-17 17:33:48 +01:00
target-mips target-mips: flush QEMU TLB when disabling 64-bit addressing 2015-11-24 11:01:03 +00:00
target-moxie target-*: Advance pc after recognizing a breakpoint 2015-10-28 10:57:16 -07:00
target-openrisc target-*: Advance pc after recognizing a breakpoint 2015-10-28 10:57:16 -07:00
target-ppc target-ppc: Define kvmppc_read_int_dt() 2016-01-11 15:28:49 +11:00
target-s390x s390x: avoid "naked" qemu_log 2015-12-17 17:33:48 +01:00
target-sh4 target-*: Advance pc after recognizing a breakpoint 2015-10-28 10:57:16 -07:00
target-sparc target-sparc: implement NPT timer bit 2016-01-07 12:21:06 +00:00
target-tilegx target-tilegx: Implement prefetch instructions in pipe y2 2015-10-22 07:51:49 -10:00
target-tricore tricore: avoid "naked" qemu_log 2015-12-17 17:33:48 +01:00
target-unicore32 target-*: Advance pc after recognizing a breakpoint 2015-10-28 10:57:16 -07:00
target-xtensa xtensa: avoid "naked" qemu_log 2015-12-17 17:33:48 +01:00
tcg tcg: Increase the highwater reservation 2015-12-01 14:36:32 -08:00
tests error: Use error_reportf_err() where it makes obvious sense 2016-01-13 15:16:17 +01:00
trace trace: add make dependencies on tracetool source 2016-01-07 16:59:56 +08:00
ui error: Use error_reportf_err() where it makes obvious sense 2016-01-13 15:16:17 +01:00
util error: New error_prepend(), error_reportf_err() 2016-01-13 15:16:17 +01:00
.dir-locals.el Add .dir-locals.el file to configure emacs coding style 2015-10-08 19:46:01 +03:00
.exrc
.gitignore maint: Ignore ivshmem binaries 2015-11-06 15:42:38 +03:00
.gitmodules
.mailmap
.travis.yml .travis.yml: Run make check for all targets, not just some 2015-10-08 19:46:47 +03:00
accel.c
aio-posix.c aio-epoll: Fix use-after-free of node 2015-11-17 18:35:57 +08:00
aio-win32.c aio: Introduce aio_context_setup 2015-11-09 09:59:32 +00:00
arch_init.c error: Use error_reportf_err() where it makes obvious sense 2016-01-13 15:16:17 +01:00
async.c aio: Introduce aio_context_setup 2015-11-09 09:59:32 +00:00
balloon.c Inhibit ballooning during postcopy 2015-11-10 15:00:28 +01:00
block.c error: Use error_prepend() where it makes obvious sense 2016-01-13 15:16:17 +01:00
blockdev-nbd.c Include monitor/monitor.h exactly where needed 2015-06-22 18:20:41 +02:00
blockdev.c error: Use error_reportf_err() where it makes obvious sense 2016-01-13 15:16:17 +01:00
blockjob.c block: Add block job transactions 2015-11-12 16:22:44 +01:00
bootdevice.c
bt-host.c
bt-vhci.c
Changelog
CODING_STYLE CODING_STYLE: update mixed declaration rules 2015-09-09 15:34:54 +02:00
configure configure: fix trace backend check 2016-01-11 11:39:28 +03:00
COPYING
COPYING.LIB
cpu-exec-common.c exec.c: Collect AddressSpace related fields into a CPUAddressSpace struct 2015-10-12 18:29:26 +02:00
cpu-exec.c So here it is, let's see what happens. 2015-11-06 11:31:40 +00:00
cpus.c cpu: Convert CpuInfo into flat union 2015-12-17 08:21:28 +01:00
cputlb.c cputlb: Change tlb_set_dirty() arg to cpu 2015-09-16 17:33:33 +02:00
device_tree.c device_tree: Fix a typo 2015-07-27 22:44:47 +03:00
device-hotplug.c
disas.c disas: QOMify alpha specific disas setup 2015-10-22 15:49:40 +02:00
dma-helpers.c
dump.c Include qapi/qmp/qerror.h exactly where needed 2015-06-22 18:20:41 +02:00
exec.c ivshmem: Store file descriptor for vhost-user negotiation 2016-01-09 23:20:20 +02:00
gdbstub.c gdbstub: Fix buffer overflows in gdb_handle_packet() 2015-11-06 15:42:37 +03:00
HACKING
hmp-commands-info.hx hmp: added io apic dump state 2015-09-25 12:04:42 +02:00
hmp-commands.hx migrate-start-postcopy: Improve text 2015-11-12 17:54:39 +01:00
hmp.c error: Use error_report_err() instead of monitor_printf() 2016-01-13 15:16:16 +01:00
hmp.h migrate_start_postcopy: Command to trigger transition to postcopy 2015-11-10 15:00:26 +01:00
iohandler.c aio: Add "is_external" flag for event handlers 2015-10-23 18:18:23 +02:00
ioport.c ioport: do not use CPU_LOG_IOPORT 2015-11-04 15:02:30 +01:00
iothread.c iothread: include id in thread name 2015-12-03 11:08:01 +08:00
kvm-all.c kvm: x86: add support for KVM_CAP_SPLIT_IRQCHIP 2015-12-17 17:33:47 +01:00
kvm-stub.c KVM: add support for any length io eventfd 2015-11-12 15:49:32 +02:00
LICENSE
main-loop.c main-loop: suppress warnings under qtest 2015-12-02 12:01:43 +01:00
MAINTAINERS trivial patches for 2016-01-11 2016-01-11 12:56:58 +00:00
Makefile fsdev: rename virtio-9p-marshal.{c,h} to 9p-iov-marshal.{c,h} 2016-01-08 14:35:06 +05:30
Makefile.objs io: add abstract QIOChannel classes 2015-12-18 12:18:05 +00:00
Makefile.target io: add abstract QIOChannel classes 2015-12-18 12:18:05 +00:00
memory_mapping.c memory_mapping: Rework cpu related includes 2015-06-26 16:00:50 +02:00
memory.c memory: inline a few small accessors 2015-12-17 17:33:49 +01:00
module-common.c
monitor.c error: Use error_report_err() instead of monitor_printf() 2016-01-13 15:16:16 +01:00
nbd.c nbd: Mark fd handlers client type as "external" 2015-10-23 18:18:23 +02:00
numa.c Use error_fatal to simplify obvious fatal errors 2016-01-13 11:58:58 +01:00
os-posix.c
os-win32.c maint: remove unused include for signal.h 2015-09-11 10:21:38 +03:00
page_cache.c maint: remove unused include for strings.h 2015-09-11 10:21:38 +03:00
qapi-schema.json qemu-char: convert to use error checked base64 decode 2015-12-18 16:25:08 +00:00
qdev-monitor.c error: Use error_report_err() instead of ad hoc prints 2016-01-13 15:16:16 +01:00
qdict-test-data.txt
qemu-bridge-helper.c
qemu-char.c qemu-char: convert to use error checked base64 decode 2015-12-18 16:25:08 +00:00
qemu-doc.texi Add a base IPMI interface 2015-12-22 18:39:19 +02:00
qemu-ga.texi qga: start a man page 2015-09-01 13:16:26 -05:00
qemu-img-cmds.hx
qemu-img.c error: Use error_reportf_err() where it makes obvious sense 2016-01-13 15:16:17 +01:00
qemu-img.texi maint: remove / fix many doubled words 2015-09-11 10:21:38 +03:00
qemu-io-cmds.c qemu-io: Account for failed, invalid and flush operations 2015-11-12 16:22:46 +01:00
qemu-io.c qemu-io: Remove duplicate 'open' error message 2015-09-14 16:51:36 +02:00
qemu-log.c user: introduce "-d page" 2015-12-17 17:33:48 +01:00
qemu-nbd.c error: Use error_reportf_err() where it makes obvious sense 2016-01-13 15:16:17 +01:00
qemu-nbd.texi
qemu-options-wrapper.h
qemu-options.h
qemu-options.hx nvdimm acpi: build ACPI NFIT table 2015-12-22 18:39:20 +02:00
qemu-seccomp.c seccomp: add cacheflush to whitelist 2015-11-16 09:48:53 +01:00
qemu-tech.texi doc: Refresh URLs in the qemu-tech documentation 2015-09-25 12:20:21 +02:00
qemu-timer.c replay: checkpoints 2015-11-06 10:16:03 +01:00
qemu.nsi nsis: Add QEMU version information to Windows registry 2015-09-24 20:52:28 +02:00
qemu.sasl
qjson.c
qmp-commands.hx qmp: Add blockdev-mirror command 2016-01-07 21:30:18 +01:00
qmp.c qmp: Convert QMP code to use object property iterators 2015-11-18 21:13:48 +01:00
qtest.c Move page_size_init earlier 2015-11-10 14:51:48 +01:00
README README: fill out some useful quickstart information 2015-10-13 18:48:46 +02:00
rules.mak make: load only required dependency files. 2015-08-13 14:08:25 +03:00
softmmu_template.h softmmu: remove now unused functions 2015-09-11 08:16:05 -07:00
spice-qemu-char.c char: Convert to new qapi union layout 2015-11-02 08:30:27 +01:00
tcg-runtime.c
tci.c tcg: Rename debug_insn_start to insn_start 2015-10-07 20:36:26 +11:00
thread-pool.c coroutine: move into libqemuutil.a library 2015-10-20 14:59:04 +01:00
thunk.c linux-user: Allocate thunk size dynamically 2015-06-15 11:36:58 +03:00
tpm.c qapi: Don't let implicit enum MAX member collide 2015-12-17 08:21:28 +01:00
trace-events trace: fix PRIx64 constants in trace-events 2016-01-07 09:39:11 +08:00
translate-all.c translate-all: ensure host page mask is always extended with 1's 2015-12-02 13:12:30 +01:00
translate-all.h translate-all: remove unnecessary argument to tb_invalidate_phys_range 2015-06-05 17:09:59 +02:00
translate-common.c translate-all: ensure host page mask is always extended with 1's 2015-12-02 13:12:30 +01:00
user-exec.c osdep.h: Remove qemu_printf 2015-08-19 16:29:53 +01:00
VERSION Open 2.6 development tree 2015-12-17 10:17:08 +00:00
version.rc
vl.c error: Use error_reportf_err() where it makes obvious sense 2016-01-13 15:16:17 +01:00
xen-common-stub.c
xen-common.c migration: Fix regression for xenfv and pc,accel=xen machine. 2015-08-03 16:13:40 +00:00
xen-hvm-stub.c pc: Remove redundant arguments from xen_hvm_init() 2015-09-10 11:05:40 +03:00
xen-hvm.c xen-hvm: Mark inappropriate error handling FIXME 2016-01-13 15:16:16 +01:00
xen-mapcache.c maint: avoid useless "if (foo) free(foo)" pattern 2015-09-11 10:21:38 +03:00

         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

Complete details of the process for building and configuring QEMU for
all supported host platforms can be found in the qemu-tech.html file.
Additional information can also be found online via the QEMU website:

  http://qemu-project.org/Hosts/Linux
  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