[rustc.git] / src / llvm / test / tools / llvm-cov / Inputs / README

These inputs were pre-generated to allow for easier testing of llvm-cov.

The files used to test the gcov compatible code coverage tool were generated
using the following method:

  test.gcno and test.gcda were create by running clang:
    clang++ -g -ftest-coverage -fprofile-arcs test.cpp

  test.cpp.gcov was created by running gcov 4.2.1:
    gcov test.cpp

The 'covmapping' files that are used to test llvm-cov contain raw sections
with the coverage mapping data generated by the compiler and linker. They are
created by running clang and llvm-cov:
  clang++ -fprofile-instr-generate -fcoverage-mapping -o test test.cpp
  llvm-cov convert-for-testing -o test.covmapping test

The 'profdata' files were generated by running an instrumented version of the
program and merging the raw profile data using llvm-profdata.
  ./test
  llvm-profdata merge -o test.profdata default.profraw
Commit	Line	Data
1a4d82fc JJ	1	These inputs were pre-generated to allow for easier testing of llvm-cov.
	2
	3	The files used to test the gcov compatible code coverage tool were generated
	4	using the following method:
	5
	6	test.gcno and test.gcda were create by running clang:
	7	clang++ -g -ftest-coverage -fprofile-arcs test.cpp
	8
	9	test.cpp.gcov was created by running gcov 4.2.1:
	10	gcov test.cpp
	11
	12	The 'covmapping' files that are used to test llvm-cov contain raw sections
	13	with the coverage mapping data generated by the compiler and linker. They are
	14	created by running clang and llvm-cov:
	15	clang++ -fprofile-instr-generate -fcoverage-mapping -o test test.cpp
	16	llvm-cov convert-for-testing -o test.covmapping test
	17
	18	The 'profdata' files were generated by running an instrumented version of the
	19	program and merging the raw profile data using llvm-profdata.
	20	./test
	21	llvm-profdata merge -o test.profdata default.profraw