40
41 Naming conventions:
42 functions: THREAD_*
43
44 The following source files declares a set of functions which
45 provides support for lists of various objects
46
47 Source files:
48 nsk_list.h
49 nsk_list.c
50
51 Naming conventions:
52 functions: nsk_list_*
53
54 ---------------------------------------------------------------------------------
55
56 nsk_tools.h
57
58 Provides functions and macroses for the most usefull actions:
59
60 - access native JVM environment in a compiler independent manner
61
62 NSK_CPP_STUBn(function, env, arg1, ..., argn)
63
64 - print error message with arguments
65
66 NSK_COMPLAINn(format, arg1, ..., argn)
67
68 - print verbose message with arguments
69
70 NSK_DISPLAYn(format, arg1, ..., argn)
71
72 - trace action execution
73
74 NSK_TRACE(action)
75
76 - trace action, check result for true/false and print error if required
77
78 NSK_VERIFY(action)
79 NSK_VERIFY_NEGATIVE(action)
80
81 - set verbose and trace mode of test output
82
83 void nsk_setVerboseMode(int verbose);
84 int nsk_getVerboseMode();
85
86 void nsk_setTraceMode(int mode);
87 int nsk_getTraceMode();
88
89 - miscelaneous functions for printing messages
90 (hidden by above mentioned macroses)
91
92 Typical example of using macroses NSK_CPP_STUB and NSK_VERIFY
93 for accesing JVM native environment:
94
95 // jvm->GetEnv(jvm, &env, version)
96 if (!NSK_VERIFY(
97 jvm->GetEnv(&env, JNI_VERSION_1_2) == JNI_OK)) {
98 return JNI_ERR;
99 }
100
101 For more specific checks in invocations of JNI and JVMTI functions
102 use special macroses defined in share/jni and share/jvmti frameworks.
103
104 ---------------------------------------------------------------------------------
105
106 native_thread.h
107
108 Provides platform-independent support for running native threads:
109
110 - manage native threads
111
112 void* THREAD_new(PROCEDURE procedure, void* context);
|
40
41 Naming conventions:
42 functions: THREAD_*
43
44 The following source files declares a set of functions which
45 provides support for lists of various objects
46
47 Source files:
48 nsk_list.h
49 nsk_list.c
50
51 Naming conventions:
52 functions: nsk_list_*
53
54 ---------------------------------------------------------------------------------
55
56 nsk_tools.h
57
58 Provides functions and macroses for the most usefull actions:
59
60 - print error message with arguments
61
62 NSK_COMPLAINn(format, arg1, ..., argn)
63
64 - print verbose message with arguments
65
66 NSK_DISPLAYn(format, arg1, ..., argn)
67
68 - trace action execution
69
70 NSK_TRACE(action)
71
72 - trace action, check result for true/false and print error if required
73
74 NSK_VERIFY(action)
75 NSK_VERIFY_NEGATIVE(action)
76
77 - set verbose and trace mode of test output
78
79 void nsk_setVerboseMode(int verbose);
80 int nsk_getVerboseMode();
81
82 void nsk_setTraceMode(int mode);
83 int nsk_getTraceMode();
84
85 - miscelaneous functions for printing messages
86 (hidden by above mentioned macroses)
87
88 Typical example of using the NSK_VERIFY macro
89 for accesing JVM native environment:
90
91 // jvm->GetEnv(jvm, &env, version)
92 if (!NSK_VERIFY(
93 jvm->GetEnv(&env, JNI_VERSION_1_2) == JNI_OK)) {
94 return JNI_ERR;
95 }
96
97 For more specific checks in invocations of JNI and JVMTI functions
98 use special macroses defined in share/jni and share/jvmti frameworks.
99
100 ---------------------------------------------------------------------------------
101
102 native_thread.h
103
104 Provides platform-independent support for running native threads:
105
106 - manage native threads
107
108 void* THREAD_new(PROCEDURE procedure, void* context);
|