Personal qemu branches
Stefan Hajnoczi 2c28c01778 iotests: add LUKS payload overhead to 178 qemu-img measure test 1 day ago
accel kvm: Add kvm_set_ioeventfd* traces 5 days ago
audio wavcapture: Convert to error_report 5 days ago
backends hostmem: add more information in error messages 3 weeks ago
block qcow2: include LUKS payload overhead in qemu-img measure 20 hours ago
bsd-user avoid TABs in files that only contain a few 1 month ago
capstone @ 22ead3e0bf disas: Add capstone as submodule 1 year ago
chardev char-pty: remove write_lock usage 5 days ago
contrib contrib/libvhost-user: cleanup casts 1 week ago
crypto crypto: finish removing TABs 1 week ago
default-configs hw/vfio/Makefile.objs: Create new CONFIG_* variables for VFIO core and PCI 1 week ago
disas disas: nanoMIPS: Amend DSP instructions related comments 3 weeks ago
docs qapi: Generate QAPIEvent stuff into separate files 1 day ago
dtc @ 88f18909db Update dtc/libfdt submodule to v1.4.7 4 months ago
fpu softfloat: enforce softfloat if the host's FMA is broken 3 weeks ago
fsdev qemu/queue.h: leave head structs anonymous unless necessary 1 month ago
gdb-xml gdbstub: Fix i386/x86_64 machine description and add control registers 1 week ago
hw qapi: move RTC_CHANGE to the target schema 1 day ago
include block: Purify .bdrv_refresh_filename() 20 hours ago
io io: add qio_task_wait_thread to join with a background thread 6 days ago
libdecnumber build: remove CONFIG_LIBDECNUMBER 1 year ago
linux-headers include: update Linux headers to 4.21-rc1/5.0-rc1 2 weeks ago
linux-user s390x: Fix the confusing contributions-after-2012 license statements 1 day ago
migration migration: introduce pages-per-second 3 weeks ago
nbd nbd/server: Kill pointless shadowed variable 1 week ago
net char: allow specifying a GMainContext at opening time 6 days ago
pc-bios Update OpenBIOS images to 3464681b built from submodule. 4 days ago
po po/Makefile: Modern shell scripting (use $() instead of ``) 3 months ago
qapi qapi: move RTC_CHANGE to the target schema 1 day ago
qga qemu/queue.h: simplify reverse access to QTAILQ 1 month ago
qobject json: Fix % handling when not interpolating 3 weeks ago
qom qom/cpu: Add cluster_index to CPUState 3 weeks ago
replay replay: Exit on errors reading from replay log 3 months ago
roms Update OpenBIOS images to 3464681b built from submodule. 4 days ago
scripts iotests: Let 045 be run concurrently 20 hours ago
scsi file-posix: Switch to .bdrv_co_ioctl 2 months ago
slirp slirp: wrap the remaining socket functions 6 days ago
stubs qapi: make query-cpu-definitions depend on specific targets 1 day ago
target Merge remote-tracking branch 'remotes/armbru/tags/pull-qapi-2019-02-18' into staging 23 hours ago
tcg tcg/i386: fix unsigned vector saturating arithmetic 1 week ago
tests iotests: add LUKS payload overhead to 178 qemu-img measure test 20 hours ago
trace trace: simple style changes 2 months ago
ui qapi: Generate QAPIEvent stuff into separate files 1 day ago
util slirp: replace global polling with per-instance & notifier 1 week ago
.cirrus.yml .cirrus.yml: basic compile and test for FreeBSD 1 week ago
.dir-locals.el Add .dir-locals.el file to configure emacs coding style 3 years ago
.editorconfig editorconfig: set emacs mode 3 months ago
.exrc qemu: add .exrc 6 years ago
.gdbinit .gdbinit: load QEMU sub-commands when gdb starts 1 year ago
.gitignore qapi: Generate QAPIEvent stuff into separate files 1 day ago
.gitmodules gitmodules: use 'https://' instead of 'git://' 3 months ago
.gitpublish Add a git-publish configuration file 11 months ago
.mailmap maint: Grammar fix to mailmap 2 months ago
.shippable.yml .shippable.yml: disable the win cross tests 2 months ago
.travis.yml .travis.yml: fold --disable-tcg into alternate coroutine builds 1 week ago
CODING_STYLE CODING_STYLE: Define our preferred form for multiline comments 8 months ago
COPYING COPYING: update from FSF 10 years ago
COPYING.LIB COPYING.LIB: Synchronize the LGPL 2.1 with the version from gnu.org 2 weeks ago
Changelog Use HTTPS for qemu.org and other domains 1 year ago
HACKING HACKING: document preference for g_new instead of g_malloc 9 months ago
LICENSE vfio: move hw/misc/vfio.c to hw/vfio/pci.c Move vfio.h into include/hw/vfio 4 years ago
MAINTAINERS MAINTAINERS: Remove myself as block maintainer 20 hours ago
Makefile build: Deal with all of QAPI's .o in qapi/Makefile.objs 1 day ago
Makefile.objs build: Deal with all of QAPI's .o in qapi/Makefile.objs 1 day ago
Makefile.target build: Deal with all of QAPI's .o in qapi/Makefile.objs 1 day ago
README README: use 'https://' instead of 'git://' 3 months ago
VERSION Open 4.0 development tree 2 months ago
arch_init.c arch_init: sort architectures 8 months ago
balloon.c balloon: Allow multiple inhibit users 6 months ago
block.c block: BDS options may lack the "driver" option 20 hours ago
blockdev-nbd.c nbd/server: Hoist length check to qmp_nbd_server_add 4 weeks ago
blockdev.c block: Use bdrv_refresh_filename() to pull 20 hours ago
blockjob.c block: Use a single global AioWait 4 months ago
bootdevice.c fw_cfg: ignore suffixes in the bootdevice list dependent on machine class 6 months ago
bt-host.c all: Clean up includes 3 years ago
bt-vhci.c all: Clean up includes 3 years ago
configure Merge remote-tracking branch 'remotes/amarkovic/tags/mips-queue-feb-14-2019' into staging 4 days ago
cpus-common.c qemu/queue.h: simplify reverse access to QTAILQ 1 month ago
cpus.c cpus: ignore ESRCH in qemu_cpu_kick_thread() 1 week ago
device-hotplug.c blockdev: Convert drive_new() to Error 4 months ago
device_tree.c device_tree.c: Don't use load_image() 2 months ago
disas.c disas: Add RISC-V support 1 month ago
dma-helpers.c block: explicitly acquire aiocontext in bottom halves that need it 2 years ago
dump.c dump: Set correct vaddr for ELF dump 1 week ago
exec.c mmap-alloc: fix hugetlbfs misaligned length in ppc64 1 week ago
gdbstub.c gdbstub: Send a reply to the vKill packet. 4 days ago
gitdm.config contrib: add a basic gitdm config 2 months ago
hmp-commands-info.hx hmp-commands-info: add sync-profile 5 months ago
hmp-commands.hx block/snapshot.c: eliminate use of ID input in snapshot operations 20 hours ago
hmp.c Merge remote-tracking branch 'remotes/vivier2/tags/trivial-branch-pull-request' into staging 4 days ago
hmp.h hmp-commands: add sync-profile 5 months ago
ioport.c trace: switch to modular code generation for sub-directories 2 years ago
iothread.c iothread: fix iothread hang when stop too soon 1 week ago
job-qmp.c jobs: canonize Error object 5 months ago
job.c job: Fix off-by-one assert checks for JobSTT and JobVerbTable 3 months ago
memory.c qemu/queue.h: simplify reverse access to QTAILQ 1 month ago
memory_ldst.inc.c exec: Fix MAP_RAM for cached access 7 months ago
memory_mapping.c qemu/queue.h: simplify reverse access to QTAILQ 1 month ago
module-common.c all: Clean up includes 3 years ago
monitor.c qmp: Deprecate query-events in favor of query-qmp-schema 1 day ago
numa.c numa: Fixed the memory leak of numa error message 3 weeks ago
os-posix.c util: add qemu_write_pidfile() 4 months ago
os-win32.c util: add qemu_write_pidfile() 4 months ago
qdev-monitor.c qdev-monitor: Make device options help nicer 3 months ago
qdict-test-data.txt Introduce QDict test data file 9 years ago
qemu-bridge-helper.c all: Remove unnecessary glib.h includes 2 years ago
qemu-deprecated.texi qmp: Deprecate query-events in favor of query-qmp-schema 1 day ago
qemu-doc.texi qemu-doc: Add nanoMIPS ISA information 3 weeks ago
qemu-edid.c display/edid: add edid generator to qemu. 4 months ago
qemu-ga.texi qemu-ga: Remove stray 'q' in documentation 2 years ago
qemu-img-cmds.hx qemu-img: Add -C option for convert with copy offloading 6 months ago
qemu-img.c block: bdrv_get_full_backing_filename_from_...'s ret. val. 20 hours ago
qemu-img.texi qemu-img: Add -C option for convert with copy offloading 6 months ago
qemu-io-cmds.c bdrv_query_image_info Error parameter added 1 week ago
qemu-io.c qom: Clean up error reporting in user_creatable_add_opts_foreach() 4 months ago
qemu-keymap.c ui: use enum to string helpers 5 months ago
qemu-nbd.c qemu-nbd: Deprecate qemu-nbd --partition 2 weeks ago
qemu-nbd.texi qemu-nbd: Deprecate qemu-nbd --partition 2 weeks ago
qemu-option-trace.texi qemu-option-trace: -trace enable= is a pattern, not a file 9 months ago
qemu-options-wrapper.h qemu-img: remove references to GEN_DOCS 9 months ago
qemu-options.h Clean up ill-advised or unusual header guards 2 years ago
qemu-options.hx qemu-options: Remove deprecated option -clock 5 days ago
qemu-seccomp.c seccomp: Work-around GCC 4.x bug in gnu99 mode 4 weeks ago
qemu-tech.texi cli qmp: Mark --preconfig, exit-preconfig experimental 7 months ago
qemu.nsi Use HTTPS for qemu.org and other domains 1 year ago
qemu.sasl Default to GSSAPI (Kerberos) instead of DIGEST-MD5 for SASL 1 year ago
qmp.c qapi: make query-cpu-definitions depend on specific targets 1 day ago
qtest.c char: allow specifying a GMainContext at opening time 6 days ago
replication.c replication: Introduce new APIs to do replication operation 2 years ago
replication.h block/replication: Remove protocol_name field 11 months ago
rules.mak test: replace gtester with a TAP driver 1 month ago
thunk.c thunk: assert nb_fields is valid 1 year ago
tpm.c tpm: Clean up error reporting in tpm_init_tpmdev() 4 months ago
trace-events trace: improve runstate tracing 3 weeks ago
version.rc Use HTTPS for qemu.org and other domains 1 year ago
vl.c Merge remote-tracking branch 'remotes/vivier2/tags/trivial-branch-pull-request' into staging 4 days ago
win_dump.c dump: fix Windows dump memory run mapping 4 months ago
win_dump.h dump: move Windows dump structures definitions 4 months ago

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

$ 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