Statistics
| Branch: | Tag: | Revision:

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.