1 QEMU PC emulator version 0.12.5 (qemu-kvm-0.12.5), Copyright (c) 2003-2008 Fabrice Bellard
2 usage: qemu [options] [disk_image]
4 'disk_image' is a raw hard image image for IDE hard disk 0
7 -h or -help display this help and exit
8 -version display version information and exit
9 -M machine select emulated machine (-M ? for list)
10 -cpu cpu select CPU (-cpu ? for list)
11 -smp n[,maxcpus=cpus][,cores=cores][,threads=threads][,sockets=sockets]
12 set the number of CPUs to 'n' [default=1]
13 maxcpus= maximum number of total cpus, including
14 offline CPUs for hotplug etc.
15 cores= number of CPU cores on one socket
16 threads= number of threads on one CPU core
17 sockets= number of discrete sockets in the system
18 -numa node[,mem=size][,cpus=cpu[-cpu]][,nodeid=node]
19 -fda/-fdb file use 'file' as floppy disk 0/1 image
20 -hda/-hdb file use 'file' as IDE hard disk 0/1 image
21 -hdc/-hdd file use 'file' as IDE hard disk 2/3 image
22 -cdrom file use 'file' as IDE cdrom image (cdrom is ide1 master)
23 -drive [file=file][,if=type][,bus=n][,unit=m][,media=d][,index=i]
24 [,cyls=c,heads=h,secs=s[,trans=t]][,snapshot=on|off]
25 [,cache=writethrough|writeback|none][,format=f][,serial=s]
26 [,addr=A][,id=name][,aio=threads|native]
28 use 'file' as a drive image
29 -set group.id.arg=value
30 set <arg> parameter for item <id> of type <group>
31 i.e. -set drive.$id.file=/path/to/image
32 -global driver.property=value
33 set a global default for a driver property
34 -mtdblock file use 'file' as on-board Flash memory image
35 -sd file use 'file' as SecureDigital card image
36 -pflash file use 'file' as a parallel flash image
37 -boot [order=drives][,once=drives][,menu=on|off]
38 'drives': floppy (a), hard disk (c), CD-ROM (d), network (n)
39 -snapshot write to temporary files instead of disk image files
40 -m megs set virtual RAM size to megs MB [default=128]
41 -k language use keyboard layout (for example 'fr' for French)
42 -audio-help print list of audio drivers and their options
43 -soundhw c1,... enable audio support
44 and only specified sound cards (comma separated list)
45 use -soundhw ? to get the list of supported cards
46 use -soundhw all to enable all of them
47 -usb enable the USB driver (will be the default soon)
48 -usbdevice name add the host or guest USB device 'name'
49 -device driver[,options] add device
50 -name string1[,process=string2] set the name of the guest
51 string1 sets the window title and string2 the process name (on Linux)
52 -uuid %08x-%04x-%04x-%04x-%012x
56 -nographic disable graphical output and redirect serial I/Os to console
57 -curses use a curses/ncurses interface instead of SDL
58 -no-frame open SDL window without a frame and window decorations
59 -alt-grab use Ctrl-Alt-Shift to grab mouse (instead of Ctrl-Alt)
60 -ctrl-grab use Right-Ctrl to grab mouse (instead of Ctrl-Alt)
61 -no-quit disable SDL window close capability
63 -portrait rotate graphical output 90 deg left (only PXA LCD)
64 -vga [std|cirrus|vmware|xenfb|none]
65 select video card type
66 -full-screen start in full screen
67 -vnc display start a VNC server on display
70 -win2k-hack use it when installing Windows 2000 to avoid a disk full bug
71 -no-fd-bootchk disable boot signature checking for floppy disks
74 -balloon none disable balloon device
75 -balloon virtio[,addr=str]
76 enable virtio balloon device (default)
77 -acpitable [sig=str][,rev=n][,oem_id=str][,oem_table_id=str][,oem_rev=n][,asl_compiler_id=str][,asl_compiler_rev=n][,data=file1[:file2]...]
78 ACPI table description
80 Load SMBIOS entry from binary file
81 -smbios type=0[,vendor=str][,version=str][,date=str][,release=%d.%d]
82 Specify SMBIOS type 0 fields
83 -smbios type=1[,manufacturer=str][,product=str][,version=str][,serial=str]
84 [,uuid=uuid][,sku=str][,family=str]
85 Specify SMBIOS type 1 fields
88 -net nic[,vlan=n][,macaddr=mac][,model=type][,name=str][,addr=str][,vectors=v]
89 create a new Network Interface Card and connect it to VLAN 'n'
90 -net user[,vlan=n][,name=str][,net=addr[/mask]][,host=addr][,restrict=y|n]
91 [,hostname=host][,dhcpstart=addr][,dns=addr][,tftp=dir][,bootfile=f]
92 [,hostfwd=rule][,guestfwd=rule][,smb=dir[,smbserver=addr]]
93 connect the user mode network stack to VLAN 'n', configure its
94 DHCP server and enabled optional services
95 -net tap[,vlan=n][,name=str][,fd=h][,ifname=name][,script=file][,downscript=dfile][,sndbuf=nbytes][,vnet_hdr=on|off]
96 connect the host TAP network interface to VLAN 'n' and use the
97 network scripts 'file' (default=/etc/kvm/kvm-ifup)
98 and 'dfile' (default=/etc/kvm/kvm-ifdown);
99 use '[down]script=no' to disable script execution;
100 use 'fd=h' to connect to an already opened TAP interface
101 use 'sndbuf=nbytes' to limit the size of the send buffer; the
102 default of 'sndbuf=1048576' can be disabled using 'sndbuf=0'
103 use vnet_hdr=off to avoid enabling the IFF_VNET_HDR tap flag; use
104 vnet_hdr=on to make the lack of IFF_VNET_HDR support an error condition
105 -net socket[,vlan=n][,name=str][,fd=h][,listen=[host]:port][,connect=host:port]
106 connect the vlan 'n' to another VLAN using a socket connection
107 -net socket[,vlan=n][,name=str][,fd=h][,mcast=maddr:port]
108 connect the vlan 'n' to multicast maddr and port
109 -net vde[,vlan=n][,name=str][,sock=socketpath][,port=n][,group=groupname][,mode=octalmode]
110 connect the vlan 'n' to port 'n' of a vde switch running
111 on host and listening for incoming connections on 'socketpath'.
112 Use group 'groupname' and mode 'octalmode' to change default
113 ownership and permissions for communication port.
114 -net dump[,vlan=n][,file=f][,len=n]
115 dump traffic on vlan 'n' to file 'f' (max n bytes per packet)
116 -net none use it alone to have zero network devices; if no -net option
117 is provided, the default is '-net nic -net user'
118 -netdev [user|tap|vde|socket],id=str[,option][,option][,...]
120 Character device options:
122 -chardev socket,id=id[,host=host],port=host[,to=to][,ipv4][,ipv6][,nodelay]
123 [,server][,nowait][,telnet] (tcp)
124 -chardev socket,id=id,path=path[,server][,nowait][,telnet] (unix)
125 -chardev udp,id=id[,host=host],port=port[,localaddr=localaddr]
126 [,localport=localport][,ipv4][,ipv6]
127 -chardev msmouse,id=id
128 -chardev vc,id=id[[,width=width][,height=height]][[,cols=cols][,rows=rows]]
129 -chardev file,id=id,path=path
130 -chardev pipe,id=id,path=path
132 -chardev stdio,id=id,[,signal=on|off]
133 -chardev braille,id=id
134 -chardev tty,id=id,path=path
135 -chardev parport,id=id,path=path
137 Bluetooth(R) options:
138 -bt hci,null dumb bluetooth HCI - doesn't respond to commands
140 use host's HCI with the given name
142 emulate a standard HCI in virtual scatternet 'n'
144 add host computer to virtual scatternet 'n' using VHCI
145 -bt device:dev[,vlan=n]
146 emulate a bluetooth device 'dev' in scatternet 'n'
148 Linux/Multiboot boot specific:
149 -kernel bzImage use 'bzImage' as kernel image
150 -append cmdline use 'cmdline' as kernel command line
151 -initrd file use 'file' as initial ram disk
153 Debug/Expert options:
154 -serial dev redirect the serial port to char device 'dev'
155 -parallel dev redirect the parallel port to char device 'dev'
156 -monitor dev redirect the monitor to char device 'dev'
157 -qmp dev like -monitor but opens in 'control' mode.
158 -mon chardev=[name][,mode=readline|control][,default]
159 -pidfile file write PID to 'file'
160 -singlestep always run in singlestep mode
161 -S freeze CPU at startup (use 'c' to start execution)
162 -gdb dev wait for gdb connection on 'dev'
163 -s shorthand for -gdb tcp::1234
164 -d item1,... output log to /tmp/qemu.log (use -d ? for a list of log items)
166 force hard disk 0 physical geometry and the optional BIOS
167 translation (t=none or lba) (usually qemu can guess them)
168 -L path set the directory for the BIOS, VGA BIOS and keymaps
169 -bios file set the filename for the BIOS
170 -enable-kvm enable KVM full virtualization support
171 -no-reboot exit instead of rebooting
172 -no-shutdown stop before shutdown
174 start right away with a saved state (loadvm in monitor)
175 -daemonize daemonize QEMU after initializing
176 -option-rom rom load a file, rom, into the option ROM space
177 -clock force the use of the given methods for timer alarm.
178 To see what timers are available use -clock ?
179 -rtc [base=utc|localtime|date][,clock=host|vm][,driftfix=none|slew]
180 set the RTC base and clock, enable drift fix for clock ticks
182 enable virtual instruction counter with 2^N clock ticks per
184 -watchdog i6300esb|ib700
185 enable virtual hardware watchdog [default=none]
186 -watchdog-action reset|shutdown|poweroff|pause|debug|none
187 action when watchdog fires [default=reset]
188 -echr chr set terminal escape character instead of ctrl-a
191 -show-cursor show cursor
192 -tb-size n set TB size
193 -incoming uri wait on uri for incoming migration
194 -nodefaults don't create default devices.
195 -chroot dir Chroot to dir just before starting the VM.
196 -runas user Change to user id user just before starting the VM.
199 read/write config file
200 -no-kvm disable KVM hardware virtualization
201 -no-kvm-irqchip disable KVM kernel mode PIC/IOAPIC/LAPIC
202 -no-kvm-pit disable KVM kernel mode PIT
203 -no-kvm-pit-reinjection disable KVM kernel mode PIT interrupt reinjection
204 -pcidevice host=bus:dev.func[,dma=none][,name=string]
205 expose a PCI device to the guest OS.
206 dma=none: don't perform any dma translations (default is to use an iommu)
207 'string' is used in log output.
208 -enable-nesting enable support for running a VM inside the VM (AMD only)
209 -nvram FILE provide ia64 nvram contents
210 -tdf enable guest time drift compensation
211 -kvm-shadow-memory MEGABYTES
212 allocate MEGABYTES for kvm mmu shadowing
213 -mem-path FILE provide backing storage for guest RAM
214 -mem-prealloc preallocate guest memory (use with -mempath)
216 During emulation, the following keys are useful:
217 ctrl-alt-f toggle full screen
218 ctrl-alt-n switch to virtual console 'n'
219 ctrl-alt toggle mouse and keyboard grab
221 When using -nographic, press 'ctrl-a h' to get some help.