Customizing SoftBench Static Analyzer | HP UX SoftBench Software

Using SoftBench Static Analyzer

Customizing SoftBench Static Analyzer

Customizing SoftBench Static Analyzer

SoftBench Static Analyzer has many options that allow you to conﬁgure the tool for your unique environment and working style:

•Use the "View" menu to make changes to the display of data.

•Use the "Options" menu to change the behavior of SoftBench Static Analyzer.

•Choose "Project: Modify Properties…" in the main SoftBench window to change the location of the Static database.

All SoftBench Static Analyzer queries rely on the information stored in the Static.sadb ﬁle. If your project encompasses source code from several directories, SoftBench stores all Static information in the project's Static.sadb ﬁle.

By default, SoftBench stores the Static database in the project data for a project that uses project build. It stores the Static database in the build directory for a project that uses external build.

You should not move the Static database ﬁle unless you have unsupported customization needs. To return to the default location for the Static database, clear the "Static database" text ﬁeld.

•Use the "View" and "Options" menus on the Static Graph to customize the graphs. See Chapter 10, “Using Static Graphs,” on page 283.

See SoftBench Online Help for explanations of each menu command. When you customize the appearance and behavior, SoftBench Static Analyzer automatically saves the changes.

When you make changes to the the display of data ("View" menu), and behavior of SoftBench Static Analyzer ("Options" menu), SoftBench Static Analyzer automatically saves the changes.

Chapter 9

275

Image 275

HP UX SoftBench Software manual Customizing SoftBench Static Analyzer

Contents

Manufacturing Part Number B6454-97413 June C++ SoftBench Users Guide Legal 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 Flow SoftBench Tools Interacting with Project and Files Understanding ProjectsMore sets of build instructions and dependencies 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 Models Understanding Projects One Project, Many Authors Sharing Projects with a TeamOne Project, One Author Team Members Cloning the Project Deﬁnition Team Members Sharing the Project Deﬁnition Team Members Using SubprojectsOne Project with Subprojects, Many Authors Sharing Projects with a Team Chapter Planning Your Project SoftBench Static Analyzer Using the SoftBench Integrated EnvironmentEditors Conﬁguration Management SoftBench Message Monitor Using SoftBench Tools Throughout Your Development CycleSoftBench Debugger SoftBench File Compare Using SoftBench Tools Together Tools That Can Directly Invoke Other Tools Using SoftBench Tools on Multiple Projects 10 Iconize and Normalize Project Buttons Using SoftBench Tools as Standalone Tools Copying Data between SoftBench Tools Reusing Tool Windows An Example SoftBench Session An Example SoftBench Session Learning SoftBench Using SoftBench Shell Syntax Prerequisites to Using SoftBench Starting SoftBench Unexpanded SoftBench Window Understanding SoftBench Window Areas Window Area Description Description of SoftBench Window Areas Static, and Optimized compiler Expanded SoftBench Window Displaying Builder Understanding the Builder CodeAdvisor Understanding the SoftBench CodeAdvisorExpanded SoftBench Window Displaying SoftBench Understanding SoftBench Window Areas Creating a Project Using Project Build Setting Up a Project Create Project Dialog Box Create Project Dialog Box for External Build Creating a Project Using 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 Add Files to Project Dialog Box Adding Existing Files to a Project Adding Existing Files to a Project Creating a Target Deﬁning Targets for Project Build Specifying Dependency Relationships Manage Build Conﬁguration Dialog Box Customizing Build Conﬁgurations Using Build Packages Deﬁning Targets for External Build External Build Command Dialog Box Deﬁning Targets for External Build Build Model Operations in the Target Graph Using the Target Graph Operation Project Build External Build Understanding the Graph Color Meaning Displaying DependenciesGraph Node States Starting Your Conﬁgured Editor Controlling Graph ComplexityBuilding a Selected Target Building Projects and Targets Setting the Compile Mode Compile Mode Settings Default Compiler Flag Previewing the Build Using the External Build Command Dialog Box Building Subprojects Handling ErrorsCompiling Instead of Building Browsing and Correcting Build Errors Interpreting Error Messages 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 Registering New Tools with SoftBench Choosing Tool Preferences Accessing Distributed Data and Tools Customizing SoftBench by Setting Resources Stopping SoftBench Running SoftBench on a Remote SystemIntegrating with CDE Restoring Your Previous SoftBench Session 11 SoftBench Online Help Window Getting Help Accessing On Item Help Using the Help Menu Condition or Explanation Message If Something Goes Wrong For More Information For More Information Chapter Using SoftBench Conﬁguration Integration of SoftBench CM with SoftBench Understanding SoftBench CM Understanding 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 System Viewing Local Servers and SoftBench CM Archives SoftBench CM Main Window Creating an Archive DirectoryFile or directory name SoftBench CM File Mapping Creating a Mapping between an Archive DirectoryLocal Directory Modifying Mappings between Local and Archive Directories 100 Show / Modify Mappings Dialog Box Chapter 101 102 Managing Archive Files and DirectoriesCreating Initial Archive Files Checking Out Archive Files Updating a Local Directory Cancelling Archive File Check Out Viewing Contents of Archive Files Viewing an Archive File 106 Deleting Archive Files and DirectoriesLocking an Archive File Break File Lock Dialog Box Breaking a Lock on an Archive FileViewing the Revision History of Archive Files 108 Show Revision History Dialog Box for an Archive File Setting Archive Display Filters 110 Managing Local FilesModifying Local Source Files Checking In Modiﬁed Files Chapter 111 112 Creating a Default Symbolic Name for Archive FilesUnderstanding Symbolic Names Symbolic Name Example Deﬁning Symbolic Names 114 Symbolic Names and Revision Numbers File File YActions and Results After Setting Symbolic Name List Action Result Man Task Description Using the SoftBench CM Command Line InterfaceSoftBench CM Command Line Man Pages 116 Using SoftBench Editors 118 Using Editors with Projects Conﬁguring SoftBench Program Editor Conﬁguring an EditorConﬁguring SoftBench vi Editor 120 Starting the Conﬁgured SoftBench Editor 122 Editing with SoftBench XEmacs Editor Using SoftBench XEmacs 124 Accessing HelpEditing Multiple Files SoftBench XEmacs Main Window Chapter 125 126 Editing with SoftBench vi EditorSoftBench vi Editor Window Using the Mouse Pointer Versus the Text Cursor 128 Reusing the Edit WindowIf the vi autowrite SoftBench vi Editors behavior Option Selecting, Copying, and Pasting Text Building a Project Accessing SoftBench Static Analyzer from the EditorCalling Other SoftBench Tools from the Editors Compiling a Program File Using Conﬁguration Management Setting Breakpoints in a Program File 132 Using SoftBench Class 134 Editing C++ Structures with SoftBench Class Graph/EditorUnderstanding the SoftBench Class Graph/Editor Use Model SoftBench Class Graph/Editor Use Model 136 Synchronizing Editor Views and the Static Database Chapter 137 138 Using SoftBench Class Graph/Editor in Your WorkViewing the Existing Class Hierarchy Modifying Existing Components Creating New Components 140 Deleting Existing Components Working with Class Templates Sample Use ModelsCreating a New Program Modifying an Existing Program 142 Condition Explanation 144 Using SoftBench CodeAdvisor 146 Using SoftBench CodeAdvisor Chapter 147 148 Preparing Your Program with External Build Performing the Check Code OperationPreparing Your Program with Project Build 150 Accessing SoftBench CodeAdvisorSelecting Rule Groups Checking Your Program Violations Display Viewing Violations 152 Terminating SoftBench CodeAdvisorFiltering Rule Violations Chapter 153 154 Using SoftBench Debugger 156 Understanding SoftBench Debugger Chapter 157 158 Preparing Your Program for Debugging 160 Using SoftBench Debugger Window AreasSoftBench Debugger Window Chapter 161 162 Tear Apart Main Toolface Tearing Apart the Main Toolface 164 Specifying the Runtime Environment Loading or Rerunning an Executable Program 166 Load Executable Dialog Box Specifying Standard I/O Setting Environment VariablesSpecifying the Working Directory and Program Arguments 168 Specifying Source Locations Adding Source Directories for External Builds Debugging Executables in a Project 170 Add Source Directories Dialog Box Stepping through Your Program 172 Interrupting a Running ProgramInterrupting in System or Non-debuggable Routines Chapter 173 174 Interacting with Your ProgramInteracting with a Standard I/O Program Interacting with a Window-Smart Program Interacting with a Terminal-Smart Program 176 Specifying Program Location Specifying Identiﬁer Locations 178 Specifying Variables Chapter 179 180 Examining and Changing Data in Your Program 182 Examining Data in Your Program Changing Data in Your Program Using Debugger VariablesPrinting Hex or String Values 184 Using Expressions Using Constants 186 Calling FunctionsViewing the Call Stack Stack View Window Viewing Thread Stacks 188 Understanding the Operation of Your Program Debugging a Program Using Breakpoints Setting and Using Breakpoints 190 Setting a BreakpointUsing the Editable Source Area Break Menu 192 Using the Break MenuUsing the Breakpoint Set/Change Dialog Box Breakpoint Set/Change Dialog Box Viewing and Modifying Breakpoints 194 Clearing a BreakpointChanging Active / Suspend Status Changing Verbose / Silent Status Executing DDE Commands at a Breakpoint 196 Viewing and Modifying Group Breakpoints Setting C++ BreakpointsSetting Group Breakpoints 198 Setting and Using Watchpoints 200 Using the Watch MenuUsing the Data Watchpoint Set/Change Dialog Box Creating Watchpoints Data Watchpoint Window Viewing and Modifying Watchpoints 202 Clearing a Watchpoint Chapter 203 204 Using the Trace MenuTracing Program Flow Creating Traces Trace Set/Change Dialog Box Using the Trace Set/Change Dialog BoxViewing Traces 206 Clearing Traces Editing Source Code Correcting Errors in Your Program 208 Synchronizing Files Debugging Dynamic Libraries 210 10 Dynamic Images/Libraries Dialog Box Tracing Assembly Language Viewing Assembly Language and CPU Registers 212 Tracing Registers Chapter 213 214 Handling Signals and EventsViewing and Editing Intercepts Chapter 215 216 Handling Signals Debugging with a Core File Signal Error Message Text NameDebugging After a Program Fails Core Dump 218 Debugging Forked Processes 220 Debugging Threaded ApplicationsViewing and Manipulating Threads Setting Breakpoints on Threads 222 Attaching the Debugger to a Running Program Debugging C++ Programs 224 Debugging Static Constructors Using Breakpoints for Exception HandlingAccessing Inherited C++ Values 226 Debugging Optimized Code 228 Customizing SoftBench DebuggerSpecifying Debugger Options Customizing User Buttons Chapter 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 Session Data Graph Window Areas Understanding Data Graph Window AreasUnderstanding the Layout Control Area 238 Understanding the Display Control AreaUnderstanding the Graph Area Reading Nodes Data Graph Window Action MenusObject Selected Actions Allowed 240 Using Dialog BoxesUnderstanding the Window Control Area Reading Arcs Displaying New Nodes Using the Graph AreaUsing the Node Values Dialog Box 242 Node Values Dialog Box Following Selected Pointers Setting Data Member ValuesNode Values Dialog Box Action Menu Displaying Data Members 244 Suspending Graph UpdatesDeactivating the Graph Stopping a Graph Process Viewing btree Verifying Correct Data Structures 246 Binary Tree NodeContinuing Program Execution Binary Tree Node with Children Dereferencing Particular Data Members Viewing Values of Data MembersShowing Nodes Showing Values On the Graph Viewing Values from Multiple NodesViewing Embedded Arrays Viewing Values from Embedded Arrays Viewing Data Members on The Graph Nodes 250 Using SoftBench Static 252 Starting SoftBench Static Analyzer Chapter 253 254 Preparing to Make QueriesGenerating Static Data Including Subprojects and Parent Projects Using the Default Analysis File SetUpdating Static Data without Building Specifying Static Data to Analyze 256 Customizing the File Set in Non-Project ModeKeeping Analysis Files Current Determining the File Set Status Filtering Queries by File Set 258 Using SoftBench Static Analyzer Window Areas SoftBench Static Analyzer Window and Areas 260 Making Textual Static QueriesMaking General Queries Making Queries Based on a Program Identiﬁer Understanding the Types of References Selecting Text 262 Relationships among Reference QueriesDetermining Identiﬁer Classiﬁcation Using Pattern Matching Troubleshooting Invalid Identiﬁers for Queries Updating the Database Using Query ResultsBrowsing the Query Result Editing the Source File Performing a Query SoftBench Static Analyzer Display Options Filtering Results Using the File SetCommand Description Simplifying Query Results Filtered Source File List Unﬁltered Source File List 268 Using ScopingFiltering C++ Query Results Scoping Example Troubleshooting Scoping InformationScoping Prerequisites and Constraints 270 Saving and Printing a Query Result Redisplaying Past QueriesRedisplaying Query Results Deleting a Query Result 272 Searching Subdirectories Using SoftBench Static Analyzer in Standalone ModeGenerating Static Data from the Command Line 274 Using the Staticﬁleset File Customizing SoftBench Static Analyzer 276 Condition or Message ExplanationAnalysis ﬁle set choose F ile Chapter 277 278 Chapter 279 280 Staticrmﬁle1 Chapter 281 282 Using Static Graphs 284 Starting SoftBench Static Analyzer Graphs 286 General Static Graph FeaturesMaking Graphical Static Queries Operating on Static Graph Nodes Finding Graph Nodes 288 Switching between Static GraphsDisplaying Nodes on Another Graph Function Description Dialog Box Using Description Boxes 290 Setting Breakpoints for SoftBench DebuggerSaving Static Graph Images to Files Chapter 291 292 Simplifying Graph DisplaysReducing Graph Complexity Filtering Sourceless Nodes 294 Customizing Static GraphsRemoving the Graph Legend Viewing Multiple Graphs Using SoftBench File Compare 296 Understanding the SoftBench File Compare WindowUnderstanding the Menu Bar Understanding the Working Directory Input Box Reading the Gutter Column Using the Left File and Right File Input BoxesUsing the Merge File Input Box Understanding the Text Areas 298 Selecting Lines for MergingLeft Right Selection Column Traversing by Single Line Highlighting Differences 300 Comparing Two Files Merging Compared Files 302 Chapter 303 304 Using SoftBench Message Monitor 306 Starting SoftBench Message Monitor Understanding Broadcast Messages Understanding the SoftBench Message Monitor Window Area 308 Clearing the Broadcast Message Area Send Message Dialog Box Composing and Sending a Message 310 For SoftBench XEmacs Starting and Stopping Message Logging Logging MessagesSpecifying a Log File 312 Using SoftBench with SQL 314 Determining Supported Environments SQL File Extensions for C Language Using Default SQL File TypesUsing SQL with Project Build Conﬁguring SoftBench with SQL 316 Updating Rdbms Versions Using SQL with External Build 318 Debugging with SQL Using SQL with SoftBench ToolsUsing SQL Preprocessor Wrappers 320 Debugging Expanded SQL Statements Editing and Rebuilding with SQL for SoftBench Debugger 322 Using SoftBench Graph Windows 324 Accessing SoftBench Graph Windows Appendix a 325 326 Using Graph Window AreasUsing Popup Menus Using Save Options for the Graph Image Figure A-1 Save Image Dialog Box Table A-2 Graph Image File Formats Option Used for 328 Using Graph File Image Save OptionsSaving HP-GL and PostScript Images Saving xwd Images 330 Using Vertical and Horizontal Scrolling Clearing the Graph Area Zooming In or Zooming Out 332 Understanding Nodes and ArcsReading Graph Area Nodes Selecting Nodes and Arcs Appendix a 333 334 Table A-4 Methods for Selecting Multiple Objects ProcedureMoving Nodes Appendix a 335 Controlling Graph Display Menu settingsCustomizing SoftBench Graphs Controlling Graph Layout Understanding Window Status Information 338 Customizing SoftBench CM Conﬁguration 340 Modifying the Conﬁguration FilesTable B-1 Server Conﬁguration Files File Name Description Figure B-1 File Mapping Between Local and Archive Files Conﬁguring Where Archive Files are Stored 342 Deﬁning User Access to the Server Appendix B 343 344 Format 2. Place path ﬁeld ﬁrst and permissions ﬁeld second Recommended Format for Permissions FileFormat 1. Place user ﬁeld ﬁrst and permissions ﬁeld second 346 Setting Logging and Debug Options Appendix B 347 348 Performing SoftBench CM Administrator TasksMigrating Archive Files From RCS Migrating Archive Files From Sccs Moving Archive Storage Locations Creating Archive BackupsModifying the Lockinfo File 350 Using the Archive Activity Log TroubleshootingUsing the Archive Status and Error Log 352 Using Regular Expressions 354 Pattern Matching Appendix C 355 356 Appendix C 357 358 Appendix C 359 360 Customizing SoftBench for Native Language Support NLS 362 Preparing to Use NLS in SoftBench Appendix D 363 364 Setting the Lang Environment VariableTable D-1 To have Lang apply to Set Lang Converting from One Encoding Method to Another 366 Rebinding Alt Changing or Removing Menu Mnemonics SoftBench Mnemonics and Non-USASCII Character Inputs 368 Customizing Keyboard Accelerators 370 Starting Your Localized SoftBench 372 Remote Execution Hosts and NLS Character Input Example Editing in SoftBench 374 375 Glossary 376 377 378 379 380 381 382 383 384 See also Project Root 385 386 387 388 389 SymbolsIndex 390 391 CDE 392 393 394 395 396 397 398 399 400 401 402 403 Graph, 47, 66 404 405