=========== QEMU README

QEMU ist ein generischer und quelloffener Maschinen- und Userspace-Emulator sowie Virtualisierer.

QEMU ist in der Lage, eine vollständige Maschine softwaremäßig zu emulieren, ohne dass Hardware-Virtualisierungsunterstützung erforderlich ist. Durch dynamische Übersetzung wird eine sehr gute Leistung erzielt. QEMU kann auch mit den Xen- und KVM-Hypervisoren integriert werden, um emulierte Hardware bereitzustellen, während der Hypervisor die CPU verwalten kann. Mit Hypervisor-Unterstützung kann QEMU eine nahezu native Leistung für CPUs erreichen. Wenn QEMU CPUs direkt emuliert, kann es Betriebssysteme ausführen, die für eine Maschine (z. B. ein ARMv7-Board) entwickelt wurden, auf einer anderen Maschine (z. B. einem x86_64-PC-Board).

QEMU ist auch in der Lage, Userspace-API-Virtualisierung für Linux- und BSD-Kernel-Schnittstellen bereitzustellen. Dies ermöglicht es, Binärdateien, die gegen eine Architektur-ABI (z. B. die Linux PPC64 ABI) kompiliert wurden, auf einem Host mit einer anderen Architektur-ABI (z. B. der Linux x86_64 ABI) auszuführen. Dies beinhaltet keine Hardware-Emulation, sondern lediglich CPU- und Syscall-Emulation.

QEMU zielt darauf ab, in eine Vielzahl von Anwendungsfällen zu passen. Es kann direkt von Benutzern aufgerufen werden, die die volle Kontrolle über sein Verhalten und seine Einstellungen wünschen. Es zielt auch darauf ab, die Integration in übergeordnete Verwaltungsebenen zu erleichtern, indem es eine stabile Befehlszeilenschnittstelle und Monitor-API bereitstellt. Es wird häufig indirekt über die libvirt-Bibliothek aufgerufen, wenn Open-Source-Anwendungen wie oVirt, OpenStack und virt-manager verwendet werden.

QEMU als Ganzes wird unter der GNU General Public License, Version 2, veröffentlicht. Für vollständige Lizenzdetails konsultieren Sie die LICENSE-Datei.

Dokumentation

Die Dokumentation ist online unter <https://www.qemu.org/documentation/>_ zu finden. Die Dokumentation für die aktuelle Entwicklungsversion, die unter <https://www.qemu.org/docs/master/>_ verfügbar ist, wird aus dem Ordner docs/ im Quellbaum generiert und mit Sphinx <https://www.sphinx-doc.org/en/master/>_ erstellt.

Bauen

QEMU ist eine plattformübergreifende Software, die auf allen modernen Linux-Plattformen, OS-X, Win32 (über die Mingw64-Toolchain) und einer Vielzahl anderer UNIX-Ziele erstellbar sein soll. Die einfachen Schritte zum Bauen von QEMU sind:

.. code-block:: shell

mkdir build cd build ../configure make

Weitere Informationen finden Sie auch online auf der QEMU-Website:

• <https://wiki.qemu.org/Hosts/Linux>_
• <https://wiki.qemu.org/Hosts/Mac>_
• <https://wiki.qemu.org/Hosts/W32>_

Patches einreichen

Der QEMU-Quellcode wird unter dem GIT-Versionskontrollsystem verwaltet.

.. code-block:: shell

git clone https://gitlab.com/qemu-project/qemu.git

Beim Einreichen von Patches ist ein üblicher Ansatz, 'git format-patch' und/oder 'git send-email' zu verwenden, um die E-Mail zu formatieren und an die Mailingliste [email protected] zu senden. Alle eingereichten Patches müssen eine 'Signed-off-by'-Zeile des Autors enthalten. Patches sollten den Richtlinien folgen, die im Style-Abschnitt <https://www.qemu.org/docs/master/devel/style.html>_ des Entwicklerhandbuchs festgelegt sind.

Weitere Informationen zum Einreichen von Patches finden Sie online auf der QEMU-Website:

• <https://wiki.qemu.org/Contribute/SubmitAPatch>_
• <https://wiki.qemu.org/Contribute/TrivialPatches>_

Die QEMU-Website wird ebenfalls unter Quellcodeverwaltung betrieben.

.. 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/>_

Ein 'git-publish'-Dienstprogramm wurde erstellt, um den obigen Prozess weniger umständlich zu gestalten, und wird für regelmäßige Beiträge oder auch nur für das Senden aufeinanderfolgender Patch-Serien-Revisionen sehr empfohlen. Es erfordert auch eine funktionierende 'git send-email'-Einrichtung und automatisiert standardmäßig nicht alles, daher möchten Sie die obigen Schritte möglicherweise einmal manuell durchgehen.

Für Installationsanweisungen besuchen Sie bitte:

• <https://github.com/stefanha/git-publish>_

Der Arbeitsablauf mit 'git-publish' ist:

.. code-block:: shell

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

Ihre Patch-Serie wird gesendet und als my-feature-v1 getaggt, falls Sie später darauf zurückverweisen müssen.

Senden von v2:

.. code-block:: shell

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

Ihre Patch-Serie wird mit dem Tag 'v2' im Betreff gesendet und der Git-Tip wird als my-feature-v2 getaggt.

Fehlerberichterstattung

Das QEMU-Projekt verwendet GitLab Issues, um Fehler zu verfolgen. Fehler, die beim Ausführen von aus QEMU-Git oder veröffentlichten Upstream-Quellen erstelltem Code gefunden werden, sollten gemeldet werden über:

• <https://gitlab.com/qemu-project/qemu/-/issues>_

Wenn QEMU über ein vorgefertigtes Binärpaket eines Betriebssystemanbieters verwendet wird, ist es vorzuziehen, Fehler zuerst im eigenen Bugtracker des Anbieters zu melden. Wenn der Fehler auch bekanntermaßen den neuesten Upstream-Code betrifft, kann er auch über GitLab gemeldet werden.

Für weitere Informationen zur Fehlerberichterstattung konsultieren Sie:

• <https://wiki.qemu.org/Contribute/ReportABug>_

Änderungsprotokoll

Für Versionsgeschichte und Versionshinweise besuchen Sie bitte <https://wiki.qemu.org/ChangeLog/>_ oder sehen Sie sich die Git-Historie für detailliertere Informationen an.

Kontakt

Die QEMU-Community kann auf verschiedene Weise kontaktiert werden, wobei die beiden Hauptmethoden E-Mail und IRC sind:

• <mailto:[email protected]>_
• <https://lists.nongnu.org/mailman/listinfo/qemu-devel>_
• #qemu on irc.oftc.net

Informationen zu weiteren Kontaktmöglichkeiten zur Community finden Sie online auf der QEMU-Website:

• <https://wiki.qemu.org/Contribute/StartHere>_