Revision 3d3b8303 qemu-options.hx

b/qemu-options.hx
303 303

  
304 304
DEF("boot", HAS_ARG, QEMU_OPTION_boot,
305 305
    "-boot [order=drives][,once=drives][,menu=on|off]\n"
306
    "                'drives': floppy (a), hard disk (c), CD-ROM (d), network (n)\n",
306
    "      [,splash=sp_name][,splash-time=sp_time]\n"
307
    "                'drives': floppy (a), hard disk (c), CD-ROM (d), network (n)\n"
308
    "                'sp_name': the file's name that would be passed to bios as logo picture, if menu=on\n"
309
    "                'sp_time': the period that splash picture last if menu=on, unit is ms\n",
307 310
    QEMU_ARCH_ALL)
308 311
STEXI
309
@item -boot [order=@var{drives}][,once=@var{drives}][,menu=on|off]
312
@item -boot [order=@var{drives}][,once=@var{drives}][,menu=on|off][,splash=@var{sp_name}][,splash-time=@var{sp_time}]
310 313
@findex -boot
311 314
Specify boot order @var{drives} as a string of drive letters. Valid
312 315
drive letters depend on the target achitecture. The x86 PC uses: a, b
......
318 321
Interactive boot menus/prompts can be enabled via @option{menu=on} as far
319 322
as firmware/BIOS supports them. The default is non-interactive boot.
320 323

  
324
A splash picture could be passed to bios, enabling user to show it as logo,
325
when option splash=@var{sp_name} is given and menu=on, If firmware/BIOS
326
supports them. Currently Seabios for X86 system support it.
327
limitation: The splash file could be a jpeg file or a BMP file in 24 BPP
328
format(true color). The resolution should be supported by the SVGA mode, so
329
the recommended is 320x240, 640x480, 800x640.
330

  
321 331
@example
322 332
# try to boot from network first, then from hard disk
323 333
qemu -boot order=nc
324 334
# boot from CD-ROM first, switch back to default order after reboot
325 335
qemu -boot once=d
336
# boot with a splash picture for 5 seconds.
337
qemu -boot menu=on,splash=/root/boot.bmp,splash-time=5000
326 338
@end example
327 339

  
328 340
Note: The legacy format '-boot @var{drives}' is still supported but its

Also available in: Unified diff