"{ 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'

! !