1 /*****************************************************************************/
5 /* Library data structures and helpers for the ld65 linker */
9 /* (C) 1998-2001 Ullrich von Bassewitz */
11 /* D-70597 Stuttgart */
12 /* EMail: uz@cc65.org */
15 /* This software is provided 'as-is', without any expressed or implied */
16 /* warranty. In no event will the authors be held liable for any damages */
17 /* arising from the use of this software. */
19 /* Permission is granted to anyone to use this software for any purpose, */
20 /* including commercial applications, and to alter it and redistribute it */
21 /* freely, subject to the following restrictions: */
23 /* 1. The origin of this software must not be misrepresented; you must not */
24 /* claim that you wrote the original software. If you use this software */
25 /* in a product, an acknowledgment in the product documentation would be */
26 /* appreciated but is not required. */
27 /* 2. Altered source versions must be plainly marked as such, and must not */
28 /* be misrepresented as being the original software. */
29 /* 3. This notice may not be removed or altered from any source */
32 /*****************************************************************************/
58 /*****************************************************************************/
60 /*****************************************************************************/
66 static char* LibName = 0;
67 static unsigned ModuleCount = 0;
68 static ObjData** Index = 0;
72 /*****************************************************************************/
73 /* Reading file data structures */
74 /*****************************************************************************/
78 static void LibReadObjHeader (ObjData* O)
79 /* Read the header of the object file checking the signature */
81 O->Header.Magic = Read32 (Lib);
82 if (O->Header.Magic != OBJ_MAGIC) {
83 Error ("Object file `%s' in library `%s' is invalid",
84 GetObjFileName (O), LibName);
86 O->Header.Version = Read16 (Lib);
87 if (O->Header.Version != OBJ_VERSION) {
88 Error ("Object file `%s' in library `%s' has wrong version",
89 GetObjFileName (O), LibName);
91 O->Header.Flags = Read16 (Lib);
92 O->Header.OptionOffs = Read32 (Lib);
93 O->Header.OptionSize = Read32 (Lib);
94 O->Header.FileOffs = Read32 (Lib);
95 O->Header.FileSize = Read32 (Lib);
96 O->Header.SegOffs = Read32 (Lib);
97 O->Header.SegSize = Read32 (Lib);
98 O->Header.ImportOffs = Read32 (Lib);
99 O->Header.ImportSize = Read32 (Lib);
100 O->Header.ExportOffs = Read32 (Lib);
101 O->Header.ExportSize = Read32 (Lib);
102 O->Header.DbgSymOffs = Read32 (Lib);
103 O->Header.DbgSymSize = Read32 (Lib);
104 O->Header.LineInfoOffs = Read32 (Lib);
105 O->Header.LineInfoSize = Read32 (Lib);
110 static ObjData* ReadIndexEntry (void)
111 /* Read one entry in the index */
115 /* Create a new entry and insert it into the list */
116 ObjData* O = NewObjData ();
118 /* Module name/flags/MTime/Start/Size */
119 O->Name = ReadStr (Lib);
120 O->Flags = Read16 (Lib);
121 Read32 (Lib); /* Skip MTime */
122 O->Start = Read32 (Lib);
123 Read32 (Lib); /* Skip Size */
125 /* Skip the export size, then read the exports */
127 O->ExportCount = ReadVar (Lib);
128 O->Exports = xmalloc (O->ExportCount * sizeof (Export*));
129 for (I = 0; I < O->ExportCount; ++I) {
130 O->Exports [I] = ReadExport (Lib, O);
133 /* Skip the import size, then read the imports */
135 O->ImportCount = ReadVar (Lib);
136 O->Imports = xmalloc (O->ImportCount * sizeof (Import*));
137 for (I = 0; I < O->ImportCount; ++I) {
138 O->Imports [I] = ReadImport (Lib, O);
147 static void ReadIndex (void)
148 /* Read the index of a library file */
152 /* Read the object file count and allocate memory */
153 ModuleCount = Read16 (Lib);
154 Index = xmalloc (ModuleCount * sizeof (ObjData*));
156 /* Read all entries in the index */
157 for (I = 0; I < ModuleCount; ++I) {
158 Index [I] = ReadIndexEntry ();
164 /*****************************************************************************/
165 /* High level stuff */
166 /*****************************************************************************/
170 static void LibCheckExports (ObjData* O)
171 /* Check if the exports from this file can satisfy any import requests. If so,
172 * insert the imports and exports from this file and mark the file as added.
177 /* Check all exports */
178 for (I = 0; I < O->ExportCount; ++I) {
179 if (IsUnresolved (O->Exports [I]->Name)) {
180 /* We need this module */
186 /* If we need this module, insert the imports and exports */
187 if (O->Flags & OBJ_REF) {
188 /* Insert the exports */
189 for (I = 0; I < O->ExportCount; ++I) {
190 InsertExport (O->Exports [I]);
192 /* Insert the imports */
193 for (I = 0; I < O->ImportCount; ++I) {
194 InsertImport (O->Imports [I]);
201 void LibAdd (FILE* F, const char* Name)
202 /* Add files from the library to the list if there are references that could
210 /* Store the parameters, so they're visible for other routines */
212 LibName = xstrdup (Name);
214 /* Read the remaining header fields (magic is already read) */
215 Header.Magic = LIB_MAGIC;
216 Header.Version = Read16 (Lib);
217 if (Header.Version != LIB_VERSION) {
218 Error ("Wrong data version in `%s'", Name);
220 Header.Flags = Read16 (Lib);
221 Header.IndexOffs = Read32 (Lib);
223 /* Seek to the index position and read the index */
224 fseek (Lib, Header.IndexOffs, SEEK_SET);
227 /* Walk through all library modules and check for each module if there
228 * are unresolved externals in existing modules that may be resolved
229 * by adding the module. Repeat this step until no more object files
234 for (I = 0; I < ModuleCount; ++I) {
235 ObjData* O = Index [I];
236 if ((O->Flags & OBJ_REF) == 0) {
238 if (O->Flags & OBJ_REF) {
239 /* The routine added the file */
246 /* Add the files list and sections for all requested modules */
247 for (I = 0; I < ModuleCount; ++I) {
248 ObjData* O = Index [I];
249 if (O->Flags & OBJ_REF) {
251 /* Seek to the start of the object file and read the header */
252 fseek (Lib, O->Start, SEEK_SET);
253 LibReadObjHeader (O);
255 /* Seek to the start of the files list and read the files list */
256 fseek (Lib, O->Start + O->Header.FileOffs, SEEK_SET);
257 ObjReadFiles (Lib, O);
259 /* Seek to the start of the debug info and read the debug info */
260 fseek (Lib, O->Start + O->Header.DbgSymOffs, SEEK_SET);
261 ObjReadDbgSyms (Lib, O);
263 /* Seek to the start of the line infos and read them */
264 fseek (Lib, O->Start + O->Header.LineInfoOffs, SEEK_SET);
265 ObjReadLineInfos (Lib, O);
267 /* Seek to the start of the segment list and read the segments.
268 * This must be last, since the data here may reference other
271 fseek (Lib, O->Start + O->Header.SegOffs, SEEK_SET);
272 ObjReadSections (Lib, O);
274 /* We have the data now */
275 O->Flags |= OBJ_HAVEDATA;
279 /* Add a pointer to the library name */
280 O->LibName = LibName;
283 /* Done. Close the file, release allocated memory */