From unknown Fri Jun 13 11:17:07 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#35438 <35438@debbugs.gnu.org> To: bug#35438 <35438@debbugs.gnu.org> Subject: Status: [PATCH v2] Document IBM Z environment variables Reply-To: bug#35438 <35438@debbugs.gnu.org> Date: Fri, 13 Jun 2025 18:17:07 +0000 retitle 35438 [PATCH v2] Document IBM Z environment variables reassign 35438 gzip submitter 35438 Ilya Leoshkevich severity 35438 normal tag 35438 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 26 10:32:44 2019 Received: (at submit) by debbugs.gnu.org; 26 Apr 2019 14:32:44 +0000 Received: from localhost ([127.0.0.1]:33343 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hK1u8-000606-4Q for submit@debbugs.gnu.org; Fri, 26 Apr 2019 10:32:44 -0400 Received: from eggs.gnu.org ([209.51.188.92]:55779) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hK1u5-0005zr-Vm for submit@debbugs.gnu.org; Fri, 26 Apr 2019 10:32:42 -0400 Received: from lists.gnu.org ([209.51.188.17]:55240) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hK1u0-0005IS-PL for submit@debbugs.gnu.org; Fri, 26 Apr 2019 10:32:36 -0400 Received: from eggs.gnu.org ([209.51.188.92]:41924) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hK1tz-0000QA-GR for bug-gzip@gnu.org; Fri, 26 Apr 2019 10:32:36 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.5 required=5.0 tests=BAYES_50,KHOP_DYNAMIC, RCVD_IN_DNSWL_LOW autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hK1ty-0005Hk-Ca for bug-gzip@gnu.org; Fri, 26 Apr 2019 10:32:35 -0400 Received: from mx0b-001b2d01.pphosted.com ([148.163.158.5]:58188 helo=mx0a-001b2d01.pphosted.com) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hK1ty-0005H1-86 for bug-gzip@gnu.org; Fri, 26 Apr 2019 10:32:34 -0400 Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x3QEQOTa126697 for ; Fri, 26 Apr 2019 10:32:30 -0400 Received: from e06smtp04.uk.ibm.com (e06smtp04.uk.ibm.com [195.75.94.100]) by mx0b-001b2d01.pphosted.com with ESMTP id 2s43rhrb03-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 26 Apr 2019 10:32:30 -0400 Received: from localhost by e06smtp04.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 26 Apr 2019 15:32:29 +0100 Received: from b06cxnps3074.portsmouth.uk.ibm.com (9.149.109.194) by e06smtp04.uk.ibm.com (192.168.101.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 26 Apr 2019 15:32:26 +0100 Received: from d06av24.portsmouth.uk.ibm.com (mk.ibm.com [9.149.105.60]) by b06cxnps3074.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id x3QEWON338863078 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 26 Apr 2019 14:32:24 GMT Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 951994204B; Fri, 26 Apr 2019 14:32:24 +0000 (GMT) Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7923C42049; Fri, 26 Apr 2019 14:32:24 +0000 (GMT) Received: from white.boeblingen.de.ibm.com (unknown [9.152.98.89]) by d06av24.portsmouth.uk.ibm.com (Postfix) with ESMTP; Fri, 26 Apr 2019 14:32:24 +0000 (GMT) From: Ilya Leoshkevich To: bug-gzip@gnu.org Subject: [PATCH v2] Document IBM Z environment variables Date: Fri, 26 Apr 2019 16:32:22 +0200 X-Mailer: git-send-email 2.21.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-TM-AS-GCONF: 00 x-cbid: 19042614-0016-0000-0000-000002758DD2 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 19042614-0017-0000-0000-000032D20C0C Message-Id: <20190426143222.48887-1-iii@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-04-26_09:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=3 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1904260100 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-Received-From: 148.163.158.5 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit Cc: Ilya Leoshkevich 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: -2.3 (--) Hello, I realized I forgot to document SOURCE_DATE_EPOCH. This new patch adds the description for this environment variable. Best regards, Ilya --- IBM Z patch (7a6f9c9) introduced 6 environment variables, which are used to tune the compression and decompression with the DEFLATE COMPRESSION CALL instruction. This patch adds texinfo documentation for all of them. * doc/gzip.texi(Environment): Add DFLTCC* environment variables. --- doc/gzip.texi | 44 +++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 43 insertions(+), 1 deletion(-) diff --git a/doc/gzip.texi b/doc/gzip.texi index a6d9896..fd2075d 100644 --- a/doc/gzip.texi +++ b/doc/gzip.texi @@ -69,7 +69,7 @@ Free Documentation License''. * Sample:: Sample output from @command{gzip}. * Invoking gzip:: How to run @command{gzip}. * Advanced usage:: Concatenated files. -* Environment:: The @env{GZIP} environment variable +* Environment:: Environment variables. * Tapes:: Using @command{gzip} on tapes. * Problems:: Reporting bugs. * GNU Free Documentation License:: Copying and sharing this manual. @@ -513,6 +513,48 @@ export PATH=/usr/bin exec gzip -9 "$@@" @end example +The following environment variables are applicable only when using +@command{gzip} on IBM Z mainframes supporting DEFLATE COMPRESSION CALL +instruction: + +@table @option + +@item DFLTCC +Whether DEFLATE COMPRESSION CALL should be used. Default value is @samp{1}. +Set this to @samp{0} to disable DEFLATE COMPRESSION CALL altogether. + +@item DFLTCC_LEVEL_MASK +Compression levels on which DEFLATE COMPRESSION CALL should be used. +Represented as a bit mask in decimal or hexadecimal form, where each bit +corresponds to a compression level. Default value is @samp{2}, which means +level 1 only. In order to make use of DEFLATE COMPRESSION CALL by default, that +is, on levels 1-6, set this to @samp{0x7e}. + +@item DFLTCC_BLOCK_SIZE +Size of deflate blocks produced by DEFLATE COMPRESSION CALL in bytes in decimal +or hexadecimal form. Default value is @samp{1048576} (1 megabyte). When using +DEFLATE COMPRESSION CALL to compress a file containing heterogeneous data (e.g. +a @samp{.tar} archive containing text and binary files), setting this to a +smaller value may improve compression ratio. + +@item DFLTCC_FIRST_FHT_BLOCK_SIZE +Size of the first fixed deflate block produced by DEFLATE COMPRESSION CALL in +bytes in decimal or hexadecimal form. Default value is @samp{4096} (4 +kilobytes). When using DEFLATE COMPRESSION CALL to compress a small file, +setting this to a larger value may improve compression ratio. + +@item DFLTCC_RIBM +Value of "Reserved for IBM" field of DEFLATE COMPRESSION CALL parameter block. +Default value is @samp{0}. + +@item SOURCE_DATE_EPOCH +If set to any value, disables compression with DEFLATE COMPRESSION CALL. This +variable is normally set during reproducible builds, and in such cases DEFLATE +COMPRESSION CALL needs to be disabled, because its output may be not +reproducible. + +@end table + @node Tapes @chapter Using @command{gzip} on tapes @cindex tapes -- 2.21.0 From debbugs-submit-bounces@debbugs.gnu.org Sun Jan 05 16:56:05 2020 Received: (at 35438-done) by debbugs.gnu.org; 5 Jan 2020 21:56:05 +0000 Received: from localhost ([127.0.0.1]:44739 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ioDsT-0003Aw-I7 for submit@debbugs.gnu.org; Sun, 05 Jan 2020 16:56:05 -0500 Received: from mail-wr1-f41.google.com ([209.85.221.41]:34669) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ioDsR-0003AQ-6N for 35438-done@debbugs.gnu.org; Sun, 05 Jan 2020 16:56:04 -0500 Received: by mail-wr1-f41.google.com with SMTP id t2so47680768wrr.1 for <35438-done@debbugs.gnu.org>; Sun, 05 Jan 2020 13:56:03 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=izG0d0l9Fe1dI3qE+gEsMb2x0bu8GiPD+6bR6SZUl50=; b=h/eJsedvRV4kyDqyK1ZMykN5ZeV27nv2/PJRbKmVqnCkGLCl6RuMjLCLwTQ1QJBYYi wmchEG5kavgWRNqaB3QJieb0G0CQiTacek4EadZxWTJKDtNaAHa73xgXtex6TIZgxCqp 9RmtVRPGC8+Twa/mjDnmtGuuPiMFVtyx7BDwGtPCTG7xsFjZHmFScivAmw4YIM2bcWRT /I6qMRHMlGLg2RIxXgyqnU93O8yZQcQPu5/+7s2aAVXYejTsAtqcISnIYMXGONxqSD9B Dh5NfDFTT84cT/UK/kY25zOoare9+OblmAhrbAL8rmC4Jo9Gkkw7GJLA+IOOPGcdraRm 9kpQ== X-Gm-Message-State: APjAAAXtkdd4QFwGe5evSBAtQGhqhVrqz/KfTiR1Hg4iBTqkkavKPsTW kIM7HApN20EOAlxW7VYQMQyW4mKqcXqQ3fROe0Nu1oVi X-Google-Smtp-Source: APXvYqzifHPBvnLcm3S5HHToNhK0+1GztrL1WbtNO2myRlvmAiE0c525dD1INYgj4zsDB/3lkAAuvCS3Rb5NcP3nV+E= X-Received: by 2002:adf:f288:: with SMTP id k8mr105494952wro.301.1578261356708; Sun, 05 Jan 2020 13:55:56 -0800 (PST) MIME-Version: 1.0 From: Jim Meyering Date: Sun, 5 Jan 2020 13:55:45 -0800 Message-ID: Subject: Re: Document IBM Z environment variables To: 35438-done@debbugs.gnu.org Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 35438-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.5 (/) Re https://bugs.gnu.org/35438 Thank you. I've pushed that patch with a tiny wording change at the end. From unknown Fri Jun 13 11:17:07 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Mon, 03 Feb 2020 12:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator