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