lapi_sub例程信息

在线编辑

用途

提供有关构成低级别应用程序编程接口 (LAPI) 的子例程的概述信息。

库

可用性库 (liblapi_r.a)

C 语法

#include <lapi.h>
 
int lapi_subroutines(parm1, parm2...)
type1 parm1;
type2 parm2;
⋮

FORTRAN 语法

include 'lapif.h'

LAPI_SUBROUTINES(parm1, parm2..., ierror)
TYPE1 :: parm1;
TYPE2 :: parm2;
⋮
INTEGER ierror

描述

LAPI 子例程提供了各种各样的函数，可以高效灵活地使用这些函数来获取任何并行编程 API 所需的大多数行为。

Programming with C++

LAPI 子例程为 C++ 编程提供 extern "C" 声明。

Profiling

LAPI 的概要分析接口包含每个 LAPI 函数的包装器，因此您可以收集有关每个 LAPI 调用的数据。 请参阅 RSCT for AIX 5L: LAPI Programming Guide 以获取更多信息。

Querying runtime values

可以通过调用具有相应查询类型的 LAPI_Qenv 子例程来找出某些参数的大小 (或大小范围)。 例如，使用 LOC_ADDRTBL_SZ 查询类型调用 LAPI_Qenv 以了解 LAPI_Addr_set 子例程所使用的地址表的大小:

LAPI_Qenv(hndl, LOC_ADDRTBL_SZ, ret_val)
现在，如果要使用 LAPI_Addr_set注册函数地址:
LAPI_Addr_set (hndl, addr, addr_hndl)
索引 addr_hndl 的值必须在以下范围内:
1 <= 地址 (addr_hndl) < LOC_ADDRTBL_SZ

当用于显示参数的大小，值的比较或值的范围时， LAPI_Qenv 子例程的 query 参数的有效值出现在 SMALL ， BOLD 大写字母中。 例如：

 
NUM_TASKS
 
是以下内容的速记表示法:
 
LAPI_Qenv(hndl, NUM_TASKS, ret_val)
 
请参阅 LAPI_Qenv 子例程以获取 query 参数的有效值列表。

参数

参数定义列示如下:
INPUT
parm1
描述 parm1。
输入/输出
此部分包含所有 LAPI 计数器。
parm2
描述 parm2。
输出
函数调用是非分块的，因此相对于函数调用，计数器行为是异步的。
ierror
指定 FORTRAN 返回码。 这始终是最后一个参数。

返回值

成功 (LAPI_SUCCESS)
指示函数调用已成功完成。

子例程的任何其他返回值都出现在此处。

有关完整列表，请参阅 RSCT for AIX 5L: LAPI Programming Guide。

有关 LAPI 错误消息的信息，请参阅 RSCT: Messages。

限制

子例程的任何特定限制都出现在此处。

另请参阅 RSCT for AIX 5L: LAPI Programming Guide 以获取更多信息。

C 示例

Any C examples of the subroutine appear here.

FORTRAN 示例

Any FORTRAN examples of the subroutine appear here.