Skip to content
Snippets Groups Projects
Commit 1da2f64f authored by Tom Lane's avatar Tom Lane
Browse files

Rearrange documentation paragraph describing pg_relation_size().

Break the list of available options into an <itemizedlist> instead of
inline sentences.  This is mostly motivated by wanting to ensure that the
cross-references to the FSM and VM docs don't cross page boundaries in PDF
format; but it seems to me to read more easily this way anyway.  I took the
liberty of editorializing a bit further while at it.

Per complaint from Magnus about 9.0.18 docs not building in A4 format.
Patch all active branches so we don't get blind-sided by this particular
issue again in future.
parent 748da01d
No related branches found
No related tags found
No related merge requests found
...@@ -15098,18 +15098,34 @@ postgres=# SELECT * FROM pg_xlogfile_name_offset(pg_stop_backup()); ...@@ -15098,18 +15098,34 @@ postgres=# SELECT * FROM pg_xlogfile_name_offset(pg_stop_backup());
</para> </para>
   
<para> <para>
<function>pg_relation_size</> accepts the OID or name of a table, index or <function>pg_relation_size</> accepts the OID or name of a table, index
toast table, and returns the on-disk size in bytes. Specifying or toast table, and returns the on-disk size in bytes of one fork of
<literal>'main'</literal> or leaving out the second argument returns the that relation. (Note that for most purposes it is more convenient to
size of the main data fork of the relation. Specifying use the higher-level functions <function>pg_total_relation_size</>
<literal>'fsm'</literal> returns the size of the or <function>pg_table_size</>, which sum the sizes of all forks.)
Free Space Map (see <xref linkend="storage-fsm">) associated with the With one argument, it returns the size of the main data fork of the
relation. Specifying <literal>'vm'</literal> returns the size of the relation. The second argument can be provided to specify which fork
Visibility Map (see <xref linkend="storage-vm">) associated with the to examine:
relation. Note that this function shows the size of only one fork; <itemizedlist spacing="compact">
for most purposes it is more convenient to use the higher-level <listitem>
functions <function>pg_total_relation_size</> or <para>
<function>pg_table_size</>. <literal>'main'</literal> returns the size of the main
data fork of the relation.
</para>
</listitem>
<listitem>
<para>
<literal>'fsm'</literal> returns the size of the Free Space Map
(see <xref linkend="storage-fsm">) associated with the relation.
</para>
</listitem>
<listitem>
<para>
<literal>'vm'</literal> returns the size of the Visibility Map
(see <xref linkend="storage-vm">) associated with the relation.
</para>
</listitem>
</itemizedlist>
</para> </para>
   
<para> <para>
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment