Return-Path: Delivered-To: apmail-harmony-commits-archive@www.apache.org Received: (qmail 68772 invoked from network); 9 Dec 2008 15:05:46 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 9 Dec 2008 15:05:46 -0000 Received: (qmail 52142 invoked by uid 500); 9 Dec 2008 15:05:58 -0000 Delivered-To: apmail-harmony-commits-archive@harmony.apache.org Received: (qmail 52127 invoked by uid 500); 9 Dec 2008 15:05:58 -0000 Mailing-List: contact commits-help@harmony.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@harmony.apache.org Delivered-To: mailing list commits@harmony.apache.org Received: (qmail 52118 invoked by uid 99); 9 Dec 2008 15:05:58 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 09 Dec 2008 07:05:58 -0800 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 09 Dec 2008 15:04:21 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id D7FE223898CD; Tue, 9 Dec 2008 07:04:01 -0800 (PST) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r724734 [45/46] - in /harmony/standard/site: docs/externals/kernel_doc/ docs/externals/kernel_doc/html/ docs/externals/vm_doc/ docs/externals/vm_doc/html/ docs/subcomponents/classlibrary/ xdocs/subcomponents/classlibrary/ Date: Tue, 09 Dec 2008 15:03:51 -0000 To: commits@harmony.apache.org From: tellison@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20081209150401.D7FE223898CD@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Propchange: harmony/standard/site/docs/externals/vm_doc/html/structHyPortLibrary.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/structHyVMLSFunctionTable.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/structHyVMLSFunctionTable.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/structHyVMLSFunctionTable.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/structHyVMLSFunctionTable.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,39 @@ + + +Harmony Class Library Porting: HyVMLSFunctionTable Struct Reference + + + + +
+ +
+
+ +
+

HyVMLSFunctionTable Struct Reference

#include <hyvmls.h> +

+

Detailed Description

+The VM local storage function table. + +
+
The documentation for this struct was generated from the following file:
    +
  • modules/luni/src/main/native/include/shared/hyvmls.h
+
+
+ +

Genereated on Tue Dec 9 14:13:00 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/structHyVMLSFunctionTable.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/structVMInterfaceFunctions__.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/structVMInterfaceFunctions__.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/structVMInterfaceFunctions__.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/structVMInterfaceFunctions__.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,205 @@ + + +Harmony Class Library Porting: VMInterfaceFunctions_ Struct Reference + + + + +
+ +
+
+ +
+

VMInterfaceFunctions_ Struct Reference

#include <vmi.h> +

+

Detailed Description

+The VM interface function table. +

+Example usage: 

 JavaVM* vm = (*vmi)->GetJavaVM(vmi);
+
+ + + + + + + + + + + + + + + + + +

Public Member Functions

JavaVM *JNICALL * GetJavaVM (VMInterface *vmi)
 Return the JNI JavaVM associated with the VM interface.
HyPortLibrary *JNICALL * GetPortLibrary (VMInterface *vmi)
 Return a pointer to an initialized HyPortLibrary structure.
HyVMLSFunctionTable *JNICALL * GetVMLSFunctions (VMInterface *vmi)
 Return a pointer to a HyVMLSFunctionTable.
HyZipCachePool *JNICALL * GetZipCachePool (VMInterface *vmi)
 ifndef HY_ZIP_API
JavaVMInitArgs *JNICALL * GetInitArgs (VMInterface *vmi)
 Return a pointer to a JavaVMInitArgs structure as defined by the 1.2 JNI specification.
+

Member Function Documentation

+ +
+
+ + + + + + + + + +
VMInterfaceFunctions_::GetJavaVM (VMInterface *  vmi  ) 
+
+
+ +

+Return the JNI JavaVM associated with the VM interface. +

+

 JavaVM* JNICALL GetJavaVM(VMInterface* vmi); 
+

+

Parameters:
+ + +
[in] vmi The VM interface pointer
+
+
Returns:
a JavaVM pointer
+ +
+

+ +

+
+ + + + + + + + + +
VMInterfaceFunctions_::GetPortLibrary (VMInterface *  vmi  ) 
+
+
+ +

+Return a pointer to an initialized HyPortLibrary structure. +

+

 HyPortLibrary* JNICALL GetPortLibrary(VMInterface* vmi); 
+

+The port library is a table of functions that implement useful platform specific capability. For example, file and socket manipulation, memory management, etc. It is the responsibility of the VM to create the port library.

+

Parameters:
+ + +
[in] vmi The VM interface pointer
+
+
Returns:
the HyPortLibrary associated with the VMI
+
See also:
hyport.c
+ +
+

+ +

+
+ + + + + + + + + +
VMInterfaceFunctions_::GetVMLSFunctions (VMInterface *  vmi  ) 
+
+
+ +

+Return a pointer to a HyVMLSFunctionTable. +

+This is a table of functions for allocating, freeing, getting, and setting thread local storage.

+

 HyVMLSFunctionTable* JNICALL GetVMLSFunctions(VMInterface* vmi); 
+

+

Parameters:
+ + +
[in] vmi The VM interface pointer
+
+
Returns:
the VM local storage function table
+ +
+

+ +

+
+ + + + + + + + + +
VMInterfaceFunctions_::GetZipCachePool (VMInterface *  vmi  ) 
+
+
+ +

+ifndef HY_ZIP_API +

+Return a pointer to the HyZipCachePool structure used by the VM. It is the responsibility of the vm to allocate the pool using zipCachePool_new(). else +

+

+ +

+
+ + + + + + + + + +
VMInterfaceFunctions_::GetInitArgs (VMInterface *  vmi  ) 
+
+
+ +

+Return a pointer to a JavaVMInitArgs structure as defined by the 1.2 JNI specification. +

+This structure contains the arguments used to invoke the vm.

+

 JavaVMInitArgs* JNICALL GetInitArgs(VMInterface* vmi); 
+

+

Parameters:
+ + +
[in] vmi The VM interface pointer
+
+
Returns:
the VM invocation arguments
+ +
+

+

The documentation for this struct was generated from the following file:
    +
  • modules/luni/src/main/native/include/shared/vmi.h
+
+
+ +

Genereated on Tue Dec 9 14:13:00 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/structVMInterfaceFunctions__.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/structhyaddrinfo__struct.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/structhyaddrinfo__struct.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/structhyaddrinfo__struct.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/structhyaddrinfo__struct.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,39 @@ + + +Harmony Class Library Porting: hyaddrinfo_struct Struct Reference + + + + +
+ +
+
+ +
+

hyaddrinfo_struct Struct Reference

#include <hysock.h> +

+

Detailed Description

+structure for IPv6 addrinfo will either point to a hostent or an addr info depending on the IPv6 support for this OS + +
+
The documentation for this struct was generated from the following file:
    +
  • modules/portlib/src/main/native/include/windows/hysock.h
+
+
+ +

Genereated on Tue Dec 9 14:13:00 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/structhyaddrinfo__struct.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiCapabilities.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/structjvmtiCapabilities.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/structjvmtiCapabilities.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/structjvmtiCapabilities.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,39 @@ + + +Harmony Class Library Porting: jvmtiCapabilities Struct Reference + + + + +
+ +
+
+ +
+

jvmtiCapabilities Struct Reference

#include <jvmti_types.h> +

+

Detailed Description

+OPEN components should be aware of event management capabilities. + +
+
The documentation for this struct was generated from the following file:
    +
  • modules/luni/src/main/native/include/shared/jvmti_types.h
+
+
+ +

Genereated on Tue Dec 9 14:13:00 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiCapabilities.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiFrameInfo.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/structjvmtiFrameInfo.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/structjvmtiFrameInfo.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/structjvmtiFrameInfo.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,39 @@ + + +Harmony Class Library Porting: jvmtiFrameInfo Struct Reference + + + + +
+ +
+
+ +
+

jvmtiFrameInfo Struct Reference

#include <jvmti_types.h> +

+

Detailed Description

+Stack frame data (from spec). + +
+
The documentation for this struct was generated from the following file:
    +
  • modules/luni/src/main/native/include/shared/jvmti_types.h
+
+
+ +

Genereated on Tue Dec 9 14:13:00 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiFrameInfo.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiStackInfo.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/structjvmtiStackInfo.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/structjvmtiStackInfo.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/structjvmtiStackInfo.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,39 @@ + + +Harmony Class Library Porting: jvmtiStackInfo Struct Reference + + + + +
+ +
+
+ +
+

jvmtiStackInfo Struct Reference

#include <jvmti_types.h> +

+

Detailed Description

+Thread stack data (from spec). + +
+
The documentation for this struct was generated from the following file:
    +
  • modules/luni/src/main/native/include/shared/jvmti_types.h
+
+
+ +

Genereated on Tue Dec 9 14:13:00 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiStackInfo.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadGroupInfo.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadGroupInfo.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadGroupInfo.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadGroupInfo.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,39 @@ + + +Harmony Class Library Porting: jvmtiThreadGroupInfo Struct Reference + + + + +
+ +
+
+ +
+

jvmtiThreadGroupInfo Struct Reference

#include <jvmti_types.h> +

+

Detailed Description

+Thread group data (from spec). + +
+
The documentation for this struct was generated from the following file:
    +
  • modules/luni/src/main/native/include/shared/jvmti_types.h
+
+
+ +

Genereated on Tue Dec 9 14:13:00 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadGroupInfo.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadInfo.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadInfo.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadInfo.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadInfo.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,39 @@ + + +Harmony Class Library Porting: jvmtiThreadInfo Struct Reference + + + + +
+ +
+
+ +
+

jvmtiThreadInfo Struct Reference

#include <jvmti_types.h> +

+

Detailed Description

+Thread data (from spec). + +
+
The documentation for this struct was generated from the following file:
    +
  • modules/luni/src/main/native/include/shared/jvmti_types.h
+
+
+ +

Genereated on Tue Dec 9 14:13:00 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/structjvmtiThreadInfo.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/tab_b.gif URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/tab_b.gif?rev=724734&view=auto ============================================================================== Binary file - no diff available. Propchange: harmony/standard/site/docs/externals/vm_doc/html/tab_b.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: harmony/standard/site/docs/externals/vm_doc/html/tab_l.gif URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/tab_l.gif?rev=724734&view=auto ============================================================================== Binary file - no diff available. Propchange: harmony/standard/site/docs/externals/vm_doc/html/tab_l.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: harmony/standard/site/docs/externals/vm_doc/html/tab_r.gif URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/tab_r.gif?rev=724734&view=auto ============================================================================== Binary file - no diff available. Propchange: harmony/standard/site/docs/externals/vm_doc/html/tab_r.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: harmony/standard/site/docs/externals/vm_doc/html/tabs.css URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/tabs.css?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/tabs.css (added) +++ harmony/standard/site/docs/externals/vm_doc/html/tabs.css Tue Dec 9 07:03:45 2008 @@ -0,0 +1,102 @@ +/* tabs styles, based on http://www.alistapart.com/articles/slidingdoors */ + +DIV.tabs +{ + float : left; + width : 100%; + background : url("tab_b.gif") repeat-x bottom; + margin-bottom : 4px; +} + +DIV.tabs UL +{ + margin : 0px; + padding-left : 10px; + list-style : none; +} + +DIV.tabs LI, DIV.tabs FORM +{ + display : inline; + margin : 0px; + padding : 0px; +} + +DIV.tabs FORM +{ + float : right; +} + +DIV.tabs A +{ + float : left; + background : url("tab_r.gif") no-repeat right top; + border-bottom : 1px solid #84B0C7; + font-size : x-small; + font-weight : bold; + text-decoration : none; +} + +DIV.tabs A:hover +{ + background-position: 100% -150px; +} + +DIV.tabs A:link, DIV.tabs A:visited, +DIV.tabs A:active, DIV.tabs A:hover +{ + color: #1A419D; +} + +DIV.tabs SPAN +{ + float : left; + display : block; + background : url("tab_l.gif") no-repeat left top; + padding : 5px 9px; + white-space : nowrap; +} + +DIV.tabs INPUT +{ + float : right; + display : inline; + font-size : 1em; +} + +DIV.tabs TD +{ + font-size : x-small; + font-weight : bold; + text-decoration : none; +} + + + +/* Commented Backslash Hack hides rule from IE5-Mac \*/ +DIV.tabs SPAN {float : none;} +/* End IE5-Mac hack */ + +DIV.tabs A:hover SPAN +{ + background-position: 0% -150px; +} + +DIV.tabs LI.current A +{ + background-position: 100% -150px; + border-width : 0px; +} + +DIV.tabs LI.current SPAN +{ + background-position: 0% -150px; + padding-bottom : 6px; +} + +DIV.nav +{ + background : none; + border : none; + border-bottom : 1px solid #84B0C7; +} Propchange: harmony/standard/site/docs/externals/vm_doc/html/tabs.css ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/vmi_8h.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/vmi_8h.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/vmi_8h.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/vmi_8h.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,499 @@ + + +Harmony Class Library Porting: modules/luni/src/main/native/include/shared/vmi.h File Reference + + + + +
+ +
+

modules/luni/src/main/native/include/shared/vmi.h File Reference

Detailed Description

+VM interface specification. +

+ +

+#include "jni.h"
+#include "hyport.h"
+#include "hyvmls.h"
+#include "zipsup.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Data Structures

struct  VMInterfaceFunctions_
 The VM interface function table. More...

Defines

#define VMI_ACCESS_FROM_ENV(env)   VMInterface* privateVMI = VMI_GetVMIFromJNIEnv(env)
 Convenience macros for acquiring a VMInterface.
#define BOOTCLASSPATH_PROPERTY   "org.apache.harmony.boot.class.path"
 Name of the property holding bootclasspath string.

Typedefs

typedef struct
+VMInterfaceFunctions_ * 		VMInterface
 The VM interface structure.

Enumerations

enum  vmiError {
+  VMI_ERROR_NONE = 0, +
+  VMI_ERROR_UNKNOWN = 1, +
+  VMI_ERROR_UNIMPLEMENTED = 2, +
+  VMI_ERROR_UNSUPPORTED_VERSION = 3, +
+  VMI_ERROR_OUT_OF_MEMORY = 4, +
+  VMI_ERROR_ILLEGAL_ARG = 5, +
+  VMI_ERROR_READ_ONLY = 6 +
+ }
 Enumeration of all possible return codes from VM interface functions. More...
enum  vmiVersion {
+  VMI_VERSION_UNKNOWN = 0x00000000, +
+  VMI_VERSION_1_0 = 0x00010000 +
+ }
 VM interface version identifier. More...

Functions

VMInterface *JNICALL VMI_GetVMIFromJNIEnv (JNIEnv *env)
 Extract the VM interface from a JNIEnv.
VMInterface *JNICALL VMI_GetVMIFromJavaVM (JavaVM *vm)
 Extract the VM interface from a JNI JavaVM.
vmiError JNICALL CheckVersion (VMInterface *vmi, vmiVersion *version)
 Check the version of the VM interface.
vmiError JNICALL GetSystemProperty (VMInterface *vmi, char *key, char **valuePtr)
 Retrieve the value of a VM system property.
vmiError JNICALL SetSystemProperty (VMInterface *vmi, char *key, char *value)
 Override the value of a VM system property.
vmiError JNICALL CountSystemProperties (VMInterface *vmi, int *countPtr)
 Return the number of VM system properties.
vmiError JNICALL IterateSystemProperties (VMInterface *vmi, vmiSystemPropertyIterator iterator, void *userData)
 Iterate over the VM system properties calling a function.
+

Define Documentation

+ +
+
+ + + + +
#define BOOTCLASSPATH_PROPERTY   "org.apache.harmony.boot.class.path"
+
+
+ +

+Name of the property holding bootclasspath string. +

+ +

+

+ +

+
+ + + + + + + + + +
#define VMI_ACCESS_FROM_ENV (env   )    VMInterface* privateVMI = VMI_GetVMIFromJNIEnv(env)
+
+
+ +

+Convenience macros for acquiring a VMInterface. +

+ +

+

+

Typedef Documentation

+ +
+
+ + + + +
VMInterface
+
+
+ +

+The VM interface structure. +

+Points to the VM interface function table. Implementations will likely choose to store opaque data off this structure. +

+

+

Enumeration Type Documentation

+ +
+
+ + + + +
enum vmiError
+
+
+ +

+Enumeration of all possible return codes from VM interface functions. +

+

Enumerator:
+ + + + + + + + +
VMI_ERROR_NONE  +Success.
VMI_ERROR_UNKNOWN  +Unknown error.
VMI_ERROR_UNIMPLEMENTED  +Function has not been implemented.
VMI_ERROR_UNSUPPORTED_VERSION  +The requested VM interface version is not supported.
VMI_ERROR_OUT_OF_MEMORY  +Not enough memory was available to complete the request.
VMI_ERROR_ILLEGAL_ARG  +An attempt to set illegal value (e.g. +

+NULL value is not allowed in system properties)

VMI_ERROR_READ_ONLY  +An attempt was made to modify a read-only item.
+
+ +
+

+ +

+
+ + + + +
enum vmiVersion
+
+
+ +

+VM interface version identifier. +

+

Enumerator:
+ + + +
VMI_VERSION_UNKNOWN  +Unknown VMInterface version.
VMI_VERSION_1_0  +VMInterface version 1.0.
+
+ +
+

+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + +
VMInterfaceFunctions_::CheckVersion (VMInterface *  vmi,
vmiVersion *  version 
)
+
+
+ +

+Check the version of the VM interface. +

+

 vmiError JNICALL CheckVersion(VMInterface* vmi, vmiVersion* version); 
+

+

Parameters:
+ + + +
[in] vmi The VM interface pointer
[in,out] version Pass in the version to check, or VMI_VERSION_UNKNOWN. Returns the current version.
+
+
Returns:
a VMI error code
+
Note:
The CheckVersion function allows a class library to verify that the VM provides the required interface functions. If the version requested is VMI_VERSION_UNKNOWN, then the function will reply with the current version and not return an error. If a specific version is passed, it will be compatibility checked against the current, and VMI_ERROR_UNSUPPORTED_VERSION may be returned.
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
VMInterfaceFunctions_::CountSystemProperties (VMInterface *  vmi,
int *  countPtr 
)
+
+
+ +

+Return the number of VM system properties. +

+

 vmiError JNICALL CountSystemProperties(VMInterface* vmi, int* countPtr); 
+

+

Parameters:
+ + + +
[in] vmi The VM interface pointer
[out] countPtr The location to store the number of system properties
+
+
Returns:
a VMI error code
+
Note:
See GetSystemProperty() for the list of properties that must be defined by the vm.
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
VMInterfaceFunctions_::GetSystemProperty (VMInterface *  vmi,
char *  key,
char **  valuePtr 
)
+
+
+ +

+Retrieve the value of a VM system property. +

+

Note:
The returned string is owned by the VM, and should not be freed.
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
VMInterfaceFunctions_::IterateSystemProperties (VMInterface *  vmi,
vmiSystemPropertyIterator  iterator,
void *  userData 
)
+
+
+ +

+Iterate over the VM system properties calling a function. +

+

Parameters:
+ + + + +
[in] vmi The VM interface pointer
[in] iterator The iterator function to call with each property
[in] userData Opaque data to pass to the iterator function
+
+
Returns:
a VMI error code
+
Note:
The returned strings are owned by the VM, and should not be freed.

+See GetSystemProperty() for the list of properties that must be defined by the vm.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
VMInterfaceFunctions_::SetSystemProperty (VMInterface *  vmi,
char *  key,
char *  value 
)
+
+
+ +

+Override the value of a VM system property. +

+

 vmiError JNICALL SetSystemProperty(VMInterface* vmi, char* key, char* value); 
+

+

Parameters:
+ + + + +
[in] vmi The VM interface pointer
[in] key The system property to override
[in] value The value of the system property
+
+
Returns:
a VMI error code
+
Note:
Only existing properties can be overridden. New properties cannot be added by this mechanism.

+See GetSystemProperty() for the list of properties that must be defined by the vm.

+ +
+

+ +

+
+ + + + + + + + + +
VMInterface* JNICALL VMI_GetVMIFromJavaVM (JavaVM *  vm  ) 
+
+
+ +

+Extract the VM interface from a JNI JavaVM. +

+Extract the VM interface from a JNI JavaVM.

+This stub implementation is non-functional, provided for the purposes of building the dependent natives. Extract the VM Interface from a JNI JavaVM

+

Parameters:
+ + +
[in] vm The JavaVM to query
+
+
Returns:
a VMInterface pointer
+ +
+

+ +

+
+ + + + + + + + + +
VMInterface* JNICALL VMI_GetVMIFromJNIEnv (JNIEnv *  env  ) 
+
+
+ +

+Extract the VM interface from a JNIEnv. +

+Extract the VM interface from a JNIEnv.

+

Parameters:
+ + +
[in] env The JNIEnv to query
+
+
Returns:
a VMInterface pointer
+ +
+

+

+
+ +

Genereated on Tue Dec 9 14:12:59 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/vmi_8h.html ------------------------------------------------------------------------------ svn:eol-style = native Added: harmony/standard/site/docs/externals/vm_doc/html/vminterfaces.gif URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/vminterfaces.gif?rev=724734&view=auto ============================================================================== Binary file - no diff available. Propchange: harmony/standard/site/docs/externals/vm_doc/html/vminterfaces.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: harmony/standard/site/docs/externals/vm_doc/html/vmport.gif URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/vmport.gif?rev=724734&view=auto ============================================================================== Binary file - no diff available. Propchange: harmony/standard/site/docs/externals/vm_doc/html/vmport.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: harmony/standard/site/docs/externals/vm_doc/html/zcpool_8c.html URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/externals/vm_doc/html/zcpool_8c.html?rev=724734&view=auto ============================================================================== --- harmony/standard/site/docs/externals/vm_doc/html/zcpool_8c.html (added) +++ harmony/standard/site/docs/externals/vm_doc/html/zcpool_8c.html Tue Dec 9 07:03:45 2008 @@ -0,0 +1,298 @@ + + +Harmony Class Library Porting: modules/archive/src/main/native/zip/shared/zcpool.c File Reference + + + + +
+ +
+

modules/archive/src/main/native/zip/shared/zcpool.c File Reference

Detailed Description

+Zip Support for Java VM. +

+ +

+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include "hyport.h"
+#include "zipsup.h"
+#include "hypool.h"
+#include "hymutex.h"
+ + + + + + + + + + + + + + + + + + + + + +

Functions

BOOLEAN zipCachePool_addCache (HyZipCachePool *zcp, HyZipCache *zipCache)
 Add a new cache to the pool with reference count of 1.
BOOLEAN zipCachePool_addRef (HyZipCachePool *zcp, HyZipCache *zipCache)
 Increment the reference count of a cache in the pool.
HyZipCache * zipCachePool_findCache (HyZipCachePool *zcp, char const *zipFileName, IDATA zipFileNameLength, IDATA zipFileSize, I_64 zipTimeStamp)
 Scans the pool for a cache with matching zipFileName, zipFileSize and zipTimeStamp.
void zipCachePool_kill (HyZipCachePool *zcp)
 Deletes a pool containing shareable zip caches.
HyZipCachePool * zipCachePool_new (HyPortLibrary *portLib)
 Creates a pool to hold shareable zip caches with their reference counts.
BOOLEAN zipCachePool_release (HyZipCachePool *zcp, HyZipCache *zipCache)
 Decrements the reference count of a cache in the pool.
+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + +
BOOLEAN zipCachePool_addCache (HyZipCachePool *  zcp,
HyZipCache *  zipCache 
)
+
+
+ +

+Add a new cache to the pool with reference count of 1. +

+When reference count reaches zero the pool will automatically be freed.

+

Parameters:
+ + + +
[in] zcp the zip cache pool that is being added to.
[in] zipCache the zip cache being added.
+
+
Returns:
TRUE if successful, FALSE otherwise.
+
Note:
A cache may only reside in one pool (read: multiple VMs may not share caches with each other).
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
BOOLEAN zipCachePool_addRef (HyZipCachePool *  zcp,
HyZipCache *  zipCache 
)
+
+
+ +

+Increment the reference count of a cache in the pool. +

+

Note:
Result is undefined if the cache is not actually in the pool!
+
Parameters:
+ + + +
[in] zcp the zip cache pool that is being added to.
[in] zipCache the zip cache being added.
+
+
Returns:
TRUE if successful, FALSE otherwise.
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HyZipCache* zipCachePool_findCache (HyZipCachePool *  zcp,
char const *  zipFileName,
IDATA  zipFileNameLength,
IDATA  zipFileSize,
I_64  zipTimeStamp 
)
+
+
+ +

+Scans the pool for a cache with matching zipFileName, zipFileSize and zipTimeStamp. +

+The reference count is incremented and the cache is returned if a match is found.

+

Parameters:
+ + + + + + +
[in] zcp the zip cache pool to search
[in] zipFileName the name to test for match
[in] zipFileNameLength the length of zipFileName
[in] zipFileSize the size to test for match
[in] zipTimeStamp the time stamp to test for match
+
+
Returns:
the matching zip cache

+NULL if no match is found.

+ +
+

+ +

+
+ + + + + + + + + +
void zipCachePool_kill (HyZipCachePool *  zcp  ) 
+
+
+ +

+Deletes a pool containing shareable zip caches. +

+

Parameters:
+ + +
[in] zcp the zip cache pool that is being deleted
+
+
Returns:
none
+
Note:
Warning: This also deletes remaining caches in the pool, regardless of their reference counts!
+ +
+

+ +

+
+ + + + + + + + + +
HyZipCachePool* zipCachePool_new (HyPortLibrary *  portLib  ) 
+
+
+ +

+Creates a pool to hold shareable zip caches with their reference counts. +

+This should be called once per VM.

+

Parameters:
+ + +
[in] portLib the port library
+
+
Returns:
a zip cache pool or NULL if one cannot be created
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
BOOLEAN zipCachePool_release (HyZipCachePool *  zcp,
HyZipCache *  zipCache 
)
+
+
+ +

+Decrements the reference count of a cache in the pool. +

+If the reference count reaches 0, the cache is removed from the pool and zipCache_kill is called on it.

+

Parameters:
+ + + +
[in] zcp the zip cache pool
[in] zipCache the zip cache whose count is being decremented.
+
+
Returns:
TRUE if the cache was destroyed

+FALSE if the cache is still in the pool.

+ +
+

+

+
+ +

Genereated on Tue Dec 9 14:12:59 2008 by Doxygen.

+

(c) Copyright 2005, 2008 The Apache Software Foundation or its licensors, as applicable.

+ +
+ + Propchange: harmony/standard/site/docs/externals/vm_doc/html/zcpool_8c.html ------------------------------------------------------------------------------ svn:eol-style = native