X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gdb%2Fdoc%2Fobserver.texi;h=fc7aac43ae31ee692c2adb74bc586d6c0f53c843;hb=cb814510676f7f6c08b329af2f57006fa598b619;hp=6827ed8f982f79a3ab30382d10cb0ffcd8d7e1b4;hpb=6dea1fbd79e621463ba1eba5b4b417ecdf16b3eb;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/doc/observer.texi b/gdb/doc/observer.texi index 6827ed8f98..fc7aac43ae 100644 --- a/gdb/doc/observer.texi +++ b/gdb/doc/observer.texi @@ -2,7 +2,7 @@ @c This file is part of the GDB manual. @c -@c Copyright (C) 2003-2006, 2008-2012 Free Software Foundation, Inc. +@c Copyright (C) 2003-2016 Free Software Foundation, Inc. @c @c See the file gdbint.texinfo for copying conditions. @c @@ -94,6 +94,34 @@ the breakpoints were are stopped at, if any. Second argument inferior has stopped. @end deftypefun +@deftypefun void signal_received (enum gdb_signal @var{siggnal}) +The inferior was stopped by a signal. +@end deftypefun + +@deftypefun void end_stepping_range (void) +We are done with a step/next/si/ni command. +@end deftypefun + +@deftypefun void signal_exited (enum gdb_signal @var{siggnal}) +The inferior was terminated by a signal. +@end deftypefun + +@deftypefun void exited (int @var{exitstatus}) +The inferior program is finished. +@end deftypefun + +@deftypefun void no_history (void) +Reverse execution: target ran out of history info. +@end deftypefun + +@deftypefun void sync_execution_done (void) +A synchronous command finished. +@end deftypefun + +@deftypefun void command_error (void) +An error was caught while executing a command. +@end deftypefun + @deftypefun void target_changed (struct target_ops *@var{target}) The target's register contents have changed. @end deftypefun @@ -113,6 +141,18 @@ at the entry-point instruction. For @samp{attach} and @samp{core}, inferior, and before any information on the inferior has been printed. @end deftypefun +@deftypefun void record_changed (struct inferior *@var{inferior}, int @var{started}, const char *@var{method}, const char *@var{format}) +The status of process record for inferior @var{inferior} in +@value{GDBN} has changed. The process record is started if +@var{started} is true, and the process record is stopped if +@var{started} is false. + +When @var{started} is true, @var{method} indicates the short name of the method +used for recording. If the method supports multiple formats, @var{format} +indicates which one is being used, otherwise it is NULL. When @var{started} is +false, they are both NULL. +@end deftypefun + @deftypefun void solib_loaded (struct so_list *@var{solib}) The shared library specified by @var{solib} has been loaded. Note that when @value{GDBN} calls this observer, the library's symbols probably @@ -131,6 +171,10 @@ Called with @var{objfile} equal to @code{NULL} to indicate previously loaded symbol table data has now been invalidated. @end deftypefun +@deftypefun void free_objfile (struct objfile *@var{objfile}) +The object file specified by @var{objfile} is about to be freed. +@end deftypefun + @deftypefun void new_thread (struct thread_info *@var{t}) The thread specified by @var{t} has been created. @end deftypefun @@ -172,19 +216,11 @@ A breakpoint has been modified in some way. The argument @var{b} is the modified breakpoint. @end deftypefun -@deftypefun void tracepoint_created (int @var{tpnum}) -A new tracepoint has been created. The argument @var{tpnum} is the -number of the newly-created tracepoint. -@end deftypefun - -@deftypefun void tracepoint_deleted (int @var{tpnum}) -A tracepoint has been destroyed. The argument @var{tpnum} is the -number of the newly-destroyed tracepoint. -@end deftypefun - -@deftypefun void tracepoint_modified (int @var{tpnum}) -A tracepoint has been modified in some way. The argument @var{tpnum} -is the number of the modified tracepoint. +@deftypefun void traceframe_changed (int @var{tfnum}, int @var{tpnum}) +The trace frame is changed to @var{tfnum} (e.g., by using the +@code{tfind} command). If @var{tfnum} is negative, it means +@value{GDBN} resumes live debugging. The number of the tracepoint +associated with this traceframe is @var{tpnum}. @end deftypefun @deftypefun void architecture_changed (struct gdbarch *@var{newarch}) @@ -216,9 +252,9 @@ The inferior @var{inf} has been removed from the list of inferiors. This method is called immediately before freeing @var{inf}. @end deftypefun -@deftypefun void memory_changed (CORE_ADDR @var{addr}, int @var{len}, const bfd_byte *@var{data}) +@deftypefun void memory_changed (struct inferior *@var{inferior}, CORE_ADDR @var{addr}, ssize_t @var{len}, const bfd_byte *@var{data}) Bytes from @var{data} to @var{data} + @var{len} have been written -to the current inferior at @var{addr}. +to the @var{inferior} at @var{addr}. @end deftypefun @deftypefun void before_prompt (const char *@var{current_prompt}) @@ -230,6 +266,42 @@ the current top-level prompt. Variable gdb_datadir has been set. The value may not necessarily change. @end deftypefun +@deftypefun void command_param_changed (const char *@var{param}, const char *@var{value}) +The parameter of some @code{set} commands in console are changed. This +method is called after a command @code{set @var{param} @var{value}}. +@var{param} is the parameter of @code{set} command, and @var{value} +is the value of changed parameter. +@end deftypefun + +@deftypefun void tsv_created (const struct trace_state_variable *@var{tsv}) +The new trace state variable @var{tsv} is created. +@end deftypefun + +@deftypefun void tsv_deleted (const struct trace_state_variable *@var{tsv}) +The trace state variable @var{tsv} is deleted. If @var{tsv} is +@code{NULL}, all trace state variables are deleted. +@end deftypefun + +@deftypefun void tsv_modified (const struct trace_state_variable *@var{tsv}) +The trace state value @var{tsv} is modified. +@end deftypefun + +@deftypefun void inferior_call_pre (ptid_t @var{thread}, CORE_ADDR @var{address}) +An inferior function at @var{address} is about to be called in thread +@var{thread}. +@end deftypefun + +@deftypefun void inferior_call_post (ptid_t @var{thread}, CORE_ADDR @var{address}) +The inferior function at @var{address} has just been called. This observer +is called even if the inferior exits during the call. @var{thread} is the +thread in which the function was called, which may be different from the +current thread. +@end deftypefun + +@deftypefun void register_changed (struct frame_info *@var{frame}, int @var{regnum}) +A register in the inferior has been modified by the @value{GDBN} user. +@end deftypefun + @deftypefun void test_notification (int @var{somearg}) This observer is used for internal testing. Do not use. See testsuite/gdb.gdb/observer.exp.