Several files control GDB's configuration for native support:
몇몇 파일들은 native 지원을 위해 GDB 설정사항들을 제어한다:
머신 xyz의 호스트나 native때 필요한 Makefile fragment를 말한다. 특별히, 이 리스트는 `NATDEPFILES=...'를 정의하여 native-dependent 객체 파일을 요구한다. 또한 `NAT_FILE= nm-xyz.h'을 정의하여 xyz의 natvie 지원을 기술하는 헤더 파일을 말한다. 여러분은 또한 `NAT_CFLAGS', `NAT_ADD_FILES', `NAT_CLIBS', `NAT_CDEPS', 등을 정의한다.; `Makefile.in'을 참조해라.
configure). Contains C
macro definitions describing the native system environment, such as
child process control and core file support.
(`nm.h'는 이 파일에 대한 링크이며 configure이 말한다.)
자식 프로세스 지원과 코어파일 지원 같은 native system 환경을 기술하는 C
매크로 정의를 포함한다.
이 머신의 native 지원을 요구하는 기타 C 코드를 포함한다. 몇몇 머신에서, 항상 존재하는것은 아니다.
There are some "generic" versions of routines that can be used by
various systems. These can be customized in various ways by macros
defined in your `nm-xyz.h' file. If these routines work for
the xyz host, you can just include the generic file's name (with
`.o', not `.c') in NATDEPFILES.
여기에는 여러 시스템에 사용될수 있는 일반적인 버전의 루틴들이 있다.
이것들은 `nm-xyz.h' 파일에 정의된 매크로에 의해
다양한 방법으로 커스터마이징 될수 있다. 만일 이들 루틴들이 xyz 호스트에서 작동된다면, 여러분은 NATDEPFILES내 일반적인 파일 이름(`.o'는 같이, `.c'는 아니다.)을 포함할수 있다.
Otherwise, if your machine needs custom support routines, you will need
to write routines that perform the same functions as the generic file.
Put them into `xyz-nat.c', and put `xyz-nat.o'
into NATDEPFILES.
그렇지 않고, 만일 머신이 custom 지원 로틴을 필요로 한다면, 여러분은 일반적인
파일처럼 같은 함수를 수행하는 루틴을 쓸 필요가 있다.
그것들을 `xyz-nat.c'에 놓고, `xyz-nat.o'을 NATDEPFILES로 놓아라.
이 파일은 ptrace를 사용하고 자식을 제어하길 기다리는 시스템내 Unix 자식 프로세스를 지원하는 target_ops vector을 포함한다.
이 파일은 자식 제어를 위해 /proc을 사용하는 시스템내 Unix 자식 프로세스를 지원하는 target_ops vector를 포함한다.
이 파일은 자식 프로세스를 시작하기 하기 위해 "fork 그리고 exec" Unix 시스템 호출을 사용하는 하위-레벨 작업을 한다.
ptrace call in a vanilla way.
이 파일은 유닉스 ptrace 호출을 사용하는 시스템을 위해
내부 프로세스에 대한 하위 레벨 인터페이스이다.
register_addr(), see below. Now that BFD is used to read core
files, virtually all machines should use core-aout.c, and should
just provide fetch_core_registers in xyz-nat.c (or
REGISTER_U_ADDR in nm-xyz.h).
코어파일에서 레지스터 읽기를 지원한다. 이루틴은 아래 보이는 register_addr()를 호출한다. BFD는 코어 파일을 일기 위해 사용되며, 실제로 모든 머신은
core-aout.c을 사용해야 하며 xyz-nat.c (또는 nm-xyz.h내 REGISTER_U_ADDR)내 fetch_core_registers을 제공해야 한다.
nm-xyz.h file defines the macro
REGISTER_U_ADDR(addr, blockend, regno), it should be defined to
set addr to the offset within the `user' struct of GDB
register number regno. blockend is the offset within the "upage" of u.u_ar0. If REGISTER_U_ADDR is defined, `core-aout.c' will define the register_addr() function and use the macro in it. If you do not define REGISTER_U_ADDR, but you are using the standard fetch_core_registers(), you will need
to define your own version of register_addr(), put it into your
xyz-nat.c file, and be sure xyz-nat.o is in the NATDEPFILES list. If you have your own
fetch_core_registers(), you may not need a separate
register_addr(). Many custom fetch_core_registers()
implementations simply locate the registers themselves.
만일 nm-xyz.h 파일이 매크로 REGISTER_U_ADDR(addr, blockend, regno)를 정의한다면, 그것은 addr을 GDB 레지스터
번호 regno의 `user' 구조내 offset으로 설정하도록 정의
되어야 한다.
blockend는 u.u_ar0의 "upage"내 offset이다.
만일 REGISTER_U_ADDR이 정의되었다면, `core-aout.c'는
register_addr()함수를 정의하고 함수내 매크로를 사용한다.
만일 여러분이 REGISTER_U_ADDR 정의하지 않았다면, 그러나 표준
fetch_core_registers()를 사용한다면, 여러분은 자신의 register_addr() 버전을 정의할 필요가 있으며, 함수를 xyz-nat.c 파일에 넣고 xyz-nat.o는 NATDEPFILES 리스트내 있다는 것을 확실하다.
When making GDB run native on a new operating system, to make it
possible to debug core files, you will need to either write specific
code for parsing your OS's core files, or customize
`bfd/trad-core.c'. First, use whatever #include files your machine uses to define the struct of registers that is accessible
(possibly in the u-area) in a core file (rather than
`machine/reg.h'), and an include file that defines whatever header
exists on a core file (e.g. the u-area or a struct core). Then
modify trad_unix_core_file_p to use these values to set up the
section information for the data segment, stack segment, any other
segments in the core file (perhaps shared library contents or control
information), "registers" segment, and if there are two discontiguous
sets of registers (e.g. integer and float), the "reg2" segment. This
section information basically delimits areas in the core file in a
standard way, which the section-reading routines in BFD know how to seek
around in.
GDB가 새 오퍼레이팅 시스템에서 native로 돌아가도록 만들고, 코어 파일을 디버깅
가능하도록 만들기 위해, 여러분은 OS 코어 파일을 파싱하기 위한 특별한 코드를
쓰거나 `bfd/trad-core.c'를 커스터마이징할 필요가 있다.
우선, 머신내 #include 파일이 코어 파일(`machine/reg.h' 보다는)
에서 접근되는 레지스터 구조를 정의하기 위해 사용한 것이 무엇이든 사용해라.
그리고 코어파일(u-area나 struct core)에 존재하는 헤더가 무엇이든 정의되어 있는 include 파일을 사용해라.
그리고 데이터 세그먼트, 스택 세그먼트, 코어 파일(아마 공유 라이브러리 내용이나
제어 정보)내 다른 세그먼트, "registers" 세그먼트를 위한 섹션 정보를 설정하기 위해
이 값들을 사용하도록 trad_unix_core_file_p를 수정해라.
그리고 만일 두개의 연속적이니 않은 레지스터 집합(e.g. integer와 float)이 있다면,
"reg2" 세그먼트를 수정해라. 이 섹션 정보는 기본적으로 표준 방법으로 코어 파일내
영역의 한계를 지으며, BFD내 섹션 읽기 루틴은 탐색할 방법을 안다.
Then back in GDB, you need a matching routine called
fetch_core_registers. If you can use the generic one, it's in
`core-aout.c'; if not, it's in your `xyz-nat.c' file.
It will be passed a char pointer to the entire "registers" segment,
its length, and a zero; or a char pointer to the entire "regs2"
segment, its length, and a 2. The routine should suck out the supplied
register values and install them into GDB's "registers" array.
GDB로 다시 가서, 여러분은 fetch_core_registers를 호출하는 루틴과
매치시킬 필요가 있다. 만일 여러분이 일반적인것을 사용한다면, 그것은 `core-aout.c'에 있다; 만일 그렇지 않다면, `xyz-nat.c' 파일내에 있다.
전체 "registers" 세그먼트, 길이, 0에 대한 char point를 전달할 것이다.;
또는 전체 "regs2" 세그먼트, 길이, a 2에 대한 char point. 루틴은 제공되는 레지스터 값을 얻어 GDB의 "registers" 배열에 이것들을 설치한다.
If your system uses `/proc' to control processes, and uses ELF format core files, then you may be able to use the same routines for reading the registers out of processes and out of core files.
만일 시스템이 프로세스를 제어하기 위해 `/proc'를 사용한다면, ELF 형식 코어 파일을 사용한다면, 여러분은 프로세스와 코어파일에서 레지스터를 읽기 위한 같은 루틴을 사용할수 있다.
When GDB is configured and compiled, various macros are defined or left undefined, to control compilation when the host and target systems are the same. These macros should be defined (or left undefined) in `nm-system.h'.
GDB가 설정되고 컴파일될때, 다양한 macro가 호스트와 타겟 시스템이 같을때 컴파일을 제어하기 위해 정의되고 미정의 상태로 남아 있는다. 이들 매크로는 `nm-system.h'에 정의(또는 미정의로)되어야 한다.
ATTACH_DETACH
attach and
detach commands.
만일 정의되었다면, GDB는 attach와 detach 명령어에 대한
지원을 포함한다.
CHILD_PREPARE_TO_STORE
만일 머신이 자식 프로세스내 모든 레지스터를 저장한다면, 모든 값이 정확하다는것을 확실히 하기 위해 이것을 저의해라. 이것은 보통 자식에서 읽기를 상속받는다. [이것은 현재 `xm-system.h' 파일내 부정확하게 정의되어 있다.]
FETCH_INFERIOR_REGISTERS
fetch_inferior_registers and store_inferior_registers in
`host-nat.c'. If this symbol is not defined, and
`infptrace.c' is included in this configuration, the default
routines in `infptrace.c' are used for these functions.
만일 native-dependent 코드가 `host-nat.c'에 자신의 루틴 fetch_inferior_registers과 store_inferior_registers를 제공한다면 이것을 정의해라. 만일 이 심볼이 정의되어 있지 않고 `infptrace.c'이 이 설정에서
포함되어 있다면, `infptrace.c'내 기본 루틴은 이들 함수에서 사용된다.
FILES_INFO_HOOK
FP0_REGNUM
이 매크로는 만일 머신이 그러한 레지스터를 가지고 있다면, 부동 소수점 레지스터의 수를 정의한다. 이것은 타겟 특정 코드에서만 나타난다. 그러나, `/proc'은 float가 이 타겟에서 사용중인지를 결정하기 위해 이것의 사용을 지원한다.
GET_LONGJMP_TARGET
longjmp will jump to,
assuming that we have just stopped at a longjmp breakpoint. It takes a
CORE_ADDR * as argument, and stores the target PC value through this
pointer. It examines the current state of the machine as needed.
재부분의 머신에서, 이것은 타겟 의존적인 인자이다.
DECstation과 Iris에서, 이것은 native 의존적인 인자이다. 왜냐하면 `setjmp.h'는 이것을 정의하기 위해 필요하기 때문이다.
이 매크로는 longjmp가 점프할 타겟 PC 주소를 결정하며, longjmp breakpoint에서 멈추도록 가정한다. 인자로써 CORE_ADDR *를 가지며 이 포인터를
통해서 타겟 PC 값을 저장한다. 필요할때 머신의 현재 상태를 검사한다.
I386_USE_GENERIC_WATCHPOINTS
x86 기반 머신은 일반적인 x86 watchpoint 지원을 사용하도록 정의할수 있다.; 알고리즘 섹션을 참조해라.
KERNEL_U_ADDR
u structure (the "user
struct", also known as the "u-page") in kernel virtual memory. GDB
needs to know this so that it can subtract this address from absolute
addresses in the upage, that are obtained via ptrace or from core files.
On systems that don't need this value, set it to zero.
커널 가상 메모리내 u 구조체("u-page"로써 알려진 "user struct")의 주소로 정의한다. GDB는 이것을 알 필요가 있다. 그래서 upage내 절대주소에서 이 주소를
뺄수 있으며 ptrace나 core file을 통해 얻는다.
이 값이 필요없는 시스템에서, 그것을 0으로 설정한다.
KERNEL_U_ADDR_BSD
u at
runtime, by using Berkeley-style nlist on the kernel's image in
the root directory.
루트 디렉토리의 커널 이미지내 Berkeley-style nlist를 사용하여, runtime시 u의 주소를 결정하도록 GDB를 야기하기 위해 이것을 정의한다.
KERNEL_U_ADDR_HPUX
u at
runtime, by using HP-style nlist on the kernel's image in the
root directory.
루트 디렉토리의 커널 이미지내 HP-style nlist를 사용하여, runtime시
u의 주소를 결정하도록 GDB를 야기하기 위해 이것을 정의한다.
ONE_PROCESS_WRITETEXT
breakpoint 삽입이 실패할때, 다른 프로세스가 같은 실행파일로 돌릴지 모르는 사용자에게 경고를 줄수 있도록 이것을 정의한다.
PREPARE_TO_PROCEED (select_it)
proceed function in `infrun.c' deals with switching between
threads.
In a multi-threaded task we may select another thread and then continue
or step. But if the old thread was stopped at a breakpoint, it will
immediately cause another breakpoint stop without any execution (i.e. it
will report a breakpoint hit incorrectly). So GDB must step over it
first.
If defined, PREPARE_TO_PROCEED should check the current thread
against the thread that reported the most recent event. If a step-over
is required, it returns TRUE. If select_it is non-zero, it should
reselect the old thread.
이 매크로는 쓰레드 스위칭을 다루는 `infrun.c'내 proceed 함수를
커스터마이징하기 위해 native 설정사항을 허용한다.
멀티 쓰레드 태스크에서, 우리는 다른 쓰레드를 선택하고 continue나 step을 계속한다.
그러나 만일 예전 쓰레드가 breakpoint에서 멈춘다면, 어떤 실행도 없이 즉시 다른 breakpoint stop을 야기한다.
그래서 GDB는 우선 뛰어 넘어야(step-over) 해야한다.
만일 정의되었다면, PREPARE_TO_PROCEED는 가장 최근 이벤트를 보고한
쓰레드와 대조적인 현재 쓰레드를 검사해야 한다. 만일 step-over가 요구된다면,
TRUE를 반환한다. 만일 select_it가 0이 아니라면, 그것은 예전 쓰레드를
다시 선택한다.
PROC_NAME_FMT
`/proc' 장치의 이름을 위한 형식을 정의한다. `procfs.c'에 있는 기본 정의를 오버라이딩하기 위해 `nm.h'에 정의 해야만 한다.
PTRACE_FP_BUG
`mach386-xdep.c'를 참조해라.
PTRACE_ARG3_TYPE
ptrace system call, if it
exists and is different from int.
만일 존재하고 int와 다르다면, ptrace 시스템 콜에 대한
세번째 인자 타입.
REGISTER_U_ADDR
"u area"내 레지스터의 offset을 정의한다.
SHELL_COMMAND_CONCAT
정의되었다면, 이것은 내부에서 시작하기 위해 사용되는 shell 명령어의 접두사에 대한 문자열이다.
SHELL_FILE
"/bin/sh".
정의되었다면, 이것은 내부에서 작동될때 사용할 shell의 이름이다.
기본은 "/bin/sh"이다.
SOLIB_ADD (filename, from_tty, targ)
이것은 filename내 심볼을 GDB 심볼 테이블에 추가하도록 표현식을 확장하도록 정의한다.
SOLIB_CREATE_INFERIOR_HOOK
이것은 여러분이 자식 프로세스가 fork된후 돌아가길 원하는 어떤 공유-라이브러리-재할당 코드로 확장하도록 정의한다.
START_INFERIOR_TRAPS_EXPECTED
하위 부분을 시작할때, GDB는 보통 2번 trap될것으로 예상한다.;shell이 exec될때와 program 자체가 exec될때. 만일 trap의 실제 수가 2 이상이라면, 예상된 수로 확장하도록 이 매크로를 정의해라.
SVR4_SHARED_LIBS
SVR4-style 공유 라이브러리가 사용중인지를 가리키도록 정의한다.
USE_PROC_FS
이것은 GDB 내부 표현과 `/proc' 표현 사이의 레지스터 값을 변환하는 `*-tdep.c'내 작은 루틴들이 컴파일되었느지 아닌지를 결정한다.
U_REGS_OFFSET
FETCH_INFERIOR_REGISTERS is not defined). If
the default value from `infptrace.c' is good enough, leave it
undefined.
The default value means that u.u_ar0 points to the location of
the registers. I'm guessing that #define U_REGS_OFFSET 0 means
that u.u_ar0 is the location of the registers.
이것은 upage에 있는 레지스터의 offset이다. 이것은 만일 `infptrace.c'의
일반적인 ptrace 레지스터 접근 루틴이 사용된다면 정의될 필요가 있다.
(즉, `infptrace.c'는 설정되고 FETCH_INFERIOR_REGISTERS는 정의
되지 않는다.) 만일 `infptrace.c'에서 기본 값이 충분히 좋다면,
정의되지 않은체로 남긴다.
기본 값은 u.u_ar0는 레지스터의 위치를 가리킨다는것을 의미한다.
개인적으로 #define U_REGS_OFFSET 0는 u.u_ar0는 레지스터의 위치이다는것을 의미한다고 생각한다.
CLEAR_SOLIB
`objfiles.c'를 참조해라.
DEBUG_PTRACE
ptrace calls.
ptrace 호출을 디버깅하기 위해 이것을 사용해라.
Go to the first, previous, next, last section, table of contents.