From a64548eabad092dcc0ddfba7ba993bd1630e00ab Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Fri, 15 Apr 2005 16:43:54 +0000 Subject: [PATCH] (MIPS): Improve documentation of heuristic-fence-post. Document "set/show mips abi", "set/show mips saved-gpreg-size", "set/show mips stack-arg-size", "set/show mips mask-address", "set/show mips remote-mips64-transfers-32bit-regs", "set/show debug mips". (ARM): Document ARM-specific commands. (AVR): New section. Document "info io_registers". (CRIS): New section. Document "set/show cris-version" and "set/show cris-dwarf2-cfi". (HPPA): New section. Document "set/show debug hppa" and "maint print unwind". (Netrino): New subsection. Document "set/show debug nto-debug". (Super-H): New section. Document the "regs" command. --- gdb/doc/ChangeLog | 15 +++- gdb/doc/gdb.texinfo | 197 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 209 insertions(+), 3 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index a00fa6b..95ff24d 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -2,11 +2,20 @@ * gdb.texinfo (Hurd Native): New subsection, documents Hurd-specific commands. - (Maintenance Commands): Add cross-reference to "Debugging - Output". + (Maintenance Commands): Add cross-reference to "Debugging Output". (Debugging Output): Document "set/show debug lin-lwp". - (MIPS): Improve documentation of heuristic-fence-post. + (MIPS): Improve documentation of heuristic-fence-post. Document + "set/show mips abi", "set/show mips saved-gpreg-size", "set/show + mips stack-arg-size", "set/show mips mask-address", "set/show mips + remote-mips64-transfers-32bit-regs", "set/show debug mips". (ARM): Document ARM-specific commands. + (AVR): New section. Document "info io_registers". + (CRIS): New section. Document "set/show cris-version" and + "set/show cris-dwarf2-cfi". + (HPPA): New section. Document "set/show debug hppa" and "maint + print unwind". + (Netrino): New subsection. Document "set/show debug nto-debug". + (Super-H): New section. Document the "regs" command. 2005-04-09 Eli Zaretskii diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 20646c6..43e592a 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -12320,6 +12320,7 @@ configurations. * DJGPP Native:: Features specific to the DJGPP port * Cygwin Native:: Features specific to the Cygwin port * Hurd Native:: Features specific to @sc{gnu} Hurd +* Neutrino:: Features specific to QNX Neutrino @end menu @node HP-UX @@ -13010,6 +13011,25 @@ the non-default commands. @end table +@node Neutrino +@subsection QNX Neutrino +@cindex QNX Neutrino + +@value{GDBN} provides the following commands specific to the QNX +Neutrino target: + +@table @code +@item set debug nto-debug +@kindex set debug nto-debug +When set to on, enables debugging messages specific to the QNX +Neutrino support. + +@item show debug nto-debug +@kindex show debug nto-debug +Show the current state of QNX Neutrino messages. +@end table + + @node Embedded OS @section Embedded Operating Systems @@ -13208,6 +13228,9 @@ configurations. * Sparclite:: Fujitsu Sparclite * ST2000:: Tandem ST2000 * Z8000:: Zilog Z8000 +* AVR:: Atmel AVR +* CRIS:: CRIS +* Super-H:: Renesas Super-H @end menu @node ARM @@ -13627,6 +13650,7 @@ Array Tech LSI33K RAID controller board. @item set mipsfpu double @itemx set mipsfpu single @itemx set mipsfpu none +@itemx set mipsfpu auto @itemx show mipsfpu @kindex set mipsfpu @kindex show mipsfpu @@ -14112,6 +14136,62 @@ conventions; for example, @w{@samp{b fputc if $cycles>5000}} sets a conditional breakpoint that suspends only after at least 5000 simulated clock ticks. +@node AVR +@subsection Atmel AVR +@cindex AVR + +When configured for debugging the Atmel AVR, @value{GDBN} supports the +following AVR-specific commands: + +@table @code +@item info io_registers +@kindex info io_registers@r{, AVR} +@cindex I/O registers (Atmel AVR) +This command displays information about the AVR I/O registers. For +each register, @value{GDBN} prints its number and value. +@end table + +@node CRIS +@subsection CRIS +@cindex CRIS + +When configured for debugging CRIS, @value{GDBN} provides the +following CRIS-specific commands: + +@table @code +@item set cris-version @var{ver} +@cindex CRIS version +Set the current CRIS version to @var{ver}. The CRIS version affects +register names and sizes. This command is useful in case +autodetection of the CRIS version fails. + +@item show cris-version +Show the current CRIS version. + +@item set cris-dwarf2-cfi +@cindex DWARF-2 CFI and CRIS +Set the usage of DWARF-2 CFI for CRIS debugging. The default is off +if using @code{gcc-cris} whose version is below @code{R59}, otherwise +on. + +@item show cris-dwarf2-cfi +Show the current state of using DWARF-2 CFI. +@end table + +@node Super-H +@subsection Renesas Super-H +@cindex Super-H + +For the Renesas Super-H processor, @value{GDBN} provides these +commands: + +@table @code +@item regs +@kindex regs@r{, Super-H} +Show the values of all Super-H registers. +@end table + + @node Architectures @section Architectures @@ -14123,6 +14203,7 @@ all uses of @value{GDBN} with the architecture, both native and cross. * A29K:: * Alpha:: * MIPS:: +* HPPA:: HP PA architecture @end menu @node i386 @@ -14213,6 +14294,122 @@ Display the current limit. These commands are available @emph{only} when @value{GDBN} is configured for debugging programs on Alpha or MIPS processors. +Several MIPS-specific commands are available when debugging MIPS +programs: + +@table @code +@item set mips saved-gpreg-size @var{size} +@kindex set mips saved-gpreg-size +@cindex MIPS GP register size on stack +Set the size of MIPS general-purpose registers saved on the stack. +The argument @var{size} can be one of the following: + +@table @samp +@item 32 +32-bit GP registers +@item 64 +64-bit GP registers +@item auto +Use the target's default setting or autodetect the saved size from the +information contained in the executable. This is the default +@end table + +@item show mips saved-gpreg-size +@kindex show mips saved-gpreg-size +Show the current size of MIPS GP registers on the stack. + +@item set mips stack-arg-size @var{size} +@kindex set mips stack-arg-size +@cindex MIPS stack space for arguments +Set the amount of stack space reserved for arguments to functions. +The argument can be one of @code{"32"}, @code{"64"} or @code{"auto"} +(the default). + +@item set mips abi @var{arg} +@kindex set mips abi +@cindex set ABI for MIPS +Tell @value{GDBN} which MIPS ABI is used by the inferior. Possible +values of @var{arg} are: + +@table @samp +@item auto +The default ABI associated with the current binary (this is the +default). +@item o32 +@item o64 +@item n32 +@item n64 +@item eabi32 +@item eabi64 +@item auto +@end table + +@item show mips abi +@kindex show mips abi +Show the MIPS ABI used by @value{GDBN} to debug the inferior. + +@item set mipsfpu +@itemx show mipsfpu +@xref{MIPS Embedded, set mipsfpu}. + +@item set mips mask-address @var{arg} +@kindex set mips mask-address +@cindex MIPS addresses, masking +This command determines whether the most-significant 32 bits of 64-bit +MIPS addresses are masked off. The argument @var{arg} can be +@samp{on}, @samp{off}, or @samp{auto}. The latter is the default +setting, which lets @value{GDBN} determine the correct value. + +@item show mips mask-address +@kindex show mips mask-address +Show whether the upper 32 bits of MIPS addresses are masked off or +not. + +@item set remote-mips64-transfers-32bit-regs +@kindex set remote-mips64-transfers-32bit-regs +This command controls compatibility with 64-bit MIPS targets that +transfer data in 32-bit quantities. If you have an old MIPS 64 target +that transfers 32 bits for some registers, like @sc{sr} and @sc{fsr}, +and 64 bits for other registers, set this option to @samp{on}. + +@item show remote-mips64-transfers-32bit-regs +@kindex show remote-mips64-transfers-32bit-regs +Show the current setting of compatibility with older MIPS 64 targets. + +@item set debug mips +@kindex set debug mips +This command turns on and off debugging messages for the MIPS-specific +target code in @value{GDBN}. + +@item show debug mips +@kindex show debug mips +Show the current setting of MIPS debugging messages. +@end table + + +@node HPPA +@subsection HPPA +@cindex HPPA support + +When @value{GDBN} is debugging te HP PA architecture, it provides the +following special commands: + +@table @code +@item set debug hppa +@kindex set debug hppa +THis command determines whether HPPA architecture specific debugging +messages are to be displayed. + +@item show debug hppa +Show whether HPPA debugging messages are displayed. + +@item maint print unwind @var{address} +@kindex maint print unwind@r{, HPPA} +This command displays the contents of the unwind table entry at the +given @var{address}. + +@end table + @node Controlling GDB @chapter Controlling @value{GDBN} -- 2.7.4