Setup, Exit, and Query

def

ACLSHMEM_DEVICE_PREFIX

device 接口前缀

ACLSHMEM_HOST_PREFIX

host 接口前缀

enum aclshmem_error_code_t

错误码

Values:

enumerator ACLSHMEM_SUCCESS

任务执行成功

enumerator ACLSHMEM_INVALID_PARAM

参数无效

enumerator ACLSHMEM_INVALID_VALUE

参数值非法

enumerator ACLSHMEM_SMEM_ERROR

共享内存报错

enumerator ACLSHMEM_INNER_ERROR

内部报错

enumerator ACLSHMEM_NOT_INITED

尚未初始化

ACLSHMEMX_INIT_ATTR

ACLSHMEM_HOST_PREFIX int aclshmemx_init_attr(uint32_t flags, aclshmem_init_attr_t *attr)

初始化aclshmem

参数:
  • flags – [in] aclshmem控制面通信使用的方式

  • attr – [in] aclshmem相应的初始化信息

返回:

错误码

ACLSHMEM_MY_PE

ACLSHMEM_DEVICE_PREFIX int aclshmem_my_pe()
ACLSHMEM_HOST_PREFIX int aclshmem_my_pe()

获取当前PE的PE id。

返回:

当前PE的PE id。

ACLSHMEM_N_PES

ACLSHMEM_DEVICE_PREFIX int aclshmem_n_pes()
ACLSHMEM_HOST_PREFIX int aclshmem_n_pes()

获取程序中运行的PE数量。

返回:

程序中运行的PE数量。

ACLSHMEM_FINALIZE

ACLSHMEM_HOST_PREFIX void aclshmem_finalize()

释放所有aclshmem使用的资源

ACLSHMEM_PTR

ACLSHMEM_DEVICE_PREFIX __gm__ void *aclshmem_ptr(__gm__ const void *dest, int pe)
ACLSHMEM_HOST_PREFIX void *aclshmem_ptr(void *ptr, int pe)

在指定PE上,将本地对称地址转换为远程对称地址。

参数:
  • dest – [in] 本地PE上的对称地址。

  • pe – [in] 目标PE的PE id。

返回:

转换后的远程对称地址。

ACLSHMEM_INFO_GET_VERSION

ACLSHMEM_DEVICE_PREFIX void aclshmem_info_get_version(int *major, int *minor)

获取当前的版本号

参数:
  • major – [out] 主版本号。

  • minor – [out] 次版本号。