Modifier and Type	Class and Description
private static class	LibFallback.NativeConstants

Modifier and Type	Field and Description
pack-priv static final boolean	SUPPORTED
private static final MethodType	UPCALL_TARGET_TYPE

Access	Constructor and Description
private	LibFallback()

Method Summary

Modifier and Type	Method and Description
private static native int	alignof_double()
private static native int	alignof_long_long()
private static void	checkStatus(int code)
pack-priv static MemorySegment	Returns: the created upcall stub createClosure(MemorySegment a pointer to a `ffi_cif` struct cif, MethodHandle a method handle that points to the target function target, Arena the scope to which to attach the created upcall stub arena) Create an upcallStub-style closure.
private static native int	createClosure(long cif, Object userData, long[] ptrs)
pack-priv static int	defaultABI()
pack-priv static void	doDowncall(MemorySegment a pointer to a `ffi_cif` struct cif, MemorySegment the address of the target function target, MemorySegment a pointer to a buffer into which the return value shall be written, or `null` if the target function does not return a value retPtr, MemorySegment a pointer to an array of pointers, which each point to an argument value argPtrs, Object captureStateHeapBase, MemorySegment a pointer to a buffer into which captured state is written, or `null` if no state is to be captured capturedState, int the bit mask indicating which state to capture capturedStateMask, Object[] heapBases, int numArgs) Do a libffi based downcall.
private static native void	doDowncall(long cif, long fn, long rvalue, long avalues, Object captureStateHeapBase, long capturedState, int capturedStateMask, Object[] heapBases, int numArgs)
pack-priv static int	doubleAlign()
pack-priv static MemorySegment	doubleType()
private static void	doUpcall(long retPtr, long argPtrs, MethodHandle target)
private static native int	ffi_default_abi()
private static native int	ffi_get_struct_offsets(int abi, long type, long offsets)
private static native int	ffi_prep_cif(long cif, int abi, int nargs, long rtype, long atypes)
private static native int	ffi_prep_cif_var(long cif, int abi, int nfixedargs, int ntotalargs, long rtype, long atypes)
private static native int	ffi_sizeof_int()
private static native int	ffi_sizeof_long()
private static native int	ffi_sizeof_short()
private static native int	ffi_sizeof_wchar()
private static native long	ffi_type_double()
private static native long	ffi_type_float()
private static native long	ffi_type_pointer()
private static native long	ffi_type_sint16()
private static native long	ffi_type_sint32()
private static native long	ffi_type_sint64()
private static native long	ffi_type_sint8()
private static native short	ffi_type_struct()
private static native long	ffi_type_uint16()
private static native long	ffi_type_uint32()
private static native long	ffi_type_uint64()
private static native long	ffi_type_uint8()
private static native long	ffi_type_void()
pack-priv static MemorySegment	floatType()
private static native void	freeClosure(long closureAddress, long globalTarget)
pack-priv static void	getStructOffsets(MemorySegment a pointer to an `ffi_type` representing a struct structType, MemorySegment a pointer to an array of `size_t`, with one element for each element of the struct. This is an 'out' parameter that will be filled in by this call offsetsOut, FFIABI the abi to be used abi) Wrapper for `ffi_get_struct_offsets`
private static native boolean	init()
pack-priv static int	intSize()
pack-priv static int	longLongAlign()
pack-priv static int	longSize()
pack-priv static MemorySegment	pointerType()
pack-priv static MemorySegment	Returns: a pointer to a prepared `ffi_cif` struct prepCif(MemorySegment a pointer to an @{code ffi_type} describing the return type returnType, int the number of arguments numArgs, MemorySegment a pointer to an array of pointers, which each point to an `ffi_type` describing a parameter type paramTypes, FFIABI the abi to be used abi, Arena the scope into which to allocate the returned `ffi_cif` struct scope) Wrapper for `ffi_prep_cif`
pack-priv static MemorySegment	Returns: a pointer to a prepared `ffi_cif` struct prepCifVar(MemorySegment a pointer to an @{code ffi_type} describing the return type returnType, int the number of fixed arguments numFixedArgs, int the number of total arguments numTotalArgs, MemorySegment a pointer to an array of pointers, which each point to an `ffi_type` describing a parameter type paramTypes, FFIABI the abi to be used abi, Arena the scope into which to allocate the returned `ffi_cif` struct scope) Wrapper for `ffi_prep_cif_var`.
pack-priv static int	shortSize()
pack-priv static MemorySegment	sint16Type()
pack-priv static MemorySegment	sint32Type()
pack-priv static MemorySegment	sint64Type()
pack-priv static MemorySegment	sint8Type()
private static native long	sizeofCif()
pack-priv static short	structTag()
private static boolean	tryLoadLibrary()
pack-priv static MemorySegment	uint16Type()
pack-priv static MemorySegment	uint8Type()
pack-priv static MemorySegment	voidType()
pack-priv static int	wcharSize()

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

Field Detail

SUPPORTED	back to summary
pack-priv static final boolean SUPPORTED

UPCALL_TARGET_TYPE	back to summary
private static final MethodType UPCALL_TARGET_TYPE

Constructor Detail

LibFallback	back to summary
private LibFallback()

Method Detail

alignof_double	back to summary
private static native int alignof_double()

alignof_long_long	back to summary
private static native int alignof_long_long()

checkStatus	back to summary
private static void checkStatus(int code)

createClosure back to summary

createClosure	back to summary
pack-priv static MemorySegment createClosure(MemorySegment cif, MethodHandle target, Arena arena) throws IllegalStateException, IllegalArgumentException Create an upcallStub-style closure. This method wraps the `ffi_closure_alloc` and `ffi_prep_closure_loc` functions. The closure will end up calling into `doUpcall(long, long, MethodHandle)` The target method handle should have the type `(MemorySegment, MemorySegment) -> void`. The first argument is a pointer to the buffer into which the native return value should be written. The second argument is a pointer to an array of pointers, which each point to a native argument value. Parameters cif:MemorySegment a pointer to a `ffi_cif` struct target:MethodHandle a method handle that points to the target function arena:Arena the scope to which to attach the created upcall stub Returns:MemorySegment the created upcall stub Annotations @SuppressWarnings:restricted Exceptions IllegalStateException: if the call to `ffi_prep_closure_loc` returns a non-zero status code IllegalArgumentException: if `target` does not have the right type

pack-priv static MemorySegment createClosure(MemorySegment cif, MethodHandle target, Arena arena) throws IllegalStateException, IllegalArgumentException

Create an upcallStub-style closure. This method wraps the ffi_closure_alloc and ffi_prep_closure_loc functions.

The closure will end up calling into doUpcall(long, long, MethodHandle)

The target method handle should have the type (MemorySegment, MemorySegment) -> void. The first argument is a pointer to the buffer into which the native return value should be written. The second argument is a pointer to an array of pointers, which each point to a native argument value.

Parameters

cif:MemorySegment: a pointer to a ffi_cif struct
target:MethodHandle: a method handle that points to the target function
arena:Arena: the scope to which to attach the created upcall stub

Returns:MemorySegment

the created upcall stub

Annotations

@SuppressWarnings:restricted

Exceptions

IllegalStateException:: if the call to ffi_prep_closure_loc returns a non-zero status code
IllegalArgumentException:: if target does not have the right type

createClosure	back to summary
private static native int createClosure(long cif, Object userData, long[] ptrs)

defaultABI	back to summary
pack-priv static int defaultABI()

doDowncall back to summary

doDowncall	back to summary
pack-priv static void doDowncall(MemorySegment cif, MemorySegment target, MemorySegment retPtr, MemorySegment argPtrs, Object captureStateHeapBase, MemorySegment capturedState, int capturedStateMask, Object[] heapBases, int numArgs) Do a libffi based downcall. This method wraps the `ffi_call` function Parameters cif:MemorySegment a pointer to a `ffi_cif` struct target:MemorySegment the address of the target function retPtr:MemorySegment a pointer to a buffer into which the return value shall be written, or `null` if the target function does not return a value argPtrs:MemorySegment a pointer to an array of pointers, which each point to an argument value capturedState:MemorySegment a pointer to a buffer into which captured state is written, or `null` if no state is to be captured capturedStateMask:int the bit mask indicating which state to capture See Also `jdk.internal.foreign.abi.CapturableState`

pack-priv static void doDowncall(MemorySegment cif, MemorySegment target, MemorySegment retPtr, MemorySegment argPtrs, Object captureStateHeapBase, MemorySegment capturedState, int capturedStateMask, Object[] heapBases, int numArgs)

Do a libffi based downcall. This method wraps the ffi_call function

Parameters

cif:MemorySegment: a pointer to a ffi_cif struct
target:MemorySegment: the address of the target function
retPtr:MemorySegment: a pointer to a buffer into which the return value shall be written, or null if the target function does not return a value
argPtrs:MemorySegment: a pointer to an array of pointers, which each point to an argument value
capturedState:MemorySegment: a pointer to a buffer into which captured state is written, or null if no state is to be captured
capturedStateMask:int: the bit mask indicating which state to capture

doDowncall	back to summary
private static native void doDowncall(long cif, long fn, long rvalue, long avalues, Object captureStateHeapBase, long capturedState, int capturedStateMask, Object[] heapBases, int numArgs)

doubleAlign	back to summary
pack-priv static int doubleAlign()

doubleType	back to summary
pack-priv static MemorySegment doubleType()

doUpcall	back to summary
private static void doUpcall(long retPtr, long argPtrs, MethodHandle target)

ffi_default_abi	back to summary
private static native int ffi_default_abi()

ffi_get_struct_offsets	back to summary
private static native int ffi_get_struct_offsets(int abi, long type, long offsets)

ffi_prep_cif	back to summary
private static native int ffi_prep_cif(long cif, int abi, int nargs, long rtype, long atypes)

ffi_prep_cif_var	back to summary
private static native int ffi_prep_cif_var(long cif, int abi, int nfixedargs, int ntotalargs, long rtype, long atypes)

ffi_sizeof_int	back to summary
private static native int ffi_sizeof_int()

ffi_sizeof_long	back to summary
private static native int ffi_sizeof_long()

ffi_sizeof_short	back to summary
private static native int ffi_sizeof_short()

ffi_sizeof_wchar	back to summary
private static native int ffi_sizeof_wchar()

ffi_type_double	back to summary
private static native long ffi_type_double()

ffi_type_float	back to summary
private static native long ffi_type_float()

ffi_type_pointer	back to summary
private static native long ffi_type_pointer()

ffi_type_sint16	back to summary
private static native long ffi_type_sint16()

ffi_type_sint32	back to summary
private static native long ffi_type_sint32()

ffi_type_sint64	back to summary
private static native long ffi_type_sint64()

ffi_type_sint8	back to summary
private static native long ffi_type_sint8()

ffi_type_struct	back to summary
private static native short ffi_type_struct()

ffi_type_uint16	back to summary
private static native long ffi_type_uint16()

ffi_type_uint32	back to summary
private static native long ffi_type_uint32()

ffi_type_uint64	back to summary
private static native long ffi_type_uint64()

ffi_type_uint8	back to summary
private static native long ffi_type_uint8()

ffi_type_void	back to summary
private static native long ffi_type_void()

floatType	back to summary
pack-priv static MemorySegment floatType()

freeClosure	back to summary
private static native void freeClosure(long closureAddress, long globalTarget)

getStructOffsets back to summary

getStructOffsets	back to summary
pack-priv static void getStructOffsets(MemorySegment structType, MemorySegment offsetsOut, FFIABI abi) throws IllegalStateException Wrapper for `ffi_get_struct_offsets` Parameters structType:MemorySegment a pointer to an `ffi_type` representing a struct offsetsOut:MemorySegment a pointer to an array of `size_t`, with one element for each element of the struct. This is an 'out' parameter that will be filled in by this call abi:FFIABI the abi to be used Exceptions IllegalStateException: if the call to `ffi_get_struct_offsets` returns a non-zero status code

pack-priv static void getStructOffsets(MemorySegment structType, MemorySegment offsetsOut, FFIABI abi) throws IllegalStateException

Wrapper for ffi_get_struct_offsets

Parameters

structType:MemorySegment: a pointer to an ffi_type representing a struct
offsetsOut:MemorySegment: a pointer to an array of size_t, with one element for each element of the struct. This is an 'out' parameter that will be filled in by this call
abi:FFIABI: the abi to be used

Exceptions

IllegalStateException:: if the call to ffi_get_struct_offsets returns a non-zero status code

init	back to summary
private static native boolean init()

intSize	back to summary
pack-priv static int intSize()

longLongAlign	back to summary
pack-priv static int longLongAlign()

longSize	back to summary
pack-priv static int longSize()

pointerType	back to summary
pack-priv static MemorySegment pointerType()

prepCif back to summary

prepCif	back to summary
pack-priv static MemorySegment prepCif(MemorySegment returnType, int numArgs, MemorySegment paramTypes, FFIABI abi, Arena scope) throws IllegalStateException Wrapper for `ffi_prep_cif` Parameters returnType:MemorySegment a pointer to an @{code ffi_type} describing the return type numArgs:int the number of arguments paramTypes:MemorySegment a pointer to an array of pointers, which each point to an `ffi_type` describing a parameter type abi:FFIABI the abi to be used scope:Arena the scope into which to allocate the returned `ffi_cif` struct Returns:MemorySegment a pointer to a prepared `ffi_cif` struct Exceptions IllegalStateException: if the call to `ffi_prep_cif` returns a non-zero status code

pack-priv static MemorySegment prepCif(MemorySegment returnType, int numArgs, MemorySegment paramTypes, FFIABI abi, Arena scope) throws IllegalStateException

Wrapper for ffi_prep_cif

Parameters

returnType:MemorySegment: a pointer to an @{code ffi_type} describing the return type
numArgs:int: the number of arguments
paramTypes:MemorySegment: a pointer to an array of pointers, which each point to an ffi_type describing a parameter type
abi:FFIABI: the abi to be used
scope:Arena: the scope into which to allocate the returned ffi_cif struct

Returns:MemorySegment

a pointer to a prepared ffi_cif struct

Exceptions

IllegalStateException:: if the call to ffi_prep_cif returns a non-zero status code

prepCifVar back to summary

prepCifVar	back to summary
pack-priv static MemorySegment prepCifVar(MemorySegment returnType, int numFixedArgs, int numTotalArgs, MemorySegment paramTypes, FFIABI abi, Arena scope) throws IllegalStateException Wrapper for `ffi_prep_cif_var`. The variadic version of prep_cif Parameters returnType:MemorySegment a pointer to an @{code ffi_type} describing the return type numFixedArgs:int the number of fixed arguments numTotalArgs:int the number of total arguments paramTypes:MemorySegment a pointer to an array of pointers, which each point to an `ffi_type` describing a parameter type abi:FFIABI the abi to be used scope:Arena the scope into which to allocate the returned `ffi_cif` struct Returns:MemorySegment a pointer to a prepared `ffi_cif` struct Exceptions IllegalStateException: if the call to `ffi_prep_cif` returns a non-zero status code

pack-priv static MemorySegment prepCifVar(MemorySegment returnType, int numFixedArgs, int numTotalArgs, MemorySegment paramTypes, FFIABI abi, Arena scope) throws IllegalStateException

Wrapper for ffi_prep_cif_var. The variadic version of prep_cif

Parameters

returnType:MemorySegment: a pointer to an @{code ffi_type} describing the return type
numFixedArgs:int: the number of fixed arguments
numTotalArgs:int: the number of total arguments
paramTypes:MemorySegment: a pointer to an array of pointers, which each point to an ffi_type describing a parameter type
abi:FFIABI: the abi to be used
scope:Arena: the scope into which to allocate the returned ffi_cif struct

Returns:MemorySegment

a pointer to a prepared ffi_cif struct

Exceptions

IllegalStateException:: if the call to ffi_prep_cif returns a non-zero status code

shortSize	back to summary
pack-priv static int shortSize()

sint16Type	back to summary
pack-priv static MemorySegment sint16Type()

sint32Type	back to summary
pack-priv static MemorySegment sint32Type()

sint64Type	back to summary
pack-priv static MemorySegment sint64Type()

sint8Type	back to summary
pack-priv static MemorySegment sint8Type()

sizeofCif	back to summary
private static native long sizeofCif()

structTag	back to summary
pack-priv static short structTag()

tryLoadLibrary	back to summary
private static boolean tryLoadLibrary() Annotations @SuppressWarnings:restricted

uint16Type	back to summary
pack-priv static MemorySegment uint16Type()

uint8Type	back to summary
pack-priv static MemorySegment uint8Type()

voidType	back to summary
pack-priv static MemorySegment voidType()

wcharSize	back to summary
pack-priv static int wcharSize()

jdk.internal.foreign.abi.fallback back to summary

private final Class LibFallback.NativeConstants

Class Inheritance

extends Object

java.lang.Object
jdk.internal.foreign.abi.fallback.LibFallback.NativeConstants

Field Summary

Modifier and Type	Field and Description
pack-priv static final int	ALIGNOF_DOUBLE
pack-priv static final int	ALIGNOF_LONG_LONG
pack-priv static final int	DEFAULT_ABI
pack-priv static final MemorySegment	DOUBLE_TYPE
pack-priv static final MemorySegment	FLOAT_TYPE
pack-priv static final MemorySegment	POINTER_TYPE
pack-priv static final MemorySegment	SINT16_TYPE
pack-priv static final MemorySegment	SINT32_TYPE
pack-priv static final MemorySegment	SINT64_TYPE
pack-priv static final MemorySegment	SINT8_TYPE
pack-priv static final long	SIZEOF_CIF
pack-priv static final int	SIZEOF_INT
pack-priv static final int	SIZEOF_LONG
pack-priv static final int	SIZEOF_SHORT
pack-priv static final int	SIZEOF_WCHAR
pack-priv static final short	STRUCT_TAG
pack-priv static final MemorySegment	UINT16_TYPE
pack-priv static final MemorySegment	UINT8_TYPE
pack-priv static final MemorySegment	VOID_TYPE

Constructor Summary

Access	Constructor and Description
private	NativeConstants()

Method Summary

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

Field Detail

ALIGNOF_DOUBLE	back to summary
pack-priv static final int ALIGNOF_DOUBLE

ALIGNOF_LONG_LONG	back to summary
pack-priv static final int ALIGNOF_LONG_LONG

DEFAULT_ABI	back to summary
pack-priv static final int DEFAULT_ABI

DOUBLE_TYPE	back to summary
pack-priv static final MemorySegment DOUBLE_TYPE

FLOAT_TYPE	back to summary
pack-priv static final MemorySegment FLOAT_TYPE

POINTER_TYPE	back to summary
pack-priv static final MemorySegment POINTER_TYPE

SINT16_TYPE	back to summary
pack-priv static final MemorySegment SINT16_TYPE

SINT32_TYPE	back to summary
pack-priv static final MemorySegment SINT32_TYPE

SINT64_TYPE	back to summary
pack-priv static final MemorySegment SINT64_TYPE

SINT8_TYPE	back to summary
pack-priv static final MemorySegment SINT8_TYPE

SIZEOF_CIF	back to summary
pack-priv static final long SIZEOF_CIF

SIZEOF_INT	back to summary
pack-priv static final int SIZEOF_INT

SIZEOF_LONG	back to summary
pack-priv static final int SIZEOF_LONG

SIZEOF_SHORT	back to summary
pack-priv static final int SIZEOF_SHORT

SIZEOF_WCHAR	back to summary
pack-priv static final int SIZEOF_WCHAR

STRUCT_TAG	back to summary
pack-priv static final short STRUCT_TAG

UINT16_TYPE	back to summary
pack-priv static final MemorySegment UINT16_TYPE

UINT8_TYPE	back to summary
pack-priv static final MemorySegment UINT8_TYPE

VOID_TYPE	back to summary
pack-priv static final MemorySegment VOID_TYPE

Constructor Detail

NativeConstants	back to summary
private NativeConstants()

pack-priv final Class LibFallback

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class LibFallback.NativeConstants

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail