قراءة التقارير

يتكوّن تقرير Valgrind من ثلاثة أجزاء:

• بادئة معرّف العملية في كل سطر
• كتلة أخطاء واحدة أو أكثر عند حدوثها
• ملخص نهائي لـ HEAP and LEAK SUMMARY عند الخروج

إن تعلّم قراءة كل جزء يحوّل جدار النص إلى قائمة مهام دقيقة.

يبدأ كل سطر من Valgrind بالصيغة ==PID==، مثل ==12345==.

هذا هو معرّف العملية، وليس جزءًا من ناتج برنامجك. وهو يتيح لك فصل رسائل Valgrind عن ناتج printf الخاص ببرنامجك عندما يشتركان في الطرفية.

إليك كتلة حقيقية لعملية كتابة غير صالحة:

==12345== Invalid write of size 4
==12345== at 0x4005A1: main (prog.c:6)
==12345== Address 0x520304c is 0 bytes after a block of size 20 alloc'd
==12345== at 0x4838B40: malloc
==12345== by 0x40058E: main (prog.c:5)

يسمّي السطر الأول نوع الخطأ وحجمه: 'Invalid write of size 4'.

يعني الحجم 4 أن الوصول يبلغ 4 بايتات، وهو عادةً من نوع int. يخبرك هذا السطر وحده بفئة الخطأ المتوقعة قبل أن تتابع القراءة.

يمثّل السطر at الإطار الداخلي، حيث حدث الخطأ. وكل سطر by يمثّل مستدعيًا أعلى منه بمستوى واحد.

اقرأ من الأعلى إلى الأسفل، من الأعمق إلى الأقل عمقًا. ويكون أول إطار يتضمّن اسم ملفك غالبًا موضع الخطأ.

يحدّد السطر Address ... موضع الوصول بالنسبة إلى كتلة معروفة:

• 0 bytes after a block of size 20 alloc'd — فيضان يتجاوز النهاية مباشرةً
• 4 bytes inside a block of size 4 free'd — استخدام الذاكرة بعد تحريرها
• on thread 1's stack — وصول إلى المكدس

كما يعرض موضع تخصيص تلك الكتلة أو تحريرها.

عند الخروج، تحصل على حساب للتخصيصات:

==12345== HEAP SUMMARY:
==12345== in use at exit: 20 bytes in 1 blocks
==12345== total heap usage: 3 allocs, 2 frees, 1,044 bytes allocated

تعني قيمة 'in use at exit' الأكبر من الصفر أن شيئًا ما لم يُحرَّر.

تُصنَّف التسريبات أسفل ملخص الكومة:

definitely lost: 20 bytes in 1 blocks
indirectly lost: 0 bytes in 0 blocks
possibly lost: 0 bytes in 0 blocks
still reachable: 0 bytes in 0 blocks

أضف --leak-check=full لإرفاق تتبّع بكل كتلة مفقودة.

يعدّ السطر الأخير كل شيء:

ERROR SUMMARY: 2 errors from 2 contexts

«السياق» هو موضع خطأ فريد. إذا نُفّذ سطر يحوي خطأً مليون مرة داخل حلقة، فسيظل سياقًا واحدًا. هدفك هو 0 errors from 0 contexts.

عالج التقرير بطريقة منهجية:

• أصلح أخطاء الوصول غير الصالح أولًا؛ فهي تسبب تلفًا
• ثم أخطاء القيم غير المُهيّأة
• ثم التسريبات المفقودة حتمًا والمفقودة بشكل غير مباشر
• أعد التشغيل بعد كل إصلاح؛ فغالبًا ما يزيل السبب الجذري عدة تقارير

تأتي بعض الأخطاء من مكتبات لا يمكنك إصلاحها، مثل بيئة تشغيل C أو برنامج تشغيل الرسوميات. أنشئ ملف حجب لإسكات هذه الأخطاء من دون إخفاء أخطائك.

يطبع --gen-suppressions=all إدخالات حجب جاهزة للاستخدام، تحفظها ثم تمررها مجددًا باستخدام --suppressions=file.

فسّر سطرًا واحدًا من تقرير.

يمكنك الآن قراءة تقارير Valgrind من البداية إلى النهاية:

• تسبق ==PID== أسطر Valgrind، فتفصلها عن ناتج البرنامج
• تقدّم كل كتلة خطأ النوع والحجم وتتبع المكدس وملاحظة العنوان
• تحصي ملخصات HEAP/LEAK التخصيصات والذاكرة المفقودة
• يعدّ ERROR SUMMARY السياقات الفريدة؛ فاستهدف الوصول إلى الصفر

عالج أخطاء الوصول أولًا، ثم التسريبات، مع إعادة التشغيل أثناء التقدّم.