Table of Contents

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

Notes

If you are using an iPXE 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