ccc

Koleksi Kompiler Kekacauan

Pustaka dan seperangkat alat baris perintah untuk mengurai simbol debug dari game PS2. Rilis seri 1.x difokuskan pada simbol STABS di bagian .mdebug, sedangkan rilis seri 2.x juga dapat mengurai simbol ELF standar dan simbol linker SNDLL. Dukungan DWARF sedang dikerjakan.

• Rilis
• Bangunan Tidak Stabil

Peralatan

menguraikan

Demangler simbol C++ dengan dukungan untuk skema mangling Itanium C++ ABI (GCC 3+) baru dan skema GCC 2 lama.

keberatan

Pembongkaran MIPS inti EE yang setengah berfungsi. Mungkin tidak terlalu menarik.

stdump

Pengurai dan dumper tabel simbol. Itu dapat mengekstrak informasi berikut:

• Tipe data (struct, union, enum, dll)
• Fungsi (nama, tipe kembalian, parameter dan variabel lokal)
• Variabel global

Format keluaran berikut ini didukung:

• C++
• JSON

Ini dimaksudkan untuk digunakan dengan ghidra-emotionengine-reloaded (>= 2.1.0 atau salah satu build tidak stabil) untuk mengimpor semua informasi ini ke Ghidra. Perhatikan bahwa meskipun namanya penganalisa STABS harus bekerja untuk R3000 (IOP) dan mungkin prosesor MIPS lainnya juga.

tidak termasuk

Ini mirip dengan stdump kecuali ia mengatur keluarannya ke dalam file sumber terpisah, dan memiliki sejumlah fitur tambahan yang dirancang untuk mencoba dan membuat keluaran tersebut mendekati kode sumber yang valid. File SOURCES.txt harus disediakan di direktori keluaran, yang dapat dihasilkan menggunakan perintah stdump files (Anda harus memperbaiki jalur secara manual sehingga relatif terhadap direktori keluaran, dan menghapus alamatnya). Selain itu, file tidak kosong yang tidak dimulai dengan // STATUS: NOT STARTED tidak akan ditimpa.

Jika file FUNCTIONS.txt disediakan di direktori output, seperti yang dapat dihasilkan menggunakan skrip CCCDecompileAllFunctions.java yang disertakan untuk Ghidra, kode dari file tersebut akan digunakan untuk mengisi isi fungsi dalam output. Dalam hal ini, grup pertama dari deklarasi variabel lokal yang dipancarkan adalah grup yang dipulihkan dari simbol, dan grup kedua akan berasal dari kode yang disediakan dalam file fungsi. Nama fungsi dihilangkan.

Data variabel global akan dicetak secara terstruktur berdasarkan tipe datanya.

Tipe data akan diurutkan ke dalam file yang sesuai. Karena informasi ini tidak disimpan dalam tabel simbol, uncc menggunakan heuristik untuk memetakan tipe ke file. Jenis akan dimasukkan ke dalam file .c atau .cpp ketika hanya ada satu unit terjemahan yang jenisnya muncul, dan file .h ketika ada beberapa (dan karenanya heuristik harus digunakan untuk menentukan di mana menempatkannya).

Disarankan untuk menggunakan pemformat kode seperti clang-format atau astyle pada output.

Bangunan

 cmake -B bin/
cmake --build bin/

Dokumentasi

Koleksi Kompiler Kekacauan

• Ikhtisar Perpustakaan
• Bug Kompiler
• Penanganan Kesalahan
• Format JSON
• Struktur Proyek
• Basis Data Simbol

Bagian DWARF (.debug).

• Format Informasi Debugging DWARF / mirror dalam repo / mirror archive.org

MIPS ABI

• MIPS EABI / cermin dalam repo / cermin archive.org
• Tambahan Prosesor MIPS RISC Antarmuka Biner Aplikasi Sistem V / in-repo mirror / archive.org mirror

Bagian Debug MIPS (.mdebug).

• Perangkat Lunak Mata Ketiga dan tabel simbol MIPS (Peter Rowell) / in-repo mirror / archive.org mirror
• Informasi Debugging Mdebug MIPS (David Anderson, 1996) / in-repo mirror / archive.org mirror
• Panduan Pemrogram Bahasa Majelis MIPS, Bab Tabel Simbol (Silicon Graphics, 1992) / in-repo mirror
• Spesifikasi Format Tabel Simbol dan File Objek UNIX Tru64, Bab Tabel Simbol
  • Versi 5.1 (Compaq Computer Corporation, 2000) / mirror dalam repo
  • Versi 5.0 (Compaq Computer Corporation, 1999) / mirror dalam repo
• mdebugread.c dari gdb (membaca)
• ecoff.c dari gas (menulis)
• include/coff/sym.h dari binutils (header)

Tusuk-tusuk

• Representasi "tusukan" dari informasi debug (Julia Menapace, Jim Kingdon, dan David MacKenzie, 1992-???) / in-repo mirror (HTML, PDF) / archive.org mirror
• stabs.c dari binutils (membaca)
• stabsread.c dari gdb (membaca)
• dbxread.c dari gdb (membaca)
• dbxout.c dari gcc (menulis)
• stab.def dari gcc (kode simbol)

Lisensi

Kode sumber untuk perpustakaan CCC dan alat baris perintah terkait dirilis di bawah lisensi MIT.

Demangler GNU digunakan, yang berisi file sumber yang dilisensikan di bawah GPL dan LGPL. RapidJSON digunakan di bawah lisensi MIT. Pustaka GoogleTest digunakan oleh rangkaian pengujian di bawah lisensi 3-Clause BSD.