1 /* rescoff.c -- read and write resources in Windows COFF files.
2 Copyright (C) 1997-2016 Free Software Foundation, Inc.
3 Written by Ian Lance Taylor, Cygnus Support.
4 Rewritten by Kai Tietz, Onevision.
6 This file is part of GNU Binutils.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
23 /* This file contains function that read and write Windows resources
29 #include "libiberty.h"
34 /* In order to use the address of a resource data entry, we need to
35 get the image base of the file. Right now we extract it from
36 internal BFD information. FIXME. */
38 #include "coff/internal.h"
41 /* Information we extract from the file. */
47 /* Data read from the file. */
49 /* End of data read from file. */
50 const bfd_byte *data_end;
51 /* Address of the resource section minus the image base of the file. */
55 /* A resource directory table in a COFF file. */
57 struct __attribute__ ((__packed__)) extern_res_directory
59 /* Characteristics. */
60 bfd_byte characteristics[4];
63 /* Major version number. */
65 /* Minor version number. */
67 /* Number of named directory entries. */
68 bfd_byte name_count[2];
69 /* Number of directory entries with IDs. */
73 /* A resource directory entry in a COFF file. */
75 struct extern_res_entry
79 /* Address of resource entry or subdirectory. */
83 /* A resource data entry in a COFF file. */
85 struct extern_res_data
87 /* Address of resource data. This is apparently a file relative
88 address, rather than a section offset. */
90 /* Size of resource data. */
98 /* Local functions. */
100 static void overrun (const struct coff_file_info *, const char *);
101 static rc_res_directory *read_coff_res_dir (windres_bfd *, const bfd_byte *,
102 const struct coff_file_info *,
103 const rc_res_id *, int);
104 static rc_res_resource *read_coff_data_entry (windres_bfd *, const bfd_byte *,
105 const struct coff_file_info *,
108 /* Read the resources in a COFF file. */
111 read_coff_rsrc (const char *filename, const char *target)
113 rc_res_directory *ret;
120 struct coff_file_info flaginfo;
122 if (filename == NULL)
123 fatal (_("filename required for COFF input"));
125 abfd = bfd_openr (filename, target);
127 bfd_fatal (filename);
129 if (! bfd_check_format_matches (abfd, bfd_object, &matching))
131 bfd_nonfatal (bfd_get_filename (abfd));
132 if (bfd_get_error () == bfd_error_file_ambiguously_recognized)
133 list_matching_formats (matching);
137 sec = bfd_get_section_by_name (abfd, ".rsrc");
140 fatal (_("%s: no resource section"), filename);
143 set_windres_bfd (&wrbfd, abfd, sec, WR_KIND_BFD);
144 size = bfd_section_size (abfd, sec);
145 /* PR 17512: file: 1b25ba5d
146 The call to get_file_size here may be expensive
147 but there is no other way to determine if the section size
149 if (size > (bfd_size_type) get_file_size (filename))
150 fatal (_("%s: .rsrc section is bigger than the file!"), filename);
152 data = (bfd_byte *) res_alloc (size);
153 get_windres_bfd_content (&wrbfd, data, 0, size);
155 flaginfo.filename = filename;
156 flaginfo.data = data;
157 flaginfo.data_end = data + size;
158 flaginfo.secaddr = (bfd_get_section_vma (abfd, sec)
159 - pe_data (abfd)->pe_opthdr.ImageBase);
161 /* Now just read in the top level resource directory. Note that we
162 don't free data, since we create resource entries that point into
163 it. If we ever want to free up the resource information we read,
164 this will have to be cleaned up. */
166 ret = read_coff_res_dir (&wrbfd, data, &flaginfo, (const rc_res_id *) NULL, 0);
173 /* Give an error if we are out of bounds. */
176 overrun (const struct coff_file_info *flaginfo, const char *msg)
178 fatal (_("%s: %s: address out of bounds"), flaginfo->filename, msg);
181 /* Read a resource directory. */
183 static rc_res_directory *
184 read_coff_res_dir (windres_bfd *wrbfd, const bfd_byte *data,
185 const struct coff_file_info *flaginfo,
186 const rc_res_id *type, int level)
188 const struct extern_res_directory *erd;
189 rc_res_directory *rd;
190 int name_count, id_count, i;
192 const struct extern_res_entry *ere;
194 /* PR 17512: file: 09d80f53.
195 Whilst in theory resources can nest to any level, in practice
196 Microsoft only defines 3 levels. Corrupt files however might
197 claim to use more. */
199 overrun (flaginfo, _("Resources nest too deep"));
201 if ((size_t) (flaginfo->data_end - data) < sizeof (struct extern_res_directory))
202 overrun (flaginfo, _("directory"));
204 erd = (const struct extern_res_directory *) data;
206 rd = (rc_res_directory *) res_alloc (sizeof (rc_res_directory));
207 rd->characteristics = windres_get_32 (wrbfd, erd->characteristics, 4);
208 rd->time = windres_get_32 (wrbfd, erd->time, 4);
209 rd->major = windres_get_16 (wrbfd, erd->major, 2);
210 rd->minor = windres_get_16 (wrbfd, erd->minor, 2);
213 name_count = windres_get_16 (wrbfd, erd->name_count, 2);
214 id_count = windres_get_16 (wrbfd, erd->id_count, 2);
218 /* The resource directory entries immediately follow the directory
220 ere = (const struct extern_res_entry *) (erd + 1);
222 for (i = 0; i < name_count; i++, ere++)
224 rc_uint_type name, rva;
229 if ((const bfd_byte *) ere >= flaginfo->data_end)
230 overrun (flaginfo, _("named directory entry"));
232 name = windres_get_32 (wrbfd, ere->name, 4);
233 rva = windres_get_32 (wrbfd, ere->rva, 4);
235 /* For some reason the high bit in NAME is set. */
238 if (name > (rc_uint_type) (flaginfo->data_end - flaginfo->data))
239 overrun (flaginfo, _("directory entry name"));
241 ers = flaginfo->data + name;
243 re = (rc_res_entry *) res_alloc (sizeof *re);
246 length = windres_get_16 (wrbfd, ers, 2);
247 re->id.u.n.length = length;
248 re->id.u.n.name = (unichar *) res_alloc (length * sizeof (unichar));
249 for (j = 0; j < length; j++)
251 /* PR 17512: file: 05dc4a16. */
252 if (length < 0 || ers >= (bfd_byte *) ere || ers + j * 2 + 4 >= (bfd_byte *) ere)
253 overrun (flaginfo, _("resource name"));
254 re->id.u.n.name[j] = windres_get_16 (wrbfd, ers + j * 2 + 2, 2);
260 if ((rva & 0x80000000) != 0)
263 if (rva >= (rc_uint_type) (flaginfo->data_end - flaginfo->data))
264 overrun (flaginfo, _("named subdirectory"));
266 re->u.dir = read_coff_res_dir (wrbfd, flaginfo->data + rva, flaginfo, type,
271 if (rva >= (rc_uint_type) (flaginfo->data_end - flaginfo->data))
272 overrun (flaginfo, _("named resource"));
274 re->u.res = read_coff_data_entry (wrbfd, flaginfo->data + rva, flaginfo, type);
281 for (i = 0; i < id_count; i++, ere++)
283 unsigned long name, rva;
286 if ((const bfd_byte *) ere >= flaginfo->data_end)
287 overrun (flaginfo, _("ID directory entry"));
289 name = windres_get_32 (wrbfd, ere->name, 4);
290 rva = windres_get_32 (wrbfd, ere->rva, 4);
292 re = (rc_res_entry *) res_alloc (sizeof *re);
300 if ((rva & 0x80000000) != 0)
303 if (rva >= (rc_uint_type) (flaginfo->data_end - flaginfo->data))
304 overrun (flaginfo, _("ID subdirectory"));
306 re->u.dir = read_coff_res_dir (wrbfd, flaginfo->data + rva, flaginfo, type,
311 if (rva >= (rc_uint_type) (flaginfo->data_end - flaginfo->data))
312 overrun (flaginfo, _("ID resource"));
314 re->u.res = read_coff_data_entry (wrbfd, flaginfo->data + rva, flaginfo, type);
324 /* Read a resource data entry. */
326 static rc_res_resource *
327 read_coff_data_entry (windres_bfd *wrbfd, const bfd_byte *data,
328 const struct coff_file_info *flaginfo,
329 const rc_res_id *type)
331 const struct extern_res_data *erd;
333 rc_uint_type size, rva;
334 const bfd_byte *resdata;
337 fatal (_("resource type unknown"));
339 if ((size_t) (flaginfo->data_end - data) < sizeof (struct extern_res_data))
340 overrun (flaginfo, _("data entry"));
342 erd = (const struct extern_res_data *) data;
344 size = windres_get_32 (wrbfd, erd->size, 4);
345 rva = windres_get_32 (wrbfd, erd->rva, 4);
346 if (rva < flaginfo->secaddr
347 || rva - flaginfo->secaddr >= (rc_uint_type) (flaginfo->data_end - flaginfo->data))
348 overrun (flaginfo, _("resource data"));
350 resdata = flaginfo->data + (rva - flaginfo->secaddr);
352 if (size > (rc_uint_type) (flaginfo->data_end - resdata))
353 overrun (flaginfo, _("resource data size"));
355 r = bin_to_res (wrbfd, *type, resdata, size);
357 memset (&r->res_info, 0, sizeof (rc_res_res_info));
358 r->coff_info.codepage = windres_get_32 (wrbfd, erd->codepage, 4);
359 r->coff_info.reserved = windres_get_32 (wrbfd, erd->reserved, 4);
364 /* This structure is used to build a list of bindata structures. */
370 /* The last structure we have added to the list. */
372 /* The size of the list as a whole. */
373 unsigned long length;
376 struct coff_res_data_build
380 /* The last structure we have added to the list. */
382 /* The size of the list as a whole. */
383 unsigned long length;
386 /* This structure keeps track of information as we build the directory
389 struct coff_write_info
391 /* These fields are based on the BFD. */
392 /* The BFD itself. */
394 /* Pointer to section symbol used to build RVA relocs. */
397 /* These fields are computed initially, and then not changed. */
398 /* Length of directory tables and entries. */
399 unsigned long dirsize;
400 /* Length of directory entry strings. */
401 unsigned long dirstrsize;
402 /* Length of resource data entries. */
403 unsigned long dataentsize;
405 /* These fields are updated as we add data. */
406 /* Directory tables and entries. */
407 struct bindata_build dirs;
408 /* Directory entry strings. */
409 struct bindata_build dirstrs;
410 /* Resource data entries. */
411 struct bindata_build dataents;
412 /* Actual resource data. */
413 struct coff_res_data_build resources;
416 /* Number of relocations. */
417 unsigned int reloc_count;
420 static void coff_bin_sizes (const rc_res_directory *, struct coff_write_info *);
421 static bfd_byte *coff_alloc (struct bindata_build *, rc_uint_type);
422 static void coff_to_bin
423 (const rc_res_directory *, struct coff_write_info *);
424 static void coff_res_to_bin
425 (const rc_res_resource *, struct coff_write_info *);
427 /* Write resources to a COFF file. RESOURCES should already be
430 Right now we always create a new file. Someday we should also
431 offer the ability to merge resources into an existing file. This
432 would require doing the basic work of objcopy, just modifying or
433 adding the .rsrc section. */
436 write_coff_file (const char *filename, const char *target,
437 const rc_res_directory *resources)
441 struct coff_write_info cwi;
445 unsigned long length, offset;
447 if (filename == NULL)
448 fatal (_("filename required for COFF output"));
450 abfd = bfd_openw (filename, target);
452 bfd_fatal (filename);
454 if (! bfd_set_format (abfd, bfd_object))
455 bfd_fatal ("bfd_set_format");
457 #if defined DLLTOOL_SH
458 if (! bfd_set_arch_mach (abfd, bfd_arch_sh, 0))
459 bfd_fatal ("bfd_set_arch_mach(sh)");
460 #elif defined DLLTOOL_MIPS
461 if (! bfd_set_arch_mach (abfd, bfd_arch_mips, 0))
462 bfd_fatal ("bfd_set_arch_mach(mips)");
463 #elif defined DLLTOOL_ARM
464 if (! bfd_set_arch_mach (abfd, bfd_arch_arm, 0))
465 bfd_fatal ("bfd_set_arch_mach(arm)");
467 /* FIXME: This is obviously i386 specific. */
468 if (! bfd_set_arch_mach (abfd, bfd_arch_i386, 0))
469 bfd_fatal ("bfd_set_arch_mach(i386)");
472 if (! bfd_set_file_flags (abfd, HAS_SYMS | HAS_RELOC))
473 bfd_fatal ("bfd_set_file_flags");
475 sec = bfd_make_section_with_flags (abfd, ".rsrc",
476 (SEC_HAS_CONTENTS | SEC_ALLOC
477 | SEC_LOAD | SEC_DATA));
479 bfd_fatal ("bfd_make_section");
481 if (! bfd_set_symtab (abfd, sec->symbol_ptr_ptr, 1))
482 bfd_fatal ("bfd_set_symtab");
484 /* Requiring this is probably a bug in BFD. */
485 sec->output_section = sec;
487 /* The order of data in the .rsrc section is
488 resource directory tables and entries
489 resource directory strings
490 resource data entries
493 We build these different types of data in different lists. */
495 set_windres_bfd (&wrbfd, abfd, sec, WR_KIND_BFD);
498 cwi.sympp = sec->symbol_ptr_ptr;
503 cwi.dirs.last = NULL;
505 cwi.dirstrs.d = NULL;
506 cwi.dirstrs.last = NULL;
507 cwi.dirstrs.length = 0;
508 cwi.dataents.d = NULL;
509 cwi.dataents.last = NULL;
510 cwi.dataents.length = 0;
511 cwi.resources.d = NULL;
512 cwi.resources.last = NULL;
513 cwi.resources.length = 0;
517 /* Work out the sizes of the resource directory entries, so that we
518 know the various offsets we will need. */
519 coff_bin_sizes (resources, &cwi);
521 /* Force the directory strings to be 64 bit aligned. Every other
522 structure is 64 bit aligned anyhow. */
523 cwi.dirstrsize = (cwi.dirstrsize + 7) & ~7;
525 /* Actually convert the resources to binary. */
526 coff_to_bin (resources, &cwi);
528 /* Add another few bytes to the directory strings if needed for
530 if ((cwi.dirstrs.length & 7) != 0)
532 rc_uint_type pad = 8 - (cwi.dirstrs.length & 7);
535 ex = coff_alloc (& cwi.dirstrs, pad);
539 /* Make sure that the data we built came out to the same size as we
540 calculated initially. */
541 assert (cwi.dirs.length == cwi.dirsize);
542 assert (cwi.dirstrs.length == cwi.dirstrsize);
543 assert (cwi.dataents.length == cwi.dataentsize);
545 length = (cwi.dirsize
548 + cwi.resources.length);
550 if (! bfd_set_section_size (abfd, sec, length))
551 bfd_fatal ("bfd_set_section_size");
553 bfd_set_reloc (abfd, sec, cwi.relocs, cwi.reloc_count);
556 for (d = cwi.dirs.d; d != NULL; d = d->next)
558 if (! bfd_set_section_contents (abfd, sec, d->data, offset, d->length))
559 bfd_fatal ("bfd_set_section_contents");
562 for (d = cwi.dirstrs.d; d != NULL; d = d->next)
564 set_windres_bfd_content (&wrbfd, d->data, offset, d->length);
567 for (d = cwi.dataents.d; d != NULL; d = d->next)
569 set_windres_bfd_content (&wrbfd, d->data, offset, d->length);
572 for (rd = cwi.resources.d; rd != NULL; rd = rd->next)
574 res_to_bin (cwi.wrbfd, (rc_uint_type) offset, rd->res);
575 offset += rd->length;
578 assert (offset == length);
580 if (! bfd_close (abfd))
581 bfd_fatal ("bfd_close");
583 /* We allocated the relocs array using malloc. */
587 /* Work out the sizes of the various fixed size resource directory
588 entries. This updates fields in CWI. */
591 coff_bin_sizes (const rc_res_directory *resdir,
592 struct coff_write_info *cwi)
594 const rc_res_entry *re;
596 cwi->dirsize += sizeof (struct extern_res_directory);
598 for (re = resdir->entries; re != NULL; re = re->next)
600 cwi->dirsize += sizeof (struct extern_res_entry);
603 cwi->dirstrsize += re->id.u.n.length * 2 + 2;
606 coff_bin_sizes (re->u.dir, cwi);
608 cwi->dataentsize += sizeof (struct extern_res_data);
612 /* Allocate data for a particular list. */
615 coff_alloc (struct bindata_build *bb, rc_uint_type size)
619 d = (bindata *) reswr_alloc (sizeof (bindata));
622 d->data = (bfd_byte *) reswr_alloc (size);
635 /* Convert the resource directory RESDIR to binary. */
638 coff_to_bin (const rc_res_directory *resdir, struct coff_write_info *cwi)
640 struct extern_res_directory *erd;
642 const rc_res_entry *e;
643 struct extern_res_entry *ere;
645 /* Write out the directory table. */
647 erd = ((struct extern_res_directory *)
648 coff_alloc (&cwi->dirs, sizeof (*erd)));
650 windres_put_32 (cwi->wrbfd, erd->characteristics, resdir->characteristics);
651 windres_put_32 (cwi->wrbfd, erd->time, resdir->time);
652 windres_put_16 (cwi->wrbfd, erd->major, resdir->major);
653 windres_put_16 (cwi->wrbfd, erd->minor, resdir->minor);
657 for (e = resdir->entries; e != NULL; e = e->next)
665 windres_put_16 (cwi->wrbfd, erd->name_count, cn);
666 windres_put_16 (cwi->wrbfd, erd->id_count, ci);
668 /* Write out the data entries. Note that we allocate space for all
669 the entries before writing them out. That permits a recursive
670 call to work correctly when writing out subdirectories. */
672 ere = ((struct extern_res_entry *)
673 coff_alloc (&cwi->dirs, (ci + cn) * sizeof (*ere)));
674 for (e = resdir->entries; e != NULL; e = e->next, ere++)
677 windres_put_32 (cwi->wrbfd, ere->name, e->id.u.id);
683 /* For some reason existing files seem to have the high bit
684 set on the address of the name, although that is not
686 windres_put_32 (cwi->wrbfd, ere->name,
687 0x80000000 | (cwi->dirsize + cwi->dirstrs.length));
689 str = coff_alloc (&cwi->dirstrs, e->id.u.n.length * 2 + 2);
690 windres_put_16 (cwi->wrbfd, str, e->id.u.n.length);
691 for (i = 0; i < e->id.u.n.length; i++)
692 windres_put_16 (cwi->wrbfd, str + (i + 1) * sizeof (unichar), e->id.u.n.name[i]);
697 windres_put_32 (cwi->wrbfd, ere->rva, 0x80000000 | cwi->dirs.length);
698 coff_to_bin (e->u.dir, cwi);
702 windres_put_32 (cwi->wrbfd, ere->rva,
703 cwi->dirsize + cwi->dirstrsize + cwi->dataents.length);
705 coff_res_to_bin (e->u.res, cwi);
710 /* Convert the resource RES to binary. */
713 coff_res_to_bin (const rc_res_resource *res, struct coff_write_info *cwi)
716 struct extern_res_data *erd;
719 /* For some reason, although every other address is a section
720 offset, the address of the resource data itself is an RVA. That
721 means that we need to generate a relocation for it. We allocate
722 the relocs array using malloc so that we can use realloc. FIXME:
723 This relocation handling is correct for the i386, but probably
724 not for any other target. */
726 r = (arelent *) reswr_alloc (sizeof (arelent));
727 r->sym_ptr_ptr = cwi->sympp;
728 r->address = cwi->dirsize + cwi->dirstrsize + cwi->dataents.length;
730 r->howto = bfd_reloc_type_lookup (WR_BFD (cwi->wrbfd), BFD_RELOC_RVA);
731 if (r->howto == NULL)
732 bfd_fatal (_("can't get BFD_RELOC_RVA relocation type"));
734 cwi->relocs = xrealloc (cwi->relocs,
735 (cwi->reloc_count + 2) * sizeof (arelent *));
736 cwi->relocs[cwi->reloc_count] = r;
737 cwi->relocs[cwi->reloc_count + 1] = NULL;
740 erd = (struct extern_res_data *) coff_alloc (&cwi->dataents, sizeof (*erd));
742 windres_put_32 (cwi->wrbfd, erd->rva,
746 + cwi->resources.length));
747 windres_put_32 (cwi->wrbfd, erd->codepage, res->coff_info.codepage);
748 windres_put_32 (cwi->wrbfd, erd->reserved, res->coff_info.reserved);
750 d = (coff_res_data *) reswr_alloc (sizeof (coff_res_data));
751 d->length = res_to_bin (NULL, (rc_uint_type) 0, res);
755 if (cwi->resources.d == NULL)
756 cwi->resources.d = d;
758 cwi->resources.last->next = d;
760 cwi->resources.last = d;
761 cwi->resources.length += (d->length + 7) & ~7;
763 windres_put_32 (cwi->wrbfd, erd->size, d->length);
765 /* Force the next resource to have 64 bit alignment. */
766 d->length = (d->length + 7) & ~7;