====== String setting type ======

===== Name =====

    :string

===== Examples =====

==== Display the boot filename ====

    iPXE> show filename
    net0.dhcp/filename:string = http://boot.ipxe.org/demo/boot.php

==== Display DHCP option 40 ====

    iPXE> show 40:string  # Option 40 - NIS domain name
    net0.dhcp/40:string = nis.example.com

==== Set the SAN root path ====

    iPXE> set root-path iscsi:10.0.0.6::::iqn.2010-04.org.ipxe.dolphin:storage

===== Description =====

Represents a type of setting that is a string.

===== See also =====

  * [[:cfgtype:uristring]]
  * [[:cfg|List of all iPXE settings]]

===== Notes =====

A [[:cfgtype:string]] setting can contain spaces and other "special" characters that can cause problems during URI parsing.  You can avoid these potential problems by requesting expansion as a [[:cfgtype:uristring]] setting.  For example, if you want to pass the SMBIOS ''[[:cfg:product]]'' name to a boot script running on a web server, you could use

    chain http://boot.ipxe.org/demo/boot.php?product=${product:uristring}

This will ensure that any "special" characters are URI-encoded as necessary.  For example, if the SMBIOS product name is "PowerEdge R210", then the above command will expand to

    chain http://boot.ipxe.org/demo/boot.php?product=PowerEdge%20R210