> For the complete documentation index, see [llms.txt](https://docs.hex-rays.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hex-rays.com/core/debugger/concepts/remote-debugging/remote-gdb-debugger/debugging-with-gdbserver.md).

# Debugging with gdbserver

gdbserver is a GDB stub implemented as a separate program. It runs a program to be debugged or attaches to a process and then waits for commands. The remote GDB debugger module has been tested with gdbserver available with Cygwin and Linux.

To debug a specific program from the start, run the following command:

```
    gdbserver localhost:23946 <program>
```

and then choose Debugger → Attach → \<process running on target> in IDA.

To debug a running process:

```
    gdbserver --multi localhost:23947
```

then choose Debugger → Attach → \<enter PID to attach> in IDA and enter the PID of the process to attach to.

Another method of debugging a running process is:

```
    gdbserver localhost:23947 --attach <PID>
```

then choose Debugger → Attach → \<process running on target> in IDA.

To start a program from inside IDA, first launch the debugger server:

```
    gdbserver --multi localhost:23947
```

Then use Debugger → Start process or Debugger → Run in IDA.

{% hint style="info" %}
The `--multi` option is only available in GDB 6.8 or higher.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hex-rays.com/core/debugger/concepts/remote-debugging/remote-gdb-debugger/debugging-with-gdbserver.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.