#delete-file #file #file-content #data #deletion #rename #overwrite

bin+lib file_shred

Library and binary to securily delete files, overwriting and moving them before removal

4 stable releases

1.1.3 Apr 28, 2023
1.1.2 Mar 26, 2023
1.1.0 Apr 18, 2020
1.0.0 Mar 29, 2020

#1300 in Command line utilities

Download history 180/week @ 2024-07-24 134/week @ 2024-07-31 151/week @ 2024-08-07 131/week @ 2024-08-14 127/week @ 2024-08-21 106/week @ 2024-08-28 135/week @ 2024-09-04 109/week @ 2024-09-11 195/week @ 2024-09-18 123/week @ 2024-09-25 163/week @ 2024-10-02 271/week @ 2024-10-09 255/week @ 2024-10-16 245/week @ 2024-10-23 283/week @ 2024-10-30 255/week @ 2024-11-06

1,112 downloads per month
Used in file_endec

BSD-3-Clause

32KB
801 lines

Tests

Dependencies

File shred

Command line utility that safely deletes files.

Functionality

  • Repeatedly overwrite the file content with random data and specific patterns.
  • Rename repeatedly to hide that the file ever existed.
  • Remove access- and modification time.
  • Truncate then delete the file.

In Docker

Run the shredder with Docker:

docker run --rm -it -v "$(pwd):/data" mverleg/file-shred -- file.txt

You can mount any directory in which you want to shred files; the above example uses the current directory $(pwd).

To build the image yourself (instead of downloading from Dockerhub), clone the Github project and run:

docker build -t mverleg/file-shred .

This will also run the tests and lints, to verify that your version is okay.

As binary

You can shred files like

shred file.txt image.png /tmp/stuff/*

There are command line options for various things::

USAGE:
    shred [FLAGS] [OPTIONS] <FILES>...

FLAGS:
    -v, --debug         Show debug information, especially on errors.
    -h, --help          Prints help information
    -k, --keep          Destroy the data, but do not rename or delete the file. Useful for non-regular files like special system devices.
    -y, --no-confirm   Delete files without asking for confirmation.
    -q, --quiet         Do not show progress or other non-critical output.
    -V, --version       Prints version information

OPTIONS:
        --overwrite-count <overwrite-count>    Number of times the file is overwritten (at least 1). [default: 10]
        --rename-count <rename-count>          Number of times the file is renamed.

As library

  • Create an instance of ::file_shred::ShredConfig, options largely correspond to the command-line ones.
  • In particular note confirmation_prompt=false if there might not be an interactive session present.
  • Call the ::file_shred::shred function and pass this config.

Keep in mind that:

There are no security guarantees, and the author is not a professional security expert. Use at your own risk.

  • Obviously, be careful. The purpose of this tool is to irrecoverably delete data. I cannot help you get data back if you delete it by accident.
  • Note that data recovery difficulty depends on the environment (operating system, hard disk formatting, physical medium). For some configurations, overwriting may not work.

This is used by file_endec.

Dependencies

~5–13MB
~139K SLoC