GDB 매뉴얼

사용법

help	도움말, 명령어 분류 목록 출력
help [class]	해당 class에 속한 명령어 목록 표시
help [command]	해당 command에 대한 도움말 표시

*** class와 command의 축약형도 지원됨

명령어 분류 목록

running	프로그램 수행	support	지원 도구
stack	스택 검사	user-defined	사용자 정의 명령
data	데이타 검사	aliases	다른 명령어의 별칭
files	검사할 파일	obscure	기타
status	상태 조회	internals	유지보수 명령
breakpoints	어떤 포인트에서 프로그램을 중단하게 만듦

프로그램의 수행 (running)

show args

디버깅할 프로그램에 전달되는 argument를 보여준다.
이 명령어 다음에 몇 개의 argument가 온다.

info handle

프로그램이 각종 신호를 입력으로 받았을 때, 디버거의 동작법을 보여준다.

kill

디버깅 중인 프로그램의 실행을 취소한다.

target

타겟 기계나 프로세스에 연결한다.
첫번째 argument는 타겟 기계의 타입이나 프로토콜이다. 나머지 argument는 타겟 프로토콜에 의해서 해석 되어진다. 특정 프로토콜에 작동하는 argument에 관해 추가 정보가 필요하면, [help target 프로토콜명]을 친다.

[target 서브 명령어 목록]

target exec	타겟으로서 실행 파일을 사용한다.
target extended-remote	시리얼 라인을 경유해 떨어져 있는 컴퓨터를 타겟으로 사용
target remote	시리얼 라인을 경유해 떨어져 있는 컴퓨터를 타겟으로 사용
target core	타겟으로서 코어 파일을 사용한다.
target child	([run] 명령어에 의해 시작된) 유닉스의 자식 프로세스를 타겟으로 사용한다.

handle

신호를 어떻게 다룰지 상술함
argument는 신호와 그 신호에 적용할 동작이다. 심벌 신호(즉 SIGSEGV)가 권장 사항이지만, 1-15의 숫자 신호도 GDB의 이전 버젼과의 호환성을 위해 허용된다. 숫자 범위는 LOW-HIGH(즉 1-5)의 형태로 지정되어질 수 있다.
특별한 argument "all"은 대체로 SIGTRAP과 SIGINT처럼 디버거에 의해 사용되어지는 것을 제외한 모든 신호를 의미한다고 인식되어진다.
동작에는 "stop", "nostop", "print", "noprint", "pass", "nopass", "ignore", "noignore"가 있다.

"stop"은 디버거로 다시 들어감을 의미한다("print"를 포함한다).
"print"는 메세지를 프린트함을 의미한다.
"pass"는 프로그램이 이 신호를 인식할 수 있도록 함을 의미한다; 그렇지않으면 프로그램은 알 수 없다.
"ignore"는 "nopass"와 같은 말이며, "noignore"도 "pass"와 같은 말이다.
"pass"와 "stop"은 결합해서 사용할 수 있다.

run

디버깅할 프로그램의 수행을 시작한다.
전달할 argument를 지정할 수 있다. argument는 "*"나 "[..]"를 포함할 수도 있다; 쉘의 사용까지도 확장 될 수 있다. ">", "<", ">>" 같은 입출력 방향 재지정 기호도 또한 허용된다.
argument 없이, 마지막으로 지정된 argument를 사용할 수 있다("run" 또는 "set args"에 의해) 이전의 argument를 취소하고 argument 없이 실행하기 위해서, "set args" 를 argument 없이 사용하라.

continue

신호나 breakpoint 후에, 디버깅할 프로그램의 수행을 계속한다.
만약 breakpoint에서부터 진행된다면, 숫자 N이 argument로 사용되어질 수 있으며, 이는 breakpoint의 무시할 갯수가 N-1로 정해진다는 것을 의미한다. (그래서 breakpoint 가 N번째에 이를 때까지 분기하지 않는다)

jump

지정된 라인이나 주소에서 디버깅할 프로그램의 수행을 계속한다.
LINENUM이나 *ADDR을 argument로 준다.

until

프로그램이 현재 라인보다 큰 라인이나 또는 지정된 라인이나 어드레스 또는 함수에 도달할 때까지 수행한다(break 명령과 동일한 argument).
실행은 현재의 스택 프레임으로 부터 빠져나오면서 중지될 것이다.

step

다른 소스 라인에 도달할 때까지 프로그램의 수행을 건너뛴다.
argument N은 이를 N번 수행하라는 의미다(또는 다른 이유로 인해 프로그램이 중지될 때까지).

서브루틴을 호출하여 진행하면서 프로그램의 수행을 건너뛴다.
서브루틴 호출이 발생하지 않는한 "step" 명령어와 같다.
이 명령어가 수행될 때, 호출은 하나의 명령으로 다루어진다.
argument N은 이를 N번 수행하라는 의미다(또는 다른 이유로 인해 프로그램이 중지될 때까지).

finish

선택된 스택 프레임이 리턴될 때까지 수행한다. 리턴되면서, 리턴되는 값은 출력되어지고 값 히스토리에 입력된다.

nexti

명령 하나를 건너뛰지만, 서브루틴 호출은 진행한다. argument N은 이를 N번 수행하라는 의미다(또는 다른 이유로 인해 프로그램이 중지될 때까지).

stepi

정확하게 명령 하나를 건너 뛴다. argument N은 이를 N번 수행하라는 의미다(또는 다른 이유로 인해 프로그램이 중지될 때까지).

signal

argument에 의해 지정된 신호를 주면서 프로그램의 수행을 계속한다.
argument "0"은 신호를 주지 않으면서 프로그램을 계속 수행하라는 의미다.

detach

이전에 첨부된 프로세스나 파일을 제거하라. 만약 프로세스이면, 더 이상 추적할 필요 없이 수행을 계속한다. 만약 파일을 디버깅 중이라면, 그 파일은 닫히고 gdb는 더 이상 억세스 하지 않는다.

attach

GDB 바깥의 프로세스나 파일을 첨부한다. 이 명령어는 'target' 명령어처럼 다른 타겟에 부가되어진다('info files'는 당신의 타겟 스택을 보여줄 것이다).
이 명령어는 프로세스 id나 디바이스 파일을 argument로 가질 수 있다.
프로세스 id에 대해, 당신은 프로세스로 신호를 보낼 수 있는 권한을 가지고 있어야만 하며, 디버거와 똑같은 영향을 가지는 uid를 가지고 있어야 한다.
"attach" 명령을 사용할 때, 프로세스에서 프로그램 동작을 상술하며 심벌 테이블을 로딩하는 명령 "file"을 사용해야 한다.

unset environment

프로그램에 대한 환경변수 VAR을 취소한다.
이 명령은 이후에 "run" 명령을 수행했을 때, 프로그램에 영향을 미친다.

tty

디버깅할 프로그램의 앞으로의 수행을 위해 터미널을 셋팅한다.

set environment

프로그램에 전달할 환경변수 값을 셋팅한다.
argument는 VAR VALUE인데, 여기에서 VAR은 변수명이고 VALUE는 값이다.
환경변수의 VALUE는 해석되지 않은 스트링이다. 이 명령은 이후에 "run" 명령을 수행했을 때, 프로그램에 영향을 미친다.

set args

프로그램이 시작될 때, 디버깅할 프로그램에 전달할 argument를 셋팅한다.
이 명령어 다음에 프로그램에 전달될 몇 개의 argument가 따라온다.

thread

thread간 스위칭을 위해 이 명령을 사용한다. 새로운 thread ID를 반드시 알고 있어야 한다.

thread	서브명령어의 목록
thread apply	thread 목록에 명령을 적용한다.
thread apply all	모든 thread에 명령어를 적용한다.

스택을 검사 (stack)

스택은 스택 프레임으로 구성되어진다. gdb는 스택 프레임에 번호를 지정한다.
gdb는 가장 안쪽에 있는(현재 실행중인) 프레임에 대해 0번 부터 번호를 부여한다. 항상 gdb는 한 프레임을 선택된 프레임으로 간주한다. 변수 룩업은 선택된 프레임에 대하여 이루어진다. 디버깅 중인 프로그램이 정지될 때, gdb는 가장 안쪽에 있는 프레임을 선택한다. 아래 명령어들은 숫자나 어드레스에 의해서 선택된 다른 프레임에 대해서도 사용되어질 수도 있다.

명령어 목록

bt	모든 스택 프레임이나 가장 안쪽에 있는 COUNT 프레임의 backtrace를 출력한다. argument가 음수일 때, 가장 바깥쪽의 -COUNT 프레임을 출력한다.
backtrace	bt 명령어와 동일하다.
select-frame	아무런 출력 없이 스택 프레임을 선택한다. argument는 선택할 프레임을 상술한다. 그것은 스택 프레임 번호이거나 프레임 어드레스일 수도 있다.
frame	스택 프레임을 선택하고 출력한다. argument 없이 사용하면, 선택된 스택 프레임을 출력한다("info frame" 참조) argument 는 선택할 프레임을 상술한다. 그것은 스택 프레임 번호이거나 프레임 어드레스일 수도 있다. argument와 같이 사용할 경우에, 입력이 명령 파일이나 사용자 정의 명령에 근거한다면 출력되는 것은 아무 것도 없다.
down	이 명령에 의해 호출된 스택 프레임을 선택하고 출력한다. argument는 얼마나 많은 프레임을 down 해야할지를 말해준다.
up	이 명령에 의해 호출된 스택 프레임을 선택하고 출력한다. argument는 얼마나 많은 프레임을 up 해야할지를 말해준다.
return	선택된 스택 프레임으로 하여금 호출자에게 리턴값을 돌려주도록 한다. 디버거에 제어가 남아 있지만 당신이 계속할 때, 실행은 현재 선택된 것보다 위에 있는 프레임에서 계속될 것이다. 만약 argument가 주어진다면, 리턴값에 대한 표현이다.

데이타를 검사 (data)

명령어 목록

whatis	expression EXP의 데이터 타입을 출력한다.
ptype	타입 TYPE의 정의를 출력한다. argument는 typedef, "struct STRUCT-TAG", "class CLASS-NAME", "union UNION-TAG", "enum ENUM-TAG"에 의해 정의된 타입명이다. 선택된 스택 프레임의 어휘적인 문맥은 그 명칭을 찾는데 사용되어진다.
inspect	당신이 epoch 환경에서 실행중이라면 그 값이 자신의 창에 출력된다는 것을 제외하면 "print" 명령과 동일하다.
print	expression EXP의 값을 출력한다.
call	프로그램 내에 있는 함수를 호출한다. argument는 현재 작업중인 언어의 표기에서 함수명과 argument이다. void가 아니라면, 결과는 value history에 기록 되어지고 출력될 것이다.
set	변수 VAR 대해 표현 EXP와 지정된 결과를 계산한다.
output	"print"와 유사하지만, value history에 입력하지 않고 개행문자도 출력하지 않는다.
undisplay	프로그램이 정지할 때마다 출력되는 몇몇 표현을 취소한다.
disassemble	메모리의 특정 부분을 해체한다. x 메모리를 검사한다. : x/FMT ADDRESS
delete display	display 기능을 삭제한다.
disable display	display 기능을 disable시킨다.
enable display	display 기능을 enable시킨다.

특정 지점에서 프로그램을 정지시키기

명령어 목록

awatch	한 표현에 대해 watchpoint를 셋팅한다.
rwatch	한 표현에 대해 read watchpoint를 셋팅한다.
watch	한 표현에 대해 watchpoint를 셋팅한다.
catch	발생되는 예외를 잡아내기 위해 breakpoint를 셋팅한다.
break	특정 라인이나 함수에 breakpoint를 셋팅한다.
clear	특정 라인이나 함수에 있던 breakpoint를 삭제한다.
delete	몇몇 breakpoint나 자동으로 출력되는 표현을 삭제한다.
disable	몇몇 breakpoint를 disable시킨다.
enable	몇몇 breakpoint를 enable시킨다.
thbreak	breakpoint를 지원하는 일시적인 하드웨어를 셋팅한다.
hbreak	breakpoint를 지원하는 하드웨어를 셋팅한다.
tbreak	일시적인 breakpoint를 셋팅한다.
condition	breakpoint 번호 N을 오직 COND가 참일 경우에만 분기하도록 지정한다.
commands	breakpoint를 만났을 때, 실행될 명령어를 셋팅한다.
ignore	breakpoint 번호 N을 무시하는 번호로 셋팅한다.

파일의 상술 및 검사

명령어 목록

show gnutarget	현재의 BFD 타겟을 셋팅한다.
cd	디버깅 중인 프로그램과 디버거를 위한 작업 디렉토리를 DIR로 셋팅한다.
pwd	작업 디렉토리를 출력한다.
core-file	메모리와 레지스터의 검사를 위한 core dump로서 FILE을 사용한다.
section	실행 파일의 섹션 SECTION의 기본 어드레스를 ADDR로 변경한다.
exec-file	순수한 메모리의 내용을 얻기 위한 프로그램으로서 FILE을 사용한다.
file	디버깅할 프로그램으로서 FILE을 사용한다.
path	디렉토리 DIR을 목적 파일에 대한 검색 시작점으로 추가한다.
load	실행중인 프로그램 속으로 FILE을 역동적으로 로딩한다.
add-shared-symbol-files	dynamic linker의 link map에 있는 shared object로 부터 심벌을 로딩한다. add-symbol-file 사용법 : add-symbol-file FILE ADDR
symbol-file	실행파일인 FILE로부터 심벌 테이블을 로딩한다.
set gnutarget	현재의 BFD 타겟을 셋팅한다.
list	지정된 함수나 행을 출력한다.
reverse-search	출력된 마지막 행에서부터 정규 표현식에 대해 역방향으로 검색한다.
search	출력된 마지막 행에서부터 정규 표현식에 대해 검색한다. (regex(3) 참조)
directory	원본 파일에 대한 검색 경로의 시작에 디렉토리 DIR을 추가한다.

상태 조회

명령어 목록

show	디버거에 관한 것을 보여주는 포괄적인 명령어
info	디버깅 중인 프로그램에 관한 것을 보여주는 포괄적인 명령어

지원 도구

명령어 목록

if	IF 조건이 0이 아닐 경우, 지정된 명령어들을 실행한다.
while	WHILE 조건이 0이 아닐 경우, 지정된 명령어들을 실행한다.
show confirm	위험한 작동을 확인할지를 보여준다.
show history	명령어 history 파라메터를 보여주기 위한 포괄적인 명령어이다.
show editing	명령어 라인의 편집을 보여준다.
show verbose	장황한 설명을 보여준다.
show prompt	gdb의 프롬프트를 보여준다.
show complaints	잘못된 기호에 관해 경고 메세지의 최대 수를 보여준다.
show demangle-style	현재의 C++ 스타일을 보여준다.
show write	실행 파일과 코어 파일에 쓰여지는 것을 보여준다.
show check range	검사할 범위를 보여준다.
show check type	검사할 타입을 보여준다.
show language	현재의 원본 언어를 보여준다.
show remotecache	remote 타겟을 위한 cache 사용을 보여준다.
show auto-solib-add	shared library symbol의 autoloading을 보여준다.
show stop-on-solib-events	shared library event에 대한 중지를 보여준다.
show symbol-reloading	1회 실행에 여러번 재로딩하는 다이나믹 심벌 테이블을 보여준다.
show radix	입출력 번호 radix의 디폴트 값을 보여준다.
show output-radix	값의 출력을 위한 출력 radix의 디폴트 값을 보여준다.
show input-radix	입력 숫자에 대한 입력 radix의 디폴트 값을 보여준다.
show print object	vtable 정보에 기초한 오브젝트의 파생된 타입의 출력을 보여준다.
show print vtbl	C++의 가상 함수 테이블의 출력을 보여준다. Show printing of C++ virtual function tables.
show print static-members	C++의 static member의 출력을 보여준다.
show print address	어드레스의 출력을 보여준다.
show print array	배열의 prettyprinting을 보여준다.
show print union	유니온 내부의 출력을 보여준다.
show print pretty	구조체의 prettyprinting을 보여준다.
show print asm-demangle	분해 목록에서 C++ 이름의 결합을 보여준다.
show print sevenbit-strings	스트링에서 \nnn과 같은 8비트 문자의 출력을 보여준다.
show print demangle	심벌을 출력할 때, 인코딩된 C++ 이름의 결합을 보여준다.
show listsize	gdb가 디폴트로 출력할 소스 라인의 숫자를 보여준다.
show height	gdb가 한 페이지에 넣을 수 있는 행수를 보여준다.
show width	gdb가 한 라인에 넣을 수 있는 글자수를 보여준다.
dont-repeat	이 명령을 반복하지 말라.
help	명령어의 목록을 출력한다.
quit	gdb를 빠져 나간다.
source	파일명 FILE로부터 명령어들을 읽어 들인다.
define	새로운 명령어 이름을 정의한다.
document	사용자 정의 명령에 해설을 단다.
echo	상수 스트링을 출력한다.
make	argument로서 그 행의 나머지를 사용하는 'make' 프로그램을 실행한다.
shell	쉘 명령으로서 그 행의 나머지를 실행한다.
set confirm	위험스런 작동을 확인할지 셋팅한다.
set history	명령어 history 파라메터 셋팅에 대한 포괄적인 명령어
set editing	명령어 라인의 편집을 셋팅한다
set verbose	장황한 설명 여부를 셋팅한다.
set prompt	gdb의 프롬프트를 셋팅한다.
set complaints	잘못된 심벌에 관한 경고 메세지의 최대 갯수를 셋팅한다.
set demangle-style	현재의 C++ 스타일을 셋팅한다.
set write	실행 파일과 코어 파일에 쓰여지는 것을 셋팅한다.
set check range	검사할 범위를 셋팅한다.
set check type	검사할 타입을 셋팅한다.
set language	현재의 원본 언어를 셋팅한다.
set remotecache	remote 타겟을 위한 cache 사용을 셋팅한다.
set auto-solib-add	shared library symbol의 autoloading을 셋팅한다.
set stop-on-solib-events	shared library event에 대한 중지를 셋팅한다.
set symbol-reloading	1회 실행에 여러번 재로딩하는 다이나믹 심벌 테이블을 셋팅한다.
set radix	입출력 번호 radix의 디폴트 값을 셋팅한다.
set output-radix	값의 출력을 위한 출력 radix의 디폴트 값을 셋팅한다.
set input-radix	입력 숫자에 대한 입력 radix의 디폴트 값을 셋팅한다.
set print object	vtable 정보에 기초한 오브젝트의 파생된 타입의 출력을 셋팅한다.
set print vtbl	C++ 가상 함수 테이블의 출력을 셋팅한다.
set print static-members	C++ static member의 출력을 셋팅한다.
set print address	어드레스의 출력을 셋팅한다.
set print array	배열의 prettyprinting을 셋팅한다.
set print union	유니온 내부의 출력을 셋팅한다.
set print pretty	구조체의 prettyprinting을 셋팅한다.
set print asm-demangle	분해 목록에서 C++ 이름의 결합을 셋팅한다.
set print asm-demangle	스트링에서 \nnn과 같은 8비트 문자의 출력을 셋팅한다.
set print demangle	심벌을 출력할 때, 인코딩된 C++ 이름의 결합을 셋팅한다.
set listsize	gdb가 디폴트로 출력할 소스 라인의 숫자를 셋팅한다.
set height	gdb가 한 페이지에 넣을 수 있는 행수를 셋팅한다.
set width	gdb가 한 라인에 넣을 수 있는 글자수를 셋팅한다.
down-silently	'down' 명령어와 동일
up-silently	'up' 명령어와 동일

사용자 정의 명령어

이 명령어들은 사용자의 정의에 의해서 만들어진다.
"define" 명령을 써서 명령어를 정의하라.

다른 명령어들의 별칭

명령어 목록

ni	명령어 하나를 진행한다.
si	명령어 하나를 정확하게 진행한다.
where	모든 스택 프레임을 역추적하면서 그 값을 출력한다.
disable breakpoints	몇몇 breakpoint를 disable시킨다.

기 타

명령어 목록

complete	명령어로서 그 행의 나머지에 대해 완성된 것을 출력한다.
remote <command>	remote 모니터로 명령을 보낸다.
stop	'stop' 명령어가 없지만, 당신은 'stop'에 대한 hook를 셋팅할 수 있다. 이것은 프로그램 중지가 실행될 때마다 명령어 목록을 셋팅할 수 있게 허용한다.

유지보수 명령어

몇몇 gdb 명령어들은 gdb 유지보수자에 의한 사용을 위해 제공되어진다. 이들 명령어들은 자주 변하기 쉬우며, 사용자 명령어들 처럼 상세한 설명이 되어 있지 않다.

명령어 목록

show watchdog	watchdog 타이머를 보여준다.
show targetdebug	디버깅 중인 타겟을 보여준다.
maintenance	GDB 유지보수자에 의한 사용을 위한 명령어들
maintenance check-symtabs	psymtab과 symtab의 일관성을 검사한다.
maintenance space	공간 사용의 출력을 셋팅한다.
maintenance time	시간 사용의 출력을 셋팅한다.
maintenance demangle	C++의 분해된 이름을 결합시킨다.
maintenance dump-me	중대한 에러를 취득; 디버거가 자신의 코어를 덤프하게 한다.
maintenance print	GDB 내부 상태 출력에 대한 유지보수 명령어 세부 명령어 maintenance print statistics maintenance print objfiles maintenance print psymbols maintenance print msymbols maintenance print symbols maintenance print type
maintenance info	디버깅 중인 프로그램에 관한 내부 정보를 보여주기 위한 명령어
set watchdog	watchdog 타이머를 셋팅한다. non-zero일 때, 이 타임아웃은 타겟에 대해 low-level step을 끝내거나 동작을 계속하게 하기 위해 영원히 기다리는 것 대신 사용되어진다. 만약 지정된 시간 동안 타겟으로부터 응답이 없으면, 에러가 발생한다.
set targetdebug	디버깅할 타겟을 셋팅한다. non-zero일 때, 디버깅할 타겟은 활성화된다.