Lines Matching refs:CR
310 #define CR "\n" macro
314 {"overview!", CR
315 "**phpdbg** is a lightweight, powerful and easy to use debugging platform for PHP5.4+" CR
316 "It supports the following commands:" CR CR
318 "**Information**" CR
319 " **list** list PHP source" CR
320 " **info** displays information on the debug session" CR
321 " **print** show opcodes" CR
322 " **frame** select a stack frame and print a stack frame summary" CR
323 " **back** shows the current backtrace" CR
324 " **help** provide help on a topic" CR CR
326 "**Starting and Stopping Execution**" CR
327 " **exec** set execution context" CR
328 " **run** attempt execution" CR
329 " **step** continue execution until other line is reached" CR
330 " **continue** continue execution" CR
331 " **until** continue execution up to the given location" CR
332 " **finish** continue up to end of the current execution frame" CR
333 …e** continue up to end of the current execution frame and halt after the calling instruction" CR
334 " **break** set a breakpoint at the specified target" CR
335 " **watch** set a watchpoint on $variable" CR
336 " **clear** clear one or all breakpoints" CR
337 " **clean** clean the execution environment" CR CR
339 "**Miscellaneous**" CR
340 " **set** set the phpdbg configuration" CR
341 " **source** execute a phpdbginit script" CR
342 " **register** register a phpdbginit function as a command alias" CR
343 " **sh** shell a command" CR
344 " **ev** evaluate some code" CR
345 " **quit** exit phpdbg" CR CR
350 "but **help cl** will list the summary for **clean** and **clear**." CR CR
352 "Type **help aliases** to show a full alias list, including any registered phpdginit functions" CR
353 "Type **help syntax** for a general introduction to the command syntax." CR
354 "Type **help options** for a list of phpdbg command line options." CR
357 {"options", CR
358 "Below are the command line options supported by phpdbg" CR CR
360 "**Command Line Options and Flags**" CR
361 " **Option** **Example Argument** **Description**" CR
362 " **-c** **-c**/my/php.ini Set php.ini file to load" CR
363 " **-d** **-d**memory_limit=4G Set a php.ini directive" CR
364 " **-n** Disable default php.ini" CR
365 " **-q** Supress welcome banner" CR
366 " **-v** Enable oplog output" CR
367 " **-s** Enable stepping" CR
368 " **-b** Disable colour" CR
369 " **-i** **-i**my.init Set .phpdbginit file" CR
370 " **-I** Ignore default .phpdbginit" CR
371 " **-O** **-O**my.oplog Sets oplog output file" CR
372 " **-r** Run execution context" CR
373 " **-rr** Run execution context and quit after execution" CR
374 " **-E** Enable step through eval, careful!" CR
375 " **-S** **-S**cli Override SAPI name, careful!" CR
376 " **-l** **-l**4000 Setup remote console ports" CR
377 " **-a** **-a**192.168.0.3 Setup remote console bind address" CR
378 " **-V** Print version number" CR
380 "argument after it" CR CR
382 "**Remote Console Mode**" CR CR
389 "interface/port." CR CR
394 {"phpdbginit", CR
398 "details)." CR CR
400 "Debugger scripts can also be executed using the **source** command." CR CR
403 "code. " CR CR
406 "files and not in interactive sessions." CR CR
410 "and **register** PHP functions as new commands." CR CR
416 {"syntax", CR
421 "than by substitution by the alias." CR CR
423 "Some commands take an argument. Arguments are typed according to their format:" CR
424 " * **omitted**" CR
425 " * **address** **0x** followed by a hex string" CR
426 " * **number** an optionally signed number" CR
427 " * **method** a valid **Class::methodName** expression" CR
428 " * **func#op** a valid **Function name** follow by # and an integer" CR
429 " * **method#op** a valid **Class::methodName** follow by # and an integer" CR
430 " * **string** a general string" CR
431 " * **function** a valid **Function name**" CR
432 " * **file:line** a valid **filename** follow by : and an integer" CR CR
434 "In some cases the type of the argument enables the second keyword to be omitted." CR CR
437 "on any specific command." CR CR
439 "**Valid Examples**" CR CR
441 " $P quit" CR
442 " $P q" CR
443 " Quit the debugger" CR CR
445 " $P ev $total[2]" CR
446 " Evaluate and print the variable $total[2] in the current stack frame" CR
447 " " CR
448 " $P break 200" CR
449 " $P b my_source.php:200" CR
450 " Break at line 200 in the current source and in file **my_source.php**. " CR CR
452 " $P b @ ClassX::get_args if $arg[0] == \"fred\"" CR
453 " $P b ~ 3" CR
454 " Break at ClassX::get_args() if $arg[0] == \"fred\" and delete breakpoint 3" CR CR
456 "**Examples of invalid commands**" CR
458 " $P #This is a comment" CR
463 {"aliases!", CR
465 "is a synomyn for **info break** and **l func** for **list func**, etc." CR CR
470 {"duplicate!", CR
478 "a complete backtrace is given." CR CR
480 "**Examples**" CR CR
481 " $P back 5" CR
482 " $P t " CR
483 " " CR
490 "types:" CR CR
492 " **Target** **Alias** **Purpose**" CR
493 " **at** **A** specify breakpoint by location and condition" CR
494 " **del** **d** delete breakpoint by breakpoint identifier number" CR CR
498 "execution, if evaluated as true in a boolean context at the specified target." CR CR
500 "Note that breakpoints can also be disabled and re-enabled by the **set break** command." CR CR
502 "**Examples**" CR CR
503 " $P break test.php:100" CR
504 " $P b test.php:100" CR
505 " Break execution at line 100 of test.php" CR CR
507 " $P break 200" CR
508 " $P b 200" CR
509 " Break execution at line 200 of the currently PHP script file" CR CR
511 " $P break \\\\mynamespace\\\\my_function" CR
512 " $P b \\\\mynamespace\\\\my_function" CR
513 " Break execution on entry to \\\\mynamespace\\\\my_function" CR CR
515 " $P break classX::method" CR
516 " $P b classX::method" CR
517 " Break execution on entry to classX::method" CR CR
519 " $P break 0x7ff68f570e08" CR
520 " $P b 0x7ff68f570e08" CR
521 " Break at the opline at the address 0x7ff68f570e08" CR CR
523 " $P break my_function#14" CR
524 " $P b my_function#14" CR
525 " Break at the opline #14 of the function my_function" CR CR
527 " $P break \\\\my\\\\class::method#2" CR
528 " $P b \\\\my\\\\class::method#2" CR
529 " Break at the opline #2 of the method \\\\my\\\\class::method" CR CR
531 " $P break test.php:#3" CR
532 " $P b test.php:#3" CR
533 " Break at opline #3 in test.php" CR CR
535 " $P break if $cnt > 10" CR
536 " $P b if $cnt > 10" CR
537 " Break when the condition ($cnt > 10) evaluates to true" CR CR
539 " $P break at phpdbg::isGreat if $opt == 'S'" CR
540 " $P break @ phpdbg::isGreat if $opt == 'S'" CR
541 " Break at any opcode in phpdbg::isGreat when the condition ($opt == 'S') is true" CR CR
543 " $P break at test.php:20 if !isset($x)" CR
544 " Break at every opcode on line 20 of test.php when the condition evaluates to true" CR CR
546 " $P break ZEND_ADD" CR
547 " $P b ZEND_ADD" CR
548 " Break on any occurence of the opcode ZEND_ADD" CR CR
550 " $P break del 2" CR
551 " $P b ~ 2" CR
552 " Remove breakpoint 2" CR CR
555 "as they significantly slow execution." CR CR
565 "take place." CR CR
572 "Clearing breakpoints means you can once again run code without interruption." CR CR
574 "Note: use break delete N to clear a specific breakpoint." CR CR
582 "been explicitly changed by issuing a **frame** command. " CR CR
584 "**Examples**" CR CR
585 " $P ev $variable" CR
586 " Will print_r($variable) on the console, if it is defined" CR CR
588 " $P ev $variable = \"Hello phpdbg :)\"" CR
589 " Will set $variable in the current scope" CR CR
593 "is needed here. You can even call PHP functions which have breakpoints defined. " CR CR
601 "**-e** command line option." CR CR
604 "context." CR CR
606 "**Examples**" CR CR
608 " $P exec /tmp/script.php" CR
609 " $P e /tmp/script.php" CR
618 "completion of the script" CR CR
621 "skipped. "CR CR
629 "being executed." CR CR
631 "**Examples**" CR CR
632 " $P frame 2" CR
633 " $P ev $count" CR
634 " Go to frame 2 and print out variable **$count** in that frame" CR CR
641 …*info** commands provide quick access to various types of information about the PHP environment" CR
642 "Specific info commands are show below:" CR CR
644 " **Target** **Alias** **Purpose**" CR
645 " **break** **b** show current breakpoints" CR
646 " **files** **F** show included files" CR
647 " **classes** **c** show loaded classes" CR
648 " **funcs** **f** show loaded classes" CR
649 " **error** **e** show last error" CR
650 " **vars** **v** show active variables" CR
651 " **literal** **l** show active literal constants" CR
661 "variables including the return value before it is returned" CR CR
663 "**Examples**" CR CR
665 " $P leave" CR
666 " $P L" CR CR
669 "skipped. "CR CR
676 "a second subcommand keyword:" CR CR
678 " **Type** **Alias** **Purpose**" CR
679 " **lines** **l** List N lines from the current execution point" CR
680 " **func** **f** List the complete source for a specified function" CR
681 " **method** **m** List the complete source for a specified class::method" CR
682 " **class** **c** List the complete source for a specified class" CR CR
686 "to list off a class." CR CR
688 "**Examples**" CR CR
689 " $P list 2" CR
690 " $P l l 2" CR
691 " List the next 2 lines from the current file" CR CR
693 " $P list my_function" CR
694 " $P l f my_function" CR
695 " List the source of the function **my_function**" CR CR
698 " $P list func .mine" CR
699 " $P l f .mine" CR
700 " List the source of the method **mine** from the active class in scope" CR CR
702 " $P list m my::method" CR
703 " $P l my::method" CR
704 " List the source of **my::method**" CR CR
706 " $P list c myClass" CR
707 " $P l c myClass" CR
708 " List the source of **myClass**" CR CR
716 "Continue with execution after hitting a break or watchpoint" CR CR
718 "**Examples**" CR CR
719 " $P continue" CR
720 " $P c" CR
721 " Continue executing until the next break or watchpoint" CR CR
727 "By default, print will show information about the current execution context." CR
728 "Other printing commands give access to instruction information." CR
729 "Specific printers loaded are show below:" CR CR
731 " **Type** **Alias** **Purpose**" CR
732 " **exec** **e** print out the instructions in the execution context" CR
733 " **opline** **o** print out the instruction in the current opline" CR
734 " **class** **c** print out the instructions in the specified class" CR
735 " **method** **m** print out the instructions in the specified method" CR
736 " **func** **f** print out the instructions in the specified function" CR
737 " **stack** **s** print out the instructions in the current stack" CR CR
739 "**Examples**" CR CR
740 " $P print class \\\\my\\\\class" CR
741 " $P p c \\\\my\\\\class" CR
742 " Print the instructions for the methods in \\\\my\\\\class" CR CR
744 " $P print method \\\\my\\\\class::method" CR
745 " $P p m \\\\my\\\\class::method" CR
746 " Print the instructions for \\\\my\\\\class::method" CR CR
748 " $P print func .getSomething" CR
749 " $P p f .getSomething" CR
751 " Print the instructions for ::getSomething in the active scope" CR CR
753 " $P print func my_function" CR
754 " $P p f my_function" CR
755 " Print the instructions for the global function my_function" CR CR
757 " $P print opline" CR
758 " $P p o" CR
759 " Print the instruction for the current opline" CR CR
761 " $P print exec" CR
762 " $P p e" CR
763 " Print the instructions for the execution context" CR CR
765 " $P print stack" CR
766 " $P p s" CR
772 "Register any global function for use as a command in phpdbg console" CR CR
774 "**Examples**" CR CR
775 " $P register scandir" CR
776 " $P R scandir" CR
777 " Will register the scandir function for use in phpdbg" CR CR
784 "or completion of the script. Add parameters you want to use as $argv" CR CR
786 "**Examples**" CR CR
788 " $P run" CR
789 " $P r" CR
790 " Will cause execution of the context, if it is set" CR CR
791 " $P r test" CR
792 " Will execute with $argv[1] == \"test\"" CR CR
795 "be compiled before execution." CR CR
803 "are as follows:" CR CR
805 " **Type** **Alias** **Purpose**" CR
806 " **prompt** **p** set the prompt" CR
807 " **color** **c** set color <element> <color>" CR
808 " **colors** **C** set colors [<on|off>]" CR
809 " **oplog** **O** set oplog [output]" CR
810 " **break** **b** set break **id** <on|off>" CR
811 " **breaks** **B** set breaks [<on|off>]" CR
812 " **quiet** **q** set quiet [<on|off>]" CR
813 " **stepping** **s** set stepping [<opcode|line>]" CR
814 " **refcount** **r** set refcount [<on|off>] " CR CR
818 "**-bold** or **-underline** qualifier." CR CR
820 "Color elements can be one of **prompt**, **notice**, or **error**." CR CR
822 "**Examples**" CR CR
823 " $P S C on" CR
824 " Set colors on" CR CR
826 " $P set p >" CR
827 " $P set color prompt white-bold" CR
828 " Set the prompt to a bold >" CR CR
830 " $P S c error red-bold" CR
831 " Use red bold for errors" CR CR
833 " $P S refcount on" CR
834 " Enable refcount display when hitting watchpoints" CR CR
836 " $P S b 4 off" CR
837 " Temporarily disable breakpoint 4. This can be subsequently reenabled by a **s b 4 on**." CR
842 "Direct access to shell commands saves having to switch windows/consoles" CR CR
844 "**Examples**" CR CR
845 " $P sh ls /usr/src/php-src" CR
851 "Sourcing a **phpdbginit** script during your debugging session might save some time." CR CR
853 "**Examples**" CR CR
855 " $P source /my/init" CR
856 " $P < /my/init" CR
857 " Will execute the phpdbginit file at /my/init" CR CR
861 "Exporting breakpoints allows you to share, and or save your current debugging session" CR CR
863 "**Examples**" CR CR
865 " $P export /my/exports" CR
866 " $P > /my/exports" CR
867 " Will export all breakpoints to /my/exports" CR CR
871 "Execute opcodes until next line" CR CR
873 "**Examples**" CR CR
875 " $P s" CR
876 " Will continue and break again in the next encountered line" CR CR
882 "will then continue until the next breakpoint or completion of the script" CR CR
884 …ote when **step**ping is enabled, any opcode steps within the current line are also skipped. "CR CR
887 "skipped. " CR CR
893 "Sets watchpoints on variables as long as they are defined" CR
894 "Passing no parameter to **watch**, lists all actually active watchpoints" CR CR
896 "**Format for $variable**" CR CR
897 " **$var** Variable $var" CR
898 " **$var[]** All array elements of $var" CR
899 " **$var->** All properties of $var" CR
900 " **$var->a** Property $var->a" CR
901 " **$var[b]** Array element with key b in array $var" CR CR
903 "Subcommands of **watch**:" CR CR
905 " **Type** **Alias** **Purpose**" CR
906 …** **a** Sets watchpoint on array/object to observe if an entry is added or removed" CR
907 …riable recursively and automatically adds watchpoints if some entry is added to an array/object" CR
908 " **delete** **d** Removes watchpoint" CR CR
910 … when **recursive** watchpoints are removed, watchpoints on all the children are removed too" CR CR
912 "**Examples**" CR CR
913 " $P watch" CR
914 " List currently active watchpoints" CR CR
916 " $P watch $array" CR
917 " $P w $array" CR
918 " Set watchpoint on $array" CR CR
920 " $P watch recursive $obj->" CR
921 " $P w r $obj->" CR
922 " Set recursive watchpoint on $obj->" CR CR
924 " $P watch delete $obj->a" CR
925 " $P w d $obj->a" CR
926 " Remove watchpoint $obj->a" CR CR
928 …get many segmentation faults, each time when a memory page containing a watched address is hit." CR
929 …en you can continue, phpdbg will remove the write protection, so that the program can continue." CR
