1 /*****************************************************************************/
5 /* Handling object file data for the ld65 linker */
9 /* (C) 1998-2011, Ullrich von Bassewitz */
10 /* Roemerstrasse 52 */
11 /* D-70794 Filderstadt */
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 /*****************************************************************************/
52 /*****************************************************************************/
54 /*****************************************************************************/
58 /* Collection containing used ObjData objects */
59 Collection ObjDataList = STATIC_COLLECTION_INITIALIZER;
63 /*****************************************************************************/
65 /*****************************************************************************/
69 ObjData* NewObjData (void)
70 /* Allocate a new structure on the heap, insert it into the list, return it */
73 ObjData* O = xmalloc (sizeof (ObjData));
75 /* Initialize the data */
77 O->Name = INVALID_STRING_ID;
84 O->Files = EmptyCollection;
85 O->Sections = EmptyCollection;
86 O->Exports = EmptyCollection;
87 O->Imports = EmptyCollection;
88 O->DbgSyms = EmptyCollection;
89 O->LineInfos = EmptyCollection;
92 O->Assertions = EmptyCollection;
93 O->Scopes = EmptyCollection;
95 /* Return the new entry */
101 void FreeObjData (ObjData* O)
102 /* Free an ObjData object. NOTE: This function works only for unused object
103 * data, that is, ObjData objects that aren't used because they aren't
109 for (I = 0; I < CollCount (&O->Files); ++I) {
110 CollDeleteItem (&((FileInfo*) CollAtUnchecked (&O->Files, I))->Modules, O);
112 DoneCollection (&O->Files);
113 DoneCollection (&O->Sections);
114 for (I = 0; I < CollCount (&O->Exports); ++I) {
115 FreeExport (CollAtUnchecked (&O->Exports, I));
117 DoneCollection (&O->Exports);
118 for (I = 0; I < CollCount (&O->Imports); ++I) {
119 FreeImport (CollAtUnchecked (&O->Imports, I));
121 DoneCollection (&O->Imports);
122 DoneCollection (&O->DbgSyms);
124 for (I = 0; I < CollCount (&O->LineInfos); ++I) {
125 FreeLineInfo (CollAtUnchecked (&O->LineInfos, I));
127 DoneCollection (&O->LineInfos);
129 DoneCollection (&O->Assertions);
130 DoneCollection (&O->Scopes);
136 void FreeObjStrings (ObjData* O)
137 /* Free the module string data. Used once the object file is loaded completely
138 * when all strings are converted to global strings.
147 void InsertObjData (ObjData* O)
148 /* Insert the ObjData object into the collection of used ObjData objects. */
150 CollAppend (&ObjDataList, O);
155 void InsertObjGlobals (ObjData* O)
156 /* Insert imports and exports from the object file into the global import and
162 /* Insert exports and imports */
163 for (I = 0; I < CollCount (&O->Exports); ++I) {
164 InsertExport (CollAt (&O->Exports, I));
166 for (I = 0; I < CollCount (&O->Imports); ++I) {
167 InsertImport (CollAt (&O->Imports, I));
173 unsigned MakeGlobalStringId (const ObjData* O, unsigned Index)
174 /* Convert a local string id into a global one and return it. */
176 if (Index >= O->StringCount) {
177 Error ("Invalid string index (%u) in module `%s'",
178 Index, GetObjFileName (O));
180 return O->Strings[Index];
185 const char* GetObjFileName (const ObjData* O)
186 /* Get the name of the object file. Return "[linker generated]" if the object
190 return O? GetString (O->Name) : "[linker generated]";
195 struct Section* GetObjSection (ObjData* O, unsigned Id)
196 /* Get a section from an object file checking for a valid index */
198 if (Id >= CollCount (&O->Sections)) {
199 Error ("Invalid section index (%u) in module `%s'",
200 Id, GetObjFileName (O));
202 return CollAtUnchecked (&O->Sections, Id);
207 struct Scope* GetObjScope (ObjData* O, unsigned Id)
208 /* Get a scope from an object file checking for a valid index */
210 if (Id >= CollCount (&O->Scopes)) {
211 Error ("Invalid scope index (%u) in module `%s'",
212 Id, GetObjFileName (O));
214 return CollAtUnchecked (&O->Scopes, Id);
219 void PrintDbgModules (FILE* F)
220 /* Output the modules to a debug info file */
225 for (I = 0; I < CollCount (&ObjDataList); ++I) {
227 /* Get this object file */
228 const ObjData* O = CollConstAt (&ObjDataList, I);
230 /* The main source file is the one at index zero */
231 const FileInfo* Source = CollConstAt (&O->Files, 0);
233 /* Output the module line */
235 "mod\tid=%u,name=\"%s\",file=%u",
240 /* Add library if any */
242 fprintf (F, ",lib=%u", GetLibId (O->Lib));
245 /* Terminate the output line */