Commit 2221dde5d4927c2a5c3cfa4c6b89a6447d560155
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>
Showing
1 changed file
with
23 additions
and
4 deletions
qemu-options.hx
@@ -219,11 +219,30 @@ Use 'file' as a parallel flash image. | @@ -219,11 +219,30 @@ Use 'file' as a parallel flash image. | ||
219 | ETEXI | 219 | ETEXI |
220 | 220 | ||
221 | DEF("boot", HAS_ARG, QEMU_OPTION_boot, | 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 | STEXI | 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 | ETEXI | 246 | ETEXI |
228 | 247 | ||
229 | DEF("snapshot", 0, QEMU_OPTION_snapshot, | 248 | DEF("snapshot", 0, QEMU_OPTION_snapshot, |