qemu-system-unicore32 - En ligne dans le Cloud

PROGRAMME:

Nom

qemu-doc - Documentation utilisateur de l'émulateur QEMU

SYNOPSIS

utilisation : qemu-system-i386 [options] [image_disque]

DESCRIPTION

L'émulateur QEMU PC System simule les périphériques suivants :

- Pont PCI hôte i440FX et pont PIIX3 PCI vers ISA

- Carte PCI VGA Cirrus CLGD 5446 ou carte VGA factice avec extensions Bochs VESA (hardware
niveau, y compris tous les modes non standard).

- Souris et clavier PS/2

- 2 interfaces PCI IDE avec support disque dur et CD-ROM

- Disquette

- Cartes réseau PCI et ISA

- Ports série

- Carte son Creative SoundBlaster 16

- Carte son ENSONIQ AudioPCI ES1370

- Carte son compatible Intel 82801AA AC97 Audio

- Contrôleur audio Intel HD et codec HDA

- Adlib (OPL2) - Puce compatible Yamaha YM3812

- Carte son Gravis Ultrasound GF1

- Carte son compatible CS4231A

- Contrôleur USB PCI UHCI et un hub USB virtuel.

SMP est pris en charge avec jusqu'à 255 processeurs.

QEMU utilise le BIOS PC du projet Seabios et le BIOS VGA Plex86/Bochs LGPL.

QEMU utilise l'émulation YM3812 de Tatsuyuki Satoh.

QEMU utilise l'émulation GUS (GUSEMU32http://www.deinmeister.de/gusemu/>) par Tibor "TS"
Schutz.

Notez que, par défaut, GUS partage IRQ(7) avec des ports parallèles et donc QEMU doit être dit de
ne pas avoir de ports parallèles pour avoir un GUS fonctionnel.

qemu-system-i386 dos.img -soundhw gus -parallèle aucun

Alternativement:

qemu-system-i386 dos.img -device gus,irq=5

Ou un autre IRQ non réclamé.

CS4231A est la puce utilisée dans les produits Windows Sound System et GUSMAX

OPTIONS

image_disque est une image de disque dur brute pour le disque dur IDE 0. Certaines cibles n'ont pas besoin de disque
l'image.

Options standards :

-h Afficher l'aide et quitter

-version
Afficher les informations de version et quitter

-machine [tapez=]prénom[,prop=Plus-value[,...]]
Sélectionnez la machine émulée en prénom. Utilisez "-machine help" pour lister les machines disponibles.
Les propriétés de machine prises en charge sont :

accélérer=accel1[:accel2[:...]]
Ceci est utilisé pour activer un accélérateur. Selon l'architecture cible, kvm,
xen ou tcg peuvent être disponibles. Par défaut, tcg est utilisé. S'il y a plus d'un
accélérateur spécifié, le suivant est utilisé si le précédent ne parvient pas à
initialiser.

kernel_irqchip=activé|désactivé
Active la prise en charge d'irqchip dans le noyau pour l'accélérateur choisi lorsqu'il est disponible.

gfx_passthru = activé | désactivé
Active la prise en charge du passthrough IGD GFX pour la machine choisie lorsqu'elle est disponible.

vmport=on|off|auto
Active l'émulation du port VMWare IO, pour vmmouse etc. auto dit de sélectionner le
valeur basée sur l'accélération. Pour accel=xen, la valeur par défaut est désactivée, sinon la valeur par défaut est
sur.

kvm_shadow_mem=taille
Définit la taille du shadow MMU KVM.

dump-guest-core=on|off
Incluez la mémoire d'invité dans un vidage de mémoire. La valeur par défaut est activée.

mem-merge = activé | désactivé
Active ou désactive la prise en charge de la fusion de mémoire. Cette fonctionnalité, lorsqu'elle est prise en charge par le
hôte, déduplique les pages de mémoire identiques parmi les instances de VM (activé par
défaut).

iommu = activé | désactivé
Active ou désactive la prise en charge d'Intel IOMMU (VT-d) émulé. La valeur par défaut est désactivée.

aes-key-wrap=on|off
Active ou désactive la prise en charge du wrapping de clé AES sur les hôtes s390-ccw. Cette fonctionnalité
contrôle si les clés d'encapsulation AES seront créées pour permettre l'exécution d'AES
fonctions cryptographiques. La valeur par défaut est activée.

dea-key-wrap=on|off
Active ou désactive la prise en charge du wrapping de clé DEA sur les hôtes s390-ccw. Cette fonctionnalité
contrôle si les clés d'encapsulation DEA seront créées pour permettre l'exécution de DEA
fonctions cryptographiques. La valeur par défaut est activée.

-CPU modèle
Sélectionnez le modèle de processeur ("-cpu help" pour la liste et la sélection de fonctionnalités supplémentaires)

-smp [processeur=]n[,cœurs=couleurs][,fils=discussions][,prises=sockets][,maxcpus=CPU max]
Simulez un système SMP avec n CPU. Sur la cible PC, jusqu'à 255 processeurs sont pris en charge. Au
Cible Sparc32, Linux limite le nombre de CPU utilisables à 4. Pour la cible PC, le
nombre de couleurs par prise, le nombre de discussions par cœurs et le nombre total de
sockets peut être spécifié. Les valeurs manquantes seront calculées. Le cas échéant sur les trois valeurs
est donné, le nombre total de CPU n peut être omis. CPU max spécifie le maximum
nombre de processeurs enfichables à chaud.

-numa nœud[,mem=Taille][,processeur=processeur[-processeur]][,id_noeud=nœud]
-numa nœud[,memdev=id][,processeur=processeur[-processeur]][,id_noeud=nœud]
Simulez un système NUMA multi-nœuds. Si Membre, memdev et cpus sont omis, les ressources sont
diviser à parts égales. Notez également que le -Numa l'option n'alloue aucun des éléments spécifiés
Ressources. C'est-à-dire qu'il attribue simplement les ressources existantes aux nœuds NUMA. Cela signifie que
il faut encore utiliser le -m, -smp des options pour allouer respectivement de la RAM et des VCPU, et
peut-être -objet pour spécifier le backend de la mémoire pour le memdev sous-option.

Membre et memdev sont mutuellement exclusifs. De plus, si un nœud utilise memdev, tous
ils doivent l'utiliser.

-ajouter-fd fd=fd,set=set[,opaque=opaque]
Ajoutez un descripteur de fichier à un ensemble fd. Les options valides sont :

fd=fd
Cette option définit le descripteur de fichier dont un doublon est ajouté à fd set.
Le descripteur de fichier ne peut pas être stdin, stdout ou stderr.

set =set
Cette option définit l'ID de l'ensemble fd auquel ajouter le descripteur de fichier.

opaque=opaque
Cette option définit une chaîne de forme libre qui peut être utilisée pour décrire fd.

Vous pouvez ouvrir une image à l'aide de descripteurs de fichiers pré-ouverts à partir d'un ensemble fd :

système-qemu-i386
-add-fd fd=3,set=2,opaque="rdwr:/chemin/vers/fichier"
-add-fd fd=4,set=2,opaque="rdonly:/path/to/file"
-fichier lecteur=/dev/fdset/2,index=0,media=disque

-ensemble groupe.id.arg=Plus-value
Définir le paramètre arg pour l'article id De type groupe "

-mondial driver.soutenir=Plus-value
-mondial pilote =driver,propriété=propriété,valeur=Plus-value
Définir la valeur par défaut de driverla propriété de soutenir à Plus-value, par exemple:

qemu-system-i386 -global ide-drive.physical_block_size=4096 -drive file=file,if=ide,index=0,media=disk

En particulier, vous pouvez l'utiliser pour définir les propriétés du pilote pour les périphériques qui sont créés
automatiquement par le modèle de la machine. Pour créer un appareil qui n'est pas créé
automatiquement et définissez des propriétés dessus, utilisez -dispositif.

-mondial driver.soutenir=Plus-value est un raccourci pour -global
pilote =driver,propriété=soutenir,valeur=Plus-value. La syntaxe manuscrite fonctionne même lorsque driver
contient un point.

-démarrage
[commande=les lecteurs][,une fois=les lecteurs][,menu=on|off][,splash=nom_sp][,splash-time=sp_time][,délai de redémarrage=rb_timeout][,strict=on|off]
Spécifier l'ordre de démarrage les lecteurs comme une chaîne de lettres de lecteur. Les lettres de lecteur valides dépendent de
l'architecture cible. Le PC x86 utilise : a, b (disquettes 1 et 2), c (premier disque dur),
d (premier CD-ROM), np (Etherboot à partir de la carte réseau 1-4), le démarrage du disque dur est le
défaut. Pour appliquer un ordre de démarrage particulier uniquement au premier démarrage, spécifiez-le via
une fois.

Les menus/invites de démarrage interactifs peuvent être activés via menu=activé jusqu'au firmware/BIOS
les soutient. La valeur par défaut est le démarrage non interactif.

Une image de démarrage peut être transmise au bios, permettant à l'utilisateur de l'afficher sous forme de logo, lorsque
option éclaboussure=nom_sp est donné et menu=on, si le firmware/BIOS les prend en charge. Actuellement
Le système Seabios pour X86 le prend en charge. limitation : le fichier de démarrage peut être un fichier jpeg
ou un fichier BMP au format 24 BPP (couleur vraie). La résolution doit être appuyée par le
Mode SVGA, donc le recommandé est 320x240, 640x480, 800x640.

Un délai d'attente pourrait être transmis au bios, l'invité fera une pause pendant rb_timeout ms au démarrage
a échoué, puis redémarrez. Si rb_timeout est '-1', l'invité ne redémarrera pas, qemu passe '-1' à
bios par défaut. Actuellement, le système Seabios pour X86 le prend en charge.

Faites un démarrage strict via strict=sur dans la mesure où le firmware/BIOS le prend en charge. Cela n'affecte que
lorsque la priorité de démarrage est modifiée par les options bootindex. La valeur par défaut est le démarrage non strict.

# essayez de démarrer à partir du réseau d'abord, puis à partir du disque dur
qemu-system-i386 -commande de démarrage=nc
# démarrer d'abord à partir du CD-ROM, revenir à l'ordre par défaut après le redémarrage
qemu-system-i386 -boot une fois = d
# démarrage avec une image de démarrage pendant 5 secondes.
qemu-system-i386 -boot menu=on,splash=/root/boot.bmp,splash-time=5000

Remarque : Le format hérité '-boot les lecteurs' est toujours pris en charge mais son utilisation est déconseillée
car il peut être supprimé des versions futures.

-m [taille=]Mo[,slots=n,maxmem=taille]
Définit la taille de la RAM de démarrage de l'invité sur Mo mégaoctets. La valeur par défaut est 128 Mio. En option, un
le suffixe « M » ou « G » peut être utilisé pour signifier une valeur en mégaoctets ou en gigaoctets
respectivement. Paire en option fentes, mémoire maximale pourrait être utilisé pour définir la quantité de hotplug
emplacements mémoire et quantité maximale de mémoire. Noter que mémoire maximale doit être aligné sur le
taille de la page.

Par exemple, la ligne de commande suivante définit la taille de la RAM de démarrage de l'invité sur 1 Go,
crée 3 emplacements pour brancher à chaud de la mémoire supplémentaire et définit la mémoire maximale que l'invité peut
atteindre 4 Go :

qemu-system-x86_64 -m 1G,slots=3,maxmem=4G

If fentes et mémoire maximale ne sont pas spécifiés, la connexion à chaud de la mémoire ne sera pas activée et l'invité
La RAM de démarrage n'augmentera jamais.

-mem-chemin chemin
Allouer de la RAM invitée à partir d'un fichier créé temporairement dans chemin.

-mem-préalloc
Préallouez de la mémoire lors de l'utilisation de -mem-path.

-k langue
Utiliser la disposition du clavier langue (par exemple "fr" pour le français). Cette option est seulement nécessaire
où il n'est pas facile d'obtenir des codes clés PC bruts (par exemple sur Mac, avec certains serveurs X11 ou
avec un affichage VNC). Vous n'avez normalement pas besoin de l'utiliser sur PC/Linux ou PC/Windows
hôtes

Les mises en page disponibles sont :

ar de-ch es fo fr-ca hu ja mk no pt-br sv
da en-gb et fr fr-ch is lt nl pl ru th
de en-us fi fr-be hr it lv nl-be pt sl tr

La valeur par défaut est "en-us".

-audio-aide
Affiche l'aide du sous-système audio : liste des pilotes, paramètres réglables.

-sonhw carte1[,carte2,...] or -sonhw tous
Activer l'audio et le matériel audio sélectionné. Utilisez 'help' pour imprimer tous les sons disponibles
matériel.

qemu-system-i386 -soundhw sb16, adlib disk.img
qemu-system-i386 -soundhw es1370 disque.img
qemu-system-i386 -soundhw ac97 disk.img
qemu-system-i386 -soundhw hda disk.img
Qemu-System-I386 -Soundhw All Disk.img
qemu-system-i386 -soundhw aide

Notez que le module du noyau OSS i810_audio de Linux (pour AC97) peut nécessiter manuellement
spécifiant le pointage.

horloge modprobe i810_audio=48000

-ballon aucun
Désactivez le dispositif ballon.

-ballon virtio[,adr=addr]
Activer le périphérique virtio balloon (par défaut), éventuellement avec une adresse PCI addr.

-Deva driver[,soutenir[=Plus-value][,...]]
Ajouter un appareil driver. soutenir=Plus-value définit les propriétés du pilote. Les propriétés valides dépendent du
conducteur. Pour obtenir de l'aide sur les pilotes et propriétés possibles, utilisez "-device help" et
"-dispositif chauffeur, aide".

-patate douce prénom
Définit le prénom de l'invité. Ce nom sera affiché dans la légende de la fenêtre SDL.
Votre prénom sera également utilisé pour le serveur VNC. Réglez également en option le haut visible
nom du processus sous Linux. Le nommage des threads individuels peut également être activé sur Linux pour
aide au débogage.

-uuid uuid
Définir l'UUID du système.

Bloquer les options de l'appareil :

-fda filet
-fdb filet
Utilisez filet comme image de disquette 0/1.

-hda filet
-HDB filet
-HDC filet
-hdd filet
Utilisez filet comme image de disque dur 0, 1, 2 ou 3.

-CD ROM filet
Utilisez filet comme image de CD-ROM (vous ne pouvez pas utiliser -HDC et -CD ROM à la fois). Vous pouvez
utiliser le CD-ROM hôte en utilisant / dev / cdrom comme nom de fichier.

-conduire option[,option[,option[,...]]]
Définir un nouveau lecteur. Les options valides sont :

fichier=filet
Cette option définit l'image disque à utiliser avec ce lecteur. Si le nom de fichier
contient une virgule, vous devez la doubler (par exemple, "file=my,,file" pour utiliser file
"mon fichier").

Des fichiers spéciaux tels que des périphériques iSCSI peuvent être spécifiés à l'aide d'URL spécifiques au protocole.
Consultez la section « Syntaxe de l'URL du périphérique » pour plus d'informations.

si =interface
Cette option définit sur quel type d'interface le variateur est connecté. Disponible
les types sont : ide, scsi, sd, mtd, floppy, pflash, virtio.

bus =bus,unité=unité
Ces options définissent où est connecté le variateur en définissant le numéro de bus et
l'identifiant de l'unité.

indice=indice
Cette option définit où est connecté le variateur en utilisant un index dans la liste des
connecteurs disponibles d'un type d'interface donné.

média=galerie de
Cette option définit le type de média : disque ou cdrom.

cylindres=c,têtes=h,sec=s[,trans=t]
Ces options ont la même définition que dans -hdachs.

instantané=instantané
instantané est "on" ou "off" et contrôle le mode instantané pour le lecteur donné (voir
-instantané).

cache =cachette
cachette est "none", "writeback", "unsafe", "directsync" ou "writethrough" et
contrôle la façon dont le cache de l'hôte est utilisé pour accéder aux données de bloc.

aïo=traceurs
traceurs est « threads » ou « native » et sélectionne entre les E/S disque basées sur pthread et
AIO Linux natif.

rejeter =Jeter
Jeter est l'un de "ignore" (ou "off") ou "unmap" (ou "on") et contrôle si
Jeter (aussi connu sous le nom réduire or démapper) les demandes sont ignorées ou transmises au
système de fichiers. Certains types de machines peuvent ne pas prendre en charge les demandes de suppression.

format=le format
Spécifiez quel disque le format sera utilisé plutôt que de détecter le format. Peut être
utilisé pour spécifier format=raw pour éviter d'interpréter un en-tête de format non fiable.

série=en série
Cette option spécifie le numéro de série à attribuer à l'appareil.

adresse=addr
Spécifiez l'adresse PCI du contrôleur (if=virtio uniquement).

erreur=action,rerreur=action
Précisez quel action pour prendre en charge les erreurs d'écriture et de lecture. Les actions valides sont : "ignorer"
(ignorer l'erreur et essayer de continuer), "stop" (pause QEMU), "report" (signaler le
erreur à l'invité), "enospc" (mettre en pause QEMU uniquement si le disque hôte est plein ; signaler
l'erreur à l'invité sinon). Le paramètre par défaut est erreur=enospc et
erreur=rapport.

lecture seulement
Ouvrir le lecteur filet en lecture seule. Les tentatives d'écriture d'invité échoueront.

copie-en-lecture=copie en lecture
copie en lecture est "on" ou "off" et permet de copier ou non le fichier de sauvegarde en lecture
secteurs dans le fichier image.

détecter-zéros=détecter-zéros
détecter-zéros est "off", "on" ou "unmap" et permet la conversion automatique de
plain zero écrit par le système d'exploitation sur des commandes d'écriture zéro optimisées spécifiques au pilote. Tu
peut même choisir "unmap" si Jeter est défini sur "unmap" pour permettre à une écriture nulle d'être
converti en une opération UNMAP.

Par défaut, le cache=réécriture mode est utilisé. Il signalera les écritures de données comme terminées
dès que les données sont présentes dans le cache de la page hôte. Ceci est sûr tant que votre
Le système d'exploitation invité s'assure de vider correctement les caches disque si nécessaire. Si votre système d'exploitation invité le fait
ne gère pas correctement les caches d'écriture sur disque volatile et votre hôte se bloque ou perd de l'alimentation,
alors l'invité peut subir une corruption de données.

Pour de tels invités, vous devriez envisager d'utiliser cache=écriture. Cela signifie que le
le cache de la page hôte sera utilisé pour lire et écrire les données, mais la notification d'écriture sera
envoyé à l'invité uniquement après que QEMU s'est assuré de vider chaque écriture sur le disque. Être
conscient que cela a un impact majeur sur les performances.

Le cache de la page hôte peut être entièrement évité avec cache=aucun. Cela tentera de faire
disk IO directement dans la mémoire de l'invité. QEMU peut toujours effectuer une copie interne de
les données. Notez que ceci est considéré comme un mode de réécriture et que le système d'exploitation invité doit gérer
correctement le cache d'écriture du disque afin d'éviter la corruption des données lors des plantages de l'hôte.

Le cache de la page hôte peut être évité tout en envoyant uniquement des notifications d'écriture à l'invité
lorsque les données ont été vidées sur le disque à l'aide cache=synchronisation directe.

Si vous ne vous souciez pas de l'intégrité des données en cas de défaillance de l'hôte, utilisez cache=non sécurisé. Ce
L'option indique à QEMU qu'il n'a jamais besoin d'écrire de données sur le disque mais qu'il peut à la place
garder les choses en cache. Si quelque chose ne va pas, comme votre hôte perdant de l'alimentation, le disque
stockage déconnecté accidentellement, etc. votre image sera très probablement
rendu inutilisable. Lors de l'utilisation du -instantané option, la mise en cache non sécurisée est toujours utilisée.

La copie en lecture évite d'accéder à plusieurs reprises aux mêmes secteurs de fichiers de sauvegarde et est utile
lorsque le fichier de sauvegarde est sur un réseau lent. Par défaut, la copie en lecture est désactivée.

Au lieu de -CD ROM vous pouvez utiliser:

qemu-system-i386 -drive file=file,index=2,media=cdrom

Au lieu de -hda, -HDB, -HDC, -hdd, vous pouvez utiliser:

qemu-system-i386 -drive file=file,index=0,media=disque
qemu-system-i386 -drive file=file,index=1,media=disque
qemu-system-i386 -drive file=file,index=2,media=disque
qemu-system-i386 -drive file=file,index=3,media=disque

Vous pouvez ouvrir une image à l'aide de descripteurs de fichiers pré-ouverts à partir d'un ensemble fd :

système-qemu-i386
-add-fd fd=3,set=2,opaque="rdwr:/chemin/vers/fichier"
-add-fd fd=4,set=2,opaque="rdonly:/path/to/file"
-fichier lecteur=/dev/fdset/2,index=0,media=disque

Vous pouvez connecter un CDROM à l'esclave d'ide0 :

qemu-system-i386 -drive fichier=fichier,if=ide,index=1,media=cdrom

Si vous ne spécifiez pas l'argument "file=", vous définissez un lecteur vide :

qemu-system-i386 -drive si=ide,index=1,media=cdrom

Vous pouvez connecter un disque SCSI avec l'ID d'unité 6 sur le bus #0 :

qemu-system-i386 -drive file=fichier,if=scsi,bus=0,unit=6

Au lieu de -fda, -fdb, vous pouvez utiliser:

qemu-system-i386 -drive fichier=fichier,index=0,if=disquette
qemu-system-i386 -drive fichier=fichier,index=1,if=disquette

Par défaut, interface est "ide" et indice est automatiquement incrémenté :

qemu-system-i386 -drive file=a -drive file=b"

est interprété comme :

qemu-system-i386 -hda a -hdb b

-mtdblock filet
Utilisez filet comme image de mémoire Flash embarquée.

-Dakota du Sud filet
Utilisez filet comme image de carte SecureDigital.

-pflash filet
Utilisez filet comme une image flash parallèle.

-instantané
Écrivez dans des fichiers temporaires au lieu de fichiers d'image disque. Dans ce cas, l'image disque brute
vous utilisez n'est pas réécrit. Vous pouvez cependant forcer la réécriture en appuyant sur Californie s.

-hdachs c,h,s,[,t]
Forcer la géométrie physique du disque dur 0 (1 <= c <= 16383, 1 <= h <= 16, 1 <= s <= 63) et
forcer éventuellement le mode de traduction du BIOS (t= aucun, lba ou auto). Habituellement, l'UEMQ peut
devinez tous ces paramètres. Cette option est utile pour les anciennes images disque MS-DOS.

-fsdev
pilote fs,identifiant=id,chemin=chemin,[modèle_sécurité=modèle_de_sécurité][,écriture=rédiger][,lecture seule][,socket=douille|chaussette_fd=chaussette_fd]
Définissez un nouveau périphérique de système de fichiers. Les options valides sont :

pilote fs
Cette option spécifie le backend du pilote fs à utiliser. Actuellement "local", "handle"
et les pilotes de système de fichiers "proxy" sont pris en charge.

id =id
Spécifie l'identifiant de cet appareil

chemin =chemin
Spécifie le chemin d'exportation pour le périphérique du système de fichiers. Les fichiers sous ce chemin seront
être disponible pour le client 9p sur l'invité.

modèle_sécurité=modèle_de_sécurité
Spécifie le modèle de sécurité à utiliser pour ce chemin d'exportation. Sécurité prise en charge
les modèles sont "passthrough", "mapped-xattr", "mapped-file" et "none". Dans
modèle de sécurité "passthrough", les fichiers sont stockés en utilisant les mêmes informations d'identification qu'ils
sont créés sur l'invité. Cela nécessite que QEMU s'exécute en tant que root. Dans "mapped-xattr"
modèle de sécurité, certains des attributs de fichier comme uid, gid, mode bits et link
target sont stockés en tant qu'attributs de fichier. Pour "mapped-file", ces attributs sont
stocké dans le répertoire caché .virtfs_metadata. Répertoires exportés par ce
le modèle de sécurité ne peut pas interagir avec d'autres outils Unix. le modèle de sécurité "aucun" est
Identique au passthrough, sauf que le serveur ne signalera pas les échecs s'il ne parvient pas à définir le fichier
attributs comme la propriété. Le modèle de sécurité est obligatoire uniquement pour le pilote fs local.
Les autres pilotes fs (comme le handle, le proxy) ne prennent pas le modèle de sécurité comme paramètre.

écriture =rédiger
Il s'agit d'un argument facultatif. La seule valeur prise en charge est "immédiate". Ça signifie
ce cache de page hôte sera utilisé pour lire et écrire des données mais écrire une notification
ne sera envoyé au client que lorsque les données ont été signalées comme écrites par le
sous-système de stockage.

lecture seulement
Permet d'exporter le partage 9p en tant que montage en lecture seule pour les invités. Par défaut lecture-écriture
l'accès est donné.

prise=douille
Permet au pilote du système de fichiers proxy d'utiliser le fichier socket transmis pour communiquer avec
virtfs-proxy-helper

chaussette_fd=chaussette_fd
Permet au pilote du système de fichiers proxy d'utiliser le descripteur de socket passé pour communiquer
avec virtfs-proxy-helper. Habituellement, un assistant comme libvirt créera une paire de sockets et
passer l'un des fds comme sock_fd

L'option -fsdev est utilisée avec le pilote -device "virtio-9p-pci".

-Deva virtio-9p-pci,fsdev=id,balise_montage=balise_montage
Les options du pilote virtio-9p-pci sont :

fsdev=id
Spécifie la valeur d'ID spécifiée avec l'option -fsdev

balise_montage=balise_montage
Spécifie le nom de balise à utiliser par l'invité pour monter ce point d'exportation

-virtfs
pilote fs[,chemin=chemin],balise_montage=balise_montage[, security_model=modèle_de_sécurité][,écriture=rédiger][,lecture seule][,socket=douille|chaussette_fd=chaussette_fd]
La forme générale des options d'intercommunication du système de fichiers virtuels est :

pilote fs
Cette option spécifie le backend du pilote fs à utiliser. Actuellement "local", "handle"
et les pilotes de système de fichiers "proxy" sont pris en charge.

id =id
Spécifie l'identifiant de cet appareil

chemin =chemin
Spécifie le chemin d'exportation pour le périphérique du système de fichiers. Les fichiers sous ce chemin seront
être disponible pour le client 9p sur l'invité.

modèle_sécurité=modèle_de_sécurité
Spécifie le modèle de sécurité à utiliser pour ce chemin d'exportation. Sécurité prise en charge
les modèles sont "passthrough", "mapped-xattr", "mapped-file" et "none". Dans
modèle de sécurité "passthrough", les fichiers sont stockés en utilisant les mêmes informations d'identification qu'ils
sont créés sur l'invité. Cela nécessite que QEMU s'exécute en tant que root. Dans "mapped-xattr"
modèle de sécurité, certains des attributs de fichier comme uid, gid, mode bits et link
target sont stockés en tant qu'attributs de fichier. Pour "mapped-file", ces attributs sont
stocké dans le répertoire caché .virtfs_metadata. Répertoires exportés par ce
le modèle de sécurité ne peut pas interagir avec d'autres outils Unix. le modèle de sécurité "aucun" est
Identique au passthrough, sauf que le serveur ne signalera pas les échecs s'il ne parvient pas à définir le fichier
attributs comme la propriété. Le modèle de sécurité est obligatoire uniquement pour le pilote fs local.
Les autres pilotes fs (comme le handle, le proxy) ne prennent pas le modèle de sécurité comme paramètre.

écriture =rédiger
Il s'agit d'un argument facultatif. La seule valeur prise en charge est "immédiate". Ça signifie
ce cache de page hôte sera utilisé pour lire et écrire des données mais écrire une notification
ne sera envoyé au client que lorsque les données ont été signalées comme écrites par le
sous-système de stockage.

lecture seulement
Permet d'exporter le partage 9p en tant que montage en lecture seule pour les invités. Par défaut lecture-écriture
l'accès est donné.

prise=douille
Permet au pilote du système de fichiers proxy d'utiliser le fichier socket transmis pour communiquer avec
virtfs-proxy-helper. Habituellement, un assistant comme libvirt créera une paire de sockets et passera
l'un des fds comme sock_fd

chaussette_fd
Permet au pilote du système de fichiers proxy d'utiliser 'sock_fd' passé comme descripteur de socket
pour l'interfaçage avec virtfs-proxy-helper

-virtfs_synth
Créer une image de système de fichiers synthétique

Options USB :

-USB
Activer le pilote USB (sera bientôt par défaut)

-périphérique USB nom dev
Ajouter le périphérique USB nom dev.

souris
Souris virtuelle. Cela remplacera l'émulation de souris PS/2 lorsqu'il est activé.

tablettes
Dispositif de pointage qui utilise des coordonnées absolues (comme un écran tactile). Ça signifie
QEMU est capable de signaler la position de la souris sans avoir à saisir la souris. Aussi
remplace l'émulation de souris PS/2 lorsqu'il est activé.

disque :[format=le format]:filet
Périphérique de stockage de masse basé sur un fichier. L'optionnel le format l'argument sera utilisé
plutôt que de détecter le format. Peut être utilisé pour spécifier "format=raw" pour éviter
interpréter un en-tête de format non fiable.

hôte:bus.addr
Passer par le périphérique hôte identifié par bus.addr (Linux uniquement).

hôte:fournisseur ID:ID_produit
Passer par le périphérique hôte identifié par fournisseur ID:ID_produit (Linux uniquement).

série:[vendorid=fournisseur ID][,identifiant du produit=ID_produit]:dev
Convertisseur série en périphérique de caractère hôte dev, voir "-serial" pour les
dispositifs.

braille
Appareil braille. Cela utilisera BrlAPI pour afficher la sortie braille sur un vrai ou
faux appareil.

net:Options
Carte réseau prenant en charge les protocoles Ethernet CDC et RNDIS.

Option d'affichage:

-afficher type
Sélectionnez le type d'affichage à utiliser. Cette option remplace l'ancien style
-sdl/-curses/... options. Valeurs valides pour type

sdl Afficher la sortie vidéo via SDL (généralement dans une fenêtre graphique séparée ; voir le SDL
documentation pour d'autres possibilités).

les courses
Afficher la sortie vidéo via des malédictions. Pour les modèles de périphériques graphiques qui prennent en charge un texte
mode, QEMU peut afficher cette sortie en utilisant une interface curses/ncurses. Rien n'est
affiché lorsque le périphérique graphique est en mode graphique ou si le périphérique graphique
ne prend pas en charge le mode texte. Généralement, seuls les modèles d'appareils VGA prennent en charge le texte
mode.

aucun
Ne pas afficher la sortie vidéo. L'invité verra toujours une carte graphique émulée,
mais sa sortie ne sera pas affichée pour l'utilisateur QEMU. Cette option diffère de
l'option -nographic en ce qu'elle n'affecte que ce qui est fait avec la sortie vidéo ;
-nographic modifie également la destination des données des ports série et parallèle.

gtk Afficher la sortie vidéo dans une fenêtre GTK. Cette interface propose des menus déroulants et
d'autres éléments d'interface utilisateur pour configurer et contrôler la machine virtuelle pendant l'exécution.

vnc Démarrer un serveur VNC à l'écran

-nographique
Normalement, QEMU utilise SDL pour afficher la sortie VGA. Avec cette option, vous pouvez totalement
désactiver la sortie graphique afin que QEMU soit une simple application en ligne de commande. Les
le port série émulé est redirigé sur la console et multiplexé avec le moniteur (sauf si
redirigé ailleurs explicitement). Par conséquent, vous pouvez toujours utiliser QEMU pour déboguer un Linux
noyau avec une console série. Utilisation Californie h pour obtenir de l'aide sur la commutation entre la console et
moniteur.

-malédictions
Normalement, QEMU utilise SDL pour afficher la sortie VGA. Avec cette option, QEMU peut afficher
la sortie VGA en mode texte à l'aide d'une interface curses/ncurses. Rien n'est
affiché en mode graphique.

-pas de cadre
N'utilisez pas de décorations pour les fenêtres SDL et démarrez-les en utilisant tout l'écran disponible
espacer. Cela rend l'utilisation de QEMU dans un espace de travail de bureau dédié plus pratique.

-alt-saisir
Utilisez Ctrl-Alt-Shift pour saisir la souris (au lieu de Ctrl-Alt). Notez que cela affecte également
les touches spéciales (pour le plein écran, le changement de mode moniteur, etc.).

-ctrl-saisir
Utilisez Right-Ctrl pour saisir la souris (au lieu de Ctrl-Alt). Notez que cela affecte également le
touches spéciales (pour le plein écran, le changement de mode moniteur, etc.).

-no-quitter
Désactivez la fonction de fermeture de fenêtre SDL.

-sdl
Activez SDL.

-pimenter option[,option[,...]]
Activez le protocole de bureau à distance Spice. Les options valides sont

port=
Définissez le port TCP sur lequel l'épice est à l'écoute pour les canaux en texte clair.

adresse=
Définissez l'adresse IP sur laquelle Spice écoute. La valeur par défaut est n'importe quelle adresse.

ipv4
ipv6
unix
Forcer l'utilisation de la version IP spécifiée.

mot de passe=
Définissez le mot de passe dont vous avez besoin pour vous authentifier.

SASL
Exiger que le client utilise SASL pour s'authentifier avec l'épice. Le choix exact
de la méthode d'authentification utilisée est contrôlée à partir de la SASL du système/utilisateur
fichier de configuration du service 'qemu'. Cela se trouve généralement dans
/etc/sasl2/qemu.conf. Si vous exécutez QEMU en tant qu'utilisateur non privilégié, un environnement
la variable SASL_CONF_PATH peut être utilisée pour lui faire rechercher des emplacements alternatifs pour le
configuration des services. Alors que certaines méthodes d'authentification SASL peuvent également fournir un cryptage des données (par ex.
GSSAPI), il est recommandé de toujours combiner SASL avec les 'tls' et 'x509'
paramètres pour permettre l'utilisation de SSL et de certificats de serveur. Cela garantit une donnée
cryptage empêchant la compromission des informations d'authentification.

désactiver-billetterie
Autoriser les clients à se connecter sans authentification.

désactiver-copier-coller
Désactivez le copier-coller entre le client et l'invité.

désactiver-agent-file-xfer
Désactivez le fichier-xfer basé sur spice-vdagent entre le client et l'invité.

tls-port=
Définissez le port TCP sur lequel l'épice écoute les canaux cryptés.

x509-dir=
Définissez le répertoire de fichiers x509. Attend les mêmes noms de fichiers que -vnc $display,x509=$dir

x509-key-file=
x509-key-password=
x509-cert-file=
x509-cacert-fichier=
x509-dh-key-file=
Les noms de fichiers x509 peuvent également être configurés individuellement.

tls-ciphers=
Spécifiez les chiffrements à utiliser.

tls-channel=[principal|affichage|curseur|entrées|enregistrement|lecture]
plaintext-channel=[principal|affichage|curseur|entrées|enregistrement|lecture]
Forcer l'utilisation d'un canal spécifique avec ou sans cryptage TLS. Les options peuvent
être spécifié plusieurs fois pour configurer plusieurs canaux. Le nom spécial
"default" peut être utilisé pour définir le mode par défaut. Pour les chaînes qui ne sont pas
explicitement forcé dans un mode, le client spice est autorisé à choisir tls/plaintext
comme il lui plaît.

image-compression=[auto_glz|auto_lz|quic|glz|lz|off]
Configurez la compression d'image (sans perte). La valeur par défaut est auto_glz.

jpeg-wan-compression=[auto|jamais|toujours]
zlib-glz-wan-compression=[auto|jamais|toujours]
Configurez la compression d'image wan (avec perte pour les liens lents). La valeur par défaut est automatique.

streaming-video=[off|all|filtre]
Configurez la détection de flux vidéo. La valeur par défaut est le filtre.

agent-mouse=[on|off]
Activer/désactiver le passage des événements de souris via vdagent. La valeur par défaut est activée.

lecture-compression=[on|off]
Activer/désactiver la compression de flux audio (à l'aide de celt 0.5.1). La valeur par défaut est activée.

migration-transparente=[on|off]
Activer/désactiver la migration transparente de Spice. La valeur par défaut est désactivée.

-portrait
Faites pivoter la sortie graphique de 90 degrés vers la gauche (uniquement LCD PXA).

-tourner deg
Faites pivoter la sortie graphique d'un peu vers la gauche (uniquement PXA LCD).

-vga type
Sélectionnez le type de carte VGA à émuler. Valeurs valides pour type

cirrus
Carte vidéo Cirrus Logic GD5446. Toutes les versions de Windows à partir de Windows 95
devrait reconnaître et utiliser cette carte graphique. Pour des performances optimales, utilisez 16 bits
profondeur de couleur dans l'invité et le système d'exploitation hôte. (Celui-ci est la valeur par défaut)

std Carte VGA standard avec extensions Bochs VBE. Si votre système d'exploitation invité prend en charge le VESA
2.0 extensions VBE (par exemple Windows XP) et si vous souhaitez utiliser des modes haute résolution
(>= 1280x1024x16) alors vous devriez utiliser cette option.

vmware
Adaptateur compatible VMWare SVGA-II. Utilisez-le si vous avez suffisamment récent
Serveur XFree86/XOrg ou invité Windows avec un pilote pour cette carte.

qxl Carte graphique paravirtuelle QXL. Il est compatible VGA (y compris VESA 2.0 VBE
Support). Fonctionne mieux avec les pilotes invités qxl installés. Choix recommandé
lors de l'utilisation du protocole d'épices.

TCX (sun4m uniquement) Tampon d'image Sun TCX. C'est le framebuffer par défaut pour sun4m
machines et offre des profondeurs de couleur 8 bits et 24 bits à une résolution fixe de
1024x768.

cg3 (sun4m uniquement) Sun cgthree framebuffer. Il s'agit d'un simple framebuffer 8 bits pour sun4m
machines disponibles dans les résolutions 1024x768 (OpenBIOS) et 1152x900 (OBP)
destiné aux personnes souhaitant exécuter des versions plus anciennes de Solaris.

virtio
Carte Virtio VGA.

aucun
Désactivez la carte VGA.

-plein écran
Démarrez en plein écran.

-g largeurxla taille[xprofondeur]
Définissez la résolution et la profondeur graphiques initiales (PPC, SPARC uniquement).

-vnc l’affichage[,option[,option[,...]]]
Normalement, QEMU utilise SDL pour afficher la sortie VGA. Avec cette option, vous pouvez avoir
QEMU écoute sur l'écran VNC l’affichage et redirigez l'affichage VGA sur la session VNC.
Il est très utile d'activer la tablette USB lors de l'utilisation de cette option (option
-périphérique USB tablettes). Lorsque vous utilisez l'affichage VNC, vous devez utiliser le -k paramètre à définir
la disposition du clavier si vous n'utilisez pas en-us. Syntaxe valide pour le l’affichage is

hôte:d
Les connexions TCP ne seront autorisées que depuis hôte sur écran d. Par convention le
Le port TCP est 5900+d. En option, hôte peut être omis, auquel cas le serveur
accepter les connexions de n'importe quel hôte.

unix :chemin
Les connexions seront autorisées sur les sockets de domaine UNIX où chemin est l'emplacement de
un socket unix pour écouter les connexions.

aucun
VNC est initialisé mais pas démarré. La commande monitor "change" peut être utilisée pour
plus tard, démarrez le serveur VNC.

Suite au l’affichage valeur il peut y avoir un ou plusieurs option drapeaux séparés par des virgules.
Les options valides sont

inverser
Connectez-vous à un client VNC d'écoute via une connexion "inverse". Le client est
spécifié par le l’affichage. Pour les connexions réseau inversées (hôte:d, "inverse"), le
d L'argument est un numéro de port TCP, pas un numéro d'affichage.

Websocket
Ouvre un port d'écoute TCP supplémentaire dédié aux connexions VNC Websocket. Par
définition le port Websocket est 5700+l’affichage. Si hôte est des connexions spécifiées
ne sera autorisé qu'à partir de cet hôte. Comme alternative, le port Websocket pourrait
être spécifié en utilisant "websocket"=port. Si aucune information d'identification TLS n'est fournie, le
la connexion websocket s'exécute en mode non crypté. Si les informations d'identification TLS sont fournies,
la connexion websocket nécessite des connexions client cryptées.

Mot de passe
Exiger que l'authentification par mot de passe soit utilisée pour les connexions client.

Le mot de passe doit être défini séparément à l'aide de la commande "set_password" dans le
pcsys_monitor. La syntaxe pour changer votre mot de passe est : "set_password
" où peut être "vnc" ou "spice".

Si vous souhaitez changer expiration du mot de passe, vous devez utiliser
"expire_password " où le délai d'expiration pourrait être un
parmi les options suivantes : maintenant, jamais, +secondes ou heure d'expiration UNIX, par exemple
+60 pour faire expirer le mot de passe en 60 secondes, ou 1335196800 pour faire expirer le mot de passe
le "Lun 23 avr 12:00:00 EDT 2012" (heure UNIX pour cette date et heure).

Vous pouvez également utiliser les mots clés « maintenant » ou « jamais » pour le délai d'expiration afin de permettre
le mot de passe expire immédiatement ou n'expire jamais.

tls-creds=ID
Fournit l'ID d'un ensemble d'informations d'identification TLS à utiliser pour sécuriser le serveur VNC. Ils
s'appliquera à la fois au socket serveur VNC normal et au socket websocket (si
activée). La définition des informations d'identification TLS obligera le socket du serveur VNC à activer le
Mécanisme d'authentification VeNCrypt. Les identifiants doivent avoir été préalablement créés
en utilisant l' -objet tls-crédits argument.

Votre tls-crédits paramètre rend obsolète le tls, x509 et x509vérifier options, et comme
il n'est donc pas permis de définir à la fois les nouvelles et les anciennes options de type.

tls Exiger que le client utilise TLS lors de la communication avec le serveur VNC. Cela utilise
les informations d'identification TLS anonymes sont donc susceptibles d'une attaque de l'homme du milieu. Il est
recommandé que cette option soit combinée avec le x509 or x509vérifier
options.

Cette option est désormais obsolète au profit de l'utilisation du tls-crédits argument.

x509=/chemin/vers/certificat/répertoire
Valable si tls est spécifié. Exiger que les informations d'identification x509 soient utilisées pour la négociation
la session TLS. Le serveur enverra son certificat x509 au client. Il est
recommandé qu'un mot de passe soit défini sur le serveur VNC pour fournir l'authentification de
le client lorsqu'il est utilisé. Le chemin qui suit cette option spécifie où le
Les certificats x509 doivent être chargés à partir de. Voir le sécurité_vnc rubrique pour plus de détails
sur la génération de certificats.

Cette option est désormais obsolète au profit de l'utilisation du tls-crédits argument.

x509vérifier=/chemin/vers/certificat/répertoire
Valable si tls est spécifié. Exiger que les informations d'identification x509 soient utilisées pour la négociation
la session TLS. Le serveur enverra son certificat x509 au client, et
demander au client d'envoyer son propre certificat x509. Le serveur validera
le certificat du client par rapport au certificat CA et rejeter les clients lorsque
la validation échoue. Si l'autorité de certification est de confiance, cela est suffisant
mécanisme d'authentification. Vous pouvez toujours souhaiter définir un mot de passe sur le serveur VNC
comme deuxième couche d'authentification. Le chemin suivant cette option spécifie où
les certificats x509 doivent être chargés à partir de. Voir le sécurité_vnc section pour
détails sur la génération de certificats.

Cette option est désormais obsolète au profit de l'utilisation du tls-crédits argument.

SASL
Exiger que le client utilise SASL pour s'authentifier auprès du serveur VNC. L'exact
le choix de la méthode d'authentification utilisée est contrôlé à partir de la SASL du système/utilisateur
fichier de configuration du service 'qemu'. Cela se trouve généralement dans
/etc/sasl2/qemu.conf. Si vous exécutez QEMU en tant qu'utilisateur non privilégié, un environnement
la variable SASL_CONF_PATH peut être utilisée pour lui faire rechercher des emplacements alternatifs pour le
configuration des services. Alors que certaines méthodes d'authentification SASL peuvent également fournir un cryptage des données (par ex.
GSSAPI), il est recommandé de toujours combiner SASL avec les 'tls' et 'x509'
paramètres pour permettre l'utilisation de SSL et de certificats de serveur. Cela garantit une donnée
cryptage empêchant la compromission des informations d'authentification. Voir le
sécurité_vnc section pour plus de détails sur l'utilisation de l'authentification SASL.

acl Activer les listes de contrôle d'accès pour vérifier le certificat client x509 et SASL
fête. Pour les certificats x509, la vérification de l'ACL est effectuée par rapport au certificat
nom distingué. C'est quelque chose qui ressemble
"C=GB,O=ACME,L=Boston,CN=bob". Pour la partie SASL, la vérification de l'ACL est effectuée par rapport au
nom d'utilisateur, qui, selon le plugin SASL, peut inclure un composant de domaine, par exemple
"bob" ou "[email protected]". Quand le acl flag est défini, la liste d'accès initiale
sera vide, avec une politique "refuser". Ainsi, personne ne sera autorisé à utiliser le VNC
serveur jusqu'à ce que les ACL aient été chargées. Ceci peut être réalisé en utilisant le "acl"
commande moniteur.

lossy
Activez les méthodes de compression avec perte (gradient, JPEG, ...). Si cette option est définie, VNC
le client peut recevoir des mises à jour de framebuffer avec perte en fonction de ses paramètres d'encodage.
L'activation de cette option peut économiser beaucoup de bande passante au détriment de la qualité.

non adaptatif
Désactivez les encodages adaptatifs. Les encodages adaptatifs sont activés par défaut. Un
l'encodage adaptatif essaiera de détecter les régions d'écran fréquemment mises à jour et enverra
mises à jour dans ces régions en utilisant un encodage avec perte (comme JPEG). Cela peut être vraiment
utile pour économiser de la bande passante lors de la lecture de vidéos. Désactiver les encodages adaptatifs
restaure le comportement statique d'origine des encodages comme Tight.

share=[autoriser-exclusif|forcer-partagé|ignorer]
Définir la politique de partage d'affichage. 'allow-exclusive' permet aux clients de demander une exclusivité
accès. Comme suggéré par la spécification rfb, cela est implémenté en supprimant d'autres
Connexions. La connexion de plusieurs clients en parallèle nécessite que tous les clients demandent
pour une session partagée (vncviewer : -shared switch). C'est la valeur par défaut.
'force-shared' désactive l'accès exclusif au client. Utile pour le bureau partagé
sessions, où vous ne voulez pas que quelqu'un oublie de spécifier -déconnexion partagée
tout le monde. « ignorer » ignore complètement le drapeau partagé et permet à tout le monde
connecter inconditionnellement. N'est pas conforme à la spécification rfb mais est QEMU traditionnel
comportement.

Cible i386 uniquement :

-win2k-hack
Utilisez-le lors de l'installation de Windows 2000 pour éviter un bogue de disque plein. Une fois que Windows 2000 est
installé, vous n'avez plus besoin de cette option (cette option ralentit les transferts IDE).

-no-fd-bootchk
Désactivez la vérification de la signature de démarrage pour les disquettes dans le BIOS. Peut être nécessaire pour démarrer à partir de
vieilles disquettes.

-pas d'acpi
Désactivez la prise en charge ACPI (Advanced Configuration and Power Interface). Utilisez-le si votre
Le système d'exploitation invité se plaint de problèmes ACPI (ordinateur cible PC uniquement).

-non-hpet
Désactivez la prise en charge HPET.

-acceptable [signature=str][,rév=n][,oem_id=str][,oem_table_id=str][,oem_rev=n]
[,asl_compiler_id=str][,asl_compiler_rev=n][,données=file1[:file2(...)...]
Ajoutez une table ACPI avec des champs d'en-tête et un contexte spécifiés à partir de fichiers spécifiés. Pour
file=, prend la table ACPI entière à partir des fichiers spécifiés, y compris tous les en-têtes ACPI
(éventuellement remplacé par d'autres options). Pour data=, seule la partie données du tableau est
utilisé, toutes les informations d'en-tête sont spécifiées dans la ligne de commande.

-smbios fichier=binaire
Chargez l'entrée SMBIOS à partir du fichier binaire.

-smbios type=0[,fournisseur=str][,version=str][,date=str][,libération=%d.%d][,uefi=on|off]
Spécifiez les champs SMBIOS de type 0

-smbios
type=1[,fabricant=str][,produit=str][,version=str][,série=str][,uuid=uuid][,sku=str][,famille=str]
Spécifiez les champs SMBIOS de type 1

-smbios
type=2[,fabricant=str][,produit=str][,version=str][,série=str][,actif=str][,emplacement=str][,famille=str]
Spécifiez les champs SMBIOS de type 2

-smbios type=3[,fabricant=str][,version=str][,série=str][,actif=str][,sku=str]
Spécifiez les champs SMBIOS de type 3

-smbios
type=4[,sock_pfx=str][,fabricant=str][,version=str][,série=str][,actif=str][,partie=str]
Spécifiez les champs SMBIOS de type 4

-smbios
type=17[,loc_pfx=str][,banque=str][,fabricant=str][,série=str][,actif=str][,partie=str][,vitesse=%d]
Spécifiez les champs SMBIOS de type 17

Options réseau:

-rapporter nic[,vlan=n][,macaddr=mac][,modèle=type] [,nom=prénom][,adr=addr][,vecteurs=v]
Créez une nouvelle carte d'interface réseau et connectez-la au VLAN n (n = 0 est la valeur par défaut).
Le NIC est un e1000 par défaut sur le PC cible. En option, l'adresse MAC peut être
changé en mac, l'adresse de l'appareil définie sur addr (cartes PCI uniquement) et un prénom peuvent être
affecté pour être utilisé dans les commandes de surveillance. En option, pour les cartes PCI, vous pouvez spécifier le
nombre v des vecteurs MSI-X que la carte devrait avoir ; cette option actuellement uniquement
affecte les cartes virtio; ensemble v = 0 pour désactiver MSI-X. Sinon -rapporter option est spécifiée, un
une seule carte réseau est créée. QEMU peut émuler plusieurs modèles différents de carte réseau.
Valeurs valides pour type sont "virtio", "i82551", "i82557b", "i82559er", "ne2k_pci",
"ne2k_isa", "pcnet", "rtl8139", "e1000", "smc91c111", "lance" et "mcf_fec". Pas tout
les appareils sont pris en charge sur toutes les cibles. Utilisez "-net nic,model=help" pour une liste de
appareils disponibles pour votre cible.

-netdev utilisateur, id=id[,option][,option][,...]
-rapporter utilisateur[,option][,option][,...]
Utilisez la pile réseau en mode utilisateur qui ne nécessite aucun privilège d'administrateur pour s'exécuter.
Les options valides sont :

vlan=n
Connecter la pile en mode utilisateur au VLAN n (n = 0 est la valeur par défaut).

id =id
name =prénom
Attribuez un nom symbolique à utiliser dans les commandes de surveillance.

net=addr[/masque]
Définissez l'adresse réseau IP que l'invité verra. Spécifiez éventuellement le masque de réseau, soit
sous la forme abcd ou en tant que nombre de bits supérieurs valides. La valeur par défaut est 10.0.2.0/24.

hôte =addr
Spécifiez l'adresse visible par les invités de l'hôte. La valeur par défaut est la 2ème IP dans l'invité
réseau, iexxx2.

restreindre=on|off
Si cette option est activée, l'invité sera isolé, c'est-à-dire qu'il ne pourra pas
contactez l'hôte et aucun paquet IP invité ne sera acheminé sur l'hôte vers le
à l'extérieur. Cette option n'affecte pas les règles de transfert explicitement définies.

nom d'hôte=prénom
Spécifie le nom d'hôte du client signalé par le serveur DHCP intégré.

dhcpstart=addr
Spécifiez la première des 16 IP que le serveur DHCP intégré peut attribuer. La valeur par défaut est
la 15e à la 31e IP du réseau invité, c'est-à-dire xxx15 à xxx31.

dns =addr
Spécifiez l'adresse visible par l'invité du serveur de noms virtuel. L'adresse doit être
différente de l'adresse de l'hôte. La valeur par défaut est la 3e IP du réseau invité, c'est-à-dire
xxx3.

recherche DNS=domaine
Fournit une entrée pour la liste de recherche de domaine envoyée par le serveur DHCP intégré.
Plus d'un suffixe de domaine peut être transmis en spécifiant cette option plusieurs
fois. Si pris en charge, cela entraînera l'invité à essayer automatiquement d'ajouter le
suffixe(s) de domaine donné au cas où un nom de domaine ne peut pas être résolu.

Mise en situation :

utilisateur qemu -net,dnssearch=mgmt.example.org,dnssearch=example.org [...]

tftp=dir
Lorsque vous utilisez la pile réseau en mode utilisateur, activez un serveur TFTP intégré. Les fichiers
in dir sera exposé en tant que racine d'un serveur TFTP. Le client TFTP sur l'invité
doit être configuré en mode binaire (utiliser la commande "bin" du client Unix TFTP).

fichier de démarrage=filet
Lorsque vous utilisez la pile réseau en mode utilisateur, diffusez filet comme nom de fichier BOOTP. Dans
conjonction avec tftp, cela peut être utilisé pour démarrer en réseau un invité à partir d'un
répertoire.

Exemple (avec pxelinux) :

qemu-system-i386 -hda linux.img -boot n -net user,tftp=/chemin/vers/tftp/files,bootfile=/pxelinux.0

qn=dir[,serveursmb=addr]
Lorsque vous utilisez la pile réseau en mode utilisateur, activez un serveur SMB intégré afin que
Les systèmes d'exploitation Windows peuvent accéder aux fichiers hôtes dans dir de manière transparente. L'adresse IP de
le serveur SMB peut être configuré pour addr. Par défaut, la 4e IP du réseau invité est
utilisé, iexxx4.

Dans le système d'exploitation Windows invité, la ligne :

10.0.2.4 serveur smb

doit être ajouté dans le fichier C:\WINDOWS\LMHOSTS (pour windows 9x/Me) ou
C:\WINNT\SYSTEM32\DRIVERS\ETC\LMHOSTS (Windows NT/2000).

Ensuite dir est accessible dans \smbserveur\qemu.

Notez qu'un serveur SAMBA doit être installé sur le système d'exploitation hôte. QEMU a été testé
avec succès avec les versions smbd de Red Hat 9, Fedora Core 3 et OpenSUSE 11.x.

hostfwd=[tcp|udp] :[adresse hôte]:port hôte-[adresse invité]:port d'invité
Rediriger les connexions TCP ou UDP entrantes vers le port hôte port hôte à l'IP invité
propos adresse invité sur le port invité port d'invité. Si adresse invité n'est pas spécifié, son
la valeur est xxx15 (première adresse par défaut donnée par le serveur DHCP intégré). Par
en précisant adresse hôte, la règle peut être liée à une interface hôte spécifique. Sinon
le type de connexion est défini, TCP est utilisé. Cette option peut être donnée plusieurs fois.

Par exemple, pour rediriger la connexion hôte X11 de l'écran 1 vers l'écran invité 0, utilisez
ce qui suit:

# sur l'hôte
utilisateur qemu-system-i386 -net,hostfwd=tcp:127.0.0.1:6001-:6000 [...]
# cet hôte xterm doit s'ouvrir sur le serveur invité X11
xterm -affichage : 1

Pour rediriger les connexions telnet du port hôte 5555 vers le port telnet sur l'invité,
utilisez le suivant:

# sur l'hôte
utilisateur qemu-system-i386 -net,hostfwd=tcp::5555-:23 [...]
hôte local telnet 5555

Ensuite, lorsque vous utilisez sur l'hôte "telnet localhost 5555", vous vous connectez à l'invité
serveur telnet.

guestfwd=[tcp] :serveur:port-dev
guestfwd=[tcp] :serveur:port-cmd:commande
Transférer les connexions TCP invitées à l'adresse IP serveur sur le port port à la
dispositif de caractère dev ou à un programme exécuté par cmd:commande qui est engendré
pour chaque connexion. Cette option peut être donnée plusieurs fois.

Vous pouvez soit utiliser un chardev directement et l'avoir utilisé tout au long de QEMU
durée de vie, comme dans l'exemple suivant :

# ouvrez 10.10.1.1:4321 au démarrage, connectez-le 10.0.2.100:1234 à chaque fois
# l'invité y accède
utilisateur qemu -net,guestfwd=tcp:10.0.2.100:1234-tcp:10.10.1.1:4321 [...]

Ou vous pouvez exécuter une commande sur chaque connexion TCP établie par l'invité, donc
que QEMU se comporte de la même manière qu'un processus inetd pour ce serveur virtuel :

# appelez "netcat 10.10.1.1 4321" sur chaque connexion TCP à 10.0.2.100:1234
# et connectez le flux TCP à son stdin/stdout
qemu -net 'utilisateur,guestfwd=tcp:10.0.2.100:1234-cmd:netcat 10.10.1.1 4321'

Remarque : les options autonomes héritées -tftp, -bootp, -smb et -redir sont toujours traitées
et appliqué à l'utilisateur -net. Les mélanger avec la nouvelle syntaxe de configuration donne
résultats indéfinis. Leur utilisation pour de nouvelles applications est déconseillée car elles seront
supprimé des versions futures.

-netdev appuyez sur, id=id[,fd=h][,sinom=prénom][,script=filet][,downscript=fichier][,aide=assistant]
-rapporter
appuyez sur [,vlan=n][,nom=prénom][,fd=h][,sinom=prénom][,script=filet][,downscript=fichier][,aide=assistant]
Connectez l'interface réseau TAP hôte prénom au VLAN n.

Utiliser le script réseau filet pour le configurer et le script réseau fichier à
le déconfigurer. Si prénom n'est pas fourni, le système d'exploitation en fournit un automatiquement. Les
le script de configuration du réseau par défaut est /etc/qemu-ifup et la configuration du réseau par défaut
le script est /etc/qemu-ifdown. utilisation script=non or downscript=non pour désactiver le script
exécution.

Si vous exécutez QEMU en tant qu'utilisateur non privilégié, utilisez l'assistant réseau assistant configurer
l'interface TAP. L'exécutable d'assistance réseau par défaut est
/chemin/vers/qemu-bridge-helper.

fd=h peut être utilisé pour spécifier le handle d'une interface TAP hôte déjà ouverte.

Exemples :

#lancer une instance QEMU avec le script réseau par défaut
qemu-system-i386 linux.img -net nic -net tap

#lancer une instance QEMU avec deux cartes réseau, chacune connectée
#vers un appareil TAP
qemu-system-i386 linux.img \
-net nic,vlan=0 -net tap,vlan=0,ifname=tap0 \
-net nic,vlan=1 -net tap,vlan=1,ifname=tap1

#lancer une instance QEMU avec l'assistant réseau par défaut pour
#connecter un appareil TAP au pont br0
qemu-system-i386 linux.img \
-net nic -net tap,"helper=/path/to/qemu-bridge-helper"

-netdev pont, id=id[,br=pont][,aide=assistant]
-rapporter pont[,vlan=n][,nom=prénom][,br=pont][,aide=assistant]
Connectez une interface réseau TAP hôte à un périphérique de pont hôte.

Utiliser l'assistant réseau assistant pour configurer l'interface TAP et l'attacher au
pont. L'exécutable d'assistance réseau par défaut est /chemin/vers/qemu-bridge-helper et la
le périphérique de pont par défaut est br0.

Exemples :

#lancer une instance QEMU avec l'assistant réseau par défaut pour
#connecter un appareil TAP au pont br0
qemu-system-i386 linux.img -net bridge -net nic, modèle = virtio

#lancer une instance QEMU avec l'assistant réseau par défaut pour
#connecter un périphérique TAP au pont qemubr0
qemu-system-i386 linux.img -net bridge,br=qemubr0 -net nic,model=virtio

-netdev prise, identifiant =id[,fd=h][,écouter=[hôte]:port][,connecter=hôte:port]
-rapporter prise[,vlan=n][,nom=prénom][,fd=h] [,écouter=[hôte]:port][,connecter=hôte:port]
Connectez le VLAN n à un VLAN distant dans une autre machine virtuelle QEMU à l'aide d'un socket TCP
lien. Si écouter est spécifié, QEMU attend les connexions entrantes sur port (hôte
est facultatif). Contact est utilisé pour se connecter à une autre instance QEMU en utilisant le écouter
option. fd=h spécifie un socket TCP déjà ouvert.

Mise en situation :

# lancer une première instance QEMU
qemu-system-i386 linux.img \
-net nic,macaddr=52:54:00:12:34:56 \
-net socket, écouter=:1234
# connecte le VLAN 0 de cette instance au VLAN 0
# de la première instance
qemu-system-i386 linux.img \
-net nic,macaddr=52:54:00:12:34:57 \
-prise nette, connexion=127.0.0.1:1234

-netdev prise, identifiant =id[,fd=h][,mcast=maddr:port[,adresselocale=addr]]
-rapporter prise[,vlan=n][,nom=prénom][,fd=h][,mcast=maddr:port[,adresselocale=addr]]
Créer un VLAN n partagé avec d'autres machines virtuelles QEMU à l'aide d'une multidiffusion UDP
socket, créant efficacement un bus pour chaque QEMU avec la même adresse de multidiffusion maddr et
port. REMARQUES:

1. Plusieurs QEMU peuvent s'exécuter sur différents hôtes et partager le même bus (en supposant
configuration de multidiffusion correcte pour ces hôtes).

2. La prise en charge de mcast est compatible avec le mode utilisateur Linux (argument ethN=mdiffusion), voir
<http://user-mode-linux.sf.net>.

3. Utiliser fd=h pour spécifier un socket multicast UDP déjà ouvert.

Mise en situation :

# lancer une instance QEMU
qemu-system-i386 linux.img \
-net nic,macaddr=52:54:00:12:34:56 \
-socket net,mcast=230.0.0.1:1234
# lancer une autre instance QEMU sur le même "bus"
qemu-system-i386 linux.img \
-net nic,macaddr=52:54:00:12:34:57 \
-socket net,mcast=230.0.0.1:1234
# lancer encore une autre instance QEMU sur le même "bus"
qemu-system-i386 linux.img \
-net nic,macaddr=52:54:00:12:34:58 \
-socket net,mcast=230.0.0.1:1234

Exemple (mode utilisateur compatible Linux) :

# lancer l'instance QEMU (notez l'adresse mcast sélectionnée
# est la valeur par défaut d'UML)
qemu-system-i386 linux.img \
-net nic,macaddr=52:54:00:12:34:56 \
-socket net,mcast=239.192.168.1:1102
# lancer UML
/chemin/vers/linux ubd0=/chemin/vers/root_fs eth0=mcast

Exemple (envoyer des paquets depuis l'hôte 1.2.3.4) :

qemu-system-i386 linux.img \
-net nic,macaddr=52:54:00:12:34:56 \
-net socket,mcast=239.192.168.1:1102,localaddr=1.2.3.4

-netdev
l2tpv3, identifiant =id,source=cœur,heure d'été=dstaddr[,srcport=port de source][,dstport=port d'arrivée],txsession=session d'émission[,rxsession=rxsession][,ipv6][,udp][,cookie64][,counter][,pincounter][,txcookie=txcookie][,rxcookie=rxcookie][,décalage=compenser]
-rapporter
l2tpv3[,vlan=n][,nom=prénom],source=cœur,heure d'été=dstaddr[,srcport=port de source][,dstport=port d'arrivée],txsession=session d'émission[,rxsession=rxsession][,ipv6][,udp][,cookie64][,counter][,pincounter][,txcookie=txcookie][,rxcookie=rxcookie][,décalage=compenser]
Connecter le VLAN n au pseudo-fil L2TPv3. L2TPv3 (RFC3391) est un protocole populaire pour
transportent des trames de données Ethernet (et d'autres couches 2) entre deux systèmes. il est présent
dans les routeurs, les pare-feux et le noyau Linux (à partir de la version 3.3).

Ce transport permet à une VM de communiquer directement avec une autre VM, routeur ou pare-feu.

src =cœur
adresse source (obligatoire)

dst =dstaddr
adresse de destination (obligatoire)

udp sélectionnez l'encapsulation udp (la valeur par défaut est ip).

port_src=port de source
port udp source.

portdst=port d'arrivée
port udp de destination.

ipv6
force v6, sinon la valeur par défaut est la v4.

rxcookie=rxcookie
txcookie=txcookie
Les cookies sont une forme de sécurité faible dans la spécification l2tpv3. Leur fonction est
principalement pour éviter les erreurs de configuration. Par défaut, ils sont en 32 bits.

Cookie64
Définir la taille du cookie sur 64 bits au lieu de 32 par défaut

compteur = éteint
Forcer un L2TPv3 'coupé' sans compteur comme dans
brouillon-mkonstan-l2tpext-keyed-ipv6-tunnel-00

pincounter = activé
Contourner la gestion des compteurs cassés dans le pair. Cela peut également aider sur les réseaux qui ont
réorganisation des paquets.

décalage =compenser
Ajouter un décalage supplémentaire entre l'en-tête et les données

Par exemple, pour attacher une VM s'exécutant sur l'hôte 4.3.2.1 via L2TPv3 au pont br-lan on
l'hôte Linux distant 1.2.3.4 :

# Configuration du tunnel sur l'hôte Linux en utilisant l'adresse IP brute comme encapsulation
# sur 1.2.3.4
ip l2tp ajouter un tunnel distant 4.3.2.1 local 1.2.3.4 tunnel_id 1 peer_tunnel_id 1 \
encap udp udp_sport 16384 udp_dport 16384
ip l2tp ajouter session tunnel_id 1 nom vmtunnel0 session_id \
0xFFFFFFFF peer_session_id 0xFFFFFFFF
ifconfig vmtunnel0 mtu 1500
ifconfig vmtunnel0 en place
brctl addif br-lan vmtunnel0

# sur 4.3.2.1
# lancement de l'instance QEMU - si votre réseau a une réorganisation ou est très avec perte, ajoutez, pincounter

qemu-system-i386 linux.img -net nic -net l2tpv3,src=4.2.3.1,dst=1.2.3.4,udp,srcport=16384,dstport=16384,rxsession=0xffffffff,txsession=0xffffffff,compteur

-netdev vde,id=id[,chaussette=chemin de socket][,port=n][,groupe=nom de groupe][,mode=mode octal]
-rapporter vde[,vlan=n][,nom=prénom][,chaussette=chemin de socket]
[,port=n][,groupe=nom de groupe][,mode=mode octal]
Connecter le VLAN n au PORT n d'un commutateur vde s'exécutant sur l'hôte et écoutant les entrées
connexions sur chemin de socket. Utiliser GROUPE nom de groupe et MODE mode octal changer la valeur par défaut
propriété et autorisations pour le port de communication. Cette option n'est disponible que si
QEMU a été compilé avec le support vde activé.

Mise en situation :

# lancer le commutateur vde
vde_switch -F -sock /tmp/moncommutateur
# lancer l'instance QEMU
qemu-system-i386 linux.img -net nic -net vde,sock=/tmp/myswitch

-netdev hubport, id=id,hubid=hubide
Créer un port hub sur QEMU "vlan" hubide.

Le hubport netdev vous permet de connecter une carte réseau à un "vlan" QEMU au lieu d'un seul netdev.
"-net" et "-device" avec paramètre vlan créer automatiquement le hub requis.

-netdev utilisateur-vhost,chardev=id[,vhostforce=on|off][,files d'attente=n]
Établir un netdev vhost-user, soutenu par un chardev id. Le chardev devrait être un unix
socket de domaine soutenu un. Le vhost-user utilise un protocole spécifiquement défini pour passer
messages de remplacement vhost ioctl à une application à l'autre extrémité du socket. Au
invités non MSIX, la fonctionnalité peut être forcée avec vhostforce. Utilisez « files d'attente = »n' spécifier
le nombre de files d'attente à créer pour vhost-user multifile.

Mise en situation :

qemu -m 512 -object mémoire-backend-file,id=mem,size=512M,mem-path=/hugetlbfs,share=on \
-numa nœud, memdev=mem \
-chardev socket,chemin=/chemin/vers/socket \
-netdev type=utilisateur-vhost,id=net0,chardev=chr0 \
-périphérique virtio-net-pci,netdev=net0

-rapporter dump[,vlan=n][,fichier=filet][,len=len]
Vider le trafic réseau sur le VLAN n déposer filet (qemu-vlan0.pcap par défaut). Au plus len
octets (64 Ko par défaut) par paquet sont stockés. Le format de fichier est libpcap, il peut donc être
analysé avec des outils tels que tcpdump ou Wireshark. Remarque : Pour les appareils créés avec
'-netdev', utilisez '-object filter-dump,...' à la place.

-rapporter aucun
Indiquez qu'aucun périphérique réseau ne doit être configuré. Il est utilisé pour remplacer le
configuration par défaut (-rapporter nic -rapporter utilisateur) qui est activé si non -rapporter les options sont
à condition de.

Options de périphérique de caractère :

La forme générale d'une option de périphérique de caractères est :

-chardev backend ,identifiant=id [, mux = activé | désactivé] [,Options]
Le backend est l'un des suivants : nul, douille, udp, mssouris, vc, ringbuf, filet, pipe, console,
en série, pty, stdio, braille, tty, parallèle, parc, épicesvmc. épicesL’
un backend spécifique déterminera les options applicables.

Tous les appareils doivent avoir un identifiant, qui peut être n'importe quelle chaîne jusqu'à 127 caractères. Il est
utilisé pour identifier de manière unique ce périphérique dans d'autres directives de ligne de commande.

Un périphérique de caractères peut être utilisé en mode multiplexage par plusieurs frontaux. La clé
séquence de Contrôle-a et c fera pivoter le focus d'entrée entre les frontaux attachés.
Spécifier multiplex = activé pour activer ce mode.

Les options de chaque backend sont décrites ci-dessous.

-chardev nul ,identifiant=id
Un appareil vide. Cet appareil n'émettra aucune donnée et supprimera toutes les données qu'il reçoit.
Le backend null ne prend aucune option.

-chardev douille ,identifiant=id [TCP Options or unix Options] [,serveur] [,non attends] [, telnet]
[,reconnecter=secondes]
Créez un socket de flux bidirectionnel, qui peut être un socket TCP ou unix. Un unix
socket sera créé si chemin est spécifié. Le comportement n'est pas défini si les options TCP sont
spécifié pour un socket unix.

serveur spécifie que la socket doit être une socket d'écoute.

maintenant spécifie que QEMU ne doit pas bloquer l'attente qu'un client se connecte à un
prise d'écoute.

telnet spécifie que le trafic sur le socket doit interpréter les séquences d'échappement telnet.

reconnecter définit le délai de reconnexion sur les sockets non-serveur lorsque l'extrémité distante
s'en va. qemu retardera ce nombre de secondes, puis tentera de se reconnecter. Zéro
désactive la reconnexion et est la valeur par défaut.

Les options de socket TCP et Unix sont données ci-dessous :

TCP options: port =port [,hôte=hôte] [,à=à] [,ipv4] [,ipv6] [,sans délais]
hôte pour une socket d'écoute spécifie l'adresse locale à lier. Pour un
Le socket de connexion désigne l'hôte distant auquel se connecter. hôte est facultatif pour
prises d'écoute. S'il n'est pas spécifié, la valeur par défaut est 0.0.0.0.

port pour une socket d'écoute spécifie le port local à lier. Pour une connexion
socket spécifie le port sur l'hôte distant auquel se connecter. port peut être donné comme
soit un numéro de port, soit un nom de service. port est nécessaire.

à ne concerne que les prises d'écoute. S'il est spécifié, et port c'est pas possible
lié, QEMU tentera de se lier aux ports suivants jusqu'à et y compris à jusqu'au
ça réussit. à doit être spécifié en tant que numéro de port.

ipv4 et ipv6 spécifiez que IPv4 ou IPv6 doit être utilisé. Si ni l'un ni l'autre n'est
spécifié que le socket peut utiliser l'un ou l'autre protocole.

sans délais désactive l'algorithme Nagle.

unix options: chemin =chemin
chemin spécifie le chemin local du socket unix. chemin est nécessaire.

-chardev udp ,identifiant=id [,hôte=hôte] ,port=port [,adresselocale=adresse locale] [,portlocal=port local]
[,ipv4] [,ipv6]
Envoie tout le trafic de l'invité à un hôte distant via UDP.

hôte spécifie l'hôte distant auquel se connecter. Si non spécifié, la valeur par défaut est
"localhost".

port spécifie le port sur l'hôte distant auquel se connecter. port est nécessaire.

adresse locale spécifie l'adresse locale à laquelle se lier. Si non spécifié, la valeur par défaut est
0.0.0.0.

port local spécifie le port local auquel se lier. Si non spécifié tout local disponible
port sera utilisé.

ipv4 et ipv6 spécifiez que IPv4 ou IPv6 doit être utilisé. Si ni l'un ni l'autre n'est spécifié
l'appareil peut utiliser l'un ou l'autre protocole.

-chardev mssouris ,identifiant=id
Transférez les événements msmouse émulés de QEMU à l'invité. mssouris ne prend aucun
options.

-chardev vc ,identifiant=id [[,largeur=largeur] [,hauteur=la taille]] [[,cols=cols] [,lignes=lignes]]
Connectez-vous à une console de texte QEMU. vc peut éventuellement se voir attribuer une taille spécifique.

largeur et la taille spécifiez respectivement la largeur et la hauteur de la console, en pixels.

cols et lignes spécifier que la console doit être dimensionnée pour s'adapter à une console de texte avec le
dimensions.

-chardev ringbuf ,identifiant=id [,taille=Taille]
Créer un tampon en anneau avec une taille fixe Taille. Taille doit être une puissance de deux, et les valeurs par défaut
à "64K").

-chardev filet ,identifiant=id ,chemin=chemin
Consignez tout le trafic reçu de l'invité dans un fichier.

chemin spécifie le chemin du fichier à ouvrir. Ce fichier sera créé si c'est le cas
n'existe pas déjà, et écrasé s'il existe. chemin est nécessaire.

-chardev pipe ,identifiant=id ,chemin=chemin
Créez une connexion bidirectionnelle avec l'invité. Le comportement diffère légèrement entre
Hôtes Windows et autres hôtes :

Sous Windows, un seul canal duplex sera créé à \.tuyau\chemin.

Sur les autres hôtes, 2 tuyaux seront créés appelés chemin. Dans et chemin.en dehors. Données écrites sur
chemin. Dans sera reçu par le client. Les données écrites par l'invité peuvent être lues à partir de
chemin.en dehors. QEMU ne créera pas ces fifos et exige leur présence.

chemin fait partie du trajet du tuyau tel que décrit ci-dessus. chemin est nécessaire.

-chardev console ,identifiant=id
Envoyez le trafic de l'invité à la sortie standard de QEMU. console ne prend aucun
options.

console n'est disponible que sur les hôtes Windows.

-chardev en série ,identifiant=id ,chemin=chemin
Envoyez le trafic de l'invité à un périphérique série sur l'hôte.

Sur les hôtes Unix, la série acceptera en fait n'importe quel périphérique tty, pas seulement les lignes série.

chemin spécifie le nom du périphérique série à ouvrir.

-chardev pty ,identifiant=id
Créez un nouveau pseudo-terminal sur l'hôte et connectez-vous à celui-ci. pty ne prend aucun
options.

pty n'est pas disponible sur les hôtes Windows.

-chardev stdio ,identifiant=id [, signal = activé | désactivé]
Connectez-vous à l'entrée standard et à la sortie standard du processus QEMU.

signal contrôle si les signaux sont activés sur le terminal, ce qui inclut la sortie de QEMU
avec la séquence de touches Contrôle-c. Cette option est activée par défaut, utilisez signal = éteint à
le désactiver.

stdio n'est pas disponible sur les hôtes Windows.

-chardev braille ,identifiant=id
Connectez-vous à un serveur BrlAPI local. braille ne prend aucune option.

-chardev tty ,identifiant=id ,chemin=chemin
tty est uniquement disponible sur les hôtes Linux, Sun, FreeBSD, NetBSD, OpenBSD et DragonFlyBSD.
C'est un alias pour en série.

chemin spécifie le chemin d'accès au tty. chemin est nécessaire.

-chardev parallèle ,identifiant=id ,chemin=chemin
-chardev parc ,identifiant=id ,chemin=chemin
parallèle n'est disponible que sur les hôtes Linux, FreeBSD et DragonFlyBSD.

Connectez-vous à un port parallèle local.

chemin spécifie le chemin d'accès au périphérique du port parallèle. chemin est nécessaire.

-chardev épicesvmc ,identifiant=id ,déboguer=déboguer, name =prénom
épicesvmc n'est disponible que lorsque la prise en charge des épices est intégrée.

déboguer niveau de débogage pour spicevmc

prénom nom du canal spice auquel se connecter

Connectez-vous à un canal de machine virtuelle Spice, tel que vdiport.

-chardev épices ,identifiant=id ,déboguer=déboguer, name =prénom
épices n'est disponible que lorsque la prise en charge des épices est intégrée.

déboguer niveau de débogage pour spicevmc

prénom nom du port d'épices auquel se connecter

Connectez-vous à un port Spice, permettant à un client Spice de gérer le trafic identifié par un
nom (de préférence un nom de domaine complet).

Syntaxe de l'URL de l'appareil :

En plus d'utiliser des images de fichiers normales pour les périphériques de stockage émulés, QEMU peut également
utiliser des ressources en réseau telles que des périphériques iSCSI. Ceux-ci sont spécifiés à l'aide d'une URL spéciale
syntaxe.

iSCSI
La prise en charge iSCSI permet à QEMU d'accéder directement aux ressources iSCSI et de les utiliser comme images pour le
stockage des invités. Les images de disque et de cédérom sont prises en charge.

La syntaxe pour spécifier les LUN iSCSI est "iscsi:// [: ]/ / "

Par défaut, qemu utilisera le nom d'initiateur iSCSI 'iqn.2008-11.org.linux-kvm[ : ]'
mais cela peut également être défini à partir de la ligne de commande ou d'un fichier de configuration.

Depuis la version Qemu 2.4 il est possible de spécifier un timeout de requête iSCSI pour détecter
demandes bloquées et forcer le rétablissement de la session. Le délai d'attente est spécifié
en secondes. La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de délai d'attente. Libiscsi 1.15.0 ou supérieur est
requis pour cette fonction.

Exemple (sans authentification) :

qemu-system-i386 -iscsi nom-initiateur=iqn.2001-04.com.example:mon-initiateur \
-cdrom iscsi://192.0.2.1/iqn.2001-04.com.example/2 \
-drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1

Exemple (nom d'utilisateur/mot de passe CHAP via URL) :

qemu-system-i386 -drive file=iscsi://user%[email protected]/iqn.2001-04.com.exemple/1

Exemple (nom d'utilisateur/mot de passe CHAP via des variables d'environnement) :

LIBISCSI_CHAP_USERNAME="utilisateur" \
LIBISCSI_CHAP_PASSWORD="mot de passe" \
qemu-system-i386 -drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1

La prise en charge iSCSI est une fonctionnalité facultative de QEMU et n'est disponible qu'une fois compilée et
lié contre libiscsi.

Les paramètres iSCSI tels que le nom d'utilisateur et le mot de passe peuvent également être spécifiés via un
fichier de configuration. Voir qemu-doc pour plus d'informations et d'exemples.

NBD QEMU prend en charge NBD (Network Block Devices) à la fois en utilisant le protocole TCP et Unix
Sockets de domaine.

Syntaxe pour spécifier un périphérique NBD à l'aide de TCP
"nbd : : [:exportname= ]"

Syntaxe pour spécifier un périphérique NBD à l'aide de sockets de domaine Unix
"nbd:unix: [:exportname= ]"

Exemple pour TCP

qemu-system-i386 --drive file=nbd:192.0.2.1:30000

Exemple pour les sockets de domaine Unix

qemu-system-i386 --drive file=nbd:unix:/tmp/nbd-socket

SSH QEMU prend en charge l'accès SSH (Secure Shell) aux disques distants.

Exemples :

qemu-system-i386 -drive file=ssh://user@host/path/to/disk.img
qemu-system-i386 -drive file.driver=ssh,file.user=user,file.host=host,file.port=22,file.path=/path/to/disk.img

Actuellement, l'authentification doit être effectuée à l'aide de ssh-agent. Autres méthodes d'authentification
peut être pris en charge à l'avenir.

Chien de berger
Sheepdog est un système de stockage distribué pour QEMU. QEMU prend en charge l'utilisation soit locale
appareils de chien de berger ou appareils distants en réseau.

Syntaxe pour spécifier un périphérique de chien de berger

chien de berger[+tcp|+unix]://[host:port]/vdiname[?socket=path][#snapid|#tag]

Exemple

qemu-system-i386 --drive file=sheepdog://192.0.2.1:30000/MyVirtualMachine

Voir égalementhttp://httphttps://www.osrg.net/sheepdog/>.

GlusterFS
GlusterFS est un système de fichiers distribué en espace utilisateur. QEMU soutient l'utilisation de
Volumes GlusterFS pour l'hébergement d'images de disque VM à l'aide de TCP, de sockets de domaine Unix et de RDMA
protocoles de transport.

La syntaxe pour spécifier une image disque VM sur le volume GlusterFS est

gluster[+transport]://[serveur[:port]]/volname/image[?socket=...]

Exemple

qemu-system-x86_64 --drive file=gluster://192.0.2.1/testvol/a.img

Voir égalementhttp://www.gluster.org>.

HTTP/HTTPS/FTP/FTPS/TFTP
QEMU prend en charge l'accès en lecture seule aux fichiers accessibles via http(s), ftp(s) et tftp.

Syntaxe utilisant un seul nom de fichier :

://[ [: ]@] /

où:

protocole
'http', 'https', 'ftp', 'ftps' ou 'tftp'.

Nom d'utilisateur
Nom d'utilisateur facultatif pour l'authentification sur le serveur distant.

Mot de passe
Mot de passe facultatif pour l'authentification sur le serveur distant.

hôte
Adresse du serveur distant.

chemin
Chemin sur le serveur distant, y compris toute chaîne de requête.

Les options suivantes sont également prises en charge :

url L'URL complète lors de la transmission explicite des options au pilote.

lecture anticipée
La quantité de données à lire à l'avance avec chaque demande de plage au serveur distant.
Cette valeur peut éventuellement avoir le suffixe 'T', 'G', 'M', 'K', 'k' ou 'b'. Si ça
n'a pas de suffixe, il sera supposé être en octets. La valeur doit être un
multiple de 512 octets. La valeur par défaut est 256k.

sslverifier
S'il faut vérifier le certificat du serveur distant lors de la connexion via SSL. Ça peut
avoir la valeur 'on' ou 'off'. Il est par défaut sur « on ».

gâteau
Envoyez ce cookie (il peut aussi s'agir d'une liste de cookies séparés par ';') avec chaque
demande sortante. Uniquement pris en charge lors de l'utilisation de protocoles tels que HTTP qui prennent en charge
cookies, sinon ignorés.

temps mort
Définissez le délai d'expiration en secondes de la connexion CURL. Ce délai d'attente est le temps que
CURL attend une réponse du serveur distant pour obtenir la taille de l'image à
être téléchargé. S'il n'est pas défini, le délai d'attente par défaut de 5 secondes est utilisé.

Notez que lors de la transmission explicite d'options à qemu, driver est la valeur de .

Exemple : démarrage à partir d'une image ISO en direct Fedora 20 distante

qemu-system-x86_64 --drive media=cdrom,file=http://dl.fedoraproject.org/pub/fedora/linux/releases/20/Live/x86_64/Fedora-Live-Desktop-x86_64-20-1.iso,lecture seulement

qemu-system-x86_64 --drive media=cdrom,file.driver=http,file.url=http://dl.fedoraproject.org/pub/fedora/linux/releases/20/Live/x86_64/Fedora-Live-Desktop-x86_64-20-1.iso,lecture seulement

Exemple : démarrage à partir d'une image cloud Fedora 20 distante en utilisant une surcouche locale pour les écritures,
copie en lecture et une lecture anticipée de 64k

qemu-img create -f qcow2 -o backing_file='json:{"file.driver":"http",, "file.url":"https://dl.fedoraproject.org/pub/fedora/linux/releases /20/Images/x86_64/Fedora-x86_64-20-20131211.1-sda.qcow2",, "file.readahead":"64k"}' /tmp/Fedora-x86_64-20-20131211.1-sda.qcow2

qemu-system-x86_64 -drive file=/tmp/Fedora-x86_64-20-20131211.1-sda.qcow2,copy-on-read=on

Exemple : démarrage à partir d'une image stockée sur un serveur VMware vSphere avec un
certificat utilisant une superposition locale pour les écritures, une lecture anticipée de 64k et un délai d'attente de 10
secondes.

qemu-img create -f qcow2 -o backing_file='json:{"file.driver":"https",, "file.url":"https://user :[email protected]/folder/test/test-flat.vmdk?dcPath=Datacenter&dsName=datastore1",, "file.sslverify":"off",, "file.readahead":"64k",, "file.timeout":10}' /tmp/test.qcow2

qemu-system-x86_64 -drive file=/tmp/test.qcow2

Options Bluetooth(MD) :

-bt hc[...]
Définit la fonction du Bluetooth HCI correspondant. les options -bt correspondent à
les HCI présents dans le type de machine choisi. Par exemple lors de l'émulation d'une machine
avec un seul HCI intégré, seule la première option "-bt hci[...]" est valide et
définit la logique du HCI. La couche de transport est décidée par le type de machine.
Actuellement, les machines "n800" et "n810" ont un HCI et toutes les autres machines ont
aucun.

Les trois types suivants sont reconnus :

-bt hci, nul
(par défaut) Le Bluetooth HCI correspondant n'assume aucune logique interne et ne
répondre à toutes les commandes HCI ou émettre des événements.

-bt hci,hôte[:id]
("bluez" uniquement) Le HCI correspondant passe des commandes/événements vers/depuis le
IHM physique identifié par le nom id (par défaut : "hci0") sur l'ordinateur en cours d'exécution
QEMU. Uniquement disponible sur les systèmes compatibles "bluez" comme Linux.

-bt hci[,vlan=n]
Ajoutez un HCI virtuel standard qui participera au scatternet Bluetooth n
(par défaut 0). Similaire à -rapporter VLAN, appareils à l'intérieur d'un réseau Bluetooth n vous
communiquer uniquement avec d'autres appareils du même réseau (scatternet).

-bt vhci[,vlan=n]
(Linux-host uniquement) Créer un HCI dans scatternet n (par défaut 0) attaché à l'hôte
pile bluetooth au lieu de la cible émulée. Cela permet à l'hôte et à la cible
des machines à participer à un scatternet commun et à communiquer. Nécessite Linux
pilote "vhci" installé. Peut être utilisé comme suit :

qemu-system-i386 [...OPTIONS...] -bt hci,vlan=5 -bt vhci,vlan=5

-bt dispositif:dev[,vlan=n]
Émuler un appareil Bluetooth dev et le mettre en réseau n (par défaut 0). QEMU ne peut
émulez actuellement un type d'appareils Bluetooth :

clavier
Clavier sans fil virtuel implémentant le profil Bluetooth HIDP.

Options du périphérique TPM :

La forme générale d'une option de périphérique TPM est :

-tpmdev backend ,identifiant=id [,Options]
Le type de backend doit être : traverser.

Le type de backend spécifique déterminera les options applicables. L'option "-tpmdev"
crée le backend TPM et nécessite une option "-device" qui spécifie le TPM
modèle d'interface frontale.

Les options de chaque backend sont décrites ci-dessous.

Utilisez 'help' pour imprimer tous les types de backend TPM disponibles.

qemu -tpmdev aide

-tpmdev traverser, id =id, chemin =chemin, annuler-chemin=annuler-chemin
(Hôte Linux uniquement) Activez l'accès au TPM de l'hôte à l'aide du pilote passthrough.

chemin spécifie le chemin d'accès au périphérique TPM de l'hôte, c'est-à-dire que sur un hôte Linux, ce serait
"/dev/tpm0". chemin est facultatif et par défaut "/dev/tpm0" est utilisé.

annuler-chemin spécifie le chemin d'accès à l'entrée sysfs du périphérique TPM hôte permettant
annulation d'une commande TPM en cours. annuler-chemin est facultatif et par défaut QEMU
recherchera l'entrée sysfs à utiliser.

Quelques notes sur l'utilisation du TPM de l'hôte avec le pilote passthrough :

Le périphérique TPM auquel accède le pilote passthrough ne doit être utilisé par aucun autre
application sur l'hôte.

Étant donné que le micrologiciel de l'hôte (BIOS/UEFI) a déjà initialisé le TPM, le
firmware (BIOS/UEFI) ne pourra pas réinitialiser le TPM et peut donc
ne pas afficher un menu spécifique au TPM qui permettrait autrement à l'utilisateur de configurer le TPM,
par exemple, permettre à l'utilisateur d'activer/désactiver ou d'activer/désactiver le TPM. De plus, si
La propriété du TPM est libérée à partir d'une machine virtuelle, puis le TPM de l'hôte sera désactivé et
désactivé. Pour activer et réactiver le TPM par la suite, l'hôte doit être
redémarré et l'utilisateur doit entrer dans le menu du firmware pour activer et activer
le TPM. Si le TPM reste désactivé et/ou désactivé, la plupart des commandes TPM échoueront.

Pour créer un TPM passthrough, utilisez les deux options suivantes :

-tpmdev passthrough,id=tpm0 -device tpm-tis,tpmdev=tpm0

Notez que l'identifiant "-tpmdev" est "tpm0" et est référencé par "tpmdev=tpm0" dans le périphérique
option.

Spécifique au démarrage Linux/Multiboot :

Lorsque vous utilisez ces options, vous pouvez utiliser un noyau Linux ou Multiboot donné sans installer
dans l'image disque. Cela peut être utile pour tester plus facilement divers noyaux.

-noyau bzImage
Utilisez bzImage comme image du noyau. Le noyau peut être soit un noyau Linux soit en multiboot
le format.

-ajouter cmdline
Utilisez cmdline comme ligne de commande du noyau

-initrd filet
Utilisez filet comme disque RAM initial.

-initrd "file1 arg=foo,file2"
Cette syntaxe n'est disponible qu'avec le multiboot.

Utilisez file1 et file2 en tant que modules et passez arg=foo en paramètre au premier module.

-dtb filet
Utilisez filet en tant qu'image binaire d'arborescence de périphériques (dtb) et la transmettre au noyau au démarrage.

Options de débogage/expert :

-fw_cfg [nom=]prénom,fichier=filet
Ajoutez l'entrée nommée fw_cfg à partir du fichier. prénom détermine le nom de l'entrée dans le fw_cfg
répertoire de fichiers exposé à l'invité.

-fw_cfg [nom=]prénom,chaîne=str
Ajoutez l'entrée nommée fw_cfg à partir de la chaîne.

-en série dev
Rediriger le port série virtuel vers le périphérique de caractère hôte dev. L'appareil par défaut est
"vc" en mode graphique et "stdio" en mode non graphique.

Cette option peut être utilisée plusieurs fois pour simuler jusqu'à 4 ports série.

Utilisez "-serial none" pour désactiver tous les ports série.

Les périphériques de caractères disponibles sont :

vc[ :WxH]
Console virtuelle. Optionnellement, une largeur et une hauteur peuvent être données en pixel avec

vc:800x600

Il est également possible de spécifier la largeur ou la hauteur en caractères :

vc: 80Cx24C

pty [Linux uniquement] Pseudo TTY (un nouveau PTY est automatiquement attribué)

aucun
Aucun appareil n'est alloué.

nul
appareil vide

chardev :id
Utilisez un périphérique de caractère nommé défini avec l'option "-chardev".

/dev/XXX
[Linux uniquement] Utilisez l'hôte tty, par exemple /dev/ttyS0. Les paramètres du port série hôte sont
réglés en fonction de ceux émulés.

/dev/parportN
[Linux uniquement, port parallèle uniquement] Utiliser le port parallèle hôte N. Actuellement SPP et EPP
des fonctionnalités de port parallèle peuvent être utilisées.

fichier:nom de fichier
Écrire la sortie dans nom de fichier. Aucun caractère ne peut être lu.

stdio
[Unix uniquement] entrée/sortie standard

tuyau:nom de fichier
tuyau de nom nom de fichier

COMn
[Windows uniquement] Utiliser le port série hôte n

udp :[hôte_distant]:port_distant[@[src_ip]:port_src]
Cela implémente UDP Net Console. Lorsque hôte_distant or src_ip ne sont pas spécifiés
ils sont par défaut à 0.0.0.0. Lorsque vous n'utilisez pas un port_src un port aléatoire est
choisi automatiquement.

Si vous voulez juste une simple console en lecture seule, vous pouvez utiliser "netcat" ou "nc", en
en commençant QEMU avec : "-serial udp::4555" et nc comme : "nc -u -l -p 4555". À tout moment
QEMU écrit quelque chose sur ce port, il apparaîtra dans la session netconsole.

Si vous envisagez de renvoyer des personnages via netconsole ou si vous souhaitez arrêter et démarrer
QEMU souvent, vous devriez faire en sorte que QEMU utilise le même port source à chaque fois en
en utilisant quelque chose comme "-serial udp::4555@4556" à QEMU. Une autre approche consiste à utiliser
une version corrigée de netcat qui peut écouter un port TCP et envoyer et recevoir
caractères via udp. Si vous avez une version corrigée de netcat qui active
écho distant telnet et transfert de caractère unique, vous pouvez utiliser ce qui suit
options pour intensifier un redirecteur netcat pour permettre à telnet sur le port 5555 d'accéder au
port QEMU.

« Options QEMU : »
-série udp::4555@4556

"options netcat :"
-u -P 4555 -L 0.0.0.0:4556 -t -p 5555 -I -T

"options telnet :"
localhost 5555

tcp :[hôte]:port[,serveur] [, aujourd'hui] [, nodelay] [, reconnecter =secondes]
La console TCP Net a deux modes de fonctionnement. Il peut envoyer les E/S série à un
emplacement ou attendre une connexion à partir d'un emplacement. Par défaut, la console TCP Net
est envoyé à hôte au port. Si vous utilisez le serveur l'option QEMU attendra un
l'application socket client pour se connecter au port avant de continuer, à moins que le
L'option "nowait" a été spécifiée. L'option "nodelay" désactive la mise en mémoire tampon de Nagle
algorithme. L'option "reconnecter" ne s'applique que si aucun serveur est défini, si le
la connexion tombe en panne, il tentera de se reconnecter à l'intervalle donné. Si hôte
est omis, 0.0.0.0 est supposé. Une seule connexion TCP à la fois est acceptée. Tu
peut utiliser "telnet" pour se connecter au périphérique de caractère correspondant.

"Exemple pour envoyer la console TCP au port 192.168.0.2 4444"
-tcp série : 192.168.0.2 : 4444

"Exemple pour écouter et attendre sur le port 4444 pour la connexion"
-serial tcp::4444,serveur

"Exemple pour ne pas attendre et écouter sur ip 192.168.0.100 port 4444"
-serial tcp:192.168.0.100:4444,serveur,nowait

telnet :hôte:port[,server][,nowait][,nodelay]
Le protocole telnet est utilisé à la place des sockets tcp bruts. Les options fonctionnent de la même manière
comme si vous aviez spécifié "-serial tcp". La différence est que le port agit comme
un serveur ou un client telnet utilisant la négociation d'options telnet. Cela permettra également
vous d'envoyer la séquence MAGIC_SYSRQ si vous utilisez un telnet qui prend en charge l'envoi du
séquence de pause. Typiquement dans unix telnet, vous le faites avec Control-] puis tapez
"envoyer pause" suivi d'une pression sur la touche entrée.

unix :chemin[,serveur][,maintenant][,reconnecter=secondes]
Un socket de domaine unix est utilisé à la place d'un socket tcp. L'option fonctionne de la même manière
comme si vous aviez spécifié "-serial tcp" sauf le socket de domaine unix chemin est utilisé
pour les connexions.

lun:chaîne_dev
Il s'agit d'une option spéciale pour permettre au moniteur d'être multiplexé sur un autre
port série. Le moniteur est accessible avec une séquence de touches de Contrôle-a et alors
pressant c. chaîne_dev doit être l'un des périphériques série spécifiés ci-dessus.
Un exemple pour multiplexer le moniteur sur un serveur telnet écoutant sur le port 4444
serait:

"-serial mon:telnet::4444,server,nowait"

Lorsque le moniteur est multiplexé sur stdio de cette manière, Ctrl+C ne terminera pas
QEMU n'est plus mais sera transmis à l'invité à la place.

braille
Appareil braille. Cela utilisera BrlAPI pour afficher la sortie braille sur un vrai ou
faux appareil.

mssouris
Souris série à trois boutons. Configurez l'invité pour utiliser le protocole Microsoft.

-parallèle dev
Rediriger le port parallèle virtuel vers le périphérique hôte dev (mêmes appareils que la série
Port). Sur les hôtes Linux, /dev/parportN peut être utilisé pour utiliser des périphériques matériels connectés sur
le port parallèle hôte correspondant.

Cette option peut être utilisée plusieurs fois pour simuler jusqu'à 3 ports parallèles.

Utilisez "-parallel none" pour désactiver tous les ports parallèles.

-moniteur dev
Rediriger le moniteur vers le périphérique hôte dev (mêmes appareils que le port série). Les
le périphérique par défaut est "vc" en mode graphique et "stdio" en mode non graphique. Utilisation
"-monitor none" pour désactiver le moniteur par défaut.

-qmp dev
Comme -monitor mais s'ouvre en mode 'contrôle'.

-qmp-joli dev
Comme -qmp mais utilise un joli formatage JSON.

-lun [chardev=]nom[,mode=readline|control][,default]
Moniteur d'installation sur chardev prénom.

-debugcon dev
Rediriger la console de débogage vers le périphérique hôte dev (mêmes appareils que le port série). Les
la console de débogage est un port d'E/S qui est généralement le port 0xe9 ; écrire sur ce port d'E/S
envoie la sortie à cet appareil. Le périphérique par défaut est "vc" en mode graphique et "stdio"
en mode non graphique.

-fichierpid filet
Stockez le PID du processus QEMU dans filet. C'est utile si vous lancez QEMU à partir d'un script.

-un seul pas
Exécutez l'émulation en mode pas à pas.

-S Ne démarrez pas le CPU au démarrage (vous devez taper 'c' dans le moniteur).

-temps réel mlock=activé|désactivé
Exécutez qemu avec des fonctionnalités en temps réel. mlocking qemu et la mémoire invité peuvent être activés via
mlock = activé (activé par défaut).

-gdb dev
Attendre la connexion gdb sur l'appareil dev. Les connexions typiques seront probablement basées sur TCP,
mais aussi UDP, pseudo TTY, ou même stdio sont des cas d'utilisation raisonnables. Ce dernier est
permettant de démarrer QEMU depuis gdb et d'établir la connexion via un pipe :

(gdb) cible à distance | exec qemu-system-i386 -gdb stdio ...

-s Raccourci pour -gdb tcp::1234, c'est-à-dire ouvrir un gdbserver sur le port TCP 1234.

-d item1[,...]
Activer la journalisation des éléments spécifiés. Utilisez « -d help » pour obtenir une liste des éléments de journal.

-D fichier journal
Connexion de sortie fichier journal au lieu de stderr

-L chemin
Définissez le répertoire pour le BIOS, le BIOS VGA et les keymaps.

-bios filet
Définissez le nom de fichier pour le BIOS.

-activer-kvm
Activez la prise en charge complète de la virtualisation KVM. Cette option n'est disponible que si le support KVM
est activé lors de la compilation.

-xen-domid id
Spécifier le domaine invité xen id (XEN uniquement).

-xen-créer
Créez un domaine à l'aide d'hypercalls xen, en contournant xend. Avertissement : ne doit pas être utilisé lorsque
xend est en cours d'utilisation (XEN uniquement).

-xen-attacher
Attachez-vous au domaine xen existant. xend l'utilisera lors du démarrage de QEMU (XEN uniquement).

-pas de redémarrage
Quittez au lieu de redémarrer.

-Pas d'extinction
Ne quittez pas QEMU lors de l'arrêt de l'invité, mais arrêtez uniquement l'émulation. Ceci permet
par exemple, passer au moniteur pour valider les modifications apportées à l'image disque.

-loadvm filet
Commencez tout de suite avec un état enregistré ("loadvm" dans le moniteur)

-démoniser
Démoniser le processus QEMU après l'initialisation. QEMU ne se détachera pas de la norme
IO jusqu'à ce qu'il soit prêt à recevoir des connexions sur l'un de ses appareils. Cette option est un
moyen utile pour les programmes externes de lancer QEMU sans avoir à faire face à
conditions de course à l'initialisation.

-option-rom filet
Chargez le contenu de filet en option ROM. Cette option est utile pour charger des choses comme
EtherBoot.

-rtc [base=utc|heure locale|données][,clock=host|vm][,driftfix=none|slew]
Spécifier base comme "utc" ou "localtime" pour laisser le RTC commencer à l'UTC ou local actuel
temps, respectivement. "localtime" est requis pour la date correcte dans MS-DOS ou Windows. À
commencer à un moment précis, fournir données au format "2006-06-17T16:01:21" ou
"2006-06-17". La base par défaut est UTC.

Par défaut, le RTC est piloté par l'heure du système hôte. Cela permet d'utiliser le RTC comme
horloge de référence précise à l'intérieur de l'invité, en particulier si l'heure de l'hôte est fluide
suivant une horloge de référence externe précise, par exemple via NTP. Si vous voulez vous isoler
l'heure de l'invité de l'hôte, vous pouvez définir horloge à "rt" à la place. Pour même l'empêcher
de progresser pendant la suspension, vous pouvez le définir sur "vm".

Activer correction de dérive (cibles i386 uniquement) si vous rencontrez des problèmes de dérive temporelle,
spécifiquement avec l'ACPI HAL de Windows. Cette option essaiera de déterminer combien de minuterie
les interruptions n'ont pas été traitées par l'invité Windows et les réinjecteront.

-Je compte [décalage=N|auto][,rr=enregistrement|rejouer,rrfile=nom de fichier]
Activer le compteur d'instructions virtuelles. Le processeur virtuel exécutera une instruction
tous les 2^N ns de temps virtuel. Si "auto" est spécifié, la vitesse du processeur virtuel sera
être automatiquement ajusté pour garder le temps virtuel à quelques secondes du temps réel.

Lorsque le processeur virtuel est en veille, le temps virtuel avancera à la vitesse par défaut
à moins que dormir=non est spécifié. Avec dormir=non, l'heure virtuelle passera à la suivante
délai de la minuterie instantanément chaque fois que le processeur virtuel passe en mode veille et ne
avance si aucune minuterie n'est activée. Ce comportement donne des temps d'exécution déterministes de
le point de vue de l'invité.

Notez que bien que cette option puisse donner un comportement déterministe, elle ne fournit pas de cycle
émulation précise. Les processeurs modernes contiennent des cœurs superscalaires en panne avec des
hiérarchies de cache. Le nombre d'instructions exécutées a souvent peu ou pas
corrélation avec les performances réelles.

aligner=on activera l'algorithme de délai qui tentera de synchroniser l'hôte
l'horloge et l'horloge virtuelle. L'objectif est d'avoir un invité fonctionnant à la fréquence réelle
imposée par l'option de décalage. Chaque fois que l'horloge de l'invité est en retard sur l'horloge de l'hôte et si
aligner=on est spécifié, puis nous imprimons un message à l'utilisateur pour l'informer du retard.
Actuellement, cette option ne fonctionne pas lorsque décalage est "auto". Remarque : L'algorithme de synchronisation
fonctionnera pour les valeurs de décalage pour lesquelles l'horloge de l'invité est en avance sur l'hôte
l'horloge. Cela se produit généralement lorsque la valeur de décalage est élevée (la valeur dépend de la
machine hôte).

Quand rr l'option est spécifiée. L'enregistrement/relecture déterministe est activé. Le journal de relecture est
écrit dans nom de fichier fichier en mode enregistrement et lire à partir de ce fichier en mode relecture.

-chien de garde modèle
Créez un périphérique de chien de garde matériel virtuel. Une fois activé (par une action d'invité), le
chien de garde doit être périodiquement interrogé par un agent à l'intérieur de l'invité ou bien l'invité
sera redémarré. Choisissez un modèle pour lequel votre invité a des chauffeurs.

Votre modèle est le modèle de chien de garde matériel à émuler. Utilisez "-watchdog help" pour lister
modèles de matériel disponibles. Un seul chien de garde peut être activé pour un invité.

Les modèles suivants peuvent être disponibles :

ib700
iBASE 700 est un chien de garde ISA très simple avec une seule minuterie.

i6300esb
Le concentrateur de contrôleur d'E/S Intel 6300ESB est un double temporisateur PCI beaucoup plus fonctionnel
chien de garde.

diag288
Un chien de garde virtuel pour s390x soutenu par l'hypercall de diagnostic 288 (actuellement KVM
seulement).

-chien de garde-action action
Votre action contrôle ce que QEMU fera lorsque le temporisateur de surveillance expire. La valeur par défaut est
"reset" (réinitialisation forcée de l'invité). Les autres actions possibles sont : « shutdown » (tentative
pour arrêter gracieusement l'invité), "poweroff" (mettre l'invité hors tension de force), "pause"
(mettre l'invité en pause), "debug" (imprimer un message de débogage et continuer) ou "aucun" (faire
rien).

Notez que l'action « shutdown » nécessite que l'invité réponde aux signaux ACPI,
ce qu'il peut ne pas être en mesure de faire dans le genre de situations où le chien de garde aurait
expiré, et donc "-watchdog-action shutdown" n'est pas recommandé pour une utilisation en production.

Exemples :

"-watchdog i6300esb -watchdog-action pause"
"-chien de garde ib700"
-echr valeur_ascii_numérique
Modifiez le caractère d'échappement utilisé pour basculer vers le moniteur lors de l'utilisation du moniteur et
partage en série. La valeur par défaut est 0x01 lors de l'utilisation de l'option "-nographic". 0x01 est
équivaut à appuyer sur "Contrôle-a". Vous pouvez sélectionner un caractère différent de l'ASCII
touches de contrôle où 1 à 26 correspondent à Control-a à Control-z. Par exemple vous
peut utiliser l'un des éléments suivants pour remplacer le caractère d'échappement par Control-t.

"-echr 0x14"
"-echr 20"
-console virtio c
Réglez la console virtuelle.

Cette option est conservée pour la compatibilité descendante.

Veuillez utiliser "-device virtconsole" pour le nouveau mode d'invocation.

-afficher-curseur
Afficher le curseur.

-tb-taille n
Définir la taille de la To.

-entrant tcp :[hôte]:port[,à=port max][,ipv4][,ipv6]
-entrant rdma :hôte:port[,ipv4][,ipv6]
Préparez-vous à la migration entrante, écoutez sur un port TCP donné.

-entrant unix :chemin de socket
Préparez-vous à la migration entrante, écoutez sur un socket Unix donné.

-entrant fd :fd
Accepter la migration entrante à partir d'un descripteur de fichier donné.

-entrant exe :cmdline
Acceptez la migration entrante en tant que sortie de la commande externe spécifiée.

-entrant reporter
Attendez que l'URI soit spécifié via migrate_incoming. Le moniteur peut être utilisé pour
modifier les paramètres (tels que les paramètres de migration) avant d'émettre le migrate_incoming
pour permettre à la migration de commencer.

-défauts de nœud
Ne créez pas d'appareils par défaut. Normalement, QEMU définit les périphériques par défaut comme série
port, port parallèle, console virtuelle, périphérique moniteur, adaptateur VGA, disquette et CD-ROM
conduire et autres. L'option "-nodefaults" désactivera tous ces périphériques par défaut.

-chroot dir
Immédiatement avant de démarrer l'exécution de l'invité, effectuez un chroot dans le répertoire spécifié.
Particulièrement utile en combinaison avec -runas.

-courir comme utilisateur
Immédiatement avant de commencer l'exécution de l'invité, supprimez les privilèges root, en passant au
utilisateur spécifié.

-prom-env variable=Plus-value
Définir OpenBIOS nvram variable donner Plus-value (PPC, SPARC uniquement).

-semi-hébergement
Activez le mode semi-hébergement (ARM, M68K, Xtensa, MIPS uniquement).

-semihosting-config [enable=on|off][,target=native|gdb|auto][,arg=str[,...]]
Activer et configurer le semi-hébergement (ARM, M68K, Xtensa, MIPS uniquement).

cible="native|gdb|auto"
Définit où les appels de semi-hébergement seront adressés, à QEMU ("native") ou à
GDB ("gdb"). La valeur par défaut est "auto", ce qui signifie "gdb" pendant les sessions de débogage et
"natif" sinon.

argument=str1,argument=str2...
Permet à l'utilisateur de passer des arguments d'entrée et peut être utilisé plusieurs fois pour construire
une liste. L'ancienne méthode "-kernel"/"-append" pour passer une ligne de commande est
toujours pris en charge pour la compatibilité descendante. Si à la fois le "--semihosting-config arg"
et le "-kernel"/"-append" sont spécifiés, le premier est passé à semihosting comme
il a toujours la priorité.

-vieux-param
Ancien mode param (ARM uniquement).

-bac à sable arg
Activez le filtre d'appel système Seccomp mode 2. 'on' activera le filtrage des appels système et 'off'
le désactivera. La valeur par défaut est « désactivé ».

-readconfig filet
Lire la configuration de l'appareil depuis filet. Cette approche est utile lorsque vous souhaitez générer
Processus QEMU avec de nombreuses options de ligne de commande mais vous ne voulez pas dépasser la commande
limite de caractères de ligne.

-writeconfig filet
Écrire la configuration de l'appareil dans filetL’ filet peut être soit le nom de fichier pour enregistrer la commande
ligne et configuration de l'appareil dans un fichier ou un tiret "-") pour imprimer la sortie vers
sortie standard. Cela peut être utilisé plus tard comme fichier d'entrée pour l'option "-readconfig".

-nodefconfig
Normalement, QEMU charge les fichiers de configuration à partir de rép.sysconf et répertoire de données au démarrage. Les
L'option "-nodefconfig" empêchera QEMU de charger l'un de ces fichiers de configuration.

-pas de configuration utilisateur
L'option "-no-user-config" empêche QEMU de charger les fichiers de configuration fournis par l'utilisateur
on rép.sysconf, mais ne lui fera pas sauter les fichiers de configuration fournis par QEMU de répertoire de données.

-tracer [événements=filet][,fichier=filet]
Spécifiez les options de traçage.

événements =filet
Activer immédiatement les événements répertoriés dans filet. Le fichier doit contenir un nom d'événement
(comme indiqué dans le traces-événements fichier) par ligne. Cette option n'est disponible que si
QEMU a été compilé avec soit simple or stderr backend de traçage.

fichier=filet
Consigner les traces de sortie vers filet.

Cette option n'est disponible que si QEMU a été compilé avec le simple traçant
arrière-plan.

-activer-fips
Activez le mode de conformité FIPS 140-2.

- msg horodatage[=on|off]
ajouter un horodatage à chaque message de journal. (par défaut : on)

-dump-vmstate filet
Vider les informations vmstate codées en json pour le type de machine actuel dans le fichier filet Générique
création d'objet

-objet nom de type[,prop1=value1,...]
Créer un nouvel objet de type nom de type définir les propriétés dans l'ordre dans lequel elles sont
spécifié. Notez que la propriété 'id' doit être définie. Ces objets sont placés dans le
Chemin '/objets'.

-objet fichier-backend-mémoire,id=id,taille=Taille,chemin-mém=dir,partager=on | off
Crée un objet backend de fichier mémoire, qui peut être utilisé pour sauvegarder la RAM invitée avec
pages énormes. Les id le paramètre est un identifiant unique qui sera utilisé pour référencer ce
région de mémoire lors de la configuration du -numa argument. le Taille l'option fournit le
taille de la région de mémoire, et accepte les suffixes communs, par exemple 500ML’ chemin-mem
fournit le chemin d'accès à une mémoire partagée ou à un montage de système de fichiers de grande page. Les
share L'option booléenne détermine si la région de mémoire est marquée comme privée pour
QEMU, ou partagé. Ce dernier permet à un processus externe coopérant d'accéder au
Région mémoire QEMU.

-objet rng-aléatoire,id=id,nom de fichier=/ dev / aléatoire
Crée un backend générateur de nombres aléatoires qui obtient l'entropie d'un appareil sur
l'hôte. Les id le paramètre est un identifiant unique qui sera utilisé pour référencer ce
backend d'entropie du virtio-rng dispositif. le nom de fichier paramètre spécifie quel
fichier pour obtenir l'entropie de et s'il est omis, la valeur par défaut est / dev / aléatoire.

-objet rng-egd,id=id,chardev=chardevid
Crée un backend générateur de nombres aléatoires qui obtient l'entropie d'un externe
démon s'exécutant sur l'hôte. Les id le paramètre est un identifiant unique qui sera utilisé pour
référencer ce backend d'entropie à partir du virtio-rng dispositif. le chardev paramètre
est l'identifiant unique d'un backend de périphérique de caractère qui fournit la connexion au
Démon RNG.

-objet
tls-creds-anon,id=id,extrémité=point final,rep=/chemin/vers/cred/dir,vérifier-pair=on | off
Crée un objet d'informations d'identification anonyme TLS, qui peut être utilisé pour fournir TLS
support sur les backends réseau. Les id le paramètre est un identifiant unique dont le réseau
les backends utiliseront pour accéder aux informations d'identification. Les point final est soit serveur or
client selon que le backend du réseau QEMU qui utilise les informations d'identification
agira en tant que client ou en tant que serveur. Si vérifier-pair est activé (par défaut)
puis une fois la poignée de main terminée, les informations d'identification des pairs seront vérifiées,
bien qu'il s'agisse d'une non-opération pour les informations d'identification anonymes.

Votre dir Le paramètre indique à QEMU où trouver les fichiers d'informations d'identification. Pour serveur
points de terminaison, ce répertoire peut contenir un fichier dh-params.pem fournir diffie-
paramètres hellman à utiliser pour le serveur TLS. Si le fichier est manquant, QEMU
générer un ensemble de paramètres DH au démarrage. C'est un calcul coûteux
opération qui consomme l'entropie de pool aléatoire, il est donc recommandé qu'un
un ensemble persistant de paramètres soit généré à l'avance et enregistré.

-objet
tls-creds-x509,id=id,extrémité=point final,rep=/chemin/vers/cred/dir,vérifier-pair=on | off
Crée un objet d'informations d'identification anonyme TLS, qui peut être utilisé pour fournir TLS
support sur les backends réseau. Les id le paramètre est un identifiant unique dont le réseau
les backends utiliseront pour accéder aux informations d'identification. Les point final est soit serveur or
client selon que le backend du réseau QEMU qui utilise les informations d'identification
agira en tant que client ou en tant que serveur. Si vérifier-pair est activé (par défaut)
puis une fois la poignée de main terminée, les informations d'identification des pairs seront vérifiées. Avec
x509, cela implique que les clients doivent disposer de certificats valides
certificats clients aussi.

Votre dir Le paramètre indique à QEMU où trouver les fichiers d'informations d'identification. Pour serveur
points de terminaison, ce répertoire peut contenir un fichier dh-params.pem fournir diffie-
paramètres hellman à utiliser pour le serveur TLS. Si le fichier est manquant, QEMU
générer un ensemble de paramètres DH au démarrage. C'est un calcul coûteux
opération qui consomme l'entropie de pool aléatoire, il est donc recommandé qu'un
un ensemble persistant de paramètres soit généré à l'avance et enregistré.

Pour les informations d'identification du certificat x509, le répertoire contiendra d'autres fichiers
fournissant les certificats x509. Les certificats doivent être stockés au format PEM, dans
noms de fichiers ca-cert.pem, ca-crl.pem (optionnel), serveur-cert.pem (serveurs uniquement),
clé-serveur.pem (serveurs uniquement), certificat-client.pem (clients uniquement), et clé-client.pem
(uniquement les clients).

-objet filtre-tampon, id=id,netdev=netdevid,intervalle=t[,file d'attente=tout|rx|tx]
intervalle t ne peut pas être égal à 0, ce filtre regroupe la livraison des paquets : tous les paquets
arriver dans un intervalle donné sur netdev netdevid sont retardés jusqu'à la fin de la
intervalle. L'intervalle est en microsecondes.

file tout|rx|tx est une option qui peut être appliquée à n'importe quel netfilter.

tous: le filtre est attaché à la fois à la file d'attente de réception et d'émission du
netdev (par défaut).

rx: le filtre est attaché à la file d'attente de réception du netdev, où il sera
recevoir les paquets envoyés au netdev.

tx: le filtre est attaché à la file d'attente de transmission du netdev, où il sera
recevoir les paquets envoyés par le netdev.

-objet vidage-filtre, id=id,netdev=dev,fichier=nom de fichier][,maxlen=len]
Vider le trafic réseau sur netdev dev au fichier spécifié par nom de fichier. Au plus
len octets (64 Ko par défaut) par paquet sont stockés. Le format de fichier est libpcap, donc
il peut être analysé avec des outils tels que tcpdump ou Wireshark.

Pendant l'émulation graphique, vous pouvez utiliser des combinaisons de touches spéciales pour changer de mode. Les
les mappages de touches par défaut sont indiqués ci-dessous, mais si vous utilisez "-alt-grab", le modificateur est
Ctrl-Alt-Shift (au lieu de Ctrl-Alt) et si vous utilisez "-ctrl-grab" alors le modificateur est le
touche Ctrl droite (au lieu de Ctrl-Alt) :

Ctrl-Alt-f
Passer en plein écran

Ctrl-Alt-+
Agrandir l'écran

Ctrl-Alt--
Réduisez l'écran

Ctrl-Alt-u
Restaurer les dimensions non mises à l'échelle de l'écran

Ctrl-Alt-n
Basculez vers la console virtuelle 'n'. Les mappages de console standard sont :

1 Affichage du système cible

2 Surveiller des

3 Le port série

Ctrl-Alt
Basculez la saisie de la souris et du clavier.

Dans les consoles virtuelles, vous pouvez utiliser Ctrl-Haut, Ctrl-Bas, Ctrl-Page Up et Ctrl-PageBas à
déplacer dans le journal arrière.

Pendant l'émulation, si vous utilisez le -nographique option, utiliser Ctrl h obtenir un terminal
commandes:

Ctrl h
Ctrl ?
Imprimer cette aide

Ctrl x
Quitter l'émulateur

Ctrl s
Enregistrer les données du disque dans un fichier (si -snapshot)

Ctrl t
Basculer les horodatages de la console

Ctrl b
Envoyer une pause (magic sysrq sous Linux)

Ctrl c
Basculer entre la console et le moniteur

Ctrl Ctrl
Envoyer Ctrl-a

Les options suivantes sont spécifiques à l'émulation PowerPC :

-g WxH[xPROFONDEUR]
Définissez le mode graphique VGA initial. La valeur par défaut est 800x600x32.

-prom-env un magnifique
Définissez les variables OpenBIOS dans la NVRAM, par exemple :

qemu-system-ppc -prom-env 'auto-boot?=false' \
-prom-env 'boot-device=hd:2,\yaboot' \
-prom-env 'boot-args=conf=hd:2,\yaboot.conf'

Ces variables ne sont pas utilisées par Open Hack'Ware.

Les options suivantes sont spécifiques à l'émulation Sparc32 :

-g WxHx[xPROFONDEUR]
Définissez le mode graphique initial. Pour TCX, la valeur par défaut est 1024x768x8 avec l'option de
1024x768x24. Pour cgthree, la valeur par défaut est 1024x768x8 avec l'option de 1152x900x8 pour
les personnes qui souhaitent utiliser OBP.

-prom-env un magnifique
Définissez les variables OpenBIOS dans la NVRAM, par exemple :

qemu-system-sparc -prom-env 'auto-boot?=false' \
-prom-env 'boot-device=sd(0,2,0):d' -prom-env 'boot-args=linux single'

-M [SS-4|SS-5|SS-10|SS-20|SS-600MP|LX|Voyager|SPARCClassic] [|Livre SPARC]
Définissez le type de machine émulée. La valeur par défaut est SS-5.

Les options suivantes sont spécifiques à l'émulation Sparc64 :

-prom-env un magnifique
Définissez les variables OpenBIOS dans la NVRAM, par exemple :

qemu-system-sparc64 -prom-env 'auto-boot?=false'

-M [sun4u|sun4v|Niagara]
Définissez le type de machine émulée. La valeur par défaut est sun4u.

Utilisez qemu-system-unicore32 en ligne à l'aide des services onworks.net