diff options
| author | Nick Clifton <nickc@redhat.com> | 2023-05-16 16:04:58 +0100 |
|---|---|---|
| committer | Nick Clifton <nickc@redhat.com> | 2023-05-16 16:04:58 +0100 |
| commit | d1792f72bf92ac06be7a4785567e2c7bf78c0496 (patch) | |
| tree | f403f96a40e2ab64a16c2406321faa9bb0a686cb | |
| parent | 0e759f232b6def277d4ae3f2d8bccfe6e34d6034 (diff) | |
| download | binutils-gdb-d1792f72bf92ac06be7a4785567e2c7bf78c0496.tar.gz | |
Document how to use the linker to create a resource only DLL.
PR 30359
* ld.texi (WIN32): Document how to create a resource only DLL.
| -rw-r--r-- | ld/ChangeLog | 5 | ||||
| -rw-r--r-- | ld/ld.texi | 33 |
2 files changed, 38 insertions, 0 deletions
diff --git a/ld/ChangeLog b/ld/ChangeLog index 788410a026a..ae1b34af0c0 100644 --- a/ld/ChangeLog +++ b/ld/ChangeLog @@ -1,5 +1,10 @@ 2023-05-16 Nick Clifton <nickc@redhat.com> + PR 30359 + * ld.texi (WIN32): Document how to create a resource only DLL. + +2023-05-16 Nick Clifton <nickc@redhat.com> + * ld.texi (-Ur): Clarify the actions of this option. 2023-05-10 Nick Clifton <nickc@redhat.com> diff --git a/ld/ld.texi b/ld/ld.texi index fdcc8c50e4d..252a0ac9c3f 100644 --- a/ld/ld.texi +++ b/ld/ld.texi @@ -8556,6 +8556,39 @@ archive. The cygwin and mingw ports of @command{ld} have specific support for creating such libraries provided with the @samp{--out-implib} command-line option. +@item Resource only DLLs +It is possible to create a DLL that only contains resources, ie just a +@samp{.rsrc} section, but in order to do so a custom linker script +must be used. This is because the built-in default linker scripts +will always create @samp{.text} amd @samp {.idata} sections, even if +there is no input to go into them. + +The script should look like this, although the @code{OUTPUT_FORMAT} +should be changed to match the desired format. + +@example +OUTPUT_FORMAT(pei-i386) +SECTIONS +@{ + . = SIZEOF_HEADERS; + . = ALIGN(__section_alignment__); + .rsrc __image_base__ + __section_alignment__ : ALIGN(4) + @{ + KEEP (*(.rsrc)) + KEEP (*(.rsrc$*)) + @} + /DISCARD/ : @{ *(*) @} +@} +@end example + +With this script saved to a file called, eg @file{rsrc.ld}, a command +line like this can be used to create the resource only DLL +@file{rsrc.dll} from an input file called @file{rsrc.o}: + +@smallexample +ld -dll --subsystem windows -e 0 -s rsrc.o -o rsrc.dll -T rsrc.ld +@end smallexample + @item exporting DLL symbols @cindex exporting DLL symbols The cygwin/mingw @command{ld} has several ways to export symbols for dll's. |