Annotation of sys/arch/alpha/stand/setnetbootinfo/setnetbootinfo.8, Revision 1.1
1.1 ! nbrk 1: .\" $OpenBSD: setnetbootinfo.8,v 1.7 2007/05/31 19:20:02 jmc 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 $Mdocdate: May 31 2007 $
! 33: .Dt SETNETBOOTINFO 8 alpha
! 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
! 50: The
! 51: .Nm setnetbootinfo
! 52: utility configures the OpenBSD/alpha network bootstrap program so
! 53: that it can be used to bootstrap systems with old firmware revisions.
! 54: .Pp
! 55: The OpenBSD/alpha network bootstrap program needs to have the ethernet
! 56: address of the interface being used to boot the system available when
! 57: querying other hosts on the network for bootstrapping information.
! 58: Alpha systems with old firmware revisions provide no way for
! 59: network bootstrap programs to determine the ethernet address of
! 60: the interface that they are booting from, and so the OpenBSD/alpha
! 61: network bootstrap program must find that information in another way.
! 62: (Newer firmware revisions include the ethernet address in the name of
! 63: the device that is being booted from.)
! 64: The
! 65: .Nm
! 66: utility encodes an ethernet address (and other information) directly
! 67: into the network bootstrap program.
! 68: .Pp
! 69: The options recognized by
! 70: .Nm
! 71: are as follows:
! 72: .Bl -tag -width flag
! 73: .It Fl a Ar ether-address
! 74: Encode the given ethernet address into the network bootstrap program.
! 75: (This option and the
! 76: .Fl h
! 77: option are mutually exclusive.)
! 78: .It Fl f
! 79: Force the address information being encoded in the bootstrap
! 80: program to be used regardless of whether or not the bootstrap
! 81: program can get address information from the booting system's
! 82: firmware.
! 83: .It Fl h Ar ether-host
! 84: Encode the ethernet address of the specified host into the network
! 85: bootstrap program.
! 86: The host's name is translated to an ethernet address using the
! 87: .Xr ether_hostton 3
! 88: function.
! 89: (This option and the
! 90: .Fl a
! 91: option are mutually exclusive.)
! 92: .It Fl o Ar outfile
! 93: Output the resulting bootstrap program into the file named by
! 94: .Ar outfile ,
! 95: replacing it if it already exists.
! 96: If the
! 97: .Fl o
! 98: flag is not specified, the output file name will be
! 99: the name of the input bootstrap program concatenated with a
! 100: period and the digits of the ethernet address being encoded.
! 101: For instance, if the input file is named
! 102: .Pa /usr/mdec/netboot
! 103: and is being configured to encode the ethernet address
! 104: .Li 08:00:2b:bd:5d:fd ,
! 105: then the default output file name would be
! 106: .Pa /usr/mdec/netboot.08002bbd5dfd .
! 107: It is safe to set the output file name to be the same as the
! 108: input file name; the input file is read in its entirety before
! 109: the output file is modified.
! 110: .It Fl u
! 111: Remove configuration information from the specified network
! 112: bootstrap program.
! 113: If this option is used, an output file name must be specified with the
! 114: .Fl o
! 115: option, and neither the
! 116: .Fl a
! 117: or the
! 118: .Fl h
! 119: options may be specified.
! 120: .It Fl v
! 121: Verbose mode.
! 122: .El
! 123: .Sh SEE ALSO
! 124: .Xr dhcpd 8
! 125: .Sh HISTORY
! 126: The alpha
! 127: .Nm
! 128: command first appeared in
! 129: .Nx 1.2b .
CVSweb