1 /*
  2 * Copyright (c) 2015, 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 #include "cds/cdsConfig.hpp"
 26 #include "cds/filemap.hpp"
 27 #include "classfile/classFileParser.hpp"
 28 #include "classfile/classFileStream.hpp"
 29 #include "classfile/classLoader.hpp"
 30 #include "classfile/classLoaderData.inline.hpp"
 31 #include "classfile/classLoadInfo.hpp"
 32 #include "classfile/klassFactory.hpp"
 33 #include "classfile/systemDictionaryShared.hpp"
 34 #include "memory/resourceArea.hpp"
 35 #include "prims/jvmtiEnvBase.hpp"
 36 #include "prims/jvmtiRedefineClasses.hpp"
 37 #include "runtime/handles.inline.hpp"
 38 #include "utilities/macros.hpp"
 39 #if INCLUDE_JFR
 40 #include "jfr/support/jfrKlassExtension.hpp"
 41 #endif
 42 
 43 
 44 // called during initial loading of a shared class
 45 InstanceKlass* KlassFactory::check_shared_class_file_load_hook(
 46                                           InstanceKlass* ik,
 47                                           Symbol* class_name,
 48                                           Handle class_loader,
 49                                           Handle protection_domain,
 50                                           const ClassFileStream *cfs,
 51                                           TRAPS) {
 52 #if INCLUDE_CDS && INCLUDE_JVMTI
 53   assert(ik != nullptr, "sanity");
 54   assert(ik->in_aot_cache(), "expecting a shared class");
 55   if (JvmtiExport::should_post_class_file_load_hook()) {
 56     ResourceMark rm(THREAD);
 57     // Post the CFLH
 58     JvmtiCachedClassFileData* cached_class_file = nullptr;
 59     if (cfs == nullptr) {
 60       cfs = FileMapInfo::open_stream_for_jvmti(ik, class_loader, CHECK_NULL);
 61     }
 62     unsigned char* ptr = (unsigned char*)cfs->buffer();
 63     unsigned char* end_ptr = ptr + cfs->length();
 64     unsigned char* old_ptr = ptr;
 65     JvmtiExport::post_class_file_load_hook(class_name,
 66                                            class_loader,
 67                                            protection_domain,
 68                                            &ptr,
 69                                            &end_ptr,
 70                                            &cached_class_file);
 71     if (old_ptr != ptr) {
 72       // JVMTI agent has modified class file data.
 73       // Set new class file stream using JVMTI agent modified class file data.
 74       ClassLoaderData* loader_data =
 75         ClassLoaderData::class_loader_data(class_loader());
 76       s2 path_index = ik->shared_classpath_index();
 77       ClassFileStream* stream = new ClassFileStream(ptr,
 78                                                     pointer_delta_as_int(end_ptr, ptr),
 79                                                     cfs->source(),
 80                                                     /* from_boot_loader_modules_image */ false,
 81                                                     /* from_class_file_load_hook */ true);
 82       ClassLoadInfo cl_info(protection_domain);
 83       ClassFileParser parser(stream,
 84                              class_name,
 85                              loader_data,
 86                              &cl_info,
 87                              ClassFileParser::BROADCAST, // publicity level
 88                              CHECK_NULL);
 89       const ClassInstanceInfo* cl_inst_info = cl_info.class_hidden_info_ptr();
 90       InstanceKlass* new_ik = parser.create_instance_klass(true, // changed_by_loadhook
 91                                                            *cl_inst_info,  // dynamic_nest_host and classData
 92                                                            CHECK_NULL);
 93 
 94       if (cached_class_file != nullptr) {
 95         new_ik->set_cached_class_file(cached_class_file);
 96       }
 97 
 98       if (class_loader.is_null()) {
 99         new_ik->set_classpath_index(path_index);
100       }
101 
102       return new_ik;
103     }
104   }
105 #endif
106 
107   return nullptr;
108 }
109 
110 
111 static ClassFileStream* check_class_file_load_hook(ClassFileStream* stream,
112                                                    Symbol* name,
113                                                    ClassLoaderData* loader_data,
114                                                    Handle protection_domain,
115                                                    JvmtiCachedClassFileData** cached_class_file,
116                                                    TRAPS) {
117 
118   assert(stream != nullptr, "invariant");
119 
120   if (JvmtiExport::should_post_class_file_load_hook()) {
121     const JavaThread* jt = THREAD;
122 
123     Handle class_loader(THREAD, loader_data->class_loader());
124 
125     // Get the cached class file bytes (if any) from the class that
126     // is being retransformed. If class file load hook provides
127     // modified class data during class loading or redefinition,
128     // new cached class file buffer should be allocated.
129     // We use jvmti_thread_state()
130     // instead of JvmtiThreadState::state_for(jt) so we don't allocate
131     // a JvmtiThreadState any earlier than necessary. This will help
132     // avoid the bug described by 7126851.
133 
134     JvmtiThreadState* state = jt->jvmti_thread_state();
135 
136     if (state != nullptr) {
137       Klass* k = state->get_class_being_redefined();
138       if (k != nullptr && state->get_class_load_kind() == jvmti_class_load_kind_retransform) {
139         InstanceKlass* class_being_redefined = InstanceKlass::cast(k);
140         *cached_class_file = class_being_redefined->get_cached_class_file();
141       }
142     }
143 
144     unsigned char* ptr = const_cast<unsigned char*>(stream->buffer());
145     unsigned char* end_ptr = ptr + stream->length();
146 
147     JvmtiExport::post_class_file_load_hook(name,
148                                            class_loader,
149                                            protection_domain,
150                                            &ptr,
151                                            &end_ptr,
152                                            cached_class_file);
153 
154     if (ptr != stream->buffer()) {
155       // JVMTI agent has modified class file data.
156       // Set new class file stream using JVMTI agent modified class file data.
157       stream = new ClassFileStream(ptr,
158                                    pointer_delta_as_int(end_ptr, ptr),
159                                    stream->source(),
160                                    /* from_boot_loader_modules_image */ false,
161                                    /* from_class_file_load_hook */ true);
162     }
163   }
164 
165   return stream;
166 }
167 
168 
169 InstanceKlass* KlassFactory::create_from_stream(ClassFileStream* stream,
170                                                 Symbol* name,
171                                                 ClassLoaderData* loader_data,
172                                                 const ClassLoadInfo& cl_info,
173                                                 TRAPS) {
174   assert(stream != nullptr, "invariant");
175   assert(loader_data != nullptr, "invariant");
176 
177   ResourceMark rm(THREAD);
178   HandleMark hm(THREAD);
179 
180   JvmtiCachedClassFileData* cached_class_file = nullptr;
181 
182   ClassFileStream* old_stream = stream;
183 
184   // increment counter
185   THREAD->statistical_info().incr_define_class_count();
186 
187   // Skip this processing for VM hidden classes
188   if (!cl_info.is_hidden()) {
189     stream = check_class_file_load_hook(stream,
190                                         name,
191                                         loader_data,
192                                         cl_info.protection_domain(),
193                                         &cached_class_file,
194                                         CHECK_NULL);
195   }
196 
197   ClassFileParser parser(stream,
198                          name,
199                          loader_data,
200                          &cl_info,
201                          ClassFileParser::BROADCAST, // publicity level
202                          CHECK_NULL);
203 
204   const ClassInstanceInfo* cl_inst_info = cl_info.class_hidden_info_ptr();
205   InstanceKlass* result = parser.create_instance_klass(old_stream != stream, *cl_inst_info, CHECK_NULL);
206   assert(result != nullptr, "result cannot be null with no pending exception");
207   if (CDSConfig::is_dumping_archive() && stream->from_class_file_load_hook()) {
208     SystemDictionaryShared::set_from_class_file_load_hook(result);
209   }
210 
211   if (cached_class_file != nullptr) {
212     // JVMTI: we have an InstanceKlass now, tell it about the cached bytes
213     result->set_cached_class_file(cached_class_file);
214   }
215 
216   JFR_ONLY(ON_KLASS_CREATION(result, parser, THREAD);)
217 
218 #if INCLUDE_CDS
219   if (CDSConfig::is_dumping_archive()) {
220     ClassLoader::record_result(THREAD, result, stream, old_stream != stream);
221   }
222 #endif // INCLUDE_CDS
223 
224   return result;
225 }