Códigos de retorno versus erros assíncronos
Por que os núcleos falham silenciosamente por padrão.
Códigos de retorno versus erros assíncronos é uma aula grátis de CUDA Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de CUDA Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de CUDA Academy inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Two Ways CUDA Fails
CUDA reports trouble in two flavors: an immediate return code from API calls, and delayed async errors from kernels. Knowing both is key. 🧭
API Calls Return a Code
Most CUDA runtime calls hand back a cudaError_t. A value of cudaSuccess means all good; anything else signals a problem you can act on.
cudaError_t err = cudaMalloc(&d, n);Check It Right Away
For synchronous calls like cudaMalloc, the returned code is final. Compare it to cudaSuccess immediately and react before moving on.
if (err != cudaSuccess) return 1;Kernels Return Nothing
A kernel launch with triple brackets has no return value you can test. So launch failures cannot be reported the same easy way.
myKernel<<<g, b>>>(d); // no code to checkWhy Kernels Are Async
Launches are asynchronous: the CPU queues the work and races ahead. The GPU may not have even started when your next line runs.
Errors Arrive Late
Because work runs later, a kernel crash becomes an async error. It surfaces on a future call, not at the launch line itself.
Silent by Default
If you never check, a broken kernel fails silently. Your program seems to run while producing garbage or zeros in the output.
Two Kinds of Launch Errors
Launches can fail in two stages: a bad configuration caught at launch, and a runtime fault like out-of-bounds caught while executing.
Sticky Errors
A serious fault leaves the context in a sticky error state. Every later CUDA call then returns the same error until you restart.
Sync to Force Async Errors
To pull a hidden fault into the open, call cudaDeviceSynchronize. It waits for the kernel and returns any runtime error it hit.
cudaError_t e = cudaDeviceSynchronize();A Reliable Habit
The rule of thumb: check the return code of every API call, and sync to catch kernels. Together they leave no failure unseen.
Quick Check
Test your grasp of how kernels report failure.
Recap: Two Error Paths
API calls give an instant return code, while kernels fail asynchronously. Check codes and synchronize so nothing slips by unnoticed. 🎉
Perguntas Frequentes
A aula “Códigos de retorno versus erros assíncronos” é grátis?
Sim — o texto completo de “Códigos de retorno versus erros assíncronos” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de CUDA Academy, atualize para CoddyKit PRO. O curso de CUDA Academy inclui 4 aulas no total.
O que vou aprender em “Códigos de retorno versus erros assíncronos”?
Por que os núcleos falham silenciosamente por padrão. Você pratica CUDA Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar CUDA Academy?
Nenhuma experiência prévia é necessária. CUDA Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Códigos de retorno versus erros assíncronos”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de CUDA Academy?
Sim. Cada aula de CUDA Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Códigos de retorno versus erros assíncronos
- cudaGetLastError após a execução
- Uma macro CUDA_CHECK reutilizável
- Decodifique cudaGetErrorString