SETNETBOOTINFO(8) OpenBSD System Manager's Manual (Alpha) SETNETBOOTINFO(8)NAMEsetnetbootinfo - configure network bootstrap program
SYNOPSISsetnetbootinfo [-vf] [-o infile] [-a ether-address | -h ether-host]
netboot
setnetbootinfo [-v] -u -o outfile infile
DESCRIPTION
The setnetbootinfo utility configures the OpenBSD/alpha network bootstrap
program so that it can be used to bootstrap systems with old firmware
revisions.
The OpenBSD/alpha network bootstrap program needs to have the Ethernet
address of the interface being used to boot the system available when
querying other hosts on the network for bootstrapping information. Alpha
systems with old firmware revisions provide no way for network bootstrap
programs to determine the Ethernet address of the interface that they are
booting from, and so the OpenBSD/alpha network bootstrap program must
find that information in another way. (Newer firmware revisions include
the Ethernet address in the name of the device that is being booted
from.) The setnetbootinfo utility encodes an Ethernet address (and other
information) directly into the network bootstrap program.
The options recognized by setnetbootinfo are as follows:
-a ether-address
Encode the given Ethernet address into the network bootstrap
program. (This option and the -h option are mutually exclusive.)
-f Force the address information being encoded in the bootstrap
program to be used regardless of whether or not the bootstrap
program can get address information from the booting system's
firmware.
-h ether-host
Encode the Ethernet address of the specified host into the network
bootstrap program. The host's name is translated to an Ethernet
address using the ether_hostton(3) function. (This option and the
-a option are mutually exclusive.)
-o outfile
Output the resulting bootstrap program into the file named by
outfile, replacing it if it already exists. If the -o flag is not
specified, the output file name will be the name of the input
bootstrap program concatenated with a period and the digits of the
Ethernet address being encoded. For instance, if the input file is
named /usr/mdec/netboot and is being configured to encode the
Ethernet address 08:00:2b:bd:5d:fd, then the default output file
name would be /usr/mdec/netboot.08002bbd5dfd. It is safe to set
the output file name to be the same as the input file name; the
input file is read in its entirety before the output file is
modified.
-u Remove configuration information from the specified network
bootstrap program. If this option is used, an output file name
must be specified with the -o option, and neither the -a or the -h
options may be specified.
-v Verbose mode.
SEE ALSOdhcpd(8)HISTORY
The alpha setnetbootinfo command first appeared in NetBSD 1.2b.
OpenBSD 4.9 February 1, 2009 OpenBSD 4.9