Statistics
| Branch: | Tag: | Revision:

root / test / data / kvm_1.0_help.txt @ 5030cff3

History | View | Annotate | Download (13.5 kB)

1 585c8187 Guido Trotter
QEMU emulator version 1.0 (qemu-kvm-1.0 Debian 1.0+dfsg-2), Copyright (c) 2003-2008 Fabrice Bellard
2 585c8187 Guido Trotter
usage: qemu [options] [disk_image]
3 585c8187 Guido Trotter
4 585c8187 Guido Trotter
'disk_image' is a raw hard disk image for IDE hard disk 0
5 585c8187 Guido Trotter
6 585c8187 Guido Trotter
Standard options:
7 585c8187 Guido Trotter
-h or -help     display this help and exit
8 585c8187 Guido Trotter
-version        display version information and exit
9 585c8187 Guido Trotter
-machine [type=]name[,prop[=value][,...]]
10 585c8187 Guido Trotter
                selects emulated machine (-machine ? for list)
11 585c8187 Guido Trotter
                property accel=accel1[:accel2[:...]] selects accelerator
12 585c8187 Guido Trotter
                supported accelerators are kvm, xen, tcg (default: tcg)
13 585c8187 Guido Trotter
-cpu cpu        select CPU (-cpu ? for list)
14 585c8187 Guido Trotter
-smp n[,maxcpus=cpus][,cores=cores][,threads=threads][,sockets=sockets]
15 585c8187 Guido Trotter
                set the number of CPUs to 'n' [default=1]
16 585c8187 Guido Trotter
                maxcpus= maximum number of total cpus, including
17 585c8187 Guido Trotter
                offline CPUs for hotplug, etc
18 585c8187 Guido Trotter
                cores= number of CPU cores on one socket
19 585c8187 Guido Trotter
                threads= number of threads on one CPU core
20 585c8187 Guido Trotter
                sockets= number of discrete sockets in the system
21 585c8187 Guido Trotter
-numa node[,mem=size][,cpus=cpu[-cpu]][,nodeid=node]
22 585c8187 Guido Trotter
-fda/-fdb file  use 'file' as floppy disk 0/1 image
23 585c8187 Guido Trotter
-hda/-hdb file  use 'file' as IDE hard disk 0/1 image
24 585c8187 Guido Trotter
-hdc/-hdd file  use 'file' as IDE hard disk 2/3 image
25 585c8187 Guido Trotter
-cdrom file     use 'file' as IDE cdrom image (cdrom is ide1 master)
26 585c8187 Guido Trotter
-drive [file=file][,if=type][,bus=n][,unit=m][,media=d][,index=i]
27 585c8187 Guido Trotter
       [,cyls=c,heads=h,secs=s[,trans=t]][,snapshot=on|off]
28 585c8187 Guido Trotter
       [,cache=writethrough|writeback|none|directsync|unsafe][,format=f]
29 585c8187 Guido Trotter
       [,serial=s][,addr=A][,id=name][,aio=threads|native]
30 585c8187 Guido Trotter
       [,readonly=on|off]
31 585c8187 Guido Trotter
                use 'file' as a drive image
32 585c8187 Guido Trotter
-set group.id.arg=value
33 585c8187 Guido Trotter
                set <arg> parameter for item <id> of type <group>
34 585c8187 Guido Trotter
                i.e. -set drive.$id.file=/path/to/image
35 585c8187 Guido Trotter
-global driver.property=value
36 585c8187 Guido Trotter
                set a global default for a driver property
37 585c8187 Guido Trotter
-mtdblock file  use 'file' as on-board Flash memory image
38 585c8187 Guido Trotter
-sd file        use 'file' as SecureDigital card image
39 585c8187 Guido Trotter
-pflash file    use 'file' as a parallel flash image
40 585c8187 Guido Trotter
-boot [order=drives][,once=drives][,menu=on|off]
41 585c8187 Guido Trotter
      [,splash=sp_name][,splash-time=sp_time]
42 585c8187 Guido Trotter
                'drives': floppy (a), hard disk (c), CD-ROM (d), network (n)
43 585c8187 Guido Trotter
                'sp_name': the file's name that would be passed to bios as logo picture, if menu=on
44 585c8187 Guido Trotter
                'sp_time': the period that splash picture last if menu=on, unit is ms
45 585c8187 Guido Trotter
-snapshot       write to temporary files instead of disk image files
46 585c8187 Guido Trotter
-m megs         set virtual RAM size to megs MB [default=128]
47 585c8187 Guido Trotter
-mem-path FILE  provide backing storage for guest RAM
48 585c8187 Guido Trotter
-mem-prealloc   preallocate guest memory (use with -mem-path)
49 585c8187 Guido Trotter
-k language     use keyboard layout (for example 'fr' for French)
50 585c8187 Guido Trotter
-audio-help     print list of audio drivers and their options
51 585c8187 Guido Trotter
-soundhw c1,... enable audio support
52 585c8187 Guido Trotter
                and only specified sound cards (comma separated list)
53 585c8187 Guido Trotter
                use -soundhw ? to get the list of supported cards
54 585c8187 Guido Trotter
                use -soundhw all to enable all of them
55 585c8187 Guido Trotter
-usb            enable the USB driver (will be the default soon)
56 585c8187 Guido Trotter
-usbdevice name add the host or guest USB device 'name'
57 585c8187 Guido Trotter
-device driver[,prop[=value][,...]]
58 585c8187 Guido Trotter
                add device (based on driver)
59 585c8187 Guido Trotter
                prop=value,... sets driver properties
60 585c8187 Guido Trotter
                use -device ? to print all possible drivers
61 585c8187 Guido Trotter
                use -device driver,? to print all possible properties
62 585c8187 Guido Trotter
63 585c8187 Guido Trotter
File system options:
64 585c8187 Guido Trotter
-fsdev fsdriver,id=id,path=path,[security_model={mapped|passthrough|none}]
65 585c8187 Guido Trotter
       [,writeout=immediate][,readonly]
66 585c8187 Guido Trotter
67 585c8187 Guido Trotter
Virtual File system pass-through options:
68 585c8187 Guido Trotter
-virtfs local,path=path,mount_tag=tag,security_model=[mapped|passthrough|none]
69 585c8187 Guido Trotter
        [,writeout=immediate][,readonly]
70 585c8187 Guido Trotter
-virtfs_synth Create synthetic file system image
71 585c8187 Guido Trotter
72 585c8187 Guido Trotter
-name string1[,process=string2]
73 585c8187 Guido Trotter
                set the name of the guest
74 585c8187 Guido Trotter
                string1 sets the window title and string2 the process name (on Linux)
75 585c8187 Guido Trotter
-uuid %08x-%04x-%04x-%04x-%012x
76 585c8187 Guido Trotter
                specify machine UUID
77 585c8187 Guido Trotter
78 585c8187 Guido Trotter
Display options:
79 585c8187 Guido Trotter
-display sdl[,frame=on|off][,alt_grab=on|off][,ctrl_grab=on|off]
80 585c8187 Guido Trotter
            [,window_close=on|off]|curses|none|
81 585c8187 Guido Trotter
            vnc=<display>[,<optargs>]
82 585c8187 Guido Trotter
                select display type
83 585c8187 Guido Trotter
-nographic      disable graphical output and redirect serial I/Os to console
84 585c8187 Guido Trotter
-curses         use a curses/ncurses interface instead of SDL
85 585c8187 Guido Trotter
-no-frame       open SDL window without a frame and window decorations
86 585c8187 Guido Trotter
-alt-grab       use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt)
87 585c8187 Guido Trotter
-ctrl-grab      use Right-Ctrl to grab mouse (instead of Ctrl-Alt)
88 585c8187 Guido Trotter
-no-quit        disable SDL window close capability
89 585c8187 Guido Trotter
-sdl            enable SDL
90 585c8187 Guido Trotter
-spice <args>   enable spice
91 585c8187 Guido Trotter
-portrait       rotate graphical output 90 deg left (only PXA LCD)
92 585c8187 Guido Trotter
-rotate <deg>   rotate graphical output some deg left (only PXA LCD)
93 585c8187 Guido Trotter
-vga [std|cirrus|vmware|qxl|xenfb|none]
94 585c8187 Guido Trotter
                select video card type
95 585c8187 Guido Trotter
-full-screen    start in full screen
96 585c8187 Guido Trotter
-g WxH[xDEPTH]  Set the initial graphical resolution and depth
97 585c8187 Guido Trotter
-vnc display    start a VNC server on display
98 585c8187 Guido Trotter
99 585c8187 Guido Trotter
i386 target only:
100 585c8187 Guido Trotter
-win2k-hack     use it when installing Windows 2000 to avoid a disk full bug
101 585c8187 Guido Trotter
-no-fd-bootchk  disable boot signature checking for floppy disks
102 585c8187 Guido Trotter
-no-acpi        disable ACPI
103 585c8187 Guido Trotter
-no-hpet        disable HPET
104 585c8187 Guido Trotter
-balloon none   disable balloon device
105 585c8187 Guido Trotter
-balloon virtio[,addr=str]
106 585c8187 Guido Trotter
                enable virtio balloon device (default)
107 585c8187 Guido Trotter
-acpitable [sig=str][,rev=n][,oem_id=str][,oem_table_id=str][,oem_rev=n][,asl_compiler_id=str][,asl_compiler_rev=n][,{data|file}=file1[:file2]...]
108 585c8187 Guido Trotter
                ACPI table description
109 585c8187 Guido Trotter
-smbios file=binary
110 585c8187 Guido Trotter
                load SMBIOS entry from binary file
111 585c8187 Guido Trotter
-smbios type=0[,vendor=str][,version=str][,date=str][,release=%d.%d]
112 585c8187 Guido Trotter
                specify SMBIOS type 0 fields
113 585c8187 Guido Trotter
-smbios type=1[,manufacturer=str][,product=str][,version=str][,serial=str]
114 585c8187 Guido Trotter
              [,uuid=uuid][,sku=str][,family=str]
115 585c8187 Guido Trotter
                specify SMBIOS type 1 fields
116 585c8187 Guido Trotter
117 585c8187 Guido Trotter
Network options:
118 585c8187 Guido Trotter
-net nic[,vlan=n][,macaddr=mac][,model=type][,name=str][,addr=str][,vectors=v]
119 585c8187 Guido Trotter
                create a new Network Interface Card and connect it to VLAN 'n'
120 585c8187 Guido Trotter
-net user[,vlan=n][,name=str][,net=addr[/mask]][,host=addr][,restrict=on|off]
121 585c8187 Guido Trotter
         [,hostname=host][,dhcpstart=addr][,dns=addr][,tftp=dir][,bootfile=f]
122 585c8187 Guido Trotter
         [,hostfwd=rule][,guestfwd=rule][,smb=dir[,smbserver=addr]]
123 585c8187 Guido Trotter
                connect the user mode network stack to VLAN 'n', configure its
124 585c8187 Guido Trotter
                DHCP server and enabled optional services
125 585c8187 Guido Trotter
-net tap[,vlan=n][,name=str][,fd=h][,ifname=name][,script=file][,downscript=dfile][,sndbuf=nbytes][,vnet_hdr=on|off][,vhost=on|off][,vhostfd=h][,vhostforce=on|off]
126 585c8187 Guido Trotter
                connect the host TAP network interface to VLAN 'n' and use the
127 585c8187 Guido Trotter
                network scripts 'file' (default=/etc/kvm/kvm-ifup)
128 585c8187 Guido Trotter
                and 'dfile' (default=/etc/kvm/kvm-ifdown)
129 585c8187 Guido Trotter
                use '[down]script=no' to disable script execution
130 585c8187 Guido Trotter
                use 'fd=h' to connect to an already opened TAP interface
131 585c8187 Guido Trotter
                use 'sndbuf=nbytes' to limit the size of the send buffer (the
132 585c8187 Guido Trotter
                default is disabled 'sndbuf=0' to enable flow control set 'sndbuf=1048576')
133 585c8187 Guido Trotter
                use vnet_hdr=off to avoid enabling the IFF_VNET_HDR tap flag
134 585c8187 Guido Trotter
                use vnet_hdr=on to make the lack of IFF_VNET_HDR support an error condition
135 585c8187 Guido Trotter
                use vhost=on to enable experimental in kernel accelerator
136 585c8187 Guido Trotter
                    (only has effect for virtio guests which use MSIX)
137 585c8187 Guido Trotter
                use vhostforce=on to force vhost on for non-MSIX virtio guests
138 585c8187 Guido Trotter
                use 'vhostfd=h' to connect to an already opened vhost net device
139 585c8187 Guido Trotter
-net socket[,vlan=n][,name=str][,fd=h][,listen=[host]:port][,connect=host:port]
140 585c8187 Guido Trotter
                connect the vlan 'n' to another VLAN using a socket connection
141 585c8187 Guido Trotter
-net socket[,vlan=n][,name=str][,fd=h][,mcast=maddr:port[,localaddr=addr]]
142 585c8187 Guido Trotter
                connect the vlan 'n' to multicast maddr and port
143 585c8187 Guido Trotter
                use 'localaddr=addr' to specify the host address to send packets from
144 585c8187 Guido Trotter
-net vde[,vlan=n][,name=str][,sock=socketpath][,port=n][,group=groupname][,mode=octalmode]
145 585c8187 Guido Trotter
                connect the vlan 'n' to port 'n' of a vde switch running
146 585c8187 Guido Trotter
                on host and listening for incoming connections on 'socketpath'.
147 585c8187 Guido Trotter
                Use group 'groupname' and mode 'octalmode' to change default
148 585c8187 Guido Trotter
                ownership and permissions for communication port.
149 585c8187 Guido Trotter
-net dump[,vlan=n][,file=f][,len=n]
150 585c8187 Guido Trotter
                dump traffic on vlan 'n' to file 'f' (max n bytes per packet)
151 585c8187 Guido Trotter
-net none       use it alone to have zero network devices. If no -net option
152 585c8187 Guido Trotter
                is provided, the default is '-net nic -net user'
153 585c8187 Guido Trotter
-netdev [user|tap|vde|socket],id=str[,option][,option][,...]
154 585c8187 Guido Trotter
155 585c8187 Guido Trotter
Character device options:
156 585c8187 Guido Trotter
-chardev null,id=id[,mux=on|off]
157 585c8187 Guido Trotter
-chardev socket,id=id[,host=host],port=host[,to=to][,ipv4][,ipv6][,nodelay]
158 585c8187 Guido Trotter
         [,server][,nowait][,telnet][,mux=on|off] (tcp)
159 585c8187 Guido Trotter
-chardev socket,id=id,path=path[,server][,nowait][,telnet],[mux=on|off] (unix)
160 585c8187 Guido Trotter
-chardev udp,id=id[,host=host],port=port[,localaddr=localaddr]
161 585c8187 Guido Trotter
         [,localport=localport][,ipv4][,ipv6][,mux=on|off]
162 585c8187 Guido Trotter
-chardev msmouse,id=id[,mux=on|off]
163 585c8187 Guido Trotter
-chardev vc,id=id[[,width=width][,height=height]][[,cols=cols][,rows=rows]]
164 585c8187 Guido Trotter
         [,mux=on|off]
165 585c8187 Guido Trotter
-chardev file,id=id,path=path[,mux=on|off]
166 585c8187 Guido Trotter
-chardev pipe,id=id,path=path[,mux=on|off]
167 585c8187 Guido Trotter
-chardev pty,id=id[,mux=on|off]
168 585c8187 Guido Trotter
-chardev stdio,id=id[,mux=on|off][,signal=on|off]
169 585c8187 Guido Trotter
-chardev braille,id=id[,mux=on|off]
170 585c8187 Guido Trotter
-chardev tty,id=id,path=path[,mux=on|off]
171 585c8187 Guido Trotter
-chardev parport,id=id,path=path[,mux=on|off]
172 585c8187 Guido Trotter
-chardev spicevmc,id=id,name=name[,debug=debug]
173 585c8187 Guido Trotter
174 585c8187 Guido Trotter
Bluetooth(R) options:
175 585c8187 Guido Trotter
-bt hci,null    dumb bluetooth HCI - doesn't respond to commands
176 585c8187 Guido Trotter
-bt hci,host[:id]
177 585c8187 Guido Trotter
                use host's HCI with the given name
178 585c8187 Guido Trotter
-bt hci[,vlan=n]
179 585c8187 Guido Trotter
                emulate a standard HCI in virtual scatternet 'n'
180 585c8187 Guido Trotter
-bt vhci[,vlan=n]
181 585c8187 Guido Trotter
                add host computer to virtual scatternet 'n' using VHCI
182 585c8187 Guido Trotter
-bt device:dev[,vlan=n]
183 585c8187 Guido Trotter
                emulate a bluetooth device 'dev' in scatternet 'n'
184 585c8187 Guido Trotter
185 585c8187 Guido Trotter
Linux/Multiboot boot specific:
186 585c8187 Guido Trotter
-kernel bzImage use 'bzImage' as kernel image
187 585c8187 Guido Trotter
-append cmdline use 'cmdline' as kernel command line
188 585c8187 Guido Trotter
-initrd file    use 'file' as initial ram disk
189 585c8187 Guido Trotter
190 585c8187 Guido Trotter
Debug/Expert options:
191 585c8187 Guido Trotter
-serial dev     redirect the serial port to char device 'dev'
192 585c8187 Guido Trotter
-parallel dev   redirect the parallel port to char device 'dev'
193 585c8187 Guido Trotter
-monitor dev    redirect the monitor to char device 'dev'
194 585c8187 Guido Trotter
-qmp dev        like -monitor but opens in 'control' mode
195 585c8187 Guido Trotter
-mon chardev=[name][,mode=readline|control][,default]
196 585c8187 Guido Trotter
-debugcon dev   redirect the debug console to char device 'dev'
197 585c8187 Guido Trotter
-pidfile file   write PID to 'file'
198 585c8187 Guido Trotter
-singlestep     always run in singlestep mode
199 585c8187 Guido Trotter
-S              freeze CPU at startup (use 'c' to start execution)
200 585c8187 Guido Trotter
-gdb dev        wait for gdb connection on 'dev'
201 585c8187 Guido Trotter
-s              shorthand for -gdb tcp::1234
202 585c8187 Guido Trotter
-d item1,...    output log to /tmp/qemu.log (use -d ? for a list of log items)
203 585c8187 Guido Trotter
-D logfile      output log to logfile (instead of the default /tmp/qemu.log)
204 585c8187 Guido Trotter
-hdachs c,h,s[,t]
205 585c8187 Guido Trotter
                force hard disk 0 physical geometry and the optional BIOS
206 585c8187 Guido Trotter
                translation (t=none or lba) (usually qemu can guess them)
207 585c8187 Guido Trotter
-L path         set the directory for the BIOS, VGA BIOS and keymaps
208 585c8187 Guido Trotter
-bios file      set the filename for the BIOS
209 585c8187 Guido Trotter
-enable-kvm     enable KVM full virtualization support
210 585c8187 Guido Trotter
-xen-domid id   specify xen guest domain id
211 585c8187 Guido Trotter
-xen-create     create domain using xen hypercalls, bypassing xend
212 585c8187 Guido Trotter
                warning: should not be used when xend is in use
213 585c8187 Guido Trotter
-xen-attach     attach to existing xen domain
214 585c8187 Guido Trotter
                xend will use this when starting qemu
215 585c8187 Guido Trotter
-no-reboot      exit instead of rebooting
216 585c8187 Guido Trotter
-no-shutdown    stop before shutdown
217 585c8187 Guido Trotter
-loadvm [tag|id]
218 585c8187 Guido Trotter
                start right away with a saved state (loadvm in monitor)
219 585c8187 Guido Trotter
-daemonize      daemonize QEMU after initializing
220 585c8187 Guido Trotter
-option-rom rom load a file, rom, into the option ROM space
221 585c8187 Guido Trotter
-clock          force the use of the given methods for timer alarm.
222 585c8187 Guido Trotter
                To see what timers are available use -clock ?
223 585c8187 Guido Trotter
-rtc [base=utc|localtime|date][,clock=host|vm][,driftfix=none|slew]
224 585c8187 Guido Trotter
                set the RTC base and clock, enable drift fix for clock ticks (x86 only)
225 585c8187 Guido Trotter
-icount [N|auto]
226 585c8187 Guido Trotter
                enable virtual instruction counter with 2^N clock ticks per
227 585c8187 Guido Trotter
                instruction
228 585c8187 Guido Trotter
-watchdog i6300esb|ib700
229 585c8187 Guido Trotter
                enable virtual hardware watchdog [default=none]
230 585c8187 Guido Trotter
-watchdog-action reset|shutdown|poweroff|pause|debug|none
231 585c8187 Guido Trotter
                action when watchdog fires [default=reset]
232 585c8187 Guido Trotter
-echr chr       set terminal escape character instead of ctrl-a
233 585c8187 Guido Trotter
-virtioconsole c
234 585c8187 Guido Trotter
                set virtio console
235 585c8187 Guido Trotter
-show-cursor    show cursor
236 585c8187 Guido Trotter
-tb-size n      set TB size
237 585c8187 Guido Trotter
-incoming p     prepare for incoming migration, listen on port p
238 585c8187 Guido Trotter
-nodefaults     don't create default devices
239 585c8187 Guido Trotter
-chroot dir     chroot to dir just before starting the VM
240 585c8187 Guido Trotter
-runas user     change to user id user just before starting the VM
241 585c8187 Guido Trotter
-prom-env variable=value
242 585c8187 Guido Trotter
                set OpenBIOS nvram variables
243 585c8187 Guido Trotter
-semihosting    semihosting mode
244 585c8187 Guido Trotter
-old-param      old param mode
245 585c8187 Guido Trotter
-readconfig <file>
246 585c8187 Guido Trotter
-writeconfig <file>
247 585c8187 Guido Trotter
                read/write config file
248 585c8187 Guido Trotter
-nodefconfig
249 585c8187 Guido Trotter
                do not load default config files at startup
250 585c8187 Guido Trotter
-trace [events=<file>][,file=<file>]
251 585c8187 Guido Trotter
                specify tracing options
252 585c8187 Guido Trotter
-no-kvm         disable KVM hardware virtualization
253 585c8187 Guido Trotter
-no-kvm-irqchip disable KVM kernel mode PIC/IOAPIC/LAPIC
254 585c8187 Guido Trotter
-no-kvm-pit     disable KVM kernel mode PIT
255 585c8187 Guido Trotter
-no-kvm-pit-reinjection
256 585c8187 Guido Trotter
                disable KVM kernel mode PIT interrupt reinjection
257 585c8187 Guido Trotter
-tdf            enable guest time drift compensation
258 585c8187 Guido Trotter
-kvm-shadow-memory MEGABYTES
259 585c8187 Guido Trotter
                allocate MEGABYTES for kvm mmu shadowing
260 585c8187 Guido Trotter
261 585c8187 Guido Trotter
During emulation, the following keys are useful:
262 585c8187 Guido Trotter
ctrl-alt-f      toggle full screen
263 585c8187 Guido Trotter
ctrl-alt-n      switch to virtual console 'n'
264 585c8187 Guido Trotter
ctrl-alt        toggle mouse and keyboard grab
265 585c8187 Guido Trotter
266 585c8187 Guido Trotter
When using -nographic, press 'ctrl-a h' to get some help.