PHPDBG_HELP(exec) /* {{{ */
{
phpdbg_help_header();
- phpdbg_writeln("Will attempt execution, if compilation has not yet taken place, it occurs now");
+ phpdbg_writeln("\tWill attempt execution, if compilation has not yet taken place, it occurs now");
phpdbg_writeln("The execution context must be set before execution can take place");
phpdbg_help_footer();
return SUCCESS;
phpdbg_help_header();
phpdbg_writeln("You can enable and disable stepping at any phpdbg prompt during execution");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%sstepping 1", PROMPT);
phpdbg_writeln("\t%ss 1", PROMPT);
- phpdbg_writeln("Will enable stepping");
+ phpdbg_writeln("\tWill enable stepping");
phpdbg_writeln(EMPTY);
phpdbg_writeln("While stepping is enabled you are presented with a prompt after the execution of each opcode");
phpdbg_help_footer();
phpdbg_help_header();
phpdbg_write("Step back into the vm and execute the next opcode");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%snext", PROMPT);
phpdbg_writeln("\t%sn", PROMPT);
- phpdbg_writeln("Will cause control to be passed back to the vm, continuing execution");
+ phpdbg_writeln("\tWill cause control to be passed back to the vm, continuing execution");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: is only useful while executing");
phpdbg_help_footer();
phpdbg_help_header();
phpdbg_writeln("Step back into the vm, skipping breakpoints until the next source line");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%suntil", PROMPT);
phpdbg_writeln("\t%su", PROMPT);
- phpdbg_writeln("Will cause control to be passed back to the vm, continuing execution");
+ phpdbg_writeln("\tWill cause control to be passed back to the vm, continuing execution");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: is only useful while executing");
phpdbg_help_footer();
phpdbg_help_header();
phpdbg_writeln("Step back into the vm, skipping breakpoints until past the end of the current stack");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%sfinish", PROMPT);
phpdbg_writeln("\t%sf", PROMPT);
- phpdbg_writeln("Will cause control to be passed back to the vm, continuing execution");
+ phpdbg_writeln("\tWill cause control to be passed back to the vm, continuing execution");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: this allows all breakpoints that would otherwise break execution in the current scope to be skipped");
phpdbg_help_footer();
phpdbg_help_header();
phpdbg_writeln("Step back into the vm, skipping breakpoints until the current stack is returning");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%sleave", PROMPT);
phpdbg_writeln("\t%sL", PROMPT);
- phpdbg_writeln("Will cause a break when instructed to leave the current context");
+ phpdbg_writeln("\tWill cause a break when instructed to leave the current context");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: this allows inspection of the return value before it is returned");
phpdbg_help_footer();
phpdbg_writeln("Pre-compilation of the execution context provides the opportunity to inspect opcodes before execution");
phpdbg_writeln("The execution context must be set for compilation to succeed");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%scompile", PROMPT);
phpdbg_writeln("\t%sc", PROMPT);
- phpdbg_writeln("Will compile the current execution context, populating class/function/constant/etc tables");
+ phpdbg_writeln("\tWill compile the current execution context, populating class/function/constant/etc tables");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: It is a good idea to clean the environment between each compilation");
phpdbg_help_footer();
phpdbg_writeln("By default, print will show information about the current execution context");
phpdbg_writeln("Other printing commands give access to instruction information");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%sprint class \\my\\class", PROMPT);
phpdbg_writeln("\t%sp c \\my\\class", PROMPT);
- phpdbg_writeln("Will print the instructions for the methods in \\my\\class");
+ phpdbg_writeln("\tWill print the instructions for the methods in \\my\\class");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sprint method \\my\\class::method", PROMPT);
phpdbg_writeln("\t%sp m \\my\\class::method", PROMPT);
- phpdbg_writeln("Will print the instructions for \\my\\class::method");
+ phpdbg_writeln("\tWill print the instructions for \\my\\class::method");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sprint func .getSomething", PROMPT);
phpdbg_writeln("\t%sp f .getSomething", PROMPT);
- phpdbg_writeln("Will print the instructions for ::getSomething in the active scope");
+ phpdbg_writeln("\tWill print the instructions for ::getSomething in the active scope");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sprint func my_function", PROMPT);
phpdbg_writeln("\t%sp f my_function", PROMPT);
- phpdbg_writeln("Will print the instructions for the global function my_function");
+ phpdbg_writeln("\tWill print the instructions for the global function my_function");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sprint opline", PROMPT);
phpdbg_writeln("\t%sp o", PROMPT);
- phpdbg_writeln("Will print the instruction for the current opline");
+ phpdbg_writeln("\tWill print the instruction for the current opline");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sprint exec", PROMPT);
phpdbg_writeln("\t%sp e", PROMPT);
- phpdbg_writeln("Will print the instructions for the execution context");
+ phpdbg_writeln("\tWill print the instructions for the execution context");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sprint stack", PROMPT);
phpdbg_writeln("\t%sp s", PROMPT);
- phpdbg_writeln("Will print the instructions for the current stack");
+ phpdbg_writeln("\tWill print the instructions for the current stack");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Specific printers loaded are show below:");
phpdbg_notice("Commands");
phpdbg_help_header();
phpdbg_writeln("Execute the current context inside the phpdbg vm");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%srun", PROMPT);
phpdbg_writeln("\t%sr", PROMPT);
- phpdbg_writeln("Will cause execution of the context, if it is set.");
+ phpdbg_writeln("\tWill cause execution of the context, if it is set.");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: The execution context must be set, but not necessarily compiled before execution occurs");
phpdbg_help_footer();
phpdbg_help_header();
phpdbg_writeln("Access to eval() allows you to change the environment during execution, careful though !!");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%seval $variable", PROMPT);
phpdbg_writeln("\t%sE $variable", PROMPT);
- phpdbg_writeln("Will print_r($variable) on the console, if it is defined");
+ phpdbg_writeln("\tWill print_r($variable) on the console, if it is defined");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%seval $variable = \"Hello phpdbg :)\"", PROMPT);
phpdbg_writeln("\t%sE $variable = \"Hello phpdbg :)\"", PROMPT);
- phpdbg_writeln("Will set $variable in the current scope");
+ phpdbg_writeln("\tWill set $variable in the current scope");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: eval() will always show the result; do not prefix the code with \"return\"");
phpdbg_help_footer();
phpdbg_help_header();
phpdbg_writeln("Setting a breakpoint stops execution at a specific stage");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%sbreak [file] test.php:1", PROMPT);
- phpdbg_writeln("Will break execution on line 1 of test.php");
+ phpdbg_writeln("\t%sb [f] test.php:1", PROMPT);
+ phpdbg_writeln("\tWill break execution on line 1 of test.php");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sbreak [func] my_function", PROMPT);
- phpdbg_writeln("Will break execution on entry to my_function");
+ phpdbg_writeln("\t%sb [f] my_function", PROMPT);
+ phpdbg_writeln("\tWill break execution on entry to my_function");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sbreak [method] \\my\\class::method", PROMPT);
- phpdbg_writeln("Will break execution on entry to \\my\\class::method");
+ phpdbg_writeln("\t%sb [m] \\my\\class::method", PROMPT);
+ phpdbg_writeln("\tWill break execution on entry to \\my\\class::method");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sbreak [address] 0x7ff68f570e08", PROMPT);
- phpdbg_writeln("Will break at the opline with the address provided (addresses are shown during execution)");
+ phpdbg_writeln("\t%sb [a] 0x7ff68f570e08", PROMPT);
+ phpdbg_writeln("\tWill break at the opline with the address provided (addresses are shown during execution)");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sbreak [lineno] 200", PROMPT);
- phpdbg_writeln("Will break at line 200 of the currently executing file");
+ phpdbg_writeln("\t%sb [l] 200", PROMPT);
+ phpdbg_writeln("\tWill break at line 200 of the currently executing file");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%sbreak on ($expression == true)", PROMPT);
- phpdbg_writeln("Will break when the condition evaluates to true");
- phpdbg_notice("The parameters enclosed by [] are usually optional, but help avoid ambigious commands");
+ phpdbg_writeln("\t%sb on ($expression == true)", PROMPT);
+ phpdbg_writeln("\tWill break when the condition evaluates to true");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: An address is only valid for the current compilation");
phpdbg_writeln(EMPTY);
+ phpdbg_notice("The parameters enclosed by [] are usually optional, but help avoid ambigious commands");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("Specific breakers loaded are show below:");
phpdbg_notice("Commands");
{
PHPDBG_HELP(clean) /* {{{ */
{
- phpdbg_help_header();
- phpdbg_writeln("While debugging you may experience errors because of attempts to redeclare classes, constants or functions");
-
- phpdbg_writeln("Cleaning the environment cleans these tables, so that files can be recompiled without exiting phpdbg");
- phpdbg_help_footer();
- return SUCCESS;
+ phpdbg_help_header();
+ phpdbg_writeln("While debugging you may experience errors because of attempts to redeclare classes, constants or functions");
+
+ phpdbg_writeln("Cleaning the environment cleans these tables, so that files can be recompiled without exiting phpdbg");
+ phpdbg_help_footer();
+ return SUCCESS;
} /* }}} */
PHPDBG_HELP(clear) /* {{{ */
{
- phpdbg_help_header();
- phpdbg_writeln("Clearing breakpoints means you can once again run code without interruption");
-
- phpdbg_writeln("Note: all breakpoints are lost; be sure debugging is complete before clearing");
- phpdbg_help_footer();
- return SUCCESS;
+ phpdbg_help_header();
+ phpdbg_writeln("Clearing breakpoints means you can once again run code without interruption");
+
+ phpdbg_writeln("Note: all breakpoints are lost; be sure debugging is complete before clearing");
+ phpdbg_help_footer();
+ return SUCCESS;
} /* }}} */
PHPDBG_HELP(info) /* {{{ */
{
- phpdbg_help_header();
- phpdbg_writeln("info commands provide quick access to various types of information about the PHP environment");
- phpdbg_writeln("Specific info commands are show below:");
+ phpdbg_help_header();
+ phpdbg_writeln("info commands provide quick access to various types of information about the PHP environment");
+ phpdbg_writeln("Specific info commands are show below:");
phpdbg_notice("Commands");
{
- const phpdbg_command_t *info_command = phpdbg_info_commands;
+ const phpdbg_command_t *info_command = phpdbg_info_commands;
- phpdbg_writeln("\tAlias\tCommand\t\tPurpose");
- while (info_command && info_command->name) {
+ phpdbg_writeln("\tAlias\tCommand\t\tPurpose");
+ while (info_command && info_command->name) {
if (info_command->alias) {
- phpdbg_writeln("\t[%c]\t%s\t\t%s", info_command->alias, info_command->name, info_command->tip);
+ phpdbg_writeln("\t[%c]\t%s\t\t%s", info_command->alias, info_command->name, info_command->tip);
} else phpdbg_writeln("\t[ ]\t%s\t\t%s", info_command->name, info_command->tip);
++info_command;
}
}
-
- phpdbg_help_footer();
- return SUCCESS;
+
+ phpdbg_help_footer();
+ return SUCCESS;
} /* }}} */
PHPDBG_HELP(quiet) /* {{{ */
{
- phpdbg_help_header();
- phpdbg_writeln("Setting quietness on will stop the OPLINE output during execution");
- phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
- phpdbg_writeln("\t%squiet 1", PROMPT);
- phpdbg_writeln("\t%sQ 1", PROMPT);
- phpdbg_writeln("Will silence OPLINE output, while");
- phpdbg_writeln("\t%squiet 0", PROMPT);
- phpdbg_writeln("\t%sQ 0", PROMPT);
- phpdbg_writeln("Will enable OPLINE output again");
- phpdbg_writeln(EMPTY);
- phpdbg_writeln("Note: Quietness is disabled automatically while stepping");
- phpdbg_help_footer();
+ phpdbg_help_header();
+ phpdbg_writeln("Setting quietness on will stop the OPLINE output during execution");
+ phpdbg_writeln(EMPTY);
+ phpdbg_notice("Examples");
+ phpdbg_writeln("\t%squiet 1", PROMPT);
+ phpdbg_writeln("\t%sQ 1", PROMPT);
+ phpdbg_writeln("\tWill silence OPLINE output, while");
+ phpdbg_writeln(EMPTY);
+ phpdbg_writeln("\t%squiet 0", PROMPT);
+ phpdbg_writeln("\t%sQ 0", PROMPT);
+ phpdbg_writeln("\tWill enable OPLINE output again");
+ phpdbg_writeln(EMPTY);
+ phpdbg_writeln("Note: Quietness is disabled automatically while stepping");
+ phpdbg_help_footer();
return SUCCESS;
} /* }}} */
phpdbg_help_header();
phpdbg_writeln("The backtrace is gathered with the default debug backtrace functionality");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
- phpdbg_writeln("You can set the limit on the trace");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%sback 5", PROMPT);
phpdbg_writeln("\t%st 5", PROMPT);
- phpdbg_writeln("Will limit the number of frames to 5, the default is no limit");
+ phpdbg_writeln("\tWill limit the number of frames to 5, the default is no limit");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: it is not necessary for an exception to be thrown to show a backtrace");
phpdbg_help_footer();
phpdbg_help_header();
phpdbg_writeln("The list command displays source code for the given argument");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%slist [lines] 2", PROMPT);
phpdbg_writeln("\t%sl [l] 2", PROMPT);
- phpdbg_writeln("Will print next 2 lines from the current file");
+ phpdbg_writeln("\tWill print next 2 lines from the current file");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%slist [func] my_function", PROMPT);
phpdbg_writeln("\t%sl [f] my_function", PROMPT);
- phpdbg_writeln("Will print the source of the global function \"my_function\"");
+ phpdbg_writeln("\tWill print the source of the global function \"my_function\"");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%slist [func] .mine", PROMPT);
phpdbg_writeln("\t%sl [f] .mine", PROMPT);
- phpdbg_writeln("Will print the source of the method \"mine\" from the active scope");
+ phpdbg_writeln("\tWill print the source of the method \"mine\" from the active scope");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%slist [method] my::method", PROMPT);
phpdbg_writeln("\t%sl [m] my::method", PROMPT);
- phpdbg_writeln("Will print the source of \"my::method\"");
+ phpdbg_writeln("\tWill print the source of \"my::method\"");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("\t%slist c myClass", PROMPT);
phpdbg_writeln("\t%sl c myClass", PROMPT);
- phpdbg_writeln("Will print the source of \"myClass\"");
- phpdbg_notice("The parameters enclosed by [] are usually optional, but help avoid ambigious commands");
+ phpdbg_writeln("\tWill print the source of \"myClass\"");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: before listing functions you must have a populated function table, try compile !!");
phpdbg_writeln(EMPTY);
+ phpdbg_notice("The parameters enclosed by [] are usually optional, but help avoid ambigious commands");
+ phpdbg_writeln(EMPTY);
phpdbg_writeln("Specific listers loaded are show below:");
phpdbg_notice("Commands");
{
PHPDBG_HELP(oplog) /* {{{ */
{
- phpdbg_help_header();
- phpdbg_writeln("Even when quietness is enabled you may wish to save opline logs to a file");
- phpdbg_writeln("Setting a new oplog closes the previously open log");
- phpdbg_writeln("The log includes a high resolution timestamp on each entry");
- phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
- phpdbg_writeln("\t%soplog /path/to/my.oplog", PROMPT);
- phpdbg_writeln("\t%sO /path/to/my.oplog", PROMPT);
- phpdbg_writeln("Will open the file /path/to/my.oplog for writing, creating it if it does not exist");
- phpdbg_writeln("\t%soplog 0", PROMPT);
- phpdbg_writeln("\t%sO 0", PROMPT);
- phpdbg_writeln("Will close the currently open log file, disabling oplog");
- phpdbg_writeln(EMPTY);
- phpdbg_writeln("Note: upon failure to open a new oplog, the last oplog is held open");
- phpdbg_help_footer();
- return SUCCESS;
+ phpdbg_help_header();
+ phpdbg_writeln("Even when quietness is enabled you may wish to save opline logs to a file");
+ phpdbg_writeln("Setting a new oplog closes the previously open log");
+ phpdbg_writeln("The log includes a high resolution timestamp on each entry");
+ phpdbg_writeln(EMPTY);
+ phpdbg_notice("Examples");
+ phpdbg_writeln("\t%soplog /path/to/my.oplog", PROMPT);
+ phpdbg_writeln("\t%sO /path/to/my.oplog", PROMPT);
+ phpdbg_writeln("\tWill open the file /path/to/my.oplog for writing, creating it if it does not exist");
+ phpdbg_writeln(EMPTY);
+ phpdbg_writeln("\t%soplog 0", PROMPT);
+ phpdbg_writeln("\t%sO 0", PROMPT);
+ phpdbg_writeln("\tWill close the currently open log file, disabling oplog");
+ phpdbg_writeln(EMPTY);
+ phpdbg_writeln("Note: upon failure to open a new oplog, the last oplog is held open");
+ phpdbg_help_footer();
+ return SUCCESS;
} /* }}} */
PHPDBG_HELP(shell) /* {{{ */
phpdbg_help_header();
phpdbg_writeln("Direct access to shell commands saves having to switch windows/consoles");
phpdbg_writeln(EMPTY);
- phpdbg_writeln("Examples:");
+ phpdbg_notice("Examples");
phpdbg_writeln("\t%sshell ls /usr/src/php-src", PROMPT);
phpdbg_writeln("\t%s- ls /usr/src/php-src", PROMPT);
- phpdbg_writeln("Will execute ls /usr/src/php-src, displaying the output in the console");
+ phpdbg_writeln("\tWill execute ls /usr/src/php-src, displaying the output in the console");
phpdbg_writeln(EMPTY);
phpdbg_writeln("Note: read only commands please !");
phpdbg_help_footer();
projects / php / commitdiff