1.\" $NetBSD: setnetbootinfo.8,v 1.2 1997/04/06 08:41:36 cgd Exp $ 2.\" 3.\" Copyright (c) 1997 Christopher G. Demetriou. All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 3. All advertising materials mentioning features or use of this software 14.\" must display the following acknowledgement: 15.\" This product includes software developed by Christopher G. Demetriou 16.\" for the NetBSD Project. 17.\" 3. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 21.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 22.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 23.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 24.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 25.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 29.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30.\" 31.Dd January 20, 1997 32.Dt SETNETBOOTINFO 8 33.Os 34.Sh NAME 35.Nm setnetbootinfo 36.Nd configure network bootstrap program 37.Sh SYNOPSIS 38.Nm setnetbootinfo 39.Op Fl vf 40.Op Fl o Ar infile 41.Oo 42.Fl a Ar ether-address | Fl h Ar ether-host 43.Oc 44.Ar netboot 45.Nm setnetbootinfo 46.Op Fl v 47.Fl u o Ar outfile Ar infile 48.Sh DESCRIPTION 49The 50.Nm setnetbootinfo 51utility configures the NetBSD/alpha network bootstrap program so 52that it can be used to bootstrap systems with old firmware revisions. 53.Pp 54The NetBSD/alpha network bootstrap program needs to have the ethernet 55address of the interface being used to boot the system available when 56querying other hosts on the network for bootstrapping information. 57Alpha systems with old firmware revisions provide no way for 58network bootstrap programs to determine the ethernet address of 59the interface that they are booting from, and so the NetBSD/alpha 60network bootstrap program must find that information in another way. 61(Newer firmware revisions include the ethernet address in the name of 62the device that is being booted from.) 63The 64.Nm 65utility encodes an ethernet address (and other information) directly 66into the network bootstrap program. 67.Pp 68The options recognized by 69.Nm 70are as follows: 71.Bl -tag -width flag 72.It Fl a Ar ether-address 73Encode the given ethernet address into the network bootstrap program. 74(This option and the 75.Fl h 76option are mutually exclusive.) 77.It Fl f 78Force the address information being encoded in the bootstrap 79program to be used regardless of whether or not the bootstrap 80program can get address information from the booting system's 81firmware. 82.It Fl h Ar ether-host 83Encode the ethernet address of the specified host into the network 84bootstrap program. The host's name is translated to an ethernet 85address using the 86.Xr ether_hostton 3 87function. 88(This option and the 89.Fl a 90option are mutually exclusive.) 91.It Fl o Ar outfile 92Output the resulting bootstrap program into the file named by 93.Ar outfile , 94replacing it if it already exists. If the 95.Fl o 96flag is not specified, the output file name will be 97the name of the input bootstrap program concatenated with a 98period and the digits of the ethernet address being encoded. 99For instance, if the input file is named 100.Pa /usr/mdec/netboot 101and is being configured to encode the ethernet address 102.Li 08:00:2b:bd:5d:fd , 103then the default output file name would be 104.Pa /usr/mdec/netboot.08002bbd5dfd . 105It is safe to set the output file name to be the same as the 106input file name; the input file is read in its entirety before 107the output file is modified. 108.It Fl u 109Remove configuration information from the specified network 110bootstrap program. If this option is used, an output file name must be 111specified with the 112.Fl o 113option, and neither the 114.Fl a 115or the 116.Fl h 117options may be specified. 118.It Fl v 119Verbose mode. 120.El 121.Sh "SEE ALSO" 122.Xr bootpd 8 123.Sh HISTORY 124The NetBSD/alpha 125.Nm 126command first appeared in 127.Nx 1.2b . 128