org.jscsi.target.connection.stage.fullfeature

Class TargetFullFeatureStage

java.lang.Object

org.jscsi.target.connection.stage.TargetStage

org.jscsi.target.connection.stage.fullfeature.TargetFullFeatureStage

Direct Known Subclasses:

FormatUnitStage, InquiryStage, LogoutStage, ModeSenseStage, PingStage, ReadCapacityStage, ReadOrWriteStage, ReportLunsStage, RequestSenseStage, SendDiagnosticStage, TestUnitReadyStage, TextNegotiationStage, UnsupportedOpCodeStage

public abstract class TargetFullFeatureStage
extends TargetStage

This class is an abstract super-class for stages of the TargetFullFeaturePhase.

Author:

Andreas Ergenzinger

See Also:

TargetStage

Field Summary

Fields inherited from class org.jscsi.target.connection.stage.TargetStage

connection, session, settings, targetPhase

Constructor Summary

Constructors

Constructor and Description
TargetFullFeatureStage(TargetFullFeaturePhase targetFullFeaturePhase) The abstract constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected static ProtocolDataUnit	createFixedFormatErrorPdu(FieldPointerSenseKeySpecificData[] senseKeySpecificData, AdditionalSenseCodeAndQualifier additionalSenseCodeAndQualifier, int initiatorTaskTag, int expectedDataTransferLength) Creates a PDU with FixedFormatSenseData that must be sent to the initiator after receiving a Command Descriptor Block with an illegal field.
protected static ProtocolDataUnit	createFixedFormatErrorPdu(FieldPointerSenseKeySpecificData[] senseKeySpecificData, int initiatorTaskTag, int expectedDataTransferLength) Creates a PDU with FixedFormatSenseData that must be sent to the initiator after receiving a Command Descriptor Block with an illegal field, which requires the the additional sense code AdditionalSenseCodeAndQualifier.INVALID_FIELD_IN_CDB.
protected static ProtocolDataUnit	createScsiResponsePdu(SCSIStatus status, int initiatorTaskTag, int expectedDataTransferLength, int responseDataSize) Creates a SCSI Response PDU with a length zero data segment.
protected void	sendResponse(int initiatorTaskTag, int expectedDataTransferLength, IResponseData responseData) Sends a two byte sequence of a Data-In and a SCSI Response PDU with the specified responseData payload to the initiator.

Methods inherited from class org.jscsi.target.connection.stage.TargetStage

execute, getConnection

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TargetFullFeatureStage

public TargetFullFeatureStage(TargetFullFeaturePhase targetFullFeaturePhase)

The abstract constructor.

Parameters:

targetFullFeaturePhase - the phase this stage is a part of

Method Detail

createFixedFormatErrorPdu

protected static final ProtocolDataUnit createFixedFormatErrorPdu(FieldPointerSenseKeySpecificData[] senseKeySpecificData,
                                         AdditionalSenseCodeAndQualifier additionalSenseCodeAndQualifier,
                                         int initiatorTaskTag,
                                         int expectedDataTransferLength)

Creates a PDU with FixedFormatSenseData that must be sent to the initiator after receiving a Command Descriptor Block with an illegal field.

Parameters:

senseKeySpecificData - contains a list of all illegal fields

additionalSenseCodeAndQualifier - provides more specific information about the cause of the check condition

initiatorTaskTag - used by the initiator to identify the task

expectedDataTransferLength - the amount of payload data expected by the initiator (i.e. allocated buffer space)

Returns:

the error PDU

createFixedFormatErrorPdu

protected static final ProtocolDataUnit createFixedFormatErrorPdu(FieldPointerSenseKeySpecificData[] senseKeySpecificData,
                                         int initiatorTaskTag,
                                         int expectedDataTransferLength)

Creates a PDU with FixedFormatSenseData that must be sent to the initiator after receiving a Command Descriptor Block with an illegal field, which requires the the additional sense code AdditionalSenseCodeAndQualifier.INVALID_FIELD_IN_CDB.

Parameters:

senseKeySpecificData - contains a list of all illegal fields

initiatorTaskTag - used by the initiator to identify the task

expectedDataTransferLength - the amount of payload data expected by the initiator (i.e. allocated buffer space)

Returns:

the error PDU

createScsiResponsePdu

protected static final ProtocolDataUnit createScsiResponsePdu(SCSIStatus status,
                                     int initiatorTaskTag,
                                     int expectedDataTransferLength,
                                     int responseDataSize)

Creates a SCSI Response PDU with a length zero data segment. Objects created with this method can be used as replies in task terminating with SCSIStatus.GOOD which do not require additional data to be transfered, or for creating follow-up PDU with SCSIStatus.CHECK_CONDITION status sent after Data-In PDUs with sense data.

Parameters:

status - the SCSI status of the task

initiatorTaskTag - used by the initiator to identify the task

expectedDataTransferLength - total amount of payload data in bytes expected by the initiator

responseDataSize - actual amount of payload data in bytes sent by the target

Returns:

the SCSI Response PDU

sendResponse

protected final void sendResponse(int initiatorTaskTag,
                int expectedDataTransferLength,
                IResponseData responseData)
                           throws InterruptedException,
                                  IOException,
                                  InternetSCSIException

Sends a two byte sequence of a Data-In and a SCSI Response PDU with the specified responseData payload to the initiator.

Parameters:

initiatorTaskTag - used by the initiator to identify the task

expectedDataTransferLength - the total amount of payload data in bytes expected by the initiator

The method might throw exceptions during PDU serialization and sending.

responseData - the data requested by the initiator

Throws:

InterruptedException

IOException

InternetSCSIException