Statistics
| Branch: | Tag: | Revision:

root / test / data / kvm_1.1.2_help.txt @ 69809ae3

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.