From unknown Sat Aug 16 18:32:39 2025 X-Loop: help-debbugs@gnu.org Subject: bug#29317: info shred:documentation feedback Resent-From: kalle Original-Sender: "Debbugs-submit" Resent-CC: bug-coreutils@gnu.org Resent-Date: Thu, 16 Nov 2017 10:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 29317 X-GNU-PR-Package: coreutils X-GNU-PR-Keywords: To: 29317@debbugs.gnu.org X-Debbugs-Original-To: bug-coreutils@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.15108287145999 (code B ref -1); Thu, 16 Nov 2017 10:39:02 +0000 Received: (at submit) by debbugs.gnu.org; 16 Nov 2017 10:38:34 +0000 Received: from localhost ([127.0.0.1]:42646 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eFHZ4-0001Yh-DW for submit@debbugs.gnu.org; Thu, 16 Nov 2017 05:38:34 -0500 Received: from eggs.gnu.org ([208.118.235.92]:37553) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eFHZ2-0001YU-W4 for submit@debbugs.gnu.org; Thu, 16 Nov 2017 05:38:33 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eFHYw-0007lq-Vb for submit@debbugs.gnu.org; Thu, 16 Nov 2017 05:38:27 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:57381) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eFHYw-0007lU-SB for submit@debbugs.gnu.org; Thu, 16 Nov 2017 05:38:26 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:56730) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eFHYv-0001B2-U0 for bug-coreutils@gnu.org; Thu, 16 Nov 2017 05:38:26 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eFHYt-0007cy-OA for bug-coreutils@gnu.org; Thu, 16 Nov 2017 05:38:25 -0500 Received: from mail.netzguerilla.net ([217.11.57.120]:34335) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eFHYt-0007aF-IC for bug-coreutils@gnu.org; Thu, 16 Nov 2017 05:38:23 -0500 Received: from localhost (localhost [127.0.0.1]) by mail.netzguerilla.net (Postfix) with ESMTP id 73B6E100013 for ; Thu, 16 Nov 2017 11:38:22 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at netzguerilla.net Received: from mail.netzguerilla.net ([217.11.57.120]) by localhost (sal.netzguerilla.net [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id oAO7kItXvS5m for ; Thu, 16 Nov 2017 11:38:21 +0100 (CET) Received: from [IPv6:2003:dd:ff22:fd01:226:18ff:fee1:ab1b] (p200300DDFF22FD01022618FFFEE1AB1B.dip0.t-ipconnect.de [IPv6:2003:dd:ff22:fd01:226:18ff:fee1:ab1b]) by mail.netzguerilla.net (Postfix) with ESMTPSA id 54C17100012 for ; Thu, 16 Nov 2017 11:38:21 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=projektwerkstatt.de; s=fckp; t=1510828701; bh=MQyVrsT+QPX5wfRGGtjCBZQ7KVn8nAljYxEQC4m4J4w=; h=Date:From:To:Subject:From; b=O194WPaGaqXAjiEAQ6RSvotG/Fylkgr3r4RI518jV+spw5TQ5bPaJm+AOOwm6XpyJ JbP+7EwHBX9lD9xhSVRFDihtNX7CpV0T2a9rEhq+zMIoFPW2iUbf2F5n3xGiwwpDTv OCYgy9s3bHRy9AP96vTnu7mbcq0xsV50c8sGhPRjuBPocIFzdDO3JfNOPaHqCpBPAo hIplAJP49z8vLz8c+Wh4ANFTjaiCFJXARrVxslG6WEY9N3x/9L4Yt14hGVSt0od6z0 vv70WUzhXtWNikqZq/chUITDi5MAmLULDjPeB1BhjNvYhGtY+nc01ldQJbrXg7+nJq +qoz9fCP3bTCQ== Message-ID: <5A0D78A1.80306@projektwerkstatt.de> Date: Thu, 16 Nov 2017 12:38:09 +0100 From: kalle User-Agent: Mozilla/5.0 (X11; Linux i686; rv:31.0) Gecko/20100101 Icedove/31.2.0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) hello, - at the sentence "by default does not truncate": what does truncating a file means? Could this be described better in the manual? -part "on a busy system": why is this written here? Is this a usual method to overwrite content? thanks, kalle From unknown Sat Aug 16 18:32:39 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: kalle Subject: bug#29317: closed (Re: bug#29317: info shred:documentation feedback) Message-ID: References: <18e03dc4-78e6-0fb4-cc9a-2db4099a769e@draigBrady.com> <5A0D78A1.80306@projektwerkstatt.de> X-Gnu-PR-Message: they-closed 29317 X-Gnu-PR-Package: coreutils Reply-To: 29317@debbugs.gnu.org Date: Sun, 10 Dec 2017 00:57:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1512867422-2413-1" This is a multi-part message in MIME format... ------------=_1512867422-2413-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #29317: info shred:documentation feedback which was filed against the coreutils package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 29317@debbugs.gnu.org. --=20 29317: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D29317 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1512867422-2413-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 29317-done) by debbugs.gnu.org; 10 Dec 2017 00:56:16 +0000 Received: from localhost ([127.0.0.1]:54317 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eNpuh-0000bv-Qx for submit@debbugs.gnu.org; Sat, 09 Dec 2017 19:56:16 -0500 Received: from mail.magicbluesmoke.com ([82.195.144.49]:52694) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eNpuf-0000bn-Ix for 29317-done@debbugs.gnu.org; Sat, 09 Dec 2017 19:56:14 -0500 Received: from localhost.localdomain (c-73-158-116-184.hsd1.ca.comcast.net [73.158.116.184]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.magicbluesmoke.com (Postfix) with ESMTPSA id 45B0894C4; Sun, 10 Dec 2017 00:56:12 +0000 (GMT) Subject: Re: bug#29317: info shred:documentation feedback To: kalle , 29317-done@debbugs.gnu.org References: <5A0D78A1.80306@projektwerkstatt.de> From: =?UTF-8?Q?P=c3=a1draig_Brady?= Message-ID: <18e03dc4-78e6-0fb4-cc9a-2db4099a769e@draigBrady.com> Date: Sat, 9 Dec 2017 16:56:10 -0800 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 MIME-Version: 1.0 In-Reply-To: <5A0D78A1.80306@projektwerkstatt.de> Content-Type: multipart/mixed; boundary="------------A0D25F85622653A7D9EDB885" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 29317-done X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) This is a multi-part message in MIME format. --------------A0D25F85622653A7D9EDB885 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit On 16/11/17 03:38, kalle wrote: > hello, > > - at the sentence "by default does not truncate": what does truncating a > file means? Could this be described better in the manual? > -part "on a busy system": why is this written here? Is this a usual > method to overwrite content? truncate deallocates data. remove deletes the reference to the data. I suppose truncate is to deallocate, as unlink is to remove, so the attached uses 'deallocate' instead of 'truncate'. cheers, Pádraig --------------A0D25F85622653A7D9EDB885 Content-Type: text/x-patch; name="shred-deallocate.patch" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="shred-deallocate.patch" =46rom 6150b10698a4c3757630aba76720e7262d0590bd Mon Sep 17 00:00:00 2001 From: =3D?UTF-8?q?P=3DC3=3DA1draig=3D20Brady?=3D Date: Sat, 9 Dec 2017 16:49:45 -0800 Subject: [PATCH] doc: shred: change 'truncate' to the more descriptive 'deallocate' * doc/coreutils.texi (shred invocation): s/truncate/deallocate/. * src/shred.c (usage): Likewise. Fixes https://bugs.gnu.org/29317 --- doc/coreutils.texi | 6 +++--- src/shred.c | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/coreutils.texi b/doc/coreutils.texi index ed3a633..bd766e4 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -9958,8 +9958,8 @@ destroy it. @command{shred} makes no attempt to detect or report this problem, just = as it makes no attempt to do anything about backups. However, since it is more reliable to shred devices than files, @command{shred} by default do= es -not truncate or remove the output file. This default is more suitable -for devices, which typically cannot be truncated and should not be +not deallocate or remove the output file. This default is more suitable= +for devices, which typically cannot be deallocated and should not be removed. =20 Finally, consider the risk of backups and mirrors. @@ -10016,7 +10016,7 @@ the whole file. @var{bytes} can be followed by a= size specification like @opindex --remove=3Dwipe @opindex --remove=3Dwipesync @cindex removing files after shredding -After shredding a file, truncate it (if possible) and then remove it. +After shredding a file, deallocate it (if possible) and then remove it. If a file has multiple links, only the named links will be removed. Often the file name is less sensitive than the file data, in which case the optional @var{how} parameter, supported with the long form option, diff --git a/src/shred.c b/src/shred.c index f2b5d27..b1f0b64 100644 --- a/src/shred.c +++ b/src/shred.c @@ -186,7 +186,7 @@ If FILE is -, shred standard output.\n\ -s, --size=3DN shred this many bytes (suffixes like K, M, G accepted= )\n\ "), DEFAULT_PASSES); fputs (_("\ - -u truncate and remove file after overwriting\n\ + -u deallocate and remove file after overwriting\n\ --remove[=3DHOW] like -u but give control on HOW to delete; See = below\n\ -v, --verbose show progress\n\ -x, --exact do not round file sizes up to the next full block;\n\ --=20 2.9.3 --------------A0D25F85622653A7D9EDB885-- ------------=_1512867422-2413-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 16 Nov 2017 10:38:34 +0000 Received: from localhost ([127.0.0.1]:42646 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eFHZ4-0001Yh-DW for submit@debbugs.gnu.org; Thu, 16 Nov 2017 05:38:34 -0500 Received: from eggs.gnu.org ([208.118.235.92]:37553) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eFHZ2-0001YU-W4 for submit@debbugs.gnu.org; Thu, 16 Nov 2017 05:38:33 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eFHYw-0007lq-Vb for submit@debbugs.gnu.org; Thu, 16 Nov 2017 05:38:27 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:57381) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eFHYw-0007lU-SB for submit@debbugs.gnu.org; Thu, 16 Nov 2017 05:38:26 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:56730) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eFHYv-0001B2-U0 for bug-coreutils@gnu.org; Thu, 16 Nov 2017 05:38:26 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eFHYt-0007cy-OA for bug-coreutils@gnu.org; Thu, 16 Nov 2017 05:38:25 -0500 Received: from mail.netzguerilla.net ([217.11.57.120]:34335) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eFHYt-0007aF-IC for bug-coreutils@gnu.org; Thu, 16 Nov 2017 05:38:23 -0500 Received: from localhost (localhost [127.0.0.1]) by mail.netzguerilla.net (Postfix) with ESMTP id 73B6E100013 for ; Thu, 16 Nov 2017 11:38:22 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at netzguerilla.net Received: from mail.netzguerilla.net ([217.11.57.120]) by localhost (sal.netzguerilla.net [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id oAO7kItXvS5m for ; Thu, 16 Nov 2017 11:38:21 +0100 (CET) Received: from [IPv6:2003:dd:ff22:fd01:226:18ff:fee1:ab1b] (p200300DDFF22FD01022618FFFEE1AB1B.dip0.t-ipconnect.de [IPv6:2003:dd:ff22:fd01:226:18ff:fee1:ab1b]) by mail.netzguerilla.net (Postfix) with ESMTPSA id 54C17100012 for ; Thu, 16 Nov 2017 11:38:21 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=projektwerkstatt.de; s=fckp; t=1510828701; bh=MQyVrsT+QPX5wfRGGtjCBZQ7KVn8nAljYxEQC4m4J4w=; h=Date:From:To:Subject:From; b=O194WPaGaqXAjiEAQ6RSvotG/Fylkgr3r4RI518jV+spw5TQ5bPaJm+AOOwm6XpyJ JbP+7EwHBX9lD9xhSVRFDihtNX7CpV0T2a9rEhq+zMIoFPW2iUbf2F5n3xGiwwpDTv OCYgy9s3bHRy9AP96vTnu7mbcq0xsV50c8sGhPRjuBPocIFzdDO3JfNOPaHqCpBPAo hIplAJP49z8vLz8c+Wh4ANFTjaiCFJXARrVxslG6WEY9N3x/9L4Yt14hGVSt0od6z0 vv70WUzhXtWNikqZq/chUITDi5MAmLULDjPeB1BhjNvYhGtY+nc01ldQJbrXg7+nJq +qoz9fCP3bTCQ== Message-ID: <5A0D78A1.80306@projektwerkstatt.de> Date: Thu, 16 Nov 2017 12:38:09 +0100 From: kalle User-Agent: Mozilla/5.0 (X11; Linux i686; rv:31.0) Gecko/20100101 Icedove/31.2.0 MIME-Version: 1.0 To: bug-coreutils@gnu.org Subject: info shred:documentation feedback Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) hello, - at the sentence "by default does not truncate": what does truncating a file means? Could this be described better in the manual? -part "on a busy system": why is this written here? Is this a usual method to overwrite content? thanks, kalle ------------=_1512867422-2413-1--