begriffs open source - ai-pg/blob - full-docs/txt/backup-manifest-files.txt

   1
   2 70.2. Backup Manifest File Object #
   3
   4    The object which describes a single file contains either a Path key or
   5    an Encoded-Path key. Normally, the Path key will be present. The
   6    associated string value is the path of the file relative to the root of
   7    the backup directory. Files located in a user-defined tablespace will
   8    have paths whose first two components are pg_tblspc and the OID of the
   9    tablespace. If the path is not a string that is legal in UTF-8, or if
  10    the user requests that encoded paths be used for all files, then the
  11    Encoded-Path key will be present instead. This stores the same data,
  12    but it is encoded as a string of hexadecimal digits. Each pair of
  13    hexadecimal digits in the string represents a single octet.
  14
  15    The following two keys are always present:
  16
  17    Size
  18           The expected size of this file, as an integer.
  19
  20    Last-Modified
  21           The last modification time of the file as reported by the server
  22           at the time of the backup. Unlike the other fields stored in the
  23           backup, this field is not used by pg_verifybackup. It is
  24           included only for informational purposes.
  25
  26    If the backup was taken with file checksums enabled, the following keys
  27    will be present:
  28
  29    Checksum-Algorithm
  30           The checksum algorithm used to compute a checksum for this file.
  31           Currently, this will be the same for every file in the backup
  32           manifest, but this may change in future releases. At present,
  33           the supported checksum algorithms are CRC32C, SHA224, SHA256,
  34           SHA384, and SHA512.
  35
  36    Checksum
  37           The checksum computed for this file, stored as a series of
  38           hexadecimal characters, two for each byte of the checksum.