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

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

#604 in Command line utilities

Download history 75/week @ 2024-01-29 107/week @ 2024-02-05 9/week @ 2024-02-12 88/week @ 2024-02-19 71/week @ 2024-02-26 141/week @ 2024-03-04 189/week @ 2024-03-11 198/week @ 2024-03-18 202/week @ 2024-03-25 264/week @ 2024-04-01 102/week @ 2024-04-08 57/week @ 2024-04-15

638 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

~4–11MB
~119K SLoC