Annotation of sys/arch/alpha/stand/setnetbootinfo/setnetbootinfo.8, Revision 1.1.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