====== Display images ======

===== Synopsis =====

    imgstat [<name>...]

===== Examples =====

=== Display all images ===

    imgstat

=== Display the image ''pxelinux.0'' ===

    imgstat pxelinux.0

===== Description =====

Display information about the specified images.  If no images are explicitly specified, iPXE will display information about all images.  For example:

    iPXE> imgstat
    boot.php : 111 bytes [script] [SELECTED]

In this example you can see that there is a single image, named ''boot.php'', which is an iPXE [[:scripting|script]].  The image has already been selected for booting (using a command such as ''[[:cmd:kernel]]'' or ''[[:cmd:imgselect]]'').

It is possible to have multiple images present at the same time.  For example:

    iPXE> imgstat
    vmlinuz : 2904736 bytes [bzImage] [SELECTED] "console=ttyS0,115200n8 console=tty0"
    initrd.img : 421168 bytes
    e1000.ko : 64852 bytes "/lib/modules/e1000.ko"

In this example you can see that there are three images.  The image named ''vmlinuz'' is a Linux kernel bzImage and has been selected for booting.  The command line "''console=ttyS0,115200n8 console=tty0''" will be passed to the Linux kernel when it boots.

The other two images will be available to the booted Linux kernel image: the image named ''initrd.img'' is a Linux initial RAM filesystem image, and the image named ''e1000.ko'' is a Linux kernel module that will be provided as the file ''/lib/modules/e1000.ko'' within the initial RAM filesystem.

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

  * ''[[:cmd:chain]]''
  * ''[[:cmd:imgfetch]]''
  * ''[[:cmd:kernel]]''
  * ''[[:cmd:imgfree]]''
  * [[:cmd|List of all iPXE commands]]

===== Notes =====

You can boot images displayed by ''imgstat'' using the ''[[:cmd:boot]]'' command.

You can discard images displayed by ''imgstat'' using the ''[[:cmd:imgfree]]'' command.