.\" Man page generated from reStructuredText. . .TH "PLAINBOX-DEV-CRASH" "1" "January 05, 2016" "0.25" "Plainbox" .SH NAME plainbox-dev-crash \- crash the application . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .SH SYNOPSIS .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C plainbox dev crash [\-h] (\-c | \-H) .ft P .fi .UNINDENT .UNINDENT .SH DESCRIPTION .sp Crash the application .sp This command is designed to crash or hang the application. .sp 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 \fIhave to\fP be used before the \fBdev crash\fP syntax) that allow to enable one of the following actions: .SS Jumping Into PDB on Uncaught Exception .sp If \fBplainbox\fP is invoked with the \fB\-\-pdb\fP 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.. .SS Jumping into PDB on KeyboardInterrupt .sp If \fBplainbox\fP is invoked with both the \fB\-\-pdb\fP and the \fB\-\-debug\-interrupt\fP command line options then a \fBKeyboardInterrupt\fP 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. .SH OPTIONS .sp \fBOptional arguments:\fP .PP .INDENT 0.0 .TP .B \-c\fP,\fB \-\-crash raise an exception .TP .B \-H\fP,\fB \-\-hang hang the application with a busy loop .UNINDENT .SH EXAMPLES .sp A debugger session on exception: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C plainbox \-\-pdb dev crash \-\-crash .ft P .fi .UNINDENT .UNINDENT .sp A debugger session on keyboard interrupt: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C plainbox \-\-pdb \-\-debug\-interrupt dev crash \-\-hang .ft P .fi .UNINDENT .UNINDENT .SH SEE ALSO .sp \fBplainbox\-dev\fP, \fBplainbox\fP, \fBpdb3\fP (1) .SH AUTHOR Zygmunt Krynicki & Checkbox Contributors .SH COPYRIGHT 2012-2014 Canonical Ltd .\" Generated by docutils manpage writer. .