فك ترميز cudaGetErrorString

إن cudaError_t الخام ليس سوى رقم. ولفهمه، تحوّله إلى نص واضح باستخدام cudaGetErrorString. 📖

تأخذ cudaGetErrorString رمز خطأ وتعيد سلسلة C مقروءة للبشر، تصف بالضبط ما الذي حدث من خطأ.

مرّر تلك السلسلة مباشرةً إلى printf حتى تسجل سجلاتك ما حدث بدلًا من عرض عدد صحيح غامض.

من الرسائل التي ستصادفها كثيرًا out of memory، وهي تعني أن cudaMalloc طلبت ذاكرة أكبر مما يستطيع الجهاز توفيره.

تعني السلسلة invalid configuration argument أن الإطلاق طلب عددًا كبيرًا جدًا من الخيوط أو حجم كتلة أو شبكة غير قانوني.

تشير رسالة illegal address إلى وصول خارج الحدود داخل kernel، وغالبًا ما يكون السبب غياب فحص الحدود على الفهرس.

تتألق هذه الأداة داخل macro‏ CUDA_CHECK: التقط الرمز، ثم اطبع سلسلته حتى تشرح الأخطاء نفسها فورًا.

توجد أيضًا cudaGetErrorName، التي تعيد اسم التعداد مثل cudaErrorMemoryAllocation بدلًا من الوصف الطويل.

استخدم الاسم للسجلات المختصرة، والوصف للوضوح. وتطبع فرق كثيرة الاثنين للحصول على أفضل ما فيهما.

هل توقفت بسبب خطأ؟ ألصق سلسلة الخطأ في محرك بحث. فصياغتها معيارية، ولذلك واجهها آخرون قبلك.

يحوّل فك الترميز رقمًا عديم الفائدة إلى دليل واضح. وغالبًا ما تشير الرسالة الصحيحة مباشرةً إلى السطر الذي يجب إصلاحه.

تحوّل cudaGetErrorString الرموز إلى رسائل مقروءة، بينما تعطي cudaGetErrorName اسم التعداد. اطبعهما لتصحيح الأخطاء بثقة. 🎉