sys-shred 1.0.0

A forensic-grade, multi-threaded command-line utility for secure file erasure and anti-forensics.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! # Secure Unlinking
//!
//! Handles the final removal of the file entry from the filesystem's
//! directory structure.

use crate::error::ShredResult;
use std::fs;
use std::path::Path;

/// A utility for performing secure file unlinking (deletion).
pub struct Unlinker;

impl Unlinker {
    /// Permanently removes the file entry from the filesystem.
    ///
    /// This is the final step in the shredding process, performed only after
    /// the data has been overwritten and the metadata has been obfuscated.
    ///
    /// # Arguments
    ///
    /// * `path` - The `Path` to the file to be unlinked.
    ///
    /// # Errors
    ///
    /// Returns `ShredError::Io` if the file cannot be removed (e.g., due to
    /// permission constraints).
    pub fn unlink(path: &Path) -> ShredResult<()> {
        if path.exists() {
            fs::remove_file(path)?;
        }
        Ok(())
    }
}