Understand A Statement Made in Appendix C.3 in CUDA Programming Guide

The statement is that " To guarantee co-residency of the thread blocks on the GPU, the number of blocks launched needs to be carefully considered. For example, a block per SM can be launched as follows:"

cudaDeviceProp deviceProp;
cudaGetDeviceProperties(&deviceProp, dev);
// initialize, then launch
cudaLaunchCooperativeKernel((void*)my_kernel, deviceProp.multiProcessorCount, numThreads, args);

I understand that this piece of code schedules deviceProp.multiProcessCount thread blocks on a device and the size of each thread block is numThreads. I could not understand why the above code snippet will guarantee that there will be one thread block scheduled on each SM and exclude the case that multiple thread blocks are scheduled to some SMs and the rest SMs are idle.

there is now an answer posted on your cross-posting on SO:

https://stackoverflow.com/questions/51032571/helps-on-cuda-programming-guide