blob: 23eb4bfdfffeb11d00e8bc699de782b36dbac57a [file] [log] [blame]
This is, produced by makeinfo version 4.8 from ./gdb.texinfo.
INFO-DIR-SECTION Software development
* Gdb: (gdb). The GNU debugger.
Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010 2011, 2012 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 Tenth Edition, of `Debugging with GDB: the GNU
Source-Level Debugger' for GDB (GDB) Version 7.5.
Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010 2011, 2012 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: 1910 298476 597893 897339 1194684 1474501

Tag Table:
Node: Top1910
Node: Summary5338
Node: Free Software7211
Node: Free Documentation7952
Node: Contributors12887
Node: Sample Session20981
Node: Invocation27817
Node: Invoking GDB28361
Node: File Options30674
Node: Mode Options33732
Ref: -nx33959
Node: Startup40406
Ref: Home Directory Init File40957
Ref: Option -init-eval-command41067
Ref: Init File in the Current Directory during Startup41412
Ref: Startup-Footnote-143584
Node: Quitting GDB43693
Node: Shell Commands44590
Node: Logging Output45517
Node: Commands46363
Node: Command Syntax47001
Node: Completion49167
Ref: Completion-Footnote-154531
Node: Help54691
Node: Running60060
Node: Compilation61289
Node: Starting63373
Node: Arguments72298
Node: Environment73568
Node: Working Directory76836
Node: Input/Output77944
Node: Attach79915
Node: Kill Process82382
Node: Inferiors and Programs83363
Node: Threads90608
Ref: set libthread-db-search-path98017
Node: Forks100075
Node: Checkpoint/Restart106385
Ref: Checkpoint/Restart-Footnote-1110914
Node: Stopping110949
Node: Breakpoints112212
Node: Set Breaks115755
Node: Set Watchpoints134488
Node: Set Catchpoints143891
Node: Delete Breaks153327
Node: Disabling155263
Node: Conditions158652
Node: Break Commands164300
Node: Dynamic Printf167522
Node: Save Breakpoints171782
Node: Static Probe Points172957
Node: Error in Breakpoints175644
Node: Breakpoint-related Warnings176380
Node: Continuing and Stepping178707
Node: Skipping Over Functions and Files188093
Node: Signals191665
Ref: extra signal information195947
Node: Thread Stops197450
Node: All-Stop Mode198549
Node: Non-Stop Mode202447
Node: Background Execution205924
Node: Thread-Specific Breakpoints208493
Node: Interrupted System Calls209815
Node: Observer Mode211329
Node: Reverse Execution214768
Ref: Reverse Execution-Footnote-1219395
Ref: Reverse Execution-Footnote-2220022
Node: Process Record and Replay220072
Node: Stack227319
Node: Frames228812
Node: Backtrace231564
Ref: Backtrace-Footnote-1236777
Node: Selection236965
Node: Frame Info239829
Node: Source241823
Node: List242889
Node: Specify Location245502
Node: Edit250106
Ref: Edit-Footnote-1251581
Node: Search251816
Node: Source Path252624
Ref: set substitute-path258991
Node: Machine Code261212
Node: Data267886
Node: Expressions275502
Node: Ambiguous Expressions277594
Node: Variables280828
Node: Arrays286446
Node: Output Formats288977
Ref: Output Formats-Footnote-1292165
Node: Memory292322
Node: Auto Display298476
Node: Print Settings303018
Ref: set print entry-values310598
Node: Pretty Printing321843
Node: Pretty-Printer Introduction322356
Node: Pretty-Printer Example324111
Node: Pretty-Printer Commands324889
Node: Value History327313
Node: Convenience Vars329734
Node: Registers334580
Ref: Registers-Footnote-1339257
Node: Floating Point Hardware339652
Node: Vector Unit340184
Node: OS Information340571
Ref: linux info os infotypes343148
Node: Memory Region Attributes347348
Node: Dump/Restore Files352018
Node: Core File Generation354323
Node: Character Sets355557
Node: Caching Remote Data361922
Ref: Caching Remote Data-Footnote-1364187
Node: Searching Memory364425
Node: Optimized Code367302
Node: Inline Functions368979
Node: Tail Call Frames371606
Ref: set debug entry-values373746
Node: Macros377820
Ref: Macros-Footnote-1385396
Node: Tracepoints385549
Node: Set Tracepoints387610
Node: Create and Delete Tracepoints390548
Node: Enable and Disable Tracepoints396948
Node: Tracepoint Passcounts398188
Node: Tracepoint Conditions399615
Node: Trace State Variables401309
Node: Tracepoint Actions403499
Node: Listing Tracepoints409804
Node: Listing Static Tracepoint Markers410925
Node: Starting and Stopping Trace Experiments412771
Ref: disconnected tracing414516
Node: Tracepoint Restrictions418134
Node: Analyze Collected Data421904
Node: tfind423209
Node: tdump427631
Node: save tracepoints430146
Node: Tracepoint Variables430642
Node: Trace Files431770
Node: Overlays433228
Node: How Overlays Work433948
Ref: A code overlay436508
Node: Overlay Commands439946
Node: Automatic Overlay Debugging444136
Node: Overlay Sample Program446277
Node: Languages448037
Node: Setting449200
Node: Filenames450902
Node: Manually451713
Node: Automatically452922
Node: Show453983
Node: Checks455305
Node: Type Checking456695
Node: Range Checking459428
Node: Supported Languages461829
Node: C463129
Node: C Operators464093
Node: C Constants468412
Node: C Plus Plus Expressions471293
Node: C Defaults474636
Node: C Checks475319
Node: Debugging C476042
Node: Debugging C Plus Plus476526
Node: Decimal Floating Point479984
Node: D481243
Node: Go481500
Node: Objective-C482594
Node: Method Names in Commands483057
Node: The Print Command with Objective-C484752
Node: OpenCL C485403
Node: OpenCL C Datatypes485678
Node: OpenCL C Expressions486053
Node: OpenCL C Operators486410
Node: Fortran486642
Node: Fortran Operators487364
Node: Fortran Defaults488220
Node: Special Fortran Commands488605
Node: Pascal489111
Node: Modula-2489626
Node: M2 Operators490601
Node: Built-In Func/Proc493600
Node: M2 Constants496461
Node: M2 Types498062
Node: M2 Defaults501281
Node: Deviations501881
Node: M2 Checks502982
Node: M2 Scope503800
Node: GDB/M2504824
Node: Ada505736
Node: Ada Mode Intro506799
Node: Omissions from Ada508709
Node: Additions to Ada513063
Node: Stopping Before Main Program516993
Node: Ada Tasks517522
Node: Ada Tasks and Core Files523935
Node: Ravenscar Profile524853
Node: Ada Glitches525923
Node: Unsupported Languages528717
Node: Symbols529407
Node: Altering543995
Node: Assignment544964
Node: Jumping548069
Node: Signaling550204
Node: Returning551335
Node: Calling554687
Node: Patching557714
Node: GDB Files558791
Node: Files559436
Ref: Shared Libraries572281
Ref: Files-Footnote-1583915
Node: Separate Debug Files584090
Ref: debug-file-directory587195
Node: Index Files595824
Node: Symbol Errors597893
Node: Data Files601506
Node: Targets602462
Node: Active Targets603942
Node: Target Commands605016
Ref: load609289
Node: Byte Order610270
Node: Remote Debugging611247
Node: Connecting612509
Node: File Transfer617449
Node: Server618389
Ref: Monitor Commands for gdbserver628611
Ref: Server-Footnote-1633265
Node: Remote Configuration633385
Ref: set remotebreak634409
Ref: set remote hardware-watchpoint-limit635873
Ref: set remote hardware-breakpoint-limit635873
Ref: set remote hardware-watchpoint-length-limit636099
Ref: set remote exec-file636514
Node: Remote Stub643479
Node: Stub Contents646376
Node: Bootstrapping648483
Node: Debug Session652292
Node: Configurations654334
Node: Native655103
Node: HP-UX655738
Node: BSD libkvm Interface656027
Node: SVR4 Process Information657098
Node: DJGPP Native660528
Node: Cygwin Native667108
Node: Non-debug DLL Symbols671057
Node: Hurd Native675605
Node: Neutrino680868
Node: Darwin681258
Node: Embedded OS682516
Node: VxWorks682992
Node: VxWorks Connection685209
Node: VxWorks Download686143
Node: VxWorks Attach687878
Node: Embedded Processors688276
Node: ARM689455
Node: M32R/D693576
Node: M68K695278
Node: MicroBlaze695571
Node: MIPS Embedded697021
Node: OpenRISC 1000701959
Node: PowerPC Embedded704828
Node: PA708595
Node: Sparclet708879
Node: Sparclet File710349
Node: Sparclet Connection711229
Node: Sparclet Download711707
Node: Sparclet Execution712756
Node: Sparclite713347
Node: Z8000713722
Node: AVR715106
Node: CRIS715469
Node: Super-H716447
Node: Architectures717650
Node: i386718063
Node: Alpha718746
Node: MIPS718879
Node: HPPA722772
Node: SPU723291
Node: PowerPC725479
Node: Controlling GDB726197
Node: Prompt727094
Node: Editing728813
Node: Command History729756
Node: Screen Size733160
Node: Numbers734994
Node: ABI736971
Node: Auto-loading739895
Ref: set auto-load off740762
Ref: show auto-load741398
Ref: info auto-load742177
Node: Init File in the Current Directory745758
Ref: set auto-load local-gdbinit746333
Ref: show auto-load local-gdbinit746515
Ref: info auto-load local-gdbinit746679
Node: file746827
Ref: set auto-load libthread-db747764
Ref: show auto-load libthread-db747895
Ref: info auto-load libthread-db748032
Node: objfile-gdb.gdb file748216
Ref: set auto-load gdb-scripts748825
Ref: show auto-load gdb-scripts748949
Ref: info auto-load gdb-scripts749079
Node: Auto-loading safe path749310
Ref: set auto-load safe-path750465
Ref: show auto-load safe-path751204
Ref: add-auto-load-safe-path751327
Node: Auto-loading verbose mode754221
Ref: set debug auto-load755384
Ref: show debug auto-load755485
Node: Messages/Warnings755607
Ref: confirmation requests757042
Node: Debugging Output758249
Node: Other Misc Settings765051
Node: Extending GDB766080
Node: Sequences767708
Node: Define768303
Node: Hooks772104
Node: Command Files774471
Node: Output779541
Node: Python784474
Node: Python Commands785649
Node: Python API787443
Node: Basic Python789376
Ref: prompt_hook796842
Node: Exception Handling797439
Node: Values From Inferior799935
Node: Types In Python812580
Node: Pretty Printing API821319
Node: Selecting Pretty-Printers825212
Node: Writing a Pretty-Printer827545
Node: Inferiors In Python832868
Node: Events In Python835875
Node: Threads In Python841283
Node: Commands In Python843895
Node: Parameters In Python853081
Node: Functions In Python858542
Node: Progspaces In Python860657
Node: Objfiles In Python862009
Node: Frames In Python863940
Node: Blocks In Python870377
Node: Symbols In Python873348
Node: Symbol Tables In Python880887
Node: Breakpoints In Python883878
Node: Finish Breakpoints in Python890990
Node: Lazy Strings In Python893097
Node: Python Auto-loading895300
Ref: set auto-load python-scripts895964
Ref: show auto-load python-scripts896064
Ref: info auto-load python-scripts896170
Node: file897339
Ref: set auto-load scripts-directory898121
Ref: with-auto-load-dir898497
Ref: show auto-load scripts-directory899315
Node: dotdebug_gdb_scripts section899644
Node: Which flavor to choose?901165
Node: Python modules902991
Node: gdb.printing903377
Node: gdb.types904791
Node: gdb.prompt906493
Node: Aliases908142
Node: Interpreters910985
Node: TUI913084
Node: TUI Overview914031
Node: TUI Keys916464
Node: TUI Single Key Mode918768
Node: TUI Commands919643
Node: TUI Configuration922027
Node: Emacs923323
Node: GDB/MI928797
Node: GDB/MI General Design930677
Node: Context management933200
Node: Asynchronous and non-stop modes936335
Node: Thread groups938327
Node: GDB/MI Command Syntax940605
Node: GDB/MI Input Syntax940848
Node: GDB/MI Output Syntax942402
Node: GDB/MI Compatibility with CLI945974
Node: GDB/MI Development and Front Ends946711
Node: GDB/MI Output Records948368
Node: GDB/MI Result Records948740
Node: GDB/MI Stream Records949746
Node: GDB/MI Async Records951011
Node: GDB/MI Frame Information958843
Node: GDB/MI Thread Information959921
Node: GDB/MI Ada Exception Information960900
Node: GDB/MI Simple Examples961323
Node: GDB/MI Command Description Format963500
Node: GDB/MI Breakpoint Commands964380
Node: GDB/MI Program Context982251
Node: GDB/MI Thread Commands986519
Node: GDB/MI Ada Tasking Commands990475
Node: GDB/MI Program Execution992729
Node: GDB/MI Stack Manipulation1004515
Node: GDB/MI Variable Objects1015417
Ref: -var-set-format1025320
Ref: -var-list-children1026438
Ref: -var-update1034789
Ref: -var-set-frozen1037784
Ref: -var-set-update-range1038580
Ref: -var-set-visualizer1039110
Node: GDB/MI Data Manipulation1040607
Node: GDB/MI Tracepoint Commands1058192
Node: GDB/MI Symbol Query1065521
Node: GDB/MI File Commands1066210
Node: GDB/MI Target Manipulation1069547
Node: GDB/MI File Transfer Commands1075769
Node: GDB/MI Miscellaneous Commands1077091
Ref: -interpreter-exec1089683
Node: Annotations1091996
Node: Annotations Overview1092915
Node: Server Prefix1095378
Node: Prompting1096112
Node: Errors1097629
Node: Invalidation1098525
Node: Annotations for Running1099002
Node: Source Annotations1100522
Node: JIT Interface1101447
Node: Declarations1103247
Node: Registering Code1104634
Node: Unregistering Code1105606
Node: Custom Debug Info1106233
Node: Using JIT Debug Info Readers1107529
Node: Writing JIT Debug Info Readers1108396
Node: In-Process Agent1110593
Ref: Control Agent1112536
Node: In-Process Agent Protocol1113403
Node: IPA Protocol Objects1114195
Ref: agent expression object1115197
Ref: tracepoint action object1115403
Ref: tracepoint object1115484
Node: IPA Protocol Commands1118441
Node: GDB Bugs1119776
Node: Bug Criteria1120508
Node: Bug Reporting1121385
Node: Command Line Editing1129008
Node: Introduction and Notation1129660
Node: Readline Interaction1131280
Node: Readline Bare Essentials1132469
Node: Readline Movement Commands1134256
Node: Readline Killing Commands1135219
Node: Readline Arguments1137137
Node: Searching1138179
Node: Readline Init File1140328
Node: Readline Init File Syntax1141479
Node: Conditional Init Constructs1156537
Node: Sample Init File1159068
Node: Bindable Readline Commands1162183
Node: Commands For Moving1163238
Node: Commands For History1164097
Node: Commands For Text1167499
Node: Commands For Killing1170223
Node: Numeric Arguments1172363
Node: Commands For Completion1173500
Node: Keyboard Macros1175467
Node: Miscellaneous Commands1176036
Node: Readline vi Mode1179890
Node: Using History Interactively1180800
Node: History Interaction1181343
Node: Event Designators1182765
Node: Word Designators1183905
Node: Modifiers1185542
Node: In Memoriam1186765
Node: Formatting Documentation1187648
Ref: Formatting Documentation-Footnote-11190961
Node: Installing GDB1191025
Node: Requirements1191597
Ref: Expat1192166
Node: Running Configure1194684
Node: Separate Objdir1198223
Node: Config Names1201107
Node: Configure Options1202552
Node: System-wide configuration1204922
Node: Maintenance Commands1206217
Ref: maint info breakpoints1207871
Node: Remote Protocol1222269
Node: Overview1222899
Ref: Binary Data1225461
Node: Packets1227984
Ref: thread-id syntax1228884
Ref: extended mode1230329
Ref: bc1232050
Ref: bs1232260
Ref: read registers packet1233864
Ref: cycle step packet1235797
Ref: write register packet1237673
Ref: step with signal packet1238669
Ref: vCont packet1240123
Ref: vStopped packet1245039
Ref: X packet1245382
Ref: insert breakpoint or watchpoint packet1245668
Node: Stop Reply Packets1249705
Node: General Query Packets1254445
Ref: QNonStop1264659
Ref: QPassSignals1265283
Ref: QProgramSignals1266452
Ref: qSearch memory1268928
Ref: QStartNoAckMode1269426
Ref: qSupported1269956
Ref: multiprocess extensions1279773
Ref: install tracepoint in tracing1281802
Ref: qXfer read1284820
Ref: qXfer auxiliary vector read1285314
Ref: qXfer target description read1285663
Ref: qXfer library list read1286107
Ref: qXfer svr4 library list read1286762
Ref: qXfer memory map read1287397
Ref: qXfer sdata read1287783
Ref: qXfer siginfo read1288247
Ref: qXfer spu read1288643
Ref: qXfer threads read1289166
Ref: qXfer traceframe info read1289568
Ref: qXfer unwind info block1289984
Ref: qXfer fdpic loadmap read1290216
Ref: qXfer osdata read1290631
Ref: qXfer write1291833
Ref: qXfer siginfo write1292390
Ref: qXfer spu write1292786
Ref: General Query Packets-Footnote-11294873
Node: Architecture-Specific Protocol Details1295200
Node: ARM-Specific Protocol Details1295709
Node: ARM Breakpoint Kinds1295957
Node: MIPS-Specific Protocol Details1296289
Node: MIPS Register packet Format1296572
Node: MIPS Breakpoint Kinds1297501
Node: Tracepoint Packets1297920
Ref: QTEnable1306913
Ref: QTDisable1307109
Ref: qTfSTM1312633
Ref: qTsSTM1312633
Ref: qTSTMat1313671
Node: Host I/O Packets1316599
Node: Interrupts1321217
Node: Notification Packets1323120
Node: Remote Non-Stop1325391
Node: Packet Acknowledgment1329650
Node: Examples1331765
Node: File-I/O Remote Protocol Extension1332391
Node: File-I/O Overview1332853
Node: Protocol Basics1335050
Node: The F Request Packet1337282
Node: The F Reply Packet1338183
Node: The Ctrl-C Message1339101
Node: Console I/O1340730
Node: List of Supported Calls1341947
Node: open1342309
Node: close1344803
Node: read1345185
Node: write1345792
Node: lseek1346559
Node: rename1347437
Node: unlink1348833
Node: stat/fstat1349772
Node: gettimeofday1350659
Node: isatty1351094
Node: system1351690
Node: Protocol-specific Representation of Datatypes1353232
Node: Integral Datatypes1353609
Node: Pointer Values1354416
Node: Memory Transfer1355124
Node: struct stat1355744
Node: struct timeval1357946
Node: Constants1358463
Node: Open Flags1358912
Node: mode_t Values1359253
Node: Errno Values1359745
Node: Lseek Flags1360556
Node: Limits1360741
Node: File-I/O Examples1361101
Node: Library List Format1362217
Node: Library List Format for SVR4 Targets1365000
Node: Memory Map Format1367470
Node: Thread List Format1370047
Node: Traceframe Info Format1370865
Node: Agent Expressions1372322
Node: General Bytecode Design1375143
Node: Bytecode Descriptions1379943
Node: Using Agent Expressions1393379
Node: Varying Target Capabilities1395357
Node: Rationale1396519
Node: Target Descriptions1403905
Node: Retrieving Descriptions1405781
Node: Target Description Format1406866
Node: Predefined Target Types1415915
Node: Standard Target Features1417300
Node: ARM Features1419090
Node: i386 Features1420582
Node: MIPS Features1421686
Node: M68K Features1422870
Node: PowerPC Features1423533
Node: TIC6x Features1424840
Node: Operating System Information1425389
Node: Process list1426227
Node: Trace File Format1427289
Node: Index Section Format1429283
Node: Copying1436911
Node: GNU Free Documentation License1474501
Node: Concept Index1499667
Node: Command and Variable Index1616465

End Tag Table