ccc

Коллекция компиляторов хаоса

Библиотека и набор инструментов командной строки для анализа символов отладки из игр для PS2. Выпуски серии 1.x были ориентированы на символы STABS в разделах .mdebug, тогда как выпуски серии 2.x также могут анализировать стандартные символы ELF и символы компоновщика SNDLL. Поддержка DWARF находится в разработке.

• Релизы
• Нестабильные сборки

Инструменты

разбирать

Средство разбора символов C++ с поддержкой как новой схемы преобразования Itanium C++ ABI (GCC 3+), так и старой схемы GCC 2.

объектный дамп

Полурабочий дизассемблер MIPS EE core. Наверное, это не слишком интересно.

стандартный дамп

Анализатор и дампер таблицы символов. Он может извлечь следующую информацию:

• Типы данных (структуры, объединения, перечисления и т. д.)
• Функции (имя, тип возвращаемого значения, параметры и локальные переменные)
• Глобальные переменные

Поддерживаются следующие форматы вывода:

• С++
• 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/

Документация

Коллекция компиляторов хаоса

• Обзор библиотеки
• Ошибки компилятора
• Обработка ошибок
• Формат JSON
• Структура проекта
• База данных символов

Раздел DWARF (.debug)

• Формат отладочной информации DWARF / зеркало в репозитории / зеркало archive.org

МИПС АБИ

• MIPS EABI / зеркало в репозитории / зеркало archive.org
• Двоичный интерфейс приложения System V. Дополнение к процессору MIPS RISC / зеркало в репозитории / зеркало archive.org

Раздел отладки MIPS (.mdebug)

• Программное обеспечение Third Eye и таблица символов MIPS (Питер Роуэлл) / зеркало в репозитории / зеркало archive.org
• Информация об отладке MIPS Mdebug (Дэвид Андерсон, 1996) / зеркало в репозитории / зеркало archive.org
• Руководство программиста на языке ассемблера MIPS, глава таблицы символов (Silicon Graphics, 1992) / зеркало в репозитории
• Спецификация формата объектного файла Tru64 UNIX и таблицы символов, глава «Таблица символов»
  • Версия 5.1 (Compaq Computer Corporation, 2000 г.) / зеркало в репозитории
  • Версия 5.0 (Compaq Computer Corporation, 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 из gcc (запись)
• stab.def из gcc (коды символов)

Лицензия

Исходный код библиотеки CCC и связанных с ней инструментов командной строки распространяется под лицензией MIT.

Используется деманглер GNU, который содержит исходные файлы под лицензией GPL и LGPL. RapidJSON используется по лицензии MIT. Библиотека GoogleTest используется набором тестов по лицензии BSD из 3 пунктов.