| This is gdb.info, produced by makeinfo version 4.8 from ./gdb.texinfo. |
| |
| INFO-DIR-SECTION Software development |
| START-INFO-DIR-ENTRY |
| * Gdb: (gdb). The GNU debugger. |
| END-INFO-DIR-ENTRY |
| |
| Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, |
| 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, |
| 2010 Free Software Foundation, Inc. |
| |
| Permission is granted to copy, distribute and/or modify this document |
| under the terms of the GNU Free Documentation License, Version 1.3 or |
| any later version published by the Free Software Foundation; with the |
| Invariant Sections being "Free Software" and "Free Software Needs Free |
| Documentation", with the Front-Cover Texts being "A GNU Manual," and |
| with the Back-Cover Texts as in (a) below. |
| |
| (a) The FSF's Back-Cover Text is: "You are free to copy and modify |
| this GNU Manual. Buying copies from GNU Press supports the FSF in |
| developing GNU and promoting software freedom." |
| |
| This file documents the GNU debugger GDB. |
| |
| This is the Ninth Edition, of `Debugging with GDB: the GNU |
| Source-Level Debugger' for GDB (GDB) Version 7.2. |
| |
| Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, |
| 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, |
| 2010 Free Software Foundation, Inc. |
| |
| Permission is granted to copy, distribute and/or modify this document |
| under the terms of the GNU Free Documentation License, Version 1.3 or |
| any later version published by the Free Software Foundation; with the |
| Invariant Sections being "Free Software" and "Free Software Needs Free |
| Documentation", with the Front-Cover Texts being "A GNU Manual," and |
| with the Back-Cover Texts as in (a) below. |
| |
| (a) The FSF's Back-Cover Text is: "You are free to copy and modify |
| this GNU Manual. Buying copies from GNU Press supports the FSF in |
| developing GNU and promoting software freedom." |
| |
| |
| Indirect: |
| gdb.info-1: 1888 |
| gdb.info-2: 297354 |
| gdb.info-3: 596354 |
| gdb.info-4: 902640 |
| gdb.info-5: 1197690 |
| gdb.info-6: 1307181 |
| |
| Tag Table: |
| (Indirect) |
| Node: Top1888 |
| Node: Summary5015 |
| Node: Free Software6720 |
| Node: Contributors12288 |
| Node: Sample Session20377 |
| Node: Invocation27213 |
| Node: Invoking GDB27757 |
| Node: File Options30070 |
| Node: Mode Options32807 |
| Node: Startup39406 |
| Ref: Startup-Footnote-141628 |
| Node: Quitting GDB41737 |
| Node: Shell Commands42634 |
| Node: Logging Output43476 |
| Node: Commands44322 |
| Node: Command Syntax44960 |
| Node: Completion47126 |
| Ref: Completion-Footnote-152332 |
| Node: Help52492 |
| Node: Running57733 |
| Node: Compilation58962 |
| Node: Starting60939 |
| Node: Arguments69829 |
| Node: Environment71099 |
| Node: Working Directory74367 |
| Node: Input/Output75475 |
| Node: Attach77446 |
| Node: Kill Process79913 |
| Node: Inferiors and Programs80894 |
| Node: Threads88064 |
| Node: Forks96442 |
| Node: Checkpoint/Restart102750 |
| Ref: Checkpoint/Restart-Footnote-1107279 |
| Node: Stopping107314 |
| Node: Breakpoints108473 |
| Node: Set Breaks111909 |
| Ref: Set Breaks-Footnote-1128201 |
| Node: Set Watchpoints128449 |
| Node: Set Catchpoints136458 |
| Node: Delete Breaks145654 |
| Node: Disabling147590 |
| Node: Conditions150443 |
| Node: Break Commands155392 |
| Node: Save Breakpoints158616 |
| Node: Error in Breakpoints159792 |
| Node: Breakpoint-related Warnings160523 |
| Node: Continuing and Stepping162850 |
| Node: Signals172210 |
| Ref: extra signal information176482 |
| Node: Thread Stops177985 |
| Node: All-Stop Mode179084 |
| Node: Non-Stop Mode182982 |
| Node: Background Execution186459 |
| Node: Thread-Specific Breakpoints189028 |
| Node: Interrupted System Calls190350 |
| Node: Observer Mode191864 |
| Node: Reverse Execution195303 |
| Ref: Reverse Execution-Footnote-1199930 |
| Ref: Reverse Execution-Footnote-2200557 |
| Node: Process Record and Replay200607 |
| Node: Stack207854 |
| Node: Frames209347 |
| Node: Backtrace212099 |
| Ref: Backtrace-Footnote-1217330 |
| Node: Selection217518 |
| Node: Frame Info220382 |
| Node: Source222713 |
| Node: List223779 |
| Node: Specify Location226392 |
| Node: Edit229642 |
| Ref: Edit-Footnote-1231117 |
| Node: Search231352 |
| Node: Source Path232160 |
| Ref: set substitute-path238418 |
| Node: Machine Code240639 |
| Node: Data247313 |
| Node: Expressions249983 |
| Node: Ambiguous Expressions252075 |
| Node: Variables255309 |
| Node: Arrays259812 |
| Node: Output Formats262343 |
| Ref: Output Formats-Footnote-1265531 |
| Node: Memory265688 |
| Node: Auto Display271842 |
| Node: Print Settings275557 |
| Node: Pretty Printing289161 |
| Node: Value History290198 |
| Node: Convenience Vars292619 |
| Node: Registers297354 |
| Ref: Registers-Footnote-1302031 |
| Node: Floating Point Hardware302426 |
| Node: Vector Unit302958 |
| Node: OS Information303345 |
| Node: Memory Region Attributes305990 |
| Node: Dump/Restore Files310660 |
| Node: Core File Generation312965 |
| Node: Character Sets314199 |
| Node: Caching Remote Data320566 |
| Ref: Caching Remote Data-Footnote-1322367 |
| Node: Searching Memory322605 |
| Node: Optimized Code325482 |
| Node: Inline Functions327092 |
| Node: Macros330062 |
| Node: Tracepoints337165 |
| Node: Set Tracepoints339226 |
| Node: Create and Delete Tracepoints342165 |
| Node: Enable and Disable Tracepoints347053 |
| Node: Tracepoint Passcounts347837 |
| Node: Tracepoint Conditions349264 |
| Node: Trace State Variables350957 |
| Node: Tracepoint Actions353147 |
| Node: Listing Tracepoints358487 |
| Node: Listing Static Tracepoint Markers359605 |
| Node: Starting and Stopping Trace Experiments361451 |
| Node: Tracepoint Restrictions365865 |
| Node: Analyze Collected Data369618 |
| Node: tfind370923 |
| Node: tdump375345 |
| Node: save tracepoints377860 |
| Node: Tracepoint Variables378356 |
| Node: Trace Files379484 |
| Node: Overlays380942 |
| Node: How Overlays Work381662 |
| Ref: A code overlay384222 |
| Node: Overlay Commands387660 |
| Node: Automatic Overlay Debugging391850 |
| Node: Overlay Sample Program393991 |
| Node: Languages395751 |
| Node: Setting396914 |
| Node: Filenames398616 |
| Node: Manually399427 |
| Node: Automatically400636 |
| Node: Show401697 |
| Node: Checks403019 |
| Node: Type Checking404409 |
| Node: Range Checking407142 |
| Node: Supported Languages409543 |
| Node: C410753 |
| Node: C Operators412044 |
| Node: C Constants416363 |
| Node: C Plus Plus Expressions418767 |
| Node: C Defaults422310 |
| Node: C Checks422993 |
| Node: Debugging C423716 |
| Node: Debugging C Plus Plus424200 |
| Node: Decimal Floating Point427387 |
| Node: D428646 |
| Node: Objective-C428912 |
| Node: Method Names in Commands429373 |
| Node: The Print Command with Objective-C431068 |
| Node: Fortran431719 |
| Node: Fortran Operators432444 |
| Node: Fortran Defaults433300 |
| Node: Special Fortran Commands433685 |
| Node: Pascal434191 |
| Node: Modula-2434706 |
| Node: M2 Operators435681 |
| Node: Built-In Func/Proc438680 |
| Node: M2 Constants441541 |
| Node: M2 Types443142 |
| Node: M2 Defaults446361 |
| Node: Deviations446961 |
| Node: M2 Checks448062 |
| Node: M2 Scope448880 |
| Node: GDB/M2449904 |
| Node: Ada450816 |
| Node: Ada Mode Intro451763 |
| Node: Omissions from Ada453673 |
| Node: Additions to Ada458027 |
| Node: Stopping Before Main Program461957 |
| Node: Ada Tasks462486 |
| Node: Ada Tasks and Core Files468899 |
| Node: Ada Glitches469812 |
| Node: Unsupported Languages472879 |
| Node: Symbols473569 |
| Node: Altering487398 |
| Node: Assignment488367 |
| Node: Jumping491472 |
| Node: Signaling493607 |
| Node: Returning494738 |
| Node: Calling498090 |
| Node: Patching501117 |
| Node: GDB Files502194 |
| Node: Files502782 |
| Ref: Shared Libraries515617 |
| Ref: Files-Footnote-1525851 |
| Node: Separate Debug Files526026 |
| Node: Symbol Errors537598 |
| Node: Data Files541220 |
| Node: Targets542059 |
| Node: Active Targets543539 |
| Node: Target Commands545118 |
| Ref: load549391 |
| Node: Byte Order550372 |
| Node: Remote Debugging551349 |
| Node: Connecting552611 |
| Node: File Transfer557551 |
| Node: Server558491 |
| Ref: Monitor Commands for gdbserver566141 |
| Ref: Server-Footnote-1570690 |
| Node: Remote Configuration570810 |
| Ref: set remotebreak571834 |
| Ref: set remote hardware-watchpoint-limit573298 |
| Ref: set remote hardware-breakpoint-limit573298 |
| Ref: set remote exec-file573580 |
| Node: Remote Stub579783 |
| Node: Stub Contents582680 |
| Node: Bootstrapping584791 |
| Node: Debug Session588600 |
| Node: Configurations590160 |
| Node: Native590929 |
| Node: HP-UX591564 |
| Node: BSD libkvm Interface591853 |
| Node: SVR4 Process Information592924 |
| Node: DJGPP Native596354 |
| Node: Cygwin Native602934 |
| Node: Non-debug DLL Symbols606883 |
| Node: Hurd Native611431 |
| Node: Neutrino616694 |
| Node: Darwin617084 |
| Node: Embedded OS618342 |
| Node: VxWorks618818 |
| Node: VxWorks Connection621035 |
| Node: VxWorks Download621969 |
| Node: VxWorks Attach623704 |
| Node: Embedded Processors624102 |
| Node: ARM625281 |
| Node: M32R/D629402 |
| Node: M68K631104 |
| Node: MicroBlaze631397 |
| Node: MIPS Embedded632847 |
| Node: OpenRISC 1000637797 |
| Node: PowerPC Embedded640652 |
| Node: PA642544 |
| Node: Sparclet642833 |
| Node: Sparclet File644317 |
| Node: Sparclet Connection645197 |
| Node: Sparclet Download645675 |
| Node: Sparclet Execution646724 |
| Node: Sparclite647315 |
| Node: Z8000647690 |
| Node: AVR649074 |
| Node: CRIS649437 |
| Node: Super-H650415 |
| Node: Architectures651530 |
| Node: i386651952 |
| Node: A29K652634 |
| Node: Alpha653473 |
| Node: MIPS653606 |
| Node: HPPA656230 |
| Node: SPU656749 |
| Node: PowerPC658937 |
| Node: Controlling GDB659655 |
| Node: Prompt660481 |
| Node: Editing661260 |
| Node: Command History662203 |
| Node: Screen Size665607 |
| Node: Numbers667441 |
| Node: ABI669418 |
| Node: Messages/Warnings672347 |
| Ref: confirmation requests673773 |
| Node: Debugging Output674980 |
| Node: Other Misc Settings680899 |
| Node: Extending GDB681666 |
| Node: Sequences683157 |
| Node: Define683752 |
| Node: Hooks687365 |
| Node: Command Files689732 |
| Node: Output694802 |
| Node: Python699735 |
| Node: Python Commands700590 |
| Node: Python API702265 |
| Node: Basic Python703924 |
| Node: Exception Handling707856 |
| Node: Values From Inferior709925 |
| Node: Types In Python715522 |
| Node: Pretty Printing API722996 |
| Node: Selecting Pretty-Printers726895 |
| Node: Disabling Pretty-Printers731007 |
| Node: Inferiors In Python731881 |
| Node: Threads In Python734441 |
| Node: Commands In Python736167 |
| Node: Parameters In Python744983 |
| Node: Functions In Python749739 |
| Node: Progspaces In Python751852 |
| Node: Objfiles In Python753214 |
| Node: Frames In Python754749 |
| Node: Blocks In Python758143 |
| Node: Symbols In Python759745 |
| Node: Symbol Tables In Python764866 |
| Node: Breakpoints In Python766525 |
| Node: Lazy Strings In Python771496 |
| Node: Auto-loading773770 |
| Node: objfile-gdb.py file774845 |
| Node: .debug_gdb_scripts section776100 |
| Node: Which flavor to choose?777477 |
| Node: Interpreters779294 |
| Node: TUI781393 |
| Node: TUI Overview782360 |
| Node: TUI Keys784793 |
| Node: TUI Single Key Mode787097 |
| Node: TUI Commands787972 |
| Node: TUI Configuration790356 |
| Node: Emacs791652 |
| Node: GDB/MI797129 |
| Node: GDB/MI General Design798977 |
| Node: Context management801500 |
| Node: Asynchronous and non-stop modes804635 |
| Node: Thread groups806627 |
| Node: GDB/MI Command Syntax808905 |
| Node: GDB/MI Input Syntax809148 |
| Node: GDB/MI Output Syntax810702 |
| Node: GDB/MI Compatibility with CLI814274 |
| Node: GDB/MI Development and Front Ends815011 |
| Node: GDB/MI Output Records816668 |
| Node: GDB/MI Result Records817003 |
| Node: GDB/MI Stream Records818009 |
| Node: GDB/MI Async Records819274 |
| Node: GDB/MI Frame Information825399 |
| Node: GDB/MI Thread Information826477 |
| Node: GDB/MI Simple Examples827415 |
| Node: GDB/MI Command Description Format829592 |
| Node: GDB/MI Breakpoint Commands830472 |
| Node: GDB/MI Program Context848468 |
| Node: GDB/MI Thread Commands852736 |
| Node: GDB/MI Program Execution855614 |
| Node: GDB/MI Stack Manipulation867395 |
| Node: GDB/MI Variable Objects878089 |
| Ref: -var-set-format887821 |
| Ref: -var-list-children888939 |
| Ref: -var-update897120 |
| Ref: -var-set-frozen899817 |
| Ref: -var-set-update-range900613 |
| Ref: -var-set-visualizer901143 |
| Node: GDB/MI Data Manipulation902640 |
| Node: GDB/MI Tracepoint Commands917020 |
| Node: GDB/MI Symbol Query924349 |
| Node: GDB/MI File Commands925038 |
| Node: GDB/MI Target Manipulation928375 |
| Node: GDB/MI File Transfer Commands934597 |
| Node: GDB/MI Miscellaneous Commands935919 |
| Ref: -interpreter-exec945318 |
| Node: Annotations947631 |
| Node: Annotations Overview948550 |
| Node: Server Prefix951013 |
| Node: Prompting951747 |
| Node: Errors953264 |
| Node: Invalidation954160 |
| Node: Annotations for Running954637 |
| Node: Source Annotations956157 |
| Node: JIT Interface957082 |
| Node: Declarations958800 |
| Node: Registering Code960187 |
| Node: Unregistering Code961159 |
| Node: GDB Bugs961760 |
| Node: Bug Criteria962489 |
| Node: Bug Reporting963366 |
| Node: Command Line Editing970989 |
| Node: Introduction and Notation971641 |
| Node: Readline Interaction973261 |
| Node: Readline Bare Essentials974450 |
| Node: Readline Movement Commands976237 |
| Node: Readline Killing Commands977200 |
| Node: Readline Arguments979118 |
| Node: Searching980160 |
| Node: Readline Init File982309 |
| Node: Readline Init File Syntax983372 |
| Node: Conditional Init Constructs995304 |
| Node: Sample Init File997835 |
| Node: Bindable Readline Commands1000950 |
| Node: Commands For Moving1002005 |
| Node: Commands For History1002864 |
| Node: Commands For Text1005986 |
| Node: Commands For Killing1008710 |
| Node: Numeric Arguments1010850 |
| Node: Commands For Completion1011987 |
| Node: Keyboard Macros1013529 |
| Node: Miscellaneous Commands1014098 |
| Node: Readline vi Mode1017457 |
| Node: Using History Interactively1018374 |
| Node: History Interaction1018889 |
| Node: Event Designators1020311 |
| Node: Word Designators1021244 |
| Node: Modifiers1022881 |
| Node: Formatting Documentation1024106 |
| Ref: Formatting Documentation-Footnote-11027435 |
| Node: Installing GDB1027499 |
| Node: Requirements1028071 |
| Ref: Expat1028640 |
| Node: Running Configure1030775 |
| Node: Separate Objdir1034314 |
| Node: Config Names1037198 |
| Node: Configure Options1038643 |
| Node: System-wide configuration1041013 |
| Node: Maintenance Commands1042308 |
| Ref: maint info breakpoints1043492 |
| Node: Remote Protocol1057527 |
| Node: Overview1058089 |
| Ref: Binary Data1060651 |
| Node: Packets1062910 |
| Ref: thread-id syntax1063810 |
| Ref: extended mode1065255 |
| Ref: bc1066976 |
| Ref: bs1067186 |
| Ref: read registers packet1068612 |
| Ref: cycle step packet1069776 |
| Ref: write register packet1071652 |
| Ref: step with signal packet1072559 |
| Ref: vStopped packet1078840 |
| Ref: X packet1079183 |
| Ref: insert breakpoint or watchpoint packet1079469 |
| Node: Stop Reply Packets1082231 |
| Node: General Query Packets1086971 |
| Ref: QNonStop1095911 |
| Ref: QPassSignals1096535 |
| Ref: qSearch memory1098612 |
| Ref: QStartNoAckMode1099110 |
| Ref: qSupported1099640 |
| Ref: multiprocess extensions1108362 |
| Ref: qXfer read1112192 |
| Ref: qXfer auxiliary vector read1112686 |
| Ref: qXfer target description read1113035 |
| Ref: qXfer library list read1113479 |
| Ref: qXfer memory map read1114125 |
| Ref: qXfer sdata read1114511 |
| Ref: qXfer siginfo read1114975 |
| Ref: qXfer spu read1115371 |
| Ref: qXfer threads read1115894 |
| Ref: qXfer osdata read1116287 |
| Ref: qXfer write1117489 |
| Ref: qXfer siginfo write1118046 |
| Ref: qXfer spu write1118442 |
| Ref: General Query Packets-Footnote-11120529 |
| Node: Architecture-Specific Protocol Details1120856 |
| Node: Tracepoint Packets1122369 |
| Node: Host I/O Packets1138816 |
| Node: Interrupts1142958 |
| Node: Notification Packets1144861 |
| Node: Remote Non-Stop1147132 |
| Node: Packet Acknowledgment1151391 |
| Node: Examples1153506 |
| Node: File-I/O Remote Protocol Extension1154132 |
| Node: File-I/O Overview1154594 |
| Node: Protocol Basics1156791 |
| Node: The F Request Packet1159023 |
| Node: The F Reply Packet1159924 |
| Node: The Ctrl-C Message1160842 |
| Node: Console I/O1162471 |
| Node: List of Supported Calls1163688 |
| Node: open1164050 |
| Node: close1166544 |
| Node: read1166926 |
| Node: write1167533 |
| Node: lseek1168300 |
| Node: rename1169178 |
| Node: unlink1170574 |
| Node: stat/fstat1171513 |
| Node: gettimeofday1172400 |
| Node: isatty1172835 |
| Node: system1173431 |
| Node: Protocol-specific Representation of Datatypes1174973 |
| Node: Integral Datatypes1175350 |
| Node: Pointer Values1176157 |
| Node: Memory Transfer1176865 |
| Node: struct stat1177485 |
| Node: struct timeval1179687 |
| Node: Constants1180204 |
| Node: Open Flags1180653 |
| Node: mode_t Values1180994 |
| Node: Errno Values1181486 |
| Node: Lseek Flags1182297 |
| Node: Limits1182482 |
| Node: File-I/O Examples1182842 |
| Node: Library List Format1183958 |
| Node: Memory Map Format1186722 |
| Node: Thread List Format1189282 |
| Node: Agent Expressions1190069 |
| Node: General Bytecode Design1192890 |
| Node: Bytecode Descriptions1197690 |
| Node: Using Agent Expressions1209401 |
| Node: Varying Target Capabilities1211379 |
| Node: Rationale1212541 |
| Node: Trace File Format1219927 |
| Node: Target Descriptions1221908 |
| Node: Retrieving Descriptions1223968 |
| Node: Target Description Format1225053 |
| Node: Predefined Target Types1234103 |
| Node: Standard Target Features1235488 |
| Node: ARM Features1237259 |
| Node: i386 Features1238535 |
| Node: MIPS Features1239644 |
| Node: M68K Features1240589 |
| Node: PowerPC Features1241252 |
| Node: Operating System Information1242536 |
| Node: Process list1243374 |
| Node: Copying1244436 |
| Node: GNU Free Documentation License1282023 |
| Node: Index1307181 |
| |
| End Tag Table |
