====== Discard images ======

===== Synopsis =====

    imgfree [<image>]

===== Examples =====

=== Discard all images ===

    imgfree

=== Discard the image "pxelinux.0" ===

    imgfree pxelinux.0

===== Description =====

Discard the specified image.  If no image is explicitly specified, iPXE will discard all images.

The memory used to hold the image will be released and made available for reuse.

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

  * ''[[:cmd:imgstat]]''
  * [[:cmd|List of all iPXE commands]]

===== Notes =====

If you are using an iPXE [[:scripting|script]] that may retry downloads, then it is usually a good idea to use the ''imgfree'' command to ensure that you do not end up with multiple copies of downloaded images.  For example:

    #!ipxe
    
    :retry
    imgfree  # Discard any already-downloaded images
    kernel vmlinuz-2.6.32 || goto retry
    initrd initrd.img || goto retry
    boot || goto retry