dwh110 commented on code in PR #3428: URL: https://github.com/apache/brpc/pull/3428#discussion_r3781084110
########## docs/cn/urma.md: ########## @@ -0,0 +1,149 @@ +# UrmaTransport：基于 URMA 的远程内存 RPC + +UrmaTransport 是使用 openEuler +[URMA](https://atomgit.com/openeuler/umdk)（Unified Remote Memory Access）SDK +实现的传输层。它是 +[#3217](https://github.com/apache/brpc/discussions/3217) 中提出的路线 B， +与基于 OBMM 的 UBRing 传输（路线 A， +[#3226](https://github.com/apache/brpc/issues/3226)）互补，承担大包/跨节点 +高吞吐场景，共同构成路线 C（双后端）。 + +## 技术背景 + +URMA 在 UMDK 支持的设备上提供 verbs 风格接口。当前实现创建可靠消息 +（`URMA_TM_RM`）Jetty，并使用 CTP 传输路径；通过 +`urma_post_jetty_send_wr` 提交发送 WR，通过 `urma_post_jfr_wr` 提交接收 +WR。完成事件既可由 JFC 忙轮询获取，也可通过 JFCE 事件 fd 获取。 + +## 编译配置 + +### CMake 编译 + +```bash +# 带 URMA 支持编译 brpc +cmake -B build -DWITH_URMA=ON +make -C build -j$(nproc) + +# 编译 urma_performance 示例 +cd example/urma_performance +cmake -B build +make -C build -j$(nproc) +``` + +`WITH_URMA=ON` 使用上游 UMDK 头文件进行编译。CMake 优先使用系统安装的 +SDK；找不到头文件时，会参照 Mooncake 的 mock 构建方式下载固定版本的 +UMDK，可通过 `DOWNLOAD_URMA_HEADERS=OFF` 禁止下载。找到 `liburma` 时使用 Review Comment: DOWNLOAD_URMA_HEADERS lacks Bazel build support -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
