Class MacForeignFunctions

java.lang.Object

oshi.ffm.ForeignFunctions

oshi.ffm.mac.MacForeignFunctions

Direct Known Subclasses:

CoreFoundationFunctions, CoreGraphicsFunctions, DiskArbitrationFunctions, IOKitFunctions, IOReportFunctions, MacSystemFunctions, SystemConfigurationFunctions

public abstract class MacForeignFunctions
extends ForeignFunctions

Base class for macOS FFM function bindings, adding framework lookup support on top of ForeignFunctions.

Field Summary

Fields

Modifier and Type	Field	Description
protected static final List<String>	FRAMEWORK_SEARCH_PATHS	Search paths for macOS frameworks, in priority order.

Fields inherited from class ForeignFunctions

CAPTURE_CALL_STATE, CAPTURED_STATE_LAYOUT, ERRNO_HANDLE, LIBRARY_ARENA, LINKER, NATIVE_LONG_SIZE, NATIVE_POINTER_SIZE, NATIVE_SIZE_T_SIZE, SYMBOL_LOOKUP

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MacForeignFunctions()	Not intended for instantiation.

Method Summary

Modifier and Type	Method	Description
protected static SymbolLookup	frameworkLookup(String frameworkName)	Lookup a macOS framework by simple name, e.g.

Methods inherited from class ForeignFunctions

downcall, getByteArrayFromNativePointer, getErrno, getStringFromNativePointer, getStructFromNativePointer, lib, libraryLookup

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

FRAMEWORK_SEARCH_PATHS

protected static final List<String> FRAMEWORK_SEARCH_PATHS

Search paths for macOS frameworks, in priority order.

• /System/Library/Frameworks - Reserved strictly for Apple's core OS frameworks (e.g. IOKit, CoreFoundation, AppKit).
• /Library/Frameworks - Standard location for third-party frameworks available to all users (e.g. SDL2, GStreamer, or custom drivers).

Constructor Details

MacForeignFunctions

protected MacForeignFunctions()

Not intended for instantiation.

Method Details

frameworkLookup

protected static SymbolLookup frameworkLookup(String frameworkName)

Lookup a macOS framework by simple name, e.g. "IOKit". Searches FRAMEWORK_SEARCH_PATHS in order.

Parameters:

frameworkName - the framework name without path or extension

Returns:

the symbol lookup for the framework

Throws:

IllegalArgumentException - if the framework is not found in any search path