You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
pwndbg/docs/commands/misc/cymbol.md

44 lines
1.5 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<!-- THIS PART OF THIS FILE IS AUTOGENERATED. DO NOT MODIFY IT. See scripts/generate-docs.sh -->
# cymbol
<small style="color: lightgray;">(only in GDB)</small>
```text
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|
### 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. Its 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`
<!-- END OF AUTOGENERATED PART. Do not modify this line or the line below, they mark the end of the auto-generated part of the file. If you want to extend the documentation in a way which cannot easily be done by adding to the command help description, write below the following line. -->
<!-- ------------\>8---- ----\>8---- ----\>8------------ -->