IronFamily.FileEngine

Monorepo for the active ICFG, ILOG, and IUPD engines plus their native and managed support code.

The canonical native direction is portable C99. The current C# and .NET code remains in scope as host tooling, reference implementation, vector generation, parity support, and bindings support. Native and managed surfaces are not claimed equivalent unless a specific gate proves parity.

Historical codecs remain in the source tree for compatibility work, but they are not active supported engines. This documentation does not claim production readiness.

Repository layout

• libs/ironconfig-dotnet/ managed libraries, tests, and host tooling
• libs/ironcfg-c/ public C API surface and related native code
• native/ top-level native build and ironfamily_c verifier-oriented code
• vectors/ canonical vectors referenced by tests
• docs/ public documentation for active repository scope

Build and test

dotnet restore libs/ironconfig-dotnet/IronConfig.sln
dotnet build -c Release libs/ironconfig-dotnet/IronConfig.sln
dotnet test -c Release libs/ironconfig-dotnet/IronConfig.sln

Native:

cmake -S native -B native/build
cmake --build native/build --config Release
ctest --test-dir native/build -C Release --output-on-failure

Optional native hardening configs:

cmake -S native -B native/build-strict -DIRONFAMILY_STRICT_WARNINGS=ON
cmake --build native/build-strict --config Release

cmake -S native -B native/build-asan -DIRONFAMILY_ENABLE_SANITIZERS=ON
cmake --build native/build-asan --config Release

Current dependency limits

• The native build currently pulls in libs/ironcfg-c, whose CMake configuration requires OpenSSL.
• Because of that dependency, the full native tree should not be described as dependency-free embedded core code.
• .NET 8.0 is required for the managed solution and its tests.

Documentation

• Documentation index: docs/README.md
• Build and install: docs/BUILD_AND_INSTALL.md
• Architecture and scope: docs/ARCHITECTURE_SCOPE.md
• Compatibility and versioning: docs/COMPATIBILITY_AND_VERSIONING.md
• Security model: docs/SECURITY_MODEL.md
• Implementation status: docs/IMPLEMENTATION_STATUS.md
• Release process: docs/RELEASE_PROCESS.md
• Changelog: CHANGELOG.md