1. Forum
  2. Usenet
  3. LINUX.GENTOO.DEV

  • [gentoo-dev] [PATCH 0/3] glep-0074: Explicitly specify hashes and compr

    From =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?@21:1/5 to All on Sun Sep 11 15:20:01 2022
    Hi,

    Here's a batch of three followup patches to GLEP 74 (Manifest),
    to be reviewed separately from the previous set:

    1. Add a changelog to the GLEP.
    2. Explicitly list supported hash algorithms.
    3. Explicitly list supported compressed Manifest formats.


    Originally I didn't want to include these lists in GLEP 74 because
    I didn't want to update the spec whenever we were to add a new hash.
    However, from retrospective this seems wrong. In the end, new hashes
    are not something that happens every month (we didn't add any since
    the GLEP was published) and updating the GLEP is relatively cheap.
    At the same time, having a formal, well-defined list of algorithms
    is good for interoperability.

    I have also considered the option of listing the algorithms
    in a separate GLEP but I think this option would only cause unnecessary confusion.

    --
    Best regards,
    Michał Górny

    Michał Górny (3):
    glep-0074: Add a changelog
    glep-0074: Specify supported hash algorithms
    glep-0074: Specify compressed file formats

    glep-0074.rst | 220 ++++++++++++++++++++++++++++++++++++--------------
    1 file changed, 161 insertions(+), 59 deletions(-)

    --
    2.37.3

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?@21:1/5 to All on Sun Sep 11 15:20:02 2022
    Signed-off-by: Michał Górny <mgorny@gentoo.org>
    ---
    glep-0074.rst | 82 ++++++++++++++++++++++++++++++++++++++++++++-------
    1 file changed, 72 insertions(+), 10 deletions(-)

    diff --git a/glep-0074.rst b/glep-0074.rst
    index 33f6f80..6deeaf8 100644
    --- a/glep-0074.rst
    +++ b/glep-0074.rst
    @@ -27,7 +27,8 @@ Changes
    =======

    v1.3
    - Formally specified the current set of hash algorithms supported.
    + Formally specified the current set of hash algorithms and compressed
    + Manifest formats supported.

    v1.2
    Specified the newline convention used for Manifests.
    @@ -422,9 +423,8 @@ compression and this specification.

    The compressed Manifest files are required to be suffixed for their
    compression algorithm. This suffix should be used to recognize
    -the compression and decompress Manifests transparently. The exact list
    -of algorithms and their corresponding suffixes are outside the scope
    -of this specification.
    +the compression and decompress Manifests transparently. The supported
    +formats are specified in `compressed file formats`_ s
  • From =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?@21:1/5 to All on Sun Sep 11 15:20:02 2022
    Replace the informational hash name section with a formal specification
    of allowed hash algorithms. The original reasoning for leaving them implementation-defined was poor. After all, not a single new hash
    was added since the initial version of the GLEP. At the same time,
    ensuring consistent support for at least a minimal set of hash
    algorithms is crucial to interoperability. Given that the effort needed
    to update the GLEP is relatively small, it is better to require all
    algorithms to be formally listed than to have to track all
    implementations for new hashes and hope for consistency.

    Signed-off-by: Michał Górny <mgorny@gentoo.org>
    ---
    glep-0074.rst | 125 +++++++++++++++++++++++++++++++-------------------
    1 file changed, 77 insertions(+), 48 deletions(-)

    diff --git a/glep-0074.rst b/glep-0074.rst
    index 8cec618..33f6f80 100644
    --- a/glep-0074.rst
    +++ b/glep-0074.rst
    @@ -6,7 +6,7 @@ Author: Michał Górny <mgorny@gentoo.org>,
    Ulrich Müller <ulm@gentoo.org>
    Type: Standards Track
    Status: Final
    -Version: 1.2
    +Version: 1.3
    Created: 2017-10-21
    Last-Modified: 2022-09-11
    Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08, 2022-09-11
    @@ -26,6 +26,9 @@ efficient and provide means of backwards compatibility.
    Changes
    =======

    +v1.3
    + Formally specified the current set of hash algorithms supported.
    +
    v1.2
    Specified the newline convention used for Manifests.

    @@ -364,27 +367,50 @@ up to and including the *original* directory. Note that those
    sub-Manifests can use different filenames than ``Manifest``.


    -Checksum algorithms (informational)
    ------------------------------------
    -
    -Thi