README.md
author Jan Vrany <jan.vrany@fit.cvut.cz>
Mon, 18 Feb 2019 10:49:02 +0000
changeset 176 e734c17e7c37
parent 161 4e020e46a29c
child 216 800057dbad30
permissions -rw-r--r--
Use `View >> pushEvent:` or `ApplicationModel >> enqueueMessage:` to post events ...rather than asking for a window sensor and then talking to it. This allows for more flexibility as the object (subscription receiver) can decide how to handle posting of events.

# 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