Manuals / Brands / Computer Equipment / Computer Hardware / HP / Computer Equipment / Computer Hardware

HP gnu source-level debugger 5992-4701 manual

1 369

Download 369 pages, 2 Mb

Debugging with GDB Manual

The GNU Source-Level Debugger

HP Part Number: 5992-4701

Published: February 2009

Edition: 19

Contents

Page Page Table of Contents Page Page Page Page Page Page Page Page Page List of Tables List of Examples Summary of GDB Free Software Contributors to GDB Page Page Page 1 A Sample GDB Session 1.1 Loading the Executable 1.2 Setting Display width 1.3 Setting Breakpoints 1.4 Running the executable under GDB 1.5 Stepping to the next line in the source program 1.6Stepping into a subroutine 1.7 Examining the Stack 1.8Printing Variable Values 1.9 Listing Source Code 1.10 Setting Variable Values During a Session Page Page 2 Getting In and Out of GDB 2.1Invoking GDB 2.1.1 Choosing files 2.1.2 Choosing modes Page Page 2.2 Quitting GDB 2.3 Shell commands Page 3 GDB Commands 3.1Command syntax 3.2Command completion Page 3.3 Getting help Page Page Page 4 Running Programs Under GDB 4.1 Compiling for debugging 4.2 Starting your program Page 4.3Arguments To Your Program 4.4 Program Environment Page 4.5 Working directory 4.6 Program Input and Output 4.7Debugging a Running Process 4.8 Killing the child process 4.9 Debugging programs with multiple threads Page Page 4.10 Debugging programs with multiple processes Page 5 Stopping and Continuing 5.1 Breakpoints 5.1.1 Setting breakpoints Page Page Page 5.1.2 Setting catchpoints Page 5.1.3 Deleting breakpoints 5.1.4 Disabling breakpoints 5.1.5 Break conditions Page 5.1.6 Breakpoint command lists 5.1.7 Breakpoint menus 5.1.8“Cannot insert breakpoints” 5.2 Continuing and stepping Page Page 5.3 Signals Page 5.4 Stopping and starting multi-threadprograms Page 6 Examining the Stack 6.1 Stack frames 6.2 Stacks Without frames 6.3 Commands for Examining the Stack 6.4 Backtraces 6.5 Selecting a frame 6.6 Information about a frame Page Page 7 Examining Source Files 7.1 Printing source lines 7.2 Searching source files 7.3 Specifying source directories 7.4Source and machine code Page Page 8 Examining Data 8.1 Expressions 8.2 Program variables 8.3 Artificial arrays 8.4Output formats 8.5 Examining memory Page 8.6 Automatic display 8.7 Print settings Page Page Page Page 8.8 Value history 8.9 Convenience variables Page 8.10 Registers 8.11 Printing Floating Point Values 8.12 Floating point hardware Page 9 Using GDB with Different Languages 9.1 Switching between source languages 9.1.2 Setting the working language 9.1.3 Having GDB infer the source language 9.2 Displaying the language 9.3 Type and range checking 9.3.2 An overview of range checking 9.4 Supported languages 9.4.1 C and C++ Page Page Page Page Page 9.4.2 Fortran Page Page 10 Examining the Symbol Table Page Page Page 11 Altering Execution 11.1 Assignment to variables 11.2 Continuing at a different address 11.3 Giving your program a signal 11.4 Returning from a function 11.5 Calling program functions 11.6 Patching programs Page Page 12 GDB Files 12.1 Commands to specify files Page Page Page Page 12.2 Specifying shared library locations 12.3 Errors reading symbol files Page 13 Specifying a Debugging Target 13.1 Active targets 13.2 Commands for managing targets Page 13.3 Choosing target byte order Page 14 HP-UX Configuration-SpecificInformation 14.1 Summary of HP Enhancements to GDB Page Page 14.2 HP-UXdependencies Page 14.3Supported Platforms and Modes 14.4 HP-UXtargets 14.5 Support for Alternate root 14.6 Specifying object file directories 14.7Fix and continue debugging 14.7.1 Fix and Continue compiler dependencies 14.7.2Fix and Continue restrictions 14.7.3Using Fix and Continue 14.7.4Example Fix and Continue session Page 14.8 Inline Support 14.8.2 Inline Debugging in Integrity Systems Page 14.9Debugging Macros Page 14.9.2 Examples for Macro Debugging Page 14.10 Debugging Memory Problems 14.10.1 When to suspect a memory leak 14.10.2 Memory debugging restrictions 14.10.3Memory Debugging Methodologies 14.10.4Debugging Memory in Interactive Mode Page Page Page Page 14.10.5Debugging Memory in Batch Mode Page Page Page Page Page Page 14.10.6Debugging Memory Interactively After Attaching to a Running Process Page 14.10.7 Configuring memory debugging settings 14.10.8 Scenarios in memory debugging Page 14.10.9Comparison of Memory Debugging Commands in Interactive Mode and Batch Mode Page 14.10.10 Heap Profiling Page 14.10.11 Memory Checking Analysis for User Defined Memory Management Routines 14.10.12Commands to track the change in data segment value 14.11Thread Debugging Support 14.11.2 Backtrace Support for Thread Debugging 14.11.3 Advanced Thread Debugging Support Page Page Page Page 14.11.4 Debugging Threads Interactively After Attaching to a Process Page 14.11.5Thread Debugging in Batch Mode Page Page Page 14.11.6 Thread Debugging in +check Mode 14.12 Debugging MPI Programs 14.13Debugging multiple processes ( programs with fork and vfork calls) 14.14 Command to Search for a Pattern in the Memory Address Space Page Page Page 14.15Debugging Core Files 14.15.2 Support for the info target Command 14.15.3Support for the dumpcore command 14.16 Printing the Execution Path Entries for the Current Frame or Thread 14.16.1Compiler Dependencies for Printing the Execution Path Entries 14.16.2 Example Illustrating Execution Path Recovery 14.17 Command to Unwind Beyond 10000 Frames 14.18 Invoking GDB Before a Program Aborts 14.19 Aborting a Command Line Call 14.20 Instruction Level Stepping 14.21 Enhanced support for watchpoints and breakpoints 14.21.4 Support for procedural breakpoints 14.21.5 Support for template breakpoints 14.22Debugging support for shared libraries 14.22.2 Setting Deferred Breakpoints in Shared Library 14.22.3 Using catch load 14.22.4 Privately mapping shared libraries 14.22.5 Selectively Mapping Shared Libraries As Private 14.23 Debugging support for Decimal Floating Point data type 14.23.2 Printing NaT Registers 14.23.3 Handling Decimal Floating Point Data types 14.23.4 Evaluating Decimal Floating Point data types Page 14.24Additional Support for binary floating point data type 14.25 Language support Page Page Page 14.25.2 Enhanced support for C++ templates 14.25.3 Support for _ _fpreg data type on IPF 14.25.4 Support for _Complex variables in HP C 14.25.5 Support for debugging namespaces 14.26 Viewing Wide Character Strings 14.27 Support for output logging 14.27.2 Support for Fortran array slices 14.27.3 Displaying enumerators 14.27.4 Support for debugging typedefs 14.27.5 Support for steplast command for C and C++ 14.28 Getting information from a non-debugexecutable 14.29 Debugging optimized code Page 14.29.1 Debugging Optimized Code at Various Optimization Levels 14.30 Debugging with ARIES 14.30.1 Debugging the application using GDB under ARIES 14.30.2Attaching GDB to an already running emulated process 14.30.3 Detecting memory leaks using GDB under ARIES 14.31 Visual Interface for WDB 14.31.2 Navigating the Visual Interface for WDB display 14.31.3 Specifying foreground and background colors 14.31.4 Using the X-windowgraphical interface 14.31.5 Using the TUI mode 14.31.6Changing the size of the source or debugger pane 14.31.7 Using commands to browse through source files 14.31.8 Loading source files 14.31.9 Editing source files 14.31.10 Editing the command line and command-linehistory 14.31.11 Saving the contents of a debugging session to a file 14.32 Support for ddd 14.33 Support for XDB commands 14.34 GNU GDB Logging Commands 14.35Support for command line calls in a stripped executable 14.35.2Additional support for command line calls in a stripped executable 14.35.3Support for debugging stripped binaries 14.36 Displaying the current block scope information 14.37 Linux support Page 15 The HP-UXTerminal User Interface 15.1 Starting the TUI 15.2 Automatically running a program at startup 15.3 Screen Layouts 15.3.1 Source pane 15.3.2 Disassembly pane 15.3.3 Source/Disassembly pane 15.3.4 Disassembly/Register pane 15.3.5 Source/Register pane 15.4 Cycling through the panes 15.5 Changing pane focus Page 15.6 Scrolling panes 15.7 Changing the register display 15.8 Changing the pane size 15.9 Refreshing and updating the window 16 XDB to WDB Transition Guide 16.1By-functionlists of XDB commands and HP WDB equivalents 16.1.1Invocation commands 16.1.2 Window mode commands 16.1.3 File viewing commands 16.1.4 Source directory mapping commands 16.1.5 Data Viewing and modification commands Page 16.1.6 Stack viewing commands 16.1.7 Status-viewingcommand 16.1.8 Job control commands 16.2 Overall breakpoint commands 16.2.2 Breakpoint creation commands 16.2.3 Breakpoint status commands 16.2.4 All-proceduresbreakpoint commands 16.2.5 Global breakpoint commands 16.2.6 Assertion control commands 16.2.7 Record and playback commands 16.2.8 Macro facility commands 16.2.9 Signal control commands 16.2.10 Miscellaneous commands 16.3 XDB data formats and HP WDB equivalents Page 16.4XDB location syntax and HP WDB equivalents 16.5 XDB special language operators and HP WDB equivalents 16.6 XDB special variables and HP WDB equivalents 16.7 XDB variable identifiers and HP WDB equivalents 16.8Alphabetical lists of XDB commands and HP WDB equivalents 16.8.2 B 16.8.3 C through D 16.8.4 F through K 16.8.5 L 16.8.6 M through P 16.8.7 Q through S 16.8.8 T 16.8.9 U through Z 16.8.10 Symbols Page Page Page 17 Controlling GDB 17.1 Setting the GDB Prompt 17.2 Setting Command Editing Options in GDB 17.3 Setting Command History Feature in GDB Page 17.4 Setting the GDB Screen Size 17.5 Supported Number Formats 17.6 Optional warnings and messages 17.7 Optional messages about internal happenings Page 18 Canned Sequences of Commands 18.1User-definedcommands 18.2 User-definedcommand hooks 18.3 Command files 18.4 Commands for controlled output Page Page 19 Using GDB under gnu Emacs Page Page Page 20 GDB Annotations 20.1 What is an annotation 20.2 The server prefix 20.3 Values 20.4 Frames Page 20.5 Displays 20.6 Annotation for GDB input 20.7 Errors 20.8 Information on breakpoints 20.9 Invalidation notices 20.10 Running the program 20.11 Displaying source 20.12Annotations We Might Want in the Future Page 21 The GDB/MI Interface 21.1 GDB/MI Command Syntax 21.1.2GDB/MI Output syntax Page 21.2 GDB/MI compatibility with CLI 21.3 GDB/MI output records 21.4 GDB/MI command description format 21.5 GDB/MI breakpoint table commands The -break-condition command The -break-delete command The -break-disable command The -break-enable command The -break-info Command The -break-insert command The -break-list command The -break-watch command Page 21.6 GDB/MI Data manipulation Page The -data-evaluate-expression command The -data-list-changed-registers Command The -data-list-register-names command The -data-list-register-values command The -data-read-memory command Page The -display-delete command The -display-disable Command The -display-enable command The -display-insert Command The -display-list command The -environment-cd command The -environment-directory command The -environment-path command 21.7 GDB/MI program control The -exec-abort command The -exec-arguments command The -exec-continue command The -exec-finish command The -exec-interrupt command The -exec-next command The -exec-next-instruction command The -exec-return command The -exec-run command The -exec-show-argumentscommand The -exec-step Command The -exec-step-instruction command The -exec-until command The -file-exec-and-symbols command The -file-exec-file command The -file-list-exec-sections command The -file-list-exec-source-files command The -file-list-shared-libraries command 21.8 Miscellaneous GDB commands in GDB/MI The -gdb-set command The -gdb-show command The -gdb-version command 21.9 GDB/MI Stack Manipulation Commands The -stack-list-argumentscommand The -stack-list-frames command Page The -stack-list-locals command The -stack-select-frame command 21.10 GDB/MI Symbol query commands The -symbol-info-line command The -symbol-info-symbol command The -symbol-list-functions command The -symbol-list-types command The -symbol-list-variables command The -symbol-locate command The -symbol-type command 21.11 GDB/MI Target Manipulation Commands The -target-download command The -target-exec-status command The -target-list-available-targets command The -target-list-current-targets command The -target-list-parameters command 21.12 GDB/MI thread commands The -thread-list-ids command The -thread-select command 21.13 GDB/MI tracepoint commands 21.14 GDB/MI variable objects The -var-create command The -var-delete command The -var-set-format command The -var-show-format command The -var-info-num-children command The -var-list-children command The -var-info-type command The -var-info-expression command The -var-show-attributes command The -var-evaluate-expression command The -var-assign command The -var-update command Page 22 Reporting Bugs in GDB 22.1 Have you found a bug 22.2How to report bugs Page Page Page A Installing GDB A.1 Compiling GDB in another directory A.2 Specifying names for hosts and targets A.3 configure options

Related pages Section 4Troubleshooting for Motorola BR700 SPECIFICATIONS for Bakers Pride Oven CH-8J When selecting the VIDEO 2 OUT for Sherwood R-965 Frequently asked questions for Miele G 1180 Chapitre 1 Branchements et installation for RCA J32HE720 11. Parts list 11. Liste des pièces 11. Lista de piezas for Zenoah CHTZ2401, CHTZ2401L, HTZ2401, HTZ2401L Selecting languages using the language code list for Pioneer S-DV440 Your device displays network or service error messages for Samsung SM-G925FZWASER Default temperature . . . 400 F 200 C for Miele H4780B SETTING THE AIR ADJUSTMENT PLATE for Weil-McLain 800058000-Brn-PO Rie F5 Dimensional Diagrams for Heatcraft Refrigeration Products H-IM-82C