pgbackrest/doc/FORMAT.md

# Thoughts on Repository Format 6

# Info Format

- Info format will be `JSON`.  Something like (but without whitespace):

```
[
    {"pgbackrest":{"format":6,"version":<pgbackrest version>,"repo-id":<base32 * 16>,id:<base32 * 16>}},
    {"content":...},
    {"checksum":<sha(1/256)hash>}
]
```

## Manifest

- Save **all** options instead of the piecemeal saves that are done now.  These options are for informational purposes only so it would be fine to save them in a KeyValue or JSON blob.

- Store default sections before file/link/path sections to avoid two passes on load.
- Format backup labels using gmtime().

## Options

- Disable symlinks by default on `posix` repos. This is a convenience feature for manual access to the repo and it makes more sense to make it optional.
Thoughts on repository version 6. 2019-09-24 01:26:24 +02:00			`# Thoughts on Repository Format 6`

			`# Info Format`

			- Info format will be `JSON`. Something like (but without whitespace):

			```
			`[`
			`{"pgbackrest":{"format":6,"version":<pgbackrest version>,"repo-id":<base32 * 16>,id:<base32 * 16>}},`
			`{"content":...},`
			`{"checksum":<sha(1/256)hash>}`
			`]`
			```

			`## Manifest`

			`- Save all options instead of the piecemeal saves that are done now. These options are for informational purposes only so it would be fine to save them in a KeyValue or JSON blob.`

			`- Store default sections before file/link/path sections to avoid two passes on load.`
Note that next repo format should use UTC for backup labels. 2019-12-09 16:12:34 +02:00			`- Format backup labels using gmtime().`
Add notes about optional symlinks to repo format 6 design. 2020-09-01 17:02:44 +02:00
			`## Options`

			- Disable symlinks by default on `posix` repos. This is a convenience feature for manual access to the repo and it makes more sense to make it optional.