Using Cadvise, Getting started | HP UX Web Development Tools

2 Using Cadvise

This chapter addresses the following topics:

•“Getting started” (page 10)

•“Steps in using cadvise” (page 10)

•“Invoking Cadvise” (page 11)

•“Using Cadvise as a wrapper around Compiler or Linker” (page 12)

•“Integrating Cadvise with the makefiles and build process” (page 12)

•“Enabling different categories of diagnostic messages” (page 13)

•“Generating code complexity metrics” (page 13)

•“Detecting violation of pre-defined or user-defined coding guidelines” (page 17)

2.1Getting started

This section addresses the following topics:

•“Supported platforms” (page 10)

•“Installing Cadvise” (page 10)

2.1.1Supported platforms

You can install and use cadvise on the following platforms:

•HP-UX 11i v3 (B.11.31) PA-RISC (HP 9000) and HP Integrity systems

•HP-UX 11i v2 (B.11.23) PA-RISC (HP 9000) and HP Integrity systems

•HP-UX 11i v1 (B.11.11) PA-RISC (HP 9000) systems

2.1.2Installing Cadvise

To install cadvise, complete the following steps:

1.Download cadvise for your platform through the website http://www.hp.com/go/cadvise.

2.Install cadvise using the swinstall command. For more information on using the swinstall command, see Software Distributor Administration Guide.

Cadvise is installed in the /opt/cadvise/bin/cadvise directory by default.

2.2 Steps in using cadvise

Cadvise is part of an iterative process of building, analyzing, reporting, and removing the potential coding errors in an application, as shown in Figure 2.

10 Using Cadvise

Image 10

HP UX Web Development Tools Using Cadvise, Getting started, Steps in using cadvise, Supported platforms Installing Cadvise

Contents

HP Code Advisor C.02.20 User Guide Page Contents Contents Intended audience Document conventions and symbolsAbout this document Related information HP encourages your comments Cadvise-help@lists.hp.com Introduction FeaturesCadvise user interface Features Cadvise user interface Advanced static code analysis $ cadvise cc -c hello.c Supported compilers $ cadvise -pdb ./mypdb +wlint aCC hello.cpp Supported platforms Installing Cadvise Using CadviseSteps in using cadvise Getting started Invoking Cadvise See the following makefile content Using Cadvise as a wrapper around Compiler or LinkerFor information on PDB, see Using the Program Database PDB Integrating Cadvise with the makefiles and build process Generating code complexity metrics Enabling different categories of diagnostic messagesExample 2 Sample wrapper script Example 3 Generating code complexity metrics Objfile.metrics Generating code complexity metrics Example 4 Code complexity metrics $ cat /tmp/example.c +wcodeguide=rules-library Source structure in the rules library Example 5 Writing a rule to enforce naming convention Using the Program Database PDB Deleting PDB PDB options tableSpecifying the PDB location Disabling locks in PDB operations Example 8 Removing object file information from the PDB Creating a PDB snapshot at a specified locationDisplaying PDB version Example 9 Creating a PDB snapshot Usage Using cross-file analysisCross-file analysis options Crossfile=auto Example 15 Specifying the location of object files Suppressing warnings selectively Configuring diagnostic messagesDiagnostic configuration options table Enabling warnings selectively Disabling warnings in a macro Interpreting selective warnings as errorsManaging warnings in a source file Cadvise report report-options -pdb pdbdir Generating reportsReport generation options table Cadvise report report-options logfile Generating detailed report Generating summary reportsGenerating file summary report $cadvise report -summary -pdb testpdb -noheader Example 23 Generating detailed report To save reports, run the following commandGenerating Html report $ cadvise report -pdb testpdb -all Generating XML report Printing diagnostics with specific diagnostic numbersFollowing example shows the command to generate XML report Example 24 Generating an XML report $ cadvise report -pdb testpdb -diag Suppressing diagnostics for specific filesGenerating reports based on severity Example 26 Generating reports based on severity $ cadvise report -pdb test.pdb -summary -exclude inflate.c Reporting diagnostics from specific filesReporting program complexity metrics $ cadvise report -pdb test.pdb -summary -include inflate.c Example 29 Reporting program complexity metrics Generating report for a module$ cadvise report -pdb gzip.pdb +metrics -include inflate.c Generating PDB comparison report Modifying the default severity level of a diagnosticSuppressing report header $ cadvise report -pdb test.pdb -summary -module test1 Example 34 Generating detailed diff report with the header $ cadvise report -pdb tmp.pdb -basepdb tmp1.pdb -all Example 35 Generating diff report for any particular warning $ cadvise report -pdb tmp.pdb -basepdb tmp1.pdb -diag $ cadvise report -pdb tmp.pdb -basepdb tmp1.pdb -severity $ cadvise -pdb pdb1 cc one.c two.c Report options file $ cadvise report -pdb new.pdb -basepdb old.pdb -all Generating consolidated report from multiple PDBs Example 42 Generating a report using -migration optionGenerate report for migration related warnings Example 41 Report options file Report options interoperability Recommended process for analyzing the diagnostic messagesGenerating PDB diffs with multiple PDBs $ cadvise report -pdb 1.pdb2.pdb3.pdb4.pdb -all Example 45 Ignoring the -includeoption Example 44 Reporting options interoperability$ cadvise report -pdb test.pdb -diag 2549 -exclude b.c $ cadvise report -pdb test.pdb -summary -include a.cb.c Help-h-H Example 48 Using -noabortMiscellaneous driver options Example 47 Displaying the list of cadvise options Example 51 Using -tee option Example 49 Using -nobuild optionFollowing command creates the file cadvdir/foo.cad Following example shows the usage of -nobuildoption Example 52 Using +opts filename option Line generates the following messages Categories of diagnostics table Categories of diagnostics with examplesDetecting generic programming errors Categories of diagnostics with examples Example 53 Null pointer dereference check Such cases, cadvise generates the following warning Example 54 Potential memory leak check Such cases, cadvise generates the following warnings Example 55 Out of bound access Example 56 Out of scope access Example 57 Use of pointer after free Such cases, cadvise generates the following errorExample 58 Allocator/deallocator mismatch Example 60 Detecting 32-bit to 64-bit migraton issues Detecting 32-bit to 64-bit migraton issuesDetecting endianness migration issues Example 59 Signed bit field of length Example 61 Detecting endian dependent code fragments Detecting potential security vulnerabilitiesConsider the following code fragment Detecting multi-threaded programming issues This case, cadvise generates the following error Running cadvise generates the following error Example 63 Detecting multi-threaded programming issuesDetecting potential performance improvement opportunities Detecting potential performance improvement opportunities Fixing the warnings by source change Incompatibilities on PA-RISC based systems AC++ standard conformance and compatibility changes Symbols Index