1This is gdb.info, produced by makeinfo version 4.8 from 2../.././gdb/doc/gdb.texinfo. 3 4INFO-DIR-SECTION Software development 5START-INFO-DIR-ENTRY 6* Gdb: (gdb). The GNU debugger. 7END-INFO-DIR-ENTRY 8 9 This file documents the GNU debugger GDB. 10 11 This is the Ninth Edition, of `Debugging with GDB: the GNU 12Source-Level Debugger' for GDB Version 6.7.1. 13 14 Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 151998, 161999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 17Free Software Foundation, Inc. 18 19 Permission is granted to copy, distribute and/or modify this document 20under the terms of the GNU Free Documentation License, Version 1.1 or 21any later version published by the Free Software Foundation; with the 22Invariant Sections being "Free Software" and "Free Software Needs Free 23Documentation", with the Front-Cover Texts being "A GNU Manual," and 24with the Back-Cover Texts as in (a) below. 25 26 (a) The FSF's Back-Cover Text is: "You are free to copy and modify 27this GNU Manual. Buying copies from GNU Press supports the FSF in 28developing GNU and promoting software freedom." 29 30 31Indirect: 32gdb.info-1: 1111 33gdb.info-2: 300312 34gdb.info-3: 600312 35gdb.info-4: 896157 36 37Tag Table: 38(Indirect) 39Node: Top1111 40Node: Summary3819 41Node: Free Software5455 42Node: Contributors11023 43Node: Sample Session19007 44Node: Invocation25845 45Node: Invoking GDB26389 46Node: File Options28702 47Node: Mode Options31463 48Node: Startup37875 49Ref: Startup-Footnote-139780 50Node: Quitting GDB39889 51Node: Shell Commands40786 52Node: Logging Output41628 53Node: Commands42474 54Node: Command Syntax43112 55Node: Completion45278 56Node: Help49613 57Node: Running54853 58Node: Compilation56035 59Node: Starting58674 60Node: Arguments63563 61Node: Environment64833 62Node: Working Directory68101 63Node: Input/Output69209 64Node: Attach71180 65Node: Kill Process73647 66Node: Threads74613 67Node: Processes80773 68Node: Checkpoint/Restart85824 69Ref: Checkpoint/Restart-Footnote-190357 70Node: Stopping90392 71Node: Breakpoints91539 72Node: Set Breaks94958 73Node: Set Watchpoints107583 74Node: Set Catchpoints115420 75Node: Delete Breaks119397 76Node: Disabling121114 77Node: Conditions123881 78Node: Break Commands128829 79Node: Breakpoint Menus131714 80Node: Error in Breakpoints133446 81Node: Breakpoint-related Warnings135024 82Node: Continuing and Stepping137351 83Node: Signals146692 84Node: Thread Stops150964 85Node: Stack155569 86Node: Frames157045 87Node: Backtrace159797 88Ref: Backtrace-Footnote-1164688 89Node: Selection164876 90Node: Frame Info167740 91Node: Source170071 92Node: List171075 93Node: Edit174604 94Ref: Edit-Footnote-1176335 95Node: Search176570 96Node: Source Path177378 97Ref: set substitute-path183133 98Node: Machine Code185354 99Node: Data188764 100Node: Expressions191145 101Node: Variables193113 102Node: Arrays197604 103Node: Output Formats200133 104Ref: Output Formats-Footnote-1203006 105Node: Memory203163 106Node: Auto Display208410 107Node: Print Settings212123 108Node: Value History223908 109Node: Convenience Vars226324 110Node: Registers229848 111Ref: Registers-Footnote-1234523 112Node: Floating Point Hardware234918 113Node: Vector Unit235448 114Node: OS Information235833 115Node: Memory Region Attributes237831 116Node: Dump/Restore Files242490 117Node: Core File Generation244793 118Node: Character Sets246025 119Node: Caching Remote Data252850 120Node: Macros253998 121Node: Tracepoints260949 122Node: Set Tracepoints262791 123Node: Create and Delete Tracepoints263991 124Node: Enable and Disable Tracepoints265635 125Node: Tracepoint Passcounts266334 126Node: Tracepoint Actions267758 127Node: Listing Tracepoints270758 128Node: Starting and Stopping Trace Experiments271880 129Node: Analyze Collected Data273061 130Node: tfind274366 131Node: tdump278759 132Node: save-tracepoints280418 133Node: Tracepoint Variables280837 134Node: Overlays281852 135Node: How Overlays Work282572 136Ref: A code overlay285132 137Node: Overlay Commands288570 138Node: Automatic Overlay Debugging292760 139Node: Overlay Sample Program294901 140Node: Languages296661 141Node: Setting297824 142Node: Filenames299526 143Node: Manually300312 144Node: Automatically301521 145Node: Show302582 146Node: Checks303904 147Node: Type Checking305294 148Node: Range Checking308027 149Node: Supported Languages310428 150Node: C311601 151Node: C Operators312829 152Node: C Constants317184 153Node: C Plus Plus Expressions319588 154Node: C Defaults323131 155Node: C Checks323814 156Node: Debugging C324537 157Node: Debugging C Plus Plus325021 158Node: Objective-C328107 159Node: Method Names in Commands328568 160Node: The Print Command with Objective-C330263 161Node: Fortran330914 162Node: Fortran Operators331639 163Node: Fortran Defaults332229 164Node: Special Fortran Commands332614 165Node: Pascal333120 166Node: Modula-2333635 167Node: M2 Operators334610 168Node: Built-In Func/Proc337608 169Node: M2 Constants340386 170Node: M2 Types341987 171Node: M2 Defaults345260 172Node: Deviations345860 173Node: M2 Checks346961 174Node: M2 Scope347779 175Node: GDB/M2348803 176Node: Ada349715 177Node: Ada Mode Intro350514 178Node: Omissions from Ada352386 179Node: Additions to Ada356347 180Node: Stopping Before Main Program360245 181Node: Ada Glitches360777 182Node: Unsupported Languages362755 183Node: Symbols363445 184Node: Altering376806 185Node: Assignment377775 186Node: Jumping380880 187Node: Signaling383037 188Node: Returning384168 189Node: Calling385370 190Node: Patching387263 191Node: GDB Files388340 192Node: Files388881 193Node: Separate Debug Files407007 194Node: Symbol Errors417415 195Node: Targets421018 196Node: Active Targets422498 197Node: Target Commands424077 198Node: Byte Order429317 199Node: Remote Debugging430294 200Node: Connecting431491 201Node: Server436359 202Ref: Server-Footnote-1441766 203Node: Remote Configuration441886 204Ref: set remotebreak442910 205Ref: set remote hardware-watchpoint-limit444374 206Ref: set remote hardware-breakpoint-limit444374 207Node: Remote Stub447011 208Node: Stub Contents449908 209Node: Bootstrapping452019 210Node: Debug Session455828 211Node: Configurations457388 212Node: Native458157 213Node: HP-UX458751 214Node: BSD libkvm Interface459040 215Node: SVR4 Process Information460111 216Node: DJGPP Native463541 217Node: Cygwin Native470121 218Node: Non-debug DLL Symbols473502 219Node: Hurd Native478048 220Node: Neutrino483311 221Node: Embedded OS483686 222Node: VxWorks484162 223Node: VxWorks Connection486379 224Node: VxWorks Download487313 225Node: VxWorks Attach489048 226Node: Embedded Processors489446 227Node: ARM490581 228Node: M32R/D493535 229Node: M68K495237 230Node: MIPS Embedded495533 231Node: OpenRISC 1000500478 232Node: PowerPC503333 233Node: PA504004 234Node: Sparclet504284 235Node: Sparclet File505759 236Node: Sparclet Connection506639 237Node: Sparclet Download507117 238Node: Sparclet Execution508166 239Node: Sparclite508757 240Node: Z8000509130 241Node: AVR510514 242Node: CRIS510877 243Node: Super-H511855 244Node: Architectures512097 245Node: i386512507 246Node: A29K513189 247Node: Alpha514028 248Node: MIPS514161 249Node: HPPA516785 250Node: SPU517304 251Node: Controlling GDB518532 252Node: Prompt519293 253Node: Editing520072 254Node: Command History521015 255Node: Screen Size524419 256Node: Numbers526124 257Node: ABI528101 258Node: Messages/Warnings531030 259Node: Debugging Output533523 260Node: Sequences537890 261Node: Define538501 262Node: Hooks541852 263Node: Command Files544043 264Node: Output547896 265Node: Interpreters550310 266Node: TUI552405 267Node: TUI Overview553372 268Node: TUI Keys555805 269Node: TUI Single Key Mode558109 270Node: TUI Commands558984 271Node: TUI Configuration561072 272Node: Emacs562368 273Node: GDB/MI567845 274Node: GDB/MI Command Syntax569633 275Node: GDB/MI Input Syntax569846 276Node: GDB/MI Output Syntax571400 277Node: GDB/MI Compatibility with CLI574818 278Node: GDB/MI Development and Front Ends575555 279Node: GDB/MI Output Records577476 280Node: GDB/MI Result Records577758 281Node: GDB/MI Stream Records578485 282Node: GDB/MI Out-of-band Records579756 283Node: GDB/MI Simple Examples581193 284Node: GDB/MI Command Description Format583002 285Node: GDB/MI Breakpoint Commands583882 286Node: GDB/MI Program Context600312 287Node: GDB/MI Thread Commands604794 288Node: GDB/MI Program Execution606870 289Node: GDB/MI Stack Manipulation615479 290Node: GDB/MI Variable Objects625110 291Ref: -var-list-children632122 292Ref: -var-update637081 293Ref: -var-set-frozen637895 294Node: GDB/MI Data Manipulation638618 295Node: GDB/MI Tracepoint Commands652980 296Node: GDB/MI Symbol Query653224 297Node: GDB/MI File Commands656512 298Node: GDB/MI Target Manipulation660618 299Node: GDB/MI Miscellaneous Commands667797 300Ref: -interpreter-exec669929 301Node: Annotations672230 302Node: Annotations Overview673144 303Node: Server Prefix675607 304Node: Prompting676247 305Node: Errors677764 306Node: Invalidation678660 307Node: Annotations for Running679137 308Node: Source Annotations680657 309Node: GDB Bugs681582 310Node: Bug Criteria682309 311Node: Bug Reporting683186 312Node: Command Line Editing690809 313Node: Introduction and Notation691461 314Node: Readline Interaction693081 315Node: Readline Bare Essentials694270 316Node: Readline Movement Commands696057 317Node: Readline Killing Commands697020 318Node: Readline Arguments698938 319Node: Searching699980 320Node: Readline Init File702129 321Node: Readline Init File Syntax703192 322Node: Conditional Init Constructs715124 323Node: Sample Init File717655 324Node: Bindable Readline Commands720770 325Node: Commands For Moving721825 326Node: Commands For History722684 327Node: Commands For Text725806 328Node: Commands For Killing728530 329Node: Numeric Arguments730670 330Node: Commands For Completion731807 331Node: Keyboard Macros733349 332Node: Miscellaneous Commands733918 333Node: Readline vi Mode737277 334Node: Using History Interactively738194 335Node: History Interaction738709 336Node: Event Designators740131 337Node: Word Designators741064 338Node: Modifiers742701 339Node: Formatting Documentation743926 340Ref: Formatting Documentation-Footnote-1747263 341Node: Installing GDB747331 342Node: Requirements747840 343Ref: Expat748409 344Node: Running Configure748981 345Node: Separate Objdir752550 346Node: Config Names755446 347Node: Configure Options756895 348Node: Maintenance Commands759231 349Ref: maint info breakpoints759890 350Node: Remote Protocol769959 351Node: Overview770390 352Ref: Binary Data772577 353Node: Packets774383 354Ref: read registers packet777989 355Ref: cycle step packet779155 356Ref: write register packet781031 357Ref: step with signal packet781909 358Ref: X packet785580 359Ref: insert breakpoint or watchpoint packet785870 360Node: Stop Reply Packets788316 361Node: General Query Packets791875 362Ref: QPassSignals798918 363Ref: qSupported800993 364Ref: qXfer read809585 365Ref: qXfer auxiliary vector read810079 366Ref: qXfer target description read810428 367Ref: qXfer library list read810872 368Ref: qXfer memory map read811518 369Ref: qXfer spu read811907 370Ref: qXfer spu write814037 371Ref: General Query Packets-Footnote-1815327 372Node: Register Packet Format815654 373Node: Tracepoint Packets816572 374Node: Interrupts822661 375Node: Examples824124 376Node: File-I/O Remote Protocol Extension824737 377Node: File-I/O Overview825197 378Node: Protocol Basics827344 379Node: The F Request Packet829574 380Node: The F Reply Packet830473 381Node: The Ctrl-C Message831389 382Node: Console I/O833016 383Node: List of Supported Calls834231 384Node: open834591 385Node: close837085 386Node: read837467 387Node: write838074 388Node: lseek838841 389Node: rename839719 390Node: unlink841115 391Node: stat/fstat842054 392Node: gettimeofday842941 393Node: isatty843376 394Node: system843972 395Node: Protocol-specific Representation of Datatypes845514 396Node: Integral Datatypes845889 397Node: Pointer Values846696 398Node: Memory Transfer847404 399Node: struct stat848024 400Node: struct timeval850226 401Node: Constants850743 402Node: Open Flags851190 403Node: mode_t Values851531 404Node: Errno Values852023 405Node: Lseek Flags852834 406Node: Limits853019 407Node: File-I/O Examples853379 408Node: Library List Format854493 409Node: Memory Map Format856269 410Node: Agent Expressions858709 411Node: General Bytecode Design861642 412Node: Bytecode Descriptions866442 413Node: Using Agent Expressions877128 414Node: Varying Target Capabilities878661 415Node: Tracing on Symmetrix879834 416Node: Rationale885656 417Node: Target Descriptions893035 418Node: Retrieving Descriptions895072 419Node: Target Description Format896157 420Node: Predefined Target Types902704 421Node: Standard Target Features903884 422Node: ARM Features905598 423Node: M68K Features907047 424Node: Copying907684 425Node: GNU Free Documentation License926902 426Node: Index949337 427 428End Tag Table 429