보고서 읽기

Valgrind 보고서는 세 부분으로 구성됩니다.

• 모든 줄에 붙는 프로세스 ID 접두사
• 발생한 순서대로 표시되는 하나 이상의 오류 블록
• 종료 시 표시되는 최종 HEAP 및 LEAK SUMMARY

각 부분을 읽는 법을 익히면 긴 텍스트가 정확한 할 일 목록으로 바뀝니다.

모든 Valgrind 줄은 ==PID==로 시작합니다. 예를 들면 ==12345==과 같습니다.

이는 프로그램 출력의 일부가 아니라 프로세스 ID입니다. 프로그램의 printf와 Valgrind의 메시지가 같은 터미널에 표시될 때 둘을 구분할 수 있게 해 줍니다.

다음은 실제 잘못된 쓰기 오류 블록입니다.

==12345== Invalid write of size 4
==12345== at 0x4005A1: main (prog.c:6)
==12345== Address 0x520304c is 0 bytes after a block of size 20 alloc'd
==12345== at 0x4838B40: malloc
==12345== by 0x40058E: main (prog.c:5)

첫 번째 줄에는 오류 종류와 크기가 표시됩니다. 'Invalid write of size 4'와 같습니다.

크기 4는 일반적으로 int에 해당하는 4바이트 접근을 의미합니다. 이 한 줄만으로도 더 읽어 보기 전에 예상되는 버그의 범주를 알 수 있습니다.

at 줄은 오류가 발생한 가장 안쪽 프레임입니다. 각 by 줄은 한 단계 위의 호출자입니다.

위에서 아래로 읽되, 가장 깊은 프레임부터 가장 얕은 프레임 순서라고 생각하면 됩니다. 작성한 파일 이름이 처음 나타나는 프레임이 거의 항상 버그가 발생한 위치입니다.

Address ... 줄은 알려진 블록을 기준으로 접근 위치를 나타냅니다.

• 0 bytes after a block of size 20 alloc'd — 끝을 막 넘어선 오버플로
• 4 bytes inside a block of size 4 free'd — 해제 후 사용
• on thread 1's stack — 스택 접근

해당 블록이 할당되거나 해제된 위치까지 표시됩니다.

종료할 때 할당 내역이 표시됩니다.

==12345== HEAP SUMMARY:
==12345== in use at exit: 20 bytes in 1 blocks
==12345== total heap usage: 3 allocs, 2 frees, 1,044 bytes allocated

'in use at exit'가 0보다 크면 해제되지 않은 항목이 있다는 뜻입니다.

HEAP SUMMARY 아래에는 누수가 다음과 같이 분류됩니다.

definitely lost: 20 bytes in 1 blocks
indirectly lost: 0 bytes in 0 blocks
possibly lost: 0 bytes in 0 blocks
still reachable: 0 bytes in 0 blocks

각 손실된 블록에 추적 정보를 추가하려면 --leak-check=full을 사용합니다.

마지막 줄에는 모든 항목의 개수가 표시됩니다.

ERROR SUMMARY: 2 errors from 2 contexts

'context'는 고유한 오류 위치를 의미합니다. 문제가 있는 줄이 반복문에서 백만 번 실행되어도 context는 하나입니다. 목표는 0 errors from 0 contexts입니다.

보고서를 체계적으로 처리합니다.

• 먼저 손상을 일으키는 잘못된 접근 오류를 수정합니다.
• 그다음 초기화되지 않은 값 오류를 수정합니다.
• 이후 definitely 및 indirectly lost 누수를 수정합니다.
• 각 수정 후 다시 실행합니다. 하나의 근본 원인이 여러 보고서를 없애는 경우가 많습니다.

일부 오류는 C 실행 환경이나 그래픽 드라이버처럼 수정할 수 없는 라이브러리에서 발생합니다. 억제 파일을 생성하면 이러한 오류를 숨길 수 있으며, 직접 만든 버그는 그대로 확인할 수 있습니다.

--gen-suppressions=all은 바로 사용할 수 있는 억제 항목을 출력합니다. 이를 저장한 뒤 --suppressions=file로 다시 전달합니다.

보고서의 한 줄을 해석해 보세요.

이제 Valgrind 보고서를 처음부터 끝까지 읽을 수 있습니다.

• ==PID==는 Valgrind 줄의 접두사로, 프로그램 출력과 구분해 줍니다.
• 각 오류 블록에는 종류, 크기, 호출 스택 추적, 주소 설명이 표시됩니다.
• HEAP/LEAK 요약에는 할당과 손실된 메모리의 내역이 표시됩니다.
• ERROR SUMMARY에는 고유한 context의 개수가 표시됩니다. 0을 목표로 하세요.

접근 오류를 먼저 처리한 다음 누수를 처리하고, 진행하면서 계속 다시 실행하세요.