OpenJDK 27 · jdk.internal.foreign.abi.SharedUtils · APIdia, the JavaDoc alternative

Field Summary

Modifier and Type	Field and Description
public static final AddressLayout	C_POINTER
public static final Arena	DUMMY_ARENA
private static final JavaLangInvokeAccess	JLIA
private static final BufferStack	LINKER_STACK
private static final int	LINKER_STACK_SIZE
private static final MethodHandle	MH_ALLOC_BUFFER
private static final MethodHandle	MH_BUFFER_COPY
private static final MethodHandle	MH_CHECK_CAPTURE_SEGMENT
public static final MethodHandle	MH_CHECK_SYMBOL
private static final MethodHandle	MH_REACHABILITY_FENCE
public static final SegmentAllocator	THROWING_ALLOCATOR

Constructor Summary

Access	Constructor and Description
private	SharedUtils()

Method Summary

Modifier and Type	Method and Description
public static MethodHandle	Returns: the adapted handle adaptDowncallForIMR(MethodHandle the target handle to adapt handle, FunctionDescriptor the function descriptor of the native function (with actual return layout) cDesc, CallingSequence sequence) Takes a MethodHandle that takes an input buffer as a first argument (a MemorySegment), and returns nothing, and adapts it to return a MemorySegment, by allocating a MemorySegment for the input buffer, calling the target MethodHandle, and then returning the allocated MemorySegment.
private static MethodHandle	Returns: the adapted handle adaptUpcallForIMR(MethodHandle the target handle to adapt target, boolean dropReturn) Takes a MethodHandle that returns a MemorySegment, and adapts it to take an input buffer as a first argument (a MemorySegment), and upon invocation, copies the contents of the returned MemorySegment into the input buffer passed as the first argument.
public static long	alignUp(long addr, long alignment)
public static AbstractLinker.UpcallStubFactory	arrangeUpcallHelper(MethodType targetType, boolean isInMemoryReturn, boolean dropReturn, ABIDescriptor abi, CallingSequence callingSequence)
private static MemorySegment	bufferCopy(MemorySegment dest, MemorySegment buffer)
public static Map<String, MemoryLayout>	canonicalLayouts(ValueLayout longLayout, ValueLayout sizetLayout, ValueLayout wchartLayout)
public static MemorySegment	checkCaptureSegment(MemorySegment captureSegment)
public static void	checkExceptions(MethodHandle target)
public static void	checkNative(MemorySegment segment)
public static void	checkSymbol(MemorySegment symbol)
pack-priv static void	checkType(Class<?> actualType, Class<?> expectedType)
public static Linker	getSystemLinker()
public static void	handleUncaughtException(Throwable t)
pack-priv static Map<VMStorage, Integer>	indexMap(Binding.Move[] moves)
public static boolean	isPowerOfTwo(int width)
public static MethodHandle	maybeCheckCaptureSegment(MethodHandle handle, LinkerOptions options)
public static MethodHandle	maybeInsertAllocator(FunctionDescriptor descriptor, MethodHandle handle)
pack-priv static MethodHandle	mergeArguments(MethodHandle mh, int sourceIndex, int destIndex)
public static Arena	newBoundedArena(long size)
public static Arena	newEmptyArena()
pack-priv static long	pickChunkOffset(long chunkOffset, long byteWidth, int chunkWidth)
public static Class<?>	primitiveCarrierForSize(long size, boolean useFloat)
public static ValueLayout	primitiveLayoutForSize(long size, boolean useFloat)
private static MethodHandle	reachabilityFenceHandle(Class<?> type)
pack-priv static Object	read(MemorySegment ptr, long offset, Class<?> type)
public static long	remainsToAlignment(long addr, long alignment)
public static MethodHandle	swapArguments(MethodHandle mh, int firstArg, int secondArg)
public static long	unboxSegment(MemorySegment segment)
public static int	unboxSegment32(MemorySegment segment)
pack-priv static void	write(MemorySegment ptr, long offset, Class<?> type, Object o)
pack-priv static void	writeOverSized(MemorySegment ptr, Class<?> type, Object o)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

C_POINTER	back to summary
public static final AddressLayout C_POINTER Annotations @SuppressWarnings:restricted

DUMMY_ARENA	back to summary
public static final Arena DUMMY_ARENA

JLIA	back to summary
private static final JavaLangInvokeAccess JLIA

LINKER_STACK	back to summary
private static final BufferStack LINKER_STACK

LINKER_STACK_SIZE	back to summary
private static final int LINKER_STACK_SIZE

MH_ALLOC_BUFFER	back to summary
private static final MethodHandle MH_ALLOC_BUFFER

MH_BUFFER_COPY	back to summary
private static final MethodHandle MH_BUFFER_COPY

MH_CHECK_CAPTURE_SEGMENT	back to summary
private static final MethodHandle MH_CHECK_CAPTURE_SEGMENT

MH_CHECK_SYMBOL	back to summary
public static final MethodHandle MH_CHECK_SYMBOL

MH_REACHABILITY_FENCE	back to summary
private static final MethodHandle MH_REACHABILITY_FENCE

THROWING_ALLOCATOR	back to summary
public static final SegmentAllocator THROWING_ALLOCATOR

Constructor Detail

SharedUtils	back to summary
private SharedUtils()

Method Detail

adaptDowncallForIMR	back to summary
public static MethodHandle adaptDowncallForIMR(MethodHandle handle, FunctionDescriptor cDesc, CallingSequence sequence) Takes a MethodHandle that takes an input buffer as a first argument (a MemorySegment), and returns nothing, and adapts it to return a MemorySegment, by allocating a MemorySegment for the input buffer, calling the target MethodHandle, and then returning the allocated MemorySegment. This allows viewing a MethodHandle that makes use of in memory return (IMR) as a MethodHandle that just returns a MemorySegment without requiring a pre-allocated buffer as an explicit input. Parameters handle:MethodHandle the target handle to adapt cDesc:FunctionDescriptor the function descriptor of the native function (with actual return layout) Returns:MethodHandle the adapted handle

adaptDowncallForIMR

back to summary

public static MethodHandle adaptDowncallForIMR(MethodHandle handle, FunctionDescriptor cDesc, CallingSequence sequence)

Takes a MethodHandle that takes an input buffer as a first argument (a MemorySegment), and returns nothing, and adapts it to return a MemorySegment, by allocating a MemorySegment for the input buffer, calling the target MethodHandle, and then returning the allocated MemorySegment. This allows viewing a MethodHandle that makes use of in memory return (IMR) as a MethodHandle that just returns a MemorySegment without requiring a pre-allocated buffer as an explicit input.

Parameters

handle:MethodHandle: the target handle to adapt
cDesc:FunctionDescriptor: the function descriptor of the native function (with actual return layout)

Returns:MethodHandle

the adapted handle

adaptUpcallForIMR	back to summary
private static MethodHandle adaptUpcallForIMR(MethodHandle target, boolean dropReturn) Takes a MethodHandle that returns a MemorySegment, and adapts it to take an input buffer as a first argument (a MemorySegment), and upon invocation, copies the contents of the returned MemorySegment into the input buffer passed as the first argument. Parameters target:MethodHandle the target handle to adapt Returns:MethodHandle the adapted handle

adaptUpcallForIMR