rustfs/rustfs · error · StorageError::ShortWrite

0x4F

0x4F

Error message

short write

What it means

StorageError variant meaning a disk write completed only partially (write returned a short count) so the file is not durably complete. RustFS fails the operation instead of accepting partial durability; the caller retries the write or the whole object/part operation. It mirrors DiskError::ShortWrite at the storage-error level.

Source

Thrown at crates/ecstore/src/error/mod.rs:84

///   - **Generic** – I/O, locks, and catch-all errors
#[derive(Debug, thiserror::Error)]
pub enum StorageError {
    // ── Disk / Volume ────────────────────────────────────────────────
    #[error("Faulty disk")]
    FaultyDisk,
    #[error("Faulty remote disk")]
    FaultyRemoteDisk,
    #[error("Disk full")]
    DiskFull,
    #[error("Disk not found")]
    DiskNotFound,
    #[error("Disk access denied")]
    DiskAccessDenied,
    #[error("Drive is root")]
    DriveIsRoot,
    #[error("Unformatted disk")]
    UnformattedDisk,
    #[error("Corrupted format")]
    CorruptedFormat,
    #[error("Corrupted backend")]
    CorruptedBackend,
    #[error("Too many open files")]
    TooManyOpenFiles,
    #[error("maximum versions exceeded, please delete few versions to proceed")]
    MaxVersionsExceeded,
    #[error("inconsistent drive found")]
    InconsistentDisk,
    #[error("drive does not support O_DIRECT")]
    UnsupportedDisk,
    #[error("disk not a dir")]
    DiskNotDir,
    #[error("drive still did not complete the request")]
    DiskOngoingReq,
    #[error("path not found")]
    PathNotFound,
    #[error("bit-rot hash algorithm is invalid")]

View on GitHub (pinned to 5dca076efe)

Solutions

1. Retry the write and verify byte counts
2. Check disk health and free space
3. Treat the drive as suspect if partial writes recur

When it happens

Trigger: Thrown at crates/ecstore/src/error/mod.rs:84 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of rustfs/rustfs@5dca076efe (2026-08-20). Data as JSON: /api/errors/e280944d2aa87b9b. Report an issue: GitHub.