GDBFrontend एक आसान, लचीला और विस्तार योग्य GUI डीबगर है।

इंस्टॉल करना

आवश्यकताएं

• GDB => 8.2 (python3 के साथ)
• python3 => 3.6
• tmux

PIP पैकेज (Python Wheel) [अनुशंसित]

आप 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 शेल को इस कमांड से खोल सकते हैं:

tmux a -t gdb-frontend

Arch Linux (AUR)

आप Arch-आधारित वितरणों के लिए Arch Linux पैकेज इंस्टॉल कर सकते हैं। (AUR पैकेज)

yay -S gdb-frontend-bin

और आप इसे चला सकते हैं:

gdbfrontend

Flatpak

Flatpak पैकेज एक TODO है।

डॉकरीकृत C/C++ ऐप्स को GDBFrontend के साथ डीबग करना

इस ट्यूटोरियल का पालन करें ताकि डॉकरीकृत C/C++ ऐप्स को GDBFrontend के साथ डीबग करना सीख सकें।

GDBFrontend के साथ एम्बेडेड डीबगिंग

इस त्वरित ट्यूटोरियल का पालन करें एम्बेडेड उपकरणों को GDBFrontend के साथ डीबग करने के लिए।

GDBFrontend के साथ Python C एक्सटेंशन डीबगिंग

इस त्वरित ट्यूटोरियल का पालन करें नेटिव C Python एक्सटेंशन को GDBFrontend के साथ डीबग करने के लिए।

GDBFrontend प्लगइन्स कैसे विकसित करें?

GDBFrontend में शक्तिशाली और विस्तार योग्य APIs हैं। GDBFrontend प्लगइन्स विकसित करने के लिए इस त्वरित ट्यूटोरियल का पालन करें।

GDBFrontend को अपने Makefile के साथ कैसे एकीकृत करें?

विशेष विकास/डीबगिंग आवश्यकताओं के लिए एकीकरण विचारों के लिए इस त्वरित ट्यूटोरियल का पालन करें।

OpenOCD, GDB और GDBFrontend का उपयोग करके Linux पर STM32 डीबगिंग

OpenOCD और GDBFrontend के साथ STM32 को डीबग करने के लिए इस ट्यूटोरियल का पालन करें।

विशेषताएं

एक्सप्रेशन इवैल्यूएटर

GDBFrontend में एक एक्सप्रेशन इवैल्यूएटर है जिसका उपयोग आप एक ही समय में कई बार कर सकते हैं।

पॉइंटर विज़ुअलाइज़ेशन

लिंक्ड-लिस्ट विज़ुअलाइज़ेशन

सशर्त ब्रेकपॉइंट्स

ब्रेकपॉइंट पर राइट-क्लिक करें ताकि उसकी शर्त सेट कर सकें।

कनेक्टेड एक्सप्रेशन्स

GDBFrontend के VariablesExplorer में सभी वेरिएबल्स, सदस्यों और आइटम्स के एक्सप्रेशन कनेक्टेड होते हैं।

प्रक्रिया प्रबंधक

आप प्रक्रिया प्रबंधक के साथ प्रक्रियाओं को देख, फ़िल्टर या प्रबंधित कर सकते हैं।

ऐरे-ग्राफ विज़ुअलाइज़ेशन

उन्नत सहयोग

GDBFrontend में सहयोग के लिए कुछ विशेषताएं हैं जिन्हें "Enhanced Collabration" नाम दिया गया है।

सहयोग ड्रा

जब आप Enhanced Collabration सक्षम करते हैं तो सहयोग ड्रा उपलब्ध होता है। ड्रा करने के लिए Ctrl + Shift + X शॉर्टकट और सभी ड्रॉइंग साफ़ करने के लिए Ctrl + Shift + C का उपयोग करें।

सिंक किया गया स्रोत दृश्य

Enhanced Collabration के साथ सभी डीबगर क्लाइंट स्रोत दृश्य में सिंक्रनाइज़ होते हैं।

एक्सप्रेशन होवर पॉपअप वेरिएबल एक्सप्लोरर

विस्तार योग्यता

GDBFrontend बहुत विस्तार योग्य है और इसमें शक्तिशाली APIs हैं। 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

स्टार्टअप के तुरंत बाद UI खोलने से बचता है।

--verbose, -V

विस्तृत आउटपुट सक्षम करता है।

GDB कमांड

GDBFrontend के GDB कमांड 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 में बिल्ट-इन थीम हैं।

थीम के बीच स्विच करने के लिए GDB शेल पर gf-theme [THEME] कमांड का उपयोग करें।

(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 API

आप gdbfrontend मॉड्यूल के माध्यम से GDBFrontend के Python API तक पहुँच सकते हैं।

(gdb) python-interactive

>>> dir(gdbfrontend)

उदाहरण के लिए, आप सभी क्लाइंट सॉकेट इस प्रकार प्राप्त कर सकते हैं:

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

या आप सभी प्लगइन्स प्राप्त कर सकते हैं:

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

सत्र साझा करने के साथ सुरक्षा

आप अपने डीबगर सत्र में HTTP प्रमाणीकरण जोड़ने के लिए --credentials=USER:PASS विकल्प का उपयोग कर सकते हैं।

ब्राउज़र संगतता

GDBFrontend मुख्य रूप से Chromium-आधारित ब्राउज़रों पर परीक्षण के साथ विकसित किया जा रहा है। यह विशेष रूप से Firefox जैसे अन्य ब्राउज़रों पर ठीक से काम करेगा, लेकिन यदि आपको अन्य ब्राउज़रों पर कुछ समस्याएं आती हैं, तो आप एक बग-रिपोर्ट भेज सकते हैं।

समस्या निवारण

GDB शेल/मुख्य-थ्रेड को ब्लॉक करना

अधिकांश GDBFrontend फ़ंक्शन थ्रेड-सुरक्षित हैं और GDB के मुख्य-थ्रेड पर काम करते हैं। इसलिए, यदि आप GDB शेल पर कुछ ऐसा चलाते हैं जो ब्लॉकिंग है, तो GDBFrontend फ़ंक्शन को इसके समाप्त होने तक प्रतीक्षा करनी होती है।

जब कोई थ्रेड-सुरक्षित GDBFrontend फ़ंक्शन काम करना चाहता है और आप GDB के मुख्य थ्रेड को ब्लॉक कर रहे हैं, तो आपको यह चेतावनी मिलेगी।

(gdb) shell
$ ...

जब आप शेल से बाहर निकलते हैं, तो ब्लॉकिंग GDBFrontend फ़ंक्शन काम करना जारी रखेंगे।

नोट: कभी-कभी आप GDB शेल में कुछ भी चलाए बिना यह चेतावनी प्राप्त कर सकते हैं, इसका मतलब है कि GDB के इवेंट-लूप में कुछ लंबा समय ले रहा है; इस मामले में इस चेतावनी को अनदेखा करें।

ज़ोंबी प्रक्रियाएं

GDBFrontend अपनी उप-प्रक्रियाओं, आपके एप्लिकेशन और इसकी उप-प्रक्रियाओं को SIGTERM भेजता है। यदि आपका एप्लिकेशन नई प्रक्रियाएं फोर्क कर रहा है और उनके PGIDs सेट कर रहा है, तो GDBFrontend उन्हें बंद नहीं कर सकता है। इस स्थिति में, आपको अपनी प्रक्रियाओं को SIGKILL भेजना चाहिए।

pkill -f gdb

एक्सप्रेशन इवैल्यूएटर प्रदर्शन युक्तियाँ

यदि आप बहुत लंबी गहराई वाले विस्तारित वेरिएबल्स/सदस्यों के साथ ExpressionEvaluator का उपयोग कर रहे हैं, तो पॉइंटर विज़ुअलाइज़ेशन के लिए आपका स्क्रॉल और इवैल्यूएटर विंडो मूव प्रदर्शन खराब हो सकता है। इस स्थिति में, आप उस इवैल्यूएटर विंडो के लिए सिग्नल और स्लॉट पॉइंटिंग बंद कर सकते हैं।

GDB-संबंधित समस्याएं और युक्तियाँ

• GDB डायनामिक लिंक्ड ऑब्जेक्ट के स्रोत तब तक नहीं दे सकता जब तक आप एक बार उस पंक्ति पर कदम नहीं रखते जो डायनामिक लिंक्ड ऑब्जेक्ट से किसी फ़ंक्शन को कॉल करती है। आप एक ब्रेक पॉइंट जोड़ सकते हैं और एक बार कदम रख सकते हैं, फिर सत्र के दौरान आगे डायनामिक लिंक्ड ऑब्जेक्ट से स्रोत देख सकेंगे।

विंडोज

वास्तव में, gdb-frontend विंडोज पर चलने में सक्षम है, लेकिन GDB के विंडोज संस्करण में कुछ गंभीर समस्याएं हैं जो विंडोज पर gdb-frontend के उपयोग को रोकती हैं। बेशक यदि आप विंडोज 10 का उपयोग कर रहे हैं तो आप WSL पर gdb-frontend का उपयोग कर सकते हैं।

विंडोज-GDB के बारे में समस्याएं

• प्रक्रिया चलने के दौरान GDB का मुख्य-थ्रेड ब्लॉक हो जाता है। (gdb-frontend में इसे ठीक करने के लिए एक इंटरप्टिंग तंत्र है लेकिन यह अभी पर्याप्त नहीं है।)
• विंडोज-GDB का प्रॉम्प्ट प्रक्रिया चलने के दौरान ब्लॉक हो जाता है और एप्लिकेशन को बाधित करने में कुछ समस्याएं हैं।

WSL

आप WSL (विंडोज सबसिस्टम फॉर लिनक्स) पर gdb-frontend का उपयोग कर सकते हैं।

WSL के बारे में समस्याएं

• WSL 1 पर, रैंडम पोर्ट विकल्प WSL पर उपयोग योग्य नहीं है क्योंकि /proc/net/tcp इंटरफ़ेस WSL पर काम नहीं करता है। (WSL 2 में यह समस्या नहीं है।)

संस्करणकरण

v0.2.0-beta से, GDBFrontend ने एक नई संस्करणकरण रणनीति अपनाई।

संस्करण पढ़ना

vX.Y.Z-STABILITY में:

• X प्रमुख संस्करण है, प्रमुख सुविधाओं और संवर्द्धन के साथ दीर्घकालिक परिवर्तन।
• Y मुख्य संस्करण है जिसमें नई सुविधाएं और संवर्द्धन शामिल हैं।
• Z मुख्य संस्करणों के बगफिक्स रिलीज़ हैं।
• STABILITY रिलीज़ की स्थिरता का स्तर है। (alpha, beta, rcN, stable)

दस्तावेज़ीकरण

दस्तावेज़ीकरण अभी एक TODO है।

API दस्तावेज़ीकरण

API दस्तावेज़ीकरण अभी एक TODO है।

प्लगइन विकास

आप प्लगइन विकास ट्यूटोरियल पढ़ सकते हैं।

थीम विकास

थीम को प्लगइन के रूप में विकसित किया जाता है।

Discord

Discord समुदाय में शामिल हों।

🎊 योगदान

आप प्रोजेक्ट में कमिट करके या एक प्लगइन विकसित करके योगदान कर सकते हैं। सभी कमिट का स्वागत है।

योगदान गाइड

❤️ दान करें

• Patreon
• GitHub Sponsors

क्रिप्टोकरेंसी दान

अधिमानतः, USDT या USDC दान करने की अनुशंसा की जाती है, लेकिन आप उपरोक्त किसी भी मुद्रा में दान कर सकते हैं। 🥳

लाइसेंस

Copyright (C) 2019, Oğuzhan Eroğlu [email protected] (https://oguzhaneroglu.com/)

GNU General Public License v3 (GPL-3)

आप सॉफ़्टवेयर को कॉपी, वितरित और संशोधित कर सकते हैं जब तक आप स्रोत फ़ाइलों में परिवर्तन/तिथियों को ट्रैक करते हैं। GPL-लाइसेंस प्राप्त कोड के किसी भी संशोधन या सॉफ़्टवेयर (कंपाइलर के माध्यम से) को भी GPL के तहत बिल्ड और इंस्टॉल निर्देशों के साथ उपलब्ध कराया जाना चाहिए।