[package]
edition = "2021"
rust-version = "1.75"
name = "fsys"
version = "1.1.0"
authors = ["James Gober <me@jamesgober.com>"]
build = false
include = [
"src/**/*",
"tests/**/*",
"benches/**/*",
"examples/**/*",
"Cargo.toml",
"README.md",
"LICENSE-APACHE",
"LICENSE-MIT",
"CHANGELOG.md",
]
autolib = false
autobins = false
autoexamples = false
autotests = false
autobenches = false
description = "Filesystem IO for Rust storage engines: journal substrate, io_uring, NVMe passthrough, atomic writes, cross-platform durability."
homepage = "https://github.com/jamesgober/fsys-rs"
documentation = "https://docs.rs/fsys"
readme = "README.md"
keywords = [
"journal",
"filesystem",
"storage",
"durability",
"nvme",
]
categories = [
"filesystem",
"hardware-support",
"os",
"concurrency",
]
license = "Apache-2.0 OR MIT"
repository = "https://github.com/jamesgober/fsys-rs"
[package.metadata.docs.rs]
all-features = true
rustdoc-args = [
"--cfg",
"docsrs",
]
[features]
async = ["dep:tokio"]
default = []
fuzz = []
oom_inject = []
spdk = []
stress = []
tracing = ["dep:tracing"]
[lib]
name = "fsys"
path = "src/lib.rs"
[[example]]
name = "01_quick_one_shot"
path = "examples/01_quick_one_shot.rs"
[[example]]
name = "02_handle_basics"
path = "examples/02_handle_basics.rs"
[[example]]
name = "03_method_sync"
path = "examples/03_method_sync.rs"
[[example]]
name = "04_method_data"
path = "examples/04_method_data.rs"
[[example]]
name = "05_method_direct"
path = "examples/05_method_direct.rs"
[[example]]
name = "06_method_mmap"
path = "examples/06_method_mmap.rs"
[[example]]
name = "07_method_auto"
path = "examples/07_method_auto.rs"
[[example]]
name = "08_write_copy"
path = "examples/08_write_copy.rs"
[[example]]
name = "09_batch_slice"
path = "examples/09_batch_slice.rs"
[[example]]
name = "10_batch_builder"
path = "examples/10_batch_builder.rs"
[[example]]
name = "11_async_basics"
path = "examples/11_async_basics.rs"
required-features = ["async"]
[[example]]
name = "12_async_batch"
path = "examples/12_async_batch.rs"
required-features = ["async"]
[[example]]
name = "13_root_scoped"
path = "examples/13_root_scoped.rs"
[[example]]
name = "14_directory_crud"
path = "examples/14_directory_crud.rs"
[[example]]
name = "15_error_handling"
path = "examples/15_error_handling.rs"
[[example]]
name = "16_tuning_direct"
path = "examples/16_tuning_direct.rs"
[[example]]
name = "17_journal_basics"
path = "examples/17_journal_basics.rs"
[[example]]
name = "18_journal_append_batch"
path = "examples/18_journal_append_batch.rs"
[[example]]
name = "19_batch_commit_grouped"
path = "examples/19_batch_commit_grouped.rs"
[[example]]
name = "20_tune_for_database"
path = "examples/20_tune_for_database.rs"
[[example]]
name = "21_punch_hole_wal_trim"
path = "examples/21_punch_hole_wal_trim.rs"
[[example]]
name = "22_sync_mode_barrier_macos"
path = "examples/22_sync_mode_barrier_macos.rs"
[[example]]
name = "23_multi_shard_batches"
path = "examples/23_multi_shard_batches.rs"
[[example]]
name = "24_observer_basics"
path = "examples/24_observer_basics.rs"
[[example]]
name = "25_sqpoll_opt_in"
path = "examples/25_sqpoll_opt_in.rs"
[[example]]
name = "26_plp_aware_skip_fsync"
path = "examples/26_plp_aware_skip_fsync.rs"
[[example]]
name = "27_atomic_write_unit"
path = "examples/27_atomic_write_unit.rs"
[[example]]
name = "28_write_lifetime_hint"
path = "examples/28_write_lifetime_hint.rs"
[[example]]
name = "29_reflink_aware_copy"
path = "examples/29_reflink_aware_copy.rs"
[[example]]
name = "30_capability_probe"
path = "examples/30_capability_probe.rs"
[[example]]
name = "31_capability_cache_lifecycle"
path = "examples/31_capability_cache_lifecycle.rs"
[[example]]
name = "32_journal_backend_info"
path = "examples/32_journal_backend_info.rs"
[[example]]
name = "33_method_spdk_gating"
path = "examples/33_method_spdk_gating.rs"
[[test]]
name = "async_batch"
path = "tests/async_batch.rs"
[[test]]
name = "async_crud"
path = "tests/async_crud.rs"
[[test]]
name = "async_substrate"
path = "tests/async_substrate.rs"
[[test]]
name = "batch_builder"
path = "tests/batch_builder.rs"
[[test]]
name = "batch_ordering"
path = "tests/batch_ordering.rs"
[[test]]
name = "batch_partial_failure"
path = "tests/batch_partial_failure.rs"
[[test]]
name = "capability_stress"
path = "tests/capability_stress.rs"
[[test]]
name = "concurrent_handles"
path = "tests/concurrent_handles.rs"
[[test]]
name = "crash_data"
path = "tests/crash_data.rs"
[[test]]
name = "crash_direct"
path = "tests/crash_direct.rs"
[[test]]
name = "crash_journal"
path = "tests/crash_journal.rs"
[[test]]
name = "crash_mmap"
path = "tests/crash_mmap.rs"
[[test]]
name = "crash_sync"
path = "tests/crash_sync.rs"
[[test]]
name = "critical_fixes_0_8_0"
path = "tests/critical_fixes_0_8_0.rs"
[[test]]
name = "dir_completion"
path = "tests/dir_completion.rs"
[[test]]
name = "edge_cases"
path = "tests/edge_cases.rs"
[[test]]
name = "fd_exhaustion"
path = "tests/fd_exhaustion.rs"
[[test]]
name = "foundation"
path = "tests/foundation.rs"
[[test]]
name = "handle_poisoning"
path = "tests/handle_poisoning.rs"
[[test]]
name = "hostile_filesystems"
path = "tests/hostile_filesystems.rs"
[[test]]
name = "iouring_features_fallback"
path = "tests/iouring_features_fallback.rs"
[[test]]
name = "journal_concurrent"
path = "tests/journal_concurrent.rs"
[[test]]
name = "journal_direct"
path = "tests/journal_direct.rs"
[[test]]
name = "journal_direct_edge_cases"
path = "tests/journal_direct_edge_cases.rs"
[[test]]
name = "journal_storage_engine"
path = "tests/journal_storage_engine.rs"
[[test]]
name = "method_mmap"
path = "tests/method_mmap.rs"
[[test]]
name = "nvme_passthrough"
path = "tests/nvme_passthrough.rs"
[[test]]
name = "oom_injection"
path = "tests/oom_injection.rs"
[[test]]
name = "path_security"
path = "tests/path_security.rs"
[[test]]
name = "pipeline_backpressure"
path = "tests/pipeline_backpressure.rs"
[[test]]
name = "pipeline_basic"
path = "tests/pipeline_basic.rs"
[[test]]
name = "pipeline_concurrency"
path = "tests/pipeline_concurrency.rs"
[[test]]
name = "pipeline_panic"
path = "tests/pipeline_panic.rs"
[[test]]
name = "pipeline_shutdown"
path = "tests/pipeline_shutdown.rs"
[[test]]
name = "platform_symmetry"
path = "tests/platform_symmetry.rs"
[[test]]
name = "power_loss_sim"
path = "tests/power_loss_sim.rs"
[[test]]
name = "regression_benchmarks"
path = "tests/regression_benchmarks.rs"
[[test]]
name = "smoke"
path = "tests/smoke.rs"
[[test]]
name = "stress"
path = "tests/stress.rs"
[[test]]
name = "write_copy"
path = "tests/write_copy.rs"
[[bench]]
name = "async_native_vs_blocking"
path = "benches/async_native_vs_blocking.rs"
harness = false
required-features = ["async"]
[[bench]]
name = "backend_accessors"
path = "benches/backend_accessors.rs"
harness = false
[[bench]]
name = "batch_throughput"
path = "benches/batch_throughput.rs"
harness = false
[[bench]]
name = "capability_access"
path = "benches/capability_access.rs"
harness = false
[[bench]]
name = "concurrent_batches"
path = "benches/concurrent_batches.rs"
harness = false
[[bench]]
name = "direct_iouring"
path = "benches/direct_iouring.rs"
harness = false
[[bench]]
name = "journal_vs_atomic_replace"
path = "benches/journal_vs_atomic_replace.rs"
harness = false
[[bench]]
name = "matrix_with_peers"
path = "benches/matrix_with_peers.rs"
harness = false
required-features = ["async"]
[[bench]]
name = "method_comparison"
path = "benches/method_comparison.rs"
harness = false
[[bench]]
name = "method_payload_matrix"
path = "benches/method_payload_matrix.rs"
harness = false
[[bench]]
name = "mmap_workloads"
path = "benches/mmap_workloads.rs"
harness = false
[[bench]]
name = "single_read"
path = "benches/single_read.rs"
harness = false
[[bench]]
name = "single_write"
path = "benches/single_write.rs"
harness = false
[[bench]]
name = "solo_vs_batch"
path = "benches/solo_vs_batch.rs"
harness = false
[[bench]]
name = "tail_validation"
path = "benches/tail_validation.rs"
harness = false
[dependencies.crc32c]
version = "0.6"
[dependencies.crossbeam-channel]
version = "0.5"
[dependencies.crossbeam-queue]
version = "0.3"
[dependencies.crossbeam-utils]
version = "0.8"
default-features = false
[dependencies.glob]
version = "0.3"
[dependencies.memmap2]
version = "0.9"
[dependencies.parking_lot]
version = "0.12"
[dependencies.tokio]
version = "1"
features = [
"rt",
"rt-multi-thread",
"sync",
"macros",
"net",
"time",
]
optional = true
[dependencies.tracing]
version = "0.1"
optional = true
default-features = false
[dev-dependencies.criterion]
version = "0.5"
features = ["html_reports"]
[target.'cfg(target_os = "linux")'.dependencies.io-uring]
version = "0.6"
[target."cfg(unix)".dependencies.libc]
version = "0.2"
default-features = false
[target."cfg(windows)".dependencies.windows-sys]
version = "0.59"
features = [
"Win32_Storage_FileSystem",
"Win32_Storage_IscsiDisc",
"Win32_Foundation",
"Win32_System_IO",
"Win32_System_Ioctl",
"Win32_System_Pipes",
"Win32_System_SystemInformation",
"Win32_Security",
"Win32_Security_Authorization",
]
[profile.bench]
opt-level = 3
lto = "thin"
codegen-units = 1
debug = 2
[profile.release]
opt-level = 3
lto = "thin"
codegen-units = 1
strip = "symbols"