Go to the first, previous, next, last section, table of contents.

DLL을 만들고 사용하는데 필요한 파일을 만들기

dlltool may be used to create the files needed to build and use dynamic link libraries (DLLs).
dlltool은 동적 링크 라이브러리(DLL)을 만들고 사용하는데 필요한 파일을 만든다.

Warning: dlltool is not always built as part of the binary utilities, since it is only useful for those targets which support DLLs.
경고: dlltool은 DLL을 지원하는 타겟에서만 사용하기 때문에 컴파일시 생성되지 않을 수 있다.

dlltool [-d|--input-def def-file-name]
        [-b|--base-file base-file-name]
        [-e|--output-exp exports-file-name]
        [-z|--output-def def-file-name]
        [-l|--output-lib library-file-name]        
        [--export-all-symbols] [--no-export-all-symbols]
        [--exclude-symbols list]
        [--no-default-excludes]
        [-S|--as path-to-assembler] [-f|--as-flags options]
        [-D|--dllname name] [-m|--machine machine]
        [-a|--add-indirect] [-U|--add-underscore] [-k|--kill-at]
        [-A|--add-stdcall-alias]
        [-x|--no-idata4] [-c|--no-idata5] [-i|--interwork]
        [-n|--nodelete] [-v|--verbose] [-h|--help] [-V|--version]
        [object-file ...]

dlltool reads its inputs, which can come from the `-d' and `-b' options as well as object files specified on the command line. It then processes these inputs and if the `-e' option has been specified it creates a exports file. If the `-l' option has been specified it creates a library file and if the `-z' option has been specified it creates a def file. Any or all of the -e, -l and -z options can be present in one invocation of dlltool.

When creating a DLL, along with the source for the DLL, it is necessary to have three other files. dlltool can help with the creation of these files.

dlltool은 명령행과 `-d', `-b' 옵션으로 입력을 받는다. 입력을 처리한 후, `-e' 옵션을 사용하면 익스포트 파일을 만든다. `-l' 옵션은 라이브러리 파일(.lib 파일)을, `-z' 옵션은 def 파일을 만든다. -e, -l, -z 옵션은 같이 사용할 수 있다.

DLL 파일을 만들 때 DLL을 위한 소스 외에 3 파일이 필요하다. dlltool는 이 파일을 만드는 것을 도와준다.

The first file is a `.def' file which specifies which functions are exported from the DLL, which functions the DLL imports, and so on. This is a text file and can be created by hand, or dlltool can be used to create it using the `-z' option. In this case dlltool will scan the object files specified on its command line looking for those functions which have been specially marked as being exported and put entries for them in the .def file it creates.

In order to mark a function as being exported from a DLL, it needs to have an `-export:<name_of_function>' entry in the `.drectve' section of the object file. This can be done in C by using the asm() operator:
첫번째 파일은 DLL이 어떤 함수를 익스포트하고 임포트하는지를 설명하는 `.def' 파일이다. 이는 일반 텍스트 파일로 `-z' 옵션으로 만들 수 있다. 이 경우 dlltool는 명령행에 주어진 오브젝트 파일들에서 명시적으로 익스포트되는 함수를 찾아 .def 파일에 포함한다.

DLL에서 함수가 익스포트됨을 명시적으로 알기기 위해서 오브젝트 파일의 `.drectve' 섹션에 `-export:<name_of_function>' 항목이 필요하다. 이는 다음과 같이 C에서 asm() 연산자를 사용하여 가능하다.

  asm (".section .drectve");  
  asm (".ascii \"-export:my_func\"");

  int my_func (void) { ... }

The second file needed for DLL creation is an exports file. This file is linked with the object files that make up the body of the DLL and it handles the interface between the DLL and the outside world. This is a binary file and it can be created by giving the `-e' option to dlltool when it is creating or reading in a .def file.

The third file needed for DLL creation is the library file that programs will link with in order to access the functions in the DLL. This file can be created by giving the `-l' option to dlltool when it is creating or reading in a .def file.
DLL을 만드는데 필요한 두번째 파일은 익스포트 파일이다. 이 파일은 DLL을 이루는 오브젝트 파일과 링크되어 DLL과 외부 사이의 인터페이스를 다룬다. 이는 이진 파일이고, .def 파일을 만들거나 읽을 때 `-e' 옵션으로 만들 수 있다.

세번째 파일은 DLL 함수에 접근하기 위해서 링크되는 프로그램인 라이브러리 파일이다. 이 파일은 .def 파일을 만들거나 읽을 때 `-l' 옵션으로 만들 수 있다.

dlltool builds the library file by hand, but it builds the exports file by creating temporary files containing assembler statements and then assembling these. The `-S' command line option can be used to specify the path to the assembler that dlltool will use, and the `-f' option can be used to pass specific flags to that assembler. The `-n' can be used to prevent dlltool from deleting these temporary assembler files when it is done, and if `-n' is specified twice then this will prevent dlltool from deleting the temporary object files it used to build the library.

Here is an example of creating a DLL from a source file `dll.c' and also creating a program (from an object file called `program.o') that uses that DLL:
dlltool은 직접 라이브러리 파일을 만들지만, 익스포트 파일은 어셈블리 문장을 담은 임시 파일을 만들고 이를 어셈블하여 만든다. `-S' 옵션은 사용할 어셈블러의 경로를 지정하고, `-f' 옵션은 어셈블러에 줄 옵션을 지정한다. `-n'은 임시 어셈블리 파일을 삭제하지 않게 하고, `-n'을 두번 사용하면 라이브러리 파일을 만드는데 사용한 임시 파일들을 삭제하지 않는다.

다음은 `dll.c'로 DLL을 만들고, 이 DLL을 사용하는 (`program.o'라는 오브젝트 파일에서) 프로그램을 만드는 예이다.

  gcc -c dll.c
  dlltool -e exports.o -l dll.lib dll.o
  gcc dll.o exports.o -o dll.dll
  gcc program.o dll.lib -o program

The command line options have the following meanings:

명령행 옵션들은 다음과 같다.

-d filename
--input-def filename: Specifies the name of a .def file to be read in and processed.
읽고 처리할 .def 파일 이름을 지정한다.
-b filename
--base-file filename: Specifies the name of a base file to be read in and processed. The contents of this file will be added to the relocation section in the exports file generated by dlltool.
읽고 처리할 베이스 파일 이름을 지정한다. 파일 내용은 dlltool이 생성하는 익스포트 파일의 재배치 섹션에 추가된다.
-e filename
--output-exp filename: Specifies the name of the export file to be created by dlltool.
생성할 익스포트 파일 이름을 지정한다.
-z filename
--output-def filename: Specifies the name of the .def file to be created by dlltool.
생성할 .def 파일 이름을 지정한다.
-l filename
--output-lib filename: Specifies the name of the library file to be created by dlltool.
생성할 라이브러리 파일 이름을 지정한다.
--export-all-symbols: Treat all global and weak defined symbols found in the input object files as symbols to be exported. There is a small list of symbols which are not exported by default; see the --no-default-excludes option. You may add to the list of symbols to not export by using the --exclude-symbols option.
입력 오브젝트 파일의 모든 정의된 전역 심볼과 약한 심볼을 익스포트한다. 기본으로 익스포트되지 않는 심볼들이 조금 있다. --no-default-excludes를 참고하라. --exclude-symbols 옵션을 사용하여 추가로 심볼들을 익스포트하지 않게 할 수 있다.
--no-export-all-symbols: Only export symbols explicitly listed in an input .def file or in `.drectve' sections in the input object files. This is the default behaviour. The `.drectve' sections are created by `dllexport' attributes in the source code.
명시적으로 .def 파일이나 입력 오브젝트 파일의 `.drectve' 섹션에 지정된 심볼만 익스포트한다. 이는 기본 행동이다. `.drectve' 섹션은 소스 코드에서 `dllexport' 속성으로 만든다.
--exclude-symbols list: Do not export the symbols in list. This is a list of symbol names separated by comma or colon characters. The symbol names should not contain a leading underscore. This is only meaningful when --export-all-symbols is used.
list의 심볼들을 익스포트하지 않는다. 목록에서 심볼 이름은 `,'나 `:'으로 구분된다. 심볼 이름은 앞에 `_'을 포함할 수 없다. 이 옵션은 --export-all-symbols을 사용했을 때만 의미가 있다.
--no-default-excludes: When --export-all-symbols is used, it will by default avoid exporting certain special symbols. The current list of symbols to avoid exporting is `DllMain@12', `DllEntryPoint@0', `impure_ptr'. You may use the --no-default-excludes option to go ahead and export these special symbols. This is only meaningful when --export-all-symbols is used.
--export-all-symbols를 사용하면 기본으로 어떤 특별한 심볼은 익스포트하지 않는다. 이 목록은 현재 `DllMain@12', `DllEntryPoint@0', `impure_ptr'이다. --no-default-excludes 옵션으로 이들까지도 익스포트할 수 있다. 이 옵션은 --export-all-symbols을 사용했을 때만 의미가 있다.
-S path
--as path: Specifies the path, including the filename, of the assembler to be used to create the exports file.
익스포트 파일을 만들 때 사용하는 어셈블러의 (파일명을 포함한) 경로를 지정한다.
-f switches
--as-flags switches: Specifies any specific command line switches to be passed to the assembler when building the exports file. This option will work even if the `-S' option is not used. This option only takes one argument, and if it occurs more than once on the command line, then later occurrences will override earlier occurrences. So if it is necessary to pass multiple switches to the assembler they should be enclosed in double quotes.
익스포트 파일을 만들 때 어셈블러에 주어질 옵션을 지정한다. 이 옵션은 `-S' 옵션이 없어도 가능하다. 이 옵션은 오직 한 아규먼트만 받는다. 옵션을 여러번 사용하면 나중 것이 앞의 것을 대체한다. 그래서 어셈블러에 여러 옵션을 넘겨주려면 쌍따옴표로 묶어줘야 한다.
-D name
--dll-name name: Specifies the name to be stored in the .def file as the name of the DLL when the `-e' option is used. If this option is not present, then the filename given to the `-e' option will be used as the name of the DLL.
`-e' 옵션을 사용할 때 .def 파일에 저장할 DLL 이름을 지정한다. 이 옵션을 사용하지 않으면 `-e' 옵션에 주어진 이름이 DLL 이름이 된다.
-m machine
-machine machine: Specifies the type of machine for which the library file should be built. dlltool has a built in default type, depending upon how it was created, but this option can be used to override that. This is normally only useful when creating DLLs for an ARM processor, when the contents of the DLL are actually encode using THUMB instructions.
라이브러리 파일이 만들어질 컴퓨터 타입을 지정한다. dlltool은 컴파일 때 결정되는 기본 타입이 있지만, 이 옵션으로 대체할 수 있다. 보통 DLL의 내용이 THUMB 명령어로 된, ARM 프로세서를 위한 DLL을 생성할 때만 유용하다.
-a
--add-indirect: Specifies that when dlltool is creating the exports file it should add a section which allows the exported functions to be referenced without using the import library. Whatever the hell that means!
익스포트 파일을 만들 때, 임포트 라이브러리 없이 익스포트된 함수를 참조할 수 있게 하는 섹션을 추가한다. 도대체 이게 무슨 말이야!
-U
--add-underscore: Specifies that when dlltool is creating the exports file it should prepend an underscore to the names of the exported functions.
익스포트 파일을 만들 때, 익스포트되는 함수 이름 앞에 `_'을 붙인다.
-k
--kill-at: Specifies that when dlltool is creating the exports file it should not append the string `@ <number>'. These numbers are called ordinal numbers and they represent another way of accessing the function in a DLL, other than by name.
익스포트 파일을 만들 때, 이름 뒤에 `@ <number>'을 붙인다. 이 숫자는 ordinal number라 하며, DLL 함수를 이름 외의 방법으로 접근할 때 쓰인다.
-A
--add-stdcall-alias: Specifies that when dlltool is creating the exports file it should add aliases for stdcall symbols without `@ <number>' in addition to the symbols with `@ <number>'.
익스포트 파일을 만들 때, `@ <number>'를 가진 심볼에 `@ <number>'이 없는 stdcall 심볼을 위한 별명을 붙인다.
-x
--no-idata4: Specifies that when dlltool is creating the exports and library files it should omit the .idata4 section. This is for compatibility with certain operating systems.
익스포트 파일과 라이브러리 파일을 만들 때, .idata4 섹션을 생략한다. 이는 어떤 운영체제에서 호환성을 위한 것이다.
-c
--no-idata5: Specifies that when dlltool is creating the exports and library files it should omit the .idata5 section. This is for compatibility with certain operating systems.
익스포트 파일과 라이브러리 파일을 만들 때, .idata5 섹션을 생략한다. 이는 어떤 운영체제에서 호환성을 위한 것이다.
-i
--interwork: Specifies that dlltool should mark the objects in the library file and exports file that it produces as supporting interworking between ARM and THUMB code.
ARM과 THUMB 코드를 결합하기 위해 생성된 라이브러리 파일과 익스포트 파일에서 객체에 표시를 한다.
-n
--nodelete: Makes dlltool preserve the temporary assembler files it used to create the exports file. If this option is repeated then dlltool will also preserve the temporary object files it uses to create the library file.
익스포트 파일을 만드는데 쓰인 임시 어셈블리 파일을 보존한다. 이 옵션이 반복되면 라이브러리 파일을 만드는데 사용한 임시 객체들도 보존한다.
-v
--verbose: Make dlltool describe what it is doing.
dlltool이 하고 있는 작업을 출력한다.
-h
--help: Displays a list of command line options and then exits.
명령행 옵션을 간단히 설명하고 종료한다.
-V
--version: Displays dlltool's version number and then exits.
dlltool의 버전을 출력하고 종료한다.

Go to the first, previous, next, last section, table of contents.