doc/Linker-Script-Commands.html

   1 <html lang="en">
   2 <head>
   3 <title>Linker Script Commands - The XORcyst Manual</title>
   4 <meta http-equiv="Content-Type" content="text/html">
   5 <meta name="description" content="The XORcyst Manual">
   6 <meta name="generator" content="makeinfo 4.7">
   7 <link title="Top" rel="start" href="index.html#Top">
   8 <link rel="prev" href="Assembler-Directives.html#Assembler-Directives" title="Assembler Directives">
   9 <link rel="next" href="Object-Code-Format.html#Object-Code-Format" title="Object Code Format">
  10 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
  11 <!--
  12 This is the manual for The XORcyst version 1.5.2.
  13
  14 Copyright (C) 2004, 2005, 2007, 2008, 2009 Kent Hansen.-->
  15 <meta http-equiv="Content-Style-Type" content="text/css">
  16 <style type="text/css"><!--
  17   pre.display { font-family:inherit }
  18   pre.format  { font-family:inherit }
  19   pre.smalldisplay { font-family:inherit; font-size:smaller }
  20   pre.smallformat  { font-family:inherit; font-size:smaller }
  21   pre.smallexample { font-size:smaller }
  22   pre.smalllisp    { font-size:smaller }
  23   span.sc { font-variant:small-caps }
  24   span.roman { font-family: serif; font-weight: normal; }
  25 --></style>
  26 </head>
  27 <body>
  28 <div class="node">
  29 <p>
  30 <a name="Linker-Script-Commands"></a>Next:&nbsp;<a rel="next" accesskey="n" href="Object-Code-Format.html#Object-Code-Format">Object Code Format</a>,
  31 Previous:&nbsp;<a rel="previous" accesskey="p" href="Assembler-Directives.html#Assembler-Directives">Assembler Directives</a>,
  32 Up:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
  33 <hr><br>
  34 </div>
  35
  36 <h2 class="appendix">Appendix C Linker Script Commands</h2>
  37
  38 <p>The following is an alphabetical listing of the script commands recognized by the linker and the arguments they may take. Note that not all arguments are mandatory and some are mutually exclusive.
  39
  40      <dl>
  41 <dt><code>bank { size=</code><var>size</var><code>, origin=</code><var>origin-address</var><code> }</code><dd>Start a new bank of size <var>size</var> bytes and set initial relocation address to <var>origin-address</var>.
  42
  43      <br><dt><code>copy { file=</code><var>filename</var><code> }</code><dd>Copy contents of <var>filename</var> to output.
  44
  45      <br><dt><code>link { file=</code><var>filename</var><code>, origin=</code><var>origin-address</var><code> }</code><dd>Relocate code in the unit <var>filename</var> to <var>origin-address</var> and copy the result to output. (If an origin is not specified, the internally managed linker origin is used.)
  46
  47      <!-- @item options -->
  48 <br><dt><code>output { file=</code><var>filename</var><code> }</code><dd>Set the linker output file.
  49
  50      <br><dt><code>pad { origin=</code><var>origin-address</var><code>, offset=</code><var>offset</var><code>, size=</code><var>size</var><code> }</code><dd>Pad to the given origin or bank offset, or pad <var>size</var> bytes (only one of the arguments should be given).
  51
  52      <br><dt><code>ram { start=</code><var>start-address</var><code>, end=</code><var>end-address</var><code> }</code><dd>Specify that 6502 RAM in the range <var>start-address</var>...<var>end-address</var> (non-inclusive) may be used by the linker to map contents of data segments.
  53
  54    </dl>
  55
  56    </body></html>
  57