diff options
| author | Tom Lane <tgl@sss.pgh.pa.us> | 2019-03-14 00:23:33 -0400 |
|---|---|---|
| committer | Tom Lane <tgl@sss.pgh.pa.us> | 2019-03-14 00:23:40 -0400 |
| commit | 401b87a24fbab7bfb48eb48050a51e033452ac6e (patch) | |
| tree | 503076a3455a314df849d95c368d250f26d850aa /doc/src | |
| parent | 364298be22090769da14aa749fe730cf16ed3c2c (diff) | |
| download | postgresql-401b87a24fbab7bfb48eb48050a51e033452ac6e.tar.gz postgresql-401b87a24fbab7bfb48eb48050a51e033452ac6e.zip | |
Sync commentary in transam.h and bki.sgml.
Commit a6417078c missed updating some comments in transam.h about
reservation of high OIDs for development purposes. Also tamp down
an over-optimistic comment there about how easy it'd be to change
FirstNormalObjectId.
Earlier, commit 09568ec3d failed to update bki.sgml for the split
between genbki.pl-assigned OIDs and those assigned during initdb.
Also fix genbki.pl so that it will complain if it overruns
that split. It's possible that doing so would have no very bad
consequences, but that's no excuse for not detecting it.
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/bki.sgml | 20 |
1 files changed, 11 insertions, 9 deletions
diff --git a/doc/src/sgml/bki.sgml b/doc/src/sgml/bki.sgml index 0dd753bc6f5..aa3d6f8e593 100644 --- a/doc/src/sgml/bki.sgml +++ b/doc/src/sgml/bki.sgml @@ -422,19 +422,21 @@ </para> <para> - The OID counter starts at 10000 at the beginning of a bootstrap run. - If a row from a source other than <filename>postgres.bki</filename> - is inserted into a table that requires OIDs, then it will receive an - OID of 10000 or above. For example, objects created while running - the <filename>information_schema.sql</filename> script receive such - OIDs. + If <filename>genbki.pl</filename> needs to assign an OID to a catalog + entry that does not have a manually-assigned OID, it will use a value in + the range 10000—11999. The server's OID counter is set to 12000 + at the start of a bootstrap run. Thus objects created by regular SQL + commands during the later phases of bootstrap, such as objects created + while running the <filename>information_schema.sql</filename> script, + receive OIDs of 12000 or above. </para> <para> OIDs assigned during normal database operation are constrained to be - 16384 or higher. This leaves the range 10000—16383 available - for OIDs assigned automatically during bootstrap. These OIDs are not - considered stable, and may change from one installation to another. + 16384 or higher. This ensures that the range 10000—16383 is free + for OIDs assigned automatically by <filename>genbki.pl</filename> or + during bootstrap. These automatically-assigned OIDs are not considered + stable, and may change from one installation to another. </para> </sect2> |