ccc

مجموعة مترجم الفوضى

مكتبة ومجموعة من أدوات سطر الأوامر لتحليل رموز التصحيح من ألعاب PS2. ركزت سلسلة الإصدارات 1.x على رموز STABS في أقسام .mdebug، بينما يمكن لسلسلة الإصدارات 2.x أيضًا تحليل رموز ELF القياسية ورموز رابط SNDLL. دعم DWARF قيد التنفيذ.

• الإصدارات
• بنيات غير مستقرة

أدوات

تفكيك

أداة فك تشابك رموز C++ مع دعم لكل من مخطط تغيير Itanium C++ ABI (GCC 3+) الجديد ونظامGC 2 القديم.

com.objdump

مفكك MIPS EE الأساسي نصف العامل. ربما ليست مثيرة للاهتمام للغاية.

com.stdump

محلل جدول الرموز والقلابة. يمكنه استخراج المعلومات التالية:

• أنواع البيانات (الهياكل، الاتحادات، التعدادات، الخ)
• الوظائف (الاسم ونوع الإرجاع والمعلمات والمتغيرات المحلية)
• المتغيرات العالمية

يتم دعم تنسيقات الإخراج التالية:

• سي ++
• JSON

هذا مخصص للاستخدام مع ghidra-emotionengine-reloaded (>= 2.1.0 أو أحد الإصدارات غير المستقرة) لاستيراد كل هذه المعلومات إلى Ghidra. لاحظ أنه على الرغم من الاسم، يجب أن يعمل محلل STABS مع معالجات R3000 (IOP) وربما معالجات MIPS الأخرى أيضًا.

uncc

يشبه هذا stdump إلا أنه ينظم مخرجاته في ملفات مصدر منفصلة، ​​ويحتوي على عدد من الميزات الإضافية المصممة لمحاولة جعل المخرجات المذكورة أقرب إلى كود المصدر الصحيح. يجب توفير ملف SOURCES.txt في دليل الإخراج، والذي يمكن إنشاؤه باستخدام أمر stdump files (يجب عليك إصلاح المسارات يدويًا بحيث تكون مرتبطة بدليل الإخراج، وإزالة العناوين). بالإضافة إلى ذلك، لن تتم الكتابة فوق الملفات غير الفارغة التي لا تبدأ بـ // STATUS: NOT STARTED .

إذا تم توفير ملف FUNCTIONS.txt في دليل المخرجات، كما يمكن إنشاؤه باستخدام البرنامج النصي CCCDecompileAllFunctions.java المضمن لـ Ghidra، فسيتم استخدام الكود من هذا الملف لملء أجسام الوظائف في المخرجات. في هذه الحالة، المجموعة الأولى من إعلانات المتغيرات المحلية المنبعثة ستكون تلك المستردة من الرموز، وستكون المجموعة الثانية من التعليمات البرمجية المتوفرة في ملف الوظائف. يتم تفكيك أسماء الوظائف.

ستتم طباعة بيانات المتغير الشامل بطريقة منظمة بناءً على نوع البيانات الخاصة به.

سيتم فرز أنواع البيانات في الملفات المقابلة لها. نظرًا لعدم تخزين هذه المعلومات في جدول الرموز، يستخدم UNCC الأساليب البحثية لتعيين الأنواع للملفات. سيتم وضع الأنواع في ملفات .c أو .cpp عندما لا يكون هناك سوى وحدة ترجمة واحدة يظهر فيها النوع، وملفات .h عندما تكون هناك عدة ملفات (وبالتالي عندما يجب استخدام الاستدلال لتحديد مكان وضعها).

يوصى باستخدام منسق التعليمات البرمجية مثل clang-format أو astyle في المخرجات.

مبنى

 cmake -B bin/
cmake --build bin/

التوثيق

مجموعة مترجم الفوضى

• نظرة عامة على المكتبة
• أخطاء المترجم
• معالجة الأخطاء
• تنسيق جيسون
• هيكل المشروع
• قاعدة بيانات الرموز

قسم القزم (.debug).

• تنسيق معلومات تصحيح DWARF / مرآة in-repo / مرآة archive.org

MIPS أبي

• MIPS EABI / مرآة في الريبو / مرآة archive.org
• واجهة التطبيق الثنائية للنظام V، ملحق معالج MIPS RISC / مرآة in-repo / مرآة archive.org

قسم تصحيح MIPS (.mdebug).

• برنامج العين الثالثة وجدول رموز MIPS (بيتر رويل) / مرآة in-repo / مرآة archive.org
• معلومات تصحيح أخطاء MIPS Mdebug (ديفيد أندرسون، 1996) / مرآة in-repo / مرآة archive.org
• دليل مبرمج لغة التجميع MIPS، فصل جدول الرموز (Silicon Graphics، 1992) / مرآة في الريبو
• مواصفات ملف كائن Tru64 UNIX وتنسيق جدول الرموز، فصل جدول الرموز
  • الإصدار 5.1 (شركة كومباك للكمبيوتر، 2000) / مرآة في الريبو
  • الإصدار 5.0 (شركة كومباك للكمبيوتر، 1999) / مرآة في الريبو
• mdebugread.c من gdb (القراءة)
• ecoff.c من الغاز (الكتابة)
• include/coff/sym.h من binutils (الرؤوس)

طعنات

• تمثيل "الطعنات" لمعلومات تصحيح الأخطاء (جوليا مينابيس، وجيم كينغدون، وديفيد ماكنزي، 1992-؟؟؟) / مرآة الريبو (HTML، PDF) / مرآة archive.org
• stabs.c من binutils (القراءة)
• stabsread.c من gdb (القراءة)
• dbxread.c من gdb (القراءة)
• dbxout.c من دول مجلس التعاون الخليجي (الكتابة)
• stab.def من دول مجلس التعاون الخليجي (رموز الرموز)

رخصة

يتم إصدار الكود المصدري لمكتبة CCC وأدوات سطر الأوامر المرتبطة بها بموجب ترخيص MIT.

يتم استخدام أداة فك تشابك GNU، التي تحتوي على ملفات مصدر مرخصة بموجب GPL وLGPL. يتم استخدام RapidJSON بموجب ترخيص MIT. يتم استخدام مكتبة GoogleTest بواسطة مجموعة الاختبار بموجب ترخيص BSD المكون من 3 فقرات.