{"record":{"id":"21d6b34aa94b27f2","repo":"rustfs/rustfs","slug":"drive-is-part-of-root-drive-will-not-be-used","errorCode":null,"errorMessage":"drive is part of root drive, will not be used","messagePattern":"drive is part of root drive, will not be used","errorType":"exception","errorClass":"DiskError","httpStatus":null,"severity":"error","filePath":"crates/ecstore/src/disk/error.rs","lineNumber":62,"sourceCode":"// DiskError == StorageErr\n#[derive(Debug, thiserror::Error)]\npub enum DiskError {\n    #[error(\"maximum versions exceeded, please delete few versions to proceed\")]\n    MaxVersionsExceeded,\n\n    #[error(\"unexpected error\")]\n    Unexpected,\n\n    #[error(\"corrupted format\")]\n    CorruptedFormat,\n\n    #[error(\"corrupted backend\")]\n    CorruptedBackend,\n\n    #[error(\"unformatted disk error\")]\n    UnformattedDisk,\n\n    #[error(\"inconsistent drive found\")]\n    InconsistentDisk,\n\n    #[error(\"drive does not support O_DIRECT\")]\n    UnsupportedDisk,\n\n    #[error(\"drive path full\")]\n    DiskFull,\n\n    #[error(\"disk not a dir\")]\n    DiskNotDir,\n\n    #[error(\"disk not found\")]\n    DiskNotFound,\n\n    #[error(\"drive still did not complete the request\")]\n    DiskOngoingReq,\n\n    #[error(\"drive is part of root drive, will not be used\")]","sourceCodeStart":44,"sourceCodeEnd":80,"githubUrl":"https://github.com/rustfs/rustfs/blob/5dca076efed96e7b842de07c4c2111035ae7c7a2/crates/ecstore/src/disk/error.rs#L44-L80","documentation":"DriveIsRoot is a DiskError sentinel: the candidate drive path resolves to (or lies on) the server's root drive/device. RustFS deliberately refuses to store erasure data on the OS root drive to protect the system volume.","triggerScenarios":"Thrown at crates/ecstore/src/disk/error.rs:62 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Dedicate separate block devices to the erasure set","Update drive configuration to exclude the root device","This refusal is intentional; do not override it"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"5dca076efed96e7b842de07c4c2111035ae7c7a2","analyzedAt":"2026-08-20T21:57:04.799Z","contentChangedAt":"2026-08-20T21:57:04.799Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}