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