Debian Codegraph @

upstream/debian-trixie/man1/shred.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH SHRED "1" "June 2025" "GNU coreutils 9.7" "User Commands"
3 .SH NAME
4 shred \- overwrite a file to hide its contents, and optionally delete it
5 .SH SYNOPSIS
6 .B shred
7 [\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
8 .SH DESCRIPTION
9 .\" Add any additional description here
10 .PP
11 Overwrite the specified FILE(s) repeatedly, in order to make it harder
12 for even very expensive hardware probing to recover the data.
13 .PP
14 If FILE is \-, shred standard output.
15 .PP
16 Mandatory arguments to long options are mandatory for short options too.
17 .TP
18 \fB\-f\fR, \fB\-\-force\fR
19 change permissions to allow writing if necessary
20 .TP
21 \fB\-n\fR, \fB\-\-iterations\fR=\fI\,N\/\fR
22 overwrite N times instead of the default (3)
23 .TP
24 \fB\-\-random\-source\fR=\fI\,FILE\/\fR
25 get random bytes from FILE
26 .TP
27 \fB\-s\fR, \fB\-\-size\fR=\fI\,N\/\fR
28 shred this many bytes (suffixes like K, M, G accepted)
29 .TP
30 \fB\-u\fR
31 deallocate and remove file after overwriting
32 .TP
33 \fB\-\-remove\fR[=\fI\,HOW\/\fR]
34 like \fB\-u\fR but give control on HOW to delete; See below
35 .TP
36 \fB\-v\fR, \fB\-\-verbose\fR
37 show progress
38 .TP
39 \fB\-x\fR, \fB\-\-exact\fR
40 do not round file sizes up to the next full block;
41 this is the default for non\-regular files
42 .TP
43 \fB\-z\fR, \fB\-\-zero\fR
44 add a final overwrite with zeros to hide shredding
45 .TP
46 \fB\-\-help\fR
47 display this help and exit
48 .TP
49 \fB\-\-version\fR
50 output version information and exit
51 .PP
52 Delete FILE(s) if \fB\-\-remove\fR (\fB\-u\fR) is specified. The default is not to remove
53 the files because it is common to operate on device files like \fI\,/dev/hda\/\fP,
54 and those files usually should not be removed.
55 The optional HOW parameter indicates how to remove a directory entry:
56 \&'unlink' => use a standard unlink call.
57 \&'wipe' => also first obfuscate bytes in the name.
58 \&'wipesync' => also sync each obfuscated byte to the device.
59 The default mode is 'wipesync', but note it can be expensive.
60 .PP
61 CAUTION: shred assumes the file system and hardware overwrite data in place.
62 Although this is common, many platforms operate otherwise. Also, backups
63 and mirrors may contain unremovable copies that will let a shredded file
64 be recovered later. See the GNU coreutils manual for details.
65 .SH AUTHOR
66 Written by Colin Plumb.
67 .SH "REPORTING BUGS"
68 GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
69 .br
70 Report any translation bugs to <https://translationproject.org/team/>
71 .SH "SEE ALSO"
72 Full documentation <https://www.gnu.org/software/coreutils/shred>
73 .br
74 or available locally via: info \(aq(coreutils) shred invocation\(aq
75 .PP
76 .br
77 Packaged by Debian (9.7\-3)
78 .br
79 Copyright \(co 2025 Free Software Foundation, Inc.
80 .br
81 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
82 .br
83 This is free software: you are free to change and redistribute it.
84 .br
85 There is NO WARRANTY, to the extent permitted by law.