The GNU linker
GNU 링커인 ld is meant to cover a broad range of situations,
and to be as compatible as possible with other linkers. As a result,
you have many choices to control its behavior.
ld는 광범위한 용도로 사용되고,
가능한 다른 링커들과 호환이 되게 설계되었다. 이 결과로 실행을 제어하는
많은 옵션을 가진다.
명령행 옵션
The linker supports a plethora of command-line options, but in actual
practice few of them are used in any particular context.
For instance, a frequent use of
링커에는 매우 많은 명령행 옵션이 있지만, 실제 사용되는 것은 소수이다.
예를 들면, ld is to link standard Unix
object files on a standard, supported Unix system. On such a system, to
link a file hello.o:
ld의 흔한 용도는 유닉스 시스템에서 표준 유닉스
오브젝트 파일을 링크하는 것이다. 이 경우 hello.o 파일을
링크하여면,
ld -o output /lib/crt0.o hello.o -lc
This tells
위에서 ld to produce a file called output as the
result of linking the file /lib/crt0.o with hello.o and
the library libc.a, which will come from the standard search
directories. (See the discussion of the `-l' option below.)
ld는 /lib/crt0.o, hello.o와
표준 검색 디렉토리에 있는 라이브러리 libc.a를 링크하여 결과로
output를 만든다. (`-l' 옵션은 아래서 설명된다.)
Some of the command-line options to
여러 명령행 옵션은 명령행에서 아무 곳이나 위치해도 된다. 그러나
`-l'나 `-T'와 같이 파일과 관련된 옵션의 경우,
명령행에서 옵션의 순서대로 파일을 읽는다. 파일과 관련이 없는 옵션을
서로 다른 아규먼트를 가지고 여러번 사용하면 무효가 되거나 (명령행의 왼쪽) 전의
옵션을 무시한다. 여러번 반복되도 되는 옵션은 아래 옵션 설명에 명시된다.
ld may be specified at any
point in the command line. However, options which refer to files, such
as `-l' or `-T', cause the file to be read at the point at
which the option appears in the command line, relative to the object
files and other file options. Repeating non-file options with a
different argument will either have no further effect, or override prior
occurrences (those further to the left on the command line) of that
option. Options which may be meaningfully specified more than once are
noted in the descriptions below.
Non-option arguments are object files or archives which are to be linked
together. They may follow, precede, or be mixed in with command-line
options, except that an object file argument may not be placed between
an option and its argument.
옵션이 아닌 아규먼트는 오브젝트 파일이거나 같이 링크될 아카이브 파일이다.
이들은 옵션과 옵션의 아규먼트 사이를 제외하고는 명령행 어디에도 위치할 수 있다.
Usually the linker is invoked with at least one object file, but you can
specify other forms of binary input files using `-l', `-R',
and the script command language. If no binary input files at all
are specified, the linker does not produce any output, and issues the
message `No input files'.
링커는 보통 최소한 한 오브젝트 파일을 가지고 실행된다. 그러나
`-l', `-R' 옵션이나 스크립트 명령 언어로도
입력 파일을 지정할 수 있다. 어떤 이진 입력 파일도 주어지지 않다면,
링커는 어떤 출력 파일도 만들지않고 `No input files'라고
출력을 한다.
If the linker can not recognize the format of an object file, it will
assume that it is a linker script. A script specified in this way
augments the main linker script used for the link (either the default
linker script or the one specified by using `-T'). This feature
permits the linker to link against a file which appears to be an object
or an archive, but actually merely defines some symbol values, or uses
링커가 오브젝트 파일 형식을 알아내지 못하면, 이를 링커 스크립트로 간주한다.
이렇게 주어진 스크립트는 주 링커 스크립트를 (기본 링커 스크립트나
`-T' 옵션으로 지정한 스크립트) 보완한다.
이런 스크립트를 이용하여 오브젝트 파일이나 아카이브 파일처럼 보이는 파일들을
링크할 수 있지만, 실제로 심볼값을 정의하거나
다른 오브젝트를 읽어들이기 위해
INPUT or GROUP to load other objects. Note that
specifying a script in this way should only be used to augment the main
linker script; if you want to use some command that logically can only
appear once, such as the SECTIONS or MEMORY command, you
must replace the default linker script using the `-T' option.
See section Linker Scripts.
INPUT, GROUP을 사용한다. 이렇게 주어진 스크립트는
주 링커 스크립트를 보완하는데만 사용되는 것을 주의하라.
만약 SECTIONS나 MEMORY 명령어와 같이 의미상 한번만
나와야하는 명령어를 사용해야 한다면, `-T' 옵션으로 기본 링커
스크립트를 대체해야 한다. Linker Scripts를
참고하라.
For options whose names are a single letter,
option arguments must either follow the option letter without intervening
whitespace, or be given as separate arguments immediately following the
option that requires them.
이름이 한 문자인 옵션의 아규먼트는 공백 없이 옵션 문자 바로 뒤에 적거나
옵션 뒤에 아규먼트로 적어주면 된다.
For options whose names are multiple letters, either one dash or two can
precede the option name; for example, `-trace-symbol' and
`--trace-symbol' are equivalent. Note - there is one exception to
this rule. Multiple letter options that start with a lower case 'o' can
only be preceeded by two dashes. This is to reduce confusion with the
`-o' option. So for example `-omagic' sets the output file
name to `magic' whereas `--omagic' sets the NMAGIC flag on the
output.
이름이 여러 문자인 옵션은 옵션 이름 앞에 하나나 두개의 빼기 기호를 쓴다.
예를 들어, `-trace-symbol'와 `--trace-symbol'는
동일하다. 주의! 이 규칙에 예외가 있다. 여러 문자 옵션이 소문자 'o'로 시작하면
`-o 옵션과 혼동을 피하기 위해서 빼기 기호를 두개 써줘야 한다.
그래서 `-omagic은 출력 파일이름을 `magic'으로 하고,
`--omagic'은 출력에 NMAGIC 플래그를 설정한다.
Arguments to multiple-letter options must either be separated from the
option name by an equals sign, or be given as separate arguments
immediately following the option that requires them. For example,
`--trace-symbol foo' and `--trace-symbol=foo' are equivalent.
Unique abbreviations of the names of multiple-letter options are
accepted.
여러 문자 옵션의 아규먼트는 옵션과 등호로 연결되거나 옵션 뒤에 독립된 아규먼트로
주어진다. 예를 들어, `--trace-symbol foo'와
`--trace-symbol=foo'는 동일하다. 여러 문자 옵션의 줄인 이름도 있다.
Note - if the linker is being invoked indirectly, via a compiler driver
(eg `gcc') then all the linker command line options should be
prefixed by `-Wl,' (or whatever is appropriate for the particular
compiler driver) like this:
주의! 링커가 `gcc' 같은 컴파일러 드라이버에 의해 간접적으로
실행된다면, 다음과 같이 링커 옵션 앞에 `-Wl,'을
(혹은 특정 컴파일러 드라이버에 해당하는) 붙여야 한다.
gcc -Wl,--startgroup foo.o bar.o -Wl,--endgroup
This is important, because otherwise the compiler driver program may
silently drop the linker options, resulting in a bad link.
그렇지 않으면 컴파일러 드라이버 프로그램이 링커 옵션을 무시하여 링크를
잘못하게 된다.
Here is a table of the generic command line switches accepted by the GNU
linker:
다음은 GNU 링커의 일반 명령행 옵션들이다.
-akeyword
-Aarchitecture
--architecture=architecture
ld, this option is useful only for the
Intel 960 family of architectures. In that ld configuration, the
architecture argument identifies the particular architecture in
the 960 family, enabling some safeguards and modifying the
archive-library search path. See section ld and the Intel 960 family, for details.
Future releases of ld may support similar functionality for
other architecture families.
ld and the Intel 960 family을 참고하라.
앞으로 다른 아키텍쳐 계열에서도 비슷한 기능을 지원할 수 있다.
-b input-format
--format=input-format
ld may be configured to support more than one kind of object
file. If your ld is configured this way, you can use the
`-b' option to specify the binary format for input object files
that follow this option on the command line. Even when ld is
configured to support alternative object formats, you don't usually need
to specify this, as ld should be configured to expect as a
default input format the most usual format on each machine.
input-format is a text string, the name of a particular format
supported by the BFD libraries. (You can list the available binary
formats with `objdump -i'.)
See section BFD.
You may want to use this option if you are linking files with an unusual
binary format. You can also use `-b' to switch formats explicitly (when
linking object files of different formats), by including
`-b input-format' before each group of object files in a
particular format.
The default format is taken from the environment variable
GNUTARGET.
See section Environment Variables.
You can also define the input format from a script, using the command
TARGET; see section Commands dealing with object file formats.
ld는 여러개의 오브젝트 파일 형식을 지원할 수 있다. 만약 그렇다면
`-b' 옵션으로 이 옵션 뒤에 나오는 입력 오브젝트 파일의 형식을
지정할 수 있다. 그러나 이를 지정하지 않아도 ld는 각 플래폼에서
가장 많이 쓰이는 형식을 기본 형식으로 고려한다. input-format은
문자열로 BFD 라이브러리가 지원하는 형식의 이름이다. (가능한 형식은
`objdump -i'로 확인할 수 있다.)
BFD를 참조하라.
보통 많이 쓰이지 않는 형식의 파일을 링크할 때, 이 옵션을 사용한다.
또, 여러 다른 형식의 오브젝트 파일을 링크할 때 각 형식의 오브젝트
파일들 앞에 `-b input-format'를 사용하여
명시적으로 형식을 변환할 수 있다.
기본 형식은 환경변수 GNUTARGET에서 읽어들인다.
Environment Variables를 참고하라.
또, TARGET 명령어를 사용하여 스크립트에서 입력 형식을
정의할 수도 있다.
Commands dealing with object file formats를
참고하라.
-c MRI-commandfile
--mri-script=MRI-commandfile
ld accepts script
files written in an alternate, restricted command language, described in
section MRI Compatible Script Files. Introduce MRI script files with
the option `-c'; use the `-T' option to run linker
scripts written in the general-purpose ld scripting language.
If MRI-cmdfile does not exist, ld looks for it in the directories
specified by any `-L' options.
ld는
MRI Compatible Script Files에 설명된
별도의 제한된 명령 언어를 받아들인다. MRI 스크립트 파일은 `-c' 옵션과
함께 사용한다. (범용 ld 스크립트 언어로 쓰여진 파일은 `-T'
옵션과 함께 사용한다.) MRI-cmdfile을 찾지못하면, `-L'
옵션으로 지정한 디렉토리에서 찾는다.
-d
-dc
-dp
FORCE_COMMON_ALLOCATION has the same effect.
See section Other linker script commands.
FORCE_COMMON_ALLOCATION도
같은 기능을 한다. Other linker script commands를
참조하라.
-e entry
--entry=entry
-E
--export-dynamic
dlopen to load a dynamic object which needs to refer
back to the symbols defined by the program, rather than some other
dynamic object, then you will probably need to use this option when
linking the program itself.
dlopen을 사용하여 프로그램에서 정의한 심볼을 나중에
참조하는 동적 객체를 읽어들인다면 아마도 이 옵션이 필요할 것이다.
-EB
-EL
-f
--auxiliary name
-F name
--filter name
-F option throughout a compilation
toolchain for specifying object-file format for both input and output
object files. The GNU linker uses other mechanisms for this
purpose: the -b, --format, --oformat options, the
TARGET command in linker scripts, and the GNUTARGET
environment variable. The GNU linker will ignore the -F
option when not creating an ELF shared object.
-F 옵션을 사용했다. GNU 링커는 이 목적으로,
-b, --format, --oformat 옵션과
스크립트에서 TARGET 명령어, 환경변수 GNUTARGET을 사용한다.
GNU 링커는 ELF 공유 객체를 만들지 않다면 -F 옵션을 무시한다.
-fini name
_fini를
사용한다.
-g
-Gvalue
--gpsize=value
-hname
-soname=name
-i
-init name
_init as the
function to call.
_init를
사용한다.
-larchive
--library=archive
ld will search its
path-list for occurrences of libarchive.a for every
archive specified.
On systems which support shared libraries, ld may also search for
libraries with extensions other than .a. Specifically, on ELF
and SunOS systems, ld will search a directory for a library with
an extension of .so before searching for one with an extension of
.a. By convention, a .so extension indicates a shared
library.
The linker will search an archive only once, at the location where it is
specified on the command line. If the archive defines a symbol which
was undefined in some object which appeared before the archive on the
command line, the linker will include the appropriate file(s) from the
archive. However, an undefined symbol in an object appearing later on
the command line will not cause the linker to search the archive again.
ld는
자체 패스에서 libarchive.a를 찾는다.
공유 라이브러리를 지원하는 시스템에서는 .a 외의 확장자를 가진
라이브러리도 찾는다. 구체적으로 ELF와 SunOS 시스템에서 .a 확장자를
가진 라이브러리를 찾기 전에 .so 확장자를 가진 라이브러리를 찾는다.
관습으로 .so 확장자는 공유 라이브러리를 나타낸다.
링커는 명령행에 주어진 위치에서 단 한번만 라이브러리를 찾는다.
명령행에서 라이브러리 전에 위치한 파일에서 정의되지 않은 심볼을 라이브러리가
정의하면, 링커는 라이브러리로 부터 적당한 파일을 포함한다.
그러나 명령행에서 뒤에 위치한 파일의 정의되지 않은 심볼은 라이브러리에서
다시 찾지 않는다.
See the -( option for a way to force the linker to search
archives multiple times.
You may list the same archive multiple times on the command line.
This type of archive searching is standard for Unix linkers. However,
if you are using ld on AIX, note that it is different from the
behaviour of the AIX linker.
-( 옵션을 참고하라.
또, 명령행에서 같은 라이브러리를 여러번 명시해도 된다.
이런 라이브러리 검색은 유닉스 링커의 표준이다. 그러나 AIX의 AIX 링커는
다른 행동을 한다는 것을 유의하라.
-Lsearchdir
--library-path=searchdir
ld will search
for archive libraries and ld control scripts. You may use this
option any number of times. The directories are searched in the order
in which they are specified on the command line. Directories specified
on the command line are searched before the default directories. All
-L options apply to all -l options, regardless of the
order in which the options appear.
The default set of paths searched (without being specified with
`-L') depends on which emulation mode ld is using, and in
some cases also on how it was configured. See section Environment Variables.
The paths can also be specified in a link script with the
SEARCH_DIR command. Directories specified this way are searched
at the point in which the linker script appears in the command line.
ld가 아카이브 라이브러리와 스크립트르르 찾는 패스 목록에
searchdir을 추가한다. 이 옵션은 여러번 사용해도 된다.
디렉토리는 명령행에 주어진 순서로 검색된다. 명령행에 주어진 디렉토리는
기본 디렉토리 전에 검색된다. 모든 -L 옵션은 옵션의 순서와
관계없이 모든 -l 옵션에 적용된다.
기본 패스는 ld가 사용하는 에뮬레이션 모드와 어떻게 구성되었냐에
따라 다르다. Environment Variables를 참고하라.
패스는 링크 스크립트에서 SEARCH_DIR 명령어로도 지정될 수 있다.
이 방식으로 지정된 디렉토리는 명령행에서 링커 스크립트의 위치에서
검색된다.
-memulation
LDEMULATION environment variable, if that is defined.
Otherwise, the default emulation depends upon how the linker was
configured.
LDEMULATION 환경변수가 정의되있다면
이를 사용한다.
정의되있지 않다면 기본 에뮬레이션은 링커가 구성된 방식에 따라 다르다.
-M
--print-map
-n
--nmagic
NMAGIC if possible.
NMAGIC으로 표시한다.
(역주; NMAGIC은 a.out 오브젝트 파일 형식의 일종이다.)
-N
--omagic
OMAGIC.
OMAGIC으로 표시한다.
(역주; OMAGIC은 a.out 오브젝트 파일 형식의 일종이다.)
-o output
--output=output
ld; if this
option is not specified, the name `a.out' is used by default. The
script command OUTPUT can also specify the output file name.
ld의 결과로 생성될 프로그램 이름을 output으로 한다.
이 옵션이 없다면 기본적으로 `a.out'이 사용된다. 스크립트 명령어
OUTPUT도 출력파일 이름을 정한다.
-O level
ld optimizes
the output. This might take significantly longer and therefore probably
should only be enabled for the final binary.
ld는 출력을 최적화한다.
이 과정은 상당히 길 수 있기 때문에 아마도 마지막에 사용된다.
-q
--emit-relocs
-r
--relocateable
ld. This is often called partial
linking. As a side effect, in environments that support standard Unix
magic numbers, this option also sets the output file's magic number to
OMAGIC.
If this option is not specified, an absolute file is produced. When
linking C++ programs, this option will not resolve references to
constructors; to do that, use `-Ur'.
This option does the same thing as `-i'.
ld의 입력으로 사용될 수
있는 출력을 만든다. 이는 보통 부분 링킹이라 불린다. 또한 시스템이 표준
유닉스 매직넘버를 지원한다면 이 옵션은 출력파일의 매직넘버를
OMAGIC으로 한다.
(역주; OMAGIC은 a.out 오브젝트 파일 형식의 일종이다.)
이 옵션이 없다면 절대 파일이 만들어 진다. C++ 프로그램을 링크할 때 이 옵션은
생성자의 참조를 리졸브하지 않는다. 이를 위해서 -R filename
--just-symbols=filename
-R option is
followed by a directory name, rather than a file name, it is treated as
the -rpath option.
-R 옵션 다음에 파일이름 대신
디렉토리 이름이 나올 경우 -rpath 옵션으로 취급된다.
-s
--strip-all
-S
--strip-debug
-t
--trace
ld processes them.
-T scriptfile
--script=scriptfile
ld's default linker script (rather than adding to it), so
commandfile must specify everything necessary to describe the
output file. You must use this option if you want to use a command
which can only appear once in a linker script, such as the
SECTIONS or MEMORY command. See section Linker Scripts. If
scriptfile does not exist in the current directory, ld
looks for it in the directories specified by any preceding `-L'
options. Multiple `-T' options accumulate.
SECTIONS나
MEMORY 명령어와 같이 링커 스크립트에서 단 한번만 사용될 수 있는
명령어를 사용해야 한다면 이 옵션이 필요하다.
Linker Scripts를 참조하라. scriptfile이
현재 디렉토리에 없다면 그 전 `-L' 옵션으로 지정된 디렉토리에서
찾는다. 여러 `-T' 옵션의 내용은 서로 축적된다.
-u symbol
--undefined=symbol
EXTERN linker script command.
EXTERN 명령어도 같은 기능을
한다.
-Ur
ld. When linking C++ programs, `-Ur'
does resolve references to constructors, unlike `-r'.
It does not work to use `-Ur' on files that were themselves linked
with `-Ur'; once the constructor table has been built, it cannot
be added to. Use `-Ur' only for the last partial link, and
`-r' for the others.
--unique[=SECTION]
-v
--version
-V
ld. The -V option also
lists the supported emulations.
ld의 버전을 출력한다. -V 옵션은 지원되는
에뮬레이션도 같이 출력한다.
-x
--discard-all
-X
--discard-locals
-y symbol
--trace-symbol=symbol
-Y path
-z keyword
initfirst, interpose,
loadfltr, nodefaultlib, nodelete, nodlopen,
nodump, now and origin. The other keywords are
ignored for Solaris compatibility. initfirst marks the object
to be initialized first at runtime before any other objects.
interpose marks the object that its symbol table interposes
before all symbols but the primary executable. loadfltr marks
the object that its filtees be processed immediately at runtime.
nodefaultlib marks the object that the search for dependencies
of this object will ignore any default library search paths.
nodelete marks the object shouldn't be unloaded at runtime.
nodlopen marks the object not available to dlopen.
nodump marks the object can not be dumped by dldump.
now marks the object with the non-lazy runtime binding.
origin marks the object may contain $ORIGIN.
defs disallows undefined symbols.
initfirst, interpose,
loadfltr, nodefaultlib, nodelete,
nodlopen, nodump, now, origin
이다. 다른 키워드는 Solaris와 호환을 위한 것으로 무시된다.
initfirst는 객체가 실행 중 다른 객체 보다 먼저 초기화되도록
표시한다. interpose는 객체의 심볼표를 주 실행파일을 제외한
모든 심볼 전에 포함시킨다.
loadfltr는 객체에 실행 중 이 객체로 필터하는 객체가 즉시
처리되게 표시한다. nodefaultlib는 객체의 의존을 검색할 때
기본 라이브러리 검색 패스를 무시하도록 표시한다. nodelete는
객체가 실행 중에 언로드되지 않게 표시한다. nodlopen는
객체가 dlopen로 사용할 수 없게 표시한다. nodump는
객체가 dldump로 덤프될 수 없게 표시한다. now는
객체를 실행 중 레이지바인딩(lazy binding) 하지 않도록 표시한다.
origin은 객체가 $ORGIN을 포함할 수 있다고 표시한다.
defs는 정의되지 않은 심볼을 허용하지 않는다.
-( archives -)
--start-group archives --end-group
-assert keyword
-Bdynamic
-dy
-call_shared
-l options which follow it.
-l 옵션의 라이브러리 검색에 영향을 준다.
-Bgroup
DF_1_GROUP flag in the DT_FLAGS_1 entry in the dynamic
section. This causes the runtime linker to handle lookups in this
object and its dependencies to be performed only inside the group.
--no-undefined is implied. This option is only meaningful on ELF
platforms which support shared libraries.
DT_FLAGS_1 항목에 DF_1_GROUP 플래그를
설정한다. 그래서 실행 중 링커가 이 객체와 의존하는 객체에서 검색을
그룹 안에서만 수행되도록 한다. --no-undefined 옵션은 가정된다.
이 옵션은 공유 라이브러리를 지원하는 ELF 플래폼에서만 의미가 있다.
-Bstatic
-dn
-non_shared
-static
-l options which follow it.
-l 옵션의 라이브러리 검색에 영향을 준다.
-Bsymbolic
--check-sections
--no-check-sections
--cref
--defsym symbol=expression
+ and - to add or subtract hexadecimal
constants or symbols. If you need more elaborate expressions, consider
using the linker command language from a script (see section Assigning Values to Symbols). Note: there should be no white
space between symbol, the equals sign ("="), and
expression.
+, -를 사용할 수 있다. 더 복잡한 연산이 필요하면
링커 명령 언어 스크립트를 (Assigning Values to Symbols
참고) 사용해라. 주의! symbol과 등호 ("="),
expression 사이에 공백이 있으면 안된다.
--demangle[=style]
--no-demangle
--dynamic-linker file
--embedded-relocs
--force-exe-suffix
.exe or .dll suffix, this option forces the linker to copy
the output file to one of the same name with a .exe suffix. This
option is useful when using unmodified Unix makefiles on a Microsoft
Windows host, since some versions of Windows won't run an image unless
it ends in a .exe suffix.
.exe나
.dll 확장자를 가지지 않는다면, 이 옵션은 결과파일을
같은 이름에 .exe 확장자를 가진 파일로 복사한다.
몇몇 Winodws가 .exe 확장자가 없다면 실행파일을 실행하지
못하지 때문에, 이 옵션은 Microsoft Windows에서 유닉스 makefile을
수정하지 않고 사용할 때 유용하다.
--no-gc-sections
--gc-sections
--help
--target-help
-Map mapfile
--no-keep-memory
ld normally optimizes for speed over memory usage by caching the
symbol tables of input files in memory. This option tells ld to
instead optimize for memory usage, by rereading the symbol tables as
necessary. This may be required if ld runs out of memory space
while linking a large executable.
ld는 기본적으로 메모리에 입력파일의 심볼표를 저장하여
(메모리 보다는) 속도에 최적화하여 실행된다. 대신 이 옵션은 필요할 때마다
심볼표를 읽어들여서 메모리 사용을 최소화하게 한다. 이 옵션은 큰 실행파일을
링크할 때 메모리 부족해진다면 필요하다.
--no-undefined
-z defs
--allow-shlib-undefined
--no-warn-mismatch
ld will give an error if you try to link together input
files that are mismatched for some reason, perhaps because they have
been compiled for different processors or for different endiannesses.
This option tells ld that it should silently permit such possible
errors. This option should only be used with care, in cases when you
have taken some special action that ensures that the linker errors are
inappropriate.
ld는 입력파일들이 다른 CPU나 endian을 대상으로 컴파일 된
것과 같은 이유로 입력파일들 간에 불일치가 발견되면 오류를 발생한다.
이 옵션은 이런 오류를 조용히 넘어가게 한다. 이 옵션은
링커의 오류가 부적절한 것임이 확실한 경우에만 주의있게 사용해야 한다.
--no-whole-archive
--whole-archive option for subsequent
archive files.
--whole-archive 옵션 효과를 제거한다.
--noinhibit-exec
--oformat output-format
ld may be configured to support more than one kind of object
file. If your ld is configured this way, you can use the
`--oformat' option to specify the binary format for the output
object file. Even when ld is configured to support alternative
object formats, you don't usually need to specify this, as ld
should be configured to produce as a default output format the most
usual format on each machine. output-format is a text string, the
name of a particular format supported by the BFD libraries. (You can
list the available binary formats with `objdump -i'.) The script
command OUTPUT_FORMAT can also specify the output format, but
this option overrides it. See section BFD.
ld는 여러 종류의 오브젝트 파일 형식을 지원하도록 설정될 수 있다.
이렇게 설정되었다면 `--oformat' 옵션으로 출력 오브젝트 파일의
형식을 지정할 수 있다. 각 컴퓨터에 가장 흔한 형식을 기본 출력 형식으로
사용하기 때문에 이 옵션을 항상 사용할 필요는 없다. output-format는
문자열로 BFD 라이브러리가 지원하는 형식의 이름이다. (사용가능한
형식은 `objdump -i'으로 알 수 있다.) 스크립트 명령어
OUTPUT_FORMAT도 출력 형식을 지정하지만, 이 옵션이
우선순위를 가진다. BFD를 참고하라.
-qmagic
-Qy
--relax
ld and the H8/300.
See section ld and the Intel 960 family.
On some platforms, the `--relax' option performs global
optimizations that become possible when the linker resolves addressing
in the program, such as relaxing address modes and synthesizing new
instructions in the output object file.
On some platforms these link time global optimizations may make symbolic
debugging of the resulting executable impossible.
This is known to be
the case for the Matsushita MN10200 and MN10300 family of processors.
On platforms where this is not supported, `--relax' is accepted,
but ignored.
ld and the H8/300와
ld and the Intel 960 family를
참고하라.
어떤 플래폼에서 `--relax' 옵션은 출력 오브젝트 파일에서
주소형식을 바꾸거나 새로운 명령어를 합성하는 것과 같이 링커가
주소를 리졸브할 때 가능한 전역 최적화를 수행하게 한다.
어떤 플래폼에서 이 전역 최적화는 결과 파일에서 디버그 심볼을
사용할 수 없게 만든다. 예로 Matsushita MN10200와 MN10300 계열이 그러하다.
기타 플래폼에서 이 옵션은 무시된다.
--retain-symbols-file filename
-rpath dir
-rpath
arguments are concatenated and passed to the runtime linker, which uses
them to locate shared objects at runtime. The -rpath option is
also used when locating shared objects which are needed by shared
objects explicitly included in the link; see the description of the
-rpath-link option. If -rpath is not used when linking an
ELF executable, the contents of the environment variable
LD_RUN_PATH will be used if it is defined.
The -rpath option may also be used on SunOS. By default, on
SunOS, the linker will form a runtime search patch out of all the
-L options it is given. If a -rpath option is used, the
runtime search path will be formed exclusively using the -rpath
options, ignoring the -L options. This can be useful when using
gcc, which adds many -L options which may be on NFS mounted
filesystems.
For compatibility with other ELF linkers, if the -R option is
followed by a directory name, rather than a file name, it is treated as
the -rpath option.
-rpath 아규먼트는 모아져서 실행 중 링커가
공유 객체를 찾는데 사용된다. 또 이 옵션은 링크에 명시적으로
포함될 필요가 있는 공유 객체를 지시하는데도 사용된다.
-rpath-link 옵션 설명을 참조하라. ELF 실행파일을
링크할 때 이 옵션이 사용되지 않고 LD_RUN_PATH
환경변수가 정의되있다면 이 환경변수의 내용이 사용된다.
이 옵션은 SunOS에서도 사용할 수 있다. SunOS에서 기본적으로
링커는 주어진 -L 옵션으로 실행 중 검색 패스를
만든다. 이 옵션이 사용되면 -L 옵션은 무시하고,
오직 이 옵션만으로 실행 중 검색 패스를 만든다.
그래서 gcc에서 NFS로 마운트되는 여러 파일시스템을 -L 옵션과
유용하게 사용할 수 있다.
다른 ELF 링커와 호환을 위해 -R 옵션 뒤에 파일이름이
아니라 디렉토리 이름이 올 경우 -rpath 옵션으로 취급한다.
(역주; DYNAMIC 세그먼트에 RPATH 타입의 항목을 추가한다.
(링크 때가 아니라 실행 중) 현재 디렉토리를 나타내는 '.'도 사용가능하다.)
-rpath-link DIR
ld -shared link includes a shared library as one
of the input files.
When the linker encounters such a dependency when doing a non-shared,
non-relocatable link, it will automatically try to locate the required
shared library and include it in the link, if it is not included
explicitly. In such a case, the -rpath-link option
specifies the first set of directories to search. The
-rpath-link option may specify a sequence of directory names
either by specifying a list of names separated by colons, or by
appearing multiple times.
This option should be used with caution as it overrides the search path
that may have been hard compiled into a shared library. In such a case it
is possible to use unintentionally a different search path than the
runtime linker would do.
The linker uses the following search paths to locate required shared
libraries.
ld -shared로 공유 라이브러리를
입력파일에 포함한 경우에 발생한다.
링커가 공유되지 않고 재배치불가능한 링크를 할 때 이런 의존성을
발견하면 (명시되지 않았어도) 필요한 공유 라이브러리를 찾아서
링크에 포함시키려고 한다. 이 경우 이 옵션은 처음으로 검색할
디렉토리 집합을 지정한다. 이 옵션은 각 이름을 `:'으로 분리하거나
옵션을 여러번 사용하여 일련의 디렉토리를 지정한다.
이 옵션은 공유 라이브러리에 쓰여진 검색 패스를 무효로 할 수
있으므로 주의있게 사용해야 한다. 어떤 경우에 의도하지 않게
실행 중 링커와 다른 검색 패스를 사용할 수도 있다.
링커는 필요한 공유 라이브러리를 찾기 위해 다음 검색 패스를 사용한다.
-rpath-link options.
-rpath options. The difference
between -rpath and -rpath-link is that directories
specified by -rpath options are included in the executable and
used at runtime, whereas the -rpath-link option is only effective
at link time. It is for the native linker only.
-rpath and rpath-link options
were not used, search the contents of the environment variable
LD_RUN_PATH. It is for the native linker only.
-rpath option was not used, search any
directories specified using -L options.
LD_LIBRARY_PATH.
DT_RUNPATH or
DT_RPATH of a shared library are searched for shared
libraries needed by it. The DT_RPATH entries are ignored if
DT_RUNPATH entries exist.
-rpath-link 옵션으로 지정된 디렉토리들
-rpath 옵션으로 지정된 디렉토리들. -rpath과
-rpath-link의 차이는 -rpath는 실행파일에
포함되고 실행 중에 사용되는 반면 -rpath-link는 오직 링크 시에
사용된다는 점이다. 이는 기본 링커에만 적용된다.
-rpath과 -rpath-link 옵션이
사용되지 않았다면 환경변수 LD_RUN_PATH의 내용을 검색한다.
이는 기본 링커에만 적용된다.
-rpath가 사용되지 않았다면 -L 옵션으로
주어진 디렉토리를 검색한다.
LD_LIBRARY_PATH의 내용
DT_RUNPATH나
DT_RPATH에 저장된 디렉토리가 검색된다. DT_RUNPATH 항목이
있다면 DT_RPATH 항목은 무시된다.
-shared
-Bshareable
-e option is not used and there are
undefined symbols in the link.
-e 옵션이 사용되지 않고 링크에
정의되지 않은 심볼이 있다면 링커는 자동으로 공유 라이브러리를 만든다.
--sort-common
ld to sort the common symbols by size when it
places them in the appropriate output sections. First come all the one
byte symbols, then all the two bytes, then all the four bytes, and then
everything else. This is to prevent gaps between symbols due to
alignment constraints.
ld가 공통 심볼을 적당한 출력 섹션에 위치할 때
크기 순으로 정렬하게 한다. 1 바이트 심볼들은 처음에 나오고, 다음에
2 바이트의, 다음에 4 바이트의, 등등. 그래서 정렬 제한으로 인한 심볼사이의
공간을 줄인다.
--split-by-file [size]
--split-by-reloc but creates a new output section for
each input file when size is reached. size defaults to a
size of 1 if not given.
--split-by-reloc과 비슷하지만, 각 입력파일에 대해서
size를 넘을 때마다 새로운 출력 섹션을 만든다. size이
주어지지 않으면 1이 사용된다.
--split-by-reloc [count]
--stats
--traditional-format
ld is different in some ways from
the output of some existing linker. This switch requests ld to
use the traditional format instead.
For example, on SunOS, ld combines duplicate entries in the
symbol string table. This can reduce the size of an output file with
full debugging information by over 30 percent. Unfortunately, the SunOS
dbx program can not read the resulting program (gdb has no
trouble). The `--traditional-format' switch tells ld to not
combine duplicate entries.
ld의 출력 방식이 이미 존재하는 링커와
다를 수 있다. 이 옵션은 ld가 대신 전통적인 형식을 사용하게 한다.
SunOS의 예를 들면, ld는 심볼문자열표에 반복되는 항목을
포함한다. 그래서 많은 디버깅 정보를 가진 출력파일의 크기를 30%
이상 줄인다. 그러나 SunOS의 dbx는 이 결과를
읽을 수 없다. (gdb는 문제없다.)
이 경우 `--traditional-format' 옵션은 반복되는 항목을 합치지 않게 한다.
--section-start sectionname=org
-Tbss org
-Tdata org
-Ttext org
bss, data, or the text segment of the output file.
org must be a single hexadecimal integer;
for compatibility with other linkers, you may omit the leading
`0x' usually associated with hexadecimal values.
bss, data,
text 부분의 시작 주소로 사용한다.
다른 링커와 호환을 위해 org는 16 진수 정수이다.
보통 16 진수값과 같이 쓰이는 앞의 `0x'는 생략이
가능하다.
--dll-verbose
--verbose
ld and list the linker emulations
supported. Display which input files can and cannot be opened. Display
the linker script if using a default builtin script.
ld의 버전과 지원하는 링커 에뮬레이션을 출력한다.
입력파일을 열 수 있는지 없는지도 출력한다. 기본 스크립트를
사용한다면 링커 스크립트도 출력한다.
--version-script=version-scriptfile
--warn-common
file(section): warning: common of `symbol' overridden by definition file(section): warning: defined here
file(section): warning: definition of `symbol' overriding common file(section): warning: common is here
file(section): warning: multiple common of `symbol' file(section): warning: previous common is here
file(section): warning: common of `symbol' overridden by larger common file(section): warning: larger common is here
file(section): warning: common of `symbol' overriding smaller common file(section): warning: smaller common is here
file(section): warning: common of `symbol' overridden by definition file(section): warning: defined here
file(section): warning: definition of `symbol' overriding common file(section): warning: common is here
file(section): warning: multiple common of `symbol' file(section): warning: previous common is here
file(section): warning: common of `symbol' overridden by larger common file(section): warning: larger common is here
file(section): warning: common of `symbol' overriding smaller common file(section): warning: smaller common is here
--warn-constructors
--warn-multiple-gp
--warn-once
--warn-section-align
SECTIONS command does not specify a start address for
the section (see section SECTIONS command).
SECTIONS 명령어가 섹션의 시작 주소를 지정하지 않았다면,
주소를 변경한다. (SECTIONS command를 참조하라.)
--whole-archive
--whole-archive option, include every object file in the archive
in the link, rather than searching the archive for the required object
files. This is normally used to turn an archive file into a shared
library, forcing every object to be included in the resulting shared
library. This option may be used more than once.
Two notes when using this option from gcc: First, gcc doesn't know
about this option, so you have to use -Wl,-whole-archive.
Second, don't forget to use -Wl,-no-whole-archive after your
list of archives, because gcc will add its own list of archives to
your link and you may not want this flag to affect those as well.
--wrap symbol
__wrap_symbol. Any
undefined reference to __real_symbol will be resolved to
symbol.
This can be used to provide a wrapper for a system function. The
wrapper function should be called __wrap_symbol. If it
wishes to call the system function, it should call
__real_symbol.
Here is a trivial example:
__wrap_symbol로 리졸브된다.
__real_symbol로 정의되지 않은 참조는 symbol로
리졸브된다.
이 옵션은 시스템 함수에 래퍼를 제공하기 위해서 사용된다. 래퍼 함수는
__wrap_symbol로 호출된다. 시스템 함수를 사용하고
싶다면 __real_symbol을 호출하면 된다.
여기 간단한 예가 있다.
void *
__wrap_malloc (int c)
{
printf ("malloc called with %ld\n", c);
return __real_malloc (c);
}
If you link other code with this file using --wrap malloc, then
all calls to malloc will call the function __wrap_malloc
instead. The call to __real_malloc in __wrap_malloc will
call the real malloc function.
You may wish to provide a __real_malloc function as well, so that
links without the --wrap option will succeed. If you do this,
you should not put the definition of __real_malloc in the same
file as __wrap_malloc; if you do, the assembler may resolve the
call before the linker has a chance to wrap it to malloc.
--wrap malloc을 사용하여 다른 코드와 링크하면
모든 malloc 호출은 대신 __wrap_malloc을 호출한다.
__wrap_malloc에서 __real_malloc은 실제
malloc 함수를 호출한다.
__real_malloc 함수도 만들어서 --wrap 옵션 없이도
링크가 성공하게 할 수 있다. 만약 그렇다면 __real_malloc의 정의를
__wrap_malloc과 같은 파일에 넣지마라. 그렇다면 링커가 이를
malloc으로 래퍼하기 전에 어셈블러가 호출을 가로채서 먼저
리졸브할 수 있다.
--enable-new-dtags
--disable-new-dtags
--enable-new-dtags, the dynamic tags will be created as needed.
If you specify --disable-new-dtags, no new dynamic tags will be
created. By default, the new dynamic tags are not created. Note that
those options are only available for ELF systems.
--enable-new-dtags를 사용하면
필요한 동적 태그가 만들어 진다. --disable-new-dtags를
사용하면 어떠한 새로운 동적 태그도 만들지 않는다. 기본적으로
새로운 동적 태그는 만들지 않는다. 이 옵션은 ELF 시스템에서 제공된다.
The i386 PE linker supports the
i386 PE (역주, win32 portable executable 실행파일 형식) 링커는 출력이
보통 실행파일 대신에 동적 링크 라이브러리로 (DLL)
만드는 -shared option, which causes
the output to be a dynamically linked library (DLL) instead of a
normal executable. You should name the output *.dll when you
use this option. In addition, the linker fully supports the standard
*.def files, which may be specified on the linker command line
like an object file (in fact, it should precede archives it exports
symbols from, to ensure that they get linked in, just like a normal
object file).
-shared 옵션을 지원한다. 이 옵션을 사용할 때
출력 이름을 *.dll로 해야 한다. 추가로 오브젝트 파일과
같이 링커 명령행에 사용할 수 있는 표준 *.def 파일도 지원한다.
(보통 오브젝트 파일과 같이 링크되려면 심볼을 익스포트하는 아카이브 전에
위치해야 한다.)
In addition to the options common to all targets, the i386 PE linker
support additional command line options that are specific to the i386
PE target. Options that take values may be separated from their
values by either a space or an equals sign.
모든 플래폼에 공통인 옵션에 추가로 i386 PE 링커 특유의 옵션이 있다.
값을 받는 옵션은 값과 공백이나 등호로 연결된다.
--add-stdcall-alias
--base-file file
--dll
-shared or specify a LIBRARY in a given .def
file.
-shared나
.def 파일에서 LIBRARY를 지정해도 된다.
--enable-stdcall-fixup
--disable-stdcall-fixup
_foo might be linked to the function
_foo@12, or the undefined symbol _bar@16 might be linked
to the function _bar. When the linker does this, it prints a
warning, since it normally should have failed to link, but sometimes
import libraries generated from third-party dlls may need this feature
to be usable. If you specify --enable-stdcall-fixup, this
feature is fully enabled and warnings are not printed. If you specify
--disable-stdcall-fixup, this feature is disabled and such
mismatches are considered to be errors.
_foo은
함수 _foo@12에, 정의되지 않은 심볼 _bar@16는
함수 _bar로 링크될 수 있다. 이런 경우 보통 링크는 찾지못하기
때문에 경고를 출력한다. 그러나 다른 회사의
dll로 생성한 라이브러리를 임포트하는 경우 이 기능이 유용할 수 있다.
--enable-stdcall-fixup이 사용되면 이 기능이 작동하고
경고는 출력되지 않는다. --disable-stdcall-fixup이 사용되면
이 기능은 작동하지 않고, 이런 불일치는 오류로 간주된다.
--export-all-symbols
DllMain@12,
DllEntryPoint@0, and impure_ptr will not be automatically
exported.
DllMain@12,
DllEntryPoint@0, impure_ptr는 자동으로
익스포트되지 않는다.
--exclude-symbols symbol,symbol,...
--file-alignment
--heap reserve
--heap reserve,commit
--image-base value
--kill-at
--major-image-version value
--major-os-version value
--major-subsystem-version value
--minor-image-version value
--minor-os-version value
--minor-subsystem-version value
--output-def file
*.def) may be used to create an import
library with dlltool or may be used as a reference to
automatically or implicitly exported symbols.
*.def) dlltool로 임포트
라이브러리를 만들거나, 자동 혹은 암시적으로 익스포트된 심볼을 참조할 때 사용된다.
--section-alignment
--stack reserve
--stack reserve,commit
--subsystem which
--subsystem which:major
--subsystem which:major.minor
native, windows,
console, and posix. You may optionally set the
subsystem version also.
native, windows, console,
posix이다. 또한 선택적으로 서브시스템 버전을 설정할 수도 있다.
You can change the behavior of
ld with the environment variables
GNUTARGET, LDEMULATION, and COLLECT_NO_DEMANGLE.
ld의 행동을 환경변수 GNUTARGET, LDEMULATION,
COLLECT_NO_DEMANGLE로 조정할 수 있다.
GNUTARGET determines the input-file object format if you don't
use `-b' (or its synonym `--format'). Its value should be one
of the BFD names for an input format (see section BFD). If there is no
GNUTARGET in the environment, ld uses the natural format
of the target. If GNUTARGET is set to default then BFD
attempts to discover the input format by examining binary input files;
this method often succeeds, but there are potential ambiguities, since
there is no method of ensuring that the magic number used to specify
object-file formats is unique. However, the configuration procedure for
BFD on each system places the conventional format for that system first
in the search-list, so ambiguities are resolved in favor of convention.
GNUTARGET은 `-b' (나 `--format') 옵션이
사용되지 않은 경우 입력파일의 형식을 지정한다. 이 값은 입력 형식에 대한 BFD
이름이어야 한다. (BFD를 참조하라.)
만약 GNUTARGET 환경변수가 없다면 플래폼의 기본 형식을 사용한다.
GNUTARGET가 default로 설정되었다면 BFD는
입력파일을 살펴보고 형식을 알아내려고 시도한다. 보통 이 방법은 성공하나
매직넘버가 오브젝트 파일 형식을 결정하지 못하여 모호할 경우도 있다.
그러나 각 시스템에서 BFD를 설정할 때 자주 사용되는 형식을 검색 목록 앞에
위치하여 모호함을 해결한다.
LDEMULATION determines the default emulation if you don't use the
`-m' option. The emulation can affect various aspects of linker
behaviour, particularly the default linker script. You can list the
available emulations with the `--verbose' or `-V' options. If
the `-m' option is not used, and the LDEMULATION environment
variable is not defined, the default emulation depends upon how the
linker was configured.
LDEMULATION는 `-m' 옵션이 사용되지 않았을 때
기본 에뮬레이션을 지정한다. 에뮬레이션은 링커의 여러 행동에, 특히 기본
링커 스크립트에 영향을 준다. 사용 가능한 에뮬레이션은 `--verbose'나
`-V' 옵션으로 확인할 수 있다. `-m' 옵션을 사용하지 않고
환경변수 LDEMULATION가 없다면 링커가 구성된 방법에 따라
기본 에뮬레이션이 결정된다.
Normally, the linker will default to demangling symbols. However, if
COLLECT_NO_DEMANGLE is set in the environment, then it will
default to not demangling symbols. This environment variable is used in
a similar fashion by the gcc linker wrapper program. The default
may be overridden by the `--demangle' and `--no-demangle'
options.
보통 링커는 기본적으로 심볼을 디맹글링한다. 그러나 환경변수
COLLECT_NO_DEMANGLE가 있다면 자동으로 심볼을 디맹글링하지
않는다. gcc(링커 래퍼 프로그램)도 이 환경변수를 사용한다.
기본값은 `--demangle'나 `--no-demangle'로
무시할 수 있다.
Go to the first, previous, next, last section, table of contents.