pgsql: doc: Document overflow handling of pg_class.relpages etc.

From: Peter Eisentraut <peter(at)eisentraut(dot)org>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: doc: Document overflow handling of pg_class.relpages etc.
Date: 2026-08-25 06:45:22
Message-ID: E1wykuP-0000000214n-1pc4@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

doc: Document overflow handling of pg_class.relpages etc.

The pg_class fields relpages, relallvisible, and relallfrozen are
stored as int32 in the catalog but block numbers are internally of
type uint32. This all works correctly because the values are
implicitly converted back and forth according to C conversion rules.
But this was apparently never explicitly documented, so add this.

Reviewed-by: Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com>
Discussion: https://www.postgresql.org/message-id/flat/db993f34-e3e1-4e6e-85c3-4f248d2ff29b%40eisentraut.org

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/e63961d7c16f7df5ba4b881f4bfa7a7920c628bd

Modified Files
--------------
doc/src/sgml/catalogs.sgml | 12 ++++++++++++
1 file changed, 12 insertions(+)

Browse pgsql-committers by date

  From Date Subject
Next Message Peter Eisentraut 2026-08-25 08:01:39 pgsql: Fix accidentally casting away const
Previous Message Richard Guo 2026-08-25 01:50:15 pgsql: Fix CPU cost of right-semi and right-anti hash joins