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