diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 95ff24d85a..45980e6e57 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,21 @@ +2005-04-16 Eli Zaretskii + + * gdb.texinfo (OS Information): Renamed from Auxiliary Vector; all + references changed. Add descriptgion of "info udot". + (Files): Document "set/show stop-on-solib-events". + (M32R/D): Document "set/show download-path", "set/show + board-address", "set/show server-address", "upload", "tload". + (Maintenance Commands): Improve indexing. + (Target Commands): Document "set/show hash", "set/show debug + monitor". + (SVR4 Process Information): Document "info pidlist" and "info + meminfo". Document "set/show procfs-tarce" and "set/show + procfs-file". Document "proc-trace-*" and "proc-untrace-*". + (Symbols, The Print Command with Objective-C): Improve indexing. + (Objective-C): Add references to "info classes" and "info + selectors". + (Debugging Output): Improve wording. + 2005-04-15 Eli Zaretskii * gdb.texinfo (Hurd Native): New subsection, documents @@ -16,6 +34,7 @@ print unwind". (Netrino): New subsection. Document "set/show debug nto-debug". (Super-H): New section. Document the "regs" command. + (Debugging Output): Document "set/show debug aix-thread". 2005-04-09 Eli Zaretskii diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 43e592adf9..4b9ba6bf4f 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -1930,6 +1930,7 @@ specify files}. @table @code @kindex cd +@cindex change working directory @item cd @var{directory} Set the @value{GDBN} working directory to @var{directory}. @@ -4852,7 +4853,7 @@ Table}. * Registers:: Registers * Floating Point Hardware:: Floating point hardware * Vector Unit:: Vector Unit -* Auxiliary Vector:: Auxiliary data provided by operating system +* OS Information:: Auxiliary data provided by operating system * Memory Region Attributes:: Memory region attributes * Dump/Restore Files:: Copy between memory and a file * Core File Generation:: Cause a program dump its core @@ -6093,11 +6094,33 @@ Display information about the vector unit. The exact contents and layout vary depending on the hardware. @end table -@node Auxiliary Vector -@section Operating system auxiliary vector +@node OS Information +@section Operating system auxiliary information +@cindex OS information + +@value{GDBN} provides interfaces to useful OS facilities that can help +you debug your program. + +@cindex @code{ptrace} system call +@cindex @code{struct user} contents +When @value{GDBN} runs on a @dfn{Posix system} (such as GNU or Unix +machines), it interfaces with the inferior via the @code{ptrace} +system call. The operating system creates a special sata structure, +called @code{struct user}, for this interface. You can use the +command @code{info udot} to display the contents of this data +structure. + +@table @code +@item info udot +@kindex info udot +Display the contents of the @code{struct user} maintained by the OS +kernel for the program being debugged. @value{GDBN} displays the +contents of @code{struct user} as a list of hex numbers, similar to +the @code{examine} command. +@end table + @cindex auxiliary vector @cindex vector, auxiliary - Some operating systems supply an @dfn{auxiliary vector} to programs at startup. This is akin to the arguments and environment that you specify for a program, but contains a system-dependent variety of @@ -6122,6 +6145,7 @@ most appropriate form for a recognized tag, and in hexadecimal for an unrecognized tag. @end table + @node Memory Region Attributes @section Memory region attributes @cindex memory region attributes @@ -8784,7 +8808,9 @@ available choices, or to finish the type list for you. @cindex Objective-C This section provides information about some commands and command -options that are useful for debugging Objective-C code. +options that are useful for debugging Objective-C code. See also +@ref{Symbols, info classes}, and @ref{Symbols, info selectors}, for a +few more commands specific to Objective-C support. @menu * Method Names in Commands:: @@ -8859,6 +8885,7 @@ clear -[NSWindow makeKeyAndOrderFront:] @node The Print Command with Objective-C @subsubsection The Print Command With Objective-C +@cindex Objective-C, print objects @kindex print-object @kindex po @r{(@code{print-object})} @@ -9925,6 +9952,7 @@ variables) whose names contain a match for regular expression @var{regexp}. @kindex info classes +@cindex Objective-C, classes and selectors @item info classes @itemx info classes @var{regexp} Display all Objective-C classes in your program, or @@ -10853,6 +10881,24 @@ Mb). Display the current autoloading size threshold, in megabytes. @end table +Sometimes you may wish that @value{GDBN} stops and gives you control +when any of shared library events happen. Use the @code{set +stop-on-solib-events} command for this: + +@table @code +@item set stop-on-solib-events +@kindex set stop-on-solib-events +This command controls whether @value{GDBN} should give you control +when the dynamic linker notifies it about some shared library event. +The most common event of interest is loading or unloading of a new +shared library. + +@item show stop-on-solib-events +@kindex show stop-on-solib-events +Show whether @value{GDBN} stops and gives you control when shared +library events happen. +@end table + Shared libraries are also supported in many cross or remote debugging configurations. A copy of the target's libraries need to be present on the host system; they need to be the same as the target libraries, although the @@ -11360,10 +11406,10 @@ NetROM ROM emulator. This target only supports downloading. Different targets are available on different configurations of @value{GDBN}; your configuration may have more or fewer targets. -Many remote targets require you to download the executable's code -once you've successfully established a connection. You may wish to -control the size of the data chunks used by @value{GDBN} to download -program parts to the remote target. +Many remote targets require you to download the executable's code once +you've successfully established a connection. You may wish to control +various aspects of this process, such as the size of the data chunks +used by @value{GDBN} to download program parts to the remote target. @table @code @kindex set download-write-size @@ -11376,7 +11422,31 @@ memory cache. @kindex show download-write-size @item show download-write-size +@kindex show download-write-size Show the current value of the write size. + +@item set hash +@kindex set hash@r{, for remote monitors} +@cindex hash mark while downloading +This command controls whether a hash mark @samp{#} is displayed while +downloading a file to the remote monitor. If on, a hash mark is +displayed after each S-record is successfully downloaded to the +monitor. + +@item show hash +@kindex show hash@r{, for remote monitors} +Show the current status of displaying the hash mark. + +@item set debug monitor +@kindex set debug monitor +@cindex display remote monitor communications +Enable or disable display of communications messages between +@value{GDBN} and the remote monitor. + +@item show debug monitor +@kindex show debug monitor +Show the current status of displaying communications between +@value{GDBN} and the remote monitor. @end table @table @code @@ -11913,11 +11983,11 @@ downloads. @cindex @code{auxv}, and remote targets Set the use of the remote protocol's @samp{qPart:auxv:read} (target auxiliary vector read) request. This request is used to fetch the -remote target's @dfn{auxiliary vector}, see @ref{Auxiliary Vector}. -The default setting depends on the remote stub's support of this -request (@value{GDBN} queries the stub when this request is first -required). @xref{General Query Packets, qPart}, for more information -about this request. +remote target's @dfn{auxiliary vector}, see @ref{OS Information, +Auxiliary Vector}. The default setting depends on the remote stub's +support of this request (@value{GDBN} queries the stub when this +request is first required). @xref{General Query Packets, qPart}, for +more information about this request. @item show remote read-aux-vector-packet Show the current setting of use of the @samp{qPart:auxv:read} request. @@ -12364,7 +12434,7 @@ available: @table @code @kindex kvm @item kvm pcb -Set current context from pcb address. +Set current context from the @dfn{Process Control Block} (PCB) address. @item kvm proc Set current context from proc address. This command isn't available on @@ -12443,6 +12513,48 @@ its children. Report on the process IDs related to your program: its own process ID, the ID of its parent, the process group ID, and the session ID. @end ignore + +@item set procfs-trace +@kindex set procfs-trace +@cindex @code{procfs} API calls +This command enables and disables tracing of @code{procfs} API calls. + +@item show procfs-trace +@kindex show procfs-trace +Show the current state of @code{procfs} API call tracing. + +@item set procfs-file @var{file} +@kindex set procfs-file +Tell @value{GDBN} to write @code{procfs} API trace to the named +@var{file}. @value{GDBN} appends the trace info to the previous +contents of the file. The default is to display the trace on the +standard output. + +@item show procfs-file +@kindex show procfs-file +Show the file to which @code{procfs} API trace is written. + +@item proc-trace-entry +@itemx proc-trace-exit +@itemx proc-untrace-entry +@itemx proc-untrace-exit +@kindex proc-trace-entry +@kindex proc-trace-exit +@kindex proc-untrace-entry +@kindex proc-untrace-exit +These commands enable and disable tracing of entries into and exits +from the @code{syscall} interface. + +@item info pidlist +@kindex info pidlist +@cindex process list, QNX Neutrino +For QNX Neutrino only, this command displays the list of all the +processes and all the threads within each process. + +@item info meminfo +@kindex info meminfo +@cindex mapinfo list, QNX Neutrino +For QNX Neutrino only, this command displays the list of all mapinfos. @end table @node DJGPP Native @@ -13532,7 +13644,6 @@ memory}. The accepted values for @var{mod} are @code{small}, @subsection Renesas M32R/D @table @code - @kindex target m32r @item target m32r @var{dev} Renesas M32R/D ROM monitor. @@ -13540,7 +13651,48 @@ Renesas M32R/D ROM monitor. @kindex target m32rsdi @item target m32rsdi @var{dev} Renesas M32R SDI server, connected via parallel port to the board. +@end table +The following @value{GDBN} commands are specific to the M32R monitor: + +@table @code +@item set download-path @var{path} +@kindex set download-path +@cindex find downloadable @sc{srec} files (M32R) +Set the default path for finding donwloadable @sc{srec} files. + +@item show download-path +@kindex show download-path +Show the default path for downloadable @sc{srec} files. + +@item set board-address @var{addr} +@kindex set board-address +@cindex M32-EVA target board address +Set the IP address for the M32R-EVA target board. + +@item show board-address +@kindex show board-address +Show the current IP address of the target board. + +@item set server-address @var{addr} +@kindex set server-address +@cindex download server address (M32R) +Set the IP address for the download server, which is the @value{GDBN}'s +host machine. + +@item show server-address +@kindex show server-address +Display the IP address of the download server. + +@item upload @r{[}@var{file}@r{]} +@kindex upload@r{, M32R} +Upload the specified @sc{srec} @var{file} via the monitor's Ethernet +upload capability. If no @var{file} argument is given, the current +executable file is uploaded. + +@item tload @r{[}@var{file}@r{]} +@kindex tload@r{, M32R} +Test the @code{upload} command. @end table @node M68K @@ -14889,6 +15041,12 @@ Turns on or off display of gdbarch debugging info. The default is off @kindex show debug @item show debug arch Displays the current state of displaying gdbarch debugging info. +@item set debug aix-thread +@cindex AIX threads +Display debugging messages about inner workings of the AIX thread +module. +@item show debug aix-thread +Show the current state of AIX thread debugging info display. @item set debug event @cindex event debugging info Turns on or off display of @value{GDBN} event debugging info. The @@ -14898,11 +15056,11 @@ Displays the current state of displaying @value{GDBN} event debugging info. @item set debug expression @cindex expression debugging info -Turns on or off display of @value{GDBN} expression debugging info. The -default is off. +Turns on or off display of debugging info about @value{GDBN} +expression parsing. The default is off. @item show debug expression -Displays the current state of displaying @value{GDBN} expression -debugging info. +Displays the current state of displaying debugging info about +@value{GDBN} expression parsing. @item set debug frame @cindex frame debugging info Turns on or off display of @value{GDBN} frame debugging info. The @@ -14920,7 +15078,7 @@ Displays the current state of @value{GDBN} inferior debugging. @item set debug lin-lwp @cindex @sc{gnu}/Linux LWP debug messages @cindex Linux lightweight processes -Turns on or off debugging messages from the LWP debug support. +Turns on or off debugging messages from the Linux LWP debug support. @item show debug lin-lwp Show the current state of Linux LWP debugging messages. @item set debug observer @@ -20980,7 +21138,10 @@ the replacement as part of the warning. @kindex maint dump-me @item maint dump-me +@cindex @code{SIGQUIT} signal, dump core of @value{GDBN} Cause a fatal signal in the debugger and force it to dump its core. +This is supported only on systems which support aborting a program +with the @code{SIGQUIT} signal. @kindex maint internal-error @kindex maint internal-warning @@ -21023,7 +21184,6 @@ Print the entire architecture configuration. The optional argument @kindex maint print dummy-frames @item maint print dummy-frames - Prints the contents of @value{GDBN}'s internal dummy-frame stack. @smallexample @@ -22205,9 +22365,9 @@ requests use the same reply formats, listed below. @table @asis @item @code{qPart}:@code{auxv}:@code{read}::@var{offset},@var{length} -Access the target's @dfn{auxiliary vector}. @xref{Auxiliary Vector}, -and see @ref{Remote configuration, read-aux-vector-packet}. -Note @var{annex} must be empty. +Access the target's @dfn{auxiliary vector}. @xref{OS Information, +auxiliary vector}, and see @ref{Remote configuration, +read-aux-vector-packet}. Note @var{annex} must be empty. @end table Reply: