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