From 7e272c3147f82d46c5d1bd3699a4ea1175526a09 Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 17:07:34 -0400 Subject: [PATCH 01/11] Empty list --- docs/0001-digest-algorithms.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/0001-digest-algorithms.md diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md new file mode 100644 index 0000000..0d4db1c --- /dev/null +++ b/docs/0001-digest-algorithms.md @@ -0,0 +1,21 @@ +# OCFL Community Extension 0001: Digest Algorithms + + * Authors: OCFL Editors + * Obsoletes: n/a + * Obsoleted by: n/a + +## Overview + +This extension is an index of additional digest algorithms that are defined in community extensions. It provides a list of digest algorithm names that may be used to indicate the given algorith in `fixity` blocks of OCFL Objects, and links their defining extensions. + +## Digest Algorithms Defined in Community Extensions + +------------------------------------------------------ +| Digest Algorithm Name | Community Extension | Note | +------------------------------------------------------ +| ... none yet ... | | | +------------------------------------------------------ + +## Maintenance + +In order to have an additional digest algorithm listed here, please submit an extension describing it and with a name that does not conflict with those defined in the OCFL Specification or in other community extensions, and is preferably in common use for the given algorithm. From 3585a10f8cebe243794cfc8c84b5d2bbb703599a Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 17:15:20 -0400 Subject: [PATCH 02/11] Add OCFL version --- docs/0000-example-extension.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/0000-example-extension.md b/docs/0000-example-extension.md index a41d6b4..4411ae8 100644 --- a/docs/0000-example-extension.md +++ b/docs/0000-example-extension.md @@ -1,6 +1,7 @@ # OCFL Community Extension 0000: Example Extension * Authors: A Person, Other Person + * OCFL Version: 1.0 * Obsoletes: n/a * Obsoleted by: n/a From 522f521ad07f16520369219404d13686da356bec Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 17:16:38 -0400 Subject: [PATCH 03/11] Add to index, indicate OCFL version 1.0 --- docs/0001-digest-algorithms.md | 1 + docs/index.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md index 0d4db1c..c1d0c97 100644 --- a/docs/0001-digest-algorithms.md +++ b/docs/0001-digest-algorithms.md @@ -1,6 +1,7 @@ # OCFL Community Extension 0001: Digest Algorithms * Authors: OCFL Editors + * OCFL Version: 1.0 * Obsoletes: n/a * Obsoleted by: n/a diff --git a/docs/index.md b/docs/index.md index f4cde01..2183bad 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,3 +1,3 @@ # OCFL Community Extensions - * [0000: Example Extension](0000-example-extension) \ No newline at end of file + * [0001: Digest Algorithms](0001-digest-algorithms) \ No newline at end of file From d6a7de44cfc4cd98165ca7df6ace23e8105111ff Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 18:13:43 -0400 Subject: [PATCH 04/11] Fixes requests plus additions of blake2b and sha512/256 algorithms --- docs/0001-digest-algorithms.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md index c1d0c97..b7ff29a 100644 --- a/docs/0001-digest-algorithms.md +++ b/docs/0001-digest-algorithms.md @@ -7,16 +7,19 @@ ## Overview -This extension is an index of additional digest algorithms that are defined in community extensions. It provides a list of digest algorithm names that may be used to indicate the given algorith in `fixity` blocks of OCFL Objects, and links their defining extensions. +This extension is an index of additional digest algorithms that are defined in community extensions. It provides a controlled vocabulary of digest algorithm names that may be used to indicate the given algorithm in `fixity` blocks of OCFL Objects, and links their defining extensions. ## Digest Algorithms Defined in Community Extensions ------------------------------------------------------- -| Digest Algorithm Name | Community Extension | Note | ------------------------------------------------------- -| ... none yet ... | | | ------------------------------------------------------- +-------------------------------- +| Digest Algorithm Name | Note | +-------------------------------- +| blake2b-160 | BLAKE2 digest using the 2B variant (64 bit) with size 160 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://ocfl.io/0.3/spec/#bib-rfc4648). For example, the blake2b-160 digest of a zero-length bitstream is `3345524abf6bbe1809449224b5972c41790b6cf2` (40 hex digits long). | +| blake2b-256 | BLAKE2 digest using the 2B variant (64 bit) with size 256 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://ocfl.io/0.3/spec/#bib-rfc4648). For example, the blake2b-256 digest of a zero-length bitstream starts as follows `0e5751c026e543b2e8ab2eb06099daa1d1e5df47...` (64 hex digits long). | +| blake2b-384 | BLAKE2 digest using the 2B variant (64 bit) with size 384 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://ocfl.io/0.3/spec/#bib-rfc4648). For example, the blake2b-384 digest of a zero-length bitstream starts as follows `b32811423377f52d7862286ee1a72ee540524380...` (96 hex digits long). | +| sha512/256 | SHA-512 algorithm with 256 output as defined by [FIPS-180-4]. MUST be encoded using hex (base16) encoding [RFC4648](https://ocfl.io/0.3/spec/#bib-rfc4648). For example, the sha512 digest of a zero-length bitstream starts `c672b8d1ef56ed28ab87c3622c5114069bdd3ad7...` (64 hex digits long). | +-------------------------------- ## Maintenance -In order to have an additional digest algorithm listed here, please submit an extension describing it and with a name that does not conflict with those defined in the OCFL Specification or in other community extensions, and is preferably in common use for the given algorithm. +In order to have an additional digest algorithm listed here, please submit a pull request on this extension that adds it to the table. New entries should have a name that does not conflict with those defined in the OCFL Specification or this community extension, and is preferably in common use for the given algorithm. In the case that long description is required it may be appropriate to submit a new extension describing the algorithm along with an update to this extension that links to it. From cc547ca216a8f2f05f384d385ae99dbb4f3b7d8b Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 18:15:24 -0400 Subject: [PATCH 05/11] minimum ocfl version --- docs/0000-example-extension.md | 2 +- docs/0001-digest-algorithms.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/0000-example-extension.md b/docs/0000-example-extension.md index 4411ae8..38eca6f 100644 --- a/docs/0000-example-extension.md +++ b/docs/0000-example-extension.md @@ -1,7 +1,7 @@ # OCFL Community Extension 0000: Example Extension * Authors: A Person, Other Person - * OCFL Version: 1.0 + * Minimum OCFL Version: 1.0 * Obsoletes: n/a * Obsoleted by: n/a diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md index b7ff29a..43c007c 100644 --- a/docs/0001-digest-algorithms.md +++ b/docs/0001-digest-algorithms.md @@ -1,7 +1,7 @@ # OCFL Community Extension 0001: Digest Algorithms * Authors: OCFL Editors - * OCFL Version: 1.0 + * Minimum OCFL Version: 1.0 * Obsoletes: n/a * Obsoleted by: n/a From 8ae66e953c50619801ad2d9bd3038c2516f34965 Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 18:17:01 -0400 Subject: [PATCH 06/11] Fix refs --- docs/0001-digest-algorithms.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md index 43c007c..2e059d0 100644 --- a/docs/0001-digest-algorithms.md +++ b/docs/0001-digest-algorithms.md @@ -14,10 +14,10 @@ This extension is an index of additional digest algorithms that are defined in c -------------------------------- | Digest Algorithm Name | Note | -------------------------------- -| blake2b-160 | BLAKE2 digest using the 2B variant (64 bit) with size 160 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://ocfl.io/0.3/spec/#bib-rfc4648). For example, the blake2b-160 digest of a zero-length bitstream is `3345524abf6bbe1809449224b5972c41790b6cf2` (40 hex digits long). | -| blake2b-256 | BLAKE2 digest using the 2B variant (64 bit) with size 256 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://ocfl.io/0.3/spec/#bib-rfc4648). For example, the blake2b-256 digest of a zero-length bitstream starts as follows `0e5751c026e543b2e8ab2eb06099daa1d1e5df47...` (64 hex digits long). | -| blake2b-384 | BLAKE2 digest using the 2B variant (64 bit) with size 384 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://ocfl.io/0.3/spec/#bib-rfc4648). For example, the blake2b-384 digest of a zero-length bitstream starts as follows `b32811423377f52d7862286ee1a72ee540524380...` (96 hex digits long). | -| sha512/256 | SHA-512 algorithm with 256 output as defined by [FIPS-180-4]. MUST be encoded using hex (base16) encoding [RFC4648](https://ocfl.io/0.3/spec/#bib-rfc4648). For example, the sha512 digest of a zero-length bitstream starts `c672b8d1ef56ed28ab87c3622c5114069bdd3ad7...` (64 hex digits long). | +| blake2b-160 | BLAKE2 digest using the 2B variant (64 bit) with size 160 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-160 digest of a zero-length bitstream is `3345524abf6bbe1809449224b5972c41790b6cf2` (40 hex digits long). | +| blake2b-256 | BLAKE2 digest using the 2B variant (64 bit) with size 256 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-256 digest of a zero-length bitstream starts as follows `0e5751c026e543b2e8ab2eb06099daa1d1e5df47...` (64 hex digits long). | +| blake2b-384 | BLAKE2 digest using the 2B variant (64 bit) with size 384 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-384 digest of a zero-length bitstream starts as follows `b32811423377f52d7862286ee1a72ee540524380...` (96 hex digits long). | +| sha512/256 | SHA-512 algorithm with 256 output as defined by [FIPS-180-4](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the sha512 digest of a zero-length bitstream starts `c672b8d1ef56ed28ab87c3622c5114069bdd3ad7...` (64 hex digits long). | -------------------------------- ## Maintenance From ea622552ff3493fd0391fb0a6d8597ebb1da603f Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 18:35:43 -0400 Subject: [PATCH 07/11] Code font algorithm names --- docs/0001-digest-algorithms.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md index 2e059d0..842952d 100644 --- a/docs/0001-digest-algorithms.md +++ b/docs/0001-digest-algorithms.md @@ -14,10 +14,10 @@ This extension is an index of additional digest algorithms that are defined in c -------------------------------- | Digest Algorithm Name | Note | -------------------------------- -| blake2b-160 | BLAKE2 digest using the 2B variant (64 bit) with size 160 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-160 digest of a zero-length bitstream is `3345524abf6bbe1809449224b5972c41790b6cf2` (40 hex digits long). | -| blake2b-256 | BLAKE2 digest using the 2B variant (64 bit) with size 256 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-256 digest of a zero-length bitstream starts as follows `0e5751c026e543b2e8ab2eb06099daa1d1e5df47...` (64 hex digits long). | -| blake2b-384 | BLAKE2 digest using the 2B variant (64 bit) with size 384 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-384 digest of a zero-length bitstream starts as follows `b32811423377f52d7862286ee1a72ee540524380...` (96 hex digits long). | -| sha512/256 | SHA-512 algorithm with 256 output as defined by [FIPS-180-4](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the sha512 digest of a zero-length bitstream starts `c672b8d1ef56ed28ab87c3622c5114069bdd3ad7...` (64 hex digits long). | +| 'blake2b-160' | BLAKE2 digest using the 2B variant (64 bit) with size 160 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-160 digest of a zero-length bitstream is `3345524abf6bbe1809449224b5972c41790b6cf2` (40 hex digits long). | +| 'blake2b-256' | BLAKE2 digest using the 2B variant (64 bit) with size 256 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-256 digest of a zero-length bitstream starts as follows `0e5751c026e543b2e8ab2eb06099daa1d1e5df47...` (64 hex digits long). | +| 'blake2b-384' | BLAKE2 digest using the 2B variant (64 bit) with size 384 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-384 digest of a zero-length bitstream starts as follows `b32811423377f52d7862286ee1a72ee540524380...` (96 hex digits long). | +| 'sha512/256' | SHA-512 algorithm with 256 output as defined by [FIPS-180-4](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the sha512 digest of a zero-length bitstream starts `c672b8d1ef56ed28ab87c3622c5114069bdd3ad7...` (64 hex digits long). | -------------------------------- ## Maintenance From 5b5304d1a88740ff0f4fffe4dcdd69f325d0b668 Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 19:14:57 -0400 Subject: [PATCH 08/11] Tick the ticks the right way --- docs/0001-digest-algorithms.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md index 842952d..4c2889f 100644 --- a/docs/0001-digest-algorithms.md +++ b/docs/0001-digest-algorithms.md @@ -14,10 +14,10 @@ This extension is an index of additional digest algorithms that are defined in c -------------------------------- | Digest Algorithm Name | Note | -------------------------------- -| 'blake2b-160' | BLAKE2 digest using the 2B variant (64 bit) with size 160 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-160 digest of a zero-length bitstream is `3345524abf6bbe1809449224b5972c41790b6cf2` (40 hex digits long). | -| 'blake2b-256' | BLAKE2 digest using the 2B variant (64 bit) with size 256 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-256 digest of a zero-length bitstream starts as follows `0e5751c026e543b2e8ab2eb06099daa1d1e5df47...` (64 hex digits long). | -| 'blake2b-384' | BLAKE2 digest using the 2B variant (64 bit) with size 384 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the blake2b-384 digest of a zero-length bitstream starts as follows `b32811423377f52d7862286ee1a72ee540524380...` (96 hex digits long). | -| 'sha512/256' | SHA-512 algorithm with 256 output as defined by [FIPS-180-4](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the sha512 digest of a zero-length bitstream starts `c672b8d1ef56ed28ab87c3622c5114069bdd3ad7...` (64 hex digits long). | +| `blake2b-160` | BLAKE2 digest using the 2B variant (64 bit) with size 160 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `blake2b-160` digest of a zero-length bitstream is `3345524abf6bbe1809449224b5972c41790b6cf2` (40 hex digits long). | +| `blake2b-256` | BLAKE2 digest using the 2B variant (64 bit) with size 256 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `blake2b-256` digest of a zero-length bitstream starts as follows `0e5751c026e543b2e8ab2eb06099daa1d1e5df47...` (64 hex digits long). | +| `blake2b-384` | BLAKE2 digest using the 2B variant (64 bit) with size 384 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `blake2b-384` digest of a zero-length bitstream starts as follows `b32811423377f52d7862286ee1a72ee540524380...` (96 hex digits long). | +| `sha512/256` | SHA-512 algorithm with 256 output as defined by [FIPS-180-4](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `sha512/256` digest of a zero-length bitstream starts `c672b8d1ef56ed28ab87c3622c5114069bdd3ad7...` (64 hex digits long). | -------------------------------- ## Maintenance From 4a3029be596bffacf4c1e6cf039328ae4020d038 Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 19:20:51 -0400 Subject: [PATCH 09/11] Remove redundant text --- docs/0001-digest-algorithms.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md index 4c2889f..fa5c988 100644 --- a/docs/0001-digest-algorithms.md +++ b/docs/0001-digest-algorithms.md @@ -7,7 +7,7 @@ ## Overview -This extension is an index of additional digest algorithms that are defined in community extensions. It provides a controlled vocabulary of digest algorithm names that may be used to indicate the given algorithm in `fixity` blocks of OCFL Objects, and links their defining extensions. +This extension is an index of additional digest algorithms. It provides a controlled vocabulary of digest algorithm names that may be used to indicate the given algorithm in `fixity` blocks of OCFL Objects, and links their defining extensions. ## Digest Algorithms Defined in Community Extensions From 3bf19c5ad42679efe5bc73b2281d67fef7ed585c Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 19:22:30 -0400 Subject: [PATCH 10/11] Fix table --- docs/0001-digest-algorithms.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md index fa5c988..ce03251 100644 --- a/docs/0001-digest-algorithms.md +++ b/docs/0001-digest-algorithms.md @@ -11,14 +11,14 @@ This extension is an index of additional digest algorithms. It provides a contro ## Digest Algorithms Defined in Community Extensions --------------------------------- +|-----------------------|------| | Digest Algorithm Name | Note | --------------------------------- +|-----------------------|------| | `blake2b-160` | BLAKE2 digest using the 2B variant (64 bit) with size 160 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `blake2b-160` digest of a zero-length bitstream is `3345524abf6bbe1809449224b5972c41790b6cf2` (40 hex digits long). | | `blake2b-256` | BLAKE2 digest using the 2B variant (64 bit) with size 256 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `blake2b-256` digest of a zero-length bitstream starts as follows `0e5751c026e543b2e8ab2eb06099daa1d1e5df47...` (64 hex digits long). | | `blake2b-384` | BLAKE2 digest using the 2B variant (64 bit) with size 384 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `blake2b-384` digest of a zero-length bitstream starts as follows `b32811423377f52d7862286ee1a72ee540524380...` (96 hex digits long). | | `sha512/256` | SHA-512 algorithm with 256 output as defined by [FIPS-180-4](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `sha512/256` digest of a zero-length bitstream starts `c672b8d1ef56ed28ab87c3622c5114069bdd3ad7...` (64 hex digits long). | --------------------------------- +|-----------------------|------| ## Maintenance From bb1b068a4c6b71f24ae9ced5367bbed0b6d7c52f Mon Sep 17 00:00:00 2001 From: Simeon Warner Date: Thu, 3 Oct 2019 19:25:40 -0400 Subject: [PATCH 11/11] gfm table syntax --- docs/0001-digest-algorithms.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/0001-digest-algorithms.md b/docs/0001-digest-algorithms.md index ce03251..02fb802 100644 --- a/docs/0001-digest-algorithms.md +++ b/docs/0001-digest-algorithms.md @@ -11,15 +11,13 @@ This extension is an index of additional digest algorithms. It provides a contro ## Digest Algorithms Defined in Community Extensions -|-----------------------|------| | Digest Algorithm Name | Note | -|-----------------------|------| +| --------------------- | ---- | | `blake2b-160` | BLAKE2 digest using the 2B variant (64 bit) with size 160 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `blake2b-160` digest of a zero-length bitstream is `3345524abf6bbe1809449224b5972c41790b6cf2` (40 hex digits long). | | `blake2b-256` | BLAKE2 digest using the 2B variant (64 bit) with size 256 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `blake2b-256` digest of a zero-length bitstream starts as follows `0e5751c026e543b2e8ab2eb06099daa1d1e5df47...` (64 hex digits long). | | `blake2b-384` | BLAKE2 digest using the 2B variant (64 bit) with size 384 bits as defined by [RFC7693](https://tools.ietf.org/html/rfc7693). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `blake2b-384` digest of a zero-length bitstream starts as follows `b32811423377f52d7862286ee1a72ee540524380...` (96 hex digits long). | | `sha512/256` | SHA-512 algorithm with 256 output as defined by [FIPS-180-4](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf). MUST be encoded using hex (base16) encoding [RFC4648](https://tools.ietf.org/html/rfc4648). For example, the `sha512/256` digest of a zero-length bitstream starts `c672b8d1ef56ed28ab87c3622c5114069bdd3ad7...` (64 hex digits long). | -|-----------------------|------| ## Maintenance -In order to have an additional digest algorithm listed here, please submit a pull request on this extension that adds it to the table. New entries should have a name that does not conflict with those defined in the OCFL Specification or this community extension, and is preferably in common use for the given algorithm. In the case that long description is required it may be appropriate to submit a new extension describing the algorithm along with an update to this extension that links to it. +In order to have an additional digest algorithm listed here, please submit a pull request on this extension that adds it to the table. New entries should have a name that does not conflict with those defined in the [OCFL Specification](https://ocfl.io/latest/spec/) or this community extension, and is preferably in common use for the given algorithm. In the case that long description is required it may be appropriate to submit a new extension describing the algorithm along with an update to this extension that links to it.