Borland
Corporate Info Products Downloads Programs Support Community
Shop Now!

코드가드(CodeGuard)에 대하여

코드가드는 C++Builder5에서 개발된 애플리케이션에 대해 실행시 디버깅 솔루션을 제공해 준다. 이 툴은 컴파일러에 의해 잡지 못하는 에러들에 대해 리포트해 준다. 왜냐하면 이러한 실행시 에러들은 문법적 규칙을 거스르지 않기 때문이다. 코드가드는 볼랜드 실행시 라이브러리와 윈도우즈 API의 많은 부분들을 검사해준다. 이뿐만 아니라 다중 스레드 애플리케이션에 대해서도 지원한다.

코드가드는 다음의 두 가지 규칙을 제공해 준다.

메모리와 리소스 사용. 코드가드는 잘못된 메모리 사용, 잘못된 메모리 할당과 해제, 잘못된 파일 스트림이나 핸들, 리소스 누수현상 등을 검사한다. 역참조에 대한 포인터를 검사하고 포인터 연산을 체크한다. 코드가드는 프로그램이 메모리나 리소스가 이미 해제된 곳을 참조할 경우 발생하는 에러에 대해서도 리포트해준다.
함수 호출 허용성 유무. 코드가드는 함수 인자를 검해해 함수의 리턴 값이 잘못되었는 지 리포트해준다. 함수 호출에서 사용된 윈도우즈 리소스 핸들을 검사한다.

코드가드 초기화 및 설정

코드가드는 정적 라이브러리(CG32.LIB)나 동적 라이브러리(CG32.DLL)를 사용한다. 이 라이브러리들은 함수의 인자와 리턴 값을 검사해주는 래퍼 함수들을 포함하고 있다. 코드가드는 코드가드 컴파일러 옵션이 활성화되어 있는 경우 컴파일해서 생성되는 실행파일에서만 에러들을 검출할 수 있다. 추가 실행 옵션을 설정하기 위해서, 코드가드 설정 유틸리티를 사용한다. 설정 유틸리티에 대한 도큐먼트나 도움말을 먼저 읽는 것이 코드 가드의 에러 로그와 코드가드를 보다 효율적으로 사용하는 데 도움을 받을 수 있을 것이다.

IDE에서 코드가드 사용하기.


1.IDE에서 프로젝트를 연다.
2.실행시 디버깅 옵션의 단계를 지정하기 위해 Project|Options|CodeGuard를 선택한다.

CodeGuard 페이지에 나타나 있는 옵션들은 코드가드가 제공해주기 원하는 실행시 디버깅 지원 단계와 메모리 접근 허용성 유무를 지적해 준다. 코드가드는 애플리케이션에서 다음의 옵션들로 지정해줄 수 있다.

1)전역과 스택 접근

커맨드 라인에서의 인자: -vGd

코드가드에 의해 빠른 검색을 위해 데이터와 스택 레이아웃 디스크립터를 생성해준다. 이 디스트립터들은 코드가드에게 오버런, 잘못된 지역, 전역, 스택 포인터을 리포트해준다.

2) 멤버 함수상의 'this' 포인터

커맨드 라인에서의 인자: -vGt

멤버 함수, 생성자, 파괴자에 대한 특별한 에필로그를 생성한다. 코드가드는 C++ 코드에 있는 모든 메소드에 이 포인터를 검사한다. 이 옵션은 this를 접근하지 못하는 메소드가 있다면 잘못된 오브젝트임을 알려주는 유용한 옵션이다.

3)포인터 접근

커맨드 라인에서의 인자: -vGc

코드에서 모든 접근에 대해 검사하기위해 호출되는 것들을 생성한다. 이 옵션은 거의 모든 포인터 에러를 알려준다. 프로그램 실행은 전형적으로 4배에서 10배 느려진다.

이 옵션들중 어느 하나를 선택하더라도 실행시 속도에 영향을 미칠 수 있다.

3. 코드가드가 실행시 에러를 검출할수 있도록 하기 위해서, Tools|CodeGuard Configuration을 선택한다. Preferences 페이지에서 Enable 체크 박스가 선택되어 있는 지 먼저 확인한다. 이 유틸리티는 (CGCONFIG.EXE)로 따로 존재하지만, C++Builder5 IDE 환경내에 내장되어 있어 쉽게 사용할 수 있다.

1)Preference 페이지

다음의 옵션들의 이 페이지에서 설정할 수 있다.

  • Enable (CodeGuard is enabled): CodeGuard 를 활성화시키거나 비활성화시킨다. 코드가드는 이 체크박스가 체크되어야만 에러를 검사할 수 있다. 그러나 애플리케이션은 코드가드없이 다시 컴파일하지 않으면 여전히 느릴 것이다.
  • Stack fill frequency: 이 옵션은 유일한 바이트 패턴을 가진 실행시 스택의 초기화되지 않은 것들을 얼마나 자주 채울 것인가 알려주는 옵션이다.
값 빈도수
-1 결코 없다
0 코드가드에 의해 덮여진 윈도우즈 aPI 함수나 실행시 라이브러리를 매번 호출한다.
n 코드가드에 의해 n번 호출된다. 최대수치는 31까지.

Report. 이 옵션들은 코드가드에게 에로 로그에 포함된 정보가 어떤 것인지 알려준다.

옵션 설명
Statistics 로그 파일의 끝에 함수와 리소스 사용에 대해 나타내 준다.
Resource Leaks 애플리케이션이 종료된 후에 검출되는 리소스 누수에 대해 표시해 준다.
Send to OutputDebugString 보조 디스플레이같은 기타 출력 장치를 구동중이라면 코드가드에서 메시지를 복사하기 위해 OutputDebugString을 사용한다.
예를 들면, 독립 실행형 터보 디버그가 실행되고 있다면 코드가드 메시지들은 CPU 윈도우 창에 로그가 나타날 것이다.
Append to log file 끝부분에 새로운 리포트를 작성하기위해 기존의 로그 파일을 그대로 사용한다.
Repeated Errors 똑같은 함수에 대해 반복적으로 일어나는 에러를 표시한다.
Limit number of error messages 최대 에러수를 지정한다. 최대 수는 65535

에러 메시지 박스

IDE밖으로부터 코드가드 사용가능한 애플리케이션을 구동시킬 때 메시지 박스로서 에러가 발생되었음을 일러준다. 캡션이나 내부에 들어갈 메시지는 사용자 정의로 설정가능하다.

디버깅 정보. The following options to tell CodeGuard how to use debugging information (if available).

Read debug info 는 코드가드에게 실행시 에러가 발생된 로그 파일에 나타날 때 소스에 그 부분을 알려주도록 한다.
Source path.소스 코드가 실행 파일과 다른 경로명일 경우 명시해 준다.

2) Resource Options 페이지

이 리소스 옵션 페이지에서는 코드가드에 의해 추적가능한 리소스 타입들을 명시할 수 있다. 각각의 리소스 타입에 대해 추적 옵션을 따로 관리해 준다. 리소스 옵션 페이지를 사용하기 위해서는 왼쪽 리스트 박스의 객체 타입을 선택하고 오른쪽은 선택옵션을 선택하면 된다.

Enable tracking: 왼쪽의 선택된 아이템에 대해 추적을 가능하게 선택해주는 옵션이다. 이 옵션이 선택되지 않으면 메모리는 절약되고 실행 속도는 더 빠르지만 코드가드는 이 리소스 타입에 대해서는 전혀 검사하지 않게 된다.

Track resource leaks: 리소스의 할당과 해제에 대해 검사한다. 예를 들어, 누수현상은 애플리케이션이 종료되기전에 파일 핸들을 해제하는 것이 실패했을 때 발생된다.

Report invalid handle/resource parameters: 함수 인자에서 잘못된 리소스의 사용을 보고해 준다.

Delay free: 리소스를 해제한 후에도 리소스를 추적해 준다. 이 옵션이 선택되면, 코드가드는 애플리케이션이 해제한 모든 리소스에 대해 그 리소스를 다시 접근하려고 할 때 이 사실을 알려준다.

Delay queue length (objects): 연기된 해제에 대해 큐로 되어 있는 오브젝트의 수를 명시해 준다. 최대 수는 65535 개이다.

Maximum memory block size (bytes): 연기된 큐에 유지할 수 있는 메모리 블락의 크기 최대 크기는 65535 바이트이다.

3)Function Options 페이지

이 페이지에서는 실행시 라이브러리와 윈도우즈 API 함수들에 스이는 함수들을 모두 나열해 주고 코드가드에서 이 함수들에 대해 실행시 추적할 수 있게끔 옵션들을 제공하고 있다. 원하는 옵션을 선택하기만 하면 된다.


주의: 몇몇 옵션은 몇가지 함수에 대해 바뀔 수 없다. 예를 들면, malloc에 대해 메모리 접근 에러를 선택하지 않을 수 없다..

Memory access errors: 잘못된 메모리 참조나 포인터를 사용하는 함수를 알려준다.
Log each call: 함수에 대해 각각의 호출을 알려준다.
Warnings: 예를 들면, 버퍼의 최대 크기를 넘어선 메모리를 접근하려하는 경우,
Function result errors: 잘못된 값을 리턴하는 경우
Invalid handle/resource parameters: 함수의 인자가 핸들이거나 리소스인 경우, 제대로 할당되었는 지 아니면 제대로 동작하는 지 검사해 준다.

4)Ignored modules 페이지

이 페이지에서는 리포트가 에러를 표시할 때 그냥 지나가기 원하는 모듈을 지정해 줄 수 있다.

4. 코드 가드를 완벽하게 사용하기 위해, 컴파일하기전 디버깅 정보를 포함하여야만 한다. 비록 필요없다손 치더라도, 디버깅 정보는 코드가드가 에러를 표시해주는 소스 라인을 직접 찾아갈 수 있게 해 준다. 또한 실행 시 라이브러리 코드와 코드를 명확하게 구분해주는 로그 정보를 표시해 준다.

5. Project|Build All Projects를 선택한다. 그리고 Run|Run을 선택해 프로그램을 실행시킨다.

코드가드로 사용가능한 애플리케이션을 실행할 때, 코드가드는 발견하는 에러들을 표시해주는 로그 파일을 생성한다. 로그 파일은 project.CGL (project 는 실행 프로젝트의 실제 이름)이며 실행 파일의 똑같은 디렉토리에 위치해 있다. IDE로부터 이 애플리케이션을 실행시키고 있다면, 로그를 확인하기 위해서는 View|Debug Windows|CodeGuard Log를 선택해 본다. 애플리케이션이 디버깅 정보와 함께 컴파일되었다면 문제를 일으킨 소스 코드 라인에 직접 이동하거나 혹은 시스템쪽이나 런타임쪽 관련이라면 어셈블리 코드와 함께 나타날 것이다.

비 정상적 프로그램 종료

때로 코드가드 사용가능한 애플리케이션은 코드가드 없이 사용할 때 발생되지 않던 것이 비정상적으로 종료될 때가 있다. 이것은 코드가드가 메모리 할당부분을 가로채어 사용되지 않는 부분에 대신 쓰기 때문에 발생되는 문제이다. 이상적인 환경에서 성공적으로 실행되는 프로그램에서 문제들을 노출시키기 위해 이 방법을 사용한다.

코드가드가 정적 데이터의 레이아웃을 표시하기 때문에 애플리케이션에서 쓰레기 값들이 발생할 수도 있다. 때문에 컴포알러는 함수 호출에서 스택 레이아숫을 변경한다. 이러한 현상은 버그를 보여주고 비정상적인 프로그램의 종료의 결과를 낳게 된다.


Copyright(C)INPRISE Korea.