cuda.bindings._v2.driver.logical_endpoint_query#

cuda.bindings._v2.driver.logical_endpoint_query(uint32_t le_id, uint32_t count) → int#

Determines if all logical endpoints in the range have been successfully constructed.

Queries the driver to determine if all logical endpoints in the given range starting at le_id and extending for count have been successfully constructed. Provides a mechanism to ensure that it is safe to begin using a logical endpoint ID. Using a logical endpoint ID before verifying that it is fully constructed can result in undefined behavior. This is not a blocking API, it returns immediately with a query_status of 0 if any logical endpoint ID in the given range is not fully constructed, and a non-zero value otherwise. Construction of a multicast logical endpoint may fail here if the devices added via cuLogicalEndpointAddDevice do not belong to the same clique. This API may return CUDA_ERROR_ILLEGAL_STATE if no devices are found on which this logical endpoint can be accessed.

Parameters:

le_id (uint32_t) – First logical endpoint ID to be queried.
count (uint32_t) – Number of logical endpoints IDs to be queried.

Returns:

Status of the logical endpoints. Returns 0 if any logical: endpoint in the given range is not fully constructed, and non- zero if all logical endpoints in the given range are fully constructed.

Return type:

int