====== 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 =====

  * ''[[:cmd:param]]''
  * iPXE [[:scripting|scripting]] guide
  * [[:cmd|List of all iPXE commands]]

===== Build options =====

This command is available only when the build option ''[[:buildcfg: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.