Add form parameter

Synopsis

  param [--params <params>] <key> <value>

Examples

Issue an HTTP POST request

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

Description

Add a form parameter with the specified key/value pair. If no form parameter list is specified, the default (unnamed) form parameter list will be used.

Command status

Success The form parameter was successfully added
Failure The form parameter was not successfully added

See also

Build options

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

Notes

The most common use for form parameter lists is to generate HTTP POST requests. You can generate a POST request by appending ##params to the HTTP URI. For example, to send a complete PCI device listing:

  #!ipxe
  
  params
  :pciscan pciscan addr || goto pciscan_done
    param pcidev ${pci/${addr}.0.2}:${pci/${addr}.2.2}
    goto pciscan
  :pciscan_done
  chain http://192.168.0.1/boot/pcilist.php##params

You must create the form parameter list using the params command before attempting to create a form parameter using the param command.

 
cmd/param.txt · Last modified: 2013/08/19 23:17 by mcb30
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki
All uses of this content must include an attribution to the iPXE project and the URL http://ipxe.org
References to "iPXE" may not be altered or removed.