cymbol
(only in GDB)
usage: cymbol [-h] {add,remove,edit,load,show,file,show-all} ...
Manage custom C structures in pwndbg. Supports project-specific auto-loading from .gdbinit.
Positional arguments
| Positional Argument | Help |
| subcommand | Available subcommands |
Optional arguments
| Short | Long | Help |
| -h | --help | show this help message and exit |
cymbol add
usage: cymbol add [-h] [--force] name
Add a custom structure.
Positional arguments
| Positional Argument | Help |
| name | Name of custom structure |
Optional arguments
| Short | Long | Help |
| -h | --help | show this help message and exit |
| --force | Overwrite if structure already exists |
cymbol remove
usage: cymbol remove [-h] name
Remove a custom structure.
Positional arguments
| Positional Argument | Help |
| name | Name of custom structure |
Optional arguments
| Short | Long | Help |
| -h | --help | show this help message and exit |
cymbol edit
usage: cymbol edit [-h] name
Edit a custom structure.
Positional arguments
| Positional Argument | Help |
| name | Name of custom structure |
Optional arguments
| Short | Long | Help |
| -h | --help | show this help message and exit |
cymbol load
usage: cymbol load [-h] name
Load a custom structure.
Positional arguments
| Positional Argument | Help |
| name | Name of custom structure |
Optional arguments
| Short | Long | Help |
| -h | --help | show this help message and exit |
cymbol show
usage: cymbol show [-h] name
Show a custom structure.
Positional arguments
| Positional Argument | Help |
| name | Name of custom structure |
Optional arguments
| Short | Long | Help |
| -h | --help | show this help message and exit |
cymbol file
usage: cymbol file [-h] [--name NAME] [--force] path
Add a structure from a header file.
Positional arguments
| Positional Argument | Help |
| path | Path to header file |
Optional arguments
| Short | Long | Help |
| -h | --help | show this help message and exit |
| --name | Optional structure name |
| --force | Overwrite if exists |
cymbol show-all
usage: cymbol show-all [-h]
Show all stored structures.
Optional arguments
| Short | Long | Help |
| -h | --help | show this help message and exit |
Notes
The cymbol command loads custom C structs and symbols into the debugger using GCC under the hood.
Usage Example: cymbol file --force ./structs.h
--force: Use this flag to force symbol reloading, even if symbols with the same name already exist.
Warning: If a loaded structure defines a symbol that already exists, the debugger may prefer the original symbol or behave unexpectedly. It’s recommended to use unique struct names to avoid symbol conflicts.
Tip: You can add this command to your .gdbinit file for automatic loading: cymbol file --force ./path/to/structs.h