Skip to main content

System process debug and analysis library.

Project description

Pointbreak

Pointbreak lets you write python programs that debug or analysis other programs. It works like a debugger but because it's a Python library you can extend and interact with it very easily.

Pointbreak is designed to make debugging and analysing complex things like JITs simpler without having to added lots of debugging code to the target.

General Advantages

  • Breakpoints are any Python callable
  • Simple API
  • Can be used from a Python REPL like IPython
  • Can be easily embedded in other things e.g. a Flask app
  • Easy to add support for custom symbols and JIT generated code
  • Simpler and less restrictive than GDB Python API

Disadvantage

Example print BOO! when function is called

If you compile gcc ghost.c -o ghost and run ./ghost nothing much happens But if we run python boo_ghost.py it prints

Boo!
Boo!
Boo!
Boo!
Boo!
Boo!
Boo!
Boo!
Boo!

because our python function is getting called each time there_is_a_ghost is called. There are more examples in the examples directory.

ghost.c

/* I'm a silly program that does nothing much on its own. */
/* Compile me with "gcc ghost.c -o ghost".                */

void there_is_a_ghost(void) {
    return;
}

int main(int argc, char *argv[]) {
    int i;
    for (i = 0; i < 10; i++) {
        there_is_a_ghost();
    }
    return 0;
}

boo_ghost.py

from __future__ import print_function
import pointbreak

def print_boo(debugger):
    print("Boo!")
    return True

db = pointbreak.create_debugger('ghost')
db.add_breakpoint('there_is_a_ghost', print_boo)
db.continue_to_last_event()

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pointbreak-0.0.2.tar.gz (8.3 kB view details)

Uploaded Source

File details

Details for the file pointbreak-0.0.2.tar.gz.

File metadata

  • Download URL: pointbreak-0.0.2.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pointbreak-0.0.2.tar.gz
Algorithm Hash digest
SHA256 db985dfa5656965ddf056b103d8f4da604bb31deda05592cb1676338bb68e328
MD5 c703afc7a9c0ed7b4b1221af739781c0
BLAKE2b-256 546ec5665432dc6594685e83a980521773a9fb87b8733667aa6438d13c6011b4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page