Table of Contents

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 the filename configuration setting. If image name is not specified, the base filename will be used as the name.

imgexec [image name] Execute the loaded image, or a specified image. If more than one image is loaded, the image must be specified. Note, if the specified image is not the most recently loaded one, Bad Things will almost certainly happen. This should only be done in special cases.

Runtime configuration

config [scope] Enter a GUI to set up runtime configuration. On some systems (cards) this may be stored in NVRAM. Scope allows the GUI to override or view specific subsets of options. (see below)

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

show <identifier> Display the value of identifier

clear <identifier> Clear the value of identifier

Identifiers

All identifiers are set within a scope.

root (scope unspecified)

proxydhcp Settings from a Proxy DHCP server (Needs more description)

[interface] e.g. net0. Settings for a network device.

[interface].dhcp. Settings from the DHCP server acquired by interface. Read/write, but note that you cannot specify new options that were not already provided.

[interface].nvo. Read/write settings in NVRAM on certain supported cards. WARNING this permanently modifies settings on your network card. It is possible to damage your network card by changing settings in this context. Use at your own risk.

smbios. Read-only access to settings in the System Management BIOS (see below)

Identifiers follow the format [scope/]identifier:[type]. For example, to set the IP address of the 'net0' card use set net0/ip XXX.XXX.XXX.XXX

Options not specified in a higher scope will be read from a lower one. So if the option ip is unspecified, it will be read from net0/ip; if the option net0/ip is unspecified, it will be read from net0.dhcp.

Root

hostname The system's hostname. Sent to the DHCP server for dynamic DNS changes, or specified by the DHCP server. Equivalent to DHCP option 12 (host name)