Hyper MPI 25.0.0及以上版本命令参数

-x UCG_PLANC_STARS_TLS=

• 取值类型：string
• 取值范围：
  • all
  • rc_acc
  • sdma_acc
• 默认值：all

可选参数，指定卸载算法所用的传输协议。

示例：

-x UCG_PLANC_STARS_TLS=all

-x UCG_PLANC_STARS_NET_DEVICES=

• 取值类型：string
• 取值范围：当前设备上所有网卡。
• 默认值：all

可选参数，指定卸载算法所用的网卡。

示例：

-x UCG_PLANC_STARS_NET_DEVICES=all

-x UCG_PLANC_STARS_SELF_DEVICES=

• 取值类型：string
• 取值范围：memory
• 默认值：memory

可选参数，指定卸载算法所用的环回设备。

示例：

-x UCG_PLANC_STARS_SELF_DEVICES=memory

-x UCG_PLANC_STARS_MAX_RAILS=

• 取值类型：int
• 取值范围：1~9
• 默认值：1

可选参数，指定卸载算法最多使用的链路数。

示例：

-x UCG_PLANC_STARS_MAX_RAILS=1

-x UCG_PLANC_STARS_BCAST_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1~4。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，Bcast的算法参数。

示例：

-x UCG_PLANC_STARS_BCAST_ATTR=I:1

-x UCG_PLANC_STARS_IBCAST_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1~4。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，IBcast的算法参数。

示例：

-x UCG_PLANC_STARS_IBCAST_ATTR=I:1

-x UCG_PLANC_STARS_SCATTERV_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，Scatterv的算法参数。

示例：

-x UCG_PLANC_STARS_SCATTERV_ATTR=I:1

-x UCG_PLANC_STARS_ISCTTERV_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，IScatterv的算法参数。

示例：

-x UCG_PLANC_STARS_ISCATTERV_ATTR=I:1

-x UCG_PLANC_STARS_ALLGATHERV_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，Allgatherv的算法参数。

示例：

-x UCG_PLANC_STARS_ALLGATHERV_ATTR=I:1

-x UCG_PLANC_STARS_IALLGATHERV_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，IAllgatherv的算法参数。

示例：

-x UCG_PLANC_STARS_IALLGATHERV_ATTR=I:1

-x UCG_PLANC_STARS_ALLTOALLV_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，Alltoallv的算法参数。

示例：

-x UCG_PLANC_STARS_ALLTOALLV_ATTR=I:1

-x UCG_PLANC_STARS_IALLTOALLV_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，IAlltoallv的算法参数。

示例：

-x UCG_PLANC_STARS_IALLTOALLV_ATTR=I:1

-x UCG_PLANC_STARS_BARRIER_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，Barrier的算法参数。

示例：

-x UCG_PLANC_STARS_BARRIER_ATTR=I:1

-x UCG_PLANC_STARS_IBARRIER_ATTR=

• 取值类型：string，格式为I:id[S:scoreR:start-end]。
• 取值范围：
  • id：必填，1。
  • score：选填，任意自然数。
  • start：选填，任意自然数。
  • end：选填，任意自然数。
• 默认值：无固定值，根据生效规则调节赋值。

可选参数，IBarrier的算法参数。

示例：

-x UCG_PLANC_STARS_IBARRIER_ATTR=I:1

-x UCG_PLANC_STARS_SCATTERV_KNTREE_DEGREE=

• 取值类型：int
• 取值范围：任意正整数
  说明：

  建议配置为2~运行作业节点数量间的正整数，例如2~8。

• 默认值：2

可选参数，指定Scatterv的算法参数。

示例：

-x UCG_PLANC_STARS_SCATTERV_KNTREE_DEGREE=2

-x UCG_PLANC_STARS_BARRIER_FANIN_DEGREE=

• 取值类型：int
• 取值范围：任意正整数
  说明：

  建议配置为2~运行作业节点数量间的正整数，例如2~8。

• 默认值：4

可选参数，指定Barrier_faninfanout的算法参数。

示例：

-x UCG_PLANC_STARS_BARRIER_FANIN_DEGREE=4

-x UCG_PLANC_STARS_BARRIER_FANOUT_DEGREE=

• 取值类型：int
• 取值范围：任意正整数
  说明：

  建议配置为2~运行作业节点数量间的正整数，例如2~8。

• 默认值：2

可选参数，指定Barrier_faninfanout的算法参数。

示例：

-x UCG_PLANC_STARS_BARRIER_FANOUT_DEGREE=2

-x UCG_PLANC_STARS_SCATTERV_RUN_HPL=

• 取值类型：string
• 取值范围：
  • y：使用HPL模式运行。
  • n：使用通用模式运行。
• 默认值：n

可选参数，指定Scatterv的运行模式。

示例：

-x UCG_PLANC_STARS_SCATTERV_RUN_HPL=y

-x UCG_PLANC_STARS_RC_SEG_SIZE=

• 取值类型：size_t
• 取值范围：0~2^64-1
• 默认值：8256

可选参数，设置弹性缓冲区大小。

示例：

-x UCG_PLANC_STARS_RC_SEG_SIZE=8256

-x UCG_PLANC_STARS_RC_TX_QUEUE_LEN=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：1024

可选参数，设置QP中发送队列的长度。

示例：

-x UCG_PLANC_STARS_RC_TX_QUEUE_LEN=1024

-x UCG_PLANC_STARS_RC_TX_MIN_INLINE=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：64

可选参数，设置在发送WQE时为内联数据保留的最小字节。

示例：

-x UCG_PLANC_STARS_RC_TX_MIN_INLINE=64

-x UCG_PLANC_STARS_RC_TX_INLINE_RESP=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：64

可选参数，设置在发送WQE时为内联响应保留的字节。对于足够小的响应，比如原子操作和small reads，都会被以内联方式接收。

示例：

-x UCG_PLANC_STARS_RC_TX_INLINE_RESP=64

-x UCG_PLANC_STARS_RC_HOP_LIMIT=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：255

可选参数，设置IB跳数限制/RoCEv2生存时间。应介于0和255之间。

示例：

-x UCG_PLANC_STARS_RC_HOP_LIMIT=255

-x UCG_PLANC_STARS_RC_PATH_MTU=

• 取值类型：unsigned
• 取值范围：
  • default
  • 512
  • 1024
  • 2048
  • 4096
• 默认值：default

可选参数，设置路径最大传输单元。default表示将为设备选择最佳MTU。

示例：

-x UCG_PLANC_STARS_RC_PATH_MTU=1024

-x UCG_PLANC_STARS_RC_TIMEOUT=

• 取值类型：string，格式为<number>[s|us|ms|ns]
• 取值范围：<number>为任意大于0的浮点数。
• 默认值：1ms

可选参数，设置传输超时时间。

示例：

-x UCG_PLANC_STARS_RC_TIMEOUT=1ms

-x UCG_PLANC_STARS_RC_RETRY_COUNT=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：7

可选参数，设置传输重试次数。

示例：

-x UCG_PLANC_STARS_RC_RETRY_COUNT=7

-x UCG_PLANC_STARS_RC_RNR_TIMEOUT=

• 取值类型：string，格式为<number>[s|us|ms|ns]
• 取值范围：<number>为任意大于0的浮点数。
• 默认值：1ms

可选参数，设置RNR超时时间。

示例：

-x UCG_PLANC_STARS_RC_RNR_TIMEOUT=1ms

-x UCG_PLANC_STARS_RC_RNR_RETRY_COUNT=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：7

可选参数，设置RNR重试次数。

示例：

-x UCG_PLANC_STARS_RC_RNR_RETRY_COUNT=7

-x UCG_PLANC_STARS_RC_TX_CQ_MODERATION=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：64

可选参数，在不请求完成的情况下，允许发送WQE的最大数量。

示例：

-x UCG_PLANC_STARS_RC_TX_CQ_MODERATION=64

-x UCG_PLANC_STARS_RC_TX_CQ_LEN=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：4096

可选参数，设置发送完成队列的长度。这限制了未完成的信号发送的总数。

示例：

-x UCG_PLANC_STARS_RC_TX_CQ_LEN=4096

-x UCG_PLANC_STARS_RC_TX_MAX_WR=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：-1（即2^32-1）

可选参数，限制未完成的已发布工作请求的数量。实际限制为该值和TX队列长度之间的最小值。-1表示无限制。

示例：

-x UCG_PLANC_STARS_RC_TX_MAX_WR=-1

-x UCG_PLANC_STARS_IB_RCACHE_MEM_PRIO=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：1000

可选参数，指定注册缓存内存事件优先级。

示例：

-x UCG_PLANC_STARS_IB_RCACHE_MEM_PRIO=1000

-x UCG_PLANC_STARS_IB_RCACHE_OVERHEAD=

• 取值类型：string，格式为<number>[s|us|ms|ns]
• 取值范围：<number>为任意大于0的浮点数。
• 默认值：180ns

可选参数，指定注册缓存查找开销。

示例：

-x UCG_PLANC_STARS_IB_RCACHE_OVERHEAD=180ns

-x UCG_PLANC_STARS_IB_RCACHE_ADDR_ALIGN=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：64

可选参数，指定注册地址对齐缓存。必须为2的幂次方，且介于64和系统页面大小之间。

示例：

-x UCG_PLANC_STARS_IB_RCACHE_ADDR_ALIGN=64

-x UCG_PLANC_STARS_IB_REG_METHODS=

• 取值类型：string
• 取值范围：
  • rcache：用户空间注册缓存。
  • odp：隐式按需分页。
  • direct：直接注册。

  可以输入多种取值，以英文逗号分割，例如rcache,odp。

• 默认值：rcache,odp,direct

可选参数，设置不同优先级的注册MR的方法。

示例：

-x UCG_PLANC_STARS_IB_REG_METHODS=rcache,odp,direct

-x UCG_PLANC_STARS_IB_MEM_REG_OVERHEAD=

• 取值类型：string，格式为<number>[s|us|ms|ns]
• 取值范围：<number>为任意大于0的浮点数。
• 默认值：16us

可选参数，设置内存注册开销。

示例：

-x UCG_PLANC_STARS_IB_MEM_REG_OVERHEAD=16us

-x UCG_PLANC_STARS_IB_MEM_REG_GROWTH=

• 取值类型：string，格式为<number>[s|us|ms|ns]
• 取值范围：<number>为任意大于0的浮点数。
• 默认值：0.06ns

可选参数，设置内存注册增长率。

示例：

-x UCG_PLANC_STARS_IB_MEM_REG_GROWTH=0.1ns

-x UCG_PLANC_STARS_IB_ETH_PAUSE_ON=

• 取值类型：string
• 取值范围：
  • y：在以太网上开启Pause帧。
  • n：在以太网上关闭Pause帧。
• 默认值：y

可选参数，是否在以太网上启用Pause帧。Pause帧是一种在以太网家族计算机网络拥塞时暂时停止数据传输的机制。如果将此参数设置为“n”，则将取消IB传输资格，因为在与RoCE一起使用时，在有损结构上可能表现不佳。

示例：

-x UCG_PLANC_STARS_IB_ETH_PAUSE_ON=y

-x UCG_PLANC_STARS_IB_ODP_NUMA_POLICY=

• 取值类型：string
• 取值范围：
  • default：不改变已有的策略。
  • prefered：设置为MPOL_PREFERRED模式。
  • bind：设置为MPOL_BIND模式。
• 默认值：default

可选参数，设置重写ODP区域的NUMA策略，以避免额外的页迁移。

• MPOL_PREFERRED模式设置优先分配的节点。内核将首先尝试从此节点分配页面，如果首选节点可用内存不足，则回落到其他节点。
• MPOL_BIND模式指定一个严格的策略，限制内存分配给nodemask指定的节点。 如果nodemask指定了多个节点，则页面分配将来自具有足够空闲内存的节点，并且优先是离分配节点最近的节点。

示例：

-x UCG_PLANC_STARS_IB_ODP_NUMA_POLICY=bind

-x UCG_PLANC_STARS_IB_ODP_MAX_SIZE=

• 取值类型：string
• 取值范围：
  • auto：自动检测是否按需分页。
  • <number>[b|kb|mb|gb]：设置按需分页的最大内存区域大小为某一具体值。<number>取值范围为0~2^64-1。
• 默认值：auto

可选参数，设置启用按需分页的最大内存区域大小。

示例：

-x UCG_PLANC_STARS_IB_ODP_MAX_SIZE=16kb

-x UCG_PLANC_STARS_RC_ROCE_LOCAL_SUBNET=

• 取值类型：string
• 取值范围：
  • y：接口子网内的地址可访问。
  • n：所有远程RoCEv2 IP地址可从任何端口访问。
• 默认值：n

可选参数，使用每个网络设备的本地IP地址和子网掩码，对RoCEv2报文进行路由，用于筛选端口的IB子网前缀，为空表示不进行筛选。

示例：

-x UCG_PLANC_STARS_RC_ROCE_LOCAL_SUBNET=y

-x UCG_PLANC_STARS_RC_ROCE_LOCAL_SUBNET_PREFIX_LEN=

• 取值类型：string
• 取值范围：
  • auto：自动从设备地址检测子网前缀长度。
  • inf：仅允许同一设备内的连接。
  • <num>：为子网前缀指定数字比特位长度值。取值范围为0~32。
• 默认值：auto

可选参数，使能UCX_IB_ROCE_LOCAL_SUBNET时，用于可达性检查的子网前缀长度，单位为比特。

示例：

-x UCG_PLANC_STARS_RC_ROCE_LOCAL_SUBNET_PREFIX_LEN=8

-x UCG_PLANC_STARS_SDMA_BW=

• 取值类型：string，格式为<number>[T|G|M|K]B|b[[p|/]s]
• 取值范围：<number>为任意大于0的浮点数。
• 默认值：16911MBs

可选参数，配置SDMA的带宽，用于数据发送时控制SDMA链路的分包大小，仅在Multi-Rail场景下生效，单链路下配置无意义。

示例：

-x UCG_PLANC_STARS_SDMA_BW=10000MBs

-x UCX_RC_VERBS_TX_MIN_SGE=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：5

可选参数，在RC协议下发送WQE中要保留的SG条目数。

示例：

-x UCX_RC_VERBS_TX_MIN_SGE=2

-x UCX_UD_VERBS_TX_MIN_SGE=

• 取值类型：unsigned
• 取值范围：0~2^32-1
• 默认值：5

可选参数，在UD协议下发送WQE中要保留的SG条目数。

示例：

-x UCX_UD_VERBS_TX_MIN_SGE=1

-x UCX_SDMA_SHARED_CHANNEL_MODE=

• 取值类型：bool
• 取值范围：
  • y：开启共享通道模式。
  • n：使用独立通道模式。
• 默认值：y

可选参数，开启该功能后，支持SDMA使用共享通道。

示例：

-x UCX_SDMA_SHARED_CHANNEL_MODE=y

-x UCG_PLANC_STARS_STREAM_DEPTH=

• 取值类型：int
• 取值范围：4096~65535
• 默认值：4096

可选参数，指定卸载队列深度。

示例：

-x UCG_PLANC_STARS_STREAM_DEPTH=4096

-x UCG_PLANC_UCX_ALLGATHERV_DEFAULT_POLICY=

• 取值类型：bool
• 取值范围：
  • y：使用默认算法。
  • n：使用优化算法。
• 默认值：y

可选参数，指定Allgatherv算子使用优化算法（部分环境下可能不适用）。

示例：

-x UCG_PLANC_UCX_ALLGATHERV_DEFAULT_POLICY=y

-x UCG_PLANC_UCX_ALLTOALLV_DEFAULT_POLICY=

• 取值类型：bool
• 取值范围：
  • y：使用默认算法。
  • n：使用优化算法。
• 默认值：y

可选参数，指定Alltoallv算子使用优化算法（部分环境下可能不适用）。

示例：

-x UCG_PLANC_UCX_ALLTOALLV_DEFAULT_POLICY=y