# libgdbs

*libgdbs* is a library providing smalltalk interface for GDB.

## Features

 * event-based interface

 * convenient API to inspect and query current state of a debugee

 * support for custom disassembler allowing for custom code analysis

## Building from Source

*libgsbs* is a part of [Smalltalk/X jv-branch][3] since version 8.0.0. To

build *libgsbs*, just follow instructions how to [build

Smalltalk/X jv-branch][6]

## Prerequisites

As of today, *libgdbs* requires a very recent GDB. Likely you'd need to

compile a GDB yourself - see [GDB.md][9]

## Documentation

Some documentation can be found in [doc][10] directory, see [doc/README.md][10]

## Reporting issues

Use [Smalltalk/X jv-branch issue tracker][6] to [report issues][7] (you may need

to login using your Google account in order to submit an issue). Alternatively,

send a message to [Smalltalk/X mailing list][8].

## Author

Jan Vrany `<jan.vrany [at] fit.cvut.cz>`

## License

This software is licensed under *GNU LESSER GENERAL PUBLIC LICENSE Version 2.1*.

You may find a full license text in `LICENSE.txt`.

For permissions beyond the scope of this license please contact author at

`<jan.vrany [at] fit.cvut.cz>`

[2]: https://www.gnu.org/software/gdb/

[3]: https://swing.fit.cvut.cz/projects/stx-jv

[4]: https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git

[5]: https://swing.fit.cvut.cz/jenkins/job/stx_jv/lastSuccessfulBuild/

[6]: https://swing.fit.cvut.cz/projects/stx-jv/report/9

[7]: https://swing.fit.cvut.cz/projects/stx-jv/newticket

[8]: https://groups.google.com/forum/#!forum/stx-jv

[9]: doc/GDB.md

[10]: doc/README.md