162 | HP UX SoftBench Software specification

Using SoftBench Debugger

Using SoftBench Debugger Window Areas

SoftBench Debugger shows the Annotation Margin, which indicates the Program Counter location with a PC Arrow. The Annotation Margin also shows program breakpoint locations. See “Setting and Using Breakpoints” on page 189. Breakpoints can be set and cleared by clicking in the Annotation Margin at the desired breakpoint location. SoftBench Debugger displays other symbols when debugging optimized code. See “Debugging Optimized Code” on page 227.

The user customizable buttons provide easy access to common debugger operations, such as Step and Print( ). You can customize these buttons (and the popup menu over the Source File Area) to provide the exact environment desired for a particular application. See “Customizing User Buttons” on page 228.

Below the user buttons are the DDE output area and the "Debugger Input" input box. SoftBench Debugger uses these areas for communicating directly with DDE, receiving output from DDE and sending raw DDE commands to DDE.

At the bottom of the screen SoftBench Debugger displays the User Program I/O area. Programs being debugged send their output to this area and take their input from this area. You must move the mouse pointer into this area to enter text into the stdio of your program.

162

Chapter 7

Image 162

HP UX SoftBench Software manual 162

Contents

C++ SoftBench Users Guide Manufacturing Part Number B6454-97413 June Legal Notices Page Printing History Convention Description Boldface fontPage Contents Using SoftBench Conﬁguration Manager Using SoftBench Editors Using SoftBench Class Graph/Editor Using SoftBench Debugger Contents Using SoftBench Debugger Data Graph Window Using Static Graphs Using SoftBench File Compare Using SoftBench Graph Windows Using Regular Expressions Contents Maximizing Your Results with SoftBench Task Flow Major Software Development Tasks Supported by SoftBench Understanding Projects More sets of build instructions and dependenciesSoftBench Tools Interacting with Project and Files Building Targets Understanding Build Conﬁgurations and Packages Understanding Projects Choosing Between Project Build and External Build Models Simpliﬁed Build Conﬁguration, Package, and Transform Series Understanding Projects Sharing Projects with a Team One Project, One AuthorOne Project, Many Authors Team Members Cloning the Project Deﬁnition Team Members Using Subprojects One Project with Subprojects, Many AuthorsTeam Members Sharing the Project Deﬁnition Sharing Projects with a Team Chapter Planning Your Project Conﬁguration Management Using the SoftBench Integrated EnvironmentEditors SoftBench Static Analyzer SoftBench File Compare Using SoftBench Tools Throughout Your Development CycleSoftBench Debugger SoftBench Message Monitor Using SoftBench Tools Together Using SoftBench Tools on Multiple Projects Tools That Can Directly Invoke Other Tools Using SoftBench Tools as Standalone Tools 10 Iconize and Normalize Project Buttons Reusing Tool Windows Copying Data between SoftBench Tools An Example SoftBench Session An Example SoftBench Session Learning SoftBench Using SoftBench Prerequisites to Using SoftBench Shell Syntax Starting SoftBench Understanding SoftBench Window Areas Unexpanded SoftBench Window Description of SoftBench Window Areas Window Area Description Static, and Optimized compiler Understanding the Builder Expanded SoftBench Window Displaying Builder Understanding the SoftBench CodeAdvisor Expanded SoftBench Window Displaying SoftBenchCodeAdvisor Understanding SoftBench Window Areas Setting Up a Project Creating a Project Using Project Build Create Project Dialog Box Creating a Project Using External Build Create Project Dialog Box for External Build Cloning a Project from an Existing Project Repartitioning an Existing Project Creating a Subproject Modifying a Project Deﬁnition Creating Files within a Project Adding Existing Files to a Project Add Files to Project Dialog Box Adding Existing Files to a Project Deﬁning Targets for Project Build Creating a Target Specifying Dependency Relationships Customizing Build Conﬁgurations Manage Build Conﬁguration Dialog Box Using Build Packages External Build Command Dialog Box Deﬁning Targets for External Build Deﬁning Targets for External Build Using the Target Graph Build Model Operations in the Target Graph Understanding the Graph Operation Project Build External Build Displaying Dependencies Graph Node StatesColor Meaning Controlling Graph Complexity Building a Selected TargetStarting Your Conﬁgured Editor Setting the Compile Mode Building Projects and Targets Compile Mode Settings Default Compiler Flag Using the External Build Command Dialog Box Previewing the Build Handling Errors Compiling Instead of BuildingBuilding Subprojects Interpreting Error Messages Browsing and Correcting Build Errors Running the Build on a Remote System Checking Your Code Using SoftBench CodeAdvisor Running Other SoftBench Tools Managing Your SoftBench Environment Adding and Removing Tool Icons Choosing Tool Preferences Registering New Tools with SoftBench Customizing SoftBench by Setting Resources Accessing Distributed Data and Tools Running SoftBench on a Remote System Integrating with CDEStopping SoftBench Restoring Your Previous SoftBench Session Getting Help 11 SoftBench Online Help Window Using the Help Menu Accessing On Item Help If Something Goes Wrong Condition or Explanation Message For More Information For More Information Chapter Using SoftBench Conﬁguration Understanding SoftBench CM Integration of SoftBench CM with SoftBench Understanding SoftBench CM Getting Started a Brief Overview Choose Directory Create… Choose Actions Check Out to Local Directory Managing the Archive System Browsing Local Network Servers and Archives Viewing Local Servers and SoftBench CM Archives Creating an Archive Directory File or directory nameSoftBench CM Main Window Creating a Mapping between an Archive Directory Local DirectorySoftBench CM File Mapping Modifying Mappings between Local and Archive Directories Show / Modify Mappings Dialog Box 100 Chapter 101 Checking Out Archive Files Managing Archive Files and DirectoriesCreating Initial Archive Files 102 Cancelling Archive File Check Out Updating a Local Directory Viewing Contents of Archive Files Viewing an Archive File Deleting Archive Files and Directories Locking an Archive File106 Breaking a Lock on an Archive File Viewing the Revision History of Archive FilesBreak File Lock Dialog Box Show Revision History Dialog Box for an Archive File 108 Setting Archive Display Filters Checking In Modiﬁed Files Managing Local FilesModifying Local Source Files 110 Chapter 111 Creating a Default Symbolic Name for Archive Files Understanding Symbolic Names112 Deﬁning Symbolic Names Symbolic Name Example Action Result Symbolic Names and Revision Numbers File File YActions and Results After Setting Symbolic Name List 114 Using the SoftBench CM Command Line Interface SoftBench CM Command Line Man PagesMan Task Description 116 Using SoftBench Editors Using Editors with Projects 118 Conﬁguring an Editor Conﬁguring SoftBench vi EditorConﬁguring SoftBench Program Editor 120 Starting the Conﬁgured SoftBench Editor Editing with SoftBench XEmacs Editor 122 Using SoftBench XEmacs SoftBench XEmacs Main Window Accessing HelpEditing Multiple Files 124 Chapter 125 Editing with SoftBench vi Editor SoftBench vi Editor Window126 Using the Mouse Pointer Versus the Text Cursor Reusing the Edit Window If the vi autowrite SoftBench vi Editors behavior Option128 Selecting, Copying, and Pasting Text Compiling a Program File Accessing SoftBench Static Analyzer from the EditorCalling Other SoftBench Tools from the Editors Building a Project Setting Breakpoints in a Program File Using Conﬁguration Management 132 Using SoftBench Class Editing C++ Structures with SoftBench Class Graph/Editor Understanding the SoftBench Class Graph/Editor Use Model134 SoftBench Class Graph/Editor Use Model Synchronizing Editor Views and the Static Database 136 Chapter 137 Using SoftBench Class Graph/Editor in Your Work Viewing the Existing Class Hierarchy138 Creating New Components Modifying Existing Components Deleting Existing Components 140 Modifying an Existing Program Sample Use ModelsCreating a New Program Working with Class Templates 142 Condition Explanation 144 Using SoftBench CodeAdvisor Using SoftBench CodeAdvisor 146 Chapter 147 148 Performing the Check Code Operation Preparing Your Program with Project BuildPreparing Your Program with External Build Checking Your Program Accessing SoftBench CodeAdvisorSelecting Rule Groups 150 Viewing Violations Violations Display Terminating SoftBench CodeAdvisor Filtering Rule Violations152 Chapter 153 154 Using SoftBench Debugger Understanding SoftBench Debugger 156 Chapter 157 158 Preparing Your Program for Debugging Using SoftBench Debugger Window Areas SoftBench Debugger Window160 Chapter 161 162 Tearing Apart the Main Toolface Tear Apart Main Toolface 164 Loading or Rerunning an Executable Program Specifying the Runtime Environment Load Executable Dialog Box 166 Setting Environment Variables Specifying the Working Directory and Program ArgumentsSpecifying Standard I/O Specifying Source Locations 168 Debugging Executables in a Project Adding Source Directories for External Builds Add Source Directories Dialog Box 170 Stepping through Your Program Interrupting a Running Program Interrupting in System or Non-debuggable Routines172 Chapter 173 Interacting with Your Program Interacting with a Standard I/O Program174 Interacting with a Terminal-Smart Program Interacting with a Window-Smart Program 176 Specifying Identiﬁer Locations Specifying Program Location Specifying Variables 178 Chapter 179 180 Examining and Changing Data in Your Program Examining Data in Your Program 182 Using Debugger Variables Printing Hex or String ValuesChanging Data in Your Program Using Expressions 184 Using Constants Calling Functions Viewing the Call Stack186 Viewing Thread Stacks Stack View Window Understanding the Operation of Your Program 188 Setting and Using Breakpoints Debugging a Program Using Breakpoints Setting a Breakpoint Using the Editable Source Area190 Break Menu Using the Break Menu Using the Breakpoint Set/Change Dialog Box192 Viewing and Modifying Breakpoints Breakpoint Set/Change Dialog Box Changing Verbose / Silent Status Clearing a BreakpointChanging Active / Suspend Status 194 Executing DDE Commands at a Breakpoint 196 Setting C++ Breakpoints Setting Group BreakpointsViewing and Modifying Group Breakpoints 198 Setting and Using Watchpoints Creating Watchpoints Using the Watch MenuUsing the Data Watchpoint Set/Change Dialog Box 200 Viewing and Modifying Watchpoints Data Watchpoint Window Clearing a Watchpoint 202 Chapter 203 Creating Traces Using the Trace MenuTracing Program Flow 204 Using the Trace Set/Change Dialog Box Viewing TracesTrace Set/Change Dialog Box Clearing Traces 206 Correcting Errors in Your Program Editing Source Code Synchronizing Files 208 Debugging Dynamic Libraries 10 Dynamic Images/Libraries Dialog Box 210 Viewing Assembly Language and CPU Registers Tracing Assembly Language Tracing Registers 212 Chapter 213 Handling Signals and Events Viewing and Editing Intercepts214 Chapter 215 Handling Signals 216 Signal Error Message Text Name Debugging After a Program Fails Core DumpDebugging with a Core File 218 Debugging Forked Processes Debugging Threaded Applications Viewing and Manipulating Threads220 Setting Breakpoints on Threads Attaching the Debugger to a Running Program 222 Debugging C++ Programs 224 Using Breakpoints for Exception Handling Accessing Inherited C++ ValuesDebugging Static Constructors 226 Debugging Optimized Code Customizing User Buttons Customizing SoftBench DebuggerSpecifying Debugger Options 228 Chapter 229 230 Chapter 231 Offset argument. 232 Chapter 233 234 Using SoftBench Debugger Data Stopping a Browsing Session Starting and Stopping the Data Graph WindowBeginning a Browsing Session 236 Understanding Data Graph Window Areas Understanding the Layout Control AreaData Graph Window Areas Understanding the Display Control Area Understanding the Graph Area238 Data Graph Window Action Menus Object Selected Actions AllowedReading Nodes Reading Arcs Using Dialog BoxesUnderstanding the Window Control Area 240 Using the Graph Area Using the Node Values Dialog BoxDisplaying New Nodes Node Values Dialog Box 242 Displaying Data Members Setting Data Member ValuesNode Values Dialog Box Action Menu Following Selected Pointers Stopping a Graph Process Suspending Graph UpdatesDeactivating the Graph 244 Verifying Correct Data Structures Viewing btree Binary Tree Node with Children Binary Tree NodeContinuing Program Execution 246 Viewing Values of Data Members Showing NodesDereferencing Particular Data Members Viewing Values from Embedded Arrays Viewing Values from Multiple NodesViewing Embedded Arrays Showing Values On the Graph Viewing Data Members on The Graph Nodes 250 Using SoftBench Static Starting SoftBench Static Analyzer 252 Chapter 253 Preparing to Make Queries Generating Static Data254 Specifying Static Data to Analyze Using the Default Analysis File SetUpdating Static Data without Building Including Subprojects and Parent Projects Customizing the File Set in Non-Project Mode Keeping Analysis Files Current256 Filtering Queries by File Set Determining the File Set Status Using SoftBench Static Analyzer Window Areas 258 SoftBench Static Analyzer Window and Areas Making Queries Based on a Program Identiﬁer Making Textual Static QueriesMaking General Queries 260 Selecting Text Understanding the Types of References Relationships among Reference Queries Determining Identiﬁer Classiﬁcation262 Troubleshooting Invalid Identiﬁers for Queries Using Pattern Matching Editing the Source File Using Query ResultsBrowsing the Query Result Updating the Database Performing a Query Simplifying Query Results Filtering Results Using the File SetCommand Description SoftBench Static Analyzer Display Options Unﬁltered Source File List Filtered Source File List Using Scoping Filtering C++ Query Results268 Troubleshooting Scoping Information Scoping Prerequisites and ConstraintsScoping Example 270 Deleting a Query Result Redisplaying Past QueriesRedisplaying Query Results Saving and Printing a Query Result 272 Using SoftBench Static Analyzer in Standalone Mode Generating Static Data from the Command LineSearching Subdirectories Using the Staticﬁleset File 274 Customizing SoftBench Static Analyzer Condition or Message Explanation Analysis ﬁle set choose F ile276 Chapter 277 278 Chapter 279 Staticrmﬁle1 280 Chapter 281 282 Using Static Graphs 284 Starting SoftBench Static Analyzer Graphs General Static Graph Features Making Graphical Static Queries286 Finding Graph Nodes Operating on Static Graph Nodes Switching between Static Graphs Displaying Nodes on Another Graph288 Using Description Boxes Function Description Dialog Box Setting Breakpoints for SoftBench Debugger Saving Static Graph Images to Files290 Chapter 291 Simplifying Graph Displays Reducing Graph Complexity292 Filtering Sourceless Nodes Customizing Static Graphs Removing the Graph Legend Viewing Multiple Graphs294 Using SoftBench File Compare Understanding the Working Directory Input Box Understanding the SoftBench File Compare WindowUnderstanding the Menu Bar 296 Understanding the Text Areas Using the Left File and Right File Input BoxesUsing the Merge File Input Box Reading the Gutter Column Selecting Lines for Merging Left Right Selection Column298 Highlighting Differences Traversing by Single Line Comparing Two Files 300 Merging Compared Files 302 Chapter 303 304 Using SoftBench Message Monitor Starting SoftBench Message Monitor 306 Understanding the SoftBench Message Monitor Window Area Understanding Broadcast Messages Clearing the Broadcast Message Area 308 Composing and Sending a Message Send Message Dialog Box For SoftBench XEmacs 310 Logging Messages Specifying a Log FileStarting and Stopping Message Logging 312 Using SoftBench with SQL Determining Supported Environments 314 Conﬁguring SoftBench with SQL Using Default SQL File TypesUsing SQL with Project Build SQL File Extensions for C Language 316 Using SQL with External Build Updating Rdbms Versions 318 Using SQL with SoftBench Tools Using SQL Preprocessor WrappersDebugging with SQL Debugging Expanded SQL Statements 320 Editing and Rebuilding with SQL for SoftBench Debugger 322 Using SoftBench Graph Windows Accessing SoftBench Graph Windows 324 Appendix a 325 Using Save Options for the Graph Image Using Graph Window AreasUsing Popup Menus 326 Table A-2 Graph Image File Formats Option Used for Figure A-1 Save Image Dialog Box Using Graph File Image Save Options Saving HP-GL and PostScript Images328 Saving xwd Images Using Vertical and Horizontal Scrolling 330 Zooming In or Zooming Out Clearing the Graph Area Selecting Nodes and Arcs Understanding Nodes and ArcsReading Graph Area Nodes 332 Appendix a 333 Table A-4 Methods for Selecting Multiple Objects Procedure Moving Nodes334 Appendix a 335 Controlling Graph Layout Menu settingsCustomizing SoftBench Graphs Controlling Graph Display Understanding Window Status Information 338 Customizing SoftBench CM Conﬁguration Modifying the Conﬁguration Files Table B-1 Server Conﬁguration Files File Name Description340 Conﬁguring Where Archive Files are Stored Figure B-1 File Mapping Between Local and Archive Files Deﬁning User Access to the Server 342 Appendix B 343 344 Recommended Format for Permissions File Format 1. Place user ﬁeld ﬁrst and permissions ﬁeld secondFormat 2. Place path ﬁeld ﬁrst and permissions ﬁeld second Setting Logging and Debug Options 346 Appendix B 347 Migrating Archive Files From Sccs Performing SoftBench CM Administrator TasksMigrating Archive Files From RCS 348 Creating Archive Backups Modifying the Lockinfo FileMoving Archive Storage Locations 350 Troubleshooting Using the Archive Status and Error LogUsing the Archive Activity Log 352 Using Regular Expressions Pattern Matching 354 Appendix C 355 356 Appendix C 357 358 Appendix C 359 360 Customizing SoftBench for Native Language Support NLS Preparing to Use NLS in SoftBench 362 Appendix D 363 Setting the Lang Environment Variable Table D-1 To have Lang apply to Set Lang364 Converting from One Encoding Method to Another Rebinding Alt 366 SoftBench Mnemonics and Non-USASCII Character Inputs Changing or Removing Menu Mnemonics 368 Customizing Keyboard Accelerators 370 Starting Your Localized SoftBench Remote Execution Hosts and NLS 372 Editing in SoftBench Character Input Example 374 Glossary 375 376 377 378 379 380 381 382 383 See also Project Root 384 385 386 387 388 Symbols Index389 390 CDE 391 392 393 394 395 396 397 398 399 400 401 402 Graph, 47, 66 403 404 405