/drivers/scsi/scsi_obsolete.h

  1/*
  2 *  scsi_obsolete.h Copyright (C) 1997 Eric Youngdale
  3 *
  4 */
  5
  6#ifndef _SCSI_OBSOLETE_H
  7#define _SCSI_OBSOLETE_H
  8
  9/*
 10 * These are the return codes for the abort and reset functions.  The mid-level
 11 * code uses these to decide what to do next.  Each of the low level abort
 12 * and reset functions must correctly indicate what it has done.
 13 * The descriptions are written from the point of view of the mid-level code,
 14 * so that the return code is telling the mid-level drivers exactly what
 15 * the low level driver has already done, and what remains to be done.
 16 */
 17
 18/* We did not do anything.  
 19 * Wait some more for this command to complete, and if this does not work, 
 20 * try something more serious. */
 21#define SCSI_ABORT_SNOOZE 0
 22
 23/* This means that we were able to abort the command.  We have already
 24 * called the mid-level done function, and do not expect an interrupt that 
 25 * will lead to another call to the mid-level done function for this command */
 26#define SCSI_ABORT_SUCCESS 1
 27
 28/* We called for an abort of this command, and we should get an interrupt 
 29 * when this succeeds.  Thus we should not restore the timer for this
 30 * command in the mid-level abort function. */
 31#define SCSI_ABORT_PENDING 2
 32
 33/* Unable to abort - command is currently on the bus.  Grin and bear it. */
 34#define SCSI_ABORT_BUSY 3
 35
 36/* The command is not active in the low level code. Command probably
 37 * finished. */
 38#define SCSI_ABORT_NOT_RUNNING 4
 39
 40/* Something went wrong.  The low level driver will indicate the correct
 41 * error condition when it calls scsi_done, so the mid-level abort function
 42 * can simply wait until this comes through */
 43#define SCSI_ABORT_ERROR 5
 44
 45/* We do not know how to reset the bus, or we do not want to.  Bummer.
 46 * Anyway, just wait a little more for the command in question, and hope that
 47 * it eventually finishes.  If it never finishes, the SCSI device could
 48 * hang, so use this with caution. */
 49#define SCSI_RESET_SNOOZE 0
 50
 51/* We do not know how to reset the bus, or we do not want to.  Bummer.
 52 * We have given up on this ever completing.  The mid-level code will
 53 * request sense information to decide how to proceed from here. */
 54#define SCSI_RESET_PUNT 1
 55
 56/* This means that we were able to reset the bus.  We have restarted all of
 57 * the commands that should be restarted, and we should be able to continue
 58 * on normally from here.  We do not expect any interrupts that will return
 59 * DID_RESET to any of the other commands in the host_queue, and the mid-level
 60 * code does not need to do anything special to keep the commands alive. 
 61 * If a hard reset was performed then all outstanding commands on the
 62 * bus have been restarted. */
 63#define SCSI_RESET_SUCCESS 2
 64
 65/* We called for a reset of this bus, and we should get an interrupt 
 66 * when this succeeds.  Each command should get its own status
 67 * passed up to scsi_done, but this has not happened yet. 
 68 * If a hard reset was performed, then we expect an interrupt
 69 * for *each* of the outstanding commands that will have the
 70 * effect of restarting the commands.
 71 */
 72#define SCSI_RESET_PENDING 3
 73
 74/* We did a reset, but do not expect an interrupt to signal DID_RESET.
 75 * This tells the upper level code to request the sense info, and this
 76 * should keep the command alive. */
 77#define SCSI_RESET_WAKEUP 4
 78
 79/* The command is not active in the low level code. Command probably
 80   finished. */
 81#define SCSI_RESET_NOT_RUNNING 5
 82
 83/* Something went wrong, and we do not know how to fix it. */
 84#define SCSI_RESET_ERROR 6
 85
 86#define SCSI_RESET_SYNCHRONOUS		0x01
 87#define SCSI_RESET_ASYNCHRONOUS		0x02
 88#define SCSI_RESET_SUGGEST_BUS_RESET	0x04
 89#define SCSI_RESET_SUGGEST_HOST_RESET	0x08
 90/*
 91 * This is a bitmask that is ored with one of the above codes.
 92 * It tells the mid-level code that we did a hard reset.
 93 */
 94#define SCSI_RESET_BUS_RESET 0x100
 95/*
 96 * This is a bitmask that is ored with one of the above codes.
 97 * It tells the mid-level code that we did a host adapter reset.
 98 */
 99#define SCSI_RESET_HOST_RESET 0x200
100/*
101 * Used to mask off bits and to obtain the basic action that was
102 * performed.  
103 */
104#define SCSI_RESET_ACTION   0xff
105
106#endif				/* SCSI_OBSOLETE_H */