GDBMI_dprintf_insert.st
changeset 12 568a2971c977
child 78 c24e7d8bc881
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/GDBMI_dprintf_insert.st	Thu Jun 12 01:21:45 2014 +0100
@@ -0,0 +1,98 @@
+"{ Package: 'jv:libgdbs' }"
+
+GDBMICommand subclass:#GDBMI_dprintf_insert
+	instanceVariableNames:''
+	classVariableNames:''
+	poolDictionaries:''
+	category:'GDB-Core-Commands-MI'
+!
+
+!GDBMI_dprintf_insert class methodsFor:'documentation'!
+
+documentation
+"
+The `-dprintf-insert' Command
+-----------------------------
+
+Synopsis
+........
+
+      -dprintf-insert [ -t ] [ -f ] [ -d ]
+         [ -c CONDITION ] [ -i IGNORE-COUNT ]
+         [ -p THREAD-ID ] [ LOCATION ] [ FORMAT ]
+         [ ARGUMENT ]
+
+If specified, LOCATION, can be one of:
+
+   * FUNCTION
+
+   * FILENAME:LINENUM
+
+   * FILENAME:function
+
+   * *ADDRESS
+
+   The possible optional parameters of this command are:
+
+`-t'
+     Insert a temporary breakpoint.
+
+`-f'
+     If LOCATION cannot be parsed (for example, if it refers to unknown
+     files or functions), create a pending breakpoint.  Without this
+     flag, {No value for `GDBN'} will report an error, and won't create
+     a breakpoint, if LOCATION cannot be parsed.
+
+`-d'
+     Create a disabled breakpoint.
+
+`-c CONDITION'
+     Make the breakpoint conditional on CONDITION.
+
+`-i IGNORE-COUNT'
+     Set the ignore count of the breakpoint (*note ignore count:
+     Conditions.)  to IGNORE-COUNT.
+
+`-p THREAD-ID'
+     Restrict the breakpoint to the specified THREAD-ID.
+
+Result
+......
+
+*Note GDB/MI Breakpoint Information::, for details on the format of the
+resulting breakpoint.
+
+{No value for `GDBN'} Command
+.............................
+
+The corresponding {No value for `GDBN'} command is `dprintf'.
+
+Example
+.......
+
+     (gdb)
+     4-dprintf-insert foo 'At foo entry\n'
+     4^done,bkpt={number='1',type='dprintf',disp='keep',enabled='y',
+     addr='0x000000000040061b',func='foo',file='mi-dprintf.c',
+     fullname='mi-dprintf.c',line='25',thread-groups=['i1'],
+     times='0',script={'printf \'At foo entry\\n\'','continue'},
+     original-location='foo'}
+     (gdb)
+     5-dprintf-insert 26 'arg=%d, g=%d\n' arg g
+     5^done,bkpt={number='2',type='dprintf',disp='keep',enabled='y',
+     addr='0x000000000040062a',func='foo',file='mi-dprintf.c',
+     fullname='mi-dprintf.c',line='26',thread-groups=['i1'],
+     times='0',script={'printf \'arg=%d, g=%d\\n\', arg, g','continue'},
+     original-location='mi-dprintf.c:26'}
+     (gdb)
+
+
+"
+! !
+
+!GDBMI_dprintf_insert methodsFor:'accessing'!
+
+operation
+	^ 'dprintf-insert'
+! !
+