1 /*
2 * Copyright (c) 2012, 2025, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25 #ifndef SHARE_CDS_AOTMETASPACE_HPP
26 #define SHARE_CDS_AOTMETASPACE_HPP
27
28 #include "memory/allocation.hpp"
29 #include "memory/memRegion.hpp"
30 #include "memory/reservedSpace.hpp"
31 #include "memory/virtualspace.hpp"
32 #include "oops/oop.hpp"
33 #include "utilities/macros.hpp"
34
35 class ArchiveBuilder;
36 class ArchiveMappedHeapInfo;
37 class ArchiveStreamedHeapInfo;
38 class FileMapInfo;
39 class Method;
40 class outputStream;
41 class SerializeClosure;
42 class StaticArchiveBuilder;
43
44 template<class E> class Array;
45
46 enum MapArchiveResult {
47 MAP_ARCHIVE_SUCCESS,
48 MAP_ARCHIVE_MMAP_FAILURE,
49 MAP_ARCHIVE_OTHER_FAILURE
50 };
51
52 class StaticArchiveBuilder;
53
54 // Class Data Sharing Support
55 class AOTMetaspace : AllStatic {
56 static ReservedSpace _symbol_rs; // used only during -Xshare:dump
57 static VirtualSpace _symbol_vs; // used only during -Xshare:dump
58 static bool _archive_loading_failed;
59 static bool _remapped_readwrite;
60 static void* _aot_metaspace_static_top;
61 static intx _relocation_delta;
62 static char* _requested_base_address;
63 static bool _use_optimized_module_handling;
64 static Array<Method*>* _archived_method_handle_intrinsics;
65 static int volatile _preimage_static_archive_dumped;
66 static jlong _preimage_static_archive_recording_duration;
67
68 public:
69 enum {
70 // core archive spaces
71 rw = 0, // read-write
72 ro = 1, // read-only
73 bm = 2, // relocation bitmaps (freed after file mapping is finished)
74 hp = 3, // heap region
75 ac = 4, // aot code
76 num_core_region = 2, // rw and ro
77 n_regions = 5 // total number of regions
78 };
79
80 static void dump_static_archive(TRAPS) NOT_CDS_RETURN;
81 #ifdef _LP64
82 static void adjust_heap_sizes_for_dumping() NOT_CDS_JAVA_HEAP_RETURN;
83 #endif
84
85 private:
86 static void exercise_runtime_cds_code(TRAPS) NOT_CDS_RETURN;
87 static void dump_static_archive_impl(StaticArchiveBuilder& builder, TRAPS) NOT_CDS_RETURN;
88 static void load_classes(TRAPS) NOT_CDS_RETURN;
89
90 public:
91 static Symbol* symbol_rs_base() {
92 return (Symbol*)_symbol_rs.base();
93 }
94
95 static void initialize_for_static_dump() NOT_CDS_RETURN;
96 static void open_static_archive() NOT_CDS_RETURN;
97 static void initialize_runtime_shared_and_meta_spaces() NOT_CDS_RETURN;
98 static void post_initialize(TRAPS) NOT_CDS_RETURN;
99
100 static void print_on(outputStream* st);
101
102 static void set_archive_loading_failed() {
103 _archive_loading_failed = true;
104 }
105
106 static void initialize_shared_spaces() NOT_CDS_RETURN;
107
108 // Return true if given address is in the shared metaspace regions (i.e., excluding the
109 // mapped heap region.)
110 static bool in_aot_cache(const void* p) {
111 return MetaspaceObj::in_aot_cache((const MetaspaceObj*)p);
112 }
113
114 static void set_aot_metaspace_range(void* base, void *static_top, void* top) NOT_CDS_RETURN;
115
116 // inside the metaspace of the AOT cache, or the static CDS archive
117 static bool in_aot_cache_static_region(void* p) NOT_CDS_RETURN_(false);
118
119 // inside the metaspace of the dynamic static CDS archive
120 static bool in_aot_cache_dynamic_region(void* p) NOT_CDS_RETURN_(false);
121
122 static bool is_recording_preimage_static_archive() NOT_CDS_RETURN_(false);
123 static jlong get_preimage_static_archive_recording_duration() NOT_CDS_RETURN_(0);
124
125 static void unrecoverable_loading_error(const char* message = "unrecoverable error");
126 static void report_loading_error(const char* format, ...) ATTRIBUTE_PRINTF(1, 0);
127 static void unrecoverable_writing_error(const char* message = nullptr);
128 static void writing_error(const char* message = nullptr);
129
130 static void make_method_handle_intrinsics_shareable() NOT_CDS_RETURN;
131 static void write_method_handle_intrinsics() NOT_CDS_RETURN;
132 static Array<Method*>* archived_method_handle_intrinsics() { return _archived_method_handle_intrinsics; }
133 static void early_serialize(SerializeClosure* sc) NOT_CDS_RETURN;
134 static void serialize(SerializeClosure* sc) NOT_CDS_RETURN;
135
136 // JVM/TI RedefineClasses() support:
137 // Remap the shared readonly space to shared readwrite, private if
138 // sharing is enabled. Simply returns true if sharing is not enabled
139 // or if the remapping has already been done by a prior call.
140 static bool remap_shared_readonly_as_readwrite() NOT_CDS_RETURN_(true);
141 static bool remapped_readwrite() {
142 CDS_ONLY(return _remapped_readwrite);
143 NOT_CDS(return false);
144 }
145
146 static bool try_link_class(JavaThread* current, InstanceKlass* ik);
147 static void link_all_loaded_classes(JavaThread* current);
148 static void link_shared_classes(TRAPS) NOT_CDS_RETURN;
149 static bool may_be_eagerly_linked(InstanceKlass* ik) NOT_CDS_RETURN_(false);
150
151 #if INCLUDE_CDS
152 // Alignment for the 2 core CDS regions (RW/RO) only.
153 // (Heap region alignments are decided by GC).
154 static size_t core_region_alignment();
155 static size_t protection_zone_size();
156 static void rewrite_bytecodes_and_calculate_fingerprints(Thread* thread, InstanceKlass* ik);
157 // print loaded classes names to file.
158 static void dump_loaded_classes(const char* file_name, TRAPS);
159 #endif
160
161 // Allocate a block of memory from the temporary "symbol" region.
162 static char* symbol_space_alloc(size_t num_bytes);
163
164 // This is the base address as specified by -XX:SharedBaseAddress during -Xshare:dump.
165 // Both the base/top archives are written using this as their base address.
166 //
167 // During static dump: _requested_base_address == SharedBaseAddress.
168 //
169 // During dynamic dump: _requested_base_address is not always the same as SharedBaseAddress:
170 // - SharedBaseAddress is used for *reading the base archive*. I.e., CompactHashtable uses
171 // it to convert offsets to pointers to Symbols in the base archive.
172 // The base archive may be mapped to an OS-selected address due to ASLR. E.g.,
173 // you may have SharedBaseAddress == 0x00ff123400000000.
174 // - _requested_base_address is used for *writing the output archive*. It's usually
175 // 0x800000000 (unless it was set by -XX:SharedBaseAddress during -Xshare:dump).
176 static char* requested_base_address() {
177 return _requested_base_address;
178 }
179
180 // Non-zero if the archive(s) need to be mapped a non-default location due to ASLR.
181 static intx relocation_delta() { return _relocation_delta; }
182
183 static bool use_windows_memory_mapping() {
184 const bool is_windows = (NOT_WINDOWS(false) WINDOWS_ONLY(true));
185 //const bool is_windows = true; // enable this to allow testing the windows mmap semantics on Linux, etc.
186 return is_windows;
187 }
188
189 // Can we skip some expensive operations related to modules?
190 static bool use_optimized_module_handling() { return NOT_CDS(false) CDS_ONLY(_use_optimized_module_handling); }
191 static void disable_optimized_module_handling() { _use_optimized_module_handling = false; }
192
193 private:
194 static void read_extra_data(JavaThread* current, const char* filename) NOT_CDS_RETURN;
195 static void fork_and_dump_final_static_archive(TRAPS);
196 static bool write_static_archive(ArchiveBuilder* builder,
197 FileMapInfo* map_info,
198 ArchiveMappedHeapInfo* mapped_heap_info,
199 ArchiveStreamedHeapInfo* streamed_heap_info);
200 static FileMapInfo* open_dynamic_archive();
201 // use_requested_addr: If true (default), attempt to map at the address the
202 static MapArchiveResult map_archives(FileMapInfo* static_mapinfo, FileMapInfo* dynamic_mapinfo,
203 bool use_requested_addr);
204 static char* reserve_address_space_for_archives(FileMapInfo* static_mapinfo,
205 FileMapInfo* dynamic_mapinfo,
206 bool use_archive_base_addr,
207 ReservedSpace& total_space_rs,
208 ReservedSpace& archive_space_rs,
209 ReservedSpace& class_space_rs);
210 static void release_reserved_spaces(ReservedSpace& total_space_rs,
211 ReservedSpace& archive_space_rs,
212 ReservedSpace& class_space_rs);
213 static MapArchiveResult map_archive(FileMapInfo* mapinfo, char* mapped_base_address, ReservedSpace rs);
214 static void unmap_archive(FileMapInfo* mapinfo);
215 static void get_default_classlist(char* default_classlist, const size_t buf_size);
216 };
217 #endif // SHARE_CDS_AOTMETASPACE_HPP