← Back to branch summary

~ubuntu-branches/ubuntu/utopic/binutils-arm64-cross/utopic

« back to all changes in this revision

Viewing changes to binutils-2.23.52.20130611/builddir-aarch64-linux-gnu/binutils/doc/dlltool.1

  • Committer: Package Import Robot
  • Author(s): Matthias Klose
  • Date: 2013-06-20 17:38:09 UTC
  • Revision ID: package-import@ubuntu.com-20130620173809-app8lzgvymy5fg6c
Tags: 0.7
Build-depend on binutils-source (>= 2.23.52.20130620-1~).

Show diffs side-by-side

added added

removed removed

Lines of Context:
binutils-2.23.52.20130611/builddir-aarch64-linux-gnu/binutils/doc/dlltool.1
 
1
.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
 
2
.\"
 
3
.\" Standard preamble:
 
4
.\" ========================================================================
 
5
.de Sp \" Vertical space (when we can't use .PP)
 
6
.if t .sp .5v
 
7
.if n .sp
 
8
..
 
9
.de Vb \" Begin verbatim text
 
10
.ft CW
 
11
.nf
 
12
.ne \\$1
 
13
..
 
14
.de Ve \" End verbatim text
 
15
.ft R
 
16
.fi
 
17
..
 
18
.\" Set up some character translations and predefined strings.  \*(-- will
 
19
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
 
20
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
 
21
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
 
22
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
 
23
.\" nothing in troff, for use with C<>.
 
24
.tr \(*W-
 
25
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 
26
.ie n \{\
 
27
.    ds -- \(*W-
 
28
.    ds PI pi
 
29
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
 
30
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
 
31
.    ds L" ""
 
32
.    ds R" ""
 
33
.    ds C` ""
 
34
.    ds C' ""
 
35
'br\}
 
36
.el\{\
 
37
.    ds -- \|\(em\|
 
38
.    ds PI \(*p
 
39
.    ds L" ``
 
40
.    ds R" ''
 
41
'br\}
 
42
.\"
 
43
.\" Escape single quotes in literal strings from groff's Unicode transform.
 
44
.ie \n(.g .ds Aq \(aq
 
45
.el       .ds Aq '
 
46
.\"
 
47
.\" If the F register is turned on, we'll generate index entries on stderr for
 
48
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
 
49
.\" entries marked with X<> in POD.  Of course, you'll have to process the
 
50
.\" output yourself in some meaningful fashion.
 
51
.ie \nF \{\
 
52
.    de IX
 
53
.    tm Index:\\$1\t\\n%\t"\\$2"
 
54
..
 
55
.    nr % 0
 
56
.    rr F
 
57
.\}
 
58
.el \{\
 
59
.    de IX
 
60
..
 
61
.\}
 
62
.\"
 
63
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 
64
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
 
65
.    \" fudge factors for nroff and troff
 
66
.if n \{\
 
67
.    ds #H 0
 
68
.    ds #V .8m
 
69
.    ds #F .3m
 
70
.    ds #[ \f1
 
71
.    ds #] \fP
 
72
.\}
 
73
.if t \{\
 
74
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
 
75
.    ds #V .6m
 
76
.    ds #F 0
 
77
.    ds #[ \&
 
78
.    ds #] \&
 
79
.\}
 
80
.    \" simple accents for nroff and troff
 
81
.if n \{\
 
82
.    ds ' \&
 
83
.    ds ` \&
 
84
.    ds ^ \&
 
85
.    ds , \&
 
86
.    ds ~ ~
 
87
.    ds /
 
88
.\}
 
89
.if t \{\
 
90
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 
91
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 
92
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 
93
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 
94
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 
95
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 
96
.\}
 
97
.    \" troff and (daisy-wheel) nroff accents
 
98
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 
99
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 
100
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 
101
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 
102
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 
103
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 
104
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 
105
.ds ae a\h'-(\w'a'u*4/10)'e
 
106
.ds Ae A\h'-(\w'A'u*4/10)'E
 
107
.    \" corrections for vroff
 
108
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 
109
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 
110
.    \" for low resolution devices (crt and lpr)
 
111
.if \n(.H>23 .if \n(.V>19 \
 
112
\{\
 
113
.    ds : e
 
114
.    ds 8 ss
 
115
.    ds o a
 
116
.    ds d- d\h'-1'\(ga
 
117
.    ds D- D\h'-1'\(hy
 
118
.    ds th \o'bp'
 
119
.    ds Th \o'LP'
 
120
.    ds ae ae
 
121
.    ds Ae AE
 
122
.\}
 
123
.rm #[ #] #H #V #F C
 
124
.\" ========================================================================
 
125
.\"
 
126
.IX Title "DLLTOOL 1"
 
127
.TH DLLTOOL 1 "2013-06-11" "binutils-2.23.52" "GNU Development Tools"
 
128
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 
129
.\" way too many mistakes in technical documents.
 
130
.if n .ad l
 
131
.nh
 
132
.SH "NAME"
 
133
dlltool \- Create files needed to build and use DLLs.
 
134
.SH "SYNOPSIS"
 
135
.IX Header "SYNOPSIS"
 
136
dlltool [\fB\-d\fR|\fB\-\-input\-def\fR \fIdef-file-name\fR]
 
137
        [\fB\-b\fR|\fB\-\-base\-file\fR \fIbase-file-name\fR]
 
138
        [\fB\-e\fR|\fB\-\-output\-exp\fR \fIexports-file-name\fR]
 
139
        [\fB\-z\fR|\fB\-\-output\-def\fR \fIdef-file-name\fR]
 
140
        [\fB\-l\fR|\fB\-\-output\-lib\fR \fIlibrary-file-name\fR]
 
141
        [\fB\-y\fR|\fB\-\-output\-delaylib\fR \fIlibrary-file-name\fR]
 
142
        [\fB\-\-export\-all\-symbols\fR] [\fB\-\-no\-export\-all\-symbols\fR]
 
143
        [\fB\-\-exclude\-symbols\fR \fIlist\fR]
 
144
        [\fB\-\-no\-default\-excludes\fR]
 
145
        [\fB\-S\fR|\fB\-\-as\fR \fIpath-to-assembler\fR] [\fB\-f\fR|\fB\-\-as\-flags\fR \fIoptions\fR]
 
146
        [\fB\-D\fR|\fB\-\-dllname\fR \fIname\fR] [\fB\-m\fR|\fB\-\-machine\fR \fImachine\fR]
 
147
        [\fB\-a\fR|\fB\-\-add\-indirect\fR]
 
148
        [\fB\-U\fR|\fB\-\-add\-underscore\fR] [\fB\-\-add\-stdcall\-underscore\fR]
 
149
        [\fB\-k\fR|\fB\-\-kill\-at\fR] [\fB\-A\fR|\fB\-\-add\-stdcall\-alias\fR]
 
150
        [\fB\-p\fR|\fB\-\-ext\-prefix\-alias\fR \fIprefix\fR]
 
151
        [\fB\-x\fR|\fB\-\-no\-idata4\fR] [\fB\-c\fR|\fB\-\-no\-idata5\fR]
 
152
        [\fB\-\-use\-nul\-prefixed\-import\-tables\fR]
 
153
        [\fB\-I\fR|\fB\-\-identify\fR \fIlibrary-file-name\fR] [\fB\-\-identify\-strict\fR]
 
154
        [\fB\-i\fR|\fB\-\-interwork\fR]
 
155
        [\fB\-n\fR|\fB\-\-nodelete\fR] [\fB\-t\fR|\fB\-\-temp\-prefix\fR \fIprefix\fR]
 
156
        [\fB\-v\fR|\fB\-\-verbose\fR]
 
157
        [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
 
158
        [\fB\-\-no\-leading\-underscore\fR] [\fB\-\-leading\-underscore\fR]
 
159
        [object\-file ...]
 
160
.SH "DESCRIPTION"
 
161
.IX Header "DESCRIPTION"
 
162
\&\fBdlltool\fR reads its inputs, which can come from the \fB\-d\fR and
 
163
\&\fB\-b\fR options as well as object files specified on the command
 
164
line.  It then processes these inputs and if the \fB\-e\fR option has
 
165
been specified it creates a exports file.  If the \fB\-l\fR option
 
166
has been specified it creates a library file and if the \fB\-z\fR option
 
167
has been specified it creates a def file.  Any or all of the \fB\-e\fR,
 
168
\&\fB\-l\fR and \fB\-z\fR options can be present in one invocation of
 
169
dlltool.
 
170
.PP
 
171
When creating a \s-1DLL\s0, along with the source for the \s-1DLL\s0, it is necessary
 
172
to have three other files.  \fBdlltool\fR can help with the creation of
 
173
these files.
 
174
.PP
 
175
The first file is a \fI.def\fR file which specifies which functions are
 
176
exported from the \s-1DLL\s0, which functions the \s-1DLL\s0 imports, and so on.  This
 
177
is a text file and can be created by hand, or \fBdlltool\fR can be used
 
178
to create it using the \fB\-z\fR option.  In this case \fBdlltool\fR
 
179
will scan the object files specified on its command line looking for
 
180
those functions which have been specially marked as being exported and
 
181
put entries for them in the \fI.def\fR file it creates.
 
182
.PP
 
183
In order to mark a function as being exported from a \s-1DLL\s0, it needs to
 
184
have an \fB\-export:<name_of_function>\fR entry in the \fB.drectve\fR
 
185
section of the object file.  This can be done in C by using the
 
186
\&\fIasm()\fR operator:
 
187
.PP
 
188
.Vb 2
 
189
\&          asm (".section .drectve");
 
190
\&          asm (".ascii \e"\-export:my_func\e"");
 
191
\&        
 
192
\&          int my_func (void) { ... }
 
193
.Ve
 
194
.PP
 
195
The second file needed for \s-1DLL\s0 creation is an exports file.  This file
 
196
is linked with the object files that make up the body of the \s-1DLL\s0 and it
 
197
handles the interface between the \s-1DLL\s0 and the outside world.  This is a
 
198
binary file and it can be created by giving the \fB\-e\fR option to
 
199
\&\fBdlltool\fR when it is creating or reading in a \fI.def\fR file.
 
200
.PP
 
201
The third file needed for \s-1DLL\s0 creation is the library file that programs
 
202
will link with in order to access the functions in the \s-1DLL\s0 (an `import
 
203
library').  This file can be created by giving the \fB\-l\fR option to
 
204
dlltool when it is creating or reading in a \fI.def\fR file.
 
205
.PP
 
206
If the \fB\-y\fR option is specified, dlltool generates a delay-import
 
207
library that can be used instead of the normal import library to allow
 
208
a program to link to the dll only as soon as an imported function is
 
209
called for the first time. The resulting executable will need to be
 
210
linked to the static delayimp library containing _\|\fI_delayLoadHelper2()\fR,
 
211
which in turn will import LoadLibraryA and GetProcAddress from kernel32.
 
212
.PP
 
213
\&\fBdlltool\fR builds the library file by hand, but it builds the
 
214
exports file by creating temporary files containing assembler statements
 
215
and then assembling these.  The \fB\-S\fR command line option can be
 
216
used to specify the path to the assembler that dlltool will use,
 
217
and the \fB\-f\fR option can be used to pass specific flags to that
 
218
assembler.  The \fB\-n\fR can be used to prevent dlltool from deleting
 
219
these temporary assembler files when it is done, and if \fB\-n\fR is
 
220
specified twice then this will prevent dlltool from deleting the
 
221
temporary object files it used to build the library.
 
222
.PP
 
223
Here is an example of creating a \s-1DLL\s0 from a source file \fBdll.c\fR and
 
224
also creating a program (from an object file called \fBprogram.o\fR)
 
225
that uses that \s-1DLL:\s0
 
226
.PP
 
227
.Vb 4
 
228
\&          gcc \-c dll.c
 
229
\&          dlltool \-e exports.o \-l dll.lib dll.o
 
230
\&          gcc dll.o exports.o \-o dll.dll
 
231
\&          gcc program.o dll.lib \-o program
 
232
.Ve
 
233
.PP
 
234
\&\fBdlltool\fR may also be used to query an existing import library
 
235
to determine the name of the \s-1DLL\s0 to which it is associated.  See the
 
236
description of the \fB\-I\fR or \fB\-\-identify\fR option.
 
237
.SH "OPTIONS"
 
238
.IX Header "OPTIONS"
 
239
The command line options have the following meanings:
 
240
.IP "\fB\-d\fR \fIfilename\fR" 4
 
241
.IX Item "-d filename"
 
242
.PD 0
 
243
.IP "\fB\-\-input\-def\fR \fIfilename\fR" 4
 
244
.IX Item "--input-def filename"
 
245
.PD
 
246
Specifies the name of a \fI.def\fR file to be read in and processed.
 
247
.IP "\fB\-b\fR \fIfilename\fR" 4
 
248
.IX Item "-b filename"
 
249
.PD 0
 
250
.IP "\fB\-\-base\-file\fR \fIfilename\fR" 4
 
251
.IX Item "--base-file filename"
 
252
.PD
 
253
Specifies the name of a base file to be read in and processed.  The
 
254
contents of this file will be added to the relocation section in the
 
255
exports file generated by dlltool.
 
256
.IP "\fB\-e\fR \fIfilename\fR" 4
 
257
.IX Item "-e filename"
 
258
.PD 0
 
259
.IP "\fB\-\-output\-exp\fR \fIfilename\fR" 4
 
260
.IX Item "--output-exp filename"
 
261
.PD
 
262
Specifies the name of the export file to be created by dlltool.
 
263
.IP "\fB\-z\fR \fIfilename\fR" 4
 
264
.IX Item "-z filename"
 
265
.PD 0
 
266
.IP "\fB\-\-output\-def\fR \fIfilename\fR" 4
 
267
.IX Item "--output-def filename"
 
268
.PD
 
269
Specifies the name of the \fI.def\fR file to be created by dlltool.
 
270
.IP "\fB\-l\fR \fIfilename\fR" 4
 
271
.IX Item "-l filename"
 
272
.PD 0
 
273
.IP "\fB\-\-output\-lib\fR \fIfilename\fR" 4
 
274
.IX Item "--output-lib filename"
 
275
.PD
 
276
Specifies the name of the library file to be created by dlltool.
 
277
.IP "\fB\-y\fR \fIfilename\fR" 4
 
278
.IX Item "-y filename"
 
279
.PD 0
 
280
.IP "\fB\-\-output\-delaylib\fR \fIfilename\fR" 4
 
281
.IX Item "--output-delaylib filename"
 
282
.PD
 
283
Specifies the name of the delay-import library file to be created by dlltool.
 
284
.IP "\fB\-\-export\-all\-symbols\fR" 4
 
285
.IX Item "--export-all-symbols"
 
286
Treat all global and weak defined symbols found in the input object
 
287
files as symbols to be exported.  There is a small list of symbols which
 
288
are not exported by default; see the \fB\-\-no\-default\-excludes\fR
 
289
option.  You may add to the list of symbols to not export by using the
 
290
\&\fB\-\-exclude\-symbols\fR option.
 
291
.IP "\fB\-\-no\-export\-all\-symbols\fR" 4
 
292
.IX Item "--no-export-all-symbols"
 
293
Only export symbols explicitly listed in an input \fI.def\fR file or in
 
294
\&\fB.drectve\fR sections in the input object files.  This is the default
 
295
behaviour.  The \fB.drectve\fR sections are created by \fBdllexport\fR
 
296
attributes in the source code.
 
297
.IP "\fB\-\-exclude\-symbols\fR \fIlist\fR" 4
 
298
.IX Item "--exclude-symbols list"
 
299
Do not export the symbols in \fIlist\fR.  This is a list of symbol names
 
300
separated by comma or colon characters.  The symbol names should not
 
301
contain a leading underscore.  This is only meaningful when
 
302
\&\fB\-\-export\-all\-symbols\fR is used.
 
303
.IP "\fB\-\-no\-default\-excludes\fR" 4
 
304
.IX Item "--no-default-excludes"
 
305
When \fB\-\-export\-all\-symbols\fR is used, it will by default avoid
 
306
exporting certain special symbols.  The current list of symbols to avoid
 
307
exporting is \fBDllMain@12\fR, \fBDllEntryPoint@0\fR,
 
308
\&\fBimpure_ptr\fR.  You may use the \fB\-\-no\-default\-excludes\fR option
 
309
to go ahead and export these special symbols.  This is only meaningful
 
310
when \fB\-\-export\-all\-symbols\fR is used.
 
311
.IP "\fB\-S\fR \fIpath\fR" 4
 
312
.IX Item "-S path"
 
313
.PD 0
 
314
.IP "\fB\-\-as\fR \fIpath\fR" 4
 
315
.IX Item "--as path"
 
316
.PD
 
317
Specifies the path, including the filename, of the assembler to be used
 
318
to create the exports file.
 
319
.IP "\fB\-f\fR \fIoptions\fR" 4
 
320
.IX Item "-f options"
 
321
.PD 0
 
322
.IP "\fB\-\-as\-flags\fR \fIoptions\fR" 4
 
323
.IX Item "--as-flags options"
 
324
.PD
 
325
Specifies any specific command line options to be passed to the
 
326
assembler when building the exports file.  This option will work even if
 
327
the \fB\-S\fR option is not used.  This option only takes one argument,
 
328
and if it occurs more than once on the command line, then later
 
329
occurrences will override earlier occurrences.  So if it is necessary to
 
330
pass multiple options to the assembler they should be enclosed in
 
331
double quotes.
 
332
.IP "\fB\-D\fR \fIname\fR" 4
 
333
.IX Item "-D name"
 
334
.PD 0
 
335
.IP "\fB\-\-dll\-name\fR \fIname\fR" 4
 
336
.IX Item "--dll-name name"
 
337
.PD
 
338
Specifies the name to be stored in the \fI.def\fR file as the name of
 
339
the \s-1DLL\s0 when the \fB\-e\fR option is used.  If this option is not
 
340
present, then the filename given to the \fB\-e\fR option will be
 
341
used as the name of the \s-1DLL\s0.
 
342
.IP "\fB\-m\fR \fImachine\fR" 4
 
343
.IX Item "-m machine"
 
344
.PD 0
 
345
.IP "\fB\-machine\fR \fImachine\fR" 4
 
346
.IX Item "-machine machine"
 
347
.PD
 
348
Specifies the type of machine for which the library file should be
 
349
built.  \fBdlltool\fR has a built in default type, depending upon how
 
350
it was created, but this option can be used to override that.  This is
 
351
normally only useful when creating DLLs for an \s-1ARM\s0 processor, when the
 
352
contents of the \s-1DLL\s0 are actually encode using Thumb instructions.
 
353
.IP "\fB\-a\fR" 4
 
354
.IX Item "-a"
 
355
.PD 0
 
356
.IP "\fB\-\-add\-indirect\fR" 4
 
357
.IX Item "--add-indirect"
 
358
.PD
 
359
Specifies that when \fBdlltool\fR is creating the exports file it
 
360
should add a section which allows the exported functions to be
 
361
referenced without using the import library.  Whatever the hell that
 
362
means!
 
363
.IP "\fB\-U\fR" 4
 
364
.IX Item "-U"
 
365
.PD 0
 
366
.IP "\fB\-\-add\-underscore\fR" 4
 
367
.IX Item "--add-underscore"
 
368
.PD
 
369
Specifies that when \fBdlltool\fR is creating the exports file it
 
370
should prepend an underscore to the names of \fIall\fR exported symbols.
 
371
.IP "\fB\-\-no\-leading\-underscore\fR" 4
 
372
.IX Item "--no-leading-underscore"
 
373
.PD 0
 
374
.IP "\fB\-\-leading\-underscore\fR" 4
 
375
.IX Item "--leading-underscore"
 
376
.PD
 
377
Specifies whether standard symbol should be forced to be prefixed, or
 
378
not.
 
379
.IP "\fB\-\-add\-stdcall\-underscore\fR" 4
 
380
.IX Item "--add-stdcall-underscore"
 
381
Specifies that when \fBdlltool\fR is creating the exports file it
 
382
should prepend an underscore to the names of exported \fIstdcall\fR
 
383
functions. Variable names and non-stdcall function names are not modified.
 
384
This option is useful when creating GNU-compatible import libs for third
 
385
party DLLs that were built with MS-Windows tools.
 
386
.IP "\fB\-k\fR" 4
 
387
.IX Item "-k"
 
388
.PD 0
 
389
.IP "\fB\-\-kill\-at\fR" 4
 
390
.IX Item "--kill-at"
 
391
.PD
 
392
Specifies that when \fBdlltool\fR is creating the exports file it
 
393
should not append the string \fB@ <number>\fR.  These numbers are
 
394
called ordinal numbers and they represent another way of accessing the
 
395
function in a \s-1DLL\s0, other than by name.
 
396
.IP "\fB\-A\fR" 4
 
397
.IX Item "-A"
 
398
.PD 0
 
399
.IP "\fB\-\-add\-stdcall\-alias\fR" 4
 
400
.IX Item "--add-stdcall-alias"
 
401
.PD
 
402
Specifies that when \fBdlltool\fR is creating the exports file it
 
403
should add aliases for stdcall symbols without \fB@ <number>\fR
 
404
in addition to the symbols with \fB@ <number>\fR.
 
405
.IP "\fB\-p\fR" 4
 
406
.IX Item "-p"
 
407
.PD 0
 
408
.IP "\fB\-\-ext\-prefix\-alias\fR \fIprefix\fR" 4
 
409
.IX Item "--ext-prefix-alias prefix"
 
410
.PD
 
411
Causes \fBdlltool\fR to create external aliases for all \s-1DLL\s0
 
412
imports with the specified prefix.  The aliases are created for both
 
413
external and import symbols with no leading underscore.
 
414
.IP "\fB\-x\fR" 4
 
415
.IX Item "-x"
 
416
.PD 0
 
417
.IP "\fB\-\-no\-idata4\fR" 4
 
418
.IX Item "--no-idata4"
 
419
.PD
 
420
Specifies that when \fBdlltool\fR is creating the exports and library
 
421
files it should omit the \f(CW\*(C`.idata4\*(C'\fR section.  This is for compatibility
 
422
with certain operating systems.
 
423
.IP "\fB\-\-use\-nul\-prefixed\-import\-tables\fR" 4
 
424
.IX Item "--use-nul-prefixed-import-tables"
 
425
Specifies that when \fBdlltool\fR is creating the exports and library
 
426
files it should prefix the \f(CW\*(C`.idata4\*(C'\fR and \f(CW\*(C`.idata5\*(C'\fR by zero an
 
427
element. This emulates old gnu import library generation of
 
428
\&\f(CW\*(C`dlltool\*(C'\fR. By default this option is turned off.
 
429
.IP "\fB\-c\fR" 4
 
430
.IX Item "-c"
 
431
.PD 0
 
432
.IP "\fB\-\-no\-idata5\fR" 4
 
433
.IX Item "--no-idata5"
 
434
.PD
 
435
Specifies that when \fBdlltool\fR is creating the exports and library
 
436
files it should omit the \f(CW\*(C`.idata5\*(C'\fR section.  This is for compatibility
 
437
with certain operating systems.
 
438
.IP "\fB\-I\fR \fIfilename\fR" 4
 
439
.IX Item "-I filename"
 
440
.PD 0
 
441
.IP "\fB\-\-identify\fR \fIfilename\fR" 4
 
442
.IX Item "--identify filename"
 
443
.PD
 
444
Specifies that \fBdlltool\fR should inspect the import library
 
445
indicated by \fIfilename\fR and report, on \f(CW\*(C`stdout\*(C'\fR, the name(s)
 
446
of the associated \s-1DLL\s0(s).  This can be performed in addition to any
 
447
other operations indicated by the other options and arguments.
 
448
\&\fBdlltool\fR fails if the import library does not exist or is not
 
449
actually an import library. See also \fB\-\-identify\-strict\fR.
 
450
.IP "\fB\-\-identify\-strict\fR" 4
 
451
.IX Item "--identify-strict"
 
452
Modifies the behavior of the \fB\-\-identify\fR option, such
 
453
that an error is reported if \fIfilename\fR is associated with
 
454
more than one \s-1DLL\s0.
 
455
.IP "\fB\-i\fR" 4
 
456
.IX Item "-i"
 
457
.PD 0
 
458
.IP "\fB\-\-interwork\fR" 4
 
459
.IX Item "--interwork"
 
460
.PD
 
461
Specifies that \fBdlltool\fR should mark the objects in the library
 
462
file and exports file that it produces as supporting interworking
 
463
between \s-1ARM\s0 and Thumb code.
 
464
.IP "\fB\-n\fR" 4
 
465
.IX Item "-n"
 
466
.PD 0
 
467
.IP "\fB\-\-nodelete\fR" 4
 
468
.IX Item "--nodelete"
 
469
.PD
 
470
Makes \fBdlltool\fR preserve the temporary assembler files it used to
 
471
create the exports file.  If this option is repeated then dlltool will
 
472
also preserve the temporary object files it uses to create the library
 
473
file.
 
474
.IP "\fB\-t\fR \fIprefix\fR" 4
 
475
.IX Item "-t prefix"
 
476
.PD 0
 
477
.IP "\fB\-\-temp\-prefix\fR \fIprefix\fR" 4
 
478
.IX Item "--temp-prefix prefix"
 
479
.PD
 
480
Makes \fBdlltool\fR use \fIprefix\fR when constructing the names of
 
481
temporary assembler and object files.  By default, the temp file prefix
 
482
is generated from the pid.
 
483
.IP "\fB\-v\fR" 4
 
484
.IX Item "-v"
 
485
.PD 0
 
486
.IP "\fB\-\-verbose\fR" 4
 
487
.IX Item "--verbose"
 
488
.PD
 
489
Make dlltool describe what it is doing.
 
490
.IP "\fB\-h\fR" 4
 
491
.IX Item "-h"
 
492
.PD 0
 
493
.IP "\fB\-\-help\fR" 4
 
494
.IX Item "--help"
 
495
.PD
 
496
Displays a list of command line options and then exits.
 
497
.IP "\fB\-V\fR" 4
 
498
.IX Item "-V"
 
499
.PD 0
 
500
.IP "\fB\-\-version\fR" 4
 
501
.IX Item "--version"
 
502
.PD
 
503
Displays dlltool's version number and then exits.
 
504
.IP "\fB@\fR\fIfile\fR" 4
 
505
.IX Item "@file"
 
506
Read command-line options from \fIfile\fR.  The options read are
 
507
inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
 
508
does not exist, or cannot be read, then the option will be treated
 
509
literally, and not removed.
 
510
.Sp
 
511
Options in \fIfile\fR are separated by whitespace.  A whitespace
 
512
character may be included in an option by surrounding the entire
 
513
option in either single or double quotes.  Any character (including a
 
514
backslash) may be included by prefixing the character to be included
 
515
with a backslash.  The \fIfile\fR may itself contain additional
 
516
@\fIfile\fR options; any such options will be processed recursively.
 
517
.SH "SEE ALSO"
 
518
.IX Header "SEE ALSO"
 
519
The Info pages for \fIbinutils\fR.
 
520
.SH "COPYRIGHT"
 
521
.IX Header "COPYRIGHT"
 
522
Copyright (c) 1991\-2013 Free Software Foundation, Inc.
 
523
.PP
 
524
Permission is granted to copy, distribute and/or modify this document
 
525
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3
 
526
or any later version published by the Free Software Foundation;
 
527
with no Invariant Sections, with no Front-Cover Texts, and with no
 
528
Back-Cover Texts.  A copy of the license is included in the
 
529
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".