Mercurial > hg > index.cgi

comparison docs/manual/manual.html @ 316:c4853a54b4a1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented new "high" option for link scripts.
author William Astle <lost@l-w.ca>
date Wed, 27 Nov 2013 16:08:02 -0700
parents 155799f6cfa5
children b30091890d62
comparison
equal deleted inserted replaced
315:fcd103148aa6 316:c4853a54b4a1
196 HREF="#AEN807" 196 HREF="#AEN807"
197 >Linking Scripts</A 197 >Linking Scripts</A
198 ></DT 198 ></DT
199 ><DT 199 ><DT
200 >4.4. <A 200 >4.4. <A
201 HREF="#AEN864" 201 HREF="#AEN873"
202 >Format Specific Linking Notes</A 202 >Format Specific Linking Notes</A
203 ></DT 203 ></DT
204 ><DD 204 ><DD
205 ><DL 205 ><DL
206 ><DT 206 ><DT
207 >4.4.1. <A 207 >4.4.1. <A
208 HREF="#AEN867" 208 HREF="#AEN876"
209 >OS9 Modules</A 209 >OS9 Modules</A
210 ></DT 210 ></DT
211 ></DL 211 ></DL
212 ></DD 212 ></DD
213 ></DL 213 ></DL
214 ></DD 214 ></DD
215 ><DT 215 ><DT
216 >5. <A 216 >5. <A
217 HREF="#AEN879" 217 HREF="#AEN888"
218 >Libraries and LWAR</A 218 >Libraries and LWAR</A
219 ></DT 219 ></DT
220 ><DD 220 ><DD
221 ><DL 221 ><DL
222 ><DT 222 ><DT
223 >5.1. <A 223 >5.1. <A
224 HREF="#AEN883" 224 HREF="#AEN892"
225 >Command Line Options</A 225 >Command Line Options</A
226 ></DT 226 ></DT
227 ></DL 227 ></DL
228 ></DD 228 ></DD
229 ><DT 229 ><DT
241 ><B 241 ><B
242 >List of Tables</B 242 >List of Tables</B
243 ></DT 243 ></DT
244 ><DT 244 ><DT
245 >6-1. <A 245 >6-1. <A
246 HREF="#AEN966" 246 HREF="#AEN975"
247 >Object File Term Types</A 247 >Object File Term Types</A
248 ></DT 248 ></DT
249 ><DT 249 ><DT
250 >6-2. <A 250 >6-2. <A
251 HREF="#AEN996" 251 HREF="#AEN1005"
252 >Object File Operator Numbers</A 252 >Object File Operator Numbers</A
253 ></DT 253 ></DT
254 ></DL 254 ></DL
255 ></DIV 255 ></DIV
256 ><DIV 256 ><DIV
2648 ></DD 2648 ></DD
2649 ><DT 2649 ><DT
2650 >section <CODE 2650 >section <CODE
2651 CLASS="PARAMETER" 2651 CLASS="PARAMETER"
2652 >name</CODE 2652 >name</CODE
2653 > high <CODE
2654 CLASS="PARAMETER"
2655 >addr</CODE
2656 ></DT
2657 ><DD
2658 ><P
2659 >&#13;This causes the section <CODE
2660 CLASS="PARAMETER"
2661 >name</CODE
2662 > to load with its end
2663 address just below <CODE
2664 CLASS="PARAMETER"
2665 >addr</CODE
2666 >. Subsequent sections are
2667 loaded at progressively lower addresses. This may lead to inefficient file
2668 encoding for some targets. As of this writing, it will also almost
2669 certainly do the wrong thing for a raw target.&#13;</P
2670 ><P
2671 >&#13;This is useful for aligning a block of code with high memory. As an
2672 example, if the total size of a section is $100 bytes and a high address of
2673 $FE00 is specified, the section will actually load at $FD00.&#13;</P
2674 ></DD
2675 ><DT
2676 >section <CODE
2677 CLASS="PARAMETER"
2678 >name</CODE
2653 ></DT 2679 ></DT
2654 ><DD 2680 ><DD
2655 ><P 2681 ><P
2656 >&#13;This will cause the section <CODE 2682 >&#13;This will cause the section <CODE
2657 CLASS="PARAMETER" 2683 CLASS="PARAMETER"
2694 ><DIV 2720 ><DIV
2695 CLASS="SECTION" 2721 CLASS="SECTION"
2696 ><HR><H2 2722 ><HR><H2
2697 CLASS="SECTION" 2723 CLASS="SECTION"
2698 ><A 2724 ><A
2699 NAME="AEN864" 2725 NAME="AEN873"
2700 >4.4. Format Specific Linking Notes</A 2726 >4.4. Format Specific Linking Notes</A
2701 ></H2 2727 ></H2
2702 ><P 2728 ><P
2703 >Some formats require special information to be able to generate actual 2729 >Some formats require special information to be able to generate actual
2704 binaries. If the specific format you are interested in is not listed in 2730 binaries. If the specific format you are interested in is not listed in
2707 ><DIV 2733 ><DIV
2708 CLASS="SECTION" 2734 CLASS="SECTION"
2709 ><HR><H3 2735 ><HR><H3
2710 CLASS="SECTION" 2736 CLASS="SECTION"
2711 ><A 2737 ><A
2712 NAME="AEN867" 2738 NAME="AEN876"
2713 >4.4.1. OS9 Modules</A 2739 >4.4.1. OS9 Modules</A
2714 ></H3 2740 ></H3
2715 ><P 2741 ><P
2716 >OS9 modules need to embed several items into the module header. These 2742 >OS9 modules need to embed several items into the module header. These
2717 items are the type of module, the langauge of the module, the module 2743 items are the type of module, the langauge of the module, the module
2783 ></DIV 2809 ></DIV
2784 ><DIV 2810 ><DIV
2785 CLASS="CHAPTER" 2811 CLASS="CHAPTER"
2786 ><HR><H1 2812 ><HR><H1
2787 ><A 2813 ><A
2788 NAME="AEN879" 2814 NAME="AEN888"
2789 ></A 2815 ></A
2790 >Chapter 5. Libraries and LWAR</H1 2816 >Chapter 5. Libraries and LWAR</H1
2791 ><P 2817 ><P
2792 >LWTOOLS also includes a tool for managing libraries. These are analogous to 2818 >LWTOOLS also includes a tool for managing libraries. These are analogous to
2793 the static libraries created with the "ar" tool on POSIX systems. Each library 2819 the static libraries created with the "ar" tool on POSIX systems. Each library
2802 ><DIV 2828 ><DIV
2803 CLASS="SECTION" 2829 CLASS="SECTION"
2804 ><HR><H2 2830 ><HR><H2
2805 CLASS="SECTION" 2831 CLASS="SECTION"
2806 ><A 2832 ><A
2807 NAME="AEN883" 2833 NAME="AEN892"
2808 >5.1. Command Line Options</A 2834 >5.1. Command Line Options</A
2809 ></H2 2835 ></H2
2810 ><P 2836 ><P
2811 >The binary for LWAR is called "lwar". Note that the binary is in lower 2837 >The binary for LWAR is called "lwar". Note that the binary is in lower
2812 case. The options lwar understands are listed below. For archive manipulation 2838 case. The options lwar understands are listed below. For archive manipulation
3003 followed by any data required by the term. Then end of the list is flagged 3029 followed by any data required by the term. Then end of the list is flagged
3004 by a NULL expression (only an end of expression term).</P 3030 by a NULL expression (only an end of expression term).</P
3005 ><DIV 3031 ><DIV
3006 CLASS="TABLE" 3032 CLASS="TABLE"
3007 ><A 3033 ><A
3008 NAME="AEN966" 3034 NAME="AEN975"
3009 ></A 3035 ></A
3010 ><P 3036 ><P
3011 ><B 3037 ><B
3012 >Table 6-1. Object File Term Types</B 3038 >Table 6-1. Object File Term Types</B
3013 ></P 3039 ></P
3075 allows local symbols that are not exported to have the same names as 3101 allows local symbols that are not exported to have the same names as
3076 exported symbols or external references.</P 3102 exported symbols or external references.</P
3077 ><DIV 3103 ><DIV
3078 CLASS="TABLE" 3104 CLASS="TABLE"
3079 ><A 3105 ><A
3080 NAME="AEN996" 3106 NAME="AEN1005"
3081 ></A 3107 ></A
3082 ><P 3108 ><P
3083 ><B 3109 ><B
3084 >Table 6-2. Object File Operator Numbers</B 3110 >Table 6-2. Object File Operator Numbers</B
3085 ></P 3111 ></P