fwdl(1)				  README			1998/10/08

COPYRIGHT
=========

Copyright (c) 1997-1998 Kenneth W. Preslan <kpreslan@lcse.umn.edu>
Copyright (c) 1998-1999 Grant Erickson <gerickson@brocade.com>
Copyright (c) 1998 David Teigland <teigland@lcse.umn.edu>

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc., 59
Temple Place - Suite 330, Boston, MA 02111-1307, USA

DESCRIPTION
===========

'fwdl' is a program which will download firmware to a Seagate Fibre
Channel disk drive. The program currently only works with drives attached
to a Prisa Networks NetFX adapter on Silicon Graphics systems, drives
attached to Sun Microsystems workstations, or drives attached to a
Linux-based workstation.

FILES
=====

CHANGES		Revision history.
INSTALL		Compilation and installation instructions.
README		This file.
Makefile	Makefile
*.[Ch]		Program source files.

USAGE
=====

The proper usage of 'fwdl' for your particular system can be determined by
typing 'fwdl -h' on the command line (on a Sun workstation):

	user@host% fwdl -h
	Usage: ./fwdl [-dhV] <target disk> <file>
	  target disk  Target disk device.
	  file         Firmware data to be downloaded to the drive.
	  -d           Enable debugging code (if so compiled).
	  -h           Print this help, then exit.
	  -V           Print program version information, then exit.

Once 'fwdl' has successfully issued 3 SCSI test unit ready commands to the
device and has successfully retrieved the drive's inquiry data, you will
be prompted to continue the firmware download process. At this point, any
non-white space input except 'y' or 'Y' will result in the cancellation of
the download.

Once the download process has been confirmed, 'fwdl' will provide a 5
second countdown in which you can still exit the program by issuing a KILL
signal via the keyboard or using the 'kill' command. Once the countdown
has terminated, the download process will commence and will require
several minutes to complete.

CAVEATS
=======

Please be sure you know what you are doing before running this program! It
is completely within the realm of possibility that a drive could be ruined
as a result of downloading the incorrect firmware resulting in an
expensive door stop.

BUGS/CHANGES/COMMENTS/SUGGESTIONS
=================================

Please report any bugs, changes, comments, or suggestions to Grant
Erickson at <gerickson@brocade.com>, Kenneth Preslan at
<kpreslan@lcse.umn.edu>, or David Teigland at <teigland@lcse.umn.edu>.

If you are reporting a bug, recompile the program with the -DDEBUG option
if it wasn't already, and include a program trace after running the
program with the '-d' option.

If you make any changes or additions to the program, please submit the
changes back to us, so that we might integrate them with the rest of the
code and re-release them.
