Choose menu item

  choose [--menu <menu>] [--default <label>] [--keep]
         [--timeout <timeout>] [--retimeout <timeout>] <setting>

  menu Please choose an operating system to boot
  item fedora   Fedora Linux
  item win7     Windows 7
  choose os

  choose target && goto ${target}

  menu
  item linux    Boot Linux
  item shell    Enter iPXE shell
  item exit     Exit to BIOS
  choose --default exit --timeout 3000 target && goto ${target}

Choose an item from a menu and store the result in the specified setting, defaulting to the specified item after the specified timeout (in milliseconds). If no timeout is explicitly specified, or if a zero timeout is specified, then iPXE will wait indefinitely.

After any user activity (such as a keypress), the timeout will be reset to the specified retimeout value (in milliseconds). If no retimeout is explicitly specified, or if a zero retimeout is specified, then iPXE will wait indefinitely after the first user activity.

If no default item is explicitly specified, then the menu's pre-existing default item (if any) will be used. If no menu is specified, the default (unnamed) menu will be used. The menu will be automatically deleted unless the --keep option is specified.

• menu
• item
• iPXE scripting guide
• List of all iPXE commands

The user is able to use Ctrl-C (or Escape) to exit the menu without making a selection. You may therefore wish to always handle failures of the choose command. For example:

  choose os || goto cancelled

The --default option for the choose command overrides any default item specified using the item command.

You can use any valid setting name, including a scope and type. For example:

  menu Select a DNS server
  item ${netX/dns}    Current DNS server (${netX}/dns)
  item 8.8.8.8        Google public DNS
  choose dns:ipv4

You can add a background picture to enhance the appearance of your menu using the console command.