Compilation Problem Isolator
Product Release Notes

Overview

The Compilation Problem Isolator (CPI) helps pinpoint compile-time problems in C and C++ programs which will not compile because of a syntax error, compiler bug, etc. CPI reduces the size of test cases by removing all source code lines within a file that do not contribute to the error.

Using the Compilation Problem Isolator

Invoke CPI from the command line with the following syntax:

icpi myfile

where myfile is your original source file. CPI will create an output file with the name of the original file and an extension of .tsf.orig_ext, where orig_ext is the extension of the original file (usually .c or .cpp). For example, the command

 

icpi prog.cpp


will create an output file called prog.tsf.cpp

You can get the command-line options by typing



icpi -?



The output of the icpi -? command is listed below:

======================Compilation Problem Isolator Help======================

OPTION LIST
The option keywords are not case sensitive.

	-COMPILER=<compiler_path>

	-LOGFILE=<logfile_path> (logfile contains completion log)

	[-ERRORMATCH=<matching_criteria_file_path>] (default is ErrorMatch.txt)

	[-ERRORMATCH=<matching_error_text>] (icpi will 
	look for this error text only. If "^.*" is at the beginning of the 
	matching_error_text, icpi will ignore the text before the error_text.

	[-SAVESTEP=] (saves the intermedium files into filename.tsf.cpp.x) For example:

	
 
	-savestep=1: means save every intermedium files
	
-savestep=2: means save every other intermedium files

	This option may take a lot of disk space
	
	[-VERBOSE] (prints out all the details)

	[-LINKERR] (will look for link time errors)



	[-BUILD or -B] (prints out the build date information)

	[-VERSION or -V] (prints out the version information)

	[-HELP or -?] (displays this message)


Examples
	     icpi -compiler="icc -O3 -ipo" -errormatch="^.*couldn't match parameter" -verbose bob.cpp


FILES PRODUCED
	source_file.tsf.suffix: the isolated code

	source_file.CECR_errfile: the results of the last run 
of the compiler logfile_path

The ErrorMatch.txt file 

If a text file called ErrorMatch.txt file is found in the current working
directory, CPI will look for strings specified in this file. You can also specify the name of the file
using the -ERRORMATCH command-line option. There is an example of ErrorMatch.txt in the doc directory 
of the Intel C/C++ Compiler. Below is another example of the contents of ErrorMatch.txt.


": error" 

"internal error :" 

"internal error:" 

"Illegal READ" 

"Illegal WRITE" 

"compiler error:" 

"Compiler error" 

": catastrophic error:" 

"Catastrophic error:" 

"FATAL ERROR   : Compiler Internal Error"     




CPI by default will only look for compile-time issues. To look for errors that arise during
linking, use the /linkerr option.


 


Intel and Itanium are trademarks or registered trademarks of Intel Corporation

or its subsidiaries in the United States and other countries.

Copyright © 2001-2003, Intel Corporation. All Rights Reserved.

Compilation Problem IsolatorProduct Release Notes

Overview

Using the Compilation Problem Isolator

OPTION LIST

Examples

FILES PRODUCED

Compilation Problem Isolator
Product Release Notes