18. API Usage Notes#

  • Memory passed to cuMemObjGetDescriptor() must remain valid until cuMemObjPutDescriptor() is called.

  • Descriptor strings returned by cuMemObjGetRDMAToken() must be released with cuMemObjPutRDMAToken().

  • For cuObjGet() and cuObjPut(), the GET or PUT callback receives the RDMA descriptor through the rdma_info parameter. cuMemObjGetRDMAToken() is used when an application needs to acquire a descriptor string explicitly.

  • The os stream passed to setupTelemetry() must remain valid until all cuObjClient objects are destroyed. Call shutdownTelemetry() before closing that stream.

  • Callback implementations must synchronize access to shared resources that can be used concurrently across multiple callers.