Struct EnvironmentConfig

Source

pub struct EnvironmentConfig {Show 149 fields
    pub home: PathBuf,
    pub allow_create: bool,
    pub transactional: bool,
    pub read_only: bool,
    pub env_is_locking: bool,
    pub shared_cache: bool,
    pub env_recovery_force_checkpoint: bool,
    pub env_recovery_force_new_file: bool,
    pub halt_on_commit_after_checksum_exception: bool,
    pub logging_level: Option<String>,
    pub cache_size: u64,
    pub cache_percent: u32,
    pub max_off_heap_memory: u64,
    pub max_disk: u64,
    pub free_disk: u64,
    pub run_in_compressor: bool,
    pub run_checkpointer: bool,
    pub run_cleaner: bool,
    pub run_evictor: bool,
    pub run_offheap_evictor: bool,
    pub run_verifier: bool,
    pub env_background_read_limit_kb: u32,
    pub env_background_write_limit_kb: u32,
    pub env_background_sleep_interval_us: u64,
    pub env_check_leaks: bool,
    pub env_forced_yield: bool,
    pub env_fair_latches: bool,
    pub env_latch_timeout_ms: u64,
    pub env_ttl_clock_tolerance_ms: u64,
    pub env_expiration_enabled: bool,
    pub env_db_eviction: bool,
    pub env_dup_convert_preload_all: bool,
    pub adler32_chunk_size: usize,
    pub log_file_max_bytes: u64,
    pub log_file_cache_size: usize,
    pub log_checksum_read: bool,
    pub log_verify_checksums: bool,
    pub log_fsync_timeout_ms: u64,
    pub log_fsync_time_limit_ms: u64,
    pub log_num_buffers: usize,
    pub log_total_buffer_bytes: u64,
    pub log_buffer_size: usize,
    pub log_fault_read_size: usize,
    pub log_iterator_read_size: usize,
    pub log_iterator_max_size: usize,
    pub log_n_data_directories: u32,
    pub log_mem_only: bool,
    pub log_detect_file_delete: bool,
    pub log_detect_file_delete_interval_ms: u64,
    pub log_flush_sync_interval_ms: u64,
    pub log_flush_no_sync_interval_ms: u64,
    pub log_use_odsync: bool,
    pub log_use_write_queue: bool,
    pub log_write_queue_size: usize,
    pub log_group_commit_threshold: usize,
    pub log_group_commit_interval_ms: u64,
    pub node_max_entries: u32,
    pub node_dup_tree_max_entries: u32,
    pub tree_max_embedded_ln: u32,
    pub tree_max_delta: u8,
    pub tree_bin_delta: bool,
    pub tree_min_memory: u64,
    pub tree_compact_max_key_length: u32,
    pub in_compressor_wakeup_interval_ms: u64,
    pub compressor_deadlock_retry: u32,
    pub compressor_lock_timeout_ms: u64,
    pub compressor_purge_root: bool,
    pub cleaner_min_utilization: u8,
    pub cleaner_min_file_utilization: u8,
    pub cleaner_threads: u32,
    pub cleaner_min_file_count: u32,
    pub cleaner_min_age: u32,
    pub cleaner_bytes_interval: u64,
    pub cleaner_wakeup_interval_ms: u64,
    pub cleaner_fetch_obsolete_size: bool,
    pub cleaner_adjust_utilization: bool,
    pub cleaner_deadlock_retry: u32,
    pub cleaner_lock_timeout_ms: u64,
    pub cleaner_expunge: bool,
    pub cleaner_use_deleted_dir: bool,
    pub cleaner_max_batch_files: u32,
    pub cleaner_read_size: usize,
    pub cleaner_detail_max_memory_percentage: u32,
    pub cleaner_look_ahead_cache_size: usize,
    pub cleaner_foreground_proactive_migration: bool,
    pub cleaner_background_proactive_migration: bool,
    pub cleaner_lazy_migration: bool,
    pub cleaner_expiration_enabled: bool,
    pub checkpointer_bytes_interval: u64,
    pub checkpointer_wakeup_interval_ms: u64,
    pub checkpointer_min_interval_secs: u64,
    pub checkpointer_deadlock_retry: u32,
    pub checkpointer_high_priority: bool,
    pub evictor_nodes_per_scan: usize,
    pub evictor_evict_bytes: u64,
    pub evictor_critical_percentage: u32,
    pub evictor_lru_only: bool,
    pub evictor_n_lru_lists: u32,
    pub evictor_deadlock_retry: u32,
    pub evictor_core_threads: usize,
    pub evictor_max_threads: usize,
    pub evictor_keep_alive_ms: u64,
    pub evictor_allow_bin_deltas: bool,
    pub offheap_evict_bytes: u64,
    pub offheap_n_lru_lists: u32,
    pub offheap_checksum: bool,
    pub offheap_core_threads: usize,
    pub offheap_max_threads: usize,
    pub offheap_keep_alive_ms: u64,
    pub lock_timeout_ms: u64,
    pub lock_n_lock_tables: u32,
    pub lock_deadlock_detect: bool,
    pub lock_deadlock_detect_delay_ms: u64,
    pub txn_timeout_ms: u64,
    pub durability: Durability,
    pub txn_no_sync: bool,
    pub txn_write_no_sync: bool,
    pub txn_serializable_isolation: bool,
    pub txn_deadlock_stack_trace: bool,
    pub txn_dump_locks: bool,
    pub verify_schedule: String,
    pub verify_log: bool,
    pub verify_log_read_delay_ms: u64,
    pub verify_btree: bool,
    pub verify_secondaries: bool,
    pub verify_data_records: bool,
    pub verify_obsolete_records: bool,
    pub verify_btree_batch_size: u32,
    pub verify_btree_batch_delay_ms: u64,
    pub dos_producer_queue_timeout_ms: u64,
    pub stats_collect: bool,
    pub stats_collect_interval_secs: u64,
    pub stats_max_files: u32,
    pub stats_file_row_count: u32,
    pub stats_file_directory: Option<PathBuf>,
    pub trace_file: bool,
    pub trace_console: bool,
    pub trace_db: bool,
    pub trace_file_limit_bytes: u64,
    pub trace_file_count: u32,
    pub trace_level: Option<String>,
    pub console_logging_level: Option<String>,
    pub file_logging_level: Option<String>,
    pub trace_level_lock_manager: Option<String>,
    pub trace_level_recovery: Option<String>,
    pub trace_level_evictor: Option<String>,
    pub trace_level_cleaner: Option<String>,
    pub startup_dump_threshold_ms: u64,
    pub exception_listener: ExceptionListenerHolder,
}

Expand description

Configuration for opening a Noxu DB environment.

Configuration for a Noxu DB environment. Provides 150+ typed parameters for tuning all subsystems. Use the builder pattern (set_* / with_*) to configure individual parameters; all fields have -identical defaults unless noted.

Fields§

§home: PathBuf

Home directory for the environment.

§allow_create: bool

Allow creation of a new environment if it does not exist. Mirrors EnvironmentConfig.setAllowCreate() / default false.

§transactional: bool

Open the environment for transactional use. Mirrors ENV_IS_TRANSACTIONAL / default false.

§read_only: bool

Open the environment in read-only mode. Mirrors ENV_READ_ONLY / default false.

§env_is_locking: bool

Enable locking. When false the environment runs without a lock manager (equivalent to-transactional, non-locking mode). Mirrors ENV_IS_LOCKING / default true.

§shared_cache: bool

Share the B-tree cache across multiple environments in the same JVM. In Noxu, this is a configuration hint; shared-cache pooling is accepted as a future work item. Mirrors SHARED_CACHE / default false.

§env_recovery_force_checkpoint: bool

Force a checkpoint after recovery completes. Mirrors ENV_RECOVERY_FORCE_CHECKPOINT / default false.

§env_recovery_force_new_file: bool

Force a new log file to be started after recovery. Mirrors ENV_RECOVERY_FORCE_NEW_FILE / default false.

§halt_on_commit_after_checksum_exception: bool

Halt the environment on commit after a ChecksumException. Mirrors HALT_ON_COMMIT_AFTER_CHECKSUMEXCEPTION / default false.

§logging_level: Option<String>

Logging level for this environment (uses Rust log crate levels: "ERROR", "WARN", "INFO", "DEBUG", "TRACE"). : maps to java.util.logging.level / default "INFO".

§cache_size: u64

Maximum bytes for the B-tree cache. Mirrors MAX_MEMORY / EnvironmentConfig.setCacheSize() / default 0 ( auto-sizes to 60% of heap). Noxu default: 64 MiB.

§cache_percent: u32

Cache size as a percentage of system memory (0 = use cache_size). Mirrors MAX_MEMORY_PERCENT / EnvironmentConfig.setCachePercent() / default 60. When non-zero, overrides cache_size.

§max_off_heap_memory: u64

Off-heap cache size in bytes. 0 = disabled. Mirrors MAX_OFF_HEAP_MEMORY / default 0.

§max_disk: u64

Maximum disk space the environment may use in bytes. 0 = unlimited. Mirrors MAX_DISK / default 0.

§free_disk: u64

Minimum free disk space in bytes; triggers DiskLimitExceeded if the available space on the file-system falls below this threshold. Mirrors FREE_DISK / default 5 GiB.

§run_in_compressor: bool

Run the background INCompressor daemon. Mirrors ENV_RUN_IN_COMPRESSOR / default true.

§run_checkpointer: bool

Run the background Checkpointer daemon. Mirrors ENV_RUN_CHECKPOINTER / default true.

§run_cleaner: bool

Run the background Cleaner daemon. Mirrors ENV_RUN_CLEANER / default true.

§run_evictor: bool

Run the background Evictor daemon. Mirrors ENV_RUN_EVICTOR / default true.

§run_offheap_evictor: bool

Run the background off-heap Evictor daemon. Mirrors ENV_RUN_OFFHEAP_EVICTOR / default true (when off-heap configured).

§run_verifier: bool

Run the background data-integrity Verifier daemon. Mirrors ENV_RUN_VERIFIER / default false.

§env_background_read_limit_kb: u32

Maximum read throughput for background daemons in KB/s. 0 = unlimited. Mirrors ENV_BACKGROUND_READ_LIMIT / default 0.

§env_background_write_limit_kb: u32

Maximum write throughput for background daemons in KB/s. 0 = unlimited. Mirrors ENV_BACKGROUND_WRITE_LIMIT / default 0.

§env_background_sleep_interval_us: u64

Sleep interval for background daemons between work units in microseconds. 0 = no enforced sleep. Mirrors ENV_BACKGROUND_SLEEP_INTERVAL / default 0.

§env_check_leaks: bool

Check for lock leaks when databases are closed.

Reserved / not yet implemented as of v3.1. Setting a non-default value (false) has no effect and emits a WARN log at Environment::open time.

Mirrors ENV_CHECK_LEAKS / default true.

§env_forced_yield: bool

Force thread yields in critical sections (useful for testing fairness).

Reserved / not yet implemented as of v3.1. Setting a non-default value (true) has no effect and emits a WARN log at Environment::open time.

Mirrors ENV_FORCED_YIELD / default false.

§env_fair_latches: bool

Use fair (FIFO-ordered) latches. May reduce throughput under low contention but prevents starvation.

Reserved / not yet implemented as of v3.1. Setting a non-default value (true) has no effect and emits a WARN log at Environment::open time.

Mirrors ENV_FAIR_LATCHES / default false.

§env_latch_timeout_ms: u64

Latch acquisition timeout in milliseconds. 0 = no timeout (block indefinitely). In JE, a timeout causes EnvironmentFailure.

Reserved / not yet implemented as of v3.1. Setting a non-default value (non-zero) has no effect and emits a WARN log at Environment::open time. The latch layer always blocks indefinitely.

Mirrors ENV_LATCH_TIMEOUT / default 300_000 ms (5 min).

§env_ttl_clock_tolerance_ms: u64

TTL clock tolerance — records within this many milliseconds of their expiration time are treated as expired.

Reserved / not yet implemented as of v3.1. Setting a non-default value (non-zero) has no effect and emits a WARN log at Environment::open time.

Mirrors ENV_TTL_CLOCK_TOLERANCE / default 0.

§env_expiration_enabled: bool

Enable TTL-based record expiration at the environment level.

Reserved / not yet implemented as of v3.1. Setting a non-default value (true) has no effect and emits a WARN log at Environment::open time.

Mirrors ENV_EXPIRATION_ENABLED / default false.

§env_db_eviction: bool

Enable per-database node eviction.

Reserved / not yet implemented as of v3.1. Setting a non-default value (true) has no effect and emits a WARN log at Environment::open time.

Mirrors ENV_DB_EVICTION / default false.

§env_dup_convert_preload_all: bool

Preload all duplicate-tree data before converting dup databases. Mirrors ENV_DUP_CONVERT_PRELOAD_ALL / default true.

§adler32_chunk_size: usize

Chunk size (bytes) for Adler32 checksums. 0 = disabled (use CRC32). Mirrors ADLER32_CHUNK_SIZE / default 0.

§log_file_max_bytes: u64

Maximum size of a single log file in bytes. Mirrors LOG_FILE_MAX / default 10 MiB.

§log_file_cache_size: usize

Number of cached open file handles (LRU-evicted when full). Mirrors LOG_FILE_CACHE_SIZE / default 100.

§log_checksum_read: bool

Validate entry checksums on every log read. Mirrors LOG_CHECKSUM_READ / default true.

§log_verify_checksums: bool

Verify all checksums during log scans (more thorough than log_checksum_read; used by background verifier). Mirrors LOG_VERIFY_CHECKSUMS / default false.

§log_fsync_timeout_ms: u64

Timeout for a single fdatasync call in milliseconds. Mirrors LOG_FSYNC_TIMEOUT / default 500_000 ms.

§log_fsync_time_limit_ms: u64

Soft limit on fsync duration in milliseconds; logs a warning when exceeded. 0 = disabled. Mirrors LOG_FSYNC_TIME_LIMIT / default 0.

§log_num_buffers: usize

Number of write buffers in the log buffer pool. Mirrors LOG_NUM_BUFFERS / default 3.

§log_total_buffer_bytes: u64

Total bytes across all log write buffers. Mirrors LOG_TOTAL_BUFFER_BYTES / default 7 MiB.

§log_buffer_size: usize

Per-buffer size override in bytes. 0 = derive from log_total_buffer_bytes / log_num_buffers. Mirrors LOG_BUFFER_SIZE / default 0.

§log_fault_read_size: usize

Size of the fault-in read buffer for random BIN fetches. Mirrors LOG_FAULT_READ_SIZE / default 2 KiB.

§log_iterator_read_size: usize

Log iterator read buffer in bytes. Mirrors LOG_ITERATOR_READ_SIZE / default 8 KiB.

§log_iterator_max_size: usize

Log iterator maximum buffer size in bytes (grows up to this limit). Mirrors LOG_ITERATOR_MAX_SIZE / default 16 MiB.

§log_n_data_directories: u32

Number of data directories for log file striping. 0 = single dir. Mirrors LOG_N_DATA_DIRECTORIES / default 0.

§log_mem_only: bool

Run in in-memory-only mode (no log files written). Mirrors LOG_MEM_ONLY / default false.

§log_detect_file_delete: bool

Detect external deletion of log files and respond gracefully. Mirrors LOG_DETECT_FILE_DELETE / default false.

§log_detect_file_delete_interval_ms: u64

Interval between log-file deletion detection polls in milliseconds. Mirrors LOG_DETECT_FILE_DELETE_INTERVAL / default 3_000 ms.

§log_flush_sync_interval_ms: u64

Interval between periodic flush-and-sync operations in milliseconds. 0 = disabled. : LOG_FLUSH_SYNC_INTERVAL / default 0.

§log_flush_no_sync_interval_ms: u64

Interval between periodic flush-without-sync operations in milliseconds. 0 = disabled. Mirrors LOG_FLUSH_NO_SYNC_INTERVAL / default 0.

§log_use_odsync: bool

Use O_DSYNC when opening log files. Accepted deviation: on Linux Noxu passes O_DSYNC to OpenOptions; semantics are equivalent. Mirrors LOG_USE_ODSYNC / default false.

§log_use_write_queue: bool

Use an asynchronous write queue between the log manager and the OS. Mirrors LOG_USE_WRITE_QUEUE / default false.

§log_write_queue_size: usize

Size of the asynchronous write queue in bytes. Mirrors LOG_WRITE_QUEUE_SIZE / default 1 MiB.

§log_group_commit_threshold: usize

Group-commit waiter threshold. 0 = disabled. Mirrors LOG_GROUP_COMMIT_THRESHOLD / default 0.

§log_group_commit_interval_ms: u64

Group-commit interval in milliseconds. 0 = disabled. Mirrors LOG_GROUP_COMMIT_INTERVAL / default 0.

§node_max_entries: u32

Maximum number of entries per Internal Node (IN). Mirrors NODE_MAX_ENTRIES / default 128.

§node_dup_tree_max_entries: u32

Maximum number of entries per duplicate-tree node. Mirrors NODE_DUP_TREE_MAX_ENTRIES / default 128.

§tree_max_embedded_ln: u32

Maximum value size in bytes for inline (embedded) LNs stored directly in the BIN slot. Records larger than this are stored as separate LNs. Mirrors TREE_MAX_EMBEDDED_LN / default 16.

§tree_max_delta: u8

Maximum percentage of BIN entries that may be in a delta before a full BIN is written (0–100). Mirrors TREE_MAX_DELTA / default 25.

§tree_bin_delta: bool

Write BIN-delta log entries (partial BIN updates). Mirrors TREE_BIN_DELTA / default true.

§tree_min_memory: u64

Minimum memory per B-tree node in bytes. 0 = no minimum. Mirrors TREE_MIN_MEMORY / default 0.

§tree_compact_max_key_length: u32

Maximum key length for compact (prefix-compressed) key storage. Mirrors TREE_COMPACT_MAX_KEY_LENGTH / default 16.

§in_compressor_wakeup_interval_ms: u64

INCompressor wakeup interval in milliseconds. Mirrors COMPRESSOR_WAKEUP_INTERVAL / default 5_000 ms.

§compressor_deadlock_retry: u32

Number of deadlock retries per INCompressor pass. Mirrors COMPRESSOR_DEADLOCK_RETRY / default 3.

§compressor_lock_timeout_ms: u64

Lock timeout for INCompressor operations in milliseconds. Mirrors COMPRESSOR_LOCK_TIMEOUT / default 500 ms.

§compressor_purge_root: bool

Purge the root IN when it becomes empty after compression. Mirrors COMPRESSOR_PURGE_ROOT / default false.

§cleaner_min_utilization: u8

Minimum log utilization percentage; cleaning triggers when below this. Mirrors CLEANER_MIN_UTILIZATION / default 50.

§cleaner_min_file_utilization: u8

Minimum per-file utilization; files below this are always candidates. Mirrors CLEANER_MIN_FILE_UTILIZATION / default 5.

§cleaner_threads: u32

Number of background cleaner threads. Mirrors CLEANER_THREADS / default 1.

§cleaner_min_file_count: u32

Minimum number of log files that must exist before cleaning begins. Mirrors CLEANER_MIN_FILES_TO_CLEAN / default 2.

§cleaner_min_age: u32

Minimum age of a log file (in checkpoints) before it becomes a candidate. : CLEANER_MIN_AGE / default 2.

§cleaner_bytes_interval: u64

Bytes written between cleaner wakeups (byte-based trigger). 0 = disabled. : CLEANER_BYTES_INTERVAL / default 0.

§cleaner_wakeup_interval_ms: u64

Time between cleaner wakeups in milliseconds (time-based trigger). 0 = disabled. : CLEANER_WAKEUP_INTERVAL / default 0.

§cleaner_fetch_obsolete_size: bool

Fetch the sizes of obsolete records when calculating utilization. Mirrors CLEANER_FETCH_OBSOLETE_SIZE / default false.

§cleaner_adjust_utilization: bool

Adjust utilization accounting for uncommitted transactions. Mirrors CLEANER_ADJUST_UTILIZATION / default false.

§cleaner_deadlock_retry: u32

Number of deadlock retries per cleaner migration pass. Mirrors CLEANER_DEADLOCK_RETRY / default 3.

§cleaner_lock_timeout_ms: u64

Lock timeout for cleaner migration operations in milliseconds. Mirrors CLEANER_LOCK_TIMEOUT / default 500 ms.

§cleaner_expunge: bool

Expunge (delete) cleaned log files immediately rather than keeping them in a deleted/ sub-directory. Mirrors CLEANER_EXPUNGE / default true.

§cleaner_use_deleted_dir: bool

Move cleaned log files to a deleted/ sub-directory instead of deleting them in place. Mirrors CLEANER_USE_DELETED_DIR / default false.

§cleaner_max_batch_files: u32

Maximum number of log files processed per cleaner batch. 0 = unlimited. : CLEANER_MAX_BATCH_FILES / default 0.

§cleaner_read_size: usize

Bytes read per cleaner file scan pass. Mirrors CLEANER_READ_SIZE / default 8 KiB.

§cleaner_detail_max_memory_percentage: u32

Maximum percentage of the cache to use for cleaner utilization detail. Mirrors CLEANER_DETAIL_MAX_MEMORY_PERCENTAGE / default 2.

§cleaner_look_ahead_cache_size: usize

Number of LN records to look ahead during file cleaning. Mirrors CLEANER_LOOK_AHEAD_CACHE_SIZE / default 32.

§cleaner_foreground_proactive_migration: bool

Migrate live records proactively in the foreground (user threads). Mirrors CLEANER_FOREGROUND_PROACTIVE_MIGRATION / default false.

§cleaner_background_proactive_migration: bool

Migrate live records proactively in the background cleaner thread. Mirrors CLEANER_BACKGROUND_PROACTIVE_MIGRATION / default false.

§cleaner_lazy_migration: bool

Lazy migration: defer LN migration until the slot is next accessed. Mirrors CLEANER_LAZY_MIGRATION / default false.

§cleaner_expiration_enabled: bool

Enable TTL-based record expiration tracking in the cleaner. Mirrors CLEANER_EXPIRATION_ENABLED / default false.

§checkpointer_bytes_interval: u64

Number of bytes written between automatic checkpoints. Mirrors CHECKPOINTER_BYTES_INTERVAL / default 20 MiB.

§checkpointer_wakeup_interval_ms: u64

Time between automatic checkpoints in milliseconds. 0 = disabled. : CHECKPOINTER_WAKEUP_INTERVAL / default 30_000 ms.

§checkpointer_min_interval_secs: u64

Minimum time between automatic checkpoints in seconds (0 = disabled). : relates to CHECKPOINTER_HIGH_PRIORITY.

§checkpointer_deadlock_retry: u32

Number of deadlock retries per checkpoint. Mirrors CHECKPOINTER_DEADLOCK_RETRY / default 3.

§checkpointer_high_priority: bool

Run checkpoints at high priority (flush more aggressively). Mirrors CHECKPOINTER_HIGH_PRIORITY / default false.

§evictor_nodes_per_scan: usize

Number of tree nodes examined per evictor pass. Mirrors EVICTOR_NODES_PER_SCAN / default 10.

§evictor_evict_bytes: u64

Bytes to evict from the cache per evictor pass. Mirrors EVICTOR_EVICT_BYTES / default 512 KiB.

§evictor_critical_percentage: u32

Percentage above the cache target at which critical eviction kicks in. Mirrors EVICTOR_CRITICAL_PERCENTAGE / default 5.

§evictor_lru_only: bool

Use LRU-only eviction (no priority-1 / priority-2 split). Mirrors EVICTOR_LRU_ONLY / default false.

§evictor_n_lru_lists: u32

Number of LRU lists (increases parallelism under contention). Mirrors EVICTOR_N_LRU_LISTS / default 4.

§evictor_deadlock_retry: u32

Number of deadlock retries per evictor pass. Mirrors EVICTOR_DEADLOCK_RETRY / default 3.

§evictor_core_threads: usize

Minimum number of background evictor threads always kept alive. Mirrors EVICTOR_CORE_THREADS / default 1.

§evictor_max_threads: usize

Maximum number of background evictor threads. Mirrors EVICTOR_MAX_THREADS / default 10.

§evictor_keep_alive_ms: u64

Keep-alive time for idle evictor threads in milliseconds. Mirrors EVICTOR_KEEP_ALIVE / default 60_000 ms.

§evictor_allow_bin_deltas: bool

Allow the evictor to write BIN-delta entries rather than full BINs. Mirrors EVICTOR_ALLOW_BIN_DELTAS / default true.

§offheap_evict_bytes: u64

Bytes to evict from the off-heap cache per pass. Mirrors OFFHEAP_EVICT_BYTES / default 512 KiB.

§offheap_n_lru_lists: u32

Number of LRU lists for the off-heap cache. Mirrors OFFHEAP_N_LRU_LISTS / default 4.

§offheap_checksum: bool

Checksum off-heap cache entries on write and verify on read. Mirrors OFFHEAP_CHECKSUM / default false.

§offheap_core_threads: usize

Minimum number of off-heap evictor threads always kept alive. Mirrors OFFHEAP_CORE_THREADS / default 1.

§offheap_max_threads: usize

Maximum number of off-heap evictor threads. Mirrors OFFHEAP_MAX_THREADS / default 10.

§offheap_keep_alive_ms: u64

Keep-alive time for idle off-heap evictor threads in milliseconds. Mirrors OFFHEAP_KEEP_ALIVE / default 60_000 ms.

§lock_timeout_ms: u64

Lock timeout in milliseconds. Mirrors LOCK_TIMEOUT / default 500 ms.

§lock_n_lock_tables: u32

Number of lock table shards. Mirrors LOCK_N_LOCK_TABLES / default 1. Noxu default: 16.

§lock_deadlock_detect: bool

Run the deadlock detector on lock waits. Mirrors LOCK_DEADLOCK_DETECT / default true.

§lock_deadlock_detect_delay_ms: u64

Delay before deadlock detection runs (milliseconds). 0 = detect immediately on every wait. Mirrors LOCK_DEADLOCK_DETECT_DELAY / default 0.

§txn_timeout_ms: u64

Transaction timeout in milliseconds. 0 = no timeout. Mirrors TXN_TIMEOUT / default 0.

§durability: Durability

Default durability policy for transactions. Mirrors TXN_DURABILITY.

§txn_no_sync: bool

Commits do not wait for the log to reach disk. Mirrors TXN_NO_SYNC / default false.

Deprecated since 2.4.1 — use the durability field with Durability::commit_no_sync() instead.

§txn_write_no_sync: bool

Commits write the log to the OS buffer but skip fdatasync. Mirrors TXN_WRITE_NO_SYNC / default false.

Deprecated since 2.4.1 — use the durability field with Durability::commit_write_no_sync() instead.

§txn_serializable_isolation: bool

When true, all transactions default to serializable (degree-3) isolation: read locks are retained through commit. When false (the default), transactions use repeatable-read isolation — read locks are still held for the lifetime of the txn but predicate / phantom protection is not provided. Per-transaction overrides are available via crate::transaction_config::TransactionConfig::set_serializable_isolation and crate::transaction_config::TransactionConfig::set_read_committed. Mirrors TXN_SERIALIZABLE_ISOLATION / default false.

§txn_deadlock_stack_trace: bool

Capture a stack trace at deadlock detection time (expensive). Mirrors TXN_DEADLOCK_STACK_TRACE / default false.

§txn_dump_locks: bool

Dump all lock state on deadlock detection (diagnostic, expensive). Mirrors TXN_DUMP_LOCKS / default false.

§verify_schedule: String

Cron-style schedule string for the background verifier. Empty string = run continuously when run_verifier = true. Mirrors VERIFY_SCHEDULE / default "".

§verify_log: bool

Verify log-file checksums in the background. Mirrors VERIFY_LOG / default false.

§verify_log_read_delay_ms: u64

Delay between log verification read operations in milliseconds. Mirrors VERIFY_LOG_READ_DELAY / default 0.

§verify_btree: bool

Verify the B-tree structure in the background. Mirrors VERIFY_BTREE / default false.

§verify_secondaries: bool

Verify secondary index consistency in the background. Mirrors VERIFY_SECONDARIES / default true.

§verify_data_records: bool

Verify data records (values) in the background. Mirrors VERIFY_DATA_RECORDS / default false.

§verify_obsolete_records: bool

Verify obsolete records have correct LSNs in the background. Mirrors VERIFY_OBSOLETE_RECORDS / default false.

§verify_btree_batch_size: u32

Number of B-tree nodes verified per verifier batch. Mirrors VERIFY_BTREE_BATCH_SIZE / default 1_000.

§verify_btree_batch_delay_ms: u64

Delay between B-tree verification batches in milliseconds. Mirrors VERIFY_BTREE_BATCH_DELAY / default 10 ms.

§dos_producer_queue_timeout_ms: u64

Timeout for the disk-ordered cursor producer queue in milliseconds. Mirrors DOS_PRODUCER_QUEUE_TIMEOUT / default 10_000 ms.

§stats_collect: bool

Force a checkpoint after recovery completes (alias; see env_recovery_force_checkpoint above). Collect environment statistics in the background. Mirrors STATS_COLLECT / default false.

§stats_collect_interval_secs: u64

Interval between background stats collection passes in seconds. Mirrors STATS_COLLECT_INTERVAL / default 300 s.

§stats_max_files: u32

Maximum number of stats CSV files to retain. Mirrors STATS_MAX_FILES / default 100.

§stats_file_row_count: u32

Rows per stats CSV file before rotation. Mirrors STATS_FILE_ROW_COUNT / default 1_000.

§stats_file_directory: Option<PathBuf>

Directory for stats CSV files. None = use the environment home. Mirrors STATS_FILE_DIRECTORY / default None.

§trace_file: bool

Enable log-file-based tracing (uses env home as destination). Mirrors TRACE_FILE / default false.

§trace_console: bool

Enable console (stderr) tracing. Mirrors TRACE_CONSOLE / default false.

§trace_db: bool

Enable database-record-based tracing (internal trace DB). Mirrors TRACE_DB / default false.

§trace_file_limit_bytes: u64

Maximum size of each trace log file in bytes. Mirrors TRACE_FILE_LIMIT / default 10 MiB.

§trace_file_count: u32

Number of rotating trace log files. Mirrors TRACE_FILE_COUNT / default 10.

§trace_level: Option<String>

Overall logging level (e.g. "INFO", "DEBUG"). Mirrors TRACE_LEVEL / default "INFO".

§console_logging_level: Option<String>

Console-handler logging level. Mirrors CONSOLE_LOGGING_LEVEL / default "SEVERE".

§file_logging_level: Option<String>

File-handler logging level. Mirrors FILE_LOGGING_LEVEL / default "INFO".

§trace_level_lock_manager: Option<String>

Lock-manager subsystem trace level. Mirrors TRACE_LEVEL_LOCK_MANAGER / default "FINE".

§trace_level_recovery: Option<String>

Recovery subsystem trace level. Mirrors TRACE_LEVEL_RECOVERY / default "FINE".

§trace_level_evictor: Option<String>

Evictor subsystem trace level. Mirrors TRACE_LEVEL_EVICTOR / default "FINE".

§trace_level_cleaner: Option<String>

Cleaner subsystem trace level. Mirrors TRACE_LEVEL_CLEANER / default "FINE".

§startup_dump_threshold_ms: u64

Startup statistics dump threshold in milliseconds. Dump stats if startup takes longer than this. 0 = disabled. Mirrors STARTUP_DUMP_THRESHOLD / default 0.

§exception_listener: ExceptionListenerHolder

Optional callback invoked when a background daemon thread encounters an exception. Set this to receive notifications from the Checkpointer, Cleaner, Evictor, INCompressor, and Verifier daemons.

Mirrors EnvironmentConfig.setExceptionListener(ExceptionListener).