1、American National StandardDeveloped byfor Information Technology Fabric ApplicationInterface Standard (FAIS)ANSI INCITS 432-2007ANSIINCITS432-2007Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without lice
2、nse from IHS-,-,-Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-ANSIINCITS 432-2007American National Standardfor Information Technology Fabric ApplicationInterface Standard (FA
3、IS)SecretariatInformation Technology Industry CouncilApproved August 9, 2007 American National Standards Institute, Inc.AbstractThis standard defines an API by which a storage application may perform the functions of one or moreSCSI Targets or Initiators, and control high-performance command/data fo
4、rwarding and manipulation fa-cilities.Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-Approval of an American National Standard requires review by ANSI that therequirements for
5、due process, consensus, and other criteria for approval havebeen met by the standards developer.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
6、more thana simple majority, but not necessarily unanimity. Consensus requires that allviews and 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
7、, whether he has approvedthe standards or not, from manufacturing, marketing, purchasing, or 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
8、 NationalStandard. Moreover, no person shall have the right or authority to issue aninterpretation 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 titlepa
9、ge of this standard.CAUTION NOTICE: This American National Standard may be revised orwithdrawn 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 ma
10、yreceive current information on all standards by calling or writing the AmericanNational Standards Institute.American National StandardPublished byAmerican National Standards Institute, Inc.25 West 43rd Street, New York, NY 10036Copyright 2007 by Information Technology Industry Council (ITI)All righ
11、ts reserved.No part of this publication may be reproduced in anyform, in an electronic retrieval 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
12、holders of patents that may be re-quired for the implementation of the standard disclose such 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 publicat
13、ion of this standard, followingcalls for the identification of patents that may be required for 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
14、connection therewith. The knownpatent holder(s) has (have), however, filed a statement of willingness 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
15、 patent search is con-ducted by the developer or publisher in respect to any standard it processes. 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
16、under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-ContentsPageForeword .
17、 vi1 Scope 12 Normative References 22.1 Overview. 22.2 Approved references. 22.3 References under development 22.4 Other References 23 Definitions and conventions 43.1 Overview. 43.2 Definitions . 43.3 Editorial Conventions 63.4 Abbreviations and acronyms. 73.5 Notation for Procedures and Functions
18、83.6 Enumeration Lists . 83.7 Notation Conventions 93.7.12 Class diagram conventions. 93.8 Keywords 143.9 T10 Vendor ID fields . 154 Operational Model. 164.1 Overview. 164.2 Operational Layering. 174.3 Client/Provider Model 184.4 Service Groups 184.4.1 Overview 184.4.2 General Services . 184.4.3 Por
19、t Services 184.4.4 Front-end Services . 194.4.5 Back-end Services . 194.4.6 Volume Management Services 194.5 Framework . 194.5.1 Function Call Type . 194.5.2 Requests and Completions 194.5.3 Function Parameter Block 204.6 Event Notification . 205 Object Model 21i5.1 Overview 215.2 Model . 22Copyrigh
20、t American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-Page5.3 Meta-Attributes 235.3.1 Description . 235.3.2 Attributes 235.3.3 Relationships . 235.3.4 Handles 235.3.5 Identifiers . 255.4 Obje
21、cts . 265.4.1 BI . 265.4.2 BIT . 265.4.3 BITL . 275.4.4 BITLSetEntry . 275.4.5 BITLSetVDEV 285.4.6 BlockRange . 285.4.7 Column 285.4.8 ConcatenatedVDEV . 295.4.9 FAIS_Portal . 295.4.10 FIT . 305.4.11 FITL . 305.4.12 FLUVDEV 315.4.13 FT 315.4.14 Mirror . 315.4.15 MirroredVDEV 325.4.16 StripedVDEV 325
22、.4.17 VDEV . 335.4.18 XMapEntry . 335.4.19 XMapVDEV 346 General Services 356.1 Overview 356.2 Constants . 356.3 Data Structures 376.3.1 FAIS_ObjectType 376.3.2 FAIS_ClientRequest_Header 376.3.3 FAIS_ObjectCHandle 386.3.4 FAIS_ObjectPHandle . 396.3.5 FAIS_ClientCHandle 396.3.6 FAIS_ClientPHandle 396.
23、3.7 FAIS_HandleSet 396.3.8 FAIS_LUN 406.3.9 FAIS_Status . 406.3.10 FAIS_ProviderInfo . 426.3.11 FAIS_EnumerationFilter 426.3.12 FAIS_IO_Stats_T . 436.4 Function Calls 436.4.1 fais_Init 436.4.2 fais_Deinit 446.4.3 fais_Object_Enumerate . 456.4.4 fais_ObjectHandle_Update 466.4.5 fais_Get_IO_Stats . 47
24、iiCopyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-Page7 Port Services 487.1 Overview 487.2 Constants . 487.3 Data Structures 487.3.1 FAIS_Protocol 487.3.2 FAIS_IPVERSION 497.3.3
25、 FAIS_PortName_FCP 497.3.4 FAIS_PortName_ISCSI 507.3.5 FAIS_PortName . 507.3.6 FAIS_RegionId . 517.3.7 FAIS_Portal 517.3.8 FAIS_Portal_id_FCP 517.3.9 FAIS_Portal_id_ISCSI 527.3.10 FAIS_Portal_id . 527.4 Function Calls 537.4.1 fais_Region_Enumerate . 537.4.2 fais_Region_GetStatus 547.4.3 fais_Region_
26、GetDetail . 557.4.4 fais_Region_SetDetail 567.4.5 fais_Portal_Create . 577.4.6 fais_Portal_Destroy 587.4.7 fais_Portal_GetStatus 598 Front-end Services . 618.1 Overview 618.2 Data Structures 618.2.1 FAIS_FT . 618.2.2 FAIS_FIT 618.2.3 FAIS_FITL 628.2.4 FAIS_FITLPermission 628.3 Function Calls 638.3.1
27、 fais_FT_Create 638.3.2 fais_FT_Destroy . 648.3.3 fais_FT_Activate 658.3.4 fais_FT_Deactivate 668.3.5 fais_FT_GetStatus . 678.3.6 fais_FIT_Create . 688.3.7 fais_FIT_Destroy 688.3.8 fais_FIT_GetStatus 698.3.9 fais_FITL_Create . 708.3.10 fais_FITL_Destroy 718.3.11 fais_FITL_UpdatePermission . 718.3.12
28、 fais_FITL_AbortIOs 728.3.13 fais_FITL_GetStatus 739 Back-end Services 749.1 Overview 74iiiCopyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHSPage9.2 Data Structures 749.2.1 FAIS_BI . 7
29、49.2.2 FAIS_BIT . 749.2.3 FAIS_SCSI_CDB . 759.2.4 FAIS_SCSIFlag . 759.2.5 FAIS_SCSIStatus 759.2.6 FAIS_ResidualFlag 769.2.7 FAIS_TaskMgmtCmd 769.2.8 FAIS_TaskAttribute 779.2.9 FAIS_TaskMgmtResponse 779.2.10 FAIS_BITL . 789.2.11 FAIS_SCSI_SCB . 799.3 Function Calls 809.3.1 fais_BI_Create . 809.3.2 fa
30、is_BI_Destroy . 819.3.3 fais_BI_Activate . 829.3.4 fais_BI_Deactivate . 829.3.5 fais_BI_SendSCSICommand 839.3.6 fais_BI_GetStatus 849.3.7 fais_BIT_Create . 859.3.8 fais_BIT_Destroy . 869.3.9 fais_BIT_SendSCSICommand 869.3.10 fais_BIT_GetStatus 879.3.11 fais_BITL_Create . 889.3.12 fais_BITL_Destroy .
31、 899.3.13 fais_BITL_SendSCSICommand 899.3.14 fais_BITL_GetStatus 9010 Volume Management Services 9210.1 Overview 9210.2 Data Structures 9210.2.1 FAIS_BITLSetPathPolicy . 9210.2.2 FAIS_VDEV_ATTRIB_MASK 9310.2.3 FAIS_VDEV . 9410.2.4 FAIS_FLU 9410.2.5 FAIS_ConcatenatedVDEV . 9510.2.6 FAIS_VDEVType . 95
32、10.2.7 FAIS_MirroredVDEV_ReadPolicy . 9610.2.8 FAIS_MirroredVDEV_WritePolicy 9610.2.9 FAIS_XMapPermission 9710.2.10 FAIS_XMAP_HINT 9810.2.11 FAIS_StripedVDEV 9910.2.12 FAIS_MirroredVDEV 9910.2.13 FAIS_XMapVDEV 9910.2.14 FAIS_BITLSetVDEV 10010.2.15 FAIS_VDEVParam 10010.2.16 FAIS_Column 10110.2.17 FAI
33、S_Mirror . 10110.2.18 FAIS_BlockRange . 102iv-,-,-Copyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHS-,-,-Page10.2.19 FAIS_XMapEntry . 10210.2.20 FAIS_BITLSetEntry 10310.2.21 FAIS_Child
34、VDEVParam . 10410.3 Function Calls 10410.3.1 fais_VDEV_Create . 10410.3.2 fais_VDEV_Destroy . 10510.3.3 fais_VDEV_Update 10610.3.4 fais_VDEV_AddChildren 10710.3.5 fais_VDEV_RemoveChildren . 10810.3.6 fais_VDEV_Quiesce . 10910.3.7 fais_VDEV_Resume 10910.3.8 fais_VDEV_Copy . 11010.3.9 fais_VDEV_GetSta
35、tus 111AnnexesA Naming Conventions 113A.1 Overview 113B Implementation Recommendations 114Tables1 ISO and American Conventions. 72 Multiplicity Notation 113 General Services Constants 364 Valid Timeout Values . 385 APIVersion Values . 426 FAISEnumerationFilter_T values . 427 fais_Init Flag bits 448
36、fais_Deinit Flag Bits . 459 Port Services Constants. 4810 fais_Portal_Create flags. 5711 fais_FT_Create flags 6312 fais_BI_Create flags. 8013 FAIS_BITLSetPathPolicy_T Policy values . 9214 FAIS_VDEV_ATTRIB_MASK_T values. 9315 FAIS_MirroredVDEV_ReadPolicy_T values 9616 FAIS_MirroredVDEV_WritePolicy_T
37、values 9617 FAIS_XMAPHINT_T values . 98A.1 FAIS Naming Conventions. 113vCopyright American National Standards Institute Provided by IHS under license with ANSI Not for ResaleNo reproduction or networking permitted without license from IHSPageFigures1 Class Diagram Conventions 102 Notation for Associ
38、ation Relationships for Class Diagrams. 123 Notation for Aggregation Relationships for Class Diagrams 134 Notation for Generalization Relationships for Class Diagrams 145 Operational Layering . 176 Object Model 22vi-,-,-2007.)Copyright American National Standards Institute Provided by IHS under lice
39、nse with ANSI Not for ResaleNo reproduction or networking permitted without license from IHSForeword (This foreword is not part of American National Standard ANSI INCITS 432This standard defines an API by which a storage application may perform the func-tions of one or more SCSI Targets or Initiator
40、s, and control high-performance com-mand/data forwarding and manipulation facilities.This standard was developed by Task Group T11 of Accredited Standards Commit-tee INCITS during 2003-2006. The standards approval process started in 2006. Thisdocument includes annexes that are informative and are no
41、t considered part of thestandard.Requests for interpretation, suggestions for improvements or addenda, or defect re-ports are welcome. They should be sent to the INCITS Secretariat, Information Tech-nology Industry Council, 1250 Eye Street, NW, Suite 200, Washington, DC 20005-3922.This standard was
42、processed and approved for submittal to ANSI by the InternationalCommittee for Information Technology Standards (INCITS). Committee approval ofthe standard does not necessarily imply that all committee members voted for its ap-proval. At the time it approved this standard, INCITS had the following m
43、embers:Karen Higginbottom, ChairJennifer Garner, SecretaryOrganization Represented Name of RepresentativeAIM Global Dan MullenCharles Biss (Alt.)Apple Computer, Inc. David MichaelElectronic Industries Alliance Edward Mikoski, Jr.David Thompson (Alt.)EMC Corporation Gary RobinsonFarance, Inc Frank Fa
44、ranceTimothy Schoechle (Alt.)GS1 US Frank SharkeyJames Chronowski (Alt.)Mary Wilson (Alt.)Hewlett-Packard Company. Karen HigginbottomSteve Mills (Alt.)Scott Jameson (Alt.)IBM Corporation . Ronald F. SillettiPeter Schirling (Alt.)IEEE . Judith GormanTerry DeCourcelle (Alt.)Bill Ash (Alt.)Jodi Haasz (
45、Alt.)Bob Labelle (Alt.)Intel. Philip WennblomDave Thewlis (Alt.)Jesse Walker (Alt.)Grace Wei (Alt.)Lexmark International . Don WrightDwight Lewis (Alt.)Paul Menard (Alt.)Microsoft Corporation . Jim HughesDon Stanwyck (Alt.)Isabelle Valet-Harper (Alt.)National Institute of Standards 80112-5704, (800)
46、 854-7179.Additional availability contact information is provided below as needed.2.2 Approved referencesANSI INCITS 332-1999, Fibre Channel Arbitrated Loop (FC-AL-2)ANSI INCITS 373-2003, Fibre Channel Framing and Signaling Interface (FC-FS)ANSI INCITS 374-2003, Fibre Channel Single-Byte Command Set
47、 - 3 (FC-SB-3)ANSI INCITS 384-2004, Fibre Channel Switch Fabric Third Generation (FC-SW-3)ANSI INCITS 387-2004, Fibre Channel - Generic Services - 4 (FC-GS-4)ANSI INCITS 408-2005, SCSI Primary Commands - 3 (SPC-3)ANSI INCITS 414-2005, Fibre Channel Backbone - Generation 3 (FC-BB-3)ISO/IEC 9899:1999, Programming languages - CISO/IEC 10646-1:2000, Information technology - Universal M
