Official QEMU mirror. Please see http://wiki.qemu.org/Contribute/SubmitAPatch for how to submit changes to QEMU. Pull Requests are ignored. Please only use release tarballs from the QEMU website.
C Python C++ Shell Haxe Assembly Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
accel Remove unnecessary variables for function return value May 20, 2018
audio audio/sdl: build as module Mar 12, 2018
backends memdev: remove "id" property May 8, 2018
block Remove unnecessary variables for function return value May 20, 2018
bsd-user Use cpu_create(type) instead of cpu_init(cpu_model) Mar 19, 2018
capstone @ 22ead3e disas: Add capstone as submodule Oct 26, 2017
chardev Revert "mux: fix ctrl-a b again" Apr 17, 2018
contrib contrib/libvhost-user: add the protocol feature used for SET/GET message Apr 9, 2018
crypto Include less of the generated modular QAPI headers Mar 2, 2018
default-configs hw/arm/smmu-common: smmu base device and datatypes May 4, 2018
disas RISC-V: Fix missing break statement in disassembler May 5, 2018
docs migration: update docs May 15, 2018
dtc @ e543880 Update dtc to fix compilation problem on Mac OS 10.6 Jan 10, 2018
fpu fpu/softfloat: Define floatN_silence_nan in terms of parts_silence_nan May 17, 2018
fsdev use g_path_get_basename instead of basename Mar 6, 2018
gdb-xml s390x/gdb: add gs registers Jul 14, 2017
hw acpi: fix a comment about aml_call0() May 20, 2018
include typedefs: Remove PcGuestInfo from qemu/typedefs.h May 20, 2018
io Remove unnecessary variables for function return value May 20, 2018
libdecnumber build: remove CONFIG_LIBDECNUMBER Oct 16, 2017
linux-headers include: add psp-sev.h header file Mar 13, 2018
linux-user Merge remote-tracking branch 'remotes/vivier2/tags/linux-user-for-2.1… May 15, 2018
migration Migration+TLS: Fix crash due to double cleanup May 15, 2018
nbd nbd/client: Fix error messages during NBD_INFO_BLOCK_SIZE May 4, 2018
net net: Get rid of 'vlan' terminology and use 'hub' instead in the sourc… May 14, 2018
pc-bios pc-bios/s390-ccw: struct tpi_info must be declared as aligned(4) May 14, 2018
po po: add missing translations in de, fr, it, zh Dec 14, 2016
qapi qapi/net.json: Fix the version number of the "vlan" removal May 20, 2018
qga qobject: Replace qobject_incref/QINCREF qobject_decref/QDECREF May 4, 2018
qobject qobject: Modify qobject_ref() to return obj May 4, 2018
qom memdev: remove "id" property May 8, 2018
replay replay: save vmstate of the asynchronous events Mar 12, 2018
roms roms/u-boot-sam460ex: Change to qemu git mirror and update Apr 10, 2018
scripts Merge remote-tracking branch 'remotes/stefanha/tags/block-pull-reques… May 14, 2018
scsi qemu-pr-helper: Write pidfile more often Apr 9, 2018
slirp slirp/debug: Print IP addresses in human readable form May 20, 2018
stubs pc-dimm: factor out MemoryDevice interface May 7, 2018
target i386: define the AMD 'virt-ssbd' CPUID feature bit (CVE-2018-3639) May 21, 2018
tcg tcg: fix s/compliment/complement/ typos May 20, 2018
tests Remove unnecessary variables for function return value May 20, 2018
trace Include less of the generated modular QAPI headers Mar 2, 2018
ui sdl: Move use of surface pointer below check for whether it is NULL May 18, 2018
util replace functions which are only available in glib-2.24 May 20, 2018
.dir-locals.el Add .dir-locals.el file to configure emacs coding style Oct 8, 2015
.editorconfig add editorconfig Jul 20, 2017
.exrc qemu: add .exrc Sep 7, 2012
.gdbinit .gdbinit: load QEMU sub-commands when gdb starts Jun 7, 2017
.gitignore target/arm: Add SVE decode skeleton May 18, 2018
.gitmodules roms/u-boot-sam460ex: Change to qemu git mirror and update Apr 10, 2018
.gitpublish Add a git-publish configuration file Mar 5, 2018
.mailmap maint: Add .mailmap entries for patches claiming list authorship Apr 9, 2018
.shippable.yml shippable: Remove Debian 8 libfdt kludge May 11, 2018
.travis.yml .travis.yml: add --disable-user with the rest of the disables Mar 13, 2018
CODING_STYLE coding_style: add point about 0x in trace-events Aug 1, 2017
COPYING COPYING: update from FSF Oct 12, 2008
COPYING.LIB Update FSF address in GPL/LGPL boilerplate Jan 4, 2009
COPYING.PYTHON scripts: add argparse module for Python 2.6 compatibility Aug 30, 2017
Changelog Use HTTPS for qemu.org and other domains Nov 21, 2017
HACKING HACKING: document preference for g_new instead of g_malloc May 20, 2018
LICENSE vfio: move hw/misc/vfio.c to hw/vfio/pci.c Move vfio.h into include/h… Dec 19, 2014
MAINTAINERS MAINTAINERS: Add trace-events and qemu-option-trace.texi to tracing s… May 10, 2018
Makefile build: Silence dtc directory creation May 11, 2018
Makefile.objs build: enable audio modules Mar 12, 2018
Makefile.target make: switch from -I to -iquote Mar 23, 2018
README README: Fix typo 'git-publish' Mar 8, 2018
VERSION Open 2.13 development tree Apr 26, 2018
arch_init.c qapi: change the type of TargetInfo.arch from string to enum SysEmuTa… May 4, 2018
balloon.c qapi: Empty out qapi-schema.json Mar 2, 2018
block.c qobject: Modify qobject_ref() to return obj May 4, 2018
blockdev-nbd.c Include less of the generated modular QAPI headers Mar 2, 2018
blockdev.c qobject: Replace qobject_incref/QINCREF qobject_decref/QDECREF May 4, 2018
blockjob.c blockjob: do not cancel timer in resume May 16, 2018
bootdevice.c Makefile: Move bootdevice.o to common-obj-y Jul 4, 2017
bt-host.c all: Clean up includes Feb 4, 2016
bt-vhci.c all: Clean up includes Feb 4, 2016
configure Merge remote-tracking branch 'remotes/bonzini/tags/for-upstream' into… May 14, 2018
cpus-common.c *_run_on_cpu: introduce run_on_cpu_data type Oct 31, 2016
cpus.c cpus: tcg: fix never exiting loop on unplug May 8, 2018
device-hotplug.c Move include qemu/option.h from qemu-common.h to actual users Feb 9, 2018
device_tree.c device_tree: Increase FDT_MAX_SIZE to 1 MiB Apr 26, 2018
disas.c RISC-V Disassembler Mar 6, 2018
dma-helpers.c block: explicitly acquire aiocontext in bottom halves that need it Feb 21, 2017
dump.c dump: Fix build with newer gcc Apr 9, 2018
exec.c exec: reintroduce MemoryRegion caching May 8, 2018
gdbstub.c gdbstub: Handle errors in gdb_accept() May 20, 2018
hmp-commands-info.hx sev/i386: hmp: add 'info sev' command Mar 13, 2018
hmp-commands.hx migration/hmp: add migrate_pause command May 15, 2018
hmp.c migration/hmp: add migrate_pause command May 15, 2018
hmp.h migration/hmp: add migrate_pause command May 15, 2018
ioport.c trace: switch to modular code generation for sub-directories Jan 31, 2017
iothread.c iothread: workaround glib bug which hangs qmp-test Apr 10, 2018
memory.c exec: reintroduce MemoryRegion caching May 8, 2018
memory_ldst.inc.c exec: move memory access declarations to a common header, inline *_ph… May 8, 2018
memory_mapping.c Replace all occurances of __FUNCTION__ with __func__ Jan 22, 2018
module-common.c all: Clean up includes Feb 4, 2016
monitor.c qobject: Modify qobject_ref() to return obj May 4, 2018
numa.c memdev: remove "id" property May 8, 2018
os-posix.c qemu-options: Bail out on unsupported options instead of silently ign… May 8, 2018
os-win32.c qemu-options: Bail out on unsupported options instead of silently ign… May 8, 2018
qdev-monitor.c qom: introduce object_class_get_list_sorted Mar 12, 2018
qdict-test-data.txt Introduce QDict test data file Sep 4, 2009
qemu-bridge-helper.c all: Remove unnecessary glib.h includes Jun 7, 2016
qemu-doc.texi Merge remote-tracking branch 'remotes/jasowang/tags/net-pull-request'… May 14, 2018
qemu-ga.texi qemu-ga: Remove stray 'q' in documentation Oct 28, 2016
qemu-img-cmds.hx qemu-img-cmds.hx: add passive-aggressive note May 20, 2018
qemu-img.c qemu-img: remove references to GEN_DOCS May 20, 2018
qemu-img.texi qemu-img: Make documentation between .texi and .hx consistent May 20, 2018
qemu-io-cmds.c Move include qemu/option.h from qemu-common.h to actual users Feb 9, 2018
qemu-io.c qemu-io: Use purely string blockdev options May 15, 2018
qemu-keymap.c Drop superfluous includes of qapi-types.h and test-qapi-types.h Feb 9, 2018
qemu-nbd.c Polish the version strings containing the package version Mar 12, 2018
qemu-nbd.texi nbd: Add qemu-nbd -D for human-readable description Nov 2, 2016
qemu-option-trace.texi qemu-option-trace: -trace enable= is a pattern, not a file May 20, 2018
qemu-options-wrapper.h qemu-img: remove references to GEN_DOCS May 20, 2018
qemu-options.h Clean up ill-advised or unusual header guards Jul 12, 2016
qemu-options.hx Merge remote-tracking branch 'remotes/jasowang/tags/net-pull-request'… May 14, 2018
qemu-seccomp.c seccomp: add resourcecontrol argument to command line Sep 15, 2017
qemu-tech.texi qemu-doc: merge qemu-tech and qemu-doc Oct 7, 2016
qemu.nsi Use HTTPS for qemu.org and other domains Nov 21, 2017
qemu.sasl Default to GSSAPI (Kerberos) instead of DIGEST-MD5 for SASL May 9, 2017
qmp.c pc-dimm: factor out MemoryDevice interface May 7, 2018
qtest.c qtest: Don't perform side effects inside assertion Sep 15, 2017
replication.c replication: Introduce new APIs to do replication operation Sep 13, 2016
replication.h block/replication: Remove protocol_name field Mar 26, 2018
rules.mak configure: Really use local libfdt if the system one is too old May 11, 2018
thunk.c thunk: assert nb_fields is valid Jul 31, 2017
tpm.c qapi: Move qapi-schema.json to qapi/, rename generated files Mar 2, 2018
trace-events Merge remote-tracking branch 'remotes/mst/tags/for_upstream' into sta… Mar 20, 2018
version.rc Use HTTPS for qemu.org and other domains Nov 21, 2017
vl.c qemu-options: Allow -no-user-config again May 20, 2018

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:

  https://qemu.org/Hosts/Linux
  https://qemu.org/Hosts/Mac
  https://qemu.org/Hosts/W32


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

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

   git clone git://git.qemu.org/qemu.git

When submitting patches, one common 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

  https://qemu.org/Contribute/SubmitAPatch
  https://qemu.org/Contribute/TrivialPatches

The QEMU website is also maintained under source control.

  git clone git://git.qemu.org/qemu-web.git
  https://www.qemu.org/2017/02/04/the-new-qemu-website-is-up/

A 'git-publish' utility was created to make above process less
cumbersome, and is highly recommended for making regular contributions,
or even just for sending consecutive patch series revisions. It also
requires a working 'git send-email' setup, and by default doesn't
automate everything, so you may want to go through the above steps
manually for once.

For installation instructions, please go to

  https://github.com/stefanha/git-publish

The workflow with 'git-publish' is:

  $ git checkout master -b my-feature
  $ # work on new commits, add your 'Signed-off-by' lines to each
  $ git publish

Your patch series will be sent and tagged as my-feature-v1 if you need to refer
back to it in the future.

Sending v2:

  $ git checkout my-feature # same topic branch
  $ # making changes to the commits (using 'git rebase', for example)
  $ git publish

Your patch series will be sent with 'v2' tag in the subject and the git tip
will be tagged as my-feature-v2.

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:

  https://qemu.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
   https://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:

  https://qemu.org/Contribute/StartHere

-- End