addr2line(1)

NAME

addr2line - 주소를 파일 이름과 행 번호로 변환하기

SYNOPSIS

addr2line [-a|--addresses]
          [-b bfdname|--target=bfdname]
          [-C|--demangle[=style]]
          [-e filename|--exe=filename]
          [-i|--inlines]
          [-p|--pretty-print]
          [-j|--section=name]
          [-H|--help] [-V|--version]
          [addr addr ...]

DESCRIPTION

addr2line은 주소를 파일 이름과 행 번호로 바꿔 준다. 실행 파일 내 주소나 재배치 가능 오브젝트 섹션 내 오프셋을 받아서 디버깅 정보를 이용해 연계된 파일 이름과 행 번호를 알아낸다.

사용할 실행 파일 내지 재배치 가능 오브젝트를 -e 옵션으로 지정한다. 기본은 a.out 파일이다. 사용할 재배치 가능 오브젝트 내 섹션은 -j 옵션으로 지정한다.

addr2line에는 두 가지 동작 방식이 있다.

첫 번째 방식에서는 명령행에서 16진수 주소를 지정하면 addr2line이 각 주소에 대한 파일 이름과 행 번호를 표시한다.

두 번째 방식에서는 addr2line이 표준 입력으로부터 16진수 주소를 읽어서 각 주소에 대한 파일 이름과 행 번호를 표준 출력으로 찍는다. 이 방식을 쓰면 파이프 내에 addr2line을 써서 동적으로 선택한 주소를 변환할 수 있다.

출력 형식은 FILENAME:LINENO이다. 기본적으로 각 입력 주소가 한 행씩 출력을 만들어 낸다.

각 FILENAME:LINENO 행 앞에 행을 추가할 수 있는 옵션이 두 가지 있다.

-a 옵션을 쓰면 입력 주소 행을 표시한다.

-f 옵션을 쓰면 FUNCTIONNAME 행을 표시한다. 그 주소를 담은 함수의 이름이다.

FILENAME:LINENO 행 뒤에 행을 추가할 수 있는 옵션이 한 가지 있다.

-i 옵션을 쓰면 해당 주소가 컴파일러 인라인 처리 때문에 거기 있는 것이면 뒤에 행들을 추가로 표시한다. 인라인 처리된 함수마다 한 행 또는 (-f 옵션을 쓴 경우) 두 행씩을 추가로 표시한다.

또는 -p 옵션을 쓰면 각 입력 주소마다 주소, 함수 이름, 파일 이름, 행 번호를 담은 한 줄짜리 긴 행이 출력된다. -i까지 썼다면 인라인 처리된 함수들도 같은 방식으로 찍히되, 별도 행에서 앞에 (inlined by)가 붙어서 표시된다.

파일 이름이나 함수 이름을 알아낼 수 없으면 addr2line에서는 그 자리에 물음표 두 개를 찍는다. 행 번호를 알아낼 수 없으면 addr2line에서는 0을 찍는다.

OPTIONS

여기 같이 나와 있는 긴 옵션과 짧은 옵션은 동등하다.

-a
--addresses

함수 이름과 파일 및 행 번호 정보 앞에 주소를 표시한다. 쉽게 식별할 수 있도록 주소 앞에 0x를 붙여서 찍는다.

-b bfdname
--target=bfdname

오브젝트 파일의 오브젝트 코드 형식이 bfdname이라고 지정한다.

-C
--demangle[=style]

저수준 심볼 이름을 사용자 수준 이름으로 해독(*디맹글(demangle)*)한다. 시스템에서 앞에 붙인 밑줄을 없애는 것에 더해서 C++ 함수 이름을 읽을 수 있게 만들어 준다. 컴파일러마다 맹글링(mangling) 방식이 다르다. 선택적인 해독 방식 인자를 사용해서 자기 컴파일러에 맞는 해독 방식을 선택할 수 있다.

-e filename
--exe=filename

주소들을 변환할 실행 파일의 이름을 지정한다. 기본 파일은 a.out이다.

-f
--functions

파일 및 행 번호 정보와 함께 함수 이름도 표시한다.

-s
--basenames

각 파일 이름의 기본 이름만 표시한다.

-i
--inlines

주소가 인라인 처리된 함수에 속하면 첫 번째 비인라인 함수까지의 모든 감싸는 스코프에 대한 소스 정보를 함께 찍는다. 예를 들어 "main"에서 "callee1"을 인라인 하고 거기서 다시 "callee2"를 인라인 하는데 주소가 "callee2"에 있으면 "callee1" 및 "main"에 대한 소스 정보도 함께 찍힌다.

-j
--section

절대 주소가 아니라 지정한 섹션 기준 오프셋을 읽는다.

-p
--pretty-print

출력을 더 인간 친화적으로 만든다. 즉 각 위치를 한 행에 찍는다. -i 옵션을 지정하면 모든 감싸는 스코프 행 앞에 (inlined by)가 붙는다.

@file

file에서 명령행 옵션들을 읽는다. 읽어 들인 옵션들이 원래 @file 옵션 자리에 들어간다. file이 존재하지 않거나 읽을 수 없는 경우에는 이 옵션을 제거하지 않고 문자 그대로 다루게 된다.

file 내의 옵션들은 공백으로 구분한다. 옵션에 공백 문자를 포함시키려면 옵션 전체를 작은따옴표나 큰따옴표로 감싸면 된다. 문자 앞에 백슬래시를 붙이면 (백슬래시를 포함한) 어떤 문자든 집어넣을 수 있다. file 자체에 다시 @file 옵션이 있을 수 있다. 그러면 재귀적으로 처리가 이뤄진다.

SEE ALSO

info binutils 항목.

COPYRIGHT

Copyright (c) 1991-2018 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

---

2018-09-12

binutils-2.30-system