تحذير

مشروع RetDec حاليًا في وضع الصيانة المحدودة بسبب نقص الموارد:

• طلبات السحب (Pull Requests) مرحب بها. يتم مراجعتها بأولوية، إن أمكن دون تأخير.
• يتم الرد على المشكلات (Issues) مع تأخير يصل إلى ربع سنة. لا يتم حل المشكلات بنشاط إلا إذا كانت تتعلق بصيانة المشروع الأساسية.
• تستمر الصيانة الأساسية للمشروع.
• يتم تطوير محدود جدًا فقط.

RetDec

))/statusIcon)

RetDec هو مفكك كود آلة قابل لإعادة الاستهداف مبني على LLVM.

ليس المفكك مقيدًا بأي بنية معمارية مستهدفة أو نظام تشغيل أو تنسيق ملف قابل للتنفيذ:

• تنسيقات الملفات المدعومة: ELF, PE, Mach-O, COFF, AR (أرشيف), Intel HEX, وكود آلة خام
• البنى المعمارية المدعومة:
  • 32-bit: Intel x86, ARM, MIPS, PIC32, و PowerPC
  • 64-bit: x86-64, ARM64 (AArch64)

الميزات:

• تحليل ثابت للملفات القابلة للتنفيذ مع معلومات مفصلة.
• كشف المترجمين وبرامج الضغط.
• التحميل وفك تعليمات التشفير.
• إزالة الكود المكتبي المرتبط بشكل ثابت بناءً على التوقيعات.
• استخراج واستخدام معلومات التصحيح (DWARF, PDB).
• إعادة بناء تعابير التعليمات.
• كشف وإعادة بناء هرمية الفئات في C++ (RTTI, vtables).
• فك تشفير الرموز من ثنائيات C++ (GCC, MSVC, Borland).
• إعادة بناء الدوال والأنواع والإنشاءات عالية المستوى.
• مفكك مدمج.
• مخرجات بلغتين عاليتي المستوى: C ولغة مشابهة لـ Python.
• توليد رسوم بيانية للاستدعاءات ورسوم بيانية لتدفق التحكم وإحصائيات متنوعة.

لمزيد من المعلومات، طالع

• الويكي (قيد التطوير)
• محاضرة Botconf 2017: الشرائح، الفيديو
• محاضرة REcon Montreal 2018: الشرائح
• المنشورات

التثبيت

هناك طريقتان للحصول على وتثبيت RetDec:

1. تحميل وفك ضغط حزمة مبنية مسبقًا مستقرة أو أحدث إصدار واتبع التعليمات في قسم الاستخدام من ملف retdec/share/retdec/README.md بعد فك الضغط.
2. بناء RetDec بنفسك من المصادر باتباع قسم البناء والتثبيت. بعد التثبيت، اتبع التعليمات أدناه.

ندعم حاليًا Windows (7 أو أحدث)، Linux، macOS، و (بشكل تجريبي) FreeBSD. تتطلب النسخة المثبتة من RetDec ما يقرب من 5 إلى 6 جيجابايت من مساحة القرص الحرة.

الاستخدام

يرجى التأكد من قراءة التعليمات المقابلة لإصدار RetDec المستخدم. إذا كنت غير متأكد، راجع ملف retdec/share/retdec/README.md في التثبيت.

Windows

1. بعد تثبيت RetDec، قم بتثبيت Microsoft Visual C++ Redistributable لـ Visual Studio 2017.

2. قم بتثبيت البرامج التالية:

   • UPX (اختياري: إذا كنت ترغب في استخدام أداة فك ضغط UPX في مرحلة المعالجة المسبقة)
   • Graphviz (اختياري: إذا كنت ترغب في توليد رسوم بيانية للاستدعاء أو تدفق التحكم)

3. لفك ترجمة ملف ثنائي باسم test.exe، قم بتشغيل

   $RETDEC_INSTALL_DIR\bin\retdec-decompiler.exe test.exe
   

   لمزيد من المعلومات، قم بتشغيل retdec-decompiler.exe مع --help.

Linux

1. بعد تثبيت RetDec، قم بتثبيت الحزم التالية عبر مدير الحزم في توزيعتك:

   • UPX (اختياري: إذا كنت ترغب في استخدام أداة فك ضغط UPX في مرحلة المعالجة المسبقة)
   • Graphviz (اختياري: إذا كنت ترغب في توليد رسوم بيانية للاستدعاء أو تدفق التحكم)

2. لفك ترجمة ملف ثنائي باسم test.exe، قم بتشغيل

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   لمزيد من المعلومات، قم بتشغيل retdec-decompiler مع --help.

macOS

1. بعد تثبيت RetDec، قم بتثبيت الحزم التالية:

   • UPX (اختياري: إذا كنت ترغب في استخدام أداة فك ضغط UPX في مرحلة المعالجة المسبقة)
   • Graphviz (اختياري: إذا كنت ترغب في توليد رسوم بيانية للاستدعاء أو تدفق التحكم)

2. لفك ترجمة ملف ثنائي باسم test.exe، قم بتشغيل

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   لمزيد من المعلومات، قم بتشغيل retdec-decompiler مع --help.

FreeBSD (تجريبي)

1. لا توجد حاليًا حزم "ports" مبنية مسبقًا لـ FreeBSD. ستحتاج إلى بناء وتثبيت المفكك بنفسك. العملية موصوفة أدناه.

2. لفك ترجمة ملف ثنائي باسم test.exe، قم بتشغيل

   $RETDEC_INSTALL_DIR/bin/retdec-decompiler test.exe
   

   لمزيد من المعلومات، قم بتشغيل retdec-decompiler مع --help.

استخدام مكتبات RetDec

يمكنك استخدام مكتبات RetDec المختلفة بسهولة في مشاريعك - إذا كانت مبنية باستخدام CMake. يحتوي تثبيت RetDec على جميع الرؤوس والمكتبات وملفات CMake الضرورية.

إذا قمت بتثبيت RetDec في موقع تثبيت قياسي لنظامك (مثل /usr، /usr/local)، كل ما عليك فعله لاستخدام مكوناته هو:```cmake find_package(retdec 5.0 REQUIRED COMPONENTS [...] ) target_link_libraries(your-project PUBLIC retdec:: [...] )

إذا لم تقم بتثبيت RetDec في مكان يمكن اكتشافه تلقائياً، فستحتاج إلى مساعدة CMake في العثور عليه قبل استخدام `find_package()`. هناك طريقتان عامتان للقيام بذلك (اختر واحدة فقط واستخدمها):

1. أضف دليل تثبيت RetDec إلى [`CMAKE_PREFIX_PATH`](https://cmake.org/cmake/help/latest/variable/CMAKE_PREFIX_PATH.html):
    ```cmake
    list(APPEND CMAKE_PREFIX_PATH ${RETDEC_INSTALL_DIR})
    ```

2. عيّن المسار إلى نصوص CMake المثبتة لـ RetDec إلى `retdec_DIR`:
    ```cmake
    set(retdec_DIR ${RETDEC_INSTALL_DIR}/share/retdec/cmake)
    ```

راجع صفحة [نظرة عامة على المستودع](https://github.com/avast/retdec/wiki/Repository-Overview) في الويكي للحصول على قائمة بمكونات RetDec المتاحة، أو [retdec-build-system-tests](https://github.com/avast/retdec-build-system-tests) للحصول على عروض توضيحية حول كيفية استخدامها.

## البناء والتثبيت

يصف هذا القسم بناء وتثبيت محلي لـ RetDec. ترد تعليمات Docker في القسم التالي.

### المتطلبات

#### لينكس

* مترجم C++ ومكتبة C++ قياسية تدعم C++17 (مثل GCC >= 7)
* [CMake](https://cmake.org/) (الإصدار >= 3.6)
* [Git](https://git-scm.com/)
* [OpenSSL](https://www.openssl.org/) (الإصدار >= 1.1.1)
* [Python](https://www.python.org/) (الإصدار >= 3.4)
* [autotools](https://en.wikipedia.org/wiki/GNU_Build_System) ([autoconf](https://www.gnu.org/software/autoconf/autoconf.html)، [automake](https://www.gnu.org/software/automake/)، و [libtool](https://www.gnu.org/software/libtool/))
* [pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/)
* [m4](https://www.gnu.org/software/m4/m4.html)
* [zlib](http://zlib.net/)
* اختياري: [Doxygen](http://www.stack.nl/~dimitri/doxygen/) و [Graphviz](http://www.graphviz.org/) لتوليد وثائق API

على التوزيعات المبنية على Debian (مثل Ubuntu)، يمكن تثبيت الحزم المطلوبة باستخدام `apt-get`:```sh
sudo apt-get install build-essential cmake git openssl libssl-dev python3 autoconf automake libtool pkg-config m4 zlib1g-dev upx doxygen graphviz

على توزيعات RPM (مثل Fedora)، يمكن تثبيت الحزم المطلوبة باستخدام dnf:```sh sudo dnf install gcc gcc-c++ cmake make git openssl openssl-devel python3 autoconf automake libtool pkg-config m4 zlib-devel upx doxygen graphviz

على Arch Linux، يمكن تثبيت الحزم المطلوبة باستخدام `pacman`:```sh
sudo pacman --needed -S base-devel cmake git openssl python3 autoconf automake libtool pkg-config m4 zlib upx doxygen graphviz

ويندوز