tran_abort(9e)

1tran_abort(9E)                Driver Entry Points               tran_abort(9E)
2
3
4

NAME

6       tran_abort - abort a SCSI command
7

SYNOPSIS

9       #include <sys/scsi/scsi.h>
10
11
12
13        int prefixtran_abort(struct scsi_address *ap,
14            struct scsi_pkt *pkt);
15
16

INTERFACE LEVEL

18       Solaris architecture specific (Solaris DDI).
19

ARGUMENTS

21       ap      Pointer to a scsi_address(9S) structure.
22
23
24       pkt     Pointer to a scsi_pkt(9S) structure.
25
26

DESCRIPTION

28       The tran_abort() vector in the scsi_hba_tran(9S) structure must be ini‐
29       tialized during the HBA driver's attach(9E) to point to  an  HBA  entry
30       point to be called when a target driver calls scsi_abort(9F).
31
32
33       tran_abort()  should  attempt  to  abort  the command pkt that has been
34       transported to the HBA.  If pkt is NULL, the HBA driver should  attempt
35       to  abort all outstanding packets for the target/logical unit addressed
36       by ap.
37
38
39       Depending on the state of a particular command in the transport  layer,
40       the HBA driver may not be able to abort the command.
41
42
43       While  the  abort  is  taking  place, packets issued to the transported
44       layer may or may not be aborted.
45
46
47       For  each  packet  successfully  aborted,  tran_abort()  must  set  the
48       pkt_reason  to  CMD_ABORTED,  and  pkt_statistics  must  be  OR'ed with
49       STAT_ABORTED .
50

RETURN VALUES

52       tran_abort() must return:
53
54       1     upon success or partial success.
55
56
57       0     upon failure.
58
59

CONTEXT

61       The tran_abort() function can be called from user or interrupt context.
62       This requirement comes from scsi_abort().
63

NOTES

72       If pkt_reason already indicates that an  earlier  error  had  occurred,
73       tran_abort() should not overwrite pkt_reason with CMD_ABORTED.
74
75
76
77SunOS 5.11                        17 Aug 2005                   tran_abort(9E)