gdb frontend

GDBFrontend هو مصحح أخطاء واجهة المستخدم الرسومية سهل ومرن وقابل للتمديد. جربه على الانترنت!

التثبيت

متطلبات

• GDB => 8.2 (مع python3)
• بيثون3 => 3.6
• com.tmux

حزمة PIP (عجلة بايثون) [مستحسن]

يمكنك تثبيت GDBFrontend باستخدام pip .

sudo python3 -m pip install gdbfrontend

إذا كان مثبتًا بالفعل وتقوم بالترقية

sudo python3 -m pip install --upgrade gdbfrontend

أو إذا كنت تريد تثبيت لقطة GIT محددة:

sudo python3 setup.py install

ويمكنك تشغيل

gdbfrontend

تشغيل من GIT

يمكنك تنزيل أحدث مصدر وتشغيله.

يمكنك تشغيل gdb-frontend بالأوامر التالية:

git clone https://github.com/rohanrhu/gdb-frontend.git gdb-frontend
cd gdb-frontend
./gdbfrontend

ويمكنك فتحه باستخدام:

 http://127.0.0.1:5550/

يمكنك فتح GDB Shell باستخدام الأمر:

tmux a -t gdb-frontend

آرتش لينكس (AUR)

يمكنك تثبيت حزمة Arch Linux للتوزيعات المستندة إلى Arch. (حزمة أور)

yay -S gdb-frontend-bin

ويمكنك تشغيله:

gdbfrontend

فلاتباك

حزمة Flatpak هي TODO.

تصحيح أخطاء تطبيقات Dockerized C/C++ باستخدام GDBFrontend

اتبع هذا البرنامج التعليمي لمعرفة كيفية تصحيح أخطاء تطبيقات Dockerized C/C++ باستخدام GDBFrontend.

تصحيح الأخطاء المضمنة مع GDBFrontend

اتبع هذا البرنامج التعليمي السريع لتصحيح أخطاء الأجهزة المضمنة باستخدام GDBFrontend.

تصحيح أخطاء ملحق Python C باستخدام GDBFrontend

اتبع هذا البرنامج التعليمي السريع لتصحيح أخطاء ملحقات C Python الأصلية باستخدام GDBFrontend.

كيفية تطوير ملحقات GDBFrontend؟

يحتوي GDBFrontend على واجهات برمجة تطبيقات قوية وقابلة للتوسيع. اتبع هذا البرنامج التعليمي السريع لتتعلم كيفية تطوير المكونات الإضافية لـ GDBFrontend.

كيفية دمج GDBFrontend مع ملف Makefile الخاص بك؟

اتبع هذا البرنامج التعليمي السريع للحصول على أفكار التكامل لمتطلبات التطوير/التصحيح الخاصة.

تصحيح أخطاء STM32 باستخدام OpenOCD وGDB وGDBFrontend على Linux

اتبع هذا البرنامج التعليمي لتصحيح أخطاء STM32 باستخدام OpenOCD وGDBFrontend.

سمات

مقيم التعبير

يحتوي GDBFrontend على مُقيِّم تعبير يمكنك استخدامه عدة مرات في نفس الوقت.

تصور المؤشر

تصور القائمة المرتبطة

نقاط التوقف الشرطية

انقر بزر الماوس الأيمن على نقطة التوقف لتعيين حالتها.

التعبيرات المتصلة

ترتبط تعبيرات جميع المتغيرات والأعضاء والعناصر في VariablesExplorer الخاص بـ GDBFrontend.

مدير العمليات

يمكنك مشاهدة العمليات أو تصفيتها أو إدارتها باستخدام مدير العمليات.

تصور صفيف الرسم البياني

تعزيز التعاون

يحتوي GDBFrontend على مجموعة من الميزات للتعاون تسمى "التعاون المحسن".

رسم التعاون

يتوفر رسم التعاون عند تمكين التعاون المحسن. انقر للرسم أو استخدم اختصار Ctrl + Shift + X للرسم و Ctrl + Shift + C لمسح جميع الرسومات.

عرض المصدر المتزامن

من خلال التعاون المحسن، تتم مزامنة جميع عملاء مصحح الأخطاء عند عرض المصدر.

التعبير تحوم المستكشف المتغير

القابلية للتوسعة

GDBFrontend قابل للتوسعة للغاية ويحتوي على واجهات برمجة تطبيقات قوية. بعض الأمثلة على قابلية التوسعة في GDBFrontend.

./gdbfrontend

$ gdbfrontend --help
GDBFrontend is a easy, flexible and extensionable gui debugger.

Options:
  --help, -h:                                   Shows this help message.
  --version, -v:                                Shows version.
  --gdb-args= " ARGS " , -G " ARGS " :                 Specifies GDB command line arguments. (Optional)
  --gdb-executable=PATH, -g PATH:               Specifies GDB executable path (Default is " gdb " command on PATH environment variable.)
  --tmux-executable=PATH, -tmux PATH:           Specifies Tmux executable path (Default is " tmux " command on PATH environment variable.)
  --terminal-id=NAME, -t NAME:                  Specifies tmux terminal identifier name (Default is " gdb-frontend " .)
  --credentials=USER:PASS, -c USER:PASS:        Specifies username and password for accessing to debugger.
  --host=IP, -H IP:                             Specifies current host address that you can access via for HTTP and WS servers.
  --listen=IP, -l IP:                           Specifies listen address for HTTP and WS servers.
  --port=PORT, -p PORT:                         Specifies HTTP port. (0 for random port.)
  --url-base=PATH, -u PATH:                     Specifies URL base path. (Default: /)
  --readonly, -r:                               Makes code editor readonly. (Notice: This option is not related to security.)
  --workdir, -w:                                Specifies working directory.
  --plugin-dir, -P:                             Specifies plugins directory.
  --dontopenuionstartup, -D:                    Avoids opening UI just after startup.
  --verbose, -V:                                Enables verbose output.

خيارات

--help ، -h

يظهر نص المساعدة.

--version ، -v

يظهر الإصدار.

--gdb-args="ARGS", -G "ARGS"

يحدد وسيطات سطر أوامر GDB. (خياري)

--gdb-executable=PATH , -g PATH

يمكنك تحديد مسار GDB القابل للتنفيذ مثل gdbfrontend --gdb-executable=/path/to/gdb . (خياري)

--tmux-executable=PATH , -tmux PATH

يمكنك تحديد مسار Tmux القابل للتنفيذ مثل gdbfrontend --tmux-executable=/path/to/tmux . (خياري)

--terminal-id=PATH , -t PATH

يمكنك تحديد معرف محطة Tmux مثل gdbfrontend --terminal-id=terminal-name . (الافتراضي: gdb-frontend )

--credentials=USER:PASS ، -c USER:PASS

يحدد اسم المستخدم وكلمة المرور للوصول إلى مصحح الأخطاء.

--host=IP , -H IP

يحدد عنوان المضيف الحالي الذي يمكنك الوصول إليه عبر خوادم HTTP وWS.

--listen=IP , -l IP

يحدد عنوان الاستماع لخوادم HTTP وWS.

--port=PORT , -p PORT

يحدد منفذ HTTP. (0 للمنفذ العشوائي.)

--url-base=PATH , -u PATH

يحدد المسار الأساسي لعنوان URL. (تقصير: /)

--readonly, -r

يجعل محرر التعليمات البرمجية للقراءة فقط. (ملاحظة: هذا الخيار لا يتعلق بالأمان.)

--workdir, -w

يحدد دليل العمل.

--plugin-dir, -P

يحدد دليل الإضافات.

--dontopenuionstartup ، -D

يتجنب فتح واجهة المستخدم مباشرة بعد بدء التشغيل.

--verbose ، -V

تمكين الإخراج المطول.

أوامر جي دي بي

تبدأ أوامر GDB الخاصة بـ GDBFrontend بـ gf- .

gf-refresh

تحديث كافة عملاء المتصفح.

gf-theme [theme-name]

التبديل إلى الموضوع المطلوب. على سبيل المثال: gf-theme light أو gf-theme red أو gf-theme default للموضوع الافتراضي.

gf-list-plugins

يسرد جميع مكونات GDBFrontend الإضافية في دليل المكونات الإضافية.

gf-load-plugin [plugin-name]

تحميل البرنامج المساعد GDBFrontend.

gf-unload-plugin [plugin-name]

تفريغ البرنامج المساعد GDBFrontend.

الاختصارات / مفاتيح التشغيل السريع

يتم سرد مفاتيح التشغيل السريع الحالية أدناه.

فعل	مفتاح الاختصار	سياق
عام: افتح الملف المصدر	السيطرة + س	GDBFrontend
عام: New ExpressionEvaluator	السيطرة + ر	GDBFrontend
عام: ExpressionEvaluator جديد على النافذة الأصلية	Ctrl + Shift + R	GDBFrontend
عام: مكتشف مصدر غامض	السيطرة + ص	GDBFrontend
وقت التشغيل: تشغيل	F5	GDBFrontend
وقت التشغيل: متابعة	F6	GDBFrontend
وقت التشغيل: إيقاف مؤقت/مقاطعة	F7	GDBFrontend
وقت التشغيل: خطوة أكثر	F8	GDBFrontend
وقت التشغيل: خطوة إلى	F9	GDBFrontend
وقت التشغيل: تعليمات الخطوة	F10	GDBFrontend
وقت التشغيل: توقف	F11	GDBFrontend
التعاون المحسن: تبديل وضع الرسم	السيطرة + التحول + X	GDBFrontend / التعاون المحسن: ممكن
التعاون المحسن: مسح كافة الرسومات	Ctrl + Shift + C	GDBFrontend / التعاون المحسن: ممكن

المواضيع

يحتوي GDBFrontend على سمات مدمجة.

للتبديل بين السمات، استخدم الأمر gf-theme [THEME] على غلاف GDB.

 (gdb) gf-theme doki
(gdb) gf-theme sky
(gdb) gf-theme sakura
(gdb) gf-theme waifu
(gdb) gf-theme cyberpunk
(gdb) gf-theme dark
(gdb) gf-theme green
(gdb) gf-theme light
(gdb) gf-theme red

للتبديل مرة أخرى إلى الموضوع الافتراضي.

 (gdb) gf-theme

قد ترغب أيضًا في الاطلاع على البرنامج التعليمي لتطوير البرنامج المساعد.

واجهة برمجة تطبيقات بايثون GDBFrontend

يمكنك الوصول إلى واجهة برمجة تطبيقات Python الخاصة بـ GDBFrontend عبر وحدة gdbfrontend .

 (gdb) python-interactive

 > >> dir ( gdbfrontend )

على سبيل المثال، يمكنك الحصول على كافة مآخذ توصيل العميل مثل هذا:

 > >> gdbfrontend . api . globalvars . httpServer . ws_clients
{ 1 : < server . GDBFrontendSocket object at 0 x ... > }

أو يمكنك الحصول على جميع المكونات الإضافية:

 > >> gdbfrontend . plugin . getAll ()
[ 'hello' , 'theme_cyberpunk' , 'theme_dark' , 'theme_doki' , 'theme_green' , 'theme_light' , 'theme_red' , 'theme_sakura' , 'theme_sky' , 'theme_waifu' ]

الأمان مع جلسات المشاركة

يمكنك استخدام خيار --credentials=USER:PASS لإضافة مصادقة HTTP إلى جلسة مصحح الأخطاء الخاصة بك.

توافق المتصفح

يتم تطوير GDBFrontend بشكل أساسي من خلال الاختبار على المتصفحات المستندة إلى Chromium. سيعمل بشكل صحيح مع المتصفحات الأخرى وخاصة مع Firefox ولكن إذا واجهت بعض المشاكل على المتصفحات الأخرى، يمكنك إرسال تقرير بالأخطاء.

استكشاف الأخطاء وإصلاحها

حظر غلاف GDB/الخيط الرئيسي

معظم وظائف GDBFrontend آمنة للخيط وتعمل على مؤشر الترابط الرئيسي لـ GDB. لذا، إذا قمت بتشغيل شيء محظور على GDB Shell، فيجب على وظائف GDBFrontend الانتظار حتى الانتهاء.

سوف تحصل على هذا التحذير عندما تحتاج وظيفة GDBFrontend الآمنة لمؤشر الترابط إلى العمل وتقوم بحظر مؤشر ترابط GDB الرئيسي.

(gdb) shell
$ ...

عند الخروج من الصدفة، سيستمر حظر وظائف GDBFrontend في العمل.

ملحوظة: في بعض الأحيان قد تحصل على هذا التحذير دون تشغيل أي شيء في GDB Shell، فهذا يعني أن شيئًا ما (في حلقة حدث GDB) يستغرق وقتًا طويلاً؛ في هذه الحالة فقط تجاهل هذا التحذير.

عمليات الزومبي

يرسل GDBFrontend SIGTERM إلى عملياته الفرعية وتطبيقك وعملياته الفرعية. إذا كان تطبيقك يقوم بتفرع عمليات جديدة وتعيين معرفات PGID الخاصة بها، فقد لا يقوم GDBFrontend بإغلاقها. في هذه الحالة يجب عليك إرسال SIGKILL إلى عملياتك.

pkill -f gdb

نصائح حول أداء مقيم التعبير

إذا كنت تستخدم ExpressionEvaluator مع متغيرات/أعضاء موسعة ذات عمق طويل جدًا، فقد يتأثر أداء تحريك نافذة التمرير والمقيم بشكل سيئ بالنسبة لتصور المؤشر. في هذه الحالة، يمكنك إيقاف تشغيل إشارات الفتحة والإشارة لنافذة المُقيِّم تلك.

القضايا والنصائح المتعلقة بـ GDB

• قد لا يوفر GDB مصادر للكائنات المرتبطة الديناميكية حتى يتم التنقل على سطر يستدعي دالة من الكائن المرتبط الديناميكي مرة واحدة . يمكنك إضافة نقطة فاصل سطرًا وتدرجه مرة واحدة، ثم سترى مصادر من كائن مرتبط ديناميكي فيما بعد أثناء الجلسة.

ويندوز

في الواقع، gdb-frontend قادر على العمل على Windows ولكن هناك بعض المشكلات الخطيرة في إصدار Windows الخاص بـ GDB والتي تتجنب استخدام gdb-frontend على Windows. بالطبع يمكنك استخدام gdb-frontend على WSL إذا كنت تستخدم Windows 10.

قضايا حول Windows-GDB

• تم حظر الخيط الرئيسي لـ GDB أثناء عملية التشغيل. (تحتوي gdb-frontend على آلية مقاطعة لإصلاح هذه المشكلة ولكنها ليست كافية بعد.)
• تم حظر موجه Windows-GDB أثناء تشغيل العملية وهناك بعض المشكلات المتعلقة بمقاطعة التطبيق.

WSL

يمكنك استخدام gdb-frontend على WSL (نظام Windows الفرعي لنظام Linux).

قضايا حول WSL

• في WSL 1، لا يمكن استخدام خيار المنفذ العشوائي على WSL لأن واجهة /proc/net/tcp لا تعمل على WSL. (WSL 2 ليس لديه هذه المشكلة.)

الإصدار

منذ الإصدار 0.2.0 التجريبي، تحولت GDBFrontend إلى استراتيجية إصدار جديدة.

إصدارات القراءة

في vX.YZ-STABILITY :

• X عبارة عن إصدارات رئيسية ، تتغير على المدى الطويل مع الميزات والتحسينات الرئيسية.
• Y هي الإصدارات الرئيسية التي تتضمن ميزات وتحسينات جديدة.
• Z عبارة عن إصدارات bugfix للإصدارات الرئيسية.
• STABILITY هو مستوى استقرار الإصدار. ( alpha ، beta ، rcN ، stable )

التوثيق

التوثيق هو TODO حتى الآن.

وثائق واجهة برمجة التطبيقات

توثيق واجهة برمجة التطبيقات (API) هو TODO حتى الآن.

تطوير البرنامج المساعد

يمكنك قراءة البرنامج التعليمي لتطوير البرنامج المساعد.

تطوير الموضوع

يتم تطوير السمات كمكونات إضافية.

الفتنة

انضم إلى مجتمع Discord.

؟ المساهمة

يمكنك المساهمة في الالتزام بالمشروع أو تطوير مكون إضافي. جميع الالتزامات هي موضع ترحيب.

دليل المساهمة

❤️ تبرع

• باتريون
• رعاة جيثب

التبرعات بالعملة المشفرة

عملة	عنوان
بيتكوين	bc1qhvlc762kwuzeawedl9a8z0duhs8449nwwc35e2
إيثريوم/USDT/USDC	0x1D99B2a2D85C34d478dD8519792e82B18f861974
XMR	88qvS4sfUnLZ7nehFrz3PG1pWovvEgprcUhkmVLaiL8PVAFgfHjspjKPLhWLj3DUcm92rwNQENbJ1ZbvESdukWvh3epBUty

ويفضل التبرع بـ USDT أو USDC ولكن يمكنك التبرع بأي من العملات المذكورة أعلاه. ؟

رخصة

حقوق الطبع والنشر (C) 2019، Oğuzhan Eroğlu [email protected] (https://oguzhaneroglu.com/)

رخصة جنو العامة الإصدار 3 (GPL-3)

يجوز لك نسخ البرنامج وتوزيعه وتعديله طالما قمت بتتبع التغييرات/التواريخ في الملفات المصدر. أي تعديلات على البرامج أو البرامج بما في ذلك (عبر المترجم) يجب أيضًا توفير التعليمات البرمجية المرخصة بـ GPL بموجب GPL بالإضافة إلى تعليمات الإنشاء والتثبيت.