-
Bug
-
Resolution: Unresolved
-
P2
-
None
-
19
"Note:As of Java 16 the use of the signal and sigset functions are deprecated, and support for those functions will be removed in a future release. Use the sigaction function instead."
The above note was added to VM Signal Chaining docs of JDK 16, 17 and 18. However, it was mistakenly removed in the docs of 19, 20, 21, 22 and 23, despite the deprecation still being valid for those releases. The removal of support is planned as a future project underJDK-8257653, meaning the support has not yet been removed.
Additionally, the following two sentences should reference the signal() and sigset() functions. Replace the existing sentences with those provided on the right-hand side of the arrow (>>>>).
Sentence 1:
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. >>>> 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.
Sentence 2:
The interposed sigaction() call returns the saved signal handlers, not the signal handlers installed by the HotSpot VM and seen by the operating system. >>>> 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.
In other words, the signal chaining guides should remain the same after 18 till 23. Refer to:
JDK 18 Signal Chaining guide: https://docs.oracle.com/en/java/javase/18/vm/signal-chaining.html
JDK 19 Signal Chaining guide: https://docs.oracle.com/en/java/javase/19/vm/signal-chaining.html
The above note was added to VM Signal Chaining docs of JDK 16, 17 and 18. However, it was mistakenly removed in the docs of 19, 20, 21, 22 and 23, despite the deprecation still being valid for those releases. The removal of support is planned as a future project under
Additionally, the following two sentences should reference the signal() and sigset() functions. Replace the existing sentences with those provided on the right-hand side of the arrow (>>>>).
Sentence 1:
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. >>>> 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.
Sentence 2:
The interposed sigaction() call returns the saved signal handlers, not the signal handlers installed by the HotSpot VM and seen by the operating system. >>>> 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.
In other words, the signal chaining guides should remain the same after 18 till 23. Refer to:
JDK 18 Signal Chaining guide: https://docs.oracle.com/en/java/javase/18/vm/signal-chaining.html
JDK 19 Signal Chaining guide: https://docs.oracle.com/en/java/javase/19/vm/signal-chaining.html
- relates to
-
JDK-8257645 VM Guide: Document the deprecation in the signal chaining facility
- Resolved
-
JDK-8257653 VM Guide: Update signal chaining information to remove reference to sigset/signal
- Resolved