This is an old revision of the document!

Etherboot command-line

Network Interfaces

Etherboot names interfaces following the pattern “net#”.

ifstat [interfaces…] Displays information and statistics about the specified interface. If no interface is specified, displays information about all detected interfaces. Information includes MAC address, PCI bus/slot/function identiers, and packet counts.

ifopen [interfaces…] Opens the specified interfaces. If no interface is specified, opens all interfaces.

ifclose [interfaces…] Closes the specified interfaces. If no interface is specified, closes all interfaces.

dhcp <interface> Attempts to configure the specified network interface using DHCP. Also opens the interface.

Working with images

imgfetch [-n|–name <image name>] <filename> [arguments…] Retrieves an image file, giving it a specified name, and prepares it to be executed with the specified arguments. File name may be a simple path, or an HTTP URL. Simple paths are assumed to be located on the TFTP server specified by dhcp or config. If image name is not specified, the base filename will be used as the name.

module [-n|–name <image name>] <filename> [arguments…] Equivalent to imgfetch

initrd [-n|–name <image name>] <filename> [arguments] Fetch and load an initrd. Equivalent to imgfetch, but it sets the imagetype to initrd. There is not currently any way to mark an image as initrd once it's been fetched.

imgargs <image name> Set or change the arguments for the specified image name.

imgload <image name> Prepares an executable image to be executed.

imgfree Remove all fetched/loaded images.

kernel [-n|–name <image name>] <filename> [arguments] Fetch and load a bzImage format Linux kernel. Equivalent to an imgfetch followed by imgload.


This doesn't seem to work, as it always says “file not found”

set <identifier> <value> Set the value of identifier to value

show <identifier> Display the value of identifier

clear <identifier> Clear the value of identifier


autoboot Attempts to boot the system

config Enters a configuration GUI to set up various parameters

exit Exits gPXE, and passes boot control back to the BIOS.

sanboot Attempts to boot the system from a SAN device.

Outstanding questions

  • What does autoboot do? Does it simply execute a script, pre-defined at compile time? Does it follow its own sequence of boot operations?
  • When multiple images of the same name are fetched, which one will takes precedence?
  • What does the initrd command do that's special? It obviously sets the image type to initrd, but what's the effect of that? Is there a way to specify the type of a loaded image after the fact?
  • What are the set/clear/show

QR Code
QR Code commandline (generated for current page)