@zerodensity/smb-cpp
v0.1.0
Published
C++ SMB scanner and Reality Hub protobuf TCP drop-in server
Readme
SMB Unreal Scanner
smb-unreal-scan is a single executable with two command-line modes:
- Standalone scanner mode, used when no drop-in server port is provided.
- Reality Hub SMB drop-in mode, used when
-port=<port>,--port <port>, or--dropin-serveris provided.
Standalone Scanner
smb-unreal-scan --root //server/share/path --env .smbenv --output scansThe standalone scanner keeps the original high-concurrency traversal behavior.
Reality Hub TCP Drop-In Mode
Reality Hub launches the old Go SMB binary with -port=<port>. The same flag now switches this binary into protobuf-over-TCP mode:
smb-unreal-scan -port=15000Equivalent explicit form:
smb-unreal-scan --dropin-server --mode=tcp --port 15000 --pool 96Drop-in mode preserves the existing protobuf message types and wraps requests in length-prefixed RpcFrame messages over 127.0.0.1 TCP. Runtime caches stay in memory only for the current backend process/mount. No cache is persisted or reused across test runs.
Local Verification
On macOS arm64 against //172.16.0.20/PublicStorage/HUB/projects:
- Standalone scanner mode completed in
8.1s. - Release drop-in mode completed the Reality Hub stub scan in
5.519s. - Strict comparison against the Go reference passed with
0diffs for41projects and617maps.
NPM Package
The assumed Reality Hub package name is @zerodensity/smb-cpp. The package is staged from release bundles with:
npm run buildThe staging output is dist/npm and contains:
darwin_arm64/smb_server_cpp_darwin_arm64linux_x64/smb_server_cpp_linux_x64win32_x64/smb_server_cpp_win32_x64.exesmb2.proto
Platform folders may also contain runtime sidecars, such as the libsmb2 runtime, and Reality Hub copies the whole selected C++ platform folder next to the executable.
