test/lib/sun/hotspot/WhiteBox.java

rev 2451 : imported patch whitebox

*** 1,7 ****
  /*
!  * Copyright (c) 2012, 2016, 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.
--- 1,7 ----
  /*
!  * Copyright (c) 2012, 2017, 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.
*** 388,397 ****
--- 388,425 ----
    public native void youngGC();
  
    // Force Full GC
    public native void fullGC();
  
+   // Returns true if the current GC supports control of its concurrent
+   // phase via requestConcurrentGCPhase().  If false, a request will
+   // always fail.
+   public native boolean supportsConcurrentGCPhaseControl();
+ 
+   // Attempt to put the collector into the indicated concurrent phase,
+   // and attempt to remain in that state until a new request is made.
+   //
+   // Returns immediately if already in that state.  Otherwise, waits
+   // until the state is reached.
+   //
+   // Throws IllegalStateException if unsupported by the current collector.
+   // Throws NullPointerException if phase is null.
+   // Throws IllegalArgumentException if phase is not valid for the current collector.
+   public void requestConcurrentGCPhase(String phase) {
+     if (!supportsConcurrentGCPhaseControl()) {
+       throw new IllegalStateException("Concurrent GC phase control not supported");
+     } else if (phase == null) {
+       throw new NullPointerException("null phase");
+     } else if (!requestConcurrentGCPhase0(phase)) {
+       throw new IllegalArgumentException("Unknown concurrent GC phase: " + phase);
+     }
+   }
+ 
+   // Helper for requestConcurrentGCPhase().  Returns true if request
+   // succeeded, false if the phase is invalid.
+   private native boolean requestConcurrentGCPhase0(String phase);
+ 
    // Method tries to start concurrent mark cycle.
    // It returns false if CM Thread is always in concurrent cycle.
    public native boolean g1StartConcMarkCycle();
  
    // Tests on ReservedSpace/VirtualSpace classes