Emulation/pcsx-redux
1
0
Fork 0
mirror of https://github.com/grumpycoders/pcsx-redux.git synced 2025-04-02 10:41:54 -04:00
Code Issues Projects Releases Packages Wiki Activity
pcsx-redux/Debugging/gdb-server/index.html
nicolasnoble 83d754feb9 Deployed c0e8c06e with MkDocs version: 1.4.2
2025-02-15 07:05:50 +00:00

1248 lines
No EOL
35 KiB
HTML
Raw Permalink Blame History

<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link rel="canonical" href="https://pcsx-redux.consoledev.net/Debugging/gdb-server/">
<link rel="prev" href="../introduction/">
<link rel="next" href="../ghidra/">
<link rel="icon" href="../../assets/images/favicon.png">
<meta name="generator" content="mkdocs-1.4.2, mkdocs-material-9.1.4">
<title>GDB server - PCSX-Redux</title>
<link rel="stylesheet" href="../../assets/stylesheets/main.240905d7.min.css">
<link rel="stylesheet" href="../../assets/stylesheets/palette.a0c5b2b5.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<link rel="stylesheet" href="../../css/extra.css">
<script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
</head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
<script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script>
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#gdb-server" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../.." title="PCSX-Redux" class="md-header__button md-logo" aria-label="PCSX-Redux" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
PCSX-Redux
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
GDB server
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 6H7c-3.31 0-6 2.69-6 6s2.69 6 6 6h10c3.31 0 6-2.69 6-6s-2.69-6-6-6zm0 10H7c-2.21 0-4-1.79-4-4s1.79-4 4-4h10c2.21 0 4 1.79 4 4s-1.79 4-4 4zM7 9c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="blue" data-md-color-accent="blue" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_2">
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 7H7a5 5 0 0 0-5 5 5 5 0 0 0 5 5h10a5 5 0 0 0 5-5 5 5 0 0 0-5-5m0 8a3 3 0 0 1-3-3 3 3 0 0 1 3-3 3 3 0 0 1 3 3 3 3 0 0 1-3 3Z"/></svg>
</label>
</form>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
</button>
</nav>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://github.com/grumpycoders/pcsx-redux/" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
</div>
<div class="md-source__repository">
GitHub
</div>
</a>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../.." title="PCSX-Redux" class="md-nav__button md-logo" aria-label="PCSX-Redux" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
</a>
PCSX-Redux
</label>
<div class="md-nav__source">
<a href="https://github.com/grumpycoders/pcsx-redux/" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
</div>
<div class="md-source__repository">
GitHub
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../.." class="md-nav__link">
Home
</a>
</li>
<li class="md-nav__item">
<a href="../../menus/" class="md-nav__link">
PCSX-Redux menus
</a>
</li>
<li class="md-nav__item">
<a href="../../compiling/" class="md-nav__link">
Compiling PCSX-Redux
</a>
</li>
<li class="md-nav__item">
<a href="../../cli_flags/" class="md-nav__link">
Command Line Flags
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
Debugging
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_5">
<span class="md-nav__icon md-icon"></span>
Debugging
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../introduction/" class="md-nav__link">
Debugging with PCSX-Redux
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
GDB server
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
GDB server
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#enabling-the-gdb-server" class="md-nav__link">
Enabling the GDB server
</a>
</li>
<li class="md-nav__item">
<a href="#gdb-setup" class="md-nav__link">
GDB setup
</a>
<nav class="md-nav" aria-label="GDB setup">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#windows" class="md-nav__link">
Windows
</a>
</li>
<li class="md-nav__item">
<a href="#gnulinux" class="md-nav__link">
GNU/Linux
</a>
<nav class="md-nav" aria-label="GNU/Linux">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#debian-based" class="md-nav__link">
Debian based
</a>
</li>
<li class="md-nav__item">
<a href="#arch-based" class="md-nav__link">
Arch based
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#ide-setup" class="md-nav__link">
IDE setup
</a>
<nav class="md-nav" aria-label="IDE setup">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#ms-vscode" class="md-nav__link">
MS VScode
</a>
<nav class="md-nav" aria-label="MS VScode">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#executable" class="md-nav__link">
executable
</a>
</li>
<li class="md-nav__item">
<a href="#gdbpath" class="md-nav__link">
gdbpath
</a>
</li>
<li class="md-nav__item">
<a href="#autorun" class="md-nav__link">
autorun
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#geany" class="md-nav__link">
Geany
</a>
<nav class="md-nav" aria-label="Geany">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#gdbinit" class="md-nav__link">
.gdbinit
</a>
</li>
<li class="md-nav__item">
<a href="#plugin-configuration" class="md-nav__link">
Plugin configuration
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#clion" class="md-nav__link">
CLion
</a>
<nav class="md-nav" aria-label="CLion">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#gdbinit_1" class="md-nav__link">
.gdbinit
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#beginning-debugging" class="md-nav__link">
Beginning Debugging
</a>
<nav class="md-nav" aria-label="Beginning Debugging">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#starting-debugging-in-geany" class="md-nav__link">
Starting debugging in Geany
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#additional-tools" class="md-nav__link">
Additional tools
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../ghidra/" class="md-nav__link">
Connecting Ghidra to PCSX-Redux
</a>
</li>
<li class="md-nav__item">
<a href="../misc-features/" class="md-nav__link">
Misc Features
</a>
</li>
<li class="md-nav__item">
<a href="../vram-viewer/" class="md-nav__link">
VRAM viewer
</a>
</li>
<li class="md-nav__item">
<a href="../gpu-logger/" class="md-nav__link">
GPU Logger
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../../mips_api/" class="md-nav__link">
Mips API
</a>
</li>
<li class="md-nav__item">
<a href="../../web_server/" class="md-nav__link">
Web server
</a>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
<label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">
Lua
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_8">
<span class="md-nav__icon md-icon"></span>
Lua
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../Lua/introduction/" class="md-nav__link">
Introduction
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/libraries/" class="md-nav__link">
Loaded libraries
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/redux-basics/" class="md-nav__link">
Redux basic API
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/rendering/" class="md-nav__link">
Rendering
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/file-api/" class="md-nav__link">
File API
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/web-server/" class="md-nav__link">
Webserver Lua API
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/memory-and-registers/" class="md-nav__link">
Memory and registers
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/events/" class="md-nav__link">
Events
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/breakpoints/" class="md-nav__link">
Breakpoints
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/assembler/" class="md-nav__link">
Inline assembler
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/binary/" class="md-nav__link">
Handling of PSX binaries
</a>
</li>
<li class="md-nav__item">
<a href="../../Lua/case-studies/" class="md-nav__link">
Case studies
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../../openbios/" class="md-nav__link">
Openbios
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#enabling-the-gdb-server" class="md-nav__link">
Enabling the GDB server
</a>
</li>
<li class="md-nav__item">
<a href="#gdb-setup" class="md-nav__link">
GDB setup
</a>
<nav class="md-nav" aria-label="GDB setup">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#windows" class="md-nav__link">
Windows
</a>
</li>
<li class="md-nav__item">
<a href="#gnulinux" class="md-nav__link">
GNU/Linux
</a>
<nav class="md-nav" aria-label="GNU/Linux">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#debian-based" class="md-nav__link">
Debian based
</a>
</li>
<li class="md-nav__item">
<a href="#arch-based" class="md-nav__link">
Arch based
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#ide-setup" class="md-nav__link">
IDE setup
</a>
<nav class="md-nav" aria-label="IDE setup">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#ms-vscode" class="md-nav__link">
MS VScode
</a>
<nav class="md-nav" aria-label="MS VScode">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#executable" class="md-nav__link">
executable
</a>
</li>
<li class="md-nav__item">
<a href="#gdbpath" class="md-nav__link">
gdbpath
</a>
</li>
<li class="md-nav__item">
<a href="#autorun" class="md-nav__link">
autorun
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#geany" class="md-nav__link">
Geany
</a>
<nav class="md-nav" aria-label="Geany">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#gdbinit" class="md-nav__link">
.gdbinit
</a>
</li>
<li class="md-nav__item">
<a href="#plugin-configuration" class="md-nav__link">
Plugin configuration
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#clion" class="md-nav__link">
CLion
</a>
<nav class="md-nav" aria-label="CLion">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#gdbinit_1" class="md-nav__link">
.gdbinit
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#beginning-debugging" class="md-nav__link">
Beginning Debugging
</a>
<nav class="md-nav" aria-label="Beginning Debugging">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#starting-debugging-in-geany" class="md-nav__link">
Starting debugging in Geany
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#additional-tools" class="md-nav__link">
Additional tools
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<h1 id="gdb-server">GDB server</h1>
<p>The GDB server allows you to set breakpoints and control your PSX program's execution from your gdb compatible IDE.</p>
<h2 id="enabling-the-gdb-server">Enabling the GDB server</h2>
<p><img alt="Enable gdb server" src="../images/gdb-server-enable.png" /> </p>
<p>In PCSX-Redux: <code>Configuration &gt; Emulation &gt; Enable GDB server</code>. </p>
<p>Make sure the debugger is also enabled. </p>
<p><img alt="enable debugger/gdb" src="../images/pcsx_enable_debugger.png" /> </p>
<h2 id="gdb-setup">GDB setup</h2>
<p>You need <code>gdb-multiarch</code> on your system :</p>
<h3 id="windows">Windows</h3>
<p>Download a pre-compiled version from here : <a href="https://static.grumpycoder.net/pixel/gdb-multiarch-windows/">https://static.grumpycoder.net/pixel/gdb-multiarch-windows/</a></p>
<h3 id="gnulinux">GNU/Linux</h3>
<h4 id="debian-based">Debian based</h4>
<p>Install via your package manager :</p>
<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="c1"># Debian derivative; Ubuntu, Mint...</span>
sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>gdb-multiarch
</code></pre></div></td></tr></table></div>
<h4 id="arch-based">Arch based</h4>
<p>On Arch based distributions, multiarch is now <a href="https://gitlab.archlinux.org/archlinux/packaging/packages/gdb/-/blob/main/PKGBUILD?ref_type=heads#L50">enabled by default</a> in regular builds and you don't need to install a specific version anymore.<br />
You can install the 'gdb' package with <code>pacman</code> :<br />
<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>sudo pacman -S gdb
</code></pre></div></td></tr></table></div></p>
<h2 id="ide-setup">IDE setup</h2>
<h3 id="ms-vscode">MS VScode</h3>
<ul>
<li>Install the <code>Native debug</code> extension :<br />
<a href="https://marketplace.visualstudio.com/items?itemName=webfreak.debug">https://marketplace.visualstudio.com/items?itemName=webfreak.debug</a></li>
</ul>
<p><img alt="VScode native debg extension" src="../images/vscode_native_debug.png" /> </p>
<ul>
<li>Adapt your <code>launch.json</code> file to your environment :<br />
A sample <code>lanuch.json</code> file is available <a href="https://github.com/grumpycoders/pcsx-redux/blob/main/.vscode/launch.json">here</a>.<br />
This should go in <code>your-project/.vscode/</code>. </li>
</ul>
<p>You need to adapt the values of <code>"executable"</code>, <code>"gdbpath"</code> and <code>"autorun"</code> according to your system :</p>
<h4 id="executable">executable</h4>
<p>This is the path to your <code>.elf</code> executable :<br />
<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="w"> </span><span class="nt">&quot;executable&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;HelloWorld.elf&quot;</span><span class="p">,</span>
</code></pre></div></td></tr></table></div>
<a href="https://github.com/grumpycoders/pcsx-redux/blob/a3bebd490388130e924124cdfeff3bc46b6149d9/.vscode/launch.json#L153">https://github.com/grumpycoders/pcsx-redux/blob/a3bebd490388130e924124cdfeff3bc46b6149d9/.vscode/launch.json#L153</a> </p>
<h4 id="gdbpath">gdbpath</h4>
<p>This the path to the <code>gdb-multiarch</code> executable:<br />
<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="w"> </span><span class="nt">&quot;gdbpath&quot;</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;/usr/bin/gdb-multiarch&quot;</span><span class="p">,</span>
</code></pre></div></td></tr></table></div>
<a href="https://github.com/grumpycoders/pcsx-redux/blob/a3bebd490388130e924124cdfeff3bc46b6149d9/.vscode/launch.json#L154-L157">https://github.com/grumpycoders/pcsx-redux/blob/a3bebd490388130e924124cdfeff3bc46b6149d9/.vscode/launch.json#L154-L157</a></p>
<h4 id="autorun">autorun</h4>
<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="w"> </span><span class="nt">&quot;autorun&quot;</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
<span class="w"> </span><span class="s2">&quot;monitor reset shellhalt&quot;</span><span class="p">,</span>
<span class="w"> </span><span class="p">[</span><span class="err">...</span><span class="p">]</span>
<span class="w"> </span><span class="s2">&quot;load your-file.elf&quot;</span><span class="p">,</span>
</code></pre></div></td></tr></table></div>
<p>Make sure that <code>"load your-file.elf"</code> corresponds to the <code>"target"</code> value. </p>
<p><a href="https://github.com/grumpycoders/pcsx-redux/blob/a3bebd490388130e924124cdfeff3bc46b6149d9/.vscode/launch.json#L159-L165">https://github.com/grumpycoders/pcsx-redux/blob/a3bebd490388130e924124cdfeff3bc46b6149d9/.vscode/launch.json#L159-L165</a></p>
<p>By default, using <code>localhost</code> should work, but if encountering trouble, try using your computer's local IP (e.g; 192.168.x.x, 10.0.x.x, etc.)</p>
<p><a href="https://github.com/grumpycoders/pcsx-redux/blob/a3bebd490388130e924124cdfeff3bc46b6149d9/.vscode/launch.json#L150">https://github.com/grumpycoders/pcsx-redux/blob/a3bebd490388130e924124cdfeff3bc46b6149d9/.vscode/launch.json#L150</a></p>
<p><img alt="gdb debugging" src="../images/pcsx-gdb-debug.png" /></p>
<h3 id="geany">Geany</h3>
<p>Make sure you installed the <a href="https://www.geany.org/download/releases/#geany-plugins-releases">official plugins</a> and enable the <code>Scope debugger</code>.</p>
<p>To enable the plugin, open Geany, go to <code>Tools &gt; Plugin manager</code> and enable <code>Scope Debugger</code>.</p>
<p>You can find the debugging facilities in the <code>Debug</code> menu ;</p>
<p><img alt="geany program setup" src="../images/geany-gdb-scope-menu.png" /></p>
<p>You can find the plugin's documentation here : <a href="https://plugins.geany.org/scope.html">https://plugins.geany.org/scope.html</a></p>
<h4 id="gdbinit">.gdbinit</h4>
<p>Create a <code>.gdbinit</code> file at the root of your project with the following content, adapting the path to your <code>elf</code> file and the gdb server's ip.</p>
<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span><code>target remote localhost:3333
symbol-file load /path/to/your/executable.elf
monitor reset shellhalt
load /path/to/your/executable.elf
</code></pre></div></td></tr></table></div>
<h4 id="plugin-configuration">Plugin configuration</h4>
<p>In Geany : <code>Debug &gt; Setup Program</code> : </p>
<p><img alt="geany program setup" src="../images/geany-gdb-scope-options.png" /></p>
<h3 id="clion">CLion</h3>
<p>Open the Run/Debug Configurations menu, which you can find here:</p>
<p><img alt="run/debug configurations menu" src="../images/clion-edit-configurations.png" /></p>
<p>Then, add a new Remote Debug configuration:</p>
<p><img alt="add new remote debug" src="../images/clion-add-new-configuration.png" /></p>
<p>Finally, set your new configuration up:</p>
<p><img alt="config set up" src="../images/clion-remote-debug-setup.png" /></p>
<h4 id="gdbinit_1">.gdbinit</h4>
<p>Create a <code>.gdbinit</code> file at the root of your project with the following content, adapting the path to your <code>elf</code> file.</p>
<div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span></pre></div></td><td class="code"><div><pre><span></span><code>define target remote
target extended-remote $arg0
symbol-file /path/to/your/executable.elf
monitor reset shellhalt
load /path/to/your/executable.elf
end
</code></pre></div></td></tr></table></div>
<h2 id="beginning-debugging">Beginning Debugging</h2>
<p>Launch <code>pcsx-redux</code>, then run the debugger from your IDE. It should load the <code>elf</code> file, and execute until the next breakpoint.</p>
<h3 id="starting-debugging-in-geany">Starting debugging in Geany</h3>
<video width="640" height="360" controls>
<source src="https://archive.org/download/pcsx_redux_geany_gdb/pcsx_redux_geany_gdb.webm" type="video/webm">
Your browser does not support the video tag.
</video>
<p>Source :<br />
<a href="https://archive.org/details/pcsx_redux_geany_gdb">https://archive.org/details/pcsx_redux_geany_gdb</a></p>
<h2 id="additional-tools">Additional tools</h2>
<p><a href="https://github.com/cyrus-and/gdb-dashboard/">https://github.com/cyrus-and/gdb-dashboard/</a></p>
</article>
</div>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": "../..", "features": [], "search": "../../assets/javascripts/workers/search.208ed371.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../assets/javascripts/bundle.19047be9.min.js"></script>
</body>
</html>
Reference in a new issue View git blame Copy permalink