gwj / at91sam9263 · Commits

Commit 2221dde5d4927c2a5c3cfa4c6b89a6447d560155

Authored by Jan Kiszka
Committed by Anthony Liguori
1 parent 95387491

Update boot option documentation 

Signed-off-by: Jan Kiszka <jan.kiszka@siemens.com>
Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
Inline Side-by-side
Showing 1 changed file with 23 additions and 4 deletions
qemu-options.hx
  View file @2221dde
... ... @@ -219,11 +219,30 @@ Use &#39;file&#39; as a parallel flash image.
219 219 ETEXI
220 220  
221 221 DEF("boot", HAS_ARG, QEMU_OPTION_boot,
222   - "-boot [a|c|d|n] boot on floppy (a), hard disk (c), CD-ROM (d), or network (n)\n")
  222 + "-boot [order=drives][,once=drives][,menu=on|off]\n"
  223 + " 'drives': floppy (a), hard disk (c), CD-ROM (d), network (n)\n")
223 224 STEXI
224   -@item -boot [a|c|d|n]
225   -Boot on floppy (a), hard disk (c), CD-ROM (d), or Etherboot (n). Hard disk boot
226   -is the default.
  225 +@item -boot [order=@var{drives}][,once=@var{drives}][,menu=on|off]
  226 +
  227 +Specify boot order @var{drives} as a string of drive letters. Valid
  228 +drive letters depend on the target achitecture. The x86 PC uses: a, b
  229 +(floppy 1 and 2), c (first hard disk), d (first CD-ROM), n-p (Etherboot
  230 +from network adapter 1-4), hard disk boot is the default. To apply a
  231 +particular boot order only on the first startup, specify it via
  232 +@option{once}.
  233 +
  234 +Interactive boot menus/prompts can be enabled via @option{menu=on} as far
  235 +as firmware/BIOS supports them. The default is non-interactive boot.
  236 +
  237 +@example
  238 +# try to boot from network first, then from hard disk
  239 +qemu -boot order=nc
  240 +# boot from CD-ROM first, switch back to default order after reboot
  241 +qemu -boot once=d
  242 +@end example
  243 +
  244 +Note: The legacy format '-boot @var{drives}' is still supported but its
  245 +use is discouraged as it may be removed from future versions.
227 246 ETEXI
228 247  
229 248 DEF("snapshot", 0, QEMU_OPTION_snapshot,
... ...