1 /*
   2  * Copyright (c) 1998, 2006, 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.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 #ifndef JDWP_EVENTHANDLER_H
  27 #define JDWP_EVENTHANDLER_H
  28 
  29 #include "bag.h"
  30 
  31 typedef jint HandlerID;
  32 
  33 /* structure is read-only for users */
  34 typedef struct HandlerNode_ {
  35     HandlerID handlerID;
  36     EventIndex ei;
  37     jbyte suspendPolicy;
  38     jboolean permanent;
  39     int needReturnValue;
  40 } HandlerNode;
  41 
  42 typedef void (*HandlerFunction)(JNIEnv *env,
  43                                 EventInfo *evinfo,
  44                                 HandlerNode *node,
  45                                 struct bag *eventBag);
  46 
  47 /***** HandlerNode create = alloc + install *****/
  48 
  49 HandlerNode *eventHandler_alloc(jint filterCount, EventIndex ei,
  50                                 jbyte suspendPolicy);
  51 HandlerID eventHandler_allocHandlerID(void);
  52 jvmtiError eventHandler_installExternal(HandlerNode *node);
  53 HandlerNode *eventHandler_createPermanentInternal(EventIndex ei,
  54                                                   HandlerFunction func);
  55 HandlerNode *eventHandler_createInternalThreadOnly(EventIndex ei,
  56                                                    HandlerFunction func,
  57                                                    jthread thread);
  58 HandlerNode *eventHandler_createInternalBreakpoint(HandlerFunction func,
  59                                                    jthread thread,
  60                                                    jclass clazz,
  61                                                    jmethodID method,
  62                                                    jlocation location);
  63 
  64 /***** HandlerNode free *****/
  65 
  66 jvmtiError eventHandler_freeAll(EventIndex ei);
  67 jvmtiError eventHandler_freeByID(EventIndex ei, HandlerID handlerID);
  68 jvmtiError eventHandler_free(HandlerNode *node);
  69 void eventHandler_freeClassBreakpoints(jclass clazz);
  70 
  71 /***** HandlerNode manipulation *****/
  72 
  73 void eventHandler_initialize(jbyte sessionID);
  74 void eventHandler_reset(jbyte sessionID);
  75 
  76 void eventHandler_lock(void);
  77 void eventHandler_unlock(void);
  78 
  79 
  80 jclass getMethodClass(jvmtiEnv *jvmti_env, jmethodID method);
  81 
  82 #endif /* _EVENTHANDLER_H */