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$
  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 .Nm
  41 downloads FORE Systems' microcode into the host ATM adapter(s).
  42 .Sh OPTIONS
  43 .Bl -tag -width indent
  44 .It Fl i Ar intf
  45 Specify which ATM interface to download microcode to.
  46 Default is to load microcode into all FORE Systems host adapters.
  47 .It Fl d Ar path
  48 Specify the path to prepend to the
  49 .Ar objfile
  50 name.
  51 Default is to use current directory.
  52 .It Fl f Ar objfile
  53 Specify the microcode binary file.
  54 Defaults are:
  55 .Pa sba200.obj
  56 for SBA-200 adapters,
  57 .Pa sba200e.obj
  58 for SBA-200E adapters, and
  59 .Pa pca200e.bin
  60 for PCA-200E adapters.
  61 .El
  62 .Sh NOTES
  63 For the PCA200E adapter, if no file is specified on the command
  64 line a built-in copy of version 3.0.1 microcode is used.
  65 .Pp
  66 Microcode as distributed by FORE Systems is not ready for downloading
  67 directly into SBA host ATM adapters.
  68 Instead, the supplied microcode needs
  69 to be processed with the
  70 .Xr objcopy 1
  71 command to create an image suitable
  72 for downloading.
  73 Arguments to
  74 .Xr objcopy 1
  75 are
  76 .Dq Li "-S -l -Fcoff" .
  77 .Pp
  78 Microcode as
  79 distributed by FORE Systems for the PCA host ATM adapter does not need
  80 to be processed.
  81 .Sh FILES
  82 .Bl -tag -width indent
  83 .It Pa ~fore/etc/objcopy
  84 command to process FORE Systems supplied microcode.
  85 .It Pa ~fore/etc/sba200*.ucode*
  86 microcode as supplied by FORE Systems for SBA
  87 adapters.
  88 .It Pa ~fore/i386/pca200e.bin
  89 microcode as supplied by FORE Systems for PCA
  90 adapters.
  91 .It Pa ~harp/doc/Install
  92 HARP installation instructions.
  93 .El
  94 .Sh BUGS
  95 None known.
  96 .Sh COPYRIGHT
  97 Copyright (c) 1994-1998, Network Computing Services, Inc.
  98 .Sh AUTHORS
  99 .An John Cavanaugh ,
 100 Minnesota Supercomputer Center, Inc.
 101 .An Mike Spengler ,
 102 Minnesota Supercomputer Center, Inc.
 103 .An Joe Thomas ,
 104 Minnesota Supercomputer Center, Inc.
 105 .Sh ACKNOWLEDGMENTS
 106 This software was developed under the sponsorship of the
 107 Defense Advanced Research Projects Agency (DARPA) under
 108 contract numbers F19628-92-C-0072 and F19628-95-C-0215.