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: 2017-01-06
  • 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 Zoltan, I updated the changes with the missing "using" (as suggested). Here is the link to oracle review: http://review.us.oracle.com/review2/Review.html#reviewId=311171;scope=document;status=open,fixed;documentId=1622012;noteId=3919357 As per your inputs, I am closing this bug. Hope it is fine.
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

Hi, I have updated the changes. Here is the link to oracle review: http://review.us.oracle.com/review2/Review.html#reviewId=311171;scope=document;status=open,fixed;documentId=1622012;noteId=3919357
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, I have updated the changes as suggested. Here is the link to oracle review: http://review.us.oracle.com/review2/Review.html#reviewId=311171;scope=review;status=open,fixed;documentId=1622012;noteId=3919357
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