Visit Our UNIX and Linux User Community

Linux and UNIX Man Pages

Test Your Knowledge in Computers #501
Difficulty: Easy
If a piece of code adds two numbers together and stores the result, there should be a comment that explains the process in the source code.
True or False?
Linux & Unix Commands - Search Man Pages

tran_abort(9e) [sunos man page]

tran_abort(9E)							Driver Entry Points						    tran_abort(9E)

NAME
tran_abort - abort a SCSI command SYNOPSIS
#include <sys/scsi/scsi.h> int prefixtran_abort(struct scsi_address *ap, struct scsi_pkt *pkt); INTERFACE LEVEL
Solaris architecture specific (Solaris DDI). ARGUMENTS
ap Pointer to a scsi_address(9S) structure. pkt Pointer to a scsi_pkt(9S) structure. DESCRIPTION
The tran_abort() vector in the scsi_hba_tran(9S) structure must be initialized during the HBA driver's attach(9E) to point to an HBA entry point to be called when a target driver calls scsi_abort(9F). tran_abort() should attempt to abort the command pkt that has been transported to the HBA. If pkt is NULL, the HBA driver should attempt to abort all outstanding packets for the target/logical unit addressed by ap. Depending on the state of a particular command in the transport layer, the HBA driver may not be able to abort the command. While the abort is taking place, packets issued to the transported layer may or may not be aborted. For each packet successfully aborted, tran_abort() must set the pkt_reason to CMD_ABORTED, and pkt_statistics must be OR'ed with STAT_ABORTED . RETURN VALUES
tran_abort() must return: 1 upon success or partial success. 0 upon failure. SEE ALSO
attach(9E), scsi_abort(9F), scsi_hba_attach(9F), scsi_address(9S), scsi_hba_tran(9S), scsi_pkt(9S) Writing Device Drivers NOTES
If pkt_reason already indicates that an earlier error had occurred, tran_abort() should not overwrite pkt_reason with CMD_ABORTED. SunOS 5.10 30 Aug 1995 tran_abort(9E)

Check Out this Related Man Page

tran_reset(9E)							Driver Entry Points						    tran_reset(9E)

NAME
tran_reset - reset a SCSI bus or target SYNOPSIS
#include <sys/scsi/scsi.h> int prefixtran_reset(struct scsi_address *ap, int level); INTERFACE LEVEL
Solaris architecture specific (Solaris DDI). PARAMETERS
ap Pointer to the scsi_address(9S) structure. level The level of reset required. DESCRIPTION
The tran_reset() vector in the scsi_hba_tran(9S) structure must be initialized during the HBA driver's attach(9E) to point to an HBA entry point to be called when a target driver calls scsi_reset(9F). tran_reset() must reset either the SCSI bus, a SCSI target device, or a SCSI logical unit as specified by level. level must be one of the following: RESET_ALL Reset the SCSI bus. RESET_TARGET Reset the target specified by ap. RESET_LUN Reset the logical unit specified by ap. tran_reset should set the pkt_reason field of all outstanding packets in the transport layer associated with each target or logical unit that was successfully reset to CMD_RESET and the pkt_statistics field must be OR'ed with either STAT_BUS_RESET (if the SCSI bus was reset) or STAT_DEV_RESET (if the target or logical unit was reset). The HBA driver should use a SCSI Bus Device Reset Message to reset a target device. The HBA driver should use a SCSI Logical Unit Reset Message to reset a logical unit. Packets that are in the transport layer but not yet active on the bus should be returned with pkt_reason set to CMD_RESET and pkt_statis- tics OR'ed with STAT_ABORTED. Support for RESET_LUN is optional but strongly encouraged for new and updated HBA drivers. If an HBA driver provides RESET_LUN support, it must also create the lun-reset capability with a value of zero for each target device instance represented by a valid ap. The HBA is also required to provide the means to return the current value of the lun-reset capability in its tran_getcap(9E) routine, as well as the means to change the value of the lun_reset capability in its tran_setcap(9E) routine. RETURN VALUES
tran_reset() should return: 1 on success. 0 on failure. SEE ALSO
attach(9E), ddi_dma_buf_setup(9F), scsi_hba_attach(9F), scsi_reset(9F), scsi_address(9S), scsi_hba_tran(9S) Writing Device Drivers NOTES
If pkt_reason already indicates that an earlier error had occurred for a particular pkt, tran_reset() should not overwrite pkt_reason with CMD_RESET. SunOS 5.10 12 Jul 2002 tran_reset(9E)

Featured Tech Videos