콘텐츠로 이동

타입

공개 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
typedef struct LcclCommSt* LcclComm;

구조체

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
const char * LcclDataTypeToString(LcclDataType type);
파라미터 방향 설명
type 입력 변환할 데이터 타입

반환 — 정적 문자열 포인터.


LcclRedOpToString

LcclRedOp 값을 사람이 읽을 수 있는 문자열로 바꿉니다.

1
const char * LcclRedOpToString(LcclRedOp red_op);
파라미터 방향 설명
red_op 입력 변환할 리덕션 연산

반환 — 정적 문자열 포인터.


LcclGetErrorToString

LcclResult 코드를 로그용 문자열로 바꿉니다. 이 문자열은 로그와 Python 예외 메시지에 그대로 나타납니다.

1
const char * LcclGetErrorToString(LcclResult error);
파라미터 방향 설명
error 입력 LcclResult 코드

반환 — 정적 문자열 포인터(const char *).


LcclTypeSize

LcclDataType 원소 하나의 크기(바이트)를 돌려줍니다.

1
int LcclTypeSize(LcclDataType type);
파라미터 방향 설명
type 입력 조회할 데이터 타입

반환 — 크기(바이트). 알 수 없는 타입이면 -1.