[GR-51436] Annotate more code with @BasedOnJDKFile.

PullRequest: graal/17047

Author: christianhaeubl

substratevm/src/com.oracle.svm.core.posix/src/com/oracle/svm/core/posix/darwin/DarwinSubstitutions.java

@@ -40,6 +40,7 @@
 import com.oracle.svm.core.feature.AutomaticallyRegisteredImageSingleton;
 import com.oracle.svm.core.posix.PosixUtils;
 import com.oracle.svm.core.posix.headers.darwin.DarwinTime;
+import com.oracle.svm.core.util.BasedOnJDKFile;
 
 import jdk.internal.misc.Unsafe;
 
@@ -77,11 +78,8 @@ final class DarwinTimeUtil {
     DarwinTimeUtil() {
     }
 
-    /**
-     * Based on HotSpot JDK 19 (git commit hash: 967a28c3d85fdde6d5eb48aa0edd8f7597772469, JDK tag:
-     * jdk-19+36).
-     */
     @Uninterruptible(reason = "Called from uninterruptible code.", mayBeInlined = true)
+    @BasedOnJDKFile("src/hotspot/os/bsd/os_bsd.cpp#L799-L821")
     long nanoTime() {
         if (!U.getBooleanAcquire(this, INITIALIZED_OFFSET)) {
             /* Can be called by multiple threads but they should all query the same data. */

substratevm/src/com.oracle.svm.core.posix/src/com/oracle/svm/core/posix/thread/PosixPlatformThreads.java

@@ -67,6 +67,7 @@
 import com.oracle.svm.core.thread.Parker.ParkerFactory;
 import com.oracle.svm.core.thread.PlatformThreads;
 import com.oracle.svm.core.thread.VMThreads.OSThreadHandle;
+import com.oracle.svm.core.util.BasedOnJDKFile;
 import com.oracle.svm.core.util.UnsignedUtils;
 import com.oracle.svm.core.util.VMError;
 
@@ -302,10 +303,6 @@ final class Target_java_lang_Thread {
     Pthread.pthread_t pthreadIdentifier;
 }
 
-/**
- * {@link PosixParker} is based on HotSpot class {@code Parker} in {@code os_posix.cpp}, as of JDK
- * 19 (git commit hash: 967a28c3d85fdde6d5eb48aa0edd8f7597772469, JDK tag: jdk-19+36).
- */
 final class PosixParker extends Parker {
     private static final Unsafe U = Unsafe.getUnsafe();
     private static final long EVENT_OFFSET = U.objectFieldOffset(PosixParker.class, "event");
@@ -357,6 +354,7 @@ protected void park(boolean isAbsolute, long time) {
         }
     }
 
+    @BasedOnJDKFile("src/hotspot/os/posix/os_posix.cpp#L1662-L1738")
     private void park0(boolean isAbsolute, long time) {
         int status = Pthread.pthread_mutex_trylock_no_transition(mutex);
         if (status == Errno.EBUSY()) {
@@ -395,6 +393,7 @@ private void park0(boolean isAbsolute, long time) {
     }
 
     @Override
+    @BasedOnJDKFile("src/hotspot/os/posix/os_posix.cpp#L1740-L1763")
     protected void unpark() {
         StackOverflowCheck.singleton().makeYellowZoneAvailable();
         try {

substratevm/src/com.oracle.svm.core.windows/src/com/oracle/svm/core/windows/WindowsPlatformThreads.java

@@ -43,6 +43,7 @@
 import com.oracle.svm.core.thread.Parker.ParkerFactory;
 import com.oracle.svm.core.thread.PlatformThreads;
 import com.oracle.svm.core.thread.VMThreads.OSThreadHandle;
+import com.oracle.svm.core.util.BasedOnJDKFile;
 import com.oracle.svm.core.util.TimeUtils;
 import com.oracle.svm.core.util.VMError;
 import com.oracle.svm.core.windows.headers.Process;
@@ -179,10 +180,6 @@ protected void yieldCurrent() {
     }
 }
 
-/**
- * {@link WindowsParker} is based on HotSpot class {@code Parker} in {@code os_windows.cpp}, as of
- * JDK 19 (git commit hash: 967a28c3d85fdde6d5eb48aa0edd8f7597772469, JDK tag: jdk-19+36).
- */
 @Platforms(Platform.WINDOWS.class)
 class WindowsParker extends Parker {
     private static final long MAX_DWORD = (1L << 32) - 1;
@@ -211,6 +208,7 @@ protected void reset() {
     }
 
     @Override
+    @BasedOnJDKFile("src/hotspot/os/windows/os_windows.cpp#L5457-L5499")
     protected void park(boolean isAbsolute, long time) {
         assert time >= 0 && !(isAbsolute && time == 0) : "must not be called otherwise";
 
@@ -258,6 +256,7 @@ private static int toDword(long value) {
     }
 
     @Override
+    @BasedOnJDKFile("src/hotspot/os/windows/os_windows.cpp#L5501-L5504")
     protected void unpark() {
         StackOverflowCheck.singleton().makeYellowZoneAvailable();
         try {