[Javaprofiler-commits] CVS: interface/net/sourceforge/javaprofiler/jpi VirtualMachine.java,1.4,1.5

[Jan S. <st...@us...>]

Update of /cvsroot/javaprofiler/interface/net/sourceforge/javaprofiler/jpi
In directory usw-pr-cvs1:/tmp/cvs-serv659

Modified Files:
	VirtualMachine.java 
Log Message:
isShutdowned() and shutdown() methods added.

Index: VirtualMachine.java
===================================================================
RCS file: /cvsroot/javaprofiler/interface/net/sourceforge/javaprofiler/jpi/VirtualMachine.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -r1.4 -r1.5
*** VirtualMachine.java	2001/09/29 20:55:06	1.4
--- VirtualMachine.java	2002/01/27 22:49:17	1.5
***************
*** 107,114 ****
--- 107,146 ----
      public void resumeThreads();
      
+     /**
+      * Checks if profiled JVM is shutting down. So, it means, the JVM is no
+      * longer running, the JVMPI_EVENT_JVM_SHUTDOWN event was received and
+      * profiler dynamic library waits in JVMPI_EVENT_JVM_SHUTDOWN event
+      * handler. The client can now gain any necessary data before calling
+      * the shutdown() method which shutdowns JVM definitelly.
+      *
+      * @return true (JVM is shutting down);
+      *         false (still running, normal operation)
+      *
+      * @see shutdown(), exitVM()
+      */
+     public boolean isShutdowned();
+     
+     /**
+      * Shuts profiled JVM down. When profiled JVM is ending, it sends
+      * the JVMPI_EVENT_JVM_SHUTDOWN event to profiler dynamic library.
+      * Then the library waits in JVMPI_EVENT_JVM_SHUTDOWN event handler
+      * until the client calls this method. The goal is the client can make
+      * any necessary calls to gain data before profiled JVM really shutdowns
+      * (so before client's shutdown() call).
+      *
+      * Note: this method doesn't stop running JVM, to stop running JVM,
+      * use exitVM() method instead.
+      *
+      * @see isShutdowned(), exitVM()
+      */
+     public void shutdown();
+     
  }
  
  /*
   * $Log$
+  * Revision 1.5  2002/01/27 22:49:17  stolis
+  * isShutdowned() and shutdown() methods added.
+  *
   * Revision 1.4  2001/09/29 20:55:06  stolis
   * Plural added in licenses.