forte.cpp revision 2796
0N/A * Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 0N/A * published by the Free Software Foundation. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 0N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 0N/A// These name match the names reported by the forte quality kit 0N/A//------------------------------------------------------- 0N/A// Native interfaces for use by Forte tools. 0N/A // constructor that starts with sender of frame fr (top_frame) 0N/A // We must always have a valid frame to start filling 0N/A// Solaris SPARC Compiler1 needs an additional check on the grandparent 0N/A// of the top_frame when the parent of the top_frame is interpreted and 0N/A// the grandparent is compiled. However, in this method we do not know 0N/A// the relationship of the current _frame relative to the top_frame so 0N/A// we implement a more broad sanity check. When the previous callee is 0N/A// interpreted and the current sender is compiled, we verify that the 0N/A// current sender is also walkable. If it is not walkable, then we mark 0N/A// the current vframeStream as at the end. 0N/A // handle frames with inlining 0N/A // handle general case 0N/A // By the time we get here we should never see unsafe but better 0N/A// Determine if 'fr' is a decipherable compiled frame. We are already 0N/A// assured that fr is for a java nmethod. 0N/A // We're stopped at a call into the JVM so look for a PcDesc with 0N/A // the actual pc reported by the frame. 0N/A // Did we find a useful PcDesc? 0N/A // We're at some random pc in the nmethod so search for the PcDesc 0N/A // whose pc is greater than the current PC. It's done this way 0N/A // because the extra PcDescs that are recorded for improved debug 0N/A // info record the end of the region covered by the ScopeDesc 0N/A // instead of the beginning. 0N/A // Now do we have a useful PcDesc? 0N/A // No debug information available for this pc 0N/A // vframeStream would explode if we try and walk the frames. 0N/A // This PcDesc is useful however we must adjust the frame's pc 0N/A // so that the vframeStream lookups will use this same pc 0N/A// Determine if 'fr' is a walkable interpreted frame. Returns false 0N/A// if it is not. *method_p, and *bci_p are not set when false is 0N/A// returned. *method_p is non-NULL if frame was executing a Java 0N/A// method. *bci_p is != -1 if a valid BCI in the Java method could 0N/A// Note: this method returns true when a valid Java method is found 0N/A// even if a valid BCI cannot be found. 0N/A // top frame is an interpreted frame 0N/A // check if it is walkable (i.e. valid methodOop and valid bci) 0N/A // Because we may be racing a gc thread the method and/or bci 0N/A // of a valid interpreter frame may look bad causing us to 0N/A // fail the is_interpreted_frame_valid test. If the thread 0N/A // is in any of the following states we are assured that the 0N/A // frame is in fact valid and we must have hit the race. 0N/A // The frame code should completely validate the frame so that 0N/A // references to methodOop and bci are completely safe to access 0N/A // If they aren't the frame code should be fixed not this 0N/A // code. However since gc isn't locked out the values could be 0N/A // stale. This is a race we can never completely win since we can't 0N/A // lock out gc so do one last check after retrieving their values 0N/A // from the frame for additional safety 0N/A // We've at least found a method. 0N/A // NOTE: there is something to be said for the approach that 0N/A // if we don't find a valid bci then the method is not likely 0N/A // a valid method. Then again we may have caught an interpreter 0N/A // frame in the middle of construction and the bci field is 0N/A // See if gc may have invalidated method since we validated frame 0N/A // note: bci is set to -1 if not a valid bci 0N/A// Determine if 'fr' can be used to find an initial Java frame. 0N/A// Return false if it can not find a fully decipherable Java frame 0N/A// (in other words a frame that isn't safe to use in a vframe stream). 0N/A// Obviously if it can't even find a Java frame false will also be returned. 0N/A// If we find a Java frame decipherable or not then by definition we have 0N/A// identified a method and that will be returned to the caller via method_p. 0N/A// If we can determine a bci that is returned also. (Hmm is it possible 0N/A// to return a method and bci and still return false? ) 0N/A// The initial Java frame we find (if any) is return via initial_frame_p. 0N/A // It is possible that for a frame containing an nmethod 0N/A // we can capture the method but no bci. If we get no 0N/A // bci the frame isn't walkable but the method is usable. 0N/A // Therefore we init the returned methodOop to NULL so the 0N/A // caller can make the distinction. 0N/A // On the initial call to this method the frame we get may not be 0N/A // recognizable to us. This should only happen if we are in a JRT_LEAF 0N/A // or something called by a JRT_LEAF method. 0N/A // If the starting frame we were given has no codeBlob associated with 0N/A // it see if we can find such a frame because only frames with codeBlobs 0N/A // are possible Java frames. 0N/A // See if we can find a useful frame 0N/A // We have a frame known to be in the codeCache 0N/A // We will hopefully be able to figure out something to do with it. // If initial frame is frame from StubGenerator and there is no // previous anchor, there are no java frames associated with a method // Hopefully we got some data // If the frame isn't fully decipherable then the default // value for the bci is a signal that we don't have a bci. // If we have a decipherable frame this bci value will // Native wrapper code is trivial to decode by vframeStream // If it isn't decipherable then we have found a pc that doesn't // have a PCDesc that can get us a bci however we did find // is_decipherable_compiled_frame may modify candidate's pc // Must be some stub frame that we don't care about // If it isn't in the code cache something is wrong // since once we find a frame in the code cache they // call frame copied from old .h file and renamed // call trace copied from old .h file and renamed // The frame might not be walkable but still recovered a method // (e.g. an nmethod with no scope info for the pc // The method is not stored GC safe so see if GC became active // after we entered AsyncGetCallTrace() and before we try to // Yes, there is still a window after this check and before // we use methodOop below, but we can't lock out GC so that // has to be an acceptable risk. // We got a Java frame however it isn't fully decipherable // so it won't necessarily be safe to use it for the // initial frame in the vframe stream. // Take whatever method the top-frame decoder managed to scrape up. // We look further at the top frame only if non-safepoint // debugging information is available. // The method is not stored GC safe so see if GC became active // after we entered AsyncGetCallTrace() and before we try to // Yes, there is still a window after this check and before // we use methodOop below, but we can't lock out GC so that // has to be an acceptable risk. // we throw away everything we've gathered in this sample since // Forte Analyzer AsyncGetCallTrace() entry point. Currently supported // on Linux X86, Solaris SPARC and Solaris X86. // Async-safe version of GetCallTrace being called from a signal handler // when a LWP gets interrupted by SIGPROF but the stack traces are filled // with different content (see below). // This function must only be called when JVM/TI // CLASS_LOAD events have been enabled since agent startup. The enabled // event will cause the jmethodIDs to be allocated at class load time. // The jmethodIDs cannot be allocated in a signal handler because locks // cannot be grabbed in a signal handler safely. // void (*AsyncGetCallTrace)(ASGCT_CallTrace *trace, jint depth, void* ucontext) // Called by the profiler to obtain the current method call stack trace for // a given thread. The thread is identified by the env_id field in the // ASGCT_CallTrace structure. The profiler agent should allocate a ASGCT_CallTrace // structure with enough memory for the requested stack depth. The VM fills in // the frames buffer and the num_frames field. // trace - trace data structure to be filled by the VM. // depth - depth of the call stack trace. // ucontext - ucontext_t of the LWP // ASGCT_CallFrame *frames; // env_id - ID of thread which executed this trace. // num_frames - number of frames in the trace. // (< 0 indicates the frame is not walkable). // frames - the ASGCT_CallFrames that make up this trace. Callee followed by callers. // 1) For Java frame (interpreted and compiled), // lineno - bci of the method being executed or -1 if bci is not available // method_id - jmethodID of the method being executed // method_id - jmethodID of the method being executed // bad env_id, thread has exited or thread is exiting // thread is in the deoptimization handler so return no frames "AsyncGetCallTrace must be called by the current interrupted thread");
// We found the thread on the threads list above, but it is too // young to be useful so return that there are no Java frames. // param isInJava == false - indicate we aren't in Java code // This assert would seem to be valid but it is not. // It would be valid if we weren't possibly racing a gc // thread. A gc thread can make a valid interpreted frame // look invalid. It's a small window but it does happen. // The assert is left here commented out as a reminder. // assert(trace->num_frames != ticks_not_walkable_not_Java, "should always be walkable"); // param isInJava == true - indicate we are in Java code // Support for the Forte(TM) Peformance Tools collector. // information, please see the libcollect man page. // Method to let libcollector know about a dynamically loaded function. // Because it is weakly bound, the calls become NOP's when the library // XXXDARWIN: Link errors occur even when __attribute__((weak_import)) "Code size exceeds maximum range");
#
endif // !_WINDOWS && !IA64