Table of Contents

Create request parameter list

Synopsis

  params [--name <name>] [--delete]

Examples

Create an unnamed request parameter list

  params

Issue an HTTP POST using a request parameter list

  params
  param mac ${net0/mac}
  param uuid ${uuid}
  param asset ${asset}
  chain http://boot.ipxe.org/demo/boot.php##params

Create and use a named request parameter list

  params --name mydata
  param --params mydata username ${username}
  param --params mydata password ${password}
  imgfetch http://192.168.0.1/auth.cgi##params=mydata

Delete a named request parameter list

  params --name mydate --delete

Description

Create a request parameter list with the specified name. If no name is specified, the default (unnamed) request parameter list will be created.

If the --delete option is specified, the request parameter list will be deleted.

Command status

Success The request parameter list was successfully created
Failure The request parameter list was not successfully created

See also

Build options

This command is available only when the build option PARAM_CMD is enabled.

Notes

Unnamed request parameter lists can be referenced as part of a URI by appending ##params to the URI specified in an iPXE command. For example:

  kernel http://192.168.0.1/boot.cgi##params

Named request parameter lists can be referenced as part of a URI by appending ##params=<name> to the URI specified in an iPXE command. For example:

  imgfetch http://my.web.server/boot/test.php##params=mydata

Request parameter lists are automatically deleted when referenced as part of a URI. You do not generally need to explicitly delete a request parameter list.