1 // fileread.h -- read files for gold -*- C++ -*-
3 // Copyright 2006, 2007 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 // Classes used to read data from binary input files.
25 #ifndef GOLD_FILEREAD_H
26 #define GOLD_FILEREAD_H
40 // File_read manages a file descriptor for a file we are reading. We
41 // close file descriptors if we run out of them, so this class reopens
42 // the file as needed.
48 : name_(), descriptor_(-1), lock_count_(0), views_(),
49 saved_views_(), contents_(NULL
), contents_size_(0)
56 open(const std::string
& name
);
58 // Pretend to open the file, but provide the file contents. No
59 // actual file system activity will occur. This is used for
62 open(const std::string
& name
, const unsigned char* contents
, off_t size
);
64 // Return the file name.
67 { return this->name_
; }
69 // Lock the file for access within a particular Task::run execution.
70 // This means that the descriptor can not be closed. This routine
71 // may only be called from the main thread.
75 // Unlock the descriptor, permitting it to be closed if necessary.
79 // Test whether the object is locked.
83 // Return a view into the file starting at file offset START for
84 // SIZE bytes. The pointer will remain valid until the File_read is
85 // unlocked. It is an error if we can not read enough data from the
88 get_view(off_t start
, off_t size
);
90 // Read data from the file into the buffer P starting at file offset
91 // START for SIZE bytes.
93 read(off_t start
, off_t size
, void* p
);
95 // Read up to SIZE bytes from the file into the buffer P starting at
96 // file offset START. Set *PBYTES to the number of bytes read.
98 read_up_to(off_t start
, off_t size
, void* p
, off_t
* pbytes
);
100 // Return a lasting view into the file starting at file offset START
101 // for SIZE bytes. This is allocated with new, and the caller is
102 // responsible for deleting it when done. The data associated with
103 // this view will remain valid until the view is deleted. It is an
104 // error if we can not read enough data from the file.
106 get_lasting_view(off_t start
, off_t size
);
109 // This class may not be copied.
110 File_read(const File_read
&);
111 File_read
& operator=(const File_read
&);
113 // A view into the file when not using mmap.
117 View(off_t start
, off_t size
, const unsigned char* data
)
118 : start_(start
), size_(size
), data_(data
), lock_count_(0)
125 { return this->start_
; }
129 { return this->size_
; }
133 { return this->data_
; }
146 View
& operator=(const View
&);
150 const unsigned char* data_
;
154 friend class File_view
;
156 // Find a view into the file.
158 find_view(off_t start
, off_t size
);
160 // Read data from the file into a buffer.
162 do_read(off_t start
, off_t size
, void* p
, off_t
* pbytes
);
164 // Find or make a view into the file.
166 find_or_make_view(off_t start
, off_t size
);
168 // Clear the file views.
172 // The size of a file page for buffering data.
173 static const off_t page_size
= 8192;
175 // Given a file offset, return the page offset.
177 page_offset(off_t file_offset
)
178 { return file_offset
& ~ (page_size
- 1); }
180 // Given a file size, return the size to read integral pages.
182 pages(off_t file_size
)
183 { return (file_size
+ (page_size
- 1)) & ~ (page_size
- 1); }
185 // The type of a mapping from page start to views.
186 typedef std::map
<off_t
, View
*> Views
;
188 // A simple list of Views.
189 typedef std::list
<View
*> Saved_views
;
195 // Number of locks on the file.
197 // Buffered views into the file.
199 // List of views which were locked but had to be removed from views_
200 // because they were not large enough.
201 Saved_views saved_views_
;
202 // Specified file contents. Used only for testing purposes.
203 const unsigned char* contents_
;
204 // Specified file size. Used only for testing purposes.
205 off_t contents_size_
;
208 // A view of file data that persists even when the file is unlocked.
209 // Callers should destroy these when no longer required. These are
210 // obtained form File_read::get_lasting_view. They may only be
211 // destroyed when the underlying File_read is locked.
216 // This may only be called when the underlying File_read is locked.
219 // Return a pointer to the data associated with this view.
222 { return this->data_
; }
225 File_view(const File_view
&);
226 File_view
& operator=(const File_view
&);
228 friend class File_read
;
230 // Callers have to get these via File_read::get_lasting_view.
231 File_view(File_read
& file
, File_read::View
* view
, const unsigned char* data
)
232 : file_(file
), view_(view
), data_(data
)
236 File_read::View
* view_
;
237 const unsigned char* data_
;
240 // All the information we hold for a single input file. This can be
241 // an object file, a shared library, or an archive.
246 Input_file(const Input_file_argument
* input_argument
)
247 : input_argument_(input_argument
), file_()
250 // Create an input file with the contents already provided. This is
251 // only used for testing. With this path, don't call the open
253 Input_file(const char* name
, const unsigned char* contents
, off_t size
);
257 open(const General_options
&, const Dirsearch
&);
259 // Return the name given by the user.
262 { return this->input_argument_
->name(); }
264 // Return the file name.
267 { return this->file_
.filename(); }
269 // Return the position dependent options.
270 const Position_dependent_options
&
272 { return this->input_argument_
->options(); }
277 { return this->file_
; }
280 Input_file(const Input_file
&);
281 Input_file
& operator=(const Input_file
&);
283 const Input_file_argument
* input_argument_
;
287 } // end namespace gold
289 #endif // !defined(GOLD_FILEREAD_H)