1、American National StandardDeveloped byfor Information Technology SCSI Object-Based Storage Device Commands (OSD)ANSI INCITS 400-2004ANSIINCITS400-2004Copyright American National Standards Institute Provided by IHS under license with ANSINot for ResaleNo reproduction or networking permitted without l
2、icense from IHS-,-,-ANSIINCITS 400-2004American National Standardfor Information Technology SCSI Object-Based StorageDevice Commands (OSD)SecretariatInformation Technology Industry CouncilApproved December 15, 2004 American National Standards Institute, Inc.AbstractThis SCSI command set is designed
3、to provide efficient operation of input/output logical units thatmanage the allocation, placement, and accessing of variable-size data-storage containers, calledobjects. Objects are intended to contain operating system and application constructs.Copyright American National Standards Institute Provid
4、ed by IHS under license with ANSINot for ResaleNo reproduction or networking permitted without license from IHS-,-,-Approval of an American National Standard requires review by ANSI that therequirements for due process, consensus, and other criteria for approval havebeen met by the standards develop
5、er.Consensus is established when, in the judgement of the ANSI Board ofStandards Review, substantial agreement has been reached by directly andmaterially affected interests. Substantial agreement means much more thana simple majority, but not necessarily unanimity. Consensus requires that allviews a
6、nd objections be considered, and that a concerted effort be madetowards their resolution.The use of American National Standards is completely voluntary; theirexistence does not in any respect preclude anyone, whether he has approvedthe standards or not, from manufacturing, marketing, purchasing, or
7、usingproducts, processes, or procedures not conforming to the standards.The American National Standards Institute does not develop standards andwill in no circumstances give an interpretation of any American NationalStandard. Moreover, no person shall have the right or authority to issue aninterpret
8、ation of an American National Standard in the name of the AmericanNational Standards Institute. Requests for interpretations should beaddressed to the secretariat or sponsor whose name appears on the titlepage of this standard.CAUTION NOTICE: This American National Standard may be revised orwithdraw
9、n at any time. The procedures of the American National StandardsInstitute require that action be taken periodically to reaffirm, revise, orwithdraw this standard. Purchasers of American National Standards mayreceive current information on all standards by calling or writing the AmericanNational Stan
10、dards Institute.American National StandardPublished byAmerican National Standards Institute, Inc.25 West 43rd Street, New York, NY 10036Copyright 2005 by Information Technology Industry Council (ITI)All rights reserved.No part of this publication may be reproduced in anyform, in an electronic retrie
11、val system or otherwise,without prior written permission of ITI, 1250 Eye Street NW, Washington, DC 20005. Printed in the United States of AmericaCAUTION: The developers of this standard have requested that holders of patents that may be re-quired for the implementation of the standard disclose such
12、 patents to the publisher. However, nei-ther the developers nor the publisher have undertaken a patent search in order to identify which, ifany, patents may apply to this standard. As of the date of publication of this standard, followingcalls for the identification of patents that may be required f
13、or the implementation of the standard,notice of one or more such claims has been received. By publication of this standard, no positionis taken with respect to the validity of this claim or of any rights in connection therewith. The knownpatent holder(s) has (have), however, filed a statement of wil
14、lingness to grant a license underthese rights on reasonable and nondiscriminatory terms and conditions to applicants desiring to ob-tain such a license. Details may be obtained from the publisher. No further patent search is con-ducted by the developer or publisher in respect to any standard it proc
15、esses. No representation ismade or implied that this is the only license that may be required to avoid infringement in the use ofthis standard.Copyright American National Standards Institute Provided by IHS under license with ANSINot for ResaleNo reproduction or networking permitted without license
16、from IHS-,-,-iContentsPageForeword xIntroduction xv1 Scope . 12 Normative references. 52.1 Normative references 52.2 Approved ISO references 52.3 Approved FIPS references 52.4 Approved IETF References. 52.5 References under development 63 Definitions, symbols, abbreviations, and conventions 73.1 Def
17、initions . 73.2 Acronyms 103.3 Keywords 103.4 Conventions 113.5 Bit and byte ordering . 123.6 Notation conventions. 123.6.1 Notation for byte encoded character strings 123.6.2 Notation for procedure calls . 133.7 Data field requirements . 143.7.1 ASCII data field requirements 143.7.2 Data field term
18、ination and padding requirements 144 SCSI OSD Model . 154.1 The request-response model 154.2 OSD type devices . 154.3 OSD object abstraction . 164.4 Elements of the example configuration . 174.5 Description of the OSD Architecture . 184.6 Stored data objects . 184.6.1 Stored data object types 184.6.
19、2 Identifying OSD objects 194.6.3 Root object . 194.6.4 Partitions 194.6.5 User objects . 204.6.6 Collections 204.7 OSD object attributes 214.7.1 Overview 214.7.2 Command function ordering for commands that get and/or set attributes. 21Copyright American National Standards Institute Provided by IHS
20、under license with ANSINot for ResaleNo reproduction or networking permitted without license from IHS-,-,-iiPage4.7.3 Attributes pages . 224.7.4 Attributes 234.7.5 Attributes directories 244.8 Quotas. 244.8.1 Introduction 244.8.2 Quota errors. 254.8.3 Quota testing 254.8.4 Changing quotas 254.9 Poli
21、cy/storage management 264.9.1 Overview 264.9.2 Capabilities. 264.9.2.1 Introduction . 264.9.2.2 Capability format . 274.9.2.2.1 Introduction 274.9.2.2.2 U/C capability object descriptor 314.9.2.2.3 PAR capability object descriptor 324.9.2.3 Capabilities and commands allowed. 334.9.3 Policy access ta
22、gs 374.10 Security . 384.10.1 Basic security model 384.10.2 Trust assumptions 404.10.3 Preparing credentials . 414.10.4 Security methods . 424.10.4.1 Introduction . 424.10.4.2 The NOSEC security method 434.10.4.3 The CAPKEY security method 444.10.4.4 The CMDRSP security method. 444.10.4.5 The ALLDAT
23、A security method. 454.10.5 Credentials. 484.10.5.1 Credential format. 484.10.5.2 Capability key 484.10.6 OSD device server security algorithms 494.10.6.1 Credential validation 494.10.6.2 Reconstructing the credential 494.10.6.3 Computing the credential integrity check value. 504.10.6.4 Invalidating
24、 credentials 504.10.7 Request nonces . 514.10.7.1 Request nonce format. 514.10.7.2 Device server validation of request nonces 514.10.7.3 Lists of previously used request nonces . 524.10.7.3.1 Introduction 524.10.7.3.2 Freezing capability audit fields. 524.10.7.3.3 Freezing working keys . 534.10.8 In
25、tegrity check values. 534.10.9 Secret keys 544.10.9.1 Introduction . 544.10.9.2 Computing updated generation keysand new authentication keys 554.10.10 OSD security interactions with SPC-3 commands and SAM-3 task management functions . 56Copyright American National Standards Institute Provided by IHS
26、 under license with ANSINot for ResaleNo reproduction or networking permitted without license from IHS-,-,-iiiPage4.11 Data persistence model. 564.12 Data-In and Data-Out Buffer model. 574.12.1 Bidirectional data transfers. 574.12.2 OSD meta data. 574.12.3 OSD Data-In Buffer format . 584.12.4 OSD Da
27、ta-Out Buffer format 594.12.5 Data-In and Data-Out buffer offsets . 604.13 Interactions between concurrently processed commands. 604.14 Error reporting . 614.14.1 Introduction. 614.14.2 OSD-specific sense data descriptors . 624.14.2.1 OSD error identification sense data descriptor 624.14.2.2 OSD res
28、ponse integrity check value sense data descriptor 644.14.2.3 OSD attribute identification sense data descriptor 644.14.3 Auto contingent allegiance . 654.15 Linked commands . 654.16 Reservations . 655 Common Formats. 685.1 OSD CDB format. 685.2 Fields commonly used in OSD commands 695.2.1 Overview 6
29、95.2.2 Get and set attributes parameters 705.2.2.1 Get and set attributes CDB format selection . 705.2.2.2 Get an attributes page and set an attribute value . 705.2.2.3 Get and set attributes lists. 725.2.3 Length 735.2.4 Options byte . 735.2.5 Partition_ID. 745.2.6 Security parameters . 745.2.7 Sta
30、rting byte address . 745.2.8 Timestamps control 755.2.9 User_Object_ID 756 Commands for OSD type devices 766.1 Summary of commands for OSD type devices 766.2 APPEND 786.3 CREATE 806.4 CREATE AND WRITE. 826.5 CREATE COLLECTION 846.6 CREATE PARTITION 866.7 FLUSH. 876.8 FLUSH COLLECTION. 896.9 FLUSH OS
31、D 90Copyright American National Standards Institute Provided by IHS under license with ANSINot for ResaleNo reproduction or networking permitted without license from IHS-,-,-ivPage6.10 FLUSH PARTITION 926.11 FORMAT OSD 936.12 GET ATTRIBUTES . 956.13 LIST. 966.14 LIST COLLECTION. 996.15 PERFORM SCSI
32、COMMAND. 1026.16 PERFORM TASK MANAGEMENT FUNCTION . 1046.17 READ 1066.18 REMOVE. 1086.19 REMOVE COLLECTION. 1096.20 REMOVE PARTITION 1106.21 SET ATTRIBUTES 1116.22 SET KEY. 1126.23 SET MASTER KEY. 1146.23.1 Introduction 1146.23.2 Seed exchange 1156.23.3 Change master key 1166.24 WRITE. 1187 Paramete
33、rs for OSD type devices 1207.1 Attributes parameters 1207.1.1 Attributes parameter formats 1207.1.2 OSD attributes pages. 1207.1.2.1 Attributes pages overview. 1207.1.2.2 Attribute number 0h in all attributes pages 1227.1.2.3 Attribute number 0h for unidentified attributes pages . 1227.1.2.4 Root Di
34、rectory attributes page 1237.1.2.5 Partition Directory attributes page. 1247.1.2.6 Collection Directory attributes page 1257.1.2.7 User Object Directory attributes page. 1267.1.2.8 Root Information attributes page. 1277.1.2.9 Partition Information attributes page . 1297.1.2.10 Collection Information
35、 attributes page. 1307.1.2.11 User Object Information attributes page . 1317.1.2.12 Root Quotas attributes page . 1327.1.2.13 Partition Quotas attributes page 1347.1.2.14 User Object Quotas attributes page 1367.1.2.15 Root Timestamps attributes page . 1377.1.2.16 Partition Timestamps attributes page
36、 1397.1.2.17 Collection Timestamps attributes page. 1417.1.2.18 User Object Timestamps attributes page 1437.1.2.19 Collections attributes page 1447.1.2.20 Root Policy/Security attributes page . 147Copyright American National Standards Institute Provided by IHS under license with ANSINot for ResaleNo
37、 reproduction or networking permitted without license from IHS-,-,-vPage7.1.2.21 Partition Policy/Security attributes page 1527.1.2.22 Collection Policy/Security attributes page . 1537.1.2.23 User Object Policy/Security attributes page 1577.1.2.24 Current Command attributes page 1597.1.2.25 Null att
38、ributes page . 1617.1.3 OSD attributes lists. 1617.1.3.1 Attributes lists overview. 1617.1.3.2 List entry format for retrieving attributes for this OSD object. 1627.1.3.3 List entry format for retrieved attributes and for setting attributes for this OSD object . 1637.1.3.4 List entry format for attr
39、ibutes retrieved by CREATE command that creates multiple user objects . 1647.2 Diagnostic parameters 1657.3 Log parameters . 1657.4 Mode parameters 1657.5 Vital product data parameters . 1667.5.1 Overview 1667.5.2 OSD Information VPD page . 1667.5.2.1 Overview . 1667.5.2.2 OSD logical unit security
40、methods information descriptor. 1677.5.3 Security Token VPD page 168AnnexesA Attributes page numbers assigned by other standards 169B Numeric order codes . 170C Examples of OSD Operation 171Tables1 OSD model objects 182 Partition_ID and User_Object_ID value assignments 193 Attributes page numbers 22
41、4 Attributes page number sets 235 Attributes directory pages. 246 Capability format 277 Capability format values . 278 Created time for OSD objects by type 289 Object type values 2910 Permissions bit mask format 2911 Object descriptor types. 3012 User object/collection descriptor format . 3113 Polic
42、y access tag usage for OSD object types and commands . 31Copyright American National Standards Institute Provided by IHS under license with ANSINot for ResaleNo reproduction or networking permitted without license from IHS-,-,-viPage14 Partition descriptor format 3215 Commands allowed by specific ca
43、pability field values. 3316 Attribute retrieving and setting function allowed by specific capability field values 3517 Policy access tag format 3718 Security manager communications trust requirements 4019 OSD security methods . 4220 Security methods and threats thwarted 4321 Data-out integrity infor
44、mation format 4622 Data-in integrity information format 4723 Credential format 4824 Request nonce format 5125 OSD secret key hierarchy 5426 OSD Data-In Buffer and Data-Out Buffer model 5727 OSD Data-In Buffer format. 5828 Summary of OSD Data-In Buffer offsets 5829 OSD Data-Out Buffer format 5930 Sum
45、mary of OSD Data-Out Buffer offsets . 5931 CDB Data-In Buffer and Data-Out Buffer offset field format 6032 OSD object identification sense data descriptor format . 6233 Command functions bits. 6334 Command functions indicated by the command functions bits 6335 Command functions bits combinations 633
46、6 OSD response integrity check value sense data descriptor format . 6437 OSD attribute identification sense data descriptor format 6438 Sense data attribute descriptor format. 6539 OSD commands that are allowed in the presence of various reservations 6740 Basic OSD CDB. 6841 OSD service action speci
47、fic fields 7042 Get and set attributes CDB format code values. 7043 Page oriented get and set attributes CDB parameters format . 7044 List oriented get and set attributes CDB parameters format 7245 Option byte format 7346 Security parameters format 7447 Timestamps control values 75Copyright American
48、 National Standards Institute Provided by IHS under license with ANSINot for ResaleNo reproduction or networking permitted without license from IHS-,-,-viiPage48 Commands for OSD type devices 7649 APPEND command 7850 CREATE command 8051 CREATE AND WRITE command. 8252 CREATE COLLECTION command 8453 C
49、REATE PARTITION command 8654 FLUSH command. 8755 User object flush scope values. 8856 FLUSH COLLECTION command. 8957 Collection flush scope values . 8958 FLUSH OSD command 9059 Root object flush scope values. 9160 FLUSH PARTITION command. 9261 Partition flush scope values 9262 FORMAT OSD command. 9363 GET ATTRIBUTES command 9564 LIST command . 9665 LIST sort order values 9666 LIST command param
