Server : Apache/2.4.41 (Ubuntu) System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory :  /usr/share/postgresql-common/upgrade-scripts/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

postgresql-common upgrade script infrastructure
===============================================

Purpose
-------

These scripts are executed on upgrades of postgresql-common. They can be used
to perform version-specific or common tasks on all databases or all clusters
(like doing security updates on already existing databases, do format
conversions, and so on).

Conventions
-----------

File names must have the following format:

  version_name_scope.suffix

Files can either be SQL scripts with a "sql" suffix, or executable scripts with
any other suffix.

Files not following these conventions (like this README file) are ignored.

version: 
  This specifies a version number of postgresql-common. If the package
  is upgraded from a version less than or equal to this number, the script is
  applied. If version is "all", the script is always applied regardless of the
  already installed version.

name:
  This name is displayed when calling the script as an information for the
  user.

scope:
  db: The script is called/applied for each existing database of all clusters,
      but not to template1 and template0.
  t1: The script is additionally applied to all template1 databases.
  t0: The script is additionally applied to all template0 databases.
  cluster: The script is called once for each existing cluster.

suffix:
  ".sql" for SQL scripts, arbitrary (also empty) for executable scripts.

SQL Scripts
-----------
Per-database scripts are fed to psql which is called as cluster superuser on
the currently processed database. Per-cluster scripts are called with
connecting to template1.

Executable scripts
------------------
Scripts receive the following arguments:

  <version> <cluster> <database name>

<database name> will always be "template1" for cluster-scope scripts.
On success, they must exit with 0; on error, they should write error
messages to stdout and exit with nonzero. stdout is then displayed as
a failure message.