cuda.bindings._v2.driver.multicast_add_device#

cuda.bindings._v2.driver.multicast_add_device(uint64_t mc_handle, int dev)#

Associate a device to a multicast object.

Associates a device to a multicast object. The added device will be a part of the multicast team of size specified by CUmulticastObjectProp.numDevices during cuMulticastCreate. The association of the device to the multicast object is permanent during the life time of the multicast object. All devices must be added to the multicast team before any memory can be bound to any device in the team. Any calls to cuMulticastBindMem, cuMulticastBindMem_v2, cuMulticastBindAddr, or cuMulticastBindAddr_v2 will block until all devices have been added. Similarly all devices must be added to the multicast team before a virtual address range can be mapped to the multicast object. A call to cuMemMap will block until all devices have been added. This call may fail with CUDA_ERROR_INVALID_DEVICE if the device specified by dev does not belong to the same clique as the other devices previously added to this multicast object.

Parameters:

mc_handle (uint64_t) – Handle representing a multicast object.
dev (int) – Device that will be associated to the multicast object.