From fdcbade1275df08a262451ca97b3ff033b22ab4b Mon Sep 17 00:00:00 2001 From: Nathan Bossart Date: Thu, 8 Aug 2024 12:43:04 -0500 Subject: [PATCH v1 2/2] standardize style of CRC/SHA algorithms in docs --- doc/src/sgml/backup-manifest.sgml | 6 +++--- doc/src/sgml/pgcrypto.sgml | 4 ++-- doc/src/sgml/ref/pg_basebackup.sgml | 2 +- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/doc/src/sgml/backup-manifest.sgml b/doc/src/sgml/backup-manifest.sgml index d5ec244834..594e216bcb 100644 --- a/doc/src/sgml/backup-manifest.sgml +++ b/doc/src/sgml/backup-manifest.sgml @@ -87,10 +87,10 @@ This key is always present on the last line of the backup manifest file. - The associated value is a SHA256 checksum of all the preceding lines. + The associated value is a SHA-256 checksum of all the preceding lines. We use a fixed checksum method here to make it possible for clients - to do incremental parsing of the manifest. While a SHA256 checksum - is significantly more expensive than a CRC32C checksum, the manifest + to do incremental parsing of the manifest. While a SHA-256 checksum + is significantly more expensive than a CRC-32C checksum, the manifest should normally be small enough that the extra computation won't matter very much. diff --git a/doc/src/sgml/pgcrypto.sgml b/doc/src/sgml/pgcrypto.sgml index b8b89696e7..396c67f0cd 100644 --- a/doc/src/sgml/pgcrypto.sgml +++ b/doc/src/sgml/pgcrypto.sgml @@ -106,7 +106,7 @@ hmac(data bytea, key bytea, type text) returns bytea The algorithms in crypt() differ from the usual - MD5 or SHA1 hashing algorithms in the following respects: + MD5 or SHA-1 hashing algorithms in the following respects: @@ -525,7 +525,7 @@ gen_salt(type text [, iter_count integer ]) returns text - A SHA1 hash of the random prefix and data is appended. + A SHA-1 hash of the random prefix and data is appended. diff --git a/doc/src/sgml/ref/pg_basebackup.sgml b/doc/src/sgml/ref/pg_basebackup.sgml index 82d0c8e008..4f99340c1d 100644 --- a/doc/src/sgml/ref/pg_basebackup.sgml +++ b/doc/src/sgml/ref/pg_basebackup.sgml @@ -687,7 +687,7 @@ PostgreSQL documentation Using a SHA hash function provides a cryptographically secure digest of each file for users who wish to verify that the backup has not been - tampered with, while the CRC32C algorithm provides a checksum that is + tampered with, while the CRC-32C algorithm provides a checksum that is much faster to calculate; it is good at catching errors due to accidental changes but is not resistant to malicious modifications. Note that, to be useful against an adversary who has access to the backup, the backup -- 2.39.3 (Apple Git-146)