Statistics
| Branch: | Revision:

root / docs / usb-storage.txt @ ff5928d0

History | View | Annotate | Download (1.4 kB)

1

    
2
qemu usb storage emulation
3
--------------------------
4

    
5
QEMU has two emulations for usb storage devices.
6

    
7
Number one emulates the classic bulk-only transport protocol which is
8
used by 99% of the usb sticks on the marked today and is called
9
"usb-storage".  Usage (hooking up to xhci, other host controllers work
10
too):
11

    
12
  qemu ${other_vm_args}                                \
13
       -drive if=none,id=stick,file=/path/to/file.img  \
14
       -device nec-usb-xhci,id=xhci                    \
15
       -device usb-storage,bus=xhci.0,drive=stick
16

    
17

    
18
Number two is the newer usb attached scsi transport.  This one doesn't
19
automagically create a scsi disk, so you have to explicitly attach one
20
manually.  Multiple logical units are supported.  Here is an example
21
with tree logical units:
22

    
23
  qemu ${other_vm_args}                                                \
24
       -drive if=none,id=uas-disk1,file=/path/to/file1.img             \
25
       -drive if=none,id=uas-disk2,file=/path/to/file2.img             \
26
       -drive if=none,id=uas-cdrom,media=cdrom,file=/path/to/image.iso \
27
       -device nec-usb-xhci,id=xhci                                    \
28
       -device usb-uas,id=uas,bus=xhci.0                               \
29
       -device scsi-hd,bus=uas.0,scsi-id=0,lun=0,drive=uas-disk1       \
30
       -device scsi-hd,bus=uas.0,scsi-id=0,lun=1,drive=uas-disk2       \
31
       -device scsi-cd,bus=uas.0,scsi-id=0,lun=5,drive=uas-cdrom
32

    
33

    
34
enjoy,
35
  Gerd
36

    
37
--
38
Gerd Hoffmann <kraxel@redhat.com>