Skip to content

Document the clean shutdown requirement for pg_checksums in v5.6 #465

Open

Description

@Hanabi9248

The English v5.6 tool list says that pg_checksums operates while the server is stopped. The detailed command reference in both languages goes straight from the synopsis to the options and omits the clean shutdown prerequisite. A server can be stopped after a crash while its control file still records an unclean state. In that case pg_checksums reports cluster must be shut down, including when invoked in the default --check mode. English reference Chinese reference

The v5.6 implementation accepts DB_SHUTDOWNED and DB_SHUTDOWNED_IN_RECOVERY. This guard runs before the mode-specific checks. The accompanying command manual also documents a clean shutdown as a prerequisite. Release implementation Release manual

Add one paragraph immediately below each synopsis stating that the server must be shut down cleanly for every operating mode, including the default --check mode.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions