Documentation clarification request: pg_dumpall and Large Objects - Mailing list pgsql-docs

From Radoulov, Dimitre
Subject Documentation clarification request: pg_dumpall and Large Objects
Date
Msg-id CAGJBphSX2oMPPu=VM4U8NP4+qffFH_483tFQCJ_s-mOcN3DLDw@mail.gmail.com
Whole thread Raw
Responses Re: Documentation clarification request: pg_dumpall and Large Objects
List pgsql-docs
Hello,

I would like to request a clarification in the pg_dumpall
documentation regarding Large Objects (LOBs). The current
documentation does not explicitly state whether pg_dumpall includes
Large Objects in its output.

In the source code (pg_dumpall.c), there is a comment indicating
that pg_dumpall forces all pg_dump output to plain text. Since Large
Objects are only included by pg_dump when using -b or non-text
archive formats (custom/tar), pg_dumpall cannot include LOBs in its
output.

This behavior is clear from the implementation, but not from the
documentation.

I propose adding an explicit note such as:

  "pg_dumpall does not include Large Objects (BLOBs). To back up
   Large Objects, use pg_dump -b per database."

This clarification would help prevent user confusion during
cluster-wide backup procedures.

Thank you.

Best regards,
Dimitre Radoulov 

pgsql-docs by date:

Previous
From: Michael Paquier
Date:
Subject: Re: restart point vs restartpoint in the docs
Next
From: Laurenz Albe
Date:
Subject: Re: Documentation clarification request: pg_dumpall and Large Objects