标准规范下载简介

GB／T 37982-2019 信息技术 多路径管理(API)

7.37 MP RegisterPlugin

/T37982—2019/IS0/IEC11002:2008

B22019/ISO/IEC1100

强制性支持。 备注 与其他API不同，本API完全在公共库中实现。本API应在公共库调用插件前被调用。 本API不会影响动态添加或更改绑定到正在运行的库实例的插件。相反，它使得当前未使用插件 的应用程序在未来调用公共库时可以访问指定的插件。这通常是动态加载模块预期的行为。 本API主要被插件的安装软件调用GTCC-115-2019 铁路数字移动通信系统（GSM-R）手持终端-铁路专用产品质量监督抽查检验实施细则，用于告知公共库该插件库的路径。 重复注册一个插件并非错误。不过，一个插件只有一个注册表。对插件予以注销的第一次调用就 主销它，无论有过多少次调用注册该插件。 供应商可以通过使用多个单独的插件ID和文件名来注册多个插件。 参见 MPDeregisterPlugin

7.39MP SetOverrideP

7.40MP SetPathWeigh

/T37982—2019/IS0/IEC11002:2008

B22019/ISO/IEC1100

7.41MP SetPluginLoadBalanceType

T37982—2019/ISO/IEC11002:2008

7.42MP SetFailbackPollingRate

/T37982—2019/IS0/IEC11002:2008

B22019/ISO/IEC1100

7.43MP SetProbingPollingRate

ID引用多路径逻辑单元，则将设置ProbingPollingRate属性。 支持 选择性支持。 参见 MPAUTOPROBING SUPPORT

7.44MP SetProprietaryProperties

7.45 MP SetTPGAcces

/T37982—2019/IS0/IEC11002:2008

B22019/ISO/IEC1100

T37982—2019/IS0/IEC110022008

本标准中描述的AP1的实现应满足以下要求： a）为本标准中列出的每个API提供人口点； b 实现所有作为强制性支持列出的API； 对于一个API，当其所有的参数都有效时，尝试展现或导出该API指定的所有操作的性能 d）如果实现方法确定不能满足针 要求，则不能使用该API

本标准中描述的AP1的实现应满足以下要求： a）为本标准中列出的每个API提供人口点； D 实现所有作为强制性支持列出的API； 对于一个API，当其所有的参数都有效时，尝试展现或导出该API指定的所有操作的性能 d）如果实现方法确定不能满足针 要求，则不能使用该API

用户很可能希望使用早期版本的API编写的代码能够在库或插件的新的实现上继续使用。本标 催的修订宜尽可能确保向后兼容性。 如果此后发现此标准不清楚或者现有的一些实现不一致，则不能保持兼容性。或者，也可能发现某 个接口缺乏必需的细节。此标准的开发人员可能需要弃用接口，以确保互操作性。针对以上情况，本标 准中对兼容性问题进行了说明。用户可以通过查看插件属性中的版本号确定该插件实现的是哪个标准 的版本

9.2客户端使用注意事项

9.3接口库实现注意事项

9.3.1多线程方法支持

此API（即，库）的任何实现，比如接口库，应是多线程安全的。也就是说，接口库应允许一个客户 寸安全地拥有多个线程去调用接口库中的API。接口库负责同步不同线程对任何接口库资源 用。

37982—2019/ISO/IEC1

/T37982—2019/IS0/IEC11002:2008

为了确保多路径管理API不同实现之间的兼容性，每一个实现版本都要提供头文件和（或）文档编 译器选项，以便打包每个结构，以免结构成员之间出现填充字节

为了保持多路径管理AP 容性，每一个实现版本都要提供头文件和（或）文 当编译器选项 折有AP

9.4插件实现注意事项

API中大多数结构包含预留字段。插件应将准备预留的任何字段归

9.4.2多线程方法支持

插件还应是多线程安全的。一个客户端应支持在任何时刻有多个活跃的线程。插件负责同步不同 线程对任何插件资源的使用。

码方式审行传进 不允许销售商实现容许一 显的延迟

T37982—2019/IS0/IEC11002:2008

A.2发起者端口osDeviceName

下表中的黑体学，当其出现在示例中时，应处于完全相同的位置。斜体学是其他文本的占位符 由指定的操作系统发起者端口osDeviceName确定 表A.1描述MPINITIATORPROPERTIES结构的osDeviceName字段的建议值

表A.1osDeviceName字段的名称

A.3逻辑单元osDeviceName

表A.2osDeviceName名称

B22019/ISO/IEC1100

/T37982—2019/ISO/IEC11002:2008

图B.1合成目标端口组

表B1新老访问状态汇总

T37982—2019/ISO/IEC11002:2008

/T37982—2019/IS0/IEC11002:2008

B22019/ISO/IEC1100

SAS和iSCSI允许多个物理端口聚合到一个虚拟SCSI端口。这种方式提供的能力低于本API中 的能力。每一种方式各有其优势。 。传输层多路径方法的管理能力较为简单，因为一个目标的所有逻辑单元号共享相同的路径配 置。在传输层切换路径往往比在本API中描述的较高层SCSI层切换更有效。 ·SCSI层多路径方法（接本API描述的)适用于所有SCSI传输并且充许故障接管以及跨传输的 负载均衡（例如，具有FC和iSCSI端口的阵列可能支持从FC到iSCSI的故障接管）。SCSI层 多路径方法允许按每个逻辑单元号单独配置。 本标准并未涉及传输层多路径方法。传输特定的管理接口可能有用。同一系统中可能存在两种多 路径层都可用的情况。本标准中所使用的术语“端口”适用于传输层多路径方法配置中的聚合虚拟 端口。

T37982—2019/IS0/IEC110022008

本附录包含如何使用多路径管理API的示例。所有这些示例都是非规范性的；如果这些示例和本 示准前面的任一章条内容有差异，则这些示例被视为是不正确的，前面章条是正确的， 关于这些示例，请注意：这些示例都执行错误检测，不过不报告错误。报告错误留给读者练习。 这里有三个编码示例，它们分别是： a）获取接口库属性的示例； b）获取插件属性的示例； c）发现与多路径逻辑单元相关的路径逻辑单元的示例

D.2获取接口库属性示例

D.3获取插件属性示例

T／CCIAT 0008-2019 装配式混凝土建筑工程施工质量验收规程/ //本示例获取由接口库返回的第一个插件的属性。 //

D.4发现多路逻辑单元相关的路径逻辑单元的示

/T37982—2019/IS0/IEC11002:2008

B22019/ISO/IEC1100

T37982—2019/ISO/IEC11002:2008

/T37982—2019/IS0/IEC11002:2008

DA／T 72-2019 岩心档案管理规范B22019/ISO/IEC1100

本附录描述接口库与插件之间必需的独立于操作系统的实现的接口。 公共接口库应确保每个插件被赋予一个独特的插件ID。这是5.6.3中描述的对象ID的第二个 所有者ID）。 在大多数情况下，公共接口库将使用由调用程序提供的对象的所有者ID来确定哪些插件拥有这 象，然后动态地调用插件中相应功能。 公共接口库宜提供以下没有调用插件的API：

T37982—2019/ISO/IEC11002:2008