JDK-8169583 : Add documentation for JDK-8068945 to Tools Reference Guide
  • Type: Sub-task
  • Component: docs
  • Sub-Component: hotspot
  • Affected Version: 9
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2016-11-11
  • Updated: 2024-03-11
  • Resolved: 2017-01-06
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 9
9Fixed
Description
Add flag to the Tools Reference Guide:
-XX:PreserveFramePointer

Comments
Hi Shilpa, the changes look good. Thank you for fixing this issue! Best regards, Zoltan
06-01-2017

Hi Shilpa, thank you for updating the changes. I added a minor suggestion to the text (as a note). Once you add the missing "using" (as suggested), the text will look good to me and you can consider it reviewed. Thank you! Zoltan
06-01-2017

Sure, [~thartmann]. Here is a more detailed description of the feature: The x86-specific PreserveFramePointer flag selects between using the RBP register as a general purpose register (-XX:-PreserveFramePointer) and using the RBP register to hold the frame pointer of the currently executing method (-XX:+PreserveFramePointer). If the frame pointer is available, external profiling tools (e.g., Linux perf) can construct more accurate stack traces.
05-01-2017

[~zmajo], could you please review the changes?
05-01-2017

Hi, Added -XX:PreserveFramePointer flag under java > Advanced Runtime Options for java with the following description: -XX:PreserveFramePointer :The PreserveFramePointer flag controls RBP if used as the frame pointer or as a general purpose register. If PreserveFramePointer==true, the RBP is used as a proper frame pointer Hope description is fine.
23-12-2016