JDK-8257653 : VM Guide: Update signal chaining information to remove reference to sigset/signal
  • Type: Sub-task
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 17
  • Priority: P4
  • Status: Resolved
  • Resolution: Future Project
  • Submitted: 2020-12-03
  • Updated: 2021-04-07
  • Resolved: 2021-04-07
Description
Ref:

https://docs.oracle.com/en/java/javase/15/vm/signal-chaining.html#GUID-CB49A2A7-2A9F-4C18-948F-6D4A96FF688D

The deprecated sigset/signal usage has now been removed so the docs need updating:

1. Remove the deprecation note added under JDK-8257645

2. Replace the sentence

This library ensures that calls such as signal(), sigset(), and sigaction() are intercepted and don���t replace the signal handlers that are used by the HotSpot VM, if the handlers conflict with the signal handlers that are already installed by HotSpot VM. 

with

This library ensures that calls to sigaction() are intercepted and don���t replace the signal handlers that are used by the HotSpot VM, if the handlers conflict with the signal handlers that are already installed by HotSpot VM. 

3. Replace the sentence:

The interposed signal() , sigset() , and sigaction() calls return the saved signal handlers, not the signal handlers installed by the HotSpot VM and are seen by the operating system. 

with

The interposed sigaction() call returns the saved signal handler, not the signal handler installed by the HotSpot VM and seen by the operating system. 
Comments
The main issue is now indefinitely deferred, so closing this doc issue as a "Future Project" as well.
07-04-2021

Hi [~dholmes], Thanks for letting me know. I'll update the guide when the work is completed.
23-02-2021

[~ssatish] I've decided to postpone this work until JDK 18. Sorry for the inconvenience.
23-02-2021

Hi [~dholmes], Sorry for the confusion. I'll update this for JDK 17. Thanks, Savitha
17-02-2021

Hi [~ssatish], note this issue is for JDK 17 (assuming we proceed with the removal), not JDK 16. The updated text seems correct for 17, if we proceed with the removal.
17-02-2021

Hi [~dholmes], Kindly review the changes and let me know your inputs. https://docs-uat.us.oracle.com/en/java/javase/16/vm/signal-chaining.html#GUID-CB49A2A7-2A9F-4C18-948F-6D4A96FF688D Thanks!
15-02-2021