stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8288068: Javadoc contains spurious reference to CLinker

Browse Source 
Reviewed-by: iris
This commit is contained in:
Maurizio Cimadamore 2022-06-08 23:58:28 +00:00
parent 130ce7c6b8
commit 65f0829d64
2 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
src/java.base/share/classes/java/lang/foreign/Linker.java
View File

@ -212,7 +212,7 @@ public sealed interface Linker permits AbstractLinker {
*
* @param symbol the address of the target function.
* @param function the function descriptor of the target function.
* @return a downcall method handle. The method handle type is <a href="CLinker.html#downcall-method-handles"><em>inferred</em></a>
* @return a downcall method handle. The method handle type is <a href="Linker.html#downcall-method-handles"><em>inferred</em></a>
* @throws IllegalArgumentException if the provided function descriptor is not supported by this linker.
* or if the symbol is {@link MemoryAddress#NULL}
*/
@ -235,7 +235,7 @@ public sealed interface Linker permits AbstractLinker {
* associated with the {@link MemoryAddress#NULL} address, or a {@link NullPointerException} if that parameter is {@code null}.
*
* @param function the function descriptor of the target function.
* @return a downcall method handle. The method handle type is <a href="CLinker.html#downcall-method-handles"><em>inferred</em></a>
* @return a downcall method handle. The method handle type is <a href="Linker.html#downcall-method-handles"><em>inferred</em></a>
* from the provided function descriptor.
* @throws IllegalArgumentException if the provided function descriptor is not supported by this linker.
*/
@ -261,7 +261,7 @@ public sealed interface Linker permits AbstractLinker {
* @return a zero-length segment whose base address is the address of the upcall stub.
* @throws IllegalArgumentException if the provided function descriptor is not supported by this linker.
* @throws IllegalArgumentException if it is determined that the target method handle can throw an exception, or if the target method handle
* has a type that does not match the upcall stub <a href="CLinker.html#upcall-stubs"><em>inferred type</em></a>.
* has a type that does not match the upcall stub <a href="Linker.html#upcall-stubs"><em>inferred type</em></a>.
* @throws IllegalStateException if {@code session} is not {@linkplain MemorySession#isAlive() alive}.
* @throws WrongThreadException if this method is called from a thread other than the thread
* {@linkplain MemorySession#ownerThread() owning} {@code session}.

4
src/java.base/share/classes/java/lang/foreign/package-info.java
View File

@ -186,7 +186,7 @@
* FunctionDescriptor intCompareDescriptor = FunctionDescriptor.of(ValueLayout.JAVA_INT, ValueLayout.ADDRESS, ValueLayout.ADDRESS);
* MethodHandle intCompareHandle = MethodHandles.lookup().findStatic(IntComparator.class,
* "intCompare",
* CLinker.upcallType(comparFunction));
* Linker.upcallType(comparFunction));
* }
*
* As before, we need to create a {@link java.lang.foreign.FunctionDescriptor} instance, this time describing the signature
@ -199,7 +199,7 @@
*
* {@snippet lang=java :
* MemorySession session = ...
* Addressable comparFunc = CLinker.nativeLinker().upcallStub(
* Addressable comparFunc = Linker.nativeLinker().upcallStub(
* intCompareHandle, intCompareDescriptor, session);
* );
* }