Installing GCC: Testing

GCC 설치하기: 테스팅

Please note that this is only applicable to current development versions of GCC and GCC 3.0 or later. GCC 2.95.x does not come with a testsuite.

이것은 현재의 개발 버전의 GCC나 GCC 3.0 또는 그 이후의 버전의 GCC에서 사용가능하다는 것을 주의하라.GCC 2.95.x은 testsuite와 함께 올수 없다.

Before you install GCC, you might wish to run the testsuite. This step is optional and may require you to download additional software.

GCC를 설치하기 전에, 당신은 테스트슈트들을 실행해 보기를 원할 것이다. 이 과정은 옵션이며 추가적으로 소프트웨어를 다운받아야할 필요가 있다.

First, you must have downloaded the testsuites. The full distribution contains testsuites; only if you downloaded the "core" compiler plus any front ends, you do not have the testsuites.

우선 당신은 downloaded the testsuites에서 다운받아야한다. 전체 패키지는 테스트슈트를 포함하고 있다; 만약 당신이 프론트 앤드에 추가로 핵심 컴파일러만을 다운받았다면, 테스트슈트를 가지고 있지 않을 것이다.

Second, you must have a new version of dejagnu on your system; dejagnu 1.3 will not work. We have made dejagnu snapshots available at ftp://gcc.gnu.org/pub/gcc/infrastructure until a new version of dejagnu has been released.

다음으로, 당신의 시스템의 새로운 버전의 dejagnu을 가지고 있어야한다; dejagnu 1.3은 동작하지 않을것이다. 새로운 버전의 dejagnu가 나올때까지 ftp://gcc.gnu.org/pub/gcc/infrastructure 에서 dejagnu 스냅샷을 사용가능 하도록 만들어 놓았다.

Finally, you can run the testsuite (which may take a long time):

cd objdir; make -k check

마지막으로, 당신은 테스트슈트를 (비록 시간이 오래걸리겠지만) 실행시킬 수 있다:

cd objdir; make -k check

The testing process will try to test as many components in the GCC distribution as possible, including the C, C++ and Fortran compilers as well as the C++ runtime libraries.

테스트 과정은 C++ 런타임 라이브러리 뿐만아니라 C, C++, Fortan 컴파일러를 포함한 GCC 전체 패키지에서 많은 컴포넌트들을 테스트해보려고 할 것이다.

How can I run the test suite on selected tests?

선택된 테스트에서 어떻게 테스트 슈트를 실행시킬 것이가?

As a first possibility to cut down the number of tests that are run it is possible to use `make check-gcc` or `make check-g++` in the gcc subdirectory of the object directory. To further cut down the tests the following is possible:

make check-gcc RUNTESTFLAGS="execute.exp <other options>"

실행하는 테스트의 수를 줄일 수 있는 가능성으로써 오브젝트 디렉토리의 gcc 서브디렉토리에서 `make check-gcc` 나 `make check-g++` 명령을 수행시킬 수 있다. 다음과 같이 함으로써 테스트의 수를 더 줄일 수 있다:

make check-gcc RUNTESTFLAGS="execute.exp <other options>"

This will run all gcc execute tests in the testsuite.

make check-g++ RUNTESTFLAGS="old-deja.exp=9805* <other options>"

이 명령은 테스트슈트에서 실행가능한 gcc 테스트를 모두 실행하게 할 것이다.

make check-g++ RUNTESTFLAGS="old-deja.exp=9805* <other options>"

This will run the g++ "old-deja" tests in the testsuite where the filename matches 9805*.

이것은 화일명이 9805*로 일치하는 테스트슈트에서 g++ "old-deja" 테스트를 수행한다.

The *.exp files are located in the testsuite directories of the GCC source, the most important ones being compile.exp, execute.exp, dg.exp and old-deja.exp. To get a list of the possible *.exp files, pipe the output of `make check` into a file and look at the "Running ... .exp" lines.

*.exp 화일들은 GCC 소스의 테스트슈트 디렉토리에 위치한다. 대부분 중요한 것은 compile.exp, execute.exp, dg.exp and old-deja.exp이다. 가능한한 *.exp 화일들의 목록을 얻기 위해서, `make check`의 결과를 파이프를 이용해 화일에 저장하고 "Running ... .exp" 라인들을 찾아보면 된다.

How to interpret test results

테스트 결과를 해석하기

After the testsuite has run you'll find various *.sum and *.log files in the testsuite subdirectories. The *.log files contain a detailed log of the compiler invocations and the corresponding results, the *.sum files summarize the results. These summaries list all the tests that have been run with a corresponding status code:

테스트슈트를 실행시킨 뒤에 테스트슈트의 서브디렉토리에서 여러개의 *.sum 과 *.log 화일들을 찾아볼 수 있을 것이다. *.log 화일들은 컴파일러의 호출(invocations)들에 대한 자세한 기록들을 포함한다. *.sum 화일들은 결과를 요약해 놓은 것이다. 이 요약들은 다음과 같은 상태 코드와 함께 수행되는 모든 테스트들을 나열해 놓은 것이다:

PASS: the test passed as expected
PASS: 예상되는 대로 지나간 테스트
FAIL: the test unexpectedly failed
FAIL: 예상치 못하게 실패한 테스트
XFAIL: the test failed as expected
XFAIL: 예상한 대로 실패한 테스트
UNSUPPORTED: the test is not supported on this platform
UNSUPPORTED: 이 플렛폼에서 지원하지 않는 테스트
ERROR: the testsuite detected an error
ERROR: 에러를 발견한 테스트슈트
WARNING: the testsuite detected a possible problem
WARNING: 가능한 문제들을 발견한 테스트슈트

It is normal for some tests to report unexpected failures. At the current time our testing harness does not allow fine grained control over whether or not a test is expected to fail. We expect to fix this problem in future releases.

몇몇의 테스트에서 예상치 못한 실패들을 보고하는 것은 자주 있는 일이다. 현재 우리 테스트의 어려움은 테스트가 실패할지 그렇지 않을지에 대한 통제를 허용하지 않는 것이다.(??) 우리는 미래의 릴리즈에서 이런 문제가 해결되기를 바란다.

Submitting test results

테스트 결과들을 제출하기

If you want to report the results to the GCC project, use the contrib/test_summary shell script. Start it in the objdir with

srcdir/contrib/test_summary -p your_commentary.txt -m gcc-testresults@gcc.gnu.org |sh

만약 당신이 GCC 프로젝트에 결과들을 보고하기 원한다면, contrib/test_summary 쉘 스크립트를 사용하면 된다. objdir에서 실행하면된다:

srcdir/contrib/test_summary -p your_commentary.txt -m gcc-testresults@gcc.gnu.org |sh

This script uses the Mail program to send the results, so make sure it is in your PATH. The file your_commentary.txt is prepended to the testsuite summary and should contain any special remarks you have on your results or your build environment. Please do not edit the testsuite result block or the subject line, as these messages are automatically parsed and presented at the GCC testresults web page. Here you can also gather information on how specific tests behave on different platforms and compare them with your results. A few failing testcases are possible even on released versions and you should look here first if you think your results are unreasonable.

이 스크립트가 결과를 보내기 위해 Mail 프로그램을 사용한다. 그래서 당신의 경로(path)에 그것이 존재하도록 만들어야 한다. your_commentary.txt라는 당신의 화일이 테스트슈트의 요약을 담고있고 당신의 컴파일(build) 환경이나 당신의 테스트결과에서 주목할 만한 내용들을 포함해야만 한다. 제발 subject 라인이나 테스트슈트 결과 블럭을 수정하지 말기를 바란다. 이러한 메세지들은 자동으로 파싱되어지며, GCC testresults 웹 페이지에 나타나게 된다. 여기에서 당신은 다른 플랫폼에서 어떻게 특정하게 테스트 되었는지에 대한 정보나 당신의 결과를 다른 것과 비교할 수 있을 것이다. 약간의 테스트 실패가 릴리즈 버전에서 있을 수 있다. 만약 당신의 결과가 이상하다고 생각이되면 먼저 여기를 살펴보기를 바란다.