binutils/binutils/objcopy.c

1 /* objcopy.c -- copy object file from input to output, optionally massaging it.
19    along with this program; if not, write to the Free Software
37 /* A list of symbols to explicitly strip out, or to keep.  A linked
48 /* A list to support redefine_sym.  */
65 /* List of sections to be renamed.  */
91 /* Which symbols to remove.  */
101 /* Which local symbols to remove.  Overrides STRIP_ALL.  */
104 /* What kind of change to perform.  */
112 /* Structure used to hold lists of sections and actions to take.  */
115   struct section_list * next;	   /* Next section to change.  */
118   bfd_boolean		remove;	   /* Whether to remove this section.  */
119   bfd_boolean		copy;	   /* Whether to copy this section.  */
120   enum change_action	change_vma;/* Whether to change or set VMA.  */
121   bfd_vma		vma_val;   /* Amount to change by or set to.  */
122   enum change_action	change_lma;/* Whether to change or set LMA.  */
123   bfd_vma		lma_val;   /* Amount to change by or set to.  */
124   bfd_boolean		set_flags; /* Whether to set the section flags.	 */
125   flagword		flags;	   /* What to set the section flags to.	 */
130 /* TRUE if some sections are to be removed.  */
133 /* TRUE if only some sections are to be copied.  */
136 /* Changes to the start address.  */
141 /* Changes to section addresses.  */
148 /* Pad to a given address.  */
155 /* Output BFD flags user wants to set or clear */
159 /* List of sections to add.  */
162   /* Next section to add.  */
164   /* Name of section to add.  */
176 /* List of sections to add to the output BFD.  */
179 /* If non-NULL the argument to --add-gnu-debuglink.
180    This should be the filename to store in the .gnu_debuglink section.  */
183 /* Whether to convert debugging information.  */
186 /* Whether to change the leading character in symbol names.  */
189 /* Whether to remove the leading character from global symbol names.  */
192 /* Whether to permit wildcard in symbol comparison.  */
198 /* List of symbols to strip, keep, localize, keep-global, weaken,
279 /* Options to handle if running as "strip".  */
309 /* Options to handle if running as "objcopy".  */
357   {"pad-to", required_argument, 0, OPTION_PAD_TO},
397    -1 means if we should use argv[0] to decide.  */
404 /* Restrict the generation of Srecords to type S3 only.
409 /* Defined in bfd/binary.c.  Used to set architecture and machine of input
435   -F --target <bfdname>            Set both input and output format to <bfdname>\n\
437   -p --preserve-dates              Copy modified/access timestamps to the output\n\
439      --add-gnu-debuglink=<file>    Add section .gnu_debuglink linking to <file>\n\
453   -L --localize-symbol <name>      Force symbol <name> to be marked as a local\n\
454      --globalize-symbol <name>     Force symbol <name> to be marked as a global\n\
456   -W --weaken-symbol <name>        Force symbol <name> to be marked as a weak\n\
457      --weaken                      Force all global symbols to be marked as weak\n\
464      --pad-to <addr>               Pad the last section up to address <addr>\n\
465      --set-start <addr>            Set the start address to <addr>\n\
467                                    Add <incr> to the start address\n\
469                                    Add <incr> to LMA, VMA and start addresses\n\
479                                    Set section <name>'s properties to <flags>\n\
480      --add-section <name>=<file>   Add section <name> found in <file> to output\n\
481      --rename-section <old>=<new>[,<flags>] Rename section <old> to <new>\n\
485      --redefine-sym <old>=<new>    Redefine symbol name <old> to <new>\n\
489      --srec-forceS3                Restrict the type of generated Srecords to S3\n\
504      --prefix-symbols <prefix>     Add <prefix> to start of every symbol name\n\
505      --prefix-sections <prefix>    Add <prefix> to start of every section name\n\
507                                    Add <prefix> to start of every allocatable\n\
517     fprintf (stream, _("Report bugs to %s\n"), REPORT_BUGS_TO);
530   -F --target=<bfdname>            Set both input and output format to <bfdname>\n\
531   -p --preserve-dates              Copy modified/access timestamps to the output\n\
552     fprintf (stream, _("Report bugs to %s\n"), REPORT_BUGS_TO);
644 /* Add a symbol to strip_specific_list.  */
657 /* Add symbols listed in `filename' to strip_specific_list.  */
726 		 loop to find the real end of the line.  */
740 	 then add it to the list.  */
766       /* Advance line pointer to end of line.  The 'eol ++' in the for
767 	 loop above will then advance us to the start of the next line.  */
805 /* Return a pointer to the symbol used as a signature for GROUP.  */
871 	 If we are going to strip the group signature symbol, then
905 /* Choose which symbol entries to copy; put the result in OSYMS.
907    Return the number of symbols to print.  */
913   asymbol **from = isyms, **to = osyms;
1004 	/* Global symbols in $idata sections need to be retained
1030 	  /* There are multiple ways to set 'keep' above, but if it
1082 	  to[dst_count++] = sym;
1086   to[dst_count] = NULL;
1105 /* Add a node to a symbol redefine list.  */
1135    from the file, and add them to the symbol redefine list.  */
1214 	  /* Append the redefinition to the list.  */
1278     printf (_("copy from `%s' [unknown] to `%s' [unknown]\n"),
1333     fatal (_("Unable to change endianness of input file(s)"));
1342     printf (_("copy from `%s' [%s] to `%s' [%s]\n"),
1358      need to be set for a core file.  */
1376   /* Copy architecture of input file to output file.  */
1384 	non_fatal (_("Unable to recognise the format of the input file `%s'"),
1508 	 have no way to distinguish PE from COFF here.  */
1536 				       /* FIXME: We ought to be using
1541 					  it is easier just to hard code it.  */
1544 	    /* Umm, not sure what to do in this case.  */
1559 	 the last section to a specified address.  We do this by
1561 	 increasing the section sizes as required to fill the gaps.
1620 		  non_fatal (_("Can't add padding to %s: %s"),
1689   /* This has to happen after the symbol table has been set.  */
1763      that needs to look at the section contents will fail.  */
1767   /* Allow the BFD backend to copy any private data it understands
1768      from the input BFD to the output BFD.  This is done last to
1769      permit the routine to look at the filtered symbol table, which is
1779   /* Switch to the alternate machine code.  We have to do this at the
1802    contents to temp file, and keep the temp file handle.
1821   /* Make a temp directory to hold the contents.  */
1910 	  non_fatal (_("Unable to recognise the format of the input file `%s'"),
1934 	  /* Open the newly output file and attach to our list.  */
1987   /* To allow us to do "strip *" without dying on the first
2052       /* Report the object error in preference to the core error.  */
2073 /* Add a name to the section renaming list.  */
2105    Also set RETURNED_FLAGS to the flags to be used for this section.  */
2114   /* Default to using the flags of the input section.  */
2129 /* Once each of the sections is copied, we may still need to do some
2137   /* Allow the BFD backend to copy any private data it understands
2138      from the input section to the output section.  */
2264      may have to recompute the header for the file as well.  */
2276   /* This used to be mangle_section; we do here to avoid using
2283      that needs to look at the section contents will fail.  */
2287   /* Allow the BFD backend to copy any private data it understands
2288      from the input section to the output section.  */
2314    to an output section with the same name in OBFD.
2349   /* Core files do not need to be relocated.  */
2413 	     must be a multiple of the number of bytes to swap.  */
2430 	    /* User must pad the section up in order to do this.  */
2439 	  char *to = memhunk;
2443 	    *to++ = *from;
2458       /* We don't permit the user to turn off the SEC_HAS_CONTENTS
2460 	 back again.  However, we do permit them to turn on the
2461 	 SEC_HAS_CONTENTS flag, and take it to mean that the section
2471 /* Get all the sections.  This is used when --gap-fill or --pad-to is
2484    --gap-fill or --pad-to is used.  We force non loadable or empty
2485    sections to the front, where they are easier to ignore.  */
2494   /* Sort non loadable sections to the front.  */
2614          the next thing the caller is going to do is copy over the
2615          real sections.  We may someday have to split the contents
2630   non_fatal (_("%s: don't know how to write debugging information for %s"),
2733   /* Default is to strip all symbols.  */
2760 	/* No need to check the return value of stat().
2771 	  non_fatal (_("could not create temporary file to hold stripped copy of '%s'"),
3103 		non_fatal (_("Warning: truncating gap-fill from 0x%s to 0x%x"),
3115 	  pad_to = parse_vma (optarg, "--pad-to");
3271 	    fatal (_("unable to parse alternative machine code"));
3316               fatal (_("number of bytes to reverse must be positive and even"));
3356   /* Default is to strip no symbols.  */