]> git.ipfire.org Git - thirdparty/coreutils.git/commitdiff
doc: shred: mention unsupported file types
authorCollin Funk <collin.funk1@gmail.com>
Wed, 13 May 2026 01:35:28 +0000 (18:35 -0700)
committerCollin Funk <collin.funk1@gmail.com>
Thu, 14 May 2026 03:45:47 +0000 (20:45 -0700)
* src/shred.c (usage): Mention the behavior of 'shred' on FIFOs,
sockets, and terminals.
* doc/coreutils.texi (shred invocation): Likewise.
Addresses https://bugs.gnu.org/30177

doc/coreutils.texi
src/shred.c

index a37b63388e58f98595af1553d522e9a938dad0a3..fb12856daa04fda1f44aa5c2ed32f5d36fc9eb08 100644 (file)
@@ -10372,6 +10372,10 @@ to destroy using @command{shred}, be sure that it is not backed up or mirrored.
 shred [@var{option}]@dots{} @var{file}[@dots{}]
 @end example
 
+If @var{file} is a FIFO, socket, or terminal, @command{shred} skips it
+and emit a diagnostic message because the contents of these file types
+do not reside on disk.
+
 The program accepts the following options.  Also see @ref{Common options}.
 
 @table @samp
index 316268691f83fef3ae4bd2923edb6c9f5d83dd7e..a0b7089f5b8d498839bec1a58613a5f9b88dbd49 100644 (file)
@@ -220,6 +220,11 @@ If FILE is -, shred standard output.\n\
       oputs (VERSION_OPTION_DESCRIPTION);
       fputs (_("\
 \n\
+FILE will be skipped with a diagnostic message if it is a FIFO, socket, or\n\
+terminal, since its data does not reside on disk.\n\
+"), stdout);
+      fputs (_("\
+\n\
 Delete FILE(s) if --remove (-u) is specified.  The default is not to remove\n\
 the files because it is common to operate on device files like /dev/hda,\n\
 and those files usually should not be removed.\n\