Statistics
| Branch: | Tag: | Revision:

root / test / data / kvm_0.12.5_help.txt @ 585c8187

History | View | Annotate | Download (11.1 kB)

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]
3

    
4
'disk_image' is a raw hard image 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
-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]
27
       [,boot=on|off]
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
53
                specify machine UUID
54

    
55
Display options:
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
62
-sdl            enable SDL
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
68

    
69
i386 target only:
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
72
-no-acpi        disable ACPI
73
-no-hpet        disable HPET
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
79
-smbios file=binary
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
86

    
87
Network options:
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][,...]
119

    
120
Character device options:
121
-chardev null,id=id
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
131
-chardev pty,id=id
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
136

    
137
Bluetooth(R) options:
138
-bt hci,null    dumb bluetooth HCI - doesn't respond to commands
139
-bt hci,host[:id]
140
                use host's HCI with the given name
141
-bt hci[,vlan=n]
142
                emulate a standard HCI in virtual scatternet 'n'
143
-bt vhci[,vlan=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'
147

    
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
152

    
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)
165
-hdachs c,h,s[,t]
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
173
-loadvm [tag|id]
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
181
-icount [N|auto]
182
                enable virtual instruction counter with 2^N clock ticks per
183
                instruction
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
189
-virtioconsole c
190
                set virtio console
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.
197
-readconfig <file>
198
-writeconfig <file>
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)
215

    
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
220

    
221
When using -nographic, press 'ctrl-a h' to get some help.