跳转至

提示用户输入配置设置

语法

  read [--timeout <timeout>] <setting>

示例

提示用户输入引导文件名

  read filename

让用户为接口 "net0" 配置 IP 地址

  echo -n IP address: && read net0/ip
  echo -n Subnet mask: && read net0/netmask
  echo -n Default gateway: && read net0/gateway

让用户在引导前编辑内核命令行

  set cmdline selinux=0 console=ttyS0,115200n8 console=tty0
  echo -n Kernel command line: ${}
  read cmdline
  chain http://my.web.server/vmlinuz ${cmdline}

描述

把指定配置设置的值设为用户提供的值,并等待指定的超时时间(毫秒)。如果没有显式指定超时时间,或指定为零超时,iPXE 会无限期等待。

输入的值会按照设置名称中指定的类型来解释。例如,提示用户输入 NTP 服务器地址(DHCP 选项 42)的配置设置:

  read 42:ipv4

如果没有显式指定类型,则使用设置的默认类型。

命令状态

成功 配置设置应用成功
失败 配置设置未能成功应用,或在超时时间内没有按下任何键

另请参阅

备注

你可以使用 config 命令交互式地浏览和编辑所有预定义的设置。

echo 命令打印提示字符串时,可以在提示字符串末尾添加一个空变量 ${} 来追加一个空格。例如:

  iPXE> echo -n IP address: ${} && read net0/ip
  IP address: 192.168.0.1

你可以使用 present 命令向用户展示一个交互式表单来编辑你选定的一组设置。

你可以使用 login 命令提示用户输入用户名和密码(密码不会显示在屏幕上)。