org.jscsi.target.connection.stage.fullfeature

Class FormatUnitStage

java.lang.Object

org.jscsi.target.connection.stage.TargetStage

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

org.jscsi.target.connection.stage.fullfeature.FormatUnitStage

public class FormatUnitStage
extends TargetFullFeatureStage

A stage for processing FORMAT UNIT SCSI commands.

The FORMAT UNIT command requests that the device server format the medium into application client accessible logical blocks as specified in the number of logical blocks and logical block length values received in the last mode parameter block descriptor in a MODE SELECT command (see SPC-4). In addition, the device server may certify the medium and create control structures for the management of the medium and defects.

The degree that the medium is altered by this command is vendor specific.

If a device server receives a FORMAT UNIT command before receiving a MODE SELECT command with a mode parameter block descriptor, then the device server shall use the number of logical blocks and logical block length at which the logical unit is currently formatted (i.e., no change is made to the number of logical blocks and the logical block length of the logical unit during the format operation).

FORMAT UNIT commands received by the jSCI Target will not lead to any persistent changes of the virtual logical unit.

Author:

Andreas Ergenzinger

Field Summary

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

connection, session, settings, targetPhase

Constructor Summary

Constructors

Constructor and Description
FormatUnitStage(TargetFullFeaturePhase targetFullFeaturePhase)

Method Summary

Methods

Modifier and Type	Method and Description
void	execute(ProtocolDataUnit pdu) Starts the stage.

Methods inherited from class org.jscsi.target.connection.stage.fullfeature.TargetFullFeatureStage

createFixedFormatErrorPdu, createFixedFormatErrorPdu, createScsiResponsePdu, sendResponse

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

getConnection

Methods inherited from class java.lang.Object

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

Constructor Detail

FormatUnitStage

public FormatUnitStage(TargetFullFeaturePhase targetFullFeaturePhase)

Method Detail

execute

public void execute(ProtocolDataUnit pdu)
             throws IOException,
                    InterruptedException,
                    InternetSCSIException,
                    DigestException,
                    SettingsException

Description copied from class: TargetStage

Starts the stage. This method contains the operational logic required for the receiving, processing and sending of PDUs which is needed to successfully complete the represented iSCSI stage.

Specified by:

execute in class TargetStage

Parameters:

pdu - the first ProtocolDataUnit to be processed in the stage

Throws:

IOException - if the connection was closed unexpectedly

InterruptedException

InternetSCSIException - if a PDU has violated the iSCSI standard

DigestException - if a digest error was detected

SettingsException - if the program has attempted to access a value from settings which has not been negotiated and which does not have a default value