Decodificare cudaGetErrorString

Un cudaError_t grezzo è soltanto un numero. Per comprenderlo, lo traduca in inglese semplice con cudaGetErrorString. 📖

cudaGetErrorString riceve un codice di errore e restituisce una stringa C leggibile che descrive esattamente che cosa è andato storto.

Passi quella stringa direttamente a printf, così i log descrivono ciò che è accaduto invece di mostrare un intero criptico.

Un messaggio che incontrerà spesso è out of memory, che indica che una cudaMalloc ha richiesto più memoria di quella disponibile sul device.

La stringa invalid configuration argument indica che l’avvio ha richiesto troppi thread oppure una dimensione illegale per il blocco o la griglia.

Un messaggio illegal address indica un accesso oltre i limiti all’interno di un kernel, spesso dovuto alla mancanza di un controllo sui limiti dell’indice.

È particolarmente utile nella macro CUDA_CHECK: acquisisca il codice e poi ne stampi la stringa, così gli errori si spiegano immediatamente.

Esiste anche cudaGetErrorName, che restituisce il nome dell’enumerazione, come cudaErrorMemoryAllocation, invece della descrizione estesa.

Usi il nome per i log compatti e la descrizione per maggiore chiarezza. Molti team stampano entrambi per ottenere il meglio dei due approcci.

Non riesci a risolvere un errore? Incolla la stringa di errore in un motore di ricerca. La formulazione è standard, quindi altri utenti hanno già incontrato questo problema.

La decodifica trasforma un numero inutile in un indizio chiaro. Il messaggio corretto spesso indica direttamente la riga da correggere.

cudaGetErrorString trasforma i codici in messaggi leggibili, mentre cudaGetErrorName restituisce il nome dell'enum. Li stampi per eseguire il debug con sicurezza. 🎉