1 // archive.h -- archive support for gold -*- C++ -*-
3 // Copyright 2006, 2007, 2008 Free Software Foundation, Inc.
4 // Written by Ian Lance Taylor <iant@google.com>.
6 // This file is part of gold.
8 // This program is free software; you can redistribute it and/or modify
9 // it under the terms of the GNU General Public License as published by
10 // the Free Software Foundation; either version 3 of the License, or
11 // (at your option) any later version.
13 // This program is distributed in the hope that it will be useful,
14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 // GNU General Public License for more details.
18 // You should have received a copy of the GNU General Public License
19 // along with this program; if not, write to the Free Software
20 // Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
21 // MA 02110-1301, USA.
23 #ifndef GOLD_ARCHIVE_H
24 #define GOLD_ARCHIVE_H
30 #include "workqueue.h"
42 // This class represents an archive--generally a libNAME.a file.
43 // Archives have a symbol table and a list of objects.
48 Archive(const std::string
& name
, Input_file
* input_file
,
49 bool is_thin_archive
, Dirsearch
* dirpath
, Task
* task
)
50 : name_(name
), input_file_(input_file
), armap_(), armap_names_(),
51 extended_names_(), armap_checked_(), seen_offsets_(),
52 is_thin_archive_(is_thin_archive
), dirpath_(dirpath
), task_(task
)
55 // The length of the magic string at the start of an archive.
56 static const int sarmag
= 8;
58 // The magic string at the start of an archive.
59 static const char armag
[sarmag
];
60 static const char armagt
[sarmag
];
62 // The string expected at the end of an archive member header.
63 static const char arfmag
[2];
65 // The name of the object.
68 { return this->name_
; }
70 // Set up the archive: read the symbol map.
74 // Get a reference to the underlying file.
77 { return this->input_file_
->file(); }
81 { return this->input_file_
->file(); }
83 // Lock the underlying file.
86 { this->input_file_
->file().lock(t
); }
88 // Unlock the underlying file.
91 { this->input_file_
->file().unlock(t
); }
93 // Return whether the underlying file is locked.
96 { return this->input_file_
->file().is_locked(); }
98 // Return the token, so that the task can be queued.
101 { return this->input_file_
->file().token(); }
103 // Release the underlying file.
106 { this->input_file_
->file().release(); }
108 // Clear uncached views in the underlying file.
110 clear_uncached_views()
111 { this->input_file_
->file().clear_uncached_views(); }
113 // Unlock any nested archives.
115 unlock_nested_archives();
117 // Select members from the archive as needed and add them to the
120 add_symbols(Symbol_table
*, Layout
*, Input_objects
*, Mapfile
*);
123 Archive(const Archive
&);
124 Archive
& operator=(const Archive
&);
126 struct Archive_header
;
128 // Get a view into the underlying file.
130 get_view(off_t start
, section_size_type size
, bool aligned
, bool cache
)
131 { return this->input_file_
->file().get_view(0, start
, size
, aligned
, cache
); }
133 // Read the archive symbol map.
135 read_armap(off_t start
, section_size_type size
);
137 // Read an archive member header at OFF. CACHE is whether to cache
138 // the file view. Return the size of the member, and set *PNAME to
141 read_header(off_t off
, bool cache
, std::string
* pname
, off_t
* nested_off
);
143 // Interpret an archive header HDR at OFF. Return the size of the
144 // member, and set *PNAME to the name.
146 interpret_header(const Archive_header
* hdr
, off_t off
, std::string
* pname
,
149 // Include all the archive members in the link.
151 include_all_members(Symbol_table
*, Layout
*, Input_objects
*, Mapfile
*);
153 // Include an archive member in the link.
155 include_member(Symbol_table
*, Layout
*, Input_objects
*, off_t off
,
156 Mapfile
*, Symbol
*, const char* why
);
158 // An entry in the archive map of symbols to object files.
161 // The offset to the symbol name in armap_names_.
163 // The file offset to the object in the archive.
167 // A simple hash code for off_t values.
171 size_t operator()(off_t val
) const
172 { return static_cast<size_t>(val
); }
175 // For keeping track of open nested archives in a thin archive file.
176 typedef Unordered_map
<std::string
, Archive
*> Nested_archive_table
;
178 // Name of object as printed to user.
180 // For reading the file.
181 Input_file
* input_file_
;
183 std::vector
<Armap_entry
> armap_
;
184 // The names in the archive map.
185 std::string armap_names_
;
186 // The extended name table.
187 std::string extended_names_
;
188 // Track which symbols in the archive map are for elements which are
189 // defined or which have already been included in the link.
190 std::vector
<bool> armap_checked_
;
191 // Track which elements have been included by offset.
192 Unordered_set
<off_t
, Seen_hash
> seen_offsets_
;
193 // True if this is a thin archive.
194 const bool is_thin_archive_
;
195 // Table of nested archives, indexed by filename.
196 Nested_archive_table nested_archives_
;
197 // The directory search path.
199 // The task reading this archive.
203 // This class is used to read an archive and pick out the desired
204 // elements and add them to the link.
206 class Add_archive_symbols
: public Task
209 Add_archive_symbols(Symbol_table
* symtab
, Layout
* layout
,
210 Input_objects
* input_objects
, Mapfile
* mapfile
,
211 Archive
* archive
, Input_group
* input_group
,
212 Task_token
* this_blocker
,
213 Task_token
* next_blocker
)
214 : symtab_(symtab
), layout_(layout
), input_objects_(input_objects
),
215 mapfile_(mapfile
), archive_(archive
), input_group_(input_group
),
216 this_blocker_(this_blocker
), next_blocker_(next_blocker
)
219 ~Add_archive_symbols();
221 // The standard Task methods.
235 if (this->archive_
== NULL
)
236 return "Add_archive_symbols";
237 return "Add_archive_symbols " + this->archive_
->file().filename();
241 Symbol_table
* symtab_
;
243 Input_objects
* input_objects_
;
246 Input_group
* input_group_
;
247 Task_token
* this_blocker_
;
248 Task_token
* next_blocker_
;
251 } // End namespace gold.
253 #endif // !defined(GOLD_ARCHIVE_H)