Introduction
WinGDB is an extension of the Visual Studio Debugger. It allows you to debug:
- remote Unix programs
- local Windows (MinGW or Cygwin) applications
- embedded or mobile Linux applications
- embedded devices through JTAG/OCD interface
- Palm webOS applications
directly from Visual Studio using the GNU debugger (GDB) as a backend.
To achieve this goal, WinGDB performs the following actions:
- It establishes a connection to the remote host (if needed).
- It starts and controls GDB (attach, launch and examine core scenarios are supported).
- It provides a convenient user interface based on Visual Studio Debugger, including: source code view inside Visual Studio,
code stepping, breakpoints, locals, autos, watch, modules, disassembly, I/O console. Most standard Visual Studio Debugger
features are supported.
- It offers additional features that make applying fixes to the code easier. Direct creating/editing of remote files
is an example.
WinGDB is designed to be as easy and convenient as possible. If you are familiar with Visual Studio Debugger,
you won't need much additional learning. Most features work exactly the same way. However, there are some
platform-related differences and additional concepts specific to Unix operating systems (e.g. signal handling).
This manual contains sections explaining such subjects.
For quick start, please read the followng sections.
Requirements and installation
Describes the requirements that both your local system (Windows-based) and remote system (Unix-based) should meet.
Describes the installation process.
Explains how to handle with license and register product.
Release notes of all published versions.
Describes the limitations of demo version.
Basic configuration and usage
Explains how to store WinGDB settings in Visual C++ projects and solutions.
Explains general development options that should be configured first.
Explains how to use WinGDB to develop and debug applications remotely on desktop/server Linux machines.
Explains how to use WinGDB to develop and debug applications indirectly (with gdbserver) on desktop/server Linux machines.
Explains how to use WinGDB to develop and debug Windows applications using MinGW or Cygwin tools.
Explains how to use WinGDB to develop and debug embedded or mobile Linux applications.
Explains how to use WinGDB to develop and debug embedded "bare metal" devices using OpenOCD.
Explains how to use WinGDB to develop and debug native applications for Palm webOS mobile devices.
Reference
Explains how to attach to a process on remote host and start debugging.
Explains how to launch a process on remote host (or local host when using Cygwin/MinGW) and start debugging.
Explains how to launch a X11 process on remote host with a connection to local X-server.
Explains how to examine a core dump on remote host.
Explains how to map source directories between different locations/hosts.
Explains how to run build on remote machine.
Explains how to use complex data type visualizers (e.g. for STL containers).
WinGDB also allows to use the Visual Studio editor to edit remote source files. This section explains
how to use this feature.
Explains how to configure WinGDB for Cygwin support.
Describes configuration options for WinGDB.
Explains how to write custom scripts.
Visual Studio tips
Describes how to configure your project to be able to use IntelliSense.
Copyright (C) 2008-2010 WinGDB.com. All rights reserved.