https://github.com/lethalbit/libfortress
A library for reading DWARF, STABS, and other debugging formats.
https://github.com/lethalbit/libfortress
debug-formats dwarf pdb stabs vax
Last synced: about 1 month ago
JSON representation
A library for reading DWARF, STABS, and other debugging formats.
- Host: GitHub
- URL: https://github.com/lethalbit/libfortress
- Owner: lethalbit
- License: bsd-3-clause
- Created: 2018-05-20T19:17:39.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2022-06-26T00:37:46.000Z (almost 3 years ago)
- Last Synced: 2024-05-01T18:58:56.149Z (about 1 year ago)
- Topics: debug-formats, dwarf, pdb, stabs, vax
- Language: C++
- Homepage:
- Size: 55.7 KB
- Stars: 11
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# libfortress
libfortress is a C++ library designed to facilitate with the parsing and generation of various debug info formats.
The sister library for parsing and generating object file formats can be found at [lethalbit/libalfheim](https://github.com/lethalbit/libalfheim).
## Configuring and Building
The following steps describe how to build libfortress, it should be consistent for both Linux and Windows, but Windows remains untested.
### Prerequisites
To build libfortress, ensure you have the following build time dependencies:
* git
* meson
* ninja
* zlib >=1.2.12
* g++ >= 11 or clang++ >= 11
Optionally, when also building with binding support (which is the default) you also need:
* python >= 3.9
* pybind11 >= 2.7.0
### Configuring
You can build libfortress with the default options, all of which can be found in [`meson_options.txt`](meson_options.txt). You can change these by specifying `-D=` at initial meson invocation time, or with `meson configure` in the build directory post initial configure.
To change the install prefix, which is `/usr/local` by default ensure to pass `--prefix ` when running meson for the first time.
In either case, simply running `meson build` from the root of the repository will be sufficient and place all of the build files in the `build` subdirectory.
### Building
Once you have configured libfortress appropriately, to simply build and install simply run the following:
```
$ ninja -C build
$ ninja -C build install
```
This will build and install libfortress into the default prefix which is `/usr/local`, to change that see the configuration steps above.
### Notes to Package Maintainers
If you are building libfortress for inclusion in a distributions package system then ensure to set `DESTDIR` prior to running meson install.
There is also a `bugreport_url` configuration option that is set to this repositories issues tracker by default, it is recommended to change it to your distributions bug tracking page.
## License
libfortress is licensed under the [BSD-3-Clause](https://spdx.org/licenses/BSD-3-Clause.html) and can be found in [LICENSE](https://github.com/lethalbit/libfortress/tree/main/LICENSE).