| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <html> |
| <!-- This file documents the BFD library. |
| |
| Copyright (C) 1991 - 2013 Free Software Foundation, Inc. |
| |
| Permission is granted to copy, distribute and/or modify this document |
| under the terms of the GNU Free Documentation License, Version 1.3 or |
| any later version published by the Free Software Foundation; with the |
| Invariant Sections being "GNU General Public License" and "Funding |
| Free Software", the Front-Cover texts being (a) (see below), and with |
| the Back-Cover Texts being (b) (see below). A copy of the license is |
| included in the section entitled "GNU Free Documentation License". |
| |
| (a) The FSF's Front-Cover Text is: |
| |
| A GNU Manual |
| |
| (b) The FSF's Back-Cover Text is: |
| |
| You have freedom to copy and modify this GNU Manual, like GNU |
| software. Copies published by the Free Software Foundation raise |
| funds for GNU development. --> |
| <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ --> |
| <head> |
| <title>Untitled Document: Miscellaneous</title> |
| |
| <meta name="description" content="Untitled Document: Miscellaneous"> |
| <meta name="keywords" content="Untitled Document: Miscellaneous"> |
| <meta name="resource-type" content="document"> |
| <meta name="distribution" content="global"> |
| <meta name="Generator" content="makeinfo"> |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> |
| <link href="index.html#Top" rel="start" title="Top"> |
| <link href="BFD-Index.html#BFD-Index" rel="index" title="BFD Index"> |
| <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> |
| <link href="BFD-front-end.html#BFD-front-end" rel="up" title="BFD front end"> |
| <link href="Memory-Usage.html#Memory-Usage" rel="next" title="Memory Usage"> |
| <link href="Error-reporting.html#Error-reporting" rel="prev" title="Error reporting"> |
| <style type="text/css"> |
| <!-- |
| a.summary-letter {text-decoration: none} |
| blockquote.smallquotation {font-size: smaller} |
| div.display {margin-left: 3.2em} |
| div.example {margin-left: 3.2em} |
| div.indentedblock {margin-left: 3.2em} |
| div.lisp {margin-left: 3.2em} |
| div.smalldisplay {margin-left: 3.2em} |
| div.smallexample {margin-left: 3.2em} |
| div.smallindentedblock {margin-left: 3.2em; font-size: smaller} |
| div.smalllisp {margin-left: 3.2em} |
| kbd {font-style:oblique} |
| pre.display {font-family: inherit} |
| pre.format {font-family: inherit} |
| pre.menu-comment {font-family: serif} |
| pre.menu-preformatted {font-family: serif} |
| pre.smalldisplay {font-family: inherit; font-size: smaller} |
| pre.smallexample {font-size: smaller} |
| pre.smallformat {font-family: inherit; font-size: smaller} |
| pre.smalllisp {font-size: smaller} |
| span.nocodebreak {white-space:nowrap} |
| span.nolinebreak {white-space:nowrap} |
| span.roman {font-family:serif; font-weight:normal} |
| span.sansserif {font-family:sans-serif; font-weight:normal} |
| ul.no-bullet {list-style: none} |
| --> |
| </style> |
| |
| |
| </head> |
| |
| <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> |
| <a name="Miscellaneous"></a> |
| <div class="header"> |
| <p> |
| Next: <a href="Memory-Usage.html#Memory-Usage" accesskey="n" rel="next">Memory Usage</a>, Previous: <a href="Error-reporting.html#Error-reporting" accesskey="p" rel="prev">Error reporting</a>, Up: <a href="BFD-front-end.html#BFD-front-end" accesskey="u" rel="up">BFD front end</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="BFD-Index.html#BFD-Index" title="Index" rel="index">Index</a>]</p> |
| </div> |
| <hr> |
| <a name="Miscellaneous-1"></a> |
| <h3 class="section">2.3 Miscellaneous</h3> |
| |
| |
| <a name="Miscellaneous-functions"></a> |
| <h4 class="subsection">2.3.1 Miscellaneous functions</h4> |
| |
| |
| <a name="index-bfd_005fget_005freloc_005fupper_005fbound"></a> |
| <a name="bfd_005fget_005freloc_005fupper_005fbound"></a> |
| <h4 class="subsubsection">2.3.1.1 <code>bfd_get_reloc_upper_bound</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">long bfd_get_reloc_upper_bound (bfd *abfd, asection *sect); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Return the number of bytes required to store the |
| relocation information associated with section <var>sect</var> |
| attached to bfd <var>abfd</var>. If an error occurs, return -1. |
| </p> |
| <a name="index-bfd_005fcanonicalize_005freloc"></a> |
| <a name="bfd_005fcanonicalize_005freloc"></a> |
| <h4 class="subsubsection">2.3.1.2 <code>bfd_canonicalize_reloc</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">long bfd_canonicalize_reloc |
| (bfd *abfd, asection *sec, arelent **loc, asymbol **syms); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Call the back end associated with the open BFD |
| <var>abfd</var> and translate the external form of the relocation |
| information attached to <var>sec</var> into the internal canonical |
| form. Place the table into memory at <var>loc</var>, which has |
| been preallocated, usually by a call to |
| <code>bfd_get_reloc_upper_bound</code>. Returns the number of relocs, or |
| -1 on error. |
| </p> |
| <p>The <var>syms</var> table is also needed for horrible internal magic |
| reasons. |
| </p> |
| <a name="index-bfd_005fset_005freloc"></a> |
| <a name="bfd_005fset_005freloc"></a> |
| <h4 class="subsubsection">2.3.1.3 <code>bfd_set_reloc</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">void bfd_set_reloc |
| (bfd *abfd, asection *sec, arelent **rel, unsigned int count); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Set the relocation pointer and count within |
| section <var>sec</var> to the values <var>rel</var> and <var>count</var>. |
| The argument <var>abfd</var> is ignored. |
| </p> |
| <a name="index-bfd_005fset_005ffile_005fflags"></a> |
| <a name="bfd_005fset_005ffile_005fflags"></a> |
| <h4 class="subsubsection">2.3.1.4 <code>bfd_set_file_flags</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_boolean bfd_set_file_flags (bfd *abfd, flagword flags); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Set the flag word in the BFD <var>abfd</var> to the value <var>flags</var>. |
| </p> |
| <p>Possible errors are: |
| </p><ul> |
| <li> <code>bfd_error_wrong_format</code> - The target bfd was not of object format. |
| </li><li> <code>bfd_error_invalid_operation</code> - The target bfd was open for reading. |
| </li><li> <code>bfd_error_invalid_operation</code> - |
| The flag word contained a bit which was not applicable to the |
| type of file. E.g., an attempt was made to set the <code>D_PAGED</code> bit |
| on a BFD format which does not support demand paging. |
| </li></ul> |
| |
| <a name="index-bfd_005fget_005farch_005fsize"></a> |
| <a name="bfd_005fget_005farch_005fsize"></a> |
| <h4 class="subsubsection">2.3.1.5 <code>bfd_get_arch_size</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">int bfd_get_arch_size (bfd *abfd); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Returns the architecture address size, in bits, as determined |
| by the object file’s format. For ELF, this information is |
| included in the header. |
| </p> |
| <p><strong>Returns</strong><br> |
| Returns the arch size in bits if known, <code>-1</code> otherwise. |
| </p> |
| <a name="index-bfd_005fget_005fsign_005fextend_005fvma"></a> |
| <a name="bfd_005fget_005fsign_005fextend_005fvma"></a> |
| <h4 class="subsubsection">2.3.1.6 <code>bfd_get_sign_extend_vma</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">int bfd_get_sign_extend_vma (bfd *abfd); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Indicates if the target architecture "naturally" sign extends |
| an address. Some architectures implicitly sign extend address |
| values when they are converted to types larger than the size |
| of an address. For instance, bfd_get_start_address() will |
| return an address sign extended to fill a bfd_vma when this is |
| the case. |
| </p> |
| <p><strong>Returns</strong><br> |
| Returns <code>1</code> if the target architecture is known to sign |
| extend addresses, <code>0</code> if the target architecture is known to |
| not sign extend addresses, and <code>-1</code> otherwise. |
| </p> |
| <a name="index-bfd_005fset_005fstart_005faddress"></a> |
| <a name="bfd_005fset_005fstart_005faddress"></a> |
| <h4 class="subsubsection">2.3.1.7 <code>bfd_set_start_address</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_boolean bfd_set_start_address (bfd *abfd, bfd_vma vma); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Make <var>vma</var> the entry point of output BFD <var>abfd</var>. |
| </p> |
| <p><strong>Returns</strong><br> |
| Returns <code>TRUE</code> on success, <code>FALSE</code> otherwise. |
| </p> |
| <a name="index-bfd_005fget_005fgp_005fsize"></a> |
| <a name="bfd_005fget_005fgp_005fsize"></a> |
| <h4 class="subsubsection">2.3.1.8 <code>bfd_get_gp_size</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">unsigned int bfd_get_gp_size (bfd *abfd); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Return the maximum size of objects to be optimized using the GP |
| register under MIPS ECOFF. This is typically set by the <code>-G</code> |
| argument to the compiler, assembler or linker. |
| </p> |
| <a name="index-bfd_005fset_005fgp_005fsize"></a> |
| <a name="bfd_005fset_005fgp_005fsize"></a> |
| <h4 class="subsubsection">2.3.1.9 <code>bfd_set_gp_size</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">void bfd_set_gp_size (bfd *abfd, unsigned int i); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Set the maximum size of objects to be optimized using the GP |
| register under ECOFF or MIPS ELF. This is typically set by |
| the <code>-G</code> argument to the compiler, assembler or linker. |
| </p> |
| <a name="index-bfd_005fscan_005fvma"></a> |
| <a name="bfd_005fscan_005fvma"></a> |
| <h4 class="subsubsection">2.3.1.10 <code>bfd_scan_vma</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_vma bfd_scan_vma (const char *string, const char **end, int base); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Convert, like <code>strtoul</code>, a numerical expression |
| <var>string</var> into a <code>bfd_vma</code> integer, and return that integer. |
| (Though without as many bells and whistles as <code>strtoul</code>.) |
| The expression is assumed to be unsigned (i.e., positive). |
| If given a <var>base</var>, it is used as the base for conversion. |
| A base of 0 causes the function to interpret the string |
| in hex if a leading "0x" or "0X" is found, otherwise |
| in octal if a leading zero is found, otherwise in decimal. |
| </p> |
| <p>If the value would overflow, the maximum <code>bfd_vma</code> value is |
| returned. |
| </p> |
| <a name="index-bfd_005fcopy_005fprivate_005fheader_005fdata"></a> |
| <a name="bfd_005fcopy_005fprivate_005fheader_005fdata"></a> |
| <h4 class="subsubsection">2.3.1.11 <code>bfd_copy_private_header_data</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_boolean bfd_copy_private_header_data (bfd *ibfd, bfd *obfd); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Copy private BFD header information from the BFD <var>ibfd</var> to the |
| the BFD <var>obfd</var>. This copies information that may require |
| sections to exist, but does not require symbol tables. Return |
| <code>true</code> on success, <code>false</code> on error. |
| Possible error returns are: |
| </p> |
| <ul> |
| <li> <code>bfd_error_no_memory</code> - |
| Not enough memory exists to create private data for <var>obfd</var>. |
| </li></ul> |
| <div class="example"> |
| <pre class="example">#define bfd_copy_private_header_data(ibfd, obfd) \ |
| BFD_SEND (obfd, _bfd_copy_private_header_data, \ |
| (ibfd, obfd)) |
| </pre></div> |
| |
| <a name="index-bfd_005fcopy_005fprivate_005fbfd_005fdata"></a> |
| <a name="bfd_005fcopy_005fprivate_005fbfd_005fdata"></a> |
| <h4 class="subsubsection">2.3.1.12 <code>bfd_copy_private_bfd_data</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_boolean bfd_copy_private_bfd_data (bfd *ibfd, bfd *obfd); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Copy private BFD information from the BFD <var>ibfd</var> to the |
| the BFD <var>obfd</var>. Return <code>TRUE</code> on success, <code>FALSE</code> on error. |
| Possible error returns are: |
| </p> |
| <ul> |
| <li> <code>bfd_error_no_memory</code> - |
| Not enough memory exists to create private data for <var>obfd</var>. |
| </li></ul> |
| <div class="example"> |
| <pre class="example">#define bfd_copy_private_bfd_data(ibfd, obfd) \ |
| BFD_SEND (obfd, _bfd_copy_private_bfd_data, \ |
| (ibfd, obfd)) |
| </pre></div> |
| |
| <a name="index-bfd_005fmerge_005fprivate_005fbfd_005fdata"></a> |
| <a name="bfd_005fmerge_005fprivate_005fbfd_005fdata"></a> |
| <h4 class="subsubsection">2.3.1.13 <code>bfd_merge_private_bfd_data</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_boolean bfd_merge_private_bfd_data (bfd *ibfd, bfd *obfd); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Merge private BFD information from the BFD <var>ibfd</var> to the |
| the output file BFD <var>obfd</var> when linking. Return <code>TRUE</code> |
| on success, <code>FALSE</code> on error. Possible error returns are: |
| </p> |
| <ul> |
| <li> <code>bfd_error_no_memory</code> - |
| Not enough memory exists to create private data for <var>obfd</var>. |
| </li></ul> |
| <div class="example"> |
| <pre class="example">#define bfd_merge_private_bfd_data(ibfd, obfd) \ |
| BFD_SEND (obfd, _bfd_merge_private_bfd_data, \ |
| (ibfd, obfd)) |
| </pre></div> |
| |
| <a name="index-bfd_005fset_005fprivate_005fflags"></a> |
| <a name="bfd_005fset_005fprivate_005fflags"></a> |
| <h4 class="subsubsection">2.3.1.14 <code>bfd_set_private_flags</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_boolean bfd_set_private_flags (bfd *abfd, flagword flags); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Set private BFD flag information in the BFD <var>abfd</var>. |
| Return <code>TRUE</code> on success, <code>FALSE</code> on error. Possible error |
| returns are: |
| </p> |
| <ul> |
| <li> <code>bfd_error_no_memory</code> - |
| Not enough memory exists to create private data for <var>obfd</var>. |
| </li></ul> |
| <div class="example"> |
| <pre class="example">#define bfd_set_private_flags(abfd, flags) \ |
| BFD_SEND (abfd, _bfd_set_private_flags, (abfd, flags)) |
| </pre></div> |
| |
| <a name="index-Other-functions"></a> |
| <a name="Other-functions"></a> |
| <h4 class="subsubsection">2.3.1.15 <code>Other functions</code></h4> |
| <p><strong>Description</strong><br> |
| The following functions exist but have not yet been documented. |
| </p><div class="example"> |
| <pre class="example">#define bfd_sizeof_headers(abfd, info) \ |
| BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, info)) |
| |
| #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \ |
| BFD_SEND (abfd, _bfd_find_nearest_line, \ |
| (abfd, sec, syms, off, file, func, line)) |
| |
| #define bfd_find_nearest_line_discriminator(abfd, sec, syms, off, file, func, \ |
| line, disc) \ |
| BFD_SEND (abfd, _bfd_find_nearest_line_discriminator, \ |
| (abfd, sec, syms, off, file, func, line, disc)) |
| |
| #define bfd_find_line(abfd, syms, sym, file, line) \ |
| BFD_SEND (abfd, _bfd_find_line, \ |
| (abfd, syms, sym, file, line)) |
| |
| #define bfd_find_inliner_info(abfd, file, func, line) \ |
| BFD_SEND (abfd, _bfd_find_inliner_info, \ |
| (abfd, file, func, line)) |
| |
| #define bfd_debug_info_start(abfd) \ |
| BFD_SEND (abfd, _bfd_debug_info_start, (abfd)) |
| |
| #define bfd_debug_info_end(abfd) \ |
| BFD_SEND (abfd, _bfd_debug_info_end, (abfd)) |
| |
| #define bfd_debug_info_accumulate(abfd, section) \ |
| BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section)) |
| |
| #define bfd_stat_arch_elt(abfd, stat) \ |
| BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat)) |
| |
| #define bfd_update_armap_timestamp(abfd) \ |
| BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd)) |
| |
| #define bfd_set_arch_mach(abfd, arch, mach)\ |
| BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach)) |
| |
| #define bfd_relax_section(abfd, section, link_info, again) \ |
| BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again)) |
| |
| #define bfd_gc_sections(abfd, link_info) \ |
| BFD_SEND (abfd, _bfd_gc_sections, (abfd, link_info)) |
| |
| #define bfd_lookup_section_flags(link_info, flag_info, section) \ |
| BFD_SEND (abfd, _bfd_lookup_section_flags, (link_info, flag_info, section)) |
| |
| #define bfd_merge_sections(abfd, link_info) \ |
| BFD_SEND (abfd, _bfd_merge_sections, (abfd, link_info)) |
| |
| #define bfd_is_group_section(abfd, sec) \ |
| BFD_SEND (abfd, _bfd_is_group_section, (abfd, sec)) |
| |
| #define bfd_discard_group(abfd, sec) \ |
| BFD_SEND (abfd, _bfd_discard_group, (abfd, sec)) |
| |
| #define bfd_link_hash_table_create(abfd) \ |
| BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd)) |
| |
| #define bfd_link_hash_table_free(abfd, hash) \ |
| BFD_SEND (abfd, _bfd_link_hash_table_free, (hash)) |
| |
| #define bfd_link_add_symbols(abfd, info) \ |
| BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info)) |
| |
| #define bfd_link_just_syms(abfd, sec, info) \ |
| BFD_SEND (abfd, _bfd_link_just_syms, (sec, info)) |
| |
| #define bfd_final_link(abfd, info) \ |
| BFD_SEND (abfd, _bfd_final_link, (abfd, info)) |
| |
| #define bfd_free_cached_info(abfd) \ |
| BFD_SEND (abfd, _bfd_free_cached_info, (abfd)) |
| |
| #define bfd_get_dynamic_symtab_upper_bound(abfd) \ |
| BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd)) |
| |
| #define bfd_print_private_bfd_data(abfd, file)\ |
| BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file)) |
| |
| #define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \ |
| BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols)) |
| |
| #define bfd_get_synthetic_symtab(abfd, count, syms, dyncount, dynsyms, ret) \ |
| BFD_SEND (abfd, _bfd_get_synthetic_symtab, (abfd, count, syms, \ |
| dyncount, dynsyms, ret)) |
| |
| #define bfd_get_dynamic_reloc_upper_bound(abfd) \ |
| BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd)) |
| |
| #define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \ |
| BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms)) |
| |
| extern bfd_byte *bfd_get_relocated_section_contents |
| (bfd *, struct bfd_link_info *, struct bfd_link_order *, bfd_byte *, |
| bfd_boolean, asymbol **); |
| |
| </pre></div> |
| |
| <a name="index-bfd_005falt_005fmach_005fcode"></a> |
| <a name="bfd_005falt_005fmach_005fcode"></a> |
| <h4 class="subsubsection">2.3.1.16 <code>bfd_alt_mach_code</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_boolean bfd_alt_mach_code (bfd *abfd, int alternative); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| When more than one machine code number is available for the |
| same machine type, this function can be used to switch between |
| the preferred one (alternative == 0) and any others. Currently, |
| only ELF supports this feature, with up to two alternate |
| machine codes. |
| </p> |
| <a name="index-bfd_005femul_005fget_005fmaxpagesize"></a> |
| <a name="bfd_005femul_005fget_005fmaxpagesize"></a> |
| <h4 class="subsubsection">2.3.1.17 <code>bfd_emul_get_maxpagesize</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_vma bfd_emul_get_maxpagesize (const char *); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Returns the maximum page size, in bytes, as determined by |
| emulation. |
| </p> |
| <p><strong>Returns</strong><br> |
| Returns the maximum page size in bytes for ELF, 0 otherwise. |
| </p> |
| <a name="index-bfd_005femul_005fset_005fmaxpagesize"></a> |
| <a name="bfd_005femul_005fset_005fmaxpagesize"></a> |
| <h4 class="subsubsection">2.3.1.18 <code>bfd_emul_set_maxpagesize</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">void bfd_emul_set_maxpagesize (const char *, bfd_vma); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| For ELF, set the maximum page size for the emulation. It is |
| a no-op for other formats. |
| </p> |
| <a name="index-bfd_005femul_005fget_005fcommonpagesize"></a> |
| <a name="bfd_005femul_005fget_005fcommonpagesize"></a> |
| <h4 class="subsubsection">2.3.1.19 <code>bfd_emul_get_commonpagesize</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">bfd_vma bfd_emul_get_commonpagesize (const char *); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Returns the common page size, in bytes, as determined by |
| emulation. |
| </p> |
| <p><strong>Returns</strong><br> |
| Returns the common page size in bytes for ELF, 0 otherwise. |
| </p> |
| <a name="index-bfd_005femul_005fset_005fcommonpagesize"></a> |
| <a name="bfd_005femul_005fset_005fcommonpagesize"></a> |
| <h4 class="subsubsection">2.3.1.20 <code>bfd_emul_set_commonpagesize</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">void bfd_emul_set_commonpagesize (const char *, bfd_vma); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| For ELF, set the common page size for the emulation. It is |
| a no-op for other formats. |
| </p> |
| <a name="index-bfd_005fdemangle"></a> |
| <a name="bfd_005fdemangle"></a> |
| <h4 class="subsubsection">2.3.1.21 <code>bfd_demangle</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">char *bfd_demangle (bfd *, const char *, int); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Wrapper around cplus_demangle. Strips leading underscores and |
| other such chars that would otherwise confuse the demangler. |
| If passed a g++ v3 ABI mangled name, returns a buffer allocated |
| with malloc holding the demangled name. Returns NULL otherwise |
| and on memory alloc failure. |
| </p> |
| <a name="index-struct-bfd_005fiovec"></a> |
| <a name="struct-bfd_005fiovec"></a> |
| <h4 class="subsubsection">2.3.1.22 <code>struct bfd_iovec</code></h4> |
| <p><strong>Description</strong><br> |
| The <code>struct bfd_iovec</code> contains the internal file I/O class. |
| Each <code>BFD</code> has an instance of this class and all file I/O is |
| routed through it (it is assumed that the instance implements |
| all methods listed below). |
| </p><div class="example"> |
| <pre class="example">struct bfd_iovec |
| { |
| /* To avoid problems with macros, a "b" rather than "f" |
| prefix is prepended to each method name. */ |
| /* Attempt to read/write NBYTES on ABFD's IOSTREAM storing/fetching |
| bytes starting at PTR. Return the number of bytes actually |
| transfered (a read past end-of-file returns less than NBYTES), |
| or -1 (setting <code>bfd_error</code>) if an error occurs. */ |
| file_ptr (*bread) (struct bfd *abfd, void *ptr, file_ptr nbytes); |
| file_ptr (*bwrite) (struct bfd *abfd, const void *ptr, |
| file_ptr nbytes); |
| /* Return the current IOSTREAM file offset, or -1 (setting <code>bfd_error</code> |
| if an error occurs. */ |
| file_ptr (*btell) (struct bfd *abfd); |
| /* For the following, on successful completion a value of 0 is returned. |
| Otherwise, a value of -1 is returned (and <code>bfd_error</code> is set). */ |
| int (*bseek) (struct bfd *abfd, file_ptr offset, int whence); |
| int (*bclose) (struct bfd *abfd); |
| int (*bflush) (struct bfd *abfd); |
| int (*bstat) (struct bfd *abfd, struct stat *sb); |
| /* Mmap a part of the files. ADDR, LEN, PROT, FLAGS and OFFSET are the usual |
| mmap parameter, except that LEN and OFFSET do not need to be page |
| aligned. Returns (void *)-1 on failure, mmapped address on success. |
| Also write in MAP_ADDR the address of the page aligned buffer and in |
| MAP_LEN the size mapped (a page multiple). Use unmap with MAP_ADDR and |
| MAP_LEN to unmap. */ |
| void *(*bmmap) (struct bfd *abfd, void *addr, bfd_size_type len, |
| int prot, int flags, file_ptr offset, |
| void **map_addr, bfd_size_type *map_len); |
| }; |
| extern const struct bfd_iovec _bfd_memory_iovec; |
| </pre></div> |
| |
| <a name="index-bfd_005fget_005fmtime"></a> |
| <a name="bfd_005fget_005fmtime"></a> |
| <h4 class="subsubsection">2.3.1.23 <code>bfd_get_mtime</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">long bfd_get_mtime (bfd *abfd); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Return the file modification time (as read from the file system, or |
| from the archive header for archive members). |
| </p> |
| <a name="index-bfd_005fget_005fsize"></a> |
| <a name="bfd_005fget_005fsize"></a> |
| <h4 class="subsubsection">2.3.1.24 <code>bfd_get_size</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">file_ptr bfd_get_size (bfd *abfd); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Return the file size (as read from file system) for the file |
| associated with BFD <var>abfd</var>. |
| </p> |
| <p>The initial motivation for, and use of, this routine is not |
| so we can get the exact size of the object the BFD applies to, since |
| that might not be generally possible (archive members for example). |
| It would be ideal if someone could eventually modify |
| it so that such results were guaranteed. |
| </p> |
| <p>Instead, we want to ask questions like "is this NNN byte sized |
| object I’m about to try read from file offset YYY reasonable?" |
| As as example of where we might do this, some object formats |
| use string tables for which the first <code>sizeof (long)</code> bytes of the |
| table contain the size of the table itself, including the size bytes. |
| If an application tries to read what it thinks is one of these |
| string tables, without some way to validate the size, and for |
| some reason the size is wrong (byte swapping error, wrong location |
| for the string table, etc.), the only clue is likely to be a read |
| error when it tries to read the table, or a "virtual memory |
| exhausted" error when it tries to allocate 15 bazillon bytes |
| of space for the 15 bazillon byte table it is about to read. |
| This function at least allows us to answer the question, "is the |
| size reasonable?". |
| </p> |
| <a name="index-bfd_005fmmap"></a> |
| <a name="bfd_005fmmap"></a> |
| <h4 class="subsubsection">2.3.1.25 <code>bfd_mmap</code></h4> |
| <p><strong>Synopsis</strong> |
| </p><div class="example"> |
| <pre class="example">void *bfd_mmap (bfd *abfd, void *addr, bfd_size_type len, |
| int prot, int flags, file_ptr offset, |
| void **map_addr, bfd_size_type *map_len); |
| </pre></div> |
| <p><strong>Description</strong><br> |
| Return mmap()ed region of the file, if possible and implemented. |
| LEN and OFFSET do not need to be page aligned. The page aligned |
| address and length are written to MAP_ADDR and MAP_LEN. |
| </p> |
| |
| <hr> |
| <div class="header"> |
| <p> |
| Next: <a href="Memory-Usage.html#Memory-Usage" accesskey="n" rel="next">Memory Usage</a>, Previous: <a href="Error-reporting.html#Error-reporting" accesskey="p" rel="prev">Error reporting</a>, Up: <a href="BFD-front-end.html#BFD-front-end" accesskey="u" rel="up">BFD front end</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="BFD-Index.html#BFD-Index" title="Index" rel="index">Index</a>]</p> |
| </div> |
| |
| |
| |
| </body> |
| </html> |
