2.3.8 出错代码
虽然前文的讨论中略有提到,但是大部分的核心API所返回的整数值主要包括以下几个:
- GASNET_OK
必须为0,该值表示成功执行。 - GASNET_ERR_RESOURCE
最常见的错误,表示某些有限资源不可用引起的调用失败。 - GASNET_ERR_BAD_ARG
与errno == EINVAL相似,表示客户端传递了无效的参数值。 - GASNET_ERR_NOT_INIT
表示客户端尚未调用gasnet_init函数。 - GASNET_ERR_BARRIER_MISMATCH
表示GASNet屏障的id匹配逻辑检测到了不匹配内容(详情查阅匹配规则规范),或调用者已经调用了GASNET_BARRIERFLAG_MISMATCH函数。 - GASNET_ERR_NOT_READY
(暂时)表示分阶段操作不完整。核心API中,这通常会在所有节点调用gasnet_barrier_notify函数前调用gasnet_barrier_try时发生。
此外,可以通过以下2个函数将上述数字错误代码转换为字符串(前缀为GASNET_ERR_)名称或对应错误值的英文描述。