1 /*
   2  * Copyright (c) 2003, 2005, 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 _JAVA_JVMTI_MANAGE_CAPABILITIES_H_
  26 #define _JAVA_JVMTI_MANAGE_CAPABILITIES_H_
  27 
  28 
  29 
  30 class JvmtiManageCapabilities : public AllStatic {
  31 
  32 private:
  33 
  34   // these four capabilities sets represent all potentially
  35   // available capabilities.  They are disjoint, covering
  36   // the four cases: (OnLoad vs OnLoad+live phase) X
  37   // (one environment vs any environment).
  38   static jvmtiCapabilities always_capabilities;
  39   static jvmtiCapabilities onload_capabilities;
  40   static jvmtiCapabilities always_solo_capabilities;
  41   static jvmtiCapabilities onload_solo_capabilities;
  42 
  43   // solo capabilities that have not been grabbed
  44   static jvmtiCapabilities always_solo_remaining_capabilities;
  45   static jvmtiCapabilities onload_solo_remaining_capabilities;
  46 
  47   // all capabilities ever acquired
  48   static jvmtiCapabilities acquired_capabilities;
  49 
  50   // basic intenal operations
  51   static jvmtiCapabilities *either(const jvmtiCapabilities *a, const jvmtiCapabilities *b, jvmtiCapabilities *result);
  52   static jvmtiCapabilities *both(const jvmtiCapabilities *a, const jvmtiCapabilities *b, jvmtiCapabilities *result);
  53   static jvmtiCapabilities *exclude(const jvmtiCapabilities *a, const jvmtiCapabilities *b, jvmtiCapabilities *result);
  54   static bool has_some(const jvmtiCapabilities *a);
  55   static void update();
  56 
  57   // init functions
  58   static jvmtiCapabilities init_always_capabilities();
  59   static jvmtiCapabilities init_onload_capabilities();
  60   static jvmtiCapabilities init_always_solo_capabilities();
  61   static jvmtiCapabilities init_onload_solo_capabilities();
  62 
  63 public:
  64   static void initialize();
  65 
  66   // may have to adjust always capabilities when VM initialization has completed
  67   static void recompute_always_capabilities();
  68 
  69   // queries and actions
  70   static void get_potential_capabilities(const jvmtiCapabilities *current,
  71                                          const jvmtiCapabilities *prohibited,
  72                                          jvmtiCapabilities *result);
  73   static jvmtiError add_capabilities(const jvmtiCapabilities *current,
  74                                      const jvmtiCapabilities *prohibited,
  75                                      const jvmtiCapabilities *desired,
  76                                      jvmtiCapabilities *result);
  77   static void relinquish_capabilities(const jvmtiCapabilities *current,
  78                                       const jvmtiCapabilities *unwanted,
  79                                       jvmtiCapabilities *result);
  80   static void copy_capabilities(const jvmtiCapabilities *from, jvmtiCapabilities *to);
  81 
  82 #ifndef PRODUCT
  83   static void print(const jvmtiCapabilities* caps);
  84 #endif
  85 };
  86 
  87 #endif   /* _JAVA_JVMTI_MANAGE_CAPABILITIES_H_ */