GDB's target architecture defines what sort of machine-language programs GDB can work with, and how it works with them.
GDB 타겟 아키텍쳐는 GDB가 같이 작동할수 있는 머신-언어 프로그램의 종류와 작동하는 방법에 대한 정의이다.
At present, the target architecture definition consists of a number of C macros.
현재, 타겟 아키텍쳐 정의는 C 매크로 수로 이루어져 있다.
GDB's model of the target machine is rather simple. GDB assumes the machine includes a bank of registers and a block of memory. Each register may have a different size.
타겟 머신의 GDB 모델은 다소 간단하다. GDB는 머신은 레지스터 저장소와 메모리 블럭을 포함한다고 가정한다. 각 레지스터는 다른 크기를 가진다.
GDB does not have a magical way to match up with the
compiler's idea of which registers are which; however, it is critical
that they do match up accurately. The only way to make this work is
to get accurate information about the order that the compiler uses,
and to reflect that in the REGISTER_NAME and related macros.
GDB는 어떤 레지스터들이 어떤것이다에 대한 컴파일러의 인식과 일치하도록
하기 위해 색다른 방법을 가진것은 아니다.; 그러나, 그것들은 정확히 일치해야
한다. 이러한 작업을 만드는 유일한 방법은 컴파일러가 사용하는 순서에 대한
정확한 정보를 가지는 것이며 REGISTER_NAME와 관련 매크로내에
반영하는 것이다.
GDB can handle big-endian, little-endian, and bi-endian architectures.
GDB는 big-endian, little-endian 그리고 bi-endian 아키텍쳐를 다룰수 있다.
On almost all 32-bit architectures, the representation of a pointer is indistinguishable from the representation of some fixed-length number whose value is the byte address of the object pointed to. On such machines, the words "pointer" and "address" can be used interchangeably. However, architectures with smaller word sizes are often cramped for address space, so they may choose a pointer representation that breaks this identity, and allows a larger code address space.
거의 모든 32-비트 아키텍쳐에서, 포인터 표현은 포인트되고 있는 객체의 주소 바이트 값인 몇몇 고정된 길이 수의 표현식과 구분할수 없다. 그러한 머신에서, pointer와 address란 말은 같이 사용된다. 그러나, 작은 워드 크기를 가지는 아키텍쳐는 자주 주소 공간을 알기 어렵다. 그래서 그것들은 이러한 identity를 멈추는 포인터 표현식을 선택하고 커다란 코드 주소 공간을 허용한다.
For example, the Mitsubishi D10V is a 16-bit VLIW processor whose instructions are 32 bits long(2). If the D10V used ordinary byte addresses to refer to code locations, then the processor would only be able to address 64kb of instructions. However, since instructions must be aligned on four-byte boundaries, the low two bits of any valid instruction's byte address are always zero--byte addresses waste two bits. So instead of byte addresses, the D10V uses word addresses--byte addresses shifted right two bits--to refer to code. Thus, the D10V can use 16-bit words to address 256kb of code space.
예를 들어, Mitsubishi D10V는 명령어가 32bit long(2)인 16-bit VLIW processor이다. 만일 D10V가 코드 위치를 가리키는 일반적인 바이트 주소를 사용한다면, 프로세서는 명령어의 64kb를 address할수 있다. 그러나, 명령어는 4 바이트 경계로 정렬되어야 하기 때문에, 어떤 유효한 명령어 바이트 주소의 하위 2 비트는 항상 0이다.--바이트 주소는 2 비트를 낭비한다. 바이트 주소 대신에, D10V는 코드를 참조하기 위해 워드 주소를 사용한다.--바이트 주소는 2 비트 오른쪽으로 shift된다.-- 이와 같이, D10V는 코드 영역의 256kb를 어드레싱하기 위해 16 비트 워드를 사용할수 있다.
However, this means that code pointers and data pointers have different
forms on the D10V. The 16-bit word 0xC020 refers to byte address
0xC020 when used as a data address, but refers to byte address
0x30080 when used as a code address.
그러나, 이것은 코드 포인터와 데이터 포인터는 D10V에서 다른 형태를 가진다는
것을 의미한다. 16-비트 워드 0xC020는 데이터 주소로써 사용될때 바이트 주소 0xC020를 가리킨다. 그러나 코드 주소로써 사용될때는
바이트 주소 0x30080를 가리킨다.
(The D10V also uses separate code and data address spaces, which also affects the correspondence between pointers and addresses, but we're going to ignore that here; this example is already too long.)
(D10V는 또한 코드와 데이터 주소 공간을 분리할때 사용되며, 포인터와 주소사이의 상관관계에 영향을 준다. 그러나 여기서는 무시한다.; 이 예제는 이미 충분히 길다.)
To cope with architectures like this--the D10V is not the only
one!---GDB tries to distinguish between addresses, which are
byte numbers, and pointers, which are the target's representation
of an address of a particular type of data. In the example above,
0xC020 is the pointer, which refers to one of the addresses
0xC020 or 0x30080, depending on the type imposed upon it.
GDB provides functions for turning a pointer into an address
and vice versa, in the appropriate way for the current architecture.
이와 같이 아키텍쳐를 범위화하기 위해--D10V는 하나만 있지 않다.--GDB는 바이트
수인 addresses와 특정 데이터 타입의 주소에 대한 타겟 표현식인
pointers 사이를 구분할려고 한다.
위 예제에서, 0xC020는 여기에 부여된 타입에 의존하여 0xC020나 0x30080 주소중 하나를 가리키는 포인터이다.
GDB는 현재 아키텍쳐에 알맞는 방법으로 주소를 포인터로 그리고 그 반대를 위한 함수를 제공한다.
Unfortunately, since addresses and pointers are identical on almost all processors, this distinction tends to bit-rot pretty quickly. Thus, each time you port GDB to an architecture which does distinguish between pointers and addresses, you'll probably need to clean up some architecture-independent code.
불행하게도, 주소와 포인터는 거의 모든 프로세서들에서 동일하기 때문에 이러한 구분은 빨리 bit-rot하기 쉽다. 이와 같이, 여러분이 포인터와 주소를 구별하는 아키텍쳐로 GDB를 포팅할때마다, 여러분은 아마 아키텍쳐-독립적인 코드를 없앨 필요가 있다.
Here are functions which convert between pointers and addresses:
여기에 포인터와 주소사이의 변환을 위한 함수가 있다.:
포인터나 타입 type에 대한 참조로써 buf 바이트들을 다루고, 현재 아키텍쳐에 적당한 방법으로 이것이 나타내는 주소를 반환한다. 이것은 GDB가 타겟 메모리, disaseemble등등에서 읽을수 있는 주소를 산출한다. buf는 GDB 메모리내 버퍼를 가리키며 내부를 가리키는것이 아니다.
For example, if the current architecture is the Intel x86, this function extracts a little-endian integer of the appropriate length from buf and returns it. However, if the current architecture is the D10V, this function will return a 16-bit integer extracted from buf, multiplied by four if type is a pointer to a function.
예를 들어, 만일 현재 아키텍쳐가 Intel x86이라면, 이 함수는 buf에서 적당한 길이의 little-endian integer를 뽑아내고 이것을 반환한다. 그러나, 만일 현재 아키텍쳐가 D10V라면, 이 함수는 buf에서 뽑아낸 16 비트 정수를 반환하며, 만일 type가 함수에 대한 포인터라면 4를 곱한 16비트 정수를 반환한다.
If type is not a pointer or reference type, then this function will signal an internal error.
만일 type이 포인터나 참조 타입이 아니라면, 이 함수는 내부 에러를 보낸다.
현재 아키텍쳐에서 타입 type 포인터에 알맞는 형식으로, buf에 주소 addr를 저장한다. buf는 GDB 메모리내 버퍼를 가리키며 내부를 가리키는것이 아니다.
For example, if the current architecture is the Intel x86, this function stores addr unmodified as a little-endian integer of the appropriate length in buf. However, if the current architecture is the D10V, this function divides addr by four if type is a pointer to a function, and then stores it in buf.
예를 들어, 만일 현재 아키텍쳐가 Intel x86이라면, 이 함수는 buf에서 적당한 길이의 little-endian 정수로써 수정되지 않은 addr를 저장한다. 그러나, 만일 현재 아키텍쳐가 D10V라면, 이 함수는 만일 type이 함수에 대한 포인터라면 4로 addr를 나누고 buf에 저장한다.
If type is not a pointer or reference type, then this function will signal an internal error.
만일 type이 포인터나 참조 타입이 아니라면, 이 함수는 내부 에러를 보낸다.
val이 포인터라고 가정하고, 현재 아키텍쳐에 알맞게 표현한 주소를 반환한다.
This function actually works on integral values, as well as pointers.
For pointers, it performs architecture-specific conversions as
described above for extract_typed_address.
이 함수는 실제로 포인터처럼 정수 값으로 작동한다.
포인터를 위해, 이 함수는 extract_typed_address를 위해 위에서 기술한 아키텍쳐 의존적인 변환을 한다.
store_typed_address.
현재 아키텍쳐에 알맞게, 주소 addr를 위해 타입 type의
표현식 값을 만들고 반환한다. 이 함수는 store_typed_address를 위해
위에서 기술한 것처럼 아키텍쳐 의존적인 변환을 한다.
GDB also provides functions that do the same tasks, but assume that pointers are simply byte addresses; they aren't sensitive to the current architecture, beyond knowing the appropriate endianness.
GDB는 같은 태스크가 하는 함수를 제공한다. 그러나 포인터들은 간단히 바이트 주소라고 가정한다.; 그것들은 적당한 endian을 아는것을 넘어, 현재 아키텍쳐에 민감하지 않는다.
현재 아키텍쳐를 위한 적당한 endian의 addr에서 len 바이트 수를 알아내고 그것을 반환한다. addr는 GDB 메모리를 가리키며 내부를 가리키는것이 아니다.
This function should only be used in architecture-specific code; it
doesn't have enough information to turn bits into a true address in the
appropriate way for the current architecture. If you can, use
extract_typed_address instead.
이 함수는 아키텍쳐 의존적인 코드에서만 사용되어야 한다.; 이 함수는 현재 아키텍쳐에서 적당한 방법으로 실제주소로 비트들을 바꾸기 위한 충분한 정보를 가지고 있지
않다. 만일 여러분이 할수 있다면, extract_typed_address를 사용해라.
현재 아키텍쳐를 위한 적당한 endian으로 len-바이트 정수로써 val를 addr로 저장한다. addr는 GDB 메모리내 버퍼를 가리키지 않고 내부를 가리킨다.
This function should only be used in architecture-specific code; it
doesn't have enough information to turn a true address into bits in the
appropriate way for the current architecture. If you can, use
store_typed_address instead.
이 함수는 아키텍쳐 의존적인 코드에서만 사용되어야 한다. 그것은 현재 아키텍쳐에
적당한 방법으로 실제 주소를 비트로 바꾸기 위한 충분한 정보를 가지고 있지 않다.
만일 여러분이 할수 있다면, store_typed_address를 사용해라.
Here are some macros which architectures can define to indicate the relationship between pointers and addresses. These have default definitions, appropriate for architectures on which all pointers are simple byte addresses.
여기에 아키텍쳐가 포이터와 주소 사이의 관계를 가리키도록 정의할수 있는 몇몇 매크로가 있다. 이것들은 기본 정의이며, 모든 포인터들이 간단히 바이트 주소인 아키텍쳐에 적당한
현재 아키텍쳐를 위한 적당한 형식으로, buf는 포인터 타입 type를 가진다고 가정한다. 포인터가 참조하는 바이트 주소를 반환한다.
This function may safely assume that type is either a pointer or a C++ reference type.
이 함수는 type는 포인터나 C++ 참조 타입중 하나로 가정한다.
현재 아키텍쳐를 위한 적당한 형식으로, 주소 addr를 표현하는 포인터 타입 type를 buf에 저장한다.
This function may safely assume that type is either a pointer or a C++ reference type.
이 함수는 type는 포인터나 C++ 참조 타입중 하나로 가정한다.
Some architectures use one representation for a value when it lives in a
register, but use a different representation when it lives in memory.
In GDB's terminology, the raw representation is the one used in
the target registers, and the virtual representation is the one
used in memory, and within GDB struct value objects.
몇몇 아키텍쳐는 레지스터에 남아 있는 값을 위해 하나의 표현식을 사용한다. 그러나
메모리내에 있을때는 다른 표현식을 사용한다. GDB 용법에서, raw 표현식은
타겟 레지스터에서 사용되는 것이며 virtual 표현식은 메모리와 GDB struct value 객체내에서 사용되는 것이다.
For almost all data types on almost all architectures, the virtual and raw representations are identical, and no special handling is needed. However, they do occasionally differ. For example:
거의 모든 아키텍쳐에서 거의 모든 데이터 표현을 위해, virtual과 raw 표현식은 같으며 어떠한 특별한 핸들링도 필요하지 않다. 그러나, 그것들은 경우에 따라 다르다. 예를 들어;
long double type. However, when
we store those values in memory, they occupy twelve bytes: the
floating-point number occupies the first ten, and the final two bytes
are unused. This keeps the values aligned on four-byte boundaries,
allowing more efficient access. Thus, the x86 80-bit floating-point
type is the raw representation, and the twelve-byte loosely-packed
arrangement is the virtual representation.
x86 아키텍쳐는 80 비트 long double 타입을 지원한다.
그러나, 우리가 메모리내 이 값들을 저장한다면 이것들은 12바이트를 차지한다; 부동 소수점은
처음 10바이트를 차지하고 나머지 2 바이트는 사용되지 않는다. 이것은 4 바이트 경계로 할당되고
더 효율적은 접근을 허용한다. 이와 같이 x86 80 비트 부동소수점 타입은 raw 데이터 표현식이다.
그리고 12바이트 packed 배열은 virtual 표현식이다.
몇몇 64 비트 MIPS 타겟은 상위 비트내 쓰레기값과 함께 64 비트 레지스터로써 GDB에 32비트 레지스터를 넘겨준다. GDB는 상위 32비트는 무시한다. 이와 같이 상위 32비트는 쓰레기 값을 가지는 64 비트형태는 raw 표현식이며 잘라진 32 비트 표현식은 virtual 주소이다.
In general, the raw representation is determined by the architecture, or
GDB's interface to the architecture, while the virtual representation
can be chosen for GDB's convenience. GDB's register file,
registers, holds the register contents in raw format, and the
GDB remote protocol transmits register values in raw format.
일반적으로, raw 표현식은 아키텍쳐나 아키텍쳐에 대한 GDB 인터페이스에 의해 결정되며,
virtual 표현식은 GDB 편이에 따라 선택될수 있다. GDB 레지스터 파일 registers는
raw 형태로 레지스터 내용을 가지며 GDB 원격 프로토콜은 raw 형태에 레지스터 값을 전달한다.
Your architecture may define the following macros to request conversions between the raw and virtual format:
여러분의 아키텍쳐는 raw와 virtual 형태 사이의 변환을 요구하는 다음 매크로를 정의한다:
마닝ㄹ 레지스터 수 reg 값은 다른 raw와 virtual 형식이 필요하다면 0이 아닌값을 반환한다.
You should not use REGISTER_CONVERT_TO_VIRTUAL for a register
unless this macro returns a non-zero value for that register.
여러분느 만일 이 매크로가 그 레지스터를 위해 0이 아닌 값을 반환하지 않는다면,
레지스터를 위해 REGISTER_CONVERT_TO_VIRTUAL을 사용해서는 안된다.
registers, or in a GDB
remote protocol packet.
레지스터 수 reg의 raw 값의 크기. 이것은 registers나 GDB 원격
프로토콜 패킷에서 차지하는 레지스터 바이트 수이다.
struct value's buffer will have, holding that
register's value.
virtual 형식에서 레지스터 수 reg 값의 크기.
이것은 해당 레지스터 값을 가지는 struct value 버퍼 크기이다.
이것은 레지스터 수 reg의 virtual 표현식의 타입이다. 거기에는 레지스터 raw 형식을 위해 타입을 주는 매크로가 필요하지 않다.;일단 레지스터 값을 얻는다면, GDB는 항상 virtual 형식을 사용한다.
REGISTER_VIRTUAL_TYPE (reg). The buffer
at from holds the register's value in raw format; the macro should
convert the value to virtual format, and place it at to.
레지스터 수 reg의 값을 type로 변환하며 항상 REGISTER_VIRTUAL_TYPE (reg)이어야 한다. from에서 버퍼는 raw 형식내 레지스터 값을
가진다.; 매크로는 값을 virtual 형식으로 바꾸며 그것을 to에 놓는다.
Note that REGISTER_CONVERT_TO_VIRTUAL and
REGISTER_CONVERT_TO_RAW take their reg and type
arguments in different orders.
REGISTER_CONVERT_TO_VIRTUAL와 REGISTER_CONVERT_TO_RAW는
다른 순서로 reg와 type 인자를 가진다.
You should only use REGISTER_CONVERT_TO_VIRTUAL with registers
for which the REGISTER_CONVERTIBLE macro returns a non-zero
value.
여러분은 REGISTER_CONVERTIBLE 매크로가 0이 아닌 값으로 리턴하는 레지스터를 가지는 REGISTER_CONVERT_TO_VIRTUAL를 사용해야 한다.
REGISTER_VIRTUAL_TYPE (reg). The buffer at from holds the register's value in raw format; the macro should
convert the value to virtual format, and place it at to.
레지스터의 수 reg의 값을 type로 바꾸고, 이것은 항상 REGISTER_VIRTUAL_TYPE (reg)이어야 한다. from에서
버퍼는 raw 형식의 레지스터 값을 가진다.;매크로는 값을 virtual 형식이어야 하며,
to으로 놓아야 한다.
Note that REGISTER_CONVERT_TO_VIRTUAL and REGISTER_CONVERT_TO_RAW take their reg and type arguments in different orders.
REGISTER_CONVERT_TO_VIRTUAL과 REGISTER_CONVERT_TO_RAW는 다른 순서로 reg와 type 인자를 가진다.
This section describes the macros that you can use to define the target machine.
ADDITIONAL_OPTIONS
ADDITIONAL_OPTION_CASES
ADDITIONAL_OPTION_HANDLER
ADDITIONAL_OPTION_HELP
이것들은 추가적으로 GDB에 명령어 라인 옵션을 허용하는 매크로 집합들이다. 이것들은 현재 지원되지 않는 i960 Nindy 타겟에서만 사용되며 다른 설정사항에서는 사용되어서는 안된다.
ADDR_BITS_REMOVE (addr)
만일 어떤 비트를 포함하는 raw 머신 명령어 주소가 주소의 실제 부분이 아니라면, 그러면 addr내 이들 비트들이 0인 표현식으로 확장하도록 이 매크로를 정의해라. 이것은 명령어 주소를 위해서만 사용되며 모든 문맥에서는 아니다.
For example, the two low-order bits of the PC on the Hewlett-Packard PA
2.0 architecture contain the privilege level of the corresponding
instruction. Since instructions must always be aligned on four-byte
boundaries, the processor masks out these bits to generate the actual
address of the instruction. ADDR_BITS_REMOVE should filter out these
bits with an expression such as ((addr) & ~3).
예를 들어, Hewlett-Packard PA 2.0 아키텍쳐에서 PC의 하위 2비트는 명령어에
상응하는 우선권 레벨을 포함한다.
명령어는 4 바이트 경계로 정렬되어야하기 때문에, 프로세서는 명령어의 실제 주소를
만들기 위해 이들 비트를 마스크한다. ADDR_BITS_REMOVE는 ((addr) & ~3) 같은 표현식을 가지는 이들 비트를 필터해야 한다.
ADDRESS_TO_POINTER (type, buf, addr)
현재 아키텍쳐에 적당한 형식으로, 주소 addr를 표현하는 포인터 타입 type을 buf에 저장한다. 이 매크로는 type는 포인터나 C++ 참조 타입중 하나라는것을 가정한다. 타겟 아키텍쳐 정의섹션을 참조해라.
BEFORE_MAIN_LOOP_HOOK
main 루프를 시작히기전에 실행하길 원하는 코드로 확장하기 위해 이것을 정의한다. 엄격히 말해서, 이것이 타겟 조건이 아님에도 불구하고 현재 사용되는 방법이다. 만일 설정사항이 호스트를 위해 방법과 타겟을 위한 다른 방법이 정의되어 있따면, GDB는 아마도 컴파일되지 않고, 정확히 혼자 돌아가도록 허용되지 않는다. 이 매크로는 현재는 지원되지 않는 i960 Nindy 타겟에서만 사용되며 다른 설정사항 에서 사용되어서는 안된다.
BELIEVE_PCC_PROMOTION
short or char
parameter to an int, but still reports the parameter as its
original type, rather than the promoted type.
short나 char 인자를 int로
변경한다면 정의한다. 그러나 여전히 변경된 타입보다는 원 타입처럼 파라미터를 보고한다.
BELIEVE_PCC_PROMOTION_TYPE
short
argument when compiled by pcc, but look within a full int space to get its value. Only defined for Sun-3 at present.
만일 GDB가 pcc로 컴파일될때 타입 short 인자를 믿는다면
이것을 정의해라. 그러나 그 값을 가지기 위해 int 공간안에서 보아야 한다.
현재는 Sun-3에서만 정의된다.
BITS_BIG_ENDIAN
타겟내 비트의 수가 타겟 바이트 순서의 endian과 일치하지 않는다면 이것을 정의한다. 값 1은 그 비트가 big-endian 비트 순서라는것을 의미하며, 0은 little-endian을 의미한다.
BREAKPOINT
BREAKPOINT has been deprecated in favor of BREAKPOINT_FROM_PC.
이것은 breakpoint가 설정되어 있는 메모리 영역으로 비트 패턴을 넣기 위한
문자 배열 initializer이다. 비록 이것이 breakpoint를 위한 trap 명령어를 사용한다
할지라도, 요구되지는 않는다.; 예를 들어, bit 패턴은 무효한 명령어이다.
breakpoint는 아키텍쳐의 가장 작은 명령어보다 길어서는 안된다.
BREAKPOINT는 BREAKPOINT_FROM_PC 때문에 무시된다.
BIG_BREAKPOINT
LITTLE_BREAKPOINT
BIG_BREAKPOINT and LITTLE_BREAKPOINT have been deprecated in favor of BREAKPOINT_FROM_PC.
BREAKPOINT와 비슷하지만, bi-endian 타겟을 위해 사용된다.
BIG_BREAKPOINT와 LITTLE_BREAKPOINT는 BREAKPOINT_FROM_PC 때문에 무시된다.
REMOTE_BREAKPOINT
LITTLE_REMOTE_BREAKPOINT
BIG_REMOTE_BREAKPOINT
BIG_REMOTE_BREAKPOINT and LITTLE_REMOTE_BREAKPOINT have been deprecated in favor of BREAKPOINT_FROM_PC.
BREAKPOINT와 비슷하지만, 원격 타겟을 위해 사용된다.
BIG_REMOTE_BREAKPOINT와 LITTLE_REMOTE_BREAKPOINT는
BREAKPOINT_FROM_PC 때문에 무시된다.
BREAKPOINT_FROM_PC (pcptr, lenptr)
내용과 breakpoint 명령어의 크기를 결정하기 위해 프로그램 수를 사용한다. 이것은 breakpoint 명령어를 인코드하는 문자열 바이트에 대한 포인터를 반환하며, 문자열의 길이를 *lenptr에 저장하고 pc(만일 필요하다면)를 breakpoint가 삽입되어야 하는 실제 메모리 위치로 맞춘다. Although it is common to use a trap instruction for a breakpoint, it's not required; for instance, the bit pattern could be an invalid instruction. The breakpoint must be no longer than the shortest instruction of the architecture. Replaces all the other BREAKPOINT macros.
비록 이것이 breakpoint를 위한 trap 명령어에 사용된다할지라도, 요구되지는 않는다. ; 예를 들어, bit pattern은 무효한 명령어이다. breakpoint는 아키텍쳐의 가장 작은 명령어보다 길어서는 안된다.
MEMORY_INSERT_BREAKPOINT (addr, contents_cache)
MEMORY_REMOVE_BREAKPOINT (addr, contents_cache)
default_memory_insert_breakpoint and
default_memory_remove_breakpoint respectively) have been
provided so that it is not necessary to define these for most
architectures. Architectures which may want to define MEMORY_INSERT_BREAKPOINT and MEMORY_REMOVE_BREAKPOINT will
likely have instructions that are oddly sized or are not stored in a
conventional manner.
breakpoint 기반 메모리를 삽입하고 제거한다. 적절한 기본값(각각 default_memory_insert_breakpoint와 default_memory_remove_breakpoint)은
제공되어야 하며 대부분의 아키텍쳐에 이것을 정의할 필요는 없다.
MEMORY_INSERT_BREAK POINT와 MEMORY_REMOVE_BREAKPOINT를
정의하길 원하는 아키텍쳐는 짝이 안맞는 크기의 명령어나 편리한 방법으로 저장되지
않은 명령어를 가진다.
It may also be desirable (from an efficiency standpoint) to define
custom breakpoint insertion and removal routines if
BREAKPOINT_FROM_PC needs to read the target's memory for some
reason.
만일 BREAKPOINT_FROM_PC가 몇몇 이유로 타겟 메모리를 읽을 필요가
있다면, 일반 breakpint 삽입과 제거 루틴을 정의하길 원할(효율적인 standpoint) 것이다.
CALL_DUMMY_P
타겟이 내부 함수 호출을 지원할때 C 표현식은 0이 아니다.
CALL_DUMMY_WORDS
LONGEST words of data containing
host-byte-ordered REGISTER_BYTES sized values that partially
specify the sequence of instructions needed for an inferior function
call.
Should be deprecated in favor of a macro that uses target-byte-ordered
data.
내부 함수 호출에 필요한 명령어 순서를 지정하는 host-byte 순서의 REGISTER_BYTES크기의 값을 포함하는 데이터의 LONGEST 워드 배열에 대한 포인터.
target-byte 순서 데이터를 사용하는 매크로때문에 무시되어야 한다.
SIZEOF_CALL_DUMMY_WORDS
CALL_DUMMY_WORDS. When CALL_DUMMY_P this must return a positive value. See also CALL_DUMMY_LENGTH.
CALL_DUMMY_WORDS의 크기. CALL_DUMMY_P일때, 이것은
양수 값을 반환한다. 또한 CALL_DUMMY_LENGTH를 참조해라.
CALL_DUMMY
CALL_DUMMY_WORDS. Deprecated.
CALL_DUMMY_WORDS를 위한 static initializer. 없어졌다.
CALL_DUMMY_LOCATION
파일 `inferior.h'를 참조해라.
CALL_DUMMY_STACK_ADJUST
STACK_ALIGN.
스택 조정은 내부 함수 호출이 이루어졌을때 필요하다.
STACK_ALIGN같은 것때문에 무시되어야 한다.
CALL_DUMMY_STACK_ADJUST_P
CALL_DUMMY_STACK_ADJUST.
Should be deprecated in favor of something like STACK_ALIGN.
CALL_DUMMY_STACK_ADJUST 사용을 위한 술어.
STACK_ALIGN같은 것때문에 무시되어야 한다.
CANNOT_FETCH_REGISTER (regno)
FETCH_INFERIOR_REGISTERS is not defined.
만일 regno이 내부 프로세스에서 fetch되지 못한다면 C 표현식은 0이어서는 안된다. 만일 FETCH_INFERIOR_REGISTERS가 정의되어 있지 않다면
적절하다.
CANNOT_STORE_REGISTER (regno)
만일 regno이 타겟에 쓰여져서는 안된다면 C 표현식은 0이어서는 안된다. 익서은 프로그램 카운터, 상태 워드 그리고 다른 특별한 레지스터를 위한 경우이다. 만일 이것이 정의되지 않았다면, GDB는 모든 레지스터들이 쓰여질수 있다고 가정한다.
DO_DEFERRED_STORES
CLEAR_DEFERRED_STORES
어떤 레지스터 저장을 내부로 늦추어 실행하고 늦춰진 저장을 취소하기 위해 이것을 정의한다. 현재 native Sparc 설정에서만 수행되는가?
COERCE_FLOAT_TO_DOUBLE (formal, actual)
floats to doubles? This macro must evaluate to non-zero if we should, or zero if we should leave the
value alone.
만일 직접 함수를 호출하고 함수가 원형 없이 선언되었다면, 우리는 자동으로 floats를 doubles로 해야하는가?
이 매크로는 만일 우리가 행 한다면 0이 아닌값으로 평가하거나 값만을 남겨 놓는다면 0으로 평가된다.
The argument actual is the type of the value we want to pass to
the function. The argument formal is the type of this argument,
as it appears in the function's definition. Note that formal may
be zero if we have no debugging information for the function, or if
we're passing more arguments than are officially declared (for example,
varargs). This macro is never invoked if the function definitely has a
prototype.
인자 actual는 우리가 함수에 전달하길 원하는 값의 타입이다.
인자 formal는 이 인자의 타입이며 함수 정의시 나타난다.
만일 함수에 대한 디버깅정보를 가지고 있지 않다면, 또는 만일 공식적으로 선언(예를 들어, 가변 인자)된것 이상의 인자를 전달한다면 formal는 0이다.
이 매크로는 만일 함수가 원형을 가지고 있다면 결코 호출되지 않는다.
The default behavior is to promote only when we have no type information
for the formal parameter. This is different from the obvious behavior,
which would be to promote whenever we have no prototype, just as the
compiler does. It's annoying, but some older targets rely on this. If
you want GDB to follow the typical compiler behavior--to always
promote when there is no prototype in scope--your gdbarch init
function can call set_gdbarch_coerce_float_to_double and select
the standard_coerce_float_to_double function.
기본 행동은 우리가 정규인자에 대한 타입 정보를 가지고 있지 않을때만 조장된다.
이것은 분명항 행동과는 다르며 컴파일러가 하는것처럼, 우리가 원형을 가지고 있지 않을때는 언제나 조장된다. 짜증나지만 몇몇 예전 타겟들이 이것에 의존한다.
만일 여러분이 전형적인 컴파일러 행동을 허용하는 GDB를 원한다면--범위내 원형이 없을때만 항상 조장되도록)--여러분의 gdbarch init 함수는 set_gdbarch_coerce_float_to_double를 호출하고 standard_coerce_float_to_double함수를 선택한다.
CPLUS_MARKER
'$'. Most System V targets should
define this to '.'.
G++는 컴파일러가 만든 식별자와 프로그래머가 만든 식별자를 구별하기 위해 사용하는 문자로 확장하기 위해 이것을 정의한다. 기본적으로, 이것은 '$'로 확장한다.
대부분의 System V 타겟은 이것을 '.'로 정의해야 한다.
DBX_PARM_SYMBOL_CLASS
SYMBOL_CLASS of a parameter when decoding DBX symbol
information. In the i960, parameters can be stored as locals or as
args, depending on the type of the debug record.
DBX 심볼 정보를 디보깅힐때 파라미터 SYMBOL_CLASS를 위한 훅.
i960에서, 파라미터는 디버그 레코드 타입에 의존하여 로컬이나 인자로써 저장된다.
DECR_PC_AFTER_BREAK
BREAKPOINT, though not always. For most targets this value will be 0.
프로그램이 breakpint를 만난후 PC를 줄이기 위해 이것을 정의한다. 이것은
항상은 아니지만, BREAKPOINT내 바이트의 수이다.
대부분의 타겟을 위해, 이 값은 0이다.
DECR_PC_AFTER_HW_BREAK
비슷하게, hardware breakpint를 위해서 정의한다.
DISABLE_UNSETTABLE_BREAK (addr)
만일 정의한다면, 이것은 addr가 breakpint를 설정할수 없고 disable해야 하는 공유 라이브러리내 있다면 1로 평가되어야 한다.
DO_REGISTERS_INFO
만일 정의한다면, 레지스터의 값이나 모든 레지스터를 출력하기 위해 이것을 사용한다.
DWARF_REG_TO_REGNUM
DWARF 레지스터 수를 GDB regnum으로 바꾼다. 만일 정의되어 있지 않다면, 어떤 변환도 일어나지 않는다.
DWARF2_REG_TO_REGNUM
DWARF2 레지스터 수를 GDB regnum으로 바꾼다. 만일 정의되어 있지 않다면, 어떤 변환도 일어나지 않는다.
ECOFF_REG_TO_REGNUM
ECOFF 레지스터 수를 GDB regnum으로 바꾼다. 만일 정의되어 있지 않다면, 어떤 변환도 일어나지 않는다.
END_OF_TEXT_DEFAULT
이것은 텍스트 섹션의 끝을 가리켜야 하는 표현식이다.
EXTRACT_RETURN_VALUE(type, regbuf, valbuf)
raw 레지스터 상태 regbuf에서 함수의 반환 값 타입 type를 얻기 위해 이것을 정의하며 virtual 형식에서 그것을 valbuf로 복사한다.
EXTRACT_STRUCT_VALUE_ADDRESS(regbuf)
EXTRACT_STRUCT_VALUE_ADDRESS_P is non-zero, this is used to extract from an array regbuf (containing the raw register state) the
address in which a function should return its structure value, as a
CORE_ADDR (or an expression that can be used as one).
EXTRACT_STRUCT_VALUE_ADDRESS_P가 0이 아닐때, 이것은 함수가 CORE_ADDR(또는 하나로써 사용될수 있는 표현식)처럼 구조체 값을 반환해야 하는 배열 regbuf(raw 레지스터 상태를 포함하는) 주소를 얻기 위해 사용된다.
EXTRACT_STRUCT_VALUE_ADDRESS_P
EXTRACT_STRUCT_VALUE_ADDRESS.
EXTRACT_STRUCT_VALUE_ADDRESS를 술어.
FLOAT_INFO
만일 정의되어 있다면, 그러면 `info float' 명령어는 프로세서 부동 소수점 단위에 관한 정보를 출력한다.
FP_REGNUM
TARGET_READ_FP and
TARGET_WRITE_FP are not defined.
만일 virtual 프레임포인터가 레지스터에 유지된다면, 그려면 이 매크로는
그 레지스터의 수(0보다 크거나 같거나)로 정의되어야 한다.
이것은 만일 TARGET_READ_FP와 TARGET_WRITE_FP가
정의되어 있지 않다면 정의될 필요가 있다.
FRAMELESS_FUNCTION_INVOCATION(fi)
만일 fi이 나타내는 함수 호출이 그것과 관련있는 스택 프레임을 가지고 있지 않다면 1을 반환하는 표현식으로 이것을 정의한다. 그렇지 않으면 0을 반환한다.
FRAME_ARGS_ADDRESS_CORRECT
`stack.c'을 참조해라.
FRAME_CHAIN(frame)
주어진 frame는 호출 프레임에 대한 포인터를 반환한다.
FRAME_CHAIN_COMBINE(chain, frame)
프레임 체인 포인터를 가져오고 프레임의 명목상의 주소와 호출자 프레임의 명목상의 주소를 만들기 위해 이것을 정의한다. 현재 HP PA를 위해서만 정의된다.
FRAME_CHAIN_VALID(chain, thisframe)
만일 주어진 프레임이 호출자 없는 최상위 프레임이라면 0을 반환하는 표현식이 되도록 이것을 정의한다. 그렇지 않으면 0이 아닌값을 반환한다. 몇몇 일반적인 정의가 이용가능하다:
file_frame_chain_valid is nonzero if the chain pointer is nonzero
and given frame's PC is not inside the startup file (such as
`crt0.o').
만일 체인 포인터가 0이 아니고 주어진 프레임 PC가 startup 파일(`crt0.o' 같은)내부에 있지 않다면 file_frame_chain_valid는 0이 아니다.
func_frame_chain_valid is nonzero if the chain
pointer is nonzero and the given frame's PC is not in main or a
known entry point function (such as _start).
만일 체인 포인터가 0이 아니고 주어진 프레임 PC가 main나
알려진 엔트리 포인터 함수(_start같은)에 있지 않다면
func_frame_chain_valid는 0이 아니다.
generic_file_frame_chain_valid and
generic_func_frame_chain_valid are equivalent implementations for
targets using generic dummy frames.
generic_file_frame_chain_valid과 generic_func_frame_chain_valid는 일반적 더미 프레임을 사용하는 타겟을 위한 수행과 동일하다.
FRAME_INIT_SAVED_REGS(frame)
frame->saved_regs. Space for frame->saved_regs shall be allocated by
FRAME_INIT_SAVED_REGS using either
frame_saved_regs_zalloc or frame_obstack_alloc.
FRAME_FIND_SAVED_REGS and EXTRA_FRAME_INFO are deprecated.
`frame.h'를 참조해라. 현재 스택프레임내 모든 레지스터의 주소를 frame->saved_regs 각각에 저장하도록 결정한다.
FRAME_FIND_SAVED_REGS와 EXTRA_FRAME_INFO는 무시된다.
frame->saved_regs를 위한 공간은 frame_saved_regs_zalloc나 frame_obstack_alloc를 사용하는 FRAME_INIT_SAVED_REGS에 의해 할당되어야 한다.
FRAME_FIND_SAVED_REGS와 EXTRA_FRAME_INFO는 없어졌다.
FRAME_NUM_ARGS (fi)
-1.
fi에 의해 기술된 프레임은 전달된 인자의 수를 반환한다.
만일 인자의 수가 알려져 있지 않다면, -1을 반환한다.
FRAME_SAVED_PC(frame)
주어진 frame은 거기에 저장된 pc를 반환한다. 이것은 리턴 주소이다.
FUNCTION_EPILOGUE_SIZE
x_sym.x_misc.x_fsize field of the
function end symbol is 0. For such targets, you must define
FUNCTION_EPILOGUE_SIZE to expand into the standard size of a
function's epilogue.
몇몇 COFF 타겟을 위해, 함수 end 심볼의 x_sym.x_misc.x_fsize 필드는
0이다. 각 타겟을 위해, 여러분은 함수 epilogue의 표준 크기로 확장하기 위해
FUNCTION_EPILOGUE_SIZE를 정의해야 한다.
FUNCTION_START_OFFSET
call
instructions check this value, and save the appropriate registers
automatically. Thus, since the offset from the function's address to
its first instruction is two bytes, FUNCTION_START_OFFSET would
be 2 on the VAX.
정수, 함수 주소(심볼 값, 함수 포인터 등을 사용)에서 바이트로 주어진 offset 그리고 함수의 처음 진짜 명령어.
이것은 거의 모든 머신에서 0이다.; 함수 주소는 보통 처음 명령어의 주소이다.
그러나, 예를 들어 VAX에서 각 함수는 함수에 대한 엔트리를 저장하는 레지스터를
가리키는 bitmask를 포함하는 2 바이트로 시작한다. VAX call 명령어는
이 값을 검사하고 적당한 레지스터에 자동으로 저장한다. 이와 같이, 함수 주소에서
첫 명령어까지의 offset이 2 바이트이기때문에, VAX에서 FUNCTION_START_OFFSET는 2이다.
GCC_COMPILED_FLAG_SYMBOL
GCC2_COMPILED_FLAG_SYMBOL
gcc_compiled. and gcc2_compiled.,
respectively. (Currently only defined for the Delta 68.)
만일 정의되어 있다면, 이것들은 GCC가 컴파일한 파일을 찾도록 GDB가 찾는 심볼이름이다. 기본 심볼은 gcc_compiled. 그리고 gcc2_compiled.이다. (현재 Delta 68를 위해서 정의되어 있다.)
GDB_MULTI_ARCH
만일 정의되어 있고 0이 아니라면, GDB내 여러 아키텍쳐를 지원할수 있따. 지원은 2 레벨에서 가능하다. 한 레벨에서, 전에 정의되지 않은 매크로를 위한 정의만이 제공된다.; 레벨 2에서, 모든 아키텍쳐 의존 매크로의 multi-arch 정의가 정의된다.
GDB_TARGET_IS_HPPA
`dbxread.c'와 `partial-stab.h'내의 심각한 kludge 코드가 HPPA에서 다중 심볼 테이블 파일들을 관리하기 위해 사용될지아닐지를 결정한다. 이것은 모두 없애야 하며 대신에 `elfread.c'같은 구조를 사용해라.
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 값을 저장한다. 필요할때마다 머신의 현재 상태를 검사한다.
GET_SAVED_REGISTER
get_saved_register.
만일 여러분이 함수 get_saved_register를 위해 자신의 정의를
제공할 필요가 있다면 이것을 정의한다.
HAVE_REGISTER_WINDOWS
만일 타겟이 레지스터 윈도우을 가진다면 이것을 정의한다.
REGISTER_IN_WINDOW_P (regnum)
만일 주어진 레지스터가 윈도우에 있다면 표현식이 1이 되도록 이것을 정의한다.
IBM6000_TARGET
IBM RS/6000 target을 위해 설정되었다는것을 보여준다. 이 조건은 없어져야(FIXME)하며 feature-specific 매크로에 의해 대체되어야 한다. 그것은 성급하게 소개되었으며 후회하고 있다.
I386_USE_GENERIC_WATCHPOINTS
x86 기반 타겟은 일반적인 x86 watchpint 지원을 사용하기위해 이것을 정의할수 있다.; Algorithms섹션을 참조해라.
SYMBOLS_CAN_START_WITH_DOLLAR
몇몇 시스템은 `$'로 시작하는 이름의 루틴을 가진다.
0이 아닌 값의 매크로를 주는 것은 `$'로 시작하는 토큰을
파싱할때 그러한 루틴을 검사하도록 GDB 표현식 파서에게 말하는것이다.
On HP-UX, certain system routines (millicode) have names beginning with
`$' or `$$'. For example, $$dyncall is a millicode routine that handles inter-space procedure calls on PA-RISC.
HP-UX에서, 어떤 시스템 루틴(millicode)은 `$'나 `$$'로 시작하는 이름을 가진다. 예를 들어, $$dyncall는
PA-RISC에서 inter-space 프로시져를 처리하는 millicode 루틴이다.
IEEE_FLOAT
만일 타겟 시스템이 IEEE-형식 부동소수점 수를 사용한다면 이것을 정의한다.
INIT_EXTRA_FRAME_INFO (fromleaf, frame)
frame->extra_info. Space for frame->extra_info is allocated using frame_obstack_alloc.
만일 프레임에 관한 추가적인 정보가 요구된다면, 이것은 frame->extra_info에 저장되어야 한다. frame->extra_info를 위한 공간은 frame_obstack_alloc 사용시 할당된다.
INIT_FRAME_PC (fromleaf, prev)
이것은 prev가 가리키는 프레임의 pc를 설정하는 C 문장이다.
INNER_THAN (lhs, rhs)
lhs < rhs if the target's stack grows downward in memory, or lhs > rsh if the stack grows upward.
만일 스택 주소 lhs가 스택 주소 rhs보다 내부(스택 top에 더 가까운)에 있다면 0이 아닌 값이 반환된다.
만일 타겟 스택이 메모리내 아래쪽으로 성장한다면 lhs < rhs로써 이것을 정의하고 만일 스택이 위쪽으로 성장한다면 lhs > rsh를 정의한다.
IN_SIGTRAMP (pc, name)
sigtramp.
만일 주어진 pc아 name이 현재 함수는 sigtramp이라는것을 가리킨다면 0이 아닌 값을 리턴하도록 이것을 정의한다.
SIGTRAMP_START (pc)
SIGTRAMP_END (pc)
sigtramp for the
given pc. On machines where the address is just a compile time
constant, the macro expansion will typically just ignore the supplied
pc.
isigtramp 다음에 주어진 pc의 시작과 끝 주소로 이것들을 정의한다. 주소는 컴파일 시간인 머신에서, 매크로 확장은 제공된 pc를 무시할것이다.
IN_SOLIB_CALL_TRAMPOLINE (pc, name)
만일 프로그램이 공유 라이브러리와 연결하는 trampoline에서 멈춘다면 0이 아닌 값으로 평가하도록 이것을 정의한다.
IN_SOLIB_RETURN_TRAMPOLINE (pc, name)
만일 프로그램이 공유라이브러리에서 반환되는 trampoline에서 멈춘다면 0이 아닌값으로 평가하도록 이것을 정의한다.
IN_SOLIB_DYNSYM_RESOLVE_CODE (pc)
만일 프로그램이 동적 링커내에서 멈춘다면 0이 아닌값으로 평가하도록 이것을 정의한다.
SKIP_SOLIB_RESOLVER (pc)
실행은 동적 링커 심볼 해석 함수에서 가지기 위해 continue해야 하는 (nonzero)주소로 평가하도록 이것을 정의한다. zero 값은 그것은 동적 링커를 통해 얻기 위해 breakpoint 설정하는것은 중요하거나 필요하지 않다는것을 가리키며 그 단일 stepping은 충분하다.
IS_TRAPPED_INTERNALVAR (name)
이것은 GDB내 변수 값을 설정의 side-effect로써 일어나야 하는 특별한 행동의 내역을 허용하는 좋지 않은 훅이다. 현재 h8500에서만 사용된다. 이것은 host나 타겟 조건이어야 한다.
NEED_TEXT_START_END
만일 GDB가 텍스트 섹션의 시작과 끝 주소를 결정해야 한다면 이것을 정의한다. (의심스럽다.)
NO_HIF_SUPPORT
POINTER_TO_ADDRESS (type, buf)
buf는 현재 아키텍쳐를 위한 적당한 형식으로 포인터 타입 type를 가진다. 포인터가 참조하는 바이트 주소를 반환한다. Target Architecture Definition 섹션을 참조해라.
REGISTER_CONVERTIBLE (reg)
만일 reg이 다른 raw와 virtual 형식을 사용한다면 0이 아닌값을 반환한다. Target Architecture Definition 섹션을 참조해라.
REGISTER_RAW_SIZE (reg)
reg의 raw 사이트를 반환한다. Target Architecture Definition 섹션을 참조해라.
REGISTER_VIRTUAL_SIZE (reg)
reg의 virtual 크기를 반환한다. Target Architecture Definition 섹션을 참조해라.
REGISTER_VIRTUAL_TYPE (reg)
reg의 virtual type을 반환한다. Target Architecture Definition 섹션을 참조해라.
REGISTER_CONVERT_TO_VIRTUAL(reg, type, from, to)
raw 형태에서 virtual 형태로 레지스터의 값 reg를 바꾼다. Target Architecture Definition 섹션을 참조해라.
REGISTER_CONVERT_TO_RAW(type, reg, from, to)
virtual 형태에서 raw 형태로 레지스터 값 reg를 반환한다. Target Architecture Definition 섹션을 참조 해라.
RETURN_VALUE_ON_STACK(type)
만일 타입 TYPE의 값이 "struct convention"을 사용하는 스택에서 반환된다면, 0이 아닌값을 반환한다. (i.e., 호출자는 callee가 반환값을 저정해야 하는 buffer에 대한 포인터를 제공한다.) 이것은 `finish' 명령어가 함수의 리턴값을 발견하는 방법을 제어하며 내부 함수 호출이 리턴 값을 위한 스택내 공간을 유지하는지를 제어한다. 여기서 GDB가 사용하는 완전한 로직은 여러 종류이다.
RETURN_VALUE_ON_STACK returns zero, then GDB
concludes the value is not returned using the struct convention.
만일 값이 반환하는 타입이 구조체, union, array가 아니고 RETURN_VALUE_ON_STACK가 0을 리턴한다면, 그러면 GDB는 값은 struct convention을 사용하여 리턴되지 않는다고 결론짓는다.
USE_STRUCT_CONVENTION (see below).
If that returns non-zero, GDB assumes the struct convention is
in use.
그렇지 않으면, GDB는 USE_STRUCT_CONVENTION를 호출한다.(아래 참조)
만일 그것이 0이 아닌값을 리턴한다면, GDB는 struct convention이 유효하다고 가정한다.
RETURN_VALUE_ON_STACK likes, and something that USE_STRUCT_CONVENTION likes.
다시 말해서, 주어진 타입이 struct convention을 사용한 값을 리턴한다는것을
가리키기 위해 타입은 struct, union, array 또는 RETURN_VALUE_ON_STACK같은 것 그리고 USE_STRUCT_CONVENTION 같은 것중이어야 한다.
Note that, in C and C++, arrays are never returned by value. In those
languages, these predicates will always see a pointer type, never an
array type. All the references above to arrays being returned by value
apply only to other languages.
C와 C++에서 array는 값에 의해 리턴되지 않는다. 이들 언어에서, 이들 술어는 항상 배열 타입이 아니라 포인터 타입으로 본다. 값에 의해 리턴하는 배열에 대한 참조 모두는 다른언어에도 적용된다.
SOFTWARE_SINGLE_STEP_P()
SOFTWARE_SINGLE_STEP must also be defined.
만일 타겟이 하드웨어 single-step 메카니즘을 가지지 않는다면 이것을 정의한다.
매크로 SOFTWARE_SINGLE_STEP 또한 정의되어야 한다.
SOFTWARE_SINGLE_STEP(signal, insert_breapoints_p)
다음 명령어의 가능한 목적지마다 breakpoint를 삽입하고 제거(insert_breapoints_p에 의존)하는 함수. `sparc-tdep.c'와 `rs6000-tdep.c'를 참조해라.
SOFUN_ADDRESS_MAYBE_MISSING
영리한 사람은 여러분이 디버그 정보에서 가지는 주소가 더 실제적일수록 링커는 그것들을 재 할당하는데 더 많은 시간을 가진다는것을 안다.
그래서 디버거가 필요한 주소를 발견할수 있는 다른 방법이 있을때마다,
여러분은 더 빠른 정보를 위해 디버그 정보에서 그것을 빼야 한다.
SOFUN_ADDRESS_MAYBE_MISSING indicates that a particular set of
hacks of this sort are in use, affecting N_SO and N_FUN entries in stabs-format debugging information. N_SO stabs mark the beginning and ending addresses of compilation units in the text
segment. N_FUN stabs mark the starts and ends of functions.
SOFUN_ADDRESS_MAYBE_MISSING means two things:
SOFUN_ADDRESS_MAYBE_MISSING는 특별히 이런 종류의 hack 집합은 stabs 형식 디버깅 정보내 N_SO와 N_FUN 엔트리에 영향을 준다는것을 가리킨다.
N_SO stab은 텍스트 세그먼트내 컴파일 단위의 시작과 끝 주소를 표시한다. N_FUN stab은 함수의 시작과 끝을 표시한다.
N_FUN stabs have an address of zero. Instead, you should find the
addresses where the function starts by taking the function name from
the stab, and then looking that up in the minsyms (the
linker/assembler symbol table). In other words, the stab has the
name, and the linker/assembler symbol table is the only place that carries
the address.
N_FUN stab은 주소 0을 가진다. 대신에, 여러분은 함수가 stab에서의 함수 이름을 가지기 시작하고 minsyms(linker/assember symbol table)에서 찾도록 주소를 찾아야 한다.
다시 말해서, stab은 이름을 가지고 linter/assembler symbol table은 주소를
나르는 장소이다.
N_SO stabs have an address of zero, too. You just look at the
N_FUN stabs that appear before and after the N_SO stab,
and guess the starting and ending addresses of the compilation unit from
them.
N_SO도 역시 0의 주소를 가진다. 여러분은 N_SO stab
전후에 나타나는 N_FUN를 보고 그것들에서 컴파일 단위의
시작과 끝 주소를 추측한다.
PCC_SOL_BROKEN
(Convex 타겟에서만 사용된다.)
PC_IN_CALL_DUMMY
`inferior.h'를 참조해라.
PC_LOAD_SEGMENT
만일 정의되어 있다면, 프로그램 카운트를 위한 로드 세그먼트에 관한 정보를 출력한다.(RS/6000에서만 정의된다.)
PC_REGNUM
만일 프로그램 카운트가 레지스터에 유지된다면, 이 매크로를 그 레지스터의 수
(0보다 크거나 같다)가 되도록 정의한다.
This should only need to be defined if TARGET_READ_PC and
TARGET_WRITE_PC are not defined.
이것은 만일 TARGET_READ_PC와 TARGET_WRITE_PC가 정의되어 있지 않다면 정의할 필요가 있다.
NPC_REGNUM
만일 정의되어 있다면, "next program counter" 레지스터의 수.
NNPC_REGNUM
만일 정의되어 있다면, "next next program counter" 레지스터의 수. 현재, 이것은 Motorola 88K에서만 정의된다.
PARM_BOUNDARY
만일 0이 아니라면, 그것들을 스택에 넣기 전에 많은 비트의 경계로 인자를 round한다.
PRINT_REGISTER_HOOK (regno)
만일 정의되어 있다면, 이것은 주어진 렞지스터의 내용을 표준 출력으로 출력하는 함수이어야 한다.
PRINT_TYPELESS_INTEGER
print_longest that seems to
have been defined for the Convex target.
이것은 Convex 타겟을 위해 정의되어야 하는 print_longest를 위한
애매한 대체함수이다.
PROCESS_LINENUMBER_HOOK
XCOFF 읽기를 위해 정의된 훅.
PROLOGUE_FIRSTLINE_OVERLAP
(지원되지 않는 Convex 설정사항에서만 사용된다.)
PS_REGNUM
만일 정의된다면, 이것은 프로세서 상태 레지스터의 수이다. (이 정의는 "$ps"를 파싱할때 일반적인 코드에서만 사용된다.)
POP_FRAME
이공 스택 프레임을 제거하기 위해 `call_function_by_hand'에서 사용되며 실제 스택 프레임을 제거하기 위해 `return_command'에서 사용된다.
PUSH_ARGUMENTS (nargs, args, sp, struct_return, struct_addr)
내부 함수 호출을 위한 스택에 인자들을 넣기 위해 이것을 정의한다. 갱신된 스택 포인터 값을 반환한다.
PUSH_DUMMY_FRAME
인공 스택 프레임을 만들기 위해 `call_function_by_hand'에서 사용된다.
REGISTER_BYTES
머신 레지스터 상태의 GDB 복사본을 저장하기 위해 필요한 공간의 총 양.
REGISTER_NAME(i)
NULL or NUL to indicate that register i is not valid.
스트링으로써 레지스터의 이름 i를 반환한다.
레지스터 i가 유효하지 않다는것을 가리키기 위해 NULL나 NUL을 반환한다.
REGISTER_NAMES
REGISTER_NAME.
REGISTER_NAME는 없어졌다.
REG_STRUCT_HAS_ADDR (gcc_p, type)
만일 주어진 타입이 직접보다 포인터로 전달된다면 0을 리턴하는것으로 정의한다.
SAVE_DUMMY_FRAME_TOS (sp)
SP after both the dummy frame and space for parameters/results have been allocated on the stack.
내부 코드에 전달될 top-of-stack 값의 타겟 의존적인 코드를 인식하게 하기위해 `call_function_by_hand'에서 사용된다.
이것은 dummy frame과 값/결과를 위한 공간이 스택에 할당된후에 SP의 값이다.
SDB_REG_TO_REGNUM
sdb 레지스터의 수를 GDB regnum으로 바꾸기 위해 이것을 정의한다. 만일 정의되어 있지않다면, 어떤 변화도 행해지지 않는다.
SHIFT_INST_REGS
(m88k 타겟에서만 사용된다.)
SKIP_PERMANENT_BREAKPOINT
SKIP_PERMANENT_BREAKPOINT adjusts the processor's state so that execution will resume just after the breakpoint. This
macro does the right thing even when the breakpoint is in the delay slot
of a branch or jump.
내부 PC는 영구 breakpoint 전달을 나아가게 한다.
GDB는 보통 제거시 breakpint 위로 step하며 한 명령어를 step하고 breakpint를
다시 삽입한다. 그러나, 영구 breakpoint는 내부에서 오래가고 제거할수 없다.
그래서 이러한 전략은 작동하지 않는다. SKIP_PERMANENT_BREAKPOINT 호출은 프로세서 상태를 맞추며 실행은 breakpoint후에 다시 시작한다.
이 매크로는 breakpoint가 branch나 jump의 delay slot에 있을때조차 작당한 것이다.
SKIP_PROLOGUE (pc)
함수 엔트리 prologue를 넘어선 "real" 코드 주소를 반환하는 C 표현식은 pc에서 발견된다.
SKIP_PROLOGUE_FRAMELESS_P
SKIP_PROLOGUE will be used instead.
C 표현식은 비슷하게 행동하지만 함수가 프레임을 가지고 있는것으로 알려지자마자 멈출수 있다. 만일 정의되어 있지 않다면, SKIP_PROLOGUE가
대신 사용된다.
SKIP_TRAMPOLINE_CODE (pc)
만일 타겟 머신이 호출자와 함수가 호출 사이에 있는 trampoline 코드라면, 그러면 실제 함수의 시작인 새 PC를 반환하도록 이 매크로를 정의해라.
SP_REGNUM
만일 stack pointer가 레지스터에 유지된다면, 그러면 그 레지스터의 수(0보다 크거나 같거나)가 되도록 이 매크로를 정의해라.
This should only need to be defined if TARGET_WRITE_SP and
TARGET_WRITE_SP are not defined.
이것은 만일 TARGET_WRITE_SP와 TARGET_WRITE_SP이
정의되어 있지 않다면 정의할 필요가 있다.
STAB_REG_TO_REGNUM
stab 레지스터의 수("r" 선언에서 갖는 것처럼)를 GDB regnum 으로 바꾸기 위해 이것을 정의한다. 만일 정의되어 있지 않다면, 어떠한 변환도 행해지지 않는다.
STACK_ALIGN (addr)
주소를 프로세서 스택을 요구하는 정렬로 맞추기 위해 이것을 정의한다.
STEP_SKIPS_DELAY (addr)
만일 주소가 delay slot을 가진 명령어라면 참을 반환하도록 이것을 정의한다. 만일 breakpint가 명령어의 delay slot에 위치해 있다면, GDB는 보통 다시 시작하기 전에 명령어를 single-step한다. 현재 Mips에서만 정의된다.
STORE_RETURN_VALUE (type, valbuf)
C 표현식은 타입 type의 값을 리턴하는 함수를 저장하며, valbuf는 저장되어야하는 값의 주소이다.
SUN_FIXED_LBRAC_BUG
(Sun-3과 Sun-4 타겟에서만 사용된다.)
SYMBOL_RELOADING_DEFAULT
"symbol-reloading" 변수의 기본 값. (현재 소스에는 결코 정의되어 있지 않다.)
TARGET_BYTE_ORDER_DEFAULT
BIG_ENDIAN or LITTLE_ENDIAN. This macro replaces
TARGET_BYTE_ORDER which is deprecated.
타겟내 바이트 순서. 이것은 BIG_ENDIAN나 LITTLE_ENDIAN 이어야 한다. 이 매크로는 무시되는 TARGET_BYTE_ORDER를 대신한다.
TARGET_BYTE_ORDER_SELECTABLE_P
BIG_ENDIAN and
LITTLE_ENDIAN variants. This macro replaces
TARGET_BYTE_ORDER_SELECTABLE which is deprecated.
만일 타겟이 BIG_ENDIAN과 LITTLE_ENDIAN 변종이라면
0이 아닌값이다. 이 매크로는 무시되는 TARGET_BYTE_ORDER_SELECTABLE를 대신한다.
TARGET_CHAR_BIT
char 비트의 수; 기본은 8.
TARGET_COMPLEX_BIT
2 * TARGET_FLOAT_BIT.
At present this macro is not used.
complex 수 비트 수;기본은 2 * TARGET_FLOAT_BIT.
현재 이 매크로는 사용되지 않는다.
TARGET_DOUBLE_BIT
8 * TARGET_CHAR_BIT.
double float 비트 수;기본은 8 * TARGET_CHAR_BIT
TARGET_DOUBLE_COMPLEX_BIT
2 * TARGET_DOUBLE_BIT.
At present this macro is not used.
double complex 비트 수;기본은 2 * TARGET_DOUBLE_BIT
현재 이 매크로는 사용되지 않는다.
TARGET_FLOAT_BIT
4 * TARGET_CHAR_BIT.
float 비트 수; 기본은 4 * TARGET_CHAR_BIT.
TARGET_INT_BIT
4 * TARGET_CHAR_BIT.
integer 비트 수;기본은 4 * TARGET_CHAR_BIT.
TARGET_LONG_BIT
4 * TARGET_CHAR_BIT.
long integer 비트 수;기본은 4 * TARGET_CHAR_BIT
TARGET_LONG_DOUBLE_BIT
2 * TARGET_DOUBLE_BIT.
long double float 비트 수;기본은 2 * TARGET_DOUBLE_BIT
TARGET_LONG_LONG_BIT
2 * TARGET_LONG_BIT.
long long integer 비트 수;기본은 2 * TARGET_LONG_BIT
TARGET_PTR_BIT
TARGET_INT_BIT.
포인터 비트 수;기본은 TARGET_INT_BIT
TARGET_SHORT_BIT
2 * TARGET_CHAR_BIT.
short integer 비트 수;기본은 2 * TARGET_CHAR_BIT
TARGET_READ_PC
TARGET_WRITE_PC (val, pid)
TARGET_READ_SP
TARGET_WRITE_SP
TARGET_READ_FP
TARGET_WRITE_FP
read_pc, write_pc,
read_sp, write_sp, read_fp and write_fp.
For most targets, these may be left undefined. GDB will call the read
and write register functions with the relevant _REGNUM argument.
이것들은 read_pc, write_pc,
read_sp, write_sp, read_fp and
write_fp의 행위를 바꾼다.
대부부의 타겟을 위해, 이것들은 정의되지 않은채로 남아 있다.
GDB는 _REGNUM 인자와 관련되어 읽고 쓰는 레지스터 함수를 호출한다.
These macros are useful when a target keeps one of these registers in a
hard to get at place; for example, part in a segment register and part
in an ordinary register.
이들 매크로는 타겟이 적절하게 가지기 어려운 이들 레지스터들중 하나를 유지할때 유용하다.;예를 들어, 세그먼트 레지스터의 일부와 일반적 레지스터의 일부.
TARGET_VIRTUAL_FRAME_POINTER(pc, regp, offsetp)
(register, offset) pair representing the virtual
frame pointer in use at the code address pc. If virtual
frame pointers are not used, a default definition simply returns
FP_REGNUM, with an offset of zero.
코드 주소 pc에서 사용되는 virtual 프레임 포인터를 표현하는
(register, offset) 쌍을 반환한다. 만일 virtual 프레임 포인터가
사용되지 않는다면, 기본 정의는 단순히 0인 offset을 가지고 FP_REGNUM를 반환한다.
TARGET_HAS_HARDWARE_WATCHPOINTS
만일 0이 아니라면, 타겟은 하드웨어-관련 watchpoint를 지원한다. 세부사항과 다른 관련 매크로를 위해 Algorithms 섹션을 참조해라.
USE_STRUCT_CONVENTION (gcc_p, type)
만일 정의되었다면, 이것은 주어진 type 값이 스택에 할당된 공간을 가져야하는 함수에서 반환된다면 0이 아닌 표현식이어야 한다. 만일 고려한 함수가 GCC에 의해 컴파일되었다면 gcc_p는 참이다.; 이것은 GCC는 다른 컴파일러보다 다른 호출 변환을 사용한다고 알려진 시스템에 유용하다.
VARIABLES_INSIDE_BLOCK (desc, gcc_p)
n_desc from the
N_RBRAC symbol, and gcc_p is true if GDB has noticed the presence of either the GCC_COMPILED_SYMBOL or the
GCC2_COMPILED_SYMBOL. By default, this is 0.
dbx-style 디버깅 정보를 위해, 만일 컴파일러가 LBRAC/RBRAC 블럭내 변수 선언을
하였다면, 이것은 0이 아닌것으로 정의해야 한다.
desc가 N_RBRAC 심볼에서 n_desc 값이고,
만일 GDB가 GCC_COMPILED_SYMBOL나 GCC2_COMPILED_SYMBOL의 존재를 인식한다면 gcc_p는 참이다.
기본적으로, 이것은 0이다.
OS9K_VARIABLES_INSIDE_BLOCK (desc, gcc_p)
OS/9000에서 비슷하다. 기본은 1.
Motorola M68K target conditionals.
Motorola M68K 타겟 조건들.
BPT_VECTOR
0xf.
breakpoint trap vector의 4 비트 위치에 이것을 정의한다.
만일 정의되어 있지 않다면, 그것은 0xf이 기본이다.
REMOTE_BPT_VECTOR
1.
기본은 1.
The following files define a target to GDB:
다음 파일들은 GDB에 대한 타겟을 정의한다.:
이 타겟을 위한 Makefile fragment를 포함한다. 어떤 오브젝트 파일이 `TDEPFILES=...'와 `TDEPLIBS=...'를 정의한 타겟 ttt이 필요한지를 지정한다. 또한 `TM_FILE = tm-ttt.h'를 정의하여 ttt를 기술하는 헤더 파일을 지정한다. You can also define `TM_CFLAGS', `TM_CLIBS', `TM_CDEPS', but these are now deprecated, replaced by autoconf, and may go away in future versions of GDB.
여러분은 `TM_CFLAGS', `TM_CLIBS', `TM_CDEPS'를 정의한다. 그러나 현재는 무시되며 autoconf로 대체되었다. 그리고 GDB의 나중 버전에 없어졌다.
configure). Contains macro definitions about the target machine's registers, stack frame format and instructions.
(`tm.h'는 configure가 만든 이 파일에 대한 링크이다.)
타겟 머신 레지스터, 스택 프레임 형식과 명령어에 대한 매크로 정의를 포함한다.
이 타겟 머신에 요구되는 기타 코드들을 포함한다. 몇몇 머신에서, 그것은 모두 존재하지는 않는다. 가끔 `tm-ttt.h'내 매크로는 매우 복잡해져서 대신 여기 함수로써 수행되며 매크로는 단순히 함수 호출을 정의한다. 이해히기도 디버그하기도 쉽기때문에 이것은 매우 좋다.
타겟 머신 프로세스 칩(레지스터, 스택 등)의 기본 레이아웃을 설명하기 위해 존재한다. 만일 사용된다면, `tm-ttt.h'에 의해 포함된다. 같은 프로세스를 사용하는 많은 타겟들사이에 공유된다.
비슷하게, 이 특정 아키텍쳐를 사용하는 모든 타겟 머신에 의해 공유되는 일반적 서브루틴이 있다.
If you are adding a new operating system for an existing CPU chip, add a
`config/tm-os.h' file that describes the operating system facilities that are unusual (extra symbol table info; the breakpoint
instruction needed; etc.). Then write a `arch/tm-os.h'
that just #includes `tm-arch.h' and
`config/tm-os.h'.
만일 여러분이 존재하는 CPU 칩을 위한 새 OS를 추가한다면, 특별한 OS 기능을
기술하는 `config/tm-os.h' 파일을 추가해라.
그리고 단지 #includes `tm-arch.h'와 `config/tm-os.h'를 포함하는 `arch/tm-os.h'를 쓴다.
Go to the first, previous, next, last section, table of contents.