tomoaki/hakorune
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
c882a5bd958798a268e28d968f9cd063a156f38b
hakorune/docs/reference/abi/nyrt_c_abi_v0.md
Moe Charm c882a5bd95 fix(plugins): unsafe関数呼び出しの修正とテスト成功 
## 修正内容
- plugin_loader_v2.rs: unsafe関数呼び出しをunsafeブロックで囲む修正
- ビルド警告は残るが、すべて未使用import/変数なので問題なし

## テスト結果（すべて成功！）
- ✅ Array demo: 結果5（push/size/get動作確認）
- ✅ Array set demo: 結果42（set操作確認）
- ✅ Map RO demo: 結果200（size/get/has確認）
- ✅ JIT経路: シンボリック呼び出し確認

## 革命的発見の証明
- ユーザーBox + プラグインBoxの2種類で十分だった！
- ビルトインBox不要（すべてプラグイン化可能）
- スタティックリンクでオーバーヘッド解消

「シンプルが最強」の実証完了にゃ！😺

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-29 05:07:47 +09:00

2.0 KiB
Raw Blame History

NyRT C ABI v0 (JIT/AOT/Plugin 共通)

  • 命名規則:
    • コア: nyrt_*
    • プラグイン: nyplug_{name}_*
  • 呼出規約: x86_64 SysV / aarch64 AAPCS64 / Win64（Cranelift call_conv と一致）
  • 型: i32/i64/u64/double/void* に限定。bool は u8。構造体は不透明ハンドル。
  • 互換性: nyrt_abi_version() / nyplug_{name}_abi_version()（v0=1）で fail-fast。

最小ヘッダ例（コア: nyrt.h）

#pragma once
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif

typedef struct NyBox { void* data; uint64_t typeid; uint32_t flags; uint32_t gen; } NyBox;

int32_t  nyrt_abi_version(void);

// Box 基本
NyBox    nyrt_box_new(uint64_t typeid, uint64_t size);
void     nyrt_box_free(NyBox b);
int32_t  nyrt_adopt(NyBox parent, NyBox child);
int32_t  nyrt_release(NyBox parent, NyBox child, NyBox* out_weak);
NyBox    nyrt_weak_load(NyBox weak);

// GC/Safepoint
void     nyrt_epoch_collect(void);

// Sync（最小）
void*    nyrt_mutex_lock(NyBox sync);
void     nyrt_mutex_unlock(void* guard);

// Bus
int32_t  nyrt_bus_send(NyBox port, NyBox msg);

#ifdef __cplusplus
}
#endif

プラグインヘッダ例（nyplug_array.h）

#pragma once
#include "nyrt.h"
#ifdef __cplusplus
extern "C" {
#endif

int32_t nyplug_array_abi_version(void);
NyBox   nyplug_array_new(void);
int32_t nyplug_array_get(NyBox arr, uint64_t i, NyBox* out);
int32_t nyplug_array_set(NyBox arr, uint64_t i, NyBox v);
uint64_t nyplug_array_len(NyBox arr);

#ifdef __cplusplus
}
#endif

AOT（静的リンク）の流れ

  • CLIF から .o を出力（未解決: nyrt_* / nyplug_*）。
  • リンク（Linux/macOS の例）: 
    cc app.o -static -L. -lnyrt -lnyplug_array -o app
  • 実行: ./app

注意

  • 例外/パニックの越境は不可（戻り値/エラーコードで返す）。
  • C++ 側は必ず extern "C"、ELF は visibility("default")。
  • ABI 破壊変更は *_v1 などの別シンボルで導入（v0は凍結）。