Copyright (c) 1997, 1999 Christopher G. Demetriou
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software
must display the following acknowledgement:
This product includes software developed for the
NetBSD Project. See https://www.NetBSD.org/ for
information about NetBSD.
4. The name of the author may not be used to endorse or promote products
derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
.Dd February 17, 2017 .Dt SETNETBOOTINFO 8 alpha .Os .Sh NAME .Nm setnetbootinfo .Nd configure Alpha network bootstrap program .Sh SYNOPSIS .Nm /usr/mdec/setnetbootinfo .Op Fl vf .Op Fl o Ar outfile .Oo .Fl a Ar ether-address | Fl h Ar ether-host .Oc .Ar infile .Nm /usr/mdec/setnetbootinfo .Op Fl v .Fl u o Ar outfile Ar infile .Sh DESCRIPTION The .Nm setnetbootinfo utility configures the .Nx Ns Tn /alpha network bootstrap program so that it can be used to bootstrap systems with old firmware revisions.
p The .Nx Ns Tn /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 .Nx Ns Tn /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 .Nm utility encodes an ethernet address (and other information) directly into the network bootstrap program.
p The options recognized by .Nm are as follows: l -tag -width flag t Fl a Ar ether-address Encode the given ethernet address into the network bootstrap program. (This option and the .Fl h option are mutually exclusive.) t Fl 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. t Fl h Ar 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 .Xr ether_hostton 3 function. (This option and the .Fl a option are mutually exclusive.) t Fl o Ar outfile Output the resulting bootstrap program into the file named by .Ar outfile , replacing it if it already exists. If the .Fl 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
a /usr/mdec/netboot and is being configured to encode the ethernet address .Li 08:00:2b:bd:5d:fd , then the default output file name would be
a /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.
t Fl u Remove configuration information from the specified network
bootstrap program. If this option is used, an output file name must be
specified with the
.Fl o
option, and neither the
.Fl a
or the
.Fl h
options may be specified.
t Fl v Verbose mode.
.El
.Sh FILES
l -tag -width /usr/mdec/ustarboot -compact t Pa /usr/mdec/netboot network bootstrap program
.El
.Sh EXAMPLES
There should be some examples of how to use
.Nm setnetbootinfo .
XXX
.Sh SEE ALSO
.Xr alpha/boot 8 ,
.Xr bootpd 8
.Sh HISTORY
The
.Nx Ns Tn /alpha
.Nm
command first appeared in
.Nx 1.3 .
.Sh AUTHORS
The
.Nm
utility was written by Chris Demetriou.
Indexes created Fri Sep 26 20:09:58 GMT 2025