qemu v11.1.0
Miroir officiel de QEMU. Veuillez consulter https://www.qemu.org/contribute/ pour savoir comment soumettre des modifications à QEMU. Les Pull Requests sont désactivées. Veuillez utiliser uniquement les tarballs de version provenant du site web de QEMU.
LISEZ-MOI QEMU
QEMU est un émulateur et virtualiseur de machine et d'espace utilisateur générique et open source.
QEMU est capable d'émuler une machine complète par logiciel sans avoir besoin de support de virtualisation matérielle. Grâce à la traduction dynamique, il atteint de très bonnes performances. QEMU peut également s'intégrer aux hyperviseurs Xen et KVM pour fournir du matériel émulé tout en permettant à l'hyperviseur de gérer le CPU. Avec le support de l'hyperviseur, QEMU peut atteindre des performances quasi natives pour les CPU. Lorsque QEMU émule directement les CPU, il est capable d'exécuter des systèmes d'exploitation conçus pour une machine (par exemple une carte ARMv7) sur une machine différente (par exemple une carte x86_64 PC).
QEMU est également capable de fournir une virtualisation d'API espace utilisateur pour les interfaces noyau Linux et BSD. Cela permet d'exécuter des binaires compilés pour une ABI d'architecture (par exemple l'ABI Linux PPC64) sur un hôte utilisant une ABI d'architecture différente (par exemple l'ABI Linux x86_64). Cela n'implique aucune émulation matérielle, simplement une émulation CPU et d'appels système.
QEMU vise à s'adapter à une variété de cas d'utilisation. Il peut être invoqué directement par les utilisateurs souhaitant un contrôle total sur son comportement et ses paramètres. Il vise également à faciliter l'intégration dans des couches de gestion de plus haut niveau, en fournissant une interface de ligne de commande stable et une API de surveillance. Il est couramment invoqué indirectement via la bibliothèque libvirt lors de l'utilisation d'applications open source telles que oVirt, OpenStack et virt-manager.
QEMU dans son ensemble est publié sous la licence publique générale GNU, version 2. Pour plus de détails sur la licence, consultez le fichier LICENSE.
Documentation
La documentation peut être trouvée en ligne à
<https://www.qemu.org/documentation/>. La documentation pour la version de développement actuelle disponible à
<https://www.qemu.org/docs/master/> est générée à partir du dossier docs/
dans l'arborescence source, et est construite par Sphinx <https://www.sphinx-doc.org/en/master/>_.
Compilation
QEMU est un logiciel multi-plateforme destiné à être compilable sur toutes les plateformes Linux modernes, OS X, Win32 (via la chaîne d'outils Mingw64) et une variété d'autres cibles UNIX. Les étapes simples pour compiler QEMU sont :
.. code-block:: shell
mkdir build cd build ../configure make
Des informations supplémentaires peuvent également être trouvées en ligne via le site web de QEMU :
<https://wiki.qemu.org/Hosts/Linux>_<https://wiki.qemu.org/Hosts/Mac>_<https://wiki.qemu.org/Hosts/W32>_
Soumettre des correctifs
Le code source de QEMU est maintenu sous le système de contrôle de version GIT.
.. code-block:: shell
git clone https://gitlab.com/qemu-project/qemu.git
Lors de la soumission de correctifs, une approche courante consiste à utiliser 'git
format-patch' et/ou 'git send-email' pour formater et envoyer le courriel à la
liste de diffusion [email protected]. Tous les correctifs soumis doivent contenir
une ligne 'Signed-off-by' de l'auteur. Les correctifs doivent suivre les
directives énoncées dans la section de style <https://www.qemu.org/docs/master/devel/style.html>_ du
Guide du développeur.
Des informations supplémentaires sur la soumission de correctifs peuvent être trouvées en ligne via le site web de QEMU :
<https://wiki.qemu.org/Contribute/SubmitAPatch>_<https://wiki.qemu.org/Contribute/TrivialPatches>_
Le site web de QEMU est également maintenu sous contrôle de source.
.. 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/>_
Un utilitaire 'git-publish' a été créé pour rendre ce processus moins fastidieux, et est fortement recommandé pour faire des contributions régulières, ou même simplement pour envoyer des révisions consécutives de séries de correctifs. Il nécessite également une configuration fonctionnelle de 'git send-email', et par défaut n'automatise pas tout, donc vous voudrez peut-être suivre les étapes ci-dessus manuellement une fois.
Pour les instructions d'installation, veuillez vous rendre sur :
<https://github.com/stefanha/git-publish>_
Le flux de travail avec 'git-publish' est :
.. code-block:: shell
$ git checkout master -b my-feature $ # travaillez sur de nouveaux commits, ajoutez vos lignes 'Signed-off-by' à chacun $ git publish
Votre série de correctifs sera envoyée et étiquetée comme my-feature-v1 si vous avez besoin de vous y référer à l'avenir.
Envoi de v2 :
.. code-block:: shell
$ git checkout my-feature # même branche de sujet $ # apportez des modifications aux commits (en utilisant 'git rebase', par exemple) $ git publish
Votre série de correctifs sera envoyée avec le tag 'v2' dans le sujet et la pointe git sera étiquetée comme my-feature-v2.
Signalement de bogues
Le projet QEMU utilise les issues GitLab pour suivre les bogues. Les bogues trouvés lors de l'exécution de code compilé à partir de QEMU git ou de sources publiées en amont doivent être signalés via :
<https://gitlab.com/qemu-project/qemu/-/issues>_
Si vous utilisez QEMU via un paquet binaire pré-construit d'un fournisseur de système d'exploitation, il est préférable de signaler d'abord les bogues au traqueur de bogues du fournisseur. Si le bogue est également connu pour affecter le code amont le plus récent, il peut également être signalé via GitLab.
Pour plus d'informations sur le signalement de bogues, consultez :
<https://wiki.qemu.org/Contribute/ReportABug>_
Journal des modifications
Pour l'historique des versions et les notes de version, veuillez visiter
<https://wiki.qemu.org/ChangeLog/>_ ou consulter l'historique git pour plus
d'informations détaillées.
Contact
La communauté QEMU peut être contactée de plusieurs manières, les deux principales méthodes étant le courriel et l'IRC :
<mailto:[email protected]>_<https://lists.nongnu.org/mailman/listinfo/qemu-devel>_- #qemu on irc.oftc.net
Des informations sur d'autres méthodes pour contacter la communauté peuvent être trouvées en ligne via le site web de QEMU :
<https://wiki.qemu.org/Contribute/StartHere>_