Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
96 changes: 96 additions & 0 deletions gdb.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
project_summary:
category: "tools"
home_text: "_There are multiple homes for this project, see the [Get Involved](#get-involved) section._"
short_description: "CHERI-enabled fork of GDB"
description: |-
"[GNU Debuger](https://www.sourceware.org/gdb/) is a portable debug utility that can run/attach to other processes and inspect how these processes (and their children) are accessing the system memory and how the code ends up in and interacts with hardware registers.

It can also have control over the program counter and therefore the code execution and stop the debugged process execution at any point given some set of initial conditions. GDB also allows to override variables and registers on the fly to see what WOULD happen if say a different branches of the child process were to be executed, which can be useful.

So the tool can understand assembly and higher level languages and in general is very good for tracing application execution in real time."

status: |-
"There are three repositories for GDB, each historically adding support for different architectures, the first development work was done for the University of Cambridge RISC-V architecture (currently at ISAv9) at [https://github.com/CTSRD-CHERI/gdb](https://github.com/CTSRD-CHERI/gdb) and is currently at version 14.1 of GDB.
However, this repository also has Morello branches, with latest versioned at 14.1, these replaced the initial and canonical GBD Morello from ARM which is now very old (version 11.0.5).

The GDB for Morello at [https://git.morello-project.org/morello/binutils-gdb](https://git.morello-project.org/morello/binutils-gdb) did their own thing and actually lives in a vendor branch [upstream](https://sourceware.org/git/?p=binutils-gdb.git;a=shortlog;h=refs/heads/users/ARM/morello-binutils-gdb-master) and as already mentioned is at version 11.0.5.

The GDB hosted at the Cherry Aliance repository [https://github.com/CHERI-Alliance/gdb](https://github.com/CHERI-Alliance/gdb) is really a fork off the UoC repository from [Novermber 2024](https://github.com/CHERI-Alliance/gdb/commit/7c05fb82db7ddd8e009548b8e853657c3512029f) and Codasip has added support for the RISC-V RVY architecture on top of the previous work at UoC, it is also at version 14.1"


vulnerability_contact: "support@thecapablehub.org"
download_notes: "There are no pre-built binaries or versioned releases, users must build from source."
last_update: "30th January 2026"

project_contribution:
src_tree: |-
- [CHERI-Alliance/gdb](https://github.com/CHERI-Alliance/gdb) - 14.1
- [CTSRD-CHERI/gdb](https://github.com/CTSRD-CHERI/gdb) - 14.1
- [Morello](https://git.morello-project.org/morello/binutils-gdb) - 11.0.5
chat: |-
There are is a dedicated Slack channel at the [CHERI CPU Slack](https://www.cl.cam.ac.uk/research/security/ctsrd/cheri/cheri-slack.html) in the `#debuggers` channel.
mailing_lists: |-
There are no mailing lists associated with this project.
meetings: |-
There are no regular meetings associated with this project.

buildingFromSource: "Please keep an eye out for our [blog](/blog/) as we will soon share instructions for building from source."

software:

- arch: "riscv64c"
releases:
- version: "df929d4 (codasip-cheri-riscv)"
version_date: 2025-18-02
version_url: "https://github.com/CHERI-Alliance/gdb/tree/codasip-cheri-riscv"
latest: true
cheri_spec: CHERI RISC-V RVY
upstream_version: "v14.1"
upstream_date: 2023-12-03
upstream_url: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"
images:
- label: "Source"
link: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"

- arch: "riscv64c"
releases:
- version: "a686ecf (cheri-14)"
version_date: 2025-11-05
version_url: "https://github.com/CTSRD-CHERI/gdb"
latest: true
cheri_spec: CHERI RISC-V ISAv9
upstream_version: "v14.1"
upstream_date: 2023-12-03
upstream_url: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"
images:
- label: "Source"
link: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"

- arch: "aarch64c"
releases:
- version: "f1d9c89 (morello-binutils-gdb-14)"
version_date: 2024-17-01
version_url: "https://github.com/CTSRD-CHERI/gdb"
latest: true
cheri_spec: Morello
upstream_version: "v14.1"
upstream_date: 2023-12-03
upstream_url: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"
images:
- label: "Source"
link: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=6bda1c19bcd16eff8488facb8a67d52a436f70e7"


- arch: "aarch64c"
releases:
- version: "70d0d9f0 (morello-binutils-gdb-master)"
version_date: 2023-12-06
version_url: "https://git.morello-project.org/morello/binutils-gdb"
latest: true
cheri_spec: Morello
upstream_version: "v11.0.5"
upstream_date: 2020-10-20
upstream_url: "https://sourceware.org/git/?p=binutils-gdb.git;a=commit;h=ae86f581c2ac33fc289eb4ac62c0539a7e9c6793"
images:
- label: "Source"
link: "https://github.com/CHERI-Alliance/qemu"