SET

NAME    [Toc]    [Back]

     setnetbootinfo - configure network bootstrap program

SYNOPSIS    [Toc]    [Back]

     setnetbootinfo [-vf] [-o  infile]  [-a  ether-address  |  -h
ether-host]
                    netboot
     setnetbootinfo [-v] -u -o outfile infile

DESCRIPTION    [Toc]    [Back]

     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 ALSO    [Toc]    [Back]

     dhcpd(8)

HISTORY    [Toc]    [Back]

     The  alpha  setnetbootinfo  command first appeared in NetBSD
1.2B.

OpenBSD     3.6                        January      20,      1997