Manuals / HP / Computer Equipment / Software

HP UX SoftBench Software manual For More Information

Models: UX SoftBench Software

1 405

Download 405 pages 63.07 Kb

Page 87

Using SoftBench

For More Information

For More Information

•On getting started with SoftBench, choose "Help: Tutorial".

•On understanding particular features of a SoftBench tool, build conﬁgurations, build packages, and transforms, see SoftBench Online Help.

•On compiler-generated error messages, see the language reference manual available under "Help: Language Reference".

•On SoftBench CodeAdvisor, see Chapter 6, “Using SoftBench CodeAdvisor,” on page 145 and the softcheck(1) man page, available under "Help: Show Man Page".

•On installing and conﬁguring your SoftBench environment, see Installing SoftBench.

•On customizing SoftBench, see the "Customizing SoftBench" entry in SoftBench Online Help (accessible by choosing "Help: Welcome").

Chapter 2

87

Image 87

HP UX SoftBench Software manual For More Information

Contents

Manufacturing Part Number B6454-97413 June C++ SoftBench Users GuideLegal Notices Page Printing History Boldface font Convention DescriptionPage 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 Major Software Development Tasks Supported by SoftBench SoftBench Task FlowUnderstanding Projects More sets of build instructions and dependenciesSoftBench Tools Interacting with Project and Files Building Targets Understanding Build Conﬁgurations and Packages Understanding Projects Simpliﬁed Build Conﬁguration, Package, and Transform Series Choosing Between Project Build and External Build ModelsUnderstanding 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 SoftBench Static Analyzer Using the SoftBench Integrated EnvironmentEditors Conﬁguration ManagementSoftBench Message Monitor Using SoftBench Tools Throughout Your Development CycleSoftBench Debugger SoftBench File CompareUsing SoftBench Tools Together Tools That Can Directly Invoke Other Tools Using SoftBench Tools on Multiple Projects10 Iconize and Normalize Project Buttons Using SoftBench Tools as Standalone ToolsCopying Data between SoftBench Tools Reusing Tool WindowsAn Example SoftBench Session An Example SoftBench Session Learning SoftBench Using SoftBench Shell Syntax Prerequisites to Using SoftBenchStarting SoftBench Unexpanded SoftBench Window Understanding SoftBench Window AreasWindow Area Description Description of SoftBench Window AreasStatic, and Optimized compiler Expanded SoftBench Window Displaying Builder Understanding the BuilderUnderstanding the SoftBench CodeAdvisor Expanded SoftBench Window Displaying SoftBenchCodeAdvisor Understanding SoftBench Window Areas Creating a Project Using Project Build Setting Up a ProjectCreate Project Dialog Box Create Project Dialog Box for External Build Creating a Project Using External BuildCloning a Project from an Existing Project Repartitioning an Existing Project Creating a Subproject Modifying a Project Deﬁnition Creating Files within a Project Add Files to Project Dialog Box Adding Existing Files to a ProjectAdding Existing Files to a Project Creating a Target Deﬁning Targets for Project BuildSpecifying Dependency Relationships Manage Build Conﬁguration Dialog Box Customizing Build ConﬁgurationsUsing Build Packages Deﬁning Targets for External Build External Build Command Dialog BoxDeﬁning Targets for External Build Build Model Operations in the Target Graph Using the Target GraphOperation Project Build External Build Understanding the GraphDisplaying Dependencies Graph Node StatesColor Meaning Controlling Graph Complexity Building a Selected TargetStarting Your Conﬁgured Editor Building Projects and Targets Setting the Compile ModeCompile Mode Settings Default Compiler Flag Previewing the Build Using the External Build Command Dialog BoxHandling Errors Compiling Instead of BuildingBuilding Subprojects Browsing and Correcting Build Errors Interpreting Error MessagesRunning 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 Registering New Tools with SoftBench Choosing Tool PreferencesAccessing Distributed Data and Tools Customizing SoftBench by Setting ResourcesRunning SoftBench on a Remote System Integrating with CDEStopping SoftBench Restoring Your Previous SoftBench Session 11 SoftBench Online Help Window Getting HelpAccessing On Item Help Using the Help MenuCondition or Explanation Message If Something Goes WrongFor More Information For More Information Chapter Using SoftBench Conﬁguration Integration of SoftBench CM with SoftBench Understanding SoftBench CMUnderstanding SoftBench CM Getting Started a Brief Overview Choose Directory Create… Choose Actions Check Out to Local Directory Browsing Local Network Servers and Archives Managing the Archive SystemViewing 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 100 Show / Modify Mappings Dialog BoxChapter 101 102 Managing Archive Files and DirectoriesCreating Initial Archive Files Checking Out Archive FilesUpdating a Local Directory Cancelling Archive File Check OutViewing 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 108 Show Revision History Dialog Box for an Archive FileSetting Archive Display Filters 110 Managing Local FilesModifying Local Source Files Checking In Modiﬁed FilesChapter 111 Creating a Default Symbolic Name for Archive Files Understanding Symbolic Names112 Symbolic Name Example Deﬁning Symbolic Names114 Symbolic Names and Revision Numbers File File YActions and Results After Setting Symbolic Name List Action ResultUsing the SoftBench CM Command Line Interface SoftBench CM Command Line Man PagesMan Task Description 116 Using SoftBench Editors 118 Using Editors with ProjectsConﬁguring an Editor Conﬁguring SoftBench vi EditorConﬁguring SoftBench Program Editor 120 Starting the Conﬁgured SoftBench Editor 122 Editing with SoftBench XEmacs EditorUsing SoftBench XEmacs 124 Accessing HelpEditing Multiple Files SoftBench XEmacs Main WindowChapter 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 Building a Project Accessing SoftBench Static Analyzer from the EditorCalling Other SoftBench Tools from the Editors Compiling a Program FileUsing Conﬁguration Management Setting Breakpoints in a Program File132 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 136 Synchronizing Editor Views and the Static DatabaseChapter 137 Using SoftBench Class Graph/Editor in Your Work Viewing the Existing Class Hierarchy138 Modifying Existing Components Creating New Components140 Deleting Existing ComponentsWorking with Class Templates Sample Use ModelsCreating a New Program Modifying an Existing Program142 Condition Explanation 144 Using SoftBench CodeAdvisor 146 Using SoftBench CodeAdvisorChapter 147 148 Performing the Check Code Operation Preparing Your Program with Project BuildPreparing Your Program with External Build 150 Accessing SoftBench CodeAdvisorSelecting Rule Groups Checking Your ProgramViolations Display Viewing ViolationsTerminating SoftBench CodeAdvisor Filtering Rule Violations152 Chapter 153 154 Using SoftBench Debugger 156 Understanding SoftBench DebuggerChapter 157 158 Preparing Your Program for Debugging Using SoftBench Debugger Window Areas SoftBench Debugger Window160 Chapter 161 162 Tear Apart Main Toolface Tearing Apart the Main Toolface164 Specifying the Runtime Environment Loading or Rerunning an Executable Program166 Load Executable Dialog BoxSetting Environment Variables Specifying the Working Directory and Program ArgumentsSpecifying Standard I/O 168 Specifying Source LocationsAdding Source Directories for External Builds Debugging Executables in a Project170 Add Source Directories Dialog BoxStepping 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 Window-Smart Program Interacting with a Terminal-Smart Program176 Specifying Program Location Specifying Identiﬁer Locations178 Specifying VariablesChapter 179 180 Examining and Changing Data in Your Program 182 Examining Data in Your ProgramUsing Debugger Variables Printing Hex or String ValuesChanging Data in Your Program 184 Using ExpressionsUsing Constants Calling Functions Viewing the Call Stack186 Stack View Window Viewing Thread Stacks188 Understanding the Operation of Your ProgramDebugging a Program Using Breakpoints Setting and Using BreakpointsSetting a Breakpoint Using the Editable Source Area190 Break Menu Using the Break Menu Using the Breakpoint Set/Change Dialog Box192 Breakpoint Set/Change Dialog Box Viewing and Modifying Breakpoints194 Clearing a BreakpointChanging Active / Suspend Status Changing Verbose / Silent StatusExecuting DDE Commands at a Breakpoint 196 Setting C++ Breakpoints Setting Group BreakpointsViewing and Modifying Group Breakpoints 198 Setting and Using Watchpoints 200 Using the Watch MenuUsing the Data Watchpoint Set/Change Dialog Box Creating WatchpointsData Watchpoint Window Viewing and Modifying Watchpoints202 Clearing a WatchpointChapter 203 204 Using the Trace MenuTracing Program Flow Creating TracesUsing the Trace Set/Change Dialog Box Viewing TracesTrace Set/Change Dialog Box 206 Clearing TracesEditing Source Code Correcting Errors in Your Program208 Synchronizing FilesDebugging Dynamic Libraries 210 10 Dynamic Images/Libraries Dialog BoxTracing Assembly Language Viewing Assembly Language and CPU Registers212 Tracing RegistersChapter 213 Handling Signals and Events Viewing and Editing Intercepts214 Chapter 215 216 Handling SignalsSignal 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 222 Attaching the Debugger to a Running ProgramDebugging C++ Programs 224 Using Breakpoints for Exception Handling Accessing Inherited C++ ValuesDebugging Static Constructors 226 Debugging Optimized Code 228 Customizing SoftBench DebuggerSpecifying Debugger Options Customizing User ButtonsChapter 229 230 Chapter 231 232 Offset argument.Chapter 233 234 Using SoftBench Debugger Data 236 Starting and Stopping the Data Graph WindowBeginning a Browsing Session Stopping a Browsing SessionUnderstanding 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 240 Using Dialog BoxesUnderstanding the Window Control Area Reading ArcsUsing the Graph Area Using the Node Values Dialog BoxDisplaying New Nodes 242 Node Values Dialog BoxFollowing Selected Pointers Setting Data Member ValuesNode Values Dialog Box Action Menu Displaying Data Members244 Suspending Graph UpdatesDeactivating the Graph Stopping a Graph ProcessViewing btree Verifying Correct Data Structures246 Binary Tree NodeContinuing Program Execution Binary Tree Node with ChildrenViewing Values of Data Members Showing NodesDereferencing Particular Data Members Showing Values On the Graph Viewing Values from Multiple NodesViewing Embedded Arrays Viewing Values from Embedded ArraysViewing Data Members on The Graph Nodes 250 Using SoftBench Static 252 Starting SoftBench Static AnalyzerChapter 253 Preparing to Make Queries Generating Static Data254 Including Subprojects and Parent Projects Using the Default Analysis File SetUpdating Static Data without Building Specifying Static Data to AnalyzeCustomizing the File Set in Non-Project Mode Keeping Analysis Files Current256 Determining the File Set Status Filtering Queries by File Set258 Using SoftBench Static Analyzer Window AreasSoftBench Static Analyzer Window and Areas 260 Making Textual Static QueriesMaking General Queries Making Queries Based on a Program IdentiﬁerUnderstanding the Types of References Selecting TextRelationships among Reference Queries Determining Identiﬁer Classiﬁcation262 Using Pattern Matching Troubleshooting Invalid Identiﬁers for QueriesUpdating the Database Using Query ResultsBrowsing the Query Result Editing the Source FilePerforming a Query SoftBench Static Analyzer Display Options Filtering Results Using the File SetCommand Description Simplifying Query ResultsFiltered Source File List Unﬁltered Source File ListUsing Scoping Filtering C++ Query Results268 Troubleshooting Scoping Information Scoping Prerequisites and ConstraintsScoping Example 270 Saving and Printing a Query Result Redisplaying Past QueriesRedisplaying Query Results Deleting a Query Result272 Using SoftBench Static Analyzer in Standalone Mode Generating Static Data from the Command LineSearching Subdirectories 274 Using the Staticﬁleset FileCustomizing SoftBench Static Analyzer Condition or Message Explanation Analysis ﬁle set choose F ile276 Chapter 277 278 Chapter 279 280 Staticrmﬁle1Chapter 281 282 Using Static Graphs 284 Starting SoftBench Static Analyzer Graphs General Static Graph Features Making Graphical Static Queries286 Operating on Static Graph Nodes Finding Graph NodesSwitching between Static Graphs Displaying Nodes on Another Graph288 Function Description Dialog Box Using Description BoxesSetting 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 296 Understanding the SoftBench File Compare WindowUnderstanding the Menu Bar Understanding the Working Directory Input BoxReading the Gutter Column Using the Left File and Right File Input BoxesUsing the Merge File Input Box Understanding the Text AreasSelecting Lines for Merging Left Right Selection Column298 Traversing by Single Line Highlighting Differences300 Comparing Two FilesMerging Compared Files 302 Chapter 303 304 Using SoftBench Message Monitor 306 Starting SoftBench Message MonitorUnderstanding Broadcast Messages Understanding the SoftBench Message Monitor Window Area308 Clearing the Broadcast Message AreaSend Message Dialog Box Composing and Sending a Message310 For SoftBench XEmacsLogging Messages Specifying a Log FileStarting and Stopping Message Logging 312 Using SoftBench with SQL 314 Determining Supported EnvironmentsSQL File Extensions for C Language Using Default SQL File TypesUsing SQL with Project Build Conﬁguring SoftBench with SQL316 Updating Rdbms Versions Using SQL with External Build318 Using SQL with SoftBench Tools Using SQL Preprocessor WrappersDebugging with SQL 320 Debugging Expanded SQL StatementsEditing and Rebuilding with SQL for SoftBench Debugger 322 Using SoftBench Graph Windows 324 Accessing SoftBench Graph WindowsAppendix a 325 326 Using Graph Window AreasUsing Popup Menus Using Save Options for the Graph ImageFigure A-1 Save Image Dialog Box Table A-2 Graph Image File Formats Option Used forUsing Graph File Image Save Options Saving HP-GL and PostScript Images328 Saving xwd Images 330 Using Vertical and Horizontal ScrollingClearing the Graph Area Zooming In or Zooming Out332 Understanding Nodes and ArcsReading Graph Area Nodes Selecting Nodes and ArcsAppendix a 333 Table A-4 Methods for Selecting Multiple Objects Procedure Moving Nodes334 Appendix a 335 Controlling Graph Display Menu settingsCustomizing SoftBench Graphs Controlling Graph LayoutUnderstanding Window Status Information 338 Customizing SoftBench CM Conﬁguration Modifying the Conﬁguration Files Table B-1 Server Conﬁguration Files File Name Description340 Figure B-1 File Mapping Between Local and Archive Files Conﬁguring Where Archive Files are Stored342 Deﬁning User Access to the ServerAppendix 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 346 Setting Logging and Debug OptionsAppendix B 347 348 Performing SoftBench CM Administrator TasksMigrating Archive Files From RCS Migrating Archive Files From SccsCreating 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 354 Pattern MatchingAppendix C 355 356 Appendix C 357 358 Appendix C 359 360 Customizing SoftBench for Native Language Support NLS 362 Preparing to Use NLS in SoftBenchAppendix D 363 Setting the Lang Environment Variable Table D-1 To have Lang apply to Set Lang364 Converting from One Encoding Method to Another 366 Rebinding AltChanging or Removing Menu Mnemonics SoftBench Mnemonics and Non-USASCII Character Inputs368 Customizing Keyboard Accelerators 370 Starting Your Localized SoftBench 372 Remote Execution Hosts and NLSCharacter Input Example Editing in SoftBench374 375 Glossary376 377 378 379 380 381 382 383 384 See also Project Root385 386 387 388 Symbols Index389 390 391 CDE392 393 394 395 396 397 398 399 400 401 402 403 Graph, 47, 66404 405