타입¶
공개 API의 열거형, 타입 별칭, 구조체, 매크로, 보조 함수입니다. 라이브러리 내부 구현에만 쓰이는 선언은 싣지 않았습니다.
열거형¶
LcclDataType¶
집합 연산 버퍼의 원소 데이터 타입입니다.
| 값 | 설명 |
|---|---|
kLcclInt8 |
8비트 부호 있는 정수 |
kLcclChar |
kLcclInt8의 별칭 |
kLcclUint8 |
8비트 부호 없는 정수 |
kLcclInt32 |
32비트 부호 있는 정수 |
kLcclInt |
kLcclInt32의 별칭 |
kLcclUint32 |
32비트 부호 없는 정수 |
kLcclInt64 |
64비트 부호 있는 정수 |
kLcclUint64 |
64비트 부호 없는 정수 |
kLcclFloat16 |
16비트 IEEE 754 반정밀도 부동소수점 |
kLcclHalf |
kLcclFloat16의 별칭 |
kLcclFloat32 |
32비트 IEEE 754 단정밀도 부동소수점 |
kLcclFloat |
kLcclFloat32의 별칭 |
kLcclFloat64 |
64비트 IEEE 754 배정밀도 부동소수점 |
kLcclDouble |
kLcclFloat64의 별칭 |
kLcclBfloat16 |
16비트 brain float (bfloat16) |
열거형이 받아들이는 타입과 연산에 커널이 있는 타입은 다릅니다. 지원 매트릭스를 보십시오.
LcclRedOp¶
집합 연산에서 쓸 리덕션 연산입니다.
| 값 | 설명 |
|---|---|
kLcclSum |
원소별 합 |
kLcclProd |
원소별 곱 |
kLcclMax |
원소별 최댓값 |
kLcclMin |
원소별 최솟값 |
kLcclAvg |
원소별 평균 |
kLcclMax와 kLcclMin에는 어떤 연산에도 커널이 없습니다. 지원 매트릭스를 보십시오.
LcclResult¶
모든 LCCL 함수의 반환 코드입니다. 성공은 kLcclSuccess(0)이고, kLcclInProgress는 오류가 아니라 논블로킹 작업이 아직 끝나지 않았다는 뜻입니다. 그 밖의 값은 모두 실패입니다.
코드는 서브시스템별 범위로 나뉘어 있어서, 낯선 값 하나로 어느 계층에서 실패했는지 알 수 있습니다. 값은 (서브시스템 << 16) | 번호 구조입니다.
| 기준값 | 서브시스템 |
|---|---|
0x00000 |
일반 |
0x10000 |
커뮤니케이터 |
0x20000 |
소켓 |
0x30000 |
부트스트랩 |
0x40000 |
메모리 / 할당 |
0x50000 |
토폴로지 / 그래프 / XML |
0x60000 |
Net 플러그인 |
0x70000 |
Transport |
0x80000 |
Proxy (통신 경로 내부) |
0x90000 |
그룹 |
0xA0000 |
Enqueue (연산 준비) |
0xB0000 |
커널 / 디바이스 |
코드 전체와 각 코드의 값, 메시지, 원인과 해결은 에러 코드에 있습니다. 코드의 값은 릴리즈가 바뀌어도 달라지지 않습니다.
타입 별칭¶
LcclComm¶
커뮤니케이터의 불투명 핸들입니다.
1 | |
구조체¶
LcclConfig¶
커뮤니케이터를 만들 때 지정하는 설정입니다. 반드시 LCCL_CONFIG_INITIALIZER로 초기화한 뒤 바꿀 필드만 설정하십시오. 센티넬 값으로 남은 필드는 라이브러리 기본값을 따릅니다.
| 필드 | 타입 | 기본값 | 설명 |
|---|---|---|---|
size |
size_t |
— | 초기화 매크로가 채웁니다. 직접 설정하지 않습니다 |
magic |
unsigned int |
— | 초기화 매크로가 채웁니다. 직접 설정하지 않습니다 |
blocking |
int |
1 |
0이면 논블로킹. 커뮤니케이터 생성, LcclCommFinalize(), 연결이 필요한 그룹의 제출이 kLcclInProgress로 먼저 돌아올 수 있음 |
min_num_chnl |
int |
1 |
채널 수의 하한 |
max_num_chnl |
int |
8 |
채널 수의 상한 |
net_name |
const char * |
자동 선택 | 쓸 네트워크 백엔드 이름("IB", "Socket"). NULL이면 자동 선택 |
값 검사와 환경 변수와의 관계는 커뮤니케이터를 보십시오.
LcclUniqueId¶
커뮤니케이터를 만들기 전에 모든 랭크가 공유하는 고유 ID입니다.
| 필드 | 타입 | 설명 |
|---|---|---|
internal |
char[128] |
128바이트(LCCL_UNIQUE_ID_BYTES)의 불투명한 값. 해석하지 말고 그대로 전달하십시오 |
매크로¶
LCCL_CONFIG_INITIALIZER¶
LcclConfig의 정적 초기화 값입니다. 개별 필드를 바꾸기 전에 LcclConfig 변수에 대입하십시오. 이 매크로로 초기화하지 않은 설정은 kLcclInvalidArgument로 거부됩니다.
LCCL_CONFIG_UNDEF_INT, LCCL_CONFIG_UNDEF_PTR¶
LcclConfig에서 지정하지 않은 정수(INT_MIN)와 포인터(nullptr) 필드를 나타내는 센티넬입니다. 센티넬로 남은 필드는 라이브러리 기본값을 따릅니다.
LCCL_UNIQUE_ID_BYTES¶
LcclUniqueId 값의 크기(128바이트)입니다.
보조 함수¶
LcclDataTypeToString¶
LcclDataType 값을 사람이 읽을 수 있는 문자열로 바꿉니다.
1 | |
| 파라미터 | 방향 | 설명 |
|---|---|---|
type |
입력 | 변환할 데이터 타입 |
반환 — 정적 문자열 포인터.
LcclRedOpToString¶
LcclRedOp 값을 사람이 읽을 수 있는 문자열로 바꿉니다.
1 | |
| 파라미터 | 방향 | 설명 |
|---|---|---|
red_op |
입력 | 변환할 리덕션 연산 |
반환 — 정적 문자열 포인터.
LcclGetErrorToString¶
LcclResult 코드를 로그용 문자열로 바꿉니다. 이 문자열은 로그와 Python 예외 메시지에 그대로 나타납니다.
1 | |
| 파라미터 | 방향 | 설명 |
|---|---|---|
error |
입력 | LcclResult 코드 |
반환 — 정적 문자열 포인터(const char *).
LcclTypeSize¶
LcclDataType 원소 하나의 크기(바이트)를 돌려줍니다.
1 | |
| 파라미터 | 방향 | 설명 |
|---|---|---|
type |
입력 | 조회할 데이터 타입 |
반환 — 크기(바이트). 알 수 없는 타입이면 -1.