/*
* Copyright (c) 1998, 2007, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
#include "util.h"
#include "invoker.h"
#include "eventHandler.h"
#include "threadControl.h"
#include "outStream.h"
static jrawMonitorID invokerLock;
void
invoker_initialize(void)
{
invokerLock = debugMonitorCreate("JDWP Invocation Lock");
}
void
invoker_reset(void)
{
}
void invoker_lock(void)
{
debugMonitorEnter(invokerLock);
}
void invoker_unlock(void)
{
debugMonitorExit(invokerLock);
}
static jbyte
returnTypeTag(char *signature)
{
char *tagPtr = strchr(signature, SIGNATURE_END_ARGS);
JDI_ASSERT(tagPtr);
tagPtr++; /* 1st character after the end of args */
return (jbyte)*tagPtr;
}
static jbyte
nextArgumentTypeTag(void **cursor)
{
char *tagPtr = *cursor;
jbyte argumentTag = (jbyte)*tagPtr;
if (*tagPtr != SIGNATURE_END_ARGS) {
/* Skip any array modifiers */
while (*tagPtr == JDWP_TAG(ARRAY)) {
tagPtr++;
}
/* Skip class name */
if (*tagPtr == JDWP_TAG(OBJECT)) {
tagPtr = strchr(tagPtr, SIGNATURE_END_CLASS) + 1;
JDI_ASSERT(tagPtr);
} else {
/* Skip primitive sig */
tagPtr++;
}
}
*cursor = tagPtr;
return argumentTag;
}
static jbyte
firstArgumentTypeTag(char *signature, void **cursor)
{
JDI_ASSERT(signature[0] == SIGNATURE_BEGIN_ARGS);
*cursor = signature + 1; /* skip to the first arg */
return nextArgumentTypeTag(cursor);
}
/*
* Note: argument refs may be destroyed on out-of-memory error
*/
static jvmtiError
createGlobalRefs(JNIEnv *env, InvokeRequest *request)
{
jvmtiError error;
jclass clazz = NULL;
jobject instance = NULL;
jint argIndex;
jbyte argumentTag;
jvalue *argument;
void *cursor;
jobject *argRefs = NULL;
error = JVMTI_ERROR_NONE;
if ( request->argumentCount > 0 ) {
/*LINTED*/
argRefs = jvmtiAllocate((jint)(request->argumentCount*sizeof(jobject)));
if ( argRefs==NULL ) {
error = AGENT_ERROR_OUT_OF_MEMORY;
} else {
/*LINTED*/
(void)memset(argRefs, 0, request->argumentCount*sizeof(jobject));
}
}
if ( error == JVMTI_ERROR_NONE ) {
saveGlobalRef(env, request->clazz, &clazz);
if (clazz == NULL) {
error = AGENT_ERROR_OUT_OF_MEMORY;
}
}
if ( error == JVMTI_ERROR_NONE && request->instance != NULL ) {
saveGlobalRef(env, request->instance, &instance);
if (instance == NULL) {
error = AGENT_ERROR_OUT_OF_MEMORY;
}
}
if ( error == JVMTI_ERROR_NONE && argRefs!=NULL ) {
argIndex = 0;
argumentTag = firstArgumentTypeTag(request->methodSignature, &cursor);
argument = request->arguments;
while (argumentTag != SIGNATURE_END_ARGS) {
if ( argIndex > request->argumentCount ) {
break;
}
if ((argumentTag == JDWP_TAG(OBJECT)) ||
(argumentTag == JDWP_TAG(ARRAY))) {
/* Create a global ref for any non-null argument */
if (argument->l != NULL) {
saveGlobalRef(env, argument->l, &argRefs[argIndex]);
if (argRefs[argIndex] == NULL) {
error = AGENT_ERROR_OUT_OF_MEMORY;
break;
}
}
}
argument++;
argIndex++;
argumentTag = nextArgumentTypeTag(&cursor);
}
}
#ifdef FIXUP /* Why isn't this an error? */
/* Make sure the argument count matches */
if ( error == JVMTI_ERROR_NONE && argIndex != request->argumentCount ) {
error = AGENT_ERROR_INVALID_COUNT;
}
#endif
/* Finally, put the global refs into the request if no errors */
if ( error == JVMTI_ERROR_NONE ) {
request->clazz = clazz;
request->instance = instance;
if ( argRefs!=NULL ) {
argIndex = 0;
argumentTag = firstArgumentTypeTag(request->methodSignature, &cursor);
argument = request->arguments;
while ( argIndex < request->argumentCount ) {
if ((argumentTag == JDWP_TAG(OBJECT)) ||
(argumentTag == JDWP_TAG(ARRAY))) {
argument->l = argRefs[argIndex];
}
argument++;
argIndex++;
argumentTag = nextArgumentTypeTag(&cursor);
}
jvmtiDeallocate(argRefs);
}
return JVMTI_ERROR_NONE;
} else {
/* Delete global references */
if ( clazz != NULL ) {
tossGlobalRef(env, &clazz);
}
if ( instance != NULL ) {
tossGlobalRef(env, &instance);
}
if ( argRefs!=NULL ) {
for ( argIndex=0; argIndex < request->argumentCount; argIndex++ ) {
if ( argRefs[argIndex] != NULL ) {
tossGlobalRef(env, &argRefs[argIndex]);
}
}
jvmtiDeallocate(argRefs);
}
}
return error;
}
/*
* Delete saved global references - if any - for:
* - a potentially thrown Exception
* - a returned refernce/array value
* See invoker_doInvoke() and invoke* methods where global references
* are being saved.
*/
static void
deletePotentiallySavedGlobalRefs(JNIEnv *env, InvokeRequest *request)
{
/* Delete potentially saved return value */
if ((request->invokeType == INVOKE_CONSTRUCTOR) ||
(returnTypeTag(request->methodSignature) == JDWP_TAG(OBJECT)) ||
(returnTypeTag(request->methodSignature) == JDWP_TAG(ARRAY))) {
if (request->returnValue.l != NULL) {
tossGlobalRef(env, &(request->returnValue.l));
}
}
/* Delete potentially saved exception */
if (request->exception != NULL) {
tossGlobalRef(env, &(request->exception));
}
}
/*
* Delete global argument references from the request which got put there before a
* invoke request was carried out. See fillInvokeRequest().
*/
static void
deleteGlobalArgumentRefs(JNIEnv *env, InvokeRequest *request)
{
void *cursor;
jint argIndex = 0;
jvalue *argument = request->arguments;
jbyte argumentTag = firstArgumentTypeTag(request->methodSignature, &cursor);
if (request->clazz != NULL) {
tossGlobalRef(env, &(request->clazz));
}
if (request->instance != NULL) {
tossGlobalRef(env, &(request->instance));
}
/* Delete global argument references */
while (argIndex < request->argumentCount) {
if ((argumentTag == JDWP_TAG(OBJECT)) ||
(argumentTag == JDWP_TAG(ARRAY))) {
if (argument->l != NULL) {
tossGlobalRef(env, &(argument->l));
}
}
argument++;
argIndex++;
argumentTag = nextArgumentTypeTag(&cursor);
}
}
static jvmtiError
fillInvokeRequest(JNIEnv *env, InvokeRequest *request,
jbyte invokeType, jbyte options, jint id,
jthread thread, jclass clazz, jmethodID method,
jobject instance,
jvalue *arguments, jint argumentCount)
{
jvmtiError error;
if (!request->available) {
/*
* Thread is not at a point where it can invoke.
*/
return AGENT_ERROR_INVALID_THREAD;
}
if (request->pending) {
/*
* Pending invoke
*/
return AGENT_ERROR_ALREADY_INVOKING;
}
request->invokeType = invokeType;
request->options = options;
request->detached = JNI_FALSE;
request->id = id;
request->clazz = clazz;
request->method = method;
request->instance = instance;
request->arguments = arguments;
request->arguments = arguments;
request->argumentCount = argumentCount;
request->returnValue.j = 0;
request->exception = 0;
/*
* Squirrel away the method signature
*/
error = methodSignature(method, NULL, &request->methodSignature, NULL);
if (error != JVMTI_ERROR_NONE) {
return error;
}
/*
* The given references for class and instance are not guaranteed
* to be around long enough for invocation, so create new ones
* here.
*/
error = createGlobalRefs(env, request);
if (error != JVMTI_ERROR_NONE) {
jvmtiDeallocate(request->methodSignature);
return error;
}
request->pending = JNI_TRUE;
request->available = JNI_FALSE;
return JVMTI_ERROR_NONE;
}
void
invoker_enableInvokeRequests(jthread thread)
{
InvokeRequest *request;
JDI_ASSERT(thread);
request = threadControl_getInvokeRequest(thread);
if (request == NULL) {
EXIT_ERROR(AGENT_ERROR_INVALID_THREAD, "getting thread invoke request");
}
request->available = JNI_TRUE;
}
jvmtiError
invoker_requestInvoke(jbyte invokeType, jbyte options, jint id,
jthread thread, jclass clazz, jmethodID method,
jobject instance,
jvalue *arguments, jint argumentCount)
{
JNIEnv *env = getEnv();
InvokeRequest *request;
jvmtiError error = JVMTI_ERROR_NONE;
debugMonitorEnter(invokerLock);
request = threadControl_getInvokeRequest(thread);
if (request != NULL) {
error = fillInvokeRequest(env, request, invokeType, options, id,
thread, clazz, method, instance,
arguments, argumentCount);
}
debugMonitorExit(invokerLock);
if (error == JVMTI_ERROR_NONE) {
if (options & JDWP_INVOKE_OPTIONS(SINGLE_THREADED) ) {
/* true means it is okay to unblock the commandLoop thread */
(void)threadControl_resumeThread(thread, JNI_TRUE);
} else {
(void)threadControl_resumeAll();
}
}
return error;
}
static void
invokeConstructor(JNIEnv *env, InvokeRequest *request)
{
jobject object;
JDI_ASSERT_MSG(request->clazz, "Request clazz null");
object = JNI_FUNC_PTR(env,NewObjectA)(env, request->clazz,
request->method,
request->arguments);
request->returnValue.l = NULL;
if (object != NULL) {
saveGlobalRef(env, object, &(request->returnValue.l));
}
}
static void
invokeStatic(JNIEnv *env, InvokeRequest *request)
{
switch(returnTypeTag(request->methodSignature)) {
case JDWP_TAG(OBJECT):
case JDWP_TAG(ARRAY): {
jobject object;
JDI_ASSERT_MSG(request->clazz, "Request clazz null");
object = JNI_FUNC_PTR(env,CallStaticObjectMethodA)(env,
request->clazz,
request->method,
request->arguments);
request->returnValue.l = NULL;
if (object != NULL) {
saveGlobalRef(env, object, &(request->returnValue.l));
}
break;
}
case JDWP_TAG(BYTE):
request->returnValue.b = JNI_FUNC_PTR(env,CallStaticByteMethodA)(env,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(CHAR):
request->returnValue.c = JNI_FUNC_PTR(env,CallStaticCharMethodA)(env,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(FLOAT):
request->returnValue.f = JNI_FUNC_PTR(env,CallStaticFloatMethodA)(env,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(DOUBLE):
request->returnValue.d = JNI_FUNC_PTR(env,CallStaticDoubleMethodA)(env,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(INT):
request->returnValue.i = JNI_FUNC_PTR(env,CallStaticIntMethodA)(env,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(LONG):
request->returnValue.j = JNI_FUNC_PTR(env,CallStaticLongMethodA)(env,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(SHORT):
request->returnValue.s = JNI_FUNC_PTR(env,CallStaticShortMethodA)(env,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(BOOLEAN):
request->returnValue.z = JNI_FUNC_PTR(env,CallStaticBooleanMethodA)(env,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(VOID):
JNI_FUNC_PTR(env,CallStaticVoidMethodA)(env,
request->clazz,
request->method,
request->arguments);
break;
default:
EXIT_ERROR(AGENT_ERROR_NULL_POINTER,"Invalid method signature");
break;
}
}
static void
invokeVirtual(JNIEnv *env, InvokeRequest *request)
{
switch(returnTypeTag(request->methodSignature)) {
case JDWP_TAG(OBJECT):
case JDWP_TAG(ARRAY): {
jobject object;
JDI_ASSERT_MSG(request->instance, "Request instance null");
object = JNI_FUNC_PTR(env,CallObjectMethodA)(env,
request->instance,
request->method,
request->arguments);
request->returnValue.l = NULL;
if (object != NULL) {
saveGlobalRef(env, object, &(request->returnValue.l));
}
break;
}
case JDWP_TAG(BYTE):
request->returnValue.b = JNI_FUNC_PTR(env,CallByteMethodA)(env,
request->instance,
request->method,
request->arguments);
break;
case JDWP_TAG(CHAR):
request->returnValue.c = JNI_FUNC_PTR(env,CallCharMethodA)(env,
request->instance,
request->method,
request->arguments);
break;
case JDWP_TAG(FLOAT):
request->returnValue.f = JNI_FUNC_PTR(env,CallFloatMethodA)(env,
request->instance,
request->method,
request->arguments);
break;
case JDWP_TAG(DOUBLE):
request->returnValue.d = JNI_FUNC_PTR(env,CallDoubleMethodA)(env,
request->instance,
request->method,
request->arguments);
break;
case JDWP_TAG(INT):
request->returnValue.i = JNI_FUNC_PTR(env,CallIntMethodA)(env,
request->instance,
request->method,
request->arguments);
break;
case JDWP_TAG(LONG):
request->returnValue.j = JNI_FUNC_PTR(env,CallLongMethodA)(env,
request->instance,
request->method,
request->arguments);
break;
case JDWP_TAG(SHORT):
request->returnValue.s = JNI_FUNC_PTR(env,CallShortMethodA)(env,
request->instance,
request->method,
request->arguments);
break;
case JDWP_TAG(BOOLEAN):
request->returnValue.z = JNI_FUNC_PTR(env,CallBooleanMethodA)(env,
request->instance,
request->method,
request->arguments);
break;
case JDWP_TAG(VOID):
JNI_FUNC_PTR(env,CallVoidMethodA)(env,
request->instance,
request->method,
request->arguments);
break;
default:
EXIT_ERROR(AGENT_ERROR_NULL_POINTER,"Invalid method signature");
break;
}
}
static void
invokeNonvirtual(JNIEnv *env, InvokeRequest *request)
{
switch(returnTypeTag(request->methodSignature)) {
case JDWP_TAG(OBJECT):
case JDWP_TAG(ARRAY): {
jobject object;
JDI_ASSERT_MSG(request->clazz, "Request clazz null");
JDI_ASSERT_MSG(request->instance, "Request instance null");
object = JNI_FUNC_PTR(env,CallNonvirtualObjectMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
request->returnValue.l = NULL;
if (object != NULL) {
saveGlobalRef(env, object, &(request->returnValue.l));
}
break;
}
case JDWP_TAG(BYTE):
request->returnValue.b = JNI_FUNC_PTR(env,CallNonvirtualByteMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(CHAR):
request->returnValue.c = JNI_FUNC_PTR(env,CallNonvirtualCharMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(FLOAT):
request->returnValue.f = JNI_FUNC_PTR(env,CallNonvirtualFloatMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(DOUBLE):
request->returnValue.d = JNI_FUNC_PTR(env,CallNonvirtualDoubleMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(INT):
request->returnValue.i = JNI_FUNC_PTR(env,CallNonvirtualIntMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(LONG):
request->returnValue.j = JNI_FUNC_PTR(env,CallNonvirtualLongMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(SHORT):
request->returnValue.s = JNI_FUNC_PTR(env,CallNonvirtualShortMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(BOOLEAN):
request->returnValue.z = JNI_FUNC_PTR(env,CallNonvirtualBooleanMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
break;
case JDWP_TAG(VOID):
JNI_FUNC_PTR(env,CallNonvirtualVoidMethodA)(env,
request->instance,
request->clazz,
request->method,
request->arguments);
break;
default:
EXIT_ERROR(AGENT_ERROR_NULL_POINTER,"Invalid method signature");
break;
}
}
jboolean
invoker_doInvoke(jthread thread)
{
JNIEnv *env;
jboolean startNow;
InvokeRequest *request;
jbyte options;
jbyte invokeType;
JDI_ASSERT(thread);
debugMonitorEnter(invokerLock);
request = threadControl_getInvokeRequest(thread);
if (request == NULL) {
EXIT_ERROR(AGENT_ERROR_INVALID_THREAD, "getting thread invoke request");
}
request->available = JNI_FALSE;
startNow = request->pending && !request->started;
if (startNow) {
request->started = JNI_TRUE;
}
options = request->options;
invokeType = request->invokeType;
debugMonitorExit(invokerLock);
if (!startNow) {
return JNI_FALSE;
}
env = getEnv();
WITH_LOCAL_REFS(env, 2) { /* 1 for obj return values, 1 for exception */
jobject exception;
JNI_FUNC_PTR(env,ExceptionClear)(env);
switch (invokeType) {
case INVOKE_CONSTRUCTOR:
invokeConstructor(env, request);
break;
case INVOKE_STATIC:
invokeStatic(env, request);
break;
case INVOKE_INSTANCE:
if (options & JDWP_INVOKE_OPTIONS(NONVIRTUAL) ) {
invokeNonvirtual(env, request);
} else {
invokeVirtual(env, request);
}
break;
default:
JDI_ASSERT(JNI_FALSE);
}
request->exception = NULL;
exception = JNI_FUNC_PTR(env,ExceptionOccurred)(env);
if (exception != NULL) {
JNI_FUNC_PTR(env,ExceptionClear)(env);
saveGlobalRef(env, exception, &(request->exception));
}
} END_WITH_LOCAL_REFS(env);
return JNI_TRUE;
}
void
invoker_completeInvokeRequest(jthread thread)
{
JNIEnv *env = getEnv();
PacketOutputStream out;
jbyte tag;
jobject exc;
jvalue returnValue;
jint id;
InvokeRequest *request;
jboolean detached;
JDI_ASSERT(thread);
/* Prevent gcc errors on uninitialized variables. */
tag = 0;
exc = NULL;
id = 0;
eventHandler_lock(); /* for proper lock order */
debugMonitorEnter(invokerLock);
request = threadControl_getInvokeRequest(thread);
if (request == NULL) {
EXIT_ERROR(AGENT_ERROR_INVALID_THREAD, "getting thread invoke request");
}
JDI_ASSERT(request->pending);
JDI_ASSERT(request->started);
request->pending = JNI_FALSE;
request->started = JNI_FALSE;
request->available = JNI_TRUE; /* For next time around */
detached = request->detached;
if (!detached) {
if (request->options & JDWP_INVOKE_OPTIONS(SINGLE_THREADED)) {
(void)threadControl_suspendThread(thread, JNI_FALSE);
} else {
(void)threadControl_suspendAll();
}
if (request->invokeType == INVOKE_CONSTRUCTOR) {
/*
* Although constructors technically have a return type of
* void, we return the object created.
*/
tag = specificTypeKey(env, request->returnValue.l);
} else {
tag = returnTypeTag(request->methodSignature);
}
id = request->id;
exc = request->exception;
returnValue = request->returnValue;
}
/*
* At this time, there's no need to retain global references on
* arguments since the reply is processed. No one will deal with
* this request ID anymore, so we must call deleteGlobalArgumentRefs().
*
* We cannot delete saved exception or return value references
* since otherwise a deleted handle would escape when writing
* the response to the stream. Instead, we clean those refs up
* after writing the respone.
*/
deleteGlobalArgumentRefs(env, request);
/*
* Give up the lock before I/O operation
*/
debugMonitorExit(invokerLock);
eventHandler_unlock();
if (!detached) {
outStream_initReply(&out, id);
(void)outStream_writeValue(env, &out, tag, returnValue);
(void)outStream_writeObjectTag(env, &out, exc);
(void)outStream_writeObjectRef(env, &out, exc);
outStream_sendReply(&out);
}
/*
* Delete potentially saved global references of return value
* and exception
*/
eventHandler_lock(); // for proper lock order
debugMonitorEnter(invokerLock);
deletePotentiallySavedGlobalRefs(env, request);
debugMonitorExit(invokerLock);
eventHandler_unlock();
}
jboolean
invoker_isPending(jthread thread)
{
InvokeRequest *request;
JDI_ASSERT(thread);
request = threadControl_getInvokeRequest(thread);
if (request == NULL) {
EXIT_ERROR(AGENT_ERROR_INVALID_THREAD, "getting thread invoke request");
}
return request->pending;
}
jboolean
invoker_isEnabled(jthread thread)
{
InvokeRequest *request;
JDI_ASSERT(thread);
request = threadControl_getInvokeRequest(thread);
if (request == NULL) {
EXIT_ERROR(AGENT_ERROR_INVALID_THREAD, "getting thread invoke request");
}
return request->available;
}
void
invoker_detach(InvokeRequest *request)
{
JDI_ASSERT(request);
debugMonitorEnter(invokerLock);
request->detached = JNI_TRUE;
debugMonitorExit(invokerLock);
}