Skip to main content

Module loader

Module loader 

Source
Expand description

泛型 dlopen 加载。

§这里没有类型擦除

T 是宿主自己的 #[repr(C)] 入口结构体(对 bmux 来说就是 BmuxPluginV1)。 load() 返回的是 *const T —— 瘦指针,不是 dyn Trait,所以不存在 “两个不同 vtable 的 fat pointer 互转“那种 UB。

本 crate 不知道也不需要知道 T 里有什么字段;它只负责把符号地址取出来 并 cast 成 *const T。怎么安全地读那些字段是宿主契约 crate 的事。

§调用方必须保证的事

  1. T 与插件实际导出的结构体布局一致(靠宿主的 abi_version 字段兜底);
  2. 每一次读 T 的字段之前,要自己包 crate::panic::guard。

Structs§

LoadedPlugin
一个已加载的插件。

Functions§

find_library
在一个目录里按候选列表找 cdylib,返回第一个存在的。
library_candidates
按平台给出 cdylib 文件名的候选列表,按优先级排列。
open⚠
打开一个 cdylib 并调用它的入口函数。