14.5. Gestion des périphériques USB virtuels
Lorsque vous utilisez une machine virtuelle (VM), vous pouvez accéder à un périphérique USB, tel qu'une clé USB ou une caméra Web, qui est connecté au système hôte, et le contrôler. Dans ce scénario, le système hôte transmet le contrôle du périphérique à la machine virtuelle. C'est ce que l'on appelle un USB-passthrough.
Les sections suivantes fournissent des informations sur l'utilisation de la ligne de commande pour :
- Attacher un périphérique USB à une VM
- Supprimer un périphérique USB d'une VM
14.5.1. Attacher des périphériques USB à des machines virtuelles
Pour attacher un périphérique USB à une machine virtuelle (VM), vous pouvez inclure les informations relatives au périphérique USB dans le fichier de configuration XML de la VM.
Conditions préalables
- Assurez-vous que le périphérique que vous souhaitez transférer à la VM est connecté à l'hôte.
Procédure
Localisez les valeurs de bus et de périphérique de l'USB que vous souhaitez connecter à la VM.
Par exemple, la commande suivante affiche la liste des périphériques USB connectés à l'hôte. Le périphérique que nous utiliserons dans cet exemple est connecté au bus 001 en tant que périphérique 005.
# lsusb [...] Bus 001 Device 003: ID 2567:0a2b Intel Corp. Bus 001 Device 005: ID 0407:6252 Kingston River 2.0 [...]Utilisez l'utilitaire
virt-xmlavec l'argument--add-device.Par exemple, la commande suivante permet d'attacher une clé USB à la VM
example-VM-1.# virt-xml example-VM-1 --add-device --hostdev 001.005 Domain 'example-VM-1' defined successfully.
Pour attacher un périphérique USB à une VM en cours d'exécution, ajoutez l'argument --update à la commande précédente.
Vérification
- Exécutez la VM et vérifiez si l'appareil est présent et s'il fonctionne comme prévu.
Utilisez la commande
virsh dumpxmlpour vérifier si la définition XML du dispositif a été ajoutée à la section <devices> du fichier de configuration XML de la VM.# virsh dumpxml example-VM-1 [...] <hostdev mode='subsystem' type='usb' managed='yes'> <source> <vendor id='0x0407'/> <product id='0x6252'/> <address bus='1' device='5'/> </source> <alias name='hostdev0'/> <address type='usb' bus='0' port='3'/> </hostdev> [...]
Ressources supplémentaires
-
La page de manuel
virt-xml (1) - Attacher des périphériques aux machines virtuelles
14.5.2. Suppression des périphériques USB des machines virtuelles
Pour supprimer un périphérique USB d'une machine virtuelle (VM), vous pouvez supprimer les informations relatives au périphérique USB de la configuration XML de la VM.
Procédure
Localisez les valeurs de bus et de périphérique de l'USB que vous souhaitez supprimer de la VM.
Par exemple, la commande suivante affiche la liste des périphériques USB connectés à l'hôte. Le périphérique que nous utiliserons dans cet exemple est connecté au bus 001 en tant que périphérique 005.
# lsusb [...] Bus 001 Device 003: ID 2567:0a2b Intel Corp. Bus 001 Device 005: ID 0407:6252 Kingston River 2.0 [...]Utilisez l'utilitaire
virt-xmlavec l'argument--remove-device.Par exemple, la commande suivante supprime une clé USB, attachée à l'hôte en tant que périphérique 005 sur le bus 001, de la VM
example-VM-1.# virt-xml example-VM-1 --remove-device --hostdev 001.005 Domain 'example-VM-1' defined successfully.
Pour supprimer un périphérique USB d'une VM en cours d'exécution, ajoutez l'argument --update à la commande précédente.
Vérification
- Exécutez la VM et vérifiez si l'appareil a été supprimé de la liste des appareils.
Ressources supplémentaires
-
La page de manuel
virt-xml (1) - Attacher des périphériques aux machines virtuelles
