콘텐츠로 이동

그룹 API

여러 연산을 모아 두었다가 가장 바깥 LcclGroupEnd()에서 실행합니다. NCCL의 그룹 호출과 같은 의미이며, 자세한 설명은 그룹에 있습니다.


LcclGroupStart

그룹 구간을 엽니다. 구간 안에서 호출한 집합 연산은 모였다가 가장 바깥 LcclGroupEnd()에서 실행됩니다.

1
LcclResult LcclGroupStart();

반환 — 성공하면 kLcclSuccess, 아니면 오류 코드.

Warning

그룹은 "이 연산들은 서로 독립이다"라는 뜻이지 "이 순서로 실행하라"는 뜻이 아닙니다. 집합 연산은 전송 크기순으로 정렬되어 점대점보다 먼저 스케줄되므로 대개 호출한 순서대로 실행되지 않습니다. 그래서 그룹 안 연산끼리 버퍼가 겹치면 안 됩니다. 겹치면 정의되지 않은 결과가 나오고 라이브러리가 감지하지 못합니다. 연산 B가 A의 결과를 필요로 하면 둘을 서로 다른 그룹에 두십시오. 연속된 그룹끼리는 순서가 보장됩니다.

묶음에서 정해지는 실행 순서는 호출 순서 전체에 따라 결정됩니다. 그래서 모든 랭크가 같은 연산을 같은 크기로 같은 순서로 호출해야 하며, 랭크마다 다르면 서로 다른 순서가 만들어져 어긋납니다. 점대점은 더 엄격해서, 피어와 방향별로 LcclSend/LcclRecv가 호출 순서를 유지합니다. 상대 랭크의 같은 방향 호출과 호출 순서대로 짝지어지기 때문입니다.

그룹은 중첩할 수 있고 가장 바깥 LcclGroupEnd()만 실행합니다. 그래서 LcclAllToAll을 호출자의 그룹 안에서 호출하면 그 그룹에 합류하며 따로 실행되지 않습니다.


LcclGroupEnd

그룹 구간을 닫고, 모아 둔 연산을 실행합니다.

1
LcclResult LcclGroupEnd();

반환 — 성공하면 kLcclSuccess, 아니면 오류 코드. 중단되었거나 워치독이 끊은 커널은 여기서 보고됩니다.

가장 바깥 중첩 수준에서만 동작합니다. 이때 실행하고 끝날 때까지 기다리므로 반환될 때 묶음이 완료되어 있습니다. 이는 블로킹 커뮤니케이터의 동작입니다. 논블로킹 커뮤니케이터에서는 연결을 기다리는 커뮤니케이터나 비동기 작업이 남아 있으면 기다리지 않고 kLcclInProgress로 먼저 돌아올 수 있고, 완료는 LcclCommGetAsyncError()로 확인합니다. 연산 종류, 데이터 타입, 리덕션이 서로 다른 연산이나 점대점이 섞인 묶음은 종류별로 차례로 실행됩니다.