QEMU With E2K User Support
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.
 
 
 
 
 
 
Denis Drakhnia a40cc41db5 e2k: Move TCG translation parts into single file. 11 months ago
.github .github: point Repo Lockdown bot to GitLab repo 12 months ago
.gitlab-ci.d gitlab-ci: Add alpine to pipeline 1 year ago
accel replay: fix replay of the interrupts 12 months ago
audio audio: space prohibited between function name and parenthesis'(' 1 year ago
authz authz-simple: Check that 'identity' property is set 1 year ago
backends memory: alloc RAM from file at offset 12 months ago
block block: rename and alter bdrv_all_find_snapshot semantics 12 months ago
bsd-user accel: replace struct CpusAccel with AccelOpsClass 12 months ago
capstone@f8b1b83301 capstone: Update to upstream "next" branch 1 year ago
chardev chardev: check if the chardev is registered for yanking 12 months ago
contrib vhost-user-gpu: handle display-info in a callback 12 months ago
crypto crypto: Add spaces around operator 1 year ago
default-configs e2k: remove unnecessary e2k32 directory 11 months ago
disas disas: e2k: Fix alf print. 12 months ago
docs docs: fix Parallels Image "dirty bitmap" section 12 months ago
dtc@85e5d83984 Makefile: dtc: update, build the libfdt target 2 years ago
dump qapi: More complex uses of QAPI_LIST_APPEND 1 year ago
fpu fpu: assuming e2k fp behave like x86 12 months ago
fsdev meson: Declare have_virtfs_proxy_helper in main meson.build 1 year ago
gdb-xml target/riscv: Remove built-in GDB XML files for CSRs 1 year ago
hw hw/block/nvme: fix error handling in nvme_ns_realize 12 months ago
include tcg: Increase max temps limit. 12 months ago
io io: add qio_channel_readv_full_all_eof & qio_channel_readv_full_all helpers 12 months ago
libdecnumber qemu/: fix some comment spelling errors 1 year ago
linux-headers Update linux headers to 5.11-rc2 1 year ago
linux-user e2k: Use one large array for registers. 11 months ago
meson@776acd2a80 submodules: bump meson to 0.55.3 1 year ago
migration migration: only check page size match if RAM postcopy is enabled 12 months ago
monitor migration: introduce a delete_snapshot wrapper 12 months ago
nbd nbd/server: Quiesce coroutines on context switch 1 year ago
net Trivial patches 20210129 1 year ago
pc-bios pc-bios: update mirror URLs to GitLab 12 months ago
plugins cfi: Initial support for cfi-icall in QEMU 1 year ago
po configure: move gettext detection to meson.build 1 year ago
python python: add __repr__ to ConsoleSocket to aid debugging 1 year ago
qapi * Fuzzing improvements (Qiuhao, Alexander) 12 months ago
qga qapi: More complex uses of QAPI_LIST_APPEND 1 year ago
qobject qobject: braces {} are necessary for all arms of this statement 12 months ago
qom qom: Allow optional sugar props 12 months ago
replay migration: wire up support for snapshot device selection 12 months ago
roms qboot: update to latest upstream 1 year ago
scripts e2k: Update qemu-binfmt-conf.sh script. 11 months ago
scsi qapi: Use QAPI_LIST_APPEND in trivial cases 1 year ago
slirp@8f43a99191 slirp: update to fix CVE-2020-29129 CVE-2020-29130 1 year ago
softmmu softmmu: add e2k definition 12 months ago
storage-daemon block: move blk_exp_close_all() to qemu_cleanup() 12 months ago
stubs qapi/meson: Restrict qdev code to system-mode emulation 12 months ago
subprojects/libvhost-user build-sys: add libvhost-user missing dependencies 1 year ago
target e2k: Move TCG translation parts into single file. 11 months ago
tcg tcg/tci: Remove TCG_CONST 12 months ago
tests tests: tcg: add basic tests for e2k 12 months ago
tools virtiofsd: Add restart_syscall to the seccomp whitelist 12 months ago
trace trace: add meson custom_target() depend_files for tracetool 12 months ago
ui display/ui: add a callback to indicate GL state is flushed 12 months ago
util memory: alloc RAM from file at offset 12 months ago
.cirrus.yml cirrus/msys2: Cache msys2 mingw in a better way. 1 year ago
.dir-locals.el Add .dir-locals.el file to configure emacs coding style 6 years ago
.editorconfig meson: rename included C source files to .c.inc 1 year ago
.exrc qemu: add .exrc 10 years ago
.gdbinit .gdbinit: load QEMU sub-commands when gdb starts 5 years ago
.gitattributes buildsys: Help git-diff adding .gitattributes config file 1 year ago
.gitignore Makefile: add GNU global tags support 1 year ago
.gitlab-ci.yml gitlab-ci: remove redundant GitLab repo URL command 12 months ago
.gitmodules gitmodules: use GitLab repos instead of qemu.org 12 months ago
.gitpublish Add a git-publish configuration file 4 years ago
.mailmap MAINTAINERS: chenhc@lemote.com -> chenhuacai@kernel.org 1 year ago
.patchew.yml ci: store Patchew configuration in the tree 3 years ago
.readthedocs.yml readthedocs: build with Python 3.6 1 year ago
.shippable.yml shippable.yml: Remove jobs duplicated on Gitlab-CI 1 year ago
.travis.yml gitlab: migrate the minimal tools and unit tests from Travis 1 year ago
CODING_STYLE.rst CODING_STYLE.rst: Be less strict about 80 character limit 1 year ago
COPYING COPYING: update from FSF 13 years ago
COPYING.LIB COPYING.LIB: Synchronize the LGPL 2.1 with the version from gnu.org 3 years ago
Kconfig Makefile: simplify MINIKCONF rules 2 years ago
Kconfig.host multi-process: Add config option for multi-process QEMU 12 months ago
LICENSE tcg/LICENSE: Remove out of date claim about TCG subdirectory licensing 2 years ago
MAINTAINERS multi-process: create IOHUB object to handle irq 12 months ago
Makefile tests/docker: alias docker-help target for consistency 12 months ago
README.rst docs: update README to use GitLab repo URLs 12 months ago
VERSION Open 6.0 development tree 1 year ago
block.c block: move blk_exp_close_all() to qemu_cleanup() 12 months ago
blockdev-nbd.c nbd: Update qapi to support exporting multiple bitmaps 1 year ago
blockdev.c qapi: Use QAPI_LIST_APPEND in trivial cases 1 year ago
blockjob.c blockjob: add set_speed to BlockJobDriver 1 year ago
configure multi-process: Add config option for multi-process QEMU 12 months ago
cpu.c accel/tcg: split TCG-only code from cpu_exec_realizefn 12 months ago
cpus-common.c overall/alpha tcg cpus|hppa: Fix Lesser GPL version number 1 year ago
disas.c disas: import disassmebler from binutils 12 months ago
exec-vary.c nomaintainer: Fix Lesser GPL version number 1 year ago
gdbstub.c e2k: Move TCG translation parts into single file. 11 months ago
gitdm.config contrib: gitdm: add a mapping for Janus Technologies 3 years ago
hmp-commands-info.hx replay: introduce info hmp/qmp command 1 year ago
hmp-commands.hx hmp: remove "change vnc TARGET" command 1 year ago
iothread.c multi-process: define MPQemuMsg format and transmission functions 12 months ago
job-qmp.c qapi: Use QAPI_LIST_APPEND in trivial cases 1 year ago
job.c job: call job_enter from job_pause 1 year ago
memory_ldst.c.inc fuzz: ignore address_space_map is_write flag 12 months ago
meson.build disas: import disassmebler from binutils 12 months ago
meson_options.txt configure: Improve TCI feature description 12 months ago
module-common.c all: Clean up includes 6 years ago
os-posix.c os: deprecate the -enable-fips option and QEMU's FIPS enforcement 1 year ago
os-win32.c vl: relocate paths to data directories 1 year ago
qemu-bridge-helper.c qemu-bridge-helper: relocate path to default ACL 1 year ago
qemu-edid.c qemu-edid: drop cast 1 year ago
qemu-img-cmds.hx qemu-img: add support for rate limit in qemu-img convert 1 year ago
qemu-img.c qapi: Use QAPI_LIST_APPEND in trivial cases 1 year ago
qemu-io-cmds.c qemu-io: add preallocate mode parameter for truncate command 1 year ago
qemu-io.c trace: remove argument from trace_init_file 1 year ago
qemu-keymap.c Include qemu-common.h exactly where needed 3 years ago
qemu-nbd.c block: move blk_exp_close_all() to qemu_cleanup() 12 months ago
qemu-options-wrapper.h qemu-img: remove references to GEN_DOCS 4 years ago
qemu-options.h Clean up ill-advised or unusual header guards 6 years ago
qemu-options.hx machine: add missing doc for memory-backend option 12 months ago
qemu.nsi nsis: adjust for new MinGW paths 1 year ago
qemu.sasl Default to GSSAPI (Kerberos) instead of DIGEST-MD5 for SASL 5 years ago
replication.c replication: Introduce new APIs to do replication operation 5 years ago
replication.h Include qemu/module.h where needed, drop it from qemu-common.h 3 years ago
thunk.c overall usermode...: Fix Lesser GPL version number 1 year ago
trace-events trace-events: Fix attribution of trace points to source 1 year ago
version.rc configure: remove CONFIG_FILEVERSION and CONFIG_PRODUCTVERSION 1 year 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://gitlab.com/qemu-project/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://gitlab.com/qemu-project/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>`_


ChangeLog
=========

For version history and release notes, please visit
`<https://wiki.qemu.org/ChangeLog/>`_ or look at the git history for
more detailed information.


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>`_