Initial import from FreeBSD RELENG_4:
[dragonfly.git] / sbin / atm / fore_dnld / fore_dnld.8
1 .\"
2 .\" ===================================
3 .\" HARP  |  Host ATM Research Platform
4 .\" ===================================
5 .\"
6 .\"
7 .\" This Host ATM Research Platform ("HARP") file (the "Software") is
8 .\" made available by Network Computing Services, Inc. ("NetworkCS")
9 .\" "AS IS".  NetworkCS does not provide maintenance, improvements or
10 .\" support of any kind.
11 .\"
12 .\" NETWORKCS MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED,
13 .\" INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY
14 .\" AND FITNESS FOR A PARTICULAR PURPOSE, AS TO ANY ELEMENT OF THE
15 .\" SOFTWARE OR ANY SUPPORT PROVIDED IN CONNECTION WITH THIS SOFTWARE.
16 .\" In no event shall NetworkCS be responsible for any damages, including
17 .\" but not limited to consequential damages, arising from or relating to
18 .\" any use of the Software or related support.
19 .\"
20 .\" Copyright 1994-1998 Network Computing Services, Inc.
21 .\"
22 .\" Copies of this Software may be made, however, the above copyright
23 .\" notice must be reproduced on all copies.
24 .\"
25 .\" @(#) $FreeBSD: src/sbin/atm/fore_dnld/fore_dnld.8,v 1.4.2.2 2002/08/21 18:58:03 trhodes Exp $
26 .\"
27 .\"
28 .Dd December 3, 1996
29 .Dt FORE_DNLD 8
30 .Os
31 .Sh NAME
32 .Nm fore_dnld
33 .Nd "download FORE Systems' microcode into host ATM adapter"
34 .Sh SYNOPSIS
35 .Nm
36 .Op Fl Ar intf
37 .Op Fl d Ar path
38 .Op Fl f Ar objfile
39 .Sh DESCRIPTION
40 The
41 .Nm
42 utility downloads FORE Systems' microcode into the host ATM adapter(s).
43 .Sh OPTIONS
44 .Bl -tag -width indent
45 .It Fl i Ar intf
46 Specify which ATM interface to download microcode to.
47 Default is to load microcode into all FORE Systems host adapters.
48 .It Fl d Ar path
49 Specify the path to prepend to the
50 .Ar objfile
51 name.
52 Default is to use current directory.
53 .It Fl f Ar objfile
54 Specify the microcode binary file.
55 Defaults are:
56 .Pa sba200.obj
57 for SBA-200 adapters,
58 .Pa sba200e.obj
59 for SBA-200E adapters, and
60 .Pa pca200e.bin
61 for PCA-200E adapters.
62 .El
63 .Sh NOTES
64 For the PCA200E adapter, if no file is specified on the command
65 line a built-in copy of version 3.0.1 microcode is used.
66 .Pp
67 Microcode as distributed by FORE Systems is not ready for downloading
68 directly into SBA host ATM adapters.
69 Instead, the supplied microcode needs
70 to be processed with the
71 .Xr objcopy 1
72 command to create an image suitable
73 for downloading.
74 Arguments to
75 .Xr objcopy 1
76 are
77 .Dq Li "-S -l -Fcoff" .
78 .Pp
79 Microcode as
80 distributed by FORE Systems for the PCA host ATM adapter does not need
81 to be processed.
82 .Sh FILES
83 .Bl -tag -width indent
84 .It Pa ~fore/etc/objcopy
85 command to process FORE Systems supplied microcode.
86 .It Pa ~fore/etc/sba200*.ucode*
87 microcode as supplied by FORE Systems for SBA
88 adapters.
89 .It Pa ~fore/i386/pca200e.bin
90 microcode as supplied by FORE Systems for PCA
91 adapters.
92 .It Pa ~harp/doc/Install
93 HARP installation instructions.
94 .El
95 .Sh BUGS
96 None known.
97 .Sh COPYRIGHT
98 Copyright (c) 1994-1998, Network Computing Services, Inc.
99 .Sh AUTHORS
100 .An John Cavanaugh ,
101 Minnesota Supercomputer Center, Inc.
102 .An Mike Spengler ,
103 Minnesota Supercomputer Center, Inc.
104 .An Joe Thomas ,
105 Minnesota Supercomputer Center, Inc.
106 .Sh ACKNOWLEDGMENTS
107 This software was developed under the sponsorship of the
108 Defense Advanced Research Projects Agency (DARPA) under
109 contract numbers F19628-92-C-0072 and F19628-95-C-0215.