From 3fa7bf069226d867d6400552c55d5a838a5f0f20 Mon Sep 17 00:00:00 2001 From: Mircea Gherzan Date: Wed, 12 Dec 2012 21:23:29 +0000 Subject: [PATCH] MI: document the -catch-load/-unload commands 2012-11-16 Mircea Gherzan gdb/doc: * gdb.texinfo (GDB/MI Catchpoint Commands): New section. gdb/: * NEWS: mention the -catch-load/-catch-unload MI commands. --- gdb/ChangeLog | 4 +++ gdb/NEWS | 2 ++ gdb/doc/ChangeLog | 4 +++ gdb/doc/gdb.texinfo | 68 +++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 78 insertions(+) diff --git a/gdb/ChangeLog b/gdb/ChangeLog index a3bcbeb69d0..5ea7d67d21e 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,7 @@ +2012-12-12 Mircea Gherzan + + * NEWS: Mention the -catch-load/-catch-unload MI commands. + 2012-12-12 Mircea Gherzan * Makefile.in (SUBDIR_MI_OBS): Add mi-cmd-catch.o. diff --git a/gdb/NEWS b/gdb/NEWS index ceb81a2d35c..7c467f87e75 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -101,6 +101,8 @@ show print type typedefs has been requested. ** New optional parameter COUNT added to the "-data-write-memory-bytes" command, to allow pattern filling of memory areas. + ** New commands "-catch-load"/"-catch-unload" added for intercepting + library load/unload events. * GDB now supports the "mini debuginfo" section, .gnu_debugdata. You must have the LZMA library available when configuring GDB for this diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 226fb55840a..535f266a331 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,7 @@ +2012-12-12 Mircea Gherzan + + * gdb.texinfo (GDB/MI Catchpoint Commands): New section. + 2012-12-11 Pedro Alves * gdb.texinfo: Remove all mentions of Unixware throughout. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 9964cbf10bd..c23e5debda2 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -27155,6 +27155,7 @@ may repeat one or more times. * GDB/MI Simple Examples:: * GDB/MI Command Description Format:: * GDB/MI Breakpoint Commands:: +* GDB/MI Catchpoint Commands:: * GDB/MI Program Context:: * GDB/MI Thread Commands:: * GDB/MI Ada Tasking Commands:: @@ -28729,6 +28730,73 @@ times="1"@}]@} (gdb) @end smallexample + +@c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +@node GDB/MI Catchpoint Commands +@section @sc{gdb/mi} Catchpoint Commands + +This section documents @sc{gdb/mi} commands for manipulating +catchpoints. + +@subheading The @code{-catch-load} Command +@findex -catch-load + +@subsubheading Synopsis + +@smallexample + -catch-load [ -t ] [ -d ] @var{regexp} +@end smallexample + +Add a catchpoint for library load events. If the @samp{-t} option is used, +the catchpoint is a temporary one (@pxref{Set Breaks, ,Setting +Breakpoints}). If the @samp{-d} option is used, the catchpoint is created +in a disabled state. The @samp{regexp} argument is a regular +expression used to match the name of the loaded library. + + +@subsubheading @value{GDBN} Command + +The corresponding @value{GDBN} command is @samp{catch load}. + +@subsubheading Example + +@smallexample +-catch-load -t foo.so +^done,bkpt=@{number="1",type="catchpoint",disp="del",enabled="y", +what="load of library matching foo.so",times="0"@} +(gdb) +@end smallexample + + +@subheading The @code{-catch-unload} Command +@findex -catch-unload + +@subsubheading Synopsis + +@smallexample + -catch-unload [ -t ] [ -d ] @var{regexp} +@end smallexample + +Add a catchpoint for library unload events. If the @samp{-t} option is +used, the catchpoint is a temporary one (@pxref{Set Breaks, ,Setting +Breakpoints}). If the @samp{-d} option is used, the catchpoint is +created in a disabled state. The @samp{regexp} argument is a regular +expression used to match the name of the unloaded library. + +@subsubheading @value{GDBN} Command + +The corresponding @value{GDBN} command is @samp{catch unload}. + +@subsubheading Example + +@smallexample +-catch-unload -d bar.so +^done,bkpt=@{number="2",type="catchpoint",disp="keep",enabled="n", +what="load of library matching bar.so",times="0"@} +(gdb) +@end smallexample + + @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @node GDB/MI Program Context @section @sc{gdb/mi} Program Context -- 2.30.2