BRENE — KernelSU用のSUSFSモジュール

概要

BRENEは、SUSFSパッチが適用されたカーネル向けに設計されたKernelSUモジュールです。本モジュールはユーザースペースのヘルパーツール「ksu_susfs」を/data/adb/にインストールし、SUSFS（Shared User Space File System）とカーネル側インターフェースを介して通信するためのスクリプト例を提供します。主にKernelSU v2.0.0+およびsusfs4ksu v2.0.0+との互換性を想定しており、カーネルのumount機能を有効にして利用することが推奨されています。シンプルで実験的な構成のため、導入前に環境と互換性の確認が必要です。

リポジトリの統計情報

スター数: 3
フォーク数: 0
ウォッチャー数: 3
コミット数: 2
ファイル数: 11
メインの言語: Shell

主な特徴

ksu_susfsというユーザースペースヘルパーツールを提供し、/data/adb/へ配置する仕組み。
SUSFSパッチ済みカーネル（susfs4ksu）との通信スクリプト例を同梱。
KernelSU v2.0.0+との互換性を意識して設計。MagiskやKernelSUのエコシステムと連携。
軽量なShellベースの実装でカスタマイズや学習用に適した構成。

技術的なポイント

BRENEは主にShellスクリプトで構成されており、カーネルモジュール的な複雑さは持たず、ユーザースペースでの補助ツール配置と簡易な通信例にフォーカスしています。k su_susfsはSUSFS向けのユーザースペース補助プロセスで、/data/adb/にインストールされることで権限やパスの管理を容易にします。モジュール側ではmodule.propやinstallスクリプト相当の処理を通じてデバイス起動時やモジュール適用時の初期化（boot-completed.sh等）を行い、SUSFSにアクセスするための前提（カーネルのumount有効化など）をユーザーに促します。

技術的に注目すべきは、KernelSUとsusfs4ksuのバージョン依存性管理です。KernelSUはカーネル空間での権限委譲を提供し、susfs4ksuは共有ユーザースペースファイルシステムを介した通信を可能にします。BRENEはこれらの上位レイヤーに合わせ、ユーザースペースツールの配置・起動・サンプル通信シーケンスを整備する役割を担います。実運用ではカーネルのパッチ状況、KernelSUのバージョン、SELinuxやファイルパーミッションなど環境依存要素の確認が不可欠です。またカスタマイズ用スクリプト（customize.sh）や起動検知用スクリプト（boot-completed.sh）を通じて、モジュールを適用した端末での自動化やデバッグが行いやすく設計されています。全体として学習・実験用途やカスタムツールのデプロイに向いたシンプルな構成です。

プロジェクトの構成

主要なファイルとディレクトリ：

LICENSE: file
README.md: file
boot-completed.sh: file
customize.sh: file
module.prop: file

…他 6 ファイル

まとめ

KernelSUとsusfs4ksu環境で手軽にユーザースペース補助ツールを試せる軽量モジュールです（要互換性確認）。

リポジトリ情報：

名前: BRENE
説明: A KernelSU module
スター数: 3
言語: Shell
URL: https://github.com/rrr333nnn333/BRENE
オーナー: rrr333nnn333
アバター: https://avatars.githubusercontent.com/u/129878363?v=4

READMEの抜粋：

A KernelSU module for SUSFS patched kernel

This module is used for installing a userspace helper tool called ksu_susfs into /data/adb/ and provides a script example to communicate with SUSFS kernel.

More information soon.

Supported Versions

KernelSU v2.0.0+
susfs4ksu v2.0.0+

Tip

Kernel umount must be enabled