OpenCores
URL https://opencores.org/ocsvn/openrisc_me/openrisc_me/trunk

Subversion Repositories openrisc_me

[/] [openrisc/] [trunk/] [gnu-src/] [binutils-2.20.1/] [binutils/] [doc/] [dlltool.1] - Blame information for rev 297

Go to most recent revision | Details | Compare with Previous | View Log

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

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.