====== Video RAM contents setting ======

===== Name =====

    vram

===== Details =====

^ Type                | [[:cfgtype:base64|Base64-encoded]]    |
^ DHCP option number  | not applicable                        |
^ ISC dhcpd syntax    | not applicable                        |

===== Examples =====

=== Take a screenshot ===

    set screenshot:base64 ${vram}

=== Send a screenshot of a memory test ===

    #!ipxe
    params
    chain -a http://server/memtest.0 onepass onefail ||
    param screenshot ${vram}
    chain -a http://server/screenshot.php##params

===== Description =====

Represents the raw contents of video RAM.

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

  * ''[[:cmd:param]]'' command
  * [[:console|Console configuration]] in iPXE
  * [[:cfg|List of all iPXE settings]]

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

This setting is available only when the build option ''[[:buildcfg:VRAM_SETTINGS]]'' is enabled.

===== Notes =====

The video RAM contents can be used to capture a screenshot.  This is particularly useful for recording failures in automated environments.  For example, the output from a failed memory test using [[http://boot.ipxe.org/memtest.0|memtest.0]] can be captured and sent via an HTTP POST request to a remote server for later diagnosis:

    #!ipxe
    chain -a http://boot.ipxe.org/memtest.0 onepass onefail && goto ok || goto bad
    :bad
    params
    param screenshot ${vram}
    chain -a http://my.server.address/memtest_fail.php##params
    :ok