✎ commandline - Etherboot/gPXE Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

=====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.  

**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.


=====Variables=====
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//

=====Other=====
**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**

Trace: • journal • notes • burningroms • soc • drivers • commandline • romburning • week4 • todo • 2009 • 2006 • 2008 • journal • dnsissue • oldundiproposal • 2010