This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
cmd:choose [2012/04/28 22:34] mcb30 |
cmd:choose [2012/04/28 22:41] mcb30 |
||
---|---|---|---|
Line 29: | Line 29: | ||
===== Description ===== | ===== Description ===== | ||
- | Choose an item from a menu and store the result in the specified [[:settings|setting]], defaulting to the specified item after the specified timeout (in milliseconds). | + | Choose an item from a menu and store the result in the specified [[:settings|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. |
- | + | ||
- | If no timeout is explicitly specified, or if a zero timeout is specified, then iPXE will wait indefinitely. 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. | + | |
{{ :screenshots:menu.png?360x200 |A sample menu}} | {{ :screenshots:menu.png?360x200 |A sample menu}} | ||
- | The menu will be automatically deleted unless the ''%%--keep%%'' option is specified. | + | 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. |
===== Command status ===== | ===== Command status ===== | ||
Line 55: | Line 53: | ||
choose os || goto cancelled | choose os || goto cancelled | ||
- | The ''--default'' option for the ''choose'' command overrides any default item specified using the ''[[:cmd:item]]'' command. | + | The ''%%--default%%'' option for the ''choose'' command overrides any default item specified using the ''[[:cmd:item]]'' command. |
You can use any valid setting name, including a scope and type. For example: | You can use any valid setting name, including a scope and type. For example: |