# Native distribution notices

These notices accompany ObjectStorage's `ruststorage_linux_amd64`,
`ruststorage_linux_arm64`, `ruststorage_linux_amd64_musl`, `ruststorage_linux_arm64_musl`,
`ruststorage_macos_amd64` and `ruststorage_macos_arm64`
executables. ObjectStorage's own code remains licensed
under [MIT](./license.md).

## GNU C Library use and platform requirements

The GNU/Linux executables use the GNU C Library (glibc), licensed under the
[GNU Lesser General Public License, version 2.1 or later](./third_party_licenses/glibc-lgpl-2.1.txt).
The [upstream glibc license inventory](./third_party_licenses/glibc-license.txt)
is also retained. These executables dynamically load the system's glibc, dynamic
loader, `libm.so.6` and `libgcc_s.so.1`; those libraries are not bundled into the
npm package. Users can replace the shared libraries with modified, interface
compatible versions. ObjectStorage imposes no restriction on modification for
the user's own use or reverse engineering to debug such modifications.

Both executables require glibc 2.34 or later and the matching system libraries.
Both are built using Ubuntu 24.04/glibc 2.39. The amd64 suite runs natively there.
ARM64 IPC, HTTP object write/read, stats, clean shutdown and persisted-object
restart checks pass in a full-system QEMU TCG guest with an Alpine 6.18.35 kernel,
Ubuntu 24.04 glibc 2.39 libraries and a disposable ext4 disk. This is emulation,
not physical ARM hardware or complete Ubuntu ARM distribution qualification.
The amd64 loader is
`/lib64/ld-linux-x86-64.so.2`; the arm64 loader is `/lib/ld-linux-aarch64.so.1`.
These GNU-named executables require a glibc host. The additional static musl
executables support Alpine and glibc Linux, and are selected by the TypeScript API.
This changes version 9's static-binary portability and is released as a major
version. Public APIs, executable names, IPC and stored formats are unchanged.

## Static musl runtime

The musl executables use Rust 1.95.0's patched musl 1.2.5 runtime and the
cross-tools/musl-cross 20260823 toolchains (GCC 16.2.0, musl 1.2.6 sysroot).
The musl copyright notices, GCC GPL-3.0 license and GCC Runtime Library Exception
3.1, and complete Rust distribution copyright/license inventory are retained in
`third_party_licenses/native/`, with sources and hashes in
`third_party_licenses/native-inventory.json`. The complete Rust inventory includes
build-only components and does not imply that every listed component is linked.
Both musl binaries have no dynamic interpreter or shared-library dependency.

## macOS system libraries

The macOS executables dynamically load Apple-provided system libraries from
`/usr/lib` and `/System/Library`. Those libraries are supplied by macOS and are
not redistributed in this package. No Homebrew libraries are required at runtime.
Local APFS is required. The build deployment target is macOS 11; runtime checks
use macOS 26.3.1 on Apple Silicon and Intel execution through Rosetta 2. Older
macOS versions and physical Intel hardware have not been qualified. Both
executables carry ad-hoc signatures, verified after the build; they are not
Developer ID signed or notarized.

## Locked Cargo graph

[Cargo dependency notices](./third_party_licenses/cargo-dependencies.html)
contain the selected license texts and original attributions for 279 packages.
The complete locked graph also contains 18 feature-inactive packages:
[aho-corasick 1.1.4](./third_party_licenses/aho-corasick-1.1.4-license.txt),
[borsh 1.8.1](./third_party_licenses/borsh-1.8.1-license.txt),
[borsh-derive 1.8.1](./third_party_licenses/borsh-derive-1.8.1-apache-2.0.txt),
[dyn-clone 1.0.20](./third_party_licenses/dyn-clone-1.0.20-license.txt),
[equivalent 1.0.3](./third_party_licenses/equivalent-1.0.3-license.txt),
[hashbrown 0.17.1](./third_party_licenses/hashbrown-0.17.1-license.txt),
[indexmap 2.14.2](./third_party_licenses/indexmap-2.14.2-license.txt),
[proc-macro-crate 3.5.0](./third_party_licenses/proc-macro-crate-3.5.0-license.txt),
[ref-cast 1.0.27](./third_party_licenses/ref-cast-1.0.27-license.txt),
[ref-cast-impl 1.0.27](./third_party_licenses/ref-cast-impl-1.0.27-license.txt),
[schemars 1.2.3](./third_party_licenses/schemars-1.2.3-license.txt),
[syn 3.0.9](./third_party_licenses/syn-3.0.9-license.txt),
[toml_datetime 1.1.2](./third_party_licenses/toml_datetime-1.1.2-license.txt),
[toml_edit 0.25.17](./third_party_licenses/toml_edit-0.25.17-license.txt),
[toml_parser 1.1.5](./third_party_licenses/toml_parser-1.1.5-license.txt),
[valuable 0.1.1](./third_party_licenses/valuable-license.txt),
[winnow 1.0.4](./third_party_licenses/winnow-1.0.4-license.txt) and
[zerocopy-derive 0.8.47](./third_party_licenses/zerocopy-derive-0.8.47-license.txt).
Their exact notices (Apache-2.0 for borsh-derive, which offers no MIT
alternative, MIT for the others) bring the inventory to all 297 locked third-party
packages, conservatively including build-only, development and inactive targets.
Listing a package does not claim that it is linked into every distributed executable.

MIT is selected where offered as an alternative. Other required terms include
Apache-2.0, ISC, BSD-3-Clause, Unicode-3.0, BSL-1.0 and CDLA-Permissive-2.0.
This covers the native graph's bincode/bytes MIT, subtle BSD, rustls-webpki ISC,
ICU4X Unicode and xxhash-rust Boost notices. Combined upstream files retain
their original scope statements and additional component terms.

The supplemental [MIT source attributions](./third_party_licenses/mit-source-attributions.txt)
retain cesu8's Rust Project/Eric Kidd headers, siphasher's Rust Project/Frank
Denis attribution and crc32c's declared author with the complete selected MIT
terms. The [crc32c Zlib notice](./third_party_licenses/crc32c-0.6.8-zlib-notice.txt)
retains its translated combine implementation's source attribution, marked
alterations and the corresponding upstream Zlib license. Exact Rustix and
linux-raw-sys `COPYRIGHT` notices supplement their selected MIT licenses.

The `tikv-jemalloc-sys` crate also compiles bundled jemalloc 5.3.1 sources.
Their [BSD-2-Clause terms](./third_party_licenses/jemalloc-5.3.1-copying.txt)
are retained from the crate's `jemalloc/COPYING`, separately from the MIT
terms selected for the TiKV wrapper crates.

The existing [ring 0.17.14 index](./third_party_licenses/ring-0.17.14/INDEX.md)
and all seven bundled license/index files remain unchanged. Its
[source attribution supplement](./third_party_licenses/ring-0.17.14/source-attributions.txt)
retains copyright-bearing source comments, grouping identical comments by path.
These notices were checked against the Cargo.lock-pinned crate archive with
SHA-256 `a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7`.
The existing base64 and crc32fast MIT copies are retained as well.

## Rust runtime

`rust-toolchain.toml` pins Rust 1.95.0 and both GNU/Linux and Darwin architectures. The
[Rust standard-library inventory](./third_party_licenses/rust-standard-library.html)
is copied byte-for-byte from that official toolchain's
`share/doc/rust/COPYRIGHT-library.html`. Its inventory includes other targets
conservatively. The [compiler-builtins license](./third_party_licenses/compiler-builtins-license.txt)
preserves its MIT and Apache-2.0 WITH LLVM-exception terms and bundled component
notices. The separately installed npm dependency graph retains its own notices;
its packages are not embedded in the Rust executables.

## Generation, verification and redistribution

Install cargo-about 0.9.1 and use the pinned Rust toolchain. From the repository
root, run:

```sh
node scripts/generate-native-notices.mjs
pnpm exec tsrepo test test/test.notices.node.ts --verbose --logfile
```

The generator uses Cargo.lock and checksum-pinned local or Git license sources
from `rust/about.toml`. Network access is required for the pinned Git sources.
`rust/notices.sources.json` records supplemental upstream provenance and exact
bytes; the generator rejects changes to these reviewed copies. Refresh them
from their recorded upstream sources only as part of a distribution review.
For the ring supplement, verify its archive checksum and collect copyright
comments from `.rs`, `.c`, `.h`, `.S` and `.pl` source files; retain comment bytes
and source paths, grouping only identical comments.

The generated [inventory](./third_party_licenses/inventory.json) records the
complete package graph, selected licenses and input/output SHA-256 hashes.
Tests reject missing graph coverage, changed inputs or notices, generic copyright
placeholders, incomplete package paths and accidental static glibc linkage.
After changing the lockfile, compiler, target configuration or notice inputs,
regenerate and review the inventory and qualify all four native distributions.

Keep `license.md`, this index and the complete `third_party_licenses/` directory
beside any separately distributed executable. A deployment must verify its
actual host or container's operating-system and shared-library compatibility before activation.
