1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
|
/*
* Copyright (C) 2011 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef ART_RUNTIME_GC_SPACE_IMAGE_SPACE_H_
#define ART_RUNTIME_GC_SPACE_IMAGE_SPACE_H_
#include "gc/accounting/space_bitmap.h"
#include "runtime.h"
#include "space.h"
namespace art {
class OatFile;
namespace gc {
namespace space {
// An image space is a space backed with a memory mapped image.
class ImageSpace : public MemMapSpace {
public:
SpaceType GetType() const {
return kSpaceTypeImageSpace;
}
// Create a boot image space from an image file for a specified instruction
// set. Cannot be used for future allocation or collected.
//
// Create also opens the OatFile associated with the image file so
// that it be contiguously allocated with the image before the
// creation of the alloc space. The ReleaseOatFile will later be
// used to transfer ownership of the OatFile to the ClassLinker when
// it is initialized.
static ImageSpace* CreateBootImage(const char* image,
InstructionSet image_isa,
bool secondary_image,
std::string* error_msg)
SHARED_REQUIRES(Locks::mutator_lock_);
// Try to open an existing app image space.
static ImageSpace* CreateFromAppImage(const char* image,
const OatFile* oat_file,
std::string* error_msg)
SHARED_REQUIRES(Locks::mutator_lock_);
// Reads the image header from the specified image location for the
// instruction set image_isa or dies trying.
static ImageHeader* ReadImageHeaderOrDie(const char* image_location,
InstructionSet image_isa);
// Reads the image header from the specified image location for the
// instruction set image_isa. Returns null on failure, with
// reason in error_msg.
static ImageHeader* ReadImageHeader(const char* image_location,
InstructionSet image_isa,
std::string* error_msg);
// Give access to the OatFile.
const OatFile* GetOatFile() const;
// Releases the OatFile from the ImageSpace so it can be transfer to
// the caller, presumably the OatFileManager.
std::unique_ptr<const OatFile> ReleaseOatFile();
void VerifyImageAllocations()
SHARED_REQUIRES(Locks::mutator_lock_);
const ImageHeader& GetImageHeader() const {
return *reinterpret_cast<ImageHeader*>(Begin());
}
// Actual filename where image was loaded from.
// For example: /data/dalvik-cache/arm/system@framework@boot.art
const std::string GetImageFilename() const {
return GetName();
}
// Symbolic location for image.
// For example: /system/framework/boot.art
const std::string GetImageLocation() const {
return image_location_;
}
accounting::ContinuousSpaceBitmap* GetLiveBitmap() const OVERRIDE {
return live_bitmap_.get();
}
accounting::ContinuousSpaceBitmap* GetMarkBitmap() const OVERRIDE {
// ImageSpaces have the same bitmap for both live and marked. This helps reduce the number of
// special cases to test against.
return live_bitmap_.get();
}
void Dump(std::ostream& os) const;
// Sweeping image spaces is a NOP.
void Sweep(bool /* swap_bitmaps */, size_t* /* freed_objects */, size_t* /* freed_bytes */) {
}
bool CanMoveObjects() const OVERRIDE {
return false;
}
// Returns the filename of the image corresponding to
// requested image_location, or the filename where a new image
// should be written if one doesn't exist. Looks for a generated
// image in the specified location and then in the dalvik-cache.
//
// Returns true if an image was found, false otherwise.
static bool FindImageFilename(const char* image_location,
InstructionSet image_isa,
std::string* system_location,
bool* has_system,
std::string* data_location,
bool* dalvik_cache_exists,
bool* has_data,
bool *is_global_cache);
// Use the input image filename to adapt the names in the given boot classpath to establish
// complete locations for secondary images.
static void CreateMultiImageLocations(const std::string& input_image_file_name,
const std::string& boot_classpath,
std::vector<std::string>* image_filenames);
// Return the end of the image which includes non-heap objects such as ArtMethods and ArtFields.
uint8_t* GetImageEnd() const {
return Begin() + GetImageHeader().GetImageSize();
}
// Return the start of the associated oat file.
uint8_t* GetOatFileBegin() const {
return GetImageHeader().GetOatFileBegin();
}
// Return the end of the associated oat file.
uint8_t* GetOatFileEnd() const {
return GetImageHeader().GetOatFileEnd();
}
void DumpSections(std::ostream& os) const;
protected:
// Tries to initialize an ImageSpace from the given image path, returning null on error.
//
// If validate_oat_file is false (for /system), do not verify that image's OatFile is up-to-date
// relative to its DexFile inputs. Otherwise (for /data), validate the inputs and generate the
// OatFile in /data/dalvik-cache if necessary. If the oat_file is null, it uses the oat file from
// the image.
static ImageSpace* Init(const char* image_filename,
const char* image_location,
bool validate_oat_file,
const OatFile* oat_file,
std::string* error_msg)
SHARED_REQUIRES(Locks::mutator_lock_);
OatFile* OpenOatFile(const char* image, std::string* error_msg) const
SHARED_REQUIRES(Locks::mutator_lock_);
bool ValidateOatFile(std::string* error_msg) const
SHARED_REQUIRES(Locks::mutator_lock_);
friend class Space;
static Atomic<uint32_t> bitmap_index_;
std::unique_ptr<accounting::ContinuousSpaceBitmap> live_bitmap_;
ImageSpace(const std::string& name,
const char* image_location,
MemMap* mem_map,
accounting::ContinuousSpaceBitmap* live_bitmap,
uint8_t* end);
// The OatFile associated with the image during early startup to
// reserve space contiguous to the image. It is later released to
// the ClassLinker during it's initialization.
std::unique_ptr<OatFile> oat_file_;
// There are times when we need to find the boot image oat file. As
// we release ownership during startup, keep a non-owned reference.
const OatFile* oat_file_non_owned_;
const std::string image_location_;
private:
DISALLOW_COPY_AND_ASSIGN(ImageSpace);
};
} // namespace space
} // namespace gc
} // namespace art
#endif // ART_RUNTIME_GC_SPACE_IMAGE_SPACE_H_
|
