Mercurial > hg > index.cgi
comparison docs/manual/c858.html @ 234:d389adbcc4ab
Added section base and length symbols to lwlink
Added the ability for a link script to define section base and section
length symbols when linking. These symbols are searched for when an external
reference is resolved before looking up any symbols in the various objects
being linked. Also documented the new link script directives and added such
directives to all default link scripts.
| author | William Astle <lost@l-w.ca> |
|---|---|
| date | Fri, 10 Aug 2012 23:47:56 -0600 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 233:7887a48b74df | 234:d389adbcc4ab |
|---|---|
| 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> | |
| 2 <HTML | |
| 3 ><HEAD | |
| 4 ><TITLE | |
| 5 >Libraries and LWAR</TITLE | |
| 6 ><META | |
| 7 NAME="GENERATOR" | |
| 8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK | |
| 9 REL="HOME" | |
| 10 TITLE="LW Tool Chain" | |
| 11 HREF="index.html"><LINK | |
| 12 REL="PREVIOUS" | |
| 13 TITLE="Format Specific Linking Notes" | |
| 14 HREF="x843.html"><LINK | |
| 15 REL="NEXT" | |
| 16 TITLE="Object Files" | |
| 17 HREF="c920.html"></HEAD | |
| 18 ><BODY | |
| 19 CLASS="CHAPTER" | |
| 20 BGCOLOR="#FFFFFF" | |
| 21 TEXT="#000000" | |
| 22 LINK="#0000FF" | |
| 23 VLINK="#840084" | |
| 24 ALINK="#0000FF" | |
| 25 ><DIV | |
| 26 CLASS="NAVHEADER" | |
| 27 ><TABLE | |
| 28 SUMMARY="Header navigation table" | |
| 29 WIDTH="100%" | |
| 30 BORDER="0" | |
| 31 CELLPADDING="0" | |
| 32 CELLSPACING="0" | |
| 33 ><TR | |
| 34 ><TH | |
| 35 COLSPAN="3" | |
| 36 ALIGN="center" | |
| 37 >LW Tool Chain</TH | |
| 38 ></TR | |
| 39 ><TR | |
| 40 ><TD | |
| 41 WIDTH="10%" | |
| 42 ALIGN="left" | |
| 43 VALIGN="bottom" | |
| 44 ><A | |
| 45 HREF="x843.html" | |
| 46 ACCESSKEY="P" | |
| 47 >Prev</A | |
| 48 ></TD | |
| 49 ><TD | |
| 50 WIDTH="80%" | |
| 51 ALIGN="center" | |
| 52 VALIGN="bottom" | |
| 53 ></TD | |
| 54 ><TD | |
| 55 WIDTH="10%" | |
| 56 ALIGN="right" | |
| 57 VALIGN="bottom" | |
| 58 ><A | |
| 59 HREF="c920.html" | |
| 60 ACCESSKEY="N" | |
| 61 >Next</A | |
| 62 ></TD | |
| 63 ></TR | |
| 64 ></TABLE | |
| 65 ><HR | |
| 66 ALIGN="LEFT" | |
| 67 WIDTH="100%"></DIV | |
| 68 ><DIV | |
| 69 CLASS="CHAPTER" | |
| 70 ><H1 | |
| 71 ><A | |
| 72 NAME="AEN858" | |
| 73 ></A | |
| 74 >Chapter 5. Libraries and LWAR</H1 | |
| 75 ><P | |
| 76 >LWTOOLS also includes a tool for managing libraries. These are analogous to | |
| 77 the static libraries created with the "ar" tool on POSIX systems. Each library | |
| 78 file contains one or more object files. The linker will treat the object | |
| 79 files within a library as though they had been specified individually on | |
| 80 the command line except when resolving external references. External references | |
| 81 are looked up first within the object files within the library and then, if | |
| 82 not found, the usual lookup based on the order the files are specified on | |
| 83 the command line occurs.</P | |
| 84 ><P | |
| 85 >The tool for creating these libary files is called LWAR.</P | |
| 86 ><DIV | |
| 87 CLASS="SECTION" | |
| 88 ><H1 | |
| 89 CLASS="SECTION" | |
| 90 ><A | |
| 91 NAME="AEN862" | |
| 92 >5.1. Command Line Options</A | |
| 93 ></H1 | |
| 94 ><P | |
| 95 >The binary for LWAR is called "lwar". Note that the binary is in lower | |
| 96 case. The options lwar understands are listed below. For archive manipulation | |
| 97 options, the first non-option argument is the name of the archive. All other | |
| 98 non-option arguments are the names of files to operate on.</P | |
| 99 ><P | |
| 100 ></P | |
| 101 ><DIV | |
| 102 CLASS="VARIABLELIST" | |
| 103 ><DL | |
| 104 ><DT | |
| 105 ><CODE | |
| 106 CLASS="OPTION" | |
| 107 >--add</CODE | |
| 108 >, <CODE | |
| 109 CLASS="OPTION" | |
| 110 >-a</CODE | |
| 111 ></DT | |
| 112 ><DD | |
| 113 ><P | |
| 114 >This option specifies that an archive is going to have files added to it. | |
| 115 If the archive does not already exist, it is created. New files are added | |
| 116 to the end of the archive.</P | |
| 117 ></DD | |
| 118 ><DT | |
| 119 ><CODE | |
| 120 CLASS="OPTION" | |
| 121 >--create</CODE | |
| 122 >, <CODE | |
| 123 CLASS="OPTION" | |
| 124 >-c</CODE | |
| 125 ></DT | |
| 126 ><DD | |
| 127 ><P | |
| 128 >This option specifies that an archive is going to be created and have files | |
| 129 added to it. If the archive already exists, it is truncated.</P | |
| 130 ></DD | |
| 131 ><DT | |
| 132 ><CODE | |
| 133 CLASS="OPTION" | |
| 134 >--merge</CODE | |
| 135 >, <CODE | |
| 136 CLASS="OPTION" | |
| 137 >-m</CODE | |
| 138 ></DT | |
| 139 ><DD | |
| 140 ><P | |
| 141 >If specified, any files specified to be added to an archive will be checked | |
| 142 to see if they are archives themselves. If so, their constituent members are | |
| 143 added to the archive. This is useful for avoiding archives containing archives.</P | |
| 144 ></DD | |
| 145 ><DT | |
| 146 ><CODE | |
| 147 CLASS="OPTION" | |
| 148 >--list</CODE | |
| 149 >, <CODE | |
| 150 CLASS="OPTION" | |
| 151 >-l</CODE | |
| 152 ></DT | |
| 153 ><DD | |
| 154 ><P | |
| 155 >This will display a list of the files contained in the archive.</P | |
| 156 ></DD | |
| 157 ><DT | |
| 158 ><CODE | |
| 159 CLASS="OPTION" | |
| 160 >--debug</CODE | |
| 161 >, <CODE | |
| 162 CLASS="OPTION" | |
| 163 >-d</CODE | |
| 164 ></DT | |
| 165 ><DD | |
| 166 ><P | |
| 167 >This option increases the debugging level. It is only useful for LWTOOLS | |
| 168 developers.</P | |
| 169 ></DD | |
| 170 ><DT | |
| 171 ><CODE | |
| 172 CLASS="OPTION" | |
| 173 >--help</CODE | |
| 174 >, <CODE | |
| 175 CLASS="OPTION" | |
| 176 >-?</CODE | |
| 177 ></DT | |
| 178 ><DD | |
| 179 ><P | |
| 180 >This provides a listing of command line options and a brief description | |
| 181 of each.</P | |
| 182 ></DD | |
| 183 ><DT | |
| 184 ><CODE | |
| 185 CLASS="OPTION" | |
| 186 >--usage</CODE | |
| 187 ></DT | |
| 188 ><DD | |
| 189 ><P | |
| 190 >This will display a usage summary | |
| 191 of each command line option.</P | |
| 192 ></DD | |
| 193 ><DT | |
| 194 ><CODE | |
| 195 CLASS="OPTION" | |
| 196 >--version</CODE | |
| 197 >, <CODE | |
| 198 CLASS="OPTION" | |
| 199 >-V</CODE | |
| 200 ></DT | |
| 201 ><DD | |
| 202 ><P | |
| 203 >This will display the version of LWLINK. | |
| 204 of each.</P | |
| 205 ></DD | |
| 206 ></DL | |
| 207 ></DIV | |
| 208 ></DIV | |
| 209 ></DIV | |
| 210 ><DIV | |
| 211 CLASS="NAVFOOTER" | |
| 212 ><HR | |
| 213 ALIGN="LEFT" | |
| 214 WIDTH="100%"><TABLE | |
| 215 SUMMARY="Footer navigation table" | |
| 216 WIDTH="100%" | |
| 217 BORDER="0" | |
| 218 CELLPADDING="0" | |
| 219 CELLSPACING="0" | |
| 220 ><TR | |
| 221 ><TD | |
| 222 WIDTH="33%" | |
| 223 ALIGN="left" | |
| 224 VALIGN="top" | |
| 225 ><A | |
| 226 HREF="x843.html" | |
| 227 ACCESSKEY="P" | |
| 228 >Prev</A | |
| 229 ></TD | |
| 230 ><TD | |
| 231 WIDTH="34%" | |
| 232 ALIGN="center" | |
| 233 VALIGN="top" | |
| 234 ><A | |
| 235 HREF="index.html" | |
| 236 ACCESSKEY="H" | |
| 237 >Home</A | |
| 238 ></TD | |
| 239 ><TD | |
| 240 WIDTH="33%" | |
| 241 ALIGN="right" | |
| 242 VALIGN="top" | |
| 243 ><A | |
| 244 HREF="c920.html" | |
| 245 ACCESSKEY="N" | |
| 246 >Next</A | |
| 247 ></TD | |
| 248 ></TR | |
| 249 ><TR | |
| 250 ><TD | |
| 251 WIDTH="33%" | |
| 252 ALIGN="left" | |
| 253 VALIGN="top" | |
| 254 >Format Specific Linking Notes</TD | |
| 255 ><TD | |
| 256 WIDTH="34%" | |
| 257 ALIGN="center" | |
| 258 VALIGN="top" | |
| 259 > </TD | |
| 260 ><TD | |
| 261 WIDTH="33%" | |
| 262 ALIGN="right" | |
| 263 VALIGN="top" | |
| 264 >Object Files</TD | |
| 265 ></TR | |
| 266 ></TABLE | |
| 267 ></DIV | |
| 268 ></BODY | |
| 269 ></HTML | |
| 270 > |