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.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Peter Maydell abfa865014 Virtiofsd pull 2020-03-03 3 years ago
.gitlab-ci.d/edk2 gitlab-ci.yml: Add jobs to build EDK2 firmware binaries 3 years ago
accel accel/tcg: increase default code gen buffer size for 64 bit 3 years ago
audio audio/alsaaudio: Remove superfluous semicolons 3 years ago
authz authz: fix usage of bool in listfile.c 3 years ago
backends hostmem: fix strict bind policy 3 years ago
block block/replication.c: Ignore requests after failover 3 years ago
bsd-user build: move TARGET_GPROF to config-host.mak 3 years ago
capstone@22ead3e0bf disas: Add capstone as submodule 5 years ago
chardev qemu/queue.h: add QLIST_SAFE_REMOVE() 3 years ago
contrib libvhost-user: implement in-band notifications 3 years ago
crypto * More uses of RCU_READ_LOCK_GUARD (Dave, myself) 3 years ago
default-configs spapr: Add NVDIMM device support 3 years ago
disas target/mips: Add implementation of GINVT instruction 3 years ago
docs colo: Update Documentation for continuous replication 3 years ago
dtc@88f18909db Update dtc/libfdt submodule to v1.4.7 4 years ago
dump hmp: drop Error pointer indirection in hmp_handle_error 3 years ago
fpu softfp: Added hardfloat conversion from float32 to float64 3 years ago
fsdev virtfs-proxy-helper: Convert documentation to rST 3 years ago
gdb-xml target/riscv: Expose "priv" register for GDB for reads 3 years ago
hw -----BEGIN PGP SIGNATURE----- 3 years ago
include -----BEGIN PGP SIGNATURE----- 3 years ago
io io/channel-websock: treat 'binary' and no sub-protocol as the same 3 years ago
libdecnumber build: remove CONFIG_LIBDECNUMBER 5 years ago
linux-headers linux-headers: update 3 years ago
linux-user target/arm: Implement v8.4-RCPC 3 years ago
migration savevm: Don't call colo_init_ram_cache twice 3 years ago
monitor multifd: Add multifd-zstd-level parameter 3 years ago
nbd nbd: Fix regression with multiple meta contexts 3 years ago
net net/filter.c: Add Options to insert filters anywhere in the filter list 3 years ago
pc-bios hw/ppc/prep: Remove the deprecated "prep" machine and the OpenHackware BIOS 3 years ago
plugins plugins/core: add missing break in cb_to_tcg_flags 3 years ago
po ui/gtk: fix gettext message's charset. 3 years ago
python/qemu python/qemu/machine: Allow to use other serial consoles than default 3 years ago
qapi multifd: Add zstd compression multifd support 3 years ago
qga qga/qapi-schema.json: minor format fixups for rST 3 years ago
qobject qstring: add qstring_free() 3 years ago
qom qapi/qmp: add ObjectPropertyInfo.default-value 3 years ago
replay replay: record and replay random number sources 3 years ago
roms hw/ppc/prep: Remove the deprecated "prep" machine and the OpenHackware BIOS 3 years ago
scripts Merge branch 'exec_rw_const_v4' of https://github.com/philmd/qemu into HEAD 3 years ago
scsi build: rename CONFIG_LIBCAP to CONFIG_LIBCAP_NG 3 years ago
slirp@126c04acba slirp: update with CVE-2019-14378 fix 4 years ago
softmmu vl: Abort if multiple machines are registered as default 3 years ago
stubs stubs: add stubs for io_uring interface 3 years ago
target RISC-V Patches for the 5.0 Soft Freeze, Part 3 3 years ago
tcg tcg/arm: Expand epilogue inline 3 years ago
tests tests/test-replication.c: Add test for for secondary node continuing replication 3 years ago
tools/virtiofsd virtiofsd: Fix xattr operations 3 years ago
trace tracing: only allow -trace to override -D if set 3 years ago
ui ui/input-barrier: Remove superfluous semicolon 3 years ago
util mem-prealloc: optimize large guest startup 3 years ago
.cirrus.yml ci: build out-of-tree 3 years ago
.dir-locals.el
.editorconfig editorconfig: add setting for shell scripts 4 years ago
.exrc
.gdbinit .gdbinit: load QEMU sub-commands when gdb starts 6 years ago
.gitignore virtiofsd: add vhost-user.json file 3 years ago
.gitlab-ci-edk2.yml gitlab-ci.yml: Add jobs to build EDK2 firmware binaries 3 years ago
.gitlab-ci.yml configure: Enable test and libs for zstd 3 years ago
.gitmodules hw/ppc/prep: Remove the deprecated "prep" machine and the OpenHackware BIOS 3 years ago
.gitpublish Add a git-publish configuration file 5 years ago
.mailmap mailmap: Add entry for Yu-Chen Lin 3 years ago
.patchew.yml ci: store Patchew configuration in the tree 4 years ago
.readthedocs.yml .readthedocs.yml: specify some minimum python requirements 3 years ago
.shippable.yml .shippable: --disable-docs for cross-compile tests 3 years ago
.travis.yml configure: Enable test and libs for zstd 3 years ago
CODING_STYLE.rst docs: split the CODING_STYLE doc into distinct groups 3 years ago
COPYING
COPYING.LIB COPYING.LIB: Synchronize the LGPL 2.1 with the version from gnu.org 4 years ago
Changelog Use HTTPS for qemu.org and other domains 5 years ago
Kconfig.host configure: simplify vhost condition with Kconfig 3 years ago
LICENSE tcg/LICENSE: Remove out of date claim about TCG subdirectory licensing 3 years ago
MAINTAINERS tests/acceptance: Add a test for the integratorcp arm machine 3 years ago
Makefile docs: Move tools documentation to tools manual 3 years ago
Makefile.objs softmmu: move vl.c to softmmu/ 3 years ago
Makefile.target fuzz: add target/fuzz makefile rules 3 years ago
README.rst docs: merge HACKING.rst contents into CODING_STYLE.rst 3 years ago
VERSION Open 5.0 development tree 3 years ago
arch_init.c hw/m68k: add Nubus macfb video card 3 years ago
balloon.c Clean up inclusion of exec/cpu-common.h 4 years ago
block.c qemu/queue.h: add QLIST_SAFE_REMOVE() 3 years ago
blockdev-nbd.c nbd: Allow description when creating NBD blockdev 3 years ago
blockdev.c qapi: Allow getting flat output from 'query-named-block-nodes' 3 years ago
blockjob.c blockjob: Fix error message for negative speed 3 years ago
bootdevice.c bootdevice: FW_CFG interface for LCHS values 3 years ago
configure configure: Enable test and libs for zstd 3 years ago
cpus-common.c cpu: introduce cpu_in_exclusive_context() 3 years ago
cpus.c Wrapper function to wait on condition for the main loop mutex 3 years ago
device-hotplug.c Include hw/hw.h exactly where needed 4 years ago
device_tree.c device_tree: Fix integer overflowing in load_device_tree() 4 years ago
disas.c plugin: add qemu_plugin_insn_disas helper 3 years ago
dma-helpers.c Avoid address_space_rw() with a constant is_write argument 3 years ago
exec-vary.c exec: Cache TARGET_PAGE_MASK for TARGET_PAGE_BITS_VARY 3 years ago
exec.c Memory: Only call ramblock_ptr when needed in qemu_ram_writeback 3 years ago
gdbstub.c chardev: Use QEMUChrEvent enum in IOEventHandler typedef 3 years ago
gitdm.config contrib: gitdm: add a mapping for Janus Technologies 4 years ago
hmp-commands-info.hx riscv: hmp: Add a command to show virtual memory mappings 3 years ago
hmp-commands.hx hmp: Allow using qdev ID for qemu-io command 3 years ago
ioport.c Include qemu-common.h exactly where needed 4 years ago
iothread.c iothread: document about why we need explicit aio_poll() 4 years ago
job-qmp.c Include qemu-common.h exactly where needed 4 years ago
job.c job: drop job_drain 3 years ago
memory.c memory: batch allocate ioeventfds[] in address_space_update_ioeventfds() 3 years ago
memory_ldst.inc.c memory: Single byte swap along the I/O path 3 years ago
memory_mapping.c Include qemu-common.h exactly where needed 4 years ago
module-common.c
os-posix.c os-posix: simplify os_find_datadir 3 years ago
os-win32.c glib: use portable g_setenv() 3 years ago
qdev-monitor.c virtio, pc: fixes, features 3 years ago
qemu-bridge-helper.c build: rename CONFIG_LIBCAP to CONFIG_LIBCAP_NG 3 years ago
qemu-deprecated.texi numa: remove deprecated -mem-path fallback to anonymous RAM 3 years ago
qemu-doc.texi qemu-doc: Clarify extent of build platform support 3 years ago
qemu-edid.c Include qemu-common.h exactly where needed 4 years ago
qemu-img-cmds.hx qemu-img: Add --target-is-zero to convert 3 years ago
qemu-img.c qemu-img: Fix convert -n -B for backing-less targets 3 years ago
qemu-io-cmds.c block: Pass truncate exact=true where reasonable 3 years ago
qemu-io.c qemu-io: adds option to use aio engine 3 years ago
qemu-keymap.c Include qemu-common.h exactly where needed 4 years ago
qemu-nbd.c qemu-nbd: Removed deprecated --partition option 3 years ago
qemu-option-trace.texi qemu-nbd: Convert invocation documentation to rST 3 years ago
qemu-options-wrapper.h qemu-img: remove references to GEN_DOCS 5 years ago
qemu-options.h
qemu-options.hx l2tpv3: fix RFC number typo in qemu-options.hx 3 years ago
qemu-seccomp.c seccomp: report more useful errors from seccomp 4 years ago
qemu-tech.texi qemu-tech: Fix dangling @menu entries 4 years ago
qemu.nsi win32: fix README file in NSIS installer 3 years ago
qemu.sasl Default to GSSAPI (Kerberos) instead of DIGEST-MD5 for SASL 6 years ago
qtest.c Merge branch 'exec_rw_const_v4' of https://github.com/philmd/qemu into HEAD 3 years ago
replication.c replication: Introduce new APIs to do replication operation 6 years ago
replication.h Include qemu/module.h where needed, drop it from qemu-common.h 4 years ago
rules.mak Makefile: Ensure we don't run Sphinx in parallel for manpages 3 years ago
thunk.c thunk: improve readability of allocation loop 4 years ago
tpm.c tpm: Clean up error reporting in tpm_init_tpmdev() 4 years ago
trace-events trace: add mmu_index to mem_info 3 years ago
version.rc Use HTTPS for qemu.org and other domains 5 years ago

README.rst

===========
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:


.. code-block:: shell

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.

.. code-block:: shell

git clone https://git.qemu.org/git/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 CODING_STYLE.rst file.

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.

.. code-block:: shell

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

.. code-block:: shell

$ 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:

.. code-block:: shell

$ 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

* `<mailto: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>`_