< prev index next >

src/hotspot/share/prims/jvmti.xml

Print this page
rev 47223 : [mq]: heapz8
rev 47224 : [mq]: heap9a
rev 47225 : [mq]: heap10


11522       <origin>new</origin>
11523       <capabilities>
11524       </capabilities>
11525       <parameters>
11526         <param id="format_ptr">
11527           <outptr><enum>jvmtiJlocationFormat</enum></outptr>
11528           <description>
11529             On return, points to the format identifier for <code>jlocation</code> values.
11530           </description>
11531         </param>
11532       </parameters>
11533       <errors>
11534       </errors>
11535     </function>
11536 
11537   </category>
11538 
11539   <category id="heap_monitoring" label="Heap Monitoring">
11540     <typedef id="jvmtiStackTrace" label="Stack Trace">
11541       <field id="frames">
11542         <allocfieldbuf outcount="trace_count">
11543           <struct>jvmtiFrameInfo</struct>
11544         </allocfieldbuf>
11545         <description>Pointer to the call frames.</description>
11546       </field>
11547       <field id="frame_count">
11548         <jint/>
11549         <description>The number of frames for the trace.</description>
11550       </field>
11551       <field id="size">
11552         <jint/>
11553         <description>The size of the object allocation.</description>
11554       </field>
11555       <field id="thread_id">
11556         <jlong/>
11557         <description>The thread id number.</description>
11558       </field>
11559     </typedef>
11560 
11561     <typedef id="jvmtiStackTraces" label="Stack Traces">
11562       <field id="stack_traces">


11628         functions.
11629 
11630         Starting the heap sampler resets internal traces and counters. Therefore stopping the sampler
11631         puts internal trace samples and counters on pause for post-processing.
11632       </description>
11633       <origin>new</origin>
11634       <capabilities>
11635         <required id="can_sample_heap"></required>
11636       </capabilities>
11637       <parameters>
11638         <param id="monitoring_rate">
11639           <jint/>
11640           <description>
11641             The monitoring rate used for sampling. The sampler will use a statistical approach to
11642             provide in average sampling every <paramlink id="monitoring_rate"/> allocated bytes.
11643 
11644             Note: a low monitoring rate will incur a higher overhead, therefore, the sampler should
11645             only be used when knowing it may impact performance.
11646           </description>
11647         </param>
11648         <param id="max_storage">
11649           <jint/>
11650           <description>
11651             The maximum storage used for the sampler. By default, the value is 200.
11652           </description>
11653         </param>
11654       </parameters>
11655       <errors>
11656         <error id="JVMTI_ERROR_ILLEGAL_ARGUMENT">
11657           <paramlink id="monitoring_period"></paramlink> is less than zero.
11658         </error>
11659       </errors>
11660     </function>
11661 
11662     <function id="StopHeapSampling" phase="any" num="157">
11663       <synopsis>Stop Heap Sampling</synopsis>
11664       <description>
11665         Stop the heap sampler in the JVM.
11666         Any sample obtained during sampling is still available via the <functionlink id="GetLiveTraces"></functionlink>,
11667         <functionlink id="GetGarbageTraces"></functionlink>, <functionlink id="GetFrequentGarbageTraces"></functionlink>,
11668         functions.
11669 
11670         Starting the heap sampler resets internal traces and counters. Therefore stopping the sampler
11671         puts internal trace samples and counters on pause for post-processing.




11522       <origin>new</origin>
11523       <capabilities>
11524       </capabilities>
11525       <parameters>
11526         <param id="format_ptr">
11527           <outptr><enum>jvmtiJlocationFormat</enum></outptr>
11528           <description>
11529             On return, points to the format identifier for <code>jlocation</code> values.
11530           </description>
11531         </param>
11532       </parameters>
11533       <errors>
11534       </errors>
11535     </function>
11536 
11537   </category>
11538 
11539   <category id="heap_monitoring" label="Heap Monitoring">
11540     <typedef id="jvmtiStackTrace" label="Stack Trace">
11541       <field id="frames">
11542         <allocfieldbuf outcount="frame_count">
11543           <struct>jvmtiFrameInfo</struct>
11544         </allocfieldbuf>
11545         <description>Pointer to the call frames.</description>
11546       </field>
11547       <field id="frame_count">
11548         <jint/>
11549         <description>The number of frames for the trace.</description>
11550       </field>
11551       <field id="size">
11552         <jint/>
11553         <description>The size of the object allocation.</description>
11554       </field>
11555       <field id="thread_id">
11556         <jlong/>
11557         <description>The thread id number.</description>
11558       </field>
11559     </typedef>
11560 
11561     <typedef id="jvmtiStackTraces" label="Stack Traces">
11562       <field id="stack_traces">


11628         functions.
11629 
11630         Starting the heap sampler resets internal traces and counters. Therefore stopping the sampler
11631         puts internal trace samples and counters on pause for post-processing.
11632       </description>
11633       <origin>new</origin>
11634       <capabilities>
11635         <required id="can_sample_heap"></required>
11636       </capabilities>
11637       <parameters>
11638         <param id="monitoring_rate">
11639           <jint/>
11640           <description>
11641             The monitoring rate used for sampling. The sampler will use a statistical approach to
11642             provide in average sampling every <paramlink id="monitoring_rate"/> allocated bytes.
11643 
11644             Note: a low monitoring rate will incur a higher overhead, therefore, the sampler should
11645             only be used when knowing it may impact performance.
11646           </description>
11647         </param>
11648         <param id="max_gc_storage">
11649           <jint/>
11650           <description>
11651             The maximum storage used for the GC samples in the sampler. By default, the value is 200.
11652           </description>
11653         </param>
11654       </parameters>
11655       <errors>
11656         <error id="JVMTI_ERROR_ILLEGAL_ARGUMENT">
11657           <paramlink id="monitoring_period"></paramlink> is less than zero.
11658         </error>
11659       </errors>
11660     </function>
11661 
11662     <function id="StopHeapSampling" phase="any" num="157">
11663       <synopsis>Stop Heap Sampling</synopsis>
11664       <description>
11665         Stop the heap sampler in the JVM.
11666         Any sample obtained during sampling is still available via the <functionlink id="GetLiveTraces"></functionlink>,
11667         <functionlink id="GetGarbageTraces"></functionlink>, <functionlink id="GetFrequentGarbageTraces"></functionlink>,
11668         functions.
11669 
11670         Starting the heap sampler resets internal traces and counters. Therefore stopping the sampler
11671         puts internal trace samples and counters on pause for post-processing.


< prev index next >