NAME

       plainbox-dev-crash - crash the application

SYNOPSIS

          plainbox dev crash [-h] (-c | -H)

DESCRIPTION

       Crash the application

       This command is designed to crash or hang the application.

       Using  this  command a developer can inspect the built-in development and debugging features available in
       Plainbox.  Specifically, there are several options available to the top-level plainbox command (they have
       to be used before the dev crash syntax) that allow to enable one of the following actions:

   Jumping Into PDB on Uncaught Exception
       If plainbox is invoked with the --pdb command line option then all uncaught  exceptions  are  handled  by
       starting a debugger session. Using the debugger a developer can inspec the execution stack, including all
       the threads, local and global variables, etc..

   Jumping into PDB on KeyboardInterrupt
       If  plainbox  is  invoked  with  both  the  --pdb  and  the --debug-interrupt command line options then a
       KeyboardInterrupt exception is not ignored, as it usually is, and instead it allowed  to  bubble  up  the
       command line implementation call stack until it starts the interactive debugger session.

OPTIONS

       Optional arguments:

       -c, --crash
              raise an exception

       -H, --hang
              hang the application with a busy loop

EXAMPLES

       A debugger session on exception:

          plainbox --pdb dev crash --crash

       A debugger session on keyboard interrupt:

          plainbox --pdb --debug-interrupt dev crash --hang

SEE ALSO

       plainbox-dev, plainbox, pdb3 (1)

AUTHOR

       Zygmunt Krynicki & Checkbox Contributors

COPYRIGHT

       2012-2014 Canonical Ltd

0.25                                            January 05, 2016                           PLAINBOX-DEV-CRASH(1)