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