% Sun Logo for Frame. X3T10/95-229, Revision 2. September 28, 1995

Transcription

1 Su Microsystems, Ic Garcia Aveue Moutai View, CA X3T10/95-229, Revisio 2 September 28, 1995 % Su Logo for Frame Joh Lohmeyer Chairperso, X3T10 Symbios Logic Ic Aeroplaza Drive Colorado Sprigs, Colorado Subject:Proposal for Persistet Reservatio This proposal exteds the defiitio of reservatios to allow proper behavior i multi-iitiator ad multi-port eviromets. The proposal defies persistet reservatios which remai valid across Target Reset ad ca oly be cleared by power dow or by a properly qualified persistet reservatio from aother iitiator. Usig the commads defied by this proposal, a host ca protect the logical uit from improper behavior caused by aother iitiator o the same or other ports. At the same time, the host ca determie from a logical uit which iitiators share the logical uit, which iitiator is presetly reservig the logical uit, ad ca choose to displace the reservatio of a iitiator which is kow to have failed. Sicerely, Robert N. Sively Su Microsystems Mail Stop MPK Garcia Ave. Moutai View, CA phoe: bob.sively@su.com

2 X3T10/95-229, Revisio 2 Chage cotrol Chages from Revisio 1 to Revisio 2 (results of X3T10 meetig, Sept., 1995) 1) Editorial chages A umber of mior editorial chages, icludig modifyig wordig to meet the covetios for required fuctios of usig the word shall. 2) Sectio N..1.3 of sectio proposed for SPC. The text is clarified to idicate that while o task attribute requiremets for the Release actio are defied, the Release should ot be performed util after ay tasks iterlocked by the persistet reservatio are completed. 3) Sectio N..1.5 of sectio proposed for SPC. Text is added to idicate that the Preempt ad Clear actio clears ACA tasks ad the ACA coditio, but does ot clear ay AEN iitiated by the target. Note that a PERSISTENT RESERVE OUT with the Preempt ad Clear actio requested will pass a ACA coditio for the preempted iitiator, but ot for other iitiators. 4) Sectio N.m.2.1 of sectio proposed for SPC. The geeratio coutig process is modified to be more useful. It icremets o Register, Preempt, ad Preempt ad Clear so that ay chages i the relatioship amog the iitiators workig with the particular logical uit is idicated with a ew Geeratio value. 5) Notes for SAM or SAM-2 Notes are provided for iclusio i SAM or SAM-2 to clarify the special behaviors of ACA ad RESERVATION CONFLICT status required by persistet reservatios. 6) Uregister with preempt Sectio N..1.4 ad N..1.5 should have a idicatio that the preempt uregisters the preempted iitiator. This will allow recofiguratios that remove a iitiator kow to be bad to guaratee that the replacemet iitiator will have to reregister before it ca begi participatig i the persistet reserve protocol agai. Preemptio may also be required i the case where a lik restructures itself ad modifies the address of some iitiators. Sectios N..1.2,3,4, ad 5 must be modified to idicate that the actios ca oly be performed by a iitiator that has registered. I have writte this error as a RESERVATION CONFLICT, although a ivalid parameter would also be a acceptable error. 7) Scope of key Sectio N..1.1 is modified to idicate that the reservatio key is registered with a logical uit. PAGE 2 OF 22

3 X3T10/95-229, Revisio 2 Persistet Reservatio Proposal Descriptio of fuctio / Persistet Reservatio model: Two ew commads are defied i SPC, PERSISTENT RESERVE IN (PRIN) ad PERSISTENT RESERVE OUT (PROUT). The commads are used to create ad release persistet reservatios (icludig logical uit or Extet reservatios), to provide reservatio keys to logical uits, ad to force actios o tasks from other iitiators. The PRIN ad PROUT commads have the followig capabilities, may of which are optioal: Create persistet reservatios usig PROUT. Extet (shared reservatios defied) Exclusive logical uit Shared logical uit (shared reservatios defied) Release persistet reservatios usig PROUT. Register a 8-byte Reservatio Key for the sourcig iitiator with the attached device usig PROUT. Determie the preset reservatio's key ad characteristics usig PRIN. Determie the key of other iitiators that are attached to the peripheral device usig PRIN. Preempt a reservatio with aother iitiator with ew reservatio from this usig PROUT. Optioally automatically clear all tasks related with the preempted reservatio. Geerate a 32-bit umber icreasig with each reservatio to war of iterveig actios. A persistet reservatio is formed betwee a iitiator ad a logical uit whe the PROUT commad cotaiig the parameters requestig a persistet reservatio is successfully executed. The parameters idicate the type of reservatio that is formed. I additio, the parameters cotai a 8-byte reservatio key that is used by the target ad by software o other iitiators to idetify the iitiator holdig the reservatio. The persistet reservatio caot be released by a Target Reset, other reset activity, or by a RELEASE commad. It ca be released oly by the reservig iitiator usig a PROUT commad cotaiig the release parameters, by a power off, or by aother iitiator usig the PROUT commad cotaiig the proper preemptive reservatio parameters ad the reservatio key of the iitiator holdig the reservatio. While the persistet reservatio is active, ay coflictig persistet reservatio or activity that coflicts with the reservatio is rejected with RESERVATION CONFLICT status. This behavior allows ay cooperatig iitiators havig access to the logical uit ay port to execute carefully maaged reservatio protocols that will allow the logical uit to be safely shared amog them. The reservatio is safe from iterruptio by ay iitiators ot participatig i the persistet reservatio protocol, eve durig bootig ad error recovery operatios. The use of a reservatio key as part of the reservatio process eables iitiators to idetify other ports holdig reservatios or sharig the logical uit. Hosts use the reservatio key to perform lockig ad failover recovery operatios. The commuicatio for such algorithms is usually a auxiliary port such as Etheret or Fibre Chael. Targets with reservatios held by failig hosts ca be idetified ad preemptively reserved by hosts that are still PAGE 3 OF 22

4 X3T10/95-229, Revisio 2 operatioal. Whe preemptive reservatios are performed, the reservig iitiator ca optioally ivoke a automatic clearig of all tasks for the iitiator port that is beig preempted. The reservatio key of other ports that have previously geerated persistet reservatios ca be obtaied from the logical uit to allow each iitiator to moitor which iitiator ports have participated i the sharig process. The programmig covetios typically used with RESERVE ad RELEASE coflict with the programmig covetios that are used with PROUT ad PRIN. Operatig systems should oly use oe of the two reservatio commad sets at a time withi a sigle logical uit. Reservatios established by RESERVE are defied as coflictig with those defied by PROUT ad vice versa. Modificatios required to SPC to implemet persistet reservatio: 1) Provide additioal descriptio i sectio 5.3 of SPC Sectio 5.3 ad should be rewritte as follows: 5.3 Reservatios Various types of reservatio commads ca be used to prohibit or restrict the executio of certai commads to a logical uit or a portio of the logical uit. Usig these reservatio commads, applicatio cliets ca cooperate to protect shared data from accidetal modificatio. If the applicatio cliets do ot cooperate i the executio of a reservatio protocol, data may be uexpectedly modified ad deadlock coditios may occur. Two types of reservatio commads are defied. The opersistet reservatio commads, RESERVE(6), RESERVE(10), RELEASE(6), ad RELEASE(10) are used amog multiple iitiators that do ot require operatios to be protected across iitiator failures. The reservatios created by such commads iclude reservatios for the etire logical uit or for a extet of the logical uit. Extet reservatios may place restrictios oly upo certai types of commads. The reservatios may also be made restrictig access to the device to a differet iitiator, usually a temporary iitiator performig a service for the reservig iitiator. The reservatios do ot persist across some recovery actios, so most systems usig opersistet reservatios require sigificat reiitializatio after a failure. Reservatios are retaied by the logical uit util released or util reset by mechaisms specified i this stadard. The persistet reservatio commads, PERSISTENT RESERVE IN ad PERSISTENT RESERVE OUT, are used amog multiple iitiators that require operatios to be protected across iitiator failures. The reservatios created by such commads iclude reservatios for the etire logical uit or for a extet of the logical uit. Both extet ad logical uit reservatios may place restrictios o certai types of commads. The reservatios do persist across recovery actios, so that recovery ca be maaged without requirig complete reiitializatio of the system. Reservatios for failig iitiators ca be preempted by a iitiator PAGE 4 OF 22

5 X3T10/95-229, Revisio 2 as part of the recovery process. Persistet reservatios are retaied by the logical uit util released, preempted, or util cleared by mechaisms specified i this stadard. Because a device server caot differetiate amog differet applicatio cliets ruig o a iitiator, all applicatio cliets o the iitiator have the same access restrictios. Whe multiple applicatio cliets are accessig a sigle device server from oe iitiator, the applicatio cliets shall coordiate reservatios. The clause defiig each commad s operatios shall cotai a descriptio of how that commad is affected by reservatios. The commad may be allowed to execute or it may be preveted from executio. If the commad is preveted from executio, the commad is said to coflict with the reservatio ad the logical uit shall preset a status of RESERVATION CONFLICT. Commads that read or write to the storage medium or to storage caches shall obey the rules defied i the clauses describig the RESERVE commad ad the PERSISTENT RESERVE OUT commad. Commads that retrieve or alter iformatio about the device server s operatig state shall coflict with logical uit reservatios uless otherwise specified. Commads that alter iformatio about the device server s operatig state shall coflict, uless otherwise specified, with extet reservatios uless the logical uit maitais separate state iformatio for each iitiator. The INQUIRY ad REQUEST SENSE commads shall ot be affected by ay kid of reservatio. The RESERVE(6) ad RESERVE(10) commads allow supercedig reservatios ad shall be executed eve whe opersistet reservatios are preset from the same iitiator. The RELEASE(6) ad RELEASE(10) commads shall be executed for the reservig iitiator eve whe opersistet reservatios are preset. The executio of a RESERVE(6) or a RESERVE(10) commad coflicts with a persistet reservatio. The executio of a PERSISTENT RESERVE OUT commad with a Reserve, Release, Preempt, or Preempt ad Clear actio coflicts with a opersistet reservatio. 2) Replace sectio 5.4 of SPC cocerig Dual Port behavior The etire clause etitled Dual Port behavior should be replaced with the followig text: 5.4 Multiple port ad multiple iitiator behavior The SCSI Architectural Model, X x, specifies the behavior of logical uits beig accessed by more tha oe iitiator. Additioal ports to a logical uit provide alterate delivery paths which the device server ca be reached ad may also provide coectivity for additioal iitiators. A alterate path ca be used to improve the availability of drives i the presece of certai types of failures ad to improve the performace of drives whose other paths may be busy. If a logical uit has more tha oe SCSI iterface port, the arbitratio ad coectio maagemet amog the ports is defied by the itercoect implemetatio. Above the itercoect implemetatio, two cotetio resolutio optios exist: PAGE 5 OF 22

6 X3T10/95-229, Revisio 2 1) If oe port to a logical uit is beig used by a iitiator, accesses attempted aother port may receive a status of BUSY. 2) If the logical uit has sufficiet iteral resources, the logical uit may accept actios other ports while oe port is beig used. The device server shall idicate the presece of multiple ports by settig the DualP bit to 1 i its stadard INQUIRY data. From a iitiator, each other iitiator attached to the logical uit shall have the same relatioship to the logical uit, whether the other iitiator accesses the logical uit the same or a differet port. Reservatios, persistet reservatios, ad task maagemet fuctios are performed betwee a sigle iitiator ad a sigle logical uit. The followig operatios are the oly operatios that allow a iitiator to iteract with the tasks of aother iitiator: PERSISTENT RESERVE OUT with Preempt actio removes persistet reservatios for aother iitiator. PERSISTENT RESERVE OUT with Preempt ad Clear actio removes persistet reservatios ad all tasks for aother iitiator. Task Maagemet fuctio of TARGET RESET removes opersistet reservatios ad removes all tasks for all logical uits of the target ad for all iitiators. Persistet reservatios remai umodified. Task Maagemet fuctio of LOGICAL UNIT RESET removes opersistet reservatios ad removes all tasks for all iitiators for the addressed logical uit ad ay logical uits depedig from it i a hierarchical addressig structure. Persistet reservatios remai umodified. [Editor s ote: This paragraph is icluded i expectatio of the acceptace of the LOGICAL UNIT RESET task maagemet fuctio.] Task Maagemet fuctio of CLEAR TASK SET removes all tasks for the selected logical uit for all iitiators. Most other machie states remai umodified, icludig MODE SELECT PARAMETERS, persistet ad opersistet reservatios, ad auto cotiget allegiace. 3) Remove referece to the Port Status commad i Table 5 At preset, the refereced sectio etitled Port Status is ot icluded i revisio 6 of SPC. It should cotiue to be ot icluded ad should be removed from table 5, page 16. 4) Iclude PROUT ad PRIN commads i SPC: The PERSISTENT RESERVE OUT commad ad the PERSISTENT RESERVE IN commad will be icluded i table 5 as Z commads. The followig text will be added to SPC: N. PERSISTENT RESERVE OUT commad PAGE 6 OF 22

7 X3T10/95-229, Revisio 2 The PERSISTENT RESERVE OUT or PROUT commad (see Table 1) is used to reserve a logical uit or a extet withi a logical uit for the exclusive or shared use of a particular iitiator. The commad shall be used i cojuctio with the PERSISTENT RESERVE IN commad ad shall ot be used with the RESERVE ad RELEASE commads. Persistet reservatios shall coflict with reservatios established by the RESERVE commad. Iitiators performig PROUT actios are idetified by a reservatio key provided by the applicatio cliet. A applicatio cliet ca use the PRIN commad to idetify which applicatios are holdig coflictig or ivalid reservatios ad use the PROUT commad to preempt those reservatios if required. The PROUT ad PRIN commads provide the basic mechaism for dyamic cotetio resolutio i multiple-iitiator systems usig multiple port targets. The idetificatio of reservatios usig the reservatio key makes it possible to determie which ports hold coflictig reservatios ad to take over reservatios from failig or ucooperative iitiators. Table 1: PERSISTENT RESERVE OUT commad Bits Bytes Operatio Code (5Fh) 1 reserved Actio 2 Scope Type 3 reserved 4 reserved 5 reserved 6 reserved 7 8 Parameter Legth 9 Cotrol The PROUT commad cotais fields that specify a persistet reservatio actio, the iteded scope of the reservatio, ad the restrictios caused by the reservatio. Parameters cotaied i the PROUT Parameters specify the reservatio keys ad extet iformatio required to perform a particular persistet reservatio actio. The parameters shall be 24 bytes i legth ad the Parameter Legth field shall have a value of 24. If the Parameter Legth is ot 24, a CHECK CONDITION is idicated with a ASC/ASCQ of Ivalid Parameter List Legth (1A/00). Sice persistet reservatios are ot reset by Target Reset or other global actios, they ca be used to eforce device sharig amog multiple iitiators. PAGE 7 OF 22

8 X3T10/95-229, Revisio 2 Commads from ay iitiator that coflict with a successfully established persistet reservatio shall be rejected with a status of RESERVATION CONFLICT. The followig commads shall ot coflict with a persistet reservatio: INQUIRY REQUEST SENSE PREVENT ALLOW MEDIUM REMOVAL (with a prevet bit of oe) PERSISTENT RESERVE IN PERSISTENT RESERVE OUT (with a actio of Preempt) PERSISTENT RESERVE OUT (with a actio of Preempt ad Clear) PERSISTENT RESERVE OUT (with a reservatio actio that does ot coflict with established persistet reservatios or tasks) Other commads coflict if they perform a operatio to the logical uit that violates either the scope or the type specified for a active persistet reservatio. Each commad of a set of liked commads is idividually examied for coflicts at the time the commad is received by the target. N..1 PROUT Reservatio Actios: The PROUT commad actios are show i Table 2. The parameters required for each actio are show i Table 6. Table 2: PERSISTENT RESERVE OUT Actio Actio Code (Hex) Actio Name Actio Descriptio 00 Register Register Reservatio Key with target 01 Reserve Create Persistet Reservatio usig Reservatio Key 02 Release Release Persistet Reservatio 03 (reserved) 04 Preempt Pre-empt Persistet Reservatio for other iitiator 05 Pre-empt ad Clear Persistet Reservatio ad Clear Task Set for preempted iitiator 06-1F (reserved) N..1.1 Register The PROUT commad executig a Register actio registers a reservatio key with a logical uit without geeratig a reservatio. For each iitiator that performs a PROUT Register actio, the logical uit retais the reservatio key util the key is chaged by a ew PROUT commad with PAGE 8 OF 22

9 X3T10/95-229, Revisio 2 the Register actio from the same iitiator or util the key is reset to the default value of 0 by powerig dow the logical uit or by performig a Preempt or Preempt ad Clear actio to the iitiator. The Register actio ca be performed regardless of ay active persistet reservatios. All existig persistet reservatios for the iitiator receive the ew reservatio key. If the preset reservatio key is ot correctly provided by the parameters of the Register actio, a status value of CHECK CONDITION with a ASC/ASCQ of Ivalid Parameter (29/00) shall be geerated whe the Register actio is attempted. For predictable behavior, there are o task attribute requiremets for the Register actio. N..1.2 Reserve The PROUT commad performig a Reserve actio creates a persistet reservatio havig a specified scope ad type. The scope ad type of a persistet reservatio are defied below. A status of CHECK CONDITION ad a ASC/ASCQ of Ivalid Parameter (29/00) shall be geerated for a PROUT commad that specifies a reservatio key other tha the key for the iitiator. A status of RESERVATION CONFLICT shall be geerated for a PROUT commad that specifies the executio of a Reserve actio that coflicts with ay active persistet reservatios from the same iitiator i scope, type, extet, or reservatio key at the time the PROUT is eabled for executio. The PROUT commad with a Reserve actio shall be rejected with a status of RESERVATION CONFLICT if the iitiator requestig the commad has ot previously performed a Register actio with the logical uit. For the simplest predictable behavior, the Reserve actio should be performed with the Ordered task attribute. Persistet reservatios shall ot be superceded by a ew persistet reservatio from ay iitiator except by executio of a PROUT specifyig either the Preempt or Preempt ad Clear actio. New persistet reservatios that do ot coflict with a existig persistet reservatio shall be executed ormally. The reservatio of a logical uit or the reservatio of reserved extets havig the same type value is permitted if o coflictig persistet reservatios are held by aother iitiator. Whe such overlappig reservatios are released, each of the extet reservatios ad the logical uit reservatio shall be removed with a separate Release actio. A PROUT commad ot performig a Preempt or a Preempt ad Clear actio shall ot be performed ad shall be eded with status of RESERVATION CONFLICT if there are ay queued or active tasks from ay iitiator that would coflict with the reservatio to be established at the time the PROUT commad is eabled for executio. N..1.3 Release The PROUT commad performig a Release actio removes a active persistet reservatio held by the same iitiator. The parameters associated with the Release actio must match the parameters of the active reservatio. It is ot a error to sed a PAGE 9 OF 22

10 X3T10/95-229, Revisio 2 PROUT specifyig a Release actio whe o persistet reservatio exists from that iitiator. The reservatio key is ot chaged by the Release actio. A status of CHECK CONDITION ad a ASC/ASCQ of Ivalid Release of Active Persistet Reservatio shall be geerated for a PROUT commad that specifies the release of a persistet reservatio with a icorrect scope, reservatio key, or extet. A active persistet reservatio may also be released by either of the followig mechaisms: 1) Power off. The power off also performs a hard reset ad sets the reservatio key to its default value of 0. 2) Executio of a PROUT commad from aother iitiator with a Persistet Reserve Actio of Preempt or Preempt ad Clear The PROUT commad with a Release actio shall be rejected with a status of RESERVATION CONFLICT if the iitiator requestig the commad has ot previously performed a Register actio with the logical uit. For predictable behavior, there are o task attribute requiremets for the Release actio. A Release actio should ot be performed if ay operatios iterlocked by the persistet reservatio are ot yet complete. N..1.4 Preempt The PROUT commad that successfully performs a Preempt actio shall remove all reservatios for the iitiator specified by the PROUT parameter page. The iitiator is idetified by the reservatio key of the iitiator to be preempted. Ay commads from ay iitiator that have bee accepted by the logical uit as ocoflictig will cotiue ormal executio. A Uit Attetio coditio is established for the preempted iitiator. The first ew commad from the preempted iitiator shall preset CHECK CONDITION ad preset the Uit Attetio coditio with a ASC/ASCQ of Uit Attetio/Reservatios preempted. Subsequet commads are subject to the reservatio restrictios established by the preemptig iitiator. The persistet reservatio created by the preemptig iitiator is specified by the scope ad type field of the PROUT commad ad the correspodig parameters i the PROUT parameter page. The registratio key for the iitiator that has bee preempted is cleared by the preempt actio. The PROUT commad with a Preempt actio shall be rejected with a status of RESERVATION CONFLICT if the iitiator requestig the commad has ot previously performed a Register actio with the logical uit. PAGE 10 OF 22

11 X3T10/95-229, Revisio 2 For predictable behavior, there are o task attribute requiremets for the Preempt actio. N..1.5 Preempt ad Clear The PROUT commad performig a Preempt ad Clear actio removes all reservatios for the iitiator specified by the PROUT parameter page. The iitiator is idetified by the reservatio key of the iitiator to be preempted. Ay commads from the iitiator beig preempted are each termiated as if a ABORT TASK task maagemet fuctio had bee performed by the preempted iitiator. A Uit Attetio coditio is established for the preempted iitiator. The first ew commad from the preempted iitiator shall preset CHECK CONDITION ad preset the Uit Attetio coditio with a ASC/ASCQ of Uit Attetio/Reservatios preempted. Subsequet ew commads ad retries of commads that timed out because they were cleared are subject to the reservatio restrictios established by the preemptig iitiator. The persistet reservatio created by the preemptig iitiator is specified by the scope ad type field of the PROUT commad ad the correspodig parameters i the PROUT parameter page. The Preempt ad Clear actio shall clear ay Automatic Cotiget Allegiace coditio (ACA coditio) associated with the iitiator beig preempted ad shall clear ay tasks with a ACA attribute from that iitiator. ACA coditios for other iitiators shall prevet the executio of the PERSISTENT RESERVE OUT task, which shall ed with status of ACA ACTIVE. Ay Asychroous Evet Notificatio tasks (AEN tasks) i progress that were iitiated by the SCSI target are ot affected by the Preempt ad Clear actio. The registratio key for the iitiator that has bee preempted is cleared by the preempt actio. The PROUT commad with a Preempt ad Clear actio shall be rejected with a status of RESERVATION CONFLICT if the iitiator requestig the commad has ot previously performed a Register actio with the logical uit. For predictable behavior, there are o task attribute requiremets for the Preempt ad Clear actio. N..2 PERSISTENT RESERVE OUT Scope The value i the Scope field shall idicate whether a persistet reservatio applies to a etire logical uit, to a portio of the logical uit defied as a extet, or to a elemet. If a Scope field specifies a scope that is ot implemeted, a status of CHECK PAGE 11 OF 22

12 X3T10/95-229, Revisio 2 CONDITION with a ASC/ASCQ value of Ivalid CDB (24/00) is preseted. The values of the Scope field are defied i Table 3. Table 3: PERSISTENT RESERVE OUT Scope Code (Hex) Scope Name Scope Descriptio 0 LU The Persistet Reservatio Out is applied to the full logical uit. 1 Extet The Persistet Reservatio Out is applied to the specified extet. 2 Elemet The Persistet Reservatio Out is applied to the specified elemet. 3-F (reserved) N..2.1 LU A Scope field value of LU shall idicate that the persistet reservatio applies to the etire logical uit. The LU scope shall be implemeted by all targets that implemet PROUT. N..2.2 Extet A Scope field value of Extet shall idicate that the persistet reservatio applies to the extet of the logical uit defied by the extet parameters i the PROUT parameter page. A extet is defied oly for devices defiig cotiguous logical block addresses. The Extet scope is optioal for all targets that implemet PROUT. The umber of extets that ca be reserved for a logical uit is implemetatio depedet. N..2.3 Elemet A Scope field value of Elemet shall idicate that the persistet reservatio applies to the elemet of the logical uit defied by the elemet parameters i the PROUT parameter page. A elemet is defied by the Medium Chager Commad Set (SMC). The Elemet scope is optioal for all targets that implemet PROUT. N..3 PERSISTENT RESERVE OUT Type The value i the Type field shall specify the characteristics of the persistet reservatio beig established for all data blocks withi the extet or withi the logical uit. Table 4 describes the characteristics of the five differet type values. PAGE 12 OF 22

13 X3T10/95-229, Revisio 2 Table 4PERSISTENT RESERVE OUT Type Type Descriptio Code (Hex) Type Name Read Write Permitted Reservatios 0 Read Shared Shared Prohibited Nocoflictig, ay iitiator 1 Write Exclusive Shared Exclusive Nocoflictig, ay iitiator 2 Read Exclusive Exclusive Shared Nocoflictig, ay iitiator 3 Exclusive Access Exclusive Exclusive Nocoflictig, this iitiator 4 Shared Access Shared Shared Nocoflictig, this iitiator 5-F (reserved) N..3.1 Read If a type allows read commads to be shared, the ay iitiator ca execute commads that perform trasfers from the storage medium or cache of the logical uit to the iitiator. If a type requires read commads to be exclusive, the oly the reservig iitiator ca perform a trasfer from the storage medium or cache to the iitiator. Ay SCSI commads from aother iitiator that would create such a trasfer will receive status of RESERVATION CONFLICT. N..3.2 Write If a type allows write commads to be shared, the ay iitiator ca execute commads that perform trasfers from the iitiator to the storage medium or cache of the logical uit. If a type requires write commads to be exclusive, the oly the reservig iitiator ca perform a trasfer from the iitiator to the storage medium or cache of the logical uit. Ay SCSI commads from aother iitiator that would create such a trasfer will receive status of RESERVATION CONFLICT. If a type requires write commads to be prohibited, the ay commad from ay iitiator that would create such a trasfer will receive status of RESERVATION CONFLICT. N..3.3 Permitted Reservatios PAGE 13 OF 22

14 X3T10/95-229, Revisio 2 If a type allows ocoflictig reservatios from ay iitiator, the ay iitiator may geerate persistet reservatios to the same extet or logical uit as log as the characteristics are ot cotrary to the existig reservatios. Attempts to create coflictig reservatios will receive status of RESERVATION CONFLICT. If a type allows ocoflictig reservatios oly from the reservig iitiator, the all attempts by other iitiators to perform ay PROUT commad with the Reserve actio will receive status of RESERVATION CONFLICT. Attempts to create coflictig reservatios by the reservig iitiator will receive status of RESERVATION CONFLICT. N..4 PERSISTENT RESERVE OUT parameters The parameters required to perform the PROUT commad are defied i Table 5 ad i Table 7. Table 6 idicates which parameters shall be set by the iitiator ad expected by the target for each Actio ad Scope value. The locatios for all parameter fields shall be trasmitted, eve if the parameter is ot required for the specified fuctio Table 5: PERSISTENT RESERVE OUT parameters Bit Fuctio of Byte Byte PROUT parameter page PAGE 14 OF 22

15 X3T10/95-229, Revisio 2 Table 6: PERSISTENT RESERVE OUT: Allowed actios ad valid parameters Parameters Set by iitiator/expected by target Actio Allowed Scope Key for port performig PROUT Key for port chaged by PROUT Extet or Elemet Parameters Register LU Set/Expected Set/Expected Not Set/Igored Reserve LU Set/Expected Not Set/Igored Not Set/Igored Reserve Extet Set/Expected Not Set/Igored Extet Set/Expected Reserve Elemet Set/Expected Not Set/Igored Elemet Set/Expected Release LU Set/Expected Not Set/Igored Not Set/Igored Release Extet Set/Expected Not Set/Igored Extet Set/Expected Release Elemet Set/Expected Not Set/Igored Elemet Set/Expected Preempt LU Set/Expected Set/Expected Not Set/Igored Preempt Extet Set/Expected Set/Expected Extet Set/Expected Preempt Elemet Set/Expected Set/Expected Elemet Set/Expected Preempt ad Clear LU Set/Expected Set/Expected Not Set/Igored Preempt ad Clear Extet Set/Expected Set/Expected Extet Set/Expected Preempt ad Clear Elemet Set/Expected Set/Expected Elemet Set/Expected N..4.1 Reservatio Key of iitiator performig commad The reservatio key is a 8-byte toke provided by the iitiator to the logical uit to idetify the source of the PROUT commad. The default value of the reservatio key is set by power o reset ad is 0. N..4.2 Reservatio Key of iitiator beig chaged The reservatio key of the iitiator beig chaged is used for three actios, the Register actio ad the two Preempt actios. For the Register actio, this reservatio key is the ew reservatio key to be registered. For the Preempt actios, this reservatio key matches the reservatio key of the persistet reservatio that is beig preempted. If it does ot match, the PROUT commad presets status of RESERVATION CONFLICT. PAGE 15 OF 22

16 X3T10/95-229, Revisio 2 N..4.3 Extet defiitio parameters The extet parameters are oly required for those PROUT actios that use a Scope value of Extet. The extet is defied by the 32-bit startig logical block address ad the 16-bit cout of logical blocks i the extet. N..4.4 Elemet defiitio parameters The elemet address parameter is oly required for those PROUT actios that use a Scope value of Elemet. The elemet address is provided i bytes 18 ad 19. Table 7: PERSISTENT RESERVE OUT parameter page Fuctio of Byte Bit Byte Reservatio Key of iitiator performig commad 8 15 Reservatio Key of iitiator beig chaged LBA of first block of Extet / Elemet Address 20 (reserved) 21 (reserved) Extet Legth N.m PERSISTENT RESERVE IN commad The PERSISTENT RESERVE IN or PRIN commad (see Table 8) is used to obtai iformatio about reservatios ad reservatio keys that are active withi a logical uit. The commad is used i cojuctio with the PERSISTENT RESERVE OUT commad ad caot be used with the RESERVE ad RELEASE commads. The actual legth of the parameters that could be retured by the PRIN commad is defied withi the parameter list. The Parameter Legth field i the CDB idicates how PAGE 16 OF 22

17 X3T10/95-229, Revisio 2 much space has bee reserved for the retured parameter list. If the legth is ot sufficiet to cotai the etire parameter list, the first portio of the list is retured. If the remaider of the list is required, a ew PRIN commad with a Parameter Legth field large eough to cotai the etire list is executed. For predictable behavior, there are o task attribute requiremets for the PRIN commad. Table 8: PERSISTENT RESERVE IN commad Bits Bytes Operatio Code (5Eh) 1 reserved Actio 2 reserved 3 reserved 4 reserved 5 reserved 6 reserved 7 8 Parameter Legth 9 Cotrol N.m.1 PERSISTENT RESERVE IN actio codes The actio codes for the PRIN commad are defied i Table 9. Table 9: PERSISTENT RESERVE IN Actio Actio Code (Hex) Actio Name Actio Descriptio 00 Read Keys Reads all registered Reservatio Keys 01 Read Reservatios Reads all curret reservatios 02-1F (reserved) (reserved) PAGE 17 OF 22

18 X3T10/95-229, Revisio 2 N.m.1.1 Read Keys The Read Keys actio value requests that the logical uit retur a parameter list cotaiig a header ad a complete list of all reservatio keys that have bee passed to the logical uit from all iitiators. The keys may have bee passed by a PROUT commad that has performed a reserve actio, a register actio, or oe of the preempt actios. The reservatio keys do ot idicate what iitiator or port is associated with the key. That iformatio must be obtaied from other iitiators by mechaisms outside the scope of this stadard. N.m.1.2 Read Reservatios The Read Reservatios actio value requests that the logical uit retur a parameter list cotaiig a header ad a complete list of all reservatios that are presetly active o the logical uit ad its extets. N.m.2 PERSISTENT RESERVE IN parameters for Read Keys The format for the parameters provided i respose to a PRIN commad with the Read Keys actio is show i Table 10. Table 10: PERSISTENT RESERVE IN parameters for Read Keys Fuctio of Byte Byte Bit Geeratio 4 7 Additioal legth of parameter field 8 15 First Reservatio Key Nth Reservatio Key N.m.2.1 Geeratio The Geeratio value is a 32-bit couter i the logical uit that is icremeted every time a PROUT commad requests a Register, a Preempt, or a Preempt ad Clear operatio. The couter is ot icremeted by a PRIN commad, by a PROUT commad PAGE 18 OF 22

19 X3T10/95-229, Revisio 2 that performs a Reserve or Release actio, or by a PROUT commad that is ot performed due to a error or reservatio coflict. The Geeratio value is set to 0 as part of the power o reset process. The Geeratio value allows the iitiator examiig the geeratio value to verify that the cofiguratio of the iitiators attached to a logical uit has ot bee modified by aother iitiator without the kowledge of the examiig iitiator. N.m.2.2 Additioal Legth This field cotais a cout of the umber of bytes i the reservatio key list. The total umber of bytes available i a particular PRIN commad is 8 more tha the value i the Additioal Legth field. If the Parameter Legth specified by the PRIN commad is ot sufficiet to cotai the etire parameter list, the oly the bytes from 0 to the maximum allowed Parameter Legth are trasmitted to the iitiator. The remaiig bytes are trucated, although the Additioal Legth field still cotais the umber of bytes i the reservatio key list that would have bee trasmitted. I the case of such a trucatio, CHECK CONDITION status with sese iformatio of icorrect legth is provided. N.m.2.3 Reservatio Key list This list cotais all the 8-byte reservatio keys kow to the logical uit PROUT Reserve, Preempt, Preempt ad Clear, or Register actios. Each reservatio key may be examied by the host system ad correlated with a particular iitiator ad SCSI port by mechaisms outside the scope of this stadard. N.m.3 PERSISTENT RESERVE IN parameters for Read Reservatios The format for the parameters provided i respose to a PRIN commad with the Read Reservatios actio is show i Table 11. PAGE 19 OF 22

20 X3T10/95-229, Revisio 2 Table 11: PERSISTENT RESERVE IN parameters for Read Reservatios Fuctio of Byte Byte Bit Geeratio 4 7 Additioal legth of parameter field 8 23 First Read Reservatio Page Nth Read Reservatio Page The Geeratio field ad Additioal Legth fields are defied exactly the same as the fields for the parameters for the Read Keys actio. The read reservatio pages are defied i Table 12. There is oe read reservatio page for each reservatio held o the logical uit by ay iitiator. Table 12: PERSISTENT RESERVE IN Read Reservatio Page Fuctio of Byte Byte Bit Reservatio Key of port holdig reservatio 8 11 LBA of first block of Extet / Elemet Address 12 (reserved) 13 Scope Type Extet Legth PAGE 20 OF 22

21 X3T10/95-229, Revisio 2 N.m.3.1 Read Reservatio Page parameters For each reservatio held o the logical uit, there shall be a Read Reservatio page preseted i the list of parameters retured by the logical uit to the PRIN commad with a Read Reservatios actio. The page cotais the reservatio key of the iitiator holdig the reservatio. The type ad scope of the reservatio are also defied. If the scope is a Extet reservatio, the the LBA of the first block of the extet ad the extet legth parameters are valid. If the scope is a Elemet reservatio, the Elemet address is placed i bytes 10 ad 11 ad bytes 8, 9, 14, ad 15 are set to 0. If the scope is a Logical Uit reservatio, the bytes 8 11, 14, ad 15 are set to 0. New ASC/ASCQ defiitios required: The followig ew ASC/ASCQ idicatios or iterpretatios are required to preset error iformatio associated with persistet reservatios: Ivalid CDB (24/00) (Ivalid Release of Active Persistet Reservatio) Ivalid Parameter (26/00) (offered whe more tha oe parameter page is specified by PROUT Preempt). Ivalid Parameter (26/00) (offered whe duplicate keys are established by a Register actio) Uit Attetio/Reservatios Preempted (Sese Code = 06, 2A/TBD) Icorrect Legth (ILI bit = 1, Sese Code = 0) (offered whe Parameter Legth is too short for PRIN parameter lists.) Ivalid Parameter List Legth (1A/00) (offered whe Parameter Legth is ot = 24 i PROUT) Proposed text chages to SBC, SSC, SMC, ad SCC The PERSISTENT RESERVE IN ad PERSISTENT RESERVE OUT commads shall be icluded i the itroductory commad maps for all four commad sets. PERSISTENT RESERVE IN, PERSISTENT RESERVE OUT, RESERVE(6), RESERVE(10), RELEASE(6), ad RELEASE(10) shall be marked as S (for selectively madatory) istead of M. The followig ote shall be applied for RESERVE(6), RELEASE(6), RESERVE(10), RELEASE(10), PERSISTENT RESERVE IN, ad PERSISTENT RESERVE OUT: At least oe pair of the followig pairs of commads is madatory: RESERVE(6), RELEASE(6) RESERVE(10), RELEASE(10) PERSISTENT RESERVE IN, PERSISTENT RESERVE OUT PERSISTENT RESERVE IN ad PERSISTENT RESERVE OUT should be icluded i the commad set of multi-ported devices. PAGE 21 OF 22

22 X3T10/95-229, Revisio 2 If exteded logical uit addresses are implemeted, at least oe pair of the followig pairs of commads is madatory: RESERVE(10), RELEASE(10) PERSISTENT RESERVE IN, PERSISTENT RESERVE OUT Proposed text chages to SAM or SAM-2 documet: The followig ote is required i SAM to clarify a additioal behavior required for persistet reservatio that is ot yet explicitly icluded i SAM. The ote most logically is placed as a additioal paragraph i sectio or SAM revisio 18, or i the correspodig sectio of a erratum or SAM-2 documet. If the logical uit accepts a value of oe for the NACA bit ad this bit was set to oe i the CDB cotrol byte of the faultig commad, the the auto cotiget allegiace coditio may also be cleared by ay iitiator that performs the Preempt ad Clear actio of the PERSISTENT RESERVE OUT commad that clears the tasks of the faultig iitiator. The followig ote is recommeded for SAM to expad upo the expected causes ad behaviors associated with RESERVATION CONFLICT status. The text should replace the RESERVATION CONFLICT status defiitio i sectio 5.2 of SAM revisio 18, or i the correspodig sectio of a erratum or SAM-2 documet. RESERVATION CONFLICT. This status shall be retured wheever a iitiator attempts to access a logical uit, a elemet of a logical uit, or a extet withi a logical uit that is reserved with a coflictig reservatio type to aother SCSI iitiator. (See the RESERVE, RELEASE, PERSISTENT RESERVE OUT, AND PERSISTENT RESERVE IN commads i SPC.) The recommeded iitiator recovery actio is to issue the commad agai at a later time. Error recovery may require the executio of the preempt or preempt ad clear actios of PERSISTENT RESERVE OUT to remove a persistet reservatio to a failig iitiator. Noe. Proposed text chages to other SCSI-3 documets: PAGE 22 OF 22