```
If the macro defines a block it should look like:
```c
#define MACRO_2(paramName1, paramName2) \
{ \
\
}
```
Continuation characters should be aligned at column 132 (unlike the examples above that have been shortened for display purposes).
To avoid conflicts, variables in a macro will be named `[macro name]_[var name]`, e.g. `TEST_RESULT_resultExpected`. Variables that need to be accessed in wrapped code should be provided accessor macros.
[Variadic functions](#variadic-functions) are an exception to the capitalization rule.
#### Begin / End
Use `Begin` / `End` for names rather than `Start` / `Finish`, etc.
#### New / Free
Use `New` / `Free` for constructors and destructors rather than `Create` / `Destroy`, etc.
### Formatting
#### Braces
C allows braces to be excluded for a single statement. However, braces should be used when the control statement (if, while, etc.) spans more than one line or the statement to be executed spans more than one line.
No braces needed:
```c
if (condition)
return value;
```
Braces needed:
```c
if (conditionThatUsesEntireLine1 &&
conditionThatUsesEntireLine2)
{
return value;
}
```
```c
if (condition)
{
return
valueThatUsesEntireLine1 &&
valueThatUsesEntireLine2;
}
```
Braces should be added to `switch` statement cases that have a significant amount of code. As a general rule of thumb, if the code block in the `case` is large enough to have blank lines and/or multiple comments then it should be enclosed in braces.
```c
switch (int)
{
case 1:
a = 2;
break;
case 2:
{
# Comment this more complex code
a = 1;
b = 2;
c = func(a, b);
break;
}
}
```
#### Hints, Warnings, and Errors
Hints are to be formatted with capitalized `HINT:` followed by a space and a sentence. The sentence shall only begin with a capital letter if the first word is an acronym (e.g. TLS) or a proper name (e.g. PostgreSQL). The sentence must end with a period, question mark or exclamation point as appropriate.
Warning and errors shall be lowercase with the exceptions for proper names and acronyms and end without punctuation.
## Language Elements
### Data Types
Don't get exotic - use the simplest type that will work.
Use `int` or `unsigned int` for general cases. `int` will be at least 32 bits. When not using `int` use one of the types defined in `common/type.h`.
### Macros
Don't use a macro when a function could be used instead. Macros make it hard to measure code coverage.
### Objects
Object-oriented programming is used extensively. The object pointer is always referred to as `this`.
An object can expose internal struct members by defining a public struct that contains the members to be exposed and using inline functions to get/set the members.
The header file:
```c
/***********************************************************************************************************************************
Getters/setters
***********************************************************************************************************************************/
typedef struct ListPub
{
unsigned int listSize; // List size
} ListPub;
// List size
FN_INLINE_ALWAYS unsigned int
lstSize(const List *const this)
{
return THIS_PUB(List)->listSize;
}
```
`THIS_PUB()` ensures that `this != NULL` so there is no need to check that in the calling function.
And the C file:
```c
struct List
{
ListPub pub; // Publicly accessible variables
...
};
```
The public struct must be the first member of the private struct. The naming convention for the public struct is to add `Pub` to the end of the private struct name.
### Variadic Functions
Variadic functions can take a variable number of parameters. While the `printf()` pattern is variadic, it is not very flexible in terms of optional parameters given in any order.
This project implements variadic functions using macros (which are exempt from the normal macro rule of being all caps). A typical variadic function definition:
```c
typedef struct StoragePathCreateParam
{
bool errorOnExists;
bool noParentCreate;
mode_t mode;
} StoragePathCreateParam;
#define storagePathCreateP(this, pathExp, ...) \
storagePathCreate(this, pathExp, (StoragePathCreateParam){__VA_ARGS__})
#define storagePathCreateP(this, pathExp) \
storagePathCreate(this, pathExp, (StoragePathCreateParam){0})
void storagePathCreate(const Storage *this, const String *pathExp, StoragePathCreateParam param);
```
Continuation characters should be aligned at column 132 (unlike the example above that has been shortened for display purposes).
This function can be called without variable parameters:
```c
storagePathCreateP(storageLocal(), "/tmp/pgbackrest");
```
Or with variable parameters:
```c
storagePathCreateP(storageLocal(), "/tmp/pgbackrest", .errorOnExists = true, .mode = 0777);
```
If the majority of functions in a module or object are variadic it is best to provide macros for all functions even if they do not have variable parameters. Do not use the base function when variadic macros exist.
## Testing
### Uncoverable/Uncovered Code
#### Uncoverable Code
The `uncoverable` keyword marks code that can never be covered. For instance, a function that never returns because it always throws an error. Uncoverable code should be rare to non-existent outside the common libraries and test code.
```c
} // {uncoverable - function throws error so never returns}
```
Subsequent code that is uncoverable for the same reason is marked with `// {+uncoverable}`.
#### Uncovered Code
Marks code that is not tested for one reason or another. This should be kept to a minimum and an excuse given for each instance.
```c
exit(EXIT_FAILURE); // {uncovered - test harness does not support non-zero exit}
```
Subsequent code that is uncovered for the same reason is marked with `// {+uncovered}`.
pgbackrest-release-2.55.1/CONTRIBUTING.md 0000664 0000000 0000000 00000111452 15006170376 0017611 0 ustar 00root root 0000000 0000000 # pgBackRest
Contributing to pgBackRest
## Table of Contents
[Introduction](#introduction)
[Building a Development Environment](#building-a-development-environment)
[Coding](#coding)
[Testing](#testing)
[Submitting a Pull Request](#submitting-a-pull-request)
## Introduction
This documentation is intended to assist contributors to pgBackRest by outlining some basic steps and guidelines for contributing to the project.
Code fixes or new features can be submitted via pull requests. Ideas for new features and improvements to existing functionality or documentation can be [submitted as issues](https://github.com/pgbackrest/pgbackrest/issues). You may want to check the [Project Boards](https://github.com/pgbackrest/pgbackrest/projects) to see if your suggestion has already been submitted.
Bug reports should be [submitted as issues](https://github.com/pgbackrest/pgbackrest/issues). Please provide as much information as possible to aid in determining the cause of the problem.
You will always receive credit in the [release notes](http://www.pgbackrest.org/release.html) for your contributions.
Coding standards are defined in [CODING.md](https://github.com/pgbackrest/pgbackrest/blob/main/CODING.md) and some important coding details and an example are provided in the [Coding](#coding) section below. At a minimum, unit tests must be written and run and the documentation generated before [submitting a Pull Request](#submitting-a-pull-request); see the [Testing](#testing) section below for details.
## Building a Development Environment
This example is based on Ubuntu 20.04, but it should work on many versions of Debian and Ubuntu.
pgbackrest-dev => Install development tools
```
sudo apt-get install rsync git devscripts build-essential valgrind autoconf \
autoconf-archive libssl-dev zlib1g-dev libxml2-dev libpq-dev pkg-config \
libxml-checker-perl libyaml-perl libdbd-pg-perl liblz4-dev liblz4-tool \
zstd libzstd-dev bzip2 libbz2-dev libyaml-dev ccache python3-distutils meson
```
Some unit tests and all the integration tests require Docker. Running in containers allows us to simulate multiple hosts, test on different distributions and versions of PostgreSQL, and use sudo without affecting the host system.
pgbackrest-dev => Install Docker
```
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker `whoami`
```
This clone of the pgBackRest repository is sufficient for experimentation. For development, create a fork and clone that instead.
pgbackrest-dev => Clone pgBackRest repository
```
git clone https://github.com/pgbackrest/pgbackrest.git
```
If using a RHEL-based system, the CPAN XML parser is required to run `test.pl` and `doc.pl`. Instructions for installing Docker and the XML parser can be found in the `README.md` file of the pgBackRest [doc](https://github.com/pgbackrest/pgbackrest/blob/main/doc) directory in the section "The following is a sample RHEL 7 configuration that can be used for building the documentation". NOTE that the "Install latex (for building PDF)" section is not required since testing of the docs need only be run for HTML output.
## Coding
The following sections provide information on some important concepts needed for coding within pgBackRest.
### Memory Contexts
Memory is allocated inside contexts and can be long lasting (for objects) or temporary (for functions). In general, use `OBJ_NEW_BEGIN(MyObj)` for objects and `MEM_CONTEXT_TEMP_BEGIN()` for functions. See [memContext.h](https://github.com/pgbackrest/pgbackrest/blob/main/src/common/memContext.h) for more details and the [Coding Example](#coding-example) below.
### Logging
Logging is used for debugging with the built-in macros `FUNCTION_LOG_*()` and `FUNCTION_TEST_*()` which are used to trace parameters passed to/returned from functions. `FUNCTION_LOG_*()` macros are used for production logging whereas `FUNCTION_TEST_*()` macros will be compiled out of production code. For functions where no parameter is valuable enough to justify the cost of debugging in production, use `FUNCTION_TEST_BEGIN()/FUNCTION_TEST_END()`, else use `FUNCTION_LOG_BEGIN(someLogLevel)/FUNCTION_LOG_END()`. See [debug.h](https://github.com/pgbackrest/pgbackrest/blob/main/src/common/debug.h) for more details and the [Coding Example](#coding-example) below.
Logging is also used for providing information to the user via the `LOG_*()` macros, such as `LOG_INFO("some informational message")` and `LOG_WARN_FMT("no prior backup exists, %s backup has been changed to full", strZ(cfgOptionDisplay(cfgOptType)))` and also via `THROW_*()` macros for throwing an error. See [log.h](https://github.com/pgbackrest/pgbackrest/blob/main/src/common/log.h) and [error.h](https://github.com/pgbackrest/pgbackrest/blob/main/src/common/error/error.h) for more details and the [Coding Example](#coding-example) below.
### Coding Example
The example below is not structured like an actual implementation and is intended only to provide an understanding of some of the more common coding practices. The comments in the example are only here to explain the example and are not representative of the coding standards. Refer to the Coding Standards document ([CODING.md](https://github.com/pgbackrest/pgbackrest/blob/main/CODING.md)) and sections above for an introduction to the concepts provided here. For an actual implementation, see [db.h](https://github.com/pgbackrest/pgbackrest/blob/main/src/db/db.h) and [db.c](https://github.com/pgbackrest/pgbackrest/blob/main/src/db/db.c).
#### Example: hypothetical basic object construction
```c
/*
* HEADER FILE - see db.h for a complete implementation example
*/
// Typedef the object declared in the C file
typedef struct MyObj MyObj;
// Constructor, and any functions in the header file, are all declared on one line
MyObj *myObjNew(unsigned int myData, const String *secretName);
// Declare the publicly accessible variables in a structure with Pub appended to the name
typedef struct MyObjPub // First letter upper case
{
unsigned int myData; // Contents of the myData variable
} MyObjPub;
// Declare getters and setters inline for the publicly visible variables
// Only setters require "Set" appended to the name
FN_INLINE_ALWAYS unsigned int
myObjMyData(const MyObj *const this)
{
return THIS_PUB(MyObj)->myData; // Use the built-in THIS_PUB macro
}
// Destructor
FN_INLINE_ALWAYS void
myObjFree(MyObj *const this)
{
objFree(this);
}
// TYPE and FORMAT macros for function logging
#define FUNCTION_LOG_MY_OBJ_TYPE \
MyObj *
#define FUNCTION_LOG_MY_OBJ_FORMAT(value, buffer, bufferSize) \
FUNCTION_LOG_OBJECT_FORMAT(value, myObjToLog, buffer, bufferSize)
/*
* C FILE - see db.c for a more complete and actual implementation example
*/
// Declare the object type
struct MyObj
{
MyObjPub pub; // Publicly accessible variables must be first and named "pub"
const String *name; // Pointer to lightweight string object - see string.h
};
// Object constructor, and any functions in the C file, have the return type and function signature on separate lines
MyObj *
myObjNew(unsigned int myData, const String *secretName)
{
FUNCTION_LOG_BEGIN(logLevelDebug); // Use FUNCTION_LOG_BEGIN with a log level for displaying in production
FUNCTION_LOG_PARAM(UINT, myData); // When log level is debug, myData variable will be logged
FUNCTION_TEST_PARAM(STRING, secretName); // FUNCTION_TEST_PARAM will not display secretName value in production logging
FUNCTION_LOG_END();
ASSERT(secretName != NULL || myData > 0); // Development-only assertions (will be compiled out of production code)
OBJ_NEW_BEGIN(MyObj) // Create a long lasting memory context with the name of the object
{
*this = (MyObj) // Initialize the object
{
.pub =
{
.myData = myData, // Copy the simple data type to this object
},
.name = strDup(secretName), // Duplicate the String data type to the this object's memory context
};
}
OBJ_NEW_END();
FUNCTION_LOG_RETURN(MyObj, this);
}
// Function using temporary memory context
String *
myObjDisplay(unsigned int myData)
{
FUNCTION_TEST_BEGIN(); // No parameters passed to this function will be logged in production
FUNCTION_TEST_PARAM(UINT, myData);
FUNCTION_TEST_END();
String *result = NULL; // Result is created in the caller's memory context (referred to as "prior context" below)
MEM_CONTEXT_TEMP_BEGIN() // Begin a new temporary context
{
String *resultStr = strNewZ("Hello"); // Allocate a string in the temporary memory context
if (myData > 1)
resultStr = strCatZ(" World"); // Append a value to the string still in the temporary memory context
else
LOG_WARN("Am I not your World?"); // Log a warning to the user
MEM_CONTEXT_PRIOR_BEGIN() // Switch to the prior context so the string duplication is in the caller's context
{
result = strDup(resultStr); // Create a copy of the string in the caller's context
}
MEM_CONTEXT_PRIOR_END(); // Switch back to the temporary context
}
MEM_CONTEXT_TEMP_END(); // Free everything created inside this temporary memory context - i.e resultStr
FUNCTION_TEST_RETURN(STRING, result); // Return result but do not log the value in production
}
// Create the logging function for displaying important information from the object
String *
myObjToLog(const MyObj *this)
{
return strNewFmt(
"{name: %s, myData: %u}", this->name == NULL ? NULL_Z : strZ(this->name), myObjMyData(this));
}
```
## Testing
A list of all possible test combinations can be viewed by running:
```
pgbackrest/test/test.pl --dry-run
```
While some files are automatically generated during `make`, others are generated by running the test harness as follows:
```
pgbackrest/test/test.pl --gen-only
```
Prior to any submission, the html version of the documentation should also be run and the output checked by viewing the generated html on the local file system under `pgbackrest/doc/output/html`. More details can be found in the pgBackRest [doc/README.md](https://github.com/pgbackrest/pgbackrest/blob/main/doc/README.md) file.
```
pgbackrest/doc/doc.pl --out=html
```
> **NOTE:** `ERROR: [028]` regarding cache is invalid is OK; it just means there have been changes and the documentation will be built from scratch. In this case, be patient as the build could take 20 minutes or more depending on your system.
### Running Tests
Examples of test runs are provided in the following sections. There are several important options for running a test:
- `--dry-run` - without any other options, this will list all the available tests
- `--module` - identifies the module in which the test is located
- `--test` - the actual test set to be run
- `--run` - a number identifying the run within a test if testing a single run rather than the entire test
- `--vm-out` - displays the test output (helpful for monitoring the progress)
- `--vm` - identifies the pre-built container when using Docker, otherwise the setting should be `none`. See [test.yml](https://github.com/pgbackrest/pgbackrest/blob/main/.github/workflows/test.yml) for a list of valid vm codes noted by `param: test`.
For more options, run the test or documentation engine with the `--help` option:
```
pgbackrest/test/test.pl --help
pgbackrest/doc/doc.pl --help
```
#### Without Docker
If Docker is not installed, then the available tests can be listed using `--dry-run`. Some tests require containers and will only be available when Docker is installed.
pgbackrest-dev => List tests that don't require a container
```
pgbackrest/test/test.pl --dry-run
--- output ---
P00 INFO: test begin on x86_64 - log level info
P00 INFO: clean autogenerate code
--> P00 INFO: 83 tests selected
P00 INFO: P1-T01/83 - vm=none, module=common, test=error
[filtered 80 lines of output]
P00 INFO: P1-T82/83 - vm=none, module=performance, test=type
P00 INFO: P1-T83/83 - vm=none, module=performance, test=storage
--> P00 INFO: DRY RUN COMPLETED SUCCESSFULLY
```
pgbackrest-dev => Run a test
```
pgbackrest/test/test.pl --vm-out --module=common --test=wait
--- output ---
P00 INFO: test begin on x86_64 - log level info
P00 INFO: cleanup old data
P00 INFO: autogenerate code
P00 INFO: build for none (/home/vagrant/test/build/none)
P00 INFO: 1 test selected
P00 INFO: P1-T1/1 - vm=none, module=common, test=wait
P00 INFO: test command begin 2.55.1: [common/wait] --log-level=info --no-log-timestamp --repo-path=/home/vagrant/test/repo --scale=1 --test-path=/home/vagrant/test --vm=none --vm-id=0
P00 INFO: test command end: completed successfully
run 1 - waitNew(), waitMore, and waitFree()
L0018 expect AssertError: assertion 'waitTime <= 999999000' failed
run 1/1 ----- L0021 0ms wait
L0025 new wait
L0026 check wait time
L0027 check sleep time
L0028 check sleep prev time
L0029 no wait more
run 1/2 ----- L0032 100ms with retries after time expired
L0034 new wait
L0037 time expired, first retry
L0038 time expired, second retry
L0039 time expired, retries expired
run 1/3 ----- L0042 200ms wait
L0046 new wait = 0.2 sec
L0047 check wait time
L0048 check sleep time
L0049 check sleep prev time
L0050 check begin time
L0052 first retry
L0053 check retry
L0055 second retry
L0056 check retry
L0058 still going because of time
L0064 lower range check
L0065 upper range check
L0067 free wait
run 1/4 ----- L0070 1100ms wait
L0074 new wait = 1.1 sec
L0075 check wait time
L0076 check sleep time
L0077 check sleep prev time
L0078 check begin time
L0084 lower range check
L0085 upper range check
L0087 free wait
run 1/5 ----- L0090 waitRemainder()
L0092 new wait = 500ms
L0093 check initial wait remainder
L0094 check initial wait remainder
L0098 check updated wait remainder
L0099 check updated wait remainder
TESTS COMPLETED SUCCESSFULLY
P00 INFO: P1-T1/1 - vm=none, module=common, test=wait
P00 INFO: tested modules have full coverage
P00 INFO: TESTS COMPLETED SUCCESSFULLY
```
An entire module can be run by using only the `--module` option.
pgbackrest-dev => Run a module
```
pgbackrest/test/test.pl --module=postgres
--- output ---
P00 INFO: test begin on x86_64 - log level info
P00 INFO: cleanup old data
P00 INFO: autogenerate code
P00 INFO: build for none (/home/vagrant/test/build/none)
P00 INFO: 2 tests selected
P00 INFO: P1-T1/2 - vm=none, module=postgres, test=client
P00 INFO: P1-T2/2 - vm=none, module=postgres, test=interface
P00 INFO: tested modules have full coverage
P00 INFO: TESTS COMPLETED SUCCESSFULLY
```
#### With Docker
Build a container to run tests. The vm must be pre-configured but a variety are available. A vagrant file is provided in the test directory as an example of running in a virtual environment. The vm names are all three character abbreviations, e.g. `u20` for Ubuntu 20.04.
pgbackrest-dev => Build a VM
```
pgbackrest/test/test.pl --vm-build --vm=u20
--- output ---
P00 INFO: test begin on x86_64 - log level info
P00 INFO: Using cached pgbackrest/test:u20-base-x86_64-20250228A image (862159b4d2169a4752b106639ca0f47c1ebb1f86) ...
P00 INFO: Building pgbackrest/test:u20-test-x86_64 image ...
P00 INFO: Build Complete
```
> **NOTE:** to build all the vms, just omit the `--vm` option above.
pgbackrest-dev => Run a Specific Test Run
```
pgbackrest/test/test.pl --vm=u20 --module=postgres --test=interface --run=2
--- output ---
P00 INFO: test begin on x86_64 - log level info
P00 INFO: cleanup old data and containers
P00 INFO: autogenerate code
P00 INFO: clean build for u20 (/home/vagrant/test/build/u20)
P00 INFO: 1 test selected
P00 INFO: P1-T1/1 - vm=u20, module=postgres, test=interface, run=2
P00 INFO: TESTS COMPLETED SUCCESSFULLY
```
### Writing a Unit Test
The goal of unit testing is to have 100 percent code coverage. Two files will usually be involved in this process:
- **define.yaml** - defines the number of tests to be run for each module and test file. There is a comment at the top of the file that provides more information about this file.
- **src/module/somefileTest.c** - where "somefile" is the path and name of the test file where the unit tests are located for the code being updated (e.g. `src/module/command/expireTest.c`).
#### define.yaml
Each module is separated by a line of asterisks (*) and each test within is separated by a line of dashes (-). In the example below, the module is `command` and the unit test is `check`. The number of calls to `testBegin()` in a unit test file will dictate the number following `total:`, in this case 4. Under `coverage:`, the list of files that will be tested.
```
# ********************************************************************************************************************************
- name: command
test:
# ----------------------------------------------------------------------------------------------------------------------------
- name: check
total: 4
containerReq: true
coverage:
- command/check/common
- command/check/check
```
#### somefileTest.c
Unit test files are organized in the `test/src/module` directory with the same directory structure as the source code being tested. For example, if new code is added to src/**command/expire**.c then test/src/module/**command/expire**Test.c will need to be updated.
Assuming that a test file already exists, new unit tests will either go in a new `testBegin()` section or be added to an existing section. Each such section is a test run. The comment string passed to `testBegin()` should reflect the function(s) being tested in the test run. Tests within a run should use `TEST_TITLE()` with a comment string describing the test.
```
// *****************************************************************************************************************************
if (testBegin("expireBackup()"))
{
// -------------------------------------------------------------------------------------------------------------------------
TEST_TITLE("manifest file removal");
```
#### Setting up the command to be run
The [harnessConfig.h](https://github.com/pgbackrest/pgbackrest/blob/main/test/src/common/harnessConfig.h) describes a list of functions that should be used when configuration options are required for a command being tested. Options are set in a `StringList` which must be defined and passed to the `HRN_CFG_LOAD()` macro with the command. For example, the following will set up a test to run `pgbackrest --repo-path=test/test-0/repo info` command on multiple repositories, one of which is encrypted:
```
StringList *argList = strLstNew(); // Create an empty string list
hrnCfgArgRawZ(argList, cfgOptRepoPath, TEST_PATH "/repo"); // Add the --repo-path option
hrnCfgArgKeyRawZ(argList, cfgOptRepoPath, 2, TEST_PATH "/repo2"); // Add the --repo2-path option
hrnCfgArgKeyRawStrId(argList, cfgOptRepoCipherType, 2, cipherTypeAes256Cbc); // Add the --repo2-cipher-type option
hrnCfgEnvKeyRawZ(cfgOptRepoCipherPass, 2, TEST_CIPHER_PASS); // Set environment variable for the --repo2-cipher-pass option
HRN_CFG_LOAD(cfgCmdInfo, argList); // Load the command and option list into the test harness
```
#### Storing a file
Sometimes it is desirable to store or manipulate files before or during a test and then confirm the contents. The [harnessStorage.h](https://github.com/pgbackrest/pgbackrest/blob/main/test/src/common/harnessStorage.h) file contains macros (e.g. `HRN_STORAGE_PUT` and `TEST_STORAGE_GET`) for doing this. In addition, `HRN_INFO_PUT` is convenient for writing out info files (archive.info, backup.info, backup.manifest) since it will automatically add header and checksum information.
```
HRN_STORAGE_PUT_EMPTY(
storageRepoWrite(), STORAGE_REPO_ARCHIVE "/10-1/000000010000000100000001-abcdabcdabcdabcdabcdabcdabcdabcdabcdabcd.gz");
```
#### Testing results
Tests are run and results confirmed via macros that are described in [harnessTest.h](https://github.com/pgbackrest/pgbackrest/blob/main/test/src/common/harnessTest.h). With the exception of TEST_ERROR, the third parameter is a short description of the test. Some of the more common macros are:
- `TEST_RESULT_STR` - Test the actual value of the string returned by the function.
- `TEST_RESULT_UINT` / `TEST_RESULT_INT` - Test for an unsigned integer / integer.
- `TEST_RESULT_BOOL` - Test a boolean value.
- `TEST_RESULT_PTR` / `TEST_RESULT_PTR_NE` - Test a pointer: useful for testing if the pointer is `NULL` or not equal (`NE`) to `NULL`.
- `TEST_RESULT_VOID` - The function being tested returns a `void`. This is then usually followed by tests that ensure other actions occurred (e.g. a file was written to disk).
- `TEST_ERROR` / `TEST_ERROR_FMT` - Test that a specific error code was raised with specific wording.
> **NOTE:** `HRN_*` macros should be used only for test setup and cleanup. `TEST_*` macros must be used for testing results.
#### Testing a log message
If a function being tested logs something with `LOG_WARN`, `LOG_INFO` or other `LOG_*()` macro, then the logged message must be cleared before the end of the test by using the `TEST_RESULT_LOG()/TEST_RESULT_LOG_FMT()` macros.
```
TEST_RESULT_LOG(
"P00 WARN: WAL segment '000000010000000100000001' was not pushed due to error [25] and was manually skipped: error");
```
In the above, `Pxx` indicates the process (P) and the process number (xx), e.g. P00, P01.
#### Testing using child process
Sometimes it is useful to use a child process for testing. Below is a simple example. See [harnessFork.h](https://github.com/pgbackrest/pgbackrest/blob/main/test/src/common/harnessFork.h) for more details.
```
HRN_FORK_BEGIN()
{
HRN_FORK_CHILD_BEGIN()
{
TEST_RESULT_BOOL(cmdLockAcquireP(), true, "create backup/expire lock");
// Notify parent that lock has been acquired
HRN_FORK_CHILD_NOTIFY_PUT();
// Wait for parent to allow release lock
HRN_FORK_CHILD_NOTIFY_GET();
cmdLockReleaseP();
}
HRN_FORK_CHILD_END();
HRN_FORK_PARENT_BEGIN()
{
// Wait for child to acquire lock
HRN_FORK_PARENT_NOTIFY_GET(0);
HRN_CFG_LOAD(cfgCmdInfo, argListText);
TEST_RESULT_STR_Z(
infoRender(),
"stanza: stanza1\n"
" status: error (no valid backups, backup/expire running)\n"
" cipher: none\n"
"\n"
" db (current)\n"
" wal archive min/max (9.6): none present\n",
"text - single stanza, no valid backups, backup/expire lock detected");
// Notify child to release lock
HRN_FORK_PARENT_NOTIFY_PUT(0);
}
HRN_FORK_PARENT_END();
}
HRN_FORK_END();
```
#### Testing using a shim
A PostgreSQL libpq shim is provided to simulate interactions with PostgreSQL. Below is a simple example. See [harnessPq.h](https://github.com/pgbackrest/pgbackrest/blob/main/test/src/common/harnessPq.h) for more details.
```
// Set up two standbys but no primary
HRN_PQ_SCRIPT_SET(
HRN_PQ_SCRIPT_OPEN_GE_96(1, "dbname='postgres' port=5432", PG_VERSION_96, "/pgdata", true, NULL, NULL),
HRN_PQ_SCRIPT_OPEN_GE_96(8, "dbname='postgres' port=5433", PG_VERSION_96, "/pgdata", true, NULL, NULL),
// Close the "inner" session first (8) then the outer (1)
HRN_PQ_SCRIPT_CLOSE(8),
HRN_PQ_SCRIPT_CLOSE(1));
TEST_ERROR(cmdCheck(), ConfigError, "primary database not found\nHINT: check indexed pg-path/pg-host configurations");
```
### Running a Unit Test
**Code Coverage**
Unit tests are run for all files that are listed in `define.yaml` and a coverage report generated for each file listed under the tag `coverage:`. Note that some files are listed in multiple `coverage:` sections for a module; in this case, each test for the file being modified should be specified for the module in which the file exists (e.g. `--module=storage --test=posix --test=gcs`, etc.) or, alternatively, simply run the module without the `--test` option. It is recommended that a `--vm` be specified since running the same test for multiple vms is unnecessary for coverage. The following example would run the test set from the **define.yaml** section detailed above.
```
pgbackrest/test/test.pl --vm-out --module=command --test=check --vm=u20
```
> **NOTE:** Not all systems perform at the same speed, so if a test is timing out, try rerunning with another vm.
A coverage report will be generated and written to the local file system under the pgBackRest repository in `test/result/coverage.html`.
If 100 percent code coverage has not been achieved, an error message will be displayed, for example: `ERROR: [125]: c module command/check/check is not fully covered`
**Debugging with files**
Sometimes it is useful to look at files that were generated during the test. The default for running any test is that, at the start/end of the test, the test harness will clean up all files and directories created. To override this behavior, a single test run must be specified and the option `--no-cleanup` provided. Again, continuing with the check command, from **define.yaml** above, there are four tests. Below, test one will be run and nothing will be cleaned up so that the files and directories in `test/test-0` can be inspected.
```
pgbackrest/test/test.pl --vm-out --module=command --test=check --run=1 --no-cleanup
```
### Understanding Test Output
The following is a small sample of a typical test output.
```
run 8 - expireTimeBasedBackup()
run 8/1 ------------- L2285 no current backups
000.002s L2298 empty backup.info
000.009s 000.007s L2300 no backups to expire
```
**run 8 - expireTimeBasedBackup()** - indicates the run number (8) within the module and the parameter provided to testBegin, e.g. `testBegin("expireTimeBasedBackup()")`
**run 8/1 ------------- L2285 no current backups** - this is the first test (1) in run 8 which is the `TEST_TITLE("no current backups");` at line number 2285.
**000.002s L2298 empty backup.info** - the first number, 000.002s, is the time in seconds that the test started from the beginning of the run. L2298 is the line number of the test and `empty backup.info` is the test comment.
**000.009s 000.007s L2300 no backups to expire** - again, 000.009s, is the time in seconds that the test started from the beginning of the run. The second number, 000.007s, is the run time of the **previous** test (i.e. `empty backup.info` test took 000.007 seconds to execute). L2300 is the line number of the test and `no backups to expire` is the test comment.
## Adding an Option
Options can be added to a command or multiple commands. Options can be configuration file only, command-line only or valid for both. Once an option is successfully added, the `config.auto.h` and `parse.auto.c.inc` files will automatically be generated by the build system.
To add an option, two files need be to be modified:
- `src/build/config/config.yaml`
- `src/build/help/help.xml`
These files are discussed in the following sections along with how to verify the `help` command output.
### config.yaml
There are detailed comment blocks above each section that explain the rules for defining commands and options. Regarding options, there are two types: 1) command line only, and 2) configuration file. With the exception of secrets, all configuration file options can be passed on the command line. To configure an option for the configuration file, the `section:` key must be present.
The `option:` section is broken into sub-sections by a simple comment divider (e.g. `# Repository options`) under which the options are organized alphabetically by option name. To better explain this section, two hypothetical examples will be discussed. For more details, see [config.yaml](https://github.com/pgbackrest/pgbackrest/blob/main/src/build/config/config.yaml).
#### EXAMPLE 1 hypothetical command line only option
```
set:
type: string
command:
backup:
depend:
option: stanza
required: false
restore:
default: latest
command-role:
main: {}
```
Note that `section:` is not present thereby making this a command-line only option defined as follows:
- `set` - the name of the option
- `type` - the type of the option. Valid values for types are: `boolean`, `hash`, `integer`, `list`, `path`, `size`, `string`, and `time`
- `command` - list each command for which the option is valid. If a command is not listed, then the option is not valid for the command and an error will be thrown if it is attempted to be used for that command. In this case the valid commands are `backup` and `restore`.
- `backup` - details the requirements for the `--set` option for the `backup` command. It is dependent on the option `--stanza`, meaning it is only allowed to be specified for the `backup` command if the `--stanza` option has been specified. And `required: false` indicates that the `--set` option is never required, even with the dependency.
- `restore` - details the requirements for the `--set` option for the `restore` command. Since `required:` is omitted, it is not required to be set by the user but it is required by the command and will default to `latest` if it has not been specified by the user.
- `command-role` - defines the processes for which the option is valid. `main` indicates the option will be used by the main process and not be passed on to other local/remote processes.
#### EXAMPLE 2 hypothetical configuration file option
```
repo-test-type:
section: global
type: string
group: repo
default: full
allow-list:
- full
- diff
- incr
command:
backup: {}
restore: {}
command-role:
main: {}
```
- `repo-test-type` - the name of the option
- `section` - the section of the configuration file where this option is valid (omitted for command line only options, see [Example 1](#example-1-hypothetical-command-line-only-option) above)
- `type` - the type of the option. Valid values for types are: `boolean`, `hash`, `integer`, `list`, `path`, `size`, `string`, and `time`
- `group` - indicates that this option is part of the `repo` group of indexed options and therefore will follow the indexing rules e.g. `repo1-test-type`.
- `default` - sets a default for the option if the option is not provided when the command is run. The default can be global (as it is here) or it can be specified for a specific command in the command section (as in [Example 1](#example-1-hypothetical-command-line-only-option) above).
- `allow-list` - lists the allowable values for the option for all commands for which the option is valid.
- `command` - list each command for which the option is valid. If a command is not listed, then the option is not valid for the command and an error will be thrown if it is attempted to be used for that command. In this case the valid commands are `backup` and `restore`.
- `command-role` - defines the processes for which the option is valid. `main` indicates the option will be used by the main process and not be passed on to other local/remote processes.
When `test.pl` is run the `config.auto.h` file will be generated to contain the constants used for options in the code. For the C enums, any dashes in the option name will be removed, camel-cased and prefixed with `cfgOpt`, e.g. `repo-path` becomes `cfgOptRepoPath`.
### help.xml
All options must be documented or the system will error during the build. To add an option, find the command section identified by `command id="COMMAND"` section where `COMMAND` is the name of the command (e.g. `expire`) or, if the option is used by more than one command and the definition for the option is the same for all of the commands, the `operation-general title="General Options"` section.
To add an option, add the following to the `` section; if it does not exist, then wrap the following in `` ` `. This example uses the boolean option `force` of the `restore` command. Simply replace that with your new option and the appropriate `summary`, `text` and `example`.
```
```
> **IMPORTANT:** A period (.) is required to end the `summary` section.
### Testing the help
It is important to run the `help` command unit test after adding an option in case a change is required:
```
pgbackrest/test/test.pl --module=command --test=help --vm-out
```
To verify the `help` command output, build the pgBackRest executable:
```
pgbackrest/test/test.pl --build-only
```
Use the pgBackRest executable to test the help output:
```
test/bin/none/pgbackrest help backup repo-type
```
### Testing the documentation
To quickly view the HTML documentation, the `--no-exe` option can be passed to the documentation generator in order to bypass executing the code elements:
```
pgbackrest/doc/doc.pl --out=html --no-exe
```
The generated HTML files will be placed in the `doc/output/html` directory where they can be viewed locally in a browser.
If Docker is installed, it will be used by the documentation generator to execute the code elements while building the documentation, therefore, the `--no-exe` should be omitted, (i.e. `pgbackrest/doc/doc.pl --output=html`). `--no-cache` may be used to force a full build even when no code elements have changed since the last build. `--pre` will reuse the container definitions from the prior build and saves time during development.
The containers created for documentation builds can be useful for manually testing or trying out new code or features. The following demonstrates building through just the `quickstart` section of the `user-guide` without encryption.
```
pgbackrest/doc/doc.pl --out=html --include=user-guide --require=/quickstart --var=encrypt=n --no-cache --pre
```
The resulting Docker containers can be listed with `docker ps` and the container can be entered with `docker exec doc-pg-primary bash`. Additionally, the `-u` option can be added for entering the container as a specific user (e.g. `postgres`).
## Submitting a Pull Request
Before submitting a Pull Request:
- Does it meet the [coding standards](https://github.com/pgbackrest/pgbackrest/blob/main/CODING.md)?
- Have [Unit Tests](#writing-a-unit-test) been written and [run](#running-a-unit-test) with 100% coverage?
- If your submission includes changes to the help or online documentation, have the [help](#testing-the-help) and [documentation](#testing-the-documentation) tests been run?
- Has it passed continuous integration testing? Simply renaming your branch with the appendix `-cig` and pushing it to your GitHub account will initiate GitHub Actions to run CI tests.
When submitting a Pull Request:
- Provide a short submission title.
- Write a detailed comment to describe the purpose of your submission and any issue(s), if any, it is resolving; a link to the GitHub issue is also helpful.
- Select the `integration` branch as the base for your PR, do not select `main` nor any other branch.
After submitting a Pull Request:
- One or more reviewers will be assigned.
- Respond to any issues (conversations) in GitHub but do not resolve the conversation; the reviewer is responsible for ensuring the issue raised has been resolved and marking the conversation resolved. It is helpful to supply the commit in your reply if one was submitted to fix the issue.
Lastly, thank you for contributing to pgBackRest!
pgbackrest-release-2.55.1/LICENSE 0000664 0000000 0000000 00000002220 15006170376 0016355 0 ustar 00root root 0000000 0000000 The MIT License (MIT)
Portions Copyright (c) 2015-2025, The PostgreSQL Global Development Group
Portions Copyright (c) 2013-2025, David Steele
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
pgbackrest-release-2.55.1/README.md 0000664 0000000 0000000 00000022375 15006170376 0016644 0 ustar 00root root 0000000 0000000 # pgBackRest
Reliable PostgreSQL Backup & Restore
## Introduction
pgBackRest is a reliable backup and restore solution for PostgreSQL that seamlessly scales up to the largest databases and workloads.
pgBackRest [v2.55.1](https://github.com/pgbackrest/pgbackrest/releases/tag/release/2.55.1) is the current stable release. Release notes are on the [Releases](http://www.pgbackrest.org/release.html) page.
Please give us a star on [GitHub](https://github.com/pgbackrest/pgbackrest) if you like pgBackRest!
## Features
### Parallel Backup & Restore
Compression is usually the bottleneck during backup operations so pgBackRest solves this problem with parallel processing and more efficient compression algorithms such as lz4 and zstd.
### Local or Remote Operation
A custom protocol allows pgBackRest to backup, restore, and archive locally or remotely via TLS/SSH with minimal configuration. An interface to query PostgreSQL is also provided via the protocol layer so that remote access to PostgreSQL is never required, which enhances security.
### Multiple Repositories
Multiple repositories allow, for example, a local repository with minimal retention for fast restores and a remote repository with a longer retention for redundancy and access across the enterprise.
### Full, Differential, & Incremental Backups (at File or Block Level)
Full, differential, and incremental backups are supported. pgBackRest is not susceptible to the time resolution issues of rsync, making differential and incremental backups safe without the requirement to checksum each file. Block-level backups save space by only copying the parts of files that have changed.
### Backup Rotation & Archive Expiration
Retention polices can be set for full and differential backups to create coverage for any time frame. The WAL archive can be maintained for all backups or strictly for the most recent backups. In the latter case WAL required to make older backups consistent will be maintained in the archive.
### Backup Integrity
Checksums are calculated for every file in the backup and rechecked during a restore or verify. After a backup finishes copying files, it waits until every WAL segment required to make the backup consistent reaches the repository.
Backups in the repository may be stored in the same format as a standard PostgreSQL cluster (including tablespaces). If compression is disabled and hard links are enabled it is possible to snapshot a backup in the repository and bring up a PostgreSQL cluster directly on the snapshot. This is advantageous for terabyte-scale databases that are time consuming to restore in the traditional way.
All operations utilize file and directory level fsync to ensure durability.
### Page Checksums
If page checksums are enabled pgBackRest will validate the checksums for every file that is copied during a backup. All page checksums are validated during a full backup and checksums in files that have changed are validated during differential and incremental backups.
Validation failures do not stop the backup process, but warnings with details of exactly which pages have failed validation are output to the console and file log.
This feature allows page-level corruption to be detected early, before backups that contain valid copies of the data have expired.
### Backup Resume
An interrupted backup can be resumed from the point where it was stopped. Files that were already copied are compared with the checksums in the manifest to ensure integrity. Since this operation can take place entirely on the repository host, it reduces load on the PostgreSQL host and saves time since checksum calculation is faster than compressing and retransmitting data.
### Streaming Compression & Checksums
Compression and checksum calculations are performed in stream while files are being copied to the repository, whether the repository is located locally or remotely.
If the repository is on a repository host, compression is performed on the PostgreSQL host and files are transmitted in a compressed format and simply stored on the repository host. When compression is disabled a lower level of compression is utilized to make efficient use of available bandwidth while keeping CPU cost to a minimum.
### Delta Restore
The manifest contains checksums for every file in the backup so that during a restore it is possible to use these checksums to speed processing enormously. On a delta restore any files not present in the backup are first removed and then checksums are generated for the remaining files. Files that match the backup are left in place and the rest of the files are restored as usual. Parallel processing can lead to a dramatic reduction in restore times.
### Parallel, Asynchronous WAL Push & Get
Dedicated commands are included for pushing WAL to the archive and getting WAL from the archive. Both commands support parallelism to accelerate processing and run asynchronously to provide the fastest possible response time to PostgreSQL.
WAL push automatically detects WAL segments that are pushed multiple times and de-duplicates when the segment is identical, otherwise an error is raised. Asynchronous WAL push allows transfer to be offloaded to another process which compresses WAL segments in parallel for maximum throughput. This can be a critical feature for databases with extremely high write volume.
Asynchronous WAL get maintains a local queue of WAL segments that are decompressed and ready for replay. This reduces the time needed to provide WAL to PostgreSQL which maximizes replay speed. Higher-latency connections and storage (such as S3) benefit the most.
The push and get commands both ensure that the database and repository match by comparing PostgreSQL versions and system identifiers. This virtually eliminates the possibility of misconfiguring the WAL archive location.
### Tablespace & Link Support
Tablespaces are fully supported and on restore tablespaces can be remapped to any location. It is also possible to remap all tablespaces to one location with a single command which is useful for development restores.
File and directory links are supported for any file or directory in the PostgreSQL cluster. When restoring it is possible to restore all links to their original locations, remap some or all links, or restore some or all links as normal files or directories within the cluster directory.
### S3, Azure, and GCS Compatible Object Store Support
pgBackRest repositories can be located in S3, Azure, and GCS compatible object stores to allow for virtually unlimited capacity and retention.
### Encryption
pgBackRest can encrypt the repository to secure backups wherever they are stored.
### Compatibility with ten versions of PostgreSQL
pgBackRest includes support for ten versions of PostgreSQL, the five supported versions and the last five EOL versions. This allows ample time to upgrade to a supported version.
## Getting Started
pgBackRest strives to be easy to configure and operate:
- [User guides](http://www.pgbackrest.org/user-guide-index.html) for various operating systems and PostgreSQL versions.
- [Command reference](http://www.pgbackrest.org/command.html) for command-line operations.
- [Configuration reference](http://www.pgbackrest.org/configuration.html) for creating pgBackRest configurations.
Documentation for v1 can be found [here](http://www.pgbackrest.org/1). No further releases are planned for v1 because v2 is backward-compatible with v1 options and repositories.
## Contributions
Contributions to pgBackRest are always welcome! Please see our [Contributing Guidelines](https://github.com/pgbackrest/pgbackrest/blob/main/CONTRIBUTING.md) for details on how to contribute features, improvements or issues.
## Support
pgBackRest is completely free and open source under the [MIT](https://github.com/pgbackrest/pgbackrest/blob/main/LICENSE) license. You may use it for personal or commercial purposes without any restrictions whatsoever. Bug reports are taken very seriously and will be addressed as quickly as possible.
Creating a robust disaster recovery policy with proper replication and backup strategies can be a very complex and daunting task. You may find that you need help during the architecture phase and ongoing support to ensure that your enterprise continues running smoothly.
[Crunchy Data](http://www.crunchydata.com) provides packaged versions of pgBackRest for major operating systems and expert full life-cycle commercial support for pgBackRest and all things PostgreSQL. [Crunchy Data](http://www.crunchydata.com) is committed to providing open source solutions with no vendor lock-in, ensuring that cross-compatibility with the community version of pgBackRest is always strictly maintained.
Please visit [Crunchy Data](http://www.crunchydata.com) for more information.
## Recognition
Primary recognition goes to Stephen Frost for all his valuable advice and criticism during the development of pgBackRest.
[Crunchy Data](http://www.crunchydata.com) has contributed significant time and resources to pgBackRest and continues to actively support development. [Resonate](http://www.resonate.com) also contributed to the development of pgBackRest and allowed early (but well tested) versions to be installed as their primary PostgreSQL backup solution.
[Armchair](https://thenounproject.com/search/?q=lounge+chair&i=129971) graphic by [Sandor Szabo](https://thenounproject.com/sandorsz).
pgbackrest-release-2.55.1/doc/ 0000775 0000000 0000000 00000000000 15006170376 0016121 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/.gitignore 0000664 0000000 0000000 00000000010 15006170376 0020100 0 ustar 00root root 0000000 0000000 output/
pgbackrest-release-2.55.1/doc/NEWS.md 0000664 0000000 0000000 00000006571 15006170376 0017230 0 ustar 00root root 0000000 0000000 **June 12, 2023**: [Crunchy Data](https://www.crunchydata.com) is pleased to announce the release of [pgBackRest](https://pgbackrest.org/) 2.46, the latest version of the reliable, easy-to-use backup and restore solution that can seamlessly scale up to the largest databases and workloads.
Over the last year pgBackRest has introduced many exciting new features including block incremental backup, file bundling, repository verification, backup annotations, and SFTP repository storage.
IMPORTANT NOTE: pgBackRest 2.44 is the last version to support PostgreSQL 9.0/9.1/9.2.
pgBackRest supports a robust set of features for managing your backup and recovery infrastructure, including: parallel backup/restore, full/differential/incremental backups, block incremental backup, multiple repositories, delta restore, parallel asynchronous archiving, per-file checksums, page checksums (when enabled) validated during backup, multiple compression types, encryption, partial/failed backup resume, backup from standby, tablespace and link support, S3/Azure/GCS/SFTP support, backup expiration, local/remote operation via SSH or TLS, flexible configuration, and more.
pgBackRest can be installed from the [PostgreSQL Yum Repository](https://yum.postgresql.org/) or the [PostgreSQL APT Repository](https://apt.postgresql.org). Source code can be downloaded from [releases](https://github.com/pgbackrest/pgbackrest/releases).
## Major New Features
### Block Incremental Backup
Block incremental backup saves space in the repository by only storing file parts that have changed since the prior backup. In addition to space savings, this feature makes backup faster since there is less data to compress and transfer. Delta restore is also improved because less data from the repository is required to restore files. See [User Guide](https://pgbackrest.org/user-guide-rhel.html#backup/block) and [pgBackRest File Bundling and Block Incremental Backup](https://www.crunchydata.com/blog/pgbackrest-file-bundling-and-block-incremental-backup).
### File Bundling
File bundling combines smaller files to improve the efficiency of repository reads and writes, especially on object stores such as S3, Azure, and GCS. Zero-length files are stored only in the manifest. See [User Guide](https://pgbackrest.org/user-guide-rhel.html#backup/bundle) and [pgBackRest File Bundling and Block Incremental Backup](https://www.crunchydata.com/blog/pgbackrest-file-bundling-and-block-incremental-backup).
### Verify
The `verify` command checks that files in the repository have not been lost or corrupted and generates a report when problems are found. See [Command Reference](https://pgbackrest.org/command.html#command-verify).
### Backup Key/Value Annotations
Backup annotations allow custom annotations to be stored with a backup and queried with the `info` command. See [User Guide](https://pgbackrest.org/user-guide-rhel.html#backup/annotate).
### SFTP Repository Storage
Repositories can now be stored on an SFTP server. See [User Guide](https://pgbackrest.org/user-guide-rhel.html#sftp-support).
## Links
- [Website](https://pgbackrest.org)
- [User Guides](https://pgbackrest.org/user-guide-index.html)
- [Release Notes](https://pgbackrest.org/release.html)
- [Support](http://pgbackrest.org/#support)
[Crunchy Data](https://www.crunchydata.com) is proud to support the development and maintenance of [pgBackRest](https://github.com/pgbackrest/pgbackrest).
pgbackrest-release-2.55.1/doc/README.md 0000664 0000000 0000000 00000007037 15006170376 0017407 0 ustar 00root root 0000000 0000000 # pgBackRest
Building Documentation
## General Builds
The pgBackRest documentation can output a variety of formats and target several platforms and PostgreSQL versions.
This will build all documentation with defaults:
```bash
./doc.pl
```
The user guide can be built for `rhel` and `debian`. This will build the HTML user guide for RHEL:
```bash
./doc.pl --out=html --include=user-guide --var=os-type=rhel
```
Documentation generation will build a cache of all executed statements and use the cache to build the documentation quickly if no executed statements have changed. This makes proofing text-only edits very fast, but sometimes it is useful to do a full build without using the cache:
```bash
./doc.pl --out=html --include=user-guide --var=os-type=rhel --no-cache
```
Each `os-type` has a default container image that will be used as a base for creating hosts but it may be useful to change the image.
```bash
./doc.pl --out=html --include=user-guide --var=os-type=debian --var=os-image=debian:9
./doc.pl --out=html --include=user-guide --var=os-type=rhel --var=os-image=centos:7
```
The following is a sample RHEL 7 configuration that can be used for building the documentation.
```bash
# Install docker
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce
sudo systemctl start docker
# Install tools
sudo yum install -y git wget
# Install latex (for building PDF)
sudo yum install -y texlive texlive-titlesec texlive-sectsty texlive-framed texlive-epstopdf ghostscript
# Install Perl modules via CPAN that do not have packages
sudo yum install -y yum cpanminus
sudo yum groupinstall -y "Development Tools" "Development Libraries"
sudo cpanm install --force XML::Checker::Parser
# Add documentation test user
sudo groupadd test
sudo adduser -gtest -n testdoc
sudo usermod -aG docker testdoc
```
## Building with Packages
A user-specified package can be used when building the documentation. Since the documentation exercises most pgBackRest functionality this is a great way to smoke-test packages.
The package must be located within the pgBackRest repo and the specified path should be relative to the repository base. `test/package` is a good default path to use.
Ubuntu 16.04:
```bash
./doc.pl --out=html --include=user-guide --no-cache --var=os-type=debian --var=os-image=ubuntu:16.04 --var=package=test/package/pgbackrest_2.08-0_amd64.deb
```
RHEL 7:
```bash
./doc.pl --out=html --include=user-guide --no-cache --var=os-type=rhel --var=os-image=centos:7 --var=package=test/package/pgbackrest-2.08-1.el7.x86_64.rpm
```
RHEL 8:
```bash
./doc.pl --out=html --include=user-guide --no-cache --var=os-type=rhel --var=os-image=centos:8 --var=package=test/package/pgbackrest-2.08-1.el8.x86_64.rpm
```
Packages can be built with `test.pl` using the following configuration on top of the configuration given for building the documentation.
```bash
# Install recent git
sudo yum remove -y git
sudo yum install -y https://centos7.iuscommunity.org/ius-release.rpm
sudo yum install -y git2u-all
# Install Perl modules
sudo yum install -y perl-ExtUtils-ParseXS perl-ExtUtils-Embed perl-ExtUtils-MakeMaker perl-YAML-LibYAML
# Install dev libraries
sudo yum install -y libxml2-devel openssl-devel
# Add test user with sudo privileges
sudo adduser -gtest -n test
sudo usermod -aG docker test
sudo chmod 750 /home/test
sudo echo 'test ALL=(ALL) NOPASSWD: ALL' > /etc/sudoers.d/pgbackrest
# Add pgbackrest user required by tests
sudo adduser -gtest -n pgbackrest
```
pgbackrest-release-2.55.1/doc/RELEASE.md 0000664 0000000 0000000 00000015256 15006170376 0017534 0 ustar 00root root 0000000 0000000 # Release Build Instructions
## Update CI container builds
If there have been PostgreSQL minor releases since the last pgBackRest release then update the CI containers to include the latest releases. This should be committed before the release.
## Create a branch to test the release
```
git checkout -b release-ci
```
## Update the date, version, and release title
Edit the latest release in `doc/xml/release.xml`, e.g.:
```
```
to:
```
```
Edit version in `src/version.h`, e.g.:
```
#define PROJECT_VERSION "2.14dev"
```
to:
```
#define PROJECT_VERSION "2.14.0"
```
## Update code counts
```
pgbackrest/test/test.pl --code-count
```
## Build release documentation. Be sure to install latex using the instructions from the Vagrantfile before running this step.
```
pgbackrest/doc/release.pl --build
```
## Commit release branch and push to CI for testing
```
git commit -m "Release test"
git push origin release-ci
```
## Run Coverity
- Prepare Coverity build directory (update version/paths as required):
```
mkdir coverity
tar -xvf ~/Downloads/cov-analysis-linux-arm64-2024.6.1.tar.gz --strip-components=1 -C ~/coverity
export COVERITY_TOKEN=?
export COVERITY_EMAIL=?
export COVERITY_VERSION=?
```
- Clean directories and run Coverity:
```
rm -rf .cache/ccache && rm -rf build && rm -rf pgbackrest.tgz && rm -rf cov-int
meson setup -Dwerror=true -Dfatal-errors=true -Dbuildtype=debug build pgbackrest
coverity/bin/cov-build --dir cov-int ninja -C build
tar czvf pgbackrest.tgz cov-int
```
- Upload results:
```
curl --form token=${COVERITY_TOKEN?} --form email="${COVERITY_EMAIL?}" --form file=@pgbackrest.tgz \
--form version="${COVERITY_VERSION?}" --form description="dev build" \
"https://scan.coverity.com/builds?project=pgbackrest%2Fpgbackrest"
```
Check issues at https://scan.coverity.com/projects/pgbackrest-pgbackrest then fix and repeat Coverity runs as needed.
## Perform stress testing on release
- Build the documentation with stress testing enabled:
```
pgbackrest/doc/doc.pl --out=html --include=user-guide --require=/stress --var=stress=y --var=stress-scale-table=100 --var=stress-scale-data=1000 --pre --no-cache
```
During data load the archive-push and archive-get processes can be monitored with:
```
docker exec -it doc-pg-primary tail -f /var/log/pgbackrest/demo-archive-push-async.log
docker exec -it doc-pg-standby tail -f /var/log/pgbackrest/demo-archive-get-async.log
```
During backup/restore the processes can be monitored with:
```
docker exec -it doc-repository tail -f /var/log/pgbackrest/demo-backup.log
docker exec -it doc-pg-standby tail -f /var/log/pgbackrest/demo-restore.log
```
Processes can generally be monitored using 'top'. Once `top` is running, press `o` then enter `COMMAND=pgbackrest`. This will filter output to pgbackrest processes.
- Check for many log entries in the `archive-push`/`archive-get` logs to ensure async archiving was enabled:
```
docker exec -it doc-pg-primary vi /var/log/pgbackrest/demo-archive-push-async.log
docker exec -it doc-pg-standby vi /var/log/pgbackrest/demo-archive-get-async.log
```
- Check the backup log to ensure the correct tables/data were created and backed up. It should look something like:
```
INFO: full backup size = 14.9GB, file total = 101004
```
- Check the restore log to ensure the correct tables/data were restored. The size and file total should match exactly.
## Clone web documentation into `doc/site`
```
cd pgbackrest/doc
git clone git@github.com:pgbackrest/website.git site
```
## Deploy web documentation to `doc/site`
```
pgbackrest/doc/release.pl --deploy
```
## Final commit of release to integration
Create release notes based on the pattern in prior git commits (this should be automated at some point), e.g.
```
v2.14.0: Bug Fix and Improvements
Bug Fixes:
* Fix segfault when process-max > 8 for archive-push/archive-get. (Reported by User.)
Improvements:
* Bypass database checks when stanza-delete issued with force. (Contributed by User. Suggested by User.)
* Add configure script for improved multi-platform support.
Documentation Features:
* Add user guide for Debian.
```
Commit to integration with the above message and push to CI.
## Push to main
Push release commit to main once CI testing is complete.
## Create release on github
Create release notes based on pattern in prior releases (this should be automated at some point), e.g.
```
v2.14.0: Bug Fix and Improvements
**Bug Fixes**:
- Fix segfault when process-max > 8 for archive-push/archive-get. (Reported by User.)
**Improvements**:
- Bypass database checks when stanza-delete issued with force. (Contributed by User. Suggested by User.)
- Add configure script for improved multi-platform support.
**Documentation Features**:
- Add user guide for Debian.
```
The first line will be the release title and the rest will be the body. The tag field should be updated with the current version so a tag is created from main. **Be sure to select the release commit explicitly rather than auto-tagging the last commit in main!**
## Push web documentation to main and deploy
```
cd pgbackrest/doc/site
git commit -m "v2.14.0 documentation."
git push origin main
```
Deploy the documentation on `pgbackrest.org`.
## Notify packagers of new release
Notify the Debian packagers by email and RHEL packagers at https://github.com/pgdg-packaging/pgdg-rpms/issues.
## Announce release on Twitter
## Publish a postgresql.org news item when there are major new features
Start from NEWS.md and update with the new date, version, and interesting features added since the last release. News items are automatically sent to the `pgsql-announce` mailing list once they have been approved.
## Update PostgreSQL ecosystem wiki
Update version, date, and minimum supported version (when changed): https://wiki.postgresql.org/wiki/Ecosystem:Backup#pgBackRest
## Prepare for the next release
Add new release in `doc/xml/release.xml`, e.g.:
```
```
Edit version in `src/version.h`, e.g.:
```
#define PROJECT_VERSION "2.14.0"
```
to:
```
#define PROJECT_VERSION "2.15dev"
```
Run deploy to generate git history (ctrl-c as soon as the file is generated):
```
pgbackrest/doc/release.pl --build
```
Run code count to add new release file:
```
pgbackrest/test/test.pl --code-count
```
Commit and push to integration:
```
git commit -m "Begin v2.15.0 development."
git push origin integration
```
pgbackrest-release-2.55.1/doc/doc.pl 0000775 0000000 0000000 00000031452 15006170376 0017233 0 ustar 00root root 0000000 0000000 #!/usr/bin/perl
####################################################################################################################################
# doc.pl - PgBackRest Doc Builder
####################################################################################################################################
####################################################################################################################################
# Perl includes
####################################################################################################################################
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
$SIG{__DIE__} = sub { Carp::confess @_ };
use Cwd qw(abs_path);
use File::Basename qw(dirname);
use Getopt::Long qw(GetOptions);
use Pod::Usage qw(pod2usage);
use Storable;
use lib dirname(abs_path($0)) . '/lib';
use lib dirname(dirname(abs_path($0))) . '/lib';
use lib dirname(dirname(abs_path($0))) . '/build/lib';
use lib dirname(dirname(abs_path($0))) . '/test/lib';
use pgBackRestTest::Common::ExecuteTest;
use pgBackRestTest::Common::Storage;
use pgBackRestTest::Common::StoragePosix;
use pgBackRestDoc::Common::Doc;
use pgBackRestDoc::Common::DocConfig;
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::DocRender;
use pgBackRestDoc::Common::Exception;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::Html::DocHtmlSite;
use pgBackRestDoc::Latex::DocLatex;
use pgBackRestDoc::Markdown::DocMarkdown;
use pgBackRestDoc::ProjectInfo;
####################################################################################################################################
# Usage
####################################################################################################################################
=head1 NAME
doc.pl - Generate pgBackRest documentation
=head1 SYNOPSIS
doc.pl [options]
General Options:
--help Display usage and exit
--version Display pgBackRest version
--quiet Sets log level to ERROR
--log-level Log level for execution (e.g. ERROR, WARN, INFO, DEBUG)
--deploy Write exe.cache into resource for persistence
--no-exe Should commands be executed when building help? (for testing only)
--no-cache Don't use execution cache
--cache-only Only use the execution cache - don't attempt to generate it
--pre Pre-build containers for execute elements marked pre
--var Override defined variable
--key-var Override defined variable and use in cache key
--doc-path Document path to render (manifest.xml should be located here)
--out Output types (html, pdf, markdown)
--out-preserve Don't clean output directory
--require Require only certain sections of the document (to speed testing)
--include Include source in generation (links will reference website)
--exclude Exclude source from generation (links will reference website)
Variable Options:
--dev Set 'dev' variable to 'y'
--debug Set 'debug' variable to 'y'
=cut
####################################################################################################################################
# Load command line parameters and config (see usage above for details)
####################################################################################################################################
my $bHelp = false;
my $bVersion = false;
my $bQuiet = false;
my $strLogLevel = 'info';
my $bNoExe = false;
my $bNoCache = false;
my $bCacheOnly = false;
my $rhVariableOverride = {};
my $rhKeyVariableOverride = {};
my $strDocPath;
my @stryOutput;
my $bOutPreserve = false;
my @stryRequire;
my @stryInclude;
my @stryExclude;
my $bDeploy = false;
my $bDev = false;
my $bDebug = false;
my $bPre = false;
GetOptions ('help' => \$bHelp,
'version' => \$bVersion,
'quiet' => \$bQuiet,
'log-level=s' => \$strLogLevel,
'out=s@' => \@stryOutput,
'out-preserve' => \$bOutPreserve,
'require=s@' => \@stryRequire,
'include=s@' => \@stryInclude,
'exclude=s@' => \@stryExclude,
'no-exe', \$bNoExe,
'deploy', \$bDeploy,
'no-cache', \$bNoCache,
'dev', \$bDev,
'debug', \$bDebug,
'pre', \$bPre,
'cache-only', \$bCacheOnly,
'key-var=s%', $rhKeyVariableOverride,
'var=s%', $rhVariableOverride,
'doc-path=s', \$strDocPath)
or pod2usage(2);
####################################################################################################################################
# Run in eval block to catch errors
####################################################################################################################################
eval
{
# Display version and exit if requested
if ($bHelp || $bVersion)
{
print PROJECT_NAME . ' ' . PROJECT_VERSION . " Documentation Builder\n";
if ($bHelp)
{
print "\n";
pod2usage();
}
exit 0;
}
# Disable cache when no exe
if ($bNoExe)
{
$bNoCache = true;
}
# Make sure options are set correctly for deploy
if ($bDeploy)
{
my $strError = 'cannot be specified for deploy';
!$bNoExe
or confess "--no-exe ${strError}";
!@stryRequire
or confess "--require ${strError}";
}
# one --include must be specified when --required is
if (@stryRequire && @stryInclude != 1)
{
confess "one --include is required when --require is specified";
}
# Set console log level
if ($bQuiet)
{
$strLogLevel = 'error';
}
# If --dev passed then set the dev var to 'y'
if ($bDev)
{
$rhVariableOverride->{'dev'} = 'y';
}
# If --debug passed then set the debug var to 'y'
if ($bDebug)
{
$rhVariableOverride->{'debug'} = 'y';
}
# Doesn't make sense to pass include and exclude
if (@stryInclude > 0 && @stryExclude > 0)
{
confess "cannot specify both --include and --exclude";
}
logLevelSet(undef, uc($strLogLevel), OFF);
# Get the base path
my $strBasePath = abs_path(dirname($0));
my $oStorageDoc = new pgBackRestTest::Common::Storage(
$strBasePath, new pgBackRestTest::Common::StoragePosix({bFileSync => false, bPathSync => false}));
if (!defined($strDocPath))
{
$strDocPath = $strBasePath;
}
my $strOutputPath = "${strDocPath}/output";
# Create the out path if it does not exist
if (!-e $strOutputPath)
{
mkdir($strOutputPath)
or confess &log(ERROR, "unable to create path ${strOutputPath}");
}
# Merge key variables into the variable list and ensure there are no duplicates
foreach my $strKey (sort(keys(%{$rhKeyVariableOverride})))
{
if (defined($rhVariableOverride->{$strKey}))
{
confess &log(ERROR, "'${strKey}' cannot be passed as --var and --key-var");
}
$rhVariableOverride->{$strKey} = $rhKeyVariableOverride->{$strKey};
}
# Build C code
my $strBuildPath = "${strBasePath}/output/build";
my $strRepoPath = dirname($strBasePath);
my $strBuildNinja = "${strBuildPath}/build.ninja";
&log(INFO, "build C helper");
if (!-e $strBuildNinja)
{
executeTest("meson setup -Dwerror=true -Dfatal-errors=true -Dbuildtype=debug ${strBuildPath} ${strRepoPath}");
}
executeTest("ninja -C ${strBuildPath} doc/src/doc-pgbackrest");
executeTest(
"${strBuildPath}/doc/src/doc-pgbackrest --repo-path=${strRepoPath}" .
($strLogLevel ne 'info' ? " --log-level=${strLogLevel}" : ''),
{bShowOutputAsync => true});
# Load the manifest
my $oManifest = new pgBackRestDoc::Common::DocManifest(
$oStorageDoc, \@stryRequire, \@stryInclude, \@stryExclude, $rhKeyVariableOverride, $rhVariableOverride,
$strDocPath, $bDeploy, $bCacheOnly, $bPre);
if (!$bNoCache)
{
$oManifest->cacheRead();
}
# If no outputs were given
if (@stryOutput == 0)
{
@stryOutput = $oManifest->renderList();
if ($oManifest->isBackRest())
{
push(@stryOutput, 'man');
}
}
# Build host containers
if (!$bCacheOnly && !$bNoExe)
{
foreach my $strSource ($oManifest->sourceList())
{
if ((@stryInclude == 0 || grep(/$strSource/, @stryInclude)) && !grep(/$strSource/, @stryExclude))
{
&log(INFO, "source $strSource");
foreach my $oHostDefine ($oManifest->sourceGet($strSource)->{doc}->nodeList('host-define', false))
{
if ($oManifest->evaluateIf($oHostDefine))
{
my $strImage = $oManifest->variableReplace($oHostDefine->paramGet('image'));
my $strFrom = $oManifest->variableReplace($oHostDefine->paramGet('from'));
my $strDockerfile = "${strOutputPath}/doc-host.dockerfile";
&log(INFO, "Build vm '${strImage}' from '${strFrom}'");
$oStorageDoc->put(
$strDockerfile,
"FROM ${strFrom}\n\n" . trim($oManifest->variableReplace($oHostDefine->valueGet())) . "\n");
executeTest("docker build -f ${strDockerfile} -t ${strImage} ${strBasePath}", {bSuppressStdErr => true});
}
}
}
}
}
# Render output
for my $strOutput (@stryOutput)
{
&log(INFO, "render ${strOutput} output");
# Man output has already been generated in C so do not remove it
next if ($strOutput eq 'man');
# Clean contents of out directory
if (!$bOutPreserve)
{
my $strOutputPath = $strOutput eq 'pdf' ? "${strOutputPath}/latex" : "${strOutputPath}/$strOutput";
# Clean the current out path if it exists
if (-e $strOutputPath)
{
executeTest("rm -rf ${strOutputPath}/*");
}
# Else create the html path
else
{
mkdir($strOutputPath)
or confess &log(ERROR, "unable to create path ${strOutputPath}");
}
}
$oManifest->renderGet($strOutput);
if ($strOutput eq 'markdown')
{
my $oMarkdown =
new pgBackRestDoc::Markdown::DocMarkdown
(
$oManifest,
"${strBasePath}/xml",
"${strOutputPath}/markdown",
!$bNoExe
);
$oMarkdown->process();
}
elsif ($strOutput eq 'html')
{
my $oHtmlSite =
new pgBackRestDoc::Html::DocHtmlSite
(
$oManifest,
"${strBasePath}/xml",
"${strOutputPath}/html",
"${strBasePath}/resource/html/default.css",
defined($oManifest->variableGet('project-favicon')) ?
"${strBasePath}/resource/html/" . $oManifest->variableGet('project-favicon') : undef,
defined($oManifest->variableGet('project-logo')) ?
"${strBasePath}/resource/" . $oManifest->variableGet('project-logo') : undef,
!$bNoExe
);
$oHtmlSite->process();
}
elsif ($strOutput eq 'pdf')
{
my $oLatex =
new pgBackRestDoc::Latex::DocLatex
(
$oManifest,
"${strBasePath}/xml",
"${strOutputPath}/latex",
"${strBasePath}/resource/latex/preamble.tex",
!$bNoExe
);
$oLatex->process();
}
}
# Cache the manifest (mostly useful for testing rendering changes in the code)
if (!$bNoCache && !$bCacheOnly)
{
$oManifest->cacheWrite();
}
# Exit with success
exit 0;
}
####################################################################################################################################
# Check for errors
####################################################################################################################################
or do
{
# If a backrest exception then return the code
exit $EVAL_ERROR->code() if (isException(\$EVAL_ERROR));
# Else output the unhandled error
print $EVAL_ERROR;
exit ERROR_UNHANDLED;
};
# It shouldn't be possible to get here
&log(ASSERT, 'execution reached invalid location in ' . __FILE__ . ', line ' . __LINE__);
exit ERROR_ASSERT;
pgbackrest-release-2.55.1/doc/example/ 0000775 0000000 0000000 00000000000 15006170376 0017554 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/example/pgsql-pgbackrest-info.sql 0000664 0000000 0000000 00000001547 15006170376 0024506 0 ustar 00root root 0000000 0000000 -- An example of monitoring pgBackRest from within PostgreSQL
--
-- Use copy to export data from the pgBackRest info command into the jsonb
-- type so it can be queried directly by PostgreSQL.
-- Create monitor schema
create schema monitor;
-- Get pgBackRest info in JSON format
create function monitor.pgbackrest_info()
returns jsonb AS $$
declare
data jsonb;
begin
-- Create a temp table to hold the JSON data
create temp table temp_pgbackrest_data (data text);
-- Copy data into the table directly from the pgBackRest info command
copy temp_pgbackrest_data (data)
from program
'pgbackrest --output=json info' (format text);
select replace(temp_pgbackrest_data.data, E'\n', '\n')::jsonb
into data
from temp_pgbackrest_data;
drop table temp_pgbackrest_data;
return data;
end $$ language plpgsql;
pgbackrest-release-2.55.1/doc/example/pgsql-pgbackrest-query.sql 0000664 0000000 0000000 00000001140 15006170376 0024705 0 ustar 00root root 0000000 0000000 -- Get last successful backup for each stanza
--
-- Requires the monitor.pgbackrest_info function.
with stanza as
(
select data->'name' as name,
data->'backup'->(
jsonb_array_length(data->'backup') - 1) as last_backup,
data->'archive'->(
jsonb_array_length(data->'archive') - 1) as current_archive
from jsonb_array_elements(monitor.pgbackrest_info()) as data
)
select name,
to_timestamp(
(last_backup->'timestamp'->>'stop')::numeric) as last_successful_backup,
current_archive->>'max' as last_archived_wal
from stanza;
pgbackrest-release-2.55.1/doc/lib/ 0000775 0000000 0000000 00000000000 15006170376 0016667 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/ 0000775 0000000 0000000 00000000000 15006170376 0021342 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/ 0000775 0000000 0000000 00000000000 15006170376 0022572 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/Doc.pm 0000664 0000000 0000000 00000060630 15006170376 0023642 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC MODULE
####################################################################################################################################
package pgBackRestDoc::Common::Doc;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
use Cwd qw(abs_path);
use File::Basename qw(dirname);
use Scalar::Util qw(blessed);
use XML::Checker::Parser;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{strFileName},
my $strSgmlSearchPath,
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strFileName', required => false},
{name => 'strSgmlSearchPath', required => false},
);
# Load the doc from a file if one has been defined
if (defined($self->{strFileName}))
{
my $oParser = XML::Checker::Parser->new(ErrorContext => 2, Style => 'Tree');
$oParser->set_sgml_search_path(
defined($strSgmlSearchPath) ? $strSgmlSearchPath : dirname(dirname(abs_path($0))) . '/doc/xml/dtd');
my $oTree;
eval
{
local $XML::Checker::FAIL = sub
{
my $iCode = shift;
die XML::Checker::error_string($iCode, @_);
};
$oTree = $oParser->parsefile($self->{strFileName});
return true;
}
# Report any error that stopped parsing
or do
{
my $strException = $EVAL_ERROR;
$strException =~ s/at \/.*?$//s; # remove module line number
die "malformed xml in '$self->{strFileName}':\n" . trim($strException);
};
# Parse and build the doc
$self->{oDoc} = $self->build($self->parse(${$oTree}[0], ${$oTree}[1]));
}
# Else create a blank doc
else
{
$self->{oDoc} = {name => 'doc', children => []};
}
$self->{strName} = 'root';
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# parse
#
# Parse the xml doc into a more usable hash and array structure.
####################################################################################################################################
sub parse
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$oyNode
) =
logDebugParam
(
__PACKAGE__ . '->parse', \@_,
{name => 'strName', trace => true},
{name => 'oyNode', trace => true}
);
my %oOut;
my $iIndex = 0;
my $bText = $strName eq 'text' || $strName eq 'p' || $strName eq 'title' ||
$strName eq 'summary' || $strName eq 'table-cell' || $strName eq 'table-column' || $strName eq 'list-item' ||
$strName eq 'admonition';
# Store the node name
$oOut{name} = $strName;
if (keys(%{$$oyNode[$iIndex]}))
{
$oOut{param} = $$oyNode[$iIndex];
}
$iIndex++;
# Look for strings and children
while (defined($$oyNode[$iIndex]))
{
# Process string data
if (ref(\$$oyNode[$iIndex]) eq 'SCALAR' && $$oyNode[$iIndex] eq '0')
{
$iIndex++;
my $strBuffer = $$oyNode[$iIndex++];
# Strip tabs, CRs, and LFs
$strBuffer =~ s/\t|\r//g;
# If anything is left
if (length($strBuffer) > 0)
{
# If text node then create array entries for strings
if ($bText)
{
if (!defined($oOut{children}))
{
$oOut{children} = [];
}
push(@{$oOut{children}}, $strBuffer);
}
# Don't allow strings mixed with children
elsif (length(trim($strBuffer)) > 0)
{
if (defined($oOut{children}))
{
confess "text mixed with children in node ${strName} (spaces count)";
}
if (defined($oOut{value}))
{
confess "value is already defined in node ${strName} - this shouldn't happen";
}
# Don't allow text mixed with
$oOut{value} = $strBuffer;
}
}
}
# Process a child
else
{
if (defined($oOut{value}) && $bText)
{
confess "text mixed with children in node ${strName} before child " . $$oyNode[$iIndex++] . " (spaces count)";
}
if (!defined($oOut{children}))
{
$oOut{children} = [];
}
push(@{$oOut{children}}, $self->parse($$oyNode[$iIndex++], $$oyNode[$iIndex++]));
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => \%oOut, trace => true}
);
}
####################################################################################################################################
# build
#
# Restructure the doc to make walking it easier.
####################################################################################################################################
sub build
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oDoc
) =
logDebugParam
(
__PACKAGE__ . '->build', \@_,
{name => 'oDoc', trace => true}
);
# Initialize the node object
my $oOut = {name => $$oDoc{name}, children => [], value => $$oDoc{value}};
my $strError = "in node $$oDoc{name}";
# Get all params
if (defined($$oDoc{param}))
{
for my $strParam (keys %{$$oDoc{param}})
{
$$oOut{param}{$strParam} = $$oDoc{param}{$strParam};
}
}
if ($$oDoc{name} eq 'p' || $$oDoc{name} eq 'title' || $$oDoc{name} eq 'summary' ||
$$oDoc{name} eq 'table-cell' || $$oDoc{name} eq 'table-column' || $$oDoc{name} eq 'list-item' ||
$$oDoc{name} eq 'admonition')
{
$$oOut{field}{text} = $oDoc;
}
elsif (defined($$oDoc{children}))
{
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
my $oSub = $$oDoc{children}[$iIndex];
my $strName = $$oSub{name};
if ($strName eq 'text')
{
$$oOut{field}{text} = $oSub;
}
elsif ((defined($$oSub{value}) && !defined($$oSub{param})) && $strName ne 'code-block')
{
$$oOut{field}{$strName} = $$oSub{value};
}
elsif (!defined($$oSub{children}) && !defined($$oSub{value}) && !defined($$oSub{param}))
{
$$oOut{field}{$strName} = true;
}
else
{
push(@{$$oOut{children}}, $self->build($oSub));
}
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => $oOut, trace => true}
);
}
####################################################################################################################################
# nodeGetById
#
# Return a node by name - error if more than one exists
####################################################################################################################################
sub nodeGetById
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$strId,
$bRequired,
) =
logDebugParam
(
__PACKAGE__ . 'nodeGetById', \@_,
{name => 'strName', trace => true},
{name => 'strId', required => false, trace => true},
{name => 'bRequired', default => true, trace => true}
);
my $oDoc = $self->{oDoc};
my $oNode;
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
if ((defined($strName) && $$oDoc{children}[$iIndex]{name} eq $strName) &&
(!defined($strId) || $$oDoc{children}[$iIndex]{param}{id} eq $strId))
{
if (!defined($oNode))
{
$oNode = $$oDoc{children}[$iIndex];
}
else
{
confess "found more than one child ${strName} in node $$oDoc{name}";
}
}
}
if (!defined($oNode) && $bRequired)
{
confess "unable to find child ${strName}" . (defined($strId) ? " (${strId})" : '') . " in node $$oDoc{name}";
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oNodeDoc', value => $self->nodeBless($oNode), trace => true}
);
}
####################################################################################################################################
# nodeGet
#
# Return a node by name - error if more than one exists
####################################################################################################################################
sub nodeGet
{
my $self = shift;
return $self->nodeGetById(shift, undef, shift);
}
####################################################################################################################################
# nodeTest
#
# Test that a node exists
####################################################################################################################################
sub nodeTest
{
my $self = shift;
return defined($self->nodeGetById(shift, undef, false));
}
####################################################################################################################################
# nodeAdd
#
# Add a node to the current doc's child list
####################################################################################################################################
sub nodeAdd
{
my $self = shift;
my $strName = shift;
my $strValue = shift;
my $oParam = shift;
my $oField = shift;
my $oDoc = $self->{oDoc};
my $oNode = {name => $strName, value => $strValue, param => $oParam, field => $oField};
push(@{$$oDoc{children}}, $oNode);
return $self->nodeBless($oNode);
}
####################################################################################################################################
# nodeBless
#
# Make a new Doc object from a node.
####################################################################################################################################
sub nodeBless
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oNode
) =
logDebugParam
(
__PACKAGE__ . '->nodeBless', \@_,
{name => 'oNode', required => false, trace => true}
);
my $oDoc;
if (defined($oNode))
{
$oDoc = {};
bless $oDoc, $self->{strClass};
$oDoc->{strClass} = $self->{strClass};
$oDoc->{strName} = $$oNode{name};
$oDoc->{oDoc} = $oNode;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => $oDoc, trace => true}
);
}
####################################################################################################################################
# nodeList
#
# Get a list of nodes.
####################################################################################################################################
sub nodeList
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$bRequired,
) =
logDebugParam
(
__PACKAGE__ . '->nodeList', \@_,
{name => 'strName', required => false, trace => true},
{name => 'bRequired', default => true, trace => true},
);
my $oDoc = $self->{oDoc};
my @oyNode;
if (defined($$oDoc{children}))
{
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
if (!defined($strName) || $$oDoc{children}[$iIndex]{name} eq $strName)
{
if (ref(\$$oDoc{children}[$iIndex]) eq "SCALAR")
{
push(@oyNode, $$oDoc{children}[$iIndex]);
}
else
{
push(@oyNode, $self->nodeBless($$oDoc{children}[$iIndex]));
}
}
}
}
if (@oyNode == 0 && $bRequired)
{
confess 'unable to find ' . (defined($strName) ? "children named '${strName}'" : 'any children') . " in node $$oDoc{name}";
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oyNode', value => \@oyNode, trace => true}
);
}
####################################################################################################################################
# nodeRemove
#
# Remove a child node.
####################################################################################################################################
sub nodeRemove
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oChildRemove
) =
logDebugParam
(
__PACKAGE__ . '->nodeRemove', \@_,
{name => 'oChildRemove', required => false, trace => true}
);
my $bRemove = false;
my $oDoc = $self->{oDoc};
# Error if there are no children
if (!defined($$oDoc{children}))
{
confess &log(ERROR, "node has no children");
}
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
if ($$oDoc{children}[$iIndex] == $oChildRemove->{oDoc})
{
splice(@{$$oDoc{children}}, $iIndex, 1);
$bRemove = true;
last;
}
}
if (!$bRemove)
{
confess &log(ERROR, "child was not found in node, could not be removed");
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# nodeReplace
#
# Replace a child node with one or more child nodes.
####################################################################################################################################
sub nodeReplace
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oChildRemove,
$oyChildReplace,
) =
logDebugParam
(
__PACKAGE__ . '->nodeReplace', \@_,
{name => 'oChildRemove', trace => true},
{name => 'oChildReplace', trace => true},
);
my $bReplace = false;
my $iReplaceIdx = undef;
my $iReplaceTotal = undef;
my $oDoc = $self->{oDoc};
# Error if there are no children
if (!defined($$oDoc{children}))
{
confess &log(ERROR, "node has no children");
}
for (my $iIndex = 0; $iIndex < @{$$oDoc{children}}; $iIndex++)
{
if ($$oDoc{children}[$iIndex] == $oChildRemove->{oDoc})
{
splice(@{$$oDoc{children}}, $iIndex, 1);
splice(@{$$oDoc{children}}, $iIndex, 0, @{$oyChildReplace});
$iReplaceIdx = $iIndex;
$iReplaceTotal = scalar(@{$oyChildReplace});
$bReplace = true;
last;
}
}
if (!$bReplace)
{
confess &log(ERROR, "child was not found in node, could not be replaced");
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'iReplaceIdx', value => $iReplaceIdx, trace => true},
{name => 'iReplaceTotal', value => $iReplaceTotal, trace => true},
);
}
####################################################################################################################################
# nameGet
####################################################################################################################################
sub nameGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->nameGet');
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strName', value => ${$self->{oDoc}}{name}, trace => true}
);
}
####################################################################################################################################
# valueGet
####################################################################################################################################
sub valueGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->valueGet');
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strValue', value => ${$self->{oDoc}}{value}, trace => true}
);
}
####################################################################################################################################
# valueSet
####################################################################################################################################
sub valueSet
{
my $self = shift;
my $strValue = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->valueSet');
# Set the value
${$self->{oDoc}}{value} = $strValue;
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# paramGet
#
# Get a parameter from a node.
####################################################################################################################################
sub paramGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$bRequired,
$strDefault,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->paramGet', \@_,
{name => 'strName', trace => true},
{name => 'bRequired', default => true, trace => true},
{name => 'strDefault', required => false, trace => true},
{name => 'strType', default => 'param', trace => true}
);
my $strValue = ${$self->{oDoc}}{$strType}{$strName};
if (!defined($strValue))
{
if ($bRequired)
{
confess "${strType} '${strName}' is required in node '$self->{strName}'";
}
$strValue = $strDefault;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strValue', value => $strValue, trace => true}
);
}
####################################################################################################################################
# paramTest
#
# Test that a parameter exists or has a certain value.
####################################################################################################################################
sub paramTest
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$strExpectedValue,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->paramTest', \@_,
{name => 'strName', trace => true},
{name => 'strExpectedValue', required => false, trace => true},
{name => 'strType', default => 'param', trace => true}
);
my $bResult = true;
my $strValue = $self->paramGet($strName, false, undef, $strType);
if (!defined($strValue))
{
$bResult = false;
}
elsif (defined($strExpectedValue) && $strValue ne $strExpectedValue)
{
$bResult = false;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'bResult', value => $bResult, trace => true}
);
}
####################################################################################################################################
# paramSet
#
# Set a parameter in a node.
####################################################################################################################################
sub paramSet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$strValue,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->paramSet', \@_,
{name => 'strName', trace => true},
{name => 'strValue', required => false, trace => true},
{name => 'strType', default => 'param', trace => true}
);
${$self->{oDoc}}{$strType}{$strName} = $strValue;
# Return from function and log return values if any
logDebugReturn($strOperation);
}
####################################################################################################################################
# fieldGet
#
# Get a field from a node.
####################################################################################################################################
sub fieldGet
{
my $self = shift;
return $self->paramGet(shift, shift, shift, 'field');
}
####################################################################################################################################
# fieldTest
#
# Test if a field exists.
####################################################################################################################################
sub fieldTest
{
my $self = shift;
return $self->paramTest(shift, shift, 'field');
}
####################################################################################################################################
# textGet
#
# Get a field from a node.
####################################################################################################################################
sub textGet
{
my $self = shift;
return $self->nodeBless($self->paramGet('text', shift, shift, 'field'));
}
####################################################################################################################################
# textSet
#
# Get a field from a node.
####################################################################################################################################
sub textSet
{
my $self = shift;
my $oText = shift;
if (blessed($oText) && $oText->isa('pgBackRestDoc::Common::Doc'))
{
$oText = $oText->{oDoc};
}
elsif (ref($oText) ne 'HASH')
{
$oText = {name => 'text', children => [$oText]};
}
return $self->paramSet('text', $oText, 'field');
}
####################################################################################################################################
# fieldSet
#
# Set a parameter in a node.
####################################################################################################################################
sub fieldSet
{
my $self = shift;
$self->paramSet(shift, shift, 'field');
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/DocConfig.pm 0000664 0000000 0000000 00000031533 15006170376 0024770 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC CONFIG MODULE
####################################################################################################################################
package pgBackRestDoc::Common::DocConfig;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::Custom::DocConfigData;
use pgBackRestDoc::ProjectInfo;
####################################################################################################################################
# Help types
####################################################################################################################################
use constant CONFIG_HELP_COMMAND => 'command';
push @EXPORT, qw(CONFIG_HELP_COMMAND);
use constant CONFIG_HELP_DESCRIPTION => 'description';
push @EXPORT, qw(CONFIG_HELP_DESCRIPTION);
use constant CONFIG_HELP_INTERNAL => 'internal';
use constant CONFIG_HELP_OPTION => 'option';
push @EXPORT, qw(CONFIG_HELP_OPTION);
use constant CONFIG_HELP_SECTION => 'section';
push @EXPORT, qw(CONFIG_HELP_SECTION);
use constant CONFIG_HELP_SUMMARY => 'summary';
push @EXPORT, qw(CONFIG_HELP_SUMMARY);
use constant CONFIG_HELP_SOURCE => 'source';
push @EXPORT, qw(CONFIG_HELP_SOURCE);
use constant CONFIG_HELP_SOURCE_DEFAULT => 'default';
use constant CONFIG_HELP_SOURCE_SECTION => CONFIG_HELP_SECTION;
use constant CONFIG_HELP_SOURCE_COMMAND => CONFIG_HELP_COMMAND;
push @EXPORT, qw(CONFIG_HELP_SOURCE_COMMAND);
####################################################################################################################################
# Config Section Types
####################################################################################################################################
use constant CFGDEF_COMMAND => 'command';
use constant CFGDEF_GENERAL => 'general';
use constant CFGDEF_LOG => 'log';
use constant CFGDEF_REPOSITORY => 'repository';
####################################################################################################################################
# Option define hash
####################################################################################################################################
my $rhConfigDefine = cfgDefine();
####################################################################################################################################
# Returns the option defines based on the command.
####################################################################################################################################
sub docConfigCommandDefine
{
my $strOption = shift;
my $strCommand = shift;
if (defined($strCommand))
{
return defined($rhConfigDefine->{$strOption}{&CFGDEF_COMMAND}) &&
defined($rhConfigDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand}) &&
ref($rhConfigDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand}) eq 'HASH' ?
$rhConfigDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand} : undef;
}
return;
}
####################################################################################################################################
# Does the option have a default for this command?
####################################################################################################################################
sub docConfigOptionDefault
{
my $strOption = shift;
my $strCommand = shift;
# Get the command define
my $oCommandDefine = docConfigCommandDefine($strOption, $strCommand);
# Check for default in command
my $strDefault = defined($oCommandDefine) ? $$oCommandDefine{&CFGDEF_DEFAULT} : undef;
# If defined return, else try to grab the global default
return defined($strDefault) ? $strDefault : $rhConfigDefine->{$strOption}{&CFGDEF_DEFAULT};
}
push @EXPORT, qw(docConfigOptionDefault);
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oDoc},
$self->{oDocRender}
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oDoc'},
{name => 'oDocRender', required => false}
);
$self->process();
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Parse the xml doc into commands and options.
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
# Iterate through all commands
my $oDoc = $self->{oDoc};
my $oConfigHash = {};
foreach my $strCommand (cfgDefineCommandList())
{
my $oCommandDoc = $oDoc->nodeGet('operation')->nodeGet('command-list')->nodeGetById('command', $strCommand);
$$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand} = {};
my $oCommand = $$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand};
$$oCommand{&CONFIG_HELP_SUMMARY} = $oCommandDoc->nodeGet('summary')->textGet();
$$oCommand{&CONFIG_HELP_DESCRIPTION} = $oCommandDoc->textGet();
$oCommand->{&CONFIG_HELP_INTERNAL} = cfgDefineCommand()->{$strCommand}{&CFGDEF_INTERNAL};
}
# Iterate through all options
my $oOptionDefine = cfgDefine();
foreach my $strOption (sort(keys(%{$oOptionDefine})))
{
# Iterate through all commands
my @stryCommandList = sort(keys(%{defined($$oOptionDefine{$strOption}{&CFGDEF_COMMAND}) ?
$$oOptionDefine{$strOption}{&CFGDEF_COMMAND} : $$oConfigHash{&CONFIG_HELP_COMMAND}}));
foreach my $strCommand (@stryCommandList)
{
if (!defined($$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand}))
{
next;
}
# Skip the option if it is not valid for this command and the default role. Only options valid for the default role are
# show in help because that is the only role available to a user.
if (!defined($oOptionDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand}{&CFGDEF_COMMAND_ROLE}{&CFGCMD_ROLE_MAIN}))
{
next;
}
my $oCommandDoc = $oDoc->nodeGet('operation')->nodeGet('command-list')->nodeGetById('command', $strCommand);
# First check if the option is documented in the command
my $oOptionDoc;
my $strOptionSource;
my $oCommandOptionList = $oCommandDoc->nodeGet('option-list', false);
if (defined($oCommandOptionList))
{
$oOptionDoc = $oCommandOptionList->nodeGetById('option', $strOption, false);
$strOptionSource = CONFIG_HELP_SOURCE_COMMAND if (defined($oOptionDoc));
}
# If the option wasn't found keep looking
my $strSection;
if (!defined($oOptionDoc))
{
# Next see if it's documented in the section
if (defined($$oOptionDefine{$strOption}{&CFGDEF_SECTION}))
{
# &log(INFO, " trying section ${strSection}");
foreach my $oSectionNode ($oDoc->nodeGet('config')->nodeGet('config-section-list')->nodeList())
{
my $oOptionDocCheck = $oSectionNode->nodeGetById('config-key-list')
->nodeGetById('config-key', $strOption, false);
if ($oOptionDocCheck)
{
if (defined($oOptionDoc))
{
confess 'option exists in more than one section';
}
$oOptionDoc = $oOptionDocCheck;
$strOptionSource = CONFIG_HELP_SOURCE_SECTION;
$strSection = $oSectionNode->paramGet('id');
}
}
}
# If no section is defined then look in the default command option list
else
{
$oOptionDoc = $oDoc->nodeGet('operation')->nodeGet('operation-general')->nodeGet('option-list')
->nodeGetById('option', $strOption, false);
$strOptionSource = CONFIG_HELP_SOURCE_DEFAULT if (defined($oOptionDoc));
# If a section is specified then use it, otherwise the option should be general since it is not for a specific
# command
if (defined($oOptionDoc))
{
$strSection = $oOptionDoc->paramGet('section', false);
if (!defined($strSection))
{
$strSection = "general";
}
}
}
}
# If the option wasn't found then error
if (!defined($oOptionDoc))
{
confess &log(ERROR, "unable to find option '${strOption}' for command '${strCommand}'")
}
# if the option is documented in the command then it should be accessible from the command line only.
if (!defined($strSection))
{
if (defined($$oOptionDefine{$strOption}{&CFGDEF_SECTION}))
{
&log(ERROR,
"option ${strOption} defined in command ${strCommand} must not have " . CFGDEF_SECTION .
" defined");
}
}
# Store the option in the command
$$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand}{&CONFIG_HELP_OPTION}{$strOption}{&CONFIG_HELP_SOURCE} =
$strOptionSource;
my $oCommandOption = $$oConfigHash{&CONFIG_HELP_COMMAND}{$strCommand}{&CONFIG_HELP_OPTION}{$strOption};
$$oCommandOption{&CONFIG_HELP_SUMMARY} = $oOptionDoc->nodeGet('summary')->textGet();
$$oCommandOption{&CONFIG_HELP_DESCRIPTION} = $oOptionDoc->textGet();
$oCommandOption->{&CONFIG_HELP_INTERNAL} =
cfgDefineCommand()->{$strCommand}{&CFGDEF_INTERNAL} ? true : $oOptionDefine->{$strOption}{&CFGDEF_INTERNAL};
# If internal is defined for the option/command it overrides everything else
if (defined($oOptionDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand}{&CFGDEF_INTERNAL}))
{
$oCommandOption->{&CONFIG_HELP_INTERNAL} =
$oOptionDefine->{$strOption}{&CFGDEF_COMMAND}{$strCommand}{&CFGDEF_INTERNAL};
}
# If the option did not come from the command also store in global option list. This prevents duplication of commonly
# used options.
if ($strOptionSource ne CONFIG_HELP_SOURCE_COMMAND)
{
$$oConfigHash{&CONFIG_HELP_OPTION}{$strOption}{&CONFIG_HELP_SUMMARY} = $$oCommandOption{&CONFIG_HELP_SUMMARY};
my $oOption = $$oConfigHash{&CONFIG_HELP_OPTION}{$strOption};
if (defined($strSection))
{
$$oOption{&CONFIG_HELP_SECTION} = $strSection;
}
$$oOption{&CONFIG_HELP_DESCRIPTION} = $$oCommandOption{&CONFIG_HELP_DESCRIPTION};
$oOption->{&CONFIG_HELP_INTERNAL} = $oOptionDefine->{$strOption}{&CFGDEF_INTERNAL};
}
}
}
# Store the config hash
$self->{oConfigHash} = $oConfigHash;
# Return from function and log return values if any
logDebugReturn($strOperation);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/DocExecute.pm 0000664 0000000 0000000 00000113346 15006170376 0025170 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC EXECUTE MODULE
####################################################################################################################################
package pgBackRestDoc::Common::DocExecute;
use parent 'pgBackRestDoc::Common::DocRender';
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use Storable qw(dclone);
use pgBackRestTest::Common::ExecuteTest;
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::Exception;
use pgBackRestDoc::Common::Host;
use pgBackRestDoc::Common::HostGroup;
use pgBackRestDoc::Common::Ini;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::Custom::DocConfigData;
use pgBackRestDoc::ProjectInfo;
####################################################################################################################################
# User that's building the docs
####################################################################################################################################
use constant DOC_USER => getpwuid($UID) eq 'root' ? 'ubuntu' : getpwuid($UID) . '';
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType,
$oManifest,
$strRenderOutKey,
$bExe
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strType'},
{name => 'oManifest'},
{name => 'strRenderOutKey'},
{name => 'bExe'}
);
# Create the class hash
my $self = $class->SUPER::new($strType, $oManifest, $bExe, $strRenderOutKey);
bless $self, $class;
if (defined($self->{oSource}{hyCache}))
{
$self->{bCache} = true;
$self->{iCacheIdx} = 0;
}
else
{
$self->{bCache} = false;
}
$self->{bExe} = $bExe;
$self->{iCmdLineLen} = $self->{oDoc}->paramGet('cmd-line-len', false, 80);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# executeKey
#
# Get a unique key for the execution step to determine if the cache is valid.
####################################################################################################################################
sub executeKey
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strHostName,
$oCommand,
) =
logDebugParam
(
__PACKAGE__ . '->executeKey', \@_,
{name => 'strHostName', trace => true},
{name => 'oCommand', trace => true},
);
# Add user to command
my $bUserForce = $oCommand->paramTest('user-force', 'y') ? true : false;
my $strCommand = $self->{oManifest}->variableReplace(trim($oCommand->fieldGet('exe-cmd')));
my $strUser = $self->{oManifest}->variableReplace($oCommand->paramGet('user', false, DOC_USER));
$strCommand = ($strUser eq DOC_USER || $bUserForce ? '' : ('sudo ' . ($strUser eq 'root' ? '' : "-u $strUser "))) . $strCommand;
# Format and split command
$strCommand =~ s/[ ]*\n[ ]*/ \\\n /smg;
$strCommand =~ s/ \\\@ \\//smg;
my @stryCommand = split("\n", $strCommand);
my $hCacheKey =
{
host => $strHostName,
cmd => \@stryCommand,
output => JSON::PP::false,
};
$$hCacheKey{'run-as-user'} = $bUserForce ? $strUser : undef;
if (defined($oCommand->fieldGet('exe-cmd-extra', false)))
{
$$hCacheKey{'cmd-extra'} = $self->{oManifest}->variableReplace($oCommand->fieldGet('exe-cmd-extra'));
}
if (defined($oCommand->paramGet('err-expect', false)))
{
$$hCacheKey{'err-expect'} = $oCommand->paramGet('err-expect');
}
if ($oCommand->paramTest('output', 'y') || $oCommand->paramTest('show', 'y') || $oCommand->paramTest('variable-key'))
{
$$hCacheKey{'output'} = JSON::PP::true;
}
$$hCacheKey{'load-env'} = $oCommand->paramTest('load-env', 'n') ? JSON::PP::false : JSON::PP::true;
$$hCacheKey{'bash-wrap'} = $oCommand->paramTest('bash-wrap', 'n') ? JSON::PP::false : JSON::PP::true;
if (defined($oCommand->fieldGet('exe-highlight', false)))
{
$$hCacheKey{'output'} = JSON::PP::true;
$$hCacheKey{highlight}{'filter'} = $oCommand->paramTest('filter', 'n') ? JSON::PP::false : JSON::PP::true;
$$hCacheKey{highlight}{'filter-context'} = $oCommand->paramGet('filter-context', false, 2);
my @stryHighlight;
$stryHighlight[0] = $self->{oManifest}->variableReplace($oCommand->fieldGet('exe-highlight'));
$$hCacheKey{highlight}{list} = \@stryHighlight;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'hExecuteKey', value => $hCacheKey, trace => true}
);
}
####################################################################################################################################
# execute
####################################################################################################################################
sub execute
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$strHostName,
$oCommand,
$iIndent,
$bCache,
$bShow,
) =
logDebugParam
(
__PACKAGE__ . '->execute', \@_,
{name => 'oSection'},
{name => 'strHostName'},
{name => 'oCommand'},
{name => 'iIndent', optional => true, default => 1},
{name => 'bCache', optional => true, default => true},
{name => 'bShow', optional => true, default => true},
);
# Working variables
my $hCacheKey = $self->executeKey($strHostName, $oCommand);
my $strCommand = join("\n", @{$$hCacheKey{cmd}});
my $strOutput;
if ($bShow && $self->{bExe} && $self->isRequired($oSection))
{
# Make sure that no lines are greater than 80 chars
foreach my $strLine (split("\n", $strCommand))
{
if (length(trim($strLine)) > $self->{iCmdLineLen})
{
confess &log(ERROR,
"command has a line > $self->{iCmdLineLen} characters:\n${strCommand}\noffending line: ${strLine}");
}
}
}
&log(DEBUG, (' ' x $iIndent) . "execute: $strCommand");
if ($self->{oManifest}->variableReplace($oCommand->paramGet('skip', false, 'n')) ne 'y')
{
if ($self->{bExe} && $self->isRequired($oSection))
{
my ($bCacheHit, $strCacheType, $hCacheKey, $hCacheValue) = $self->cachePop('exe', $hCacheKey);
if ($bCacheHit)
{
$strOutput = defined($$hCacheValue{output}) ? join("\n", @{$$hCacheValue{output}}) : undef;
}
else
{
# Check that the host is valid
my $oHost = $self->{host}{$strHostName};
if (!defined($oHost))
{
confess &log(ERROR, "cannot execute on host ${strHostName} because the host does not exist");
}
my $oExec = $oHost->execute(
$strCommand . (defined($$hCacheKey{'cmd-extra'}) ? ' ' . $$hCacheKey{'cmd-extra'} : ''),
{iExpectedExitStatus => $$hCacheKey{'err-expect'},
bSuppressError => $oCommand->paramTest('err-suppress', 'y'),
iRetrySeconds => $oCommand->paramGet('retry', false)}, $hCacheKey->{'run-as-user'},
{bLoadEnv => $hCacheKey->{'load-env'}, bBashWrap => $hCacheKey->{'bash-wrap'}});
$oExec->begin();
$oExec->end();
if (defined($oExec->{strOutLog}) && $oExec->{strOutLog} ne '')
{
$strOutput = $oExec->{strOutLog};
# Trim off extra linefeeds before and after
$strOutput =~ s/^\n+|\n$//g;
}
if (defined($$hCacheKey{'err-expect'}) && defined($oExec->{strErrorLog}) && $oExec->{strErrorLog} ne '')
{
$strOutput .= $oExec->{strErrorLog};
}
if ($$hCacheKey{output} && defined($$hCacheKey{highlight}) && $$hCacheKey{highlight}{filter} && defined($strOutput))
{
my $strHighLight = @{$$hCacheKey{highlight}{list}}[0];
if (!defined($strHighLight))
{
confess &log(ERROR, 'filter requires highlight definition: ' . $strCommand);
}
my $iFilterContext = $$hCacheKey{highlight}{'filter-context'};
my @stryOutput = split("\n", $strOutput);
undef($strOutput);
# my $iFiltered = 0;
my $iLastOutput = -1;
for (my $iIndex = 0; $iIndex < @stryOutput; $iIndex++)
{
if ($stryOutput[$iIndex] =~ /$strHighLight/)
{
# Determine the first line to output
my $iFilterFirst = $iIndex - $iFilterContext;
# Don't go past the beginning
$iFilterFirst = $iFilterFirst < 0 ? 0 : $iFilterFirst;
# Don't repeat lines that have already been output
$iFilterFirst = $iFilterFirst <= $iLastOutput ? $iLastOutput + 1 : $iFilterFirst;
# Determine the last line to output
my $iFilterLast = $iIndex + $iFilterContext;
# Don't got past the end
$iFilterLast = $iFilterLast >= @stryOutput ? @stryOutput -1 : $iFilterLast;
# Mark filtered lines if any
if ($iFilterFirst > $iLastOutput + 1)
{
my $iFiltered = $iFilterFirst - ($iLastOutput + 1);
if ($iFiltered > 1)
{
$strOutput .= (defined($strOutput) ? "\n" : '') .
" [filtered ${iFiltered} lines of output]";
}
else
{
$iFilterFirst -= 1;
}
}
# Output the lines
for (my $iOutputIndex = $iFilterFirst; $iOutputIndex <= $iFilterLast; $iOutputIndex++)
{
$strOutput .= (defined($strOutput) ? "\n" : '') . $stryOutput[$iOutputIndex];
}
$iLastOutput = $iFilterLast;
}
}
if (@stryOutput - 1 > $iLastOutput + 1)
{
my $iFiltered = (@stryOutput - 1) - ($iLastOutput + 1);
if ($iFiltered > 1)
{
$strOutput .= (defined($strOutput) ? "\n" : '') .
" [filtered ${iFiltered} lines of output]";
}
else
{
$strOutput .= (defined($strOutput) ? "\n" : '') . $stryOutput[-1];
}
}
}
if (!$$hCacheKey{output})
{
$strOutput = undef;
}
if (defined($strOutput))
{
my @stryOutput = split("\n", $strOutput);
$$hCacheValue{output} = \@stryOutput;
}
if ($bCache)
{
$self->cachePush($strCacheType, $hCacheKey, $hCacheValue);
}
}
# Output is assigned to a var
if ($oCommand->paramTest('variable-key'))
{
$self->{oManifest}->variableSet($oCommand->paramGet('variable-key'), trim($strOutput), true);
}
}
elsif ($$hCacheKey{output})
{
$strOutput = 'Output suppressed for testing';
}
}
# Default variable output when it was not set by execution
if ($oCommand->paramTest('variable-key') && !defined($self->{oManifest}->variableGet($oCommand->paramGet('variable-key'))))
{
$self->{oManifest}->variableSet($oCommand->paramGet('variable-key'), '[Test Variable]', true);
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strCommand', value => $strCommand, trace => true},
{name => 'strOutput', value => $strOutput, trace => true}
);
}
####################################################################################################################################
# configKey
####################################################################################################################################
sub configKey
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oConfig,
) =
logDebugParam
(
__PACKAGE__ . '->hostKey', \@_,
{name => 'oConfig', trace => true},
);
my $hCacheKey =
{
host => $self->{oManifest}->variableReplace($oConfig->paramGet('host')),
file => $self->{oManifest}->variableReplace($oConfig->paramGet('file')),
};
if ($oConfig->paramTest('reset', 'y'))
{
$$hCacheKey{reset} = JSON::PP::true;
}
# Add all options to the key
my $strOptionTag = $oConfig->nameGet() eq 'backrest-config' ? 'backrest-config-option' : 'postgres-config-option';
foreach my $oOption ($oConfig->nodeList($strOptionTag))
{
my $hOption = {};
if ($oOption->paramTest('remove', 'y'))
{
$$hOption{remove} = JSON::PP::true;
}
if (defined($oOption->valueGet(false)))
{
$$hOption{value} = $self->{oManifest}->variableReplace($oOption->valueGet());
}
my $strKey = $self->{oManifest}->variableReplace($oOption->paramGet('key'));
if ($oConfig->nameGet() eq 'backrest-config')
{
my $strSection = $self->{oManifest}->variableReplace($oOption->paramGet('section'));
$$hCacheKey{option}{$strSection}{$strKey} = $hOption;
}
else
{
$$hCacheKey{option}{$strKey} = $hOption;
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'hCacheKey', value => $hCacheKey, trace => true}
);
}
####################################################################################################################################
# backrestConfig
####################################################################################################################################
sub backrestConfig
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->backrestConfig', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# Working variables
my $hCacheKey = $self->configKey($oConfig);
my $strFile = $$hCacheKey{file};
my $strConfig = undef;
&log(DEBUG, (' ' x $iDepth) . 'process backrest config: ' . $$hCacheKey{file});
if ($self->{bExe} && $self->isRequired($oSection))
{
my ($bCacheHit, $strCacheType, $hCacheKey, $hCacheValue) = $self->cachePop('cfg-' . PROJECT_EXE, $hCacheKey);
if ($bCacheHit)
{
$strConfig = defined($$hCacheValue{config}) ? join("\n", @{$$hCacheValue{config}}) : undef;
}
else
{
# Check that the host is valid
my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
my $oHost = $self->{host}{$strHostName};
if (!defined($oHost))
{
confess &log(ERROR, "cannot configure backrest on host ${strHostName} because the host does not exist");
}
# Reset all options
if ($oConfig->paramTest('reset', 'y'))
{
delete(${$self->{config}}{$strHostName}{$$hCacheKey{file}})
}
foreach my $oOption ($oConfig->nodeList('backrest-config-option'))
{
my $strSection = $self->{oManifest}->variableReplace($oOption->paramGet('section'));
my $strKey = $self->{oManifest}->variableReplace($oOption->paramGet('key'));
my $strValue;
if (!$oOption->paramTest('remove', 'y'))
{
$strValue = $self->{oManifest}->variableReplace(trim($oOption->valueGet(false)));
}
if (!defined($strValue))
{
delete(${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey});
if (keys(%{${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}}) == 0)
{
delete(${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection});
}
&log(DEBUG, (' ' x ($iDepth + 1)) . "reset ${strSection}->${strKey}");
}
else
{
# If this option is a hash and the value is already set then append to the array
if (defined(cfgDefine()->{$strKey}) &&
cfgDefine()->{$strKey}{&CFGDEF_TYPE} eq CFGDEF_TYPE_HASH &&
defined(${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey}))
{
my @oValue = ();
my $strHashValue = ${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey};
# If there is only one key/value
if (ref(\$strHashValue) eq 'SCALAR')
{
push(@oValue, $strHashValue);
}
# Else if there is an array of values
else
{
@oValue = @{$strHashValue};
}
push(@oValue, $strValue);
${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey} = \@oValue;
}
# else just set the value
else
{
${$self->{config}}{$strHostName}{$$hCacheKey{file}}{$strSection}{$strKey} = $strValue;
}
&log(DEBUG, (' ' x ($iDepth + 1)) . "set ${strSection}->${strKey} = ${strValue}");
}
}
my $strLocalFile = abs_path(dirname($0)) . '/output/pgbackrest.conf';
# Save the ini file
$self->{oManifest}->storage()->put($strLocalFile, iniRender($self->{config}{$strHostName}{$$hCacheKey{file}}, true));
$oHost->copyTo(
$strLocalFile, $$hCacheKey{file},
$self->{oManifest}->variableReplace($oConfig->paramGet('owner', false, 'postgres:postgres')), '640');
# Remove the log-console-stderr option before pushing into the cache
# ??? This is not very pretty and should be replaced with a general way to hide config options
my $oConfigClean = dclone($self->{config}{$strHostName}{$$hCacheKey{file}});
delete($$oConfigClean{&CFGDEF_SECTION_GLOBAL}{&CFGOPT_LOG_LEVEL_STDERR});
delete($$oConfigClean{&CFGDEF_SECTION_GLOBAL}{&CFGOPT_LOG_TIMESTAMP});
if (keys(%{$$oConfigClean{&CFGDEF_SECTION_GLOBAL}}) == 0)
{
delete($$oConfigClean{&CFGDEF_SECTION_GLOBAL});
}
$self->{oManifest}->storage()->put("${strLocalFile}.clean", iniRender($oConfigClean, true));
# Push config file into the cache
$strConfig = ${$self->{oManifest}->storage()->get("${strLocalFile}.clean")};
my @stryConfig = undef;
if (trim($strConfig) ne '')
{
@stryConfig = split("\n", $strConfig);
}
$$hCacheValue{config} = \@stryConfig;
$self->cachePush($strCacheType, $hCacheKey, $hCacheValue);
}
}
else
{
$strConfig = 'Config suppressed for testing';
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strFile', value => $strFile, trace => true},
{name => 'strConfig', value => $strConfig, trace => true},
{name => 'bShow', value => $oConfig->paramTest('show', 'n') ? false : true, trace => true}
);
}
####################################################################################################################################
# postgresConfig
####################################################################################################################################
sub postgresConfig
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->postgresConfig', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# Working variables
my $hCacheKey = $self->configKey($oConfig);
my $strFile = $$hCacheKey{file};
my $strConfig;
if ($self->{bExe} && $self->isRequired($oSection))
{
my ($bCacheHit, $strCacheType, $hCacheKey, $hCacheValue) = $self->cachePop('cfg-postgresql', $hCacheKey);
if ($bCacheHit)
{
$strConfig = defined($$hCacheValue{config}) ? join("\n", @{$$hCacheValue{config}}) : undef;
}
else
{
# Check that the host is valid
my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
my $oHost = $self->{host}{$strHostName};
if (!defined($oHost))
{
confess &log(ERROR, "cannot configure postgres on host ${strHostName} because the host does not exist");
}
my $strLocalFile = abs_path(dirname($0)) . '/output/postgresql.conf';
$oHost->copyFrom($$hCacheKey{file}, $strLocalFile);
if (!defined(${$self->{'pg-config'}}{$strHostName}{$$hCacheKey{file}}{base}) && $self->{bExe})
{
${$self->{'pg-config'}}{$strHostName}{$$hCacheKey{file}}{base} =
${$self->{oManifest}->storage()->get($strLocalFile)};
}
my $oConfigHash = $self->{'pg-config'}{$strHostName}{$$hCacheKey{file}};
my $oConfigHashNew;
if (!defined($$oConfigHash{old}))
{
$oConfigHashNew = {};
$$oConfigHash{old} = {}
}
else
{
$oConfigHashNew = dclone($$oConfigHash{old});
}
&log(DEBUG, (' ' x $iDepth) . 'process postgres config: ' . $$hCacheKey{file});
foreach my $oOption ($oConfig->nodeList('postgres-config-option'))
{
my $strKey = $oOption->paramGet('key');
my $strValue = $self->{oManifest}->variableReplace(trim($oOption->valueGet()));
if ($strValue eq '')
{
delete($$oConfigHashNew{$strKey});
&log(DEBUG, (' ' x ($iDepth + 1)) . "reset ${strKey}");
}
else
{
$$oConfigHashNew{$strKey} = $strValue;
&log(DEBUG, (' ' x ($iDepth + 1)) . "set ${strKey} = ${strValue}");
}
}
# Generate config text
foreach my $strKey (sort(keys(%$oConfigHashNew)))
{
if (defined($strConfig))
{
$strConfig .= "\n";
}
$strConfig .= "${strKey} = $$oConfigHashNew{$strKey}";
}
# Save the conf file
if ($self->{bExe})
{
$self->{oManifest}->storage()->put($strLocalFile, $$oConfigHash{base} .
(defined($strConfig) ? "\n# pgBackRest Configuration\n${strConfig}\n" : ''));
$oHost->copyTo($strLocalFile, $$hCacheKey{file}, 'postgres:postgres', '640');
}
$$oConfigHash{old} = $oConfigHashNew;
my @stryConfig = undef;
if (trim($strConfig) ne '')
{
@stryConfig = split("\n", $strConfig);
}
$$hCacheValue{config} = \@stryConfig;
$self->cachePush($strCacheType, $hCacheKey, $hCacheValue);
}
}
else
{
$strConfig = 'Config suppressed for testing';
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strFile', value => $strFile, trace => true},
{name => 'strConfig', value => $strConfig, trace => true},
{name => 'bShow', value => $oConfig->paramTest('show', 'n') ? false : true, trace => true}
);
}
####################################################################################################################################
# hostKey
####################################################################################################################################
sub hostKey
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oHost,
) =
logDebugParam
(
__PACKAGE__ . '->hostKey', \@_,
{name => 'oHost', trace => true},
);
my $hCacheKey =
{
name => $self->{oManifest}->variableReplace($oHost->paramGet('name')),
image => $self->{oManifest}->variableReplace($oHost->paramGet('image')),
};
if (defined($oHost->paramGet('id', false)))
{
$hCacheKey->{id} = $self->{oManifest}->variableReplace($oHost->paramGet('id'));
}
else
{
$hCacheKey->{id} = $hCacheKey->{name};
}
if (defined($oHost->paramGet('option', false)))
{
$$hCacheKey{option} = $self->{oManifest}->variableReplace($oHost->paramGet('option'));
}
if (defined($oHost->paramGet('param', false)))
{
$$hCacheKey{param} = $self->{oManifest}->variableReplace($oHost->paramGet('param'));
}
if (defined($oHost->paramGet('os', false)))
{
$$hCacheKey{os} = $self->{oManifest}->variableReplace($oHost->paramGet('os'));
}
$$hCacheKey{'update-hosts'} = $oHost->paramTest('update-hosts', 'n') ? JSON::PP::false : JSON::PP::true;
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'hCacheKey', value => $hCacheKey, trace => true}
);
}
####################################################################################################################################
# cachePop
####################################################################################################################################
sub cachePop
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strCacheType,
$hCacheKey,
) =
logDebugParam
(
__PACKAGE__ . '->hostKey', \@_,
{name => 'strCacheType', trace => true},
{name => 'hCacheKey', trace => true},
);
my $bCacheHit = false;
my $oCacheValue = undef;
if ($self->{bCache})
{
my $oJSON = JSON::PP->new()->canonical()->allow_nonref();
# &log(WARN, "checking cache for\ncurrent key: " . $oJSON->encode($hCacheKey));
my $hCache = ${$self->{oSource}{hyCache}}[$self->{iCacheIdx}];
if (!defined($hCache))
{
confess &log(ERROR, 'unable to get index from cache', ERROR_FILE_INVALID);
}
if (!defined($$hCache{key}))
{
confess &log(ERROR, 'unable to get key from cache', ERROR_FILE_INVALID);
}
if (!defined($$hCache{type}))
{
confess &log(ERROR, 'unable to get type from cache', ERROR_FILE_INVALID);
}
if ($$hCache{type} ne $strCacheType)
{
confess &log(ERROR, 'types do not match, cache is invalid', ERROR_FILE_INVALID);
}
if ($oJSON->encode($$hCache{key}) ne $oJSON->encode($hCacheKey))
{
confess &log(ERROR,
"keys at index $self->{iCacheIdx} do not match, cache is invalid." .
"\n cache key: " . $oJSON->encode($$hCache{key}) .
"\ncurrent key: " . $oJSON->encode($hCacheKey), ERROR_FILE_INVALID);
}
$bCacheHit = true;
$oCacheValue = $$hCache{value};
$self->{iCacheIdx}++;
}
else
{
if ($self->{oManifest}{bCacheOnly})
{
confess &log(ERROR, 'Cache only operation forced by --cache-only option');
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'bCacheHit', value => $bCacheHit, trace => true},
{name => 'strCacheType', value => $strCacheType, trace => true},
{name => 'hCacheKey', value => $hCacheKey, trace => true},
{name => 'oCacheValue', value => $oCacheValue, trace => true},
);
}
####################################################################################################################################
# cachePush
####################################################################################################################################
sub cachePush
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType,
$hCacheKey,
$oCacheValue,
) =
logDebugParam
(
__PACKAGE__ . '->hostKey', \@_,
{name => 'strType', trace => true},
{name => 'hCacheKey', trace => true},
{name => 'oCacheValue', required => false, trace => true},
);
if ($self->{bCache})
{
confess &log(ASSERT, "cachePush should not be called when cache is already present");
}
# Create the cache entry
my $hCache =
{
key => $hCacheKey,
type => $strType,
};
if (defined($oCacheValue))
{
$$hCache{value} = $oCacheValue;
}
push @{$self->{oSource}{hyCache}}, $hCache;
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# sectionChildProcess
####################################################################################################################################
sub sectionChildProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oChild,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->sectionChildProcess', \@_,
{name => 'oSection'},
{name => 'oChild'},
{name => 'iDepth'}
);
&log(DEBUG, (' ' x ($iDepth + 1)) . 'process child: ' . $oChild->nameGet());
# Execute a command
if ($oChild->nameGet() eq 'host-add')
{
if ($self->{bExe} && $self->isRequired($oSection))
{
my ($bCacheHit, $strCacheType, $hCacheKey, $hCacheValue) = $self->cachePop('host', $self->hostKey($oChild));
if ($bCacheHit)
{
$self->{oManifest}->variableSet('host-' . $hCacheKey->{id} . '-ip', $hCacheValue->{ip}, true);
}
else
{
if (defined($self->{host}{$$hCacheKey{name}}))
{
confess &log(ERROR, 'cannot add host ${strName} because the host already exists');
}
executeTest("rm -rf ~/data/$$hCacheKey{name}");
executeTest("mkdir -p ~/data/$$hCacheKey{name}/etc");
my $strHost = $hCacheKey->{name};
my $strImage = $hCacheKey->{image};
my $strHostUser = $self->{oManifest}->variableReplace($oChild->paramGet('user'));
# Determine if a pre-built image should be created
if (defined($self->preExecute($strHost)))
{
my $strPreImage = "${strImage}-${strHost}";
my $strFrom = $strImage;
&log(INFO, "Build vm '${strPreImage}' from '${strFrom}'");
my $strCommandList;
# Add all pre commands
foreach my $oExecute ($self->preExecute($strHost))
{
my $hExecuteKey = $self->executeKey($strHost, $oExecute);
my $strCommand =
join("\n", @{$hExecuteKey->{cmd}}) .
(defined($hExecuteKey->{'cmd-extra'}) ? ' ' . $hExecuteKey->{'cmd-extra'} : '');
$strCommand =~ s/'/'\\''/g;
$strCommand =
"sudo -u ${strHostUser}" .
($hCacheKey->{'bash-wrap'} ?
" bash" . ($hCacheKey->{'load-env'} ? ' -l' : '') . " -c '${strCommand}'" : " ${strCommand}");
if (defined($strCommandList))
{
$strCommandList .= "\n";
}
$strCommandList .= "RUN ${strCommand}";
&log(DETAIL, " Pre command $strCommand");
}
# Build container
my $strDockerfile = $self->{oManifest}{strDocPath} . "/output/doc-host.dockerfile";
$self->{oManifest}{oStorage}->put(
$strDockerfile,
"FROM ${strFrom}\n\n" . trim($self->{oManifest}->variableReplace($strCommandList)) . "\n");
executeTest(
"docker build -f ${strDockerfile} -t ${strPreImage} " . $self->{oManifest}{oStorage}->pathGet(),
{bSuppressStdErr => true});
# Use the pre-built image
$strImage = $strPreImage;
}
my $strHostRepoPath = dirname(dirname(abs_path($0)));
# Replace host repo path in mounts with if present
my $strMount = undef;
if (defined($oChild->paramGet('mount', false)))
{
$strMount = $self->{oManifest}->variableReplace($oChild->paramGet('mount'));
$strMount =~ s/\{\[host\-repo\-path\]\}/${strHostRepoPath}/g;
}
# Replace host repo mount in params if present
my $strOption = $$hCacheKey{option};
if (defined($strOption))
{
$strOption =~ s/\{\[host\-repo\-path\]\}/${strHostRepoPath}/g;
}
my $oHost = new pgBackRestDoc::Common::Host(
$$hCacheKey{name}, "doc-$$hCacheKey{name}", $strImage, $strHostUser,
defined($strMount) ? [$strMount] : undef, $strOption, $$hCacheKey{param}, $$hCacheKey{'update-hosts'});
$self->{host}{$$hCacheKey{name}} = $oHost;
$self->{oManifest}->variableSet('host-' . $hCacheKey->{id} . '-ip', $oHost->{strIP}, true);
$$hCacheValue{ip} = $oHost->{strIP};
# Add to the host group
my $oHostGroup = hostGroupGet();
$oHostGroup->hostAdd($oHost);
# Execute initialize commands
foreach my $oExecute ($oChild->nodeList('execute', false))
{
$self->execute(
$oSection, $$hCacheKey{name}, $oExecute, {iIndent => $iDepth + 1, bCache => false, bShow => false});
}
$self->cachePush($strCacheType, $hCacheKey, $hCacheValue);
}
}
}
# Skip children that have already been processed and error on others
elsif ($oChild->nameGet() ne 'title')
{
confess &log(ASSERT, 'unable to process child type ' . $oChild->nameGet());
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation
);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/DocManifest.pm 0000664 0000000 0000000 00000064215 15006170376 0025334 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC MANIFEST MODULE
####################################################################################################################################
package pgBackRestDoc::Common::DocManifest;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use JSON::PP;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
####################################################################################################################################
# File constants
####################################################################################################################################
use constant FILE_MANIFEST => 'manifest.xml';
####################################################################################################################################
# Render constants
####################################################################################################################################
use constant RENDER => 'render';
use constant RENDER_COMPACT => 'compact';
push @EXPORT, qw(RENDER_COMPACT);
use constant RENDER_FILE => 'file';
use constant RENDER_MENU => 'menu';
push @EXPORT, qw(RENDER_MENU);
use constant RENDER_PRETTY => 'pretty';
push @EXPORT, qw(RENDER_PRETTY);
use constant RENDER_TYPE => 'type';
use constant RENDER_TYPE_HTML => 'html';
push @EXPORT, qw(RENDER_TYPE_HTML);
use constant RENDER_TYPE_MARKDOWN => 'markdown';
push @EXPORT, qw(RENDER_TYPE_MARKDOWN);
use constant RENDER_TYPE_PDF => 'pdf';
push @EXPORT, qw(RENDER_TYPE_PDF);
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oStorage},
$self->{stryRequire},
$self->{stryInclude},
$self->{stryExclude},
$self->{rhKeyVariableOverride},
my $rhVariableOverride,
$self->{strDocPath},
$self->{bDeploy},
$self->{bCacheOnly},
$self->{bPre},
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oStorage'},
{name => 'stryRequire'},
{name => 'stryInclude'},
{name => 'stryExclude'},
{name => 'rhKeyVariableOverride', required => false},
{name => 'rhVariableOverride', required => false},
{name => 'strDocPath', required => false},
{name => 'bDeploy', required => false},
{name => 'bCacheOnly', required => false},
{name => 'bPre', required => false, default => false},
);
# Set the bin path
$self->{strBinPath} = abs_path(dirname($0));
# Set the base path if it was not passed in
if (!defined($self->{strDocPath}))
{
$self->{strDocPath} = $self->{strBinPath};
}
# Set cache file names
$self->{strExeCacheLocal} = $self->{strDocPath} . "/output/exe.cache";
$self->{strExeCacheDeploy} = $self->{strDocPath} . "/resource/exe.cache";
# Load the manifest
$self->{oManifestXml} = new pgBackRestDoc::Common::Doc("$self->{strDocPath}/manifest.xml");
# Iterate the sources
$self->{oManifest} = {};
foreach my $oSource ($self->{oManifestXml}->nodeGet('source-list')->nodeList('source'))
{
my $oSourceHash = {};
my $strKey = $oSource->paramGet('key');
my $strFile = $oSource->paramGet('file', false);
my $strSourceType = $oSource->paramGet('type', false);
logDebugMisc
(
$strOperation, 'load source',
{name => 'strKey', value => $strKey},
{name => 'strFile', value => $strFile},
{name => 'strSourceType', value => $strSourceType}
);
# Skip sources in exclude list
if (grep(/^$strKey$/, @{$self->{stryExclude}}))
{
next;
}
# If file is defined
if (defined($strFile))
{
$oSourceHash->{doc} = new pgBackRestDoc::Common::Doc($self->{strDocPath} . "/${strFile}");
}
# Else should be in doc/xml
else
{
$$oSourceHash{doc} = new pgBackRestDoc::Common::Doc("$self->{strDocPath}/xml/${strKey}.xml");
}
# Read variables from source
$self->variableListParse($$oSourceHash{doc}->nodeGet('variable-list', false), $rhVariableOverride);
${$self->{oManifest}}{source}{$strKey} = $oSourceHash;
${$self->{oManifest}}{source}{$strKey}{strSourceType} = $strSourceType;
}
# Iterate the renderers
foreach my $oRender ($self->{oManifestXml}->nodeGet('render-list')->nodeList('render'))
{
my $oRenderHash = {};
my $strType = $oRender->paramGet(RENDER_TYPE);
# Only one instance of each render type can be defined
if (defined(${$self->{oManifest}}{&RENDER}{$strType}))
{
confess &log(ERROR, "render ${strType} has already been defined");
}
# Get the file param
$${oRenderHash}{file} = $oRender->paramGet(RENDER_FILE, false);
$${oRenderHash}{&RENDER_COMPACT} = $oRender->paramGet(RENDER_COMPACT, false, 'n') eq 'y' ? true : false;
$${oRenderHash}{&RENDER_PRETTY} = $oRender->paramGet(RENDER_PRETTY, false, 'n') eq 'y' ? true : false;
$${oRenderHash}{&RENDER_MENU} = false;
logDebugMisc
(
$strOperation, ' load render',
{name => 'strType', value => $strType},
{name => 'strFile', value => $${oRenderHash}{file}}
);
# Error if file is set and render type is not pdf
if (defined($${oRenderHash}{file}) && $strType ne RENDER_TYPE_PDF)
{
confess &log(ERROR, 'only the pdf render type can have file set')
}
# Iterate the render sources
foreach my $oRenderOut ($oRender->nodeList('render-source'))
{
my $oRenderOutHash = {};
my $strKey = $oRenderOut->paramGet('key');
my $strSource = $oRenderOut->paramGet('source', false, $strKey);
# Skip sources in exclude list
if (grep(/^$strSource$/, @{$self->{stryExclude}}))
{
next;
}
# Skip sources not in include list
if (@{$self->{stryInclude}} > 0 && !grep(/^$strSource$/, @{$self->{stryInclude}}))
{
next;
}
# Preserve natural order
push(@{$${oRenderHash}{stryOrder}}, $strKey);
$$oRenderOutHash{source} = $strSource;
# Get the filename
if (defined($oRenderOut->paramGet('file', false)))
{
if ($strType eq RENDER_TYPE_HTML || $strType eq RENDER_TYPE_MARKDOWN)
{
$$oRenderOutHash{file} = $oRenderOut->paramGet('file');
}
else
{
confess &log(ERROR, "file is only valid with html or markdown render types");
}
}
# Get the menu caption
if (defined($oRenderOut->paramGet('menu', false)) && $strType ne RENDER_TYPE_HTML)
{
confess &log(ERROR, "menu is only valid with html render type");
}
if (defined($oRenderOut->paramGet('menu', false)))
{
$${oRenderHash}{&RENDER_MENU} = true;
if ($strType eq RENDER_TYPE_HTML)
{
$$oRenderOutHash{menu} = $oRenderOut->paramGet('menu', false);
}
else
{
confess &log(ERROR, 'only the html render type can have menu set');
}
}
logDebugMisc
(
$strOperation, ' load render source',
{name => 'strKey', value => $strKey},
{name => 'strSource', value => $strSource},
{name => 'strMenu', value => $${oRenderOutHash}{menu}}
);
$${oRenderHash}{out}{$strKey} = $oRenderOutHash;
}
${$self->{oManifest}}{render}{$strType} = $oRenderHash;
}
# Set the doc path variable
$self->variableSet('doc-path', $self->{strDocPath});
# Read variables from manifest
$self->variableListParse($self->{oManifestXml}->nodeGet('variable-list', false), $rhVariableOverride);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# isBackRest
#
# Until all the backrest specific code can be abstracted, this function will identify when BackRest docs are being built.
####################################################################################################################################
sub isBackRest
{
my $self = shift;
return($self->variableTest('project-exe', 'pgbackrest'));
}
####################################################################################################################################
# Evaluate the if condition for a node
####################################################################################################################################
sub evaluateIf
{
my $self = shift;
my $oNode = shift;
my $bIf = true;
# Evaluate if condition
if (defined($oNode->paramGet('if', false)))
{
my $strIf = $self->variableReplace($oNode->paramGet('if'));
# In this case we really do want to evaluate the contents and not treat it as a literal
$bIf = eval($strIf);
# Error if the eval failed
if ($@)
{
confess &log(ERROR, "unable to evaluate '${strIf}': $@");
}
}
return $bIf;
}
####################################################################################################################################
# variableListParse
#
# Parse a variable list and store variables.
####################################################################################################################################
sub variableListParse
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oVariableList,
$rhVariableOverride
) =
logDebugParam
(
__PACKAGE__ . '->variableListParse', \@_,
{name => '$oVariableList', required => false},
{name => '$rhVariableOverride', required => false}
);
if (defined($oVariableList))
{
foreach my $oVariable ($oVariableList->nodeList('variable'))
{
if ($self->evaluateIf($oVariable))
{
my $strKey = $oVariable->paramGet('key');
my $strValue = $self->variableReplace($oVariable->valueGet());
if ($oVariable->paramTest('eval', 'y'))
{
# In this case we really do want to evaluate the contents of strValue and not treat it as a literal.
$strValue = eval($strValue);
if ($@)
{
confess &log(ERROR, "unable to evaluate ${strKey}: $@\n" . $oVariable->valueGet());
}
}
$self->variableSet($strKey, defined($rhVariableOverride->{$strKey}) ? $rhVariableOverride->{$strKey} : $strValue);
logDebugMisc
(
$strOperation, ' load variable',
{name => 'strKey', value => $strKey},
{name => 'strValue', value => $strValue}
);
}
}
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# variableReplace
#
# Replace variables in the string.
####################################################################################################################################
sub variableReplace
{
my $self = shift;
my $strBuffer = shift;
my $strType = shift;
if (!defined($strBuffer))
{
return;
}
foreach my $strName (sort(keys(%{$self->{oVariable}})))
{
# If the value is not defined then replace it as an empty string. This means the key *was* defined but no value given.
my $strValue = defined($self->{oVariable}{$strName}) ? $self->{oVariable}{$strName} : '';
$strBuffer =~ s/\{\[$strName\]\}/$strValue/g;
}
if (defined($strType) && $strType eq 'latex')
{
$strBuffer =~ s/\\\_/\_/g;
$strBuffer =~ s/\_/\\\_/g;
$strBuffer =~ s/\\\#/\#/g;
$strBuffer =~ s/\#/\\\#/g;
}
return $strBuffer;
}
####################################################################################################################################
# variableSet
#
# Set a variable to be replaced later.
####################################################################################################################################
sub variableSet
{
my $self = shift;
my $strKey = shift;
my $strValue = shift;
my $bForce = shift;
if (defined(${$self->{oVariable}}{$strKey}) && (!defined($bForce) || !$bForce))
{
confess &log(ERROR, "${strKey} variable is already defined");
}
${$self->{oVariable}}{$strKey} = $self->variableReplace($strValue);
}
####################################################################################################################################
# variableGet
#
# Get the current value of a variable.
####################################################################################################################################
sub variableGet
{
my $self = shift;
my $strKey = shift;
return ${$self->{oVariable}}{$strKey};
}
####################################################################################################################################
# variableTest
#
# Test that a variable is defined or has an expected value.
####################################################################################################################################
sub variableTest
{
my $self = shift;
my $strKey = shift;
my $strExpectedValue = shift;
# Get the variable
my $strValue = ${$self->{oVariable}}{$strKey};
# Return false if it is not defined
if (!defined($strValue))
{
return false;
}
# Return false if it does not equal the expected value
if (defined($strExpectedValue) && $strValue ne $strExpectedValue)
{
return false;
}
return true;
}
####################################################################################################################################
# Get list of source documents
####################################################################################################################################
sub sourceList
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->sourceList');
# Check that sources exist
my @strySource;
if (defined(${$self->{oManifest}}{source}))
{
@strySource = sort(keys(%{${$self->{oManifest}}{source}}));
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strySource', value => \@strySource}
);
}
####################################################################################################################################
# sourceGet
####################################################################################################################################
sub sourceGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strSource
) =
logDebugParam
(
__PACKAGE__ . '->sourceGet', \@_,
{name => 'strSource', trace => true}
);
if (!defined(${$self->{oManifest}}{source}{$strSource}))
{
confess &log(ERROR, "source ${strSource} does not exist");
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oSource', value => ${$self->{oManifest}}{source}{$strSource}}
);
}
####################################################################################################################################
# renderList
####################################################################################################################################
sub renderList
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->renderList');
# Check that the render output exists
my @stryRender;
if (defined(${$self->{oManifest}}{render}))
{
@stryRender = sort(keys(%{${$self->{oManifest}}{render}}));
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'stryRender', value => \@stryRender}
);
}
####################################################################################################################################
# renderGet
####################################################################################################################################
sub renderGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->renderGet', \@_,
{name => 'strType', trace => true}
);
# Check that the render exists
if (!defined(${$self->{oManifest}}{render}{$strType}))
{
confess &log(ERROR, "render type ${strType} does not exist");
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oRenderOut', value => ${$self->{oManifest}}{render}{$strType}}
);
}
####################################################################################################################################
# renderOutList
####################################################################################################################################
sub renderOutList
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType
) =
logDebugParam
(
__PACKAGE__ . '->renderOutList', \@_,
{name => 'strType'}
);
# Check that the render output exists
my @stryRenderOut;
if (defined(${$self->{oManifest}}{render}{$strType}))
{
@stryRenderOut = sort(keys(%{${$self->{oManifest}}{render}{$strType}{out}}));
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'stryRenderOut', value => \@stryRenderOut}
);
}
####################################################################################################################################
# renderOutGet
####################################################################################################################################
sub renderOutGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strType,
$strKey,
$bIgnoreMissing,
) =
logDebugParam
(
__PACKAGE__ . '->renderOutGet', \@_,
{name => 'strType', trace => true},
{name => 'strKey', trace => true},
{name => 'bIgnoreMissing', default => false, trace => true},
);
if (!defined(${$self->{oManifest}}{render}{$strType}{out}{$strKey}) && !$bIgnoreMissing)
{
confess &log(ERROR, "render out ${strKey} does not exist");
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oRenderOut', value => ${$self->{oManifest}}{render}{$strType}{out}{$strKey}}
);
}
####################################################################################################################################
# cacheKey
####################################################################################################################################
sub cacheKey
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->cacheKey');
# Generate a cache key from the variable override
my $strVariableKey = JSON::PP->new()->canonical()->allow_nonref()->encode($self->{rhKeyVariableOverride});
if ($strVariableKey eq '{}')
{
$strVariableKey = 'default';
}
my $strRequire = defined($self->{stryRequire}) && @{$self->{stryRequire}} > 0 ?
join("\n", @{$self->{stryRequire}}) : 'all';
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strVariableKey', value => $strVariableKey},
{name => 'strRequire', value => $strRequire},
);
}
####################################################################################################################################
# cacheRead
####################################################################################################################################
sub cacheRead
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->cacheRead');
$self->{hCache} = undef;
my $strCacheFile = $self->{bDeploy} ? $self->{strExeCacheDeploy} : $self->{strExeCacheLocal};
if (!$self->storage()->exists($strCacheFile) && !$self->{bDeploy})
{
$strCacheFile = $self->{strExeCacheDeploy};
}
if ($self->storage()->exists($strCacheFile))
{
my ($strCacheKey, $strRequire) = $self->cacheKey();
my $oJSON = JSON::PP->new()->allow_nonref();
$self->{hCache} = $oJSON->decode(${$self->storage()->get($strCacheFile)});
foreach my $strSource (sort(keys(%{${$self->{oManifest}}{source}})))
{
my $hSource = ${$self->{oManifest}}{source}{$strSource};
if (defined(${$self->{hCache}}{$strCacheKey}{$strRequire}{$strSource}))
{
$$hSource{hyCache} = ${$self->{hCache}}{$strCacheKey}{$strRequire}{$strSource};
&log(DETAIL, "cache load $strSource (key = ${strCacheKey}, require = ${strRequire})");
}
}
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# cacheWrite
####################################################################################################################################
sub cacheWrite
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->cacheWrite');
my $strCacheFile = $self->{bDeploy} ? $self->{strExeCacheDeploy} : $self->{strExeCacheLocal};
my ($strCacheKey, $strRequire) = $self->cacheKey();
foreach my $strSource (sort(keys(%{${$self->{oManifest}}{source}})))
{
my $hSource = ${$self->{oManifest}}{source}{$strSource};
if (defined($$hSource{hyCache}))
{
${$self->{hCache}}{$strCacheKey}{$strRequire}{$strSource} = $$hSource{hyCache};
&log(DETAIL, "cache load $strSource (key = ${strCacheKey}, require = ${strRequire})");
}
}
if (defined($self->{hCache}))
{
my $oJSON = JSON::PP->new()->canonical()->allow_nonref()->pretty();
$self->storage()->put($strCacheFile, $oJSON->encode($self->{hCache}));
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# cacheReset
####################################################################################################################################
sub cacheReset
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strSource
) =
logDebugParam
(
__PACKAGE__ . '->cacheReset', \@_,
{name => 'strSource', trace => true}
);
if ($self->{bCacheOnly})
{
confess &log(ERROR, 'Cache reset disabled by --cache-only option');
}
&log(WARN, "Cache will be reset for source ${strSource} and rendering retried automatically");
delete(${$self->{oManifest}}{source}{$strSource}{hyCache});
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# Getters
####################################################################################################################################
sub storage {shift->{oStorage}};
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/DocRender.pm 0000664 0000000 0000000 00000106405 15006170376 0025003 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC RENDER MODULE
####################################################################################################################################
package pgBackRestDoc::Common::DocRender;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Exporter qw(import);
our @EXPORT = qw();
use JSON::PP;
use Storable qw(dclone);
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
####################################################################################################################################
# XML tag/param constants
####################################################################################################################################
use constant XML_SECTION_PARAM_ANCHOR => 'anchor';
push @EXPORT, qw(XML_SECTION_PARAM_ANCHOR);
use constant XML_SECTION_PARAM_ANCHOR_VALUE_NOINHERIT => 'no-inherit';
push @EXPORT, qw(XML_SECTION_PARAM_ANCHOR_VALUE_NOINHERIT);
####################################################################################################################################
# Render tags for various output types
####################################################################################################################################
my $oRenderTag =
{
'markdown' =>
{
'br' => ['\n', ''],
'quote' => ['"', '"'],
'b' => ['**', '**'],
'i' => ['_', '_'],
# 'bi' => ['_**', '**_'],
'list-item' => ["\n", ""],
'list-item' => ['- ', "\n"],
'id' => ['`', '`'],
'file' => ['`', '`'],
'path' => ['`', '`'],
'cmd' => ['`', '`'],
'param' => ['`', '`'],
'setting' => ['`', '`'],
'pg-setting' => ['`', '`'],
'code' => ['`', '`'],
# 'code-block' => ['```', '```'],
# 'exe' => [undef, ''],
'backrest' => [undef, ''],
'proper' => ['', ''],
'postgres' => ['PostgreSQL', ''],
'admonition' => ["\n> **", "\n"],
},
'text' =>
{
'br' => ['\n', ''],
'quote' => ['"', '"'],
'p' => ['', "\n\n"],
'b' => ['', ''],
'i' => ['', ''],
# 'bi' => ['', ''],
'list' => ["", "\n"],
'list-item' => ['* ', "\n"],
'id' => ['', ''],
'host' => ['', ''],
'file' => ['', ''],
'path' => ['', ''],
'cmd' => ['', ''],
'br-option' => ['', ''],
'pg-setting' => ['', ''],
'param' => ['', ''],
'setting' => ['', ''],
'code' => ['', ''],
'code-block' => ['', ''],
'exe' => [undef, ''],
'backrest' => [undef, ''],
'proper' => ['', ''],
'postgres' => ['PostgreSQL', ''],
'admonition' => ['', "\n\n"],
},
'latex' =>
{
'br' => ['\\\vspace{1em}', ''],
'quote' => ['``', '"'],
'p' => ["\n\\begin{sloppypar}", "\\end{sloppypar}\n"],
'b' => ['\textbf{', '}'],
'i' => ['\textit{', '}'],
# 'bi' => ['', ''],
'list' => ["\\begin{itemize}\n", "\\end{itemize}\n"],
'list-item' => ['\item ', "\n"],
'id' => ['\textnormal{\texttt{', '}}'],
'host' => ['\textnormal{\textbf{', '}}'],
'file' => ['\textnormal{\texttt{', '}}'],
'path' => ['\textnormal{\texttt{', '}}'],
'cmd' => ['\textnormal{\texttt{', "}}"],
'user' => ['\textnormal{\texttt{', '}}'],
'br-option' => ['', ''],
# 'param' => ['\texttt{', '}'],
# 'setting' => ['\texttt{', '}'],
'br-option' => ['\textnormal{\texttt{', '}}'],
'br-setting' => ['\textnormal{\texttt{', '}}'],
'pg-option' => ['\textnormal{\texttt{', '}}'],
'pg-setting' => ['\textnormal{\texttt{', '}}'],
'code' => ['\textnormal{\texttt{', '}}'],
# 'code' => ['\texttt{', '}'],
# 'code-block' => ['', ''],
# 'exe' => [undef, ''],
'backrest' => [undef, ''],
'proper' => ['\textnormal{\texttt{', '}}'],
'postgres' => ['PostgreSQL', ''],
'admonition' =>
["\n\\vspace{.5em}\\begin{leftbar}\n\\begin{sloppypar}\\textit{\\textbf{", "}\\end{sloppypar}\n\\end{leftbar}\n"],
},
'html' =>
{
'br' => ['
', ''],
'quote' => ['', '
'],
'b' => ['', ''],
'i' => ['', ''],
'p' => ['', ''],
# 'bi' => ['', ''],
'list' => ['', '
'],
'list-item' => ['', ' '],
'id' => ['', ''],
'host' => ['', ''],
'file' => ['', ''],
'path' => ['', ''],
'cmd' => ['', ''],
'user' => ['', ''],
'br-option' => ['', ''],
'br-setting' => ['', ''],
'pg-option' => ['', ''],
'pg-setting' => ['', ''],
'code' => ['', ''],
'code-block' => ['', ' '],
'exe' => [undef, ''],
'setting' => ['', ''], # ??? This will need to be fixed
'backrest' => [undef, ''],
'proper' => ['', ''],
'postgres' => ['PostgreSQL', ''],
'admonition' => ['', ''],
}
};
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{strType},
$self->{oManifest},
$self->{bExe},
$self->{strRenderOutKey},
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strType'},
{name => 'oManifest', required => false},
{name => 'bExe', required => false},
{name => 'strRenderOutKey', required => false}
);
# Create JSON object
$self->{oJSON} = JSON::PP->new()->allow_nonref();
# Initialize project tags
$$oRenderTag{markdown}{backrest}[0] = "{[project]}";
$$oRenderTag{markdown}{exe}[0] = "{[project-exe]}";
$$oRenderTag{text}{backrest}[0] = "{[project]}";
$$oRenderTag{text}{exe}[0] = "{[project-exe]}";
$$oRenderTag{latex}{backrest}[0] = "{[project]}";
$$oRenderTag{latex}{exe}[0] = "\\textnormal\{\\texttt\{[project-exe]}}\}\}";
$$oRenderTag{html}{backrest}[0] = "{[project]}";
$$oRenderTag{html}{exe}[0] = "{[project-exe]}";
if (defined($self->{strRenderOutKey}))
{
# Copy page data to self
my $oRenderOut =
$self->{oManifest}->renderOutGet($self->{strType} eq 'latex' ? 'pdf' : $self->{strType}, $self->{strRenderOutKey});
# If these are the backrest docs then load the help
if ($self->{oManifest}->isBackRest())
{
$self->{oReference} =
new pgBackRestDoc::Common::DocConfig(${$self->{oManifest}->sourceGet('help')}{doc}, $self);
}
if (defined($$oRenderOut{source}) && $$oRenderOut{source} eq 'release' && $self->{oManifest}->isBackRest())
{
require pgBackRestDoc::Custom::DocCustomRelease;
pgBackRestDoc::Custom::DocCustomRelease->import();
$self->{oDoc} =
(new pgBackRestDoc::Custom::DocCustomRelease(
${$self->{oManifest}->sourceGet('release')}{doc},
defined($self->{oManifest}->variableGet('dev')) && $self->{oManifest}->variableGet('dev') eq 'y'))->docGet();
}
else
{
$self->{oDoc} = ${$self->{oManifest}->sourceGet($self->{strRenderOutKey})}{doc};
}
$self->{oSource} = $self->{oManifest}->sourceGet($$oRenderOut{source});
}
if (defined($self->{strRenderOutKey}))
{
# Build the doc
$self->build($self->{oDoc});
# Get required sections
foreach my $strPath (@{$self->{oManifest}->{stryRequire}})
{
if (substr($strPath, 0, 1) ne '/')
{
confess &log(ERROR, "path ${strPath} must begin with a /");
}
if (!defined($self->{oSection}->{$strPath}))
{
confess &log(ERROR, "required section '${strPath}' does not exist");
}
if (defined(${$self->{oSection}}{$strPath}))
{
$self->required($strPath);
}
}
}
if (defined($self->{oDoc}))
{
$self->{bToc} = !defined($self->{oDoc}->paramGet('toc', false)) || $self->{oDoc}->paramGet('toc') eq 'y' ? true : false;
$self->{bTocNumber} =
$self->{bToc} &&
(!defined($self->{oDoc}->paramGet('toc-number', false)) || $self->{oDoc}->paramGet('toc-number') eq 'y') ? true : false;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# Set begin and end values for a tag
####################################################################################################################################
sub tagSet
{
my $self = shift;
my $strTag = shift;
my $strBegin = shift;
my $strEnd = shift;
$oRenderTag->{$self->{strType}}{$strTag}[0] = defined($strBegin) ? $strBegin : '';
$oRenderTag->{$self->{strType}}{$strTag}[1] = defined($strEnd) ? $strEnd : '';
}
####################################################################################################################################
# variableReplace
#
# Replace variables in the string.
####################################################################################################################################
sub variableReplace
{
my $self = shift;
return defined($self->{oManifest}) ? $self->{oManifest}->variableReplace(shift, $self->{strType}) : shift;
}
####################################################################################################################################
# variableSet
#
# Set a variable to be replaced later.
####################################################################################################################################
sub variableSet
{
my $self = shift;
return $self->{oManifest}->variableSet(shift, shift);
}
####################################################################################################################################
# variableGet
#
# Get the current value of a variable.
####################################################################################################################################
sub variableGet
{
my $self = shift;
return $self->{oManifest}->variableGet(shift);
}
####################################################################################################################################
# Get pre-execute list for a host
####################################################################################################################################
sub preExecute
{
my $self = shift;
my $strHost = shift;
if (defined($self->{preExecute}{$strHost}))
{
return @{$self->{preExecute}{$strHost}};
}
return;
}
####################################################################################################################################
# build
#
# Build the section map and perform filtering.
####################################################################################################################################
sub build
{
my $self = shift;
my $oNode = shift;
my $oParent = shift;
my $strPath = shift;
my $strPathPrefix = shift;
# &log(INFO, " node " . $oNode->nameGet());
my $strName = $oNode->nameGet();
if (defined($oParent))
{
# Evaluate if condition -- when false the node will be removed
if (!$self->{oManifest}->evaluateIf($oNode))
{
my $strDescription;
if (defined($oNode->nodeGet('title', false)))
{
$strDescription = $self->processText($oNode->nodeGet('title')->textGet());
}
&log(DEBUG, " filtered ${strName}" . (defined($strDescription) ? ": ${strDescription}" : ''));
$oParent->nodeRemove($oNode);
return;
}
}
else
{
&log(DEBUG, ' build document');
$self->{oSection} = {};
}
# Build section
if ($strName eq 'section')
{
my $strSectionId = $oNode->paramGet('id');
&log(DEBUG, "build section [${strSectionId}]");
# Set path and parent-path for this section
if (defined($strPath))
{
$oNode->paramSet('path-parent', $strPath);
}
$strPath .= '/' . $oNode->paramGet('id');
&log(DEBUG, " path ${strPath}");
${$self->{oSection}}{$strPath} = $oNode;
$oNode->paramSet('path', $strPath);
# If depend is not set then set it to the last section
my $strDepend = $oNode->paramGet('depend', false);
my $oContainerNode = defined($oParent) ? $oParent : $self->{oDoc};
my $oLastChild;
my $strDependPrev;
foreach my $oChild ($oContainerNode->nodeList('section', false))
{
if ($oChild->paramGet('id') eq $oNode->paramGet('id'))
{
if (defined($oLastChild))
{
$strDependPrev = $oLastChild->paramGet('id');
}
elsif (defined($oParent->paramGet('depend', false)))
{
$strDependPrev = $oParent->paramGet('depend');
}
last;
}
$oLastChild = $oChild;
}
if (defined($strDepend))
{
if (defined($strDependPrev) && $strDepend eq $strDependPrev && !$oNode->paramTest('depend-default'))
{
&log(WARN,
"section '${strPath}' depend is set to '${strDepend}' which is the default, best to remove" .
" because it may become obsolete if a new section is added in between");
}
}
else
{
$strDepend = $strDependPrev;
}
# If depend is defined make sure it exists
if (defined($strDepend))
{
# If this is a relative depend then prepend the parent section
if (index($strDepend, '/') != 0)
{
if (defined($oParent->paramGet('path', false)))
{
$strDepend = $oParent->paramGet('path') . '/' . $strDepend;
}
else
{
$strDepend = "/${strDepend}";
}
}
if (!defined($self->{oSection}->{$strDepend}))
{
confess &log(ERROR, "section '${strSectionId}' depend '${strDepend}' is not valid");
}
}
if (defined($strDepend))
{
$oNode->paramSet('depend', $strDepend);
}
if (defined($strDependPrev))
{
$oNode->paramSet('depend-default', $strDependPrev);
}
# Set log to true if this section has an execute list. This helps reduce the info logging by only showing sections that are
# likely to take a log time.
$oNode->paramSet('log', $self->{bExe} && $oNode->nodeList('execute-list', false) > 0 ? true : false);
# If section content is being pulled from elsewhere go get the content
if ($oNode->paramTest('source'))
{
my $oSource = ${$self->{oManifest}->sourceGet($oNode->paramGet('source'))}{doc};
# Section should not already have title defined, it should come from the source doc
if ($oNode->nodeTest('title'))
{
confess &log(ERROR, "cannot specify title in section that sources another document");
}
# Set title from source doc's title
$oNode->nodeAdd('title')->textSet($oSource->paramGet('title'));
foreach my $oSection ($oSource->nodeList('section'))
{
push(@{${$oNode->{oDoc}}{children}}, $oSection->{oDoc});
}
# Set path prefix to modify all section paths further down
$strPathPrefix = $strPath;
# Remove source so it is not included again later
$oNode->paramSet('source', undef);
}
}
# Build link
elsif ($strName eq 'link')
{
&log(DEBUG, 'build link [' . $oNode->valueGet() . ']');
# If the path prefix is set and this is a section
if (defined($strPathPrefix) && $oNode->paramTest('section'))
{
my $strNewPath = $strPathPrefix . $oNode->paramGet('section');
&log(DEBUG, "modify link section from '" . $oNode->paramGet('section') . "' to '${strNewPath}'");
$oNode->paramSet('section', $strNewPath);
}
}
# Store block defines
elsif ($strName eq 'block-define')
{
my $strBlockId = $oNode->paramGet('id');
if (defined($self->{oyBlockDefine}{$strBlockId}))
{
confess &log(ERROR, "block ${strBlockId} is already defined");
}
$self->{oyBlockDefine}{$strBlockId} = dclone($oNode->{oDoc}{children});
$oParent->nodeRemove($oNode);
}
# Copy blocks
elsif ($strName eq 'block')
{
my $strBlockId = $oNode->paramGet('id');
if (!defined($self->{oyBlockDefine}{$strBlockId}))
{
confess &log(ERROR, "block ${strBlockId} is not defined");
}
my $strNodeJSON = $self->{oJSON}->encode($self->{oyBlockDefine}{$strBlockId});
foreach my $oVariable ($oNode->nodeList('block-variable-replace', false))
{
my $strVariableKey = $oVariable->paramGet('key');
my $strVariableReplace = $oVariable->valueGet();
$strNodeJSON =~ s/\{\[$strVariableKey\]\}/$strVariableReplace/g;
}
my ($iReplaceIdx, $iReplaceTotal) = $oParent->nodeReplace($oNode, $self->{oJSON}->decode($strNodeJSON));
# Build any new children that were added
my $iChildIdx = 0;
foreach my $oChild ($oParent->nodeList(undef, false))
{
if ($iChildIdx >= $iReplaceIdx && $iChildIdx < ($iReplaceIdx + $iReplaceTotal))
{
$self->build($oChild, $oParent, $strPath, $strPathPrefix);
}
$iChildIdx++;
}
}
# Check for pre-execute statements
elsif ($strName eq 'execute')
{
if ($self->{oManifest}->{bPre} && $oNode->paramGet('pre', false, 'n') eq 'y')
{
# Add to pre-execute list
my $strHost = $self->variableReplace($oParent->paramGet('host'));
push(@{$self->{preExecute}{$strHost}}, $oNode);
# Skip this command so it doesn't get executed twice
$oNode->paramSet('skip', 'y')
}
}
# Iterate all text nodes
if (defined($oNode->textGet(false)))
{
foreach my $oChild ($oNode->textGet()->nodeList(undef, false))
{
if (ref(\$oChild) ne "SCALAR")
{
$self->build($oChild, $oNode, $strPath, $strPathPrefix);
}
}
}
# Iterate all non-text nodes
foreach my $oChild ($oNode->nodeList(undef, false))
{
if (ref(\$oChild) ne "SCALAR")
{
$self->build($oChild, $oNode, $strPath, $strPathPrefix);
# If the child should be logged then log the parent as well so the hierarchy is complete
if ($oChild->nameGet() eq 'section' && $oChild->paramGet('log', false, false))
{
$oNode->paramSet('log', true);
}
}
}
}
####################################################################################################################################
# required
#
# Build a list of required sections
####################################################################################################################################
sub required
{
my $self = shift;
my $strPath = shift;
my $bDepend = shift;
# If node is not found that means the path is invalid
my $oNode = ${$self->{oSection}}{$strPath};
if (!defined($oNode))
{
confess &log(ERROR, "invalid path ${strPath}");
}
# Only add sections that are listed dependencies
if (!defined($bDepend) || $bDepend)
{
# Match section and all child sections
foreach my $strChildPath (sort(keys(%{$self->{oSection}})))
{
if ($strChildPath =~ /^$strPath$/ || $strChildPath =~ /^$strPath\/.*$/)
{
if (!defined(${$self->{oSectionRequired}}{$strChildPath}))
{
my @stryChildPath = split('/', $strChildPath);
&log(INFO, (' ' x (scalar(@stryChildPath) - 2)) . " require section: ${strChildPath}");
${$self->{oSectionRequired}}{$strChildPath} = true;
}
}
}
}
# Get the path of the current section's parent
my $strParentPath = $oNode->paramGet('path-parent', false);
if ($oNode->paramTest('depend'))
{
foreach my $strDepend (split(',', $oNode->paramGet('depend')))
{
if ($strDepend !~ /^\//)
{
if (!defined($strParentPath))
{
$strDepend = "/${strDepend}";
}
else
{
$strDepend = "${strParentPath}/${strDepend}";
}
}
$self->required($strDepend, true);
}
}
elsif (defined($strParentPath))
{
$self->required($strParentPath, false);
}
}
####################################################################################################################################
# isRequired
#
# Is it required to execute the section statements?
####################################################################################################################################
sub isRequired
{
my $self = shift;
my $oSection = shift;
if (!defined($self->{oSectionRequired}))
{
return true;
}
my $strPath = $oSection->paramGet('path');
defined(${$self->{oSectionRequired}}{$strPath}) ? true : false;
}
####################################################################################################################################
# processTag
####################################################################################################################################
sub processTag
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oTag
) =
logDebugParam
(
__PACKAGE__ . '->processTag', \@_,
{name => 'oTag', trace => true}
);
my $strBuffer = "";
my $strType = $self->{strType};
my $strTag = $oTag->nameGet();
if (!defined($strTag))
{
require Data::Dumper;
confess Dumper($oTag);
}
if ($strTag eq 'link')
{
my $strUrl = $oTag->paramGet('url', false);
if (!defined($strUrl))
{
my $strPage = $self->variableReplace($oTag->paramGet('page', false));
my $strSection = $oTag->paramGet('section', false);
# If a page/section link points to the current page then remove the page portion
if (defined($strPage) && defined($strSection) && defined($self->{strRenderOutKey}) &&
$strPage eq $self->{strRenderOutKey})
{
undef($strPage);
}
# If this is a page URL
if (defined($strPage))
{
# If the page wasn't rendered then point at the website
if (!defined($self->{oManifest}->renderOutGet($strType, $strPage, true)))
{
$strUrl = '{[backrest-url-base]}/' . $oTag->paramGet('page') . '.html';
}
# Else point locally
else
{
if ($strType eq 'html')
{
$strUrl = "${strPage}.html". (defined($strSection) ? '#' . substr($strSection, 1) : '');
}
elsif ($strType eq 'markdown')
{
if (defined($strSection))
{
confess &log(
ERROR,
"page and section links not supported for type ${strType}, value '" . $oTag->valueGet() . "'");
}
$strUrl = "${strPage}.md";
}
else
{
confess &log(ERROR, "page links not supported for type ${strType}, value '" . $oTag->valueGet() . "'");
}
}
}
else
{
my $strSection = $oTag->paramGet('section');
my $oSection = ${$self->{oSection}}{$strSection};
if (!defined($oSection))
{
confess &log(ERROR, "section link '${strSection}' does not exist");
}
if (!defined($strSection))
{
confess &log(ERROR, "link with value '" . $oTag->valueGet() . "' must defined url, page, or section");
}
if ($strType eq 'html')
{
$strUrl = '#' . substr($strSection, 1);
}
elsif ($strType eq 'latex')
{
$strUrl = $strSection;
}
else
{
$strUrl = lc($self->processText($oSection->nodeGet('title')->textGet()));
$strUrl =~ s/[^\w\- ]//g;
$strUrl =~ s/ /-/g;
$strUrl = '#' . $strUrl;
}
}
}
if ($strType eq 'html')
{
$strBuffer = '' . $oTag->valueGet() . '';
}
elsif ($strType eq 'markdown')
{
$strBuffer = '[' . $oTag->valueGet() . '](' . $strUrl . ')';
}
elsif ($strType eq 'latex')
{
if ($oTag->paramTest('url'))
{
$strBuffer = "\\href{$strUrl}{" . $oTag->valueGet() . "}";
}
else
{
$strBuffer = "\\hyperref[$strUrl]{" . $oTag->valueGet() . "}";
}
}
elsif ($strType eq 'text')
{
$strBuffer = $oTag->valueGet();
}
else
{
confess "'link' tag not valid for type ${strType}";
}
}
else
{
my $strStart = $$oRenderTag{$strType}{$strTag}[0];
my $strStop = $$oRenderTag{$strType}{$strTag}[1];
if (!defined($strStart) || !defined($strStop))
{
confess &log(ERROR, "invalid type ${strType} or tag ${strTag}");
}
$strBuffer .= $strStart;
# Admonitions in the help materials are tags of the text element rather than field elements of the document so special
# handling is required
if ($strTag eq 'admonition')
{
$strBuffer .= $self->processAdmonitionStart($oTag);
}
if ($strTag eq 'p' || $strTag eq 'title' || $strTag eq 'list-item' || $strTag eq 'code-block' || $strTag eq 'summary'
|| $strTag eq 'admonition')
{
$strBuffer .= $self->processText($oTag);
}
elsif (defined($oTag->valueGet()))
{
$strBuffer .= $oTag->valueGet();
}
else
{
foreach my $oSubTag ($oTag->nodeList(undef, false))
{
$strBuffer .= $self->processTag($oSubTag);
}
}
if ($strTag eq 'admonition')
{
$strBuffer .= $self->processAdmonitionEnd($oTag);
}
$strBuffer .= $strStop;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strBuffer', value => $strBuffer, trace => true}
);
}
####################################################################################################################################
# processAdmonitionStart
####################################################################################################################################
sub processAdmonitionStart
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oTag
) =
logDebugParam
(
__PACKAGE__ . '->processAdmonitionStart', \@_,
{name => 'oTag', trace => true}
);
my $strType = $self->{strType};
my $strBuffer = '';
# Note that any changes to the way the HTML, markdown or latex display tags may also need to be made here
if ($strType eq 'html')
{
my $strType = $oTag->paramGet('type');
$strBuffer = '' . uc($strType) . ':' .
'';
}
elsif ($strType eq 'text' || $strType eq 'markdown')
{
$strBuffer = uc($oTag->paramGet('type')) . ": ";
}
elsif ($strType eq 'latex')
{
$strBuffer = uc($oTag->paramGet('type')) . ": }";
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strBuffer', value => $strBuffer, trace => true}
);
}
####################################################################################################################################
# processAdmonitionEnd
####################################################################################################################################
sub processAdmonitionEnd
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oTag
) =
logDebugParam
(
__PACKAGE__ . '->processAdmonitionEnd', \@_,
{name => 'oTag', trace => true}
);
my $strType = $self->{strType};
my $strBuffer = '';
# Note that any changes to the way the HTML, markdown or latex display tags may also need to be made here
if ($strType eq 'html')
{
$strBuffer = '';
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strBuffer', value => $strBuffer, trace => true}
);
}
####################################################################################################################################
# processText
####################################################################################################################################
sub processText
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oText
) =
logDebugParam
(
__PACKAGE__ . '->processText', \@_,
{name => 'oText', trace => true}
);
my $strType = $self->{strType};
my $strBuffer = '';
my $strLastTag = 'body';
foreach my $oNode ($oText->nodeList(undef, false))
{
if (ref(\$oNode) eq "SCALAR")
{
if ($oNode =~ /\"/)
{
confess &log(ERROR, "unable to process quotes in string (use instead):\n${oNode}");
}
# Skip text nodes with linefeeds since they happen between tags
if (index($oNode, "\n") == -1)
{
$strBuffer .= $oNode;
}
}
else
{
# Add br tags to separate paragraphs and linefeeds to make the output more diffable. This is needed because of the hacky
# way config text is being rendered in the final document, i.e. by passing rendered HTML into divs rather than XML to be
# rendered at that time.
if ($strLastTag eq 'p' && $strType eq 'html')
{
$strBuffer .= "
\n";
if ($oNode->nameGet() eq 'p')
{
$strBuffer .= "
\n";
}
}
$strBuffer .= $self->processTag($oNode);
$strLastTag = $oNode->nameGet();
}
}
#
# if ($strType eq 'html')
# {
# # $strBuffer =~ s/^\s+|\s+$//g;
#
# $strBuffer =~ s/\n/\\n/g;
# }
# if ($strType eq 'markdown')
# {
# $strBuffer =~ s/^\s+|\s+$//g;
$strBuffer =~ s/ +/ /g;
$strBuffer =~ s/^ //smg;
# }
if ($strType eq 'latex')
{
$strBuffer =~ s/\&mdash\;/---/g;
$strBuffer =~ s/\<\;/\\=/\$\\geq\$/g;
# $strBuffer =~ s/\_/\\_/g;
# If not a code-block, which is to be taken AS IS, then escape special characters in latex
if ($oText->nameGet() ne 'code-block')
{
# If the previous character is not already a slash (e.g. not already escaped) then insert a slash
$strBuffer =~ s/(?nameGet() eq 'list-item')
{
$strBuffer =~ s/\[/\{\[/g;
$strBuffer =~ s/\]/\]\}/g;
}
$strBuffer =~ s/\©\;/{\\textcopyright}/g;
$strBuffer =~ s/\&trade\;/{\\texttrademark}/g;
$strBuffer =~ s/\®\;/{\\textregistered}/g;
$strBuffer =~ s/\&rarr\;/{\\textrightarrow}/g;
# Escape all ampersands after making any other conversions above
$strBuffer =~ s/(?\=/g;
}
$strBuffer = $self->variableReplace($strBuffer);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strBuffer', value => $strBuffer, trace => true}
);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/Exception.pm 0000664 0000000 0000000 00000025370 15006170376 0025075 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# COMMON EXCEPTION MODULE
####################################################################################################################################
package pgBackRestDoc::Common::Exception;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess longmess);
use Scalar::Util qw(blessed);
use Exporter qw(import);
our @EXPORT = qw();
####################################################################################################################################
# Error Definitions
####################################################################################################################################
use constant ERROR_MINIMUM => 25;
push @EXPORT, qw(ERROR_MINIMUM);
use constant ERROR_MAXIMUM => 125;
push @EXPORT, qw(ERROR_MAXIMUM);
use constant ERROR_ASSERT => 25;
push @EXPORT, qw(ERROR_ASSERT);
use constant ERROR_CHECKSUM => 26;
push @EXPORT, qw(ERROR_CHECKSUM);
use constant ERROR_CONFIG => 27;
push @EXPORT, qw(ERROR_CONFIG);
use constant ERROR_FILE_INVALID => 28;
push @EXPORT, qw(ERROR_FILE_INVALID);
use constant ERROR_FORMAT => 29;
push @EXPORT, qw(ERROR_FORMAT);
use constant ERROR_OPTION_INVALID_VALUE => 32;
push @EXPORT, qw(ERROR_OPTION_INVALID_VALUE);
use constant ERROR_PG_RUNNING => 38;
push @EXPORT, qw(ERROR_PG_RUNNING);
use constant ERROR_PATH_NOT_EMPTY => 40;
push @EXPORT, qw(ERROR_PATH_NOT_EMPTY);
use constant ERROR_FILE_OPEN => 41;
push @EXPORT, qw(ERROR_FILE_OPEN);
use constant ERROR_FILE_READ => 42;
push @EXPORT, qw(ERROR_FILE_READ);
use constant ERROR_ARCHIVE_MISMATCH => 44;
push @EXPORT, qw(ERROR_ARCHIVE_MISMATCH);
use constant ERROR_ARCHIVE_DUPLICATE => 45;
push @EXPORT, qw(ERROR_ARCHIVE_DUPLICATE);
use constant ERROR_PATH_CREATE => 47;
push @EXPORT, qw(ERROR_PATH_CREATE);
use constant ERROR_LOCK_ACQUIRE => 50;
push @EXPORT, qw(ERROR_LOCK_ACQUIRE);
use constant ERROR_BACKUP_MISMATCH => 51;
push @EXPORT, qw(ERROR_BACKUP_MISMATCH);
use constant ERROR_PATH_OPEN => 53;
push @EXPORT, qw(ERROR_PATH_OPEN);
use constant ERROR_PATH_SYNC => 54;
push @EXPORT, qw(ERROR_PATH_SYNC);
use constant ERROR_FILE_MISSING => 55;
push @EXPORT, qw(ERROR_FILE_MISSING);
use constant ERROR_DB_CONNECT => 56;
push @EXPORT, qw(ERROR_DB_CONNECT);
use constant ERROR_DB_QUERY => 57;
push @EXPORT, qw(ERROR_DB_QUERY);
use constant ERROR_DB_MISMATCH => 58;
push @EXPORT, qw(ERROR_DB_MISMATCH);
use constant ERROR_PATH_REMOVE => 61;
push @EXPORT, qw(ERROR_PATH_REMOVE);
use constant ERROR_STOP => 62;
push @EXPORT, qw(ERROR_STOP);
use constant ERROR_FILE_WRITE => 64;
push @EXPORT, qw(ERROR_FILE_WRITE);
use constant ERROR_FEATURE_NOT_SUPPORTED => 67;
push @EXPORT, qw(ERROR_FEATURE_NOT_SUPPORTED);
use constant ERROR_ARCHIVE_COMMAND_INVALID => 68;
push @EXPORT, qw(ERROR_ARCHIVE_COMMAND_INVALID);
use constant ERROR_LINK_EXPECTED => 69;
push @EXPORT, qw(ERROR_LINK_EXPECTED);
use constant ERROR_LINK_DESTINATION => 70;
push @EXPORT, qw(ERROR_LINK_DESTINATION);
use constant ERROR_PATH_MISSING => 73;
push @EXPORT, qw(ERROR_PATH_MISSING);
use constant ERROR_FILE_MOVE => 74;
push @EXPORT, qw(ERROR_FILE_MOVE);
use constant ERROR_PATH_TYPE => 77;
push @EXPORT, qw(ERROR_PATH_TYPE);
use constant ERROR_DB_MISSING => 80;
push @EXPORT, qw(ERROR_DB_MISSING);
use constant ERROR_DB_INVALID => 81;
push @EXPORT, qw(ERROR_DB_INVALID);
use constant ERROR_ARCHIVE_TIMEOUT => 82;
push @EXPORT, qw(ERROR_ARCHIVE_TIMEOUT);
use constant ERROR_ARCHIVE_DISABLED => 87;
push @EXPORT, qw(ERROR_ARCHIVE_DISABLED);
use constant ERROR_FILE_OWNER => 88;
push @EXPORT, qw(ERROR_FILE_OWNER);
use constant ERROR_PATH_EXISTS => 92;
push @EXPORT, qw(ERROR_PATH_EXISTS);
use constant ERROR_FILE_EXISTS => 93;
push @EXPORT, qw(ERROR_FILE_EXISTS);
use constant ERROR_CRYPTO => 95;
push @EXPORT, qw(ERROR_CRYPTO);
use constant ERROR_INVALID => 123;
push @EXPORT, qw(ERROR_INVALID);
use constant ERROR_UNHANDLED => 124;
push @EXPORT, qw(ERROR_UNHANDLED);
use constant ERROR_UNKNOWN => 125;
push @EXPORT, qw(ERROR_UNKNOWN);
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
my $strLevel = shift; # Log level
my $iCode = shift; # Error code
my $strMessage = shift; # ErrorMessage
my $strTrace = shift; # Stack trace
my $rExtra = shift; # Extra info used exclusively by the logging system
my $bErrorC = shift; # Is this a C error?
if ($iCode < ERROR_MINIMUM || $iCode > ERROR_MAXIMUM)
{
$iCode = ERROR_INVALID;
}
# Create the class hash
my $self = {};
bless $self, $class;
# Initialize exception
$self->{strLevel} = $strLevel;
$self->{iCode} = $iCode;
$self->{strMessage} = $strMessage;
$self->{strTrace} = $strTrace;
$self->{rExtra} = $rExtra;
$self->{bErrorC} = $bErrorC ? 1 : 0;
return $self;
}
####################################################################################################################################
# level
####################################################################################################################################
sub level
{
my $self = shift;
return $self->{strLevel};
}
####################################################################################################################################
# CODE
####################################################################################################################################
sub code
{
my $self = shift;
return $self->{iCode};
}
####################################################################################################################################
# extra
####################################################################################################################################
sub extra
{
my $self = shift;
return $self->{rExtra};
}
####################################################################################################################################
# MESSAGE
####################################################################################################################################
sub message
{
my $self = shift;
return $self->{strMessage};
}
####################################################################################################################################
# TRACE
####################################################################################################################################
sub trace
{
my $self = shift;
return $self->{strTrace};
}
####################################################################################################################################
# isException - is this a structured exception or a default Perl exception?
####################################################################################################################################
sub isException
{
my $roException = shift;
# Only check if defined
if (defined($roException) && defined($$roException))
{
# If a standard Exception
if (blessed($$roException))
{
return $$roException->isa('pgBackRestDoc::Common::Exception') ? 1 : 0;
}
# Else if a specially formatted string from the C library
elsif ($$roException =~ /^PGBRCLIB\:[0-9]+\:/)
{
# Split message and discard the first part used for identification
my @stryException = split(/\:/, $$roException);
shift(@stryException);
# Construct exception fields
my $iCode = shift(@stryException) + 0;
my $strTrace = shift(@stryException) . qw{:} . shift(@stryException);
my $strMessage = join(':', @stryException);
# Create exception
$$roException = new pgBackRestDoc::Common::Exception("ERROR", $iCode, $strMessage, $strTrace, undef, 1);
return 1;
}
}
return 0;
}
push @EXPORT, qw(isException);
####################################################################################################################################
# exceptionCode
#
# Extract the error code from an exception - if a Perl exception return ERROR_UNKNOWN.
####################################################################################################################################
sub exceptionCode
{
my $oException = shift;
return isException(\$oException) ? $oException->code() : ERROR_UNKNOWN;
}
push @EXPORT, qw(exceptionCode);
####################################################################################################################################
# exceptionMessage
#
# Extract the error message from an exception - if a Perl exception return bare exception.
####################################################################################################################################
sub exceptionMessage
{
my $oException = shift;
return isException(\$oException) ? $oException->message() : $oException;
}
push @EXPORT, qw(exceptionMessage);
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/Host.pm 0000664 0000000 0000000 00000025014 15006170376 0024047 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# HostTest.pm - Encapsulate a docker host
####################################################################################################################################
package pgBackRestDoc::Common::Host;
####################################################################################################################################
# Perl includes
####################################################################################################################################
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestTest::Common::ExecuteTest;
####################################################################################################################################
# new
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{strName},
$self->{strContainer},
$self->{strImage},
$self->{strUser},
$self->{stryMount},
$self->{strOption},
$self->{strParam},
$self->{bHostUpdate},
$self->{strEntryPoint},
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strName', trace => true},
{name => 'strContainer', trace => true},
{name => 'strImage', trace => true},
{name => 'strUser', trace => true},
{name => 'stryMount', required => false, trace => true},
{name => 'strOption', required => false, trace => true},
{name => 'strParam', required => false, trace => true},
{name => 'bHostUpdate', required => false, trace => true, default => true},
{name => 'strEntryPoint', required => false, trace => true},
);
executeTest("docker rm -f $self->{strContainer}", {bSuppressError => true});
executeTest("docker run -itd -h $self->{strName} --name=$self->{strContainer}" .
(defined($self->{strOption}) ? ' ' . $self->{strOption} : '') .
(defined($self->{stryMount}) ? ' -v ' . join(' -v ', @{$self->{stryMount}}) : '') .
(defined($self->{strEntryPoint}) ? " --entrypoint=$self->{strEntryPoint} --user=$self->{strUser}" : '') .
" $self->{strImage} " . (defined($self->{strParam}) ? ' ' . $self->{strParam} : ''),
{bSuppressStdErr => true});
# Get IP Address
$self->{strIP} = trim(executeTest("docker inspect --format '\{\{ .NetworkSettings.IPAddress \}\}' $self->{strContainer}"));
$self->{bActive} = true;
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self, trace => true}
);
}
####################################################################################################################################
# remove
####################################################################################################################################
sub remove
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->remove');
if ($self->{bActive})
{
executeTest("docker rm -f $self->{strContainer}", {bSuppressError => true});
$self->{bActive} = false;
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# execute
####################################################################################################################################
sub execute
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strCommand,
$oParam,
$strUser,
$bLoadEnv,
$bBashWrap,
) =
logDebugParam
(
__PACKAGE__ . '->execute', \@_,
{name => 'strCommand'},
{name => 'oParam', required => false},
{name => 'strUser', required => false},
{name => 'bLoadEnv', optional => true, default => true},
{name => 'bBashWrap', optional => true, default => true},
);
# Set the user
if (!defined($strUser))
{
$strUser = $self->{strUser};
}
$strCommand =~ s/'/'\\''/g;
my $oExec = new pgBackRestTest::Common::ExecuteTest(
"docker exec -u ${strUser} $self->{strContainer}" .
($bBashWrap ? " bash" . ($bLoadEnv ? ' -l' : '') . " -c '${strCommand}'" : " ${strCommand}"), $oParam);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oExec', value => $oExec, trace => true}
);
}
####################################################################################################################################
# executeSimple
####################################################################################################################################
sub executeSimple
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strCommand,
$oParam,
$strUser,
$bLoadEnv,
$bBashWrap,
) =
logDebugParam
(
__PACKAGE__ . '->executeSimple', \@_,
{name => 'strCommand', trace => true},
{name => 'oParam', required=> false, trace => true},
{name => 'strUser', required => false, trace => true},
{name => 'bLoadEnv', optional => true, default => true, trace => true},
{name => 'bBashWrap', optional => true, default => true},
);
my $oExec = $self->execute($strCommand, $oParam, $strUser, {bLoadEnv => $bLoadEnv});
$oExec->begin();
$oExec->end();
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strOutLog', value => $oExec->{strOutLog}, trace => true}
);
}
####################################################################################################################################
# copyTo
####################################################################################################################################
sub copyTo
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strSource,
$strDestination,
$strOwner,
$strMode
) =
logDebugParam
(
__PACKAGE__ . '->copyTo', \@_,
{name => 'strSource'},
{name => 'strDestination'},
{name => 'strOwner', required => false},
{name => 'strMode', required => false}
);
executeTest("docker cp ${strSource} $self->{strContainer}:${strDestination}");
if (defined($strOwner))
{
$self->executeSimple("chown ${strOwner} ${strDestination}", undef, 'root');
}
if (defined($strMode))
{
$self->executeSimple("chmod ${strMode} ${strDestination}", undef, 'root');
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# copyFrom
####################################################################################################################################
sub copyFrom
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strSource,
$strDestination
) =
logDebugParam
(
__PACKAGE__ . '->copyFrom', \@_,
{name => 'strSource'},
{name => 'strDestination'}
);
executeTest("docker cp $self->{strContainer}:${strSource} ${strDestination}");
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# hostUpdateGet
####################################################################################################################################
sub hostUpdateGet
{
my $self = shift;
return $self->{bHostUpdate};
}
####################################################################################################################################
# ipGet
####################################################################################################################################
sub ipGet
{
my $self = shift;
return $self->{strIP};
}
####################################################################################################################################
# nameGet
####################################################################################################################################
sub nameGet
{
my $self = shift;
return $self->{strName};
}
####################################################################################################################################
# nameTest
####################################################################################################################################
sub nameTest
{
my $self = shift;
my $strName = shift;
return $self->{strName} eq $strName;
}
####################################################################################################################################
# userGet
####################################################################################################################################
sub userGet
{
my $self = shift;
return $self->{strUser};
}
####################################################################################################################################
# Getters
####################################################################################################################################
sub container {shift->{strContainer}}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/HostGroup.pm 0000664 0000000 0000000 00000014067 15006170376 0025072 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# HostGroupTest.pm - Encapsulate a group of docker containers
####################################################################################################################################
package pgBackRestDoc::Common::HostGroup;
####################################################################################################################################
# Perl includes
####################################################################################################################################
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestTest::Common::ExecuteTest;
####################################################################################################################################
# Global host group variable
####################################################################################################################################
my $oHostGroup;
####################################################################################################################################
# new
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->new');
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self, trace => true}
);
}
####################################################################################################################################
# hostAdd
####################################################################################################################################
sub hostAdd
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oHost,
$rstryHostName,
) =
logDebugParam
(
__PACKAGE__ . '->hostAdd', \@_,
{name => 'oHost'},
{name => 'rstryHostName', optional => true},
);
$self->{host}{$oHost->{strName}} = $oHost;
if ($oHost->hostUpdateGet())
{
$oHost->executeSimple("echo \"\" >> /etc/hosts", undef, 'root', {bLoadEnv => false});
$oHost->executeSimple("echo \"# Test Hosts\" >> /etc/hosts", undef, 'root', {bLoadEnv => false});
}
my $strHostList = $oHost->{strName} . (defined($rstryHostName) ? ' ' . join(' ', @{$rstryHostName}) : '');
# Iterate hosts to add IP mappings
foreach my $strOtherHostName (sort(keys(%{$self->{host}})))
{
my $oOtherHost = $self->{host}{$strOtherHostName};
if ($strOtherHostName ne $oHost->{strName})
{
# Add this host IP to all hosts
if ($oOtherHost->hostUpdateGet())
{
$oOtherHost->executeSimple(
"echo \"$oHost->{strIP} ${strHostList}\" >> /etc/hosts", undef, 'root', {bLoadEnv => false});
}
# Add all other host IPs to this host
if ($oHost->hostUpdateGet())
{
$oHost->executeSimple(
"echo \"$oOtherHost->{strIP} ${strOtherHostName}\" >> /etc/hosts", undef, 'root', {bLoadEnv => false});
}
}
}
# Return from function and log return values if any
return logDebugReturn($strOperation);
}
####################################################################################################################################
# hostGet
####################################################################################################################################
sub hostGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strName,
$bIgnoreMissing,
) =
logDebugParam
(
__PACKAGE__ . '->hostGet', \@_,
{name => 'strName', trace => true},
{name => 'bIgnoreMissing', default => false, trace => true},
);
my $oHost = $self->{host}{$strName};
if (!defined($oHost) && !$bIgnoreMissing)
{
confess &log(ERROR, "host ${strName} does not exist");
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oHost', value => $oHost}
);
}
####################################################################################################################################
# removeAll
####################################################################################################################################
sub removeAll
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my ($strOperation) = logDebugParam(__PACKAGE__ . '->removeAll');
my $iTotal = 0;
foreach my $strHostName (sort(keys(%{$self->{host}})))
{
${$self->{host}}{$strHostName}->remove();
delete($self->{host}{$strHostName});
$iTotal++;
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'iTotal', value => $iTotal}
);
}
####################################################################################################################################
# hostGroupGet
#
# Get the global host group object.
####################################################################################################################################
sub hostGroupGet
{
if (!defined($oHostGroup))
{
$oHostGroup = new pgBackRestDoc::Common::HostGroup();
}
return $oHostGroup;
}
push @EXPORT, qw(hostGroupGet);
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/Ini.pm 0000664 0000000 0000000 00000073355 15006170376 0023664 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# COMMON INI MODULE
####################################################################################################################################
package pgBackRestDoc::Common::Ini;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
use Digest::SHA qw(sha1_hex);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use JSON::PP;
use Storable qw(dclone);
use pgBackRestDoc::Common::Exception;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::ProjectInfo;
####################################################################################################################################
# Boolean constants
####################################################################################################################################
use constant INI_TRUE => JSON::PP::true;
push @EXPORT, qw(INI_TRUE);
use constant INI_FALSE => JSON::PP::false;
push @EXPORT, qw(INI_FALSE);
####################################################################################################################################
# Ini control constants
####################################################################################################################################
use constant INI_SECTION_BACKREST => 'backrest';
push @EXPORT, qw(INI_SECTION_BACKREST);
use constant INI_KEY_CHECKSUM => 'backrest-checksum';
push @EXPORT, qw(INI_KEY_CHECKSUM);
use constant INI_KEY_FORMAT => 'backrest-format';
push @EXPORT, qw(INI_KEY_FORMAT);
use constant INI_KEY_VERSION => 'backrest-version';
push @EXPORT, qw(INI_KEY_VERSION);
use constant INI_SECTION_CIPHER => 'cipher';
push @EXPORT, qw(INI_SECTION_CIPHER);
use constant INI_KEY_CIPHER_PASS => 'cipher-pass';
push @EXPORT, qw(INI_KEY_CIPHER_PASS);
####################################################################################################################################
# Ini file copy extension
####################################################################################################################################
use constant INI_COPY_EXT => '.copy';
push @EXPORT, qw(INI_COPY_EXT);
####################################################################################################################################
# Ini sort orders
####################################################################################################################################
use constant INI_SORT_FORWARD => 'forward';
push @EXPORT, qw(INI_SORT_FORWARD);
use constant INI_SORT_REVERSE => 'reverse';
push @EXPORT, qw(INI_SORT_REVERSE);
use constant INI_SORT_NONE => 'none';
push @EXPORT, qw(INI_SORT_NONE);
####################################################################################################################################
# new()
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oStorage},
$self->{strFileName},
my $bLoad,
my $strContent,
$self->{iInitFormat},
$self->{strInitVersion},
my $bIgnoreMissing,
$self->{strCipherPass}, # Passphrase to read/write the file
my $strCipherPassSub, # Passphrase to read/write subsequent files
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oStorage', trace => true},
{name => 'strFileName', trace => true},
{name => 'bLoad', optional => true, default => true, trace => true},
{name => 'strContent', optional => true, trace => true},
{name => 'iInitFormat', optional => true, default => REPOSITORY_FORMAT, trace => true},
{name => 'strInitVersion', optional => true, default => PROJECT_VERSION, trace => true},
{name => 'bIgnoreMissing', optional => true, default => false, trace => true},
{name => 'strCipherPass', optional => true, trace => true},
{name => 'strCipherPassSub', optional => true, trace => true},
);
# Set changed to false
$self->{bModified} = false;
# Set exists to false
$self->{bExists} = false;
# Load the file if requested
if ($bLoad)
{
$self->load($bIgnoreMissing);
}
# Load from a string if provided
elsif (defined($strContent))
{
$self->{oContent} = iniParse($strContent);
$self->headerCheck();
}
# Initialize if not loading the file and not loading from string or if a load was attempted and the file does not exist
if (!$self->{bExists} && !defined($strContent))
{
$self->numericSet(INI_SECTION_BACKREST, INI_KEY_FORMAT, undef, $self->{iInitFormat});
$self->set(INI_SECTION_BACKREST, INI_KEY_VERSION, undef, $self->{strInitVersion});
# Determine if the passphrase section should be set
if (defined($self->{strCipherPass}) && defined($strCipherPassSub))
{
$self->set(INI_SECTION_CIPHER, INI_KEY_CIPHER_PASS, undef, $strCipherPassSub);
}
}
return $self;
}
####################################################################################################################################
# loadVersion() - load a version (main or copy) of the ini file
####################################################################################################################################
sub loadVersion
{
my $self = shift;
my $bCopy = shift;
my $bIgnoreError = shift;
# Load main
my $rstrContent = $self->{oStorage}->get(
$self->{oStorage}->openRead($self->{strFileName} . ($bCopy ? INI_COPY_EXT : ''),
{bIgnoreMissing => $bIgnoreError, strCipherPass => $self->{strCipherPass}}));
# If the file exists then attempt to parse it
if (defined($rstrContent))
{
my $rhContent = iniParse($$rstrContent, {bIgnoreInvalid => $bIgnoreError});
# If the content is valid then check the header
if (defined($rhContent))
{
$self->{oContent} = $rhContent;
# If the header is invalid then undef content
if (!$self->headerCheck({bIgnoreInvalid => $bIgnoreError}))
{
delete($self->{oContent});
}
}
}
return defined($self->{oContent});
}
####################################################################################################################################
# load() - load the ini
####################################################################################################################################
sub load
{
my $self = shift;
my $bIgnoreMissing = shift;
# If main was not loaded then try the copy
if (!$self->loadVersion(false, true))
{
if (!$self->loadVersion(true, true))
{
return if $bIgnoreMissing;
confess &log(ERROR, "unable to open $self->{strFileName} or $self->{strFileName}" . INI_COPY_EXT, ERROR_FILE_MISSING);
}
}
$self->{bExists} = true;
}
####################################################################################################################################
# headerCheck() - check that version and checksum in header are as expected
####################################################################################################################################
sub headerCheck
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$bIgnoreInvalid,
) =
logDebugParam
(
__PACKAGE__ . '->headerCheck', \@_,
{name => 'bIgnoreInvalid', optional => true, default => false, trace => true},
);
# Eval so exceptions can be ignored on bIgnoreInvalid
my $bValid = true;
eval
{
# Make sure the ini is valid by testing checksum
my $strChecksum = $self->get(INI_SECTION_BACKREST, INI_KEY_CHECKSUM, undef, false);
my $strTestChecksum = $self->hash();
if (!defined($strChecksum) || $strChecksum ne $strTestChecksum)
{
confess &log(ERROR,
"invalid checksum in '$self->{strFileName}', expected '${strTestChecksum}' but found " .
(defined($strChecksum) ? "'${strChecksum}'" : '[undef]'),
ERROR_CHECKSUM);
}
# Make sure that the format is current, otherwise error
my $iFormat = $self->get(INI_SECTION_BACKREST, INI_KEY_FORMAT, undef, false, 0);
if ($iFormat != $self->{iInitFormat})
{
confess &log(ERROR,
"invalid format in '$self->{strFileName}', expected $self->{iInitFormat} but found ${iFormat}", ERROR_FORMAT);
}
# Check if the version has changed
if (!$self->test(INI_SECTION_BACKREST, INI_KEY_VERSION, undef, $self->{strInitVersion}))
{
$self->set(INI_SECTION_BACKREST, INI_KEY_VERSION, undef, $self->{strInitVersion});
}
return true;
}
or do
{
# Confess the error if it should not be ignored
if (!$bIgnoreInvalid)
{
confess $EVAL_ERROR;
}
# Return false when errors are ignored
$bValid = false;
};
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'bValid', value => $bValid, trace => true}
);
}
####################################################################################################################################
# iniParse() - parse from standard INI format to a hash.
####################################################################################################################################
push @EXPORT, qw(iniParse);
sub iniParse
{
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$strContent,
$bRelaxed,
$bIgnoreInvalid,
) =
logDebugParam
(
__PACKAGE__ . '::iniParse', \@_,
{name => 'strContent', required => false, trace => true},
{name => 'bRelaxed', optional => true, default => false, trace => true},
{name => 'bIgnoreInvalid', optional => true, default => false, trace => true},
);
# Ini content
my $oContent = undef;
my $strSection;
# Create the JSON object
my $oJSON = JSON::PP->new()->allow_nonref();
# Eval so exceptions can be ignored on bIgnoreInvalid
eval
{
# Read the INI file
foreach my $strLine (split("\n", defined($strContent) ? $strContent : ''))
{
$strLine = trim($strLine);
# Skip lines that are blank or comments
if ($strLine ne '' && $strLine !~ '^[ ]*#.*')
{
# Get the section
if (index($strLine, '[') == 0)
{
$strSection = substr($strLine, 1, length($strLine) - 2);
}
else
{
if (!defined($strSection))
{
confess &log(ERROR, "key/value pair '${strLine}' found outside of a section", ERROR_CONFIG);
}
# Get key and value
my $iIndex = index($strLine, '=');
if ($iIndex == -1)
{
confess &log(ERROR, "unable to find '=' in '${strLine}'", ERROR_CONFIG);
}
my $strKey = substr($strLine, 0, $iIndex);
my $strValue = substr($strLine, $iIndex + 1);
# If relaxed then read the value directly
if ($bRelaxed)
{
if (defined($oContent->{$strSection}{$strKey}))
{
if (ref($oContent->{$strSection}{$strKey}) ne 'ARRAY')
{
$oContent->{$strSection}{$strKey} = [$oContent->{$strSection}{$strKey}];
}
push(@{$oContent->{$strSection}{$strKey}}, $strValue);
}
else
{
$oContent->{$strSection}{$strKey} = $strValue;
}
}
# Else read the value as stricter JSON
else
{
${$oContent}{$strSection}{$strKey} = $oJSON->decode($strValue);
}
}
}
}
# Error if the file is empty
if (!($bRelaxed || defined($oContent)))
{
confess &log(ERROR, 'no key/value pairs found', ERROR_CONFIG);
}
return true;
}
or do
{
# Confess the error if it should not be ignored
if (!$bIgnoreInvalid)
{
confess $EVAL_ERROR;
}
# Undef content when errors are ignored
undef($oContent);
};
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oContent', value => $oContent, trace => true}
);
}
####################################################################################################################################
# save() - save the file.
####################################################################################################################################
sub save
{
my $self = shift;
# Save only if modified
if ($self->{bModified})
{
# Calculate the hash
$self->hash();
# Save the file
$self->{oStorage}->put($self->{strFileName}, iniRender($self->{oContent}), {strCipherPass => $self->{strCipherPass}});
if ($self->{oStorage}->can('pathSync'))
{
$self->{oStorage}->pathSync(dirname($self->{strFileName}));
}
$self->{oStorage}->put($self->{strFileName} . INI_COPY_EXT, iniRender($self->{oContent}),
{strCipherPass => $self->{strCipherPass}});
if ($self->{oStorage}->can('pathSync'))
{
$self->{oStorage}->pathSync(dirname($self->{strFileName}));
}
$self->{bModified} = false;
# Indicate the file now exists
$self->{bExists} = true;
# File was saved
return true;
}
# File was not saved
return false;
}
####################################################################################################################################
# saveCopy - save only a copy of the file.
####################################################################################################################################
sub saveCopy
{
my $self = shift;
if ($self->{oStorage}->exists($self->{strFileName}))
{
confess &log(ASSERT, "cannot save copy only when '$self->{strFileName}' exists");
}
$self->hash();
$self->{oStorage}->put($self->{strFileName} . INI_COPY_EXT, iniRender($self->{oContent}),
{strCipherPass => $self->{strCipherPass}});
}
####################################################################################################################################
# iniRender() - render hash to standard INI format.
####################################################################################################################################
push @EXPORT, qw(iniRender);
sub iniRender
{
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oContent,
$bRelaxed,
) =
logDebugParam
(
__PACKAGE__ . '::iniRender', \@_,
{name => 'oContent', trace => true},
{name => 'bRelaxed', default => false, trace => true},
);
# Open the ini file for writing
my $strContent = '';
my $bFirst = true;
# Create the JSON object canonical so that fields are alpha ordered to pass unit tests
my $oJSON = JSON::PP->new()->canonical()->allow_nonref();
# Write the INI file
foreach my $strSection (sort(keys(%$oContent)))
{
# Add a linefeed between sections
if (!$bFirst)
{
$strContent .= "\n";
}
# Write the section
$strContent .= "[${strSection}]\n";
# Iterate through all keys in the section
foreach my $strKey (sort(keys(%{$oContent->{$strSection}})))
{
# If the value is a hash then convert it to JSON, otherwise store as is
my $strValue = ${$oContent}{$strSection}{$strKey};
# If relaxed then store as old-style config
if ($bRelaxed)
{
# If the value is an array then save each element to a separate key/value pair
if (ref($strValue) eq 'ARRAY')
{
foreach my $strArrayValue (@{$strValue})
{
$strContent .= "${strKey}=${strArrayValue}\n";
}
}
# Else write a standard key/value pair
else
{
$strContent .= "${strKey}=${strValue}\n";
}
}
# Else write as stricter JSON
else
{
# Skip the checksum for now but write all other key/value pairs
if (!($strSection eq INI_SECTION_BACKREST && $strKey eq INI_KEY_CHECKSUM))
{
$strContent .= "${strKey}=" . $oJSON->encode($strValue) . "\n";
}
}
}
$bFirst = false;
}
# If there is a checksum write it at the end of the file. Having the checksum at the end of the file allows some major
# performance optimizations which we won't implement in Perl, but will make the C code much more efficient.
if (!$bRelaxed && defined($oContent->{&INI_SECTION_BACKREST}) && defined($oContent->{&INI_SECTION_BACKREST}{&INI_KEY_CHECKSUM}))
{
$strContent .=
"\n[" . INI_SECTION_BACKREST . "]\n" .
INI_KEY_CHECKSUM . '=' . $oJSON->encode($oContent->{&INI_SECTION_BACKREST}{&INI_KEY_CHECKSUM}) . "\n";
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strContent', value => $strContent, trace => true}
);
}
####################################################################################################################################
# hash() - generate hash for the manifest.
####################################################################################################################################
sub hash
{
my $self = shift;
# Remove the old checksum
delete($self->{oContent}{&INI_SECTION_BACKREST}{&INI_KEY_CHECKSUM});
# Set the new checksum
$self->{oContent}{&INI_SECTION_BACKREST}{&INI_KEY_CHECKSUM} =
sha1_hex(JSON::PP->new()->canonical()->allow_nonref()->encode($self->{oContent}));
return $self->{oContent}{&INI_SECTION_BACKREST}{&INI_KEY_CHECKSUM};
}
####################################################################################################################################
# get() - get a value.
####################################################################################################################################
sub get
{
my $self = shift;
my $strSection = shift;
my $strKey = shift;
my $strSubKey = shift;
my $bRequired = shift;
my $oDefault = shift;
# Parameter constraints
if (!defined($strSection))
{
confess &log(ASSERT, 'strSection is required');
}
if (defined($strSubKey) && !defined($strKey))
{
confess &log(ASSERT, "strKey is required when strSubKey '${strSubKey}' is requested");
}
# Get the result
my $oResult = $self->{oContent}->{$strSection};
if (defined($strKey) && defined($oResult))
{
$oResult = $oResult->{$strKey};
if (defined($strSubKey) && defined($oResult))
{
$oResult = $oResult->{$strSubKey};
}
}
# When result is not defined
if (!defined($oResult))
{
# Error if a result is required
if (!defined($bRequired) || $bRequired)
{
confess &log(ASSERT, "strSection '$strSection'" . (defined($strKey) ? ", strKey '$strKey'" : '') .
(defined($strSubKey) ? ", strSubKey '$strSubKey'" : '') . ' is required but not defined');
}
# Return default if specified
if (defined($oDefault))
{
return $oDefault;
}
}
return $oResult
}
####################################################################################################################################
# boolGet() - get a boolean value.
####################################################################################################################################
sub boolGet
{
my $self = shift;
my $strSection = shift;
my $strKey = shift;
my $strSubKey = shift;
my $bRequired = shift;
my $bDefault = shift;
return $self->get(
$strSection, $strKey, $strSubKey, $bRequired,
defined($bDefault) ? ($bDefault ? INI_TRUE : INI_FALSE) : undef) ? true : false;
}
####################################################################################################################################
# numericGet() - get a numeric value.
####################################################################################################################################
sub numericGet
{
my $self = shift;
my $strSection = shift;
my $strKey = shift;
my $strSubKey = shift;
my $bRequired = shift;
my $nDefault = shift;
return $self->get($strSection, $strKey, $strSubKey, $bRequired, defined($nDefault) ? $nDefault + 0 : undef) + 0;
}
####################################################################################################################################
# set - set a value.
####################################################################################################################################
sub set
{
my $self = shift;
my $strSection = shift;
my $strKey = shift;
my $strSubKey = shift;
my $oValue = shift;
# Parameter constraints
if (!(defined($strSection) && defined($strKey)))
{
confess &log(ASSERT, 'strSection and strKey are required');
}
my $oCurrentValue;
if (defined($strSubKey))
{
$oCurrentValue = \$self->{oContent}{$strSection}{$strKey}{$strSubKey};
}
else
{
$oCurrentValue = \$self->{oContent}{$strSection}{$strKey};
}
if (!defined($$oCurrentValue) ||
defined($oCurrentValue) != defined($oValue) ||
${dclone($oCurrentValue)} ne ${dclone(\$oValue)})
{
$$oCurrentValue = $oValue;
if (!$self->{bModified})
{
$self->{bModified} = true;
}
return true;
}
return false;
}
####################################################################################################################################
# boolSet - set a boolean value.
####################################################################################################################################
sub boolSet
{
my $self = shift;
my $strSection = shift;
my $strKey = shift;
my $strSubKey = shift;
my $bValue = shift;
$self->set($strSection, $strKey, $strSubKey, $bValue ? INI_TRUE : INI_FALSE);
}
####################################################################################################################################
# numericSet - set a numeric value.
####################################################################################################################################
sub numericSet
{
my $self = shift;
my $strSection = shift;
my $strKey = shift;
my $strSubKey = shift;
my $nValue = shift;
$self->set($strSection, $strKey, $strSubKey, defined($nValue) ? $nValue + 0 : undef);
}
####################################################################################################################################
# remove - remove a value.
####################################################################################################################################
sub remove
{
my $self = shift;
my $strSection = shift;
my $strKey = shift;
my $strSubKey = shift;
# Test if the value exists
if ($self->test($strSection, $strKey, $strSubKey))
{
# Remove a subkey
if (defined($strSubKey))
{
delete($self->{oContent}{$strSection}{$strKey}{$strSubKey});
}
# Remove a key
if (defined($strKey))
{
if (!defined($strSubKey))
{
delete($self->{oContent}{$strSection}{$strKey});
}
# Remove the section if it is now empty
if (keys(%{$self->{oContent}{$strSection}}) == 0)
{
delete($self->{oContent}{$strSection});
}
}
# Remove a section
if (!defined($strKey))
{
delete($self->{oContent}{$strSection});
}
# Record changes
if (!$self->{bModified})
{
$self->{bModified} = true;
}
return true;
}
return false;
}
####################################################################################################################################
# keys - get the list of keys in a section.
####################################################################################################################################
sub keys
{
my $self = shift;
my $strSection = shift;
my $strSortOrder = shift;
if ($self->test($strSection))
{
if (!defined($strSortOrder) || $strSortOrder eq INI_SORT_FORWARD)
{
return (sort(keys(%{$self->get($strSection)})));
}
elsif ($strSortOrder eq INI_SORT_REVERSE)
{
return (sort {$b cmp $a} (keys(%{$self->get($strSection)})));
}
elsif ($strSortOrder eq INI_SORT_NONE)
{
return (keys(%{$self->get($strSection)}));
}
else
{
confess &log(ASSERT, "invalid strSortOrder '${strSortOrder}'");
}
}
my @stryEmptyArray;
return @stryEmptyArray;
}
####################################################################################################################################
# test - test a value.
#
# Test a value to see if it equals the supplied test value. If no test value is given, tests that the section, key, or subkey is
# defined.
####################################################################################################################################
sub test
{
my $self = shift;
my $strSection = shift;
my $strValue = shift;
my $strSubValue = shift;
my $strTest = shift;
# Get the value
my $strResult = $self->get($strSection, $strValue, $strSubValue, false);
# Is there a result
if (defined($strResult))
{
# Is there a value to test against?
if (defined($strTest))
{
# Make sure these are explicit strings or Devel::Cover thinks they are equal if one side is a boolean
return ($strResult . '') eq ($strTest . '') ? true : false;
}
return true;
}
return false;
}
####################################################################################################################################
# boolTest - test a boolean value, see test().
####################################################################################################################################
sub boolTest
{
my $self = shift;
my $strSection = shift;
my $strValue = shift;
my $strSubValue = shift;
my $bTest = shift;
return $self->test($strSection, $strValue, $strSubValue, defined($bTest) ? ($bTest ? INI_TRUE : INI_FALSE) : undef);
}
####################################################################################################################################
# cipherPassSub - gets the passphrase (if it exists) used to read/write subsequent files
####################################################################################################################################
sub cipherPassSub
{
my $self = shift;
return $self->get(INI_SECTION_CIPHER, INI_KEY_CIPHER_PASS, undef, false);
}
####################################################################################################################################
# Properties.
####################################################################################################################################
sub modified {shift->{bModified}} # Has the data been modified since last load/save?
sub exists {shift->{bExists}} # Is the data persisted to file?
sub cipherPass {shift->{strCipherPass}} # Return passphrase (will be undef if repo not encrypted)
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/Log.pm 0000664 0000000 0000000 00000067033 15006170376 0023662 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# COMMON LOG MODULE
####################################################################################################################################
package pgBackRestDoc::Common::Log;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess longmess);
use English '-no_match_vars';
use Exporter qw(import);
our @EXPORT = qw();
use Fcntl qw(:DEFAULT :flock);
use File::Basename qw(dirname);
use Scalar::Util qw(blessed reftype);
use Time::HiRes qw(gettimeofday usleep);
use pgBackRestDoc::Common::Exception;
use pgBackRestDoc::Common::String;
####################################################################################################################################
# Boolean constants
####################################################################################################################################
use constant true => 1;
push @EXPORT, qw(true);
use constant false => 0;
push @EXPORT, qw(false);
####################################################################################################################################
# Log level constants
####################################################################################################################################
use constant TRACE => 'TRACE';
push @EXPORT, qw(TRACE);
use constant DEBUG => 'DEBUG';
push @EXPORT, qw(DEBUG);
use constant DETAIL => 'DETAIL';
push @EXPORT, qw(DETAIL);
use constant INFO => 'INFO';
push @EXPORT, qw(INFO);
use constant WARN => 'WARN';
push @EXPORT, qw(WARN);
use constant PROTOCOL => 'PROTOCOL';
push @EXPORT, qw(PROTOCOL);
use constant ERROR => 'ERROR';
push @EXPORT, qw(ERROR);
use constant ASSERT => 'ASSERT';
push @EXPORT, qw(ASSERT);
use constant OFF => 'OFF';
push @EXPORT, qw(OFF);
####################################################################################################################################
# Log levels ranked by severity
####################################################################################################################################
my %oLogLevelRank;
$oLogLevelRank{TRACE}{rank} = 8;
$oLogLevelRank{DEBUG}{rank} = 7;
$oLogLevelRank{DETAIL}{rank} = 6;
$oLogLevelRank{INFO}{rank} = 5;
$oLogLevelRank{WARN}{rank} = 4;
$oLogLevelRank{PROTOCOL}{rank} = 3;
$oLogLevelRank{ERROR}{rank} = 2;
$oLogLevelRank{ASSERT}{rank} = 1;
$oLogLevelRank{OFF}{rank} = 0;
####################################################################################################################################
# Module globals
####################################################################################################################################
my $hLogFile = undef;
my $strLogFileCache = undef;
my $strLogLevelFile = OFF;
my $strLogLevelConsole = OFF;
my $strLogLevelStdErr = WARN;
my $bLogTimestamp = true;
# Size of the process id log field
my $iLogProcessSize = 2;
# Flags to limit banner printing until there is actual output
my $bLogFileExists;
my $bLogFileFirst;
# Allow log to be globally enabled or disabled with logEnable() and logDisable()
my $bLogDisable = 0;
# Allow errors to be logged as warnings
my $bLogWarnOnError = 0;
# Store the last logged error
my $oErrorLast;
####################################################################################################################################
# logFileSet - set the file messages will be logged to
####################################################################################################################################
sub logFileSet
{
my $oStorage = shift;
my $strFile = shift;
my $bLogFileFirstParam = shift;
# Only open the log file if file logging is enabled
if ($strLogLevelFile ne OFF)
{
$oStorage->pathCreate(dirname($strFile), {strMode => '0750', bIgnoreExists => true, bCreateParent => true});
$strFile .= '.log';
$bLogFileExists = -e $strFile ? true : false;
$bLogFileFirst = defined($bLogFileFirstParam) ? $bLogFileFirstParam : false;
if (!sysopen($hLogFile, $strFile, O_WRONLY | O_CREAT | O_APPEND, oct('0640')))
{
logErrorResult(ERROR_FILE_OPEN, "unable to open log file '${strFile}'", $OS_ERROR);
}
# Write out anything that was cached before the file was opened
if (defined($strLogFileCache))
{
logBanner();
syswrite($hLogFile, $strLogFileCache);
undef($strLogFileCache);
}
}
}
push @EXPORT, qw(logFileSet);
####################################################################################################################################
# logBanner
#
# Output a banner on the first log entry written to a file
####################################################################################################################################
sub logBanner
{
if ($bLogFileFirst)
{
if ($bLogFileExists)
{
syswrite($hLogFile, "\n");
}
syswrite($hLogFile, "-------------------PROCESS START-------------------\n");
}
$bLogFileFirst = false;
}
####################################################################################################################################
# logLevelSet - set the log level for file and console
####################################################################################################################################
sub logLevelSet
{
my $strLevelFileParam = shift;
my $strLevelConsoleParam = shift;
my $strLevelStdErrParam = shift;
my $bLogTimestampParam = shift;
my $iLogProcessMax = shift;
if (defined($strLevelFileParam))
{
if (!defined($oLogLevelRank{uc($strLevelFileParam)}{rank}))
{
confess &log(ERROR, "file log level ${strLevelFileParam} does not exist");
}
$strLogLevelFile = uc($strLevelFileParam);
}
if (defined($strLevelConsoleParam))
{
if (!defined($oLogLevelRank{uc($strLevelConsoleParam)}{rank}))
{
confess &log(ERROR, "console log level ${strLevelConsoleParam} does not exist");
}
$strLogLevelConsole = uc($strLevelConsoleParam);
}
if (defined($strLevelStdErrParam))
{
if (!defined($oLogLevelRank{uc($strLevelStdErrParam)}{rank}))
{
confess &log(ERROR, "stdout log level ${strLevelStdErrParam} does not exist");
}
$strLogLevelStdErr = uc($strLevelStdErrParam);
}
if (defined($bLogTimestampParam))
{
$bLogTimestamp = $bLogTimestampParam;
}
if (defined($iLogProcessMax))
{
$iLogProcessSize = $iLogProcessMax > 99 ? 3 : 2;
}
}
push @EXPORT, qw(logLevelSet);
####################################################################################################################################
# logDisable
####################################################################################################################################
sub logDisable
{
$bLogDisable++;
}
push @EXPORT, qw(logDisable);
####################################################################################################################################
# logEnable
####################################################################################################################################
sub logEnable
{
$bLogDisable--;
}
push @EXPORT, qw(logEnable);
####################################################################################################################################
# logWarnOnErrorDisable
####################################################################################################################################
sub logWarnOnErrorDisable
{
$bLogWarnOnError--;
}
push @EXPORT, qw(logWarnOnErrorDisable);
####################################################################################################################################
# logWarnOnErrorEnable - when an error is thrown, log it as a warning instead
####################################################################################################################################
sub logWarnOnErrorEnable
{
$bLogWarnOnError++;
}
push @EXPORT, qw(logWarnOnErrorEnable);
####################################################################################################################################
# logDebugParam
#
# Log parameters passed to functions.
####################################################################################################################################
use constant DEBUG_PARAM => '()';
sub logDebugParam
{
my $strFunction = shift;
my $oyParamRef = shift;
return logDebugProcess($strFunction, DEBUG_PARAM, undef, $oyParamRef, @_);
}
push @EXPORT, qw(logDebugParam);
####################################################################################################################################
# logDebugReturn
#
# Log values returned from functions.
####################################################################################################################################
use constant DEBUG_RETURN => '=>';
sub logDebugReturn
{
my $strFunction = shift;
return logDebugProcess($strFunction, DEBUG_RETURN, undef, undef, @_);
}
push @EXPORT, qw(logDebugReturn);
####################################################################################################################################
# logDebugMisc
#
# Log misc values and details during execution.
####################################################################################################################################
use constant DEBUG_MISC => '';
sub logDebugMisc
{
my $strFunction = shift;
my $strDetail = shift;
return logDebugProcess($strFunction, DEBUG_MISC, $strDetail, undef, @_);
}
push @EXPORT, qw(logDebugMisc);
####################################################################################################################################
# logDebugProcess
####################################################################################################################################
sub logDebugProcess
{
my $strFunction = shift;
my $strType = shift;
my $strDetail = shift;
my $oyParamRef = shift;
my $iIndex = 0;
my $oParamHash = {};
my @oyResult;
my $bLogTrace = true;
if ($strType eq DEBUG_PARAM)
{
push @oyResult, $strFunction;
}
# Process each parameter hash
my $oParam = shift;
my $bOptionalBlock = false;
# Strip the package name off strFunction if it's pgBackRest
$strFunction =~ s/^pgBackRest[^\:]*\:\://;
while (defined($oParam))
{
my $strParamName = $$oParam{name};
my $bParamOptional = defined($oParam->{optional}) && $oParam->{optional};
my $bParamRequired = !defined($oParam->{required}) || $oParam->{required};
my $oValue;
# Should the param be redacted?
$oParamHash->{$strParamName}{redact} = $oParam->{redact} ? true : false;
# If param is optional then the optional block has been entered
if ($bParamOptional)
{
if (defined($oParam->{required}))
{
confess &log(ASSERT, "cannot define 'required' for optional parameter '${strParamName}'");
}
$bParamRequired = false;
$bOptionalBlock = true;
}
# Don't allow non-optional parameters once optional block has started
if ($bParamOptional != $bOptionalBlock)
{
confess &log(ASSERT, "non-optional parameter '${strParamName}' invalid after optional parameters");
}
# Push the return value into the return value array
if ($strType eq DEBUG_PARAM)
{
if ($bParamOptional)
{
$oValue = $$oyParamRef[$iIndex]->{$strParamName};
}
else
{
$oValue = $$oyParamRef[$iIndex];
}
if (defined($oValue))
{
push(@oyResult, $oValue);
}
else
{
push(@oyResult, $${oParam}{default});
$$oParamHash{$strParamName}{default} = true;
}
$oValue = $oyResult[-1];
if (!defined($oValue) && $bParamRequired)
{
confess &log(ASSERT, "${strParamName} is required in ${strFunction}");
}
}
else
{
if (ref($$oParam{value}) eq 'ARRAY')
{
if (defined($$oParam{ref}) && $$oParam{ref})
{
push(@oyResult, $$oParam{value});
}
else
{
push(@oyResult, @{$$oParam{value}});
}
}
else
{
push(@oyResult, $$oParam{value});
}
$oValue = $$oParam{value};
}
if (!defined($$oParam{log}) || $$oParam{log})
{
# If the parameter is a hash but not blessed then represent it as a string
# ??? This should go away once the inputs to logDebug can be changed
if (ref($oValue) eq 'HASH' && !blessed($oValue))
{
$$oParamHash{$strParamName}{value} = '[hash]';
}
# Else log the parameter value exactly
else
{
$$oParamHash{$strParamName}{value} = $oValue;
}
# There are certain return values that it's wasteful to generate debug logging for
if (!($strParamName eq 'self') &&
(!defined($$oParam{trace}) || !$$oParam{trace}))
{
$bLogTrace = false;
}
}
# Get the next parameter hash
$oParam = shift;
if (!$bParamOptional)
{
$iIndex++;
}
}
if (defined($strDetail) && $iIndex == 0)
{
$bLogTrace = false;
}
logDebugOut($strFunction, $strType, $strDetail, $oParamHash, $bLogTrace ? TRACE : DEBUG);
# If there are one or zero return values then just return a scalar (this will be undef if there are no return values)
if (@oyResult == 1)
{
return $oyResult[0];
}
# Else return an array containing return values
return @oyResult;
}
####################################################################################################################################
# logDebugBuild
####################################################################################################################################
sub logDebugBuild
{
my $strValue = shift;
my $rResult;
# Value is undefined
if (!defined($strValue))
{
$rResult = \'[undef]';
}
# Value is not a ref, but return it as a ref for efficiency
elsif (!ref($strValue))
{
$rResult = \$strValue;
}
# Value is a hash
elsif (ref($strValue) eq 'HASH')
{
my $strValueHash;
for my $strSubValue (sort(keys(%{$strValue})))
{
$strValueHash .=
(defined($strValueHash) ? ', ' : '{') . "${strSubValue} => " . ${logDebugBuild($strValue->{$strSubValue})};
}
$rResult = \(defined($strValueHash) ? $strValueHash . '}' : '{}');
}
# Value is an array
elsif (ref($strValue) eq 'ARRAY')
{
my $strValueArray;
for my $strSubValue (@{$strValue})
{
$strValueArray .= (defined($strValueArray) ? ', ' : '(') . ${logDebugBuild($strSubValue)};
}
$rResult = \(defined($strValueArray) ? $strValueArray . ')' : '()');
}
# Else some other type ??? For the moment this is forced to object to not make big log changes
else
{
$rResult = \('[object]');
}
return $rResult;
}
push @EXPORT, qw(logDebugBuild);
####################################################################################################################################
# logDebugOut
####################################################################################################################################
use constant DEBUG_STRING_MAX_LEN => 1024;
sub logDebugOut
{
my $strFunction = shift;
my $strType = shift;
my $strMessage = shift;
my $oParamHash = shift;
my $strLevel = shift;
$strLevel = defined($strLevel) ? $strLevel : DEBUG;
if ($oLogLevelRank{$strLevel}{rank} <= $oLogLevelRank{$strLogLevelConsole}{rank} ||
$oLogLevelRank{$strLevel}{rank} <= $oLogLevelRank{$strLogLevelFile}{rank} ||
$oLogLevelRank{$strLevel}{rank} <= $oLogLevelRank{$strLogLevelStdErr}{rank})
{
if (defined($oParamHash))
{
my $strParamSet;
foreach my $strParam (sort(keys(%$oParamHash)))
{
if (defined($strParamSet))
{
$strParamSet .= ', ';
}
my $strValueRef = defined($oParamHash->{$strParam}{value}) ? logDebugBuild($oParamHash->{$strParam}{value}) : undef;
my $bDefault =
defined($$strValueRef) && defined($$oParamHash{$strParam}{default}) ? $$oParamHash{$strParam}{default} : false;
$strParamSet .=
"${strParam} = " .
($oParamHash->{$strParam}{redact} && defined($$strValueRef) ? '' :
($bDefault ? '<' : '') .
(defined($$strValueRef) ?
($strParam =~ /^(b|is)/ ? ($$strValueRef ? 'true' : 'false'):
(length($$strValueRef) > DEBUG_STRING_MAX_LEN ?
substr($$strValueRef, 0, DEBUG_STRING_MAX_LEN) . ' ... ':
$$strValueRef)) : '[undef]') .
($bDefault ? '>' : ''));
}
if (defined($strMessage))
{
$strMessage = $strMessage . (defined($strParamSet) ? ": ${strParamSet}" : '');
}
else
{
$strMessage = $strParamSet;
}
}
&log($strLevel, "${strFunction}${strType}" . (defined($strMessage) ? ": $strMessage" : ''));
}
}
####################################################################################################################################
# logException
####################################################################################################################################
sub logException
{
my $oException = shift;
return &log($oException->level(), $oException->message(), $oException->code(), undef, undef, undef, $oException->extra());
}
push @EXPORT, qw(logException);
####################################################################################################################################
# logErrorResult
####################################################################################################################################
sub logErrorResult
{
my $iCode = shift;
my $strMessage = shift;
my $strResult = shift;
confess &log(ERROR, $strMessage . (defined($strResult) ? ': ' . trim($strResult) : ''), $iCode);
}
push @EXPORT, qw(logErrorResult);
####################################################################################################################################
# LOG - log messages
####################################################################################################################################
sub log
{
my $strLevel = shift;
my $strMessage = shift;
my $iCode = shift;
my $bSuppressLog = shift;
my $iIndent = shift;
my $iProcessId = shift;
my $rExtra = shift;
# Set defaults
$bSuppressLog = defined($bSuppressLog) ? $bSuppressLog : false;
# Initialize rExtra
if (!defined($rExtra))
{
$rExtra =
{
bLogFile => false,
bLogConsole => false,
};
}
# Set operational variables
my $strMessageFormat = $strMessage;
my $iLogLevelRank = $oLogLevelRank{$strLevel}{rank};
# Level rank must be valid
if (!defined($iLogLevelRank))
{
confess &log(ASSERT, "log level ${strLevel} does not exist");
}
# If message was undefined then set default message
if (!defined($strMessageFormat))
{
$strMessageFormat = '(undefined)';
}
# Set the error code
if ($strLevel eq ASSERT)
{
$iCode = ERROR_ASSERT;
}
elsif ($strLevel eq ERROR && !defined($iCode))
{
$iCode = ERROR_UNKNOWN;
}
$strMessageFormat = (defined($iCode) ? sprintf('[%03d]: ', $iCode) : '') . $strMessageFormat;
# Indent subsequent lines of the message if it has more than one line - makes the log more readable
if (defined($iIndent))
{
my $strIndent = ' ' x $iIndent;
$strMessageFormat =~ s/\n/\n${strIndent}/g;
}
else
{
# Indent subsequent message lines so they align
$bLogTimestamp ?
$strMessageFormat =~ s/\n/\n /g :
$strMessageFormat =~ s/\n/\n /g
}
# Indent TRACE and debug levels so they are distinct from normal messages
if ($strLevel eq TRACE)
{
$strMessageFormat =~ s/\n/\n /g;
$strMessageFormat = ' ' . $strMessageFormat;
}
elsif ($strLevel eq DEBUG)
{
$strMessageFormat =~ s/\n/\n /g;
$strMessageFormat = ' ' . $strMessageFormat;
}
# Format the message text
my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst) = localtime(time);
# If logging warnings as errors then change the display level and rank. These will be used to determine if the message will be
# displayed or not.
my $strDisplayLevel = ($bLogWarnOnError && $strLevel eq ERROR ? WARN : $strLevel);
my $iLogDisplayLevelRank = ($bLogWarnOnError && $strLevel eq ERROR ? $oLogLevelRank{$strDisplayLevel}{rank} : $iLogLevelRank);
$strMessageFormat =
($bLogTimestamp ? timestampFormat() . sprintf('.%03d ', (gettimeofday() - int(gettimeofday())) * 1000) : '') .
sprintf('P%0*d', $iLogProcessSize, defined($iProcessId) ? $iProcessId : 0) .
(' ' x (7 - length($strDisplayLevel))) . "${strDisplayLevel}: ${strMessageFormat}\n";
# Skip output if disabled
if (!$bLogDisable)
{
# Output to stderr if configured log level setting rank is greater than the display level rank.
if (!$rExtra->{bLogConsole} && $iLogDisplayLevelRank <= $oLogLevelRank{$strLogLevelStdErr}{rank})
{
if ($strLogLevelStdErr ne PROTOCOL)
{
syswrite(*STDERR, $strDisplayLevel . (defined($iCode) ? sprintf(' [%03d]: ', $iCode) : '') . ': ');
}
syswrite(*STDERR, "${strMessage}\n");
$rExtra->{bLogConsole} = true;
}
# Else output to stdout if configured log level setting rank is greater than the display level rank
elsif (!$rExtra->{bLogConsole} && $iLogDisplayLevelRank <= $oLogLevelRank{$strLogLevelConsole}{rank})
{
if (!$bSuppressLog)
{
syswrite(*STDOUT, $strMessageFormat);
# This is here for debugging purposes - it's not clear how best to make it into a switch
# if ($strLevel eq ASSERT || $strLevel eq ERROR)
# {
# my $strStackTrace = longmess() . "\n";
# $strStackTrace =~ s/\n/\n /g;
# syswrite(*STDOUT, $strStackTrace);
# }
}
$rExtra->{bLogConsole} = true;
}
# Output to file if configured log level setting rank is greater than the display level rank or test flag is set.
if (!$rExtra->{bLogLogFile} && $iLogDisplayLevelRank <= $oLogLevelRank{$strLogLevelFile}{rank})
{
if (defined($hLogFile) || (defined($strLogLevelFile) && $strLogLevelFile ne OFF))
{
if (!$bSuppressLog)
{
if (defined($hLogFile))
{
logBanner();
syswrite($hLogFile, $strMessageFormat);
}
else
{
$strLogFileCache .= $strMessageFormat;
}
if ($strDisplayLevel eq ASSERT ||
($strDisplayLevel eq ERROR && ($strLogLevelFile eq DEBUG || $strLogLevelFile eq TRACE)))
{
my $strStackTrace = longmess() . "\n";
$strStackTrace =~ s/\n/\n /g;
if (defined($hLogFile))
{
syswrite($hLogFile, $strStackTrace);
}
else
{
$strLogFileCache .= $strStackTrace;
}
}
}
}
$rExtra->{bLogFile} = true;
}
}
# Return a typed exception if code is defined
if (defined($iCode))
{
$oErrorLast = new pgBackRestDoc::Common::Exception($strLevel, $iCode, $strMessage, longmess(), $rExtra);
return $oErrorLast;
}
# Return the message so it can be used in a confess
return $strMessage;
}
push @EXPORT, qw(log);
####################################################################################################################################
# logErrorLast - get the last logged error
####################################################################################################################################
sub logErrorLast
{
return $oErrorLast;
}
push @EXPORT, qw(logErrorLast);
####################################################################################################################################
# logLevel - get the current log levels
####################################################################################################################################
sub logLevel
{
return ($strLogLevelFile, $strLogLevelConsole, $strLogLevelStdErr, $bLogTimestamp);
}
push @EXPORT, qw(logLevel);
####################################################################################################################################
# logFileCacheClear - Clear the log file cache
####################################################################################################################################
sub logFileCacheClear
{
undef($strLogFileCache);
}
push @EXPORT, qw(logFileCacheClear);
####################################################################################################################################
# logFileCache - Get the log file cache
####################################################################################################################################
sub logFileCache
{
return $strLogFileCache;
}
push @EXPORT, qw(logFileCache);
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Common/String.pm 0000664 0000000 0000000 00000006317 15006170376 0024405 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# COMMON STRING MODULE
####################################################################################################################################
package pgBackRestDoc::Common::String;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess longmess);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
####################################################################################################################################
# trim
#
# Trim whitespace.
####################################################################################################################################
sub trim
{
my $strBuffer = shift;
if (!defined($strBuffer))
{
return;
}
$strBuffer =~ s/^\s+|\s+$//g;
return $strBuffer;
}
push @EXPORT, qw(trim);
####################################################################################################################################
# coalesce - return first defined parameter
####################################################################################################################################
sub coalesce
{
foreach my $strParam (@_)
{
if (defined($strParam))
{
return $strParam;
}
}
return;
}
push @EXPORT, qw(coalesce);
####################################################################################################################################
# timestampFormat
#
# Get standard timestamp format (or formatted as specified).
####################################################################################################################################
sub timestampFormat
{
my $strFormat = shift;
my $lTime = shift;
if (!defined($strFormat))
{
$strFormat = '%4d-%02d-%02d %02d:%02d:%02d';
}
if (!defined($lTime))
{
$lTime = time();
}
my ($iSecond, $iMinute, $iHour, $iMonthDay, $iMonth, $iYear, $iWeekDay, $iYearDay, $bIsDst) = localtime($lTime);
if ($strFormat eq "%4d")
{
return sprintf($strFormat, $iYear + 1900)
}
else
{
return sprintf($strFormat, $iYear + 1900, $iMonth + 1, $iMonthDay, $iHour, $iMinute, $iSecond);
}
}
push @EXPORT, qw(timestampFormat);
####################################################################################################################################
# stringSplit
####################################################################################################################################
sub stringSplit
{
my $strString = shift;
my $strChar = shift;
my $iLength = shift;
if (length($strString) <= $iLength)
{
return $strString, undef;
}
my $iPos = index($strString, $strChar);
if ($iPos == -1)
{
return $strString, undef;
}
my $iNewPos = $iPos;
while ($iNewPos != -1 && $iNewPos + 1 < $iLength)
{
$iPos = $iNewPos;
$iNewPos = index($strString, $strChar, $iPos + 1);
}
return substr($strString, 0, $iPos + 1), substr($strString, $iPos + 1);
}
push @EXPORT, qw(stringSplit);
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Custom/ 0000775 0000000 0000000 00000000000 15006170376 0022614 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Custom/DocConfigData.pm 0000664 0000000 0000000 00000062145 15006170376 0025607 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# Configuration Definition Data
#
# The configuration is defined in src/build/config/config.yaml, which also contains the documentation.
####################################################################################################################################
package pgBackRestDoc::Custom::DocConfigData;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname basename);
use Getopt::Long qw(GetOptions);
use Storable qw(dclone);
use pgBackRestDoc::Common::Exception;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::ProjectInfo;
use pgBackRestTest::Common::Wait;
####################################################################################################################################
# Command constants
####################################################################################################################################
use constant CFGCMD_BACKUP => 'backup';
push @EXPORT, qw(CFGCMD_BACKUP);
use constant CFGCMD_HELP => 'help';
push @EXPORT, qw(CFGCMD_HELP);
use constant CFGCMD_INFO => 'info';
push @EXPORT, qw(CFGCMD_INFO);
use constant CFGCMD_VERSION => 'version';
####################################################################################################################################
# Command role constants - roles allowed for each command. Commands may have multiple processes that work together to implement
# their functionality. These roles allow each process to know what it is supposed to do.
####################################################################################################################################
# Called directly by the user. This is the main process of the command that may or may not spawn other command roles.
use constant CFGCMD_ROLE_MAIN => 'main';
push @EXPORT, qw(CFGCMD_ROLE_MAIN);
# Async worker that is spawned so the main process can return a result while work continues. An async worker may spawn local or
# remote workers.
use constant CFGCMD_ROLE_ASYNC => 'async';
push @EXPORT, qw(CFGCMD_ROLE_ASYNC);
# Local worker for parallelizing jobs. A local work may spawn a remote worker.
use constant CFGCMD_ROLE_LOCAL => 'local';
push @EXPORT, qw(CFGCMD_ROLE_LOCAL);
# Remote worker for accessing resources on another host
use constant CFGCMD_ROLE_REMOTE => 'remote';
push @EXPORT, qw(CFGCMD_ROLE_REMOTE);
####################################################################################################################################
# Option constants - options that are allowed for commands
####################################################################################################################################
# Command-line only options
#-----------------------------------------------------------------------------------------------------------------------------------
use constant CFGOPT_CONFIG => 'config';
push @EXPORT, qw(CFGOPT_CONFIG);
use constant CFGOPT_STANZA => 'stanza';
push @EXPORT, qw(CFGOPT_STANZA);
# Command-line only local/remote options
#-----------------------------------------------------------------------------------------------------------------------------------
# Paths
use constant CFGOPT_LOCK_PATH => 'lock-path';
push @EXPORT, qw(CFGOPT_LOCK_PATH);
use constant CFGOPT_LOG_PATH => 'log-path';
push @EXPORT, qw(CFGOPT_LOG_PATH);
use constant CFGOPT_SPOOL_PATH => 'spool-path';
push @EXPORT, qw(CFGOPT_SPOOL_PATH);
# Logging
use constant CFGOPT_LOG_LEVEL_STDERR => 'log-level-stderr';
push @EXPORT, qw(CFGOPT_LOG_LEVEL_STDERR);
use constant CFGOPT_LOG_TIMESTAMP => 'log-timestamp';
push @EXPORT, qw(CFGOPT_LOG_TIMESTAMP);
# Repository options
#-----------------------------------------------------------------------------------------------------------------------------------
# Prefix that must be used by all repo options that allow multiple configurations
use constant CFGDEF_PREFIX_REPO => 'repo';
# Repository General
use constant CFGOPT_REPO_PATH => CFGDEF_PREFIX_REPO . '-path';
push @EXPORT, qw(CFGOPT_REPO_PATH);
# Repository Host
use constant CFGOPT_REPO_HOST => CFGDEF_PREFIX_REPO . '-host';
use constant CFGOPT_REPO_HOST_CMD => CFGOPT_REPO_HOST . '-cmd';
push @EXPORT, qw(CFGOPT_REPO_HOST_CMD);
# Stanza options
#-----------------------------------------------------------------------------------------------------------------------------------
# Determines how many databases can be configured
use constant CFGDEF_INDEX_PG => 8;
push @EXPORT, qw(CFGDEF_INDEX_PG);
# Prefix that must be used by all db options that allow multiple configurations
use constant CFGDEF_PREFIX_PG => 'pg';
push @EXPORT, qw(CFGDEF_PREFIX_PG);
# Set default PostgreSQL cluster
use constant CFGOPT_PG_HOST => CFGDEF_PREFIX_PG . '-host';
use constant CFGOPT_PG_HOST_CMD => CFGOPT_PG_HOST . '-cmd';
push @EXPORT, qw(CFGOPT_PG_HOST_CMD);
####################################################################################################################################
# Option definition constants - defines, types, sections, etc.
####################################################################################################################################
# Command defines
#-----------------------------------------------------------------------------------------------------------------------------------
use constant CFGDEF_LOG_FILE => 'log-file';
push @EXPORT, qw(CFGDEF_LOG_FILE);
use constant CFGDEF_LOG_LEVEL_DEFAULT => 'log-level-default';
push @EXPORT, qw(CFGDEF_LOG_LEVEL_DEFAULT);
use constant CFGDEF_LOCK_REQUIRED => 'lock-required';
push @EXPORT, qw(CFGDEF_LOCK_REQUIRED);
use constant CFGDEF_LOCK_REMOTE_REQUIRED => 'lock-remote-required';
push @EXPORT, qw(CFGDEF_LOCK_REMOTE_REQUIRED);
use constant CFGDEF_LOCK_TYPE => 'lock-type';
push @EXPORT, qw(CFGDEF_LOCK_TYPE);
use constant CFGDEF_LOCK_TYPE_NONE => 'none';
use constant CFGDEF_PARAMETER_ALLOWED => 'parameter-allowed';
push @EXPORT, qw(CFGDEF_PARAMETER_ALLOWED);
# Option defines
#-----------------------------------------------------------------------------------------------------------------------------------
use constant CFGDEF_ALLOW_LIST => 'allow-list';
push @EXPORT, qw(CFGDEF_ALLOW_LIST);
use constant CFGDEF_ALLOW_RANGE => 'allow-range';
push @EXPORT, qw(CFGDEF_ALLOW_RANGE);
use constant CFGDEF_DEFAULT => 'default';
push @EXPORT, qw(CFGDEF_DEFAULT);
use constant CFGDEF_DEFAULT_LITERAL => 'default-literal';
push @EXPORT, qw(CFGDEF_DEFAULT_LITERAL);
# Group options together to share common configuration
use constant CFGDEF_GROUP => 'group';
push @EXPORT, qw(CFGDEF_GROUP);
use constant CFGDEF_BETA => 'beta';
push @EXPORT, qw(CFGDEF_BETA);
use constant CFGDEF_INDEX => 'index';
push @EXPORT, qw(CFGDEF_INDEX);
use constant CFGDEF_INHERIT => 'inherit';
push @EXPORT, qw(CFGDEF_INHERIT);
use constant CFGDEF_INTERNAL => 'internal';
push @EXPORT, qw(CFGDEF_INTERNAL);
use constant CFGDEF_DEPRECATE => 'deprecate';
push @EXPORT, qw(CFGDEF_DEPRECATE);
use constant CFGDEF_NEGATE => 'negate';
push @EXPORT, qw(CFGDEF_NEGATE);
use constant CFGDEF_COMMAND => 'command';
push @EXPORT, qw(CFGDEF_COMMAND);
use constant CFGDEF_COMMAND_ROLE => 'command-role';
push @EXPORT, qw(CFGDEF_COMMAND_ROLE);
use constant CFGDEF_REQUIRED => 'required';
push @EXPORT, qw(CFGDEF_REQUIRED);
use constant CFGDEF_RESET => 'reset';
push @EXPORT, qw(CFGDEF_RESET);
use constant CFGDEF_SECTION => 'section';
push @EXPORT, qw(CFGDEF_SECTION);
use constant CFGDEF_SECURE => 'secure';
push @EXPORT, qw(CFGDEF_SECURE);
use constant CFGDEF_TYPE => 'type';
push @EXPORT, qw(CFGDEF_TYPE);
# Option types
#-----------------------------------------------------------------------------------------------------------------------------------
use constant CFGDEF_TYPE_BOOLEAN => 'boolean';
push @EXPORT, qw(CFGDEF_TYPE_BOOLEAN);
use constant CFGDEF_TYPE_HASH => 'hash';
push @EXPORT, qw(CFGDEF_TYPE_HASH);
use constant CFGDEF_TYPE_INTEGER => 'integer';
push @EXPORT, qw(CFGDEF_TYPE_INTEGER);
use constant CFGDEF_TYPE_LIST => 'list';
push @EXPORT, qw(CFGDEF_TYPE_LIST);
use constant CFGDEF_TYPE_PATH => 'path';
push @EXPORT, qw(CFGDEF_TYPE_PATH);
use constant CFGDEF_TYPE_STRING => 'string';
push @EXPORT, qw(CFGDEF_TYPE_STRING);
use constant CFGDEF_TYPE_SIZE => 'size';
push @EXPORT, qw(CFGDEF_TYPE_SIZE);
use constant CFGDEF_TYPE_TIME => 'time';
push @EXPORT, qw(CFGDEF_TYPE_TIME);
# Option config sections
#-----------------------------------------------------------------------------------------------------------------------------------
use constant CFGDEF_SECTION_GLOBAL => 'global';
push @EXPORT, qw(CFGDEF_SECTION_GLOBAL);
use constant CFGDEF_SECTION_STANZA => 'stanza';
push @EXPORT, qw(CFGDEF_SECTION_STANZA);
####################################################################################################################################
# Load configuration
####################################################################################################################################
use YAML::XS qw(LoadFile);
# Required so booleans are not read-only
local $YAML::XS::Boolean = "JSON::PP";
my $rhConfig = LoadFile(dirname(dirname($0)) . '/src/build/config/config.yaml');
my $rhCommandDefine = $rhConfig->{'command'};
my $rhOptionGroupDefine = $rhConfig->{'optionGroup'};
my $rhConfigDefine = $rhConfig->{'option'};
####################################################################################################################################
# Fix errors introduced by YAML::XS::LoadFile. This is typically fixed by setting local $YAML::XS::Boolean = "JSON::PP", but older
# Debian/Ubuntu versions do not support this fix. Some booleans get set read only and others also end up as empty strings. There is
# no apparent pattern to what gets broken so it is important to be on the lookout for strange output when adding new options.
#
# ??? For now this code is commented out since packages for older Debians can be built using backports. It is being preserved just
# in case it is needed before the migration to C is complete.
####################################################################################################################################
# sub optionDefineFixup
# {
# my $strKey = shift;
# my $rhDefine = shift;
#
# # Fix read-only required values so they are writable
# if (defined($rhDefine->{&CFGDEF_REQUIRED}))
# {
# my $value = $rhDefine->{&CFGDEF_REQUIRED} ? true : false;
# delete($rhDefine->{&CFGDEF_REQUIRED});
# $rhDefine->{&CFGDEF_REQUIRED} = $value;
# }
#
# # If the default is an empty string set to false. This must be a mangled boolean since empty strings are not valid defaults.
# if (defined($rhDefine->{&CFGDEF_DEFAULT}) && $rhDefine->{&CFGDEF_DEFAULT} eq '')
# {
# delete($rhDefine->{&CFGDEF_DEFAULT});
# $rhDefine->{&CFGDEF_DEFAULT} = false;
# }
# }
#
# # Fix all options
# foreach my $strKey (sort(keys(%{$rhConfigDefine})))
# {
# my $rhOption = $rhConfigDefine->{$strKey};
# optionDefineFixup($strKey, $rhOption);
#
# # Fix all option commands
# if (ref($rhOption->{&CFGDEF_COMMAND}))
# {
# foreach my $strCommand (sort(keys(%{$rhOption->{&CFGDEF_COMMAND}})))
# {
# optionDefineFixup("$strKey-$strCommand", $rhOption->{&CFGDEF_COMMAND}{$strCommand});
# }
# }
# }
####################################################################################################################################
# Process command define defaults
####################################################################################################################################
foreach my $strCommand (sort(keys(%{$rhCommandDefine})))
{
# Commands are external by default
if (!defined($rhCommandDefine->{$strCommand}{&CFGDEF_INTERNAL}))
{
$rhCommandDefine->{$strCommand}{&CFGDEF_INTERNAL} = false;
}
# Log files are created by default
if (!defined($rhCommandDefine->{$strCommand}{&CFGDEF_LOG_FILE}))
{
$rhCommandDefine->{$strCommand}{&CFGDEF_LOG_FILE} = true;
}
# Default log level is INFO
if (!defined($rhCommandDefine->{$strCommand}{&CFGDEF_LOG_LEVEL_DEFAULT}))
{
$rhCommandDefine->{$strCommand}{&CFGDEF_LOG_LEVEL_DEFAULT} = INFO;
}
# Default lock required is false
if (!defined($rhCommandDefine->{$strCommand}{&CFGDEF_LOCK_REQUIRED}))
{
$rhCommandDefine->{$strCommand}{&CFGDEF_LOCK_REQUIRED} = false;
}
# Default lock remote required is false
if (!defined($rhCommandDefine->{$strCommand}{&CFGDEF_LOCK_REMOTE_REQUIRED}))
{
$rhCommandDefine->{$strCommand}{&CFGDEF_LOCK_REMOTE_REQUIRED} = false;
}
# Lock type must be set if a lock is required
if (!defined($rhCommandDefine->{$strCommand}{&CFGDEF_LOCK_TYPE}))
{
# Is a lock type required?
if ($rhCommandDefine->{$strCommand}{&CFGDEF_LOCK_REQUIRED})
{
confess &log(ERROR, "lock type is required for command '${strCommand}'");
}
$rhCommandDefine->{$strCommand}{&CFGDEF_LOCK_TYPE} = CFGDEF_LOCK_TYPE_NONE;
}
else
{
if ($rhCommandDefine->{$strCommand}{&CFGDEF_LOCK_REQUIRED} &&
$rhCommandDefine->{$strCommand}{&CFGDEF_LOCK_TYPE} eq CFGDEF_LOCK_TYPE_NONE)
{
confess &log(ERROR, "lock type is required for command '${strCommand}' and cannot be 'none'");
}
}
# Default parameter allowed is false
if (!defined($rhCommandDefine->{$strCommand}{&CFGDEF_PARAMETER_ALLOWED}))
{
$rhCommandDefine->{$strCommand}{&CFGDEF_PARAMETER_ALLOWED} = false;
}
# All commands have the default role
if (!defined($rhCommandDefine->{$strCommand}{&CFGDEF_COMMAND_ROLE}{&CFGCMD_ROLE_MAIN}))
{
$rhCommandDefine->{$strCommand}{&CFGDEF_COMMAND_ROLE}{&CFGCMD_ROLE_MAIN} = {};
}
}
####################################################################################################################################
# Process option define defaults
####################################################################################################################################
foreach my $strKey (sort(keys(%{$rhConfigDefine})))
{
my $rhOption = $rhConfigDefine->{$strKey};
# If the define is a scalar then copy the entire define from the referenced option
if (defined($rhConfigDefine->{$strKey}{&CFGDEF_INHERIT}))
{
# Make a copy in case there are overrides that need to be applied after inheriting
my $hConfigDefineOverride = dclone($rhConfigDefine->{$strKey});
# Copy the option being inherited from
$rhConfigDefine->{$strKey} = dclone($rhConfigDefine->{$rhConfigDefine->{$strKey}{&CFGDEF_INHERIT}});
# No need to copy the inheritance key
delete($rhConfigDefine->{$strKey}{&CFGDEF_INHERIT});
# It makes no sense to inherit deprecations - they must be specified for each option
delete($rhConfigDefine->{$strKey}{&CFGDEF_DEPRECATE});
# Apply overrides
foreach my $strOptionDef (sort(keys(%{$hConfigDefineOverride})))
{
$rhConfigDefine->{$strKey}{$strOptionDef} = $hConfigDefineOverride->{$strOptionDef};
}
# Update option variable with new hash reference
$rhOption = $rhConfigDefine->{$strKey}
}
# If command is not specified then the option is valid for all commands except version and help
if (!defined($rhOption->{&CFGDEF_COMMAND}))
{
foreach my $strCommand (sort(keys(%{$rhCommandDefine})))
{
next if $strCommand eq CFGCMD_HELP || $strCommand eq CFGCMD_VERSION;
$rhOption->{&CFGDEF_COMMAND}{$strCommand} = {};
}
}
# Else if the command section is a scalar then copy the section from the referenced option
elsif (defined($rhConfigDefine->{$strKey}{&CFGDEF_COMMAND}) && !ref($rhConfigDefine->{$strKey}{&CFGDEF_COMMAND}))
{
$rhConfigDefine->{$strKey}{&CFGDEF_COMMAND} =
dclone($rhConfigDefine->{$rhConfigDefine->{$strKey}{&CFGDEF_COMMAND}}{&CFGDEF_COMMAND});
}
# If the allow list is a scalar then copy the list from the referenced option
if (defined($rhConfigDefine->{$strKey}{&CFGDEF_ALLOW_LIST}) && !ref($rhConfigDefine->{$strKey}{&CFGDEF_ALLOW_LIST}))
{
$rhConfigDefine->{$strKey}{&CFGDEF_ALLOW_LIST} =
dclone($rhConfigDefine->{$rhConfigDefine->{$strKey}{&CFGDEF_ALLOW_LIST}}{&CFGDEF_ALLOW_LIST});
}
# Default type is string
if (!defined($rhConfigDefine->{$strKey}{&CFGDEF_TYPE}))
{
&log(ASSERT, "type is required for option '${strKey}'");
}
# Default required is true
if (!defined($rhConfigDefine->{$strKey}{&CFGDEF_REQUIRED}))
{
$rhConfigDefine->{$strKey}{&CFGDEF_REQUIRED} = true;
}
# Default internal is false
if (!defined($rhConfigDefine->{$strKey}{&CFGDEF_INTERNAL}))
{
$rhConfigDefine->{$strKey}{&CFGDEF_INTERNAL} = false;
}
# All boolean config options can be negated. Boolean command-line options must be marked for negation individually.
if ($rhConfigDefine->{$strKey}{&CFGDEF_TYPE} eq CFGDEF_TYPE_BOOLEAN && defined($rhConfigDefine->{$strKey}{&CFGDEF_SECTION}))
{
$rhConfigDefine->{$strKey}{&CFGDEF_NEGATE} = true;
}
# Default for negation is false
if (!defined($rhConfigDefine->{$strKey}{&CFGDEF_NEGATE}))
{
$rhConfigDefine->{$strKey}{&CFGDEF_NEGATE} = false;
}
# All config options can be reset
if (defined($rhConfigDefine->{$strKey}{&CFGDEF_SECTION}))
{
$rhConfigDefine->{$strKey}{&CFGDEF_RESET} = true;
}
elsif (!defined($rhConfigDefine->{$strKey}{&CFGDEF_RESET}))
{
$rhConfigDefine->{$strKey}{&CFGDEF_RESET} = false;
}
# By default options are not secure
if (!defined($rhConfigDefine->{$strKey}{&CFGDEF_SECURE}))
{
$rhConfigDefine->{$strKey}{&CFGDEF_SECURE} = false;
}
# All size and time options must have an allow range
if (($rhConfigDefine->{$strKey}{&CFGDEF_TYPE} eq CFGDEF_TYPE_TIME ||
$rhConfigDefine->{$strKey}{&CFGDEF_TYPE} eq CFGDEF_TYPE_SIZE) &&
!(defined($rhConfigDefine->{$strKey}{&CFGDEF_ALLOW_RANGE}) || defined($rhConfigDefine->{$strKey}{&CFGDEF_ALLOW_LIST})))
{
confess &log(ASSERT, "int/size/time option '${strKey}' must have allow range or list");
}
# Ensure all commands are valid
foreach my $strCommand (sort(keys(%{$rhConfigDefine->{$strKey}{&CFGDEF_COMMAND}})))
{
if (!defined($rhCommandDefine->{$strCommand}))
{
confess &log(ASSERT, "invalid command '${strCommand}'");
}
}
}
# Generate valid command roles for each option
foreach my $strOption (sort(keys(%{$rhConfigDefine})))
{
my $rhOption = $rhConfigDefine->{$strOption};
# Generate valid command roles for each command in the option
foreach my $strCommand (sort(keys(%{$rhOption->{&CFGDEF_COMMAND}})))
{
# If command roles are defined in the option command override then check that they are valid
if (defined($rhOption->{&CFGDEF_COMMAND}{$strCommand}{&CFGDEF_COMMAND_ROLE}))
{
foreach my $strCommandRole (sort(keys(%{$rhOption->{&CFGDEF_COMMAND}{$strCommand}{&CFGDEF_COMMAND_ROLE}})))
{
if (!defined($rhCommandDefine->{$strCommand}{&CFGDEF_COMMAND_ROLE}{$strCommandRole}))
{
confess &log(
ASSERT, "option '${strOption}', command '${strCommand}' has invalid command role '${strCommandRole}'");
}
}
}
# Else if the option has command roles defined then use the intersection of command roles with the command
elsif (defined($rhOption->{&CFGDEF_COMMAND_ROLE}))
{
foreach my $strCommandRole (sort(keys(%{$rhOption->{&CFGDEF_COMMAND_ROLE}})))
{
if (defined($rhCommandDefine->{$strCommand}{&CFGDEF_COMMAND_ROLE}{$strCommandRole}))
{
$rhOption->{&CFGDEF_COMMAND}{$strCommand}{&CFGDEF_COMMAND_ROLE}{$strCommandRole} = {};
}
}
}
# Else copy the command roles from the command
else
{
foreach my $strCommandRole (sort(keys(%{$rhCommandDefine->{$strCommand}{&CFGDEF_COMMAND_ROLE}})))
{
$rhOption->{&CFGDEF_COMMAND}{$strCommand}{&CFGDEF_COMMAND_ROLE}{$strCommandRole} = {};
}
}
}
# Remove option command roles so they don't accidentally get used in processing (since they were copied to option commands)
delete($rhOption->{&CFGDEF_COMMAND_ROLE});
}
####################################################################################################################################
# Get option definition
####################################################################################################################################
sub cfgDefine
{
return dclone($rhConfigDefine);
}
push @EXPORT, qw(cfgDefine);
####################################################################################################################################
# Get command definition
####################################################################################################################################
sub cfgDefineCommand
{
return dclone($rhCommandDefine);
}
push @EXPORT, qw(cfgDefineCommand);
####################################################################################################################################
# Get option group definition
####################################################################################################################################
sub cfgDefineOptionGroup
{
return dclone($rhOptionGroupDefine);
}
push @EXPORT, qw(cfgDefineOptionGroup);
####################################################################################################################################
# Get list of all commands
####################################################################################################################################
sub cfgDefineCommandList
{
# Return sorted list
return (sort(keys(%{$rhCommandDefine})));
}
push @EXPORT, qw(cfgDefineCommandList);
####################################################################################################################################
# Get list of all option types
####################################################################################################################################
sub cfgDefineOptionTypeList
{
my $rhOptionTypeMap;
# Get unique list of types
foreach my $strOption (sort(keys(%{$rhConfigDefine})))
{
my $strOptionType = $rhConfigDefine->{$strOption}{&CFGDEF_TYPE};
if (!defined($rhOptionTypeMap->{$strOptionType}))
{
$rhOptionTypeMap->{$strOptionType} = true;
}
};
# Return sorted list
return (sort(keys(%{$rhOptionTypeMap})));
}
push @EXPORT, qw(cfgDefineOptionTypeList);
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Custom/DocCustomRelease.pm 0000664 0000000 0000000 00000067054 15006170376 0026367 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC RELEASE MODULE
####################################################################################################################################
package pgBackRestDoc::Custom::DocCustomRelease;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use pgBackRestDoc::Common::DocRender;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::ProjectInfo;
####################################################################################################################################
# XML node constants
####################################################################################################################################
use constant XML_PARAM_ID => 'id';
use constant XML_CONTRIBUTOR_LIST => 'contributor-list';
use constant XML_CONTRIBUTOR => 'contributor';
use constant XML_CONTRIBUTOR_NAME_DISPLAY => 'contributor-name-display';
use constant XML_RELEASE_CORE_LIST => 'release-core-list';
use constant XML_RELEASE_DOC_LIST => 'release-doc-list';
use constant XML_RELEASE_TEST_LIST => 'release-test-list';
use constant XML_RELEASE_BUG_LIST => 'release-bug-list';
use constant XML_RELEASE_DEVELOPMENT_LIST => 'release-development-list';
use constant XML_RELEASE_FEATURE_LIST => 'release-feature-list';
use constant XML_RELEASE_IMPROVEMENT_LIST => 'release-improvement-list';
use constant XML_RELEASE_ITEM_CONTRIBUTOR_LIST => 'release-item-contributor-list';
use constant XML_RELEASE_ITEM_CONTRIBUTOR => 'release-item-contributor';
use constant XML_RELEASE_ITEM_IDEATOR => 'release-item-ideator';
use constant XML_RELEASE_ITEM_REVIEWER => 'release-item-reviewer';
####################################################################################################################################
# Contributor text constants
####################################################################################################################################
use constant TEXT_CONTRIBUTED => 'Contributed';
use constant TEXT_FIXED => 'Fixed';
use constant TEXT_FOUND => 'Reported';
use constant TEXT_REVIEWED => 'Reviewed';
use constant TEXT_SUGGESTED => 'Suggested';
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oDoc},
$self->{bDev},
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oDoc'},
{name => 'bDev', required => false, default => false},
);
# Get contributor list
foreach my $oContributor ($self->{oDoc}->nodeGet(XML_CONTRIBUTOR_LIST)->nodeList(XML_CONTRIBUTOR))
{
my $strContributorId = $oContributor->paramGet(XML_PARAM_ID);
if (!defined($self->{hContributor}))
{
$self->{hContributor} = {};
$self->{strContributorDefault} = $strContributorId;
}
${$self->{hContributor}}{$strContributorId}{name} = $oContributor->fieldGet(XML_CONTRIBUTOR_NAME_DISPLAY);
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# currentStableVersion
#
# Return the current stable version.
####################################################################################################################################
sub currentStableVersion
{
my $self = shift;
my $oDoc = $self->{oDoc};
foreach my $oRelease ($oDoc->nodeGet('release-list')->nodeList('release'))
{
my $strVersion = $oRelease->paramGet('version');
if ($strVersion !~ /dev$/)
{
return $strVersion;
}
}
confess &log(ERROR, "unable to find non-development version");
}
####################################################################################################################################
# releaseLast
#
# Get the last release.
####################################################################################################################################
sub releaseLast
{
my $self = shift;
my $oDoc = $self->{oDoc};
foreach my $oRelease ($oDoc->nodeGet('release-list')->nodeList('release'))
{
return $oRelease;
}
}
####################################################################################################################################
# contributorTextGet
#
# Get a list of contributors for an item in text format.
####################################################################################################################################
sub contributorTextGet
{
my $self = shift;
my $oReleaseItem = shift;
my $strItemType = shift;
my $strContributorText;
my $hItemContributorType = {};
# Create a the list of contributors
foreach my $strContributorType (XML_RELEASE_ITEM_IDEATOR, XML_RELEASE_ITEM_CONTRIBUTOR, XML_RELEASE_ITEM_REVIEWER)
{
my $stryItemContributor = [];
if ($oReleaseItem->nodeTest(XML_RELEASE_ITEM_CONTRIBUTOR_LIST))
{
foreach my $oContributor ($oReleaseItem->nodeGet(XML_RELEASE_ITEM_CONTRIBUTOR_LIST)->
nodeList($strContributorType, false))
{
push @{$stryItemContributor}, $oContributor->paramGet(XML_PARAM_ID);
}
}
if (@$stryItemContributor == 0 && $strContributorType eq XML_RELEASE_ITEM_CONTRIBUTOR)
{
push @{$stryItemContributor}, $self->{strContributorDefault}
}
# Add the default user as a reviewer if there are no reviewers listed and default user is not already a contributor
if (@$stryItemContributor == 0 && $strContributorType eq XML_RELEASE_ITEM_REVIEWER)
{
my $bFound = false;
foreach my $strContributor (@{$$hItemContributorType{&XML_RELEASE_ITEM_CONTRIBUTOR}})
{
if ($strContributor eq $self->{strContributorDefault})
{
$bFound = true;
last;
}
}
if (!$bFound)
{
push @{$stryItemContributor}, $self->{strContributorDefault}
}
}
$$hItemContributorType{$strContributorType} = $stryItemContributor;
}
# Error if a reviewer is also a contributor
foreach my $strReviewer (@{$$hItemContributorType{&XML_RELEASE_ITEM_REVIEWER}})
{
foreach my $strContributor (@{$$hItemContributorType{&XML_RELEASE_ITEM_CONTRIBUTOR}})
{
if ($strReviewer eq $strContributor)
{
confess &log(ERROR, "${strReviewer} cannot be both a contributor and a reviewer");
}
}
}
# Error if the ideator list is the same as the contributor list
if (join(',', @{$$hItemContributorType{&XML_RELEASE_ITEM_IDEATOR}}) eq
join(',', @{$$hItemContributorType{&XML_RELEASE_ITEM_CONTRIBUTOR}}))
{
confess &log(ERROR, 'cannot have same contributor and ideator list: ' .
join(', ', @{$$hItemContributorType{&XML_RELEASE_ITEM_CONTRIBUTOR}}));
}
# Remove the default user if they are the only one in a group (to prevent the entire page from being splattered with one name)
foreach my $strContributorType (XML_RELEASE_ITEM_IDEATOR, XML_RELEASE_ITEM_CONTRIBUTOR)
{
if (@{$$hItemContributorType{$strContributorType}} == 1 &&
@{$$hItemContributorType{$strContributorType}}[0] eq $self->{strContributorDefault})
{
$$hItemContributorType{$strContributorType} = [];
}
}
# Render the string
foreach my $strContributorType (XML_RELEASE_ITEM_CONTRIBUTOR, XML_RELEASE_ITEM_REVIEWER, XML_RELEASE_ITEM_IDEATOR)
{
my $stryItemContributor = $$hItemContributorType{$strContributorType};
my $strContributorTypeText;
foreach my $strContributor (@{$stryItemContributor})
{
my $hContributor = ${$self->{hContributor}}{$strContributor};
if (!defined($hContributor))
{
confess &log(ERROR, "contributor ${strContributor} does not exist");
}
$strContributorTypeText .= (defined($strContributorTypeText) ? ', ' : '') . $$hContributor{name};
}
if (defined($strContributorTypeText))
{
$strContributorTypeText = ' by ' . $strContributorTypeText . '.';
if ($strContributorType eq XML_RELEASE_ITEM_CONTRIBUTOR)
{
$strContributorTypeText = ($strItemType eq 'bug' ? TEXT_FIXED : TEXT_CONTRIBUTED) . $strContributorTypeText;
}
elsif ($strContributorType eq XML_RELEASE_ITEM_IDEATOR)
{
$strContributorTypeText = ($strItemType eq 'bug' ? TEXT_FOUND : TEXT_SUGGESTED) . $strContributorTypeText;
}
elsif ($strContributorType eq XML_RELEASE_ITEM_REVIEWER)
{
$strContributorTypeText = TEXT_REVIEWED . $strContributorTypeText;
}
$strContributorText .= (defined($strContributorText) ? ' ' : '') . $strContributorTypeText;
}
}
return $strContributorText;
}
####################################################################################################################################
# Find a commit by subject prefix. Error if the prefix appears more than once.
####################################################################################################################################
sub commitFindSubject
{
my $self = shift;
my $rhyCommit = shift;
my $strSubjectPrefix = shift;
my $bRegExp = shift;
$bRegExp = defined($bRegExp) ? $bRegExp : true;
my $rhResult = undef;
foreach my $rhCommit (@{$rhyCommit})
{
if (($bRegExp && $rhCommit->{subject} =~ /^$strSubjectPrefix/) ||
(!$bRegExp && length($rhCommit->{subject}) >= length($strSubjectPrefix) &&
substr($rhCommit->{subject}, 0, length($strSubjectPrefix)) eq $strSubjectPrefix))
{
if (defined($rhResult))
{
confess &log(ERROR, "subject prefix '${strSubjectPrefix}' already found in commit " . $rhCommit->{commit});
}
$rhResult = $rhCommit;
}
}
return $rhResult;
}
####################################################################################################################################
# Throw an error that includes a list of release commits
####################################################################################################################################
sub commitError
{
my $self = shift;
my $strMessage = shift;
my $rstryCommitRemaining = shift;
my $rhyCommit = shift;
my $strList;
foreach my $strCommit (@{$rstryCommitRemaining})
{
$strList .=
(defined($strList) ? "\n" : '') .
substr($rhyCommit->{$strCommit}{date}, 0, length($rhyCommit->{$strCommit}{date}) - 15) . " $strCommit: " .
$rhyCommit->{$strCommit}{subject};
}
confess &log(ERROR, "${strMessage}:\n${strList}");
}
####################################################################################################################################
# docGet
#
# Get the xml for release.
####################################################################################################################################
sub docGet
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->docGet');
# Load the git history
my $oStorageDoc = new pgBackRestTest::Common::Storage(
dirname(abs_path($0)), new pgBackRestTest::Common::StoragePosix({bFileSync => false, bPathSync => false}));
my @hyGitLog = @{(JSON::PP->new()->allow_nonref())->decode(${$oStorageDoc->get("resource/git-history.cache")})};
# Get renderer
my $oRender = new pgBackRestDoc::Common::DocRender('text');
$oRender->tagSet('backrest', PROJECT_NAME);
# Create the doc
my $oDoc = new pgBackRestDoc::Common::Doc();
$oDoc->paramSet('title', $self->{oDoc}->paramGet('title'));
$oDoc->paramSet('toc-number', $self->{oDoc}->paramGet('toc-number'));
# Set the description for use as a meta tag
$oDoc->fieldSet('description', $self->{oDoc}->fieldGet('description'));
# Add the introduction
my $oIntroSectionDoc = $oDoc->nodeAdd('section', undef, {id => 'introduction'});
$oIntroSectionDoc->nodeAdd('title')->textSet('Introduction');
$oIntroSectionDoc->textSet($self->{oDoc}->nodeGet('intro')->textGet());
# Add each release section
my $oSection;
my $iDevReleaseTotal = 0;
my $iCurrentReleaseTotal = 0;
my $iStableReleaseTotal = 0;
my $iUnsupportedReleaseTotal = 0;
my @oyRelease = $self->{oDoc}->nodeGet('release-list')->nodeList('release');
for (my $iReleaseIdx = 0; $iReleaseIdx < @oyRelease; $iReleaseIdx++)
{
my $oRelease = $oyRelease[$iReleaseIdx];
# Get the release version and dev flag
my $strVersion = $oRelease->paramGet('version');
my $bReleaseDev = $strVersion =~ /dev$/ ? true : false;
# Get a list of commits that apply to this release
my @rhyReleaseCommit;
my $rhReleaseCommitRemaining;
my @stryReleaseCommitRemaining;
my $bReleaseCheckCommit = false;
# Check versions except for bug fix releases that are not the most recent release (since bug fixes on are separate branches)
if ($strVersion ge '2.01' && !($strVersion =~ /^[0-9]+\.[0-9]+\.[0-9]+$/ && $iReleaseIdx != 0))
{
# Should commits in the release be checked?
$bReleaseCheckCommit = !$bReleaseDev ? true : false;
# Get the begin commit
my $rhReleaseCommitBegin = $self->commitFindSubject(\@hyGitLog, "Begin v${strVersion} development\\.");
my $strReleaseCommitBegin = defined($rhReleaseCommitBegin) ? $rhReleaseCommitBegin->{commit} : undef;
# Get the end commit of the last release (skipping bug fixes which are on separate branches)
my $iReleaseLastVersionIdx = $iReleaseIdx + 1;
my $strReleaseLastVersion = $oyRelease[$iReleaseLastVersionIdx]->paramGet('version');
while ($strReleaseLastVersion =~ /^[0-9]+\.[0-9]+\.[0-9]+$/)
{
$iReleaseLastVersionIdx++;
$strReleaseLastVersion = $oyRelease[$iReleaseLastVersionIdx]->paramGet('version');
}
my $rhReleaseLastCommitEnd = $self->commitFindSubject(\@hyGitLog, "v${strReleaseLastVersion}\\: .+");
if (!defined($rhReleaseLastCommitEnd))
{
confess &log(ERROR, "release ${strReleaseLastVersion} must have an end commit");
}
my $strReleaseLastCommitEnd = $rhReleaseLastCommitEnd->{commit};
# Get the end commit
my $rhReleaseCommitEnd = $self->commitFindSubject(\@hyGitLog, "v${strVersion}\\: .+");
my $strReleaseCommitEnd = defined($rhReleaseCommitEnd) ? $rhReleaseCommitEnd->{commit} : undef;
if ($bReleaseCheckCommit && !defined($rhReleaseCommitEnd) && $iReleaseIdx != 0)
{
confess &log(ERROR, "release ${strVersion} must have an end commit");
}
# Make a list of commits for this release
while ($hyGitLog[0]->{commit} ne $strReleaseLastCommitEnd)
{
# Don't add begin/end commits to the list since they are already accounted for
if ((defined($strReleaseCommitEnd) && $hyGitLog[0]->{commit} eq $strReleaseCommitEnd) ||
(defined($strReleaseCommitBegin) && $hyGitLog[0]->{commit} eq $strReleaseCommitBegin))
{
shift(@hyGitLog);
}
# Else add the commit to this releases' list
else
{
push(@stryReleaseCommitRemaining, $hyGitLog[0]->{commit});
push(@rhyReleaseCommit, $hyGitLog[0]);
$rhReleaseCommitRemaining->{$hyGitLog[0]->{commit}}{date} = $hyGitLog[0]->{date};
$rhReleaseCommitRemaining->{$hyGitLog[0]->{commit}}{subject} = $hyGitLog[0]->{subject};
shift(@hyGitLog);
}
}
# At least one commit is required for non-dev releases
if ($bReleaseCheckCommit && @stryReleaseCommitRemaining == 0)
{
confess &log(ERROR, "no commits found for release ${strVersion}");
}
}
# Display versions in TOC?
my $bTOC = true;
# Create a release section
if ($bReleaseDev)
{
if ($iDevReleaseTotal > 1)
{
confess &log(ERROR, 'only one development release is allowed');
}
$oSection = $oDoc->nodeAdd('section', undef, {id => 'development', if => "'{[dev]}' eq 'y'"});
$oSection->nodeAdd('title')->textSet("Development Notes");
$iDevReleaseTotal++;
}
elsif ($iCurrentReleaseTotal == 0)
{
$oSection = $oDoc->nodeAdd('section', undef, {id => 'current'});
$oSection->nodeAdd('title')->textSet("Current Stable Release");
$iCurrentReleaseTotal++;
}
elsif ($strVersion ge '1.00')
{
if ($iStableReleaseTotal == 0)
{
$oSection = $oDoc->nodeAdd('section', undef, {id => 'supported'});
$oSection->nodeAdd('title')->textSet("Stable Releases");
}
$iStableReleaseTotal++;
$bTOC = false;
}
else
{
if ($iUnsupportedReleaseTotal == 0)
{
$oSection = $oDoc->nodeAdd('section', undef, {id => 'unsupported'});
$oSection->nodeAdd('title')->textSet("Pre-Stable Releases");
}
$iUnsupportedReleaseTotal++;
$bTOC = false;
}
# Format the date
my $strDate = $oRelease->paramGet('date');
my $strDateOut = "";
my @stryMonth = ('January', 'February', 'March', 'April', 'May', 'June',
'July', 'August', 'September', 'October', 'November', 'December');
if ($strDate =~ /^X/)
{
$strDateOut .= 'No Release Date Set';
}
else
{
if ($strDate !~ /^(XXXX-XX-XX)|([0-9]{4}-[0-9]{2}-[0-9]{2})$/)
{
confess &log(ASSERT, "invalid date ${strDate} for release {$strVersion}");
}
$strDateOut .= 'Released ' . $stryMonth[(substr($strDate, 5, 2) - 1)] . ' ' .
(substr($strDate, 8, 2) + 0) . ', ' . substr($strDate, 0, 4);
}
# Add section and titles
my $oReleaseSection = $oSection->nodeAdd('section', undef, {id => $strVersion, toc => !$bTOC ? 'n' : undef});
$oReleaseSection->paramSet(XML_SECTION_PARAM_ANCHOR, XML_SECTION_PARAM_ANCHOR_VALUE_NOINHERIT);
$oReleaseSection->nodeAdd('title')->textSet(
"v${strVersion} " . ($bReleaseDev ? '' : 'Release ') . 'Notes');
$oReleaseSection->nodeAdd('subtitle')->textSet($oRelease->paramGet('title'));
$oReleaseSection->nodeAdd('subsubtitle')->textSet($strDateOut);
# Add release sections
my $bReleaseNote = false;
my $hSectionType =
{
&XML_RELEASE_CORE_LIST => {title => 'Core', type => 'core'},
&XML_RELEASE_DOC_LIST => {title => 'Documentation', type => 'doc'},
&XML_RELEASE_TEST_LIST => {title => 'Test Suite', type => 'test'},
};
foreach my $strSectionType (XML_RELEASE_CORE_LIST, XML_RELEASE_DOC_LIST, XML_RELEASE_TEST_LIST)
{
if ($oRelease->nodeTest($strSectionType))
{
# Add release item types
my $hItemType =
{
&XML_RELEASE_BUG_LIST => {title => 'Bug Fixes', type => 'bug'},
&XML_RELEASE_FEATURE_LIST => {title => 'Features', type => 'feature'},
&XML_RELEASE_IMPROVEMENT_LIST => {title => 'Improvements', type => 'improvement'},
&XML_RELEASE_DEVELOPMENT_LIST => {title => 'Development', type => 'development'},
};
foreach my $strItemType (
XML_RELEASE_BUG_LIST, XML_RELEASE_FEATURE_LIST, XML_RELEASE_IMPROVEMENT_LIST, XML_RELEASE_DEVELOPMENT_LIST)
{
next if (!$self->{bDev} && $strItemType eq XML_RELEASE_DEVELOPMENT_LIST);
if ($oRelease->nodeGet($strSectionType)->nodeTest($strItemType))
{
# Add release note if present
if (!$bReleaseNote && defined($oRelease->nodeGet($strSectionType)->textGet(false)))
{
$oReleaseSection->nodeAdd('p')->textSet($oRelease->nodeGet($strSectionType)->textGet());
$bReleaseNote = true;
}
my $strTypeText =
($strSectionType eq XML_RELEASE_CORE_LIST ? '' : $$hSectionType{$strSectionType}{title}) . ' ' .
$$hItemType{$strItemType}{title} . ':';
$oReleaseSection->
nodeAdd('p')->textSet(
{name => 'text', children=> [{name => 'b', value => $strTypeText}]});
my $oList = $oReleaseSection->nodeAdd('list');
# Add release items
foreach my $oReleaseFeature ($oRelease->nodeGet($strSectionType)->
nodeGet($strItemType)->nodeList('release-item'))
{
my @rhyReleaseItemP = $oReleaseFeature->nodeList('p');
my $oReleaseItemText = $rhyReleaseItemP[0]->textGet();
# Check release item commits
if ($bReleaseCheckCommit && $strItemType ne XML_RELEASE_DEVELOPMENT_LIST)
{
my @oyCommit = $oReleaseFeature->nodeList('commit', false);
# If no commits found then try to use the description as the commit subject
if (@oyCommit == 0)
{
my $strSubject = $oRender->processText($oReleaseItemText);
my $rhCommit = $self->commitFindSubject(\@rhyReleaseCommit, $strSubject, false);
if (!defined($rhCommit))
{
$self->commitError(
"unable to find commit or no subject match for release ${strVersion} item" .
" '${strSubject}'",
\@stryReleaseCommitRemaining, $rhReleaseCommitRemaining);
my $strCommit = $rhCommit->{commit};
@stryReleaseCommitRemaining = grep(!/$strCommit/, @stryReleaseCommitRemaining);
}
}
# Check the rest of the commits to ensure they exist
foreach my $oCommit (@oyCommit)
{
my $strSubject = $oCommit->paramGet('subject');
my $rhCommit = $self->commitFindSubject(\@rhyReleaseCommit, $strSubject, false);
if (defined($rhCommit))
{
my $strCommit = $rhCommit->{commit};
@stryReleaseCommitRemaining = grep(!/$strCommit/, @stryReleaseCommitRemaining);
}
else
{
$self->commitError(
"unable to find release ${strVersion} commit subject '${strSubject}' in list",
\@stryReleaseCommitRemaining, $rhReleaseCommitRemaining);
}
}
}
# Append the rest of the text
if (@rhyReleaseItemP > 1)
{
shift(@rhyReleaseItemP);
push(@{$oReleaseItemText->{oDoc}{children}}, ' ');
foreach my $rhReleaseItemP (@rhyReleaseItemP)
{
push(@{$oReleaseItemText->{oDoc}{children}}, @{$rhReleaseItemP->textGet()->{oDoc}{children}});
}
}
# Append contributor info
my $strContributorText = $self->contributorTextGet($oReleaseFeature, $$hItemType{$strItemType}{type});
if (defined($strContributorText))
{
push(@{$oReleaseItemText->{oDoc}{children}}, ' (');
push(@{$oReleaseItemText->{oDoc}{children}},
{name => 'i', value => $strContributorText});
push(@{$oReleaseItemText->{oDoc}{children}}, ')');
}
# Add the list item
$oList->nodeAdd('list-item')->textSet($oReleaseItemText);
}
}
}
}
}
# Error if there are commits left over
# if ($bReleaseCheckCommit && @stryReleaseCommitRemaining != 0)
# {
# $self->commitError(
# "unassigned commits for release ${strVersion}", \@stryReleaseCommitRemaining, $rhReleaseCommitRemaining);
# }
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oDoc', value => $oDoc}
);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Html/ 0000775 0000000 0000000 00000000000 15006170376 0022246 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Html/DocHtmlBuilder.pm 0000664 0000000 0000000 00000024675 15006170376 0025463 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC HTML BUILDER MODULE
####################################################################################################################################
package pgBackRestDoc::Html::DocHtmlBuilder;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Exporter qw(import);
our @EXPORT = qw();
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::Html::DocHtmlElement;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{strName},
$self->{strTitle},
$self->{strFavicon},
$self->{strLogo},
$self->{strDescription},
$self->{bPretty},
$self->{bCompact},
$self->{strCss},
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strName'},
{name => 'strTitle'},
{name => 'strFavicon', required => false},
{name => 'strLogo', required => false},
{name => 'strDescription', required => false},
{name => 'bPretty', default => false},
{name => 'bCompact', default => false},
{name => 'strCss', required => false},
);
$self->{oBody} = new pgBackRestDoc::Html::DocHtmlElement(HTML_BODY);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# indent
#
# Indent html
####################################################################################################################################
sub indent
{
my $self = shift;
my $iDepth = shift;
return $self->{bPretty} ? (' ' x $iDepth) : '';
}
####################################################################################################################################
# lf
#
# Add a linefeed.
####################################################################################################################################
sub lf
{
my $self = shift;
return $self->{bPretty} ? "\n" : '';
}
####################################################################################################################################
# bodyGet
#
# Get the body element.
####################################################################################################################################
sub bodyGet
{
my $self = shift;
return $self->{oBody};
}
####################################################################################################################################
# htmlRender
#
# Render each html element.
####################################################################################################################################
sub htmlRender
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my (
$strOperation,
$oElement,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->htmlRender', \@_,
{name => 'oElement', trace => true},
{name => 'iDepth', trace => true}
);
# If a pre tag add a linefeed before the tag unless the prior tag was also pre. This makes the output more diffable.
my $strHtml = "";
if ($oElement->{strType} eq HTML_PRE && !$self->{bPretty})
{
if (!$self->{bPrePrior})
{
$strHtml .= "\n";
}
$self->{bPrePrior} = true;
}
else
{
$self->{bPrePrior} = false;
}
# Build the tag
$strHtml .=
$self->indent($iDepth) . "<$oElement->{strType}" .
(defined($oElement->{strClass}) ? " class=\"$oElement->{strClass}\"": '') .
(defined($oElement->{strRef}) ? " href=\"$oElement->{strRef}\"": '') .
(defined($oElement->{strId}) ? " id=\"$oElement->{strId}\"": '') .
(defined($oElement->{strExtra}) ? " $oElement->{strExtra}": '') . '>';
if (defined($oElement->{strContent}))
{
if (!defined($oElement->{bPre}) || !$oElement->{bPre})
{
$oElement->{strContent} = trim($oElement->{strContent});
# Add a linefeed before the content if not pre. This makes the output more diffable.
$strHtml .= "\n";
}
else
{
$oElement->{strContent} =~ s/\&/\&\;/g;
}
$strHtml .= $oElement->{strContent};
# Add a linefeed after the content if not pre. This makes the output more diffable.
if (!defined($oElement->{bPre}) || !$oElement->{bPre})
{
$strHtml .= "\n" . $self->indent($iDepth);
}
}
else
{
if (!($oElement->{strType} eq HTML_A && @{$oElement->{oyElement}} == 0))
{
$strHtml .= $self->lf();
}
foreach my $oChildElement (@{$oElement->{oyElement}})
{
$strHtml .= $self->htmlRender($oChildElement, $iDepth + 1);
}
if (!($oElement->{strType} eq HTML_A && @{$oElement->{oyElement}} == 0))
{
$strHtml .= $self->indent($iDepth);
}
}
$strHtml .= "{strType}>";
# If a pre tag add an lf after the tag. This makes the output more diffable.
$strHtml .= $oElement->{strType} eq HTML_PRE ? "\n" : $self->lf();
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strHtml', value => $strHtml, trace => true}
);
}
####################################################################################################################################
# escape
#
# Generate the HTML.
####################################################################################################################################
sub escape
{
my $self = shift;
my $strBuffer = shift;
$strBuffer =~ s/\&/\&\;/g;
$strBuffer =~ s/\htmlGet', \@_,
{name => 'bAnalytics', optional => true, default => false, trace => true},
);
# Build the header
my $strHtml =
$self->indent(0) . "" . $self->lf() .
$self->indent(0) . "" . $self->lf() .
$self->indent(0) . "" . $self->lf() .
$self->indent(1) . "\n" .
$self->indent(2) . $self->escape($self->{strTitle}) . "\n" .
$self->indent(1) . ' ' . $self->lf() .
$self->indent(1) . "\n";
if (!$self->{bCompact})
{
$strHtml .=
# $self->indent(1) . "\n" .
$self->indent(1) . '\n" .
$self->indent(1) . '\n" .
$self->indent(1) . "\n";
if (defined($self->{strFavicon}))
{
$strHtml .= $self->indent(1) . "{strFavicon}\" type=\"image/png\">\n";
}
if (defined($self->{strLogo}))
{
$strHtml .=
$self->indent(1) . "\n" .
$self->indent(1) . "{strLogo}\">\n";
}
if (defined($self->{strDescription}))
{
$strHtml .=
$self->indent(1) . '\n" .
$self->indent(1) .
'\n";
}
}
if (defined($self->{strCss}))
{
my $strCss = $self->{strCss};
if (!$self->{bPretty})
{
$strCss =~ s/^\s+//mg;
$strCss =~ s/\n//g;
$strCss =~ s/\/\*.*?\*\///g;
}
$strHtml .= $self->indent(1) . "\n";
}
else
{
$strHtml .=
$self->indent(1) . "\n";
}
if ($bAnalytics)
{
$strHtml .=
$self->indent(1) . "\n" .
$self->indent(1) . "\n";
}
$strHtml .=
$self->indent(0) . "" . $self->lf() .
$self->htmlRender($self->bodyGet(), 0);
# Complete the html
$strHtml .=
$self->indent(0) . "" . $self->lf();
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strHtml', value => $strHtml, trace => true}
);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Html/DocHtmlElement.pm 0000664 0000000 0000000 00000012537 15006170376 0025460 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC HTML ELEMENT MODULE
####################################################################################################################################
package pgBackRestDoc::Html::DocHtmlElement;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Exporter qw(import);
our @EXPORT = qw();
use Scalar::Util qw(blessed);
use pgBackRestDoc::Common::Log;
####################################################################################################################################
# Html Element Types
####################################################################################################################################
use constant HTML_A => 'a';
push @EXPORT, qw(HTML_A);
use constant HTML_BODY => 'body';
push @EXPORT, qw(HTML_BODY);
use constant HTML_PRE => 'pre';
push @EXPORT, qw(HTML_PRE);
use constant HTML_DIV => 'div';
push @EXPORT, qw(HTML_DIV);
use constant HTML_SPAN => 'span';
push @EXPORT, qw(HTML_SPAN);
use constant HTML_TABLE => 'table';
push @EXPORT, qw(HTML_TABLE);
use constant HTML_TABLE_CAPTION => 'caption';
push @EXPORT, qw(HTML_TABLE_CAPTION);
use constant HTML_TD => 'td';
push @EXPORT, qw(HTML_TD);
use constant HTML_TH => 'th';
push @EXPORT, qw(HTML_TH);
use constant HTML_TR => 'tr';
push @EXPORT, qw(HTML_TR);
use constant HTML_UL => 'ul';
push @EXPORT, qw(HTML_UL);
use constant HTML_LI => 'li';
push @EXPORT, qw(HTML_LI);
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{strType},
$self->{strClass},
my $oParam
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'strType', trace => true},
{name => 'strClass', required => false, trace => true},
{name => 'oParam', required => false, trace => true}
);
$self->{oyElement} = [];
$self->{strContent} = $$oParam{strContent};
$self->{strId} = $$oParam{strId};
$self->{strRef} = $$oParam{strRef};
$self->{strExtra} = $$oParam{strExtra};
$self->{bPre} = $$oParam{bPre};
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# addNew
#
# Create a new element and add it.
####################################################################################################################################
sub addNew
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my (
$strOperation,
$strType,
$strClass,
$oParam
) =
logDebugParam
(
__PACKAGE__ . '->addNew', \@_,
{name => 'strType', trace => true},
{name => 'strClass', required => false, trace => true},
{name => 'oParam', required => false, trace => true}
);
my $oElement = new pgBackRestDoc::Html::DocHtmlElement($strType, $strClass, $oParam);
$self->add($oElement);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oElement', value => $oElement, trace => true}
);
}
####################################################################################################################################
# add
#
# Add an element.
####################################################################################################################################
sub add
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my (
$strOperation,
$oElement
) =
logDebugParam
(
__PACKAGE__ . '->add', \@_,
{name => 'oElement', trace => true}
);
if (!(blessed($oElement) && $oElement->isa('pgBackRestDoc::Html::DocHtmlElement')))
{
confess &log(ASSERT, 'oElement must be a valid element object');
}
push(@{$self->{oyElement}}, $oElement);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oElement', value => $oElement, trace => true}
);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Html/DocHtmlPage.pm 0000664 0000000 0000000 00000063102 15006170376 0024735 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC HTML PAGE MODULE
####################################################################################################################################
package pgBackRestDoc::Html::DocHtmlPage;
use parent 'pgBackRestDoc::Common::DocExecute';
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Data::Dumper;
use Exporter qw(import);
our @EXPORT = qw();
use pgBackRestDoc::Common::DocConfig;
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::DocRender;
use pgBackRestDoc::Html::DocHtmlBuilder;
use pgBackRestDoc::Html::DocHtmlElement;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oManifest,
$strRenderOutKey,
$bMenu,
$bExe,
$bCompact,
$strCss,
$bPretty,
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strRenderOutKey'},
{name => 'bMenu'},
{name => 'bExe'},
{name => 'bCompact'},
{name => 'strCss'},
{name => 'bPretty'},
);
# Create the class hash
my $self = $class->SUPER::new(RENDER_TYPE_HTML, $oManifest, $strRenderOutKey, $bExe);
bless $self, $class;
$self->{bMenu} = $bMenu;
$self->{bCompact} = $bCompact;
$self->{strCss} = $strCss;
$self->{bPretty} = $bPretty;
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
# Working variables
my $oPage = $self->{oDoc};
my $oRender = $self->{oManifest}->renderGet(RENDER_TYPE_HTML);
# Initialize page
my $strTitle = $oPage->paramGet('title');
my $strSubTitle = $oPage->paramGet('subtitle', false);
my $oHtmlBuilder = new pgBackRestDoc::Html::DocHtmlBuilder(
$self->{oManifest}->variableReplace('{[project]}' . (defined($self->{oManifest}->variableGet('project-tagline')) ?
' - ' . $self->{oManifest}->variableGet('project-tagline') : '')),
$self->{oManifest}->variableReplace($strTitle . (defined($strSubTitle) ? " - ${strSubTitle}" : '')),
$self->{oManifest}->variableGet('project-favicon'),
$self->{oManifest}->variableGet('project-logo'),
$self->{oManifest}->variableReplace(trim($self->{oDoc}->fieldGet('description'))),
$self->{bPretty},
$self->{bCompact},
$self->{bCompact} ? $self->{strCss} : undef);
# Generate header
my $oPageHeader = $oHtmlBuilder->bodyGet()->addNew(HTML_DIV, 'page-header');
# add the logo to the header
if (defined($self->{oManifest}->variableGet('html-logo')))
{
$oPageHeader->
addNew(HTML_DIV, 'page-header-logo',
{strContent =>"{[html-logo]}"});
}
$oPageHeader->
addNew(HTML_DIV, 'page-header-title',
{strContent => $strTitle});
if (defined($strSubTitle))
{
$oPageHeader->
addNew(HTML_DIV, 'page-header-subtitle',
{strContent => $strSubTitle});
}
# Generate menu
if ($self->{bMenu})
{
my $oMenuBody = $oHtmlBuilder->bodyGet()->addNew(HTML_DIV, 'page-menu')->addNew(HTML_DIV, 'menu-body');
# Get the menu in the order listed in the manifest.xml
foreach my $strRenderOutKey (@{${$oRender}{stryOrder}})
{
# Do not output the menu item for the page the user is on (e.g. on Command page, the Command menu item will not appear)
if ($strRenderOutKey ne $self->{strRenderOutKey})
{
my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_HTML, $strRenderOutKey);
if (defined($$oRenderOut{menu}))
{
$oMenuBody->addNew(HTML_DIV, 'menu')->addNew(
HTML_A, 'menu-link',
{strContent => $$oRenderOut{menu},
strRef => $strRenderOutKey eq 'index' ? '{[project-url-root]}' : "${strRenderOutKey}.html"});
}
}
}
}
# Generate table of contents
my $oPageTocBody;
if ($self->{bToc})
{
my $oPageToc = $oHtmlBuilder->bodyGet()->addNew(HTML_DIV, 'page-toc');
$oPageToc->addNew(HTML_DIV, 'page-toc-header')->addNew(HTML_DIV, 'page-toc-title', {strContent => "Table of Contents"});
$oPageTocBody = $oPageToc->
addNew(HTML_DIV, 'page-toc-body');
}
# Generate body
my $oPageBody = $oHtmlBuilder->bodyGet()->addNew(HTML_DIV, 'page-body');
my $iSectionNo = 1;
# Render sections
foreach my $oSection ($oPage->nodeList('section'))
{
my ($oChildSectionElement, $oChildSectionTocElement) =
$self->sectionProcess($oSection, undef, "${iSectionNo}", 1);
$oPageBody->add($oChildSectionElement);
if (defined($oPageTocBody) && defined($oChildSectionTocElement))
{
$oPageTocBody->add($oChildSectionTocElement);
}
$iSectionNo++;
}
my $oPageFooter = $oHtmlBuilder->bodyGet()->
addNew(HTML_DIV, 'page-footer',
{strContent => '{[html-footer]}'});
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strHtml',
value => $oHtmlBuilder->htmlGet(
{bAnalytics => defined($self->{oManifest}->variableGet('analytics')) &&
$self->{oManifest}->variableGet('analytics') eq 'y'}),
trace => true}
);
}
####################################################################################################################################
# sectionProcess
####################################################################################################################################
sub sectionProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$strAnchor,
$strSectionNo,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->sectionProcess', \@_,
{name => 'oSection'},
{name => 'strAnchor', required => false},
{name => 'strSectionNo'},
{name => 'iDepth'}
);
if ($oSection->paramGet('log'))
{
&log(INFO, (' ' x ($iDepth + 1)) . 'process section: ' . $oSection->paramGet('path'));
}
if ($iDepth > 3)
{
confess &log(ASSERT, "section depth of ${iDepth} exceeds maximum");
}
# Working variables
$strAnchor =
($oSection->paramTest(XML_SECTION_PARAM_ANCHOR, XML_SECTION_PARAM_ANCHOR_VALUE_NOINHERIT) ? '' :
(defined($strAnchor) ? "${strAnchor}/" : '')) .
$oSection->paramGet('id');
# Create the section toc element
my $oSectionTocElement = new pgBackRestDoc::Html::DocHtmlElement(HTML_DIV, "section${iDepth}-toc");
# Create the section element
my $oSectionElement = new pgBackRestDoc::Html::DocHtmlElement(HTML_DIV, "section${iDepth}");
# Add the section anchor
$oSectionElement->addNew(HTML_A, undef, {strId => $strAnchor});
# Add the section title to section and toc
my $oSectionHeaderElement = $oSectionElement->addNew(HTML_DIV, "section${iDepth}-header");
my $strSectionTitle = $self->processText($oSection->nodeGet('title')->textGet());
if ($self->{bTocNumber})
{
$oSectionHeaderElement->addNew(HTML_DIV, "section${iDepth}-number");
}
$oSectionHeaderElement->addNew(HTML_DIV, "section${iDepth}-title", {strContent => $strSectionTitle});
if ($self->{bTocNumber})
{
$oSectionTocElement->addNew(HTML_DIV, "section${iDepth}-toc-number");
}
my $oTocSectionTitleElement = $oSectionTocElement->addNew(HTML_DIV, "section${iDepth}-toc-title");
$oTocSectionTitleElement->addNew(
HTML_A, undef,
{strContent => $strSectionTitle, strRef => "#${strAnchor}"});
# Add the section intro if it exists
if (defined($oSection->textGet(false)))
{
$oSectionElement->
addNew(HTML_DIV, "section-intro",
{strContent => $self->processText($oSection->textGet())});
}
# Add the section body
my $oSectionBodyElement = $oSectionElement->addNew(HTML_DIV, "section-body");
# Process each child
my $iSectionNo = 1;
foreach my $oChild ($oSection->nodeList())
{
&log(DEBUG, (' ' x ($iDepth + 2)) . 'process child ' . $oChild->nameGet());
# Execute a command
if ($oChild->nameGet() eq 'execute-list')
{
my $bShow = $oChild->paramTest('show', 'n') ? false : true;
my $oExecuteBodyElement;
my $bFirst = true;
my $strHostName = $self->{oManifest}->variableReplace($oChild->paramGet('host'));
if ($bShow)
{
my $oSectionBodyExecute = $oSectionBodyElement->addNew(HTML_DIV, "execute");
$oSectionBodyExecute->
addNew(HTML_DIV, "execute-title",
{strContent => "${strHostName} ⇒ " .
$self->processText($oChild->nodeGet('title')->textGet())});
$oExecuteBodyElement = $oSectionBodyExecute->addNew(HTML_DIV, "execute-body");
}
foreach my $oExecute ($oChild->nodeList('execute'))
{
my $bExeShow = !$oExecute->paramTest('show', 'n');
my $bExeExpectedError = defined($oExecute->paramGet('err-expect', false));
my ($strCommand, $strOutput) = $self->execute(
$oSection, $strHostName, $oExecute, {iIndent => $iDepth + 3, bShow => $bShow && $bExeShow});
if ($bShow && $bExeShow)
{
# Add continuation chars and proper spacing
$strCommand =~ s/\n/\n /smg;
$oExecuteBodyElement->
addNew(HTML_PRE, "execute-body-cmd",
{strContent => $strCommand, bPre => true});
my $strHighLight = $self->{oManifest}->variableReplace($oExecute->fieldGet('exe-highlight', false));
my $bHighLightFound = false;
if (defined($strOutput))
{
my $bHighLightOld;
my $strHighLightOutput;
if ($oExecute->fieldTest('exe-highlight-type', 'error'))
{
$bExeExpectedError = true;
}
foreach my $strLine (split("\n", $strOutput))
{
my $bHighLight = defined($strHighLight) && $strLine =~ /$strHighLight/;
if (defined($bHighLightOld) && $bHighLight != $bHighLightOld)
{
$oExecuteBodyElement->
addNew(HTML_PRE, 'execute-body-output' .
($bHighLightOld ? '-highlight' . ($bExeExpectedError ? '-error' : '') : ''),
{strContent => $strHighLightOutput, bPre => true});
undef($strHighLightOutput);
}
$strHighLightOutput .= (defined($strHighLightOutput) ? "\n" : '') . $strLine;
$bHighLightOld = $bHighLight;
$bHighLightFound = $bHighLightFound ? true : $bHighLight ? true : false;
}
if (defined($bHighLightOld))
{
$oExecuteBodyElement->
addNew(HTML_PRE, 'execute-body-output' .
($bHighLightOld ? '-highlight' . ($bExeExpectedError ? '-error' : '') : ''),
{strContent => $strHighLightOutput, bPre => true});
}
$bFirst = true;
}
if ($self->{bExe} && $self->isRequired($oSection) && defined($strHighLight) && !$bHighLightFound)
{
confess &log(ERROR, "unable to find a match for highlight: ${strHighLight}");
}
}
$bFirst = false;
}
}
# Add code block
elsif ($oChild->nameGet() eq 'code-block')
{
my $strValue = $oChild->valueGet();
# Trim linefeeds from the beginning and all whitespace from the end
$strValue =~ s/^\n+|\s+$//g;
# Find the line with the fewest leading spaces
my $iSpaceMin = undef;
foreach my $strLine (split("\n", $strValue))
{
$strLine =~ s/\s+$//;
my $iSpaceMinTemp = length($strLine) - length(trim($strLine));
if (!defined($iSpaceMin) || $iSpaceMinTemp < $iSpaceMin)
{
$iSpaceMin = $iSpaceMinTemp;
}
}
# Replace the leading spaces
$strValue =~ s/^( ){$iSpaceMin}//smg;
$oSectionBodyElement->addNew(
HTML_PRE, 'code-block', {strContent => $strValue, bPre => true});
}
# Add table
elsif ($oChild->nameGet() eq 'table')
{
my $oTableTitle;
if ($oChild->nodeTest('title'))
{
$oTableTitle = $oChild->nodeGet('title');
}
my $oTableElement = $oSectionBodyElement->addNew(HTML_TABLE, 'table');
my @oyColumn;
# If there is a title element then add it as the caption for the table
if (defined($oTableTitle))
{
# Print the label (e.g. Table 1:) in front of the title if one exists
my $strTableTitle = $oTableTitle->paramTest('label') ?
($oTableTitle->paramGet('label') . ': '. $self->processText($oTableTitle->textGet())) :
$self->processText($oTableTitle->textGet());
$oTableElement->addNew(HTML_TABLE_CAPTION, 'table-caption', {strContent => $strTableTitle});
}
# Build the header
if ($oChild->nodeTest('table-header'))
{
my $oHeader = $oChild->nodeGet('table-header');
@oyColumn = $oHeader->nodeList('table-column');
my $oHeaderRowElement = $oTableElement->addNew(HTML_TR, 'table-header-row');
foreach my $oColumn (@oyColumn)
{
# Each column can have different alignment properties - if not set, then default to align left
my $strAlign = $oColumn->paramGet("align", false, 'left');
my $bFill = $oColumn->paramTest('fill', 'y');
$oHeaderRowElement->addNew(
HTML_TH,
"table-header-${strAlign}" . ($bFill ? " table-header-fill" : ""),
{strContent => $self->processText($oColumn->textGet())});
}
}
# Build the rows
foreach my $oRow ($oChild->nodeGet('table-data')->nodeList('table-row'))
{
my $oRowElement = $oTableElement->addNew(HTML_TR, 'table-row');
my @oRowCellList = $oRow->nodeList('table-cell');
for (my $iRowCellIdx = 0; $iRowCellIdx < @oRowCellList; $iRowCellIdx++)
{
my $oRowCell = $oRowCellList[$iRowCellIdx];
# If a header row was defined, then get the column alignment, else default to left
my $strAlign = @oyColumn > 0 ? $oyColumn[$iRowCellIdx]->paramGet("align", false, 'left') : 'left';
$oRowElement->addNew(
HTML_TD, "table-data-${strAlign}", {strContent => $self->processText($oRowCell->textGet())});
}
}
}
# Add descriptive text
elsif ($oChild->nameGet() eq 'p')
{
$oSectionBodyElement->
addNew(HTML_DIV, 'section-body-text',
{strContent => $self->processText($oChild->textGet())});
}
# Add option descriptive text
elsif ($oChild->nameGet() eq 'option-description')
{
my $strOption = $oChild->paramGet("key");
my $oDescription = ${$self->{oReference}->{oConfigHash}}{&CONFIG_HELP_OPTION}{$strOption}{&CONFIG_HELP_DESCRIPTION};
if (!defined($oDescription))
{
confess &log(ERROR, "unable to find ${strOption} option in sections - try adding option?");
}
$oSectionBodyElement->
addNew(HTML_DIV, 'section-body-text',
{strContent => $self->processText($oDescription)});
}
# Add cmd descriptive text
elsif ($oChild->nameGet() eq 'cmd-description')
{
my $strCommand = $oChild->paramGet("key");
my $oDescription = ${$self->{oReference}->{oConfigHash}}{&CONFIG_HELP_COMMAND}{$strCommand}{&CONFIG_HELP_DESCRIPTION};
if (!defined($oDescription))
{
confess &log(ERROR, "unable to find ${strCommand} command in sections - try adding command?");
}
$oSectionBodyElement->
addNew(HTML_DIV, 'section-body-text',
{strContent => $self->processText($oDescription)});
}
# Add/remove backrest config options
elsif ($oChild->nameGet() eq 'backrest-config')
{
my $oConfigElement = $self->backrestConfigProcess($oSection, $oChild, $iDepth + 3);
if (defined($oConfigElement))
{
$oSectionBodyElement->add($oConfigElement);
}
}
# Add/remove postgres config options
elsif ($oChild->nameGet() eq 'postgres-config')
{
my $oConfigElement = $self->postgresConfigProcess($oSection, $oChild, $iDepth + 3);
if (defined($oConfigElement))
{
$oSectionBodyElement->add($oConfigElement);
}
}
# Add a list
elsif ($oChild->nameGet() eq 'list')
{
my $oList = $oSectionBodyElement->addNew(HTML_UL, 'list-unordered');
foreach my $oListItem ($oChild->nodeList())
{
$oList->addNew(HTML_LI, 'list-unordered', {strContent => $self->processText($oListItem->textGet())});
}
}
# Add a subtitle
elsif ($oChild->nameGet() eq 'subtitle')
{
$oSectionBodyElement->
addNew(HTML_DIV, "section${iDepth}-subtitle",
{strContent => $self->processText($oChild->textGet())});
}
# Add a subsubtitle
elsif ($oChild->nameGet() eq 'subsubtitle')
{
$oSectionBodyElement->
addNew(HTML_DIV, "section${iDepth}-subsubtitle",
{strContent => $self->processText($oChild->textGet())});
}
# Add a subsection
elsif ($oChild->nameGet() eq 'section')
{
my ($oChildSectionElement, $oChildSectionTocElement) =
$self->sectionProcess($oChild, $strAnchor, "${strSectionNo}.${iSectionNo}", $iDepth + 1);
$oSectionBodyElement->add($oChildSectionElement);
if (defined($oChildSectionTocElement))
{
$oSectionTocElement->add($oChildSectionTocElement);
}
$iSectionNo++;
}
# Add an admonition (e.g. NOTE, WARNING, etc)
elsif ($oChild->nameGet() eq 'admonition')
{
my $oAdmonition = $oSectionBodyElement->addNew(HTML_DIV, 'admonition');
$oAdmonition->addNew(HTML_DIV, $oChild->paramGet('type'), {strContent => uc($oChild->paramGet('type')) . ": "});
$oAdmonition->addNew(HTML_DIV, $oChild->paramGet('type') . '-text',
{strContent => $self->processText($oChild->textGet())});
}
# Check if the child can be processed by a parent
else
{
$self->sectionChildProcess($oSection, $oChild, $iDepth + 1);
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oSectionElement', value => $oSectionElement, trace => true},
{name => 'oSectionTocElement', value => $oSection->paramTest('toc', 'n') ? undef : $oSectionTocElement, trace => true}
);
}
####################################################################################################################################
# backrestConfigProcess
####################################################################################################################################
sub backrestConfigProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->backrestConfigProcess', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# Generate the config
my $oConfigElement;
my ($strFile, $strConfig, $bShow) = $self->backrestConfig($oSection, $oConfig, $iDepth);
if ($bShow)
{
my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
# Render the config
$oConfigElement = new pgBackRestDoc::Html::DocHtmlElement(HTML_DIV, "config");
$oConfigElement->
addNew(HTML_DIV, "config-title",
{strContent => "${strHostName}:${strFile}" .
" ⇒ " . $self->processText($oConfig->nodeGet('title')->textGet())});
my $oConfigBodyElement = $oConfigElement->addNew(HTML_DIV, "config-body");
#
# $oConfigBodyElement->
# addNew(HTML_DIV, "config-body-title",
# {strContent => "${strFile}:"});
# Convert linefeeds to br tags
$strConfig =~ s/\n/'});
$oConfig->fieldSet('actual-config', $strConfig);
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'oConfigElement', value => $oConfigElement, trace => true}
);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Html/DocHtmlSite.pm 0000664 0000000 0000000 00000012777 15006170376 0025001 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC HTML SITE MODULE
####################################################################################################################################
package pgBackRestDoc::Html::DocHtmlSite;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
use Data::Dumper;
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use File::Copy;
use POSIX qw(strftime);
use Storable qw(dclone);
use pgBackRestTest::Common::ExecuteTest;
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::Exception;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::Html::DocHtmlPage;
use pgBackRestDoc::ProjectInfo;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oManifest},
$self->{strXmlPath},
$self->{strHtmlPath},
$self->{strCssFile},
$self->{strFaviconFile},
$self->{strProjectLogoFile},
$self->{bExe}
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strXmlPath'},
{name => 'strHtmlPath'},
{name => 'strCssFile'},
{name => 'strFaviconFile', required => false},
{name => 'strProjectLogoFile', required => false},
{name => 'bExe'}
);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
# Get render options
my $oRender = $self->{oManifest}->renderGet(RENDER_TYPE_HTML);
my $bMenu = $$oRender{&RENDER_MENU};
my $bPretty = $$oRender{&RENDER_PRETTY};
my $bCompact = $$oRender{&RENDER_COMPACT};
if (!$bCompact)
{
# Copy the css file
my $strCssFileDestination = "$self->{strHtmlPath}/default.css";
copy($self->{strCssFile}, $strCssFileDestination)
or confess &log(ERROR, "unable to copy $self->{strCssFile} to ${strCssFileDestination}");
# Copy the favicon file
if (defined($self->{strFaviconFile}))
{
my $strFaviconFileDestination = "$self->{strHtmlPath}/" . $self->{oManifest}->variableGet('project-favicon');
copy($self->{strFaviconFile}, $strFaviconFileDestination)
or confess &log(ERROR, "unable to copy $self->{strFaviconFile} to ${strFaviconFileDestination}");
}
# Copy the project logo file
if (defined($self->{strProjectLogoFile}))
{
my $strProjectLogoFileDestination = "$self->{strHtmlPath}/" . $self->{oManifest}->variableGet('project-logo');
copy($self->{strProjectLogoFile}, $strProjectLogoFileDestination)
or confess &log(ERROR, "unable to copy $self->{strProjectLogoFile} to ${strProjectLogoFileDestination}");
}
}
foreach my $strPageId ($self->{oManifest}->renderOutList(RENDER_TYPE_HTML))
{
&log(INFO, " render out: ${strPageId}");
my $strHtml;
my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_HTML, $strPageId);
eval
{
$strHtml = $self->{oManifest}->variableReplace(
new pgBackRestDoc::Html::DocHtmlPage(
$self->{oManifest}, $strPageId, $bMenu, $self->{bExe}, $bCompact,
${$self->{oManifest}->storage()->get($self->{strCssFile})}, $bPretty)->process());
return true;
}
or do
{
my $oException = $@;
if (exceptionCode($oException) == ERROR_FILE_INVALID)
{
my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_HTML, $strPageId);
$self->{oManifest}->cacheReset($$oRenderOut{source});
$strHtml = $self->{oManifest}->variableReplace(
new pgBackRestDoc::Html::DocHtmlPage(
$self->{oManifest}, $strPageId, $bMenu, $self->{bExe}, $bCompact,
${$self->{oManifest}->storage()->get($self->{strCssFile})}, $bPretty)->process());
}
else
{
confess $oException;
}
};
# Save the html page
my $strFile = "$self->{strHtmlPath}/" . (defined($$oRenderOut{file}) ? $$oRenderOut{file} : "${strPageId}.html");
$self->{oManifest}->storage()->put($strFile, $strHtml);
}
# Return from function and log return values if any
logDebugReturn($strOperation);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Latex/ 0000775 0000000 0000000 00000000000 15006170376 0022417 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Latex/DocLatex.pm 0000664 0000000 0000000 00000013627 15006170376 0024471 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC LATEX MODULE
####################################################################################################################################
package pgBackRestDoc::Latex::DocLatex;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
use Cwd qw(abs_path);
use Data::Dumper;
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname basename);
use File::Copy;
use POSIX qw(strftime);
use Storable qw(dclone);
use pgBackRestTest::Common::ExecuteTest;
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::Exception;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::Latex::DocLatexSection;
use pgBackRestDoc::ProjectInfo;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oManifest},
$self->{strXmlPath},
$self->{strLatexPath},
$self->{strPreambleFile},
$self->{bExe}
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strXmlPath'},
{name => 'strLatexPath'},
{name => 'strPreambleFile'},
{name => 'bExe'}
);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
my $oRender = $self->{oManifest}->renderGet(RENDER_TYPE_PDF);
my $strLogo = $self->{oManifest}->variableGet('pdf-resource-logo');
if (!defined($strLogo))
{
$strLogo = 'blank.eps';
}
my ($strExt) = $strLogo =~ /(\.[^.]+)$/;
my $strLogoPath = defined($self->{oManifest}->variableGet('pdf-resource-path')) ?
$self->{oManifest}->variableGet('pdf-resource-path') :
"$self->{oManifest}{strDocPath}/resource/latex/";
# Copy the logo
copy($strLogoPath . $strLogo, "$self->{strLatexPath}/logo$strExt")
or confess &log(ERROR, "unable to copy logo");
my $strLatex = $self->{oManifest}->variableReplace(
${$self->{oManifest}->storage()->get($self->{strPreambleFile})}, 'latex') . "\n";
# ??? Temp hack for underscores in filename
$strLatex =~ s/pgaudit\\\_doc/pgaudit\_doc/g;
# Process the sources in the order listed in the manifest.xml
foreach my $strPageId (@{${$self->{oManifest}->renderGet(RENDER_TYPE_PDF)}{stryOrder}})
{
&log(INFO, " render out: ${strPageId}");
eval
{
my $oDocLatexSection =
new pgBackRestDoc::Latex::DocLatexSection($self->{oManifest}, $strPageId, $self->{bExe});
# Save the html page
$strLatex .= $oDocLatexSection->process();
return true;
}
or do
{
my $oException = $EVAL_ERROR;
if (exceptionCode($oException) == ERROR_FILE_INVALID)
{
my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_HTML, $strPageId);
$self->{oManifest}->cacheReset($$oRenderOut{source});
my $oDocLatexSection =
new pgBackRestDoc::Latex::DocLatexSection($self->{oManifest}, $strPageId, $self->{bExe});
# Save the html page
$strLatex .= $oDocLatexSection->process();
}
else
{
confess $oException;
}
};
}
$strLatex .= "\n% " . ('-' x 130) . "\n% End document\n% " . ('-' x 130) . "\n\\end{document}\n";
# Get base name of output file to use for processing
(my $strLatexFileBase = basename($$oRender{file})) =~ s/\.[^.]+$//;
$strLatexFileBase = $self->{oManifest}->variableReplace($strLatexFileBase);
# Name of latex file to use for output and processing
my $strLatexFileName = $self->{oManifest}->variableReplace("$self->{strLatexPath}/" . $strLatexFileBase . '.tex');
# Output latex and build PDF
$self->{oManifest}->storage()->put($strLatexFileName, $strLatex);
executeTest("pdflatex -output-directory=$self->{strLatexPath} -shell-escape $strLatexFileName",
{bSuppressStdErr => true});
executeTest("pdflatex -output-directory=$self->{strLatexPath} -shell-escape $strLatexFileName",
{bSuppressStdErr => true});
# Determine path of output file
my $strLatexOutputName = $oRender->{file};
if ($strLatexOutputName !~ /^\//)
{
$strLatexOutputName = abs_path($self->{strLatexPath} . "/" . $oRender->{file});
}
# Copy pdf file if it is not already in the correct place
if ($strLatexOutputName ne "$self->{strLatexPath}/" . $strLatexFileBase . '.pdf')
{
copy("$self->{strLatexPath}/" . $strLatexFileBase . '.pdf', $strLatexOutputName)
or confess &log(ERROR, "unable to copy pdf to " . $strLatexOutputName);
}
# Return from function and log return values if any
logDebugReturn($strOperation);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Latex/DocLatexSection.pm 0000664 0000000 0000000 00000037570 15006170376 0026021 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC LATEX SECTION MODULE
####################################################################################################################################
package pgBackRestDoc::Latex::DocLatexSection;
use parent 'pgBackRestDoc::Common::DocExecute';
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Exporter qw(import);
our @EXPORT = qw();
use pgBackRestDoc::Common::DocConfig;
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oManifest,
$strRenderOutKey,
$bExe
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strRenderOutKey'},
{name => 'bExe'}
);
# Create the class hash
my $self = $class->SUPER::new('latex', $oManifest, $strRenderOutKey, $bExe);
bless $self, $class;
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
# Working variables
my $oPage = $self->{oDoc};
my $strLatex;
# Initialize page
my $strTitle = $oPage->paramGet('title');
my $strSubTitle = $oPage->paramGet('subtitle', false);
# Render sections
foreach my $oSection ($oPage->nodeList('section'))
{
$strLatex .= (defined($strLatex) ? "\n" : '') . $self->sectionProcess($oSection, undef, 1);
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strHtml', value => $strLatex, trace => true}
);
}
####################################################################################################################################
# sectionProcess
####################################################################################################################################
sub sectionProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$strSection,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->sectionRender', \@_,
{name => 'oSection'},
{name => 'strSection', required => false},
{name => 'iDepth'}
);
if ($oSection->paramGet('log'))
{
&log(INFO, (' ' x ($iDepth + 1)) . 'process section: ' . $oSection->paramGet('path'));
}
# Create section type
my $strSectionTitle = $self->processText($oSection->nodeGet('title')->textGet());
$strSection .= (defined($strSection) ? ', ' : '') . "'${strSectionTitle}' " . ('Sub' x ($iDepth - 1)) . "Section";
# Create section comment
my $strLatex =
"% ${strSection}\n% " . ('-' x 130) . "\n";
# Exclude from table of contents if requested
if ($iDepth <= 3 && $oSection->paramTest('toc', 'n'))
{
$strLatex .= '\\addtocontents{toc}{\\protect\\setcounter{tocdepth}{' . ($iDepth - 1) . "}}\n";
}
# Create section name
$strLatex .= '\\';
if ($iDepth <= 3)
{
$strLatex .= ($iDepth > 1 ? ('sub' x ($iDepth - 1)) : '') . "section";
}
elsif ($iDepth == 4)
{
$strLatex .= 'paragraph';
}
else
{
confess &log(ASSERT, "section depth of ${iDepth} exceeds maximum");
}
$strLatex .= "\{${strSectionTitle}\}\\label{" . $oSection->paramGet('path', false) . "}\n";
# Reset table of contents numbering if the section was excluded
if ($iDepth <= 3 && $oSection->paramTest('toc', 'n'))
{
$strLatex .= '\\addtocontents{toc}{\\protect\\setcounter{tocdepth}{' . $iDepth . "}}\n";
}
foreach my $oChild ($oSection->nodeList())
{
&log(DEBUG, (' ' x ($iDepth + 2)) . 'process child ' . $oChild->nameGet());
# Execute a command
if ($oChild->nameGet() eq 'execute-list')
{
my $bShow = $oChild->paramTest('show', 'n') ? false : true;
my $strHostName = $self->{oManifest}->variableReplace($oChild->paramGet('host'));
if ($bShow)
{
$strLatex .=
"\n\\begin\{lstlisting\}[title=\{\\textnormal{\\textbf\{${strHostName}}} --- " .
$self->processText($oChild->nodeGet('title')->textGet()) . "}]\n";
}
foreach my $oExecute ($oChild->nodeList('execute'))
{
my $bExeShow = !$oExecute->paramTest('show', 'n');
my ($strCommand, $strOutput) = $self->execute(
$oSection, $self->{oManifest}->variableReplace($oChild->paramGet('host')), $oExecute,
{iIndent => $iDepth + 3, bShow => $bShow && $bExeShow});
if ($bShow && $bExeShow)
{
$strLatex .= "${strCommand}\n";
if (defined($strOutput))
{
$strLatex .= "\nOutput:\n\n${strOutput}\n";
}
}
}
if ($bShow)
{
$strLatex .=
"\\end{lstlisting}\n";
}
}
# Add code block
elsif ($oChild->nameGet() eq 'code-block')
{
my $strTitle = $self->{oManifest}->variableReplace($oChild->paramGet("title", false), 'latex');
if (defined($strTitle) && $strTitle eq '')
{
undef($strTitle)
}
# Begin the code listing
if (!defined($strTitle))
{
$strLatex .=
"\\vspace{.75em}\n";
}
$strLatex .=
"\\begin\{lstlisting\}";
# Add the title if one is provided
if (defined($strTitle))
{
$strLatex .= "[title=\{${strTitle}:\}]";
}
# End the code listing
$strLatex .=
"\n" .
trim($oChild->valueGet()) . "\n" .
"\\end{lstlisting}\n";
}
# Add table
elsif ($oChild->nameGet() eq 'table')
{
my $oHeader;
my @oyColumn;
if ($oChild->nodeTest('table-header'))
{
$oHeader = $oChild->nodeGet('table-header');
@oyColumn = $oHeader->nodeList('table-column');
}
my $strWidth =
'{' . (defined($oHeader) && $oHeader->paramTest('width') ? ($oHeader->paramGet('width') / 100) .
'\textwidth' : '\textwidth') . '}';
# Build the table
$strLatex .= "\\vspace{1em}\\newline\n\\begin{table}\n\\begin{tabularx}${strWidth}{|";
# Build the table header
foreach my $oColumn (@oyColumn)
{
my $strAlignCode;
my $strAlign = $oColumn->paramGet("align", false);
# If fill is specified then use X or the custom designed alignments in the preamble to fill and justify the columns.
if ($oColumn->paramTest('fill') && $oColumn->paramGet('fill', false) eq 'y')
{
if (!defined($strAlign) || $strAlign eq 'left')
{
$strAlignCode = 'X';
}
elsif ($strAlign eq 'right')
{
$strAlignCode = 'R';
}
elsif ($strAlign eq 'center')
{
$strAlignCode = 'C';
}
else
{
confess &log(ERROR, "align '${strAlign}' not valid when fill=y");
}
}
else
{
if (!defined($strAlign) || $strAlign eq 'left')
{
$strAlignCode = 'l';
}
elsif ($strAlign eq 'center')
{
$strAlignCode = 'c';
}
elsif ($strAlign eq 'right')
{
$strAlignCode = 'r';
}
else
{
confess &log(ERROR, "align '${strAlign}' not valid");
}
}
# $strLatex .= 'p{' . $oColumn->paramGet("width") . '} | ';
$strLatex .= $strAlignCode . ' | ';
}
# If table-header not provided then default the column alignment and fill by using the number of columns in the 1st row
if (!defined($oHeader))
{
my @oyRow = $oChild->nodeGet('table-data')->nodeList('table-row');
foreach my $oRowCell ($oyRow[0]->nodeList('table-cell'))
{
$strLatex .= 'X|';
}
}
$strLatex .= "}\n";
my $strLine;
if (defined($oHeader))
{
$strLatex .= "\\hline";
$strLatex .= "\\rowcolor{ltgray}\n";
foreach my $oColumn (@oyColumn)
{
$strLine .= (defined($strLine) ? ' & ' : '') . '\textbf{' . $self->processText($oColumn->textGet()) . '}';
}
$strLatex .= "${strLine}\\\\";
}
# Build the rows
foreach my $oRow ($oChild->nodeGet('table-data')->nodeList('table-row'))
{
$strLatex .= "\\hline\n";
undef($strLine);
foreach my $oRowCell ($oRow->nodeList('table-cell'))
{
$strLine .= (defined($strLine) ? ' & ' : '') . $self->processText($oRowCell->textGet());
}
$strLatex .= "${strLine}\\\\";
}
$strLatex .= "\\hline\n\\end{tabularx}\n";
# If there is a title for the table, add it. Ignore the label since LaTex will automatically generate numbered labels.
# e.g. Table 1:
if ($oChild->nodeGet("title", false))
{
$strLatex .= "\\caption{" . $self->processText($oChild->nodeGet("title")->textGet()) . "}\n";
}
$strLatex .= "\\end{table}\n";
}
# Add descriptive text
elsif ($oChild->nameGet() eq 'p')
{
$strLatex .= "\n\\begin{sloppypar}" . $self->processText($oChild->textGet()) . "\\end{sloppypar}\n";
}
# Add option descriptive text
elsif ($oChild->nameGet() eq 'option-description')
{
my $strOption = $oChild->paramGet("key");
my $oDescription = ${$self->{oReference}->{oConfigHash}}{&CONFIG_HELP_OPTION}{$strOption}{&CONFIG_HELP_DESCRIPTION};
if (!defined($oDescription))
{
confess &log(ERROR, "unable to find ${strOption} option in sections - try adding option?");
}
$strLatex .= "\n\\begin{sloppypar}" . $self->processText($oDescription) . "\\end{sloppypar}\n";
}
# Add cmd descriptive text
elsif ($oChild->nameGet() eq 'cmd-description')
{
my $strCommand = $oChild->paramGet("key");
my $oDescription = ${$self->{oReference}->{oConfigHash}}{&CONFIG_HELP_COMMAND}{$strCommand}{&CONFIG_HELP_DESCRIPTION};
if (!defined($oDescription))
{
confess &log(ERROR, "unable to find ${strCommand} command in sections - try adding command?");
}
$strLatex .= "\n\\begin{sloppypar}" . $self->processText($oDescription) . "\\end{sloppypar}\n";
}
# Add a list
elsif ($oChild->nameGet() eq 'list')
{
$strLatex .= "\n\\begin{itemize}";
foreach my $oListItem ($oChild->nodeList())
{
$strLatex .= "\n \\item " . $self->processText($oListItem->textGet());
}
$strLatex .= "\n\\end{itemize}";
}
# Add/remove config options
elsif ($oChild->nameGet() eq 'backrest-config' || $oChild->nameGet() eq 'postgres-config')
{
$strLatex .= $self->configProcess($oSection, $oChild, $iDepth + 3);
}
# Add a subsection
elsif ($oChild->nameGet() eq 'section')
{
$strLatex .= "\n" . $self->sectionProcess($oChild, $strSection, $iDepth + 1);
}
# Add an admonition (e.g. NOTE, WARNING, etc)
elsif ($oChild->nameGet() eq 'admonition')
{
$strLatex .= "\n\\vspace{.5em}\\begin{leftbar}";
$strLatex .= "\n\\begin{sloppypar}\\textit{\\textbf{" . uc($oChild->paramGet('type')) . ": }";
$strLatex .= $self->processText($oChild->textGet()) . "}\\end{sloppypar}";
$strLatex .= "\n\\end{leftbar}\n";
}
# Check if the child can be processed by a parent
else
{
$self->sectionChildProcess($oSection, $oChild, $iDepth + 1);
}
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strSection', value => $strLatex, trace => true}
);
}
####################################################################################################################################
# configProcess
####################################################################################################################################
sub configProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->configProcess', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# Working variables
my $strLatex = '';
my $strFile;
my $strConfig;
my $bShow = true;
# Generate the config
if ($oConfig->nameGet() eq 'backrest-config')
{
($strFile, $strConfig, $bShow) = $self->backrestConfig($oSection, $oConfig, $iDepth);
}
else
{
($strFile, $strConfig, $bShow) = $self->postgresConfig($oSection, $oConfig, $iDepth);
}
if ($bShow)
{
my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
# Replace _ in filename
$strFile = $self->variableReplace($strFile);
# Render the config
$strLatex =
"\n\\begin\{lstlisting\}[title=\{\\textnormal{\\textbf\{${strHostName}}}:\\textnormal{\\texttt\{${strFile}}} --- " .
$self->processText($oConfig->nodeGet('title')->textGet()) . "}]\n" .
(defined($strConfig) ? $strConfig : '') .
"\\end{lstlisting}\n";
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strConfig', value => $strLatex, trace => true}
);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Markdown/ 0000775 0000000 0000000 00000000000 15006170376 0023124 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Markdown/DocMarkdown.pm 0000664 0000000 0000000 00000005752 15006170376 0025703 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC MARKDOWN MODULE
####################################################################################################################################
package pgBackRestDoc::Markdown::DocMarkdown;
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Data::Dumper;
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use File::Copy;
use POSIX qw(strftime);
use Storable qw(dclone);
use pgBackRestTest::Common::ExecuteTest;
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::Markdown::DocMarkdownRender;
use pgBackRestDoc::ProjectInfo;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Create the class hash
my $self = {};
bless $self, $class;
$self->{strClass} = $class;
# Assign function parameters, defaults, and log debug info
(
my $strOperation,
$self->{oManifest},
$self->{strXmlPath},
$self->{strMarkdownPath},
$self->{bExe}
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strXmlPath'},
{name => 'strMarkdownPath'},
{name => 'bExe'}
);
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
foreach my $strRenderOutId ($self->{oManifest}->renderOutList(RENDER_TYPE_MARKDOWN))
{
my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_MARKDOWN, $strRenderOutId);
my $strFile = "$self->{strMarkdownPath}/" . (defined($$oRenderOut{file}) ? $$oRenderOut{file} : "${strRenderOutId}.md");
&log(INFO, " render out: ${strRenderOutId}");
# Save the html page
$self->{oManifest}->storage()->put(
$strFile, $self->{oManifest}->variableReplace((new pgBackRestDoc::Markdown::DocMarkdownRender($self->{oManifest},
$strRenderOutId, $self->{bExe}))->process()));
}
# Return from function and log return values if any
logDebugReturn($strOperation);
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/Markdown/DocMarkdownRender.pm 0000664 0000000 0000000 00000047255 15006170376 0027047 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# DOC MARKDOWN RENDER MODULE
####################################################################################################################################
package pgBackRestDoc::Markdown::DocMarkdownRender;
use parent 'pgBackRestDoc::Common::DocExecute';
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use Data::Dumper;
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
use File::Copy;
use Storable qw(dclone);
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
####################################################################################################################################
# CONSTRUCTOR
####################################################################################################################################
sub new
{
my $class = shift; # Class name
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oManifest,
$strRenderOutKey,
$bExe
) =
logDebugParam
(
__PACKAGE__ . '->new', \@_,
{name => 'oManifest'},
{name => 'strRenderOutKey'},
{name => 'bExe'}
);
# Create the class hash
my $self = $class->SUPER::new(RENDER_TYPE_MARKDOWN, $oManifest, $strRenderOutKey, $bExe);
bless $self, $class;
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'self', value => $self}
);
}
####################################################################################################################################
# process
#
# Generate the site html
####################################################################################################################################
sub process
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my $strOperation = logDebugParam(__PACKAGE__ . '->process');
# Working variables
my $oPage = $self->{oDoc};
# Initialize page
my $strMarkdown = "# " . $oPage->paramGet('title');
if (defined($oPage->paramGet('subtitle', false)))
{
$strMarkdown .= '
' . $oPage->paramGet('subtitle') . '';
}
# my $oHtmlBuilder = new pgBackRestDoc::Html::DocHtmlBuilder("{[project]} - Reliable PostgreSQL Backup",
# $strTitle . (defined($strSubTitle) ? " - ${strSubTitle}" : ''),
# $self->{bPretty});
#
# # Generate header
# my $oPageHeader = $oHtmlBuilder->bodyGet()->addNew(HTML_DIV, 'page-header');
#
# $oPageHeader->
# addNew(HTML_DIV, 'page-header-title',
# {strContent => $strTitle});
#
# if (defined($strSubTitle))
# {
# $oPageHeader->
# addNew(HTML_DIV, 'page-header-subtitle',
# {strContent => $strSubTitle});
# }
#
# # Generate menu
# my $oMenuBody = $oHtmlBuilder->bodyGet()->addNew(HTML_DIV, 'page-menu')->addNew(HTML_DIV, 'menu-body');
#
# if ($self->{strRenderOutKey} ne 'index')
# {
# my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_HTML, 'index');
#
# $oMenuBody->
# addNew(HTML_DIV, 'menu')->
# addNew(HTML_A, 'menu-link', {strContent => $$oRenderOut{menu}, strRef => '{[project-url-root]}'});
# }
#
# foreach my $strRenderOutKey ($self->{oManifest}->renderOutList(RENDER_TYPE_HTML))
# {
# if ($strRenderOutKey ne $self->{strRenderOutKey} && $strRenderOutKey ne 'index')
# {
# my $oRenderOut = $self->{oManifest}->renderOutGet(RENDER_TYPE_HTML, $strRenderOutKey);
#
# $oMenuBody->
# addNew(HTML_DIV, 'menu')->
# addNew(HTML_A, 'menu-link', {strContent => $$oRenderOut{menu}, strRef => "${strRenderOutKey}.html"});
# }
# }
#
# # Generate table of contents
# my $oPageTocBody;
#
# if (!defined($oPage->paramGet('toc', false)) || $oPage->paramGet('toc') eq 'y')
# {
# my $oPageToc = $oHtmlBuilder->bodyGet()->addNew(HTML_DIV, 'page-toc');
#
# $oPageToc->
# addNew(HTML_DIV, 'page-toc-title',
# {strContent => "Table of Contents"});
#
# $oPageTocBody = $oPageToc->
# addNew(HTML_DIV, 'page-toc-body');
# }
#
# # Generate body
# my $oPageBody = $oHtmlBuilder->bodyGet()->addNew(HTML_DIV, 'page-body');
# Render sections
foreach my $oSection ($oPage->nodeList('section'))
{
$strMarkdown = trim($strMarkdown) . "\n\n" . $self->sectionProcess($oSection, 1);
}
$strMarkdown .= "\n";
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strMarkdown', value => $strMarkdown, trace => true}
);
}
####################################################################################################################################
# sectionProcess
####################################################################################################################################
sub sectionProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->sectionProcess', \@_,
{name => 'oSection'},
{name => 'iDepth'}
);
if ($oSection->paramGet('log'))
{
&log(INFO, (' ' x ($iDepth + 1)) . 'process section: ' . $oSection->paramGet('path'));
}
if ($iDepth > 3)
{
confess &log(ASSERT, "section depth of ${iDepth} exceeds maximum");
}
my $strMarkdown = '#' . ('#' x $iDepth) . ' ' . $self->processText($oSection->nodeGet('title')->textGet());
my $strLastChild = undef;
foreach my $oChild ($oSection->nodeList())
{
&log(DEBUG, (' ' x ($iDepth + 2)) . 'process child ' . $oChild->nameGet());
# Execute a command
if ($oChild->nameGet() eq 'execute-list')
{
my $bShow = $oChild->paramTest('show', 'n') ? false : true;
my $bFirst = true;
my $strHostName = $self->{oManifest}->variableReplace($oChild->paramGet('host'));
my $bOutput = false;
if ($bShow)
{
$strMarkdown .=
"\n\n${strHostName} => " . $self->processText($oChild->nodeGet('title')->textGet()) .
"\n```\n";
}
foreach my $oExecute ($oChild->nodeList('execute'))
{
my $bExeShow = !$oExecute->paramTest('show', 'n');
my $bExeExpectedError = defined($oExecute->paramGet('err-expect', false));
if ($bOutput)
{
confess &log(ERROR, "only the last command can have output");
}
my ($strCommand, $strOutput) = $self->execute(
$oSection, $strHostName, $oExecute, {iIndent => $iDepth + 3, bShow => $bShow && $bExeShow});
if ($bShow && $bExeShow)
{
# Add continuation chars and proper spacing
$strCommand =~ s/\n/\n /smg;
$strMarkdown .= "${strCommand}\n";
my $strHighLight = $self->{oManifest}->variableReplace($oExecute->fieldGet('exe-highlight', false));
my $bHighLightFound = false;
if (defined($strOutput))
{
$strMarkdown .= "\n--- output ---\n\n";
if ($oExecute->fieldTest('exe-highlight-type', 'error'))
{
$bExeExpectedError = true;
}
foreach my $strLine (split("\n", $strOutput))
{
my $bHighLight = defined($strHighLight) && $strLine =~ /$strHighLight/;
if ($bHighLight)
{
$strMarkdown .= $bExeExpectedError ? "ERR" : "-->";
}
else
{
$strMarkdown .= " ";
}
$strMarkdown .= " ${strLine}\n";
$bHighLightFound = $bHighLightFound ? true : $bHighLight ? true : false;
}
$bFirst = true;
}
if ($self->{bExe} && $self->isRequired($oSection) && defined($strHighLight) && !$bHighLightFound)
{
confess &log(ERROR, "unable to find a match for highlight: ${strHighLight}");
}
}
$bFirst = false;
}
$strMarkdown .= "```";
}
# Add code block
elsif ($oChild->nameGet() eq 'code-block')
{
if ($oChild->paramTest('title'))
{
if (defined($strLastChild) && $strLastChild ne 'code-block')
{
$strMarkdown .= "\n";
}
$strMarkdown .= "\n_" . $oChild->paramGet('title') . "_:";
}
$strMarkdown .= "\n```";
if ($oChild->paramTest('type'))
{
$strMarkdown .= $oChild->paramGet('type');
}
$strMarkdown .= "\n" . trim($oChild->valueGet()) . "\n```";
}
# Add descriptive text
elsif ($oChild->nameGet() eq 'p')
{
if (defined($strLastChild) && $strLastChild ne 'code-block' && $strLastChild ne 'table')
{
$strMarkdown .= "\n";
}
$strMarkdown .= "\n" . $self->processText($oChild->textGet());
}
# Add option descriptive text
elsif ($oChild->nameGet() eq 'option-description')
{
# my $strOption = $oChild->paramGet("key");
# my $oDescription = ${$self->{oReference}->{oConfigHash}}{&CONFIG_HELP_OPTION}{$strOption}{&CONFIG_HELP_DESCRIPTION};
#
# if (!defined($oDescription))
# {
# confess &log(ERROR, "unable to find ${strOption} option in sections - try adding command?");
# }
#
# $oSectionBodyElement->
# addNew(HTML_DIV, 'section-body-text',
# {strContent => $self->processText($oDescription)});
}
# Add/remove backrest config options
elsif ($oChild->nameGet() eq 'backrest-config')
{
# my $oConfigElement = $self->backrestConfigProcess($oSection, $oChild, $iDepth + 3);
#
# if (defined($oConfigElement))
# {
# $oSectionBodyElement->add($oConfigElement);
# }
}
# Add/remove postgres config options
elsif ($oChild->nameGet() eq 'postgres-config')
{
# my $oConfigElement = $self->postgresConfigProcess($oSection, $oChild, $iDepth + 3);
#
# if (defined($oConfigElement))
# {
# $oSectionBodyElement->add($oConfigElement);
# }
}
# Add a list
elsif ($oChild->nameGet() eq 'list')
{
foreach my $oListItem ($oChild->nodeList())
{
$strMarkdown .= "\n\n- " . $self->processText($oListItem->textGet());
}
}
# Add a subsection
elsif ($oChild->nameGet() eq 'section')
{
$strMarkdown = trim($strMarkdown) . "\n\n" . $self->sectionProcess($oChild, $iDepth + 1);
}
elsif ($oChild->nameGet() eq 'table')
{
my $oTableTitle;
if ($oChild->nodeTest('title'))
{
$oTableTitle = $oChild->nodeGet('title');
}
my $oHeader;
my @oyColumn;
if ($oChild->nodeTest('table-header'))
{
$oHeader = $oChild->nodeGet('table-header');
@oyColumn = $oHeader->nodeList('table-column');
}
if (defined($oTableTitle))
{
# Print the label (e.g. Table 1:) in front of the title if one exists
$strMarkdown .= "\n\n**" . ($oTableTitle->paramTest('label') ?
($oTableTitle->paramGet('label') . ': ' . $self->processText($oTableTitle->textGet())) :
$self->processText($oTableTitle->textGet())) . "**\n\n";
}
else
{
$strMarkdown .= "\n\n";
}
my $strHeaderText = "| ";
my $strHeaderIndicator = "| ";
for (my $iColCellIdx = 0; $iColCellIdx < @oyColumn; $iColCellIdx++)
{
my $strAlign = $oyColumn[$iColCellIdx]->paramGet("align", false, 'left');
$strHeaderText .= $self->processText($oyColumn[$iColCellIdx]->textGet()) .
(($iColCellIdx < @oyColumn - 1) ? " | " : " |\n");
$strHeaderIndicator .= ($strAlign eq 'left' || $strAlign eq 'center') ? ":---" : "---";
$strHeaderIndicator .= ($strAlign eq 'right' || $strAlign eq 'center') ? "---:" : "";
$strHeaderIndicator .= ($iColCellIdx < @oyColumn - 1) ? " | " : " |\n";
}
# Markdown requires a table header so if not provided then create an empty header row and default the column alignment
# left by using the number of columns in the 1st row
if (!defined($oHeader))
{
my @oyRow = $oChild->nodeGet('table-data')->nodeList('table-row');
foreach my $oRowCell ($oyRow[0]->nodeList('table-cell'))
{
$strHeaderText .= " | ";
$strHeaderIndicator .= ":--- | ";
}
$strHeaderText .= "\n";
$strHeaderIndicator .= "\n";
}
$strMarkdown .= (defined($strHeaderText) ? $strHeaderText : '') . $strHeaderIndicator;
# Build the rows
foreach my $oRow ($oChild->nodeGet('table-data')->nodeList('table-row'))
{
my @oRowCellList = $oRow->nodeList('table-cell');
$strMarkdown .= "| ";
for (my $iRowCellIdx = 0; $iRowCellIdx < @oRowCellList; $iRowCellIdx++)
{
my $oRowCell = $oRowCellList[$iRowCellIdx];
$strMarkdown .= $self->processText($oRowCell->textGet()) .
(($iRowCellIdx < @oRowCellList -1) ? " | " : " |\n");
}
}
}
# Add an admonition (e.g. NOTE, WARNING, etc)
elsif ($oChild->nameGet() eq 'admonition')
{
$strMarkdown .= "\n> **" . uc($oChild->paramGet('type')) . ":** " . $self->processText($oChild->textGet());
}
# Check if the child can be processed by a parent
else
{
$self->sectionChildProcess($oSection, $oChild, $iDepth + 1);
}
$strLastChild = $oChild->nameGet();
}
# Return from function and log return values if any
return logDebugReturn
(
$strOperation,
{name => 'strMarkdown', value => $strMarkdown, trace => true}
);
}
####################################################################################################################################
# backrestConfigProcess
####################################################################################################################################
sub backrestConfigProcess
{
my $self = shift;
# Assign function parameters, defaults, and log debug info
my
(
$strOperation,
$oSection,
$oConfig,
$iDepth
) =
logDebugParam
(
__PACKAGE__ . '->backrestConfigProcess', \@_,
{name => 'oSection'},
{name => 'oConfig'},
{name => 'iDepth'}
);
# # Generate the config
# my $oConfigElement;
# my ($strFile, $strConfig, $bShow) = $self->backrestConfig($oSection, $oConfig, $iDepth);
#
# if ($bShow)
# {
# my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
#
# # Render the config
# $oConfigElement = new pgBackRestDoc::Html::DocHtmlElement(HTML_DIV, "config");
#
# $oConfigElement->
# addNew(HTML_DIV, "config-title",
# {strContent => "${strHostName}:${strFile}" .
# " ⇒ " . $self->processText($oConfig->nodeGet('title')->textGet())});
#
# my $oConfigBodyElement = $oConfigElement->addNew(HTML_DIV, "config-body");
# #
# # $oConfigBodyElement->
# # addNew(HTML_DIV, "config-body-title",
# # {strContent => "${strFile}:"});
#
# $oConfigBodyElement->
# addNew(HTML_DIV, "config-body-output",
# {strContent => $strConfig});
# }
#
# # Return from function and log return values if any
# return logDebugReturn
# (
# $strOperation,
# {name => 'oConfigElement', value => $oConfigElement, trace => true}
# );
}
####################################################################################################################################
# postgresConfigProcess
####################################################################################################################################
sub postgresConfigProcess
{
my $self = shift;
# # Assign function parameters, defaults, and log debug info
# my
# (
# $strOperation,
# $oSection,
# $oConfig,
# $iDepth
# ) =
# logDebugParam
# (
# __PACKAGE__ . '->postgresConfigProcess', \@_,
# {name => 'oSection'},
# {name => 'oConfig'},
# {name => 'iDepth'}
# );
#
# # Generate the config
# my $oConfigElement;
# my ($strFile, $strConfig, $bShow) = $self->postgresConfig($oSection, $oConfig, $iDepth);
#
# if ($bShow)
# {
# # Render the config
# my $strHostName = $self->{oManifest}->variableReplace($oConfig->paramGet('host'));
# $oConfigElement = new pgBackRestDoc::Html::DocHtmlElement(HTML_DIV, "config");
#
# $oConfigElement->
# addNew(HTML_DIV, "config-title",
# {strContent => "${strHostName}:${strFile}" .
# " ⇒ " . $self->processText($oConfig->nodeGet('title')->textGet())});
#
# my $oConfigBodyElement = $oConfigElement->addNew(HTML_DIV, "config-body");
#
# # $oConfigBodyElement->
# # addNew(HTML_DIV, "config-body-title",
# # {strContent => "append to ${strFile}:"});
#
# $oConfigBodyElement->
# addNew(HTML_DIV, "config-body-output",
# {strContent => defined($strConfig) ? $strConfig : ''});
#
# $oConfig->fieldSet('actual-config', $strConfig);
# }
#
# # Return from function and log return values if any
# return logDebugReturn
# (
# $strOperation,
# {name => 'oConfigElement', value => $oConfigElement, trace => true}
# );
}
1;
pgbackrest-release-2.55.1/doc/lib/pgBackRestDoc/ProjectInfo.pm 0000664 0000000 0000000 00000007160 15006170376 0024126 0 ustar 00root root 0000000 0000000 ####################################################################################################################################
# PROJECT INFO MODULE
#
# Contains project name, version and format.
####################################################################################################################################
package pgBackRestDoc::ProjectInfo;
use strict;
use warnings FATAL => qw(all);
use Cwd qw(abs_path);
use Exporter qw(import);
our @EXPORT = qw();
use File::Basename qw(dirname);
# Project Name
#
# Defines the official project name, exe, and config file.
#-----------------------------------------------------------------------------------------------------------------------------------
push @EXPORT, qw(PROJECT_NAME);
push @EXPORT, qw(PROJECT_EXE);
push @EXPORT, qw(PROJECT_CONF);
# Project Version Number
#
# Defines the current version of the BackRest executable. The version number is used to track features but does not affect what
# repositories or manifests can be read - that's the job of the format number.
#-----------------------------------------------------------------------------------------------------------------------------------
push @EXPORT, qw(PROJECT_VERSION_MAJOR);
push @EXPORT, qw(PROJECT_VERSION_MINOR);
push @EXPORT, qw(PROJECT_VERSION_PATCH);
push @EXPORT, qw(PROJECT_VERSION_SUFFIX);
push @EXPORT, qw(PROJECT_VERSION);
# Repository Format Number
#
# Defines format for info and manifest files as well as on-disk structure. If this number changes then the repository will be
# invalid unless migration functions are written.
#-----------------------------------------------------------------------------------------------------------------------------------
push @EXPORT, qw(REPOSITORY_FORMAT);
####################################################################################################################################
# Load project info from src/version.h
####################################################################################################################################
require pgBackRestTest::Common::Storage;
require pgBackRestTest::Common::StoragePosix;
my $strProjectInfo = ${new pgBackRestTest::Common::Storage(
dirname(dirname(abs_path($0))), new pgBackRestTest::Common::StoragePosix())->get('src/version.h')};
foreach my $strLine (split("\n", $strProjectInfo))
{
if ($strLine =~ /^#define PROJECT_NAME/)
{
eval("use constant PROJECT_NAME => " . (split(" ", $strLine))[-1]);
}
elsif ($strLine =~ /^#define PROJECT_BIN/)
{
eval("use constant PROJECT_EXE => " . (split(" ", $strLine))[-1]);
eval("use constant PROJECT_CONF => " . (split(" ", $strLine))[-1] . " . \'.conf\'");
}
elsif ($strLine =~ /^#define PROJECT_VERSION_MAJOR/)
{
eval("use constant PROJECT_VERSION_MAJOR => \"" . (split(" ", $strLine))[-1] . "\"");
}
elsif ($strLine =~ /^#define PROJECT_VERSION_MINOR/)
{
eval("use constant PROJECT_VERSION_MINOR => " . (split(" ", $strLine))[-1]);
}
elsif ($strLine =~ /^#define PROJECT_VERSION_PATCH/)
{
eval("use constant PROJECT_VERSION_PATCH => " . (split(" ", $strLine))[-1]);
}
elsif ($strLine =~ /^#define PROJECT_VERSION_SUFFIX/)
{
eval("use constant PROJECT_VERSION_SUFFIX => " . (split(" ", $strLine))[-1]);
}
elsif ($strLine =~ /^#define REPOSITORY_FORMAT/)
{
eval("use constant REPOSITORY_FORMAT => " . (split(" ", $strLine))[-1]);
}
}
eval(
'use constant PROJECT_VERSION => "' . PROJECT_VERSION_MAJOR() . '.' . PROJECT_VERSION_MINOR() . '.' . PROJECT_VERSION_PATCH() .
PROJECT_VERSION_SUFFIX() . '"');
1;
pgbackrest-release-2.55.1/doc/manifest.xml 0000664 0000000 0000000 00000013535 15006170376 0020460 0 ustar 00root root 0000000 0000000
pgBackRest
Reliable PostgreSQL Backup & Restore
use pgBackRestDoc::ProjectInfo; PROJECT_VERSION
use pgBackRestDoc::Custom::DocCustomRelease;
(new pgBackRestDoc::Custom::DocCustomRelease(
new pgBackRestDoc::Common::Doc("{[doc-path]}/xml/release.xml")))->currentStableVersion();
pgbackrest
/
PostgreSQL
-
logo.png
favicon.png
n
n
n
n
use Time::Local;
use pgBackRestDoc::Custom::DocCustomRelease;
my ($second, $minute , $hour, $mday, $month, $year) = localtime();
$year += 1900;
if ('{[release-date-static]}' eq 'y')
{
my $strDate = (new pgBackRestDoc::Custom::DocCustomRelease(
new pgBackRestDoc::Common::Doc("{[doc-path]}/xml/release.xml")))->releaseLast()->paramGet('date');
if ($strDate eq 'XXXX-XX-XX')
{
confess &log(ERROR, 'not possible to use static release dates on a dev build');
}
else
{
($year, $month, $mday) = split(/[\s.\-]+/, $strDate);
$month -= 1;
}
}
my @stryMonth = ('January', 'February', 'March', 'April', 'May', 'June',
'July', 'August', 'September', 'October', 'November', 'December');
$stryMonth[$month] . ' ' . $mday . ', ' . $year;
'Copyright © 2015' . '-' . substr('{[release-date]}', length('{[release-date]}') - 4) .
', The PostgreSQL Global Development Group, <a href="{[github-url-license]}">MIT License</a>. Updated ' .
'{[release-date]}';
{[doc-path]}/output/latex/logo
{[project]} User Guide
Open Source PostgreSQL Backup and Restore Utility
Version {[version]}
Crunchy Data Solutions, Inc.
cds-logo.eps
{[pdf-title1]}\\{[pdf-title3]}
\ \\-\ \thepage\ -
{[pdf-organization]}\\\today
CrunchyBackRest-UserGuide-{[version]}
pgbackrest-release-2.55.1/doc/release.pl 0000775 0000000 0000000 00000031364 15006170376 0020110 0 ustar 00root root 0000000 0000000 #!/usr/bin/perl
####################################################################################################################################
# release.pl - PgBackRest Release Manager
####################################################################################################################################
####################################################################################################################################
# Perl includes
####################################################################################################################################
use strict;
use warnings FATAL => qw(all);
use Carp qw(confess);
use English '-no_match_vars';
$SIG{__DIE__} = sub { Carp::confess @_ };
use Cwd qw(abs_path);
use File::Basename qw(dirname);
use Getopt::Long qw(GetOptions);
use Pod::Usage qw(pod2usage);
use Storable;
use lib dirname($0) . '/lib';
use lib dirname(dirname($0)) . '/build/lib';
use lib dirname(dirname($0)) . '/lib';
use lib dirname(dirname($0)) . '/test/lib';
use pgBackRestTest::Common::ExecuteTest;
use pgBackRestTest::Common::Storage;
use pgBackRestTest::Common::StoragePosix;
use pgBackRestTest::Common::VmTest;
use pgBackRestDoc::Common::Doc;
use pgBackRestDoc::Common::DocConfig;
use pgBackRestDoc::Common::DocManifest;
use pgBackRestDoc::Common::DocRender;
use pgBackRestDoc::Common::Exception;
use pgBackRestDoc::Common::Log;
use pgBackRestDoc::Common::String;
use pgBackRestDoc::Custom::DocCustomRelease;
use pgBackRestDoc::Html::DocHtmlSite;
use pgBackRestDoc::Latex::DocLatex;
use pgBackRestDoc::Markdown::DocMarkdown;
use pgBackRestDoc::ProjectInfo;
####################################################################################################################################
# Usage
####################################################################################################################################
=head1 NAME
release.pl - pgBackRest Release Manager
=head1 SYNOPSIS
release.pl [options]
General Options:
--help Display usage and exit
--version Display pgBackRest version
--quiet Sets log level to ERROR
--log-level Log level for execution (e.g. ERROR, WARN, INFO, DEBUG)
Release Options:
--build Build the cache before release (should be included in the release commit)
--deploy Deploy documentation to website (can be done as docs are updated)
--no-gen Don't auto-generate
--vm vm to build documentation for
=cut
####################################################################################################################################
# Load command line parameters and config (see usage above for details)
####################################################################################################################################
my $bHelp = false;
my $bVersion = false;
my $bQuiet = false;
my $strLogLevel = 'info';
my $bBuild = false;
my $bDeploy = false;
my $bNoGen = false;
my $strVm = undef;
GetOptions ('help' => \$bHelp,
'version' => \$bVersion,
'quiet' => \$bQuiet,
'log-level=s' => \$strLogLevel,
'build' => \$bBuild,
'deploy' => \$bDeploy,
'no-gen' => \$bNoGen,
'vm=s' => \$strVm)
or pod2usage(2);
####################################################################################################################################
# Run in eval block to catch errors
####################################################################################################################################
eval
{
# Display version and exit if requested
if ($bHelp || $bVersion)
{
print PROJECT_NAME . ' ' . PROJECT_VERSION . " Release Manager\n";
if ($bHelp)
{
print "\n";
pod2usage();
}
exit 0;
}
# If neither build nor deploy is requested then error
if (!$bBuild && !$bDeploy)
{
confess &log(ERROR, 'neither --build nor --deploy requested, nothing to do');
}
# Set console log level
if ($bQuiet)
{
$strLogLevel = 'error';
}
logLevelSet(undef, uc($strLogLevel), OFF);
# Set the paths
my $strDocPath = dirname(abs_path($0));
my $strDocHtml = "${strDocPath}/output/html";
my $strDocExe = "${strDocPath}/doc.pl";
my $strTestExe = dirname($strDocPath) . "/test/test.pl";
my $oStorageDoc = new pgBackRestTest::Common::Storage(
$strDocPath, new pgBackRestTest::Common::StoragePosix({bFileSync => false, bPathSync => false}));
# Determine if this is a dev release
my $bDev = PROJECT_VERSION =~ /dev$/;
my $strVersion = $bDev ? 'dev' : PROJECT_VERSION;
# Make sure version number matches the latest release
&log(INFO, "check version info");
my $strReleaseFile = dirname(dirname(abs_path($0))) . '/doc/xml/release.xml';
my $oRelease = (new pgBackRestDoc::Custom::DocCustomRelease(new pgBackRestDoc::Common::Doc($strReleaseFile)))->releaseLast();
if ($oRelease->paramGet('version') ne PROJECT_VERSION)
{
confess 'unable to find version ' . PROJECT_VERSION . " as the most recent release in ${strReleaseFile}";
}
if ($bBuild)
{
if (!$bNoGen)
{
# Update git history
my $strGitCommand =
'git -C ' . $strDocPath .
' log --pretty=format:\'{^^^^commit^^^^:^^^^%H^^^^,^^^^date^^^^:^^^^%ci^^^^,^^^^subject^^^^:^^^^%s^^^^,^^^^body^^^^:^^^^%b^^^^},\'';
my $strGitLog = qx($strGitCommand);
$strGitLog =~ s/\^\^\^\^\}\,\n/\#\#\#\#/mg;
$strGitLog =~ s/\\/\\\\/g;
$strGitLog =~ s/\n/\\n/mg;
$strGitLog =~ s/\r/\\r/mg;
$strGitLog =~ s/\t/\\t/mg;
$strGitLog =~ s/\"/\\\"/g;
$strGitLog =~ s/\^\^\^\^/\"/g;
$strGitLog =~ s/\#\#\#\#/\"\}\,\n/mg;
$strGitLog = '[' . substr($strGitLog, 0, length($strGitLog) - 1) . ']';
my @hyGitLog = @{(JSON::PP->new()->allow_nonref())->decode($strGitLog)};
# Load prior history
my @hyGitLogPrior = @{(JSON::PP->new()->allow_nonref())->decode(
${$oStorageDoc->get("${strDocPath}/resource/git-history.cache")})};
# Add new commits
for (my $iGitLogIdx = @hyGitLog - 1; $iGitLogIdx >= 0; $iGitLogIdx--)
{
my $rhGitLog = $hyGitLog[$iGitLogIdx];
my $bFound = false;
foreach my $rhGitLogPrior (@hyGitLogPrior)
{
if ($rhGitLog->{commit} eq $rhGitLogPrior->{commit})
{
$bFound = true;
}
}
next if $bFound;
$rhGitLog->{body} = trim($rhGitLog->{body});
if ($rhGitLog->{body} eq '')
{
delete($rhGitLog->{body});
}
unshift(@hyGitLogPrior, $rhGitLog);
}
# Write git log
$strGitLog = undef;
foreach my $rhGitLog (@hyGitLogPrior)
{
$strGitLog .=
(defined($strGitLog) ? ",\n" : '') .
" {\n" .
' "commit": ' . trim((JSON::PP->new()->allow_nonref()->pretty())->encode($rhGitLog->{commit})) . ",\n" .
' "date": ' . trim((JSON::PP->new()->allow_nonref()->pretty())->encode($rhGitLog->{date})) . ",\n" .
' "subject": ' . trim((JSON::PP->new()->allow_nonref()->pretty())->encode($rhGitLog->{subject}));
# Skip the body if it is empty or a release (since we already have the release note content)
if ($rhGitLog->{subject} !~ /^v[0-9]{1,2}\.[0-9]{1,2}(\.[0-9]+){0,1}\: /g && defined($rhGitLog->{body}))
{
$strGitLog .=
",\n" .
' "body": ' . trim((JSON::PP->new()->allow_nonref()->pretty())->encode($rhGitLog->{body}));
}
$strGitLog .=
"\n" .
" }";
}
$oStorageDoc->put("${strDocPath}/resource/git-history.cache", "[\n${strGitLog}\n]\n");
# Generate coverage summary
&log(INFO, "Generate Coverage Summary");
executeTest("${strTestExe} --vm=u22 --no-valgrind --clean --coverage-summary", {bShowOutputAsync => true});
}
# Remove permanent cache file
$oStorageDoc->remove("${strDocPath}/resource/exe.cache", {bIgnoreMissing => true});
# Remove all docker containers to get consistent IP address assignments
executeTest('docker rm -f $(docker ps -a -q)', {bSuppressError => true});
# Generate deployment docs for RHEL
if (!defined($strVm) || $strVm eq VM_RH8)
{
&log(INFO, "Generate RHEL documentation");
executeTest("${strDocExe} --deploy --key-var=os-type=rhel --out=html", {bShowOutputAsync => true});
if (!defined($strVm))
{
executeTest("${strDocExe} --deploy --cache-only --key-var=os-type=rhel --out=pdf");
}
}
# Generate deployment docs for Debian
if (!defined($strVm) || $strVm eq VM_U20)
{
&log(INFO, "Generate Debian/Ubuntu documentation");
executeTest("${strDocExe} --deploy --out=man --out=html --out=markdown", {bShowOutputAsync => true});
}
# Generate a full copy of the docs for review
if (!defined($strVm))
{
&log(INFO, "Generate full documentation for review");
executeTest(
"${strDocExe} --deploy --out-preserve --cache-only --key-var=os-type=rhel --out=html" .
" --var=project-url-root=index.html");
$oStorageDoc->move("$strDocHtml/user-guide.html", "$strDocHtml/user-guide-rhel.html");
executeTest(
"${strDocExe} --deploy --out-preserve --cache-only --out=man --out=html --var=project-url-root=index.html");
}
}
if ($bDeploy)
{
my $strDeployPath = "${strDocPath}/site";
# Generate docs for the website history
&log(INFO, 'Generate website ' . ($bDev ? 'dev' : 'history') . ' documentation');
my $strDocExeVersion =
${strDocExe} . ($bDev ? ' --dev' : ' --deploy --cache-only') . ' --var=project-url-root=index.html --out=html';
executeTest("${strDocExeVersion} --out-preserve --key-var=os-type=rhel");
$oStorageDoc->move("$strDocHtml/user-guide.html", "$strDocHtml/user-guide-rhel.html");
$oStorageDoc->remove("$strDocHtml/release.html");
executeTest("${strDocExeVersion} --out-preserve --exclude=release");
# Deploy to repository
&log(INFO, '...Deploy to repository');
executeTest("rm -rf ${strDeployPath}/prior/${strVersion}");
executeTest("mkdir ${strDeployPath}/prior/${strVersion}");
executeTest("cp ${strDocHtml}/* ${strDeployPath}/prior/${strVersion}");
# Generate docs for the main website
if (!$bDev)
{
&log(INFO, "Generate website documentation");
executeTest("${strDocExe} --var=analytics=y --deploy --cache-only --key-var=os-type=rhel --out=html");
$oStorageDoc->move("$strDocHtml/user-guide.html", "$strDocHtml/user-guide-rhel.html");
executeTest("${strDocExe} --var=analytics=y --deploy --out-preserve --cache-only --out=html");
# Deploy to repository
&log(INFO, '...Deploy to repository');
executeTest("rm -rf ${strDeployPath}/dev");
executeTest("find ${strDeployPath} -maxdepth 1 -type f -exec rm {} +");
executeTest("cp ${strDocHtml}/* ${strDeployPath}");
executeTest("cp ${strDocPath}/../README.md ${strDeployPath}");
executeTest("cp ${strDocPath}/../LICENSE ${strDeployPath}");
}
# Update permissions
executeTest("find ${strDeployPath} -path .git -prune -type d -exec chmod 750 {} +");
executeTest("find ${strDeployPath} -path .git -prune -type f -exec chmod 640 {} +");
}
# Exit with success
exit 0;
}
####################################################################################################################################
# Check for errors
####################################################################################################################################
or do
{
# If a backrest exception then return the code
exit $EVAL_ERROR->code() if (isException(\$EVAL_ERROR));
# Else output the unhandled error
print $EVAL_ERROR;
exit ERROR_UNHANDLED;
};
# It shouldn't be possible to get here
&log(ASSERT, 'execution reached invalid location in ' . __FILE__ . ', line ' . __LINE__);
exit ERROR_ASSERT;
pgbackrest-release-2.55.1/doc/resource/ 0000775 0000000 0000000 00000000000 15006170376 0017750 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/resource/exe.cache 0000664 0000000 0000000 00002074766 15006170376 0021544 0 ustar 00root root 0000000 0000000 {
"default" : {
"all" : {
"contributing" : [
{
"key" : {
"id" : "contrib",
"image" : "pgbackrest/doc:contrib",
"name" : "pgbackrest-dev",
"option" : "-v /var/run/docker.sock:/var/run/docker.sock -v /home/vagrant/test:/home/vagrant/test",
"os" : "u20",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.10"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get update"
],
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install rsync git devscripts build-essential valgrind autoconf \\",
" autoconf-archive libssl-dev zlib1g-dev libxml2-dev libpq-dev pkg-config \\",
" libxml-checker-perl libyaml-perl libdbd-pg-perl liblz4-dev liblz4-tool \\",
" zstd libzstd-dev bzip2 libbz2-dev libyaml-dev ccache python3-distutils meson"
],
"cmd-extra" : "-y 2>&1",
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"pgbackrest/test/test.pl --clean-only"
],
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"curl -fsSL https://get.docker.com | sudo sh"
],
"cmd-extra" : "2>&1",
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo usermod -aG docker `whoami`"
],
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 666 /var/run/docker.sock"
],
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"pgbackrest/test/test.pl --dry-run"
],
"cmd-extra" : "--no-log-timestamp",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"[0-9]+ tests selected|DRY RUN COMPLETED SUCCESSFULLY"
]
},
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: test begin on x86_64 - log level info",
"P00 INFO: clean autogenerate code",
"P00 INFO: 83 tests selected",
" ",
"P00 INFO: P1-T01/83 - vm=none, module=common, test=error",
" [filtered 80 lines of output]",
"P00 INFO: P1-T82/83 - vm=none, module=performance, test=type",
"P00 INFO: P1-T83/83 - vm=none, module=performance, test=storage",
"P00 INFO: DRY RUN COMPLETED SUCCESSFULLY"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"pgbackrest/test/test.pl --vm-out --module=common --test=wait"
],
"cmd-extra" : "--no-log-timestamp",
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: test begin on x86_64 - log level info",
"P00 INFO: cleanup old data",
"P00 INFO: autogenerate code",
"P00 INFO: build for none (/home/vagrant/test/build/none)",
"P00 INFO: 1 test selected",
" ",
"P00 INFO: P1-T1/1 - vm=none, module=common, test=wait",
" ",
" P00 INFO: test command begin 2.55.1: [common/wait] --log-level=info --no-log-timestamp --repo-path=/home/vagrant/test/repo --scale=1 --test-path=/home/vagrant/test --vm=none --vm-id=0",
" P00 INFO: test command end: completed successfully",
" run 1 - waitNew(), waitMore, and waitFree()",
" L0018 expect AssertError: assertion 'waitTime <= 999999000' failed",
" ",
" run 1/1 ----- L0021 0ms wait",
" L0025 new wait",
" L0026 check wait time",
" L0027 check sleep time",
" L0028 check sleep prev time",
" L0029 no wait more",
" ",
" run 1/2 ----- L0032 100ms with retries after time expired",
" L0034 new wait",
" L0037 time expired, first retry",
" L0038 time expired, second retry",
" L0039 time expired, retries expired",
" ",
" run 1/3 ----- L0042 200ms wait",
" L0046 new wait = 0.2 sec",
" L0047 check wait time",
" L0048 check sleep time",
" L0049 check sleep prev time",
" L0050 check begin time",
" L0052 first retry",
" L0053 check retry",
" L0055 second retry",
" L0056 check retry",
" L0058 still going because of time",
" L0064 lower range check",
" L0065 upper range check",
" L0067 free wait",
" ",
" run 1/4 ----- L0070 1100ms wait",
" L0074 new wait = 1.1 sec",
" L0075 check wait time",
" L0076 check sleep time",
" L0077 check sleep prev time",
" L0078 check begin time",
" L0084 lower range check",
" L0085 upper range check",
" L0087 free wait",
" ",
" run 1/5 ----- L0090 waitRemainder()",
" L0092 new wait = 500ms",
" L0093 check initial wait remainder",
" L0094 check initial wait remainder",
" L0098 check updated wait remainder",
" L0099 check updated wait remainder",
" ",
" TESTS COMPLETED SUCCESSFULLY",
"",
"P00 INFO: P1-T1/1 - vm=none, module=common, test=wait",
"P00 INFO: tested modules have full coverage",
"P00 INFO: TESTS COMPLETED SUCCESSFULLY"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"pgbackrest/test/test.pl --module=postgres"
],
"cmd-extra" : "--no-log-timestamp",
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: test begin on x86_64 - log level info",
"P00 INFO: cleanup old data",
"P00 INFO: autogenerate code",
"P00 INFO: build for none (/home/vagrant/test/build/none)",
"P00 INFO: 2 tests selected",
" ",
"P00 INFO: P1-T1/2 - vm=none, module=postgres, test=client",
"P00 INFO: P1-T2/2 - vm=none, module=postgres, test=interface",
"P00 INFO: tested modules have full coverage",
"P00 INFO: TESTS COMPLETED SUCCESSFULLY"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"pgbackrest/test/test.pl --vm-build --vm=u20"
],
"cmd-extra" : "--no-log-timestamp",
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: test begin on x86_64 - log level info",
"P00 INFO: Using cached pgbackrest/test:u20-base-x86_64-20250228A image (862159b4d2169a4752b106639ca0f47c1ebb1f86) ...",
"P00 INFO: Building pgbackrest/test:u20-test-x86_64 image ...",
"P00 INFO: Build Complete"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"pgbackrest/test/test.pl --vm=u20 --module=postgres --test=interface --run=2"
],
"cmd-extra" : "--no-log-timestamp",
"host" : "pgbackrest-dev",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: test begin on x86_64 - log level info",
"P00 INFO: cleanup old data and containers",
"P00 INFO: autogenerate code",
"P00 INFO: clean build for u20 (/home/vagrant/test/build/u20)",
"P00 INFO: 1 test selected",
" ",
"P00 INFO: P1-T1/1 - vm=u20, module=postgres, test=interface, run=2",
"P00 INFO: TESTS COMPLETED SUCCESSFULLY"
]
}
}
],
"user-guide" : [
{
"key" : {
"id" : "azure",
"image" : "mcr.microsoft.com/azure-storage/azurite",
"name" : "azure-server",
"option" : "-v {[host-repo-path]}/doc/resource/fake-cert/azure-server.crt:/root/public.crt:ro -v {[host-repo-path]}/doc/resource/fake-cert/azure-server.key:/root/private.key:ro -e AZURITE_ACCOUNTS='pgbackrest:YXpLZXk='",
"os" : "debian",
"param" : "azurite-blob --blobPort 443 --blobHost 0.0.0.0 --cert=/root/public.crt --key=/root/private.key",
"update-hosts" : false
},
"type" : "host",
"value" : {
"ip" : "172.17.0.2"
}
},
{
"key" : {
"id" : "s3",
"image" : "minio/minio",
"name" : "s3-server",
"option" : "-v {[host-repo-path]}/doc/resource/fake-cert/s3-server.crt:/root/.minio/certs/public.crt:ro -v {[host-repo-path]}/doc/resource/fake-cert/s3-server.key:/root/.minio/certs/private.key:ro -e MINIO_REGION=us-east-1 -e MINIO_DOMAIN=s3.us-east-1.amazonaws.com -e MINIO_BROWSER=off -e MINIO_ACCESS_KEY=accessKey1 -e MINIO_SECRET_KEY=verySecretKey1",
"os" : "debian",
"param" : "server /data --address :443",
"update-hosts" : false
},
"type" : "host",
"value" : {
"ip" : "172.17.0.3"
}
},
{
"key" : {
"id" : "sftp",
"image" : "pgbackrest/doc:debian",
"name" : "sftp-server",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.4"
}
},
{
"key" : {
"id" : "build",
"image" : "pgbackrest/doc:debian",
"name" : "build",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.5"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /build/pgbackrest-release-2.55.1"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp -r /pgbackrest/* /build/pgbackrest-release-2.55.1"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown -R vagrant /build"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get update"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install python3-distutils meson gcc libpq-dev libssl-dev libxml2-dev \\",
" pkg-config liblz4-dev libzstd-dev libbz2-dev libz-dev libyaml-dev libssh2-1-dev"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"meson setup /build/pgbackrest /build/pgbackrest-release-2.55.1"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"ninja -C /build/pgbackrest"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg1",
"image" : "pgbackrest/doc:debian",
"name" : "pg-primary",
"option" : "-m 512m",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.6"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install postgresql-client libxml2 libssh2-1"
],
"cmd-extra" : "-y 2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.55.1 - General help",
"",
"Usage:",
" pgbackrest [options] [command]",
"",
"Commands:",
" annotate add or modify backup annotation",
" archive-get get a WAL segment from the archive",
" archive-push push a WAL segment to the archive",
" backup backup a database cluster",
" check check the configuration",
" expire expire backups that exceed retention",
" help get help",
" info retrieve information about backups",
" repo-get get a file from a repository",
" repo-ls list files in a repository",
" restore restore a database cluster",
" server pgBackRest server",
" server-ping ping pgBackRest server",
" stanza-create create the required stanza data",
" stanza-delete delete a stanza",
" stanza-upgrade upgrade a stanza",
" start allow pgBackRest processes to run",
" stop stop pgBackRest processes from running",
" verify verify contents of a repository",
" version get version",
"",
"Use 'pgbackrest help [command]' for more information."
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/lib/postgresql/16/bin/initdb \\",
" -D /var/lib/postgresql/16/demo -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_createcluster 16 demo"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"Configuring already existing cluster (configuration: /etc/postgresql/16/demo, data: /var/lib/postgresql/16/demo, owner: 102:103)",
"Ver Cluster Port Status Owner Data directory Log file",
"16 demo 5432 down postgres /var/lib/postgresql/16/demo /var/log/postgresql/postgresql-16-demo.log"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cat /root/postgresql.common.conf >> /etc/postgresql/16/demo/postgresql.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/16/demo"
}
},
"global" : {
"log-timestamp" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres bash -c ' \\",
" export PGBACKREST_LOG_PATH=/path/set/by/env && \\",
" pgbackrest --log-level-console=error help backup log-path'"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"current\\: \\/path\\/set\\/by\\/env"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.55.1 - 'backup' command - 'log-path' option help",
"",
"Path where log files are stored.",
"",
"The log path provides a location for pgBackRest to store log files. Note that",
"if log-level-file=off then no log path is required.",
"",
"current: /path/set/by/env",
"default: /var/log/pgbackrest"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/etc/postgresql/16/demo/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo restart"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" create or replace function create_test_table(prefix int, scale int, data bool) returns void as \\$\\$ \\",
" declare \\",
" index int; \\",
" begin \\",
" for index in 1 .. scale loop \\",
" execute 'create table test_' || prefix || '_' || index || ' (id int)'; \\",
" \\",
" if data then \\",
" execute 'insert into test_' || prefix || '_' || index || ' values (' || (prefix * index) || ')'; \\",
" end if; \\",
" end loop; \\",
" end \\$\\$ LANGUAGE plpgsql;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global:archive-push" : {
"compress-level" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-cipher-pass" : {
"value" : "zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO"
},
"repo1-cipher-type" : {
"value" : "aes-256-cbc"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.55.1: --exec-id=377-87743616 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-create for stanza 'demo' on repo1",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" successfully archived to "
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=385-c96e0ee9 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 000000010000000000000001 successfully archived to '/var/lib/pgbackrest/archive/demo/16-1/0000000100000000/000000010000000000000001-ce9289f79867819258af79ffa4d150deb16ca2d3.gz' on repo1",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"start-fast" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.55.1: --exec-id=409-09d7370f --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --start-fast",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 000000010000000000000002, lsn = 0/2000028",
" [filtered 3 lines of output]",
"P00 INFO: check archive for segment(s) 000000010000000000000002:000000010000000000000003",
"P00 INFO: new backup label = 20250505-153608F",
"P00 INFO: full backup size = 22.0MB, file total = 963",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=409-09d7370f --log-level-console=info --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-153608F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"diff backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 7 lines of output]",
"P00 INFO: check archive for segment(s) 000000010000000000000004:000000010000000000000005",
"P00 INFO: new backup label = 20250505-153608F_20250505-153612D",
"P00 INFO: diff backup size = 8.3KB, file total = 963",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=434-a44db86f --log-level-console=info --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"(full|incr|diff) backup"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (16): 000000010000000000000001/000000010000000000000005",
"",
" full backup: 20250505-153608F",
" timestamp start/stop: 2025-05-05 15:36:08+00 / 2025-05-05 15:36:11+00",
" wal start/stop: 000000010000000000000002 / 000000010000000000000003",
" database size: 22.0MB, database backup size: 22.0MB",
" repo1: backup set size: 2.9MB, backup size: 2.9MB",
"",
" diff backup: 20250505-153608F_20250505-153612D",
" timestamp start/stop: 2025-05-05 15:36:12+00 / 2025-05-05 15:36:13+00",
" wal start/stop: 000000010000000000000004 / 000000010000000000000005",
" database size: 22.0MB, database backup size: 8.3KB",
" repo1: backup set size: 2.9MB, backup size: 464B",
" backup reference total: 1 full"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm /var/lib/postgresql/16/demo/global/pg_control"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"could not find the database system"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"Error: /usr/lib/postgresql/16/bin/pg_ctl /usr/lib/postgresql/16/bin/pg_ctl start -D /var/lib/postgresql/16/demo -l /var/log/postgresql/postgresql-16-demo.log -s -o -c config_file=\"/etc/postgresql/16/demo/postgresql.conf\" exited with status 1: ",
"postgres: could not find the database system",
"Expected to find it in the directory \"/var/lib/postgresql/16/demo\",",
"but could not open file \"/var/lib/postgresql/16/demo/global/pg_control\": No such file or directory",
"Examine the log output."
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres find /var/lib/postgresql/16/demo -mindepth 1 -delete"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p /var/lib/postgresql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cp -r /pgbackrest/doc/example/* \\",
" /var/lib/postgresql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/postgresql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- An example of monitoring pgBackRest from within PostgreSQL",
"--",
"-- Use copy to export data from the pgBackRest info command into the jsonb",
"-- type so it can be queried directly by PostgreSQL.",
"",
"-- Create monitor schema",
"create schema monitor;",
"",
"-- Get pgBackRest info in JSON format",
"create function monitor.pgbackrest_info()",
" returns jsonb AS $$",
"declare",
" data jsonb;",
"begin",
" -- Create a temp table to hold the JSON data",
" create temp table temp_pgbackrest_data (data text);",
"",
" -- Copy data into the table directly from the pgBackRest info command",
" copy temp_pgbackrest_data (data)",
" from program",
" 'pgbackrest --output=json info' (format text);",
"",
" select replace(temp_pgbackrest_data.data, E'\\n', '\\n')::jsonb",
" into data",
" from temp_pgbackrest_data;",
"",
" drop table temp_pgbackrest_data;",
"",
" return data;",
"end $$ language plpgsql;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/postgresql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/postgresql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- Get last successful backup for each stanza",
"--",
"-- Requires the monitor.pgbackrest_info function.",
"with stanza as",
"(",
" select data->'name' as name,",
" data->'backup'->(",
" jsonb_array_length(data->'backup') - 1) as last_backup,",
" data->'archive'->(",
" jsonb_array_length(data->'archive') - 1) as current_archive",
" from jsonb_array_elements(monitor.pgbackrest_info()) as data",
")",
"select name,",
" to_timestamp(",
" (last_backup->'timestamp'->>'stop')::numeric) as last_successful_backup,",
" current_archive->>'max' as last_archived_wal",
" from stanza;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/postgresql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" name | last_successful_backup | last_archived_wal ",
"--------+------------------------+--------------------------",
" \"demo\" | 2025-05-05 15:36:13+00 | 000000010000000000000005",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install jq"
],
"cmd-extra" : "-y 2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --output=json --stanza=demo info | \\",
" jq '.[0] | .backup[-1] | .timestamp.stop'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"1746459373"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --output=json --stanza=demo info | \\",
" jq '.[0] | .archive[-1] | .max'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"\"000000010000000000000005\""
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-bundle" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres find /var/lib/pgbackrest/backup/demo/latest/ -type f | wc -l"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"5"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-block" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --annotation=source=\"demo backup\" \\",
" --annotation=key=value --type=full backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-153628F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --set=20250505-153628F info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"annotation"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (16): 000000020000000000000007/000000020000000000000009",
"",
" full backup: 20250505-153628F",
" timestamp start/stop: 2025-05-05 15:36:28+00 / 2025-05-05 15:36:29+00",
" wal start/stop: 000000020000000000000008 / 000000020000000000000009",
" lsn start/stop: 0/8000028 / 0/9000050",
" database size: 22.0MB, database backup size: 22.0MB",
" repo1: backup size: 2.9MB",
" database list: postgres (5)",
" annotation(s)",
" key: value",
" source: demo backup"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --set=20250505-153628F \\",
" --annotation=key= --annotation=new_key=new_value annotate"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --set=20250505-153628F info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"annotation"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (16): 000000020000000000000007/000000020000000000000009",
"",
" full backup: 20250505-153628F",
" timestamp start/stop: 2025-05-05 15:36:28+00 / 2025-05-05 15:36:29+00",
" wal start/stop: 000000020000000000000008 / 000000020000000000000009",
" lsn start/stop: 0/8000028 / 0/9000050",
" database size: 22.0MB, database backup size: 22.0MB",
" repo1: backup size: 2.9MB",
" database list: postgres (5)",
" annotation(s)",
" new_key: new_value",
" source: demo backup"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20250505-153608F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 975 lines of output]",
"P00 INFO: repo1: remove expired backup 20250505-153625F",
"P00 DETAIL: repo1: 16-1 archive retention on backup 20250505-153628F, start = 000000020000000000000008",
"P00 INFO: repo1: 16-1 remove archive, start = 000000020000000000000007, stop = 000000020000000000000007",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-153631F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire full backup set 20250505-153608F|archive retention on backup 20250505-153631F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 11 lines of output]",
"P00 INFO: repo1: expire full backup 20250505-153628F",
"P00 INFO: repo1: remove expired backup 20250505-153628F",
"P00 INFO: repo1: 16-1 remove archive, start = 000000020000000000000008, stop = 00000002000000000000000A",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "1"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=1",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-153633F_20250505-153636D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire diff backup set 20250505-153633F_20250505-153636D"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 10 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=874-b831e96e --log-level-console=info --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-diff=1 --repo1-retention-full=2 --stanza=demo",
"P00 INFO: repo1: expire diff backup set 20250505-153633F_20250505-153636D, 20250505-153633F_20250505-153638I",
"P00 INFO: repo1: remove expired backup 20250505-153633F_20250505-153638I",
"P00 INFO: repo1: remove expired backup 20250505-153633F_20250505-153636D",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-153633F_20250505-153640D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_wal(); \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_wal();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"new backup label"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 6 lines of output]",
"P00 INFO: backup stop archive = 000000020000000000000017, lsn = 0/17000050",
"P00 INFO: check archive for segment(s) 000000020000000000000016:000000020000000000000017",
"P00 INFO: new backup label = 20250505-153633F_20250505-153643D",
"P00 INFO: diff backup size = 8.3KB, file total = 963",
"P00 INFO: backup command end: completed successfully",
" [filtered 2 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-153633F_20250505-153643D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=detail \\",
" --repo1-retention-archive-type=diff --repo1-retention-archive=1 expire"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20250505-153633F_20250505-153640D|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: expire command begin 2.55.1: --exec-id=950-c6af69bb --log-level-console=detail --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-archive=1 --repo1-retention-archive-type=diff --repo1-retention-diff=2 --repo1-retention-full=2 --stanza=demo",
"P00 DETAIL: repo1: 16-1 archive retention on backup 20250505-153631F, start = 00000002000000000000000B, stop = 00000002000000000000000B",
"P00 DETAIL: repo1: 16-1 archive retention on backup 20250505-153633F, start = 00000002000000000000000C, stop = 00000002000000000000000D",
"P00 DETAIL: repo1: 16-1 archive retention on backup 20250505-153633F_20250505-153640D, start = 000000020000000000000012, stop = 000000020000000000000013",
"P00 DETAIL: repo1: 16-1 archive retention on backup 20250505-153633F_20250505-153643D, start = 000000020000000000000016",
"P00 INFO: repo1: 16-1 remove archive, start = 00000002000000000000000E, stop = 000000020000000000000011",
"P00 INFO: repo1: 16-1 remove archive, start = 000000020000000000000014, stop = 000000020000000000000015",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --log-level-console=detail restore"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"demo\\/PG_VERSION - exists and matches backup|remove invalid files|rename global\\/pg_control"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 DETAIL: check '/var/lib/postgresql/16/demo' exists",
"P00 DETAIL: remove 'global/pg_control' so cluster will not start if restore does not complete",
"P00 INFO: remove invalid files/links/paths from '/var/lib/postgresql/16/demo'",
"P00 DETAIL: remove invalid file '/var/lib/postgresql/16/demo/backup_label.old'",
"P00 DETAIL: remove invalid file '/var/lib/postgresql/16/demo/base/1/pg_internal.init'",
" [filtered 13 lines of output]",
"P00 DETAIL: remove invalid file '/var/lib/postgresql/16/demo/postmaster.opts'",
"P01 DETAIL: restore file /var/lib/postgresql/16/demo/backup_label (260B, 0.00%) checksum ad24e14059cb8ecf184023253f8b5fca6f14af04",
"P01 DETAIL: restore file /var/lib/postgresql/16/demo/PG_VERSION - exists and matches backup (bundle 20250505-153633F/1/0, 3B, 0.00%) checksum 3596ea087bfdaf52380eae441077572ed289d657",
"P01 DETAIL: restore file /var/lib/postgresql/16/demo/pg_multixact/members/0000 - exists and matches backup (bundle 20250505-153633F/1/24, 8KB, 0.04%) checksum 0631457264ff7f8d5fb1edc2c0211992a67c73e6",
"P01 DETAIL: restore file /var/lib/postgresql/16/demo/global/pg_filenode.map - exists and matches backup (bundle 20250505-153633F/1/64, 524B, 0.04%) checksum 3de878cf56cdb80345e88da11f91bc6d46f9f804",
" [filtered 988 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test2;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test1_table (id int); \\",
" insert into test1_table (id) values (1);\" test1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE TABLE",
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test2_table (id int); \\",
" insert into test2_table (id) values (2);\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE TABLE",
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select oid from pg_database where datname = 'test1'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"32768"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/postgresql/16/demo/base/32768"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"7.4M\t/var/lib/postgresql/16/demo/base/32768"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-153633F_20250505-153651I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --set=20250505-153633F_20250505-153651I info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"database list"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 12 lines of output]",
" repo1: backup size: 2.0MB",
" backup reference list: 20250505-153633F, 20250505-153633F_20250505-153643D",
" database list: postgres (5), test1 (32768), test2 (32769)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --db-include=test2 --type=immediate --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test2_table;\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" id ",
"----",
" 2",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test1_table;\" test1"
],
"err-expect" : "2",
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"relation mapping file.*contains invalid data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"psql: error: connection to server on socket \"/var/run/postgresql/.s.PGSQL.5432\" failed: FATAL: relation mapping file \"base/32768/pg_filenode.map\" contains invalid data"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/postgresql/16/demo/base/32768"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"8.0K\t/var/lib/postgresql/16/demo/base/32768"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"drop database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"DROP DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select oid, datname from pg_database order by oid;\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"test2"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" oid | datname ",
"-------+-----------",
" 1 | template1",
" 4 | template0",
" 5 | postgres",
" 32769 | test2",
"(4 rows)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" create table important_table (message text); \\",
" insert into important_table values ('Important Data'); \\",
" commit; \\",
" select * from important_table;\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 4 lines of output]",
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select current_timestamp\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"2025-05-05 15:37:03.157376+00"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" drop table important_table; \\",
" commit; \\",
" select * from important_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"BEGIN",
"DROP TABLE",
"COMMITERROR: relation \"important_table\" does not exist",
"LINE 1: ...le important_table; commit; select * from important_...",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-153633F_20250505-153704I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"20250505-153633F_20250505-153704I"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 38 lines of output]",
" backup reference total: 1 full, 1 diff",
"",
" incr backup: 20250505-153633F_20250505-153704I",
" timestamp start/stop: 2025-05-05 15:37:04+00 / 2025-05-05 15:37:05+00",
" wal start/stop: 00000004000000000000001A / 00000004000000000000001A",
" [filtered 2 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --set=20250505-153633F_20250505-153704I --target-timeline=current \\",
" --type=time \"--target=2025-05-05 15:37:03.157376+00\" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/log/postgresql/postgresql-16-demo.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery ended before configured recovery target was reached"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 13 lines of output]",
"LOG: database system is ready to accept read-only connections",
"LOG: redo done at 0/1A000100 system usage: CPU: user: 0.00 s, system: 0.00 s, elapsed: 0.02 s",
"FATAL: recovery ended before configured recovery target was reached",
"LOG: startup process (PID 1321) exited with exit code 1",
"LOG: terminating any other active server processes",
"LOG: database system is shut down"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --type=time \"--target=2025-05-05 15:37:03.157376+00\" \\",
" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/log/postgresql/postgresql-16-demo.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/postgresql/16/demo/postgresql.auto.conf"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery_target_time"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 9 lines of output]",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:37:08",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"recovery_target_time = '2025-05-05 15:37:03.157376+00'",
"recovery_target_action = 'promote'"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/postgresql/postgresql-16-demo.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery stopping before|last completed transaction|starting point-in-time recovery"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 4 lines of output]",
"LOG: database system was interrupted; last known up at 2025-05-05 15:36:52 UTC",
"LOG: restored log file \"00000004.history\" from archive",
"LOG: starting point-in-time recovery to 2025-05-05 15:37:03.157376+00",
"LOG: starting backup recovery with redo LSN 0/19000028, checkpoint LSN 0/19000060, on timeline ID 3",
"LOG: restored log file \"00000004.history\" from archive",
" [filtered 5 lines of output]",
"LOG: database system is ready to accept read-only connections",
"LOG: restored log file \"00000004000000000000001A\" from archive",
"LOG: recovery stopping before commit of transaction 740, time 2025-05-05 15:37:04.47197+00",
"LOG: redo done at 0/19026050 system usage: CPU: user: 0.00 s, system: 0.01 s, elapsed: 0.07 s",
"LOG: last completed transaction was at log time 2025-05-05 15:37:01.902745+00",
"LOG: restored log file \"000000040000000000000019\" from archive",
"LOG: selected new timeline ID: 5",
" [filtered 5 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stop"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stop command begin 2.55.1: --exec-id=1443-49e13bce --log-level-console=info --no-log-timestamp --stanza=demo",
"P00 INFO: stop command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=1 \\",
" --log-level-console=info stanza-delete"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-delete command begin 2.55.1: --exec-id=1450-c989c5ff --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo=1 --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-delete command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo2-azure-account" : {
"value" : "pgbackrest"
},
"repo2-azure-container" : {
"value" : "demo-container"
},
"repo2-azure-key" : {
"value" : "YXpLZXk="
},
"repo2-path" : {
"value" : "/demo-repo"
},
"repo2-retention-full" : {
"value" : "4"
},
"repo2-type" : {
"value" : "azure"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo2-azure-account=pgbackrest",
"repo2-azure-container=demo-container",
"repo2-azure-key=YXpLZXk=",
"repo2-path=/demo-repo",
"repo2-retention-full=4",
"repo2-type=azure",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo \"172.17.0.2 pgbackrest.blob.core.windows.net\" | tee -a /etc/hosts"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres bash -c 'export AZURE_CLI_DISABLE_CONNECTION_VERIFICATION=1;az storage container create -n demo-container \\",
" --connection-string \"DefaultEndpointsProtocol=https;AccountName=pgbackrest;AccountKey=YXpLZXk=\" \\",
" 2>&1'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.55.1: --exec-id=1521-8d36a4a8 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo2-type=azure --stanza=demo",
"P00 INFO: stanza-create for stanza 'demo' on repo1",
"P00 INFO: stanza-create for stanza 'demo' on repo2",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=2 \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.55.1: --exec-id=1529-81f60a40 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo=2 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-block --repo1-bundle --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo2-type=azure --stanza=demo --start-fast",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000005000000000000001B, lsn = 0/1B000028",
" [filtered 3 lines of output]",
"P00 INFO: check archive for segment(s) 00000005000000000000001B:00000005000000000000001B",
"P00 INFO: new backup label = 20250505-153719F",
"P00 INFO: full backup size = 29.1MB, file total = 1265",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=1529-81f60a40 --log-level-console=info --no-log-timestamp --repo=2 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo2-type=azure --stanza=demo"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo3-path" : {
"value" : "/demo-repo"
},
"repo3-retention-full" : {
"value" : "4"
},
"repo3-s3-bucket" : {
"value" : "demo-bucket"
},
"repo3-s3-endpoint" : {
"value" : "s3.us-east-1.amazonaws.com"
},
"repo3-s3-key" : {
"value" : "accessKey1"
},
"repo3-s3-key-secret" : {
"value" : "verySecretKey1"
},
"repo3-s3-region" : {
"value" : "us-east-1"
},
"repo3-type" : {
"value" : "s3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo2-azure-account=pgbackrest",
"repo2-azure-container=demo-container",
"repo2-azure-key=YXpLZXk=",
"repo2-path=/demo-repo",
"repo2-retention-full=4",
"repo2-type=azure",
"repo3-path=/demo-repo",
"repo3-retention-full=4",
"repo3-s3-bucket=demo-bucket",
"repo3-s3-endpoint=s3.us-east-1.amazonaws.com",
"repo3-s3-key=accessKey1",
"repo3-s3-key-secret=verySecretKey1",
"repo3-s3-region=us-east-1",
"repo3-type=s3",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo \"172.17.0.3 demo-bucket.s3.us-east-1.amazonaws.com s3.us-east-1.amazonaws.com\" | tee -a /etc/hosts"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc --insecure alias set s3 https://127.0.0.1 accessKey1 verySecretKey1"
],
"host" : "s3-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc --insecure mb --with-versioning s3/demo-bucket"
],
"host" : "s3-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 4 lines of output]",
"P00 INFO: stanza 'demo' already exists on repo2 and is valid",
"P00 INFO: stanza-create for stanza 'demo' on repo3",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.55.1: --exec-id=1577-45157b4a --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo=3 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-block --repo1-bundle --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo3-retention-full=4 --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo2-type=azure --repo3-type=s3 --stanza=demo --start-fast",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000005000000000000001C, lsn = 0/1C000028",
" [filtered 3 lines of output]",
"P00 INFO: check archive for segment(s) 00000005000000000000001C:00000005000000000000001D",
"P00 INFO: new backup label = 20250505-153728F",
"P00 INFO: full backup size = 29.1MB, file total = 1265",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=1577-45157b4a --log-level-console=info --no-log-timestamp --repo=3 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo3-retention-full=4 --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo2-type=azure --repo3-type=s3 --stanza=demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select date_trunc('seconds', current_timestamp)\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"2025-05-05 15:37:33+00"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"process-max" : {
"value" : "4"
},
"repo4-bundle" : {
"value" : "y"
},
"repo4-path" : {
"value" : "/demo-repo"
},
"repo4-sftp-host" : {
"value" : "sftp-server"
},
"repo4-sftp-host-key-hash-type" : {
"value" : "sha1"
},
"repo4-sftp-host-user" : {
"value" : "pgbackrest"
},
"repo4-sftp-private-key-file" : {
"value" : "/var/lib/postgresql/.ssh/id_rsa_sftp"
},
"repo4-sftp-public-key-file" : {
"value" : "/var/lib/postgresql/.ssh/id_rsa_sftp.pub"
},
"repo4-type" : {
"value" : "sftp"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"process-max=4",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo2-azure-account=pgbackrest",
"repo2-azure-container=demo-container",
"repo2-azure-key=YXpLZXk=",
"repo2-path=/demo-repo",
"repo2-retention-full=4",
"repo2-type=azure",
"repo3-path=/demo-repo",
"repo3-retention-full=4",
"repo3-s3-bucket=demo-bucket",
"repo3-s3-endpoint=s3.us-east-1.amazonaws.com",
"repo3-s3-key=accessKey1",
"repo3-s3-key-secret=verySecretKey1",
"repo3-s3-region=us-east-1",
"repo3-type=s3",
"repo4-bundle=y",
"repo4-path=/demo-repo",
"repo4-sftp-host=sftp-server",
"repo4-sftp-host-key-hash-type=sha1",
"repo4-sftp-host-user=pgbackrest",
"repo4-sftp-private-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp",
"repo4-sftp-public-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp.pub",
"repo4-type=sftp",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/postgresql/.ssh"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/postgresql/.ssh/id_rsa_sftp \\",
" -t rsa -b 4096 -N \"\" -m PEM"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"id -u pgbackrest > /dev/null 2>&1 || adduser --disabled-password --gecos \"\" pgbackrest"
],
"host" : "sftp-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mkdir -m 750 -p /demo-repo && chown pgbackrest /demo-repo"
],
"host" : "sftp-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest mkdir -m 750 -p /home/pgbackrest/.ssh"
],
"host" : "sftp-server",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(sudo ssh root@pg-primary cat /var/lib/postgresql/.ssh/id_rsa_sftp.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "sftp-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"ssh-keyscan -H sftp-server >> /var/lib/postgresql/.ssh/known_hosts 2>/dev/null"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "postgres"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 6 lines of output]",
"P00 INFO: stanza 'demo' already exists on repo3 and is valid",
"P00 INFO: stanza-create for stanza 'demo' on repo4",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=4 \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.55.1: --exec-id=1656-747a1781 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --process-max=4 --repo=4 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-block --repo1-bundle --repo4-bundle --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo4-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo3-retention-full=4 --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo4-sftp-host=sftp-server --repo4-sftp-host-key-hash-type=sha1 --repo4-sftp-host-user=pgbackrest --repo4-sftp-private-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp --repo4-sftp-public-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp.pub --repo2-type=azure --repo3-type=s3 --repo4-type=sftp --stanza=demo --start-fast",
"P00 WARN: option 'repo4-retention-full' is not set for 'repo4-retention-full-type=count', the repository may run out of space",
" HINT: to retain full backups indefinitely (without warning), set option 'repo4-retention-full' to the maximum.",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000005000000000000001E, lsn = 0/1E000028",
" [filtered 3 lines of output]",
"P00 INFO: check archive for segment(s) 00000005000000000000001E:00000005000000000000001F",
"P00 INFO: new backup label = 20250505-153736F",
"P00 INFO: full backup size = 29.1MB, file total = 1265",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=1656-747a1781 --log-level-console=info --no-log-timestamp --repo=4 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo4-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo3-retention-full=4 --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo4-sftp-host=sftp-server --repo4-sftp-host-key-hash-type=sha1 --repo4-sftp-host-user=pgbackrest --repo4-sftp-private-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp --repo4-sftp-public-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp.pub --repo2-type=azure --repo3-type=s3 --repo4-type=sftp --stanza=demo",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo5-gcs-bucket" : {
"value" : "demo-bucket"
},
"repo5-gcs-key" : {
"value" : "/etc/pgbackrest/gcs-key.json"
},
"repo5-path" : {
"value" : "/demo-repo"
},
"repo5-type" : {
"value" : "gcs"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"process-max=4",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo2-azure-account=pgbackrest",
"repo2-azure-container=demo-container",
"repo2-azure-key=YXpLZXk=",
"repo2-path=/demo-repo",
"repo2-retention-full=4",
"repo2-type=azure",
"repo3-path=/demo-repo",
"repo3-retention-full=4",
"repo3-s3-bucket=demo-bucket",
"repo3-s3-endpoint=s3.us-east-1.amazonaws.com",
"repo3-s3-key=accessKey1",
"repo3-s3-key-secret=verySecretKey1",
"repo3-s3-region=us-east-1",
"repo3-type=s3",
"repo4-bundle=y",
"repo4-path=/demo-repo",
"repo4-sftp-host=sftp-server",
"repo4-sftp-host-key-hash-type=sha1",
"repo4-sftp-host-user=pgbackrest",
"repo4-sftp-private-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp",
"repo4-sftp-public-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp.pub",
"repo4-type=sftp",
"repo5-gcs-bucket=demo-bucket",
"repo5-gcs-key=/etc/pgbackrest/gcs-key.json",
"repo5-path=/demo-repo",
"repo5-type=gcs",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 stanza-delete"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"missing stanza data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: error (missing stanza data)",
" cipher: none"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc ls --versions s3/demo-bucket/demo-repo/backup/demo/backup.info"
],
"cmd-extra" : "--insecure",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup\\.info$"
]
},
"host" : "s3-server",
"load-env" : true,
"output" : true,
"run-as-user" : "root"
},
"type" : "exe",
"value" : {
"output" : [
"[2025-05-05 15:37:42 UTC] 0B STANDARD 4b8a6087-660b-4454-b54b-f23b4c99166d v3 DEL backup.info",
"[2025-05-05 15:37:33 UTC] 1.0KiB STANDARD ff3f0b2c-36f0-4a39-bd98-95e231304bf7 v2 PUT backup.info",
"[2025-05-05 15:37:27 UTC] 372B STANDARD 3665e998-7670-4201-be92-72f1f448dbea v1 PUT backup.info",
"[2025-05-05 15:37:42 UTC] 0B STANDARD 15063baa-a307-498c-95df-0c2c6c0e74f6 v3 DEL backup.info.copy",
"[2025-05-05 15:37:33 UTC] 1.0KiB STANDARD 487bbb33-04f6-4b6d-81d7-84bb3521b2f5 v2 PUT backup.info.copy"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 \\",
" --repo-target-time=\"2025-05-05 15:37:33+00\" info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"full backup"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 5 lines of output]",
" wal archive min/max (16): 00000005000000000000001C/00000005000000000000001D",
"",
" full backup: 20250505-153728F",
" timestamp start/stop: 2025-05-05 15:37:28+00 / 2025-05-05 15:37:33+00",
" wal start/stop: 00000005000000000000001C / 00000005000000000000001D",
" repo3: backup set size: 3.9MB, backup size: 3.9MB"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 --delta \\",
" --repo-target-time=\"2025-05-05 15:37:33+00\" --log-level-console=info restore"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" restore backup set "
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: restore command begin 2.55.1: --delta --exec-id=1733-c6bc056e --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --process-max=4 --repo=3 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo5-gcs-bucket=demo-bucket --repo5-gcs-key= --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo4-path=/demo-repo --repo5-path=/demo-repo --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo4-sftp-host=sftp-server --repo4-sftp-host-key-hash-type=sha1 --repo4-sftp-host-user=pgbackrest --repo4-sftp-private-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp --repo4-sftp-public-key-file=/var/lib/postgresql/.ssh/id_rsa_sftp.pub --repo-target-time=\"2025-05-05 15:37:33+00\" --repo2-type=azure --repo3-type=s3 --repo4-type=sftp --repo5-type=gcs --stanza=demo",
"P00 INFO: repo3: restore backup set 20250505-153728F, recovery will start at 2025-05-05 15:37:28",
"P00 INFO: remove invalid files/links/paths from '/var/lib/postgresql/16/demo'",
"P00 INFO: write updated /var/lib/postgresql/16/demo/postgresql.auto.conf",
" [filtered 2 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "repo1",
"image" : "pgbackrest/doc:debian",
"name" : "repository",
"option" : "-m 512m",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.7"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo adduser --disabled-password --gecos \"\" pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install postgresql-client libxml2 libssh2-1"
],
"cmd-extra" : "-y 2>&1",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest mkdir -m 750 /home/pgbackrest/.ssh"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh-keygen -f /home/pgbackrest/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/postgresql/.ssh"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/postgresql/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@pg-primary cat /var/lib/postgresql/.ssh/id_rsa.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@repository cat /home/pgbackrest/.ssh/id_rsa.pub) | \\",
" sudo -u postgres tee -a /var/lib/postgresql/.ssh/authorized_keys"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh postgres@pg-primary"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh pgbackrest@repository"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-host" : {
"value" : "pg-primary"
},
"pg1-path" : {
"value" : "/var/lib/postgresql/16/demo"
}
},
"global" : {
"log-timestamp" : {
"value" : "n"
},
"repo1-retention-full" : {
"value" : "2"
},
"start-fast" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/16/demo"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
}
}
},
"reset" : true
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo stanza-create"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: no prior backup exists, incr backup has been changed to full"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"process-max" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"timestamp start/stop"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: none",
"",
" db (current)",
" wal archive min/max (16): 000000070000000000000023/000000070000000000000025",
"",
" full backup: 20250505-153818F",
" timestamp start/stop: 2025-05-05 15:38:18+00 / 2025-05-05 15:38:21+00",
" wal start/stop: 000000070000000000000023 / 000000070000000000000023",
" database size: 29.1MB, database backup size: 29.1MB",
" repo1: backup set size: 3.9MB, backup size: 3.9MB",
"",
" full backup: 20250505-153823F",
" timestamp start/stop: 2025-05-05 15:38:23+00 / 2025-05-05 15:38:28+00",
" wal start/stop: 000000070000000000000024 / 000000070000000000000025",
" database size: 29.1MB, database backup size: 29.1MB",
" repo1: backup set size: 3.9MB, backup size: 3.9MB"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for all stanzas"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg1: [StopError] raised from remote-0 ssh protocol on 'pg-primary': stop file exists for all stanzas",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed",
" HINT: are all available clusters in recovery?"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: stop file already exists for all stanzas"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for stanza demo"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg1: [StopError] raised from remote-0 ssh protocol on 'pg-primary': stop file exists for stanza demo",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed",
" HINT: are all available clusters in recovery?"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg2",
"image" : "pgbackrest/doc:debian",
"name" : "pg-standby",
"option" : "-m 512m",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.8"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install postgresql-client libxml2 libssh2-1"
],
"cmd-extra" : "-y 2>&1",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/postgresql/.ssh"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/postgresql/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@pg-standby cat /var/lib/postgresql/.ssh/id_rsa.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@repository cat /home/pgbackrest/.ssh/id_rsa.pub) | \\",
" sudo -u postgres tee -a /var/lib/postgresql/.ssh/authorized_keys"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh postgres@pg-standby"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh pgbackrest@repository"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/16/demo"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_createcluster 16 demo"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/postgresql/16/demo/postgresql.auto.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Do not edit this file manually!",
"# It will be overwritten by the ALTER SYSTEM command.",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:36:15",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:36:45",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:37:08",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"# Removed by pgBackRest restore on 2025-05-05 15:37:46 # recovery_target_time = '2025-05-05 15:37:03.157376+00'",
"# Removed by pgBackRest restore on 2025-05-05 15:37:46 # recovery_target_action = 'promote'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:37:46",
"restore_command = 'pgbackrest --repo=3 --repo-target-time=\"2025-05-05 15:37:33+00\" --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:38:11",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:38:43",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cat /root/postgresql.common.conf >> /etc/postgresql/16/demo/postgresql.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/postgresql/16/demo/postgresql.conf",
"host" : "pg-standby",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"hot_standby" : {
"value" : "on"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"hot_standby = on",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/log/postgresql/postgresql-16-demo.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/postgresql/postgresql-16-demo.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"entering standby mode|database system is ready to accept read only connections"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 3 lines of output]",
"LOG: listening on Unix socket \"/var/run/postgresql/.s.PGSQL.5432\"",
"LOG: database system was interrupted; last known up at 2025-05-05 15:38:23 UTC",
"LOG: entering standby mode",
"LOG: starting backup recovery with redo LSN 0/24000028, checkpoint LSN 0/24000060, on timeline ID 7",
"LOG: restored log file \"00000007.history\" from archive",
" [filtered 6 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table replicated_table (message text); \\",
" insert into replicated_table values ('Important Data'); \\",
" commit; \\",
" select * from replicated_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 4 lines of output]",
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from replicated_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"replicated_table\" does not exist",
"LINE 1: select * from replicated_table;",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select *, current_timestamp from pg_switch_wal()\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" pg_switch_wal | current_timestamp ",
"---------------+-------------------------------",
" 0/2601A838 | 2025-05-05 15:38:50.596767+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from replicated_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | current_timestamp ",
"----------------+-------------------------------",
" Important Data | 2025-05-05 15:38:56.632927+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"because this is a standby"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=586-efbb5ee1 --log-level-console=info --log-level-file=detail --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo1-host=repository --stanza=demo",
"P00 INFO: check repo1 (standby)",
"P00 INFO: switch wal not performed because this is a standby",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" create user replicator password 'jw8s0F4' replication\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"host replication replicator 172.17.0.8/32 md5\" \\",
" >> /etc/postgresql/16/demo/pg_hba.conf'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo reload"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"recovery-option" : {
"value" : "primary_conninfo=host=172.17.0.6 port=5432 user=replicator"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"recovery-option=primary_conninfo=host=172.17.0.6 port=5432 user=replicator",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"172.17.0.6:*:replication:replicator:jw8s0F4\" \\",
" >> /var/lib/postgresql/.pgpass'"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres chmod 600 /var/lib/postgresql/.pgpass"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/postgresql/16/demo/postgresql.auto.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Do not edit this file manually!",
"# It will be overwritten by the ALTER SYSTEM command.",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:36:15",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:36:45",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:37:08",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"# Removed by pgBackRest restore on 2025-05-05 15:37:46 # recovery_target_time = '2025-05-05 15:37:03.157376+00'",
"# Removed by pgBackRest restore on 2025-05-05 15:37:46 # recovery_target_action = 'promote'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:37:46",
"restore_command = 'pgbackrest --repo=3 --repo-target-time=\"2025-05-05 15:37:33+00\" --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:38:11",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:38:59",
"primary_conninfo = 'host=172.17.0.6 port=5432 user=replicator'",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/log/postgresql/postgresql-16-demo.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo start"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/postgresql/postgresql-16-demo.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"started streaming WAL from primary"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 13 lines of output]",
"LOG: consistent recovery state reached at 0/25000088",
"LOG: database system is ready to accept read-only connections",
"LOG: started streaming WAL from primary at 0/27000000 on timeline 7"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table stream_table (message text); \\",
" insert into stream_table values ('Important Data'); \\",
" commit; \\",
" select *, current_timestamp from stream_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 4 lines of output]",
" message | current_timestamp ",
"----------------+-------------------------------",
" Important Data | 2025-05-05 15:39:06.086007+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from stream_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | current_timestamp ",
"----------------+-------------------------------",
" Important Data | 2025-05-05 15:39:06.483319+00",
"(1 row)"
]
}
},
{
"key" : {
"id" : "pgalt",
"image" : "pgbackrest/doc:debian",
"name" : "pg-alt",
"option" : "-m 512m",
"os" : "debian",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.9"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo apt-get install postgresql-client libxml2 libssh2-1"
],
"cmd-extra" : "-y 2>&1",
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/postgresql/.ssh"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/postgresql/.ssh/id_rsa \\",
" -t rsa -b 4096 -N \"\""
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@pg-alt cat /var/lib/postgresql/.ssh/id_rsa.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(echo -n 'no-agent-forwarding,no-X11-forwarding,no-port-forwarding,' && \\",
" echo -n 'command=\"/usr/bin/pgbackrest ${SSH_ORIGINAL_COMMAND#* }\" ' && \\",
" sudo ssh root@repository cat /home/pgbackrest/.ssh/id_rsa.pub) | \\",
" sudo -u postgres tee -a /var/lib/postgresql/.ssh/authorized_keys"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest ssh postgres@pg-alt"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh pgbackrest@repository"
],
"cmd-extra" : "-o StrictHostKeyChecking=no",
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-alt",
"option" : {
"demo-alt" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/16/demo"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo-alt]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo-alt" : {
"pg1-host" : {
"value" : "pg-alt"
},
"pg1-path" : {
"value" : "/var/lib/postgresql/16/demo"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[demo-alt]",
"pg1-host=pg-alt",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/lib/postgresql/16/bin/initdb \\",
" -D /var/lib/postgresql/16/demo -k -A peer"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_createcluster 16 demo"
],
"host" : "pg-alt",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"Configuring already existing cluster (configuration: /etc/postgresql/16/demo, data: /var/lib/postgresql/16/demo, owner: 102:103)",
"Ver Cluster Port Status Owner Data directory Log file",
"16 demo 5432 down postgres /var/lib/postgresql/16/demo /var/log/postgresql/postgresql-16-demo.log"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cat /root/postgresql.common.conf >> /etc/postgresql/16/demo/postgresql.conf"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/postgresql/16/demo/postgresql.conf",
"host" : "pg-alt",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo-alt archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo-alt archive-push %p'",
"archive_mode = on",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo restart"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo-alt --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-alt",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.55.1: --exec-id=350-5f466612 --log-level-console=info --log-level-file=detail --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo1-host=repository --stanza=demo-alt",
"P00 INFO: stanza-create for stanza 'demo-alt' on repo1",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"check stanza | successfully archived to "
]
},
"host" : "pg-alt",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=359-3c8eb968 --log-level-console=info --log-level-file=detail --no-log-timestamp --repo1-host=repository",
"P00 INFO: check stanza 'demo-alt'",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 000000010000000000000001 successfully archived to '/var/lib/pgbackrest/archive/demo-alt/16-1/0000000100000000/000000010000000000000001-d7ba3d079e9c0ecc7d33e16d7b45a0a2f58adc95.gz' on repo1",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"check stanza | successfully archived to "
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=1241-54620747 --log-level-console=info --no-log-timestamp --repo1-path=/var/lib/pgbackrest",
"P00 INFO: check stanza 'demo'",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 000000070000000000000027 successfully archived to '/var/lib/pgbackrest/archive/demo/16-1/0000000700000000/000000070000000000000027-14a933858863107b129b7f0e18a08d88ef43be6a.gz' on repo1",
"P00 INFO: check stanza 'demo-alt'",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 000000010000000000000002 successfully archived to '/var/lib/pgbackrest/archive/demo-alt/16-1/0000000100000000/000000010000000000000002-c47a526be6ff2c84659563d1bb7e1b73eac35985.gz' on repo1",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/16/demo",
"recovery-option=primary_conninfo=host=172.17.0.6 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'bogus'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo restart"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm -f /var/log/pgbackrest/demo-archive-push-async.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"WAL segment"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=2341-bdea8c52 --log-level-console=info --log-level-file=detail --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --repo1-host=repository --stanza=demo",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 00000007000000000000002D successfully archived to '/var/lib/pgbackrest/archive/demo/16-1/0000000700000000/00000007000000000000002D-7d798d0ab5870d10a755a412464de99fb662b910.gz' on repo1",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-push-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" WAL file\\(s\\) to archive|pushed WAL file \\'0000000"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.55.1: [/var/lib/postgresql/16/demo/pg_wal] --archive-async --exec-id=2327-27143da5 --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 1 WAL file(s) to archive: 000000070000000000000028",
"P01 DETAIL: pushed WAL file '000000070000000000000028' to the archive",
"P00 INFO: archive-push:async command end: completed successfully",
"",
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.55.1: [/var/lib/postgresql/16/demo/pg_wal] --archive-async --exec-id=2345-a01809d1 --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 5 WAL file(s) to archive: 000000070000000000000029...00000007000000000000002D",
"P02 DETAIL: pushed WAL file '00000007000000000000002A' to the archive",
"P01 DETAIL: pushed WAL file '000000070000000000000029' to the archive",
"P02 DETAIL: pushed WAL file '00000007000000000000002B' to the archive",
"P01 DETAIL: pushed WAL file '00000007000000000000002C' to the archive",
"P02 DETAIL: pushed WAL file '00000007000000000000002D' to the archive",
"P00 INFO: archive-push:async command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 5"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-get-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"found [0-F]{24} in the .* archive"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-get:async command begin 2.55.1: [000000070000000000000024, 000000070000000000000025, 000000070000000000000026, 000000070000000000000027, 000000070000000000000028, 000000070000000000000029, 00000007000000000000002A, 00000007000000000000002B] --archive-async --exec-id=790-af06cf41 --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000070000000000000024...00000007000000000000002B",
"P02 DETAIL: found 000000070000000000000025 in the repo1: 16-1 archive",
"P01 DETAIL: found 000000070000000000000024 in the repo1: 16-1 archive",
"P02 DETAIL: found 000000070000000000000026 in the repo1: 16-1 archive",
"P01 DETAIL: found 000000070000000000000027 in the repo1: 16-1 archive",
"P00 DETAIL: unable to find 000000070000000000000028 in the archive",
"P00 INFO: archive-get:async command end: completed successfully",
" [filtered 14 lines of output]",
"P00 INFO: archive-get:async command begin 2.55.1: [000000070000000000000028, 000000070000000000000029, 00000007000000000000002A, 00000007000000000000002B, 00000007000000000000002C, 00000007000000000000002D, 00000007000000000000002E, 00000007000000000000002F] --archive-async --exec-id=833-0b7bea8c --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000070000000000000028...00000007000000000000002F",
"P01 DETAIL: found 000000070000000000000028 in the repo1: 16-1 archive",
"P02 DETAIL: found 000000070000000000000029 in the repo1: 16-1 archive",
"P01 DETAIL: found 00000007000000000000002A in the repo1: 16-1 archive",
"P00 DETAIL: unable to find 00000007000000000000002B in the archive",
"P00 INFO: archive-get:async command end: completed successfully",
" [filtered 2 lines of output]",
"P00 INFO: archive-get:async command begin 2.55.1: [00000007000000000000002B, 00000007000000000000002C, 00000007000000000000002D, 00000007000000000000002E, 00000007000000000000002F, 000000070000000000000030, 000000070000000000000031, 000000070000000000000032] --archive-async --exec-id=846-ea70e4e6 --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/postgresql/16/demo --process-max=2 --repo1-host=repository --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 00000007000000000000002B...000000070000000000000032",
"P02 DETAIL: found 00000007000000000000002C in the repo1: 16-1 archive",
"P01 DETAIL: found 00000007000000000000002B in the repo1: 16-1 archive",
"P02 DETAIL: found 00000007000000000000002D in the repo1: 16-1 archive",
"P00 DETAIL: unable to find 00000007000000000000002E in the archive",
"P00 INFO: archive-get:async command end: completed successfully",
" [filtered 17 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'jw8s0F4'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg2-host" : {
"value" : "pg-standby"
},
"pg2-path" : {
"value" : "/var/lib/postgresql/16/demo"
}
},
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/16/demo",
"pg2-host=pg-standby",
"pg2-path=/var/lib/postgresql/16/demo",
"",
"[demo-alt]",
"pg1-host=pg-alt",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup file pg-primary|replay on the standby"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000007000000000000002F, lsn = 0/2F000028",
"P00 INFO: wait for replay on the standby to reach 0/2F000028",
"P00 INFO: replay on the standby reached 0/2F000028",
"P00 INFO: check archive for prior segment 00000007000000000000002E",
"P01 DETAIL: backup file pg-primary:/var/lib/postgresql/16/demo/global/pg_control (8KB, 0.53%) checksum 20a516191e9d0ce661163067b70f348cd0c478e7",
"P01 DETAIL: match file from prior backup pg-primary:/var/lib/postgresql/16/demo/pg_logical/replorigin_checkpoint (8B, 0.53%) checksum 347fc8f2df71bd4436e38bd1516ccd7ea0d46532",
"P02 DETAIL: backup file pg-standby:/var/lib/postgresql/16/demo/base/5/1249 (464KB, 31.38%) checksum ad21eff1041d8672b2fbccf2b8e4af4c4d4cf7b2",
" [filtered 1278 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 16 demo stop"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/lib/postgresql/17/bin/initdb \\",
" -D /var/lib/postgresql/17/demo -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_createcluster 17 demo"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'cd /var/lib/postgresql && \\",
" /usr/lib/postgresql/17/bin/pg_upgrade \\",
" --old-bindir=/usr/lib/postgresql/16/bin \\",
" --new-bindir=/usr/lib/postgresql/17/bin \\",
" --old-datadir=/var/lib/postgresql/16/demo \\",
" --new-datadir=/var/lib/postgresql/17/demo \\",
" --old-options=\" -c config_file=/etc/postgresql/16/demo/postgresql.conf\" \\",
" --new-options=\" -c config_file=/etc/postgresql/17/demo/postgresql.conf\"'"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Upgrade Complete"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 40 lines of output]",
"Checking for extension updates ok",
"",
"Upgrade Complete",
"----------------",
"Optimizer statistics are not transferred by pg_upgrade.",
" [filtered 3 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cat /root/postgresql.common.conf >> /etc/postgresql/17/demo/postgresql.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/postgresql/17/demo/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/17/demo"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/17/demo",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/17/demo"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/postgresql/17/demo",
"recovery-option=primary_conninfo=host=172.17.0.6 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"spool-path=/var/spool/pgbackrest",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/postgresql/17/demo"
},
"pg2-path" : {
"value" : "/var/lib/postgresql/17/demo"
}
},
"global" : {
"backup-standby" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/17/demo",
"pg2-host=pg-standby",
"pg2-path=/var/lib/postgresql/17/demo",
"",
"[demo-alt]",
"pg1-host=pg-alt",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"backup-standby=n",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp /etc/postgresql/16/demo/pg_hba.conf \\",
" /etc/postgresql/17/demo/pg_hba.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --no-online \\",
" --log-level-console=info stanza-upgrade"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-upgrade command begin 2.55.1: --exec-id=2734-020283ec --log-level-console=info --log-level-file=detail --no-log-timestamp --no-online --pg1-path=/var/lib/postgresql/17/demo --repo1-host=repository --stanza=demo",
"P00 INFO: stanza-upgrade for stanza 'demo' on repo1",
"P00 INFO: stanza-upgrade command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 17 demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_lsclusters"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_dropcluster 16 demo"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_dropcluster 16 demo"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_createcluster 17 demo"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg2: [DbConnectError] raised from remote-0 ssh protocol on 'pg-standby': unable to connect to 'dbname='postgres' port=5432': connection to server on socket \"/var/run/postgresql/.s.PGSQL.5432\" failed: No such file or directory",
" \tIs the server running locally and accepting connections on that socket?"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/postgresql/17/demo/postgresql.conf",
"host" : "pg-standby",
"option" : {
"hot_standby" : {
"value" : "on"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"hot_standby = on"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo pg_ctlcluster 17 demo start"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-path=/var/lib/postgresql/17/demo",
"pg2-host=pg-standby",
"pg2-path=/var/lib/postgresql/17/demo",
"",
"[demo-alt]",
"pg1-host=pg-alt",
"pg1-path=/var/lib/postgresql/16/demo",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y"
]
}
}
]
}
},
"{\"os-type\":\"rhel\"}" : {
"all" : {
"user-guide" : [
{
"key" : {
"id" : "azure",
"image" : "mcr.microsoft.com/azure-storage/azurite",
"name" : "azure-server",
"option" : "-v {[host-repo-path]}/doc/resource/fake-cert/azure-server.crt:/root/public.crt:ro -v {[host-repo-path]}/doc/resource/fake-cert/azure-server.key:/root/private.key:ro -e AZURITE_ACCOUNTS='pgbackrest:YXpLZXk='",
"os" : "rhel",
"param" : "azurite-blob --blobPort 443 --blobHost 0.0.0.0 --cert=/root/public.crt --key=/root/private.key",
"update-hosts" : false
},
"type" : "host",
"value" : {
"ip" : "172.17.0.2"
}
},
{
"key" : {
"id" : "s3",
"image" : "minio/minio",
"name" : "s3-server",
"option" : "-v {[host-repo-path]}/doc/resource/fake-cert/s3-server.crt:/root/.minio/certs/public.crt:ro -v {[host-repo-path]}/doc/resource/fake-cert/s3-server.key:/root/.minio/certs/private.key:ro -e MINIO_REGION=us-east-1 -e MINIO_DOMAIN=s3.us-east-1.amazonaws.com -e MINIO_BROWSER=off -e MINIO_ACCESS_KEY=accessKey1 -e MINIO_SECRET_KEY=verySecretKey1",
"os" : "rhel",
"param" : "server /data --address :443",
"update-hosts" : false
},
"type" : "host",
"value" : {
"ip" : "172.17.0.3"
}
},
{
"key" : {
"id" : "sftp",
"image" : "pgbackrest/doc:rhel",
"name" : "sftp-server",
"os" : "rhel",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.4"
}
},
{
"key" : {
"id" : "build",
"image" : "pgbackrest/doc:rhel",
"name" : "build",
"os" : "rhel",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.5"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /build/pgbackrest-release-2.55.1"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp -r /pgbackrest/* /build/pgbackrest-release-2.55.1"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown -R vagrant /build"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install meson gcc postgresql13-devel openssl-devel \\",
" libxml2-devel lz4-devel libzstd-devel bzip2-devel libyaml-devel libssh2-devel"
],
"cmd-extra" : "-y 2>&1",
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"meson setup /build/pgbackrest /build/pgbackrest-release-2.55.1"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"ninja -C /build/pgbackrest"
],
"host" : "build",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg1",
"image" : "pgbackrest/doc:rhel",
"name" : "pg-primary",
"option" : "-m 512m",
"os" : "rhel",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.6"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs libssh2"
],
"cmd-extra" : "-y 2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.55.1 - General help",
"",
"Usage:",
" pgbackrest [options] [command]",
"",
"Commands:",
" annotate add or modify backup annotation",
" archive-get get a WAL segment from the archive",
" archive-push push a WAL segment to the archive",
" backup backup a database cluster",
" check check the configuration",
" expire expire backups that exceed retention",
" help get help",
" info retrieve information about backups",
" repo-get get a file from a repository",
" repo-ls list files in a repository",
" restore restore a database cluster",
" server pgBackRest server",
" server-ping ping pgBackRest server",
" stanza-create create the required stanza data",
" stanza-delete delete a stanza",
" stanza-upgrade upgrade a stanza",
" start allow pgBackRest processes to run",
" stop stop pgBackRest processes from running",
" verify verify contents of a repository",
" version get version",
"",
"Use 'pgbackrest help [command]' for more information."
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/pgsql-13/bin/initdb \\",
" -D /var/lib/pgsql/13/data -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cat /root/postgresql.common.conf >> /var/lib/pgsql/13/data/postgresql.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"file" : "/var/lib/pgsql/13/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"log_filename" : {
"value" : "'postgresql.log'"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"log_filename = 'postgresql.log'"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/13/data"
}
},
"global" : {
"log-timestamp" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres bash -c ' \\",
" export PGBACKREST_LOG_PATH=/path/set/by/env && \\",
" pgbackrest --log-level-console=error help backup log-path'"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"current\\: \\/path\\/set\\/by\\/env"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"pgBackRest 2.55.1 - 'backup' command - 'log-path' option help",
"",
"Path where log files are stored.",
"",
"The log path provides a location for pgBackRest to store log files. Note that",
"if log-level-file=off then no log path is required.",
"",
"current: /path/set/by/env",
"default: /var/log/pgbackrest"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/lib/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/13/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"log_filename = 'postgresql.log'",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl restart postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" create or replace function create_test_table(prefix int, scale int, data bool) returns void as \\$\\$ \\",
" declare \\",
" index int; \\",
" begin \\",
" for index in 1 .. scale loop \\",
" execute 'create table test_' || prefix || '_' || index || ' (id int)'; \\",
" \\",
" if data then \\",
" execute 'insert into test_' || prefix || '_' || index || ' values (' || (prefix * index) || ')'; \\",
" end if; \\",
" end loop; \\",
" end \\$\\$ LANGUAGE plpgsql;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global:archive-push" : {
"compress-level" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-cipher-pass" : {
"value" : "zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO"
},
"repo1-cipher-type" : {
"value" : "aes-256-cbc"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.55.1: --exec-id=1144-a6cb75c7 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-create for stanza 'demo' on repo1",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" successfully archived to "
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=1171-efe8fd39 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 000000010000000000000001 successfully archived to '/var/lib/pgbackrest/archive/demo/13-1/0000000100000000/000000010000000000000001-ccfaed8bf95406170361480900c17de474a073fc.gz' on repo1",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"start-fast" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.55.1: --exec-id=1241-ab2876e1 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo --start-fast",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 000000010000000000000002, lsn = 0/2000028",
" [filtered 3 lines of output]",
"P00 INFO: check archive for segment(s) 000000010000000000000002:000000010000000000000003",
"P00 INFO: new backup label = 20250505-152734F",
"P00 INFO: full backup size = 23.2MB, file total = 936",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=1241-ab2876e1 --log-level-console=info --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-152734F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"diff backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 7 lines of output]",
"P00 INFO: check archive for segment(s) 000000010000000000000004:000000010000000000000005",
"P00 INFO: new backup label = 20250505-152734F_20250505-152737D",
"P00 INFO: diff backup size = 9.1KB, file total = 936",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=1301-ccbde6df --log-level-console=info --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-full=2 --stanza=demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"(full|incr|diff) backup"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (13): 000000010000000000000001/000000010000000000000005",
"",
" full backup: 20250505-152734F",
" timestamp start/stop: 2025-05-05 15:27:34+00 / 2025-05-05 15:27:36+00",
" wal start/stop: 000000010000000000000002 / 000000010000000000000003",
" database size: 23.2MB, database backup size: 23.2MB",
" repo1: backup set size: 2.9MB, backup size: 2.9MB",
"",
" diff backup: 20250505-152734F_20250505-152737D",
" timestamp start/stop: 2025-05-05 15:27:37+00 / 2025-05-05 15:27:38+00",
" wal start/stop: 000000010000000000000004 / 000000010000000000000005",
" database size: 23.2MB, database backup size: 9.1KB",
" repo1: backup set size: 2.9MB, backup size: 864B",
" backup reference total: 1 full"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm /var/lib/pgsql/13/data/global/pg_control"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"err-expect" : "1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl status postgresql-13.service"
],
"err-expect" : "3",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"failed"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"postgresql-13.service - PostgreSQL 13 database server",
" Loaded: loaded (/usr/lib/systemd/system/postgresql-13.service, disabled)",
" Active: failed (failed)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres find /var/lib/pgsql/13/data -mindepth 1 -delete"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p /var/lib/pgsql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cp -r /pgbackrest/doc/example/* \\",
" /var/lib/pgsql/pgbackrest/doc/example"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- An example of monitoring pgBackRest from within PostgreSQL",
"--",
"-- Use copy to export data from the pgBackRest info command into the jsonb",
"-- type so it can be queried directly by PostgreSQL.",
"",
"-- Create monitor schema",
"create schema monitor;",
"",
"-- Get pgBackRest info in JSON format",
"create function monitor.pgbackrest_info()",
" returns jsonb AS $$",
"declare",
" data jsonb;",
"begin",
" -- Create a temp table to hold the JSON data",
" create temp table temp_pgbackrest_data (data text);",
"",
" -- Copy data into the table directly from the pgBackRest info command",
" copy temp_pgbackrest_data (data)",
" from program",
" 'pgbackrest --output=json info' (format text);",
"",
" select replace(temp_pgbackrest_data.data, E'\\n', '\\n')::jsonb",
" into data",
" from temp_pgbackrest_data;",
"",
" drop table temp_pgbackrest_data;",
"",
" return data;",
"end $$ language plpgsql;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-info.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-- Get last successful backup for each stanza",
"--",
"-- Requires the monitor.pgbackrest_info function.",
"with stanza as",
"(",
" select data->'name' as name,",
" data->'backup'->(",
" jsonb_array_length(data->'backup') - 1) as last_backup,",
" data->'archive'->(",
" jsonb_array_length(data->'archive') - 1) as current_archive",
" from jsonb_array_elements(monitor.pgbackrest_info()) as data",
")",
"select name,",
" to_timestamp(",
" (last_backup->'timestamp'->>'stop')::numeric) as last_successful_backup,",
" current_archive->>'max' as last_archived_wal",
" from stanza;"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -f \\",
" /var/lib/pgsql/pgbackrest/doc/example/pgsql-pgbackrest-query.sql"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" name | last_successful_backup | last_archived_wal ",
"--------+------------------------+--------------------------",
" \"demo\" | 2025-05-05 15:27:38+00 | 000000010000000000000005",
"(1 row)"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-bundle" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres find /var/lib/pgbackrest/backup/demo/latest/ -type f | wc -l"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"5"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-block" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --annotation=source=\"demo backup\" \\",
" --annotation=key=value --type=full backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-152752F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --set=20250505-152752F info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"annotation"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (13): 000000020000000000000007/000000020000000000000009",
"",
" full backup: 20250505-152752F",
" timestamp start/stop: 2025-05-05 15:27:52+00 / 2025-05-05 15:27:53+00",
" wal start/stop: 000000020000000000000008 / 000000020000000000000009",
" lsn start/stop: 0/8000028 / 0/9000050",
" database size: 23.2MB, database backup size: 23.2MB",
" repo1: backup size: 2.9MB",
" database list: postgres (13383)",
" annotation(s)",
" key: value",
" source: demo backup"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --set=20250505-152752F \\",
" --annotation=key= --annotation=new_key=new_value annotate"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --set=20250505-152752F info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"annotation"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: aes-256-cbc",
"",
" db (current)",
" wal archive min/max (13): 000000020000000000000007/000000020000000000000009",
"",
" full backup: 20250505-152752F",
" timestamp start/stop: 2025-05-05 15:27:52+00 / 2025-05-05 15:27:53+00",
" wal start/stop: 000000020000000000000008 / 000000020000000000000009",
" lsn start/stop: 0/8000028 / 0/9000050",
" database size: 23.2MB, database backup size: 23.2MB",
" repo1: backup size: 2.9MB",
" database list: postgres (13383)",
" annotation(s)",
" new_key: new_value",
" source: demo backup"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-full" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20250505-152734F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 948 lines of output]",
"P00 INFO: repo1: remove expired backup 20250505-152750F",
"P00 DETAIL: repo1: 13-1 archive retention on backup 20250505-152752F, start = 000000020000000000000008",
"P00 INFO: repo1: 13-1 remove archive, start = 000000020000000000000007, stop = 000000020000000000000007",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-152755F"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=full \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire full backup set 20250505-152734F|archive retention on backup 20250505-152755F|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 11 lines of output]",
"P00 INFO: repo1: expire full backup 20250505-152752F",
"P00 INFO: repo1: remove expired backup 20250505-152752F",
"P00 INFO: repo1: 13-1 remove archive, start = 000000020000000000000008, stop = 000000020000000000000009",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "1"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=1",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-152757F_20250505-152759D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"expire diff backup set 20250505-152757F_20250505-152759D"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 10 lines of output]",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=2302-3a19f28b --log-level-console=info --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-diff=1 --repo1-retention-full=2 --stanza=demo",
"P00 INFO: repo1: expire diff backup set 20250505-152757F_20250505-152759D, 20250505-152757F_20250505-152800I",
"P00 INFO: repo1: remove expired backup 20250505-152757F_20250505-152800I",
"P00 INFO: repo1: remove expired backup 20250505-152757F_20250505-152759D",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo1-retention-diff" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-152757F_20250505-152801D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_wal(); \\",
" select pg_create_restore_point('generate WAL'); select pg_switch_wal();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=diff \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"new backup label"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 6 lines of output]",
"P00 INFO: backup stop archive = 000000020000000000000017, lsn = 0/17000050",
"P00 INFO: check archive for segment(s) 000000020000000000000016:000000020000000000000017",
"P00 INFO: new backup label = 20250505-152757F_20250505-152803D",
"P00 INFO: diff backup size = 11.6KB, file total = 936",
"P00 INFO: backup command end: completed successfully",
" [filtered 2 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-152757F_20250505-152803D"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=detail \\",
" --repo1-retention-archive-type=diff --repo1-retention-archive=1 expire"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"archive retention on backup 20250505-152757F_20250505-152801D|remove archive"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: expire command begin 2.55.1: --exec-id=2492-06555233 --log-level-console=detail --no-log-timestamp --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo1-retention-archive=1 --repo1-retention-archive-type=diff --repo1-retention-diff=2 --repo1-retention-full=2 --stanza=demo",
"P00 DETAIL: repo1: 13-1 archive retention on backup 20250505-152755F, start = 00000002000000000000000A, stop = 00000002000000000000000B",
"P00 DETAIL: repo1: 13-1 archive retention on backup 20250505-152757F, start = 00000002000000000000000C, stop = 00000002000000000000000D",
"P00 DETAIL: repo1: 13-1 archive retention on backup 20250505-152757F_20250505-152801D, start = 000000020000000000000012, stop = 000000020000000000000013",
"P00 DETAIL: repo1: 13-1 archive retention on backup 20250505-152757F_20250505-152803D, start = 000000020000000000000016",
"P00 INFO: repo1: 13-1 remove archive, start = 00000002000000000000000E, stop = 000000020000000000000011",
"P00 INFO: repo1: 13-1 remove archive, start = 000000020000000000000014, stop = 000000020000000000000015",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --log-level-console=detail restore"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"demo\\/PG_VERSION - exists and matches backup|remove invalid files|rename global\\/pg_control"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 DETAIL: check '/var/lib/pgsql/13/data' exists",
"P00 DETAIL: remove 'global/pg_control' so cluster will not start if restore does not complete",
"P00 INFO: remove invalid files/links/paths from '/var/lib/pgsql/13/data'",
"P00 DETAIL: remove invalid file '/var/lib/pgsql/13/data/backup_label.old'",
"P00 DETAIL: remove invalid file '/var/lib/pgsql/13/data/base/13383/pg_internal.init'",
" [filtered 981 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create database test2;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test1_table (id int); \\",
" insert into test1_table (id) values (1);\" test1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"create table test2_table (id int); \\",
" insert into test2_table (id) values (2);\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"INSERT 0 1"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select oid from pg_database where datname = 'test1'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"32768"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/pgsql/13/data/base/32768"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"7.8M\t/var/lib/pgsql/13/data/base/32768"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-152757F_20250505-152813I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo \\",
" --set=20250505-152757F_20250505-152813I info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"database list"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 12 lines of output]",
" repo1: backup size: 1.9MB",
" backup reference list: 20250505-152757F, 20250505-152757F_20250505-152803D",
" database list: postgres (13383), test1 (32768), test2 (32769)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --db-include=test2 --type=immediate --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test2_table;\" test2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" id ",
"----",
" 2",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from test1_table;\" test1"
],
"err-expect" : "2",
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"relation mapping file.*contains invalid data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"psql: error: connection to server on socket \"/run/postgresql/.s.PGSQL.5432\" failed: FATAL: relation mapping file \"base/32768/pg_filenode.map\" contains invalid data"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres du -sh /var/lib/pgsql/13/data/base/32768"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"8.0K\t/var/lib/pgsql/13/data/base/32768"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"drop database test1;\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"DROP DATABASE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select oid, datname from pg_database order by oid;\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"test2"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" oid | datname ",
"-------+-----------",
" 1 | template1",
" 13382 | template0",
" 13383 | postgres",
" 32769 | test2",
"(4 rows)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" create table important_table (message text); \\",
" insert into important_table values ('Important Data'); \\",
" commit; \\",
" select * from important_table;\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select current_timestamp\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"2025-05-05 15:28:25.620667+00"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"begin; \\",
" drop table important_table; \\",
" commit; \\",
" select * from important_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"important_table\" does not exist",
"LINE 1: ...le important_table; commit; select * from important_...",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=incr backup"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest repo-ls backup/demo --filter=\"(F|D|I)$\" --sort=desc | head -1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"20250505-152757F_20250505-152827I"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"20250505-152757F_20250505-152827I"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 38 lines of output]",
" backup reference total: 1 full, 1 diff",
"",
" incr backup: 20250505-152757F_20250505-152827I",
" timestamp start/stop: 2025-05-05 15:28:27+00 / 2025-05-05 15:28:28+00",
" wal start/stop: 00000004000000000000001A / 00000004000000000000001A",
" [filtered 2 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --set=20250505-152757F_20250505-152827I --target-timeline=current \\",
" --type=time \"--target=2025-05-05 15:28:25.620667+00\" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/13/data/log/postgresql.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"err-expect" : "1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/13/data/log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery ended before configured recovery target was reached"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 11 lines of output]",
"LOG: database system is ready to accept read only connections",
"LOG: redo done at 0/1A000100",
"FATAL: recovery ended before configured recovery target was reached",
"LOG: startup process (PID 3455) exited with exit code 1",
"LOG: terminating any other active server processes"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta \\",
" --type=time \"--target=2025-05-05 15:28:25.620667+00\" \\",
" --target-action=promote restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/13/data/log/postgresql.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/13/data/postgresql.auto.conf"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery_target_time"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 9 lines of output]",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:28:33",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"recovery_target_time = '2025-05-05 15:28:25.620667+00'",
"recovery_target_action = 'promote'"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from important_table\""
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/13/data/log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"recovery stopping before|last completed transaction|starting point-in-time recovery"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 5 lines of output]",
"LOG: database system was interrupted; last known up at 2025-05-05 15:28:13 UTC",
"LOG: restored log file \"00000004.history\" from archive",
"LOG: starting point-in-time recovery to 2025-05-05 15:28:25.620667+00",
"LOG: restored log file \"00000004.history\" from archive",
"LOG: restored log file \"000000040000000000000019\" from archive",
" [filtered 2 lines of output]",
"LOG: consistent recovery state reached at 0/19000100",
"LOG: database system is ready to accept read only connections",
"LOG: recovery stopping before commit of transaction 495, time 2025-05-05 15:28:26.982491+00",
"LOG: redo done at 0/1901E348",
"LOG: last completed transaction was at log time 2025-05-05 15:28:24.226566+00",
"LOG: selected new timeline ID: 5",
"LOG: archive recovery complete",
"LOG: database system is ready to accept connections"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stop"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stop command begin 2.55.1: --exec-id=3747-c882f699 --log-level-console=info --no-log-timestamp --stanza=demo",
"P00 INFO: stop command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=1 \\",
" --log-level-console=info stanza-delete"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-delete command begin 2.55.1: --exec-id=3773-0ed7e517 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo=1 --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --stanza=demo",
"P00 INFO: stanza-delete command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo2-azure-account" : {
"value" : "pgbackrest"
},
"repo2-azure-container" : {
"value" : "demo-container"
},
"repo2-azure-key" : {
"value" : "YXpLZXk="
},
"repo2-path" : {
"value" : "/demo-repo"
},
"repo2-retention-full" : {
"value" : "4"
},
"repo2-type" : {
"value" : "azure"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo2-azure-account=pgbackrest",
"repo2-azure-container=demo-container",
"repo2-azure-key=YXpLZXk=",
"repo2-path=/demo-repo",
"repo2-retention-full=4",
"repo2-type=azure",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo \"172.17.0.2 pgbackrest.blob.core.windows.net\" | tee -a /etc/hosts"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres bash -c 'export AZURE_CLI_DISABLE_CONNECTION_VERIFICATION=1;az storage container create -n demo-container \\",
" --connection-string \"DefaultEndpointsProtocol=https;AccountName=pgbackrest;AccountKey=YXpLZXk=\" \\",
" 2>&1'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.55.1: --exec-id=3939-d3c96342 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo2-type=azure --stanza=demo",
"P00 INFO: stanza-create for stanza 'demo' on repo1",
"P00 INFO: stanza-create for stanza 'demo' on repo2",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=2 \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.55.1: --exec-id=3966-a598a23b --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo=2 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-block --repo1-bundle --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo2-type=azure --stanza=demo --start-fast",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000005000000000000001B, lsn = 0/1B000028",
" [filtered 3 lines of output]",
"P00 INFO: check archive for segment(s) 00000005000000000000001B:00000005000000000000001B",
"P00 INFO: new backup label = 20250505-152851F",
"P00 INFO: full backup size = 30.8MB, file total = 1229",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=3966-a598a23b --log-level-console=info --no-log-timestamp --repo=2 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo2-type=azure --stanza=demo"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo3-path" : {
"value" : "/demo-repo"
},
"repo3-retention-full" : {
"value" : "4"
},
"repo3-s3-bucket" : {
"value" : "demo-bucket"
},
"repo3-s3-endpoint" : {
"value" : "s3.us-east-1.amazonaws.com"
},
"repo3-s3-key" : {
"value" : "accessKey1"
},
"repo3-s3-key-secret" : {
"value" : "verySecretKey1"
},
"repo3-s3-region" : {
"value" : "us-east-1"
},
"repo3-type" : {
"value" : "s3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo2-azure-account=pgbackrest",
"repo2-azure-container=demo-container",
"repo2-azure-key=YXpLZXk=",
"repo2-path=/demo-repo",
"repo2-retention-full=4",
"repo2-type=azure",
"repo3-path=/demo-repo",
"repo3-retention-full=4",
"repo3-s3-bucket=demo-bucket",
"repo3-s3-endpoint=s3.us-east-1.amazonaws.com",
"repo3-s3-key=accessKey1",
"repo3-s3-key-secret=verySecretKey1",
"repo3-s3-region=us-east-1",
"repo3-type=s3",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo \"172.17.0.3 demo-bucket.s3.us-east-1.amazonaws.com s3.us-east-1.amazonaws.com\" | tee -a /etc/hosts"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc --insecure alias set s3 https://127.0.0.1 accessKey1 verySecretKey1"
],
"host" : "s3-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc --insecure mb --with-versioning s3/demo-bucket"
],
"host" : "s3-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 4 lines of output]",
"P00 INFO: stanza 'demo' already exists on repo2 and is valid",
"P00 INFO: stanza-create for stanza 'demo' on repo3",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.55.1: --exec-id=4089-773fbc3c --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo=3 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-block --repo1-bundle --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo3-retention-full=4 --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo2-type=azure --repo3-type=s3 --stanza=demo --start-fast",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000005000000000000001C, lsn = 0/1C000028",
" [filtered 3 lines of output]",
"P00 INFO: check archive for segment(s) 00000005000000000000001C:00000005000000000000001D",
"P00 INFO: new backup label = 20250505-152901F",
"P00 INFO: full backup size = 30.8MB, file total = 1229",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=4089-773fbc3c --log-level-console=info --no-log-timestamp --repo=3 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo3-retention-full=4 --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo2-type=azure --repo3-type=s3 --stanza=demo"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -Atc \"select date_trunc('seconds', current_timestamp)\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"2025-05-05 15:29:07+00"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"process-max" : {
"value" : "4"
},
"repo4-bundle" : {
"value" : "y"
},
"repo4-path" : {
"value" : "/demo-repo"
},
"repo4-sftp-host" : {
"value" : "sftp-server"
},
"repo4-sftp-host-key-hash-type" : {
"value" : "sha1"
},
"repo4-sftp-host-user" : {
"value" : "pgbackrest"
},
"repo4-sftp-private-key-file" : {
"value" : "/var/lib/pgsql/.ssh/id_rsa_sftp"
},
"repo4-sftp-public-key-file" : {
"value" : "/var/lib/pgsql/.ssh/id_rsa_sftp.pub"
},
"repo4-type" : {
"value" : "sftp"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"process-max=4",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo2-azure-account=pgbackrest",
"repo2-azure-container=demo-container",
"repo2-azure-key=YXpLZXk=",
"repo2-path=/demo-repo",
"repo2-retention-full=4",
"repo2-type=azure",
"repo3-path=/demo-repo",
"repo3-retention-full=4",
"repo3-s3-bucket=demo-bucket",
"repo3-s3-endpoint=s3.us-east-1.amazonaws.com",
"repo3-s3-key=accessKey1",
"repo3-s3-key-secret=verySecretKey1",
"repo3-s3-region=us-east-1",
"repo3-type=s3",
"repo4-bundle=y",
"repo4-path=/demo-repo",
"repo4-sftp-host=sftp-server",
"repo4-sftp-host-key-hash-type=sha1",
"repo4-sftp-host-user=pgbackrest",
"repo4-sftp-private-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp",
"repo4-sftp-public-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp.pub",
"repo4-type=sftp",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -m 750 -p /var/lib/pgsql/.ssh"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres ssh-keygen -f /var/lib/pgsql/.ssh/id_rsa_sftp \\",
" -t rsa -b 4096 -N \"\" -m PEM"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"id -u pgbackrest > /dev/null 2>&1 || adduser -n pgbackrest"
],
"host" : "sftp-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mkdir -m 750 -p /demo-repo && chown pgbackrest /demo-repo"
],
"host" : "sftp-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest mkdir -m 750 -p /home/pgbackrest/.ssh"
],
"host" : "sftp-server",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"(sudo ssh root@pg-primary cat /var/lib/pgsql/.ssh/id_rsa_sftp.pub) | \\",
" sudo -u pgbackrest tee -a /home/pgbackrest/.ssh/authorized_keys"
],
"host" : "sftp-server",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"ssh-keyscan -H sftp-server >> /var/lib/pgsql/.ssh/known_hosts 2>/dev/null"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "postgres"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 6 lines of output]",
"P00 INFO: stanza 'demo' already exists on repo3 and is valid",
"P00 INFO: stanza-create for stanza 'demo' on repo4",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=4 \\",
" --log-level-console=info backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"no prior backup exists|full backup size"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: backup command begin 2.55.1: --exec-id=4322-888f0cdd --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --process-max=4 --repo=4 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-block --repo1-bundle --repo4-bundle --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo4-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo3-retention-full=4 --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo4-sftp-host=sftp-server --repo4-sftp-host-key-hash-type=sha1 --repo4-sftp-host-user=pgbackrest --repo4-sftp-private-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp --repo4-sftp-public-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp.pub --repo2-type=azure --repo3-type=s3 --repo4-type=sftp --stanza=demo --start-fast",
"P00 WARN: option 'repo4-retention-full' is not set for 'repo4-retention-full-type=count', the repository may run out of space",
" HINT: to retain full backups indefinitely (without warning), set option 'repo4-retention-full' to the maximum.",
"P00 WARN: no prior backup exists, incr backup has been changed to full",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000005000000000000001E, lsn = 0/1E000028",
" [filtered 3 lines of output]",
"P00 INFO: check archive for segment(s) 00000005000000000000001E:00000005000000000000001F",
"P00 INFO: new backup label = 20250505-152911F",
"P00 INFO: full backup size = 30.8MB, file total = 1229",
"P00 INFO: backup command end: completed successfully",
"P00 INFO: expire command begin 2.55.1: --exec-id=4322-888f0cdd --log-level-console=info --no-log-timestamp --repo=4 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo4-path=/demo-repo --repo1-retention-diff=2 --repo1-retention-full=2 --repo2-retention-full=4 --repo3-retention-full=4 --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo4-sftp-host=sftp-server --repo4-sftp-host-key-hash-type=sha1 --repo4-sftp-host-user=pgbackrest --repo4-sftp-private-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp --repo4-sftp-public-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp.pub --repo2-type=azure --repo3-type=s3 --repo4-type=sftp --stanza=demo",
"P00 INFO: expire command end: completed successfully"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"repo5-gcs-bucket" : {
"value" : "demo-bucket"
},
"repo5-gcs-key" : {
"value" : "/etc/pgbackrest/gcs-key.json"
},
"repo5-path" : {
"value" : "/demo-repo"
},
"repo5-type" : {
"value" : "gcs"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"process-max=4",
"repo1-block=y",
"repo1-bundle=y",
"repo1-cipher-pass=zWaf6XtpjIVZC5444yXB+cgFDFl7MxGlgkZSaoPvTGirhPygu4jOKOXf9LO4vjfO",
"repo1-cipher-type=aes-256-cbc",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-diff=2",
"repo1-retention-full=2",
"repo2-azure-account=pgbackrest",
"repo2-azure-container=demo-container",
"repo2-azure-key=YXpLZXk=",
"repo2-path=/demo-repo",
"repo2-retention-full=4",
"repo2-type=azure",
"repo3-path=/demo-repo",
"repo3-retention-full=4",
"repo3-s3-bucket=demo-bucket",
"repo3-s3-endpoint=s3.us-east-1.amazonaws.com",
"repo3-s3-key=accessKey1",
"repo3-s3-key-secret=verySecretKey1",
"repo3-s3-region=us-east-1",
"repo3-type=s3",
"repo4-bundle=y",
"repo4-path=/demo-repo",
"repo4-sftp-host=sftp-server",
"repo4-sftp-host-key-hash-type=sha1",
"repo4-sftp-host-user=pgbackrest",
"repo4-sftp-private-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp",
"repo4-sftp-public-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp.pub",
"repo4-type=sftp",
"repo5-gcs-bucket=demo-bucket",
"repo5-gcs-key=/etc/pgbackrest/gcs-key.json",
"repo5-path=/demo-repo",
"repo5-type=gcs",
"start-fast=y",
"",
"[global:archive-push]",
"compress-level=3"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 1"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 stanza-delete"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"missing stanza data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: error (missing stanza data)",
" cipher: none"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mc ls --versions s3/demo-bucket/demo-repo/backup/demo/backup.info"
],
"cmd-extra" : "--insecure",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup\\.info$"
]
},
"host" : "s3-server",
"load-env" : true,
"output" : true,
"run-as-user" : "root"
},
"type" : "exe",
"value" : {
"output" : [
"[2025-05-05 15:29:18 UTC] 0B STANDARD c89dad87-2067-4ef3-bcc6-b10dc276ab3f v3 DEL backup.info",
"[2025-05-05 15:29:07 UTC] 1.0KiB STANDARD 81c92a67-8cf3-479e-9d98-ed6bb81a5c89 v2 PUT backup.info",
"[2025-05-05 15:29:01 UTC] 372B STANDARD b7196686-d823-4b6b-83fc-c5c6532d221c v1 PUT backup.info",
"[2025-05-05 15:29:18 UTC] 0B STANDARD e61860f5-f8b6-4c70-95cb-d3532e97124f v3 DEL backup.info.copy",
"[2025-05-05 15:29:07 UTC] 1.0KiB STANDARD 70489080-5a15-48f2-be78-80ab11f54118 v2 PUT backup.info.copy"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 \\",
" --repo-target-time=\"2025-05-05 15:29:07+00\" info"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"full backup"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 5 lines of output]",
" wal archive min/max (13): 00000005000000000000001C/00000005000000000000001D",
"",
" full backup: 20250505-152901F",
" timestamp start/stop: 2025-05-05 15:29:01+00 / 2025-05-05 15:29:06+00",
" wal start/stop: 00000005000000000000001C / 00000005000000000000001D",
" repo3: backup set size: 3.8MB, backup size: 3.8MB"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --repo=3 --delta \\",
" --repo-target-time=\"2025-05-05 15:29:07+00\" --log-level-console=info restore"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" restore backup set "
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: restore command begin 2.55.1: --delta --exec-id=4555-c667fd71 --log-level-console=info --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --process-max=4 --repo=3 --repo2-azure-account= --repo2-azure-container=demo-container --repo2-azure-key= --repo1-cipher-pass= --repo1-cipher-type=aes-256-cbc --repo5-gcs-bucket=demo-bucket --repo5-gcs-key= --repo1-path=/var/lib/pgbackrest --repo2-path=/demo-repo --repo3-path=/demo-repo --repo4-path=/demo-repo --repo5-path=/demo-repo --repo3-s3-bucket=demo-bucket --repo3-s3-endpoint=s3.us-east-1.amazonaws.com --repo3-s3-key= --repo3-s3-key-secret= --repo3-s3-region=us-east-1 --repo4-sftp-host=sftp-server --repo4-sftp-host-key-hash-type=sha1 --repo4-sftp-host-user=pgbackrest --repo4-sftp-private-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp --repo4-sftp-public-key-file=/var/lib/pgsql/.ssh/id_rsa_sftp.pub --repo-target-time=\"2025-05-05 15:29:07+00\" --repo2-type=azure --repo3-type=s3 --repo4-type=sftp --repo5-type=gcs --stanza=demo",
"P00 INFO: repo3: restore backup set 20250505-152901F, recovery will start at 2025-05-05 15:29:01",
"P00 INFO: remove invalid files/links/paths from '/var/lib/pgsql/13/data'",
"P00 INFO: write updated /var/lib/pgsql/13/data/postgresql.auto.conf",
" [filtered 2 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "repo1",
"image" : "pgbackrest/doc:rhel",
"name" : "repository",
"option" : "-m 512m",
"os" : "rhel",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.7"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo groupadd pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo adduser -gpgbackrest -n pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs libssh2"
],
"cmd-extra" : "-y 2>&1",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/log/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /etc/pgbackrest/pgbackrest.conf"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 750 /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown pgbackrest:pgbackrest /var/lib/pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"repo1-path" : {
"value" : "/var/lib/pgbackrest"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[global]",
"repo1-path=/var/lib/pgbackrest"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-host" : {
"value" : "pg-primary"
},
"pg1-host-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"pg1-host-cert-file" : {
"value" : "/etc/pgbackrest/cert/client.crt"
},
"pg1-host-key-file" : {
"value" : "/etc/pgbackrest/cert/client.key"
},
"pg1-host-type" : {
"value" : "tls"
},
"pg1-path" : {
"value" : "/var/lib/pgsql/13/data"
}
},
"global" : {
"log-timestamp" : {
"value" : "n"
},
"repo1-retention-full" : {
"value" : "2"
},
"start-fast" : {
"value" : "y"
},
"tls-server-address" : {
"value" : "*"
},
"tls-server-auth" : {
"value" : "pgbackrest-client=*"
},
"tls-server-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"tls-server-cert-file" : {
"value" : "/etc/pgbackrest/cert/server.crt"
},
"tls-server-key-file" : {
"value" : "/etc/pgbackrest/cert/server.key"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=*",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/13/data"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
},
"repo1-host-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"repo1-host-cert-file" : {
"value" : "/etc/pgbackrest/cert/client.crt"
},
"repo1-host-key-file" : {
"value" : "/etc/pgbackrest/cert/client.key"
},
"repo1-host-type" : {
"value" : "tls"
},
"tls-server-address" : {
"value" : "*"
},
"tls-server-auth" : {
"value" : "pgbackrest-client=demo"
},
"tls-server-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"tls-server-cert-file" : {
"value" : "/etc/pgbackrest/cert/server.crt"
},
"tls-server-key-file" : {
"value" : "/etc/pgbackrest/cert/server.key"
}
}
},
"reset" : true
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository",
"repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"repo1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"repo1-host-key-file=/etc/pgbackrest/cert/client.key",
"repo1-host-type=tls",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=demo",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mkdir -p -m 770 /etc/pgbackrest/cert && \\",
" cp /pgbackrest/doc/resource/fake-cert/ca.crt \\",
" /etc/pgbackrest/cert/ca.crt && \\",
" \\",
" openssl genrsa -out /etc/pgbackrest/cert/server.key 2048 2>&1 && \\",
" chmod 600 /etc/pgbackrest/cert/server.key && \\",
" openssl req -new -sha256 -nodes -out /etc/pgbackrest/cert/server.csr \\",
" -key /etc/pgbackrest/cert/server.key -subj \"/CN=repository\" 2>&1 && \\",
" openssl x509 -req -in /etc/pgbackrest/cert/server.csr \\",
" -CA /etc/pgbackrest/cert/ca.crt \\",
" -CAkey /pgbackrest/doc/resource/fake-cert/ca.key -CAcreateserial \\",
" -out /etc/pgbackrest/cert/server.crt -days 9 2>&1 && \\",
" \\",
" openssl genrsa -out /etc/pgbackrest/cert/client.key 2048 2>&1 && \\",
" chmod 600 /etc/pgbackrest/cert/client.key && \\",
" openssl req -new -sha256 -nodes -out /etc/pgbackrest/cert/client.csr \\",
" -key /etc/pgbackrest/cert/client.key -subj \"/CN=pgbackrest-client\" 2>&1 && \\",
" openssl x509 -req -in /etc/pgbackrest/cert/client.csr \\",
" -CA /etc/pgbackrest/cert/ca.crt \\",
" -CAkey /pgbackrest/doc/resource/fake-cert/ca.key -CAcreateserial \\",
" -out /etc/pgbackrest/cert/client.crt -days 9 2>&1 && \\",
" \\",
" chown -R pgbackrest /etc/pgbackrest/cert"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo '[Unit]' | tee /etc/systemd/system/pgbackrest.service && \\",
" echo 'Description=pgBackRest Server' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'After=network.target' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'StartLimitIntervalSec=0' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '[Service]' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'Type=simple' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'Restart=always' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'RestartSec=1' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'User=pgbackrest' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStart=/usr/bin/pgbackrest server' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStartPost=/bin/sleep 3' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStartPost=/bin/bash -c \"[ ! -z $MAINPID ]\"' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecReload=/bin/kill -HUP $MAINPID' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '[Install]' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'WantedBy=multi-user.target' | tee -a /etc/systemd/system/pgbackrest.service"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cat /etc/systemd/system/pgbackrest.service"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"[Unit]",
"Description=pgBackRest Server",
"After=network.target",
"StartLimitIntervalSec=0",
"",
"[Service]",
"Type=simple",
"Restart=always",
"RestartSec=1",
"User=pgbackrest",
"ExecStart=/usr/bin/pgbackrest server",
"ExecStartPost=/bin/sleep 3",
"ExecStartPost=/bin/bash -c \"[ ! -z $MAINPID ]\"",
"ExecReload=/bin/kill -HUP $MAINPID",
"",
"[Install]",
"WantedBy=multi-user.target"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl enable pgbackrest"
],
"cmd-extra" : "2>&1",
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start pgbackrest"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mkdir -p -m 770 /etc/pgbackrest/cert && \\",
" cp /pgbackrest/doc/resource/fake-cert/ca.crt \\",
" /etc/pgbackrest/cert/ca.crt && \\",
" \\",
" openssl genrsa -out /etc/pgbackrest/cert/server.key 2048 2>&1 && \\",
" chmod 600 /etc/pgbackrest/cert/server.key && \\",
" openssl req -new -sha256 -nodes -out /etc/pgbackrest/cert/server.csr \\",
" -key /etc/pgbackrest/cert/server.key -subj \"/CN=pg-primary\" 2>&1 && \\",
" openssl x509 -req -in /etc/pgbackrest/cert/server.csr \\",
" -CA /etc/pgbackrest/cert/ca.crt \\",
" -CAkey /pgbackrest/doc/resource/fake-cert/ca.key -CAcreateserial \\",
" -out /etc/pgbackrest/cert/server.crt -days 9 2>&1 && \\",
" \\",
" openssl genrsa -out /etc/pgbackrest/cert/client.key 2048 2>&1 && \\",
" chmod 600 /etc/pgbackrest/cert/client.key && \\",
" openssl req -new -sha256 -nodes -out /etc/pgbackrest/cert/client.csr \\",
" -key /etc/pgbackrest/cert/client.key -subj \"/CN=pgbackrest-client\" 2>&1 && \\",
" openssl x509 -req -in /etc/pgbackrest/cert/client.csr \\",
" -CA /etc/pgbackrest/cert/ca.crt \\",
" -CAkey /pgbackrest/doc/resource/fake-cert/ca.key -CAcreateserial \\",
" -out /etc/pgbackrest/cert/client.crt -days 9 2>&1 && \\",
" \\",
" chown -R postgres /etc/pgbackrest/cert"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo '[Unit]' | tee /etc/systemd/system/pgbackrest.service && \\",
" echo 'Description=pgBackRest Server' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'After=network.target' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'StartLimitIntervalSec=0' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '[Service]' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'Type=simple' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'Restart=always' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'RestartSec=1' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'User=postgres' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStart=/usr/bin/pgbackrest server' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStartPost=/bin/sleep 3' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStartPost=/bin/bash -c \"[ ! -z $MAINPID ]\"' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecReload=/bin/kill -HUP $MAINPID' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '[Install]' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'WantedBy=multi-user.target' | tee -a /etc/systemd/system/pgbackrest.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cat /etc/systemd/system/pgbackrest.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"[Unit]",
"Description=pgBackRest Server",
"After=network.target",
"StartLimitIntervalSec=0",
"",
"[Service]",
"Type=simple",
"Restart=always",
"RestartSec=1",
"User=postgres",
"ExecStart=/usr/bin/pgbackrest server",
"ExecStartPost=/bin/sleep 3",
"ExecStartPost=/bin/bash -c \"[ ! -z $MAINPID ]\"",
"ExecReload=/bin/kill -HUP $MAINPID",
"",
"[Install]",
"WantedBy=multi-user.target"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl enable pgbackrest"
],
"cmd-extra" : "2>&1",
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo stanza-create"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: no prior backup exists, incr backup has been changed to full"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta restore"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"process-max" : {
"value" : "3"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=*",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest info"
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"timestamp start/stop"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"stanza: demo",
" status: ok",
" cipher: none",
"",
" db (current)",
" wal archive min/max (13): 000000070000000000000023/000000070000000000000025",
"",
" full backup: 20250505-153034F",
" timestamp start/stop: 2025-05-05 15:30:34+00 / 2025-05-05 15:30:37+00",
" wal start/stop: 000000070000000000000023 / 000000070000000000000023",
" database size: 30.8MB, database backup size: 30.8MB",
" repo1: backup set size: 3.8MB, backup size: 3.8MB",
"",
" full backup: 20250505-153038F",
" timestamp start/stop: 2025-05-05 15:30:38+00 / 2025-05-05 15:30:41+00",
" wal start/stop: 000000070000000000000024 / 000000070000000000000025",
" database size: 30.8MB, database backup size: 30.8MB",
" repo1: backup set size: 3.8MB, backup size: 3.8MB"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for all stanzas"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg1: [StopError] raised from remote-0 tls protocol on 'pg-primary': stop file exists for all stanzas",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed",
" HINT: are all available clusters in recovery?"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: stop file already exists for all stanzas"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo stop"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo backup"
],
"err-expect" : "56",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"\\: stop file exists for stanza demo"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg1: [StopError] raised from remote-0 tls protocol on 'pg-primary': stop file exists for stanza demo",
"P00 ERROR: [056]: unable to find primary cluster - cannot proceed",
" HINT: are all available clusters in recovery?"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo start"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"id" : "pg2",
"image" : "pgbackrest/doc:rhel",
"name" : "pg-standby",
"option" : "-m 512m",
"os" : "rhel",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.8"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs libssh2"
],
"cmd-extra" : "-y 2>&1",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/13/data"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
},
"repo1-host-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"repo1-host-cert-file" : {
"value" : "/etc/pgbackrest/cert/client.crt"
},
"repo1-host-key-file" : {
"value" : "/etc/pgbackrest/cert/client.key"
},
"repo1-host-type" : {
"value" : "tls"
},
"tls-server-address" : {
"value" : "*"
},
"tls-server-auth" : {
"value" : "pgbackrest-client=demo"
},
"tls-server-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"tls-server-cert-file" : {
"value" : "/etc/pgbackrest/cert/server.crt"
},
"tls-server-key-file" : {
"value" : "/etc/pgbackrest/cert/server.key"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository",
"repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"repo1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"repo1-host-key-file=/etc/pgbackrest/cert/client.key",
"repo1-host-type=tls",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=demo",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mkdir -p -m 770 /etc/pgbackrest/cert && \\",
" cp /pgbackrest/doc/resource/fake-cert/ca.crt \\",
" /etc/pgbackrest/cert/ca.crt && \\",
" \\",
" openssl genrsa -out /etc/pgbackrest/cert/server.key 2048 2>&1 && \\",
" chmod 600 /etc/pgbackrest/cert/server.key && \\",
" openssl req -new -sha256 -nodes -out /etc/pgbackrest/cert/server.csr \\",
" -key /etc/pgbackrest/cert/server.key -subj \"/CN=pg-standby\" 2>&1 && \\",
" openssl x509 -req -in /etc/pgbackrest/cert/server.csr \\",
" -CA /etc/pgbackrest/cert/ca.crt \\",
" -CAkey /pgbackrest/doc/resource/fake-cert/ca.key -CAcreateserial \\",
" -out /etc/pgbackrest/cert/server.crt -days 9 2>&1 && \\",
" \\",
" openssl genrsa -out /etc/pgbackrest/cert/client.key 2048 2>&1 && \\",
" chmod 600 /etc/pgbackrest/cert/client.key && \\",
" openssl req -new -sha256 -nodes -out /etc/pgbackrest/cert/client.csr \\",
" -key /etc/pgbackrest/cert/client.key -subj \"/CN=pgbackrest-client\" 2>&1 && \\",
" openssl x509 -req -in /etc/pgbackrest/cert/client.csr \\",
" -CA /etc/pgbackrest/cert/ca.crt \\",
" -CAkey /pgbackrest/doc/resource/fake-cert/ca.key -CAcreateserial \\",
" -out /etc/pgbackrest/cert/client.crt -days 9 2>&1 && \\",
" \\",
" chown -R postgres /etc/pgbackrest/cert"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo '[Unit]' | tee /etc/systemd/system/pgbackrest.service && \\",
" echo 'Description=pgBackRest Server' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'After=network.target' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'StartLimitIntervalSec=0' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '[Service]' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'Type=simple' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'Restart=always' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'RestartSec=1' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'User=postgres' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStart=/usr/bin/pgbackrest server' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStartPost=/bin/sleep 3' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStartPost=/bin/bash -c \"[ ! -z $MAINPID ]\"' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecReload=/bin/kill -HUP $MAINPID' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '[Install]' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'WantedBy=multi-user.target' | tee -a /etc/systemd/system/pgbackrest.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cat /etc/systemd/system/pgbackrest.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"[Unit]",
"Description=pgBackRest Server",
"After=network.target",
"StartLimitIntervalSec=0",
"",
"[Service]",
"Type=simple",
"Restart=always",
"RestartSec=1",
"User=postgres",
"ExecStart=/usr/bin/pgbackrest server",
"ExecStartPost=/bin/sleep 3",
"ExecStartPost=/bin/bash -c \"[ ! -z $MAINPID ]\"",
"ExecReload=/bin/kill -HUP $MAINPID",
"",
"[Install]",
"WantedBy=multi-user.target"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl enable pgbackrest"
],
"cmd-extra" : "2>&1",
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p -m 700 /var/lib/pgsql/13/data"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/13/data/postgresql.auto.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Do not edit this file manually!",
"# It will be overwritten by the ALTER SYSTEM command.",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:27:43",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:28:07",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:28:33",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"# Removed by pgBackRest restore on 2025-05-05 15:29:21 # recovery_target_time = '2025-05-05 15:28:25.620667+00'",
"# Removed by pgBackRest restore on 2025-05-05 15:29:21 # recovery_target_action = 'promote'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:29:21",
"restore_command = 'pgbackrest --repo=3 --repo-target-time=\"2025-05-05 15:29:07+00\" --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:30:29",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:31:33",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cat /root/postgresql.common.conf >> /var/lib/pgsql/13/data/postgresql.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"file" : "/var/lib/pgsql/13/data/postgresql.conf",
"host" : "pg-standby",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"hot_standby" : {
"value" : "on"
},
"log_filename" : {
"value" : "'postgresql.log'"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"hot_standby = on",
"log_filename = 'postgresql.log'",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/13/data/log/postgresql.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/13/data/log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"entering standby mode|database system is ready to accept read only connections"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 4 lines of output]",
"LOG: listening on Unix socket \"/tmp/.s.PGSQL.5432\"",
"LOG: database system was interrupted; last known up at 2025-05-05 15:30:38 UTC",
"LOG: entering standby mode",
"LOG: restored log file \"00000007.history\" from archive",
"LOG: restored log file \"000000070000000000000024\" from archive",
"LOG: redo starts at 0/24000028",
"LOG: restored log file \"000000070000000000000025\" from archive",
"LOG: consistent recovery state reached at 0/25000050",
"LOG: database system is ready to accept read only connections"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table replicated_table (message text); \\",
" insert into replicated_table values ('Important Data'); \\",
" commit; \\",
" select * from replicated_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message ",
"----------------",
" Important Data",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select * from replicated_table;\""
],
"err-expect" : "1",
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"does not exist"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ERROR: relation \"replicated_table\" does not exist",
"LINE 1: select * from replicated_table;",
" ^"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"select *, current_timestamp from pg_switch_wal()\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" pg_switch_wal | current_timestamp ",
"---------------+-------------------------------",
" 0/26017738 | 2025-05-05 15:31:39.445111+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from replicated_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | current_timestamp ",
"----------------+-------------------------------",
" Important Data | 2025-05-05 15:31:40.659536+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"because this is a standby"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=1197-5567e589 --log-level-console=info --log-level-file=detail --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo1-host=repository --repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt --repo1-host-cert-file=/etc/pgbackrest/cert/client.crt --repo1-host-key-file=/etc/pgbackrest/cert/client.key --repo1-host-type=tls --stanza=demo",
"P00 INFO: check repo1 (standby)",
"P00 INFO: switch wal not performed because this is a standby",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" create user replicator password 'jw8s0F4' replication\";"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"CREATE ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"host replication replicator 172.17.0.8/32 md5\" \\",
" >> /var/lib/pgsql/13/data/pg_hba.conf'"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl reload postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"recovery-option" : {
"value" : "primary_conninfo=host=172.17.0.6 port=5432 user=replicator"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"recovery-option=primary_conninfo=host=172.17.0.6 port=5432 user=replicator",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository",
"repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"repo1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"repo1-host-key-file=/etc/pgbackrest/cert/client.key",
"repo1-host-type=tls",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=demo",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'echo \\",
" \"172.17.0.6:*:replication:replicator:jw8s0F4\" \\",
" >> /var/lib/pgsql/.pgpass'"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres chmod 600 /var/lib/pgsql/.pgpass"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --delta --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/13/data/postgresql.auto.conf"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"# Do not edit this file manually!",
"# It will be overwritten by the ALTER SYSTEM command.",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:27:43",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:28:07",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:28:33",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"# Removed by pgBackRest restore on 2025-05-05 15:29:21 # recovery_target_time = '2025-05-05 15:28:25.620667+00'",
"# Removed by pgBackRest restore on 2025-05-05 15:29:21 # recovery_target_action = 'promote'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:29:21",
"restore_command = 'pgbackrest --repo=3 --repo-target-time=\"2025-05-05 15:29:07+00\" --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:30:29",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'",
"",
"# Recovery settings generated by pgBackRest restore on 2025-05-05 15:31:46",
"primary_conninfo = 'host=172.17.0.6 port=5432 user=replicator'",
"restore_command = 'pgbackrest --stanza=demo archive-get %f \"%p\"'"
]
}
},
{
"key" : {
"file" : "/var/lib/pgsql/13/data/postgresql.conf",
"host" : "pg-standby",
"option" : {
"hot_standby" : {
"value" : "on"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"hot_standby = on",
"log_filename = 'postgresql.log'",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm /var/lib/pgsql/13/data/log/postgresql.log"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-13.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/lib/pgsql/13/data/log/postgresql.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"started streaming WAL from primary"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 12 lines of output]",
"LOG: database system is ready to accept read only connections",
"LOG: restored log file \"000000070000000000000026\" from archive",
"LOG: started streaming WAL from primary at 0/27000000 on timeline 7"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" begin; \\",
" create table stream_table (message text); \\",
" insert into stream_table values ('Important Data'); \\",
" commit; \\",
" select *, current_timestamp from stream_table\";"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | current_timestamp ",
"----------------+-------------------------------",
" Important Data | 2025-05-05 15:31:52.190109+00",
"(1 row)"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select *, current_timestamp from stream_table\""
],
"highlight" : {
"filter" : false,
"filter-context" : 2,
"list" : [
"Important Data"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" message | current_timestamp ",
"----------------+-------------------------------",
" Important Data | 2025-05-05 15:31:52.512491+00",
"(1 row)"
]
}
},
{
"key" : {
"id" : "pgalt",
"image" : "pgbackrest/doc:rhel",
"name" : "pg-alt",
"option" : "-m 512m",
"os" : "rhel",
"update-hosts" : true
},
"type" : "host",
"value" : {
"ip" : "172.17.0.9"
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo yum install postgresql-libs libssh2"
],
"cmd-extra" : "-y 2>&1",
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo scp build:/build/pgbackrest/src/pgbackrest /usr/bin"
],
"cmd-extra" : "2>&1",
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 755 /usr/bin/pgbackrest"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 770 /var/log/pgbackrest"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/log/pgbackrest"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p /etc/pgbackrest/conf.d"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo touch /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chmod 640 /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-alt",
"option" : {
"demo-alt" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/13/data"
}
},
"global" : {
"log-level-file" : {
"value" : "detail"
},
"log-timestamp" : {
"value" : "n"
},
"repo1-host" : {
"value" : "repository"
},
"repo1-host-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"repo1-host-cert-file" : {
"value" : "/etc/pgbackrest/cert/client.crt"
},
"repo1-host-key-file" : {
"value" : "/etc/pgbackrest/cert/client.key"
},
"repo1-host-type" : {
"value" : "tls"
},
"tls-server-address" : {
"value" : "*"
},
"tls-server-auth" : {
"value" : "pgbackrest-client=demo-alt"
},
"tls-server-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"tls-server-cert-file" : {
"value" : "/etc/pgbackrest/cert/server.crt"
},
"tls-server-key-file" : {
"value" : "/etc/pgbackrest/cert/server.key"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo-alt]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"log-level-file=detail",
"repo1-host=repository",
"repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"repo1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"repo1-host-key-file=/etc/pgbackrest/cert/client.key",
"repo1-host-type=tls",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=demo-alt",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo-alt" : {
"pg1-host" : {
"value" : "pg-alt"
},
"pg1-host-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"pg1-host-cert-file" : {
"value" : "/etc/pgbackrest/cert/client.crt"
},
"pg1-host-key-file" : {
"value" : "/etc/pgbackrest/cert/client.key"
},
"pg1-host-type" : {
"value" : "tls"
},
"pg1-path" : {
"value" : "/var/lib/pgsql/13/data"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[demo-alt]",
"pg1-host=pg-alt",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=*",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"mkdir -p -m 770 /etc/pgbackrest/cert && \\",
" cp /pgbackrest/doc/resource/fake-cert/ca.crt \\",
" /etc/pgbackrest/cert/ca.crt && \\",
" \\",
" openssl genrsa -out /etc/pgbackrest/cert/server.key 2048 2>&1 && \\",
" chmod 600 /etc/pgbackrest/cert/server.key && \\",
" openssl req -new -sha256 -nodes -out /etc/pgbackrest/cert/server.csr \\",
" -key /etc/pgbackrest/cert/server.key -subj \"/CN=pg-alt\" 2>&1 && \\",
" openssl x509 -req -in /etc/pgbackrest/cert/server.csr \\",
" -CA /etc/pgbackrest/cert/ca.crt \\",
" -CAkey /pgbackrest/doc/resource/fake-cert/ca.key -CAcreateserial \\",
" -out /etc/pgbackrest/cert/server.crt -days 9 2>&1 && \\",
" \\",
" openssl genrsa -out /etc/pgbackrest/cert/client.key 2048 2>&1 && \\",
" chmod 600 /etc/pgbackrest/cert/client.key && \\",
" openssl req -new -sha256 -nodes -out /etc/pgbackrest/cert/client.csr \\",
" -key /etc/pgbackrest/cert/client.key -subj \"/CN=pgbackrest-client\" 2>&1 && \\",
" openssl x509 -req -in /etc/pgbackrest/cert/client.csr \\",
" -CA /etc/pgbackrest/cert/ca.crt \\",
" -CAkey /pgbackrest/doc/resource/fake-cert/ca.key -CAcreateserial \\",
" -out /etc/pgbackrest/cert/client.crt -days 9 2>&1 && \\",
" \\",
" chown -R postgres /etc/pgbackrest/cert"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"echo '[Unit]' | tee /etc/systemd/system/pgbackrest.service && \\",
" echo 'Description=pgBackRest Server' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'After=network.target' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'StartLimitIntervalSec=0' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '[Service]' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'Type=simple' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'Restart=always' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'RestartSec=1' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'User=postgres' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStart=/usr/bin/pgbackrest server' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStartPost=/bin/sleep 3' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecStartPost=/bin/bash -c \"[ ! -z $MAINPID ]\"' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'ExecReload=/bin/kill -HUP $MAINPID' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo '[Install]' | tee -a /etc/systemd/system/pgbackrest.service && \\",
" echo 'WantedBy=multi-user.target' | tee -a /etc/systemd/system/pgbackrest.service"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cat /etc/systemd/system/pgbackrest.service"
],
"host" : "pg-alt",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"[Unit]",
"Description=pgBackRest Server",
"After=network.target",
"StartLimitIntervalSec=0",
"",
"[Service]",
"Type=simple",
"Restart=always",
"RestartSec=1",
"User=postgres",
"ExecStart=/usr/bin/pgbackrest server",
"ExecStartPost=/bin/sleep 3",
"ExecStartPost=/bin/bash -c \"[ ! -z $MAINPID ]\"",
"ExecReload=/bin/kill -HUP $MAINPID",
"",
"[Install]",
"WantedBy=multi-user.target"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl enable pgbackrest"
],
"cmd-extra" : "2>&1",
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start pgbackrest"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/pgsql-13/bin/initdb \\",
" -D /var/lib/pgsql/13/data -k -A peer"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cat /root/postgresql.common.conf >> /var/lib/pgsql/13/data/postgresql.conf"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"file" : "/var/lib/pgsql/13/data/postgresql.conf",
"host" : "pg-alt",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo-alt archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"log_filename" : {
"value" : "'postgresql.log'"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo-alt archive-push %p'",
"archive_mode = on",
"log_filename = 'postgresql.log'",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl restart postgresql-13.service"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-alt",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo-alt --log-level-console=info stanza-create"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-alt",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-create command begin 2.55.1: --exec-id=960-376c0d96 --log-level-console=info --log-level-file=detail --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo1-host=repository --repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt --repo1-host-cert-file=/etc/pgbackrest/cert/client.crt --repo1-host-key-file=/etc/pgbackrest/cert/client.key --repo1-host-type=tls --stanza=demo-alt",
"P00 INFO: stanza-create for stanza 'demo-alt' on repo1",
"P00 INFO: stanza-create command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"check stanza | successfully archived to "
]
},
"host" : "pg-alt",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=987-2341c8d3 --log-level-console=info --log-level-file=detail --no-log-timestamp --repo1-host=repository --repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt --repo1-host-cert-file=/etc/pgbackrest/cert/client.crt --repo1-host-key-file=/etc/pgbackrest/cert/client.key --repo1-host-type=tls",
"P00 INFO: check stanza 'demo-alt'",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 000000010000000000000001 successfully archived to '/var/lib/pgbackrest/archive/demo-alt/13-1/0000000100000000/000000010000000000000001-fdc4d128665b12cd6451f2a34646fc503687864c.gz' on repo1",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"check stanza | successfully archived to "
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=1331-582c5602 --log-level-console=info --no-log-timestamp --repo1-path=/var/lib/pgbackrest",
"P00 INFO: check stanza 'demo'",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 000000070000000000000027 successfully archived to '/var/lib/pgbackrest/archive/demo/13-1/0000000700000000/000000070000000000000027-6ec3f77c103df27e1c5c2176ba20a25be52f4c59.gz' on repo1",
"P00 INFO: check stanza 'demo-alt'",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 000000010000000000000002 successfully archived to '/var/lib/pgbackrest/archive/demo-alt/13-1/0000000100000000/000000010000000000000002-1ca03294e18dcc858dcb227abf90a4f2a6bb094d.gz' on repo1",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo mkdir -p -m 750 /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo chown postgres:postgres /var/spool/pgbackrest"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"repo1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"repo1-host-key-file=/etc/pgbackrest/cert/client.key",
"repo1-host-type=tls",
"spool-path=/var/spool/pgbackrest",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=demo",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"global" : {
"archive-async" : {
"value" : "y"
},
"spool-path" : {
"value" : "/var/spool/pgbackrest"
}
},
"global:archive-get" : {
"process-max" : {
"value" : "2"
}
},
"global:archive-push" : {
"process-max" : {
"value" : "2"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/13/data",
"recovery-option=primary_conninfo=host=172.17.0.6 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"repo1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"repo1-host-key-file=/etc/pgbackrest/cert/client.key",
"repo1-host-type=tls",
"spool-path=/var/spool/pgbackrest",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=demo",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'bogus'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl restart postgresql-13.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres rm -f /var/log/pgbackrest/demo-archive-push-async.log"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \" \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal(); \\",
" select pg_create_restore_point('test async push'); select pg_switch_wal();\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --log-level-console=info check"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"WAL segment"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: check command begin 2.55.1: --exec-id=5523-a294109a --log-level-console=info --log-level-file=detail --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --repo1-host=repository --repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt --repo1-host-cert-file=/etc/pgbackrest/cert/client.crt --repo1-host-key-file=/etc/pgbackrest/cert/client.key --repo1-host-type=tls --stanza=demo",
"P00 INFO: check repo1 configuration (primary)",
"P00 INFO: check repo1 archive for WAL (primary)",
"P00 INFO: WAL segment 00000007000000000000002D successfully archived to '/var/lib/pgbackrest/archive/demo/13-1/0000000700000000/00000007000000000000002D-aeeff865302e5d3d88bc6400d7bc492b147e06ee.gz' on repo1",
"P00 INFO: check command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-push-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
" WAL file\\(s\\) to archive|pushed WAL file \\'0000000"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.55.1: [/var/lib/pgsql/13/data/pg_wal] --archive-async --exec-id=5493-218290f9 --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --process-max=2 --repo1-host=repository --repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt --repo1-host-cert-file=/etc/pgbackrest/cert/client.crt --repo1-host-key-file=/etc/pgbackrest/cert/client.key --repo1-host-type=tls --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 1 WAL file(s) to archive: 000000070000000000000028",
"P01 DETAIL: pushed WAL file '000000070000000000000028' to the archive",
"P00 DETAIL: statistics: {\"socket.client\":{\"total\":1},\"socket.session\":{\"total\":1},\"tls.client\":{\"total\":1},\"tls.session\":{\"total\":1}}",
"P00 INFO: archive-push:async command end: completed successfully",
"",
"-------------------PROCESS START-------------------",
"P00 INFO: archive-push:async command begin 2.55.1: [/var/lib/pgsql/13/data/pg_wal] --archive-async --exec-id=5525-183ecf58 --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --process-max=2 --repo1-host=repository --repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt --repo1-host-cert-file=/etc/pgbackrest/cert/client.crt --repo1-host-key-file=/etc/pgbackrest/cert/client.key --repo1-host-type=tls --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: push 5 WAL file(s) to archive: 000000070000000000000029...00000007000000000000002D",
"P01 DETAIL: pushed WAL file '000000070000000000000029' to the archive",
"P02 DETAIL: pushed WAL file '00000007000000000000002A' to the archive",
"P01 DETAIL: pushed WAL file '00000007000000000000002B' to the archive",
"P02 DETAIL: pushed WAL file '00000007000000000000002C' to the archive",
"P01 DETAIL: pushed WAL file '00000007000000000000002D' to the archive",
"P00 DETAIL: statistics: {\"socket.client\":{\"total\":1},\"socket.session\":{\"total\":1},\"tls.client\":{\"total\":1},\"tls.session\":{\"total\":1}}",
"P00 INFO: archive-push:async command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 5"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres cat /var/log/pgbackrest/demo-archive-get-async.log"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"found [0-F]{24} in the .* archive"
]
},
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"-------------------PROCESS START-------------------",
"P00 INFO: archive-get:async command begin 2.55.1: [000000070000000000000024, 000000070000000000000025, 000000070000000000000026, 000000070000000000000027, 000000070000000000000028, 000000070000000000000029, 00000007000000000000002A, 00000007000000000000002B] --archive-async --exec-id=1728-47faf303 --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --process-max=2 --repo1-host=repository --repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt --repo1-host-cert-file=/etc/pgbackrest/cert/client.crt --repo1-host-key-file=/etc/pgbackrest/cert/client.key --repo1-host-type=tls --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000070000000000000024...00000007000000000000002B",
"P02 DETAIL: found 000000070000000000000025 in the repo1: 13-1 archive",
"P01 DETAIL: found 000000070000000000000024 in the repo1: 13-1 archive",
"P01 DETAIL: found 000000070000000000000027 in the repo1: 13-1 archive",
"P02 DETAIL: found 000000070000000000000026 in the repo1: 13-1 archive",
"P00 DETAIL: unable to find 000000070000000000000028 in the archive",
"P00 DETAIL: statistics: {\"socket.client\":{\"total\":1},\"socket.session\":{\"total\":1},\"tls.client\":{\"total\":1},\"tls.session\":{\"total\":1}}",
" [filtered 24 lines of output]",
"P00 INFO: archive-get:async command begin 2.55.1: [000000070000000000000028, 000000070000000000000029, 00000007000000000000002A, 00000007000000000000002B, 00000007000000000000002C, 00000007000000000000002D, 00000007000000000000002E, 00000007000000000000002F] --archive-async --exec-id=1777-98b8e35e --log-level-console=off --log-level-file=detail --log-level-stderr=off --no-log-timestamp --pg1-path=/var/lib/pgsql/13/data --process-max=2 --repo1-host=repository --repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt --repo1-host-cert-file=/etc/pgbackrest/cert/client.crt --repo1-host-key-file=/etc/pgbackrest/cert/client.key --repo1-host-type=tls --spool-path=/var/spool/pgbackrest --stanza=demo",
"P00 INFO: get 8 WAL file(s) from archive: 000000070000000000000028...00000007000000000000002F",
"P01 DETAIL: found 000000070000000000000028 in the repo1: 13-1 archive",
"P02 DETAIL: found 000000070000000000000029 in the repo1: 13-1 archive",
"P01 DETAIL: found 00000007000000000000002A in the repo1: 13-1 archive",
"P02 DETAIL: found 00000007000000000000002B in the repo1: 13-1 archive",
"P01 DETAIL: found 00000007000000000000002C in the repo1: 13-1 archive",
"P02 DETAIL: found 00000007000000000000002D in the repo1: 13-1 archive",
"P00 DETAIL: unable to find 00000007000000000000002E in the archive",
"P00 DETAIL: statistics: {\"socket.client\":{\"total\":1},\"socket.session\":{\"total\":1},\"tls.client\":{\"total\":1},\"tls.session\":{\"total\":1}}",
" [filtered 7 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres psql -c \"alter user replicator password 'jw8s0F4'\""
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"ALTER ROLE"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg2-host" : {
"value" : "pg-standby"
},
"pg2-host-ca-file" : {
"value" : "/etc/pgbackrest/cert/ca.crt"
},
"pg2-host-cert-file" : {
"value" : "/etc/pgbackrest/cert/client.crt"
},
"pg2-host-key-file" : {
"value" : "/etc/pgbackrest/cert/client.key"
},
"pg2-host-type" : {
"value" : "tls"
},
"pg2-path" : {
"value" : "/var/lib/pgsql/13/data"
}
},
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/13/data",
"pg2-host=pg-standby",
"pg2-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg2-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg2-host-key-file=/etc/pgbackrest/cert/client.key",
"pg2-host-type=tls",
"pg2-path=/var/lib/pgsql/13/data",
"",
"[demo-alt]",
"pg1-host=pg-alt",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=*",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --log-level-console=detail backup"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"backup file pg-primary|replay on the standby"
]
},
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 2 lines of output]",
"P00 INFO: execute non-exclusive backup start: backup begins after the requested immediate checkpoint completes",
"P00 INFO: backup start archive = 00000007000000000000002F, lsn = 0/2F000028",
"P00 INFO: wait for replay on the standby to reach 0/2F000028",
"P00 INFO: replay on the standby reached 0/2F000028",
"P00 INFO: check archive for prior segment 00000007000000000000002E",
"P01 DETAIL: backup file pg-primary:/var/lib/pgsql/13/data/log/postgresql.log (11KB, 0.47%) checksum a243e99af415b81bf4d9d0ec91af46983eed09df",
"P01 DETAIL: backup file pg-primary:/var/lib/pgsql/13/data/global/pg_control (8KB, 0.82%) checksum b2232ca69c379dce910b569560f7c1ada80e9da6",
"P01 DETAIL: backup file pg-primary:/var/lib/pgsql/13/data/pg_hba.conf (4.5KB, 1.01%) checksum 65e54ae24bda87b2542351cb16a7fecc7e5aceeb",
"P01 DETAIL: match file from prior backup pg-primary:/var/lib/pgsql/13/data/current_logfiles (26B, 1.02%) checksum 78a9f5c10960f0d91fcd313937469824861795a2",
"P01 DETAIL: match file from prior backup pg-primary:/var/lib/pgsql/13/data/pg_logical/replorigin_checkpoint (8B, 1.02%) checksum 347fc8f2df71bd4436e38bd1516ccd7ea0d46532",
" [filtered 1243 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl stop postgresql-13.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres /usr/pgsql-14/bin/initdb \\",
" -D /var/lib/pgsql/14/data -k -A peer"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sh -c 'cd /var/lib/pgsql && \\",
" /usr/pgsql-14/bin/pg_upgrade \\",
" --old-bindir=/usr/pgsql-13/bin \\",
" --new-bindir=/usr/pgsql-14/bin \\",
" --old-datadir=/var/lib/pgsql/13/data \\",
" --new-datadir=/var/lib/pgsql/14/data \\",
" --old-options=\" -c config_file=/var/lib/pgsql/13/data/postgresql.conf\" \\",
" --new-options=\" -c config_file=/var/lib/pgsql/14/data/postgresql.conf\"'"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"Upgrade Complete"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
" [filtered 68 lines of output]",
"Checking for extension updates ok",
"",
"Upgrade Complete",
"----------------",
"Optimizer statistics are not transferred by pg_upgrade.",
" [filtered 4 lines of output]"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"cat /root/postgresql.common.conf >> /var/lib/pgsql/14/data/postgresql.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : "root"
},
"type" : "exe"
},
{
"key" : {
"file" : "/var/lib/pgsql/14/data/postgresql.conf",
"host" : "pg-primary",
"option" : {
"archive_command" : {
"value" : "'pgbackrest --stanza=demo archive-push %p'"
},
"archive_mode" : {
"value" : "on"
},
"log_filename" : {
"value" : "'postgresql.log'"
},
"max_wal_senders" : {
"value" : "3"
},
"wal_level" : {
"value" : "replica"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"archive_command = 'pgbackrest --stanza=demo archive-push %p'",
"archive_mode = on",
"log_filename = 'postgresql.log'",
"max_wal_senders = 3",
"wal_level = replica"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-primary",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/14/data"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/14/data",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"repo1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"repo1-host-key-file=/etc/pgbackrest/cert/client.key",
"repo1-host-type=tls",
"spool-path=/var/spool/pgbackrest",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=demo",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "pg-standby",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/14/data"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-path=/var/lib/pgsql/14/data",
"recovery-option=primary_conninfo=host=172.17.0.6 port=5432 user=replicator",
"",
"[global]",
"archive-async=y",
"log-level-file=detail",
"repo1-host=repository",
"repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"repo1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"repo1-host-key-file=/etc/pgbackrest/cert/client.key",
"repo1-host-type=tls",
"spool-path=/var/spool/pgbackrest",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=demo",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key",
"",
"[global:archive-get]",
"process-max=2",
"",
"[global:archive-push]",
"process-max=2"
]
}
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"demo" : {
"pg1-path" : {
"value" : "/var/lib/pgsql/14/data"
},
"pg2-path" : {
"value" : "/var/lib/pgsql/14/data"
}
},
"global" : {
"backup-standby" : {
"value" : "n"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/14/data",
"pg2-host=pg-standby",
"pg2-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg2-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg2-host-key-file=/etc/pgbackrest/cert/client.key",
"pg2-host-type=tls",
"pg2-path=/var/lib/pgsql/14/data",
"",
"[demo-alt]",
"pg1-host=pg-alt",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"backup-standby=n",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=*",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo cp /var/lib/pgsql/13/data/pg_hba.conf \\",
" /var/lib/pgsql/14/data/pg_hba.conf"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --no-online \\",
" --log-level-console=info stanza-upgrade"
],
"highlight" : {
"filter" : true,
"filter-context" : 2,
"list" : [
"completed successfully"
]
},
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 INFO: stanza-upgrade command begin 2.55.1: --exec-id=6035-d86ea449 --log-level-console=info --log-level-file=detail --no-log-timestamp --no-online --pg1-path=/var/lib/pgsql/14/data --repo1-host=repository --repo1-host-ca-file=/etc/pgbackrest/cert/ca.crt --repo1-host-cert-file=/etc/pgbackrest/cert/client.crt --repo1-host-key-file=/etc/pgbackrest/cert/client.key --repo1-host-type=tls --stanza=demo",
"P00 INFO: stanza-upgrade for stanza 'demo' on repo1",
"P00 INFO: stanza-upgrade command end: completed successfully"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-14.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl status postgresql-14.service"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-primary",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm -rf /var/lib/pgsql/13/data"
],
"host" : "pg-primary",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo rm -rf /var/lib/pgsql/13/data"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres mkdir -p -m 700 /usr/pgsql-14/bin"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo check"
],
"host" : "repository",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe",
"value" : {
"output" : [
"P00 WARN: unable to check pg2: [DbConnectError] raised from remote-0 tls protocol on 'pg-standby': unable to connect to 'dbname='postgres' port=5432': could not connect to server: No such file or directory",
" \tIs the server running locally and accepting",
" \tconnections on Unix domain socket \"/run/postgresql/.s.PGSQL.5432\"?"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u pgbackrest pgbackrest --stanza=demo --type=full backup"
],
"host" : "repository",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo --type=standby restore"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/var/lib/pgsql/14/data/postgresql.conf",
"host" : "pg-standby",
"option" : {
"hot_standby" : {
"value" : "on"
}
}
},
"type" : "cfg-postgresql",
"value" : {
"config" : [
"hot_standby = on"
]
}
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo systemctl start postgresql-14.service"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres sleep 2"
],
"host" : "pg-standby",
"load-env" : true,
"output" : false,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"bash-wrap" : true,
"cmd" : [
"sudo -u postgres pgbackrest --stanza=demo check"
],
"host" : "pg-standby",
"load-env" : true,
"output" : true,
"run-as-user" : null
},
"type" : "exe"
},
{
"key" : {
"file" : "/etc/pgbackrest/pgbackrest.conf",
"host" : "repository",
"option" : {
"global" : {
"backup-standby" : {
"value" : "y"
}
}
}
},
"type" : "cfg-pgbackrest",
"value" : {
"config" : [
"[demo]",
"pg1-host=pg-primary",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/14/data",
"pg2-host=pg-standby",
"pg2-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg2-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg2-host-key-file=/etc/pgbackrest/cert/client.key",
"pg2-host-type=tls",
"pg2-path=/var/lib/pgsql/14/data",
"",
"[demo-alt]",
"pg1-host=pg-alt",
"pg1-host-ca-file=/etc/pgbackrest/cert/ca.crt",
"pg1-host-cert-file=/etc/pgbackrest/cert/client.crt",
"pg1-host-key-file=/etc/pgbackrest/cert/client.key",
"pg1-host-type=tls",
"pg1-path=/var/lib/pgsql/13/data",
"",
"[global]",
"backup-standby=y",
"process-max=3",
"repo1-path=/var/lib/pgbackrest",
"repo1-retention-full=2",
"start-fast=y",
"tls-server-address=*",
"tls-server-auth=pgbackrest-client=*",
"tls-server-ca-file=/etc/pgbackrest/cert/ca.crt",
"tls-server-cert-file=/etc/pgbackrest/cert/server.crt",
"tls-server-key-file=/etc/pgbackrest/cert/server.key"
]
}
}
]
}
}
}
pgbackrest-release-2.55.1/doc/resource/fake-cert/ 0000775 0000000 0000000 00000000000 15006170376 0021611 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/resource/fake-cert/.gitignore 0000664 0000000 0000000 00000000014 15006170376 0023574 0 ustar 00root root 0000000 0000000 *.csr
*.srl
pgbackrest-release-2.55.1/doc/resource/fake-cert/README.md 0000664 0000000 0000000 00000003057 15006170376 0023075 0 ustar 00root root 0000000 0000000 # pgBackRest Documentation Certificates
The certificates in this directory are used for documentation generation only and should not be used for actual services.
## pgBackRest CA
Generate a CA that will be used to sign documentation certificates. It can be installed in the documentation containers to make certificates signed by it valid.
```
cd [pgbackrest-root]/doc/resource/fake-cert
openssl ecparam -genkey -name prime256v1 | openssl ec -out ca.key
openssl req -new -x509 -extensions v3_ca -key ca.key -out ca.crt -days 99999 \
-subj "/C=US/ST=All/L=All/O=pgBackRest/CN=pgbackrest.org"
```
## S3 Certificate
Mimic an S3 certificate for the `us-east-1`/`us-east-2` region to generate S3 documentation.
```
cd [pgbackrest-root]/doc/resource/fake-cert
openssl ecparam -genkey -name prime256v1 | openssl ec -out s3-server.key
openssl req -new -sha256 -nodes -out s3-server.csr -key s3-server.key -config s3.cnf
openssl x509 -req -in s3-server.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
-out s3-server.crt -days 99999 -extensions v3_req -extfile s3.cnf
```
## Azure Certificate
Mimic an Azure certificate for the `*.blob.core.windows.net` hosts to generate Azure documentation.
```
cd [pgbackrest-root]/doc/resource/fake-cert
openssl ecparam -genkey -name prime256v1 | openssl ec -out azure-server.key
openssl req -new -sha256 -nodes -out azure-server.csr -key azure-server.key -config azure.cnf
openssl x509 -req -in azure-server.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
-out azure-server.crt -days 99999 -extensions v3_req -extfile azure.cnf
```
pgbackrest-release-2.55.1/doc/resource/fake-cert/azure-server.crt 0000664 0000000 0000000 00000001446 15006170376 0024762 0 ustar 00root root 0000000 0000000 -----BEGIN CERTIFICATE-----
MIICJjCCAc2gAwIBAgIUdW+DRN7XbILssJmdxycMz90EEwUwCgYIKoZIzj0EAwIw
VzELMAkGA1UEBhMCVVMxDDAKBgNVBAgMA0FsbDEMMAoGA1UEBwwDQWxsMRMwEQYD
VQQKDApwZ0JhY2tSZXN0MRcwFQYDVQQDDA5wZ2JhY2tyZXN0Lm9yZzAgFw0yMDA2
MjkxOTM0MjhaGA8yMjk0MDQxMzE5MzQyOFowdzELMAkGA1UEBhMCVVMxDDAKBgNV
BAgMA0FsbDEMMAoGA1UEBwwDQWxsMRMwEQYDVQQKDApwZ0JhY2tSZXN0MRwwGgYD
VQQLDBNVbml0IFRlc3RpbmcgRG9tYWluMRkwFwYDVQQDDBBjb3JlLndpbmRvd3Mu
bmV0MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEqQy14z/cTAwvIDUCgU+5ATJh
5hsvMaUrYfuCEFC9tx7+zeqrEbtWOqO1dQVnCfZr38lwrTDzJvZJKqh4rTlWoKNV
MFMwCQYDVR0TBAIwADALBgNVHQ8EBAMCBeAwOQYDVR0RBDIwMIIVYmxvYi5jb3Jl
LndpbmRvd3MubmV0ghcqLmJsb2IuY29yZS53aW5kb3dzLm5ldDAKBggqhkjOPQQD
AgNHADBEAiB5RbKWvkzISbAHRqkg4egKcitsijqZsPJgpj4X91ercwIgBJmMNKVP
ELrECSmLFbJQCIZJAMcbzmLxZNcnsRaMUG8=
-----END CERTIFICATE-----
pgbackrest-release-2.55.1/doc/resource/fake-cert/azure-server.key 0000664 0000000 0000000 00000000343 15006170376 0024755 0 ustar 00root root 0000000 0000000 -----BEGIN EC PRIVATE KEY-----
MHcCAQEEIEGn3zrwzQ8+ZP6i+eye3iqQybiBK4ap+JAQ0uNGEMP1oAoGCCqGSM49
AwEHoUQDQgAEqQy14z/cTAwvIDUCgU+5ATJh5hsvMaUrYfuCEFC9tx7+zeqrEbtW
OqO1dQVnCfZr38lwrTDzJvZJKqh4rTlWoA==
-----END EC PRIVATE KEY-----
pgbackrest-release-2.55.1/doc/resource/fake-cert/azure.cnf 0000664 0000000 0000000 00000000614 15006170376 0023430 0 ustar 00root root 0000000 0000000 [req]
default_bits = 4096
prompt = no
default_md = sha256
req_extensions = v3_req
distinguished_name = dn
[ dn ]
C=US
ST=All
L=All
O=pgBackRest
OU=Unit Testing Domain
CN = core.windows.net
[ v3_req ]
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment
subjectAltName = @alt_names
[ alt_names ]
DNS.1 = blob.core.windows.net
DNS.2 = *.blob.core.windows.net
pgbackrest-release-2.55.1/doc/resource/fake-cert/ca.crt 0000664 0000000 0000000 00000001351 15006170376 0022706 0 ustar 00root root 0000000 0000000 -----BEGIN CERTIFICATE-----
MIIB+jCCAaCgAwIBAgIJAJDUUhiBUbmEMAoGCCqGSM49BAMCMFcxCzAJBgNVBAYT
AlVTMQwwCgYDVQQIDANBbGwxDDAKBgNVBAcMA0FsbDETMBEGA1UECgwKcGdCYWNr
UmVzdDEXMBUGA1UEAwwOcGdiYWNrcmVzdC5vcmcwIBcNMTkwNTI3MDAxOTU5WhgP
MjI5MzAzMTAwMDE5NTlaMFcxCzAJBgNVBAYTAlVTMQwwCgYDVQQIDANBbGwxDDAK
BgNVBAcMA0FsbDETMBEGA1UECgwKcGdCYWNrUmVzdDEXMBUGA1UEAwwOcGdiYWNr
cmVzdC5vcmcwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAAQYHUcSknRDL+fgFJZI
IC73Ju75yA0203IxPO35i8mVb9CcWVhEgHmS+cQ6SfY6GC7V61VB7gwzQ+XESi2p
ndhJo1MwUTAdBgNVHQ4EFgQUYMbKIlTUE6gklw8KcSC6fnlOitwwHwYDVR0jBBgw
FoAUYMbKIlTUE6gklw8KcSC6fnlOitwwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjO
PQQDAgNIADBFAiEA1Bzy17/6jQimg3ROZTrVGkRtAuzTtjgDParHFrIhSDoCIH43
OeOUaPVb0rXGPLu9rFpjPOmtFSW3lf4skheJMKyN
-----END CERTIFICATE-----
pgbackrest-release-2.55.1/doc/resource/fake-cert/ca.key 0000664 0000000 0000000 00000000343 15006170376 0022706 0 ustar 00root root 0000000 0000000 -----BEGIN EC PRIVATE KEY-----
MHcCAQEEIB5f3SxfiZ92GMpuqpfTiPO3xaVOnxRh6qVAoRtu7NOZoAoGCCqGSM49
AwEHoUQDQgAEGB1HEpJ0Qy/n4BSWSCAu9ybu+cgNNtNyMTzt+YvJlW/QnFlYRIB5
kvnEOkn2Ohgu1etVQe4MM0PlxEotqZ3YSQ==
-----END EC PRIVATE KEY-----
pgbackrest-release-2.55.1/doc/resource/fake-cert/s3-server.crt 0000664 0000000 0000000 00000001610 15006170376 0024152 0 ustar 00root root 0000000 0000000 -----BEGIN CERTIFICATE-----
MIICbTCCAhOgAwIBAgIJAODTXyGnxWtVMAoGCCqGSM49BAMCMFcxCzAJBgNVBAYT
AlVTMQwwCgYDVQQIDANBbGwxDDAKBgNVBAcMA0FsbDETMBEGA1UECgwKcGdCYWNr
UmVzdDEXMBUGA1UEAwwOcGdiYWNrcmVzdC5vcmcwIBcNMTkwNTI3MDIwODEwWhgP
MjI5MzAzMTAwMjA4MTBaMIGBMQswCQYDVQQGEwJVUzEMMAoGA1UECAwDQWxsMQww
CgYDVQQHDANBbGwxEzARBgNVBAoMCnBnQmFja1Jlc3QxHDAaBgNVBAsME1VuaXQg
VGVzdGluZyBEb21haW4xIzAhBgNVBAMMGnMzLnVzLWVhc3QtMS5hbWF6b25hd3Mu
Y29tMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEEe2dO1v1gE0Qj4H407i0K8tN
kASkveckACPFzXs2i/++rZY4bwUub08JcMRv0WWwnRzOoumsN26Ge454vTbjoqOB
mjCBlzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIF4DB9BgNVHREEdjB0ghpzMy51cy1l
YXN0LTEuYW1hem9uYXdzLmNvbYIcKi5zMy51cy1lYXN0LTEuYW1hem9uYXdzLmNv
bYIaczMudXMtZWFzdC0yLmFtYXpvbmF3cy5jb22CHCouczMudXMtZWFzdC0yLmFt
YXpvbmF3cy5jb20wCgYIKoZIzj0EAwIDSAAwRQIgLiE7LuK6O/bKo70XPUi6xoDE
ew+EHO31klTOeWiS6oMCIQCHMEqSAcDF/gnG/UXnp2viHOFjnY+NZgQo76l+/2mE
iQ==
-----END CERTIFICATE-----
pgbackrest-release-2.55.1/doc/resource/fake-cert/s3-server.key 0000664 0000000 0000000 00000000343 15006170376 0024154 0 ustar 00root root 0000000 0000000 -----BEGIN EC PRIVATE KEY-----
MHcCAQEEIBhweMaCuhrRJy6hLV9X7QRCorDdyiUvSWEySHXZJM4DoAoGCCqGSM49
AwEHoUQDQgAEEe2dO1v1gE0Qj4H407i0K8tNkASkveckACPFzXs2i/++rZY4bwUu
b08JcMRv0WWwnRzOoumsN26Ge454vTbjog==
-----END EC PRIVATE KEY-----
pgbackrest-release-2.55.1/doc/resource/fake-cert/s3.cnf 0000664 0000000 0000000 00000000750 15006170376 0022630 0 ustar 00root root 0000000 0000000 [req]
default_bits = 4096
prompt = no
default_md = sha256
req_extensions = v3_req
distinguished_name = dn
[ dn ]
C=US
ST=All
L=All
O=pgBackRest
OU=Unit Testing Domain
CN = s3.us-east-1.amazonaws.com
[ v3_req ]
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment
subjectAltName = @alt_names
[ alt_names ]
DNS.1 = s3.us-east-1.amazonaws.com
DNS.2 = *.s3.us-east-1.amazonaws.com
DNS.3 = s3.us-east-2.amazonaws.com
DNS.4 = *.s3.us-east-2.amazonaws.com
pgbackrest-release-2.55.1/doc/resource/git-history.cache 0000664 0000000 0000000 00006144730 15006170376 0023236 0 ustar 00root root 0000000 0000000 [
{
"commit": "8bbb98243566bfa052f6aacfd1bd3a6acd770e40",
"date": "2025-05-01 13:22:15 -0400",
"subject": "Revert \"calculate content-md5 on S3 only when required\".",
"body": "20bfd14 removed content-md5 where allowed by the specification but failed to notice that either content-md5 or x-amz-content-* is required for PUT when object lock is enabled.\n\nOn top of that it appears Scality S3 (at least?) won't accept alternate content checksums when object lock is enabled. Technically this is a violation of the specification but nonetheless the change breaks working installations.\n\nFor now it seems safer to revert this change and pursue a better solution for a future feature release."
},
{
"commit": "5e01098617a3803067b153be2d41e023cd4d95e4",
"date": "2025-05-01 13:06:18 -0400",
"subject": "Fix lower bounds checking for option keys.",
"body": "Specifying an indexed option with a key of 0, e.g. pg0-path, would lead to a segfault.\n\nAdd lower bounds checking to fix the issue."
},
{
"commit": "293bc2a75d5cbe364f443bb87a998d76e4618ac2",
"date": "2025-05-01 12:53:05 -0400",
"subject": "Add details about notifying packagers to release instructions."
},
{
"commit": "6c0e21292629efaf53e513c5badc0824a10a1e79",
"date": "2025-05-01 12:38:37 -0400",
"subject": "Begin v2.55.1 development."
},
{
"commit": "6c90196e74ef0da38568f08fd7cb234d10130e79",
"date": "2025-04-21 18:25:00 -0400",
"subject": "v2.55.0: Verification Improvements and PostgreSQL 18 Support"
},
{
"commit": "4bb7cb1ac65a135e3f311ef288f2ad946493266b",
"date": "2025-04-21 09:02:56 -0400",
"subject": "Fix incorrect not-equal comparison in TEST_RESULT_Z_NE().",
"body": "This comparison was not being used for strings in the tests but best to fix it so it does not cause confusion in the future."
},
{
"commit": "9386920b79971347c6c57589190bf09b591d8b4d",
"date": "2025-04-16 12:26:15 -0500",
"subject": "Add FAQ about exporting self-contained cluster."
},
{
"commit": "c2f64bb03bdbb2ce883041118dbcfd79da3f1307",
"date": "2025-04-15 16:50:40 -0500",
"subject": "Fix highlight error in user guide.",
"body": "87776bc9 updated the RHEL documentation to PostgreSQL 13/14 but did not update recovery highlighting to be compatible with RHEL. This was not caught because the RHEL documentation was being build as PDF, which does not do highlighting.\n\nInstead build the RHEL documentation as HTML in the first stage (and PDF in the second) so the error is caught.\n\nFinally, fix the RHEL documentation to generate the highlight by concatenating the log."
},
{
"commit": "8bdba747981e8805a9bf355050f70cdf19e9babc",
"date": "2025-04-14 13:34:35 -0500",
"subject": "Clarify incremental backup expiration.",
"body": "The documentation was a bit misleading regarding how incremental backups are expired. Update the misleading part (\"Differential and Incremental backups are count-based...\") and move the explanation of how incremental expiration works out of differential expiration into the introductory paragraph.\n\nAlso add a note about how full backups are considered as differential for the purpose of expiration."
},
{
"commit": "565d2e0c47cd21df890a40b3a94a8c865bed76d9",
"date": "2025-04-14 12:29:31 -0500",
"subject": "PostgreSQL 18 experimental support.",
"body": "Support is experimental since PostgreSQL 18 is still in development and has not released a beta, but it may be useful for testing."
},
{
"commit": "019e4cf8a779ee2572a5227ef2d80c3036f877f9",
"date": "2025-04-14 10:46:55 -0500",
"subject": "Another fix for integration tests on alternate architectures.",
"body": "37544da5 missed another place where 57ffd2df had accidentally hard-coded the integration test architecture to x86_64.\n\nFix the test code to use the correct image based on architecture."
},
{
"commit": "48a43e76e2657bbdd871268124c5580eb7ce7caa",
"date": "2025-04-11 18:39:56 -0500",
"subject": "Enable format-overflow=2 compiler warning.",
"body": "Warn about calls to formatted input/output functions such as sprintf and vsprintf that might overflow the destination buffer.\n\nThis warning found a few short float buffers. In practice these are unlikely to ever be a problem based on our float usage but best to be safe.\n\nNote that this warning only requires the buffer size to be 317 but it must be 318 to prevent warnings from -Wformat-truncation=2. We are not ready to enable that warning yet but seems better to get the buffer correct now."
},
{
"commit": "5fe23ff07b0e6e1bea9f36d49b3f03a62a7be861",
"date": "2025-04-11 17:02:14 -0500",
"subject": "Remove implied -Wformat-nonliteral warning.",
"body": "-Wformat-nonliteral is already implied by -format=2."
},
{
"commit": "9fba07c26dc5ff353f86afc7f7bdf61edf1c8781",
"date": "2025-04-11 16:52:45 -0500",
"subject": "Remove -Wno-implicit-fallthrough and explicitly mark fallthrough.",
"body": "Last time we tried this the markered seems a bit unreliable but __attribute__((fallthrough)) appears to work pretty well."
},
{
"commit": "a076ee63bd99d1af293c30645f79893579382060",
"date": "2025-04-10 15:29:37 -0500",
"subject": "Remove unmaintained/unused development environment build files.",
"body": "The Vagrantfile has not been maintained in years and the Dockerfile is only used by a single developer. There are instructions for building a development environment in CONTRIBUTING.md so these build files are no longer required."
},
{
"commit": "dd3a7d99a78d0d604967d90e8a8dbf8915432896",
"date": "2025-04-10 12:08:35 -0500",
"subject": "Recommend not placing spool-path within pg_xlog/pg_wal.",
"body": "This is generally not a good idea and it can cause problems for PostgreSQL tools such as pg_rewind."
},
{
"commit": "cab4d6fd5c775d6e1a9cd9889d825eee667b5322",
"date": "2025-04-10 10:26:50 -0500",
"subject": "Warn when a value for a multi-key option is overwritten.",
"body": "Some options can contain multiple key/value pairs. However, if if the key is specified again the value will be silently overwritten. In most cases one value per key is appropriate, but it makes sense to warn the user about the overwrite."
},
{
"commit": "68f22aea6665b9dcbe76dbfaa731f37187e1ce20",
"date": "2025-04-09 14:50:16 -0500",
"subject": "Allow connections to PostgreSQL on abstract domain sockets.",
"body": "Currently the pg-socket-path option is required to be a valid absolute path but this precludes the use of abstract domain sockets.\n\nSet the option type to string so abstract domain sockets are allowed. This removes some validation but libpq will report if the path is invalid and we don't use it for any other purpose."
},
{
"commit": "20bfd14b73ad6d75b6fb1169565b18dcfa183c9b",
"date": "2025-04-09 12:27:27 -0500",
"subject": "Calculate content-md5 on S3 only when required.",
"body": "The content-md5 header was generated for all requests with content but it is only required for batch delete requests. It is not clear why this header is required when x-amz-content-sha256 is also provided or why it is required only for this request but the documentation is clear on the matter. However, the content for these requests is relatively small compared to uploading files so omitting content-md5 where possible will save some CPU cycles.\n\nCurrent AWS S3 and recent Minio don't complain if this header is missing but since it is still required by older versions of Minio and it is specified in the documentation for batch delete it is makes sense to keep it."
},
{
"commit": "c925832e1737f1b5cac347c482a725a87f2237cb",
"date": "2025-04-09 12:02:19 -0500",
"subject": "Add LSTDEF() macro.",
"body": "This macro allows static List objects to be created which simplifies usage when passing lists to functions. Also, since List objects are commonly used this makes the code base a bit more consistent.\n\nFor now skip static lists that are only used locally within a function since the benefit is not as clear."
},
{
"commit": "53a45d25c3e60e5067010b2676f5d6216638fbe3",
"date": "2025-04-08 10:45:06 -0500",
"subject": "Fix documentation for specifying multiple stanzas with tls-server-auth.",
"body": "The prior documentation said that multiple stanzas should be specified by repeating the tls-server-auth option. This is incorrect -- in fact a comma-separated list of stanza should be used.\n\nFix the documentation and add a test to confirm this behavior.\n\nIn passing add some const qualifiers that were missing in the relevant code."
},
{
"commit": "37544da56c711fc0a344d0a292488d4265b9cabc",
"date": "2025-04-07 11:57:00 -0500",
"subject": "Fix integration tests on alternate architectures.",
"body": "57ffd2df accidentally hard-coded the integration test architecture to x86_64 and it was not noticed because in CI all the integration tests run on that architecture.\n\nFix the test code to retrieve the current architecture and use it for integration tests."
},
{
"commit": "e18ca19895bd3dbb0a6718bb6f01b9e43010fbb7",
"date": "2025-04-04 10:26:03 -0500",
"subject": "Remove extraneous const from cvtIntToZ() prototype."
},
{
"commit": "aeea81a3883e320d071f72152b86cff9944dd50f",
"date": "2025-04-04 10:07:32 -0500",
"subject": "Fix test logging in storageHelperDryRunInit()."
},
{
"commit": "cc50e1aecd0ba7b35b451c97ac082fbd3b46591b",
"date": "2025-04-02 15:25:23 -0500",
"subject": "Revert \"full/incremental backup method\".",
"body": "This method was introduced in cad595f but on further reflection it does not seem worth the added complexity just to make restore consistency faster without improving the speed of the overall backup. The most common recovery case is PITR and this method produces diminishing returns as the recovery time gets further from the backup end time.\n\nA better solution (not implemented here) is to copy unmodified files from prior backups. This is much faster than recopying and compressing files from the cluster (especially on object stores with a copy command) and can even be done after the backup window to further reduce WAL replay required for consistency. It also reduces load on the host where the backup is made."
},
{
"commit": "4a42eec552233f34e0ace251e201a4e7e5021f21",
"date": "2025-04-02 11:59:38 -0500",
"subject": "Set noResetLogLevel in config/parse unit tests where required.",
"body": "This prevents the logging from getting reset so later tests can validate warnings."
},
{
"commit": "33655095f469d37a34aa7ed33855d1b2fa2e529c",
"date": "2025-03-31 19:30:41 -0500",
"subject": "Use latest Minio image for testing.",
"body": "It has been a while since a Minio bug has broken the tests so go back to testing against the latest version until the trust is broken again."
},
{
"commit": "dcfe30e322091dae49b00d77c731c9b31f1ae7dd",
"date": "2025-03-31 14:18:29 -0500",
"subject": "Fix instances of \"of of\"."
},
{
"commit": "b28ae98cec7ae7e881e6476c1cba1ba7e1abc358",
"date": "2025-03-31 12:24:03 -0500",
"subject": "Update unix_socket_directory to unix_socket_directories.",
"body": "unix_socket_directory has not been valid since PostgreSQL 9.2 and since 9.5 is now the minimum supported version there is no reason to document both."
},
{
"commit": "e4def8845eb5c3fe9fb8cc44d9f64766cfb348c2",
"date": "2025-03-26 08:44:29 -0600",
"subject": "Allow verification of a specified backup.",
"body": "Add support for the verify command --set option. This (internal) option was already accepted without errors but was not implemented.\n\nThe default behavior for verify is to check all the backups present. With the --set option only the specified backup will be verified. If the specified backup label is not valid an error is added to the result and verification is skipped. In addition, only WAL required to make the specified backup consistent will be verified."
},
{
"commit": "945c7d1eb67a97c00c32d8f121bca93d90c3ec80",
"date": "2025-03-25 12:43:32 -0600",
"subject": "Update verify command summary.",
"body": "The prior text implied that verify could only operate on a single repository. Make the summary more general to indicate that the command can work on any repository."
},
{
"commit": "1cfafa386c860a8f756c658130de869446445cdd",
"date": "2025-03-25 11:00:53 -0600",
"subject": "Strip version from RHEL label in user guide.",
"body": "RHEL 7 is EOL so remove it from the label. Rather than update the version range just remove it from the label since the user guide is generally applicable to RHEL."
},
{
"commit": "87776bc9cfb4af369ed22d8a116145cb1e5a5eae",
"date": "2025-03-25 10:28:46 -0600",
"subject": "Update PostgresQL versions in user guide.",
"body": "PostgreSQL 12 is EOL and no longer available in the yum.postgresql.org repository.\n\nUpdate the base and update versions of the RHEL and Debian documentation to better cover supported versions."
},
{
"commit": "84eb9a742dcf75f071e011946263dedaa985099e",
"date": "2025-03-24 12:21:31 -0600",
"subject": "Clarify behavior of --repo-retention-full-type.",
"body": "Make some clarifications and add explicit documentation for repo-retention-full-type=count."
},
{
"commit": "5d2c67c3c6975ea3ed08c7425f6e410ae378913f",
"date": "2025-03-21 10:37:20 -0600",
"subject": "Fix block incremental restore issue on non-default repository.",
"body": "If the selected backup to restore was not in the default (lowest number) repository and block incremental was used, then restore would erroneously try to load the file super block list from the default repository. Specifying --repo would fix this since it changed the default repository.\n\nFix by updating the super block read to the specified repository."
},
{
"commit": "723f900eaa41d58edc5cc58444029ab7c272acb1",
"date": "2025-03-21 09:01:02 -0600",
"subject": "Fix missing return in FUNCTION_LOG_RETURN_VOID().",
"body": "This macro is only ever called last in functions so this is not an active issue, but it makes sense to fix since it would pose a risk for future development."
},
{
"commit": "d10ad3780a46ae321aa1db4f146655eba1cfda8b",
"date": "2025-03-19 11:17:59 -0600",
"subject": "Fix test logging."
},
{
"commit": "f00c0d4e853a2384fe9e333daa640659e6cd6d31",
"date": "2025-03-19 09:34:32 -0600",
"subject": "Fix comments in unit tests."
},
{
"commit": "750a051b7aeccc3dd7ae9c07af2c73cb25057de9",
"date": "2025-02-28 16:53:03 -0600",
"subject": "Add numeric output to version command.",
"body": "Add a new output option to the version command that defaults to text (current behavior) but can be set to num to output the version in a numeric format, e.g. 2055000.\n\nThis makes it easier to compare and identify versions of pgBackRest."
},
{
"commit": "57ffd2dfcbc47300d61d901789c6d09ffc8e25b2",
"date": "2025-02-28 15:38:05 -0600",
"subject": "Fix multi-architecture unit testing.",
"body": "The Github action we were using for multi-architecture testing stopped working. The project does not seem to be getting regular maintenance so it seems better to roll multi-architecture testing into our existing container builds.\n\nIntroduce multi-architecture builds and testing into our test framework. For now this only works for unit tests -- integration tests will still only run on x86_64. That could be updated in the future but since emulation is so slow it is not clear if it would be useful.\n\nAlso fix an invalid 32-bit checksum. The d11 test had not been running as 32-bit since d8ff89a so the checksum was not updated when it should have been in 48f511d."
},
{
"commit": "814bf487c3955e877d226faaa22324d3c79863b2",
"date": "2025-02-25 16:37:22 -0600",
"subject": "Add support for GCS requester pays.",
"body": "GCS user projects allow the bucket requester to be billed rather than the bucket owner. This is useful for hosted services that create backups and want to provide direct (probably read-only) access to the backups."
},
{
"commit": "4db0263fd63274a8168eb4de17b320d2f86251a2",
"date": "2025-02-25 16:12:28 -0600",
"subject": "Add support for S3 requester pays.",
"body": "S3 requester pays allows the bucket requester to be billed rather than the bucket owner. This is useful for hosted services that create backups and want to provide direct (probably read-only) access to the backups."
},
{
"commit": "7941d6506e26cbfa1979b636554b1b5377f05c20",
"date": "2025-02-25 15:36:55 -0600",
"subject": "Remove unneeded verbiage from option descriptions.",
"body": "\"Setting this option\" didn't really add anything and was inconsistent with other option descriptions."
},
{
"commit": "f2bbfad29cee8468239d2340d5cf12204e352d10",
"date": "2025-02-21 08:24:57 -0600",
"subject": "Fix case in option summary."
},
{
"commit": "2155a12a3d861645de5618518350f90962fbc26d",
"date": "2025-02-17 11:51:51 -0600",
"subject": "Add detail logging for expired archive path.",
"body": "When archive expiration has a large number of files to remove it may look like the process has hung, at least at higher log levels.\n\nAdd a log message at detail level to show that progress is being made."
},
{
"commit": "4dcfa9ef59c5e75c6c0ee83390c64b9a3d4af1fc",
"date": "2025-02-17 10:56:57 -0600",
"subject": "Add detail logging to expire test.",
"body": "This is required to test logging to be added in a subsequent commit."
},
{
"commit": "82299eb4cd997524eeddef170ad99669ed6651cf",
"date": "2025-02-15 12:00:00 -0600",
"subject": "Clarify requirement for local/remote pgBackRest versions to match."
},
{
"commit": "47f050f8fd816e57326d881f4253d8a13c0f8da6",
"date": "2025-02-15 11:17:04 -0600",
"subject": "Fix expire archive range logging.",
"body": "The prior logging only output the last path to be removed since start was overwritten as each path was deleted. This had no affect on expire functionality but was confusing since many more files might be expired than the logs indicated.\n\nFix logging so the correct start path is logged."
},
{
"commit": "ef0a71d629bfd0729f3f8a55f38588ea25c64fb9",
"date": "2025-02-15 11:02:23 -0600",
"subject": "Update Cirrus-CI FreeBSD runner versions."
},
{
"commit": "aa7210a1830825e0a3e6b6740937357341127a6f",
"date": "2025-02-04 11:15:51 -0500",
"subject": "Change --process-max recommendation for object stores to --repo-bundle.",
"body": "While process-max is as useful for object stores as any other storage type, for file creation time in particular file bundling is far more effective since fewer files are created.\n\nUpdate the recommendation to reflect this."
},
{
"commit": "922e9f0775c39b64e009251a6bec8ef9b83c190f",
"date": "2025-02-04 10:06:17 -0500",
"subject": "Verify recovery target timeline.",
"body": "If the user picks an invalid timeline (or the default is invalid) they will not discover it until after the restore is complete and recovery starts. In that case they'll receive a message like this:\n\nFATAL: requested timeline 2 is not a child of this server's history\nDETAIL: Latest checkpoint is at 0/7000028 on timeline 1, but in the history of the requested timeline, the server forked off from that timeline at 0/600AA20.\n\nThis message generally causes confusion unless one is familiar with it. In this case 1) a standby was promoted creating a new timeline 2) a new backup was made from the primary 3) the new backup was restored but could not follow the new timeline because the backup was made after the new timeline forked off. Since PostgreSQL 12 following the latest timeline has been the default so this error has become common in split brain situations.\n\nImprove pgBackRest to read the history files and provide better error messages. Now this error is thrown before the restore starts:\n\nERROR: [058]: target timeline 2 forked from backup timeline 1 at 0/600aa20 which is before backup lsn of 0/7000028\n HINT: was the target timeline created by accidentally promoting a standby?\n HINT: was the target timeline created by testing a restore without --archive-mode=off?\n HINT: was the backup made after the target timeline was created?\n\nThis saves time since it happens before the restore and gives more information about what has gone wrong.\n\nIf the backup timeline is not an ancestor of the target timeline the error message is:\n\nERROR: [058]: backup timeline 6, lsn 0/4ffffff is not in the history of target timeline B\n HINT: was the target timeline created by promoting from a timeline < latest?\n\nThis situation should be rare but can happen during complex recovery scenarios where the user is explicitly setting the target time."
},
{
"commit": "322e764f295f65b2a1189e207f6115471f943b1b",
"date": "2025-01-30 21:43:48 -0500",
"subject": "Add Coverity build to release instructions."
},
{
"commit": "6e437defa93b8bc43e93aefcc4e7320633ac9651",
"date": "2025-01-30 14:28:28 -0500",
"subject": "Refactor backupBlockIncrMapSize() range handling to satisfy Coverity.",
"body": "Coverity complained about a possible overflow of result in the prior implementation.\n\nIt appears that Coverity was not able to follow the logic through the try block, but refactor and add an assertion to silence the complaint."
},
{
"commit": "89615eee654388ea046812bfaa30d514b269c5d1",
"date": "2025-01-30 13:59:42 -0500",
"subject": "Refactor loop in restoreManifestMap() to satisfy Coverity.",
"body": "Coverity complained that decrementing targetIdx would result in it equaling UINT_MAX. While this is true it had no impact overall (at it least in the current code) since targetIdx was immediately incremented in the loop.\n\nHowever, Coverity's suggestion is better and safer for future code updates so it makes sense to change it."
},
{
"commit": "5421ef3e92fb01efdddd235bd7a7c18d7dac6c37",
"date": "2025-01-30 13:48:59 -0500",
"subject": "Add cast to suppress Coverity complaint about volatile used in assert().",
"body": "Coverity had this complaint:\n\nassert_side_effect: Argument openData of ASSERT() has a side effect because the variable is volatile. The containing function might work differently in a non-debug build.\n\nIt appears this can also be fixed by assigning the volatile variable to an automatic but the cast seems to work just as well."
},
{
"commit": "d5cefb7290c34c64a2b9aa89ff04a718df4ec18b",
"date": "2025-01-29 13:48:26 -0500",
"subject": "Fix error reporting for queries with no results.",
"body": "If a query that expected no results returned an error then it would incorrectly report that no results were expected because the error was interpreted as a result.\n\nSwitch the order of the checks so that an error is reported instead and add a test to prevent regression."
},
{
"commit": "d50b01b4852d82020b840496603d620b00ea98f9",
"date": "2025-01-28 18:48:11 -0500",
"subject": "Add assertions to satisfy Coverity about possible underflows.",
"body": "Coverity complained about possible underflows so add assertions to demonstrate that the values in question are greater than zero."
},
{
"commit": "e46374dc7dc90275ff2836f152fb2b976dbe0e2a",
"date": "2025-01-28 15:30:23 -0500",
"subject": "Lower log level of backupDbPing()/dbPing() to trace.",
"body": "These functions get called very frequently even though they generally result in a noop at the protocol level.\n\nLower the log level to reduce noise in the log at debug level."
},
{
"commit": "e625ed8be2228cb99c3801f9d1776909a2201c5a",
"date": "2025-01-28 09:14:30 -0500",
"subject": "Caveat --tablespace-map-all regarding tablespace creation.",
"body": "If a tablespace is created after the backup starts then it cannot be mapped using --tablespace-map-all since there is no record of it in the manifest.\n\nThis would be extremely complex to fix but it can be documented."
},
{
"commit": "dde1b0477209512aabe1e9ca58836922a3c1661f",
"date": "2025-01-27 17:14:34 -0500",
"subject": "Add StringId linter.",
"body": "Verify that all StringIds in the project have been generated correctly.\n\nThis also makes it easy to generate new StringIds by copying an existing StringId and modifying the string. The error message will provide the required value."
},
{
"commit": "d582739d822bbdb705a6a946db6c87675d5c2ccc",
"date": "2025-01-27 15:51:57 -0500",
"subject": "Convert 5-bit test StringId to 6-bit.",
"body": "The original string was valid as either 5-bit or 6-bit but since we're trying to test 6-bit update the string to something only valid for 6-bit."
},
{
"commit": "6df96f505fd0f70d84b50ad36498c3a4c05a61bc",
"date": "2025-01-23 17:12:05 -0500",
"subject": "Separate version into component parts.",
"body": "This guarantees a consistent version representation and allows the version to be easily represented in other ways."
},
{
"commit": "6776940c3bbe8b61e851921099354c4e63d80d7b",
"date": "2025-01-23 14:55:44 -0500",
"subject": "Use three part version in development builds.",
"body": "This makes the versioning more consistent and is required by a subsequent commit that will separate the version components."
},
{
"commit": "e59385718c5bc207e96325a2f9ed06b9b4395218",
"date": "2025-01-23 08:10:37 -0500",
"subject": "Update CI containers to include newest PostgreSQL patch releases."
},
{
"commit": "6fbb28fa2d615576be78376c7f539921f6b8bc6a",
"date": "2025-01-23 07:58:41 -0500",
"subject": "Do not set recovery_target_timeline=current for PostgreSQL < 12.",
"body": "PostgreSQL < 12 defaults recovery_target_timeline to current but if current is explicitly set it behaves as if latest was set. Since current is not handled in the PostgreSQL code it looks as if there should be an error during the integer conversion but that doesn't happen due to incorrect strtoul() usage (not checking endptr).\n\nHandle this by omitting recovery_target_timeline from recovery.conf when it is explicitly set by the user to current."
},
{
"commit": "e58d468e27cb13346d50fe32af44ef12a057455b",
"date": "2025-01-21 18:39:51 -0500",
"subject": "Fix typo."
},
{
"commit": "931435c0177ded2189903385d520d5c8819c4f5e",
"date": "2025-01-21 11:45:50 -0500",
"subject": "Allow backup command to operate on remote repositories.",
"body": "The backup command has always been limited to working only when the repository is local. This was due to some limitations in storage (addressed in 01b81f9) and the protocol helper (addressed in 4a94b6be).\n\nNow that there a no limitations preventing this feature it makes sense to enable it. This allows for more flexibility in where backups are run."
},
{
"commit": "844f91fe3f3b04464a6a7b1fc7c743800db01933",
"date": "2025-01-20 15:12:27 -0500",
"subject": "Specify length of encoding strings.",
"body": "This saves a byte per string but more importantly makes them match the declaration of encodeHexLookup."
},
{
"commit": "4bc9376d6fe276a3bf40a5c5e7891676a0c88392",
"date": "2025-01-20 14:19:25 -0500",
"subject": "Remove \"Additional Notes\" header from release notes.",
"body": "This was intended to separate the code changes from documentation and test suite changes but it arguably does not add any clarity.\n\nSince documentation and test suite changes are explicitly marked as such that should be clear enough."
},
{
"commit": "23bd392bdcf76ecadc0eb9e76b60c34580590fae",
"date": "2025-01-20 14:09:54 -0500",
"subject": "Improve hex encode performance with bytewise lookup.",
"body": "Previously, hex encode looked up each nibble of the input separately. Instead use a larger lookup table containing the two-byte encoding of every possible input byte, resulting in a 1/3 reduction in encoding time.\n\nInspired by and mostly cribbed from PostgreSQL commit e24d7708."
},
{
"commit": "713f6657d36746221a47989ee2e6ea369fd008dd",
"date": "2025-01-20 10:57:27 -0500",
"subject": "Merge v2.54.2 release."
},
{
"commit": "7a33d6168b2650515ded488c2e1b7eabd1d942a8",
"date": "2025-01-14 13:10:32 -0500",
"subject": "Replace constant version with macro in backup test module."
},
{
"commit": "6244f02bb3f44f985df5562a90400b3e7c9b9163",
"date": "2025-01-14 10:50:48 -0500",
"subject": "Update runner versions on Github actions.",
"body": "Ubuntu 20.04 will be EOL soon so update all actions that are using it. Update other actions as far as possible without making too many changes."
},
{
"commit": "fd23257c6a52acd39b3d2deab8bcf905605dbc12",
"date": "2025-01-06 13:50:14 -0500",
"subject": "Remove extraneous const qualifier."
},
{
"commit": "b5bb1aa72c3a2fce6b5a024a815db4a09aa421e1",
"date": "2025-01-05 13:32:09 -0500",
"subject": "Remove makefile formatting from editor config.",
"body": "This is no longer required since the makefile has been removed."
},
{
"commit": "5fac1b405869e126330a99586364517c5917172e",
"date": "2025-01-02 09:11:19 -0500",
"subject": "Update LICENSE.txt and PostgreSQL copyright for 2025."
},
{
"commit": "4a94b6bef9108ab775c0070571a1fb7dd8883eeb",
"date": "2024-12-27 13:51:50 -0500",
"subject": "Refactor protocol helper.",
"body": "Simplify and improve data structures that track protocol client connections. The prior code could not store pg or repo clients but not both. We don't have a need for that yet, but tracking clients only by hostIdx was not flexible for some upcoming improvements. It is important to be able to identify and free clients very precisely.\n\nIn general this code should be easier to understand and removes duplicated code for local/remote clients."
},
{
"commit": "13f23f21683eef2d309f76d76cafc1f9b3852693",
"date": "2024-12-26 12:01:59 -0500",
"subject": "Fix issue after disabling bundling with block incremental enabled.",
"body": "When bundling and block incremental are both enabled the bundleRaw flag is set to indicate that headers are omitted (whenever possible) for encryption and compression. This is intended to save space, especially when there are very large numbers of small files.\n\nIf bundling is disabled this flag needs to be preserved so that existing bundles from prior backups are read correctly. However, the prior code was only saving the flag when bundling was enabled, which caused prior backups to be unreadable if bundling was disabled.\n\nFix so that the flag is preserved and backups are not broken."
},
{
"commit": "9ee3b2c59309fd86e5504374ad9f195bb363736b",
"date": "2024-12-26 10:45:11 -0500",
"subject": "Fix compression type in integration tests.",
"body": "Due to this bug the compression type in integration tests was always set to none. There are sufficient other tests for compression that this was not masking any bugs, but it was obviously not ideal."
},
{
"commit": "8b9e03d618d748e36ac006a0b0bb633930961512",
"date": "2024-12-23 10:30:41 -0500",
"subject": "Move linkCreate interface function to alphabetical order."
},
{
"commit": "48ecbe422da95a87c24e125f0f52bd5de2c02f6e",
"date": "2024-12-19 13:52:59 -0500",
"subject": "Clarify behavior of multiple configuration files."
},
{
"commit": "3210c9283fb7b14f26013dbea05df96e16b77e51",
"date": "2024-12-16 14:55:44 -0500",
"subject": "Clarify that unhandled errors may occur in edge cases."
},
{
"commit": "690c9803c3fa420d62bb62eccd4ae0f29266ff11",
"date": "2024-12-16 12:56:03 -0500",
"subject": "Add missing const qualifier."
},
{
"commit": "005c7e974f7966d49fbdc8cbdffcf819f532b96b",
"date": "2024-12-16 12:04:21 -0500",
"subject": "Merge v2.54.1 release."
},
{
"commit": "4d4d23131c75bf29655f6cd7625c25063ed09408",
"date": "2024-12-15 11:11:04 -0500",
"subject": "Rephrase invitation to star on Github."
},
{
"commit": "fbb31eefca5b7f79f55ee96517c05159a9cf7390",
"date": "2024-12-11 10:03:52 -0500",
"subject": "Change \"find\" to \"visit\" in introduction."
},
{
"commit": "5c8296df066564be35d3936610ebff1c332f38da",
"date": "2024-12-10 11:22:45 -0500",
"subject": "Remove reference to disabling network compression in the documentation.",
"body": "Previously setting compress-level-network=0 would disable compression. This worked because gzip disables compression at this level but still transmits the data in gz format.\n\nlz4 does not provide similar functionality so we would need to disable the compression filter entirely. This does not seem worth it however since lz4 compression is very efficient and 0 is the default fast mode."
},
{
"commit": "d96966065b937b595b6c45d41511f6f28e01a8e3",
"date": "2024-12-09 13:19:55 -0500",
"subject": "Add missing const qualifier."
},
{
"commit": "0e143ba7e7bf5c2d8c94fd44db57f768d0cdc72d",
"date": "2024-11-27 17:05:31 -0500",
"subject": "Remove --min-gen option from test.pl.",
"body": "This option was useful for the Perl code generation and autoconf generation, which were both slow. These are both gone now and the C code generation is fast enough that there is no need to exclude it.\n\n--dry-run will still prevent certain code generation from running. This may not be necessary any more but removing it should be the subject of a separate commit."
},
{
"commit": "cad595f9f8e6aaa9b64c9dcad8aa878c0c72a4d6",
"date": "2024-11-26 11:23:43 -0500",
"subject": "Full/incremental backup method.",
"body": "This backup method does a preliminary copy of all files that were last modified prior to a defined interval before calling pg_backup_start(). Then the backup is started as usual and the remainder of the files are copied. The advantage is that generally a smaller set of WAL will be required to make the backup consistent, provided there are some files that have not been recently modified.\r\n\r\nThe length of the prior full backup is used to determine the interval used for the preliminary copy since any files modified within this interval will likely be modified again during the backup. If no prior full backup exists then the interval is set to one day.\r\n\r\nThis feature is being committed as internal-only for the time being."
},
{
"commit": "0577b0301689bc19d49c4081cc652971de5da8cf",
"date": "2024-11-26 11:03:27 -0500",
"subject": "Use lz4 for protocol compression.",
"body": "lz4 provides much better compression speed and gives similar compression ratios to gz when used at low levels (the gz default was 3)."
},
{
"commit": "4af42d93b2a0201182d16c5163e9813635d12e3c",
"date": "2024-11-25 10:38:37 -0500",
"subject": "Update release notes for PostgreSQL 17 support.",
"body": "Accurately reflect when different versions of PostgreSQL were supported since an update was required for beta3."
},
{
"commit": "c351263a1d09829c91fc3f9016fefe666b5b6c62",
"date": "2024-11-22 15:25:43 -0500",
"subject": "Fix typos.",
"body": "Found using `codespell -S *.eps,*.cache,*.xml -L inout,te,fo,bload,fase,collet,hilight,debians,keep-alives` and `typos --hidden --format brief`."
},
{
"commit": "7f2dfc021c6689a5bddfbd7ed85d64ae93c01324",
"date": "2024-11-18 13:33:03 -0500",
"subject": "Update Fedora test image to Fedora 41."
},
{
"commit": "33d7681347ccdbaf2c026fd482ed3949d75d447a",
"date": "2024-11-18 10:58:00 -0500",
"subject": "Enable missing-variable-declarations compiler warning.",
"body": "Warn if a global variable is defined without a previous declaration. Use this option to detect global variables that do not have a matching extern declaration in a header file."
},
{
"commit": "4ae160aa34747128d2a45aa1f31893ebd7b86f3b",
"date": "2024-11-15 09:44:15 -0500",
"subject": "Add wait for async archive log exists check in integration test.",
"body": "They may be a small delay before the log exists, especially on slower platforms. Add a wait so the test does not fail in this case."
},
{
"commit": "12fe1393159bf63724279f03d43bc0a69ad2b636",
"date": "2024-11-13 17:48:14 -0500",
"subject": "Allow negative values for integer options.",
"body": "This mostly worked but there was a rendering issue that prevented compilation."
},
{
"commit": "d7c2d2ba1b97bb05ef7d97c4622c92e97282cafd",
"date": "2024-11-13 17:28:21 -0500",
"subject": "Move compression driver param list management to a common module.",
"body": "This code was duplicated in each driver so this means less duplication.\n\nIn addition, some drivers were not creating a parameter list for decompression which meant they could not be used remotely. This is not a currently a bug since none of them were being used remotely, but it was a blocker for using lz4 for protocol compression."
},
{
"commit": "274bb24a5ab122b599d31dd6cee197995a564c46",
"date": "2024-11-13 09:56:42 -0500",
"subject": "Stabilize async archiving in integration tests.",
"body": "The integration tests could fail if:\r\n\r\n1. After restoring the PostgreSQL instance the recovery process starts, which calls asynchronous archive-get.\r\n2. After archive-get checks the existence of the queue directory, but before writing the WAL file, there are restores when the next test is begun, which leads to the deletion of the queue directory.\r\n3. Since the directory no longer exists, writing the WAL file will fail, and archive-get will write the error file to the queue.\r\n4. A new PostgreSQL instance will start and the recovery process will begin, which requests the WAL file.\r\n5. The new archive-get looks into the queue directory, finds the error file, and throws out the error, after which the PostgreSQL recovery fails because the previous archive-get background process has not finished yet.\r\n\r\nThis patch fixes the problem by using a separate spool directory for each test."
},
{
"commit": "db912c049c7e4b98ec1cdfa5b4e45b3bbb7d1a6b",
"date": "2024-11-08 10:21:25 -0500",
"subject": "Exclude function void return logging macros from coverage reporting.",
"body": "An in 355e27d6, it makes sense to exclude FUNCTION_(LOG|TEST)_RETURN_VOID() macros when then they are on the last line of a function because in this case they are a noop (but are still used for debugging)."
},
{
"commit": "c9c73ede9d8182374372c46face4433997e8c0ea",
"date": "2024-11-07 10:30:16 -0500",
"subject": "Fix issue with version/help commands attempting to load pgbackrest.conf.",
"body": "8d6bceb5 refactored version/help to operate more like regular commands in part to simplify the implementation of --version and --help. Unfortunately this had the side effect of these commands also loading pgbackrest.conf which would lead to an error if the file could not be read or parsed.\r\n\r\nAdd a filter to prevent version or help from loading pgbackrest.conf. Also prevent reads from the env to stop any warnings or errors from that source."
},
{
"commit": "c6785431653d81d793b9c683091bfa20156c0c2f",
"date": "2024-11-07 09:27:02 -0500",
"subject": "Remove conditional compilation for lz4.",
"body": "0c32757f made lz4 required in the meson build but conditional compilation was left in to make reverting easy for packagers just in case.\n\nSince a few releases have gone by without any complaints, remove conditional compilation for lz4."
},
{
"commit": "355e27d69ce80c87fb9458f8240699ec5ce5dc5e",
"date": "2024-11-02 11:50:30 -0400",
"subject": "Exclude function logging macros from coverage reporting.",
"body": "It makes sense to exclude these from reporting since they are always covered when the function is covered and they are purely for debugging."
},
{
"commit": "fc5fdb8d358ae09d398922c1a8df44f47c8b40d6",
"date": "2024-11-02 11:36:56 -0400",
"subject": "Fix incorrect log macros.",
"body": "These led to incorrect log output in some cases. Probably not very noticeable, but definitely wrong.\n\nAlso fix types in the log macro comments."
},
{
"commit": "ed390780685adf1a463c74ee1cd3dad1b3dd9895",
"date": "2024-10-29 14:15:12 +0200",
"subject": "Enable float-equal and init-self compiler warnings.",
"body": "No code changes were required to enable these warnings."
},
{
"commit": "98670aee8927e4f7125318faeb1f18c4facf51e3",
"date": "2024-10-28 19:13:38 +0200",
"subject": "Enable redundant-decls compiler warning.",
"body": "Warn if anything is declared more than once in the same scope, even when the extra declaration is valid and changes nothing. This is primarily useful for catching missing header ifdef barriers.\n\nMove the environ variable into config/parse.h since it must be declared by us and we use it multiple times."
},
{
"commit": "9ec9b9d120c8b1113dfad734a006e0f91427cf3f",
"date": "2024-10-28 17:49:55 +0200",
"subject": "Enable missing-prototypes compiler warning.",
"body": "Warn if a global function is defined without a previous prototype declaration. This helps detect when a function that should be static is accidentally declared extern.\n\nMost of the changes are to add missing header files so functions can see their declarations.\n\nIn a some cases functions that should have been static were marked as such. There were only five of these in the core but every little bit counts.\n\nLastly, it was necessary to suppress the warning in the postgres test modules where the function declarations are not available. This is fixable by aligning the module with the auto-generated code in core, but is not a priority."
},
{
"commit": "21f7d2d3a840852d7964c5684dd04f29ce9cc68a",
"date": "2024-10-28 14:21:38 +0200",
"subject": "Enable cast-qual compiler warning.",
"body": "Warn whenever a pointer is cast so as to remove a type qualifier from the target type. For example, warn if a const char * is cast to an ordinary char *.\n\nMost of the changes for this are fairly rote: just add a const qualifier where needed. In some cases functions needed to be reworked to return non-const where before they had returned const and then cast it back to non-const. None of these patterns appeared to be bugs, but they were certainly misleading.\n\nSome cases (especially excvp() and calls to bz2) could not be fixed because of how functions out of our control are defined. In those cases the warnings have been suppressed and a comment added to detail the exception. This was also done a few places in the tests."
},
{
"commit": "bb7e1724a95a4bf087bae6782ae255e1583bc9b7",
"date": "2024-10-28 13:21:35 +0200",
"subject": "Update String, Buffer, and Variant constants to work with cast-qual.",
"body": "These three objects can be created as constants at compile time using specialized macros. Unfortunately since the values assigned are also const, cast-qual complained about the cost qualifier being lost.\n\nFix this by creating new structures to be used just for creating these constants. This is not ideal due to the need to keep the duplicated structures in sync, but in practice these structures are almost never modified. Testing should catch any out of sync structures and this feature is valuable enough to keep even though in theory there could be memory safety issues. In practice the APIs prevent const objects from being used in an unsafe way and testing provides a fair assurance of safety. Writing to these consts would be a fatal error even if it did not cause a segfault.\n\nIdeally, we would be able to use warning suppression in these macros to avoid the extra struct, but due to the way they are used it is not possible to add the required pragmas (even using _Pragma).\n\nFinally this construction makes it obvious that something special is being done, rather than it being under the covers."
},
{
"commit": "a981ef08d70fdd5faf8052a75d2e066ebcca7057",
"date": "2024-10-28 13:20:19 +0200",
"subject": "Fix misplaced volatile qualifiers in GCS authorization JWT generation.",
"body": "The volatile qualifiers should be on the pointers that are stored on the stack, not on the structures that are allocated by OpenSSL functions.\n\nAlso remove all the casts that were required when volatile was in wrong place."
},
{
"commit": "118f93baab39339a2c22deeb360f28370e139dd6",
"date": "2024-10-28 13:07:35 +0200",
"subject": "Update Cirrus MacOS runner to OpenSSL 3.",
"body": "OpenSSL 1.1 is no longer available in HomeBrew."
},
{
"commit": "48f511dad339ef9357e00f7bd8e2bf4b7c800dd4",
"date": "2024-10-21 13:56:04 +0300",
"subject": "Remove support for PostgreSQL 9.4.",
"body": "Per our policy to support five EOL versions of PostgreSQL, 9.4 is no longer supported by pgBackRest. Remove all logic associated with 9.4 and update the tests.\r\n\r\nThis includes a small fix in infoPg.c to allow backup.info files with old versions to be saved. This allows expire to function when old versions are present. Even though those older versions cannot be used, they can be expired.\r\n\r\nTests for 9.4 are left in the expire/info tests to demonstrate that these commands work with old versions present."
},
{
"commit": "89c9baba72fc99616083a7adc4be2c3e2bf9e4dd",
"date": "2024-10-21 13:32:35 +0300",
"subject": "Remove autoconf/make build.",
"body": "2.54.0 is the last release to support the autoconf/make build. Remove the autoconf/make build to reduce maintenance going forward."
},
{
"commit": "4125f726a857629c4500f82a3989dc1b69977500",
"date": "2024-10-21 09:11:49 +0300",
"subject": "Begin v2.55.0 development."
},
{
"commit": "1e5f46b7d9626eadfcf99d08cb984a74085ee0c8",
"date": "2024-10-21 08:57:43 +0300",
"subject": "v2.54.0: Target Time for Versioned Storage"
},
{
"commit": "7effca0d0995844b3b3b89d568c3c8cee7b9ef1e",
"date": "2024-10-20 20:28:54 +0300",
"subject": "Update CI tests for ppc64le/s390x architectures.",
"body": "The action suddenly broken and this appears to be the best work around according to https://github.com/uraimo/run-on-arch-action/issues/155.\n\nUnfortunately the tests take almost twice and long to run, probably because the container needs to be built from scratch."
},
{
"commit": "9ba2db017348d304f96ce89592fc01f29197e136",
"date": "2024-10-16 12:41:26 +0300",
"subject": "Clarify source for data_directory."
},
{
"commit": "f76da03eb674af8c05d90abf5c2a7f246f8c9c01",
"date": "2024-10-16 12:14:12 +0300",
"subject": "Update CI containers to include newest PostgreSQL patch releases."
},
{
"commit": "bd0480ca7d6e5ee56a53a2887d893c41f1a8d132",
"date": "2024-10-16 11:07:21 +0300",
"subject": "Move SFTP test off of PostgreSQL version tested by 32-bit.",
"body": "There have been occasional SFTP authentication failures on 32-bit. We are planning to drop 32-bit support so it does not seem worth chasing these errors down and they are likely timing issues anyway."
},
{
"commit": "65dfe2407d0c358209a01f06cd4326d0a80d1acb",
"date": "2024-10-12 10:06:40 +0300",
"subject": "Retry socket bind.",
"body": "In the case of a rapid restart it is possible that the socket may not be immediately available, so retry until it becomes available.\n\nThis is particularly useful for testing where sockets are bound and released very rapidly."
},
{
"commit": "ed72c6f9a1b156b64e05a8fc5e236e6568657d0a",
"date": "2024-10-11 12:05:23 +0300",
"subject": "Render command help summaries the same as option help summaries.",
"body": "Option help summaries do not have initial capitals (except in special cases) and final periods so it makes sense to render the command summaries the same way.\n\nUse the same function for both so they are consistent."
},
{
"commit": "eb2f279a2998d1ed893c5d8984590ab4997a5f32",
"date": "2024-10-11 11:53:34 +0300",
"subject": "Better logic for deciding when a summary should be lower-cased.",
"body": "The old logic would lower-case PostgreSQL which looked odd. This should be more robust for anything that looks like a proper name of acronym."
},
{
"commit": "70bda2cfb21130eb589a87cb419fb5f22a71c78a",
"date": "2024-10-10 11:17:35 +0300",
"subject": "Improve SFTP error messages.",
"body": "The numbers by themselves weren't very informative and required looking into the libssh2_sftp.h header file for the definition."
},
{
"commit": "c8ccaaa755993e3fd5e87148bd0a991acb3050c3",
"date": "2024-10-10 09:48:43 +0300",
"subject": "Fix PostgreSQL query performance for large datasets.",
"body": "The asynchronous logic used to implement the query timeout was misusing PQisBusy(), which caused the wait handler to throttle the consumption of command results. It could introduce a large delay on a query up to `db-timeout` because of the back-off sequence.\r\n\r\nFollowing the recommendation of libpq, fix by polling the client socket for data availability and then continue consuming results and checking for command busyness."
},
{
"commit": "33fa3965616b1432e5d1d59c489302fa4891a39e",
"date": "2024-10-09 17:57:52 +0300",
"subject": "Refactor Wait object to expose remaining wait as waitRemains().",
"body": "This is useful for code that has its own wait mechanism, e.g. poll(), but still needs a way to track overall time elapsed.\n\nTo keep it simple waitRemains() is called by waitMore()."
},
{
"commit": "77ae753ef59bd40b9867be21e8519093786c3b85",
"date": "2024-10-09 17:48:00 +0300",
"subject": "Allow fdReady() shim to be run only once with a specified return value.",
"body": "This allows more targeted testing than the prior (still supported) approach."
},
{
"commit": "6ac4e8dd78f16e93300f7747c4bc8fa8e1a0558b",
"date": "2024-10-09 10:46:45 +0300",
"subject": "Move fd module shim to io module test.",
"body": "The shim is needed in an earlier test and this is a more logical place for it anyway."
},
{
"commit": "1020bc117ab2e116abb41eebd40216726a3d2561",
"date": "2024-10-08 18:15:34 +0300",
"subject": "Shuffle PostgreSQL versions between test containers.",
"body": "Ubuntu 20.04 has been having consistent errors starting PostgreSQL 10 so move 9.5 to this container instead. An older version makes sense with an older distro.\n\nAlso move PostgreSQL 12 from RHEL 8 since this version will be EOL soon."
},
{
"commit": "b50ad48fd44ba958a6a71ac0c5fe1b113968e577",
"date": "2024-10-08 11:01:55 +0300",
"subject": "Use systemctl replacement to generate documentation.",
"body": "Containers are notoriously unfriendly to systemctl (really systemd) but we prefer to use systemctl to make our documentation as accurate as possible. This replacement performs all the functions of systemctl without requiring systemd, which great simplifies container configuration and allows the documentation build to work in more environments."
},
{
"commit": "1ebdcd611d1724feedb23f9de854819ec5499c9f",
"date": "2024-10-08 10:28:01 +0300",
"subject": "Use output path for temp config files during documentation build.",
"body": "Putting the files in the user's home directory was too Linux-centric."
},
{
"commit": "b3ca2e34823b28862d999f87c4d7346707952a5b",
"date": "2024-10-05 09:41:50 +0300",
"subject": "Correctly display current values for indexed options in help.",
"body": "The current value for an indexed option was always for the first index, e.g. pg1-path. This is likely legacy from before indexing was added (and faithfully copied over from Perl, apparently).\r\n\r\nFix this by enumerating the current values in the option help and displaying in the option list when more than one value exists."
},
{
"commit": "047e3d0ed95d882b00e2da1640e78e3ba06e1d51",
"date": "2024-10-02 19:49:15 +0300",
"subject": "Finalize catalog number for PostgreSQL 17 release."
},
{
"commit": "9f97269678091cc43a15920cf8eab34b231ae431",
"date": "2024-10-02 18:02:15 +0300",
"subject": "Use `uname -m` to get architecture for RHEL package in user guide."
},
{
"commit": "d4ed1884ea5ce54e05f84ab1aacdfc0385538c06",
"date": "2024-09-24 12:33:19 +0300",
"subject": "Reduce logging for help functions.",
"body": "Full debug/trace logging in production is unlikely to be useful but does use space in the binary.\n\nReduce logging to be useful for testing but not be deployed in production."
},
{
"commit": "cd7711f5e6306778427ced8b796da09398e08015",
"date": "2024-09-20 15:58:18 +0300",
"subject": "Update Cirrus CI MacOS running to Sonoma."
},
{
"commit": "278319eba3444070123d3f0f277be9234604d937",
"date": "2024-09-20 15:49:26 +0300",
"subject": "Add performance tuning section to user guide.",
"body": "We frequently tell users to enable to these options but they are spread through the documentation and not at all obvious. Hopefully putting them in the quick start will make them more visible and also provide an easy place to link."
},
{
"commit": "f73c6382752ca8cad43a412a03b6b5f34cf94984",
"date": "2024-09-20 15:21:38 +0300",
"subject": "Skip command-line options in configuration reference.",
"body": "Options that are only valid on the command-line should not appear in the configuration reference because it implies that they can be added to pgbackrest.conf, which is not the case.\n\nMost command-line options were already excluded because they lacked a section, but a few were slipping through."
},
{
"commit": "b19134dccd5d0dab87b5d45b443f481df00370b1",
"date": "2024-09-17 10:51:21 +0300",
"subject": "Allow repositories on versioned storage to be read at a target time.",
"body": "This feature allows the archive-get, info, repo-get, repo-ls, restore, and verify commands to operate at a point-in-time on versioned buckets in Azure, GCS, and S3. This allows recovery even if a repository has been accidentally or maliciously deleted or corrupted."
},
{
"commit": "46c1297be344909e900be596a865064233da9f87",
"date": "2024-09-09 15:47:23 +0300",
"subject": "Remove limitation on reading files in parallel during restore.",
"body": "This restriction prevented multiple files being read from a remote simultaneously, which was not supported by the protocol. Although the limitation only applied to remotes, it was applied in all cases for testing purposes and because we planned to fix it.\r\n\r\nProtocol command multiplexing added in df8cbc91 allows files to be read simultaneously from a remote so this restriction is no longer required.\r\n\r\nNote that there is a test for this condition since the prior code had coverage. It might be tricky to ensure that test doesn't go away, but in general we should have enough tests in place to ensure simultaneous reads function as expected."
},
{
"commit": "a42629f87ab70ffaee8d1241eb50c5ea7154a87d",
"date": "2024-09-09 12:56:52 +0300",
"subject": "Allow requested standby backup to proceed with no standby.",
"body": "Add a \"prefer\" value to the backup-standby option to allow the backup to proceed when no standby is found. Note that this will not help if the standby is responding but fails to sync with the primary after the backup has started.\r\n\r\nIntroduce a new option modifier, bool-like, that allows a boolean option to be converted to a string or string-id option while still allowing the option to act like a boolean on the command-line, e.g. --no-backup-standby."
},
{
"commit": "b454b9e403526b1f352df964d9206c27d2397df3",
"date": "2024-09-05 11:38:42 +0300",
"subject": "Save backup.info only when contents have changed.",
"body": "This prevents backup.info from being saved again when expire does not make any changes.\n\nMore importantly, as we look to support versioning on object stores, it will be much easier to determine a good point-in-time to use for restore if there are no extraneous saves of backup.info."
},
{
"commit": "83802ded8c5560a097757c420d0753c50d0edbb3",
"date": "2024-09-01 12:51:27 +0700",
"subject": "Remove invalid const keywords from info/infoBackup module.",
"body": "In these functions infoBackup was marked as const even though it was modified in the function. This was allowed by the compiler because the infoBackup struct was not being directly modified but it still goes against our coding conventions."
},
{
"commit": "95a4b9e10a3f7a26ebaae22fc6abd79cee14189a",
"date": "2024-09-01 11:21:56 +0700",
"subject": "Refresh web-id token for each S3 authentication.",
"body": "The token file pointed to by the AWS_WEB_IDENTITY_TOKEN_FILE environment variable was read once at startup, but for long operations the token might expire before completion.\r\n\r\nInstead read the token on each S3 authentication so the current token is always used."
},
{
"commit": "d204bac75d3020251c52c9b7892b47c5b3e7f018",
"date": "2024-08-30 16:23:55 +0700",
"subject": "Refactor storage/remote module to move more repository storage tests.",
"body": "Move tests missed in 3b3886f3."
},
{
"commit": "0b4371f3ecead992e6140251c658e9fed56a8f37",
"date": "2024-08-30 16:02:04 +0700",
"subject": "Update comment in storage/list module.",
"body": "This aligns better with other comments in the area."
},
{
"commit": "3b3886f3b81776adfe3fd4970e977f56d0c2b02f",
"date": "2024-08-30 16:00:07 +0700",
"subject": "Refactor storage/remote module to move repository storage tests.",
"body": "Move tests that use functions that are not valid for non-Posix repositories to pg storage.\n\nThis allows for a test storage driver that only implements functions required for repositories."
},
{
"commit": "b3fed2cfcf4562dde52be28c35e20d7d38171564",
"date": "2024-08-30 15:44:43 +0700",
"subject": "Simplify command/repo tests.",
"body": "Reduce the number of tests that use links and special files. This simplifies future versioning tests."
},
{
"commit": "94e21893e8b43ef9080246feba5fa89d39e67f0c",
"date": "2024-08-30 15:39:03 +0700",
"subject": "Add hrnSleepRemainder() to time test harness.",
"body": "This function replaces some ad hoc implementations in the tests."
},
{
"commit": "c40dd5ae41ae800a031715a60c91dd839b39905d",
"date": "2024-08-28 11:07:52 +0700",
"subject": "Improve reporting of partial reads in server test harness.",
"body": "Previously partial reads would be reported as an EOF which was not very helpful.\n\nAlso update error formatting to make requests easier to compare."
},
{
"commit": "2ce01e57d3f2f294efe9a9ac6c7d357342796a13",
"date": "2024-08-20 20:57:06 +0700",
"subject": "Refactor interface/driver getters for IoRead/Write and StorageRead/Write.",
"body": "Add getters where needed and remove the unused driver member from the StorageRead/Write objects. The new getters are only required for testing but they don't compromise the core code."
},
{
"commit": "a71d88481c60178de1c10dac2a0d306959675999",
"date": "2024-08-20 20:34:40 +0700",
"subject": "Improve TEST_STORAGE_GET() to allow testing of missing files.",
"body": "Previously a missing file would always throw an error. Now there is the option to return NULL for missing files."
},
{
"commit": "4eab64fcd926c2b5741d4b44f8b9d9144bf1e3a5",
"date": "2024-08-20 20:14:32 +0700",
"subject": "Improve file removal performed after each unit test.",
"body": "The rm would miss files beginning with a dot which are being used going forward for the versioning test driver.\n\nInstead use find since it will delete all files."
},
{
"commit": "f6aaa3672b851fa8e70942f332a633f3b42babb7",
"date": "2024-08-20 11:03:24 +0700",
"subject": "Merge v2.53.1 release."
},
{
"commit": "2b29fe9337e9b2cbde26915c8bfb999b4010560c",
"date": "2024-08-17 12:58:55 +0700",
"subject": "Move getEpoch() to cvtZToTime() and refactor.",
"body": "This function will be needed elsewhere going forward and in any case it makes sense to move this out of the restore module.\n\nRefactor to avoid dependency on a regular expression."
},
{
"commit": "60f96429b8f58827e3f2d6cd96dc1f6e1725c90c",
"date": "2024-08-16 10:56:07 +0700",
"subject": "Fix segfault on delayed connection errors.",
"body": "Connection errors could cause a segfault if the error was delayed enough to pass the initial call to sckClientOpenWait() and the error was instead thrown by a subsequent call to sckClientOpenWait(), which was not correctly initializing a variable required for error handling.\r\n\r\nWhile this can be produced fairly easily in a test environment, I was unable to craft a unit test to hit this exact condition, probably due to timing. The new code still has full coverage and I added several comments to help prevent regressions."
},
{
"commit": "04ef43d9ed3e1900a85f0df9475ce6dc04dc9c5f",
"date": "2024-08-13 13:45:24 +0800",
"subject": "Skip local repository duplicate check for SFTP.",
"body": "This check does not make sense for SFTP since the repository will never be local."
},
{
"commit": "80c9b3001c8f4689837d46783d348a2c839645c0",
"date": "2024-08-13 11:53:12 +0800",
"subject": "PostgreSQL 17 support.",
"body": "This release changed the control and WAL format, which is very unusual for a beta. Update control and WAL versions/structs to match."
},
{
"commit": "ed9b0c260a6e1f05a17d5d2b86c274afdd2d1b05",
"date": "2024-08-13 11:43:05 +0800",
"subject": "Fix permissions when restore run as root user.",
"body": "When restore was run as the root user the pg_control file would end up with root permissions. This bug was introduced in e634fd8. Fix this by directly overwriting the pg_control temp file rather than doing an atomic write that updates permissions. Also update other parameters to more closely match similar calls.\r\n\r\nThere was also an adjacent error where restore as the root user would fail if the base path did not exist. Fix this by ignoring the missing path since it will be created later and this logic is just trying to find an alternate user for permissions if the user in the manifest does not exist."
},
{
"commit": "57663536493bfa917e4b1c37d221697a0ddb7a73",
"date": "2024-08-02 15:47:30 +0700",
"subject": "Use Posix driver to complete dummy storage driver.",
"body": "Instead of stub functions, use the Posix driver to make the dummy storage driver interface more functional."
},
{
"commit": "b306f83493cc859ad15c8f175fc6db2321b79340",
"date": "2024-07-31 18:53:02 +0700",
"subject": "Summarize backup reference list for info command text output.",
"body": "The backup reference list can be very long so it seems better to summarize the list by default for text output and keep the full list when --set is specified."
},
{
"commit": "c42d484c9d76dfb2baa7b9b462870441e8ad37a0",
"date": "2024-07-30 12:48:32 +0700",
"subject": "Fix typo in user guide."
},
{
"commit": "8d6bceb5416a702d010fd5db4be9d6dc294cb1d9",
"date": "2024-07-23 16:39:02 +0700",
"subject": "Refactor config parse to remove none command, add version/help options.",
"body": "The none command was a bit confusing since it was only valid when parsing failed but still needed to be added to various switches and logic. Replace with cfgInited() which should make it clearer what state configuration is in.\n\nMake the default command help and convert --version and --help to real options.\n\nCombine version and help output into a single function to simplify processing in main.\n\nAdditional reformatting and a bit of refactoring."
},
{
"commit": "6c757366c2c7221a9fd571495fa2ec82b4d4da2f",
"date": "2024-07-23 11:50:12 +0700",
"subject": "Simplify main() functions in core, doc, and test.",
"body": "This refactor simplifies the main() functions and puts the more commonly run commands first.\n\nFor core main() also remove code duplication in local/remote role handling."
},
{
"commit": "faee89206776287a2ba000c43f28ac6479d33689",
"date": "2024-07-23 11:10:54 +0700",
"subject": "Do not allow help for command roles other than main.",
"body": "Previously requesting help for roles other than main would result in a segfault since help.auto.c.inc does not include such help.\n\nPrevent this by erroring when a user requests help for roles other than main.\n\nThis is a bug but it is unlikely to have ever been seen in the field and in any case it has a very low severity since it only impacts a corner-case for the help command."
},
{
"commit": "ee70c2e26e63ee6299de5a9ca20a3d1ddea036b1",
"date": "2024-07-22 14:17:47 +0700",
"subject": "Remove internal repo-create command.",
"body": "This command was used by the Perl integration tests to create buckets for storage types that required it. Now that the integration tests are written in C they can simply use the same code to create buckets.\n\nThe command was also used in the documentation but there it seems more appropriate to use the corresponding vendor CLI."
},
{
"commit": "55ca41e13784ef5fdafdb02444969ceb1a699744",
"date": "2024-07-22 12:43:54 +0700",
"subject": "Update protocol and storage/remote modules to recent coding standards.",
"body": "Add const as appropriate."
},
{
"commit": "df8cbc91c348bc2f746767c87ac5626460fb6f39",
"date": "2024-07-22 11:48:32 +0700",
"subject": "Protocol command multiplexing.",
"body": "Previously it was not possible to read or write two files at the same time on the same remote because the protocol was entirely taken over by the read or write command. Multiple reads are required to make restores efficient when a list of bundled files is being read but blocks need to be retrieved from a separate file or a different part of the same file.\r\n\r\nImprove that situation with sessions that allow related commands to be run with shared state. Also break read/write into separate requests (rather than pushing all data at once) so they can be multiplexed.\r\n\r\nThe disadvantage for read/write is that they now require more back and forth to transfer a file. This is mitigated by sending asynchronous read/write requests to keep both server and client as busy as possible. Reads that can fit into a single buffer are optimized to transfer in a single command. Reads that transfer the entire file can also skip the close command since it is implicit on end-of-file.\r\n\r\nThese changes allow the protocol to be simplified to provide one response per request, which makes the data end message obsolete. Any data sent for the request is now added to the parameters so no data needs to be sent separately to the server outside the request parameters.\r\n\r\nAlso update the Db protocol to use the new sessions. Previously this code had tracked its own sessions."
},
{
"commit": "e7f4e8d8004f609ab0edda5d7183ccb3e6c55b6a",
"date": "2024-07-22 09:42:33 +0700",
"subject": "Begin v2.54 development."
},
{
"commit": "6e8a45f650e303fe74a1e34ee8e76a193dbc6c4a",
"date": "2024-07-22 09:33:31 +0700",
"subject": "v2.53: Concurrent Backups"
},
{
"commit": "dea48be06dfcd50f48b205f65e45e4dbefa7c37a",
"date": "2024-07-21 17:01:23 +0700",
"subject": "Fix incorrect examples in doc/test help.",
"body": "The help for help was copied from core but the examples were not updated.\n\nUpdate the examples to be appropriate for doc/help."
},
{
"commit": "32a6dd6c3d1becdbad9ae14df83daf231a84f860",
"date": "2024-07-21 16:57:35 +0700",
"subject": "Improve config file handling in doc/test config load.",
"body": "Since 1141dc20 it has been possible to request that cfgParse() skip loading the config file. Use this logic to replace the code used to ignore config files in doc/test config load."
},
{
"commit": "ec3e387bb73826c30b32bf0221acb2d56f23f1c5",
"date": "2024-07-18 11:19:25 +0700",
"subject": "Clarify archive-push multi-repo behavior.",
"body": "Clarify that archive-push will not be able to push ahead in other repositories if one is failing unless archive-async in enabled."
},
{
"commit": "c85191e02486d4e9f5ea34ce3bfe7243ddf74831",
"date": "2024-07-16 09:45:22 +0700",
"subject": "Update Minio test/documentation container version."
},
{
"commit": "d8ff89ae758314c8a0f006b7a92097c35534d0ff",
"date": "2024-07-15 11:53:57 +0700",
"subject": "Update EOL Debian 10 to Debian 11/Ubuntu 20.04 in CI.",
"body": "Typically we use the oldest Debian/Ubuntu to run 32-bit unit and integration tests. However, 32-bit is no longer fully supported by Ubuntu (multiple packages we need are missing) and apt.postgresql.org no longer packages for any 32-bit version.\n\nTo address these changes, do 64-bit integration testing on the oldest Debian/Ubuntu (currently Ubuntu 20.04) and 32-bit unit/integration testing on the oldest Debian (currently 11) using the included version for integration testing."
},
{
"commit": "ce2493c3f6718cfa9209665019d56dde36b81b75",
"date": "2024-07-15 11:22:13 +0700",
"subject": "Remove obsolete vm constants.",
"body": "The VM[2-4] constants do not serve a purpose anymore (removed in 794c5771) and just make the mappings more complicated, so remove them."
},
{
"commit": "c84ab4914f33dbf0cb762cfb5a552ee39b73eb1e",
"date": "2024-07-15 11:12:53 +0700",
"subject": "Remove references to mock integration tests.",
"body": "Mock integration tests were removed in d41b21c8 but CI was still trying to run them, so remove from CI.\n\nAlso rename mock to integration in test unit tests to avoid confusion in the future."
},
{
"commit": "dfb620b0b8cf884ca486b413f4cd162e258b2fc5",
"date": "2024-07-11 10:54:20 +0700",
"subject": "Support IP-based SANs for TLS certificate validation.",
"body": "The prior SAN code only recognized DNS-based SANs, which meant that it would not properly validate if using an IP-based SAN. \r\n\r\nAdd support for IPv4 and IPv6 SANs with exact matching only.\r\n\r\nThis simplifies testing when certificate generation tools have trouble generating a DNS:1.2.3.4-style SAN, preferring to include the SAN as IP:1.2.3.4."
},
{
"commit": "d295156dd38c88c9d71e566509426cf91322e326",
"date": "2024-07-09 16:07:40 +0700",
"subject": "Improve command/role parsing.",
"body": "Reduce redundancy by improving cfgParseCommandId() to work when a command role is present. This way the function does not need to be called twice.\n\nAlso, remove the use of StringList in cfgParse() since checking for a colon is faster and saves memory allocations. Modify cfgParseCommandRoleEnum() to accept char * since a String is no longer produced for the role name."
},
{
"commit": "ccae60940241b30e8bc3e405936b6ba68857930c",
"date": "2024-07-09 11:34:13 +0700",
"subject": "Add hint to check SFTP authorization log.",
"body": "In the case of authorization failures there many be valuable information in the log."
},
{
"commit": "cf8625d24bd953ad1ed448c32b937584009e5b6b",
"date": "2024-07-09 11:17:25 +0700",
"subject": "Require OpenSSL >= 1.1.1.",
"body": "Versions below 1.1.1 are quite old and no longer need to be supported.\n\nAlso add a missing const in tlsAsn1ToStr()."
},
{
"commit": "b71d4b53d68800daceb4b6dcb717862cbe5757dc",
"date": "2024-07-09 10:48:27 +0700",
"subject": "Auto-generate code before building test binary.",
"body": "Errors in code generation can cause the test binary build to fail and then it is not possible to see the generated code.\n\nInstead, generate code first so any errors can be seen and analyzed."
},
{
"commit": "66d3cd42b5a07edaf75b0f365088dc7e202d0573",
"date": "2024-07-09 10:45:47 +0700",
"subject": "Improve error messages for allow range and allow list options.",
"body": "Create mappings between integer, size, time, and stringid option values and their string equivalents. This allows for better error messages and means that the mappings do not need to be stored with defaults, allow lists, etc."
},
{
"commit": "aadfb54046e52eeedc38750eb91f3e719e22d758",
"date": "2024-07-09 10:09:55 +0700",
"subject": "Add units to all option sizes.",
"body": "Some sizes were missing units. Add units to make it clear that they are sizes in messages."
},
{
"commit": "6f5066b0b63c5f89e39a8930d29ab725c381221c",
"date": "2024-07-07 17:06:44 +0700",
"subject": "Fix overly long lines."
},
{
"commit": "d6f0bf88af8b39492aa8e20c09bdf30260e2eb2f",
"date": "2024-07-04 16:53:07 +0700",
"subject": "Fix SFTP renaming failure when file already exists.",
"body": "Update error handling for libssh2_sftp_rename_ex() in storageWriteSftpClose() when a file already exists. \r\n\r\nThe SFTP servers used during development and testing never returned LIBSSH2_FX_FILE_ALREADY_EXISTS, rather they returned LIBSSH2_FX_FAILURE when a file already existed. However, it is clear that some SFTP servers use LIBSSH2_FX_FILE_ALREADY_EXISTS so add support."
},
{
"commit": "edd61636a98d193b7c0634b5a4444527132959e0",
"date": "2024-07-04 16:22:17 +0700",
"subject": "Allow backups to run concurrently on different repositories.",
"body": "The prior locking only allowed one backup per stanza, which was required by PostgreSQL <= 9.5 and didn't present a problem when only one stanza could be created.\r\n\r\nNow that multiple stanzas are allowed relax this restriction so that backups can run concurrently for PostgreSQL > 9.5. To do this, update the locking to be per stanza and repo rather than per stanza. Remotes are not aware of the repos that require locking so send an explicit list of files to be locked to the remote. Also remove the advisory lock for PostgreSQL > 9.5.\r\n\r\nFor info output the running backups are combined for progress output in order to avoid changing the JSON format. It definitely makes sense to have per repo progress as well but that will be left for a future commit."
},
{
"commit": "3a2266f327c340ff1133a6a2398429c844b5755d",
"date": "2024-07-04 15:42:09 +0700",
"subject": "Display time option defaults and allowed values with appropriate units.",
"body": "Similar to size options in 038abaa7, time option defaults and allowed values were displayed in seconds, which could be confusing when the values were large.\n\nThe time options were not updated in 038abaa7 because it required removing the ability to do fractional seconds, e.g. 0.5 seconds. In theory this could cause breakage for users but it seems really unlikely. Fractional seconds are used in tests, however, so the tests have been changed to use milliseconds where required, e.g. 500ms."
},
{
"commit": "df469471e3afa91212967fc3bca7877a1a8830f3",
"date": "2024-07-04 09:28:57 +0700",
"subject": "Fix invalid default inherited in job-retry-interval.",
"body": "This default was being mistakenly inherited from job-retry and would set job-retry-interval to 1 second for archive get and push. In practice this did not matter since archive get and push default to one retry and the first retry interval is always 0, but it still makes sense to fix it to correct the behavior when the value of job-retry is changed."
},
{
"commit": "8b82641d87de7fd749414737f62289fb2648e608",
"date": "2024-07-01 11:15:14 +0800",
"subject": "Shorten enums used in parse.auto.c.inc.",
"body": "Rather than using the full enum just use the part of the enum that is unique. This makes the output a bit more readable by removing the repetitive elements. The prefix for each enum is built into its macro."
},
{
"commit": "cfd4fb2c7da7b0fc113b6518a054eab29d0ef34f",
"date": "2024-06-30 16:11:11 +0800",
"subject": "Remove PARSE_RULE_OPTION_GROUP_MEMBER() macro from parse.auto.c.inc.",
"body": "It is simpler to just set group = true in the PARSE_RULE_OPTION_GROUP_ID(), so do that."
},
{
"commit": "7d540730941994d3cb630c695e9f672e047d8e7f",
"date": "2024-06-25 16:45:47 +0800",
"subject": "Default log-level-stderr option to off.",
"body": "Writing warnings and errors to stderr by default leads to error messages being lost when the user does not correctly redirect stderr while generating logs for analysis. This happens so often that it seems worth changing the default to increase the quality of the logs we receive.\r\n\r\nIf the user has explicitly set log-level-stderr then there is no change in behavior."
},
{
"commit": "1094aecab563e8c1601ae80caefb2e4247db87d4",
"date": "2024-06-25 16:16:55 +0800",
"subject": "Require compiler support for __builtin_clzl() and __builtin_bswap64().",
"body": "These functions will be useful for optimizing varint-128 functions.\n\nRequire them in the meson build before adding new code in case there are problems with packaging."
},
{
"commit": "0c32757fd9269a18b827fa33230d2997c98571a0",
"date": "2024-06-25 16:04:02 +0800",
"subject": "Require the lz4 library in the meson build.",
"body": "We would like to use lz4 for protocol compression instead of gz but first we need to make sure this is not going to cause a problem for packaging.\n\nTo do this make lz4 required in meson but make no changes to the code so this is an easy revert for packagers if there is an issue."
},
{
"commit": "acb9b6ccbeb78391e19b146488093c83d0ac3ab3",
"date": "2024-06-25 15:54:57 +0800",
"subject": "Increase width of unsigned integration in performance/type module.",
"body": "The prior int was too small to scale up as much as we need for performance testing."
},
{
"commit": "6495a46ca3e08f867efd677aecd29806e9e9f753",
"date": "2024-06-25 15:46:07 +0800",
"subject": "Fix --run and --scale options for unit tests.",
"body": "These were broken while code was being migrated to C and went unnoticed because the options are generally only used when doing performance testing.\n\nThe C code can only take one --run param so add a check for that in test.pl."
},
{
"commit": "cfb8aa202ee972579697db2cc8d5d8ef111f0022",
"date": "2024-06-21 13:29:17 +0800",
"subject": "Add remote locks for stanza commands missed in 31c7824a.",
"body": "31c7824a should have added remote locks when the commands were modified to run remotely. This is unlikely to have caused issues since these commands are generally not run concurrently with backup/expire but having the locks is safer."
},
{
"commit": "b9a9ef2d5fa22c4e257f4d1befbc067029570211",
"date": "2024-06-21 11:17:42 +0800",
"subject": "Clarify when code generation is run when modifying config.yaml.",
"body": "The contributing guide indicated that this happened at compile time but in fact it happens when test.pl is run."
},
{
"commit": "bcda7f8c7ee9823880bd1a9b5e65075df1102652",
"date": "2024-06-20 13:06:04 +0800",
"subject": "Optimize assignment of command/option rules.",
"body": "Assign the rule to a local variable to make subsequent assignments more efficient.\n\nAlso fix a missing const."
},
{
"commit": "a0a5f2300cf771095a0a7fc309d40c1f27c899a6",
"date": "2024-06-19 10:33:46 +0800",
"subject": "Replace strftime() with cvtTimeToZP() and strNew/CatTimeP().",
"body": "These functions produce cleaner code and hide implementation details."
},
{
"commit": "cec486b6dd02b6a755142ad4bee322fb02ff0d23",
"date": "2024-06-18 11:42:59 +0800",
"subject": "Refactor backup to use flag for backup standby state rather than option.",
"body": "Using the option adds a bit of complexity -- it is simpler just to use the state of the standby object to determine if backup from standby is enabled."
},
{
"commit": "270dce41b6fff0d0ad0769b0ea5df0011140f0b9",
"date": "2024-06-18 10:43:54 +0800",
"subject": "Refactor lock module.",
"body": "Refactor the lock module to split command-specific logic from the basic file locking functionality. Command specific logic is now in command/lock.c. This will make it easier to implement new features such as repository locking and updating lock file contents on remotes.\r\n\r\nThis implementation is essentially a drop-in replacement but there are a few differences. First, the lock names no longer require a path (the path is added in the lock module). Second, the timeout functionality has been removed since it was not being used."
},
{
"commit": "ad7377c75b2769d2907482de139fb21f779ae674",
"date": "2024-06-16 11:55:04 +0800",
"subject": "Fix issue with files larger on the replica than on the primary.",
"body": "If a file on the primary was larger than on the replica then the next diff/incr backup would store the primary size instead of the replica size when block incremental was enabled. On the next diff/incr backup this would lead to a repo size must be > 0 for file error when validating the manifest.\r\n\r\nFix this by limiting copy based on sizeOriginal rather than size so size can be set to the value expected to be stored in the manifest. As a bonus sizePrior is no longer needed since size can be used for the same purpose."
},
{
"commit": "2ec99ca4d9e40dcae628c2a435c8242bdcefabc2",
"date": "2024-06-12 16:08:17 +1000",
"subject": "Specify test images that get valgrind installed.",
"body": "This means valgrind is no longer built from source, which caused image builds to run for a very long time.\n\nValgrind is only required in a few images for testing."
},
{
"commit": "886bb281f69bb22228eb41760ef8ad60cdd820db",
"date": "2024-06-11 15:20:04 +1000",
"subject": "Migrate CentOS 7 integration tests to Rocky 8.",
"body": "CentOS 7 will be EOL on June 30 and since there is no CentOS 8 migrate instead to Rocky 8."
},
{
"commit": "4ac3b82c99ff3bd48d2cc74651a47ce072ac0022",
"date": "2024-06-11 12:08:52 +1000",
"subject": "Allow alternative WAL segment sizes for PostgreSQL <= 10.",
"body": "Alternative WAL segment sizes can be configured in PostgreSQL <= 10 with compile-time options. We have not allowed these before since it was not a well-tested feature of PostgreSQL.\n\nHowever, forks such as Greenplum allow alternative WAL segment sizes at initdb time (which are presumably well-tested) so it makes sense to allow it.\n\nSince the PostgreSQL versions in question are all EOL it is not important to have this restriction in place anymore."
},
{
"commit": "e8b965756c380953d4312c26c81489cc9787d1cf",
"date": "2024-06-09 11:39:58 +1000",
"subject": "Add unit tests for backup from standby with block incremental.",
"body": "These tests are important for an upcoming bug fix related to differing sizes of a file on a primary vs standby.\n\nThe test that demonstrates the bug cannot be included here since it causes a test failure, but this commit introduces the infrastructure and one test to guard against a regression in the bug fix."
},
{
"commit": "cf478bc75352486b5aed555404f912c6fdea92a0",
"date": "2024-06-08 13:00:53 +1000",
"subject": "Improve efficiency of incremental manifest build.",
"body": "Move the file.copy check before the manifest lookup to save a lookup and (probably) find for zero-length files when bundling.\n\nThis also removes a layer of indentation which helps with readability."
},
{
"commit": "48823b6cd320373b1b8de52d6ff931094fbe43f7",
"date": "2024-06-07 14:24:08 +1000",
"subject": "Simplify lock file scanning in stop command.",
"body": "This simpler implementation only requires that a lock file begin with the stanza (followed by a dash) and end in .lock.\n\nThis will make the implementation more resilient to planned changes in lock file naming."
},
{
"commit": "ea1596152ceba8ad8f8e94d55c992e0982e5c879",
"date": "2024-06-07 14:09:17 +1000",
"subject": "Avoid possible race condition while reading lock files in info command.",
"body": "Since lockRead() was being called twice the state of the lock file could change between leading to invalid data in the info output.\n\nInstead call lockRead() once and use the result for both the validity test and output."
},
{
"commit": "01838995ce08f93789d5003598cf5b43ed405465",
"date": "2024-06-07 09:21:13 +1000",
"subject": "Replace tabs with spaces in meson.build files.",
"body": "These were probably copied over from Makefile.in."
},
{
"commit": "6f562fba60cd035508726b037f72fdcc75e94e88",
"date": "2024-05-31 14:52:07 +1000",
"subject": "Migrate coverage testing to C and remove dependency on lcov.",
"body": "lcov does not seem to be very well maintained and is often not compatible with the version of gcc it ships with until a few months after a new distro is released. In any case, lcov is that not useful for us because it generates reports on all coverage while we are mainly interested in missing coverage during development.\n\nInstead use the JSON output generated by gcov to generate our minimal coverage report and metrics for the documentation.\n\nThere are some slight differences in the metrics. The difference in the common module was due to a bug in the old code -- build/common was being added into common as well as being reported separately. The source of the two additional branches in the backup module is unknown but almost certainly down to how exclusions are processed with regular expressions. Since there is additional coverage rather than coverage missing this seems fine.\n\nSince this was pretty much a rewrite it was also a good time to migrate to C."
},
{
"commit": "49e252f49260c6d8f3925dc7dace0785322ec288",
"date": "2024-05-27 11:49:21 +1000",
"subject": "Begin v2.53 development."
},
{
"commit": "dfc14b193454b3003c10eb2d021699cbd6294004",
"date": "2024-05-27 11:13:16 +1000",
"subject": "v2.52: PostgreSQL 17beta1 Support"
},
{
"commit": "899b8927888f3930f07f5607902d0493bd3b8f05",
"date": "2024-05-24 12:24:11 +1000",
"subject": "New CI container build for PostgreSQL 17 beta1.",
"body": "Update the catalog version for beta 1 so pgbackrest will not work with any prior development versions.\n\nAlso improve the integration/all test so the catalog version does not need to be updated again during the beta period."
},
{
"commit": "c401ae8fb852d8cd7d10b7b7f3dcf1c42de8d3ee",
"date": "2024-05-23 11:03:59 +1000",
"subject": "Explicitly run test servers on ipv4 localhost.",
"body": "If a host defaults to ipv6 then it can confuse the tests and lead to connection failures and inconsistent error messages.\n\nFor now just hard-code the servers to run on ipv4 but this is an area for later improvement."
},
{
"commit": "04b043797634f36d3deb26dcf0357be1ff9971db",
"date": "2024-05-23 10:58:52 +1000",
"subject": "Exclude documentation code coverage from metrics report.",
"body": "Coverage of the documentation code is not important enough to report to users. If it were reported it should be in a separate section (along with test code coverage)."
},
{
"commit": "91156bf7e1dec5dfeec18bf13a112d16e3badfda",
"date": "2024-05-23 08:19:50 +1000",
"subject": "Fix comment typos and formatting."
},
{
"commit": "b6ac11beec920fe978994c0d018c380477199ca8",
"date": "2024-05-23 08:17:02 +1000",
"subject": "Update start/stop documentation to reflect actual functionality.",
"body": "The exact functionality of start/stop has evolved over time and has become a bit confusing. It may be appropriate to make the behavior more consistent but for now at least document the behavior correctly. The documentation for start/stop was fairly inaccurate."
},
{
"commit": "9910a4eddb5a7772a289032dc30d6aeab68536ff",
"date": "2024-05-20 08:44:37 +1000",
"subject": "Add hrnTzSet() to set timezone in tests.",
"body": "3c8819e1 replaced gmtime/localtime with gmtime_r/localtime_r but did not take into account a subtle difference in how they operate. While gmtime/localtime operate as if tzset() has been called, i.e. they operate on the TZ env variable directly, gmtime_r/localtime_r require tzset() to be called after changing TZ for consistent results.\n\nRather than call tzset() every time TZ is changed, add hrnTzSet() to encapsulate both operations."
},
{
"commit": "28ad1badd939b4b02c23140bed82b1dc1034bcda",
"date": "2024-05-18 18:55:53 +1000",
"subject": "Update Fedora test image to Fedora 40."
},
{
"commit": "ffe9a17fcb9b3fe1d7caed64ca142228882d819f",
"date": "2024-05-18 14:33:40 +1000",
"subject": "Replace erroneous THROW_SYS_ERROR_FMT() in storageInfo().",
"body": "This was copied from storagePosixInfo() in a474ba54 but there is no guarantee that errno will be valid at this point. In most cases errno was zero so no system error message was displayed, but when using the Posix driver it could output \"[2] No such file or directory\". For other drivers errno was generally not set but could output a random error message in that case that errno was set by some unrelated action.\n\nUse THROW_FMT() instead since errno will not always be set correctly and in any case \"[2] No such file or directory\" is not very useful information since the main error message already says that.\n\nWhile this is technically a bug it is so harmless that it doesn't merit mention in the release notes.\n\nThis was discovered while testing on Fedora 40 which threw \"[38] Function not implemented\" -- clearly unrelated to missing paths/files."
},
{
"commit": "9e477c432154f5929e0ad3afc4aeae01a739f872",
"date": "2024-05-18 09:59:32 +1000",
"subject": "Update GitHub test checkout and codeql action versions.",
"body": "checkout@v3, codeql-action/init@v2, and codeql-action/analyze@v3 are now deprecated."
},
{
"commit": "db4eefae1a9e999cc6636740e061413b7a09bc37",
"date": "2024-05-10 10:01:16 +0930",
"subject": "Remove ASSERT() in sckClientOpen() to silence Coverity complaint.",
"body": "Coverity complains that this comparison might have a side effect because the variable is volatile. It's hard to see what that might be but since the assertion is not all that important, just remove it. During testing this sort of error will generally be caught by valgrind."
},
{
"commit": "d32eb5bb542f80657cfcc86df7663339297bb431",
"date": "2024-05-10 09:45:01 +0930",
"subject": "Silence invalid Coverity complaint in jsonReadPush().",
"body": "Coverity complains that the output from THROW_FMT will be unpredictable since the order of operations in the call is not deterministic, but it fails to understand that subsequent calls to jsonReadTypeNextIgnoreComma() are noops until the value has been processed.\n\nSilence Coverity by assigning the actual type to a local variable so jsonReadTypeNextIgnoreComma() is only called once.\n\nAlso fix an adjacent comment typo."
},
{
"commit": "bb8988b551757a8932fd99027e436e53609ad7c9",
"date": "2024-04-27 19:14:01 +1000",
"subject": "Update storage (except remote) module to recent coding standards.",
"body": "Add const as appropriate and avoid initializing variables if the variable will definitely be set later on.\n\nThe storage/remote module will be updated with the protocol module once a major waiting refactor has been committed."
},
{
"commit": "76bcb740b66f64804dbbf5a2a6be6407f9cec376",
"date": "2024-04-27 15:42:10 +1000",
"subject": "Add GCS batch delete support.",
"body": "The GCS driver sent a single file delete request for each file while deleting a path. Depending on latency this could lead to rather long delete times, especially noticeable during expiration.\r\n\r\nImprove GCS delete to use batches, which require multipart HTTP, so also add multipart HTTP infrastructure."
},
{
"commit": "e00e33b52856a63e82552ccc12df235d1a7f6f17",
"date": "2024-04-25 19:32:07 +1000",
"subject": "Dynamically find python in meson build.",
"body": "This is better than requiring a python3 binary to be on the path because some installations might have, e.g. python3.9.\r\n\r\nAlso add the python3-distutils package to Debian builds to make this work."
},
{
"commit": "55e996912aa57d39ea21f5dc905b7acabe93b0f8",
"date": "2024-04-25 18:35:48 +1000",
"subject": "Update meson minimum version to 0.47.",
"body": "This allows enabling the check option for run_command, which automatically fails when the command fails."
},
{
"commit": "4ea4e3f3809af24d8a1ff5be15ca7c713f8f40e1",
"date": "2024-04-23 22:34:32 +1000",
"subject": "Update Fedora test image to Fedora 38.",
"body": "This should have been done in 434938e3 but somehow it didn't happen.\r\n\r\nFedora 38 requires 2048 bit keys so update the VM builds to use them. Update the documentation to use 2048 bit keys. This is not technically required by this commit but it makes sense to do it now.\r\n\r\nAlso update the key location for the yum.p.o repository.\r\n\r\nLastly, shuffle test PostgreSQL versions since PostgreSQL 11 is not longer available in the yum.p.o repository."
},
{
"commit": "b40c2616c2a8870b592d8c106a0980a94055aba0",
"date": "2024-04-21 13:16:53 +1000",
"subject": "Update info module to recent coding standards.",
"body": "Add const as appropriate and avoid initializing variables if the variable will definitely be set later on."
},
{
"commit": "c6fcc81db66c4b8f820c4ecf60f7067028dc6e79",
"date": "2024-04-21 13:01:40 +1000",
"subject": "Update db/postgres modules to recent coding standards.",
"body": "Add const as appropriate and avoid initializing variables if the variable will definitely be set later on or is immediately returned."
},
{
"commit": "19411f39d2737542aa28436b3ab661912a5c3965",
"date": "2024-04-21 12:06:39 +1000",
"subject": "Update config module to recent coding standards.",
"body": "Add const as appropriate and avoid initializing variables if the variable will definitely be set later on or is immediately returned."
},
{
"commit": "0e36e1a2fc79d8b425de30f54cc804efb30e3ab1",
"date": "2024-04-21 12:01:01 +1000",
"subject": "Update common module to recent coding standards.",
"body": "Add const as appropriate and avoid initializing variables if the variable will definitely be set later on or is immediately returned."
},
{
"commit": "987e6e31f479874fbb4ff93b6fd45b8178b5e4fa",
"date": "2024-04-21 09:42:11 +1000",
"subject": "Move packager note about meson to new version.",
"body": "Since there were some issues found with the meson install (7877983a, 7b95fd3b) it makes sense for any packagers who have not made the migration to hold off until the next release.\n\nMove the note to the next release where hopefully all issues have been addressed."
},
{
"commit": "9546b9c5d0e4da7bd952b01cc3374c26e9f90ea0",
"date": "2024-04-20 14:19:27 +1000",
"subject": "Update command module to recent coding standards.",
"body": "Add const as appropriate and avoid initializing variables if the variable will definitely be set later on or is immediately returned."
},
{
"commit": "fb22f04555fecfa143354372ec3543ab186c131d",
"date": "2024-04-18 10:56:24 +1000",
"subject": "PostgreSQL 17beta1 support.",
"body": "Add catalog version and WAL magic for PostgreSQL 17."
},
{
"commit": "c8cf8e1f2bfbed2932cfbef4a7a58e3a13e16a46",
"date": "2024-04-17 19:02:28 +1000",
"subject": "Update contributor name."
},
{
"commit": "57731b6cd261c732041aacc094429ab02ca13418",
"date": "2024-04-17 11:58:13 +1000",
"subject": "S3 SSE-C encryption support.",
"body": "This feature (enabled with --repo-s3-sse-customer-key) provides an encryption key to encrypt the data after it has been transmitted to the server.\r\n\r\nWhile not as secure as encrypting data before transmission (--repo-cipher-type), this may be useful in certain configurations."
},
{
"commit": "06d3cb767c171be872262093b4547a62f1b16ee7",
"date": "2024-04-17 11:43:41 +1000",
"subject": "Improve unit testing of valid page sizes in pg_control.",
"body": "Spread the tests over more versions of PostgreSQL and improve/fix comments."
},
{
"commit": "7b95fd3bd29346e7325aa161bfee45efd71e22eb",
"date": "2024-04-10 09:23:17 +1000",
"subject": "Allow explicit disabling of optional dependencies in meson builds.",
"body": "On some platforms, e.g. FreeBSD, there is a requirement to allow the user to disable support for features even when the required library is present.\r\n\r\nIntroduce tri-state options for the optional features: auto mimics the current behavior and is the default, enable requires libraries for the feature to be present, and disable disables the feature without checking the libraries."
},
{
"commit": "dab52739cd36d2486b902b6b32d84532a834671b",
"date": "2024-04-04 18:21:26 +1100",
"subject": "Fix comment typo."
},
{
"commit": "fec1b215e37d644c3ae7a54bf197beb853e3f1db",
"date": "2024-03-30 10:43:05 +1100",
"subject": "Remove test data files made obsolete by d41b21c8.",
"body": "These should have been removed when the mock integration tests were removed.\n\nIdeally we would also remove filecopy.table.bin but it serves to provide realistic page data for performance testing."
},
{
"commit": "9f5a97139fa222cf0b448bf76f0821e399849cd9",
"date": "2024-03-29 12:21:06 +1100",
"subject": "Allow strIdToLog() to output \"null\" values.",
"body": "A valid StringId can never be zero so it more or less serves as a NULL value. In most cases zero will not be valid, but it is better to catch this condition with an assert rather than an error in logging."
},
{
"commit": "014e24889ce082c7cdaf3d128c796e1e00dcd3ff",
"date": "2024-03-27 09:53:49 +1100",
"subject": "Remove extra space before colons in meson.build files.",
"body": "The spacing was not consistent so use the style that best matches our general coding standards."
},
{
"commit": "7877983acb3b1a27e900f7e7aea89cb7b29a817d",
"date": "2024-03-27 09:29:37 +1100",
"subject": "Tag pgbackrest build target in meson as installable.",
"body": "By default meson does not install anything. Targets can be installed by tagging them as installable in the build definition."
},
{
"commit": "924aa5e8b127272bd3eff360a7e5737ef825a51f",
"date": "2024-03-25 11:22:53 +1300",
"subject": "Begin v2.52 development."
},
{
"commit": "dc07fb1e5bd38026d4fefb67a0525a89ac98b520",
"date": "2024-03-25 09:53:22 +1300",
"subject": "v2.51: Meson Build System"
},
{
"commit": "76956e71cfa3044867213bd65a6f22e96120c108",
"date": "2024-03-20 09:05:39 +1300",
"subject": "Fix progress logging when file size changes during backup.",
"body": "If the file size changed during backup then the progress percentage in the log would not be accurate.\r\n\r\nFix this by using the original size to increment the progress since progress total was calculated from original file sizes."
},
{
"commit": "de55902fb3f92758c4784e6fc06a69466e656ec3",
"date": "2024-03-13 12:06:23 +1300",
"subject": "Redact secure options in check --report.",
"body": "For this to be practically useful secure options must be redacted. Otherwise, no user is likely to share the report.\n\nSince this feature is still internal, there is no real world impact."
},
{
"commit": "ff47450402fde5ebc64a08d31791551bee52200e",
"date": "2024-03-12 12:41:58 +1300",
"subject": "Update resume functionality for block incremental.",
"body": "Resume was not updated for block incremental so block incremental files were always removed during a resume. Resume worked but was very inefficient with block incremental enabled.\r\n\r\nUpdate resume to preserve block incremental files and add tests."
},
{
"commit": "e634fd85cedc1ae3aef7c4fa2556d7d73d05cb8a",
"date": "2024-03-10 17:08:42 +1300",
"subject": "Prevent invalid recovery when backup_label removed.",
"body": "If backup_label is removed from a restored backup then PostgreSQL will instead use checkpoint information from pg_control to attempt (what is thinks is) crash recovery. This will nearly always result in a corrupt cluster because the checkpoint will not be from the beginning of the backup, and even if it is, the end point will not be specified, which could lead to recovery stopping too early.\r\n\r\nTo prevent this, invalidate the checkpoint LSN in pg_control on restore. If backup_label is removed then recovery will still fail because PostgreSQL will not be able to find the invalid checkpoint. The LSN of the checkpoint is not logged but it will be visible in pg_controldata output as 0/DEAD. This value is invalid because PostgreSQL always skips the first WAL segment when initializing a cluster."
},
{
"commit": "960b43589d422a3757535b585e31da03a595ae97",
"date": "2024-03-10 16:17:50 +1300",
"subject": "Add validation for WAL segment size in pg_control.",
"body": "This serves as an additional sanity check to be sure the pg_control format is as expected. The field is useful for being near the end and containing a limited number of discrete values."
},
{
"commit": "63541b2273360c8c3f181fe0242bd20afb845715",
"date": "2024-03-10 15:50:10 +1300",
"subject": "Add validation for page checksum version in pg_control.",
"body": "This serves as an additional sanity check to be sure the pg_control format is as expected. The field is useful for being all the way at the end and being four bytes that can only have one of two values. Something more distinctive than 0 and 1 would be better, but this is what we have to work with.\n\nConvert PgControl.pageChecksum to unsigned int and rename to PgControl.pageChecksumVersion and make all downstream changes required for the new datatype."
},
{
"commit": "7448fde157c6d22f57b90c0cef11957b0aadf4b3",
"date": "2024-03-10 11:36:39 +1300",
"subject": "Improved support for dual stack connections.",
"body": "Connections are established using the \"happy eyeballs\" approach from RFC 8305, i.e. new addresses (if available) are tried if the prior address has already had a reasonable time to connect. This prevents waiting too long on a failed connection but does not try all the addresses at once. Prior connections that are still waiting are rechecked periodically if no subsequent connection is successful.\r\n\r\nThis improves substantially on 39bb8a0, which failed to take into account connection attempts that do not fail (but never connect) and use up all the available time."
},
{
"commit": "f287178b705cc90aa887d66c932e2a223029649b",
"date": "2024-03-10 11:09:13 +1300",
"subject": "Set function/variable visibility to hidden.",
"body": "This saves about 16KiB in the binary and reduces exported symbols by about 75%. All variables are still exported and any functions that are referenced by their pointers or extern'd but never used outside the module where they are defined.\r\n\r\nIn addition to modest space savings, this should also increase performance a bit since the compiler can simplify calls to these functions and load the binary should also be a little faster.\r\n\r\nThe GCC documentation does not make it clear that visibility can be used with variables, but it certainly makes a difference in the binary size, so something is happening. Other sources on the internet suggest that visibility can be used with variables. Clearly exports are not affected, but there may be some other optimization happening."
},
{
"commit": "e3d9df3ae9669ee5749b970d59f8afeb20fd3d9d",
"date": "2024-03-10 10:53:31 +1300",
"subject": "Make meson the primary build system.",
"body": "Meson has a lot of advantages over autoconf/make, primarily in ease-of-use and performance. Make meson the only build system used for testing and building the Debian documentation, but leave the RHEL documentation using autoconf/make for now so it gets some testing."
},
{
"commit": "c64cd8e01958c3316049d73f403241c136bcf392",
"date": "2024-03-10 10:43:24 +1300",
"subject": "Disable arm64 test in CirrusCI.",
"body": "There seems to be a shortage of arm64 hosts because queue times have been steadily increasing over the last few weeks. It can now take several hours to get an arm64 test queued, which makes it difficult to get development done.\n\nDisable for the time being and hope the resource issue gets resolved in the future."
},
{
"commit": "eda7706f53e925a701f85894ab3d8e861e5fcf06",
"date": "2024-03-10 09:40:13 +1300",
"subject": "Make valgrind libssh2 leak check less specific.",
"body": "The leak kind is usually definite but sometimes flaps to possible. For stability purposes accept any leak kind.\n\nNote that this is a leak in a specific version of libssh2 and not a bug in pgBackRest."
},
{
"commit": "dddcbcd8e9a1cae578b0cc5bb2d1aa768330f3c5",
"date": "2024-03-10 09:32:55 +1300",
"subject": "Limit resume functionality to full backups.",
"body": "Resume does not work correctly with delta diff/incr backups because the presence of a reference causes it to remove the file with the idea that it can just be referenced again. This is true for timestamp-based backups but for deltas all existing files need to be rechecked (which requires a reference).\r\n\r\nThis is fixable but not without significant effort and new tests and it calls into question the usefulness of non-full resumes. For diff/incr, if the file was changed since the prior backup there is a good chance it will be modified again before the resume occurs.\r\n\r\nIn order to keep this feature as useful as possible for the most valuable case, limit resumes to full backups."
},
{
"commit": "9d91d1b2f817b543fc8d970af56d1442c325ed7c",
"date": "2024-03-08 15:07:43 +1300",
"subject": "Detect files that have not changed during non-delta incremental backup.",
"body": "02eea55 added code to load a buffer of data from a file being backup up to detect files that have been truncated to zero after manifest generation. This mechanism can also be used to detect files that have not changed since the prior backup.\r\n\r\nIf the result of the file copy fits into a single buffer, then the size and checksum can be compared to the prior file before anything gets stored. If the file matches then it is referenced to the file in to prior backup.\r\n\r\nThe size that can be compared for normal copies is limited by the buffer size but for block incremental it works with any size file since there is no output from block incremental when the file is identical."
},
{
"commit": "cf17515e409440eecfb04bf7186790d8baa8ab12",
"date": "2024-03-08 12:34:11 +1300",
"subject": "Improve archive-push WAL segment queue handling.",
"body": "Infer the size of all WAL segments from the size of the first segment rather than getting info for all segments (up to queue size). If the segments are not the same size then there are larger issues than the WAL queue."
},
{
"commit": "4387250f2e159dc4f762ed4a7f4180eb81db3717",
"date": "2024-03-08 10:07:03 +1300",
"subject": "Improve sort comparators.",
"body": "Improve sort comparators to use branchless comparisons when possible and avoid using subtraction. Only one comparator was using subtraction and it appears there was no overflow risk since the values were pretty small.\r\n\r\nInspired by https://www.postgresql.org/message-id/CA%2B14426g2Wa9QuUpmakwPxXFWG_1FaY0AsApkvcTBy-YfS6uaw%40mail.gmail.com."
},
{
"commit": "e00bfe2d2c3f124b2883e3c2d169a2ce506a1e98",
"date": "2024-03-08 09:50:20 +1300",
"subject": "Fix performance regression in storage list.",
"body": "storageListP() returns a list of entries in a path and should not need to stat/head, etc. in order to get more detailed info. This was broken by 75623d4 which failed to set the level correctly.\r\n\r\nSet the correct level and update tests.\r\n\r\nThere's no easy way to directly test for a regression here but the SFTP tests will fail if more detailed info is requested since it would require script changes."
},
{
"commit": "794c5771305bfce6298ee529df682d3a873f6f7d",
"date": "2024-03-06 11:00:09 +1300",
"subject": "Migrate integration tests to C.",
"body": "The Perl integration tests were migrated as faithfully as possible, but there was some cruft and a few unit tests that it did not make sense to migrate.\n\nAlso remove all Perl code made obsolete by this migration.\n\nAll unit, performance, and integration tests are now written in C but significant parts of the test harness remain to be migrated."
},
{
"commit": "7f1bb3a051077d8af2bcadfb261c873b1bdcea9f",
"date": "2024-03-05 17:45:25 +1300",
"subject": "Remove obsolete valgrind suppression."
},
{
"commit": "cb58bdc9752e720687e594fa953e1b4a93b8defe",
"date": "2024-03-04 18:57:19 +1300",
"subject": "Move assert in cmdServerSigChild().",
"body": "It is possible for the server to receive notifications for children that were not spawned by it, e.g. when running as the root process of a container.\n\nOnly assert when the child process is found in our process list. Otherwise, the code may be something unexpected.\n\nSince this is an assert there should not be any real world consequences either way, but the issue has caused problems in testing."
},
{
"commit": "07051347fb8723ef1c6f951b17bcddb8fa0d8fcf",
"date": "2024-03-04 18:14:41 +1300",
"subject": "Update Cirrus CI BSD image to 13.3."
},
{
"commit": "f7a7ab16c9652179945717ebf9b68af3aa8a0b0e",
"date": "2024-03-02 12:29:10 +1300",
"subject": "Skip zero-length files for block incremental delta restore.",
"body": "a42614e introduced the capability to preserve smaller than expected files for block incremental restore delta, but failed to take into account that zero-length files are both useless and cause the block checksum filter to error.\r\n\r\nFix this by skipping zero-length files during block incremental restore delta."
},
{
"commit": "6c45b57fa8eef0f570abb1ac216ac43e0acf314a",
"date": "2024-02-24 11:22:48 +1300",
"subject": "Add execOne() to simplify exec for build, documentation, and testing.",
"body": "The core Exec object is efficient but geared toward the specific needs of core and not ease-of-use as required for build, documentation, and testing.\n\nexecOne() works similarly to system() except that it automatically redirects stderr to stdout and captures the output."
},
{
"commit": "6356a2b76c8f22dc0b3e1a0349b7f1f0cf1b65ae",
"date": "2024-02-17 19:16:39 +1300",
"subject": "Disable log expect testing for non-unit tests.",
"body": "This has never been a problem for performance tests since they do not call functions that log at info level or above, but the upcoming integration tests may do so. In any case it is better to disable this functionality outside of unit tests."
},
{
"commit": "d41b21c8f70aa6ce7a39aeaddbbacafda51c609d",
"date": "2024-02-17 10:52:37 +1300",
"subject": "Remove mock integration tests.",
"body": "These tests have not been maintained for several years, i.e. no tests for new features have been added. They are highly duplicative of the unit tests but do have the advantage of mixing in different storage drivers. They were allowed to remain because they were not doing any harm even if they were probably not doing any good.\n\nHowever, the real integration tests (that run directly against PostgreSQL) also test storage drivers and have been updated with new features over time. The real integration tests are now being migrated to C and as part of that effort the mock integration tests need to be removed or migrated, and they do not provide enough value to migrate.\n\nRemove all mock integration tests and a leftover Perl performance test."
},
{
"commit": "68351785f6816a23526900db595557cf6e3a0056",
"date": "2024-02-16 11:37:31 +1300",
"subject": "Update references to recovery.conf.",
"body": "Update references to recovery.conf to include postgresql.auto.conf used in newer versions.\r\n\r\nAlso update a broken recovery URL and point it to the current version (with a hint to select the proper version of PostgreSQL)."
},
{
"commit": "273d5050f8bd74869408d9570a35761ba5de75f1",
"date": "2024-02-07 11:01:55 -0300",
"subject": "Add asserts to default switch cases in common/type/variant module.",
"body": "This matches how switch is used in other parts of the code and prevents invalid values from being processed normally."
},
{
"commit": "ad8e92a9ac23a0123a080dafe6b83f0b71a22441",
"date": "2024-02-05 10:10:59 -0300",
"subject": "Remove unneeded backupTimeStart parameter from testBackupValidate().",
"body": "5ce8b9df added this parameter, but it is better to get the value from the manifest, which is already present."
},
{
"commit": "45f070aa9a221c6f862ff6ccb4ff011bfa6c3888",
"date": "2024-01-25 10:41:20 -0300",
"subject": "Add release instructions to update PostgreSQL ecosystem wiki."
},
{
"commit": "5ce8b9dfae984a9a40c44282a59936da5c3dfbd9",
"date": "2024-01-24 14:54:28 -0300",
"subject": "Simplify output in command/backup unit tests.",
"body": "The output combined a representation of the files/paths/links in the manifest along with output of what was validated on disk. This was redundant and made maintenance of the tests difficult, especially with all the quoting in the manifest output (which also made it hard to search for output).\n\nInstead use primarily the output created during validation and add fields from the manifest that were missing. Exclude paths from the output when there are files in the path since the path is then implied.\n\nOne major change here is that checksums are no longer output. This makes it easier to write tests that work on multiple architectures and all checksums are already verified during validation."
},
{
"commit": "1a0cc96c5a58cea2a21b8754909c6a2b824c3f9e",
"date": "2024-01-23 09:56:26 -0300",
"subject": "Migrate man page generation to C."
},
{
"commit": "676700d8ca6f2e0e0ab8123aa9606c8ec7aa81ae",
"date": "2024-01-22 14:17:09 -0300",
"subject": "Add detailed backtrace to autoconf/make build.",
"body": "c8264291 added libbacktrace to the meson build (not used in production yet), but held off on adding it to autoconf/make before more performance testing was done.\r\n\r\nPerformance tests show there is no noticeable cost to adding libbacktrace, so add it to get more detail error stack traces."
},
{
"commit": "0aaa0772f56d59178518377b33b3e3d02f0f5483",
"date": "2024-01-22 12:33:40 -0300",
"subject": "Fix help not displaying help for the help command.",
"body": "'pgbackrest help help' just displayed the help overview, rather than display help for the help command.\n\nFix this by making sure the command is set and routing correctly in the help command."
},
{
"commit": "68db3075d7ac4a48377967ad54e45b95b9ee6c61",
"date": "2024-01-22 12:00:13 -0300",
"subject": "Allow --version and --help for version and help.",
"body": "It is a bit confusing that --help and --version do not work like most command-line programs. For example, git allows either --help or help.\r\n\r\nMake these work by making them shortcuts (not actual options) to the applicable commands.\r\n\r\nThe user will still need to use help (not --help) to get help on specific commands/options, but at least they can get to the main help (which will tell them this) via --help."
},
{
"commit": "db5bcff3b443833dce6ba0f10ce4293d65f0f436",
"date": "2024-01-22 10:11:48 -0300",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "c618fd3b09fab8cde44ad8e5fe0cb984c1bc76d4",
"date": "2024-01-22 10:09:38 -0300",
"subject": "Begin v2.51 development."
},
{
"commit": "1add35624dbf4061bcb19521022b318418b0bba5",
"date": "2024-01-22 09:54:59 -0300",
"subject": "v2.50: Performance Improvements and Bug Fixes"
},
{
"commit": "fd8974914d8702e5d889f03e08eeda676435faa2",
"date": "2024-01-12 13:55:08 -0300",
"subject": "Cleanup tablespace tests in command/backup module.",
"body": "Tablespaces were enabled for tests that did not have tablespaces, resulting in tablespace_map being present in backups even when it was not needed.\n\nInstead of specifying if tablespaces are present, automatically detect tablespaces in hrnBackupPqScript()."
},
{
"commit": "3926dd346ef7b6e239e939e9a046a4be8597c584",
"date": "2024-01-04 14:55:44 -0300",
"subject": "Update LICENSE.txt and PostgreSQL copyright for 2024."
},
{
"commit": "a484862763e85a7cc11b6a45366b3b78b06cd373",
"date": "2024-01-04 14:53:44 -0300",
"subject": "Remove installation of old yum.p.o repository key."
},
{
"commit": "55f22489630ae409f03a2ad9ec37c3e38a3f7ab2",
"date": "2024-01-03 18:15:50 -0300",
"subject": "Break up scripts in db unit test module.",
"body": "Long scripts followed by a number of tests are really challenging to debug and update.\n\nInstead, break up the scripts to be inline with the tests that they drive. This should make maintenance of the tests much simpler."
},
{
"commit": "7c17eec3db455d3e8e660f4f8247b6975517648f",
"date": "2024-01-03 13:01:50 -0300",
"subject": "Improve SFTP storage error messages.",
"body": "Use storageSftpEvalLibSsh2Error() in more locations to provide better error information. Also add storageSftpLibSsh2SessionLastError() for the same reason."
},
{
"commit": "802ae7914897f3d53788e526ce22562e434c92ea",
"date": "2024-01-03 12:43:50 -0300",
"subject": "Remove FreeBSD 12 and add FreeBSD 14 to Cirrus CI.",
"body": "FreeBSD 12 is now EOL.\n\nAlso update the image version for FreeBSD 13."
},
{
"commit": "8a8cfba62bfe2293d6355f68d44bab5323a91118",
"date": "2023-12-27 12:53:53 -0300",
"subject": "Remove resolved comment."
},
{
"commit": "f4a4af299bee93ab7dde599ccdb35becc1c2afad",
"date": "2023-12-27 12:49:47 -0300",
"subject": "Fix short read in block incremental restore.",
"body": "During restore it is possible to read all the blocks out of a compressed super block without reading all the input. This is because the compression format may have some trailing bytes that are not required for decompression but are required to indicate that data has ended. If a buffer aligned with the compressed data in a certain way, these last bytes might not be read.\r\n\r\nExplicitly read out any final bytes at the end of each super block to handle this case. This should always result in no additional data out and we check for that, but it does move the read position to the beginning of the next compressed super block so decompression can begin without error."
},
{
"commit": "c47b39acf67b375cbee9773904ad1afc6a1bb9ec",
"date": "2023-12-27 12:39:45 -0300",
"subject": "Fix incorrect test comment.",
"body": "Left over from an older implementation."
},
{
"commit": "4324b568a922105b272e2031559dae5f374a04da",
"date": "2023-12-26 21:07:56 -0300",
"subject": "Move block testBlockDelta() to harness module.",
"body": "This makes the function available to other test modules.\n\nAlso rename to hrnBlockDeltaRender()."
},
{
"commit": "9049fec2c02c4110e16ffdff7b56f83d8ff32b4a",
"date": "2023-12-22 13:16:45 -0300",
"subject": "Refactor skip files truncated during backup when bundling.",
"body": "Refactor 02eea555 to always close the file immediately on EOF and use backupCopyResultCopy to continue processing. Closing the file immediately saves a later EOF check and is friendlier to added logic in this area. Using backupCopyResultCopy to continue is clearer also makes it easier to add new logic.\n\nAlso store zero checksum so the bulk of results collection can be moved within the copy block."
},
{
"commit": "c8795094d418802a0e24d4d19da66973c71b00e5",
"date": "2023-12-22 12:48:01 -0300",
"subject": "Allow const checksum buffers to be returned from backupFile().",
"body": "This allows less duplication of buffers.\n\nFor delta check return file->pgFileSize/file->pgFileChecksum instead of pgTestSize/pgTestChecksum since this saves one buffer duplication and we know these values are equal since we just checked them.\n\nAlso add an assert to ensure copyChecksum is valid relative to size."
},
{
"commit": "4f760df417e17dc03ce07c0116dfaac506e04c84",
"date": "2023-12-22 00:59:12 -0300",
"subject": "Do not preserve block incremental if file is less than prior block size.",
"body": "If a file stored with block incremental shrinks below the prior block size then the map is useless and the entire file needs to be stored again.\r\n\r\nIn this case use the new block incremental values (even if none) rather than preserving the old ones."
},
{
"commit": "3cd8249dbaa085bd075464d420f68a2a8b34a165",
"date": "2023-12-21 15:28:37 -0300",
"subject": "Update warning for backup resume invalid repo file.",
"body": "This warning has had a note since the C migration that it should be moved below the backup file log message, so do that.\n\nAlso update the warning message a bit to correct for tense. This message was likely in a different place originally."
},
{
"commit": "701865eca1c8896a913e05f41a748c225b84af11",
"date": "2023-12-21 15:20:03 -0300",
"subject": "Refactor backupFile() to remove backupCopyResultReCopy.",
"body": "Having two enum values for file copy makes things a bit more complicated than they need to be (especially in an upcoming commit).\n\nInstead add a flag to indicate that the repository file was invalid since the only purpose is to trigger a warning message."
},
{
"commit": "a42614e8f3a9e6871c16331f01c2cd765ab181aa",
"date": "2023-12-21 15:08:07 -0300",
"subject": "Preserve partial files during block incremental delta restore.",
"body": "Previously files that were smaller than the expected size were not preserved for block incremental, even though it is possible that block incremental could make use of a partial file.\r\n\r\nOne example is when a restore encounters an error. On retry the partial file can be used as a starting point rather than copying again from the beginning. Another example is restoring a backup where a file is larger than what already exists in the data directory.\r\n\r\nPreserve any size file when block incremental will be used for the delta in order to reuse partial files when possible. If the file is smaller than expected then disable the whole-file checksum to reduce overhead."
},
{
"commit": "ad8febec0851473240f6f20bd4eb299b525a6d44",
"date": "2023-12-21 13:32:10 -0300",
"subject": "Refactor backup incremental manifest generation.",
"body": "This refactor should provide more clarity on what factors affect an incremental, rather that just having one big expression do it all. Overall this may be slightly more efficient since some values are reused that before were recalculated.\r\n\r\nNo behavioral changes are introduced."
},
{
"commit": "f3584e2143de518bda52151a7102ed638dcb0e95",
"date": "2023-12-21 11:20:10 -0300",
"subject": "Add tests to command/backup and info/manifest modules.",
"body": "These tests exercise various interesting cases and provide coverage for proposed improvements."
},
{
"commit": "25f14898babf4ad78baef3e8343933a863633975",
"date": "2023-12-21 10:16:13 -0300",
"subject": "Fix overflow suppressing backup progress in info output.",
"body": "Writing the sz and szCplt parameters in the lock file used jsonWriteUInt64() but reading these parameters used jsonReadUInt(). This caused a silent exception for any backups larger than MAX_UINT and prevented the info command from reporting progress.\r\n\r\nCorrect this so the reads are symmetric and verified before/after with a test."
},
{
"commit": "8af3c1c9acc7117a0cf8e3ce862c5639c82bf78d",
"date": "2023-12-17 13:15:03 -0300",
"subject": "Use original file size to log size changes during backup.",
"body": "c9703b35 added logging for file size changes during backup. Later 5ed6f8df added the sizeOriginal member to ManifestFile, which arguably is better to use for logging rather than size before backup since it will always contain the original size. Size could in theory be modified for deduplication purposes.\n\nUpdate logging to use sizeOriginal."
},
{
"commit": "bb6e5164ee6efd40fde73acd8f7b30c4afa1548d",
"date": "2023-12-16 11:42:27 -0300",
"subject": "Add block incremental test where timestamp changes but file is the same.",
"body": "If delta is not enabled, then the timestamp is used to determine if a file has changed. If the timestamp changes but the file is the same then the prior map will be stored unchanged in the new backup. This is not quite as bad as storing the entire file but it is obviously not ideal.\n\nThis will be fixed in a future commit, but add the test now to show the current behavior."
},
{
"commit": "02eea555c7169e99892fdbc8ce7cc1ee59f50509",
"date": "2023-12-14 14:21:06 -0300",
"subject": "Skip files truncated during backup when bundling.",
"body": "In bundle mode pgBackRest skips files of zero size, that is, it does not queue them for copying.\r\n\r\nAfter splitting the files into bundles, pgBackRest launches one or more processes that directly perform the backup, namely, read the files and, if necessary, write them to the bundles.\r\n\r\nIf during the time between the distribution of all files among bundles and the direct copying of a file to a bundle, this file of non-zero size was truncated to zero size (for example, when the table was truncated), then pgBackRest still unconditionally places such a zero-size file in the bundle, taking up space in it equal to the size of the headings, and additionally writes the original file size to the manifest.\r\n\r\nIn debug build an assertion was added, that does not allow zero-size files to be written to bundles, which leads to an error.\r\n\r\nTo solve the problem, this patch, when reading the next file, loads one buffer from the file to detect if it is zero-size. If so it marks the file as truncated and continues on to the next file.\r\n\r\nThe advantages of the solution are that, firstly, the assert will not fire on debug builds, and secondly, we will not place zero-size files in bundles, which exactly corresponds to the specification.\r\n\r\nThe patch adds the backupCopyResultTruncate value to the BackupCopyResult enumeration to use it to indicate the result when a non-zero size file is truncated to zero size during the backup process."
},
{
"commit": "89d5278b74ab0d880345575d7ac4c239cd1fce54",
"date": "2023-12-14 13:28:52 -0300",
"subject": "Add support for alternate compile-time page sizes.",
"body": "Alternate pages sizes can be selected at compile-time, .e.g. 4096. While compile-time settings are generally not well tested by core, some established forks such as Greenplum use them."
},
{
"commit": "d205a61949ae8491f5ce9b2019cda79d2fe7b216",
"date": "2023-12-01 11:54:30 -0300",
"subject": "Fix flapping test on older ninja versions in test unit.",
"body": "Older versions of ninja may fail to rebuild correctly when changes are made to the configuration. In this case there is an automatic retry but the unexpected log output would cause the test to fail.\n\nFor tests that are expected to succeed, check that the log is empty but also accept a retry message as long as the test does eventually succeed.\n\nAdd a new harness function, harnessLogResultEmptyOrContains(), to make this work and also clean up some adjacent code."
},
{
"commit": "7ce0f5a94c229abe415029ce80241a64665c93a2",
"date": "2023-11-30 16:43:09 -0300",
"subject": "Use unique port for each server unit test.",
"body": "If the same port is reused too quickly bind may fail with this error:\n\nFileOpenError: unable to bind socket: [98] Address already in use\n\nWe specify SO_REUSEADDR when creating the socket but apparently this is not always enough if the port is reused very rapidly.\n\nFix this (hopefully) by using a unique port for each test that needs one. This does in theory limit the number of tests that can use ports, but we allow 768 per test, whereas the test that uses the most ports is common/io-tls with 4."
},
{
"commit": "a14732789baacb4d35d5da6d0adf337ceea7f595",
"date": "2023-11-29 09:31:57 -0300",
"subject": "Output coverage report on test failure in CI.",
"body": "This allows analysis of coverage failures that only happen in CI. It is not ideal since the report needs to be copied from the log output into an HTML file where it can be viewed, but better than nothing."
},
{
"commit": "cb6bceb9f1074436b7d0b67a94d782113b5f2b35",
"date": "2023-11-28 16:38:42 -0300",
"subject": "Improve comments in socket test harness."
},
{
"commit": "70e15dacc77bcc2b7e4c2a222d683872d2180f5b",
"date": "2023-11-28 16:35:37 -0300",
"subject": "Allow custom type/message for errRetryAdd().",
"body": "It may be useful to customize the message or add a message that was never thrown. The latter case will be used in an upcoming commit."
},
{
"commit": "85bc9f27d8b70a879051f604861078034263b095",
"date": "2023-11-27 09:06:53 -0300",
"subject": "Begin v2.50 development."
},
{
"commit": "3cb891e3ca49ed1166fb0b513b126412448f5b09",
"date": "2023-11-27 08:55:56 -0300",
"subject": "v2.49: Remove PostgreSQL 9.3 Support"
},
{
"commit": "7d51228bf5227494bf50327488032221bd3d30fa",
"date": "2023-11-24 17:07:49 -0300",
"subject": "Migrate backupFile() tests in command/backup module.",
"body": "The backupFile() tests were written before the bulk of the backup command had been migrated to C. Some of them have been migrated to the complete backup tests, but others were left because there was no way to make changes to files during a backup.\n\nNow that we have the backup script harness introduced in 337da35a it is now possible to migrate all the tests. The new tests are better because they not only test backupFile() but all the functions upstream and downstream of it."
},
{
"commit": "337da35ab278e058ec4cdffeb4319f1a1e2cb0df",
"date": "2023-11-24 12:25:40 -0300",
"subject": "Add test to show behavior of bundled files truncated during backup.",
"body": "This behavior violates an assertion but is completely possible with the current implementation. This behavior will be fixed in a future commit, but for now at least test how it works correctly and remove the assertion so the test runs without error.\n\nAlso add a new harness that allows changes during the backup to be scripted."
},
{
"commit": "ac78b965837440ee34f7b5bf0a039c6e9d78eeec",
"date": "2023-11-18 11:12:41 -0300",
"subject": "Remove unused fields from backupJobResult() test in command/backup unit.",
"body": "These fields were not used because of the noop so it was hard to keep them up to date. Rather than attempt to do so, just remove them and add a comment to explain why they are missing."
},
{
"commit": "c4dc4665f88e9d67a3b66f44cd59d6dd4bb5107f",
"date": "2023-11-18 10:47:58 -0300",
"subject": "Fix recursive path remove in SFTP storage driver.",
"body": "storageSftpPathRemove() used LIBSSH2_FX_FAILURE to determine when it was attempting to unlink a directory, but it appears that LIBSSH2_FX_PERMISSION_DENIED is also valid for this case.\r\n\r\nUpdate storageSftpPathRemove() to accept either error and adjust tests."
},
{
"commit": "e2b734eff97e3fac32895b799cc32126013aae27",
"date": "2023-11-16 12:50:09 -0300",
"subject": "Allow config/load unit test to run without libssh2 installed.",
"body": "Add additional #ifdef HAVE_LIBSSH2 wrapping around tests requiring libssh2 in loadTest.c."
},
{
"commit": "05207bb8e4f462cd2fd5c685d43ad8911b219077",
"date": "2023-11-15 09:41:40 -0300",
"subject": "Fix storageReadRemote() to return actual read bytes.",
"body": "All storage interface read methods should return actual read bytes. This patch refactors storageReadRemote() to eliminate duplicated code and return actual read bytes. The return value is calculated as the number of bytes written to the passed buffer.\r\n\r\nThis is technically a bug but does not express as an issue currently because this return value is not being used. It will be used in the future, though, so it needs to be fixed."
},
{
"commit": "ea317df5d9af66935175f7ec87845f30be4f5d36",
"date": "2023-11-11 10:33:09 -0300",
"subject": "Remove old version conditionals from user guide.",
"body": "The user guide does not need to build for EOL versions of PostgreSQL, so remove some conditionals used to support versions older than 12."
},
{
"commit": "eb69e2ee6339047f0145b751437ac2bec82bb5ab",
"date": "2023-11-10 17:00:57 -0300",
"subject": "Update point-in-time recovery documentation for PostgreSQL >= 13.",
"body": "PITR changed in PostgreSQL 13 to error when the recovery target is not reached. Update the documentation to work with PostgreSQL >= 13 as well as < 13.\n\nAlso update the versions built for RHEL and Debian since PostgreSQL 11 is now EOL."
},
{
"commit": "dcf078198761a2cfe9be6b4c7f4b4fb07ef53cbf",
"date": "2023-11-09 12:59:12 -0300",
"subject": "Remove support for PostgreSQL 9.3.",
"body": "Per our policy to support five EOL versions of PostgreSQL, 9.3 is no longer supported by pgBackRest.\r\n\r\nRemove all logic associated with 9.3 and update the tests."
},
{
"commit": "fa5b2d44ad9f7591517eecaaaaeb07e9500dd51c",
"date": "2023-11-09 12:04:25 -0300",
"subject": "Fix regression in retries.",
"body": "5314dbf aimed to make nested Wait objects more accurate with regard to wait time but it also got rid of the \"bonus\" retry that was implicit in the prior implementation. This meant that if an operation used up the entire allotted timeout, it would not be retried. Object stores especially are noisy places and some amount of retry should always be attempted. So even though removing the \"bonus\" retry was intended, it turned out not to be a good idea.\r\n\r\nInstead of an implicit retry, formalize two retries in the Wait object even if the wait time has expired. Any number of retries are allowed during the wait period. Also remove waitRemaining() since it is no longer needed.\r\n\r\nAdjust tests as needed to account for the extra timeouts.\r\n\r\nNote that there may still be an underlying issue here that is simply being masked by retries. That is, the issue expressing was that waiting for a socket to be writable was timing out and without a retry that caused a hard error. This patch does nothing to address the source of the write timeout and perhaps there is nothing we can do about it. It does seem similar to the write issue we had with our blocking TLS implementation, but it was never clear if that was a problem with TLS, the kernel, or a bug in pgBackRest itself. It cropped up after a kernel update and we switched to non-blocking TLS to address the issue (c88684e)."
},
{
"commit": "3c116e1829a0df62aaf50ce241c63d829eb438e0",
"date": "2023-11-04 14:43:11 -0300",
"subject": "Remove unused header."
},
{
"commit": "e0f5880b09624db2c9274a8a615a5309a0bddab1",
"date": "2023-10-22 13:55:56 -0400",
"subject": "Refactor of pq shim to allow more flexible scripting.",
"body": "The pq scripts were pretty static which had already led to a lot of code duplication in the backup test harness.\n\nInstead allow the scripts to be built dynamically, which allows for much more flexibility and reduces duplication. For now just make these changes in the backup harness, but they may be useful elsewhere.\n\nWhile we are making big changes, also update the macro/function names to hew closer to our current harness naming conventions."
},
{
"commit": "306fdff93a072c72d6a40aab728ceeb44cc7b23f",
"date": "2023-10-19 10:11:27 -0400",
"subject": "Remove unused parameter in backupProcess().",
"body": "Also fix a comment in the same function."
},
{
"commit": "04d92cca7eb42e0037e65701109da284b214c84f",
"date": "2023-10-19 09:54:34 -0400",
"subject": "Tidy and align site introduction and description.",
"body": "Make the description more concise and use it for both the site description and introduction."
},
{
"commit": "459d59615a18c147140b1ae94a804be66541c0ab",
"date": "2023-10-18 18:14:32 -0400",
"subject": "More efficient/compact calculations for encoded sizes.",
"body": "encodeToStrSizeBase64() is definitely more efficient (pulled from the PostgreSQL implementation).\n\nencodeToStrSizeBase64Url() is probably about as efficient as the prior implementation but is certainly more compact.\n\nAlso add tests for zero byte encoding sizes."
},
{
"commit": "21c8c8a66cb06eba714bfa41bed7239af3d14f08",
"date": "2023-10-14 16:22:09 -0400",
"subject": "Document maintainer options.",
"body": "Document maintainer options in a separate section with appropriate explanation and caveats.\r\n\r\nAlso make the pg-version-force option user visible now that maintainer caveats have been documented."
},
{
"commit": "81536cd486d716ebd10eb0637ef6b1b9a61d9dd0",
"date": "2023-10-10 16:49:05 -0400",
"subject": "Simplify description rendering in command and configuration reference.",
"body": "The reference documentation was still using a very old version of rendering from before the user guide was introduced. This was preserved in the initial C migration to reduce the diff between Perl and C for testing purposes. The old version used hard linefeeds to simulate paragraphs and reduce the amount of markup that needed to be used. In retrospect this was not a great idea.\n\nInstead use more natural rendering that does not depend on using hard linefeeds between paragraphs."
},
{
"commit": "45abea471ecec10a351bfd9e5fbed8737c32da42",
"date": "2023-10-10 13:02:50 -0400",
"subject": "Simplify section titles in configuration reference.",
"body": "For some reason the internal section id was included in the title. This was probably copied from another section title where it made more sense, e.g. including the option name after the title.\n\nAlso add release note missed in 1eb01622."
},
{
"commit": "1eb0162208b37f577d35ba775f007202b285900a",
"date": "2023-10-09 14:03:43 -0400",
"subject": "Build command and configuration reference in C.",
"body": "Migrate generation of these files from help.xml to the intermediate documentation format. This allows us to share a lot of code that is already in C and remove duplicated code in Perl. More duplicate code can be removed in Perl once man generation is migrated.\n\nAlso update the unit test harness to allow testing of modules in the doc directory."
},
{
"commit": "983cc1a9e3f2865bf5128b5065722fd995382ba1",
"date": "2023-10-01 16:32:27 -0400",
"subject": "Adjust timeouts in the common/io/tls test to fix flapping coverage.",
"body": "This test was failing coverage pretty regularly because the retry in tlsClientOpen() was not always being reached. Make the TLS timeouts longer to ensure reliable coverage."
},
{
"commit": "af4621894a20ca0333726d459e2e6409bd4ee1e0",
"date": "2023-09-30 12:47:15 -0400",
"subject": "Fix common/lock test failing with -Werror=unused-result.",
"body": "Wrap ftruncate() in TEST_RESULT_INT() to prevent this error."
},
{
"commit": "eccd9eed196ff9adc074061f26fec523eae2ba00",
"date": "2023-09-30 12:45:24 -0400",
"subject": "Update Minio test/documentation container version."
},
{
"commit": "33ba4db9cbd334c9a10f15880e13e3fb589c3b10",
"date": "2023-09-30 09:40:44 -0400",
"subject": "Use CSS to number sections in documentation.",
"body": "This reduces churn in the HTML when sections are added or removed from the documentation."
},
{
"commit": "1d5563288cf1839acb237a188b865ecb01fe97da",
"date": "2023-09-29 17:28:00 -0400",
"subject": "Parse defaults and text sections in help.xml.",
"body": "These will be required to build documentation in C."
},
{
"commit": "088026e6ffcd1b084099e11f8461fdd3895b2507",
"date": "2023-09-29 17:06:37 -0400",
"subject": "Allow documentation source file to be specified in manifest.",
"body": "The help source file had previously been hardcoded and now that is no longer needed.\n\nA future commit will introduce more sources outside of the xml path."
},
{
"commit": "55fda01733f2a7e71ee175345e26344a99989927",
"date": "2023-09-29 16:57:01 -0400",
"subject": "Remove unused references to DocConfig and DocConfigData Perl modules."
},
{
"commit": "217584a2c4134667e82b2de8032b5334214e08f1",
"date": "2023-09-29 16:52:08 -0400",
"subject": "Add new XML functions required for building documentation."
},
{
"commit": "8f319b6fd34f3430b5b527825bd502113f8a957d",
"date": "2023-09-25 09:43:30 -0400",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "084c8e1691f59aa412b859f9004e188383826c58",
"date": "2023-09-25 09:40:45 -0400",
"subject": "Begin v2.49 development."
},
{
"commit": "a7ab686d0e3d48b3200986d91ea3489488800382",
"date": "2023-09-25 09:32:15 -0400",
"subject": "v2.48: Repository Storage Tags"
},
{
"commit": "cb3ff6ed4336af9e4c0643d8224d5bc3d790a655",
"date": "2023-09-23 13:41:03 -0400",
"subject": "Fix command reference example for the filter option.",
"body": "This example was broken by 24f7252. Revert to (almost) the prior code to fix this example until something better can be committed. The something better is in progress but it adds new build requirements so it is too late to include it for the release.\n\nTechnically this breaks some other examples, but they are all internal and not visible in the user-facing documentation."
},
{
"commit": "6f0f2b371e6604552001b56e8931c6d15ceab41f",
"date": "2023-09-19 19:01:16 -0400",
"subject": "Update help title for the --annotation option.",
"body": "Fix capitalization and remove pluralization that is implied."
},
{
"commit": "c3c0834e170196a1241a368779162fcca65f9ad5",
"date": "2023-09-19 16:26:13 -0400",
"subject": "Allow storage/sftp unit test to run without libssh2 installed.",
"body": "Add missing #ifdefs and update tests to prevent test compilation failure and test run issues when libssh2 is not present."
},
{
"commit": "bb752cd111b1257088e57137bdbe6715e96eb292",
"date": "2023-09-19 12:08:09 -0400",
"subject": "Remove duplicate tests from storage/sftp unit test module.",
"body": "These tests are already run as part of storage/posix and do not need to be duplicated in storage/sftp."
},
{
"commit": "31de127cf42438b1fac04c161c47264aa1fb1060",
"date": "2023-09-19 11:30:29 -0400",
"subject": "Fix issue restoring block incremental without a block list.",
"body": "It is currently possible for a block map to be written without any accompanying blocks. This happens when a file timestamp is updated but the file has not changed. On restore, this caused problems when encryption was enabled, the block map was bundled after a file that had been stored without block incremental, and both files were included in a single bundle read. In this case the block map would not be decrypted and the encrypted data was passed to blockMapNewRead() with unpredictable results. In many cases built-in retries would rectify this problem as long as delta was enabled since block maps would move to the beginning of the bundle read and be decrypted properly. If enough files were affected, however, it could overwhelm the retries and throw an error. Subsequent delta restores would eventually be able to produce a valid result.\r\n\r\nFix this by moving block map decryption so it works correctly no matter where the block map is located in the read. This has the additional benefit of limiting how far the block map can read so it will error earlier if corrupt. Though in this case there was no repository corruption involved, it appeared that way to blockMapNewRead() since it was reading encrypted data.\r\n\r\nArguably block maps without blocks should not be written at all, but it would be better to consider that as a separate change. This pattern clearly exists in the wild and needs to be handled, plus the new implementation has other benefits."
},
{
"commit": "88edea4571d954e54a561247de587f747eaaadca",
"date": "2023-09-18 11:30:42 -0400",
"subject": "Add block incremental info to restore detail logging.",
"body": "Log that block incremental was used and the delta size if less than the entire file was updated."
},
{
"commit": "d27533b40f039ff8da3a284d77fccff101083492",
"date": "2023-09-17 17:06:42 -0400",
"subject": "Fix manifest command filter for files in a tablespace.",
"body": "pg_data/ was appended at the beginning of the filter, which meant that files in tablespaces could never be queried directly.\n\nUpdate the filter to require the full path, including pg_data/ or pg_tblspc/."
},
{
"commit": "ed88f0483e8c87fde6dc098102b1c49e281d96e1",
"date": "2023-09-16 09:35:27 -0400",
"subject": "Add missing comma in protocolParallelJobToLog()."
},
{
"commit": "ce9ba0fadee652d409488bee701ea6a51cafec75",
"date": "2023-09-15 20:22:38 -0400",
"subject": "Add known hosts checking for SFTP storage driver.",
"body": "By default require a known hosts match as part of the SFTP storage driver's authentication process, i.e. repo-sftp-host-key-check-type=strict. The match is expected to be found in the default list or in a list of known hosts files provided by the user. An exception is made if a fingerprint has been manually configured with repo-sftp-host-fingerprint or repo-sftp-host-key-check-type=accept-new can be used to automatically add new hosts.\r\n\r\nAlso allow host key verification to be skipped, as before, but require the user to explicitly set this (repo-sftp-host-key-check-type=none) rather than it being the default."
},
{
"commit": "f5c730fd03ff27088bd91c148ed285c63b5e7502",
"date": "2023-09-15 18:15:02 -0400",
"subject": "Add prefix to meson build target to avoid conflicts.",
"body": "Older versions of meson fail when a build target in a subproject has the same name as another subproject.\n\nThis has been fixed in newer versions, but we still need to support older versions and in any case this seems cleaner and the help build target is already prefixed in this fashion."
},
{
"commit": "9039d20b5bd73d3732ed6dac0a2bba4558176d8f",
"date": "2023-09-15 09:30:40 -0400",
"subject": "Add report option to check command.",
"body": "This option is intended to eventually create a comprehensive report about the state of the pgBackRest configuration based on the results of the check command.\r\n\r\nImplement a detailed report of the configuration options in the environment and configuration files. This should be useful information when debugging configuration errors, since invalid options and configurations are automatically noted. While custom config locations will not be found automatically, it will at least be clear that the config is not in a standard location.\r\n\r\nFor now keep this option internal since there is a lot of work to be done, but commit it so that it can be used when needed and tested in various environments.\r\n\r\nNote that for now when --report is specified, the check command is not being run at all. Only the config report is generated. This behavior will be improved in the future."
},
{
"commit": "657c1a3e069910106bc3642153c27b0542c61dc3",
"date": "2023-09-14 18:41:36 -0400",
"subject": "Finalize catalog number for PostgreSQL 16 release."
},
{
"commit": "1b4e0cce5f3ff5ea3ee0b889e6d4ce4de1430b04",
"date": "2023-09-14 08:22:21 -0400",
"subject": "Add --repo-storage-tag option to create object tags.",
"body": "This new option allows tags to be added to objects in S3, GCS, and Azure repositories.\r\n\r\nThis was fairly straightforward for S3 and Azure, but GCS does not allow tags for a simple upload using the JSON interface. If tags are required then the resumable interface must be used even if the file falls below the limit that usually triggers a resumable upload (i.e. size < repo-storage-upload-chunk-size).\r\n\r\nThis option is structured so that tags must be specified per-repo rather than globally for all repos. This seems logical since the tag keys and values may vary by service, e.g. S3 vs GCS.\r\n\r\nThese storage tags are independent of backup annotations since they are likely to be used for different purposes, e.g. billing, while the backup annotations are primarily intended for monitoring."
},
{
"commit": "3b9c31f6e3a0c23674f97b02c42133192fb51724",
"date": "2023-09-13 16:59:52 -0400",
"subject": "Use PROJECT_NAME constant instead of string literal."
},
{
"commit": "39bb8a0d3a96eef63219dff262a9306a4f59dae9",
"date": "2023-09-12 18:09:58 -0400",
"subject": "Support for dual stack connections.",
"body": "The prior code would only connect to the first address provided by getaddrinfo().\r\n\r\nInstead try each address in the list. If all connections fail then wait and try them all again until timeout.\r\n\r\nCurrently a round robin approach is used where each connection attempt must fail before the next connection is attempted. This works fine, for example, when an ipv6 address has no route to the host, but will work less well when a host answers but doesn't respond in a timely fashion.\r\n\r\nWe may consider a Happy Eyeballs approach in the future, but since pgBackRest is primarily a background process, it is not clear that slightly improved response time (in the case of failed connections) is worth the extra complexity."
},
{
"commit": "9d3a605900644059ff0e030d71a818b3965eb031",
"date": "2023-09-10 12:45:58 -0400",
"subject": "Optimize WAL segment check after successful backup.",
"body": "The prior code did one list command against the storage for each WAL segment. This led to a lot of lists and was especially inefficient when the WAL (or the majority of it) was already present.\r\n\r\nOptimize to keep the contents of a WAL directory and use them on a subsequent search. Leave the optimizations for a single WAL segment since other places still use that mode."
},
{
"commit": "edbd520c81f5d437963aaf42d1c79b2c51d01665",
"date": "2023-09-10 10:36:58 -0400",
"subject": "Refactor address list lookup to include all returned addresses.",
"body": "sckHostLookup() only returned the first address record returned from getaddrinfo(). The new AddressInfo object provides a full list of values returned from getaddrinfo(). Freeing the list is also handled by the object so there is no longer a need for FINALLY blocks to ensure the list is freed.\r\n\r\nAdd the selected address to the client/server names for debugging purposes.\r\n\r\nThis code does not attempt to connect to multiple addresses. It just lays the groundwork for a future commit to do so."
},
{
"commit": "f42d927d2dcd58cf5a80d68eaf6888bcf2c67a4b",
"date": "2023-09-10 09:47:49 -0400",
"subject": "Retry reads of pg_control until checksum is valid.",
"body": "On certain file systems (e.g. ext4) pg_control may appear torn if there is a concurrent write while reading the file. To prevent an invalid read, retry until the checksum matches the control data.\r\n\r\nSpecial handling is required for the pg-version-force feature since the offset of the checksum is not known. In this case, scan from the default position to the end of the data looking for a checksum match. This is a bit imprecise, but better than nothing, and the chance of a random collision in the control data seems very remote considering the ratio of data size (< 512 bytes) to checksum size (4 bytes).\r\n\r\nThis was discovered and a possible solution proposed for PostgreSQL in [1]. The proposed solution may work for backup, but pgBackRest needs to be able to read pg_control reliably outside of backup. So no matter what fix is adopted for PostgreSQL, pgBackRest need retries. Further adjustment may be required as the PostgreSQL fix evolves.\r\n\r\n[1] https://www.postgresql.org/message-id/20221123014224.xisi44byq3cf5psi%40awork3.anarazel.de"
},
{
"commit": "c1805134b370f0c5c54c40a2df8978599328784f",
"date": "2023-09-09 12:54:55 -0400",
"subject": "Aggregate error retries in ErrorRetry output.",
"body": "If there are a lot of retries then the output might be very large and even be truncated by the error module. Either way, it is not good information for the user.\n\nWhen a message is repeated, aggregate so that total retries and time range are output for the message. This provides helpful information about what happened without overwhelming the user with data."
},
{
"commit": "5314dbffc761bc7507db02693f2421c1578efe10",
"date": "2023-09-09 11:22:33 -0400",
"subject": "Adjust Wait object to be more accurate when nested.",
"body": "The prior code gave a \"free\" extra iteration at the end of the wait, functionality that was copied directly from the equivalent code in Perl. This works and is mostly negligible except when wait loops are nested, in which case outer loops will always run twice even if an inner loop times out, which has a multiplying effect. For example, three nested wait loops with a timeout of three seconds will result in the inner loop being run four times (for a total of twelve seconds) even if it times out each time.\n\nInstead make waitMore() stop exactly when time is up. This makes more sense because a complete failure and timeout of an inner loop means retrying an outer loop is probably a waste of time since that inner loop will likely continue to fail.\n\nAlso make waitRemaining() recalculate the remaining time rather than depending on the prior result.\n\nSome tests needed to be adjusted to take into account there being one less loop. In general this led to a simplification of the tests.\n\nReinit a begin value in the wait unit tests. This is not related to the current change but it does make the time measurements more accurate and less likely to fail on an edge case, which has been observed from time to time.\n\nThis change appears to have a benefit for test runtime, which seems plausible especially for nested waits, but a larger sample of CI runs are needed to be sure."
},
{
"commit": "d57900839addeac56b89a445352a8efc96a197f0",
"date": "2023-09-04 18:51:44 -0400",
"subject": "Improve backup test harness to handle very large quantities of WAL.",
"body": "The current tests only generate small quantities of WAL per backup but sometimes it is useful to generate large quantities for testing.\n\nFix the issues with generating large quantities of WAL and also improve memory management."
},
{
"commit": "43524a47a4c6a847f76514812f94b87cb7af4c05",
"date": "2023-09-04 13:39:11 -0400",
"subject": "Fix configuration reference example for the tls-server-address option.",
"body": "The prior example (::*) was not valid and would result in the following error:\r\n\r\nERROR: [049]: unable to get address for '::*': [-2] Name or service not known\r\n\r\nCorrect values are either * for IPv4 or :: for IPv6. The IPv4 value is used as the example since only one example is allowed."
},
{
"commit": "c0935b79924686ebf4efef99c7dc69aea9efb28d",
"date": "2023-09-04 12:00:06 -0400",
"subject": "Split release notes into individual files.",
"body": "The release.xml file was getting pretty unwieldy so break release notes into separate files. Also break contributors into a separate file.\n\nIn theory most of release.xml could now be generated automatically but adding a new release does not represent a serious maintenance burden, so for the time being it does not seem worth it."
},
{
"commit": "6cb9c40fb8ea18e6572bf3f6e44bbb1d8f922682",
"date": "2023-09-04 10:39:19 -0400",
"subject": "Improve GCS multi-part performance.",
"body": "The prior code avoided uploading a chunk if it was not clear whether the write was complete or not. This was primarily due to the GCS documentation being very vague on what to do in the case of a zero-size chunk.\r\n\r\nNow chunks are uploaded as they are available. This should improve performance and also reduces the diff against a future commit that absolutely requires zero-size chunks."
},
{
"commit": "fd9c6b0e9ddd38de57475d1325bc53b79833a983",
"date": "2023-09-01 12:03:39 -0400",
"subject": "Add missing const qualifier to errorTypeList."
},
{
"commit": "4f52015b14a1f4e5df9373707179a5447cb5a4a6",
"date": "2023-08-31 20:22:01 -0400",
"subject": "New CI container build for PostgreSQL 16 rc1."
},
{
"commit": "e3fcd8cd9e0be42a32fc4cbd2ae3db2c072eabcd",
"date": "2023-08-31 16:36:52 -0400",
"subject": "Add backup size completed/total to info command JSON output.",
"body": "This allows for backup progress to be monitored by external processes, whereas before backup progress was only available via text output."
},
{
"commit": "fbd992adc7b18db5e70774d675c160c8c8e2f031",
"date": "2023-08-29 13:49:49 -0400",
"subject": "Allow archive-get command to run when stanza is stopped.",
"body": "The restore command can run while the stanza is stopped so it makes sense for the archive-get command to follow the same rule.\n\nThe important thing is to ensure that all commands that write to the repository are stopped when the stanza is stopped."
},
{
"commit": "8424737697edfee7cbea195b3bccb4077e1c2ee5",
"date": "2023-08-29 12:35:29 -0400",
"subject": "Encode key in HTTP query.",
"body": "The key also needs to be encoded (not just the value).\n\nThis is not currently an issue because none of the keys in use require encoding."
},
{
"commit": "d24180e4da49a8e2ef2a10a02e76cd204fe1ae8f",
"date": "2023-08-29 12:28:02 -0400",
"subject": "Fix conflicting group in test containers.",
"body": "The tests expect the group name/id to match between the host system and the container. If there is a conflict rename the group with the required id to the expected name.\n\nThis could have unintended consequences but it seems reasonably safe since we control everything that runs in the container and there should never be any system processes running."
},
{
"commit": "1e6efd73e1fcf7bbe3d3f04d925fefde44847109",
"date": "2023-08-23 12:56:49 -0400",
"subject": "Refactor IoRead handling in backupFile().",
"body": "Store the value of storageReadIo() rather than calling it each time. This is slightly more efficient, but more importantly it will be needed for an upcoming commit."
},
{
"commit": "82c12fed123df057fce109757aa5c72dce605440",
"date": "2023-08-21 13:10:48 -0400",
"subject": "Adjust range check per Coverity complaint.",
"body": "Coverity complained that: Overrunning array \"optionGroupIndexKeep[optionGroupIdx]\" of 512 bytes at byte offset 4294967550 using index \"keyIdx\" (which evaluates to 4294967294).\n\nThis does not seem possible but adjust the code to make Coverity happy, as usual."
},
{
"commit": "eb32d6de5e1575a37efb166abbf7df400d93352e",
"date": "2023-08-08 08:41:34 +0100",
"subject": "Accept leading tilde in paths for SFTP public/private keys.",
"body": "The documentation indicates that leading tilde file paths for public/private keys are valid but the functionality was omitted from the original implementation."
},
{
"commit": "1141dc20708cf0c68296f83e74c872a7db9c2bd9",
"date": "2023-08-07 17:03:09 +0100",
"subject": "Multi-stanza check command.",
"body": "Check command now checks multiple stanzas when the stanza option is omitted.\r\n\r\nThe stanza list is extracted from the current configuration rather than scanning the repository like the info command. Scanning the repository is a problem because configuration for each stanza may not be present in the current configuration. Since this functionality is new for check there is no regression.\r\n\r\nAdd a new section to the user guide to cover multi-stanza configuration and provide additional coverage for this feature.\r\n\r\nAlso fix a small issue in the parser when an indexed option has a dependency on a non-indexed option. There were no examples of this case in the previous configuration."
},
{
"commit": "995a8e96691d23eaf3914a425669f89deb3ce002",
"date": "2023-08-07 13:30:50 +0100",
"subject": "Reload GCS credentials before renewing authentication token.",
"body": "This allows the service key to be updated while a command is running. The new key should be written atomically and ideally the old key should remain valid for some period of time to avoid a race condition if the old token happens to expire at the same time that the new key is being generated."
},
{
"commit": "cbafcfabf2eb593de9ee95483da93f278c9ff1ee",
"date": "2023-08-07 12:38:33 +0100",
"subject": "Remove UNCONSTIFY() from gz compression module.",
"body": "The ZLIB_CONST macro may be used since 1.2.5.2 (17 Dec 2011) to specify that the input buffers are const. This is sufficiently old to cover all non-EOL distributions, i.e. everything we test on.\n\nCompiling on older distributions may generate warnings but will continue to work."
},
{
"commit": "6c75c99d0b3024311ea7b254953f1c6a901bcb70",
"date": "2023-07-31 11:09:17 +0200",
"subject": "Update xxHash to v0.8.2.",
"body": "This release fixes compilation errors on some platforms and contains numerous performance improvements."
},
{
"commit": "f55c8f1b813fadbc7b19a1cc4eb8f90e36b2b18c",
"date": "2023-07-26 10:45:12 +0200",
"subject": "Rename HRN_PG_CONTROL_OVERRIDE_PUT().",
"body": "Rename to HRN_PG_CONTROL_OVERRIDE_VERSION_PUT() since other types of overrides are possible (and coming)."
},
{
"commit": "65fb3b3b2d89e2fc80698e52a8378395b18e6d2a",
"date": "2023-07-24 09:17:46 +0200",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "c585ddaf48b806b5d038f0c90e7848875f7a533e",
"date": "2023-07-24 09:15:38 +0200",
"subject": "Begin v2.48 development."
},
{
"commit": "b5b033cc1ce152d387f20681f023b5e1f7c3ed3b",
"date": "2023-07-24 09:12:30 +0200",
"subject": "v2.47: Performance Improvements and Bug Fixes"
},
{
"commit": "5ed6f8df1487174985c42d6e13c367d70c2d8b8a",
"date": "2023-07-18 07:35:12 +0200",
"subject": "Fix spurious automatic delta backup on backup from standby.",
"body": "When performing backup from standby the file sizes on the standby may not be equal to file sizes on the primary. This is because replication continues during the backup and by the time the file is copied from the standby it may have changed. Since we cap the size of all files copied from the standby this practically applies to truncation and in particular truncation of free space maps (at least, every case we have seen so far is an fsm). Free space maps are especially vulnerable since they are only partially replicated, which amplifies the difference between the primary and standby.\r\n\r\nOn an incremental backup it may look like the size has changed on the primary (because of the final size recorded by the standby in the prior backup) but the timestamp may not have changed on the primary and this will trigger a checksum delta for safety. While this has no impact on backup integrity, checksum delta incrementals can run much longer than regular incrementals and backup schedules may be impacted.\r\n\r\nThe solution is to preserve the original size in the manifest and use it to do the time/size check. In the case of backup from standby the original size will always be the size on the primary, which makes comparisons against subsequent file sizes on the primary consistent. Original size is only stored in the manifest when it differs from final size, so there should not be any noticeable manifest bloat."
},
{
"commit": "4c27d74bbd3a44d8ab1af140277d3cd8302060c2",
"date": "2023-07-17 22:37:02 +0200",
"subject": "Preserve block incremental info in manifest during delta backup.",
"body": "It was possible for block incremental info to be lost if a file had been modified in such a way that block incremental would be disabled if the file were new, e.g. if the file shrank below the block incremental limit or the file timestamp regressed far enough into the past. In those cases the block incremental info would not be copied in manifestBuildIncr().\r\n\r\nInstead always copy the block incremental info in case the file ends up being referenced to a prior backup.\r\n\r\nThe validation tests were not robust enough to catch this issue so they were improved in 1d42aed.\r\n\r\nIn the particular case that exposed this bug, a file had a timestamp that was almost four weeks in the past at full backup time. A few days later a fail over occurred and the next incremental ran on the new primary (old standby) in delta mode. The same file had a timestamp just a few hours older than in the full backup, but now four weeks older than the current backup. Block incremental was disabled for the file on initial manifest build because of its age, which meant the block incremental info was not copied into the new manifest. The delta then determined the file had not changed and referenced it to the full backup. On restore, the file appeared to be a normal file stored in a bundle but could not be decompressed because it was in fact a block incremental."
},
{
"commit": "cdb7e26350822b55c00771d6d575242b1202e741",
"date": "2023-07-14 17:53:58 +0300",
"subject": "Fix block incremental file names in verify command.",
"body": "The verify command was not appending the .pgbi extension instead of the compression extension when verifying block incremental files stored outside a bundle.\r\n\r\nOriginally the idea was that verify would not need any changes (since it just examines repo-size and checksum) but at some point the new extension was added and broke that assumption.\r\n\r\nUse backupFileRepoPathP() to generate the correct filename (Just like backup, restore, etc)."
},
{
"commit": "1d42aed152563fff6ec70c517d86eb39158b3f20",
"date": "2023-07-14 11:18:25 +0300",
"subject": "Improve validation of referenced files in command/backup unit test.",
"body": "Referenced files were not being checked for validity unless they were hard linked to the current backup (which a lot of the tests did). Newer tests with bundling do not have hard links and so missed these checks.\n\nImprove the validation code to check referenced files in the manifest even when they are not hard linked into the current backup.\n\nAdd a delta test for bundling/block incremental that includes a file old enough to get a block size of zero. These are good tests by themselves but they also reduce the churn in an upcoming bug fix."
},
{
"commit": "c9703b35304c66a0bd0ebaaaebb389150ef207d6",
"date": "2023-07-13 13:47:27 +0300",
"subject": "Log when file size changes during backup.",
"body": "It is possible for the size of a file to change during the backup. In most cases we won't notice since files sizes are usually capped but it is possible for some files to grow or shrink between when they are recorded in the manifest and when they are actually copied. The new size is recorded in the manifest but the old size may be useful for debugging.\n\nThe new code has coverage but no test changes because it is covered by the parallel backup testing, which does not have deterministic log output. It doesn't seem worth creating a new test to check the log format as it is not very critical (though the output was manually verified)."
},
{
"commit": "b6b13bd6344a1f3ed7279f5a8da771643c0e948a",
"date": "2023-07-12 13:23:16 +0300",
"subject": "Mention block-level backups in feature list."
},
{
"commit": "c8afbed5308d31302c5853850e4ed56d48b6bb4b",
"date": "2023-07-12 13:09:34 +0300",
"subject": "Increase protocolServerError() logging to debug level.",
"body": "Errors should be rare enough that it makes sense to log them at debug level. Right now if there is an error if won't be logged at debug level, which makes it harder to tell why the main process may have terminated the local/remote process."
},
{
"commit": "06536b5814f2fed3e710d1d7b578aa6be53195cb",
"date": "2023-07-12 10:20:09 +0300",
"subject": "Rename macros in command/verify unit test.",
"body": "These macros were redefined, which worked since they were identical to their prior definitions, but this will not always be true."
},
{
"commit": "aa229a1deef3afeebb66db1443b19e24559adf96",
"date": "2023-07-09 21:56:05 +0300",
"subject": "Modify time_t casts based on complaints from Coverity.",
"body": "Coverity complained about time_t being cast directly to unsigned int, so instead cast the result of the operation.\n\nWe are confident in both cases that the time_t values will not be out of unsigned int range but Coverity has no way to know that.\n\nOne of these is new (introduced by 9efd5cd0) but the other one (from a9867cb0) remained unnoticed for a while, though it has not caused any production impact."
},
{
"commit": "28b6b2d4659d78ce67c1bd3104d96e5705d955c9",
"date": "2023-07-07 10:36:15 +0200",
"subject": "Improve performance of SFTP storage driver.",
"body": "The initial implementation used simple waits when having to loop due to getting a LIBSSH2_ERROR_EAGAIN, but we don't want to just wait some amount of time, we want to wait until we're able to read or write on the fd that we would have blocked on.\r\n\r\nThis change removes all of the wait code from the SFTP driver and changes the loops to call the newly introduced storageSftpWaitFd(), which in turn checks with libssh2 to determine the appropriate direction to wait on (read, write, or both) and then calls fdReady() to perform the wait using the provided timeout.\r\n\r\nThis also removes the need to pass ioSession or timeout down into the SFTP read/write code."
},
{
"commit": "125676ae0e98d3730d2dc0d47e37ca1df145d044",
"date": "2023-07-07 09:56:26 +0200",
"subject": "Cleanup of init/handshake in storageSftpNew().",
"body": "Rename handshakeStatus to rc to be consistent with the rest of the module.\n\nAdd comments and do some reformatting."
},
{
"commit": "9efd5cd0bb40c5dc2fcac2e21c9b62e554b94db6",
"date": "2023-07-06 18:46:31 +0200",
"subject": "Add timezone offset to info command date/time output.",
"body": "This makes it easier to use timestamps from the info command directly in PostgreSQL recovery settings, especially the --target option."
},
{
"commit": "762498f4cd5f1425db4c176fc707926d62cc7c04",
"date": "2023-07-06 11:27:00 +0200",
"subject": "Fix time-based archive expiration when no backups are expired.",
"body": "In the case that no backups were expired but time-based retention was met no archive expiration would occur and the following would be logged:\r\n\r\nINFO: time-based archive retention not met - archive logs will not be expired\r\n\r\nIn most cases this was harmless, but when retention was first met or if retention was increased, it would require one additional backup to expire earlier WAL. After that expiration worked as normal.\r\n\r\nEven once expiration was working normally the message would continue to be output, which was pretty misleading since retention had been met, even though there was nothing to do.\r\n\r\nBring this code in line with count-based retention, i.e. always log what should be expired at detail level (even if nothing will be expired) and then log info about what was expired (even if nothing is expired). For example:\r\n\r\nDETAIL: repo1: 11-1 archive retention on backup 20181119-152138F, start = 000000010000000000000002\r\nINFO: repo1: 11-1 no archive to remove"
},
{
"commit": "e280ed9098a6f5da9bdabb541e9c69d4f24ffcf2",
"date": "2023-07-06 08:58:16 +0200",
"subject": "Make result code handling in storage/sftp more consistent.",
"body": "Initializers are useless since rc is always set later. Make rc checks consistent with the rest of the module."
},
{
"commit": "1fd8845c7ffd76ee335ec7960ccd531eef43bd29",
"date": "2023-06-29 11:08:58 +0200",
"subject": "Remove unresolved todo from 87087fac.",
"body": "Seems easiest just to make the additional config required since it tests that custom ports are being used correctly. The test for synthetic was a noop since SFTP is not used in synthetic tests."
},
{
"commit": "0051d7ca872c84231dd55057586f957aa2bc1fa3",
"date": "2023-06-29 09:42:12 +0200",
"subject": "Update comments for removal of chunking and block numbers.",
"body": "dd4e526 should have updated this comment but failed to do so."
},
{
"commit": "0ac09344dc17fb54e250705ce49399b86329bb3d",
"date": "2023-06-28 18:19:20 +0200",
"subject": "Fix unique label generation for diff/incr backup.",
"body": "If there were at least two full backups and the last one was expired, it was impossible to make either a differential or incremental backup without first making a new full backup. The backupLabelCreate() function identified this situation as clock skew because the new backup label was compared with label of the expired full backup.\r\n\r\nIf the new backup is differential or incremental, then its label is now compared with the labels of differential or incremental backups related to the same full backup.\r\n\r\nAlso convert a hard-coded date length to a macro."
},
{
"commit": "5cbef3ade2ab08d8d2431f40d09683efe55c9586",
"date": "2023-06-25 17:36:57 +0200",
"subject": "Fix missed memory auditing in FUNCTION_LOG_RETURN_VOID().",
"body": "9ca492c missed adding auditing to this macro and as a result a few memory leaks have slipped through. Add auditing to the macro to close this hole.\n\nOf the leaks found the only possibly serious one is in blockIncrProcess(), which would leak a PackRead of about eight bytes with every superblock. Since superblocks max out at a few thousand per file this was probably not too bad.\n\nAlso change the ordering of auditing in FUNCTION_TEST_RETURN_VOID(). Even though the order does not matter, having it different from the other macros is confusing and looks like an error."
},
{
"commit": "ecae001653489ac734c3424ea10393989c218ab5",
"date": "2023-06-24 10:18:29 +0200",
"subject": "Add test for configuration hash type override behavior.",
"body": "This behavior is different than regular options where a repeated value will result in an error. It appears to be a legacy of the original Perl implementation, which used a hash as the underlying data type in the built-in command-line parser, and the C command-line parser was written to match."
},
{
"commit": "434938e32b2f71301196f933c3b9a62ed1183c31",
"date": "2023-06-22 18:23:06 +0200",
"subject": "Update Fedora test image to Fedora 38.",
"body": "This adds testing for the latest tool versions, e.g. gcc."
},
{
"commit": "5531e2662d2abcd52c24f25b4a5836c9e07a8ac9",
"date": "2023-06-18 12:55:29 +0300",
"subject": "Add --tz param missed in C unit test migration.",
"body": "This was missed in the C unit test migration and since then a new test was added that was not setting its timezone correctly.\n\nThis feature exists to make sure the tests will run on systems with different timezones and has no impact on the core code."
},
{
"commit": "a36f480c85c7add6fdf0e5517748d740e3a7b424",
"date": "2023-06-14 14:39:40 +0200",
"subject": "Clarify preference to install from packages in the user guide."
},
{
"commit": "9b1bc7d11bdea9cdb1bbf1210d66d53c15d72a46",
"date": "2023-06-14 12:28:00 +0200",
"subject": "Use new LibXML error handler.",
"body": "The old error handler has been deprecated."
},
{
"commit": "4adf6eed09da3f0819abef813c5a44deb9c91487",
"date": "2023-06-12 23:10:14 +0200",
"subject": "Clarify comments for the handling of pg_control during restore."
},
{
"commit": "396e237d53a94b04878bfea23b4de2400256de82",
"date": "2023-06-12 15:41:39 +0200",
"subject": "Update NEWS.md for new version and features."
},
{
"commit": "6875358d11828cbbaffb51f2297a866af32ee8a4",
"date": "2023-06-12 11:26:03 +0200",
"subject": "Fix typo in \"Upgrading PostgreSQL\" section of user guide."
},
{
"commit": "818ef4b71d3ec77c0003ea8ca83981977b4447ac",
"date": "2023-06-08 16:36:25 +0300",
"subject": "Improve comments in protocol/command module."
},
{
"commit": "0bf1b4a3b8cc6caf12a4174cd52a1782cda4dc31",
"date": "2023-05-26 19:50:08 +0300",
"subject": "Move delete stanza section in user guide.",
"body": "Deleting a stanza after all the storage driver stanzas were created was causing problems because the SFTP driver is slow and the GCS driver has no server (so it threw errors). This delayed the shutdown of PostgreSQL, which for some reason caused systemctl to hang when the documentation was being built on a RHEL host.\n\nMove the section up and add a comment about why the location is required. Also add a comment to the GCS section about its location.\n\nThis does not address the issue of systemctl hanging on RHEL container hosts but it will hopefully make it less common."
},
{
"commit": "5d671c63d898e9bf1c08c8ed9e830070361c861e",
"date": "2023-05-25 20:08:12 +0300",
"subject": "New CI container build for PostgreSQL 16 beta1."
},
{
"commit": "9cceed6ac4a32c14a797eba89a4ad1dc06d89d80",
"date": "2023-05-24 16:34:21 +0300",
"subject": "Skip recovery.signal for PostgreSQL >= 12 when recovery type=none.",
"body": "Bring PostgreSQL >= 12 behavior in line with other versions when recovery type=none.\r\n\r\nWe are fairly sure this did not work correctly when PostgreSQL 12 was released, but apparently the issue has been fixed since then. Either way, after testing we have determined that the behavior is now as expected."
},
{
"commit": "36ff81dc6ff7e98e40c0c05a4a343a71b91b1678",
"date": "2023-05-24 14:17:07 +0300",
"subject": "Centralize error handling for unsupported features.",
"body": "Some features are conditionally compiled into pgBackRest (e.g. lz4). Previously checking to see if the feature existed was the responsibility of the feature's module.\r\n\r\nCentralize this logic in the config/parse module to make the errors more detailed and consistent.\r\n\r\nThis also fixes the assert that is thrown when SFTP storage is specified but SFTP support is not compiled into pgBackRest."
},
{
"commit": "de46276bf60b8a2181621b123d1a99e56808a089",
"date": "2023-05-24 09:56:32 +0300",
"subject": "Refactor allow list processing in config/parse module.",
"body": "Combine StringId and int checking into a single loop. This seems more compact and makes it easier to add code that affects both types (and possibly more types in the future)."
},
{
"commit": "48b26bf569664da59bff08eb3ef959f0cd440e29",
"date": "2023-05-23 12:50:12 +0300",
"subject": "Fix sftp-all=y in the user guide so it creates a valid configuration.",
"body": "This was not tested in 87087fac and the generated config was only valid for pushing from the primary. Also do some general cleanup.\n\nUpdate the SFTP server user to be \"pgbackrest\" instead of \"postgres\".\n\nEven though sftp-all=y now creates a valid configuration, the user guide build still fails because SFTP is too slow and operations time out (particularly starting PostgreSQL). This will need to be addressed in a future commit."
},
{
"commit": "c633b187db32d18ccab24e77ab3413335e067775",
"date": "2023-05-23 10:58:51 +0300",
"subject": "Remove user-facing documentation references to --vm=none.",
"body": "This parameter is now optional and defaults to none so there is no reason to explicitly show it in user-facing documentation.\n\nAlso make the vm parameter in ci.pl optional to be consistent with how test.pl behaves."
},
{
"commit": "4ec51cdb2f92e3fd814063a2bb606640965f8c5a",
"date": "2023-05-23 10:40:56 +0300",
"subject": "Explicitly create SSH directory in SFTP setup.",
"body": "RHEL 9 (at least) will warn on stderr that the directory has been created which causes the documentation build to fail."
},
{
"commit": "5bbe98758919a38692cd859809203cb029543c59",
"date": "2023-05-23 10:14:00 +0300",
"subject": "Build u20 image to speed contributing document generation.",
"body": "This image was left out of the last round of builds, which forced the contributing document to build it from scratch."
},
{
"commit": "c2c60350d376379322d6c14c27cbb93bf6e86987",
"date": "2023-05-23 08:25:17 +0300",
"subject": "Add missed --no-log-timestamp in unit tests and improved formatting.",
"body": "The --no-log-timestamp option was missed when unit test building was migrated to C, which caused test timings to show up in the contributing guide. This caused no harm but did create churn in this file during releases.\n\nAlso improve the formatting when test timing is disabled."
},
{
"commit": "9dbf76d8e87287786f03b65c94305b3dc126029b",
"date": "2023-05-22 11:19:00 +0300",
"subject": "Begin v2.47 development."
},
{
"commit": "b461f7c6f884dba8056858464d1b571e708dad77",
"date": "2023-05-22 11:13:13 +0300",
"subject": "v2.46: Block Incremental Backup and SFTP Storage"
},
{
"commit": "a28b72c62431bcf9df02791219d9d6f5d0e60b54",
"date": "2023-05-18 09:32:44 +0300",
"subject": "Add warning about using recovery type=none."
},
{
"commit": "c61115e8adccd17d8afb6bd527fb6a396ec6b72a",
"date": "2023-05-15 17:46:41 +0300",
"subject": "Add bundling and block incremental to stress testing.",
"body": "This makes the stress testing more robust and provides additional testing for important features."
},
{
"commit": "87087fac231d2110160b3219daee3f9fb91aec02",
"date": "2023-05-13 19:16:16 +0300",
"subject": "SFTP support for repository storage."
},
{
"commit": "0c1f823e7a3abf1cadb44de3832ec1ddb2da7ec8",
"date": "2023-05-12 15:46:04 +0300",
"subject": "Add note about running stanza-create on already-created repositories."
},
{
"commit": "c7ac17330405510e56243e967d108b8d3b387ce0",
"date": "2023-05-10 09:22:26 +0300",
"subject": "Increase check timeouts in real/all integration tests.",
"body": "The prior timeouts were a bit aggressive and were causing timeouts in the Azure tests. There have also been occasional timeouts in other storage drivers.\n\nThe performance of CI environments is pretty variable so increased timeouts should make the tests more stable."
},
{
"commit": "2fc641383709ce1f91f35bb1edf4e7c1ab0f4eb3",
"date": "2023-05-06 12:16:58 +0300",
"subject": "Fix typos in test titles."
},
{
"commit": "6f250bf6860054397181f5678220faaa6574993e",
"date": "2023-05-06 12:15:21 +0300",
"subject": "Fix groupId type in StorageInfo.",
"body": "gid_t is the correct type but there was no bug because uid_t and gid_t have the same underlying type."
},
{
"commit": "ad9196cb49ce86cef678e453046803fb2be2cf70",
"date": "2023-05-05 10:08:49 +0300",
"subject": "Update Debian user guide to build on Ubuntu 20.04.",
"body": "Ubuntu 18.04 will be EOL at the end of the month so update to a newer version."
},
{
"commit": "023d3c99d8d00497501b21fb20b07f71ea49ee40",
"date": "2023-05-04 08:52:31 +0300",
"subject": "Fix incorrect commit hash in 2f322e2a."
},
{
"commit": "2f322e2a49f20ff3036db6382363efb40246922e",
"date": "2023-05-03 09:49:24 +0300",
"subject": "Add efac3474 (remove double spacing) to .git-blame-ignore-revs."
},
{
"commit": "d49907239eb37c3e4e905f97543824181a1bd406",
"date": "2023-05-03 09:37:59 +0300",
"subject": "Remove double spaces missed in 1bd5530a."
},
{
"commit": "efac3474cffc4f01154c13cc358601c4c98bcd42",
"date": "2023-05-02 12:59:20 +0300",
"subject": "Add 1bd5530a (remove double spacing) to .git-blame-ignore-revs."
},
{
"commit": "1bd5530a59cd8ddbabc279802d1ede4f8fbd5314",
"date": "2023-05-02 12:57:12 +0300",
"subject": "Remove double spaces from comments and documentation.",
"body": "Double spaces have fallen out of favor in recent years because they no longer contribute to readability.\n\nWe have been using single spaces and editing related paragraphs for some time, but now it seems best to update the remaining instances to avoid churn in unrelated commits and to make it clearer what spacing contributors should use."
},
{
"commit": "5ea7b91bf9ab57a29778d2332c0971e84f14c4c6",
"date": "2023-05-02 12:07:28 +0300",
"subject": "Remove extraneous space from error messages."
},
{
"commit": "9637d9449091632f158f8e2be8afbad4bda200fc",
"date": "2023-05-02 09:37:42 +0300",
"subject": "Use boolean variant constants where possible instead of redeclaring."
},
{
"commit": "822f2a584260a012b833455a7a2bd1c8487e3010",
"date": "2023-05-01 19:26:48 +0300",
"subject": "Finalize block incremental feature.",
"body": "Remove beta status and update documentation to remove beta references and warnings.\r\n\r\nThe repo-block-* sub-options have been marked internal. Most users will be best off with the default behavior and we may still decide to change these options for remove them in the future."
},
{
"commit": "c510046dd77c40487d2d6c659834927a3bab1106",
"date": "2023-05-01 14:27:56 +0300",
"subject": "Remove extraneous spaces in user guide."
},
{
"commit": "dd4e52679ecdc43539bd038b5aa9bd4ff9055cbf",
"date": "2023-04-27 23:29:12 +0300",
"subject": "Removing chunking and block numbers from incremental block list.",
"body": "These were intended to allow the block list to be scanned without reading the map but were never utilized. They were left in \"just in case\" and because they did not seem to be doing any harm.\r\n\r\nIn fact, it is better not to have the block numbers because this allows us set the block size at a future time as long as it is a factor of the super block size. One way this could be useful is to store older files without super blocks or a map in the full backup and then build a map for them if the file gets modified in a diff/incr backup. This would require reading the file from the full backup to build the map but it would be more space efficient and we could make more intelligent decisions about block size. It would also be possible to change the block size even if one had already been selected in a prior backup.\r\n\r\nOmitting the block numbers makes the chunking unnecessary since there is now no way to make sense of the block list without the map. Also, we might want to build maps for unchunked block lists, i.e. files that were copied normally."
},
{
"commit": "3fc3690dd77ef5fa032abb006558184164db53ec",
"date": "2023-04-27 10:30:50 +0300",
"subject": "PostgreSQL 16 support.",
"body": "Add catalog version and WAL magic for PostgreSQL 16.\r\n\r\nThe GUC to force parallel mode has be renamed so update that in the tests."
},
{
"commit": "39059dc4e7a74e6473099eefeed4e9e0efe65e60",
"date": "2023-04-26 15:00:36 +0300",
"subject": "Remove extra linefeed."
},
{
"commit": "3ff88ffbb495fd669e9a361478e60192930ee0a1",
"date": "2023-04-25 11:52:28 +0300",
"subject": "Avoid chown() on recovery files during restore.",
"body": "The chown() was already skipped on the files restored from the repository but the same logic was not applied to the generated recovery files, probably because chown'ing a few recovery files does not have performance implications. Use the same logic for recovery files to determined if they need to be chown'd.\r\n\r\nUltimately this behavior is pretty hard to test, so add a fail safe into the Posix driver that will skip chown if the permissions are already as required."
},
{
"commit": "750ab8e55c276fa0127d19961a59fec254e24c61",
"date": "2023-04-21 16:21:10 +0300",
"subject": "Add MacOS back to CirrusCI.",
"body": "9e29c01 removed MacOS testing due to breaking changes in the update to arm on the platform.\n\nUpdate the scripts to correctly work with the version of Homebrew deployed with the arm images."
},
{
"commit": "23d7d67d4961c9bb38d73ef1c409369303276846",
"date": "2023-04-21 15:08:59 +0300",
"subject": "Fix missing void parameter."
},
{
"commit": "f5e6bc26983396ec51c6579aade37db39807f3a5",
"date": "2023-04-20 13:24:12 +0300",
"subject": "Allow page header checks to be skipped.",
"body": "These checks cause false negatives for page checksum verification when the page is encrypted because pd_upper might end up as 0 in the encrypted data. This issue is rare but reproducible given a large enough cluster.\r\n\r\nMake these checks optional, but leave them enabled by default."
},
{
"commit": "8240eb5da57d2950ebbd3492c163b4e0151d3cb7",
"date": "2023-04-16 17:41:27 +0300",
"subject": "Autogenerate PostgreSQL versions.",
"body": "This will make adding/removing versions of PostgreSQL more reliable."
},
{
"commit": "a05bf6bb15ba7f7e4b610dbb84e87ebcd359dd38",
"date": "2023-04-16 17:32:24 +0300",
"subject": "Rename PG_VERSION_*_STR constants to PG_VERSION_*_Z.",
"body": "This is more consistent with other zero-terminated string constants and also has the benefit of being shorter."
},
{
"commit": "75254c9285e70913920af9ab6e9f362bc4d11d7d",
"date": "2023-04-11 16:28:29 +0400",
"subject": "Parameterize configLoad() as cfgLoadP().",
"body": "There is one existing optional parameter and there are more to come."
},
{
"commit": "d6cb3de17afff0a9c57f312455a5ca3cf202cba6",
"date": "2023-04-11 14:50:59 +0400",
"subject": "Update command/check module to recent coding standards.",
"body": "Add const as appropriate and remove an unneeded declaration."
},
{
"commit": "a9c5cd9749f6b5ae1005453b1039d91f37fb245b",
"date": "2023-04-11 12:46:00 +0400",
"subject": "Update command/backup module to recent coding standards.",
"body": "Add const as appropriate and avoid setting results to NULL if the result will definitely be set later on."
},
{
"commit": "f33e1cfb1600643820a1ae76bdeb15c62ac1fcc7",
"date": "2023-04-06 11:38:18 +0400",
"subject": "Add error retry detail for HTTP retries.",
"body": "This should make it clearer when retries have happened and for how long."
},
{
"commit": "df419b34b55a15a902ff5cc1912aaebc7e023738",
"date": "2023-04-06 11:03:46 +0400",
"subject": "Improve retry error messages.",
"body": "Centralize the code to allow it to be used in more places and update the protocol/server module to use the new code.\n\nSince the time measurements make testing difficult, also add time and errorRetry harnesses to allow specific data to be used for testing. In the case of errorRetry, the production behavior is turned off by default during testing and only enabled for the errorRetry test module."
},
{
"commit": "801e396dace2a4d9f4125ef0e751c90dc0cc644a",
"date": "2023-04-06 10:38:49 +0400",
"subject": "Move error modules to common/error directory.",
"body": "There are already enough files to warrant a separate directory and more are coming.\n\nAlso remove extraneous includes."
},
{
"commit": "ff98636e41b8ad14babe1e9fa1fdc15aad2244cd",
"date": "2023-04-06 08:22:14 +0400",
"subject": "Update 32-bit CI host to Debian 10 from Ubuntu 18.04.",
"body": "Ubuntu 18.04 will be EOL before the next release, so update to the oldest available Debian version.\n\nAlso fix one incorrect return value type, a test cast, and adjust some test timeouts."
},
{
"commit": "a9f39857cf7d8c0eda9f5f19f3d4c9497d4d47f2",
"date": "2023-04-05 11:24:53 +0400",
"subject": "Remove unused strOS parameter in Common::HostTest."
},
{
"commit": "8f7f73e4af916bf1bc6a0cb72be35b7061b297df",
"date": "2023-03-30 17:46:25 +0500",
"subject": "Sleep using nanosleep() instead of select().",
"body": "This is a safer way to sleep due to select's not-portable interaction with signals.\n\nBased on https://git.postgresql.org/gitweb/?p=postgresql.git;a=commitdiff;h=a948e49e2ef11815be0b211723bfc5b53b7f75a8 from the PostgreSQL project."
},
{
"commit": "2cfbee903a0a16d1fdeca52dbf6e775cdcddcc74",
"date": "2023-03-30 15:43:37 +0500",
"subject": "Use Buffer object for page buffer in PageChecksum filter.",
"body": "This avoids the object needing to support allocations."
},
{
"commit": "3dbf518c3a9df538ca110039758fbfe161e3f714",
"date": "2023-03-30 14:50:46 +0500",
"subject": "Convert XmlNode from allocation to object.",
"body": "This makes memory accounting more accurate and objects that use Xml no longer need to allow allocations."
},
{
"commit": "047472144b5fd92425225700aa11b351044244e5",
"date": "2023-03-30 14:42:20 +0500",
"subject": "Remove allocations from common crypto module.",
"body": "The allocations are better done with a struct and Buffer object."
},
{
"commit": "84ca7b9b2713b6d36d15d592e78942d8e1ac8a35",
"date": "2023-03-30 11:42:22 +0500",
"subject": "Cleanup for objects that do not require allocations.",
"body": "A lot of these are left over from when object interfaces required allocations (changed in f6e30736 and 9ca9c8e4). Others are likely copy/paste errors.\n\nThis saves some space in the mem context and makes it clear that no allocations will be made."
},
{
"commit": "fe0fd71be2e9754491cbbdcde79e7a7cc87f2e7b",
"date": "2023-03-30 10:00:58 +0500",
"subject": "Convert the result of zNewFmt() into an object.",
"body": "The result is not intended to be freed directly so this makes memory tracking more accurate. Fix a few places where memory was leaking after a call to zNewFmt().\n\nAlso update an assert to make it clearer."
},
{
"commit": "295b53e8453b4ac4889b62bc1c7f1d6b78b09421",
"date": "2023-03-28 16:24:43 +0600",
"subject": "Update Github actions to new versions.",
"body": "These updates remove various deprecation warnings."
},
{
"commit": "b111599badccb1c196a224e3d6ac8657b8d172a2",
"date": "2023-03-28 15:05:18 +0600",
"subject": "Simplify object creation with OBJ_NEW_BEGIN() macro.",
"body": "Eliminate the boilerplate of declaring this and assigning memory to it, which is the same for the vast majority of object creations.\n\nKeep the old version of the macro as OBJ_NEW_BASE_BEGIN() for a few exceptions in the core code and (mostly) in the tests."
},
{
"commit": "91f9301b9d0026ee72875d943e0ed01b14ec887b",
"date": "2023-03-27 16:42:35 +0600",
"subject": "Fix command/manifest unit test title."
},
{
"commit": "9ca9c8e4c97b60a4cceef1c6f9fcb93e413e15d7",
"date": "2023-03-27 14:32:37 +0600",
"subject": "Improve interface handling in remaining modules.",
"body": "As in f6e30736, make the interface object the parent of the driver object rather than the interface being allocated directly in the driver object. Allow exceptions to this general rule for objects that need to retain ownership of their interfaces."
},
{
"commit": "5f001248cce08137a601ce5671aa67d26bfdd366",
"date": "2023-03-25 14:59:47 +0700",
"subject": "Fix indentation in config.yaml."
},
{
"commit": "8ff956ad7e8608dd7582825521105c289b249810",
"date": "2023-03-25 14:07:31 +0700",
"subject": "Add lock module initialization.",
"body": "Each call to lockAcquireP() passed enough information to initialize the lock system. This was somewhat inefficient and as locks become more complicated it will lead to more code duplication. Since a process can only take one type of lock it makes sense to do most of the initialization up front.\n\nAlso reduce the log level of lockRelease() since it is only called at exit and the lock will be released in any case."
},
{
"commit": "f1caecc4ff38557cf81314738ac83d420d8bcf23",
"date": "2023-03-24 10:34:42 +0800",
"subject": "Convert lockAcquire() to lockAcquireP().",
"body": "This makes a few current parameters optional and allows for more optional parameters with less code churn."
},
{
"commit": "c8ec114c8cb392d227fa267c62d11cc6b4fb9677",
"date": "2023-03-21 12:29:45 +0800",
"subject": "Add reference filter and output to manifest command.",
"body": "This allows the file list to be filtered by reference. The reference is output when it is not the default reference for the backup."
},
{
"commit": "1807bfcff5550bb40fa4f92dee1e15580a0b752d",
"date": "2023-03-21 12:22:47 +0800",
"subject": "Clear buffer limit when buffer is limited to allocated size.",
"body": "This minor optimization automatically clears the limit flag when limit is set to allocated size. This has no impact on the current code but will simplify a future commit where a conditional bufLimitClear() is being used."
},
{
"commit": "5b5786c082b698e637bd44b9f06fbca5e4e4cc21",
"date": "2023-03-20 10:25:44 +0800",
"subject": "Begin v2.46 development."
},
{
"commit": "6ad79d16ca638b7ccdc81b5530a39007b8e01aed",
"date": "2023-03-20 09:37:23 +0800",
"subject": "v2.45: Block Incremental Backup (BETA)"
},
{
"commit": "04d224b88e73194ff1c6497dbecaaff392008dfe",
"date": "2023-03-18 20:47:03 +0800",
"subject": "Add beta feature and documentation for block incremental backup."
},
{
"commit": "78c036efb7ebf7060949f3d2f2e6d93986734414",
"date": "2023-03-16 17:46:32 +0700",
"subject": "Updates required for new manifest command to work remotely.",
"body": "Additional options are required and the BlockChecksum must work remotely."
},
{
"commit": "505a639f1e627b506c2e5a3351e8d4aacae9ed0b",
"date": "2023-03-14 21:56:05 +0700",
"subject": "Prototype manifest command.",
"body": "Output a manifest in text or JSON format. Neither format is complete but they cover the basics.\n\nIn particular the manifest command outputs the complete block restore when the filter option is specified and the block delta when the pg option is also specified. This is non-destructive so it is safe to execute against a running cluster."
},
{
"commit": "c30d3e439b77d544477e289606d30d0c8ffe301f",
"date": "2023-03-14 17:48:25 +0700",
"subject": "Block incremental map fixes and improvements.",
"body": "Bug Fixes:\r\n\r\n* Remove the distinction between maps where super block size is equal to block size and maps where they are not. In practice, maps with equal blocks are now rare and most of the optimizations can be applied directly to super blocks where the blocks are equal. This fixes a bug where a map that was created with equal size blocks and then converted to differing block sizes would generate an invalid map.\r\n\r\n* Free reads during restore to avoid running out of file handles.\r\n\r\nImprovements:\r\n\r\n* Store super block sizes in the block map. This allows the final block size to be removed from the block list and provides a more optimal restore and better potential for analysis.\r\n\r\n* Always round the super block size up to the next block size. This makes the number of blocks per super block more predictable.\r\n\r\n* Allow super block sizes to be changed at will in the map. The first case for this is to store the reduced super block size required when the last super block is short but it could be used to dynamically change the super block size to optimize compression.\r\n\r\n* Store a block count rather than a list of blocks in a super block. Blocks must always be sequential, though there may be an offset to the first block in a super block. This saves 11-14% on space for checksum sizes 6-7.\r\n\r\n* In the case that all the blocks for a super block are present, and there is no offset, the block size is omitted."
},
{
"commit": "5c1f78d4dd62c37218285d13b09a9450eb3a588e",
"date": "2023-03-12 22:38:38 +0700",
"subject": "Fix typo in blockIncrProcess()."
},
{
"commit": "1281a6eaf8552232c8c9af4d7fc15c082a7794d9",
"date": "2023-03-12 16:21:43 +0700",
"subject": "Ensure no continuations when block size equals super block size.",
"body": "In this case each super block contains a single block so continuations are not possible."
},
{
"commit": "d7704a8bc837b0be5564737e491bf5f73796ca0a",
"date": "2023-03-11 14:04:43 +0700",
"subject": "Move backup pq test script generation to backup harness.",
"body": "This allows scripted online backups to be used by other test modules."
},
{
"commit": "2fffd64213b7d51b6444f61502f4225584667731",
"date": "2023-03-10 16:11:30 +0700",
"subject": "Fix error handling in build-code binary.",
"body": "120a49b6 improved the error handling but due to a copy/pasto errors were being handled as asserts, which tripped an assertion in the log module."
},
{
"commit": "19f3a1d3040df56e73f19674618eb5f447dabe8d",
"date": "2023-03-10 16:08:30 +0700",
"subject": "Add missing header."
},
{
"commit": "24f725212d0c1dedc0f34fe4e939e481585ff697",
"date": "2023-03-10 15:30:27 +0700",
"subject": "Add beta feature infrastructure.",
"body": "This allows options to be marked as beta, which will require that the --beta option be supplied to prevent accidental usage of a beta feature.\n\nThe online and command-line documentation also show warnings when options are beta."
},
{
"commit": "6b409d049eb935146f7996b75b97744b75c411a9",
"date": "2023-03-10 14:01:38 +0700",
"subject": "Update default block size and super block values based on testing.",
"body": "Block sizes are incremented when the size of the map becomes as large as a single block. This is arbitrary but it appears to give a good balance of block size vs map size.\n\nThe full backup super block size is set to minimize loss of compression efficiency since most blocks in the database will likely never be modified. For diff/incr backup super blocks, a smaller size is allowable since only modified blocks are stored. The overall savings of not storing unmodified blocks offsets the small loss in compression efficiency due to the smaller super block and allows more granular fetches during restore."
},
{
"commit": "1119a5353911d6d326edac325f530bb796a806ae",
"date": "2023-03-09 11:04:03 +0700",
"subject": "Rename BlockHash to BlockChecksum.",
"body": "Checksum is the generally used terminology in the code base, even when a hash is being used as a checksum."
},
{
"commit": "6252c0e4485caee362edec13302a5f735a69bff4",
"date": "2023-03-09 10:30:57 +0700",
"subject": "Exclude backup set size from info for block incremental backups.",
"body": "As calculated this size is not correct since it does not include the parts of prior block incrementals that are required to make the current block incremental valid. At best this could be approximated and the resulting values might be very confusing.\n\nFor now, at least, exclude this metric for block incremental backups."
},
{
"commit": "210bed4511ae5523b170eb193b877346d787140d",
"date": "2023-03-09 10:02:04 +0700",
"subject": "Use xxHash instead of SHA-1 for block incremental checksums.",
"body": "xxHash is significantly faster than SHA-1 so this helps reduce the overhead of the feature.\n\nA variable number of bytes are used from the xxHash depending on the block size with a minimum of six bytes for the smallest block size. This keeps the maps smaller while still providing enough bits to detect block changes."
},
{
"commit": "8b5153ad210011812c8fe6db2f2ed829a5aa543a",
"date": "2023-03-09 09:39:54 +0700",
"subject": "Block-level incremental backup super blocks.",
"body": "Small blocks sizes can lead to reduced compression efficiency, so allow multiple blocks to be compressed together in a super block. The disadvantage is that the super block must be read sequentially to retrieve blocks. However, different super block sizes can be used for different backup types, so the full backup super block sizes are large for compression efficiency and diff/incr are smaller for retrieval efficiency."
},
{
"commit": "740c2258e36613b1b4e76bab452d0e610a399e7f",
"date": "2023-03-09 08:23:15 +0700",
"subject": "Add pg-version-force option for fork integration.",
"body": "Forks may update pg_control version or WAL magic without affecting the structures that pgBackRest depends on.\r\n\r\nThis option forces pgBackRest to treat a cluster as the specified version when it cannot be automatically identified."
},
{
"commit": "2fa7e53c5d4b5a5fd79f62d39763746727a5b9be",
"date": "2023-03-08 19:05:23 +0700",
"subject": "Skip writing recovery.signal by default for restores of offline backups.",
"body": "When restoring an offline backup on PostgreSQL >= 12, skip writing recovery.signal by default since this will error if the backup was made with wal_level=minimal. If the user explicitly sets the type option to something other than none, then write recovery.signal as usual since it is possible to do Point-In-Time-Recovery from an offline backup as long as wal_level was not minimal."
},
{
"commit": "7e5adc03594a3b7a975001e80902a51df3ddd577",
"date": "2023-03-07 18:46:24 +0700",
"subject": "Use raw compression/encryption to bundling and block incremental backup.",
"body": "Raw encryption was already being used for block incremental. This commit adds raw compression to block incremental where possible (see da918587).\n\nRaw compression/encryption is also added to bundling for a backup set when block incremental is enabled on the full backup. This prevents a break in backward compatibility since block incremental is not backward compatible."
},
{
"commit": "da9185870222057b97365f5db0acf797f959ec5e",
"date": "2023-03-07 18:31:17 +0700",
"subject": "Add optional raw format for compression types.",
"body": "Raw format saves 12 bytes of header for gzip and 4 bytes of checksum for lz4 (plus CPU overhead). This may not seem like much, but over millions of small files or incremental blocks can really add up. Even though it may be a relatively small percentage of the overall backup size it is still objectively a large amount of data.\n\nUse raw format for protocol compression to exercise the feature.\n\nRaw compression format will be added to bundling and block incremental in a followup commit."
},
{
"commit": "f6e307365f5a55a8bb4eb694e0a11fb4f32fb6e7",
"date": "2023-03-07 11:27:41 +0700",
"subject": "Improve interface handling in storage module.",
"body": "Make the interface object the parent of the driver object rather than the interface being allocated directly in the driver object.\n\nThe prior method was more efficient when mem contexts had a much higher cost. Now mem contexts are cheap so it makes more sense to structure the objects in a way that works better with mem context auditing. This also means the mem context does not need to be stored separately since it can be extracted directly from the interface object.\n\nThere are other areas that need to get the same improvement before the specialized objMoveContext() and objFreeContext() functions can be removed."
},
{
"commit": "120a49b6590a549a72bfe0a6a5a22905e835b2ce",
"date": "2023-03-06 21:07:08 +0700",
"subject": "Improved error handling in build-code binary.",
"body": "Show a full stack trace instead of just the error."
},
{
"commit": "0818601c055724bde3b97d4b02d3a38b0a53899a",
"date": "2023-03-06 09:49:33 +0700",
"subject": "Set online flag in manifest in command/restore unit tests.",
"body": "This flag does not currently affect restore behavior but it will in an upcoming commit. Set the flag here to simplify the test diff in the upcoming commit."
},
{
"commit": "c656669ac2354dab504d94b604e305c3b68bb493",
"date": "2023-03-04 12:50:02 +0700",
"subject": "Allow control version and WAL magic to be overridden in test harness.",
"body": "This makes it easier to write tests for invalid control version/WAL magic.\n\nAlso add HRN_PG_WAL_TO_BUFFER() to simplify generation of WAL headers."
},
{
"commit": "1648c133d6bc1ffd0682ae6219934d00295aa580",
"date": "2023-03-04 12:45:08 +0700",
"subject": "Keep only one all-default group index.",
"body": "It is possible for a group index to be created for an option that is later found to not meet dependencies. In this case all values would be default leading to a phantom group, which can be quite confusing.\r\n\r\nRemove group indexes that are all default (except the final one) and make sure the key for the final all default group index is 1."
},
{
"commit": "439447977681ea8730935535e25a657334596942",
"date": "2023-02-28 08:47:51 +0700",
"subject": "Fix typo and remove extraneous linefeed."
},
{
"commit": "16ac5ee8d3b926464cd27e8f064579f1e7935f4c",
"date": "2023-02-26 16:13:44 +0700",
"subject": "Rename block incremental manifest keys.",
"body": "Since the keys need to be read/written in order, these keys make the logic a bit simpler."
},
{
"commit": "a9867cb0b8e8d7abcac9b18b76e3e490c265f3cb",
"date": "2023-02-26 14:49:34 +0700",
"subject": "Add repo-block-age-map and repo-block-size-map options.",
"body": "Make these options configurable. This is primarily for testing purposes so the new options will be kept internal."
},
{
"commit": "15d5dcdd3bb387aab28bbe7262011c38c7d6d22c",
"date": "2023-02-26 14:41:32 +0700",
"subject": "Add explicit instructions for upgrading between 2.x versions.",
"body": "Add an explicit statement that there is nothing special to do when upgrading between 2.x versions.\r\n\r\nLeave the previous paragraph about the default location that changed between 2.00 and 2.02, as it is more a matter of transitioning from 1.x to 2.x."
},
{
"commit": "dffc933384e4327e2fd52868dd19668ed9d3ed91",
"date": "2023-02-13 09:17:30 +0700",
"subject": "Rename DeltaMap to BlockHash.",
"body": "This more accurately describes what the object does."
},
{
"commit": "779efe0d7a54340141e01597279e9ab1d0bd0773",
"date": "2023-02-09 13:01:56 +0700",
"subject": "Consistently declare block incremental size as size_t.",
"body": "The block is often allocated in memory so size_t makes more sense than uint64_t."
},
{
"commit": "d520816acf9ecb01ef805cecbc9de7e8d0a9f468",
"date": "2023-02-09 08:11:05 +0700",
"subject": "Remove parameter list from deltaMapNew().",
"body": "Since this filter cannot be used remotely (yet) there is no reason to create a parameter list."
},
{
"commit": "3feed389a2199454db68e446851323498b45db20",
"date": "2023-02-08 22:34:23 +0700",
"subject": "Improve IoChunkedRead end-of-file handling.",
"body": "Determine end-of-file earlier to improve throughput.\n\nAlso clean up some comments and formatting."
},
{
"commit": "089fae035bf0a9778fff0527ea3cbb113625a403",
"date": "2023-02-07 14:09:50 +0700",
"subject": "Add block incremental to real/all test output."
},
{
"commit": "31cad5e09e1910fc9d36d18306524aabca3ff36b",
"date": "2023-02-01 12:57:04 +0700",
"subject": "Check for stray execute permissions in test.pl --code-format.",
"body": "Sometimes these can get set while updating permissions from with a VM or container.\n\nAlso fix a few permissions that were not correct."
},
{
"commit": "8e7e9d36a133f2ec01f4864b5b0c80344888b737",
"date": "2023-01-31 21:28:28 +0700",
"subject": "Fix contributors in release notes."
},
{
"commit": "c5907a2e7193ca8f79cf56dca23e0df118e686c3",
"date": "2023-01-31 08:28:32 +0700",
"subject": "Remove references to SSH made obsolete when TLS was introduced.",
"body": "Also remove details about SSH compression that are not helpful."
},
{
"commit": "9ae6b6ef0f344b49f6153bf842ac815b0fcb9ea3",
"date": "2023-01-31 08:04:09 +0700",
"subject": "Update comments missed in copy/paste."
},
{
"commit": "ce0ea2cfab17e6770de3897133183af891df943c",
"date": "2023-01-30 12:22:41 +0700",
"subject": "Use uncrustify for code formatting.",
"body": "The code is not completely reflowed yet so there are some cases that uncrustify will not catch. The formatting will be improved over time.\n\nSome block of code require special formatting so have been surrounded with the {uncrustify-off}/{uncrustify-on} markers. These exceptions should be kept to a minimum.\n\nAdd --code-format (to reformat code) and --code-format-check (to check formatting) to test.pl.\n\nAdd a CI test that will check code formatting. Code must be correctly formatted before it can be merge to integration.\n\nAdd documentation to the coding standards for code formatting."
},
{
"commit": "d4070c90641a61fa3cb1169f3bd53067193bab4e",
"date": "2023-01-30 11:55:54 +0700",
"subject": "Reformat code with uncrustify.",
"body": "uncrustify has been configured to be as close to the current format as possible but the following changes were required:\n\n* Break long struct initializiers out of function calls.\n* Bit fields get extra spacing.\n* Strings that continue from the previous line no longer indented.\n* Ternary operators that do not fit on a single line moved to the next line first.\n* Align under parens for multi-line if statements.\n* Macros in header #if blocks are no longer indented.\n* Purposeful lack of function indentation in tests has been removed.\n\nCurrently uncrustify does not completely reflow the code so there are some edge cases that might not be caught. However, this still represents a huge improvement and the formatting can be refined going forward.\n\nSupport code for uncrustify will be in a followup commit."
},
{
"commit": "b2202c36d9e7c4557ac37087757df80193d516b5",
"date": "2023-01-30 11:16:31 +0700",
"subject": "Fix formatting errors.",
"body": "Errors in our current (manually-maintained) code format discovered by uncrustify."
},
{
"commit": "a96837d2eda4b7497e74954b24d9323f33465c50",
"date": "2023-01-30 10:55:14 +0700",
"subject": "Refactor loop limit in removeExpiredArchive().",
"body": "This simplifies the formatting, which was a bit tortured. Also, there is no need to check the limit on each iteration so this is a bit more efficient."
},
{
"commit": "f91af305845aa1e99d830a7a6addaee058b518d1",
"date": "2023-01-30 10:51:48 +0700",
"subject": "Add FN_PRINTF() macro.",
"body": "Bring the format(printf) attribute in line with the FN_NO_RETURN and FN_INLINE_ALWAYS macros.\n\nThis is simpler to read and can be customized for different compilers."
},
{
"commit": "f8ea51bf8f4de61fe3541e2f2701b9dccb5ede70",
"date": "2023-01-30 10:27:17 +0700",
"subject": "Refactor stackTraceToZ() to avoid multiple versions of the function.",
"body": "stackTraceToZ() was split this way in c8264291 to allow complete coverage. 0becb6da added a shim to improve coveage but missed simplifying the function."
},
{
"commit": "0d8e08f69c2ece7a060bd30dff0b375d013fe2fd",
"date": "2023-01-30 09:29:07 +0700",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "240312110c5b1c07deb200b06755a886b723485b",
"date": "2023-01-30 09:27:04 +0700",
"subject": "Begin v2.45 development."
},
{
"commit": "053468bfb156a8ecbd5d0325d35141056c89ec52",
"date": "2023-01-30 09:15:44 +0700",
"subject": "v2.44: Remove PostgreSQL 9.0/9.1/9.2 Support"
},
{
"commit": "a28f3d49c23d7dbd8873d07b7d513b6b7e59345a",
"date": "2023-01-28 18:55:53 +0700",
"subject": "Add --no-back-trace option to test.pl.",
"body": "Running valgrind and backtrace together has been causing tests to timeout in CI, mostly likely due to limited resources. This has not been a problem in normal development environments.\n\nSince it is still important to run backtraces for debugging, split the u22 test that was doing all this work to run coverage and backtrace together and valgrind-only as a separate test. As a bonus these tests run faster separately and since they run in parallel the total execution time is faster."
},
{
"commit": "16c625353db2569ebcc0c28e09d76a9811d2a241",
"date": "2023-01-28 16:22:04 +0700",
"subject": "Skip test modules in coverage report.",
"body": "Coverage of the test code is useful during development but it does not seem worth adding it to the core code coverage report."
},
{
"commit": "d5ef4ce747f0d743b76c5fe05c4e4a02cdd9bd09",
"date": "2023-01-28 11:01:29 +0700",
"subject": "Fix permissions on source files."
},
{
"commit": "3aea997df5ace85251d0579ccbe13fa938f587ee",
"date": "2023-01-25 10:59:13 +0700",
"subject": "Add warning about enabling \"hierarchical namespace\" on Azure storage.",
"body": "If this feature is enabled expire will fail since directories need to be deleted separately.\r\n\r\nIdeally we would add support for this feature but for now we'll just document the issue."
},
{
"commit": "ed818b31867c640d72ef829dd36cd0a7feff12df",
"date": "2023-01-25 10:35:03 +0700",
"subject": "Add dark mode to the website.",
"body": "The colors could use more tweaking but at least the website will no longer blind users running dark mode."
},
{
"commit": "1da2666a9ef41457ac64ddf2cabccc93b3b05aeb",
"date": "2023-01-21 14:03:27 +0700",
"subject": "Add manifest test harness.",
"body": "These macros make adding paths/files/etc to a manifest simpler and easier to read."
},
{
"commit": "912eec63bb971c10a545e582f628c982f4e00005",
"date": "2023-01-20 16:48:57 +0700",
"subject": "Block-level incremental backup.",
"body": "The primary goal of the block incremental backup is to save space in the repository by only storing changed parts of a file rather than the entire file. This implementation is focused on restore performance more than saving space in the repository, though there may be substantial savings depending on the workload.\r\n\r\nThe repo-block option enables the feature (when repo-bundle is already enabled). The block size is determined based on the file size and age. Very old or very small files will not use block incremental."
},
{
"commit": "008a18555c6474be4327bfe0830ef13166a18ece",
"date": "2023-01-20 15:44:01 +0700",
"subject": "Fix comment indentation and wrapping."
},
{
"commit": "bfc9a5c33e032ee7f95180cafcec07ce19e11aa9",
"date": "2023-01-14 18:01:48 +0700",
"subject": "Fix incorrect FUNCTION_TEST_END() in hrnPgWalToBuffer()."
},
{
"commit": "ccee5c0fb1653f00e74de13d917a24b8b3506c22",
"date": "2023-01-14 17:12:15 +0700",
"subject": "Reduce log level of pgVersionFromStr() and pgVersionToStr()."
},
{
"commit": "596c62c54e375fd25e7e34e9604b47ecc1ab73ff",
"date": "2023-01-14 15:25:25 +0700",
"subject": "Simply return in pgVersionToStr()."
},
{
"commit": "34e4835ff30e7f44cb36b3f1ed29d670e74a75ca",
"date": "2023-01-12 21:24:28 +0700",
"subject": "Refactor common/ini module to remove callbacks and duplicated code.",
"body": "The callbacks in iniLoad() made the downstream code more complicated than it needed to be so use an iterator model instead.\r\n\r\nCombine the two functions that were used to load the ini data to remove code duplication. In theory it would be nice to use iniValueNext() in the config/parse module rather than loading a KeyValue store but this would mean a big change to the parser, which does not seem worthwhile at this time."
},
{
"commit": "9ca492cecfd40516b8815080af23ee3e64efc22a",
"date": "2023-01-12 17:36:57 +0700",
"subject": "Audit mem contexts returned from functions into the calling context.",
"body": "It is possible for functions to accidentally leak child contexts into the calling context, which may use a lot of memory depending on the use case and where it happens.\n\nUse the function return type to determine what should be returned and error when something else is returned. Add FUNCTION_AUDIT_*() macros to handle exceptions.\n\nThis checking is only performed during unit tests on the code being covered by the specific unit test.\n\nNote that this does not work yet for memory allocations, i.e. memNew(). These are pretty rare so are not as much of an issue and they can be added in the future."
},
{
"commit": "de1dfb66ca022e7ab8370503eacda94629f6ae3f",
"date": "2023-01-12 17:14:36 +0700",
"subject": "Refactor logging functions to never allocate memory.",
"body": "Allocating memory made these functions simpler but it meant that memory was leaking into the calling context when logging was enabled. It is not clear that this was an issue but it seems that trace level logging could result it a lot of memory usage depending on the use case.\n\nThis also makes it possible to audit allocations returned to the calling context, which will be done in a followup commit.\n\nAlso rename objToLog() to objNameToLog() since it seemed logical to name the new function objToLog()."
},
{
"commit": "890b9d009390e472bd96ac74f6b347d7b1cc5a12",
"date": "2023-01-12 15:04:49 +0700",
"subject": "Remove mostly useless mem context in storageRemoteInfoProtocolPut().",
"body": "Maybe this once had a deeper purpose but now at least it is just used to avoid a few trivial allocations. If we really wanted to do that a flag would be better but it does not seem worth the trouble."
},
{
"commit": "6ec2241e15c4d6d6c8fe9a09c2cd562631ba8423",
"date": "2023-01-12 14:24:20 +0700",
"subject": "Fix leak in protocolServer()."
},
{
"commit": "9d42435ffbaa20febae5a9a5c62446a0fe5d0090",
"date": "2023-01-12 14:22:09 +0700",
"subject": "Fix leaks in db module."
},
{
"commit": "7f7d515441ee28e10d5f2aa63f986128638342bc",
"date": "2023-01-12 14:19:10 +0700",
"subject": "Fix leak in configOptionRemote()."
},
{
"commit": "123d5e77ae188dfe75a431fcb131dcca1b1913bb",
"date": "2023-01-12 14:17:48 +0700",
"subject": "Minor optimizations on config/parse module."
},
{
"commit": "0becb6da3147e7992b7e91f78032a961e7c352be",
"date": "2023-01-12 10:22:26 +0700",
"subject": "Enhance libbacktrace to handle incomplete stack traces.",
"body": "This fills in backtrace info at the bottom of the call stack when the stack trace is incomplete due to testing. This does not affect release builds, which is why it did not make the first cut, but it turns out to be useful for testing and barely changes the release code (when we do release this).\n\nThe recursion test in common/error was simplified because it would now return a very large trace."
},
{
"commit": "57fc4aaeb9b2aea84fce5bb813980116ad01dbe7",
"date": "2023-01-12 09:06:01 +0700",
"subject": "Update RHEL user guide to PostgreSQL 11/12.",
"body": "PostgreSQL 10 has expired from the PGDG yum repository."
},
{
"commit": "74ca9b50bbdbb33dafedcc8e1230a83cb619c3f5",
"date": "2023-01-11 19:43:10 +0700",
"subject": "Revert macro changes from 38d32045.",
"body": "This seemed like it would be cleaner but an important detail was missed (logAny) and it does not seem simpler when factoring that back in.\n\nKeep the removal of the extraneous semicolons and all the downstream changes required by the removal."
},
{
"commit": "9347313cbf1dbd5590b7ca481bd37bcb5de14b00",
"date": "2023-01-11 19:16:31 +0700",
"subject": "Fix error detail output to stderr.",
"body": "The error detail should be output when the error is an assert (this part was working) or the log level is at least debug. In cases where log-level-console was at least debug but log-level-stderr was not the detail was lost.\n\nImprove the range checking to output error detail to stderr when log-level-console is at least debug."
},
{
"commit": "c8264291238e0bd199e4babab7013060e7fcba7d",
"date": "2023-01-11 11:19:26 +0700",
"subject": "Improve libbacktrace implementation.",
"body": "The libbacktrace feature has not been working since the move to meson because libbacktrace detection was not added to the meson build. Add libbacktrace to meson and improve the feature so that it can be compiled into release builds.\n\nThe prior implementation fetched line numbers with each stack trace push. Not only was this slow but it missed any functions that were not being tracked on our stack.\n\nInstead just examine the backtrace when an error happens and merge it with the info we have on our stack. If the backtrace is not available then the output remains as before.\n\nAlso remove --backtrace from test.pl since the library is now auto-detected.\n\nLeave this library out of the production build for now to give it a little time to shake out in testing."
},
{
"commit": "0dd2997714ed31b4a005fc0061048f3697c9ea1a",
"date": "2023-01-10 11:45:48 +0700",
"subject": "Fix leak in jsonReadVarRecurse()."
},
{
"commit": "675b4ae251564742e23a9e6acdfb1d764b9b159d",
"date": "2023-01-10 11:17:08 +0700",
"subject": "Fix leak in archivePushDropWarning()."
},
{
"commit": "bf9e331ac15b0bd261f1a71e1307b51c9934aa85",
"date": "2023-01-10 10:14:43 +0700",
"subject": "Fix incorrect return type in backupFile()."
},
{
"commit": "b722d2b6ca31edead49b6dcc8fe0286bb508f5b2",
"date": "2023-01-10 09:28:57 +0700",
"subject": "Fix formatting of archiveGetFile()."
},
{
"commit": "38d320455336ab6da16c7c1b86e52d3118bcbd73",
"date": "2023-01-09 14:47:57 +0700",
"subject": "Remove duplication from FUNCTION_LOG_BEGIN_BASE() macro definitions.",
"body": "It is a bit simpler to define STACK_TRACE_TEST_START()/STACK_TRACE_TEST_STOP() in a separate #ifdef so FUNCTION_LOG_BEGIN_BASE() does not need to be defined twice.\n\nAlso add missing semicolons exposed by this change."
},
{
"commit": "6633ccd18d66f3354ce6af27c93916bce330981b",
"date": "2023-01-05 14:03:43 +0700",
"subject": "Do not output stderr on unit/integration test errors.",
"body": "Since stderr is being redirected to stdout this results in duplication of the error output."
},
{
"commit": "4429bc82f530fd87cd4e370c012054be117b76b9",
"date": "2023-01-05 12:59:06 +0700",
"subject": "Add unit tests for the unit test build code.",
"body": "When this code was migrated to C the unit tests were not included because there were more important priorities at the time.\n\nThis also requires some adjustments to coverage because of the new code location."
},
{
"commit": "a5499afabc7729efc2254010b47aeced74d0e918",
"date": "2023-01-05 12:44:00 +0700",
"subject": "Add CHECK_FMT() macros and tests for CHECK*() macros.",
"body": "The CHECK_FMT() macro will be used in some upcoming tests but could also be useful in the core code.\n\nThe CHECK*() macros never had tests so add them."
},
{
"commit": "2e3513984ef528404341e4e399f5257d6f2f1ccb",
"date": "2023-01-05 12:33:17 +0700",
"subject": "Remove extra linefeed."
},
{
"commit": "877bb2ac9e452ddeef6ddd4845c4fb59d83379fe",
"date": "2023-01-03 08:26:44 +0700",
"subject": "Update LICENSE.txt and PostgreSQL copyright for 2023."
},
{
"commit": "2b2a6edf355f50c0d399243e6d4d9fa495a1ec34",
"date": "2023-01-02 18:53:05 +0700",
"subject": "Cleanup of common/ini module in preparation for a refactor."
},
{
"commit": "92d5fd17b4ddb2e72e4cf5c10fd7708d5a9fad56",
"date": "2023-01-02 17:32:09 +0700",
"subject": "Fix formatting of restoreFile() definition."
},
{
"commit": "d51a86c6210001359f86aadc36285137fe8f2da9",
"date": "2023-01-02 17:30:57 +0700",
"subject": "Add BUFFER_EXTERN() and cleanup hash zero constants.",
"body": "BUFFER_EXTERN() provides a clean way to create buffer constants.\n\nConvert HASH_TYPE_SHA256_ZERO_STR to HASH_TYPE_SHA256_ZERO_BUF to be consistent with HASH_TYPE_SHA1_ZERO_BUF."
},
{
"commit": "66f108ea8a01ac881a47f4cbd8d5fb3ca8102e1d",
"date": "2023-01-02 17:26:53 +0700",
"subject": "Cleanup terminology in Buffer/Variant/String macros."
},
{
"commit": "f0189129088456cf22f7bf86fa505cf9c28a5e37",
"date": "2023-01-02 15:24:51 +0700",
"subject": "Split VR_EXTERN/FN_EXTERN macros from FV_EXTERN.",
"body": "This should make it a little clearer what the variable (VR) macros are doing since the declaration/definition cannot both be set to extern (but functions can).\n\nSplitting the variable macros out also allows them to be changed in the future with little churn, while changing the function macro creates a large amount of churn."
},
{
"commit": "9e29c01891225dd5f371b76d324366bbb3694ca4",
"date": "2023-01-02 15:11:37 +0700",
"subject": "Remove MacOS from CirrusCI.",
"body": "CirrusCI stopped supporting Intel but the arm builds are not working, even with the same steps that work on an arm Mac.\n\nRemove to unstick the build pipeline until this can be resolved."
},
{
"commit": "8993267df9864852efd59a9b5366e9a521a6c08e",
"date": "2022-12-31 23:33:45 +0700",
"subject": "Fix formatting."
},
{
"commit": "1793839e5a821a7177922e4cdad104eba772c3ec",
"date": "2022-12-31 19:12:35 +0700",
"subject": "Clean up storage headers and move posix internal type."
},
{
"commit": "4fb8a0ecdd12bdb01273cebbecf61f6beb22146d",
"date": "2022-12-31 17:13:41 +0700",
"subject": "Add meson unity build and tests.",
"body": "This is immediately useful because it will detect any extern'd functions or variables that are not being used. It also detects functions or variables that are declared but not defined.\n\nIf a FV/VR_EXTERN macro is missing it will be detected either because of a mismatch in the declaration/definition or because a new defined symbol will appear in the nm test.\n\nEventually the unity build will be used to create a more optimized pgbackrest binary but that will need to wait."
},
{
"commit": "8aa2b101bbd9fe07971794bf4bb4c8d2a61c7b07",
"date": "2022-12-31 16:41:01 +0700",
"subject": "Put logging functions unused by release builds into DEBUG blocks.",
"body": "Also inline some functions that are needed in non-DEBUG builds."
},
{
"commit": "4a64c5d80c9af2a3498943f326de7295679c63e6",
"date": "2022-12-31 15:49:32 +0700",
"subject": "Use memcpy() instead of strncpy when source size is known.",
"body": "In this case the destination will be large enough to hold the source so memcpy is more efficient.\n\nAlso, in highly optimized builds the compiler may warn for strncpy() when it can see that the source size won't include the terminator."
},
{
"commit": "2332ce8ffc16494766f1f6ee07341242e2b7b7c2",
"date": "2022-12-31 13:14:27 +0700",
"subject": "Move storageHelperFree() to storageHelper test harness.",
"body": "This function was only used for testing so move into a test harness."
},
{
"commit": "8b218158ae70136d7a2ddc5a7347f79e69fbeb13",
"date": "2022-12-31 12:54:33 +0700",
"subject": "Move regExpMatchPtr()/regExpMatchStr() to build/common/regExp module.",
"body": "Similar to b9be4fa5, these functions are not used by the core code so move them to the build module. The new implementation is a little less efficient but that is much less of a worry in the build/test code.\n\nAlso remove regExpMatchSize() since it was not longer needed."
},
{
"commit": "45ece13678f94c57777180710a7ea71a1c60971a",
"date": "2022-12-31 11:57:06 +0700",
"subject": "Use error*() getters where possible.",
"body": "This makes it a little easier to change the underlying representation and ensures that the functions are used."
},
{
"commit": "fa9d831f9f722f28567c4997551cd6bd1d7077d3",
"date": "2022-12-31 11:09:50 +0700",
"subject": "Move xmlNodeAttribute() to build/common/xml module.",
"body": "Similar to b9be4fa5, this function was not used by the core code so move it to the build module."
},
{
"commit": "c6264ad4cf55920558513127d4e221ce8e85eb28",
"date": "2022-12-31 10:31:15 +0700",
"subject": "Fix comment typo for strLower()."
},
{
"commit": "163a004f30675403eba2a619412bd803eba4d71a",
"date": "2022-12-31 10:26:11 +0700",
"subject": "Move strReplace() and strUpper() to build/common/string module.",
"body": "Neither of these functions were used by the core code. strReplace() is only used in the tests but it doesn't hurt to put it in build since the build code is not distributed."
},
{
"commit": "d517d4a3283c0ccc5ca5d06593d1b244dd5e68b4",
"date": "2022-12-31 10:10:44 +0700",
"subject": "Add explicit keyword for covered modules included in other modules.",
"body": "This was done by checking the extension but it is possible to include a module that does not have a vendor or auto extension. Instead make it explicit that the module is included in another module.\n\nAlso change the variable from \"include\" to \"included\" to make it clearer what it indicates."
},
{
"commit": "729d7f071dafe22f85201bfaf2bae461ec54d285",
"date": "2022-12-30 18:45:11 +0700",
"subject": "Put memContextSize() in a DEBUG block.",
"body": "This function is only used in unit tests so no need to include it in the release build."
},
{
"commit": "cebbf0d012ad7204c4770efa3308daddc267415f",
"date": "2022-12-30 16:26:48 +0700",
"subject": "Remove unused functions.",
"body": "These functions were either added with the intention that they would be used or they became obsolete over time."
},
{
"commit": "6f0c652e2c50f288fc4f541a994281032856be2b",
"date": "2022-12-30 14:59:16 +0700",
"subject": "Remove declaration for function that is no longer defined."
},
{
"commit": "416fadd60cc0401e5e730867d98ae59ff54f8dcd",
"date": "2022-12-30 14:48:31 +0700",
"subject": "Mark functions not used externally as static.",
"body": "Also cleanup a stray linefeed."
},
{
"commit": "b9be4fa54039e2c79fad0dc1552c7ffaf883004c",
"date": "2022-12-29 15:37:27 +0700",
"subject": "Restore errors when no backup matches the current version of PostgreSQL.",
"body": "It is probably not a good idea to restore the latest backup when it was not made from the current PostgreSQL version. If there is no backup after a stanza-upgrade then replicas might be built with a prior version leading to failures.\r\n\r\nAdd an error in this case if the latest backup would be used, i.e. --set or --type=time/lsn is not specified."
},
{
"commit": "aa1e72dfe662678919d3b01aa0e6454b677873ad",
"date": "2022-12-29 15:05:45 +0700",
"subject": "Fix improper formatting in config/parse module.",
"body": "The prior formatting worked but was confusing to read."
},
{
"commit": "36ee30d118ce6cc7720653a3d3a49a06c655c463",
"date": "2022-12-28 19:15:44 +0700",
"subject": "Updates and clarifications to index page.",
"body": "In particular the section about other backup solutions not supporting parallel processing was no longer accurate, so reword it.\r\n\r\nAlso update some other sections that used older nomenclature, had awkward wording, or needed clarification."
},
{
"commit": "84a3ff8b7ac1243c0b47c6585697f4fcf3c12065",
"date": "2022-12-28 10:48:44 +0700",
"subject": "Clarify target-action behavior on various PostgreSQL versions.",
"body": "The behavior of pause depends on the hot_standby parameter and the PostgreSQL version so mention both.\r\n\r\nThis behavior has been verified on PostgreSQL 9.6–15. PostgreSQL 12 is an inflection point because the behavior of an unset recovery_target_action with hot_standby=off changed in https://git.postgresql.org/gitweb/?p=postgresql.git;h=2dedf4d9a899b36d1a8ed29be5efbd1b31a8fe85."
},
{
"commit": "ae258f604e634f1d2a760ffdb92dd359fd1129bb",
"date": "2022-12-27 20:28:38 +0700",
"subject": "Add replacement for linefeeds in monitoring example.",
"body": "The copy command was converting \\n to a linefeed, which the json conversion did not like. In a healthy repository there won't be any linefeeds but certain errors can contain them.\r\n\r\nFix by loading into a text field and then replacing the linefeed when converting to jsonb."
},
{
"commit": "44da314adb2b63f96b1d571f822e91a0e412e984",
"date": "2022-12-27 20:05:08 +0700",
"subject": "Add compress-level range checking for each compress-type.",
"body": "The prior range checking was done based on the valid values for gz. While this worked it was a subset of what is available for lz4 and zst.\r\n\r\nAllow the range to be specified for each compress-type. Adding this functionality to the parse module would be a better solution but that is a bigger project than this fix deserves, at least for now."
},
{
"commit": "34110cfa0134d181c749cc040446f703b643bc9c",
"date": "2022-12-27 11:31:59 +0700",
"subject": "Fix typo."
},
{
"commit": "0b67389185558d4593be1ca56143de6a43e45f9f",
"date": "2022-12-27 09:18:17 +0700",
"subject": "Improve comment on forced WAL switch at backup start."
},
{
"commit": "a63e87ea2cd0efbf9e9b78adccdf7285a6876b3b",
"date": "2022-12-23 14:06:35 +0700",
"subject": "Move function prototype to a better location in the header."
},
{
"commit": "56b55f81e894c0b2875f92913bda8f0679009b17",
"date": "2022-12-22 09:26:26 +0700",
"subject": "Add repository checksum to make verify and resume more efficient.",
"body": "Calculate a checksum of the data stored in the repository when a file is transformed (e.g. compressed). This allows resume and verify to operate without needing to decompress/decrypt the data.\r\n\r\nThis can also be used to verify more complex formats such as block incremental and allow backups from the repository without needing to decompress the data to verify the checksum.\r\n\r\nAdd some basic encrypted tests to maintain coverage. These will be expanded in a future commit."
},
{
"commit": "2ab845e2636fcd865032075b4dce9e520d094d87",
"date": "2022-12-20 16:35:27 +0700",
"subject": "Store manifest checksums in memory more efficiently.",
"body": "Manifest checksums were stored as hex-encoded strings due to legacy compatibility with Perl. Storing the checksums as binary in memory uses half the space and avoids many conversions.\r\n\r\nThere is no change to the on-disk manifest format which stores the checksum as a hex-encoded string."
},
{
"commit": "77c721eb635c6d757d2d5ed6f2ffc083720c10a7",
"date": "2022-12-20 12:20:47 +0700",
"subject": "Remove support for PostgreSQL 9.0/9.1/9.2.",
"body": "Our new policy is to support ten versions of PostgreSQL, the five supported releases and the last five EOL releases. As of PostgreSQL 15, that means 9.0/9.1/9.2 are no longer supported by pgBackRest.\r\n\r\nRemove all logic associated with 9.0/9.1/9.2 and update the tests.\r\n\r\nDocument the new support policy.\r\n\r\nUpdate InfoPg to read/write control versions for the history in backup.info, since we can no longer rely on the mappings being available. In theory this could have been an issue after removing 8.3/8.4 if anybody was using a version that old."
},
{
"commit": "17ce738ff749c50f4ca721144cd9addce9e895f2",
"date": "2022-12-11 20:05:31 +0700",
"subject": "Use smaller type for decode tables.",
"body": "This saves a bit of space in the binary and should not have a noticeable impact on performance."
},
{
"commit": "010efffb0c3c7935f789e5c560104e5a3019a28f",
"date": "2022-12-11 19:46:48 +0700",
"subject": "Add hex encode/decoding to decode module.",
"body": "This replaces the bufHex() function and also allows hex to be decoded."
},
{
"commit": "9a9ee8e6406721c5a1825b8a25baef944802c92d",
"date": "2022-12-11 18:55:25 +0700",
"subject": "Rename EncodeType enum to EncodingType.",
"body": "This avoids constructs such as decodeToBin(encodeBase64, ...) which are confusing since decode and encode are used in the same function call. decodeToBin(encodingBase64, ...) makes it clearer what is happening."
},
{
"commit": "1345caa3f70e24ff759967692c10c07e63f44d00",
"date": "2022-12-07 20:30:38 +0700",
"subject": "Update missing flag in storage/posix test.",
"body": "The storageNewItrP() permissions test was running twice with the errorOnMissing flag set to false. Fix by setting to true for one test.\n\nAlso update the comments to be clearer about what the tests are doing and fix minor formatting."
},
{
"commit": "81d84ab495bfeaf0102adce2425ab3a528bb8845",
"date": "2022-12-07 10:57:29 +0100",
"subject": "Fix typos."
},
{
"commit": "4dc632d57064420134f3a198fa18dc951d5bf574",
"date": "2022-12-05 14:15:15 +0800",
"subject": "Add backup test harness.",
"body": "This allows test backups to be run in other test modules.\n\nIt is likely that more logic will be moved here but for now this suffices to get test backups working in the restore module."
},
{
"commit": "96cf479d3c46b310b87e69bd2e19a30e71e5824c",
"date": "2022-12-05 14:00:25 +0800",
"subject": "Add missing header in lock module."
},
{
"commit": "c972a9359beb5b75c4b0ea57bcb12a34fe5e7d84",
"date": "2022-11-28 17:56:59 +0800",
"subject": "Begin v2.44 development."
},
{
"commit": "cc2ffd8264bb4e10e6b289ce3978452018f725e8",
"date": "2022-11-28 17:47:48 +0800",
"subject": "v2.43: Bug Fix"
},
{
"commit": "c4bf775099c85e3cd081f9c1ce35efd4c71d9161",
"date": "2022-11-28 16:42:35 +0800",
"subject": "Fix missing reference in diff/incr backup.",
"body": "When loading prior manifests without the new reference list, the code failed to add the current backup to the reference list. Since the current backup is never explicitly referenced, building references from the file list was not sufficient to generate a complete list.\r\n\r\nThe main problem here was a bad test, fixed in 28f6604. This masked the issue and prevented it from being found. Now it is clear in the test that the current label is missing from the reference list.\r\n\r\nFix by adding the current label to the reference list if a reference list is not stored in the manifest."
},
{
"commit": "28f660482aa5abb97850a9d7c89c2e5e9f23a4c9",
"date": "2022-11-26 10:48:02 +0800",
"subject": "Move manifestBackupLabelSet() test in info/manifest unit.",
"body": "Changing the label of a manifest that already had a label was not a good test and it ended up masking a bug where the current backup label was not being added to the reference list on manifest load, since manifestBackupLabelSet() added the label to the reference list. In fact, manifestBackupLabelSet() should never be called after a manifest load or even after the label has been set.\n\nAdd an assertion to prevent manifestBackupLabelSet() being called when the label is already set.\n\nThe bug exposed here will be fixed in a subsequent commit."
},
{
"commit": "3f363cb3aed1a7c6836ee6c32eae600129a6f6b8",
"date": "2022-11-22 15:04:13 +0800",
"subject": "Add hint when an option is specified without an index.",
"body": "Hopefully this will make it a little clearer to the user what is wrong when they specify an indexed option without an index.\r\n\r\nAlso fix an ambiguous use of cfgParseOptionP(). The prior code worked in that it set prefixMatch = true but it was not very readable."
},
{
"commit": "27460862e77b7fba327c92448b2ec8ad41f2016c",
"date": "2022-11-22 10:29:32 +0800",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "092e254794c6d9eba9fc3175357bc91257f2eedf",
"date": "2022-11-22 10:27:20 +0800",
"subject": "Begin v2.43 development."
},
{
"commit": "70b75532bf20a025323b2a3138497ef01eb1774f",
"date": "2022-11-22 10:20:59 +0800",
"subject": "v2.42: Bug Fixes"
},
{
"commit": "3ad588443b452e04f3abcc107e825dc47e078103",
"date": "2022-11-14 12:47:27 +0800",
"subject": "Update test.pl --psql-bin option to match command-line help.",
"body": "The option to specify the path to psql was shown in the command-line help as --psql-bin but the option was actually named --pgsql-bin.\r\n\r\nRename to match the help so they are consistent."
},
{
"commit": "58b3c91babc6af9e003e5ef09bf99becf8a6f827",
"date": "2022-11-10 10:28:49 +0930",
"subject": "Add raw mode to CipherBlock to save space.",
"body": "The magic in the header is only required so that command-line openssl will recognize the file as being encrypted. In cases where the encrypted data cannot be read with the command-line tool it makes sense to omit the header magic to save some space.\n\nUnfortunately this cannot be enabled for file bundling because it would break backward compatibility. However, it should be possible to enable it for the combination of bundling and block incremental."
},
{
"commit": "c9db7bc274211820030c4ab6ab8c70c1b1896254",
"date": "2022-11-06 16:12:23 +0930",
"subject": "Update cipherBlockNew() to allow optional parameters.",
"body": "This simplifies calls a bit since digest is never passed and allows for new optional parameters."
},
{
"commit": "221db610d2a054ed00ad27377663941abfb9fb98",
"date": "2022-10-18 18:02:17 +1300",
"subject": "Shorten names in real/all integration test matrix.",
"body": "This should allow one or two more parameters to be added without going to a new line, which keeps the matrix easier to read."
},
{
"commit": "5fceee88a9439460bf24082f275ec2e695cc6bf6",
"date": "2022-10-18 17:39:59 +1300",
"subject": "Add backupFileRepoPathP().",
"body": "The path for a backup file in the repository was being generated in four different places, so move the logic to a function."
},
{
"commit": "fee38c2c7cc3ae318bf0d3b50fe23c22900c2311",
"date": "2022-10-18 16:11:35 +1300",
"subject": "Pass filters to remote storage as a handler array.",
"body": "The prior code required coverage in the storage/remote module for all filters that could be used remotely.\n\nNow the filter handlers are set at runtime so any filter list can be used with a remote. This is more flexible and makes coverage testing easier. It also resolves a test dependency.\n\nMove the command/remote unit test near the end so it will have access to all filters without using depends."
},
{
"commit": "1730ef4ac3d88137bd218e6128b0107a8bf2c121",
"date": "2022-10-18 11:33:19 +1300",
"subject": "Add noTruncate flag to storageNewWriteP().",
"body": "This flag skips truncation when opening a file for write on drivers that support it, currently Posix and CIFS. This is convenient for cases where the file needs to be manipulated directly using the file descriptor. Using the file descriptor is not ideal and additional functionality should be added to the storage interface, but for now at least this avoids code duplication, especially on close which updates owners, the timestamp, syncs, etc.\r\n\r\nThe remote driver forbids no truncate because a file descriptor is never available for a remote storage write object.\r\n\r\nUpdate two instances in the current code which benefit from this new functionality, but the primary reason for the change is to support more complex restore deltas in the upcoming block incremental feature."
},
{
"commit": "7967c750d83466d030081e9deb1d70a1ba240271",
"date": "2022-10-18 11:09:00 +1300",
"subject": "Fix protocol error on short read of remote file.",
"body": "If a remote file read was stopped before the read was complete or if an error occurred in the middle of the read then the protocol would end up in a bad state and produce this error:\r\n\r\nProtocolError: client state is 'data-get' but expected 'idle'\r\n\r\nPrevent this by reading the rest of the file on close() or free() to leave the protocol in an idle state for the next command.\r\n\r\nThis was a possible issue for bundling because the amount to read is known in advance and therefore eof may not be reached. However, I was only able to reproduce this issue with unreleased code.\r\n\r\nOn error this issue would cause the original error to be lost. The process may still fail with this fix (if the error comes from another source) but hopefully we'll get better information about the original error."
},
{
"commit": "ddd966cadc30440a81100144204d4084a0f2ac3a",
"date": "2022-10-18 09:59:15 +1300",
"subject": "Use more generic descriptions for pg_start_backup()/pg_stop_backup().",
"body": "The names were changed in PostgreSQL 15, so update the code and docs to make the naming more generic where needed to avoid using a version-specific name in the logs and documentation."
},
{
"commit": "65be4c64a984d51306db4c6febe3a124c3230f51",
"date": "2022-10-16 09:58:35 +1300",
"subject": "Finalize catalog number for PostgreSQL 15 release."
},
{
"commit": "ea162e821634919b7c839e866b99bf82010dbacc",
"date": "2022-10-14 12:54:43 +1300",
"subject": "Move storageReadRemoteOpen() in storage/remote/read module.",
"body": "This will make an upcoming important fix easier to review."
},
{
"commit": "909be412f8ad0d87f23ce2a2dbca94c3e0732f9f",
"date": "2022-10-14 12:08:40 +1300",
"subject": "Swap command/backup and command/restore unit tests.",
"body": "Logically restore belongs after backup and in a future commit restore will have a dependency on some backup objects."
},
{
"commit": "8f67fb6db2645c2dae24429555ead66147ba176f",
"date": "2022-10-14 10:59:07 +1300",
"subject": "Enable FreeBSD 12/13 builds on Cirrus CI.",
"body": "The builds were disabled in bb11539a and 164548f2 due to an error that seems to have been caused by a bad package dependency for rsync. In any case adding this fixed it:\n\npkg update && pkg upgrade -y libiconv"
},
{
"commit": "e7e106f781be01027d4829b258902549eb36eb7b",
"date": "2022-10-11 10:52:34 -1100",
"subject": "Use read-only storage to calculate checksum in restoreFile().",
"body": "Writable storage is not required here so use read-only storage instead."
},
{
"commit": "164548f2b744db5e6c7a3089176f6df2a638d105",
"date": "2022-10-11 10:20:44 -1100",
"subject": "Disable FreeBSD 12 builds on Cirrus CI.",
"body": "Build have begin failing with this error:\n\nld-elf.so.1: /usr/local/bin/rsync: Undefined symbol \"locale_charset\"\n\nThere does not appear to be a new version so hopefully this is a transient error (hoping the same for FreeBSD 13, see bb11539a). Disable for now to free the build pipeline."
},
{
"commit": "352cbf1d5738a720292b5067051a05efc2b9a8ac",
"date": "2022-10-06 10:15:38 -1000",
"subject": "Update ManifestFile booleans to bit fields."
},
{
"commit": "46a0af353139f3238dbe96671e99ea0456028940",
"date": "2022-10-05 18:05:56 -1000",
"subject": "Return binary as result from CryptoHash filter.",
"body": "The prior result was hex-encoded, which is not optimal. This was legacy from the interface with Perl and then the JSON protocol. The new binary protocol natively supports binary so it makes sense to use it and convert to hex where needed.\n\nA number of these hex conversions can now be removed but that will need to be handled in another commit."
},
{
"commit": "5602f179a177a8513b96c762590829c012c28175",
"date": "2022-10-05 17:01:35 -1000",
"subject": "Add varint-128 encode/decode to IoRead/IoWrite.",
"body": "This makes it more efficient to read/write (especially read) varint-128 to/from IO.\r\n\r\nUpdate the Pack type to take advantage of the more efficient read and remove some duplicate code."
},
{
"commit": "102ce5dee47e8d9a8d2eeaf2b2cc2bac105914ef",
"date": "2022-10-05 16:28:31 -1000",
"subject": "Add persistent reference list to manifest.",
"body": "The reference list was previously built at load time from whichever references existed in the file list. This was sufficient since the list was for informational purposes only.\r\n\r\nThe block incremental feature will require a reference list that contains all prior backups, even those that are not explicitly referenced from the manifest. Therefore it makes sense to build and persist a manifest list rather than building it at load time.\r\n\r\nThis list can still be used for informational purposes, though it needs to be sorted since the list it sill built for older manifest versions and may not be in sorted order.\r\n\r\nAdd strLstFindIdx() to find references in the list."
},
{
"commit": "c647bcb50954f623d29104cdb8a1457ed8e94579",
"date": "2022-10-05 13:14:15 -1000",
"subject": "Add manifest flags for file processing during backup.",
"body": "The prior method was to check a combination of fields to determine if a file needed to be copied, delta'd, or resumed. This was complicated and ultimately imposed a limitation on the number of operations that could be performed.\r\n\r\nIntroduce copy, delta, and resume flags in the manifest to make it clearer which operations need to be performed and to reduce complex and duplicated logic.\r\n\r\nThis also allows zero-length bundled files to be completed during manifest build rather than later on during backup processing."
},
{
"commit": "bb11539a37e830ed2a836633218b7184a7a57f2d",
"date": "2022-10-05 12:20:02 -1000",
"subject": "Disable FreeBSD 13 builds on Cirrus CI.",
"body": "Build have begin failing with this error:\n\nld-elf.so.1: /usr/local/bin/rsync: Undefined symbol \"locale_charset\"\n\nThere does not appear to be a new version so hopefully this is a transient error. Disable for now to free the build pipeline."
},
{
"commit": "1ea6a4142e47e2e0b56911ad1f028dfcddc5fd64",
"date": "2022-10-04 14:19:12 -1000",
"subject": "Improve manifest file updates.",
"body": "The prior manifestFileUpdate() function was pretty difficult to use since all the parameters had to specified. Instead, pass a ManifestFile struct that has all members set as needed.\r\n\r\nWhen new struct members are added the manifestFileUpdate() call sites will still need to be reviewed, but this should make the process of adding members a bit simpler."
},
{
"commit": "f981fb45d9931e597afec764e13b1a53d8365d25",
"date": "2022-10-04 13:22:31 -1000",
"subject": "Do not store references for zero-length files when bundling.",
"body": "This appears to have been an oversight in 34d6495. Storing the reference is not really correct since the file is not stored in a prior backup. It also uses more space.\r\n\r\nThere is no real harm in storing the reference, since it is always ignored on restore, but the code is simpler if the zero-length files can be dealt with during the manifest and don't need additional handling later on. This is also an important part of some upcoming optimizations."
},
{
"commit": "f0acc195c0527495857f1afa8b24bdf2a4f477b5",
"date": "2022-10-03 10:02:44 -1000",
"subject": "Fix assert message and add a clarifying comment."
},
{
"commit": "6e26860c2648f6e23ad99bb4d38ecb1bfc45dd0c",
"date": "2022-10-02 17:48:43 -1000",
"subject": "Do not log bundle info when a file is delta matched from a prior backup.",
"body": "It is possible to log the bundle info correctly but the information is useless with the backup reference, which does not appear until later. For now just omit the bundle info so we are not logging something incorrect."
},
{
"commit": "4722ad87a78f1085ef8d823b7460d191477e768e",
"date": "2022-10-02 17:41:31 -1000",
"subject": "Add test for differential file bundles to the command/backup unit.",
"body": "This test exposes a small logging issue. The bundle information for the matched delta on PG_VERSION is not correct. This issue will be fixed in the next commit.\n\nThe information stored in the manifest *is* correct so this bug is essentially cosmetic."
},
{
"commit": "ac99201c0ebde616279214e600e49fdf506f7469",
"date": "2022-10-02 17:32:48 -1000",
"subject": "Add bufferSize to cvtUInt64FromVarInt128() to further limit reads.",
"body": "The current call site, manifestFileUnpack(), does not know the total buffer size but the buffer has always been maintained in memory so there should be no corruption. However, there are upcoming use cases where the buffer will be read from IO, the buffer size will be known, and additional sanity checking on buffer overruns will be valuable.\n\nAlso rename params to align better with cvtUInt64ToVarInt128()."
},
{
"commit": "01b81f9d374701eb489dd1888bcba25fb5d6df84",
"date": "2022-10-01 15:26:44 -1000",
"subject": "Move link creation to storage interface.",
"body": "Direct link creation via Posix functions has been moved to the Posix driver.\r\n\r\nThis change allows adding SFTP softlink creation in the SFTP driver using the standard interface."
},
{
"commit": "2a4137ed2eeaa769508301056226d6f86a67fd06",
"date": "2022-09-25 16:15:23 -0800",
"subject": "Add zero-length chunked content test to common/ioHttp unit.",
"body": "It seems wasteful to chunk content when there is nothing to send but make sure we handle it gracefully just in case a server decides to do it."
},
{
"commit": "64b64b614c8272d2a87ffcde2fa7f27cf7eee365",
"date": "2022-09-25 12:30:30 -0800",
"subject": "Fix comment typo."
},
{
"commit": "f1e8e49fa933dd0f5dfab446f511ac010eb4d236",
"date": "2022-09-23 14:00:58 -0700",
"subject": "Use large error/log buffers in test harness.",
"body": "Ninja produces quite a bit of output so error messages are often truncated by the default error/log buffers. Use large buffers in the test harness to capture the error even when there is a lot of output.\n\nNinja has introduced a --quiet option, but it is currently too new to be in any of our test distributions."
},
{
"commit": "cd8db7d9e53e041ad6fb31f2f015541c1d24abc2",
"date": "2022-09-22 22:42:01 -0700",
"subject": "Fix memory leak in file bundle backup/restore.",
"body": "When converting restoreFile() to support file bundling in 34d64957 there were some I/O objects that were only freed at the end of the function that should have been freed at the end of each loop. Wrap the loops in temp mem contexts to fix this.\r\n\r\nDo the same to backupFile() since it would have a similar leak when resuming a backup. Since file bundles cannot be resumed the leak would not be as severe, but still seems worth doing to protect against future leaks."
},
{
"commit": "d50a4442e45efa8d1a16c9bf68f2337367c42835",
"date": "2022-09-22 10:35:41 -0700",
"subject": "Add missed release note for b05d31f5."
},
{
"commit": "9483844f7fc9a5eac64a87d3c80cfea3fd592e4e",
"date": "2022-09-19 10:25:38 -0700",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "ab4209ebcbe23b5c3b759ba67f0e9bdc6cb66280",
"date": "2022-09-19 10:17:25 -0700",
"subject": "Begin v2.42 development."
},
{
"commit": "6b355806cc288e6f473254412337596287291798",
"date": "2022-09-19 10:08:10 -0700",
"subject": "v2.41: Backup Annotations"
},
{
"commit": "c39c9f220ed328b4175d912e109697b726e9ea9b",
"date": "2022-09-15 12:00:44 -0700",
"subject": "Fix issue when listing directories recursively with a filter.",
"body": "While recursing and filtering, if the last entry in a directory was another directory containing entries then the parent list would get freed too early, causing a double free error or segfault.\r\n\r\nFix by ensuring that the completed list is at the top of the stack before freeing it. This will defer freeing parent lists until the contents of paths have been processed."
},
{
"commit": "08a44be4c38e4bc72a20c19d764be8a673c9b909",
"date": "2022-09-14 16:22:48 -0700",
"subject": "Fix incorrect storage for rendering errors.",
"body": "Coverity complained of a copy/paste error here, but the actual error was what it took to be the correct \"copied from\" code.\n\nIn any case, the prior code would have blown up as soon as a new error type was added. Fix by updating to the writable build storage."
},
{
"commit": "240cd755d19ae2688d0deee65c00daf0651bb601",
"date": "2022-09-14 10:06:06 -0700",
"subject": "Add mem context test missing from 0f7b6a33.",
"body": "A coverage exception was added during development but was not removed before commit.\n\nRemove the exception and add a test for coverage."
},
{
"commit": "8fb61a809dc63936a78e5233a2e8bc8dc616c762",
"date": "2022-09-08 18:36:03 -0600",
"subject": "Add FN_INLINE_ALWAYS macro.",
"body": "Eliminate a lot of useless repetition for a commonly used pattern."
},
{
"commit": "2c9cbbcc4e72f5c1809e0001e40bfb3e7d8bbe01",
"date": "2022-09-08 18:16:38 -0600",
"subject": "Update Cirrus CI FreedBSD 13 image version."
},
{
"commit": "3b5df1e089234d425dd225f8c1976755dc947c8a",
"date": "2022-09-02 10:03:18 -0500",
"subject": "Update archive.info timestamps after a successful backup.",
"body": "Lifecycle policies can cause the archive.info file and its copy to be removed since they are only updated on a stanza-upgrade. Update the timestamps after a successful backup to prevent this.\r\n\r\nThis does not mean that lifecycle policies should be used as a replacement for expiration. However, in some cases there may be policies in place that are out of admin control. If the lifecycle expiration is less than pgbackrest expiration then corruption of the earliest backup will occur at the very least and there might be other corruption which would make the repo unrecoverable."
},
{
"commit": "0f7b6a3344b676d79afa7cd16ab54f67be870fdf",
"date": "2022-08-31 12:44:55 -0400",
"subject": "Skip mem context cleanup in CATCH_FATAL() block.",
"body": "An error that gets raised all the way to the top TRY block might need to free a lot of resources and any of these callbacks could throw an error and mask the original error. In fact this is pretty likely since we are already in an error state. For example, the Db object will try to close the remote db connection, but if the protocol is in a bad state it will not be able to do so.\r\n\r\nSolve this, for now, by not freeing memory or calling callbacks in the CATCH_FATAL() block. This gives us a better chance if being able to report the error without encountering another error first.\r\n\r\nFor the most part, we don't need to worry about freeing resources (file handles, TLS contexts, etc.) if the program is going to exit immediately. However, it is important to attempt to terminate all active protocol connections, which is done by protocolFree() in main() since the protocol objects live in the top context.\r\n\r\nAnother way to handle this would be to implement an error stack and that is probably something we will do in the future. But, in the case of a segfault the original error would still be lost. Yet another option would be to still do cleanup but defer it until after the CATCH_FATAL() block."
},
{
"commit": "eda7f81ee4fd6818ce458768144fc3fc1e1f0f21",
"date": "2022-08-31 10:01:12 -0400",
"subject": "Fix incorrect time expiration being used for non-default repositories.",
"body": "If a repo is not specified for the expire command then the lowest repo becomes the default. The repo-retention-full value for time was being retrieved from the default rather than a specific repo which led to an incorrect expiration being applied.\r\n\r\nGet the value from the specific repo and add a test.\r\n\r\nIt would be better if the default repo could not be queried in this case but it is not clear how to do that since the repo option is valid for expire (unlike, e.g., archive-push)."
},
{
"commit": "f1cb8485917bc07e00e77efe4593fb737f72136a",
"date": "2022-08-30 18:04:32 -0400",
"subject": "Fix comment typos in command/expire unit test."
},
{
"commit": "db75ffd27037d690a11eb02902f929250fe2bf5b",
"date": "2022-08-25 10:12:22 -0400",
"subject": "Support --set in JSON output for info command.",
"body": "Allow detailed information (e.g. error list, tablespace list) in JSON output that is already available in text output with the --set option."
},
{
"commit": "381fd0a5a4de61624615b150ba98beeafac31f7e",
"date": "2022-08-24 10:52:33 -0400",
"subject": "Backup key/value annotations.",
"body": "Allow key/value annotations to be added with the backup command and added/modified/removed with the new annotate command.\r\n\r\nAnnotations can be viewed with the info command in text mode when --set is specified and are always included in JSON output."
},
{
"commit": "b05d31f531b55b747175cf94c963f95574c54d2b",
"date": "2022-08-24 09:33:26 -0400",
"subject": "Allow upload chunk size to be configured for object stores.",
"body": "There are performance benefits to increasing the upload chunk size as long as the tradeoff with additional memory consumption is acceptable.\r\n\r\nMake the chunk size configurable for S3, GCS, and Azure, but don't attempt to do any validation of the chunk size beyond some sane limits. The defaults remain as is for each storage type to avoid any unintentional regressions."
},
{
"commit": "37b4592e522289a0523f03f8e9b144ff28fa21d3",
"date": "2022-08-24 08:45:44 -0400",
"subject": "Allow host memory limits in the user guide to be disabled.",
"body": "These limits can cause errors in some environments, e.g. Docker in Docker on Mac M1.\n\nEntirely remove limits from the build, s3, and azure hosts since memory usage on these hosts is out of our control and not useful for testing.\n\nAlso allow empty variables to be rendered as blank."
},
{
"commit": "ff1188f92dfc9e8f6d4aeca8b71a9886f24f58b4",
"date": "2022-08-22 13:51:05 -0400",
"subject": "Allow quote tag in command-line help.",
"body": "The quote tag will be used in an upcoming commit."
},
{
"commit": "2a99ac4324b52b8b42db639e645378840159af00",
"date": "2022-08-17 11:24:20 -0400",
"subject": "Clear ProtocolClient callback after connection error.",
"body": "Attempting to shut down the connection will fail since the server has already disconnected and a new error will be thrown, masking the original error."
},
{
"commit": "82786da1545c0bfe8185837a35d13a50b5e11ade",
"date": "2022-08-16 16:15:48 -0400",
"subject": "Do not allow CATCH() to catch a fatal error.",
"body": "Catching individual fatal errors was only used in testing so the tests have been updated to use other errors instead. CATCH_FATAL() is now the only way to catch fatal errors.\r\n\r\nThis simplifies the logic a bit for upcoming changes to error handling and cleanup.\r\n\r\nAlso fix an issue where passing errorMessage() directly to THROW*() would attempt to copy the message buffer instead of preserving it, which is undefined behavior. Since there were no instances of this behavior before this commit, this was not a live bug."
},
{
"commit": "02665a5894dc4b025172b32c7a1ce42c81d6c582",
"date": "2022-08-02 11:05:31 -0400",
"subject": "Update Minio test/documentation container version."
},
{
"commit": "eb287b18c882a16eecfb1445a513c4da4ccab1b7",
"date": "2022-07-29 10:31:36 -0400",
"subject": "Add profiling, performance, and optimization to C test harness.",
"body": "All unit and performance tests are now built by the C harness.\n\nRemove all unit/performance test build code from Perl.\n\nRemove code from C harness that is no longer used. This code was included so the C harness could be run separately, but that is no longer needed with this full integration."
},
{
"commit": "1e83f2a022b36191c2d12185ed57cf4d96462862",
"date": "2022-07-28 14:53:48 -0400",
"subject": "Add coverage to C test harness.",
"body": "Coverage reports are still generated in Perl, but all the settings have been added to the C harness to generate raw coverage data."
},
{
"commit": "c99ea54f17c1f26a5e996bb8cfd3df81684f813b",
"date": "2022-07-27 10:32:32 -0400",
"subject": "Integrate C test harness with Perl test harness.",
"body": "The C test harness is used for unit tests from the Perl harness where possible. Currently, unit tests can be run in the C harness when --no-coverage is specified and --profile is not specified.\n\nC harness tests work on meson 0.45.\n\nThe C harness runs with valgrind by default. Valgrind can be disabled with --no-valgrind.\n\nAlso rebuild containers to add meson and update the documentation so that meson builds will work (even though we don't do them yet)."
},
{
"commit": "2caef37fd55ea12959015f02a106774f6ad711b7",
"date": "2022-07-26 18:25:24 -0400",
"subject": "Add reviewer for c267ba51."
},
{
"commit": "e9ff5248039eedb25da2fee550ec64fcebbc51c7",
"date": "2022-07-26 15:15:12 -0400",
"subject": "Add absolute path for kill in pgbackrest.service."
},
{
"commit": "79d9884141f90a9e93fb2ec8faef15e460dd3442",
"date": "2022-07-25 09:39:54 -0400",
"subject": "Move release build check to src/meson.build.",
"body": "This allows the C harness to perform release builds which are required for some tests."
},
{
"commit": "c267ba51b1778b5872f4ee928a9614545d743f3f",
"date": "2022-07-22 16:24:55 -0400",
"subject": "Move standby timeline check after checkpoint.",
"body": "The standby timeline check was being performed using pg_control data loaded before the backup started. If the backup was started immediately after a promotion the standby might not have executed a checkpoint and written the new timeline to pg_control.\r\n\r\nInstead perform the timeline check after the checkpoint is executed. This should ensure that the new timeline is in pg_control."
},
{
"commit": "cbbe93f592d8097393c5ffe214f0a8c5fb0549c1",
"date": "2022-07-22 14:45:38 -0400",
"subject": "Improve warning message on backup resume.",
"body": "The prior warning made it sound as if some action was required on the part of the user.\n\nThe new message should make it clearer that this action will be performed by pgBackRest."
},
{
"commit": "4c47cc5d4786b88a06c38aefe628356342433f64",
"date": "2022-07-22 09:24:29 -0400",
"subject": "Remove Debian package patch now that it has been merged upstream."
},
{
"commit": "19d9941367f68d6effb516fbb1444877fea9a9ce",
"date": "2022-07-21 20:10:51 -0400",
"subject": "More C test harness improvements and CI.",
"body": "Build pgbackrest binary and auto-generated code automatically.\n\nRemove --module option and allow modules to run by parameter. This is less verbose and multiple modules can be run at a time.\n\nAllow filtering of modules. Multiple tests can be passed as parameters and if the module ends in / it will be used as a prefix filter. For example, common/ will run all the common modules.\n\nIf a test errors the remaining tests will still run but the test process will eventually exit with an error.\n\nCI tests are included but unit tests remain on the development branch.\n\nWith these changes all unit tests run except those that specify the define (e.g. common/assert-off) or containerReq (e.g. protocol/protocol) keywords.\n\nBuilding the C test harness has been simplified:\n\nmeson -Dwerror=true -Dfatal-errors=true -Dbuildtype=debug test/build/none pgbackrest\nninja -C test/build/none test/src/test-pgbackrest\n\nTo run all modules:\n\ntest/build/none/test/src/test-pgbackrest test\n\nJust the common/error module:\n\ntest/build/none/test/src/test-pgbackrest test common/error\n\nAll info modules:\n\ntest/build/none/test/src/test-pgbackrest test info/"
},
{
"commit": "edfcf1652c6ab07fe5a147b97df0c563e09d3445",
"date": "2022-07-21 19:27:58 -0400",
"subject": "Test Dockerfile improvements.",
"body": "Add tzdata package so timezone tests in command/restore work correctly.\n\nMark default git path as safe. This is a security fix that is not applicable in this environment, but must be set.\n\nAlso remove package cleanup, which is inconvenient when new packages need to be installed. It makes sense for containers that will be downloaded from Dockerhub but not so much for a locally-maintained container."
},
{
"commit": "5e5b04be3741b4e903c9a7764dadfbe5bda121ae",
"date": "2022-07-21 18:19:47 -0400",
"subject": "Fix common/lock test creating \"750\" path.",
"body": "This was clearly an attempt to set the mode when creating a directory, but it never worked and instead created a \"750\" directory in the current working directory.\n\nDetected when running in an environment where the current working directory was read-only."
},
{
"commit": "f9bbafbf3fbd67fc289cf849900799b4718dace1",
"date": "2022-07-20 19:02:14 -0400",
"subject": "C test harness improvements.",
"body": "Add harness depends when present.\n\nInclude libyaml in all test builds.\n\nFix mode on paths before trying to remove and set test path with mode 770 to match the Perl test harness.\n\nWith these changes all unit tests run except those that specify the define (e.g. common/assert-off), binReq (e.g. command/archive-get), or containerReq (e.g. protocol/protocol) keywords.\n\nBuilds and code generation need to be done in advance. The following commands are required for setup:\n\nmeson setup -Dwerror=true -Dfatal-errors=true -Dbuildtype=debug build pgbackrest\nninja -C build test/src/test-pgbackrest\nbuild/src/build-code help pgbackrest\nbuild/src/build-code postgres pgbackrest\n\nNow tests can be run, e.g.:\n\nbuild/test/src/test-pgbackrest --module=postgres/interface"
},
{
"commit": "c625f05a13e0238bf06feb26d0d8757dd2bedffd",
"date": "2022-07-20 17:45:39 -0400",
"subject": "Unify code builder binaries into a single binary.",
"body": "Creating new binaries was convenient at first but has now become a maintenance issue.\n\nSolve this by combining that into a single binary that takes an additional parameter to indicate which code should be built.\n\nAlso clean up path handling to make it easier to build code from the command line."
},
{
"commit": "7eb5d679857999faebe78730c5a30e450ef80d5c",
"date": "2022-07-19 18:03:39 -0400",
"subject": "Add module harness and shim support to the C test harness.",
"body": "This allows running unit tests up to common/ini, excluding common/debug-off and common/assert-off."
},
{
"commit": "8fdeed780787a2c6df6672f5d9c75fb7b5b613bc",
"date": "2022-07-19 17:57:13 -0400",
"subject": "Copy repository links as files for testing.",
"body": "This makes the test code a bit simpler where we are listing a path but not following links.\n\nLinks in the repository can be used for testing but should never be committed to the main branch."
},
{
"commit": "eb775790087cd8594f6649893895c42a407302cd",
"date": "2022-07-19 17:25:07 -0400",
"subject": "Fix comment typo."
},
{
"commit": "f3a10b921bf3d87152d27347df23b487877abe94",
"date": "2022-07-18 10:52:57 -0400",
"subject": "Update config.guess to latest version."
},
{
"commit": "20f9f726478a4d1c8897cc31a5bf7df52275b84f",
"date": "2022-07-18 10:49:58 -0400",
"subject": "Begin v2.41 development."
},
{
"commit": "1ff531090b9d1eccd9107592398148a51486c9f8",
"date": "2022-07-18 09:32:30 -0400",
"subject": "v2.40: OpenSSL 3 Support"
},
{
"commit": "1df1e0281b94a06ff0f16622e2cbb76598d430d1",
"date": "2022-07-14 17:13:33 -0400",
"subject": "Replace AC_PROG_CC_C99 configure macro with AC_PROG_CC.",
"body": "AC_PROG_CC_C99 is now obsolete.\n\nThe AC_PROG_CC macro does not guarantee C99 compliance but we add an option to check for that a bit later."
},
{
"commit": "364af1635d40431276cc6fd87d6ddd689b611e09",
"date": "2022-07-14 08:26:03 -0400",
"subject": "Force target-timeline=current when restore type=immediate.",
"body": "Explicitly set target timeline to \"current\" when type=immediate and PostgreSQL >= 12. We do this because type=immediate means there won't be any actual attempt to change timelines, but if we leave the target timeline as the default of \"latest\" then PostgreSQL might fail to restore because it can't reach the \"latest\" timeline in the repository from this backup.\r\n\r\nThis is really a PostgreSQL bug and will hopefully be addressed there, but we'll handle it here for older versions, at least until they aren't really seen in the wild any longer.\r\n\r\nPostgreSQL < 12 defaults to \"current\" (but does not accept \"current\" as a parameter) so no need set it explicitly."
},
{
"commit": "75623d4583bfdaccb3a19b935fd04d744b363923",
"date": "2022-07-08 17:21:39 -0400",
"subject": "Create snapshot when listing contents of a path.",
"body": "Previously a callback was used to list path contents and if no sort was specified then a snapshot was not required. When deleting files from the path some filesystems could omit files that still existed, which meant the path could not be removed.\r\n\r\nFilter . out of lists in the Posix driver since this special entry was only used by test code (and filtered everywhere in the core code).\r\n\r\nAlso remove callbacks from the storage interface and replace with an iterator that should be easier to use and guarantees efficient use of the snapshots."
},
{
"commit": "f9ac53db92574e8b499187ee4f2a7258bc2f4794",
"date": "2022-07-08 14:38:14 -0400",
"subject": "Fix typo."
},
{
"commit": "74a4ac801db921f7b11b63b9f927228c6a6af861",
"date": "2022-07-08 11:13:55 -0400",
"subject": "Add link to PostgreSQL configuration in repository host section.",
"body": "This should make the documentation clearer when starting from this section."
},
{
"commit": "0eccbc8bf47073ab8ec1f13fed9865d0bd7c3635",
"date": "2022-07-06 18:17:52 -0400",
"subject": "Meson builds work on version 0.45.",
"body": "v0.45 ships with Ubuntu 18.04, which is currently the oldest distro we support. We may never do a Meson release on Ubuntu 18.04 but this allows us to start running unit tests with Meson in the meantime.\n\nSome more granular options are not available so we use buildtype in more places.\n\nThe check for a in-tree autoconf/make build had to be removed since the filesystem APIs are not available.\n\nFinally, alias_target was removed. This means that full paths must be used for build targets, which does not seem too bad. For instance, test/src/test-pgbackrest must now be used as a build target instead of simple test-pgbackrest."
},
{
"commit": "72960bbf179b4e8051bd4fc50be57d95159e9e13",
"date": "2022-07-06 09:55:32 -0400",
"subject": "Rename strTrunc() to strTruncIdx() and add strTrunc().",
"body": "strTrunc() is now shorthand for truncating to index 0. This is convenient when a string is being reused."
},
{
"commit": "cd25cec1471dde60f85404744252b675efff2522",
"date": "2022-07-05 14:34:31 -0400",
"subject": "Add comment to indicate that type is in a different info level."
},
{
"commit": "1c0bf0b15da8c0d15cc639851ff1d1bd05b51d06",
"date": "2022-07-05 14:28:40 -0400",
"subject": "Reorder null user/group checks in remote protocol and add tests.",
"body": "Coverage for these checks was dependent on the order the files were read from disk, which made the tests fragile.\n\nRearrange the checks and add a test that won't depend on order."
},
{
"commit": "326d152a14121cb298089847a3694aa9f50bcbd2",
"date": "2022-07-05 06:58:19 -0400",
"subject": "Update contributor name."
},
{
"commit": "845d82f6825d4101e6a465a435ef056ff6ec15a2",
"date": "2022-07-01 20:32:10 -0400",
"subject": "Use S3 IsTruncated flag to determine list continuation.",
"body": "Previously we were just checking for the existence of NextContinuationToken, which the S3 documentation indicates will not be present when the list is not truncated. However, recent versions of Scality send a blank NextContinuationToken when IsTruncated is false. Sending the blank continuation token back causes Scality to send another blank continuation token and an infinite loop occurs.\r\n\r\nInstead use IsTruncated (which is required to be present) to determine whether NextContinuationToken should be present. Error if NextContinuationToken is then missing or empty, since an empty token caused an infinite loop with the Scality server (which arguably should have errored when passed an empty token)."
},
{
"commit": "61ca9b58a000aa8789ef3267682519bdb15e8a6b",
"date": "2022-06-28 14:15:08 -0400",
"subject": "Replace hrnStorageInfoListCallback() with TEST_STORAGE_LIST() in tests.",
"body": "The TEST_STORAGE_LIST() macro is more robust and hides the callback mechanism from the caller.\n\nAdd features to TEST_STORAGE_LIST() that hrnStorageInfoListCallback() had.\n\nUpdate tests to use the abbreviated type output (e.g. path/) generated by TEST_STORAGE_LIST()."
},
{
"commit": "59f148bf6ea8c090d4d65ce5b135a71501e8ae22",
"date": "2022-06-26 08:42:43 -0400",
"subject": "Generate -fmacro-prefix-map to strip relative path from __FILE__.",
"body": "This provides reproducible builds and minimizes the file path in debug messages, just like an in-tree make build.\n\nFor test source, prefix with test/ in case there are any module name collisions."
},
{
"commit": "f863fc98886f4d6c2803b9a2396539597d0d7be2",
"date": "2022-06-23 12:20:56 -0400",
"subject": "Add experimental unit test harness written in C.",
"body": "Having the test harness in C will allow us to remove duplicated Perl code and test on systems where Perl support is not present.\n\nCustom harnesses and shims are currently not implemented, which means only the following tests in the common module will run: error, stack-trace, type-convert, assert-on, mem-context, time, encode, type-object, type-string, type-list, type-buffer, type-variant, reg-exp, log.\n\nThe experimental test harness is being committed with partial functionality so it can be used in Windows development. The remaining features will follow as needed."
},
{
"commit": "b7a1b3ec2c16fde6a201f404a27d8343595900b6",
"date": "2022-06-23 10:57:58 -0400",
"subject": "Used DEBUG instead of NDEBUG in common/stackTrace module.",
"body": "In some testing cases these might not be in sync, which causes unpredictable behavior."
},
{
"commit": "29d2f0f9fda4dbba0dc5eca6f84368a6f655bd28",
"date": "2022-06-22 09:52:30 -0400",
"subject": "Add cast to handle compilers (e.g. MSVC) that coerce to signed int.",
"body": "MSVC changes the sign in this case, presumable because of the subtraction. Cast so that MSVC does not also trigger a mixed sign warning."
},
{
"commit": "9fd85a104ad56061b028afd9057ce8c1d636d3dd",
"date": "2022-06-21 09:50:38 -0400",
"subject": "Disable meson for all but debug builds.",
"body": "The meson builds are still experimental so for now the configure/make build process is preferred for release builds. This message should help prevent any automated build systems from picking up meson instead."
},
{
"commit": "665da12ae7f519077512e60ce3a5ec6c6a9997fd",
"date": "2022-06-17 16:41:48 -0400",
"subject": "Update meson.build include comment to be more general.",
"body": "Eventually multiple subdirs will be included so update the comment to reflect that."
},
{
"commit": "5ecae90f0254ef752d8323ea5be3b99673ec46f7",
"date": "2022-06-17 16:31:48 -0400",
"subject": "Use constants rather than replacements when possible in test.c.",
"body": "Some of the replacements that were being done already existed as constants, so use the constants instead.\n\nAlso fix a minor formatting error introduced when testAdd() was renamed to hrnAdd()."
},
{
"commit": "dab1e4b6c66018c03c6e01309c41a89ef82ff5bc",
"date": "2022-06-17 16:27:31 -0400",
"subject": "Add strReplace().",
"body": "Allows substrings to be replaced with another string."
},
{
"commit": "fb9acc1c93d504d366493bc42038f15faa80300d",
"date": "2022-06-17 16:17:02 -0400",
"subject": "Add higher level YAML functions.",
"body": "These functions make parsing YAML simpler."
},
{
"commit": "55bcb933eee753a0cdd13f9861a00c33d194c1e7",
"date": "2022-06-17 11:17:52 -0400",
"subject": "Move protocol module from common to command.",
"body": "This module has dependencies on command/command so it does not make sense for it to be in the common module. Also move protocolFree() to main() since this is a very large dependency.\n\nAdjust the tests so command/exit can be tested later. This is a bit messy but will get adjusted as we improve the test harness."
},
{
"commit": "eb72a80b471145d97ac4170e3215f7c67aa83082",
"date": "2022-06-15 09:06:25 -0400",
"subject": "Fix continuation character spacing."
},
{
"commit": "716bba5800d504a76d4bdc99588448824be3d83f",
"date": "2022-06-14 08:13:22 -0400",
"subject": "Fix hard-coded WAL size assertion in walSegmentNext().",
"body": "PG_WAL_SEGMENT_SIZE_DEFAULT is used to compare and check WAL size on pre-11 installations. However, there is a hard-coded assertion in walSegmentNext() which doesn't respect PG_WAL_SEGMENT_SIZE_DEFAULT.\r\n\r\nUpdate the assertion to use PG_WAL_SEGMENT_SIZE_DEFAULT."
},
{
"commit": "282edda661b5f1eb189998e7db680b91a2b8a66b",
"date": "2022-06-09 17:42:00 -0400",
"subject": "Remove storageLocal() dependency from common/lock module.",
"body": "The storage/helper module is a very heavy dependency to introduce in the common module. Creating Posix storage objects is cheap so just do that instead."
},
{
"commit": "04f5ef25faf276e51bd546199f1197b5c70003e8",
"date": "2022-06-09 17:18:32 -0400",
"subject": "Add valgrind to Dockerfile missed in a16cf5ea."
},
{
"commit": "79443bea3634f7dd3858b6f65838e31fb9b87c3f",
"date": "2022-06-09 16:55:07 -0400",
"subject": "Move bldEnum() to the build/common/render module.",
"body": "This function will be useful for other build/test modules so extern it.\n\nAlso skip the first upper-case when no prefix is provided."
},
{
"commit": "1a00ab10033e9ac6e6f797627567e8b91e143432",
"date": "2022-06-09 07:34:11 -0400",
"subject": "Fix compile error when DEBUG_EXEC_TIME is defined without DEBUG.",
"body": "If DEBUG is not defined then the ASSERT() macro expands to nothing. In this case the timeBegin variable is never used and a compilation error occurs.\r\n\r\nThis test should work without DEBUG defined so use CHECK() instead of ASSERT()."
},
{
"commit": "0dabf88e9d85e4db2ff65ebbb14b4320e1092a8b",
"date": "2022-06-08 17:43:23 -0400",
"subject": "Add FN_NO_RETURN macro.",
"body": "Change all instances of __attribute__((__noreturn__)) to a macro in meson.build / build.auto.h.in.\r\n\r\nAs compiler attributes written in the form of __attribute__ are not supported by MSVC, this is one of several commits to make the code-base more robust and allow using MSVC-style attributes later."
},
{
"commit": "8babd558bc3a5b930fd096ffb306551773f1f14d",
"date": "2022-06-08 07:26:15 -0400",
"subject": "Add missing build.auto.h includes.",
"body": "These are required for proper building but were probably not noticed before since they are not part of the core code."
},
{
"commit": "a16cf5eac7217e79d8669fab5dff1863e26208c9",
"date": "2022-06-06 16:32:20 -0400",
"subject": "Update CI to use Ubuntu 22.04 and Fedora 36.",
"body": "Both have newer gcc and OpenSSL 3.\n\nFedora 36 runs horribly slow with valgrind enabled so run the valgrind tests on Ubuntu 22.04. Fedora 36 has a newer gcc so it is still worth testing on."
},
{
"commit": "08242ee6ac93b9eb9c05cc39e3db15bbafb9052c",
"date": "2022-06-06 14:47:47 -0400",
"subject": "OpenSSL 3 support.",
"body": "There are two changes:\r\n\r\n* Suppress deprecation warnings so we can build with -Werror and -Wfatal-errors. At some point we'll need to migrate to the new APIs but there does not seem to be a good reason to support two sets of code right now.\r\n\r\n* Update the handling for unexpected EOF to handle EOF or error. The error code for EOF has changed and become harder to identify, but we probably don't care whether it is an error or EOF."
},
{
"commit": "f92ce674f79e2d6056794c1af4002c01dad93aed",
"date": "2022-06-06 13:52:56 -0400",
"subject": "Automatically create PostgreSQL version interfaces.",
"body": "Maintaining the version interfaces was complicated by the fact that each interface needed to be in separate compilation unit to avoid type conflicts. This also meant that various build/test files needed to be updated to add the new interfaces.\r\n\r\nSolve these problems by auto-generating all the interfaces into a single file. This is made possible by parsing defines and types out of the header files and creating macros to rename the types. At the end of the version interface everything is undef'd. Another benefit is that the auto-generated interfaces can be static and included directly into postgres/interface.c.\r\n\r\nSince some code generation is now always required for tests, change --no-gen to --min-gen in test.pl.\r\n\r\nIt would also make sense to auto-generate the version defines in postgres/version.h, but that will be left for a future commit."
},
{
"commit": "b8fc20d5b8e7ca003ff39f29ea6e3ba57653f55c",
"date": "2022-06-03 14:13:56 -0400",
"subject": "Add experimental Meson build.",
"body": "Meson is a new build system that offers simpler syntax and superior performance to autoconf/make. In addition, Windows is supported natively.\r\n\r\nThe Meson build appears complete, but currently is used only for auto-generation of code and the host build of pgbackrest. Some container upgrades will be required before Meson can be used for container builds.\r\n\r\nAlso patch the Debian package to force autoconf/make rather than Meson."
},
{
"commit": "148956aed8aca201aa800af321d946094b96f176",
"date": "2022-06-01 10:13:57 -0400",
"subject": "Remove useless command/check unit test.",
"body": "This test was a placeholder and did not provide any coverage, but it did give inconsistent results on different shell versions."
},
{
"commit": "29b2a54fcc74457af5c63ffb505c5fbb24bb2ade",
"date": "2022-05-31 17:28:58 -0400",
"subject": "Allow any path to be passed to the --test-path option.",
"body": "A hard-coded path prevented this from working correctly."
},
{
"commit": "be354c489017ea84ed825f226b50d170bec1ff68",
"date": "2022-05-31 16:52:26 -0400",
"subject": "Update CodeQL to version 2.",
"body": "Version 1 will be deprecated on December 12, so upgrade now to avoid nasty surprises."
},
{
"commit": "2c38c9a56f95efea42d489792751b77acfc470e4",
"date": "2022-05-31 16:43:18 -0400",
"subject": "Skip stopping PostgreSQL 9.1 in real/all integration test.",
"body": "Stopping the cluster has started consistently running out of memory on PostgreSQL 9.1. This seems to have happened after pulling in new packages at some point so it might be build related.\n\nStopping the cluster is not critical for 9.1 so skip it."
},
{
"commit": "2feaaeaac803d6c0193477b56dbeb622fd991156",
"date": "2022-05-31 16:06:41 -0400",
"subject": "Add .inc extension to C files included in other C files.",
"body": "These files were never intended to be compiled on their own so the .c extension was a bit misleading. In particular Meson does not like .c files that are not intended to be compiled independently.\n\nLeave header files as is since they are already protected against being included more than once and are never expected to be compiled."
},
{
"commit": "cb891fa2d402ee338b72d2c0962cc5cd49eea4f1",
"date": "2022-05-31 13:02:51 -0400",
"subject": "Run remaining Github Actions CI on Ubuntu 20.04.",
"body": "The s390x/ppc64le tests are already running on 20.04."
},
{
"commit": "2643050be0dc4b7363c434f58373919bd6fdac68",
"date": "2022-05-31 12:36:21 -0400",
"subject": "Skip internal options in the configuration reference.",
"body": "Most internal options were being skipped, but not in the case where an option was marked internal for a specific command.\n\nThe command-line help was not affected by this issue."
},
{
"commit": "f0aae6ceab9a95c6d63b8955abd2592ddbbce90a",
"date": "2022-05-31 12:26:57 -0400",
"subject": "Remote repo options should not be valid for the backup command.",
"body": "Some of the remote repo options were gated by repo-local, but the rest relied on repo-host-cmd.\n\nRemove backup from the repo-host-cmd option since none of the dependent options are valid for backup."
},
{
"commit": "a902c7808d8bf651389e2479d4622b0fd49ab09d",
"date": "2022-05-31 12:24:21 -0400",
"subject": "Make all repo-* options visible for stanza create/update/delete.",
"body": "31c7824a allowed these commands to run remotely but neglected to remove some internal flags, which prevented all the repo-* options from being visible in the documentation."
},
{
"commit": "60d70fa66fc3f709914f40dd088bac1b467001f2",
"date": "2022-05-25 18:18:37 -0400",
"subject": "Disable incremental manifest save when resume=n.",
"body": "The manifest is saved on a regular basis during a backup so a failed backup can be resumed. For backups that the user has configured/invoked as not resumable, skip the incremental save of the manifest."
},
{
"commit": "8c2b3a044fa175031366fb4f676b5c1a0a319ec0",
"date": "2022-05-25 15:27:53 -0400",
"subject": "Use StringId for type in cryptoHash() and cryptoHmacOne().",
"body": "This brings hash types in line with cipher types (i.e. a StringId enum) and allows removal of some Strings."
},
{
"commit": "38ad2838d553febae1b7fe0244d942dfaa9cf548",
"date": "2022-05-25 14:20:19 -0400",
"subject": "Set backup percent complete to zero before copy start.",
"body": "Waiting to write percent complete until the first file completed resulted in a period of time where the backup was running without status available to the user.\r\n\r\nRemedy this by initializing percent complete to zero when the backup is ready to start copying files."
},
{
"commit": "7b1935c71005a5a928e34caf7b8b48e5d871cc66",
"date": "2022-05-25 10:23:43 -0400",
"subject": "Remove unused errors.",
"body": "Most of these were probably never ported from Perl to C and others became obsolete over time.\n\nFix one error that was the wrong type.\n\nAlso fix/improve some comments."
},
{
"commit": "f6f2f2e2a34c01e20bbf6c26e5e8a232a6bd232d",
"date": "2022-05-25 09:42:49 -0400",
"subject": "Add missing static keywords.",
"body": "Add static keyword to local variables where missing."
},
{
"commit": "7ec51e7e6279ea576ad3b4b5c2ea1fc389d08ab5",
"date": "2022-05-24 16:39:35 -0400",
"subject": "Truncate files during delta restore when they are larger than expected.",
"body": "Previously the behavior was to download the file from the repository when it was not exactly the same size in PGDATA. However, it may just be that the file was extended and the contents are the same up to the file size recorded in the manifest. This could also be very valuable for files that are always append only, like logs.\r\n\r\nChange info.size to file->size in one place. Both are technically correct but file->size makes more sense.\r\n\r\nUse the new fileName variable in a few existing places.\r\n\r\nAlso adjust some existing comments to make them clearer."
},
{
"commit": "c98baab6b56967e222b825e22e5808e17c02d025",
"date": "2022-05-19 18:24:09 -0400",
"subject": "New CI container builds for PostgreSQL 15 beta1 and minor releases.",
"body": "Remove VM_OS_REPO since it is no longer required.\n\nRebalance PostgreSQL versions for more efficient test times.\n\nAlways print version of PostgreSQL when testing. This helps verify that new minor releases are being used."
},
{
"commit": "69adb990dced3bf1d76a3e2482aad38016165d6c",
"date": "2022-05-19 12:25:58 -0400",
"subject": "Use storagePathP() instead of cfgOptionStr() to get base repo path.",
"body": "cfgOptionStr() may not have the correct value if the repo is remote.\n\nUse storagePathP() instead since it can ask the remote for the correct value when required."
},
{
"commit": "c7a66ac1afb9a55b049dc18493b602b7bf62bda4",
"date": "2022-05-18 10:52:01 -0400",
"subject": "Improve memory usage of mem contexts.",
"body": "Each mem context can track child contexts, allocations, and a callback. Before this change memory was allocated for tracking all three even if they were not used for a particular context. This made mem contexts unsuitable for String and Variant objects since they are plentiful and need to be as small as possible.\r\n\r\nThis change allows mem contexts to be configured to track any combination of child contexts, allocations, and a callback. In addition, the mem context can be configured to track a single child context and/or allocation, which saves memory and is a common use case.\r\n\r\nAnother benefit is that Variants can own objects (e.g. KeyValue) that they encapsulate. All of this makes memory accounting simpler because mem contexts have names while allocations do not. No more memory is used than before since Variants and Strings still had to store the memory context they were originally allocated in so they could be easily freed.\r\n\r\nUpdate the String and Variant objects to use this new functionality. The custom strFree() and varFree() functions are no longer required and can now be a wrapper around objFree().\r\n\r\nLastly, this will allow strMove() and varMove() to be implemented and used in cases where strDup() and varDup() are being used to move a String or Variant to a new context. Since this will be a bit noisy it is saved for a future commit."
},
{
"commit": "83af3f1b7ae78b150849939766e2e555366b95d5",
"date": "2022-05-18 08:48:48 -0400",
"subject": "Add additional detail to warnings when delta checksum is auto-enabled.",
"body": "Hopefully this will help with debugging when it is not clear why delta checksum is being enabled."
},
{
"commit": "5dfd00bb6ce0d6d2ead0ba6c899c18983f9a7ac9",
"date": "2022-05-18 08:18:34 -0400",
"subject": "Fix RHEL container build for documentation.",
"body": "For some reason /lib/systemd/system/sysinit.target.wants no longer exists in the rockylinux:8 container.\n\nCreate this directory explicitly in case it does not exist."
},
{
"commit": "5360f2ec0af08ac1755d48f234347c240ff09f4a",
"date": "2022-05-16 10:50:07 -0400",
"subject": "Fix comment indentation."
},
{
"commit": "b598f49dedbfb2bdd19d43dae9fa9ba654f2287c",
"date": "2022-05-16 09:17:00 -0400",
"subject": "Udpate parse.auto.c with labels from 4dcc9df2.",
"body": "Committed separately so it can be ignored in history/blame."
},
{
"commit": "4dcc9df222d2ecef6721c9ecd52b05e24024cc3d",
"date": "2022-05-16 09:14:46 -0400",
"subject": "Add labels in parse.auto.c to make diffs easier to read.",
"body": "Because there is a lot of repetition in this file, changes can look very jumbled with existing data in a diff. Also, if can be hard to tell what is being modified if the diff does not show enough lines before and after.\n\nThis change adds labels to the end of the line to localize the diff and make it easier to see what has been changed. Also, remove some linefeeds and make separators more consistent.\n\nThe change to parse.auto.c will be committed separately so it can be ignored in history/blame."
},
{
"commit": "f5023a769d4580258a336cf26f2b293aa2341b29",
"date": "2022-05-16 08:54:19 -0400",
"subject": "Update config.guess to latest version."
},
{
"commit": "243eef1e520bb72ae2b28a627dda323305e38862",
"date": "2022-05-16 08:51:37 -0400",
"subject": "Begin v2.40 development."
},
{
"commit": "901e829f6dd05fdc15d899bc7f1108883002b1d5",
"date": "2022-05-16 08:46:24 -0400",
"subject": "v2.39: Verify and File Bundling"
},
{
"commit": "19dd015d589ed3efd31a2a238249a150fb3748c1",
"date": "2022-05-13 09:41:53 -0400",
"subject": "Fix issues in improved path validation for repo-* commands.",
"body": "If the user requested the exact repo path then strSub() would be passed an invalid start value leading to an assertion:\r\n\r\n$ pgbackrest --stanza=test repo-ls /var/lib/pgbackrest\r\nASSERT: [025]: start <= this->pub.size (on dev builds)\r\nASSERT: [025]: string size must be <= 1073741824 bytes (on prod builds)\r\n\r\nFix this by checking if the requested path exactly equals the repo path and returning an empty relative path in this case.\r\n\r\nAnother issue was that invalid subpaths were not detected if they started with the repo path. For example, /var/lib/pgbackrestsub would not generate an error if the repo path was /var/lib/pgbackrest. Fix this by explictly checking for a / between the repo path and the subpath. This also requires special handling when the repo path is /.\r\n\r\nThis is not a live bug since the issues were found in an unreleased feature introduced in 5ae84d5."
},
{
"commit": "024500782e9fde91cf236db70a584beb52586d38",
"date": "2022-05-12 17:02:08 -0400",
"subject": "Reduce encrypted WAL segments sizes in command tests.",
"body": "The encrypted archive-push and repo tests were running very slowly on 32-bit with Valgrind enabled. This appears to be an issue with a newer version of Valgrind, but it has been going on long enough that bisecting does not seem to be worthwhile.\n\nReduce the size of the encrypted test segments where possible to improve overall test performance."
},
{
"commit": "7d9b2e267c3f68463000cfcfec6018cc12203f23",
"date": "2022-05-12 11:57:12 -0400",
"subject": "Move 32-bit CI testing from Debian 9 to Ubuntu 18.04.",
"body": "Debian 9 will be EOL before our next release, so move 32-bit testing to Ubuntu 18.04, which is older than Debian 10."
},
{
"commit": "24f138b0672ed55aeef1673b816b803487bca932",
"date": "2022-05-11 16:20:41 -0400",
"subject": "Remove excessive const usage in build module.",
"body": "This was an experiment that attempted to create immutable structs (at least without casting). It turned out to be a bit burdensome and required unsafe-looking casting in some cases."
},
{
"commit": "3d8ee552fe85aae6f2f00cd2a9436fb6b34513e1",
"date": "2022-05-11 15:59:37 -0400",
"subject": "Move some PostgreSQL integration tests to rh7.",
"body": "This makes the u20 test run faster. Since u20 is currently the longest running test, the time to complete all tests is also improved."
},
{
"commit": "a913113fda5886ffd2ff136cdd52a3f469eca026",
"date": "2022-05-11 15:23:41 -0400",
"subject": "Add option type descriptions.",
"body": "This cuts down on repetition of the size descriptions and adds basic descriptions for the other option types."
},
{
"commit": "5fbea6da811ee93dcd966b8f7d84d6da2e65c6c5",
"date": "2022-05-11 10:39:31 -0400",
"subject": "Add br tag for documentation.",
"body": "This tag allows for a simple linefeed in a p tag instead of being forced to start a new paragraph."
},
{
"commit": "8ee85bc605da4aff5069bd1b965bbb585d9fe851",
"date": "2022-05-11 08:46:23 -0400",
"subject": "Fix \"that that\" typos."
},
{
"commit": "c4f7edef2b6a9b541e94793c1dabbff7db854a9b",
"date": "2022-05-11 08:42:46 -0400",
"subject": "Fix typos in help."
},
{
"commit": "50d409a812be577f2c296f3d6096cf97fab049ff",
"date": "2022-05-10 14:17:05 -0400",
"subject": "Add FAQ about backup types and restore speed.",
"body": "Based on several questions/misunderstandings, provide clarification about the backup type only affecting the backup action, and not the restore."
},
{
"commit": "de816a0f5793747a774b98af627776112cc7cb2d",
"date": "2022-05-10 13:18:26 -0400",
"subject": "Remove integration expect log testing.",
"body": "Integration expect log testing was originally used as a rough-and-ready way to make sure that certain code paths were being executed before the unit tests existed. Now that we have 100% unit test coverage (with expect log testing) the value of the integration expect tests seems minimal at best.\r\n\r\nBut they do cause numerous issues:\r\n\r\n- Maintenance of the expect code and replacements that are required to keep logs reproducible.\r\n- Even a trivial change can cause massive churn in the expect logs, e.g. d9088b2. These changes should be minutely audited but since the expect logs have little value now it is seldom worth the effort.\r\n- The OS version used to do expect testing (RHEL7) can only be used to test one version of PostgreSQL. This makes it hard to balance the PostgreSQL version testing between OS versions.\r\n- When a commit affects expect logs it is not clear (especially for new developers) how to regenerate them and our contributing guide is silent on the issue.\r\n\r\nThe goal is to migrate the integration tests to C and expect testing is not part of that plan. It seems best to get rid of them now."
},
{
"commit": "3a403944729e03c66de83e6750c38cab97743333",
"date": "2022-05-10 11:18:12 -0400",
"subject": "Remove obsolete test in common/memContext.",
"body": "Once upon a time the allocation array was allocated up front so this test was required for the top context, which did not allocate up front.\n\nNow allocations are done on demand so this case is covered for every context that does not allocate memory."
},
{
"commit": "6b98b3534e15a8d277547eb2932c085bc7515eec",
"date": "2022-05-10 06:52:56 -0400",
"subject": "Fix typo."
},
{
"commit": "cc5b0614894e1b5ef78f1ceba3bc8e4760a40a24",
"date": "2022-05-09 18:07:11 -0400",
"subject": "Document required base branch for pull requests.",
"body": "Be explicit when submitting a PR about which branch to use as the base."
},
{
"commit": "b4c1ca7b807a906d42d540307da3603052c4a674",
"date": "2022-05-09 14:19:05 -0400",
"subject": "Split 32-bit CI tests.",
"body": "This helps rebalance some of the tests that are running long, i.e. d9 and u20.\n\nI would be better to move more PostgreSQL versions to d9, but the base VM does not contain more versions. New minor versions will be out later in the week so that seems a better time to be rebuilding containers."
},
{
"commit": "39dddbb6bc7d296fe25a7210468b2f51ea6b1816",
"date": "2022-05-09 12:48:19 -0400",
"subject": "Add limited CI for ppc64le/s390x using emulation.",
"body": "The emulation is so slow that running all the unit tests would be too expensive, but this at least shows that the build works and some of the more complex tests run. In particular, it is good to test on one big-endian architecture to be sure that checksums are correct.\n\nUpdate checksums in the tests where they had gotten out of date since the last time we were testing on s390x. Also use a different test in command/archivePushTest to show the name of the file when a checksum does not match to aid in debugging.\n\nThe command/archive-push test was updated but not included because there is also a permissions issue, which looks to be the same as what we see on MacOS/FreedBSD. Hopefully we'll be able to fix all of those at the same time."
},
{
"commit": "eefa0b161a6a02b7843e18455443a4bce41cd4b9",
"date": "2022-05-09 11:59:08 -0400",
"subject": "Simplify messaging around supported versions in the documentation.",
"body": "The version ranges given in the user guides caused confusion. For example, because the user guide for RHEL specified PostgreSQL 9.6-11, users questioned whether pgBackRest worked for PostgreSQL 12 on RHEL.\r\n\r\nRemove these ranges and add more explanatory text to the introduction to try and make it clearer how the user guides work and which versions are covered (basically all of them)."
},
{
"commit": "ef4c4ab8525f81c9ed22c7e82ed12096e81703c5",
"date": "2022-05-09 10:39:43 -0400",
"subject": "Use variable instead of function to track FINALLY() state.",
"body": "The function worked fine, but Coverity was unable to determine that the finally block was run, which led to false positives about unfreed memory.\r\n\r\nUsing a boolean in the block makes it clear to Coverity that the finally block will always be run no matter what else happens.\r\n\r\nWe'll depend on the compiler to optimize away the boolean if it is not used in a finally block. The cost of the boolean is fairly low in comparison to everything else being done in these macros, so it does not seem worth having a separate block even if the compiler is not able to eliminate the boolean.\r\n\r\nThis reverts most of 9a271e9 that fixed a bug caused by c5b5b58, which was also attempting to help Coverity understand FINALLY() blocks."
},
{
"commit": "e8c40a24df14fcf281de672c19d0a55dc7cb50f6",
"date": "2022-05-09 09:56:19 -0400",
"subject": "Remove unnecessary TRY() block in common/regExp module.",
"body": "This code was written before MEM_CONTEXT_TEMP*() was available, which is a better solution."
},
{
"commit": "4d8c36715ddd67c11d1ab166dcd0b4850631d83d",
"date": "2022-05-06 19:44:46 -0400",
"subject": "Remove legacy Travis-CI configuration.",
"body": "Travis-CI is now strictly a paid service. Multiple attempts to use their \"free\" service have failed due to lack of community credit and general issues with their plugin.\n\nRemove the configuration so it does not appear we are testing on Travis-CI."
},
{
"commit": "46b7b7287446d0bb5ed0963fd01c51fb2b08893f",
"date": "2022-05-06 18:23:36 -0400",
"subject": "Add hint when unable to find the primary cluster.",
"body": "If all available clusters are in recovery, pgBackRest will not be able to find a primary for the backup."
},
{
"commit": "53bfdbc01ece396c802022fea2216d3b9d7beaa1",
"date": "2022-05-06 16:02:44 -0400",
"subject": "Remove useless test in config/parse unit test.",
"body": "Since the packSize field is 7 bits, it could never fail the check for > 127.\n\nThe compiler will catch any packs that are larger than 7 bits and then the pack size will need to be adjusted. For now just adjust the comment to reflect what the test does and give a clearer indication of what to do when a pack grows too large."
},
{
"commit": "77311a9af7870e79d7a3c9ecadc268c2364458c8",
"date": "2022-05-06 15:38:03 -0400",
"subject": "Fix indentation.",
"body": "gcc11 complains about this indentation being misleading."
},
{
"commit": "efbcd975c4c5b4c29c937154e2b1e221aa3ea156",
"date": "2022-05-06 13:56:58 -0400",
"subject": "Update Docker test image for Debian 9.",
"body": "A change invalidated the current image which has been causing the d9 test to run longer."
},
{
"commit": "68a410779ad92a91f6e8bfe504a9acd7fecd06f2",
"date": "2022-05-06 12:32:49 -0400",
"subject": "Add zNewFmt().",
"body": "This replaces strZ(strNewFmt()), making the code simpler and reducing indentation."
},
{
"commit": "475e7c692d7e54b9417de74cb566c2ccc7158997",
"date": "2022-05-06 12:11:04 -0400",
"subject": "Clean up dividers in the documentation.",
"body": "Dividers were used in some files, but not others, and some had section names (which are hard to maintain) and others did not.\n\nTry to make this more consistent by putting a divider on front of every section, variable block, and wherever else seems appropriate."
},
{
"commit": "356bc27bf200762148afb7b495b5a54efeea0159",
"date": "2022-05-06 11:41:28 -0400",
"subject": "Remove key dividers in help.xml.",
"body": "The idea was to make this file easier to browse and edit, but in fact it is much easier to just search for the command/option needed.\n\nThe dividers were never applied consistently and at some point we decided to get rid of the comments because they were hard to keep updated. The result was a mix of styles which did nobody any favors."
},
{
"commit": "65d22e43257d46ff6523ffbdb3af59e30deeaea5",
"date": "2022-05-06 11:11:36 -0400",
"subject": "Add verify output and verbose options.",
"body": "These options allow the user to control how the verify results will be output to the console and log."
},
{
"commit": "f405fc6ae281eebf4d61abb39963a9830fe2fa2f",
"date": "2022-05-06 10:21:20 -0400",
"subject": "Backup file bundling documentation.",
"body": "Make the feature user visible and add documentation to the user guide."
},
{
"commit": "4cc0d46d606382e6b00493e73ee401ecfe5b9f3e",
"date": "2022-05-06 09:34:39 -0400",
"subject": "Fix comment wrapping."
},
{
"commit": "e70c71049ec1ff3bf1f3e6a1987c82d9b95bce82",
"date": "2022-05-06 07:49:23 -0400",
"subject": "Use uint8_t for optionResolveOrder.",
"body": "This saves a bit of space and should not affect processing speed.\n\nOn MacOS (clang) this unexpectedly reduces the size of the binary by 16kiB but on Linux (gcc) there are no savings at all."
},
{
"commit": "808f7bf11c367a5be2130ea573c9447d8ea2dda8",
"date": "2022-05-05 20:14:13 -0400",
"subject": "Replace strNewFmt() with TEST_ERROR_FMT() in command/archive-push module.",
"body": "This test was likely written before TEST_ERROR_FMT() existed."
},
{
"commit": "efe0a39a75ed40f5568b1f5f566fee84d76fe094",
"date": "2022-05-05 20:01:02 -0400",
"subject": "Use TEST_ERROR_FMT() rather than strNewFmt() in common/lock module.",
"body": "These tests were likely written before TEST_ERROR_FMT() existed."
},
{
"commit": "5089a26633c965c4d9293d3de527a02b42d9b88d",
"date": "2022-05-05 18:35:00 -0400",
"subject": "Convert strNewFmt() to THROW_FMT() in config/parse module.",
"body": "It's not clear why strNewFmt() was used here, but there is no need for it."
},
{
"commit": "876f3bbd1cd46af7f7d3dc2e9d454b77d51fff80",
"date": "2022-05-05 18:15:05 -0400",
"subject": "Remove COLON_STR and separator parameter from cfgParseCommandRoleName().",
"body": "The separator parameter in cfgParseCommandRoleName() was useless since it was always set to : and COLON_STR did not provide any clarity its the single other usage."
},
{
"commit": "7ae5478d9840d8b64a1211466e49d2835853ee55",
"date": "2022-05-05 12:09:21 -0400",
"subject": "Remove most _Z constants.",
"body": "Most of the time these were not making the code any clearer.\n\nFor cases where they were used to construct Strings and Buffers, replace with constants.\n\nAlso cleanup unused Buffers and Strings."
},
{
"commit": "a6b1adb5fd533b4b9aca29646c8acf647d872959",
"date": "2022-05-05 11:15:14 -0400",
"subject": "Remove extraneous linefeed when writing a lock file.",
"body": "Linefeeds are no longer part of the lock file format."
},
{
"commit": "5f8c9cd66a1b39a47acaddfbc3cf443ae8057519",
"date": "2022-05-05 10:19:11 -0400",
"subject": "Add ClockError for unexpected clock skew and timezone changes.",
"body": "A distinct result code should help debugging of clock skew and timezone issues."
},
{
"commit": "b6bfd9f99d74b1f5e631cf6462b68342589d2b80",
"date": "2022-05-05 09:20:49 -0400",
"subject": "Strip extensions from history manifest before showing in error message.",
"body": "In cases where clock skew or timezone issues are preventing backup label generation the user could see an error like this:\r\n\r\nnew backup label '20220504-152308F' is not later than latest backup label '20220504-222042F_20220504-222141I.manifest.gz'\r\n\r\nThis will happen if the most recent label is drawn from the history. It is cleaner (and probably less confusing) to strip off the extensions so the user sees:\r\n\r\nnew backup label '20220504-152308F' is not later than latest backup label '20220504-222042F_20220504-222141I'"
},
{
"commit": "ef672c74adf871f17f6e14f5f0d6ab70e8fa3d52",
"date": "2022-05-04 14:53:05 -0400",
"subject": "Prevent memContextFree() from freeing memory needed by callbacks.",
"body": "The order of callbacks and frees meant that memory needed during a callback (for logging in all known cases) might end up being freed before a callback needed it.\r\n\r\nRequiring callbacks and logging to check the validity of their allocations is pretty risky and it is not clear that all possible cases have been accounted for.\r\n\r\nInstead recursively execute all the callbacks first and then come back and recursively free the context. This is safer and it removes the need to check if a context is freeing so a simple active flag (in debug builds) will do. The caller no longer needs this information at all so remove memContextFreeing() and objMemContextFreeing()."
},
{
"commit": "d9088b2e2b16a89d29b967187a547976f96061fc",
"date": "2022-05-04 12:52:05 -0400",
"subject": "Show backup percent complete in info output.",
"body": "In the JSON output the percent complete is storage as an integer of the percent complete * 100. So, before display it should be converted to double and divided by 100, or split using integer mod and div.\r\n\r\nNote that percent complete will only be displayed on the host where the backup was executed. Remote hosts will show a backup/expire running with no percent complete."
},
{
"commit": "20782c88bc8d0842d547bd5f4fecdb292e69d1f7",
"date": "2022-05-04 11:55:59 -0400",
"subject": "PostgreSQL 15 support.",
"body": "PostgreSQL 15 drops support for exclusive backup and renames the start/stop backup commands.\r\n\r\nThis is based on the pgdg-testing repo since beta1 has not been released yet, but it seems unlikely that breaking changes will be made at this point. beta1 should be tagged just before our next release so we'll retest before the release."
},
{
"commit": "8e849ae85d6ad0ecbd1f34649be4a664712fd40c",
"date": "2022-05-04 10:28:39 -0400",
"subject": "Add PRs to thread locking on Github actions.",
"body": "It also makes sense to lock old PRs. They can be manually unlocked if they are needed for some reason.\n\nAlso add output logging to make it easier to determine if thread locking is completing."
},
{
"commit": "09b387fccddb658ae93acc6ec8dc490155c4fdea",
"date": "2022-05-04 09:24:35 -0400",
"subject": "Move issue locking to Github actions.",
"body": "The old plugin has been defunct for some time so there are currently a lot of unlocked issues.\n\nRunning this once per week seems sufficient for now. Worst case it can be run manually if it gets behind."
},
{
"commit": "692fe496bdb5fa6dcffeb9f85b6188ceb1df707a",
"date": "2022-05-04 08:22:45 -0400",
"subject": "Remove dependency on pg_database.datlastsysoid.",
"body": "This column has been removed in PostgreSQL 15. Rather than add a lot of special handling, it seems better just to update all versions to not depend on this column.\r\n\r\nAdd centralized functions to identify the type of database (i.e. system or user) by name and use FirstNormalObjectId when a name is not available.\r\n\r\nThe new query in the db module will still return the prior result for PostgreSQL <= 15, which will be stored in the manifest. This is important to preserve behavior when downgrading pgBackRest. There are no concerns here for PostgreSQL 15 since older versions of pgBackRest won't be able to restore backups for PostgreSQL 15 anyway."
},
{
"commit": "302e0c09217a2c5c11145e84976b54677f7a544e",
"date": "2022-05-03 16:53:29 -0400",
"subject": "Remove extra linefeed."
},
{
"commit": "9a271e925c6239fbd3577f9827c34940e7e43ae4",
"date": "2022-05-03 14:34:05 -0400",
"subject": "Fix error thrown from FINALLY() causing an infinite loop.",
"body": "Any error thrown resets execution to the last setjmp(), which means that parts of the try block need to make sure they don't get run again. FINALLY() was not doing this so if it threw an error it would end up back in the FINALLY() block, where the error would likely be thrown again, causing an infinite loop.\r\n\r\nFix this by tracking the state of FINALLY() and only running it once. This requires cleaning the error stack like CATCH*() and clearing the error like TRY_END() depending on the order of execution."
},
{
"commit": "b89c568b5fefd1ea0e8319402bab0f4fba6bfa2e",
"date": "2022-05-03 10:50:48 -0400",
"subject": "Fix obsolete variable naming."
},
{
"commit": "962990869454b15db058f4037dbc0b1b611fc95e",
"date": "2022-05-03 10:13:32 -0400",
"subject": "Error on all lock failures except another process holding the lock.",
"body": "The archive-get/archive-push commands would not error for, .e.g permissions errors, when attempting to get a lock before launching the async process. Since the async process was not launched there would be no error status file and the user would get a generic failure message. Also, there would be no async log.\r\n\r\nRefactor lockAcquireFile() to throw an error when failOnNoLock = false unless the file is locked by another process. This seems to be the original intent of this parameter and there may have been a mistake when porting from Perl. In any case it looks wrong enough to be considered a bug."
},
{
"commit": "eb435becb3e4d3dd8ea01b0e8899654a268d3867",
"date": "2022-05-02 15:17:34 -0400",
"subject": "Exclude mem context name from production builds.",
"body": "The mem context name is used to produce clearer debug errors but it has no purpose in production builds.\n\nAlso remove memContextName() and access the struct directly since the name is only used within the common/memContext module.\n\nNote that a few errors that were thrown in production builds (and required the name) are now only thrown in debug builds. In practice we have not seen these errors in production builds due to extensive coverage so it does not seem worth modifying the error to work without the context name.\n\nThis saves some memory, which is worthwhile, but the goal is to refactor Strings and Variants to have their own mem contexts and this change will prevent them from using more memory than they are now, along with other changes that will be coming later."
},
{
"commit": "0055fa40fee2636fed88699f52e9e67cd2803f71",
"date": "2022-05-02 09:45:57 -0400",
"subject": "Add user:group to lock permission error.",
"body": "This will help debug permissions errors when the lock file cannot be created."
},
{
"commit": "03c71aa606bc0dc89303b3907e7fcbd83ace79d6",
"date": "2022-05-02 08:49:13 -0400",
"subject": "Add hint to check the log on archive-get/archive-push async error.",
"body": "If this error is thrown rather than a specific error returned from the async process, it means the async process is unable to write the status files for some reason and the only way to get the error is out of the async log.\n\nThis hint includes the exact async log path and name to make finding errors easier."
},
{
"commit": "126fc99c77998cc65094d92e955347100aa42531",
"date": "2022-04-28 14:10:53 -0400",
"subject": "Fix leaks in common/json, common/keyValue, and common/variantList.",
"body": "This doesn't solve the problem of the variant code making far too many copies, but it at least plugs the leaks.\n\njsonReadVarRecurse() could leak KeyValue and VariantList.\n\nkvDup() leaked object allocations into the calling context.\n\nkvDefault() gets a more efficient return structure.\n\nkvGetList() leaked a Variant into the calling context.\n\nvarLstNewStrLst() leaked object allocations into the calling context. Update varLstDup() to reflect changes made in varLstNewStrLst()."
},
{
"commit": "96166539cf7df010f9077cd624f24fd77e5a4feb",
"date": "2022-04-28 13:33:03 -0400",
"subject": "Fix leaked String in cfgParseSize()."
},
{
"commit": "4872a3f121e71f79a29dd63acad34b7c3537c775",
"date": "2022-04-28 12:33:39 -0400",
"subject": "Improvements to test harness memory debugging.",
"body": "Only set -DDEBUG_MEM for the modules currently being tested rather than globally.\n\nAlso run tests in a temp mem context. Running in the top context can confuse memory accounting when a new context is created in the top context."
},
{
"commit": "90f939b36f8963272cdfe8d0ed5a50606990ff5e",
"date": "2022-04-28 12:31:59 -0400",
"subject": "Fix leaks in common/io unit test.",
"body": "These leaks make it harder to detect leaks in the core code, so fix them."
},
{
"commit": "8047e97e31fb133551ad69c7fd170a8a96d188d6",
"date": "2022-04-28 12:17:33 -0400",
"subject": "Fix leaked String and Variant in harnessPqScriptRun()."
},
{
"commit": "ceb303f9e2f47d9818919dfd0127e558f2d83495",
"date": "2022-04-28 11:46:55 -0400",
"subject": "Fix comment typo."
},
{
"commit": "c463993b4cc96a92c61af298bc95d88129068902",
"date": "2022-04-28 11:41:16 -0400",
"subject": "Fix leaks in the storage/s3 module.",
"body": "storageS3Helper() leaked a few Strings which ended up in a long-lived context.\n\nstorageS3AuthAuto() and storageS3AuthWebId() were cleaned up by their callers but since they are not called often a temp mem context seems better.\n\nstorageS3Request() leaked an HttpRequest.\n\nstorageS3Info() leaked an HttpResponse.\n\nstorageS3PathRemoveInternal() leaked a variety of objects. Fix by freeing some of them and adding a temp mem context.\n\nstorageS3Remove() leaked an HttpResponse object.\n\nstorageWriteS3Part() leaked an HttpResponse object."
},
{
"commit": "4750bc94dd8279b166233463ff32f2f51fb67e18",
"date": "2022-04-28 11:20:31 -0400",
"subject": "Fix leaks in the storage/remote module.",
"body": "storageRemoteFilterGroup() leaked a number of objects. Use a temp mem context to prevent that.\n\nstorageRemoteProtocolInfoListCallback() leaked a PackWrite.\n\nstorageWriteRemoteFreeResource() leaked a PackWrite."
},
{
"commit": "c123a6af9f5aee4baea1d9ab202e03df6de319e3",
"date": "2022-04-28 11:19:01 -0400",
"subject": "Fix leaks in the storage/posix module.",
"body": "storagePosixPathCreate() leaked a String.\n\nstoragePosixPathRemoveCallback() leaked a String."
},
{
"commit": "d89bc6f2d241ae864cb9dcae2f5c6fc3a0e655ee",
"date": "2022-04-28 10:53:11 -0400",
"subject": "Fix leaks in the storage/gcs module.",
"body": "storageGcsAuthToken() memory was being cleaned up by the calling context, but seems better to keep this tidy and add a temp mem context.\n\nstorageGcsRequest() leaked an HttpRequest.\n\nstorageGcsInfo() leaked a number of objects. Use a temp mem context to prevent that.\n\nstorageGcsPathRemoveCallback() leaked an HttpResponse.\n\nstorageGcsRemove() leaked an HttpReponse.\n\nstorageWriteGcsVerify() leaked a number of objects. Use a temp mem context to prevent that.\n\nstorageWriteGcsBlock) leaked an HttpReponse."
},
{
"commit": "083c93eaa3d54d4594048b37542276fc6f6665fb",
"date": "2022-04-28 10:11:15 -0400",
"subject": "Reuse Strings in iniLoad().",
"body": "Reuse the section/key/value Strings by truncating them instead of creating a new one every time.\n\nAlso add an error for empty sections. This function is only used for loading info files (not config files), which should never contain an empty section."
},
{
"commit": "bc46d4e37b8c324d30543147eaeb8058184d3543",
"date": "2022-04-28 09:50:23 -0400",
"subject": "Add cvtZSubNTo*() functions.",
"body": "These functions allow conversion from substrings without needing to create a String or a temporary buffer.\n\nhttpDateToTime() no longer requires a temp mem context. Also improve handling of month search to avoid an allocation.\n\nhttpUriDecode() no longer requires a temp mem context.\n\njsonReadStr() no longer requires a temp mem context.\n\npgLsnFromWalSegment() no longer requires a temp mem context.\n\npgVersionFromStr() no longer requires a temp mem context. Also do a bit of refactoring.\n\nstorageGcsCvtTime() no longer leaks six Strings per call.\n\nstorageS3CvtTime() no longer leaks six Strings per call."
},
{
"commit": "6e18235be8b56eaedd940d7382e09e52ba22ffe9",
"date": "2022-04-28 06:52:07 -0400",
"subject": "Fix leak in varLstNewStrLst().",
"body": "The duplicated list elements were leaked into the calling context."
},
{
"commit": "aeb7568a0ffeba72f254e46d2aa5d7bcca7c9a19",
"date": "2022-04-28 06:48:02 -0400",
"subject": "Remove unused header."
},
{
"commit": "5285b9aa7bdda8c160adde2b7d64e217fd2be123",
"date": "2022-04-27 20:18:18 -0400",
"subject": "Fix incorrect test param."
},
{
"commit": "eb65a5674dfa84d6b516490ef8796d44934bb0ef",
"date": "2022-04-27 11:40:29 -0400",
"subject": "Use OBJ_NEW*() macros in SocketServer object.",
"body": "This was missed in ccc255d3 when the TLS server was introduced, probably because work on that commit preceded when the macros were introduced in 475b57c8. It would have been easy to miss in a merge."
},
{
"commit": "6f2654a5eb0e2cb63a4ff3af187f991817189dca",
"date": "2022-04-26 12:53:55 -0400",
"subject": "Fix leaks in the storage/azure module.",
"body": "storageAzureHelper() leaked a few Strings which ended up in a long-lived context.\n\nstorageAzureNew() failed to make a copy of the endpoint. This worked because storageAzureHelper() leaked the endpoint into the long-lived parent context.\n\nstorageAzureRequest() leaked an HttpRequest.\n\nstorageAzureInfo() leaked an HttpResponse.\n\nstorageAzurePathRemoveCallback() leaked an HttpResponse.\n\nstorageAzureRemove() leaked an HttpResponse."
},
{
"commit": "be120c746c403b878b6bc7df83b4ffbf6e513f72",
"date": "2022-04-26 12:27:51 -0400",
"subject": "Refactor and fix leak in storageRepoPathExpression().",
"body": "storageRepoPathExpression() could leak a StringList. Also refactor to remove unneeded assignments and create the String one time."
},
{
"commit": "cca6df872a7861de18f7e69e1df5183acd504681",
"date": "2022-04-26 12:09:44 -0400",
"subject": "Refactor functions in postgres/interface module and fix leak.",
"body": "pgLsnFromWalSegment() leaked two Strings.\n\nRefactor pgLsnRangeToWalSegmentList() to create the StringList in the calling context rather than moving it later."
},
{
"commit": "a56fa0eb45871dff8b6362d9298290a52c7e6cd9",
"date": "2022-04-26 11:59:21 -0400",
"subject": "Fix leaks in protocol module.",
"body": "These leaks were not a big deal individually and there are generally few protocol objects created, but the leaks ended up in mem contexts that persist for most of execution. It makes sense to keep long-lived contexts as tidy as possible."
},
{
"commit": "78e912a9320770122808384ae202b89fa6236e89",
"date": "2022-04-26 11:20:51 -0400",
"subject": "Fix leaks in info module.",
"body": "*LoadFileCallback() all leaked between retries.\n\ninfoPgArchiveId() leaked a String."
},
{
"commit": "36b0a9fa58f4f248fdabf170235f9f624d828d56",
"date": "2022-04-26 11:07:05 -0400",
"subject": "Fix leaks in db module.",
"body": "dbFreeResource() leaked ProtocolCommand.\n\ndbTimeMSec() leaked PackRead."
},
{
"commit": "78b90e5ad80f87e0c1167701ac40504dc888d0dd",
"date": "2022-04-26 11:03:06 -0400",
"subject": "Fix leak in configOptionRemote().",
"body": "A Pack and String were leaked."
},
{
"commit": "9a6df398393c116c73dbbf459073271d84c45bec",
"date": "2022-04-26 11:00:20 -0400",
"subject": "Fix spacing."
},
{
"commit": "8efb4e1e7f8d806f4688c54052f2325c21f470a9",
"date": "2022-04-26 10:58:12 -0400",
"subject": "Fix leak in cfgCommandJobRetry().",
"body": "A Variant was leaked for each retry record.\n\nAlso remove an extra linefeed."
},
{
"commit": "a8fed52ecb653229298682280b179fdf92438cdb",
"date": "2022-04-26 10:53:13 -0400",
"subject": "Fix leak in pckReadStrLst().",
"body": "A String would be leaked on each loop iteration."
},
{
"commit": "d7e45f12a54ea186e66824b9127478eaa1355d32",
"date": "2022-04-26 10:49:04 -0400",
"subject": "Refactor httpRequestNew().",
"body": "Move httpRequestProcess() outside of the object mem context. In case it ever returns a value we don't want that to end up in the object context."
},
{
"commit": "cd1cf337ff8011f01657ab1baca31927d5d2343d",
"date": "2022-04-26 10:45:30 -0400",
"subject": "Fix leak in httpHeaderPutRange().",
"body": "The range string was leaked."
},
{
"commit": "07e280199723eef35563ec71ff0c20687d642d9b",
"date": "2022-04-26 10:39:28 -0400",
"subject": "Fix leak in ioFilterGroupResultAllSet().",
"body": "The PackRead containing the filter results was leaked."
},
{
"commit": "3310decf8e4b09293e3f6b7de7e0212323ad0c81",
"date": "2022-04-26 10:36:27 -0400",
"subject": "Add missing FUNCTION_TEST*() macros."
},
{
"commit": "7eed9730aa8af91999e542394d05ef53c1cc7e36",
"date": "2022-04-26 10:34:10 -0400",
"subject": "Fix leak in cipherBlockNew().",
"body": "The string used to look up the cipher type was leaked."
},
{
"commit": "6eed4125e6297bc6e80c9c11f839ba65979293ee",
"date": "2022-04-26 10:29:48 -0400",
"subject": "Improved memory management in the common/exit module.",
"body": "Refactor so that error detail is only logged in one place. This reduces calls to exitErrorDetail() and LOG_INTERNAL_FMT().\n\nFix minor leaks in exitErrorDetail() and exitSafe()."
},
{
"commit": "fa6c68cb029e675d9f4b3e4fa48862b6644ecc78",
"date": "2022-04-26 10:18:24 -0400",
"subject": "Mem allocation cleanup in command/verify module.",
"body": "Move the temp mem context out of verifyJobCallback() into verifyBackup() and verifyArchive(). This makes it clearer that verifyJobCallback() allocates no memory and reduces mem usage when both verifyBackup() and verifyArchive() are called.\n\nUpdate verifyErrorMsg() to return zero-terminated strings to save on allocations. The output of this function is used when formatting strings so this is also simpler. Do a similar thing in verifyRender().\n\nAlso fix a minor leak in verifyInfoFile()."
},
{
"commit": "3f7c8bc9230acaf2dfb0a013303559b54a54c26f",
"date": "2022-04-26 10:15:47 -0400",
"subject": "Fix object allocations in incorrect mem context in execOpen().",
"body": "Object variables were begin allocated in the calling context rather than the object context.\n\nThis is not a live bug because Exec objects are currently created and opened in a long-lived context."
},
{
"commit": "4dbe76a5bb6e5aae779b2538ac9ce54782f46b8f",
"date": "2022-04-26 07:33:57 -0400",
"subject": "Fix comment formatting."
},
{
"commit": "41f9d69edcf671fbda21cb6d87dbca08e48e9976",
"date": "2022-04-25 15:38:49 -0400",
"subject": "Combine functions in the command/stanza module into one function.",
"body": "It is not clear why these were split out, but it probably had something to do with testing before storageList() could return NULL for an empty directory.\n\nAlso remove the tests that depended on a boolean return, which are no longer needed for coverage."
},
{
"commit": "55a828f999f6fc8a975ea5c2ea9710e2109a5c0a",
"date": "2022-04-25 15:03:37 -0400",
"subject": "Add temporary mem contexts and fix a leak in the command/restore module.",
"body": "restoreRecoveryConf() and restoreRecoveryWriteConf() do enough work to deserve their own memory contexts.\n\nrestoreFilePgPath() was leaking a String every time it was called, which could be a lot.\n\nAlso fix a spacing issue."
},
{
"commit": "4e7414d48fb3cca45ca66b3eb853a08b6daf2833",
"date": "2022-04-25 14:49:08 -0400",
"subject": "Add temporary mem contexts in the command/help module.",
"body": "These were not really leaks since memory was being freed by the calling function, but these functions do enough work to deserve their own memory contexts."
},
{
"commit": "fd295f002b720dc1acc5d9523bd442f372394d15",
"date": "2022-04-25 14:19:10 -0400",
"subject": "Add temporary mem context to removeExpiredBackup().",
"body": "This was not really a leak since memory was being freed by the calling function, but this function does enough work to deserve its own memory context.\n\nAlso fixed a doubled semicolon."
},
{
"commit": "9314be36b161da8128cc4149372f41b89087e844",
"date": "2022-04-25 14:14:29 -0400",
"subject": "Improve result declaration in backupRegExp().",
"body": "No need to set this to NULL when the initial value can be used instead."
},
{
"commit": "5b5dbe0e7e4d3b3f412ea869487c3018c7a8d67c",
"date": "2022-04-25 13:29:43 -0400",
"subject": "Fix memory leaks in archivePushDrop().",
"body": "A string was leaked for every file processed.\n\nSince the list can be quite large it also makes sense to reset the context occasionally."
},
{
"commit": "c3b08f71ce03e2b4103f12e1d7c5c05701f02ef3",
"date": "2022-04-25 13:26:09 -0400",
"subject": "Fix formatting in common/string module."
},
{
"commit": "40ef64f2be60fb947cf68aae2bb7d510ab36c8ec",
"date": "2022-04-25 12:59:46 -0400",
"subject": "Fix memory leaks in archivePushFile().",
"body": "The errorList is only used when throwing an error and the joined list is not needed after the error is thrown, so put both in the temp mem context."
},
{
"commit": "774db650868c86c791f2791d02bee129a7669be5",
"date": "2022-04-25 12:55:51 -0400",
"subject": "Remove useless context switches in archiveGetFile()/archivePushFile().",
"body": "These context switches do nothing since the list is already in the prior context."
},
{
"commit": "582c3dab4cff6883150c9c5de7f7b41d12982da9",
"date": "2022-04-25 12:32:33 -0400",
"subject": "Add strLstAddSub*() and strLstAddSubZ*() functions.",
"body": "These help with readability and remove a cause of leaks."
},
{
"commit": "ff45f463cf4d4521df5fd69b48bd553d862f0dc1",
"date": "2022-04-25 11:58:30 -0400",
"subject": "Use strLstAddZ() instead of strLstAdd() where possible.",
"body": "Using STRDEF() to convert the zero-terminated string to a String has no performance advantage but generates more code."
},
{
"commit": "7900660d3a12573db8a68bc7df46d7552dae54d1",
"date": "2022-04-25 11:47:43 -0400",
"subject": "Add strLstNewFmt().",
"body": "Simplifies adding a formatted string to a list and removes a common cause of leaks."
},
{
"commit": "3475514b61fec52a5bd9e7fa73d38d5be612a9ad",
"date": "2022-04-25 10:57:36 -0400",
"subject": "Fix memory leak in archiveAsyncErrorClear().",
"body": "A string was leaked on each call."
},
{
"commit": "23d645b5e7f1069296f1a51165412049e1dccbdc",
"date": "2022-04-25 10:52:13 -0400",
"subject": "Fix outdated comment."
},
{
"commit": "699f15dd2b227ad13ba313fa549c32938bd6cf2b",
"date": "2022-04-25 09:24:00 -0400",
"subject": "Remove THIS_MEM_CONTEXT() macro.",
"body": "objMemContext(this) performs the same task and is easier to read.\n\nMost instances of this macro were removed by 6e7be3c0."
},
{
"commit": "6e7be3c0525782cb58e0eb5046f1385e4eb8b1df",
"date": "2022-04-25 09:12:25 -0400",
"subject": "Add MEM_CONTEXT_OBJ_*() macros.",
"body": "These provide a standard way to switch to an object mem context.\n\nUpdate the two different patterns that were used before to the new macros."
},
{
"commit": "45c3f4d53c7e5198d4d49109398326fecd282bec",
"date": "2022-04-25 09:06:26 -0400",
"subject": "Improve JSON handling.",
"body": "Previously read/writing JSON required parsing/render via a variant, which add many more memory allocations and loops.\r\n\r\nInstead allow JSON to be read/written serially to improve performance and simplify the code. This also allows us to get rid of many String and Variant constant which are no longer required.\r\n\r\nThe goal is to be able to read/write very large (e.g. gigabyte manifest) JSON structures, which would not be practical with the current code.\r\n\r\nNote that external JSON (GCS, S3, etc) is still handled using variants. Converting these will require more consideration about key ordering since it cannot be guaranteed as in our own formats."
},
{
"commit": "58f24568f5bf578e8ad0f5e4866bf2ede8b45d46",
"date": "2022-04-25 08:25:48 -0400",
"subject": "Add ASSERT_PARAM() macro.",
"body": "Allows adding a parameter to a function that is used only for assertions."
},
{
"commit": "1e2b545ba47d66760cf4c6df65c6325bb6404bb2",
"date": "2022-04-24 19:19:46 -0400",
"subject": "Require type for FUNCTION_TEST_RETURN*() macros.",
"body": "This allows code to run after the return type has been generated in the case where it is an expression.\n\nNo new functionality here yet, but this will be used by a future commit that audits memory usage."
},
{
"commit": "91bbe810592c8b57079230d0bf15720d74c705fa",
"date": "2022-04-22 09:14:12 -0400",
"subject": "Add SIZE_OF_STRUCT_MEMBER() macro.",
"body": "Gets the size of a struct member, which requires a bit of additional syntax."
},
{
"commit": "a2eee156b5a85237d9b9ba7896b237ec4f216da0",
"date": "2022-04-21 18:23:17 -0400",
"subject": "Fix instances where STRDEF() was used instead of STR().",
"body": "In practice this didn't cause problems because the string buffer was still valid and strSize() was not being called."
},
{
"commit": "627921c72ab53a88519902c17450cedfa9dbda7a",
"date": "2022-04-21 08:35:31 -0400",
"subject": "Add STR_SIZE() macro.",
"body": "This allows efficiently creating strings where the length is already known and simplifies the STR() and STRDEF() macros."
},
{
"commit": "1ce613a24d4de1c219d2b7d844cf7e88649887fc",
"date": "2022-04-21 08:34:03 -0400",
"subject": "Use STRDEF() instead of STR() in command/help module.",
"body": "STRDEF() is more efficient since this is a constant string."
},
{
"commit": "4daddebaca6b4b1861778bc2b09d265302c05ed1",
"date": "2022-04-21 08:07:22 -0400",
"subject": "Add ASSERT_DECLARE() macro.",
"body": "Declare variables that will be used by later assertions with the goal of making them easier to read and maintain.\n\nThis is particularly useful for variables that are used more than once and require a lot of syntax to extract."
},
{
"commit": "e18b70bf555de24ba38d7c51f9d0ffbe8a02a355",
"date": "2022-04-21 07:45:59 -0400",
"subject": "Allow *RETURN*() macros to accept struct initializers.",
"body": "Struct initializers look like multiple parameters in a macro so use __VA_ARGS__ to reconstruct them."
},
{
"commit": "ea4d73f375558c237fce696f20c19d1efef00bc1",
"date": "2022-04-20 19:56:26 -0400",
"subject": "Fix ordering of backup-lsn-stop field in command/restore unit test.",
"body": "All fields should be alphabetical. Currently the read code is tolerant of this, but that will not always be the case.\n\nFields are always written alphabetically so this is just a test issue introduced by d8d41321."
},
{
"commit": "cb7a5f1ef3bbfe0a26e3cd718d9635280f2e9b83",
"date": "2022-04-20 19:49:23 -0400",
"subject": "Add JSON error when value does not parse in Ini object.",
"body": "If the JSON value fails to parse it is helpful to have the error message, at least for debugging."
},
{
"commit": "da6b4abc58674902196fe549586c16094dc37e38",
"date": "2022-04-20 19:41:28 -0400",
"subject": "Handle missing archive start/stop in info/info backup unit test.",
"body": "This is not a very realistic case since archive start/stop are always written, but it appears in many other unit tests so it should also be tested here."
},
{
"commit": "d897bf1ec2c74e46c56c31c6ba2ca910394ce0e5",
"date": "2022-04-20 19:36:33 -0400",
"subject": "Add size to info/manifest unit test.",
"body": "This prevents the check from being order dependent."
},
{
"commit": "d6f466be2bd1b68d45f109f0332783b784838ab7",
"date": "2022-04-20 19:31:35 -0400",
"subject": "Remove unnecessary mem contexts in the Manifest object.",
"body": "The correct context is set by the various *Add() functions so these are not needed and cause leaks, though the leaks will only be noticeable in cases where there are a lot of page checksum errors."
},
{
"commit": "da9f2618528e9bd4b5538ff81cc359172a36af7b",
"date": "2022-04-20 14:09:49 -0400",
"subject": "Add FUNCTION_TEST_NO_RETURN() macro.",
"body": "This is required for the (currently) single place where a function with test FUNCTION_TEST*() macros does not return.\n\nThis allows return to be added to the FUNCTION_TEST_RETURN_VOID() macro, which means return no longer needs to be added when returning from a function early."
},
{
"commit": "c304fafd456f67d11b0e9e7a8f399732716cf216",
"date": "2022-04-20 08:36:53 -0400",
"subject": "Refactor PgClient to return results in Pack format.",
"body": "Packs support stronger typing than JSON and are more efficient. For the small result sets that we deal with efficiency is probably not very important, but this removes another place where we are using JSON instead of Pack.\r\n\r\nPush checking for result struct (e.g. single row) down into PgClient since it has easy access to this information rather than needing to parse the result set to find out.\r\n\r\nRefactor all code downstream that depends on PgClient results."
},
{
"commit": "e699402f99f70819bd922eb6150fbe1b837eca0d",
"date": "2022-04-19 18:07:11 -0400",
"subject": "Remove extra linefeed."
},
{
"commit": "b7fccaf9949f15ea1a00abd434e765c9c4d3e2f1",
"date": "2022-04-18 14:08:53 -0400",
"subject": "Refactor remote storage protocol to use Packs instead of JSON.",
"body": "Packs are more efficient and strongly typed so they make more sense for the protocol."
},
{
"commit": "cfd6c7ceb490d8c2766fd91a4719bdf9f6e4f110",
"date": "2022-04-18 12:14:22 -0400",
"subject": "Use specific integer types in postgres/client and db unit tests.",
"body": "This will work better once we are able to transmit the results with stronger typing.\n\nAlso remove int2 which was not being used."
},
{
"commit": "9751ddc4f80928de4b42bc56c54731afa4ff16aa",
"date": "2022-04-18 11:53:31 -0400",
"subject": "Update postgres/client unit test to conform to current patterns.",
"body": "This includes adding test titles and using constants for query and error values that repeat."
},
{
"commit": "bc5f6fac34fefd0595eee87f250dc9abef06d191",
"date": "2022-04-18 10:47:44 -0400",
"subject": "Update postgres/client unit test for changes in libpq.",
"body": "There have been some behavioral changes in libpq which require changes to the test.\n\nAlso update the instructions since it is now a bit easier to run against a real cluster."
},
{
"commit": "214ee9eb0e8398b1871a53441f4b926eb194d765",
"date": "2022-04-17 09:41:22 -0400",
"subject": "Fix URL for apt.p.o archives.",
"body": "A new archive repo was created in March of 2020: https://www.df7cb.de/blog/2020/apt-archive.postgresql.org.html"
},
{
"commit": "d103dd6238dffb5ddc3d5366c674278a67426f25",
"date": "2022-04-14 20:34:42 -0400",
"subject": "Return stats as a JSON string rather than a KeyValue object.",
"body": "There is no need to process the stats so a KeyValue is overkill.\n\nAlso remove the performance tests that check the stat totals since this is covered in the unit tests."
},
{
"commit": "e1ce731f8ae5d1aea009bc369fd157cddb44e059",
"date": "2022-04-14 19:37:03 -0400",
"subject": "Add test for protocol greeting when a field is missing.",
"body": "A missing field and a NULL field are not exactly the same so it seems best to test both.\n\nBecause of the way KeyValue objects work the error is the same, but that will not always be true."
},
{
"commit": "8a29d56f3cbf37166f3722ac7ffe18841e9e57f3",
"date": "2022-04-14 19:18:00 -0400",
"subject": "Update comment in pack module to cover a more common use case.",
"body": "The KeyValue object is actively being removed so this is no longer the best example.\n\nInstead use an example that should outlive the KeyValue object."
},
{
"commit": "aeecd07ad87fafb34087f0df9d7c7413f749194c",
"date": "2022-04-14 18:29:54 -0400",
"subject": "Fix reported error line number when ini key length is zero.",
"body": "The line number was one less than it should have been, which could cause some confusion.\n\nSince this only affected ini files with JSON values, which are always written programmatically, there is almost zero chance this has ever been a problem in the field."
},
{
"commit": "47f8e11889ab8c05e1e548c07e6a338b69745c86",
"date": "2022-04-14 08:13:39 -0400",
"subject": "Update FreeBSD and MacOS images for Cirrus CI.",
"body": "This fixes fe1ac210. Apparently FreeBSD 12.2 went EOL and the image was immediately broken.\n\nAlso add FreeBSD 13.0 and update MacOS to Monterey."
},
{
"commit": "bcbac8a067e84a48e0849c5336f21044fec89df5",
"date": "2022-04-11 17:54:18 -0400",
"subject": "Add static keywords.",
"body": "This is more efficient than pushing these variables onto the stack."
},
{
"commit": "fa40bcdc5cf9e6fc6f46236df258d3fa536ccdc7",
"date": "2022-04-11 14:08:16 -0400",
"subject": "Throw error when unable to read lock process.",
"body": "Previously the process id was skipped if it did not exist. Instead, throw an error and handle the errors in downstream code.\r\n\r\nThis was probably ignored at some point to provide backward-compatibility, but that is no longer required, if it ever was."
},
{
"commit": "fe1ac210bba9439d9a4baa4adbadd1413c61e2f5",
"date": "2022-04-11 13:17:54 -0400",
"subject": "Disable FreeBSD builds on Cirrus CI.",
"body": "This build has started breaking with the following error:\n\ncd .. && perl ${CIRRUS_WORKING_DIR}/test/test.pl --no-gen --make-cmd=gmake --vm=none --vm-max=2 --no-coverage --no-valgrind --module=command --test=backup\n2022-04-11 17:11:53.034 P00 INFO: test begin on amd64 - log level info\n2022-04-11 17:11:53.107 P00 INFO: configure build\nld-elf.so.1: /usr/local/lib/perl5/5.32/mach/CORE/libperl.so.5.32: Undefined symbol \"strerror_l@FBSD_1.6\"\n\nDisable the build to unstick the pipeline until this can be fixed."
},
{
"commit": "15021a0e976c1a8eadebf642dfff293df0fed54a",
"date": "2022-04-09 18:29:57 -0400",
"subject": "Fix whitespace."
},
{
"commit": "79b204166394295e40e7ceddc359368c5770db26",
"date": "2022-04-08 15:55:41 -0400",
"subject": "Add lockRead*() functions for reading locks from another process.",
"body": "Sometimes we need to read a lock from another process. This was done two different ways and in the case of cmdStop() was definitely hacky.\r\n\r\nCentralize the logic to make it easier to read the locks for another process. This will also make it easier to add new lock data."
},
{
"commit": "aad7171940afdb221a03825bee6eb2f1827289f1",
"date": "2022-04-08 15:00:20 -0400",
"subject": "Suppress existing WAL warning when archive-mode-check is disabled.",
"body": "When archive-mode-check is disabled and archive-push is running from multiple hosts, it is very likely that the file will already exist with the same checksum, so disable the warning.\r\n\r\nHowever, if the checksums do not match, an error will still be thrown."
},
{
"commit": "4f543a4d67e0c18c8eccdd864a32003d45df7426",
"date": "2022-04-08 11:07:26 -0400",
"subject": "Handle NULL path in TEST_STORAGE_LIST when remove is specified.",
"body": "Using the path variable directly resulted in a path with (null) in it, which caused the remove to fail.\n\nThe pathFull variable already exists for this purpose so use it."
},
{
"commit": "571dceefec5c64da2b2d79dd7e471fe0262b916a",
"date": "2022-04-07 19:00:15 -0400",
"subject": "Add LENGTH_OF() macro.",
"body": "Determining the length of arrays that could be calculated at compile time was a bit piecemeal, with special macros used sometimes and with the math done directly other times.\n\nThis macro makes the task easier, uses less space, and automatically adjusts when the type changes."
},
{
"commit": "8be11d32e43bc889c4889b28f88fe20a0c4cfd60",
"date": "2022-04-07 11:44:45 -0400",
"subject": "Replace strCatFmt() with strCat()/strCatZ() where appropriate.",
"body": "Most of these looked like copy/paste from a prior required strCatFmt() call.\n\nThere is no issue here since strCatFmt() works the same in these cases, but using strCat()/strCatZ() is more efficient."
},
{
"commit": "cff147a7d257e270df8fee184fdc3684347be330",
"date": "2022-04-06 14:45:51 -0400",
"subject": "Add default for boolean options with unresolved dependencies.",
"body": "If a boolean option had an unresolved dependency then the value would be NULL, which meant the dependency would need to be checked in the code to avoid an error. For example, cfgOptionBool(cfgOptOnline) needed to be checked before it was safe to call cfgOptionBool(cfgOptArchiveCheck).\r\n\r\nAllow a default for boolean options when they are unresolved to simplify the code. This makes using the options easier and less prone to error. Not all boolean options get a dependency default in this commit, but more may be added in the future."
},
{
"commit": "acc9f3b72a481f64f5362d862959f300eb2aa63b",
"date": "2022-04-06 10:04:08 -0400",
"subject": "Move cfgParseOptionalFilterDepend() and add comment block."
},
{
"commit": "5dba0d6e9b9129c3cb7f3a4bc46da57544f36e73",
"date": "2022-04-05 18:42:19 -0400",
"subject": "Set option-archive-copy flag in backup.manifest to false when offline.",
"body": "In offline mode the pg_wal directory is copied, but that is not the same as archive-copy, which copies the exact set of WAL required from the archive.\n\nThis flag is purely for informational purposes so there is no live bug here, but the prior behavior was certainly misleading."
},
{
"commit": "54b4187527287bf3dd8ae158329f0feb44eebed8",
"date": "2022-04-05 13:14:42 -0400",
"subject": "Show Docker output when building containers if --log-level=detail.",
"body": "This helps with debugging and monitoring container builds."
},
{
"commit": "d8d4132118edd7f93a5b221478c85c2d213c39dd",
"date": "2022-04-05 11:59:12 -0400",
"subject": "Auto-select backup for restore command --type=lsn.",
"body": "For PITR with --type=lsn, attempt to auto-select the appropriate backup set based on the --target LSN provided. Pick the most recent backup where backup-lsn-stop is less than or equal to the provided LSN."
},
{
"commit": "08d9e269c6f03e7797584e90c53eb0743b787f60",
"date": "2022-04-05 09:14:56 -0400",
"subject": "Refactor target type checking for clarity in restore module.",
"body": "This avoids using targetTime != 0 as an indicator that a time target was selected."
},
{
"commit": "f5fdab2989140630a62a4ef0d4c7fc35d789f967",
"date": "2022-03-31 17:09:50 +0200",
"subject": "Fix typo in db-timeout help."
},
{
"commit": "c222ce1a5f6f813188b7e87a3838d6dce656e0ff",
"date": "2022-03-25 08:52:41 -0600",
"subject": "Fix tls-server-auth example and add clarifications."
},
{
"commit": "d4954fcbf49790475d26c90e951ac76660cef1e9",
"date": "2022-03-25 07:52:16 -0600",
"subject": "Fix comment typo."
},
{
"commit": "f60ec5055a633308422797902e9487085c862850",
"date": "2022-03-24 18:43:43 -0600",
"subject": "Cleanup output to stderr in unit tests.",
"body": "The unit tests were ignoring stderr but nothing being output there was important. Now a test will fail if there is anything on stderr.\n\nThis makes it easier to work with -fsanitize, which outputs to stderr."
},
{
"commit": "50ee4b19fec0b6bc888e4ff6603166365ce88233",
"date": "2022-03-24 17:55:38 -0600",
"subject": "Align checksum page error list in manifest file packs.",
"body": "This was left unaligned on purpose to save space but the sanitizer did not like it. Since this field is seldom used go ahead and align it to make the sanitizer happy.\n\nAlso add some macros to make working with alignment easier.\n\nFound with -fsanitize=undefined."
},
{
"commit": "3dd796045160c4d4dbf70ec2800ad483867629f1",
"date": "2022-03-24 15:59:41 -0600",
"subject": "Fix incorrect reference to stanza-update in the user guide.",
"body": "This should be stanza-upgrade. Also fix in the git history cache since the comment was copied from the user guide."
},
{
"commit": "14016a86e7d37030ae934a004cad70888b539b33",
"date": "2022-03-24 13:13:35 -0600",
"subject": "Check that sha1 checksum is not empty in manifestFileUpdate().",
"body": "The manifest test module was setting a blank value here and causing a stack overflow because memcpy() is used instead of strcpy().\n\nThis was really just a test issue but add an assert just in case the same were to happen in production code.\n\nAlso update a bogus checksum in the integration tests to the correct length to avoid running afoul of the assert.\n\nFound with -fsanitize=address."
},
{
"commit": "4e5ac11517022f445f4ec078cc30bd2ce3aa6d15",
"date": "2022-03-24 12:56:26 -0600",
"subject": "Fix incorrect struct type in list initialization.",
"body": "This looks like a copy-paste error.\n\nThe code is only run during development so this is not a live issue.\n\nFound with -fsanitize=address."
},
{
"commit": "75b26319aea4493d8b9624a61795f8128d50c3b5",
"date": "2022-03-24 12:26:09 -0600",
"subject": "Use strNewZ() in cases where STRDEF() assignment goes out of scope.",
"body": "If a variable assigned with STRDEF() is referenced out of scope of the STRDEF() assignment then the value is undefined.\n\nLuckily most of the instances are in tests but there is one in the core code. It is not clear if this is a live bug or not but it certainly needs to be fixed.\n\nFound with -fsanitize=address."
},
{
"commit": "edf6c70baa97ad9c9045c01df4f587880a78cdc6",
"date": "2022-03-24 11:00:51 -0600",
"subject": "Prevent signed integer overflow in cfgParseSize().",
"body": "If the value and multiplier were large enough then the return value could overflow unpredictably.\n\nCheck the value to make sure it will not overflow with the current multiplier.\n\nIt would be better to present an \"out of range\" error to the user rather than \"is not valid\" but it doesn't seem worth the effort since the error is extremely unlikely.\n\nFound with -fsanitize=undefined."
},
{
"commit": "ccbe2a1f70b3ec0a328c7f5d0f5053ef3de1b543",
"date": "2022-03-24 09:32:18 -0600",
"subject": "Do not pass NULL to memcpy() in Buffer/String objects.",
"body": "glibc and others seem tolerant of this but the behavior is undefined.\n\nFound with -fsanitize=undefined."
},
{
"commit": "98792b1b0cd084ff90343e65b64526dfede396e7",
"date": "2022-03-24 09:22:05 -0600",
"subject": "Do not pass NULL to bsearch()/qsort() in List object.",
"body": "glibc and others seem tolerant of this but the behavior is undefined.\n\nFound with -fsanitize=undefined."
},
{
"commit": "333ef84606cb1597e09a324c81759a2a222e3bf4",
"date": "2022-03-23 21:47:56 -0600",
"subject": "Use bufUsed() instead of struct member in Buffer object.",
"body": "bufUsed() is an inline function so it is just as efficient and should also be easier to read and maintain."
},
{
"commit": "424008d293661dfb1a167cfec2697def48057447",
"date": "2022-03-23 10:41:36 -0600",
"subject": "Allow files that become zero-length after the backup manifest is built.",
"body": "It is possible that a file will be be truncated to zero-length after the backup manifest has been built. We could build logic into backupFile() to handle this case but it is hard to test well because of the race condition so tests would need to written directly against backupFile() and backupJobResult(). It hardly seems worth all that effort for a condition that occurs rarely, if ever.\n\nInstead just remove the manifest check and add tests to restore to make sure it handles bundled zero-length files correctly. Logging will show that the file was bundled so if it happens a lot (which seems very unlikely) then we can think about an alternate implementation."
},
{
"commit": "fe9fd2ff2d778b86c0df159aabe7644f18f6479f",
"date": "2022-03-22 09:02:33 -0600",
"subject": "Disable repo-hardlink option when repo-bundle option is enabled.",
"body": "Hardlinking will not work with bundles because files are not stored individually."
},
{
"commit": "7afaac0a3d0e43e5598d1abf548559dbe6329363",
"date": "2022-03-22 08:35:34 -0600",
"subject": "Allow repo-hardlink option to be changed after full backup.",
"body": "This rule was added because there were not sufficient tests to demonstrate that the repo-hardlink option could be changed in a backup set.\r\n\r\nRemove the restriction and add/update tests to show that it works.\r\n\r\nThis is necessary now because bundling requires that hardlinking be disabled. Rather than add code complexity, it seems better just to address this limitation."
},
{
"commit": "5ae84d5e474e95dcc00c174aa5111815a5a70ba5",
"date": "2022-03-22 07:50:26 -0600",
"subject": "Improve path validation for repo-* commands.",
"body": "Check for invalid path in repo-* commands. Perform path validation and throw an error when appropriate. Path may not contain '//'. Strip trailing '/' from path. Absolute path must fall under repo path."
},
{
"commit": "21cef09dfd03c313531dc66ba9556164ae2835ab",
"date": "2022-03-16 11:02:29 -0600",
"subject": "Add AWS IMDSv2 support.",
"body": "IMDSv2 provides additional security to prevent instance metadata from being read by an attacker.\r\n\r\nAll AWS instances should provide IMDSv2 but still fail back to IMDSv1 if the IMDSv2 token request fails. This is in case there are any services outside AWS that are emulating IMDSv1 but have not implemented IMDSv2."
},
{
"commit": "2c96327e654ab634ee4077a39d6d20a7eae1065f",
"date": "2022-03-15 17:55:48 -0600",
"subject": "Remove extraneous double spaces in code and comments."
},
{
"commit": "3f66f42ef9605a83c356e4c6eb3ef47bcb12c30d",
"date": "2022-03-14 17:49:52 -0600",
"subject": "Rename bundle-* options to repo-bundle-*.",
"body": "It seems best for these to be repo options so they can be configured per repo, rather than globally.\r\n\r\nAll clarify usage for repo-bundle-size and repo-bundle-limit."
},
{
"commit": "7c9208ba856a71833dc7d8f1cf8cb2b4bb4b7414",
"date": "2022-03-11 10:10:02 -0600",
"subject": "Improve error message for invalid repo-azure-key.",
"body": "Check that repo-azure-key is valid base64 when repo-azure-key-type = shared."
},
{
"commit": "0054677147121967889ead7feab0959fb19e39a6",
"date": "2022-03-09 15:34:15 -0600",
"subject": "Add bundle logging to backup command.",
"body": "This was added to the restore command so add it to the backup command as well."
},
{
"commit": "dca6da86bfe84a0cda004df1140d125db1630c90",
"date": "2022-03-09 15:03:28 -0600",
"subject": "Optimize restore command for file bundling.",
"body": "Since files are stored sequentially in a bundle, it is often possible to restore multiple files with a single read. Previously, each restored file required a separate read. Reducing the number of reads is particularly beneficial for object stores, but performance should benefit on any file system.\r\n\r\nCurrently if there is a gap then a new read is required. In the future we might set a limit for how large a gap we'll skip without starting a new read."
},
{
"commit": "f7ab002aa74dd2ca277123f7500018ae68a04c74",
"date": "2022-03-08 12:18:23 -0600",
"subject": "Improve stop command to honor stanza option.",
"body": "Improve the stop command, when force and stanza options are specified, to terminate only processes holding lock files for the given stanza. Prior to these changes, termination of all processes holding lock files regardless of stanza occurred."
},
{
"commit": "514137040e60e8fff0e7f42f43b493113abae5ff",
"date": "2022-03-08 08:23:31 -0600",
"subject": "Add limit parameter to ioCopyP().",
"body": "Allows the number of bytes copied to be limited."
},
{
"commit": "166039c0da1875581a08d41ab8a44adf95fa6db1",
"date": "2022-03-08 08:09:58 -0600",
"subject": "Fix example for repo-gcs-key-type option in configuration reference.",
"body": "This looks like a copy-paste error from another option."
},
{
"commit": "91b718bd4f89157c7401e3904bb171387b2e8a3e",
"date": "2022-03-06 14:58:43 -0600",
"subject": "Fix comment typo."
},
{
"commit": "330e19900ee3415d920680cf6e6856bf5e8e9a69",
"date": "2022-03-06 13:01:24 -0600",
"subject": "Increase precision of percent complete logging for backup and restore.",
"body": "For very large backups only getting an update per percent may not be often enough.\r\n\r\nAdd hundredths to the percent complete logging to provide more timely information."
},
{
"commit": "be731f825432c738571f4c055f1b9d42d3fa18cf",
"date": "2022-03-06 12:03:57 -0600",
"subject": "Fix incorrect comment.",
"body": "This appears to have been blindly copied from the archive-get command."
},
{
"commit": "8f23b46b4be9a0ce55e0c2d13be0edfd5bdc5349",
"date": "2022-03-06 11:57:20 -0600",
"subject": "Replace percentage and size with a constant in restore test logs.",
"body": "Checking percentage and size in every test can cause quite a bit of churn when changes are made.\n\nFollow the example of the backup tests and replace percentage and size after the few tests to reduce churn."
},
{
"commit": "4d2fef1c37d357965f0ffb9af0d7489f3be1371b",
"date": "2022-03-06 11:48:22 -0600",
"subject": "Remove redundant restoreFile() test and improve coverage.",
"body": "These tests were written before the restore command was fully migrated to C so many of them have become redundant.\n\nIn the cases were they still provide coverage, add tests to synthetic restores to replace them. In general, these higher level tests provide better coverage than poking at the restoreFile() function directly."
},
{
"commit": "009d33aa8ebbcd00a85392e1424e8f078952e2f5",
"date": "2022-03-06 11:17:01 -0600",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "c242b966e0352505ee8389fcebcfbde48b2a55d4",
"date": "2022-03-06 11:14:01 -0600",
"subject": "Begin v2.39 development."
},
{
"commit": "5249b89a2e94fdbb45461faaf2e1b0304b986ac7",
"date": "2022-03-06 10:30:59 -0600",
"subject": "v2.38: Minor Bug Fixes and Improvements"
},
{
"commit": "59a5373cf85e4ad0057b592bfe855495384dfcbd",
"date": "2022-03-02 11:38:52 -0600",
"subject": "Handle TLS servers that do not close connections gracefully.",
"body": "Some TLS server implementations will simply close the socket rather than correctly closing the TLS connection. This causes problems when connection: close is specified with no content-length or chunked encoding and we are forced to read to EOF. It is hard to know if this is a real EOF or a network error.\r\n\r\nIn cases where we can parse the content and (hopefully) ensure it is correct, allow the closed socket to serve as EOF. This is not ideal, but the change in 8e1807c means that currently working servers with this issue will stop working after 2.35 is installed, which seems too risky."
},
{
"commit": "f1bdf3e04b07dc9a2eaa1fdbe5278cc18371e868",
"date": "2022-03-02 10:59:06 -0600",
"subject": "Add aliveness check to systemd service configuration.",
"body": "If the pgbackrest service service fails to start then the user will get an error. However, retries will continue in the background."
},
{
"commit": "a66ec8d549b8f1f7b38682ad90281f1fcbb2748a",
"date": "2022-03-02 10:22:15 -0600",
"subject": "Revert PGDG yum repo workaround for aarch64.",
"body": "da0f3a855 used a workaround to get the documentation building on aarch64 but recent changes to the PGDG yum repo have broken this workaround. Installing the regular way still doesn't work, either.\n\nReverting for now to get the CI pipeline working again."
},
{
"commit": "fb5051fde74bcfde85fa3b9a452a1df693e79db9",
"date": "2022-02-26 13:50:30 -0600",
"subject": "Use vagrant user in the Docker container.",
"body": "This is a bit of legacy from the current Vagrant environment used to do the release, but since it is not as easy to change the user in Vagrant, just make the Docker environment conform.\n\nThis allows documentation to be built in a Vagrant environment (or any environment with the same user name) and to be deployed in a Docker environment."
},
{
"commit": "f716e98ad0e9eda94da973211e5f54e88c2c1aed",
"date": "2022-02-26 11:31:52 -0600",
"subject": "Suppress errors when there is stderr output for Docker builds.",
"body": "Docker outputs build info to stderr even when the build is successful. This seems to be especially true on Mac M1.\n\nContainerTest.pm already does this suppression so add it the other places where containers are built."
},
{
"commit": "53de3e3aeb71f8209f56167941df35bbfcb7cdc9",
"date": "2022-02-26 11:17:05 -0600",
"subject": "Move repo options in TLS documentation to the global section.",
"body": "These options were mistakenly added to the stanza section, which works in certain cases, but is not best practice."
},
{
"commit": "98d525dba43ba259ff7989746b8e5be3382c189d",
"date": "2022-02-25 14:03:09 -0600",
"subject": "Add FAQ explaining WAL archive suffix."
},
{
"commit": "b33cabe08c33e29eb8aef65dd46b2c1f3cf2d186",
"date": "2022-02-25 10:51:40 -0600",
"subject": "Allow case-insensitive matching of HTTP connection header values.",
"body": "The specification allows values for the connection header to be case-insensitive. See https://www.rfc-editor.org/rfc/rfc7230#section-6.1."
},
{
"commit": "632071232344a1160ef932d6e0d65eb3149ed226",
"date": "2022-02-23 13:53:02 -0600",
"subject": "Automatically strip trailing slashes for repo-ls paths.",
"body": "Trailing slashes in at least some of the repository storage types were preventing repo-ls from displaying any content (presumably due to storage-specific behavior).\r\n\r\nSince the path with the slash should be equivalent to the path without the slash, just remove it if provided by the user."
},
{
"commit": "53f1b2520434221c01caf92e052403a28c455c1b",
"date": "2022-02-23 13:17:14 -0600",
"subject": "Improve validation of zero pages.",
"body": "Checking that pd_upper == 0 is not enough since this field may be corrupted. Still use pd_upper as a quick check, but when it is zero proceed to check the rest of the page to ensure it is also all zeroes."
},
{
"commit": "9eec98c61302121134d2067326dbd2cd0f2f0b9c",
"date": "2022-02-23 12:05:53 -0600",
"subject": "Retry on page checksum validation failure during backup.",
"body": "Rather than attempting to filter page checksum failures by LSN, just retry when there is a page checksum failure. If the page has not changed since the last read report it as an error. If the page has changed, then PostgreSQL must be modifying the page so we can ignore the error because a full page write (and possibly updates) will be in the WAL.\r\n\r\nAlso remove tests made redundant by the test merge in b4897077."
},
{
"commit": "5c332a0b100d5a5180b3d95bd90d4d7b521b42db",
"date": "2022-02-23 11:23:32 -0600",
"subject": "Fix release note attribution in cacfdd94 and f798458e."
},
{
"commit": "f798458e1d18fc8a866b49a4cfa0cb73536cbd41",
"date": "2022-02-23 10:29:17 -0600",
"subject": "Disconnect help.auto.c from build-help in Makefile.",
"body": "When there was an issue with the system library path during building, the build-help rule would fail during executing ./build-help with the effect that main.c wouldn't build.\r\n\r\nBreak out help.auto.c generation from the build-help stage to allow it to be re-executed when the library path has been corrected."
},
{
"commit": "67bdf07e6969f8160347e895454bf729c9165884",
"date": "2022-02-23 10:26:39 -0600",
"subject": "Add XML to invalid XML error message.",
"body": "There have been cases where pgBackRest has failed on invalid XML but it is not possible to determine what was wrong with the XML.\n\nThis will only work for XML up to about 8KiB (which is the error message limit) but it should work in most cases."
},
{
"commit": "10038db9c9f2b4753c3821e0b246fa8626527184",
"date": "2022-02-23 09:14:27 -0600",
"subject": "Add archive-missing-retry option.",
"body": "Retry a WAL segment that was previously reported as missing by the archive-get command. This prevents notifications in the spool path from a prior restore from being used and possibly causing a recovery failure if consistency has not been reached.\r\n\r\nDisabling this option allows PostgreSQL to more reliably recognize when the end of the WAL in the archive has been reached, which permits it to switch over to streaming from the primary. With retries enabled, a steady stream of WAL being archived will cause PostgreSQL to continue getting WAL from the archive rather than switch to streaming.\r\n\r\nWhen disabling this option it is important to ensure that the spool path for the stanza is empty. The restore command does this automatically if the spool path is configured at restore time. Otherwise, it is up to the user to ensure the spool path is empty."
},
{
"commit": "cacfdd94d74307285b1b590ec0977d7db3142d0d",
"date": "2022-02-23 08:01:38 -0600",
"subject": "Fix typos in help and release notes."
},
{
"commit": "e2eb3ebacce18e9c0c2f74457a646142a0eace3d",
"date": "2022-02-20 17:45:41 -0600",
"subject": "Most recent news for postgresql.org."
},
{
"commit": "e6e1122dbcf5e667d683295f7e7e45de4bbf56bd",
"date": "2022-02-20 16:45:07 -0600",
"subject": "Pass file by reference in manifestFileAdd().",
"body": "Coverity complained that this pass by value was inefficient:\n\nCID 376402: Performance inefficiencies (PASS_BY_VALUE)\nPassing parameter file of type \"ManifestFile\" (size 136 bytes) by value.\n\nThis was completely intentional since it gives us a copy of the struct that we can change without bothering the caller. However, updating fields is fine and may benefit the caller at some future data, and in any case does no harm now.\n\nAnd as usual it is easier not to fight with Coverity."
},
{
"commit": "b4897077937ee4571ba719276a44d5db0a75510e",
"date": "2022-02-18 17:50:05 -0600",
"subject": "Move command/backup-common tests in the command/backup module.",
"body": "As much as possible it is better to get coverage with more realistic tests. Merging these modules will allow the page checksum code to be covered with real backups."
},
{
"commit": "efc09db7b9ece6e7b7f92538d56d6ab7b9798f8f",
"date": "2022-02-17 07:25:12 -0600",
"subject": "Limit files that can be bundled.",
"body": "Limit which files can be added to bundles, which allows resume to work reasonably well. On resume, the bundles are removed and any remaining file is eligible to be to be resumed.\r\n\r\nAlso reduce the bundle-size default to 20MiB. This is pretty arbitrary, but a smaller default seems better."
},
{
"commit": "34d649579eb3bd1530aa99f0ed1879e7d3125424",
"date": "2022-02-14 13:24:14 -0600",
"subject": "Bundle files in the repository during backup.",
"body": "Bundle (combine) smaller files during backup to reduce the number of files written to the repository (enable with --bundle). Reducing the number of files is a benefit on all file systems, but especially so on object stores such as S3 that have a high file creation cost. Another benefit is that zero-length files are only stored as metadata in the manifest.\r\n\r\nFiles are batched up to bundle-size and then compressed/encrypted individually and stored sequentially in the bundle. The bundle id and offset of each file is stored in the manifest so files can be retrieved randomly without needing to read the entire bundle. Files are ordered by timestamp descending when being assigned to bundles to reduce the amount of random access that needs to be done. The idea is that bundles with older files can be read in their entirety on restore and only bundles with newer files will get fragmented.\r\n\r\nBundles are a custom format with metadata stored in the manifest. Tar was considered but it is too limited a format, the major issue being that the size of the file must be known in advance and that is very contrary to how pgBackRest works, especially once we introduce page-level incremental backups.\r\n\r\nBundles are stored numbered in the bundle directory. Some files may still end up in pg_data if they are added after the backup is complete. backup_label is an example.\r\n\r\nCurrently, only the backup command works in batches. The restore and verify commands use the offsets to pull individual files out of the bundle. It seems better to finalize how this is going to work before optimizing the other commands. Even as is, this is a major step forward, and all commands function with bundling.\r\n\r\nOne caveat: resume is currently not supported when bundle is enabled."
},
{
"commit": "8046f0630715015d5adcced570c54e9a183c0e73",
"date": "2022-02-14 11:07:02 -0600",
"subject": "Do not retry fatal errors.",
"body": "There is some evidence that retrying fatal errors, especially out of memory errors, may cause lockups. It makes sense to report fatal errors as quickly as possible and bypass retries. This may or not fix the lockup issue but it is worth doing either way.\r\n\r\nFor now, the only fatal errors will be AssertError and MemoryError."
},
{
"commit": "8d0cce66f83abc1ff02a985ec3f0d7e285c09d72",
"date": "2022-02-13 15:19:31 -0600",
"subject": "Use normal error for protocol module error retry test.",
"body": "Asserts will not be retried in a future commit, so adjust this test now to use non-assert errors."
},
{
"commit": "8573a2df14d0bfd5578333b68147cc12c93c6f96",
"date": "2022-02-13 15:11:59 -0600",
"subject": "Improve protocol module error test for protocolClientFree().",
"body": "Using an assert here was never ideal and won't work once we start handling fatal errors differently."
},
{
"commit": "551e5bc6f67c91cf1e11da0cefe24f9650353adc",
"date": "2022-02-11 08:11:39 -0600",
"subject": "Retry errors in S3 batch file delete.",
"body": "If the entire batch failed it would be retried, but individual file errors were not retried. This could cause pgBackRest to terminate during expiration or when removing an unresumable backup.\r\n\r\nRather than retry the entire batch, delete the errored files individually to take advantage of the HTTP retry rather than adding a new retry loop. These errors seem rare enough that it should not be a performance issue."
},
{
"commit": "b26097f8d8a7e2af6e9a21576994cbb47110c6f4",
"date": "2022-02-09 10:18:39 -0600",
"subject": "Add backup type filter to info command.",
"body": "Support --type option in the info command to display only a specific backup type."
},
{
"commit": "cb630ffe3b5c819b5e97ac11d5974000bd44d632",
"date": "2022-02-09 09:32:23 -0600",
"subject": "Remove logic that tried to determine additional file system compression.",
"body": "In theory, the additional stat() call after a file has been copied to the repo can determine if additional compression has been applied by the file system. However, it has been a very long time since we tested this in practice. There are currently no unit tests that accurately test this feature since it requires a compressed file system like ZFS to work, which never seemed worth the extra cost.\r\n\r\nIt can also add a lot of time to backups if there are a large quantity of small files.\r\n\r\nIn addition, it stands as a blocker for combining files for small file support since it is no longer possible to get per-file sizes from the viewpoint of the file system. There are several ways this could be reworked but none of them are easy while at the same time maintaining current info functionality.\r\n\r\nIt doesn't seem worth keeping an untested feature that will only work in some special cases (if it still works) when it is blocking development."
},
{
"commit": "755bfc4d4015a68fa06890d1d62515b8bbbc3a64",
"date": "2022-02-07 08:14:28 -0600",
"subject": "Fix invalid file descriptor being passed to close().",
"body": "Coverity pointed out that a negative number could be passed to close(), which means the lock file would not get closed until the process ended. Proper execution does not require the file to be closed, but it is better to correctly free resources that are no longer needed."
},
{
"commit": "5cbb4a3e6b13598b90cae46fad28c31604f9f094",
"date": "2022-02-04 15:55:24 -0600",
"subject": "Remove unused backup-standby option from stanza commands."
},
{
"commit": "7dd657b7dd163ded9fbf7caef37eea7e08bc5a37",
"date": "2022-02-04 12:48:50 -0600",
"subject": "Simplify filename construction in command/verify module.",
"body": "Remove some duplicated code by tracking the backup label and constructing the filename only when needed."
},
{
"commit": "b1da4e84e8b1fda0299931dbcb9b057ce0d3ce64",
"date": "2022-02-02 14:39:39 -0600",
"subject": "Revert Minio to prior release.",
"body": "The most recent release of Minio has broken CI builds but there is no logging to indicate what is wrong.\n\nFor now, just use the prior release to get CI builds working again. This kind if breakage is not uncommon for Minio but they usually resolve it in the next release."
},
{
"commit": "9b2f10dbb49a8b869cef2c419d9957ed4c550016",
"date": "2022-01-31 16:48:28 -0600",
"subject": "Refactor lock code.",
"body": "Update lock code to use standard common/io functions and module patterns. This module was developed before the common/io module existed and our patterns had stabilized."
},
{
"commit": "22734eb376b3183924cb7794f9111c1eeb5d92d6",
"date": "2022-01-31 10:03:56 -0600",
"subject": "Add ioBufferReadNewOpen() and ioBufferWriteNewOpen().",
"body": "These are convenience functions to make the code a bit more compact where possible."
},
{
"commit": "e62e6664d3654dd63ae2eda64f981a6936b822d3",
"date": "2022-01-26 13:26:22 -0600",
"subject": "Remove release note about the default port being provisional.",
"body": "The default port has now been approved by IANA."
},
{
"commit": "cf5b3a302f0835be993a7f795038d4d676cd6f01",
"date": "2022-01-26 13:22:31 -0600",
"subject": "Fix language in rh7 test container for aarch64.",
"body": "The /etc/profile.d/lang.sh script was causing issues but it does not exist on amd64, so it seems the easiest thing was to remove it.\n\nFix how 32-bit VMs are determined now that another 64-bit architecture has been added.\n\nAnd remove some obsolete VM hashes."
},
{
"commit": "da0f3a85535df3389c5023afc637124acc6405d3",
"date": "2022-01-26 10:15:14 -0600",
"subject": "Download correct key on aarch64 in the user guide.",
"body": "The default key that gets installed is for amd64. This is only required for RHEL8 it seems, so something is definitely amiss."
},
{
"commit": "e4df5b7d3846134832b9315e22786f679d63a46b",
"date": "2022-01-24 15:21:07 -0600",
"subject": "Simplify manifest file defaults.",
"body": "Previously manifest load required two passes through the file list, one to load the data and one to set the defaults. This required each file to be packed twice.\r\n\r\nInstead simply note that the file value is default and then set the file defaults when they are loaded from the manifest. This is made possible by the different internal/external representations for files so the same method cannot be applied to paths and links.\r\n\r\nThis change seems to resolve the performance issues noted in 61ce586 but there is no obvious reason why."
},
{
"commit": "044138fbb19f02ec433e52c42684b1ecc616c624",
"date": "2022-01-23 15:07:13 -0500",
"subject": "Centralize common PostgreSQL options in the user guide.",
"body": "Centralize these options so they are consistent across clusters.\n\nAlso, there were some options that the user doesn't really need to see, .e.g. log_line_prefix. These can be set in advance so they don't need to be part of the documentation."
},
{
"commit": "13623d6ee50794e87ceac37c61e72ba3a92ad8b6",
"date": "2022-01-23 13:53:52 -0500",
"subject": "Create create_test_table() function earlier in user guide.",
"body": "This function (which creates lots of tables) is generally useful for testing (not just stress testing) so create it as soon as the cluster is created.\n\nAlso add the data parameter which will insert a single row into the table so the file on disk is not zero bytes."
},
{
"commit": "ca13f11b4a3858587c7055b0b2b4a8b396dd8451",
"date": "2022-01-22 17:20:25 -0500",
"subject": "Optimization for jsonFromStrInternal().",
"body": "This is an extremely hot code path when saving the manifest so every little bit helps."
},
{
"commit": "61ce58692f3092b72833b6e9ee87037f45b3b702",
"date": "2022-01-21 17:05:07 -0500",
"subject": "Pack manifest file structs to save memory.",
"body": "Manifests with a very large number of files can use a considerable amount of memory. There are a lot of zeroes in the data so it can be stored more efficiently by using base-128 varint encoding for the integers and storing the strings in the same allocation.\r\n\r\nThe downside is that the data needs to be unpacked in order to be used, but in most cases this seems fast enough (about 10% slower than before) except for saving the manifest, which is 10% slower up to 10 million files and then gets about 5x slower by 100 million (two minutes on my M1 Mac). Profiling does not show this slowdown so I wonder if this is related to the change in memory layout. Curiously, the function that increased most was jsonFromStrInternal(), which was not modified. That gives more weight to the idea that there is some kind of memory issue going on here and one hopes that servers would be less affected. Either way, they largest use cases we have seen are for about 6 million files so if we can improve that case I believe we will be better off.\r\n\r\nFurther analysis showed that most of the time was taken up writing the size and timestamp fields, which makes almost no sense. The same amount of time was used if they were hard-coded to 0, which points to some odd memory issue on the M1 architecture.\r\n\r\nThis change has been planned for a while, but the particular impetus at this time is that small file support requires additional fields that would increase manifest memory usage by about 20%, even if the feature is not used.\r\n\r\nNote that the Pack code has been updated to use the new varint encoder, but the decoder remains separate because it needs to fetch one byte at a time."
},
{
"commit": "575ae77c0dee12b932469d479b2e45dbaf389737",
"date": "2022-01-21 15:57:22 -0500",
"subject": "Convert varNewUInt64() to VARUINT64() where possible in manifest.",
"body": "VARUINT64() does not require memory to be allocated from the mem context so should be used when possible."
},
{
"commit": "4a73a0286387f3f2185f3f193f9c20ed0d7d926d",
"date": "2022-01-21 15:22:48 -0500",
"subject": "Simplify manifest defaults.",
"body": "Manifest defaults for user, group, and mode were previously generated by scanning the data to find the most common values. This was very accurate but slow and complicated. It could also lead to surprising changes in the manifest when a default value suddenly changed.\r\n\r\nInstead, use the $PGDATA path to generate defaults. In the vast majority of cases the same user/group should own all the path/files and the default file mode is easily derived from the path mode. There may be some edge cases where this generates larger manifests, but in general it reduces time and complexity when saving the manifest.\r\n\r\nRemove the MCV code since it is longer longer used."
},
{
"commit": "b0db4b8ff00db913cb69308017a56155d6070830",
"date": "2022-01-21 08:52:51 -0500",
"subject": "Simplify base path mode in mock/all integration tests.",
"body": "Change the mode back to 0700 earlier to reduce churn in the expect logs.\n\nThis will be especially important in a future commit that gets the defaults exclusively from the base path."
},
{
"commit": "8c062e1af824c3dc80ff94b3df8d433f95e88d0f",
"date": "2022-01-20 14:01:10 -0500",
"subject": "Remove primary flag from manifest.",
"body": "This flag was only being used by the backup command after manifestNewBuild() and had no other uses. There was a time when it was important for integration testing but the unit tests now fulfill this role.\r\n\r\nSince backup is the only code concerned with the primary flag, move the code into the backup module.\r\n\r\nWe don't have any cross-version testing but this change was tested manually with the most recent version of pgBackRest to make sure it was tolerant of the missing primary info. When an older version of pgBackRest loads a newer manifest the primary flag will always be set to false, which is fine since it is not used."
},
{
"commit": "16559d9e421c66596d21b047c8afe1b2c96ccd82",
"date": "2022-01-20 08:41:05 -0500",
"subject": "Use the PG_FILE_POSTMTRPID constant where appropriate.",
"body": "Do the same in Perl with the MANIFEST_FILE_POSTMTRPID constant."
},
{
"commit": "4ca0590a51a665535fbba903b8f55e10557b606a",
"date": "2022-01-20 08:06:42 -0500",
"subject": "Refactor backupProcessQueue() to use BackupJobData struct.",
"body": "BackupJobData has several members that backupProcessQueue() needs so it is more efficient to use them rather than passing them separately or getting them from the configuration."
},
{
"commit": "e21ba7c92bc15e9314eefa80cef8f17cf2f0e224",
"date": "2022-01-18 17:40:53 -0500",
"subject": "Remove extra spaces."
},
{
"commit": "f84909f85f7dfb202ac812c67665cc590a5acad4",
"date": "2022-01-18 17:26:30 -0500",
"subject": "Fix issue with Posix read offset handling after an error.",
"body": "Coverity pointed out that -1 could be passed to lseek() (added in a79034ae) after a file failed to open because it is missing. Overall it seems simpler to enclose the success code in an else block to prevent any repeats of this mistake in the future.\n\nThis was not an active bug because there are currently no cases where we do read offsets in a file that is allowed to be missing.\n\nAlso remove the result flag since it is easier to just check that the file descriptor is valid."
},
{
"commit": "91721e391a4d83a405a0d1be31b854312f9f157d",
"date": "2022-01-17 15:39:31 -0500",
"subject": "Fix typo."
},
{
"commit": "b791f1c82f53fa16866837d4544b58243c682f7f",
"date": "2022-01-15 14:33:38 -0500",
"subject": "Implement restore ownership without updating manifest internals.",
"body": "Updating the manifest this way was not a great idea because it broke abstraction for the object. This meant certain changes to the interface and internals were not possible because the code was modifying internal manifest data.\n\nInstead track the user replacements entirely in the restore module.\n\nThis also has the benefit of eliminating a pass over the manifest path/file/link lists."
},
{
"commit": "3097acd73a21b630aa5352be57a82b031930f96b",
"date": "2022-01-13 08:46:14 -0500",
"subject": "Add support for AWS S3 server-side encryption using KMS.",
"body": "AWS S3 integrates with AWS Key Management Service (AWS KMS) to provide server side encryption of S3 objects. This integration protects objects under encryption keys that never leave AWS KMS unencrypted."
},
{
"commit": "92ea3e05fb43e5272a19fb1e3208412b75008c24",
"date": "2022-01-11 19:15:09 -0500",
"subject": "cfgOptionGroupName() replacement missed in aced5d47."
},
{
"commit": "a79034ae2f6a8ec66b84c62ab6cd4042d2c1a249",
"date": "2022-01-11 14:42:53 -0500",
"subject": "Add read range to all storage drivers.",
"body": "The range feature allows reading out an arbitrary chunk of a file and will be important for efficient small file support.\r\n\r\nNow that all drivers are required to support ranges remove the storageFeatureLimitRead feature flag that was implemented only by the Posix driver."
},
{
"commit": "2fd100bf12760a4bb1996fb464ae54b5c379988e",
"date": "2022-01-10 17:40:18 -0500",
"subject": "Rename ConfigOptionGroupData.indexDisplay to indexName.",
"body": "This is more consistent with the function name and purpose."
},
{
"commit": "2cddbbdee01391ef0885f9262f3acc488382eee2",
"date": "2022-01-10 17:20:48 -0500",
"subject": "Remove obsolete cfgOptionHostPort()/cfgOptionIdxHostPort().",
"body": "These functions were made obsolete by the refactor in 6a124584."
},
{
"commit": "7c627c12b735345cc3d733ae66a52b1fe0030e47",
"date": "2022-01-10 17:00:58 -0500",
"subject": "Refactor option and option group config structs.",
"body": "This allows individual structs to be assigned to variables to make the code easier to read and perhaps a bit more efficient."
},
{
"commit": "aeecb500f54561f7d52fa1b637f7f6e1f7a668de",
"date": "2022-01-10 14:47:29 -0500",
"subject": "Improve implementation of cfgOptionIdxName().",
"body": "Cache option names after they are generated rather than regenerating them each time."
},
{
"commit": "aced5d47ed8e57ca7f36f92fe068f80b66f81649",
"date": "2022-01-10 09:10:06 -0500",
"subject": "Replace cfgOptionGroupIdxToKey() with cfgOptionGroupName().",
"body": "Do the replacement anywhere cfgOptionGroupIdxToKey() is being used to construct a group name in a message. cfgOptionGroupName() is better for this case since it also includes the name of the group so that it does not need to be repeated in each message."
},
{
"commit": "9657f1b32519272edaaefd379355137afd554e82",
"date": "2022-01-09 19:53:05 -0500",
"subject": "Dynamically allocate index to key index map.",
"body": "Now the config/config module has no notion of max option indexes. The config/parse still needs the max but this will be removed at a later date."
},
{
"commit": "e4b48eb430a564184ab739908df55813dd970aa4",
"date": "2022-01-09 19:43:44 -0500",
"subject": "Fix inconsistent group display names in messages.",
"body": "In other instances there are no dashes, e.g. repo1 or pg1. Make these messages match."
},
{
"commit": "5f78a5fc18120c67cb8a68f83a4fb9bcf96982e2",
"date": "2022-01-09 13:19:43 -0500",
"subject": "Add ioCopy().",
"body": "Functionality to copy from IoRead to IoWrite is frequently used so centralize it. This also simplifies coverage testing in places where a loop was required before."
},
{
"commit": "47954774c6cc70a6fc9a6c8836d82a87e341ea11",
"date": "2022-01-09 10:11:00 -0500",
"subject": "Combine encrypted backupFile() tests with unencrypted tests.",
"body": "This makes it easier to comment out all the tests while developing without getting unused variable errors."
},
{
"commit": "d866dd5c297dc046581134a108032cf9694cae0e",
"date": "2022-01-07 14:09:58 -0500",
"subject": "Add backup LSNs to info command output.",
"body": "The backup LSNs are useful for performing LSN-based PITR. LSNs will not be displayed in the general text output (without --set) because they are probably not useful enough to deserve their own line."
},
{
"commit": "bb4b30ddd3f80c246c565eb4769efc82b9509648",
"date": "2022-01-06 15:34:04 -0500",
"subject": "Remove support for PostgreSQL 8.3/8.4.",
"body": "There is no evidence that users need 8.3/8.4 anymore but it does cost us in terms of development and testing, especially now that we have a number of new backup/restore features planned.\r\n\r\nIt seems to make sense to remove this support now. If there are users who need to use/migrate from these versions they can use an older version of pgBackRest."
},
{
"commit": "ef62ef23799f081582295f1f3e8a92691b628f53",
"date": "2022-01-06 14:24:32 -0500",
"subject": "Fix comment missed in 6bd280f7."
},
{
"commit": "fdbeb8e7d64754d35dd30e4f871834756c5d77ca",
"date": "2022-01-06 14:22:56 -0500",
"subject": "Fix typo in error message."
},
{
"commit": "a82f0179cdd5742e5c5b1e0bdfd23166753fdb38",
"date": "2022-01-04 16:11:27 -0500",
"subject": "Note that replications slots are not restored.",
"body": "Update documentation and help to note that replication slots are not restored and reference the PostgreSQL documentation to explain why."
},
{
"commit": "226cfbdcde55ca384e74d7d1348c447eecd079fa",
"date": "2022-01-04 15:48:00 -0500",
"subject": "Fix typo."
},
{
"commit": "591a72c59ec403341d29eaafe3030f4651732192",
"date": "2022-01-03 08:57:05 -0500",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "75e4580919ed139f00db7c4c3141dbefc3da131b",
"date": "2022-01-03 08:52:25 -0500",
"subject": "Begin v2.38 development."
},
{
"commit": "f18f2d9991da29533ad8e9859074c4f39185420f",
"date": "2022-01-03 08:43:55 -0500",
"subject": "v2.37: TLS Server"
},
{
"commit": "62fbee72ad319f92c9410ac8dbab2f81fe945a36",
"date": "2022-01-01 10:50:16 -0500",
"subject": "Update LICENSE.txt and PostgreSQL copyright for 2022."
},
{
"commit": "d6ebf6e2d67331a838f53beda1c186c527b56a8e",
"date": "2021-12-30 18:54:36 -0500",
"subject": "Remove dead test code."
},
{
"commit": "fccb7f7dd45c6c373d0cfa74b90d69ca483aa3af",
"date": "2021-12-28 17:39:22 -0500",
"subject": "Add release note regarding IANA approval of the default TLS port."
},
{
"commit": "6a12458440168f13cb05d70f36ea54b1860e390c",
"date": "2021-12-16 10:30:59 -0500",
"subject": "Parse protocol/port in S3/Azure endpoints.",
"body": "Utilize httpUrlNewParseP() to parse endpoint and port from the URL in the S3 and Azure helpers to avoid issues where protocol was not expected to be part of the URL."
},
{
"commit": "f06101de77a980c7e4115762f2fc301280aa4127",
"date": "2021-12-16 09:47:04 -0500",
"subject": "Add TLS server documentation.",
"body": "Add documentation and make the feature visible."
},
{
"commit": "615bdff4030a31bfedfe7df04676e3948ec9c2c0",
"date": "2021-12-14 14:53:41 -0500",
"subject": "Fix socket leak on connection retries.",
"body": "This leak was caused by the file descriptor variable getting clobbered after a long jump. Mark it as volatile to fix.\r\n\r\nTesting this is a bit complex because the issue only happens in optimized builds, if at all. Put the test into the performance suite, which is always optimized, until a better idea presents itself."
},
{
"commit": "a73fe4eb966f9685f6e4179c397a10c1e7f15f19",
"date": "2021-12-10 15:53:40 -0500",
"subject": "Fix restore delta link mapping when path/file already exists.",
"body": "If a path/file was remapped to a link using either --link-map or --link-all there would be no affect if the path/file already existed. If a link existed it would be properly updated and converting a link to a path/file also worked.\r\n\r\nThe issue happened during delta cleanup, which failed to check if the existing path/file had been remapped to a link.\r\n\r\nAdd checks for newly mapped path/file links and remove the old path/file we required."
},
{
"commit": "19a7ec69debfe6587fcc1163451896590c96bf21",
"date": "2021-12-10 15:04:55 -0500",
"subject": "Close expect log file when unit test completes.",
"body": "This did not cause any issues, but it is better to explicitly close open files."
},
{
"commit": "c38e2d31709804eb4b9125a15ad84c8fc813f366",
"date": "2021-12-08 15:00:19 -0500",
"subject": "Add verb to HTTP error output.",
"body": "This makes it easier to debug HTTP errors."
},
{
"commit": "be4ac3923cb77873da298a30aca5d847b3c635af",
"date": "2021-12-08 13:57:26 -0500",
"subject": "Error when restore is unable to find a backup to match the time target.",
"body": "This was previously a warning but the warning is easy to miss so a lot of time may be lost restoring and recovering a backup that will not hit the target.\r\n\r\nSince this is technically a breaking change, add an \"important note\" about the change to the release."
},
{
"commit": "672330593789f07aaad90bbafcd2597cbc602686",
"date": "2021-12-08 12:29:20 -0500",
"subject": "Add warning when checkpoint_timeout exceeds db-timeout.",
"body": "In the backup command, add a warning if start-fast is disabled and the PostgreSQL checkpoint_timeout is greater than db-timeout.\r\n\r\nIn such cases, we might timeout before the checkpoint occurs and the backup really starts."
},
{
"commit": "bd2ba802db11c505ec69943fa81b2b379073fbf4",
"date": "2021-12-08 10:16:41 -0500",
"subject": "Check that clusters are alive and correctly configured during a backup.",
"body": "Fail the backup if a cluster stops or the standby is promoted. Previously, shutting down the primary would cause an error but it was not detected until the end of the backup. Now the error will happen sooner and a promotion on the standby will also cause an error."
},
{
"commit": "7b3ea883c7c010aafbeb14d150d073a113b703e4",
"date": "2021-12-07 18:18:43 -0500",
"subject": "Add SIGTERM and SIGHUP handling to TLS server.",
"body": "SIGHUP allows the configuration to be reloaded. Note that the configuration will not be updated in child processes that have already started.\r\n\r\nSIGTERM terminates the server process gracefully and sends SIGTERM to all child processes. This also gives the tests an easy way to stop the server."
},
{
"commit": "49145d72bac16498cdbf5eeb3cd6128ea0be0667",
"date": "2021-12-07 09:21:07 -0500",
"subject": "Add timeline and checkpoint checks to backup.",
"body": "Add the following checks:\r\n\r\n* Checkpoint is updated in pg_control after pg_start_backup(). This helps ensure that PostgreSQL and pgBackRest have a consistent view of the storage and that PGDATA paths match.\r\n* Timeline of backup start WAL file matches pg_control. Hard to see how this one could get hit, but we have the power...\r\n* Standby is on the same timeline as the primary. If not, this standby is not following the primary.\r\n* Last standby checkpoint is not greater than the backup checkpoint. If so, this standby is not following the primary.\r\n\r\nThis also requires some additional plumbing to read/write timeline/checkpoint from pg_control and parse timelines from WAL filenames. There were some changes in the backup tests caused by the fact that pg_control now has different contents for each backup.\r\n\r\nThe check to ensure that the required checkpoint was reached on the standby should also be updated to use pg_control (it currently uses pg_control_checkpoint()), but that requires non-trivial changes to the test harness and will need to wait."
},
{
"commit": "9c76056dd0d1d2b07a89646b087c5c8d36ab97f5",
"date": "2021-11-30 16:21:15 -0500",
"subject": "Add error type and message to CHECK() macro.",
"body": "A CHECK() worked exactly like ASSERT() except that it was compiled into production code. However, over time many checks have been added that should not throw AssertError, which should be reserved for probable coding errors.\n\nAllow the error code to be specified so other error types can be thrown. Also add a human-readable message since many of these could be seen by users even when there is no coding error.\n\nUpdate coverage exceptions for CHECK() to match ASSERT() since all conditions will never be covered."
},
{
"commit": "0895cfcdf7d3f15b8029f73ed62c6094d30724b3",
"date": "2021-11-30 13:23:11 -0500",
"subject": "Add HRN_PG_CONTROL_PUT() and HRN_PG_CONTROL_TIME().",
"body": "These macros simplify management of pg_control test files.\n\nCentralize time updates for pg_control in the command/backup module. This caused some time updates in the logs.\n\nFinally, move the postgres module after the storage module so it can use storage macros."
},
{
"commit": "01ac6b6cac86ea857e54a3b1c45077df1e128a75",
"date": "2021-11-30 08:28:36 -0500",
"subject": "Autogenerate test system identifiers.",
"body": "hrnPgControlToBuffer() and hrnPgWalToBuffer() now generate the system id based on the version of Postgres. If a value less than 100 is specified for systemId then it will be added to the default system id so there can be multiple ids for a single version of PostgreSQL.\n\nAdd constants to represent version system ids in tests. These will eventually be auto-generated.\n\nThis changes some checksums and we no longer have big-endian tests systems, so X those checksums out so it is obvious they are no longer valid."
},
{
"commit": "3f7409019df112ec50efb6c3db6f7780c9a63c87",
"date": "2021-11-24 16:09:45 -0500",
"subject": "Ensure ASSERT() macro is always available in test modules.",
"body": "Tests that run without DEBUG for performance did not have ASSERT() and were using CHECK() instead.\n\nInstead ensure that the ASSERT() macro is always available in tests."
},
{
"commit": "dcb4f09d8315e92c0877b589f3fa9b7f0fa65f93",
"date": "2021-11-23 09:37:12 -0500",
"subject": "Revert changes to backupFilePut() made in 1e77fc3d.",
"body": "These changes were made obsolete by a3d7a23a."
},
{
"commit": "7e35245dc3416238a84a43abbecdf976170dea91",
"date": "2021-11-23 08:07:31 -0500",
"subject": "Use ASSERT() or TEST_RESULT*() instead of CHECK() in test modules."
},
{
"commit": "a3d7a23a9d90611a3d31947598fbea240b250710",
"date": "2021-11-22 12:52:37 -0500",
"subject": "Use infoBackupDataByLabel() to log backup size.",
"body": "Eliminate summing and passing of copied files sizes for logging backup size.\r\n\r\nInstead, utilize infoBackupDataByLabel() to pull the backup size for the log message."
},
{
"commit": "1a0560d363d28737befb8c222647783d4fc2ca29",
"date": "2021-11-19 12:22:09 -0500",
"subject": "Allow y/n arguments for boolean command-line options.",
"body": "This allows boolean boolean command-line options to work like their config file equivalents.\r\n\r\nAt least for now this behavior will remain undocumented since all examples in the documentation will continue to use the standard syntax. The idea is that it will \"just work\" when options are copied out of config files rather than generating an error."
},
{
"commit": "2d963ce9471808172f879916c3f3accc35f14d56",
"date": "2021-11-18 17:23:11 -0500",
"subject": "Rename server-start command to server."
},
{
"commit": "1f14f45dfb0d1677a695719381cbd5a8a3c6c986",
"date": "2021-11-18 16:18:10 -0500",
"subject": "Check archive immediately after backup start.",
"body": "Previously the archive was only checked at the end of the backup to ensure all WAL required to make the backup consistent was present. The problem was that if archiving was not functioning then the backup had to complete before the user found out, which could be a while if the database was large enough.\r\n\r\nAdd an archive check immediately after backup start so failures are reported earlier.\r\n\r\nThe trick is to determine which WAL to check. If the repo is new there may not be any WAL in it and pg_start_backup() will not switch the WAL segment if it is empty. These are both likely scenarios when setting up and/or testing pgBackRest.\r\n\r\nIf the WAL segment is switched by pg_start_backup(), then check the archive for the segment that was detected prior to backup start. This should be common on normal running clusters with regular activity. Note that this might not be the segment immediately prior to the backup start segment if WAL volume is high.\r\n\r\nIf pg_start_backup() did not switch the WAL then we can force a switch on PostgreSQL >= 9.3 by creating a restore point. In that case the WAL to check will be the backup start WAL. This is most likely to happen on idle systems, during testing, or immediately after a repo switch.\r\n\r\nAn advantage of this approach other than earlier notification is that the backup directory will not be created so no resume will be attempted on the next backup.\r\n\r\nNote that some additional churn was created in backup.c because the load of archive.info needs to be done earlier."
},
{
"commit": "dea752477ab8e812cdbd717eb2091baf3f5d0906",
"date": "2021-11-17 16:39:04 -0500",
"subject": "Remove obsolete statement about future multi-repository support."
},
{
"commit": "0949b4d35fdd04c55927eb6a107d881376dbe73c",
"date": "2021-11-16 18:26:21 -0500",
"subject": "Add linefeed and remove space."
},
{
"commit": "809f0bbc638cdd95540e2257383147919f82e8f9",
"date": "2021-11-16 11:34:53 -0500",
"subject": "Add infoBackupLabelExists().",
"body": "This is easier to read than using infoBackupDataByLabel() != NULL.\n\nIt also allows an assertion to be added to infoBackupDataByLabel() to ensure that a NULL return value is not used unsafely."
},
{
"commit": "1e77fc3d75490b7a1b6a0b31be9298c995ec672f",
"date": "2021-11-16 10:21:32 -0500",
"subject": "Include backup_label and tablespace_map file sizes in log output.",
"body": "In cases where they are returned by postgres, include backup_label and tablespace_map file sizes in the backup size value output in the log."
},
{
"commit": "6b5322cdad7163d91b43d37d9d8eeaa39ac7f214",
"date": "2021-11-16 09:27:15 -0500",
"subject": "Add findutils package to RHEL 8 documentation container.",
"body": "This package was dropped from the most recent Rocky Linux 8 image."
},
{
"commit": "df89eff429e9b8fbc68d9e9895badf9719fd31d2",
"date": "2021-11-15 16:53:41 -0500",
"subject": "Fix typos and improve documentation for the tablespace-map-all option."
},
{
"commit": "fcae9d35038d454c674921c65beb02b195981480",
"date": "2021-11-15 16:42:46 -0500",
"subject": "Fix parameter test logging in parseOptionIdxValue()."
},
{
"commit": "b3a5f7a8e27768c445458e47dad626609814fbb7",
"date": "2021-11-15 14:32:22 -0500",
"subject": "Add tablespace_map file to command/backup test module.",
"body": "The code worked fine but better to have explicit tests for this file."
},
{
"commit": "e62ba8e85eaf469052960c4fd71ffaf26c1a1baa",
"date": "2021-11-12 17:15:45 -0500",
"subject": "Add path to pgbench used for stress test in user guide.",
"body": "This allows the stress test to run on RHEL."
},
{
"commit": "43cfa9cef776360e592882c0b787704dbeb36cb3",
"date": "2021-11-10 12:14:41 -0500",
"subject": "Revive archive performance test.",
"body": "This test was lost due to a syntax issue in a58635ac.\n\nUpdate the test to use system() to better mimic what postgres does and add logging so pgBackRest timing can be determined."
},
{
"commit": "dd96c29f963609fad38dac3349d7fa41e40722bb",
"date": "2021-11-10 07:53:46 -0500",
"subject": "Refactor postgres/client module with inline getters/setters.",
"body": "Extend the pattern introduced in 79a2d02 to the postgres/client module."
},
{
"commit": "afe77e76e0adf948138d797e227a6f4c7d47c2eb",
"date": "2021-11-10 07:31:02 -0500",
"subject": "Update contributor for 6e635764."
},
{
"commit": "6e635764a66278d5a8c2b4d30b23063bc3923067",
"date": "2021-11-09 13:24:56 -0500",
"subject": "Match backup log size with size reported by info command.",
"body": "Properly log the size of files copied during the backup, matching the backup size returned from the info command.\r\n\r\nIn the reference issue, the incremental backup after switchover logs the size of all files evaluated rather than only the size of the files copied in the backup."
},
{
"commit": "d05d6b87142347cb4891304833db389dcf7f9a81",
"date": "2021-11-08 09:39:58 -0500",
"subject": "Do not delete manifests individually during stanza delete.",
"body": "This appears to have been an attempt to not delete files that we don't recognize, but it only works in narrow cases and could leave the user is a position of not being able to complete the stanza delete without manual intervention. It seems better just to proceed with the delete, especially since the info files have already been removed.\n\nIn addition, deleting the manifests individually could be slow on object stores if there were a very large number of backups."
},
{
"commit": "bb03b3f41942d0b781931092a76877ad309001ef",
"date": "2021-11-04 09:44:31 -0400",
"subject": "Refactor switch statements in strIdBitFromZN().",
"body": "Coverity does not like fall-throughs either to or from the default case so refactor to avoid that."
},
{
"commit": "676b9d95dd2467d4bddd402b5cd2b4f445c71944",
"date": "2021-11-04 08:19:18 -0400",
"subject": "Optional parameters for tlsClientNew().",
"body": "There are a number of optional parameters with the same type so this makes them easier to track and reduces churn when new ones are added."
},
{
"commit": "038abaa71d816cc87b382bd81d3df62ddec9455a",
"date": "2021-11-03 15:23:08 -0400",
"subject": "Display size option default and allowed values with appropriate units.",
"body": "Size option default and allowed values were displayed in bytes, which was confusing for the user.\r\n\r\nThis also lays the groundwork for adding units to time options.\r\n\r\nMove option parsing functions into a common module so they can be used from the build module."
},
{
"commit": "1b93a772369bbb3a936099e0d9d5cc79bad1e0f6",
"date": "2021-11-03 12:14:17 -0400",
"subject": "Use void * instead of List * to avoid Coverity false positives.",
"body": "Coverity complains that this should be \"List\" but that is clearly not correct."
},
{
"commit": "2a576477b316238473525e56bc8fc8ea5790455f",
"date": "2021-11-03 11:36:34 -0400",
"subject": "Add --cmd option.",
"body": "Allows users to provide an executable to be used when pgbackrest generates command strings that expect to invoke pgbackrest. These generated commands are written to files by pgbackrest, e.g. recovery.conf."
},
{
"commit": "c5b5b5880619d0994ab4a8feb3f60ab52170b61b",
"date": "2021-11-03 10:36:31 -0400",
"subject": "Simplify error handler.",
"body": "The error handler used a loop to process try, catch, and finally blocks. This worked fine but static analysis tools like Coverity did not understand that the finally block would always run and so there were false positives about double-free, unfreed resource, etc.\r\n\r\nThis implementation removes the loop, which simplifies everything, and makes it clear that the finally block will always run. This cuts down on Coverity false positives.\r\n\r\nThis implementation also catches lack of coverage on empty catch blocks so a few test fixes were committed separately in d74fe7a.\r\n\r\nA small refactor in backup.c is required because gcc 10.3.1 on Fedora 33 complains that the reason variable may be used uninitialized. It's not clear why this is the case, but reducing the scope of the TRY block fixes the issue."
},
{
"commit": "cff961ede7e41fa8035ffe7451a22eb5ea0e46c1",
"date": "2021-11-03 07:38:06 -0400",
"subject": "Centralize logic to build value lists during config rendering.",
"body": "This reduces duplication and makes it easier to add new types."
},
{
"commit": "7f6c513be925c77bc6a177408efcf79f624ffc94",
"date": "2021-11-03 07:27:26 -0400",
"subject": "Add StringId as an option type.",
"body": "Rather the converting String to StringIds at runtime, store defaults in StringId format in parse.auto.c and convert user input to StringId during parsing."
},
{
"commit": "b13844086d419dc3070bcce4e918b2353bf4887c",
"date": "2021-11-01 17:35:19 -0400",
"subject": "Use cfgOptionStrId() instead of cfgOptionStr() where appropriate.",
"body": "The compress-type, repo-type and log-level-* options have allow lists, which means it is more efficient to treat them as StringIds.\r\n\r\nFor compress-type and log-level-* also update the functions that convert them to enums."
},
{
"commit": "b237d0cd592bbc6c6ee9280fb7aed264bf79eb9d",
"date": "2021-11-01 10:43:08 -0400",
"subject": "Remove placeholder bz2 helper data.",
"body": "This placeholder data should have been removed when bz2 support was added in a021c9fe053."
},
{
"commit": "f4e281399a81835821547ea5c78ed7a189914d3d",
"date": "2021-11-01 10:27:57 -0400",
"subject": "Remove unused protocol log level.",
"body": "This log level was used in the Perl code but was never ported to C."
},
{
"commit": "bc352fa6a8cff7cc08b6c7f3cdfac664d2b0805f",
"date": "2021-11-01 10:08:56 -0400",
"subject": "Simplify strIdFrom*() functions.",
"body": "The strIdFrom*() forced the caller to pick an encoding, which led to a number of TRY...CATCH blocks in the code. In practice the caller does not care which encoding is used as long as the string is valid for some encoding.\r\n\r\nUpdate the strIdFrom*() function to try all possible encodings and only throw an error when the string is not valid for any of them."
},
{
"commit": "a92d7938197d1035e362390ce467ae827cbae051",
"date": "2021-11-01 09:11:43 -0400",
"subject": "Update automake version.",
"body": "There were no changes to install.sh in this version."
},
{
"commit": "904b897f5e89542784af64b364a49205e7a6e040",
"date": "2021-11-01 09:03:42 -0400",
"subject": "Begin v2.37 development."
},
{
"commit": "42fd6ce4e09ee92614cfbfb6766d9c3a6ba9cc1a",
"date": "2021-11-01 08:59:14 -0400",
"subject": "v2.36: Minor Bug Fixes and Improvements"
},
{
"commit": "6abb06248c2829f2c27a7a553d373b0fdf70cfc3",
"date": "2021-10-29 11:45:50 -0400",
"subject": "Make analytics optional for HTML documentation.",
"body": "Analytics should only be added to the current HTML documentation on the website, so exclude them by default."
},
{
"commit": "13366573261bf2562bc93ef77014f7d16b815e5b",
"date": "2021-10-29 10:35:56 -0400",
"subject": "Restore some linefeed rendering behavior from before def7d513.",
"body": "The new rendering behavior is correct in normal cases, but for the pre-rendered HTML blocks in the command and configuration references it causes a lot of churn. This would be OK if the new HTML was diff-able, but it is not.\n\nGo back to the old behavior of using br tags for this case to reduce churn until a more permanent solution is found."
},
{
"commit": "c32e000ab92e9e9e5495ddec7c4e347c35801570",
"date": "2021-10-28 15:15:49 -0400",
"subject": "Use Rocky Linux for documentation builds instead of CentOS.",
"body": "Since CentOS 8 will be EOL at the end of the year it makes sense to do this now. The centos:8 image is still used in documentation.xml because changes there require manual testing, which will need to be done at a later date. The changes are not user-facing, however, and can be done at any time.\n\nAlso update CentOS references to RHEL since that is what we are emulating for testing purposes."
},
{
"commit": "30c589ace7a459f3b3d09b702e314efd412e71d6",
"date": "2021-10-28 13:28:49 -0400",
"subject": "Fix typo in contributing guide.",
"body": "Not sure how this got broken but it was probably an errant search and replace."
},
{
"commit": "2f1a2877373c7be68d553c7f781299edaf8ff196",
"date": "2021-10-28 11:49:00 -0400",
"subject": "Add missing assert."
},
{
"commit": "adc09ffc3bccb24c83a471c8af1f9bf68f2cf9c8",
"date": "2021-10-28 08:10:43 -0400",
"subject": "Minor fix for lower-casing of option summaries.",
"body": "This works with existing cases and fixes \"I/O\"."
},
{
"commit": "fa564ee1969229b5cf60d2479d8ace85325f4db3",
"date": "2021-10-27 11:08:32 -0400",
"subject": "Improve documentation for cmd-ssh, repo-host-cmd, pg-host-cmd options.",
"body": "Use \"command\" instead of \"exe\" and make the descriptions more consistent."
},
{
"commit": "e1f6c066b3da11fd21b1155c90370c3fa2da06b7",
"date": "2021-10-27 10:52:39 -0400",
"subject": "Improve documentation for buffer-size option."
},
{
"commit": "1f7c7b7dda1c736fab2673084498fc7c220b742a",
"date": "2021-10-26 16:56:44 -0400",
"subject": "Fix test descriptions in common/typeVariantTest."
},
{
"commit": "d74fe7a222c1e1ae0f02addbeb712f8946d3d731",
"date": "2021-10-26 13:53:44 -0400",
"subject": "Add coverage for empty CATCH() blocks.",
"body": "Currently empty CATCH() blocks are always marked as covered because of the loop structure of error handling.\n\nA prototype implementation of error handling without looping has shown that these CATCH() blocks are not covered without new tests. Whether or not that prototype gets committed it is worth adding the tests."
},
{
"commit": "e2eea974c144f77448aa9d5fbb55c933b70ea5ad",
"date": "2021-10-26 12:09:41 -0400",
"subject": "Add assertion for Coverity.",
"body": "Coverity thinks this value might be NULL but that should not be possible because of the TRY...CATCH block."
},
{
"commit": "4f10441574761c9cd4e31cdef750742e004ae669",
"date": "2021-10-26 08:25:21 -0400",
"subject": "Add missing paragraph tags in coding standards."
},
{
"commit": "7fb99c59c88fe11c679d6ba7835f995a969462c0",
"date": "2021-10-26 07:46:48 -0400",
"subject": "Use externed instead of extern'd in comments.",
"body": "This is mostly to revert some comment changes in b11ab9f7 that will break the ppc64le patch, but at the same time keep the spelling consistent in all comments and documentation.\n\nAlso revert some space changes for the same reason."
},
{
"commit": "653ffcf8d98ebfe94ae44ed54b4a295428c57850",
"date": "2021-10-25 15:42:28 -0400",
"subject": "Adjustments for new breaking change in Azurite.",
"body": "Azurite released another breaking change (see fbd018cd, 096829b3, c38d6926, and Azurite issue 1039) so make adjustments as needed to documentation and tests.\n\nAlso remove some dead code that hid the repo-storage-host option and was made obsolete by all these changes."
},
{
"commit": "13d4559708819787ad05be6f37ec0badb0eccae5",
"date": "2021-10-25 15:31:39 -0400",
"subject": "Check return value of getsockopt().",
"body": "Checking the return value is not terribly important here, but if setsockopt() fails it is likely that bind() will fail as well. May as well get it over with and this makes Coverity happy."
},
{
"commit": "1152f7a7d64e69eed1d9e74b48a308f6c742c28a",
"date": "2021-10-25 12:56:33 -0400",
"subject": "Fix mismatched parameters in tlsClientNew() call.",
"body": "3879bc69 added this call and the parameters were not quite right but in way that the compiler decided they were OK. It was mostly working but TLS verification was disabled if caPath was NULL, which is not OK."
},
{
"commit": "a1a2284c881ba6c3b9b1c316b31e0583c006f1af",
"date": "2021-10-25 09:01:22 -0400",
"subject": "Fix typos in error messages."
},
{
"commit": "3879bc69b888daa04d2ca98a2d1219cf22519ddc",
"date": "2021-10-22 18:31:55 -0400",
"subject": "Add WebIdentity authentication for AWS S3.",
"body": "This allows credentials to be automatically acquired in an EKS environment."
},
{
"commit": "51785739f44b624091246c48af6defe97c30d7a7",
"date": "2021-10-22 18:02:20 -0400",
"subject": "Store config values as a union instead of a variant.",
"body": "The variants were needed to easily serialize configurations for the Perl code.\r\n\r\nUnions are more efficient and will allow us to add new types that are not supported by variants, e.g. StringId."
},
{
"commit": "2cea005f740d640290a9948595f5933833e30e7d",
"date": "2021-10-22 17:19:16 -0400",
"subject": "Fix segfault on invalid GCS key file."
},
{
"commit": "cb36fec102855bf268ec5234bbb5261be98bdc61",
"date": "2021-10-21 17:48:00 -0400",
"subject": "Add analytics to the HTML documentation."
},
{
"commit": "a63e732987bc1f6f26514568dabc6c0b23df07ab",
"date": "2021-10-21 17:25:32 -0400",
"subject": "Fix indentation."
},
{
"commit": "78e1bd333068c4a857054490698115fa2c698e0b",
"date": "2021-10-21 17:10:00 -0400",
"subject": "Move v1 documentation links out of the introduction.",
"body": "There should be few if any users running v1 now so these links do not need to be so prominent."
},
{
"commit": "861df2a73cafbd49049dccdc55d5214b00dd3cec",
"date": "2021-10-21 17:02:46 -0400",
"subject": "Add GitHub repository link to index.html and README.md."
},
{
"commit": "1cb8ae15de5b4276682bdd9825ca97012cd43855",
"date": "2021-10-21 13:51:59 -0400",
"subject": "Fix incorrect host name in user guide.",
"body": "The text indicates to populate the pg-primary IP address into the pg_hba.conf file to allow replication connections. It should indicate to populate the pg-standby IP address"
},
{
"commit": "b11ab9f799aa6fc32dd03e96e8a0428d5c83d9ae",
"date": "2021-10-21 13:31:22 -0400",
"subject": "Fix typos."
},
{
"commit": "8ad6b7330e1ee6bcbc0f06ec0562a433e7888f44",
"date": "2021-10-21 09:20:40 -0400",
"subject": "Fix outdated comment.",
"body": "This check was moved from within the path checks at some point but the comment did not get updated."
},
{
"commit": "fbd018cd56482efff425beb4026fe22482115138",
"date": "2021-10-20 08:22:37 -0400",
"subject": "Allow S3/Azure Docker images to be specified in user guide.",
"body": "It is not uncommon for the S3/Azure emulators we use to introduce breaking changes without warning. If that happens the documentation can still be built by specifying a working version of the image. In general, it is better to let the version float so we know when things break.\n\nAzurite has yet another breaking change coming up (see 096829b3, c38d6926, and Azurite issue 1039) so set azure-image at the current version until the breaking change has been released."
},
{
"commit": "5dfdd6dd5b7b43dc3a223b9552aed4052d0db3aa",
"date": "2021-10-19 12:45:20 -0400",
"subject": "Add -Werror -Wfatal-errors -g flags to configure --enable-test.",
"body": "These flags are used for all tests but it was not possible to add them to configure before the change in 046d6643. This is especially important for adhoc tests to ensure the flags are not forgotten.\n\nRemove the flags from test make commands where they were being applied.\n\nThere is no change for production builds."
},
{
"commit": "046d6643373859c5e848a97e06389ed2aa553723",
"date": "2021-10-19 12:14:09 -0400",
"subject": "Set most compiler flags as late as possible in configure.",
"body": "Some flags, e.g. -Wfatal-errors, will cause tests in configure to behave incorrectly so we have not been able to add them to --enable-test.\n\nAdd the compiler flags as late as possible so configure checks are not affected. This will allow us to add flags that we need for testing without having to explicitly pass them to make."
},
{
"commit": "e443e3c6c05c9d65a67dac0c8430b59239fbc1b8",
"date": "2021-10-19 09:06:06 -0400",
"subject": "Add br tags for HTML documentation rendering missed in def7d513."
},
{
"commit": "4c2d89eb66e11017e2e73ad4171e4493c28acdad",
"date": "2021-10-18 16:43:19 -0400",
"subject": "Fix typos."
},
{
"commit": "6cc8e45df68c299990c0ad1f40c53b9282cb46db",
"date": "2021-10-18 14:45:36 -0400",
"subject": "Add missing paragraph tag in user guide."
},
{
"commit": "ccc255d3e05d8ce2b6ac251d1498f71b04098a86",
"date": "2021-10-18 14:32:41 -0400",
"subject": "Add TLS Server.",
"body": "The TLS server is an alternative to using SSH for protocol connections to remote hosts.\n\nThis command is currently experimental and intended only for trial and testing. As such, the new commands and options will not show up in the command-line help unless directly requested."
},
{
"commit": "09fb9393f14b47effebaecc449a97ad07ef4c752",
"date": "2021-10-18 14:02:05 -0400",
"subject": "Write command configuration overrides explicitly.",
"body": "If not written explicitly then it is impossible to distinguish the override from a NULL, which indicates no override."
},
{
"commit": "90f7f11a9f71152185219bbb57bf1de001e3a91b",
"date": "2021-10-18 12:22:48 -0400",
"subject": "Add missing static keywords in test modules."
},
{
"commit": "4570c7e27528400373ece8dc7bd348baf3ff064e",
"date": "2021-10-18 11:32:53 -0400",
"subject": "Allow error buffer to be resized for testing.",
"body": "Some tests can generate very large error messages for diffs and they often get cut off before the end.\n\nAlso fix a test so it does not create too large a buffer on the stack."
},
{
"commit": "838ee3bd08c739e3dcf611e9bddfaa6c8acbb2aa",
"date": "2021-10-18 11:05:53 -0400",
"subject": "Increase some storage test timeouts.",
"body": "32-bit Debian 9 is sometimes timing out on these tests so increase the timeouts to make the tests more reliable."
},
{
"commit": "6b9e19d423d99d3063c4bff3d3533b1e5081e4cb",
"date": "2021-10-16 12:35:47 -0400",
"subject": "Convert configuration optional rules to pack format.",
"body": "The previous format was custom for configuration parsing and was not as expressive as the pack format. An immediate benefit is that commands with the same optional rules are merged.\n\nDefaults are now represented correctly (not multiplied), which simplifies the option default functions used by help."
},
{
"commit": "360cff94e4e9e1ab5a690a1f5c38eb278158a892",
"date": "2021-10-16 12:33:31 -0400",
"subject": "Update 32-bit test container to Debian 9.",
"body": "Also rebalance PostgreSQL version integration tests."
},
{
"commit": "0e84c19a9fde0480b30078f5d3b419267b2f7673",
"date": "2021-10-15 17:50:54 -0400",
"subject": "Remove allow range from pg-socket-path option.",
"body": "The allow range was never processed because the string type does not allow ranges, but it is wasteful to have it in the parse rules.\n\nIt would be good if auto-generation errored on useless allow ranges, but that will need wait since it does not impact production."
},
{
"commit": "144469b9772bad14466fcafc65edef58c5366755",
"date": "2021-10-15 15:50:55 -0400",
"subject": "Add const buffer functions to Pack type.",
"body": "These allow packs to be created without allocating a buffer in the case that the buffer already exists or the data is in a global constant.\n\nAlso fix a rendering issue in hrnPackReadToStr()."
},
{
"commit": "66bfd1327e56f0f2de99fc6009431f3ee06ad6b8",
"date": "2021-10-13 19:48:41 -0400",
"subject": "Rename SSH connection control parameters in integration tests."
},
{
"commit": "447b24309d02938d04e036ec7814e75982210eb4",
"date": "2021-10-13 19:43:40 -0400",
"subject": "Update RHEL package URL."
},
{
"commit": "01b20724daf4c5cb25d6f636fb90456759773d22",
"date": "2021-10-13 19:36:59 -0400",
"subject": "Rename PostgreSQL pid file constants and tests."
},
{
"commit": "570162040864b8c56b236aa66d8f5c8d610b754b",
"date": "2021-10-13 19:02:58 -0400",
"subject": "Rename manifest file primary flag in tests."
},
{
"commit": "a44f9e373b47354a09bec0eaf2f3bf9e261c6941",
"date": "2021-10-13 13:21:04 -0400",
"subject": "Update Vagrantfile to Ubuntu 20.04."
},
{
"commit": "b16e827d69364408ea687a8e4b8894f7e889792e",
"date": "2021-10-13 13:20:11 -0400",
"subject": "Do not show output of PostgreSQL upgrade status check in user guide.",
"body": "On some platforms the output may contain UTF-8 characters that the latex code is not prepared to handle.\n\nShowing the command is much more important than showing the output, so no big loss."
},
{
"commit": "5e84645ac030544b572036c08d055885d96d8905",
"date": "2021-10-13 12:16:47 -0400",
"subject": "Update comments referring to the PostgreSQL primary."
},
{
"commit": "430efff98a5b8dcf7c048f383abc12d9c0e5bbf0",
"date": "2021-10-13 12:01:53 -0400",
"subject": "Update documentation/links to main branch."
},
{
"commit": "1212668d5eff51756b0719b5296f7640e8096605",
"date": "2021-10-13 11:43:14 -0400",
"subject": "Update contributing.xml with rendering changes from def7d513.",
"body": "Also update help.xml path missed in f4e1babf."
},
{
"commit": "90c73183ea5de6a63a23a9047ae2debb3f59b940",
"date": "2021-10-13 09:37:03 -0400",
"subject": "Add libc6-dbg required by updated valgrind to Vagrantfile/Dockerfile."
},
{
"commit": "c2d4552b7328489d703dc03defa769b1ccb8f739",
"date": "2021-10-13 08:51:58 -0400",
"subject": "Add debug options to code generation make in test.pl."
},
{
"commit": "bd91ebca759d2d6cfc2f7aa660366f5f7f09994a",
"date": "2021-10-12 16:16:05 -0400",
"subject": "Remove command overrides for output options.",
"body": "The overrides are not needed since both commands require the same default and allow list."
},
{
"commit": "e8e346bc8738815b07bd80a37ace862fdab3dc1d",
"date": "2021-10-12 08:53:12 -0400",
"subject": "Remove command overrides for restore-only options.",
"body": "The overrides are not needed since these options are only valid for one command."
},
{
"commit": "576b04763477877d4f2a61ad692703e20471901b",
"date": "2021-10-11 16:25:36 -0400",
"subject": "Invert required in set option to simplify generated rules."
},
{
"commit": "980b777a4a0cc07200ccb06cc55b89181101b266",
"date": "2021-10-09 12:39:54 -0400",
"subject": "Fix indentation."
},
{
"commit": "cc7f2eea900d0a7a429ffdc2cd45ead88c0298a9",
"date": "2021-10-09 12:37:25 -0400",
"subject": "Add assert in pckReadNext() to prevent reading into a field."
},
{
"commit": "610bfd736ef091a8298e5602d41aba86f10189bb",
"date": "2021-10-09 12:34:45 -0400",
"subject": "Increase tolerance for 0ms sleep in common/time test."
},
{
"commit": "7ab8dcbe6e007831e8a7f9f26e08f083c1026388",
"date": "2021-10-09 12:15:19 -0400",
"subject": "Read tag size in pckReadTagNext().",
"body": "Rather than reading the size everywhere it is needed, get it when the tag is read, if it exists.\n\nThis simplifies logic around consuming the data when not needed. There are more use cases for this coming up."
},
{
"commit": "ed68792e765411a994d8ac79e4d047bbafc25582",
"date": "2021-10-07 19:57:28 -0400",
"subject": "Rename strNewN() to strNewZN().",
"body": "Make the function name consistent with other functions that accept zero-terminated strings, e.g. strNewZ() and strCatZN()."
},
{
"commit": "b7e17d80ea02d70e56327828310c578af51795b5",
"date": "2021-10-07 19:43:28 -0400",
"subject": "More efficient memory allocation for Strings and String Variants.",
"body": "The vast majority of Strings are never modified so for most cases allocate memory for the string with the object. This results in one allocation in most cases instead of two. Use strNew() if strCat*() functions are needed.\n\nUpdate varNewStr() in the same way since String Variants can never be modified. This results in one allocation in all cases instead of three. Also update varNewStrZ() to use STR() instead of strNewZ() to save two more allocations."
},
{
"commit": "208641ac7fd22f676a55e7305b3e69df574f36f8",
"date": "2021-10-07 18:50:56 -0400",
"subject": "Use constant string for user/group in performance/type test.",
"body": "It is not safe to return strings created with STRDEF() from a function."
},
{
"commit": "74d3131830646c9f71ffa9847729cae40e3aa866",
"date": "2021-10-07 14:58:11 -0400",
"subject": "More efficient generation of diff/incr backup label."
},
{
"commit": "498902e885c9d7a44648ccc01b20454094d5b742",
"date": "2021-10-07 12:18:24 -0400",
"subject": "Allow \"global\" as a stanza prefix.",
"body": "A stanza name like global_stanza was not allowed because the code was not selective enough about how a global section should be formatted.\r\n\r\nUpdate the config parser to correctly recognize global sections."
},
{
"commit": "338102861fd0ea4d2773b010dee34a39a96ad702",
"date": "2021-10-07 11:01:48 -0400",
"subject": "Improve instructions for rebuilding pgbackrest during stress testing."
},
{
"commit": "fb3f6928c9aef499938e195fbb612c1940a2dc19",
"date": "2021-10-06 19:27:04 -0400",
"subject": "Add configurable storage helpers to create repository storage.",
"body": "Remove the hardcoded storage helpers from storageRepoGet() except for the the built-in Posix helper and the special remote helper.\n\nThe goal is to make storage driver development a bit easier by isolating as much of the code as possible into the driver module. This also makes coverage reporting much simpler for additional drivers since they do not need to provide coverage for storage/helper.\n\nConsolidate the CIFS tests into the Posix tests since CIFS is just a special case of the Posix.\n\nTest all storage features in the Posix test so that other storage driver tests do not need to provide coverage for storage/storage.\n\nRemove some dead code in the storage/s3 test."
},
{
"commit": "cfd823355af2ac99f30c5e1393a121c6dbf622b7",
"date": "2021-10-06 12:38:56 -0400",
"subject": "Refactor S3 storage driver for additional auth methods.",
"body": "Currently only two auth methods are supported and a lot of refactoring is required to add a third one.\n\nDo the refactoring now to reduce noise in the commit that adds the third auth method."
},
{
"commit": "68c5f3eaf18fc9bd10fde15a323890bcdcbf4534",
"date": "2021-10-05 17:59:05 -0400",
"subject": "Allow link-map option to create new links.",
"body": "Currently link-map only allows links that exist in the backup manifest to be remapped to a new destination.\r\n\r\nAllow link-map to create a new link as long as a valid path/file from the backup is referenced."
},
{
"commit": "f2aeb30fc706c04d6200cefeeb2645229a31ff69",
"date": "2021-10-05 14:06:59 -0400",
"subject": "Add state to ProtocolClient.",
"body": "This is currently only useful for debugging, but in the future the state may be used for resetting the protocol when something goes wrong."
},
{
"commit": "2c65fed80f47124283d4f8be92f987dc55237f48",
"date": "2021-10-05 12:29:16 -0400",
"subject": "Add missing asserts and move temp mem context block."
},
{
"commit": "6af827cbb1e78cd4c5d649ed4cb24c49a7204b8f",
"date": "2021-10-05 09:00:16 -0400",
"subject": "Report original error and retries on local job failure.",
"body": "The local process will retry jobs (e.g. backup file) but after a certain number of failures gives up. Previously, the last error was reported but generally the first error is far more valuable. The last error is likely to be a cascade failure such as the protocol being out of sync.\r\n\r\nReport the first error (and stack trace) and append the retry errors to the first error without stack trace information."
},
{
"commit": "34f78734325743b4e34cb39224852e6debf49750",
"date": "2021-10-04 13:45:53 -0400",
"subject": "Report backup file validation errors in backup.info.",
"body": "Currently errors found during the backup are only available in text output when specifying --set.\r\n\r\nAdd a flag to backup.info that is available in both the text and json output when --set is not specified. This at least provides the basic info that an error was found in the cluster during the backup, though details are still only available as described above."
},
{
"commit": "57c62315465972f6b85558020198134e34cf2ee0",
"date": "2021-10-02 17:27:33 -0400",
"subject": "Add arm64 testing on Cirrus CI.",
"body": "These tests run in a container without permissions to mount tempfs, so add an option to ci.pl to not create tempfs. Also add some packages not in the base image."
},
{
"commit": "f1ed8f0e5112d1a74d86168e67632be55eddb416",
"date": "2021-10-02 16:29:31 -0400",
"subject": "Sort WAL segment names when reporting duplicates.",
"body": "Make the output consistent even when files are listed in a different order. This is purely for testing purposes, but there is no harm in consistent output.\n\nFound on arm64."
},
{
"commit": "71047a9d6d1eea71b3fbd430983541a54049cc69",
"date": "2021-10-02 16:17:33 -0400",
"subject": "Use strncpy() to limit characters copied to optionName.",
"body": "Valgrind complained about uninitialized values on arm64 when comparing the reset prefix, probably because \"reset\" ended up being larger than the option name: Conditional jump or move depends on uninitialised value(s) at cfgParseOption (parse.c:568).\n\nCoverity complained because it could not verify the size of the string to be copied into optionName, probably because it does not understand the purpose of strSize(): You might overrun the 65-character fixed-size string \"optionName\" by copying the return value of \"strZ\" without checking the length.\n\nUse strncpy() even though we have already checked the size and make sure the string is terminated. Keep the size check because searching for truncated option names is not a good idea.\n\nThis is not a production bug since the code has not been released yet."
},
{
"commit": "b792a14cd7dbdfb61362700ffc5fc01997db890c",
"date": "2021-10-01 18:23:03 -0400",
"subject": "Use temp mem context when calling command handlers.",
"body": "It is safer and more efficient to free memory after each handler completes.\n\nThe db command handlers use the server context so update them to use the top context."
},
{
"commit": "ae40ed6ec9cf77e577518b128518a5763767f589",
"date": "2021-10-01 17:15:36 -0400",
"subject": "Add jobRetry parameter to HRN_CFG_LOAD().",
"body": "Allow the default of 0 to be overridden to test retry behavior for commands."
},
{
"commit": "136d309dd4bc1ada9f3d775f036b62292fda390b",
"date": "2021-10-01 15:29:31 -0400",
"subject": "Allow stack trace to be specified for errorInternalThrow().",
"body": "This allows the stack trace to be set when an error is received by the protocol, rather than appending it to the message. Now these errors will look no different than any other error and the stack trace will be reported in the same way.\n\nOne immediate benefit is that test.pl --vm-out --log-level-test=debug will work for tests that check expect log results. Previously, the test would error at the first check because the stack trace included in the message would not match the expected log output."
},
{
"commit": "62f6fbe2a9ecd9bc48611ecfaf27a05b9f36a87d",
"date": "2021-10-01 10:15:34 -0400",
"subject": "Update file mode in info/manifest test to 0600.",
"body": "0400 is not a very realistic mode. It may have become the default due to copy-pasting."
},
{
"commit": "0690cb25a077735780b2fe24343c946f8a4efbc6",
"date": "2021-09-30 17:55:38 -0400",
"subject": "Remove repository format 6 notes.",
"body": "The notes have been moved to a Github project."
},
{
"commit": "376362475e3b3b13b70313d9002d4ff8b25b4b40",
"date": "2021-09-30 16:15:45 -0400",
"subject": "Move archive-header-check option to the archive reference section."
},
{
"commit": "cf1a57518fe3230886509f59fcec9c9a81e6513c",
"date": "2021-09-30 14:29:49 -0400",
"subject": "Refactor restoreManifestMap() to be driven by link-map.",
"body": "This will allow new links to be added in a future commit. The current implementation is driven by the links that already exist in the manifest, which would make the new use case more complex to implement.\n\nAlso, add a more helpful error when a tablespace link is specified."
},
{
"commit": "d89a67776cfbb7b3047dbe297cc0c768e5c670e8",
"date": "2021-09-30 13:39:29 -0400",
"subject": "Refactor restoreManifestMap() tests in the command/restore unit.",
"body": "Add test titles, new tests, and rearrange.\n\nAlso manifestTargetFindDefault(), which will soon be used by core code in a refactoring commit."
},
{
"commit": "7a53ba7c7f38bff2c9ef99c6ab58d22c59dd2290",
"date": "2021-09-30 13:28:14 -0400",
"subject": "Add note to comment for int64 typedef."
},
{
"commit": "815377cc6009c800b6a5fdc1fe98ddfceaaae824",
"date": "2021-09-30 13:27:14 -0400",
"subject": "Finalize catalog number for PostgreSQL 14 release."
},
{
"commit": "baf186bfb05ca683714a59485900892f5e7e8a1b",
"date": "2021-09-29 12:03:01 -0400",
"subject": "Fix comment typos."
},
{
"commit": "9e79f0e64b661e944ce2b3897c366feea1544ac2",
"date": "2021-09-29 10:31:51 -0400",
"subject": "Add recovery start time to online backup restore log.",
"body": "This helps give an idea of how much recovery needs to be done to reach the end of the WAL stream and is easier to read than the backup label."
},
{
"commit": "9346895f5b61627b50d431f09447e08d8a50caa8",
"date": "2021-09-29 09:58:47 -0400",
"subject": "Rename page checksum error to error list in info text output.",
"body": "\"error list\" makes it clearer that other errors may be reported. For example, if checksum-page is true in the manifest but no checksum-page-error list is provided then the error is in alignment, i.e. the file size is not a multiple of the page size, with allowances made for a valid-looking partial page at the end of the file.\r\n\r\nIt is still not possible to differentiate between alignment and page checksum errors in the output but this will be addressed in a future commit."
},
{
"commit": "b7ef12a76f219881d0b24c715592af96fe5c9b8f",
"date": "2021-09-28 15:55:13 -0400",
"subject": "Add hints to standby replay timeout message."
},
{
"commit": "096829b3b257444162417662612e80d8cb2ac6ec",
"date": "2021-09-27 09:01:53 -0400",
"subject": "Add repo-azure-uri-style option.",
"body": "Azurite introduced a breaking change in 8f63964e to use automatically host-style URIs when the endpoint appears to be a multipart hostname.\n\nThis option allows the user to configure which style URI will be used, but changing the endpoint might cause breakage if Azurite decides to use a different style. Future changes to Azurite may also cause breakage."
},
{
"commit": "c8ea17c68f8fa72f2bf3b979539be3f709448493",
"date": "2021-09-24 17:40:31 -0400",
"subject": "Convert page checksum filter result to a pack.",
"body": "The pack is both more compact and more efficient than a variant.\n\nAlso aggregate the page error info in the main process rather than in the filter to allow additional LSN filtering, to be added in a future commit."
},
{
"commit": "ac1f6db4a25520b1ee957b66925dde2e1ef156ab",
"date": "2021-09-23 14:06:00 -0400",
"subject": "Centralize and optimize tag stack management.",
"body": "The push and pop code was duplicated in four places, so centralize the code into pckTagStackPop() and pckTagStackPush().\n\nAlso create a default bottom item for the stack to avoid allocating a list if there will only ever be the default container, which is very common. This avoids the extra time and memory to allocate a list."
},
{
"commit": "15e7ff10d3d6fe3570335a5abec5ff683c07e2e6",
"date": "2021-09-23 08:31:32 -0400",
"subject": "Add Pack pseudo-type.",
"body": "Rather than working directly with Buffer types, define a new Pack pseudo-type that represents a Buffer containing a pack. This makes it clearer that a pack is being stored and allows stronger typing."
},
{
"commit": "131ac0ab5e98500569d4ff6985d31c55a9ef53b9",
"date": "2021-09-22 11:18:12 -0400",
"subject": "Rename pckReadNew()/pckWriteNew() to pckReadNewIo()/pckWriteNewIo().",
"body": "These names more accurately describe the purpose of the constructors."
},
{
"commit": "0e76ccb5b7b2089f8d0300ab0086c454aebbbbbf",
"date": "2021-09-22 10:48:21 -0400",
"subject": "Convert filter param/result to Pack type.",
"body": "The Pack type is more compact and flexible than the Variant type. The Pack type also allows binary data to be stored, which is useful for transferring the passphrase in the CipherBlock filter.\n\nThe primary purpose is to allow more (and more complex) result data to be returned efficiently from the PageChecksum filter. For now the PageChecksum filter still returns the original Variant. Converting the result data will be the subject of a future commit.\n\nAlso convert filter types to StringId."
},
{
"commit": "802373cb9df28384529fe5a7bd102bfe5c8f3911",
"date": "2021-09-21 10:16:16 -0400",
"subject": "Limit valgrind error output to the first error.",
"body": "Generally the first error is the only important error. The rest simply lead to a lot of scrolling."
},
{
"commit": "473afce57bc7646c53bae4a6300b41b11b5b0357",
"date": "2021-09-20 11:03:50 -0400",
"subject": "Copy data page before verifying checksum.",
"body": "Using UNCONSTIFY() is potentially dangerous since the buffer is modified while calculating the checksum, even though the page is reverted to the original state. Instead make a copy to ensure that the original data is never modified.\n\nThis requires the logic to be shuffled a bit since the copy cannot be made until we are sure the page is complete."
},
{
"commit": "0efb8adb9452cb8bc67ebaa8b6dca0d4a69c1682",
"date": "2021-09-19 20:38:51 -0400",
"subject": "Automatically include all PostgreSQL version interface files."
},
{
"commit": "95d814cf81b84d162f40717346c3ad0cb642f724",
"date": "2021-09-19 20:32:27 -0400",
"subject": "Specify size for helpData array."
},
{
"commit": "912a498b0bcc988bd5ebaaa22198956d752251bd",
"date": "2021-09-11 16:07:59 -0400",
"subject": "Skip comments when rendering help output.",
"body": "Comments should not appear in the help. They are simply notes on implementation."
},
{
"commit": "c38d6926d6c9aa01b895a28e66fc0aa6965350a3",
"date": "2021-09-09 08:48:45 -0400",
"subject": "Revert Azurite version for testing to 3.14.0.",
"body": "3.14.2 is causing breakage in the documentation. There is no obvious cause so for now just revert to the last working version."
},
{
"commit": "f4e1babf6b4ce7087ace8221cac7cadb51488f0e",
"date": "2021-09-08 18:16:06 -0400",
"subject": "Migrate command-line help generation to C.",
"body": "Command-line help is now generated at build time so it does not need to be committed. This reduces churn on commits that add configuration and/or update the help.\n\nSince churn is no longer an issue, help.auto.c is bzip2 compressed to save space in the binary.\n\nThe Perl config parser (Data.pm) has been moved to doc/lib since the Perl build path is no longer required.\n\nLikewise doc/xml/reference.xml has been moved to src/build/help/help.xml since it is required at build time."
},
{
"commit": "def7d513cdd2d4579acf6e8c675a3d6f7da4f655",
"date": "2021-09-08 17:35:45 -0400",
"subject": "Eliminate linefeed formatting from documentation.",
"body": "Linefeeds were originally used in the place of tags to denote a paragraph. While much of the linefeed usage has been replaced over time, there were many places where it was still being used, especially in reference.xml. This made it difficult to get consistent formatting across different output types. In particular there were formatting issues in the command-line help because it is harder to audit than HTML or PDF.\n\nReplace linefeed formatting with proper
tags to make formatting more consistent.\n\nRemove double spaces in all text where
tags were added since it does not add churn.\n\nUpdate all
//- tags to the more general
/ tags.\n\nAdd a few missing periods."
},
{
"commit": "245b0c048ae62eb174b534d156b7a00b1de19a53",
"date": "2021-09-08 13:32:13 -0400",
"subject": "Add initializer braces required by older versions of gcc."
},
{
"commit": "38eeac48d617ec5d5f14a1cb612c9a8b721326d8",
"date": "2021-09-03 10:39:30 -0400",
"subject": "Remove invalid comment block."
},
{
"commit": "1afea449e2f54e69f9f8f0d772a294fcf09e0d83",
"date": "2021-09-02 13:26:21 -0400",
"subject": "Build newer valgrind and move CA cert install in test containers.",
"body": "The newer version of valgrind helps with some arm64 issues that have been fixed since the architecture has become more popular. Also add the valgrind builds to the Vagrantfile and Dockerfile.\n\nMove the CA cert install from the base container to the test container. This means the CA cert can be changed without rebuilding all the base containers."
},
{
"commit": "475b57c89b58e9709a3eafd08fe9949b467a99cd",
"date": "2021-09-01 11:10:35 -0400",
"subject": "Allow additional memory to be allocated with a mem context.",
"body": "The primary benefit is that objects can allocate memory for their struct with the context, which saves an additional allocation and makes it easier to read context/allocation dumps. Also, the memory context does not need to be stored with the object since it can be determined using the object pointer.\n\nObject pointers cannot be moved, so this means whatever additional memory is allocated cannot be resized. That makes the additional memory ideal for object structs, but not so much for allocating a list that might change size.\n\nMem contexts can no longer be reused since they will probably be the wrong size so their memory is freed on memContextFree(). This still means fewer allocations and frees overall.\n\nInterfaces still need to be freed by mem context so the old objMove() and objFree() have been preserved as objMoveContext() and objFreeContext(). This will be addressed in a future commit."
},
{
"commit": "02b06aa4957cf3fe64ceb7a44cc1893bff12fe99",
"date": "2021-08-31 12:09:50 -0400",
"subject": "Increase max index allowed for pg/repo options to 256.",
"body": "The prior limitations were based on using getopt_long() to parse command-line options, which required a static list of allowed options. Setting index max too high bloated the binary unacceptably. 45a4e80 replaced the functionality of getopt_long() but the static list remained.\r\n\r\nImprove cfgParseOption() to use available option data and remove the need for a static list. This also allows the option deprecations to be represented more compactly.\r\n\r\nIndex max is still capped at 256 because a large enough index could cause parseOptionIdxValue() to run out of memory since it allocates a static list based on the highest index found. If that function were improved with a map of found index values then index max could be set to UINT64_MAX.\r\n\r\nNote that deprecations no longer set an index max or define whether reset is valid. These were space-saving measures which are no longer required. This means that indexed deprecated options will also be valid up to 256 and always allow reset, but it doesn't seem worth additional code to limit this behavior.\r\n\r\ncfgParseOptionId() is no longer needed because calling cfgParseOption() with .ignoreMissingIndex = true duplicates the functionality of cfgParseOptionId(). This leads to some simplification in the help code."
},
{
"commit": "8a4063c2b69919d1bba305d986568f529139eaa3",
"date": "2021-08-27 06:41:56 -0400",
"subject": "Add required header for Illumos."
},
{
"commit": "5d857e196a6eeb2e1d137f2faf9001cccc066cfd",
"date": "2021-08-25 07:33:31 -0400",
"subject": "Do not use certs in container for testing.",
"body": "The certs are available in test/certificate so it makes more sense to use them there. In addition the container does not need to be rebuilt unless the CA cert changes."
},
{
"commit": "7b4d69211e64855f9ca0db0e4b2950a6492afa59",
"date": "2021-08-23 16:09:14 -0400",
"subject": "Add missing header."
},
{
"commit": "beafdbfc1873902f4b17fbbc5f88e47d6344d113",
"date": "2021-08-23 08:37:57 -0400",
"subject": "Add const to memContextFreeing()/memContextName() parameters.",
"body": "These functions do not modify the mem context so they can use const pointers."
},
{
"commit": "726d04f13a2217b78e2cbef48ef4c889f15b5b68",
"date": "2021-08-23 08:31:50 -0400",
"subject": "Remove useless if in memContextFree().",
"body": "If the upper bound of the loop is 0 then nothing will be done, making the if condition extraneous."
},
{
"commit": "d72d4415a7c79296e3160aede9df59cd5d959694",
"date": "2021-08-23 08:27:07 -0400",
"subject": "Use contextParentIdx instead of a loop when moving a context.",
"body": "contextParentIdx was introduced in 90709dfd to improve the performance of mem context frees. memContextMove() did not get the message, however, and continued to use a loop to find the mem context in the old parent.\n\nUse contextParentIdx to find the mem context in the old parent to avoid a loop."
},
{
"commit": "8a9887f27cb46728e85801e075474928207e012f",
"date": "2021-08-23 07:58:59 -0400",
"subject": "Remove useless memFree() in regExpNew().",
"body": "The MEM_CONTEXT_NEW*() block will automatically free memory if there is an error.\n\nThis code is pretty old so this may not have been true when it was written."
},
{
"commit": "5ffb7cc77127a60de98e2d9080f27ed28bf95b4f",
"date": "2021-08-23 07:14:22 -0400",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "aee0e7bac746c5c68baee106d8d4809cf6d8edfd",
"date": "2021-08-23 07:03:40 -0400",
"subject": "Begin v2.36 development."
},
{
"commit": "3787cf78032cb928f27044c13b6f50d57bf06d20",
"date": "2021-08-23 06:52:51 -0400",
"subject": "v2.35: Binary Protocol"
},
{
"commit": "ad5e06399008118d81f41fb103ef2e980343899b",
"date": "2021-08-19 17:25:57 -0400",
"subject": "Update containers for new PostgreSQL releases.",
"body": "Also add a package that is required for older Debian versions."
},
{
"commit": "590e75996891ff1328a4a8f58bf833f4b34b6bf6",
"date": "2021-08-19 11:57:37 -0400",
"subject": "Rename stringz.h to stringZ.h.",
"body": "This is more consistent with our file naming conventions."
},
{
"commit": "0354144c900eb52d0fa9a9166704d225a968eab5",
"date": "2021-08-19 11:35:49 -0400",
"subject": "Add instructions for dev builds to stress test in user guide."
},
{
"commit": "9b45df70573d54c3a1aa81848642460a9ddc5b28",
"date": "2021-08-19 11:12:56 -0400",
"subject": "Rearrange MemContext struct members to save space on 64-bit.",
"body": "On 64-bit systems this saves a bit of space (10%) due to alignment. 32-bit systems see no benefit.\n\nAlso add tests for the individual struct sizes."
},
{
"commit": "bab7a01f9971b7b45e384141f1777fc86853937e",
"date": "2021-08-19 11:00:17 -0400",
"subject": "Mark contextTop static.",
"body": "This variable is not used outside of the memContext module so no need for it to be extern'd."
},
{
"commit": "bb1ca1d3099db2ccb5cdd11a90a9d62ecabc009b",
"date": "2021-08-18 13:32:16 -0400",
"subject": "Change ASSERT() to CHECK() in infoLoad().",
"body": "Coverity complains that \"Argument loaded of ASSERT() has a side effect because the variable is volatile. The containing function might work differently in a non-debug build.\"\n\nIt does not look like this is a real issue, but a CHECK() here is not too expensive for production so change it to silence Coverity.\n\nAlso fix a typo in the comment."
},
{
"commit": "9ddfcd6a6de5cfd8acf1470216365d6951a692b8",
"date": "2021-08-18 13:23:24 -0400",
"subject": "Remove dead loop in verifyArchive().",
"body": "This loop has been dead since the code was initially committed in ad79932b. It looks like it was used at one point but became dead when the enclosing if-else was added during development.\n\nFound by Coverity."
},
{
"commit": "56ad42765311dd399b3b76025ac639c98bcd6027",
"date": "2021-08-18 10:52:35 -0400",
"subject": "Add variables for build paths in the user guide.",
"body": "This eliminates repetition of the build path so it can be changed more easily.\n\nAlso create the build path explicitly rather than suggest that the user do it."
},
{
"commit": "944a9e8ff10747a4d15187649fcc84308b7d0db9",
"date": "2021-08-18 10:17:10 -0400",
"subject": "Reduce memory requirements of stress test section in the user guide.",
"body": "The standby memory was set to 1024mb in 86a651f9 to compensate for a memory leak in restore. The leak has been fixed (or at least mitigated) in e1e6e475 and 4fb6384f so the memory can be reduced to 512mb, the same as the primary."
},
{
"commit": "d69a5963587136b91abb318aa56efc7249c14a64",
"date": "2021-08-18 09:48:37 -0400",
"subject": "Fix infinite loop in protocolServerProcess() on error.",
"body": "The error was written to the client and then another command read. If the write did not fail then the loop would never exit.\n\nInstead exit on any error that is not raised by the command handler as we can pretty safely assume this is an unrecoverable protocol error. The command handler might throw a protocol error itself, but this should be caught in the next read or write in the main loop."
},
{
"commit": "9a6afe3fc16fcb0685613308e47c19f6b11e7e35",
"date": "2021-08-18 09:32:20 -0400",
"subject": "Fix EOF behavior of ioReadSmall() to match ioRead().",
"body": "If the buffer was not full at EOF then ioReadSmall() would get stuck in an infinite loop. Instead, return on EOF even if the buffer is not full.\n\nThis is not an issue in released versions since ioReadSmall() is not being used.\n\nAlso fix a comment typo."
},
{
"commit": "4fb6384f10f6cd26c422ab9b24feb5ae0ebeeee9",
"date": "2021-08-18 08:18:11 -0400",
"subject": "Fix more memory leaks introduced by the binary protocol in 6a1c0337.",
"body": "Either of these temp mem context blocks fixes the issue of command packs not being freed, but it seems like a good idea to have both in case the code changes."
},
{
"commit": "e1e6e47535db09ea20b5f1826ea9e143ac8d614b",
"date": "2021-08-18 08:07:41 -0400",
"subject": "Add temp mem context reset blocks in job processing loops.",
"body": "Restore definitely needed to be doing cleanup, just as backup does. The archive-get, archive-push, and verify loop did not seem to be a significant source of leaks but that could change in the future so add resets.\n\nAdd temp mem context blocks in the job callbacks where they were missing.\n\nAlso switch to the prior context when creating a job, if possible, to save a move."
},
{
"commit": "eca2fc69589cd44f7c1a43206553984adde5cfb1",
"date": "2021-08-12 12:38:07 -0400",
"subject": "Update config/parse test to use standard patterns."
},
{
"commit": "e17865a03a5451b82a101557d400ff223d104383",
"date": "2021-08-12 11:57:17 -0400",
"subject": "Update protocol/protocol test to use standard patterns."
},
{
"commit": "86a651f9b03890af4f79076600e983bba624f8c5",
"date": "2021-08-12 07:49:59 -0400",
"subject": "Add optional stress test section to the user guide.",
"body": "This is intended to provide pre-release stress-testing. Include container memory limits to help check for memory leaks.\n\nAlso add parallelism to make for faster builds."
},
{
"commit": "a0bdfa436c9e1c2723be905ebe5cef7809a26244",
"date": "2021-08-11 13:39:36 -0400",
"subject": "Log backup file total and restore size/file total.",
"body": "The backup size was a bit off because it did not include any files (e.g. backup_label, WAL files) that were added to the manifest after the main copy. To fix this move the log message to the very end of the backup.\r\n\r\nAdd size/file total log message to restore since it did not exist before."
},
{
"commit": "6ab18dc0fa42885aea8eb9405ab0a943c2d49a71",
"date": "2021-08-11 12:59:25 -0400",
"subject": "Rearrange backup documentation in user guide.",
"body": "Remove the \"Automatic Stop Option\" section since it only applies to PostgreSQL <= 9.6, which will soon be EOL. Since we no longer build the user guide for PostgreSQL < 10 this section was no longer being tested. The stop-auto option is still documented in the reference.\r\n\r\nMove the \"Fast Start Option\" to \"Quick Start - Perform Backup\". This is a commonly-used option so it makes sense to mention it earlier. This also makes the backups run more quickly. In the worst case, backups in \"Quick Start - Perform Backup\" could take minutes to start\r\n\r\nMove the \"Archive Timeout\" section to \"Quick Start - Perform Backup\" since it is the last section in \"Backup\"."
},
{
"commit": "f716cb6f4f9765baa03f71b5563786d79d9f04a2",
"date": "2021-08-10 14:22:38 -0400",
"subject": "Fix use after free introduced by the binary protocol in 6a1c0337.",
"body": "The user and group were stored in a temp reset mem context so they could get freed if there were enough files to trigger the reset in storageRemoteInfoList().\n\nAllocate user and group in a mem context provided by the caller to prevent them being freed prematurely."
},
{
"commit": "6789ec420ed375663469efcd5957be8d3746efad",
"date": "2021-08-10 10:37:37 -0400",
"subject": "Add additional checks to performance/storage test.",
"body": "The storageInfoList() test was broken by 54c4eb0c when the remote was changed to use writeable storage. Since the test driver was being injected into the wrong location, new default storage was created and the test effectively did nothing but still \"succeeded\".\n\nTo prevent this type of regression, add checks to ensure the expected test driver is being used and the callback runs the expected number of times."
},
{
"commit": "0eae815ef4185bbf8bfa27856b531cc08db69d4b",
"date": "2021-08-09 17:29:09 -0400",
"subject": "Protect against mixed FUNCTION_TEST* and FUNCTION_LOG* macros.",
"body": "If the macros are mixed then the debug stack may not be cleaned up correctly. Add variables to ensure that the macros cannot be mixed.\n\nFix cases where the macros were mixed and add one missing semicolon."
},
{
"commit": "c8492aac41f29d8a0c29d7b70d1a5bf4b370965f",
"date": "2021-08-09 17:11:39 -0400",
"subject": "Cleanup inherited clients in protocol test harness.",
"body": "Cleanup all clients inherited from the parent process so they cannot be accidentally used to send messages to servers that do not belong to this process.\n\nWe need to do this carefully so that exit commands are not sent and processes are not terminated, so clear the mem context callback on each object before freeing it."
},
{
"commit": "71b654fc29497319862fe01c3917bbc353cc6dd9",
"date": "2021-08-09 16:56:06 -0400",
"subject": "Fix links and update child process example.",
"body": "Removed colon from example titles to fix links, fixed test.yml link, and updated the example for the parent/child test process to use the latest macros instead of sleep()."
},
{
"commit": "f653b59664e757a0e3da63cc8462deafe2d9e0ef",
"date": "2021-08-09 16:35:48 -0400",
"subject": "Update db/db test to use standard patterns."
},
{
"commit": "2d5cbfc73142fa99df609aa23b64db5342e73c88",
"date": "2021-08-09 09:28:17 -0400",
"subject": "Fix memory leaks introduced by the binary protocol in 6a1c0337.",
"body": "Additional buffers were being allocated for the protocol messages but not being freed.\n\nMost of the allocations were fairly harness, but storageRemoteOpenReadProtocol() and storageWriteRemote() were problematic because they were allocating (but not freeing) buffers equal to the transfer size of the file. Depending on compression, this could be a lot of memory. Though the memory was freed after each file transfer the aggregate of memory used during parallel processing could overwhelm systems with constrained memory.\n\nAlso allocate larger initial buffers in storageRemoteOpenReadProtocol() and storageWriteRemote() so a reallocation is not needed."
},
{
"commit": "33775e53c9160b7ca41c8bcfbf28517f92aff841",
"date": "2021-08-06 11:26:12 -0400",
"subject": "Fix test added for lstComparatorZ() in 9abf6a27.",
"body": "strcmp() returns < 0 and > 0 but these are not guaranteed to be -1 and 1."
},
{
"commit": "06791284618e8840724caa5e65fa535ea0438b61",
"date": "2021-08-06 09:48:55 -0400",
"subject": "Add linefeeds around content even when not in pretty mode.",
"body": "This makes the generated HTML much more readable in diffs because a single word change will not change a line with potentially many tags.\n\nThe output is now slightly larger because of the extra linefeeds."
},
{
"commit": "935de1e7a06d60415c16cad137875b49346337c6",
"date": "2021-08-05 14:29:26 -0400",
"subject": "Only pass selected repo options to the remote.",
"body": "Options for other repos can cause conflicts and should never be used. Each remote can address exactly one repo or pg cluster.\r\n\r\nAlso fix an outdated comment."
},
{
"commit": "155ef85013088a1150a4c15b04af36420d06e9c3",
"date": "2021-08-03 14:48:22 -0400",
"subject": "Fix incorrect host names in user guide.",
"body": "pg1 was incorrectly used instead of {[host-pg1]} which meant the wrong host name was displayed.\r\n\r\nAlso, the install block was installing packages to the build host no matter which host was specified."
},
{
"commit": "07f0a5901f244ccd8f81a07dc95e45744d7e2a55",
"date": "2021-08-03 11:48:58 -0400",
"subject": "Fix typo."
},
{
"commit": "74c0c44fc8f2ed04653f1486e421c5d5c9d1b0b0",
"date": "2021-08-02 18:32:11 -0400",
"subject": "Migrate error code generation to C.",
"body": "Parse src/build/error.yaml and write to src/config/error.auto.h and src/config/error.auto.c."
},
{
"commit": "aaa9136820d59d17fa81714d7fda56aa84ae31f3",
"date": "2021-08-02 18:16:57 -0400",
"subject": "Update error.yaml comment to remove Perl reference."
},
{
"commit": "930fee3a0c94944242e5582a5d1c97908b049c81",
"date": "2021-08-02 17:49:05 -0400",
"subject": "Move bldStrId() into a C file.",
"body": "This function was included in a header but not declared inline, so linker errors happened when the header was included into more than one file.\n\nBecause of the setjmp() in TRY_BEGIN() it can't be inlined so put it in a C file.\n\nAlso add some missing headers."
},
{
"commit": "13de3615678290c820345eadf67cf4cedfaee222",
"date": "2021-08-02 17:41:40 -0400",
"subject": "Improve comments."
},
{
"commit": "7542eadc9f073cbcb5e1cb1cb33fe451560bd31d",
"date": "2021-08-02 14:48:31 -0400",
"subject": "Increase timeouts in storage/remote test.",
"body": "There have been intermittent failures on f33 (with coverage) but not on u16 (without coverage).\n\nReproducing this reliably has been very difficult, so just try increasing the timeouts. This is based on the observation that tests with coverage take longer than tests without, which may lead the f33 tests to fail if CI is running slower than usual.\n\nThis will not increase the runtime of the test unless there is an error."
},
{
"commit": "4e71c077f1be9665ae7570a8a230e4735c4dd592",
"date": "2021-08-02 10:00:42 -0400",
"subject": "Clean src path in test.pl before attempting vpath builds.",
"body": "If configure/make has been run in the src path it can conflict with tests, which may require different build options.\n\nAlso add a comment when rebuilding for code generation."
},
{
"commit": "c192ec4561fa2f870152b31e034243862d2eed82",
"date": "2021-08-02 08:52:49 -0400",
"subject": "Fix rsync include list removed from test.pl in 9ee9b1fa.",
"body": "This caused the include list to be ignored and all files to be rsync'd, which worked but took a much longer."
},
{
"commit": "2dfca8a61f8305bb94afaf1791af37833e8b0795",
"date": "2021-07-30 18:15:07 -0400",
"subject": "Remove unused struct member noted in f3f0c64a.",
"body": "This variable is used to build the final command role lists, but is not needed after parsing completes."
},
{
"commit": "9abf6a2709e9c1a2cc1c246d8307fd2e2b3d566a",
"date": "2021-07-30 18:08:04 -0400",
"subject": "Add lstComparatorZ().",
"body": "Works just like lstComparatorStr() but with zero-terminated strings."
},
{
"commit": "8bca6946b4771a0d438fe1239ca8cc0a8604efca",
"date": "2021-07-30 17:51:56 -0400",
"subject": "Add line and column to build yaml error messages.",
"body": "This makes it much easier to debug errors in the yaml files."
},
{
"commit": "b47a07b8b9178d2241a9ae06d1a9732337554d21",
"date": "2021-07-29 14:40:30 -0400",
"subject": "Remove generated config.auto.c file.",
"body": "This file duplicated the command list that already exists in parse.auto.c.\n\nCombine the data from config.auto.c into parse.auto.c and adjust the interface functions as needed. Quite a few were able to be moved to parse.c as static."
},
{
"commit": "e32f9e146b11389e3d16feba9665360b73737d66",
"date": "2021-07-29 11:09:51 -0400",
"subject": "Add check for test path inside repo path.",
"body": "If the test path is inside the repo path then it can cause strange issues during testing because the entire repo path is duplicated into the test path so that all tests see a consistent view of the repo.\r\n\r\nAnother solution might be to pick a better test path name and exclude it from the rsync, but this fix at least addresses the immediate issue."
},
{
"commit": "58cc470b3eae5eeb956be6ce6e809e9110ca2dd8",
"date": "2021-07-29 08:14:17 -0400",
"subject": "Remove code made obsolete by f3f0c64a.",
"body": "The code in DocExecute.pm appears to have been obsolete for a long time."
},
{
"commit": "f3f0c64a78e2ac425567d792df204e493ad7bb20",
"date": "2021-07-28 19:59:23 -0400",
"subject": "Complete migration of config code generation to C.",
"body": "This was started in c5ae047e but did not include generation of parse.auto.c.\n\nThe parser has also been improved with better errors and multiple passes to reduce dependency on ordering and produce and cleaner output.\n\nOption order resolution now includes cycle detection."
},
{
"commit": "7517c5fef8bc43464acf961aded8d5ad3f20b52f",
"date": "2021-07-28 18:53:10 -0400",
"subject": "Fix miscalculation in time option command defaults.",
"body": "These defaults were not getting the multiplier so the timeouts were much lower than expected.\n\nSince PostgreSQL retries get/push this was probably not a big deal, but it could be critical in the future for a different time value."
},
{
"commit": "9f3c9496358a88d8ad44a0ff1e6dde265345a9c6",
"date": "2021-07-27 14:49:43 -0400",
"subject": "Updates to build/config/config.yaml.",
"body": "Fix booleans that were set to y rather than true and defaults that were set to true instead of 1. Perl was tolerant of these but C is not.\n\nReorder repo-storage-verify-tls to satisfy inheritance ordering for the dependency."
},
{
"commit": "8ca89fb41f85386666242f6c8fbc7d35db9b96ca",
"date": "2021-07-26 14:38:55 -0400",
"subject": "Use consistent separator comment spacing in parse.auto.c."
},
{
"commit": "52d4574460455975e8929108080dc89bba6cbc7e",
"date": "2021-07-26 12:02:31 -0400",
"subject": "Automatically generate option value StringIds in make build-config.",
"body": "Remove strIdGenerate() since bldStrId() performs the same function without cluttering the core code. Since bldStrId() is intended to work in non-debug builds, move the validity checks for input strings out of the DEBUG block.\n\nStringIds are generated as 5/6 bit, whichever is most efficient, for each option value. cfgOptionStrIdInternal() has been updated for this logic."
},
{
"commit": "eeaab6a3d192fc788c0f74aadbf4b3de5da52531",
"date": "2021-07-23 16:18:50 -0400",
"subject": "Update config tests (except parse) to use standard patterns."
},
{
"commit": "947c7a84cb37d09ab925785ca7670c970e32b8a3",
"date": "2021-07-23 10:35:36 -0400",
"subject": "Refactor cmdLocal()/cmdRemote() to accept a ProtocolServer object.",
"body": "This allows a local/remote to be started independently of server initialization, which will be useful for implementing new transport types, e.g. TLS.\n\nAlso remove some dead code in localTest.c."
},
{
"commit": "0999de0279fabf35af80396a9a8d35546ec02d53",
"date": "2021-07-23 08:32:30 -0400",
"subject": "Move noop from protocolClientNew() to local/remote initialization.",
"body": "protocolServerNew() does not automatically process a noop so this made the handshake in the constructors asymmetric. This made testing a bit confusing since an extra noop was needed when cmdLocal()/cmdRemote() were not called (since they processed the noop sent by protocolClientNew()).\n\nThe extra noops also make complex protocol negotiation (coming in a future commit) more complicated and slower because of the additional round trips."
},
{
"commit": "4c9ddf5ef25d0f441e20e918f57c1ec79218cfdb",
"date": "2021-07-22 18:17:08 -0400",
"subject": "Update storage tests to use standard patterns.",
"body": "The storage tests were not modified to the HRN_STORAGE_* nor TEST_STORAGE_* macros as these test are testing the storage drivers.\r\n\r\nNote that posixTest.c removed an extraneous #endif // TEST_CONTAINER_REQUIRED and #ifdef TEST_CONTAINER_REQUIRED.\r\n\r\nThis PR includes all files in the storage/* test directory, namely: azureTest.c, cifsTest.c, gcsTest.c, posixTest.c, remoteTest.c, s3Test.c"
},
{
"commit": "3a37482de90e132770bf76514baeef907f0c5d80",
"date": "2021-07-22 15:54:30 -0400",
"subject": "Update db test module error for newer libpq versions.",
"body": "PostgreSQL 14 libpq throws a more detailed error, so adjust the regular expression to handle the old and the new errors."
},
{
"commit": "eb98b8d2db94488a47df5727aff6d456869cbaae",
"date": "2021-07-21 13:19:09 -0400",
"subject": "Fix typo."
},
{
"commit": "e3d05e2b4aa80149219b6d49a3136b34fa268127",
"date": "2021-07-21 13:14:06 -0400",
"subject": "Update contributing documentation and add pull request template."
},
{
"commit": "46992acd800f7d4fed055a9236f536f2b0f1b0a7",
"date": "2021-07-20 15:43:48 -0400",
"subject": "Update Vagrantfile box version."
},
{
"commit": "49925087644c76df005828eb27c24f503a09b20b",
"date": "2021-07-20 13:30:17 -0400",
"subject": "Update command/restore test to use standard patterns."
},
{
"commit": "9ee9b1fad6fc5aa8f34b0b80d0a9aa8d7e166c40",
"date": "2021-07-20 12:01:10 -0400",
"subject": "Remove test.pl --smart, --dev, and --dev-test options.",
"body": "--smart is now the default mode. Since --dev is now just an alias for --no-optimize, remove it. --dev-test has been a noop for a while, so this seems like a good time to remove it.\n\nAlso make the C auto-generator skip writing files that have not changed to avoid updating the timestamp."
},
{
"commit": "1522cb4ed2c493739dfac797fd4cd20e94cbc5ec",
"date": "2021-07-19 15:21:40 -0400",
"subject": "Allow NULL path in HRN_STORAGE_PATH_REMOVE() macro.",
"body": "Update command/backup test to pass NULL where appropriate."
},
{
"commit": "a6cdf5b22f0eed53f33bbd84478af0542c81af7d",
"date": "2021-07-19 10:47:49 -0400",
"subject": "Update command/repo test to use standard patterns."
},
{
"commit": "ebe5848494d4e37a9c86f1fafb5b3453c1f425a6",
"date": "2021-07-19 09:51:11 -0400",
"subject": "Update command/local and command/remote tests to use standard patterns.",
"body": "Note that the logging output display of a parent/child test may look jumbled on some systems since the child and parent are attempting to log information at the same time. This is not an issue with the actual test, rather a harness issue that would be beyond the scope of this project to fix."
},
{
"commit": "c5ae047e763f01a520286f9f4de7a85afba53942",
"date": "2021-07-18 19:02:01 -0400",
"subject": "Partial migration of config code generation to C.",
"body": "Parse enough of config.yaml to auto-generate config.auto.h and config.auto.c.\n\nThis commit implements most of the infrastructure needed to migrate the rest of the build code to C, but each set of auto-generated files will present its own challenges.\n\nThe build is now dependent on libyaml. At this point there is no need for a hard requirement, but that will come soon so it seems better to add the dependency now."
},
{
"commit": "18ffec72da7f44b08343310d2a3b72d11ed5f121",
"date": "2021-07-18 18:31:43 -0400",
"subject": "Update order of configuration options.",
"body": "The upcoming C parser requires that options be in dependency order, i.e. inherited options must come before the options that inherit them.\n\nThis change has been separated to demonstrate that it does no affect the auto-generated code."
},
{
"commit": "6397d735359b459a7c0c094226f266fe39234318",
"date": "2021-07-18 17:29:20 -0400",
"subject": "Update test container OS versions.",
"body": "Update Ubuntu 12.04 to 16.04. Version 16.04 is recently EOL but testing on an old version is beneficial.\nUpdate Ubuntu 18.04 to 20.04.\nUpdate Fedora 32 to 33. Version 34 would have been preferred but there were some build issues, i.e. the default shell did not work with configure, and after ksh was installed configure locked up.\n\nAdd --no-install-recommends to apt-get commands to save a bit of time and space.\n\nUpdate test Dockerfile to run in multiple steps. This makes the container larger but also makes rebuilding after changes faster. The --squash option may be used to keep the container small.\n\nRemove obsolete casts in protocol/parallel module. These casts were included in the original migration because Ubuntu 12.04 32-bit gcc required them, but Ubuntu 16.04 32-bit gcc complains. There is no production issue here since at this point in the code the file descriptors are guaranteed to be >= 0."
},
{
"commit": "81602f1593927d34f5a0f547e2a633ac224a4b3d",
"date": "2021-07-17 11:09:53 -0400",
"subject": "Remove test.pl --vm-host option.",
"body": "This option was once used to optimize bin builds but has been defunct for some time."
},
{
"commit": "d57299ada8e4e275ed3ee18ca4d7f6d264542154",
"date": "2021-07-16 13:07:16 -0400",
"subject": "Allow NULL path in TEST_STORAGE_LIST() macro."
},
{
"commit": "117ffe88965fd60ce3dcb328e9d28503870af05a",
"date": "2021-07-15 17:51:48 -0400",
"subject": "Update command/help test to use standard patterns.",
"body": "In the first test (helpRenderSplitSize) added test for empty list and in that and some other tests, the test comment was updated to clarify a bit more what the actual tests is trying to accomplish.\r\n\r\nNote that help test parameters can only use the harnessConfig system when testing option values that have been set since options passed to the help command are not \"set\" options."
},
{
"commit": "4ad0bbda53b34688146f14d130cf0e53c8dd650f",
"date": "2021-07-15 17:00:20 -0400",
"subject": "Update command/backup tests to use standard patterns.",
"body": "Includes backup and backupCommon tests.\r\n\r\nSome tests in backupTest were split out where they were originally combined into a single boolean check - which made it difficult to determine which part of the conditional failed.\r\n\r\nString values were also removed where they were no longer needed."
},
{
"commit": "cdc89fc9759f1ac37938219b76c89e1c3a82ba0a",
"date": "2021-07-15 16:05:32 -0400",
"subject": "Allow NULL path in HRN_STORAGE_PATH_CREATE() macro."
},
{
"commit": "25508a48e0d3b0a3eabc6d1fe858b9c3dc12dc86",
"date": "2021-07-15 14:34:47 -0400",
"subject": "Add contributors missed in 8e187cdb."
},
{
"commit": "c0feca4673834867d9ea3dbd0434d02a77ed73db",
"date": "2021-07-15 13:31:54 -0400",
"subject": "Add noParentCreate parameter to HRN_STORAGE_PATH_CREATE() macro."
},
{
"commit": "4a6ca54b47b3a56a96b2c92c6e7267fe24997ce9",
"date": "2021-07-15 13:19:49 -0400",
"subject": "Remove last vestiges of key replacement missed in b270253a."
},
{
"commit": "563d117967ab9770f9f646c6186d0bc37121611f",
"date": "2021-07-15 13:02:41 -0400",
"subject": "Allow restore --type=lsn.",
"body": "The LSN recovery target was added in PostgreSQL 10 but did not get added to pgBackRest."
},
{
"commit": "8fac1ac50d28557d162fbb251fbbdcc3c9fb950c",
"date": "2021-07-15 07:45:06 -0400",
"subject": "Loop while waiting for checkpoint LSN to reach replay LSN.",
"body": "It is possible for the checkpoint LSN to lag slightly behind the replay LSN until pg_control has been updated.\r\n\r\nAdd a loop to keep checking rather than failing when the checkpoint LSN has not been updated."
},
{
"commit": "a6691c6f615f90195aeb6c1c6657a6afd79a10d3",
"date": "2021-07-14 16:06:42 -0400",
"subject": "Clarify restore --type behavior in command reference."
},
{
"commit": "d791bb7298b3ef775f77ad79b28185e255037b09",
"date": "2021-07-14 14:31:57 -0400",
"subject": "Automatically create IoRead/IoWrite interfaces in HRN_FORK*() macros.",
"body": "This removes a lot of boiler plate where every instance needs to create these interfaces.\n\nAlso add HRN_FORK_*_NOTIFY*() macros to standardize synchronizing between the parent and child processes.\n\nIn both cases update the tests with the new macros."
},
{
"commit": "be7b8a485b8f36751347e370c7221c40f0e686fd",
"date": "2021-07-13 14:28:58 -0400",
"subject": "Error in TEST_STORAGE_LIST() when path does not exist."
},
{
"commit": "1ace1ac938ca555273c150fd3d3b402d75e74ce0",
"date": "2021-07-13 14:22:53 -0400",
"subject": "Improve HRN_FORK*() macros.",
"body": "Simplify HRN_FORK_CHILD_BEGIN() by adding optional parameters with the common defaults.\n\nAdd _FD() to macros that retrieve file descriptors to make their purpose clearer."
},
{
"commit": "76cfbf833d113d6251fb8ffe76239d580dcaf947",
"date": "2021-07-13 11:58:23 -0400",
"subject": "Rename HARNESS_FORK*() macros to HRN_FORK*().",
"body": "This matches the new pattern for harness macro naming and is shorter."
},
{
"commit": "d6797009f8e316e5dc778d42db609f7bd81225ee",
"date": "2021-07-13 11:13:57 -0400",
"subject": "Add ioFdReadNewOpen() and ioFdWriteNewOpen().",
"body": "These functions construct and open in one call, which allows them to be used as function parameters."
},
{
"commit": "f70ddc16d7a12a41f3b757424b73d1f244400d16",
"date": "2021-07-13 07:09:55 -0400",
"subject": "Fix typo."
},
{
"commit": "26dd9188568481815e0e47f19c2acd32d79d9f84",
"date": "2021-07-12 15:36:52 -0400",
"subject": "Add compressType parameter to TEST_STORAGE_GET() macro.",
"body": "Also remove duplicate extension output in HRN_STORAGE_PUT()."
},
{
"commit": "f2ec4e00a4c4c388a8f1b094381fd566a3dc9aa7",
"date": "2021-07-09 15:59:17 -0400",
"subject": "Add cipher parameters to TEST_STORAGE_GET() macro."
},
{
"commit": "3c8819e10f9eff89195566e7e02f349373f5c4c7",
"date": "2021-07-09 14:16:10 -0400",
"subject": "Add CodeQL static code analysis.",
"body": "Also fix some minor issues identified, specifically using gmtime_r()/localtime_r() vs gmtime()/localtime()."
},
{
"commit": "849ab343aa10d66fbbd27cad407eff981c186d06",
"date": "2021-07-09 13:50:35 -0400",
"subject": "Change level of backup/restore copied file logging to detail.",
"body": "The log level for copied files in the backup/restore commands has been changed to detail. This makes the info log level less noisy but if these messages are required then set the log level for the backup/restore commands to detail."
},
{
"commit": "a7a041e2412b598ccc01c37123dd6dc13d46cae9",
"date": "2021-07-09 11:18:45 -0400",
"subject": "Fix flapping coverage in storage/remote test.",
"body": "The protocol does not put an end message on exit so there was a race between the main process exiting and the remote processes exiting. If the main process exited first then the remote processes might not write coverage data causing coverage to fail.\n\nFix by calling exit explicitly at the end of the test and update the harness to put an end message so the exits are synchronized."
},
{
"commit": "3369440eef7eb67062de6d0c150f999b342f49b3",
"date": "2021-07-09 09:07:41 -0400",
"subject": "Make pgControlFromBuffer() static.",
"body": "This function is no longer used externally."
},
{
"commit": "8bb0b28455d59ef884eab7ab25a91f988adbab81",
"date": "2021-07-08 16:34:11 -0400",
"subject": "Update command/control and command/command tests to use standard patterns.",
"body": "In the commandTest the HRN_STORAGE_REMOVE replacement uses .errorOnMissing when the code being tested added the file. The reason for this is 3 fold:\r\n\r\n1. to ensure that an inadvertent typo in the path/file name does not go undetected,\r\n2. to ensure that nothing else has removed the file prior to the call, and\r\n3. consistency\r\n\r\nAlso, added \"stanza\" to comment when a stanza stop file is removed vs an \"all\" stop file."
},
{
"commit": "8e1807cdbe08a6e059ff79220247cf4b3c058979",
"date": "2021-07-08 13:06:52 -0400",
"subject": "Detect errors in S3 multi-part upload finalize.",
"body": "Multi-part upload may fail despite returning an HTTP success code. Check for the ETag field in the result and if not present consider the upload to have failed. This will trigger a retry at the local job level."
},
{
"commit": "43b874628c86ec4fe297dbd5cab5bd3f62b8639b",
"date": "2021-07-08 11:30:23 -0400",
"subject": "Fix detection of circular symlinks.",
"body": "Links were followed before they were checked for validity so a circular link would send the manifest build into endless recursion leading to a crash. Fix by moving the recursion after the link check.\r\n\r\nNote that this issue has existed since the C migration and was not introduced by the refactor in eba013b."
},
{
"commit": "683933563333f39852676eb44110e7eab91b63fb",
"date": "2021-07-08 11:17:13 -0400",
"subject": "Increase harness log level to detail in command/backup test.",
"body": "Also clean up some unneeded calls to harnessLogLevelReset()."
},
{
"commit": "056a3070e0dba299389c7b5049878d40dd91ec9a",
"date": "2021-07-08 10:33:19 -0400",
"subject": "Automatically create data directory on restore.",
"body": "Data directory creation was added during the C migration, but creation of the base data directory (PGDATA) was prevented by a check migrated from Perl.\r\n\r\nRemove the check and update tests to create the data directory at least once."
},
{
"commit": "34e51ee7b6968d254e0b8c6a0970764ca5cdaa42",
"date": "2021-07-08 09:25:42 -0400",
"subject": "Allow NULL path in HRN_STORAGE_MODE() macro."
},
{
"commit": "62e8d97af03e7628d5710b17aad1cc31f83d7e69",
"date": "2021-07-02 12:22:11 -0400",
"subject": "Update command/archive tests to use standard patterns.",
"body": "Includes archiveCommon, archiveGet and archivePush.\r\n\r\nAlso fixed a test that was looking in repo instead of repo3 in the original archivePush to use the repo3 path as stated by the comment (line 879 in original tests and line 855 in new tests)."
},
{
"commit": "23bdc3deb62a622713064df3b0777110ebba8723",
"date": "2021-07-01 11:50:03 -0400",
"subject": "Fix documentation and comment typos.",
"body": "Identified using `ag -l | igor`."
},
{
"commit": "6a90d469094ee2697ae4c932349756a54136799d",
"date": "2021-06-30 08:51:11 -0400",
"subject": "Update info/manifest test to use standard patterns."
},
{
"commit": "39c1c1012013f456e951fc149b0f88cbc5dcbcc0",
"date": "2021-06-28 13:28:28 -0400",
"subject": "Remove TEST_PATH_REPO, TEST_PATH_PG, and TEST_PATH_SPOOL constants.",
"body": "It seems better to use TEST_PATH in combination with a constant string rather than have a number of different path constants. This improves readability and reduces confusion about which constant should be used."
},
{
"commit": "c6208113bfce9d637ca3fd0b35ab28a819c1a83e",
"date": "2021-06-28 12:14:26 -0400",
"subject": "Add timeModified parameter to HRN_STORAGE_PUT() macro."
},
{
"commit": "065a8c8454d2acdd72c0c71a24d6b8bc09669e18",
"date": "2021-06-28 10:58:27 -0400",
"subject": "Replace defines with string constants in unit tests.",
"body": "For tests already updated as part of the macro-replacement effort, the output tests (TEST_ERROR, TEST_RESULT_LOG, TEST_STORAGE_LIST and TEST_RESULT_STR) have been simplified for readability to remove all but the TEST_PATH constants. The ongoing macro-replacement effort will include these changes.\r\n\r\nUpdated: expireTest, stanzaTest, checkTest, infoTest, verifyTest (infoArchive and infoBackup had no changes)."
},
{
"commit": "fb2d111dcd75021313a64a348959482339bf7f2a",
"date": "2021-06-24 16:11:14 -0400",
"subject": "Update info/infoBackup test to use standard patterns."
},
{
"commit": "d0f3a3f2af3f66c899ded98b62695547fd267081",
"date": "2021-06-24 14:01:03 -0400",
"subject": "Add HRN_STORAGE_COPY() macro."
},
{
"commit": "50c129ae9d161aba080a0d2d1b012e6358ac3e40",
"date": "2021-06-24 13:57:55 -0400",
"subject": "Add expression parameter to TEST_STORAGE_LIST() macro."
},
{
"commit": "6a1c0337ddee9900dda58b7d2fa74d82c0586ed2",
"date": "2021-06-24 13:31:16 -0400",
"subject": "Binary protocol.",
"body": "Switch from JSON-based to binary protocol for communicating with local and remote process. The pack type is used to implement the binary protocol.\r\n\r\nThere are a number advantages:\r\n\r\n* The pack type is more compact than JSON and are more efficient to render/parse.\r\n* Packs are more strictly typed than JSON.\r\n* Each protocol message is written entirely within ProtocolServer/ProtocolClient so is less likely to get interrupted by an error and leave the protocol in a bad state.\r\n* There is no limit on message size. Previously this was limited by buffer size without a custom implementation, as was done for read/writing files.\r\n\r\nSome cruft from the Perl days was removed, specifically allowing NULL messages and stack traces. This is no longer possible in C.\r\n\r\nThere is room for improvement here, in particular locking down the allowed sequence of protocol messages and building a state machine to enforce it. This will be useful for resetting the protocol when it gets in a bad state."
},
{
"commit": "bffb43ea3fe00f445a2fc3c44a07f105cee65b4b",
"date": "2021-06-24 12:23:09 -0400",
"subject": "Update command/check test to use standard patterns."
},
{
"commit": "17c9ed0ef0380fb14fba9a5299b6618ca8c92c2e",
"date": "2021-06-24 08:55:44 -0400",
"subject": "Update command/info test to use standard patterns.",
"body": "Some tests had to be reordered or updated, as follows:\r\n\r\n* Reordered tests at line 317 and 331 to avoid unnecessary file removal.\r\n\r\n* Change \"stanza found\" test at line 1735 to reflect real-life scenario. Originally this test had the cipher-pass environment key set up which caused the RepoGrp to be 2 but with no valid repo path. This resulted in the repo loops executing for the repo2 but since the path was not defined, the tests just reported \"none\" for cipher which is incorrect since the repo IS encrypted.\r\n\r\n* Moved order of HRN_CFG_LOAD in some tests when able to avoid using storageTest."
},
{
"commit": "ff95eddc369597c76a9ea70ffbada493ed4d1951",
"date": "2021-06-23 18:09:46 -0400",
"subject": "Update command/verify test to use standard patterns."
},
{
"commit": "8dd882badee76b038dc8b494a1112eb3e18ef678",
"date": "2021-06-23 16:20:47 -0400",
"subject": "Update info/infoArchive test to use standard patterns."
},
{
"commit": "e697f5705a04ef431aa93d63764b12ff98d696c6",
"date": "2021-06-23 13:02:19 -0400",
"subject": "Clear error when a CATCH() block finishes.",
"body": "It is better to clear errors after the catch block completes rather than leave them set until the next error. This also make is possible to tell when a error is currently being handled, which a function further down the stack might use to modify its behavior. Currently this is only useful in testing, but clearing the error seems like a good idea in general.\r\n\r\nTwo places used errors outside the CATCH() block. Mem context cleanup now uses a FINALLY() which is a better implementation anyway. The error handling in main() now calls exitSafe() from withing the CATCH() block."
},
{
"commit": "7ba5aef7633fde709eafdfa7b6fed736493250c0",
"date": "2021-06-23 12:07:19 -0400",
"subject": "Add mode parameter to HRN_STORAGE_PUT() macro."
},
{
"commit": "03021c6a17f1374e84ef42614fa1dd2a6be4b64d",
"date": "2021-06-14 13:28:27 -0400",
"subject": "Update command/stanza test to use standard patterns.",
"body": "No core code changes; only changes for stanza-create, stanza-upgrade, and stanza-delete command unit tests."
},
{
"commit": "80d63a5e8bc6e5e6d6e4d75b349a44f2aac70954",
"date": "2021-06-12 18:00:59 -0400",
"subject": "Ignore mismatched close requests in the pq shim during error processing."
},
{
"commit": "fba043717935babe084ebd8e9e1b7352dc9ff679",
"date": "2021-06-12 17:48:35 -0400",
"subject": "Improve error handling in db test module.",
"body": "Errors could cause segfaults since server objects were freed immediately but client destructors were run much later."
},
{
"commit": "0a65e59b5591718e46a4c331fa5301c41d49155d",
"date": "2021-06-11 19:16:25 -0400",
"subject": "Update pg-path options in db test module to be valid.",
"body": "This allows files to be saved in the paths, which would have failed when they were invalid."
},
{
"commit": "97155bad860010514f06d651ef8103355b346ab8",
"date": "2021-06-10 12:40:55 -0400",
"subject": "Add mode, Pack, and StringId to the Pack type.",
"body": "Add StringList, which is not a primitive type but rather an array of String types.\n\nAlso update pckWriteToLog() to work after pckWriteEnd(), i.e. this->tagStackTop is NULL."
},
{
"commit": "85a55bd40181bad943e224619fc936b046b2c8c1",
"date": "2021-06-10 09:25:57 -0400",
"subject": "Add pckReadMove() and pckWriteMove().",
"body": "Move a PackRead or PackWrite object to a new mem context.\n\nAlso note that these functions may not work as expected with pack objects created by pckReadNewBuf() and pckWriteNewBuf() since the pack object does not have ownership of the passed buffer and cannot move it."
},
{
"commit": "788f7c1f30408b6eb3148cb288b67838e6cb718b",
"date": "2021-06-10 09:24:42 -0400",
"subject": "Skip sleep in sleepMSec() when sleep time is zero.",
"body": "There is no point in sleeping when there is no sleep time.\n\nThe advantage is that callers do not need to perform the check themselves."
},
{
"commit": "5e1a8e6895ec59005a3974ac63ecbbc6832d5244",
"date": "2021-06-10 09:21:15 -0400",
"subject": "Add error test harness/shim.",
"body": "The hrnErrorThrowP() macro allows errors with specified fields to be generated, which simplifies testing.\n\nUpdate the common/exit test to use the new macro."
},
{
"commit": "c5897007c4cb420c1e4111c9f9c14e1e706ec5e9",
"date": "2021-06-09 12:41:23 -0400",
"subject": "Add HRN_STORAGE_MOVE() macro.",
"body": "Update command/expire test to show how it is used."
},
{
"commit": "15dfbf4c1d2fd33daa1a89a644683e80eeae4194",
"date": "2021-06-09 12:28:40 -0400",
"subject": "Use lower-case names from Azure identifiers in integration tests.",
"body": "Azurite, which is used for testing, did not enforce this before so the capital letters were not a problem. Now Azurite enforces the same rules as Azure so use lower-case identifiers instead.\n\nThese names were only used in integration tests so there was no production impact."
},
{
"commit": "c6a8528e3158de3e4ccdba00c7af6d47cc28d073",
"date": "2021-06-08 14:51:23 -0400",
"subject": "Add optional remove to TEST_STORAGE_EXISTS().",
"body": "This allows TEST_STORAGE_EXISTS() to be used in most cases where TEST_STORAGE_REMOVE() was used before.\n\nRename TEST_STORAGE_REMOVE() to HRN_STORAGE_REMOVE() now that is is no longer used as a test. Still allow an error when the file is missing just to help keep tests tidy."
},
{
"commit": "4a075b725287aafe12bb2add89ae4b224dafe2bc",
"date": "2021-06-08 12:55:00 -0400",
"subject": "Add support for more Pack types.",
"body": "Since the pack type was stored in 4 bits, only 15 values were allowed (0 was reserved).\r\n\r\nAllow virtually unlimited types by storing type info in a base-128 encoded integer following the tag when the type bits in the tag are set to 0xF.\r\n\r\nAlso separate the type IDs used in the pack (PackTypeMap) from those presented to the user (PackType). The prior PackType enum exposed implementation details to the user, e.g. pckTypeUnknown."
},
{
"commit": "3f9fbc3c24eab48e7ae2871484ea01273049e601",
"date": "2021-06-08 11:00:28 -0400",
"subject": "Update command/expire test to use standard patterns.",
"body": "The way tests are written has evolved over time. Update the command/expire test to use the new test patterns."
},
{
"commit": "12f81f8933b31d528a04b3640f407c9ff7ce9c45",
"date": "2021-06-08 09:56:24 -0400",
"subject": "Fix comments.",
"body": "The extern'd function should not have duplicated the comment in the header. The static helper needed a comment."
},
{
"commit": "4ccb42bb7a84d17bd708b1a4c117037738ef1f6f",
"date": "2021-06-08 08:44:10 -0400",
"subject": "Rename param structs to match function names.",
"body": "The functions were named with short integer representations (e.g. I32) but the param structs were using longer ones, e.g. UInt32. Shorten the integer representations in the param structs to match.\n\nAlso rename pckReadUInt64Internal() to pckReadU64Internal() for the same reason."
},
{
"commit": "df8276f59f4271a80bcf4f0ca13089864d9b95cb",
"date": "2021-06-07 11:53:25 -0400",
"subject": "Switch order of remote startup in storage/remote test.",
"body": "The pg storage must be started before the repo storage to set the max remotes allowed to 2. The protocol helper expects all remotes to have the same type so we are cheating here a bit, but without this ordering the second remote will never be sent an explicit exit and may not save coverage data."
},
{
"commit": "a76cb57c80026e713886bc3205e9ef60fd1e4070",
"date": "2021-06-07 08:48:09 -0400",
"subject": "Remove parse.auto.h.",
"body": "At one time there was a lot more in this header but it got merged with the enums and constants in config.auto.c, leaving only the ConfigOptionType enum.\n\nAuto-generating the ConfigOptionType enum is not very useful since new option types require code in parse.c."
},
{
"commit": "7a449f0e49df4c03bad8a2c468a3fd5adb1e5732",
"date": "2021-06-07 08:18:02 -0400",
"subject": "Remove unused command string constants."
},
{
"commit": "a607750be1775fa9f74164f8d3768536b86387f6",
"date": "2021-06-07 07:46:51 -0400",
"subject": "Handle NULL VariantList in JSON.",
"body": "This worked if the Variant was NULL but not if the Variant contained a NULL."
},
{
"commit": "aaca4df983e280f8b2357ba923496f4618c72713",
"date": "2021-06-07 07:36:56 -0400",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "a7b1d2b9d00014172edd963229ca4d40a3855da7",
"date": "2021-06-07 07:32:34 -0400",
"subject": "Begin v2.35 development."
},
{
"commit": "d10a99d73b772f221807024abbf61fdc5ca3a800",
"date": "2021-06-07 06:51:08 -0400",
"subject": "v2.34: PostgreSQL 14 Support"
},
{
"commit": "c9a8ff27f2468dd769bfe8829b16e68d64357efb",
"date": "2021-06-02 11:46:54 -0400",
"subject": "Add HRN_STORAGE_PATH_REMOVE() macro.",
"body": "Update command/archive-push test to show how it is used."
},
{
"commit": "a97fc6e708b67fcf32aec85d312fd3ff5e7d93aa",
"date": "2021-06-01 17:10:15 -0400",
"subject": "Add storage/remote test for unknown user/group name."
},
{
"commit": "d35315aaf99be7492b7712cda7922f54ccdd924f",
"date": "2021-06-01 15:33:07 -0400",
"subject": "Add missing parameter log debug."
},
{
"commit": "8250990afb06e0bfb74d2f9ece19338127060b94",
"date": "2021-06-01 09:03:44 -0400",
"subject": "Replace harnessCfgLoad*() functions with HRN_CFG_LOAD() macro.",
"body": "HRN_CFG_LOAD() handles the majority of test configuration loads and has various options for special cases.\n\nIt was not clear when to use harnessCfgLoadRaw() vs harnessCfgLoad(). Now \"raw\" functionality is granular and enabled by parameters, e.g. noStd."
},
{
"commit": "c1277677a3e595a169f3bec7e1da31e8431f2f71",
"date": "2021-05-28 15:23:18 -0400",
"subject": "Add HRN_STORAGE_PATH_CREATE() macro.",
"body": "Update command/archive-get test to show how it is used.\n\nAlso move one path create that was much earlier than it needed to be."
},
{
"commit": "c8427682eafd8d38403818464711d63086dafc35",
"date": "2021-05-28 14:39:43 -0400",
"subject": "Improve storage harness/test macros.",
"body": "Make the macros more consistent in format and make sure that each macro outputs a line number before doing any work so when errors happen it is clear where they happened.\n\nAdd noRecurse option to TEST_STORAGE_LIST().\n\nAdd comment option to all storage macros."
},
{
"commit": "0a43be018347292a2d5e7ec68bbde595604bd104",
"date": "2021-05-28 13:08:41 -0400",
"subject": "Use L to denote line numbers in test output.",
"body": "The lower-case l was too easy to confuse with a 1."
},
{
"commit": "cfe8e5191039b63915f459f9f2cead7aab6b594d",
"date": "2021-05-28 08:50:28 -0400",
"subject": "Remove line parameter from hrnTestResultBegin().",
"body": "Instead store the line number in hrnTestLogPrefix() so it doesn't need to be passed to hrnTestResultBegin().\n\nAlso add missing linefeed in hrnStorageList()."
},
{
"commit": "b3ac9e8010e225542fe4cb584e42a53adcba9d22",
"date": "2021-05-28 08:03:22 -0400",
"subject": "Remove unused padding parameter from hrnTestLogPrefix().",
"body": "Also add fflush() so log prefix is displayed immediately."
},
{
"commit": "52217f12445dd05cb828ed2f8cd19be2ad8759fd",
"date": "2021-05-27 16:50:18 -0400",
"subject": "Replace storageTest with storagePg*() in command/archive-get test.",
"body": "All instances of storageTest are better represented with storagePg*(), which allows TEST_PATH and TEST_PATH_PG to be omitted.\n\nAlso remove some headers which are no longer needed."
},
{
"commit": "aceb956815a87f0c19ea171de25d2c3842a6d806",
"date": "2021-05-27 08:03:44 -0400",
"subject": "Change archive expiration logging from detail to info level.",
"body": "To assist with issue debugging, removal of files during archive expiration has been changed from detail level logging to info level."
},
{
"commit": "5b332b22b508d896abb64fa6abe26c78c83a29bc",
"date": "2021-05-26 13:07:18 -0400",
"subject": "Add repo-retention-history option to expire backup history.",
"body": "The default is to keep all backup history to match the current behavior. In minimal configuration (0 days), unexpired backups are always kept in history.\r\n\r\nWhen a full backup manifest expires, all dependent differential/incremental manifests expire as well."
},
{
"commit": "a69a6c2f5579a55624763592ce9d8d7e92dc55f0",
"date": "2021-05-26 12:41:15 -0400",
"subject": "Show diff when test.pl --gen-check detects unexpected autogeneration.",
"body": "This will help track down autogeneration issues if they can't be reproduced locally."
},
{
"commit": "ba351e9c5ce475831de2aa22cc2b9afa8714a21d",
"date": "2021-05-26 12:38:23 -0400",
"subject": "Refactor storage/remote unit test using the protocol remote shim.",
"body": "Using the local process shim improves coverage and simplifies the tests."
},
{
"commit": "58369c02df39ac9916d5de42d2df9ad509c33b6f",
"date": "2021-05-25 18:16:59 -0400",
"subject": "Add remote process shim.",
"body": "Run the remote process inside a forked child process instead of exec'ing it. This allows coverage to accumulate in the remote process rather than needing to test the remote protocol functions directly, resulting in better end-to-end testing and less test duplication. Another advantage is that the pgbackrest binary does not need to be built for the test and the test does not need to run in a container."
},
{
"commit": "441c000b5c3d8a4dfe67616d2a281c58184ef3ea",
"date": "2021-05-25 18:09:29 -0400",
"subject": "Factor remote process exec out of protocolRemoteGet().",
"body": "This allows protocolRemoteExec() to be shimmed, which means the remote can be run as a child of the test process, simplifying coverage testing.\n\nThe shim does not need SSH parameters, so also split those out into a separate function and update the tests to match."
},
{
"commit": "e1bc1b3e5321c585ed4e2162c28a5f881b1b9342",
"date": "2021-05-25 17:48:42 -0400",
"subject": "Set buffer-size in the configuration test harness.",
"body": "Most tests can set buffer-size as needed, but local/remote process shims are forked, so the best way to set buffer-size is via the configuration."
},
{
"commit": "cd88f8232950f1d6939c0642fa784c2d8a2110d6",
"date": "2021-05-25 11:08:51 -0400",
"subject": "Move protocol test module before config module.",
"body": "The protocol module should be tested before modules that have a dependency on it."
},
{
"commit": "6732806d89ded2969fbf31d85c51e35c2d6f8345",
"date": "2021-05-25 11:06:05 -0400",
"subject": "Add local process shim to archive-get/archive-push unit tests.",
"body": "Use the local process shim introduced in ef63750e in the archive-get/archive-push unit tests."
},
{
"commit": "d55b9471a89163ed362c64960316c292e51cdd8e",
"date": "2021-05-25 11:00:24 -0400",
"subject": "Protocol shim improvements.",
"body": "Add executable to parameter list to avoid first option being lost. The backup, restore, and verify tests worked OK with their first option being defaulted because it ended up being job-retry which worked fine as the default.\n\nAdd hrnProtocolLocalShimUninstall() allow the shim to be uninstalled.\n\nLog shim at debug level to make it obvious in the logs when a shim is in use."
},
{
"commit": "55f52955a5da07e4ebee312c493759fa9dd3f566",
"date": "2021-05-24 17:45:31 -0400",
"subject": "Fix shims with more than one function.",
"body": "Each subsequent function would double every line in the C module.\n\nMove the loop to detect shimmed functions down to prevent this issues."
},
{
"commit": "2452c4d5a4c230b8e3c33d3bddf69e56dfbec284",
"date": "2021-05-24 17:17:03 -0400",
"subject": "Add PostgreSQL 14 support.",
"body": "There are no code changes from PostgreSQL 13 so simply add the new version.\r\n\r\nAdd CATALOG_VERSION_NO_MAX to allow the catalog version to \"float\" during the PostgreSQL beta/rc period so new pgBackRest versions are not required when the catalog version changes.\r\n\r\nUpdate the integration tests to handle new PostgreSQL startup messages."
},
{
"commit": "eba013b49b850e53d59795ac6358fcb3381048a3",
"date": "2021-05-24 16:29:36 -0400",
"subject": "Fix issue when checking links for large numbers of tablespaces.",
"body": "manifestLinkCheck() was pretty inefficient so large numbers of links caused it to use a lot of memory and eventually crash. This is a more efficient implementation which runs O(nlogn) and uses far less memory.\r\n\r\nChecking for duplicate file links has been added, which represents a change in behavior, but hopefully a good one."
},
{
"commit": "ccac75e7de8754b39bb691ff8830a2839ea7a285",
"date": "2021-05-24 16:03:15 -0400",
"subject": "Consolidate RHEL/CentOS user guide into a single document.",
"body": "The user guide was split primarily to provide documentation for the stop-auto option in PostgreSQL <= 9.5. Now that 9.5 is EOL there does not seem to be a good reason to generate an extra user guide. The stop-auto function is still documented in the reference.\r\n\r\nLeave the stop-auto documentation in the user guide in case we want to manually generate documentation for older versions.\r\n\r\nAlso rename centos to rhel for most identifiers since that is the core platform we are building for, similar to how we label 'debian' builds even though we generally use Ubuntu. With CentOS set to become an upstream for RHEL later this year, we'll likely need to pick a new test distribution, perhaps Rocky Linux if that gets off the ground."
},
{
"commit": "f6303152f5f4b9ee538f4378797c9bf8f81bb3c8",
"date": "2021-05-24 12:40:27 -0400",
"subject": "Minor fixes for command/archive-get unit test.",
"body": "Test and remove WAL segment 000000010000000100000002 in the test where it is created rather than as a byproduct of a much later test.\n\nRemove incorrect local role from test. It worked, but was not the correct command role to be using when calling cmdArchiveGet().\n\nMove some harness headers down to the correct section."
},
{
"commit": "e5e0b2119634847f624c824929f5e4af24da9c02",
"date": "2021-05-22 15:07:18 -0400",
"subject": "Replace system() in tests with HRN_SYSTEM*()."
},
{
"commit": "bd40156c223837e3130ef9041ab7baf44570b362",
"date": "2021-05-22 14:22:51 -0400",
"subject": "Rename TEST_SYSTEM*() to HRN_SYSTEM*().",
"body": "These calls are not tests, rather they setup data for tests."
},
{
"commit": "73885f8c2e3a1ac234cce85684e81db961ad6d47",
"date": "2021-05-22 14:09:45 -0400",
"subject": "Replace hrnLogResult() with TEST_RESULT_LOG/_FMT().",
"body": "The macros provide more information when there is an error and may be updated in the future without changing the test code."
},
{
"commit": "6baad5cdd1f73771e6f87d788769ba658c52ff80",
"date": "2021-05-22 11:59:43 -0400",
"subject": "Replace TEST_ERROR_FMT() with TEST_ERROR() where possible.",
"body": "Some calls did not need TEST_ERROR_FMT() at all and others could be converted by replacing parameters with available defines, e.g. TEST_PATH."
},
{
"commit": "a4f057bb70ca79c8b57ab5418f1b0cc65d3ae521",
"date": "2021-05-22 11:28:56 -0400",
"subject": "Remove comment formatting from TEST_*() macros.",
"body": "Comment formatting was not used much but it incurred a heavy cost in each macro to process possible formatting.\n\nRemove formatted comments where they did not contain valuable information and replace with strZ(strNewFmt()) otherwise."
},
{
"commit": "b270253a69cd44682e94e9cbfcf68f2dce4058a4",
"date": "2021-05-22 09:30:54 -0400",
"subject": "Add defines for many test*() getter functions.",
"body": "A define was already added for TEST_PATH but it was not widely used. Replace all occurrences of testPath() with TEST_PATH in the tests.\n\nReplace testUser() with TEST_USER, testGroup() with TEST_GROUP, testRepoPath() with HRN_PATH_REPO, testDataPath() with HRN_PATH, testProjectExe() with TEST_PROJECT_EXE, and testScale() with TEST_SCALE.\n\nReplace {[path]}, {[user]}, {[group]}, etc. with defines and remove hrnReplaceKey(). This is better than having two ways to deal with replacements.\n\nIn some cases the original test*() getters were kept because they are used by the harness, which does not have access to the new defines. Move them to harnessTest.intern.h to indicate that the tests should no longer use them."
},
{
"commit": "aed3d468a1557474eba4a24854732fc09581b265",
"date": "2021-05-21 17:36:43 -0400",
"subject": "Rename strNew() to strNewZ() and add parameter-less strNew().",
"body": "Replace all instances of strNew(\"\") with strNew() and use strNewZ() for non-empty zero-terminated strings. Besides saving a useless parameter, this will allow smarter memory allocation in a future commit by signaling intent, in general, to append or not.\n\nIn the tests use STRDEF() or VARSTRDEF() where more appropriate rather than blindly replacing with strNewZ(). Also replace strLstAdd() with strLstAddZ() where appropriate for the same reason."
},
{
"commit": "68faf1482a42ea14f5b00a91e19bd5aedec275b8",
"date": "2021-05-21 13:21:25 -0400",
"subject": "Update contributing documentation.",
"body": "Add more examples of how to write code, add configuration options, test, etc."
},
{
"commit": "15b8b9207da40df3df92ee7464a546c335a5a4d9",
"date": "2021-05-21 12:51:32 -0400",
"subject": "Add log shim.",
"body": "This allows DEBUG_UNIT and DEBUG_UNIT_EXTERN to be removed since static log variables can now be exposed by functions in the harness."
},
{
"commit": "ef63750e0bc8292caefe8e421a31e985026f72ee",
"date": "2021-05-21 12:45:00 -0400",
"subject": "Add local process shim.",
"body": "Run the local process inside a forked child process instead of exec'ing it. This allows coverage to accumulate in the local process rather than needing to test the local protocol functions directly, resulting in better end-to-end testing and less test duplication. Another advantage is that the pgbackrest binary does not need to be built for the test.\n\nThe backup, restore, and verify command tests have been updated to use the new shim for coverage."
},
{
"commit": "cab7a97ab6308d72b509ef2e02c559ac691f436b",
"date": "2021-05-20 18:47:31 -0400",
"subject": "Add shim feature for unit tests.",
"body": "A shim allows a test harness to access static functions and variables in a C module, and also allows functions to be shimmed (i.e. overridden) for the purposes of testing.\n\nFor instance, coverage testing works when a process that is normally exec'd is run as a forked child process instead."
},
{
"commit": "e31df55c8dc3ce8c5cd071b0a66d83b3c7c3c4ed",
"date": "2021-05-20 18:35:30 -0400",
"subject": "Factor local process exec out of protocolLocalGet().",
"body": "This allows protocolLocalExec() to be shimmed, which means the local can be run as a child of the test process, simplifying coverage testing."
},
{
"commit": "45a4e801ed52f60f27c73eacaf63ff4b483ab352",
"date": "2021-05-20 16:02:31 -0400",
"subject": "Replace getopt_long() with custom implementation.",
"body": "getopt_long() requires an exhaustive list of all possible options that may be found on the command line. Because of the way options are indexed (e.g. repo1-4, pg1-8) optionList[] has 827 entries and we have kept it small by curtailing the maximum indexes very severely. Another issue is that getopt_long() scans the array sequentially so parsing gets slower as the index maximums increase.\r\n\r\nReplace getopt_long() with a custom implementation that behaves the same but allows options to be parsed with a function instead of using optionList[]. This commit leaves the list in place in order to focus on the getopt_long() replacement, but cfgParseOption() could be replaced with a more efficient implementation that removes the need for optionList[].\r\n\r\nThis implementation also fixes an issue where invalid options were misreported in the error message if they only had one dash, e.g. -config. This seems to have been some kind of problem in getopt_long(), but no investigation was done since the new implementation fixes it.\r\n\r\nTests were added at 0825428, 2b8d2da, 34dd663, and 384f247 to check that previously untested getopt_long() behavior doesn't change."
},
{
"commit": "831ee81466c28ca563d5f5f5468681aca6fe3bea",
"date": "2021-05-20 14:39:47 -0400",
"subject": "Rename default command role to main.",
"body": "Main makes more sense because we refer to the main process in the code, not the default process. The word default is pretty overloaded anyway."
},
{
"commit": "8453d89a92f6b7846bc8eeead285a1abd8fdfb1b",
"date": "2021-05-19 14:18:43 -0400",
"subject": "Add recursion to TEST_STORAGE_LIST() macro.",
"body": "This makes the macro useful when subpaths are present.\n\nIdentify types other than files (path, link, etc.) with a single appended character for easier debugging."
},
{
"commit": "93eb2f8362489eba2e6a6deee6b0d0c6dd3e6a2c",
"date": "2021-05-19 14:03:42 -0400",
"subject": "Fix invalid type in test function.",
"body": "This should have been char * from the start, but of course void * worked fine."
},
{
"commit": "4d48850aad23042b3d7bf22221e2f5d34c00de07",
"date": "2021-05-19 12:58:48 -0400",
"subject": "Update negate to indicate that it should not be used for new options."
},
{
"commit": "870bcf30af1a516802a67ac173e8bd7a369c6530",
"date": "2021-05-18 16:48:30 -0400",
"subject": "Add missing header.",
"body": "This worked because all places where this header was included, common/type/stringId.h was included first."
},
{
"commit": "4fa95af447d1b9caecbaacb5e7a5ef4b334f7331",
"date": "2021-05-18 16:38:57 -0400",
"subject": "Fix typo in struct typedef.",
"body": "This worked because the type is never declared as struct ExecPub."
},
{
"commit": "c92bc43c1eca6d3deac288f68332b323139e6405",
"date": "2021-05-18 16:33:45 -0400",
"subject": "Simplify defaults for --force option.",
"body": "All commands have the same default so it is more efficient to set the default for the entire option."
},
{
"commit": "320c6e1aad2cc9a8dabecb2bc91a9b34464de6ec",
"date": "2021-05-18 15:49:22 -0400",
"subject": "Remove stanza archive spool path on restore.",
"body": "Remove stanza archive spool path so existing files do not interfere with the new cluster. For instance, old archive-push acknowledgements could cause a new cluster to skip archiving. This should not happen if a new timeline is selected but better to be safe. Missing stanza spool paths are ignored.\r\n\r\nAlso add new path expression STORAGE_SPOOL_ARCHIVE to easily access this path."
},
{
"commit": "dc0e6645cd5c4baa3f301feda4acfce55ba363f7",
"date": "2021-05-18 09:08:06 -0400",
"subject": "Move includes after typedef in info/manifest.h.",
"body": "This allows the Manifest type to be used in headers that need it, e.g. command/backup/common.h."
},
{
"commit": "9af033194abc4b1cd3f06c3a97fff71c966c3827",
"date": "2021-05-17 14:55:50 -0400",
"subject": "Add automatic GCS authentication for GCE instances.",
"body": "When running on a GCE instance the authentication token can be pulled directly from the instance metadata. This is configured with repo-gcs-key-type=auto.\r\n\r\nIn a separate commit (26fefa6), move the code that parses the token response into a separate function, storageGcsAuthToken(), since it is now needed by two key types. This drastically improves the readability of the main commit."
},
{
"commit": "0152075e6bc5fca2b78cbe6051a6b3d998c9030f",
"date": "2021-05-17 11:35:22 -0400",
"subject": "Remove default VM for test.pl --coverage-only option.",
"body": "When running outside of our standard Vagrantfile the default will not be set correctly, so require the user to set it.\n\nIn any case, this option is primarily useful for reporting so note that in the command line help."
},
{
"commit": "384f2470775bd2d867529e7267c12a798a259ab3",
"date": "2021-05-17 09:33:36 -0400",
"subject": "Add config/parse tests for config/env partial options.",
"body": "Partial option matching is valid on the command line but should never be used in config files or environment options."
},
{
"commit": "ae7f0af2023ec7b9261a5a4887351eec669c4442",
"date": "2021-05-17 07:20:28 -0400",
"subject": "Move PostgreSQL version interface test functions to a test harness.",
"body": "Some version interface test functions were integrated into the core code because they relied on the PostgreSQL versioned interface. Even though they were compiled out for production builds they cluttered the core code and made it harder to determine what was required by core.\n\nCreate a PostgreSQL version interface in a test harness to contain these functions. This does require some duplication but the cleaner core code seems a good tradeoff. It is possible for some of this code to be auto-generated but since it is only updated once per year the matter is not pressing."
},
{
"commit": "18cc02238bbd15bfa9827ef86078aa172bdae52b",
"date": "2021-05-17 07:15:13 -0400",
"subject": "Remove overzealous cast.",
"body": "There does not seem to be a good reason to have an explicit cast for such a small number, so remove it.\n\nLeave PG_CONTROL_SIZE alone since it will be removed in an upcoming commit."
},
{
"commit": "9235c62c6b597bc4ed812e0c0a3bc3a36ec30767",
"date": "2021-05-17 07:12:46 -0400",
"subject": "Revert ignoring catalog version when identifying a PostgreSQL version.",
"body": "927d9adb changed the way CATALOG_VERSION_NO is used to identify PostgreSQL versions since PG_CONTROL_VERSION is generally bumped with each release. The goal was to make the beta/rc period less painful because any CATALOG_VERSION_NO bump renders pgBackRest inoperative.\n\nThis worked, but in fact we'd rather be stricter about which CATALOG_VERSION_NO we accept when identifying a version of PostgreSQL. It is not just about identifying a major version, but making sure the build contains all the functions and catalogs we expect to make pgBackRest work correctly. It is better to reject early dev/beta/rc builds that may not work.\n\nSince 927d9adb was relatively recent the chance that this stricter checking will cause a problem seems minimal, so revert to checking CATALOG_VERSION_NO for every PostgreSQL version.\n\nLeave in place the code that pulls CATALOG_VERSION_NO from pg_control rather than the internal constant since the plan is still to allow catalog versions to \"float\" during the PostgreSQL beta/rc phase, which will be the subject of a future commit."
},
{
"commit": "f45e76fa2e8ce0f62317a74fdd51083d52659cd5",
"date": "2021-05-13 17:51:39 -0400",
"subject": "Fix issues with leftover spool files from a prior restore.",
"body": "If an ok file (which indicates the WAL segment was not found) is present on the first iteration of the loop then remove it and spawn the async process to retry. This action also resets the queue.\r\n\r\nAlso error if no response is received from the async process rather than returning not found. PostgreSQL will respond the same either way, but this allows us to determine when something is going wrong with the async process.\r\n\r\nUpdate archiveAsyncStatus() to allow warnings to be suppressed. It is better to retry if no WAL segment was found before warning because the warning might be stale."
},
{
"commit": "34dd6636b83ac41cab592d6a6d18c082e1ee272e",
"date": "2021-05-13 17:01:21 -0400",
"subject": "Add config/parse tests for options and option args with spaces.",
"body": "If an option name has a space at the beginning then it will be considered an invalid command, but a space at the end is an invalid option. Add tests for these conditions.\n\nSpaces in option arguments should be preserved, so add a test to be sure this is true."
},
{
"commit": "2b8d2daca15f2535672f195164c0e8daffdade90",
"date": "2021-05-13 16:54:25 -0400",
"subject": "Add config/parse tests for partial options.",
"body": "Add coverage for partial options, i.e. an option that is partially specified but only prefix matches with a single valid option."
},
{
"commit": "add0f9b77de4b9f1395338e4b092bf77b2da2cd5",
"date": "2021-05-13 12:37:59 -0400",
"subject": "Fix an ungrammatical error message in config parsing."
},
{
"commit": "0825428fef00e6b4b107526ffa462fa7558aace4",
"date": "2021-05-13 12:35:11 -0400",
"subject": "Add config/parse test where the option/value are not in the same arg.",
"body": "All the tests in this module use --option=value syntax so add one test with --option value syntax for coverage."
},
{
"commit": "26fefa6aeeae90bbb572ea57b605fb8fe526f1a0",
"date": "2021-05-13 06:59:57 -0400",
"subject": "Refactor GCS token response parsing into a separate function.",
"body": "This function is also useful for the upcoming auto authentication. Refactoring in a separate commit to make the feature commit more readable."
},
{
"commit": "7b71604defa02d5ed9b7aa3407961cb59a52cc45",
"date": "2021-05-12 13:21:59 -0400",
"subject": "Use existing variable for GCS test server port.",
"body": "Also fix incorrect separator comment."
},
{
"commit": "5464ac83d121c653e95f337fa14870bbe35dc9f7",
"date": "2021-05-11 17:24:30 -0400",
"subject": "Convert option values in commands to StringId.",
"body": "Convert most of the remaining options that benefit from being StringIds. Since all the command modules can include config.h directly it makes sense to auto-generate these values instead of manually creating an enum for each one.\r\n\r\nFor the time being StringIds are not being auto-generated because the StringId code does not exist in Perl. However, the *_Z zero-terminated constants for each allowed option value are now auto-generated."
},
{
"commit": "87ba2ca253ec9546cb23635ec15017bb5ce7d6e9",
"date": "2021-05-11 16:54:42 -0400",
"subject": "Change CentOS 7 documentation test to CentOS 8.",
"body": "The CentOS 7 documentation test relies on PostgreSQL 9.5 which has been removed from the yum.p.o repository package. Switch the test to CentOS 8 to fix the immediate issue, but a decision on the PostgreSQL 9.5 documentation will need to be made before the next release."
},
{
"commit": "2bfebff2ec73b0af6d937f303fbb9b8a0b8ee649",
"date": "2021-05-04 15:51:46 -0400",
"subject": "Add instructions to install lcov for MacOS."
},
{
"commit": "54074a569708e40831d767a8b93074f41feec308",
"date": "2021-05-04 07:52:35 -0400",
"subject": "Exclude Dockerfile from code count."
},
{
"commit": "baddec1e9ae37ad08840401e2602301f06bda021",
"date": "2021-05-03 16:31:27 -0400",
"subject": "Basic multi-architecture support for test containers.",
"body": "The tests worked fine on multiple architectures, but would only run \"bare metal\", i.e. tests that required containers could not be run.\n\nEnable basic multi-architecture support by allowing containers to be built using whatever architecture the host supports. Also allow cached containers to be defined for multiple architectures in container.yaml.\n\nAdd a Dockerfile which can be used as a container for other containers to provide a consistent development environment.\n\nThe primary goal is to allow development on Mac M1 but other architectures should find these improvements useful."
},
{
"commit": "87df6d7a58a6ab3c4748ad75e4128cdad761b15a",
"date": "2021-05-03 12:15:39 -0400",
"subject": "Convert BackupType enum to StringId.",
"body": "Allows removal of backupType()/backupTypeStr() and improves debug logging of the enum.\r\n\r\nMove BackupType enum and string constants to info/infoBackup.h so they are available to more modules. Also convert InfoBackup to use BackupType instead of a String."
},
{
"commit": "568dc0ba0c762376b8bd902d83e38f2649a156af",
"date": "2021-05-03 09:34:22 -0400",
"subject": "Add new instructions for PostgreSQL news and include a sample.",
"body": "It is no longer possible to pull news source from the PostgreSQL website so add a sample in the doc directory. Update the release instructions to reflect this change.\n\nAlso note that it is no longer necessary to post separately to pgsql-announce."
},
{
"commit": "fb7ddce8076107c33c25832c9acb8baffbd57563",
"date": "2021-04-28 13:21:24 -0400",
"subject": "Convert InfoPgType enum to StringId.",
"body": "Improves debug logging by outputting archive/backup instead of 0/1."
},
{
"commit": "bd0081fec87ee32fa57adf5c882a6cad5394eaa0",
"date": "2021-04-28 12:37:22 -0400",
"subject": "Update IoClient/IoSession to use StringIds.",
"body": "Using StringId for the client/session type removes String constants and some awkward referencing/dereferencing needed to use a String constant in the interface.\n\nConverting IoSessionRole to StringId removes a conditional in ioSessionToLog() and improves debug logging by outputting client/server instead of 0/1."
},
{
"commit": "0ec91f61c636731a8a46fc69307bbe5d78ac8871",
"date": "2021-04-28 12:23:37 -0400",
"subject": "Convert ArchivePushFileIoType enum to StringId.",
"body": "Improves debug logging by outputting open/write/close instead of 0/1/2."
},
{
"commit": "8394577c6ac1a13884b4b05052ce6328d38ab067",
"date": "2021-04-28 12:05:01 -0400",
"subject": "Convert ArchiveMode enum to StringId.",
"body": "Improves debug logging by outputting get/push instead of 0/1."
},
{
"commit": "7dd01897fd20a3629e7333dc47bed7d02035b501",
"date": "2021-04-28 11:59:04 -0400",
"subject": "Convert ProtocolStorageType enum to StringId.",
"body": "Allows removal of protocolStorageTypeEnum()/protocolStorageTypeStr() and improves debug logging of the enum."
},
{
"commit": "bd68ed63ba38c841e286e0ab5390450f57c23b37",
"date": "2021-04-28 11:43:08 -0400",
"subject": "Convert ProtocolParallelJobState enum to StringId.",
"body": "Allows removal of protocolParallelJobToConstZ(), which was used only for debugging."
},
{
"commit": "85fc3da4c37dc1cb9af3b8c5248121769ab56650",
"date": "2021-04-28 11:36:20 -0400",
"subject": "Update CipherType/CipherMode to StringId.",
"body": "As in 6cc521b, this allows option values and enums to be easily mapped together."
},
{
"commit": "c3b15fc3bdc332591c6b059c2b23b1cce990d387",
"date": "2021-04-28 10:58:45 -0400",
"subject": "Fix comments where 'output' was misspelled as 'ouput'."
},
{
"commit": "066fbcf26826ee8332eb76db0db9d684047513ac",
"date": "2021-04-27 15:25:10 -0400",
"subject": "Refactor String, Buffer, and Variant types with inline getters.",
"body": "Extend the pattern introduced in 79a2d02c to the String, Buffer, and Variant types."
},
{
"commit": "1edcfde93e47c79a8b18b05f7ddb1e9fde29b0ed",
"date": "2021-04-27 12:12:43 -0400",
"subject": "Add cfgOptionDisplay()/cfgOptionIdxDisplay().",
"body": "Centralize the formatting of the configuration value for display to the user or passing on a command line.\r\n\r\nFor the new functions, if the value was set by the user via the command line, config, etc., then that exact value will be displayed. This makes it easier for the user to recognize the value and saves having to format it into something reasonable, especially for time and size option types.\r\n\r\nNote that cfgOptTypeHash and cfgOptTypeList option types are not supported by these functions, but they are generally not displayed to the user as a whole.\r\n\r\nThis also fixes a bug in config/load.c where time values where not being formatted correctly in an error message."
},
{
"commit": "95fb002b85897e71820c44519231975d883f87db",
"date": "2021-04-27 12:04:50 -0400",
"subject": "Preserve unused YAML fix for older Debian/Ubuntu distributions.",
"body": "This fix was not used since backports worked for older Debians and the old affected Ubuntus are EOL.\n\nStill, seems worth preserving just in case it comes up elsewhere."
},
{
"commit": "6cc521b6b232cd10b5b1622b1841d988113d0c16",
"date": "2021-04-23 13:19:47 -0400",
"subject": "Update storage module to use StringIds.",
"body": "Use StringIds for the storage types (e.g. STORAGE_S3_TYPE) and configuration settings, e.g. cfgOptS3KeyType.\r\n\r\nAlso add new config functions and harness config functions to support StringIds."
},
{
"commit": "aa72c19a831fb0dd15a50a003fbaad427f335353",
"date": "2021-04-23 12:33:25 -0400",
"subject": "Do not write files atomically or sync paths during backup copy.",
"body": "There is no need to write the file atomically (e.g. via a temp file on Posix) because checksums are tested on resume after a failed backup. The path does not need be synced for each file because all paths are synced at the end of the backup.\r\n\r\nThis functionality was not lost during the migration -- it never existed in the Perl code, though these settings are used in restore. See 59f1353 where backupFile() was migrated to C."
},
{
"commit": "aaa15b9709cd58ad56e5008858867d91f4abe803",
"date": "2021-04-23 11:46:03 -0400",
"subject": "Add help for all internal options valid for default roles.",
"body": "Fix the segfault when getting help for an internal option is requested by adding help for all internal options that are valid for a default command role.\r\n\r\nAlso print warnings about internal options in code rather than putting in each command/option description."
},
{
"commit": "2ad497ea4cdc53f5966f2abab018696ff4694a2d",
"date": "2021-04-23 08:04:03 -0400",
"subject": "Remove documentation about enum truncation and add tests.",
"body": "The enum truncation observed was due to the value getting passed via a protocol function which silently narrowed the enum.\n\nEven so, add some tests to ensure tested platforms support 64-bit enums."
},
{
"commit": "bcc925b7406ae590cd24ff5a0bbb789a6d1ecd5a",
"date": "2021-04-22 20:04:27 -0400",
"subject": "Replace misused kvAdd() with kvPut().",
"body": "Although kvAdd() works like kvPut() on the first call, kvPut() is more efficient when a key has a single value.\n\nUpdate the comment to clarify that kvAdd() is seldom required."
},
{
"commit": "a2f02f95ec5f2835d3c114d1b96fec8109e11402",
"date": "2021-04-22 19:28:11 -0400",
"subject": "Remove redundant CompressType conversions.",
"body": "These seem to be the result of overzealous copy/paste.\n\nThe conversions do not even serve as a verification of locally available compression types since compressTypeEnum() and compressTypeStr() do not check that."
},
{
"commit": "468aa79ea8b1975b1d6fe0665611230432f16d75",
"date": "2021-04-22 19:10:13 -0400",
"subject": "Remove auto-generated option String constants.",
"body": "These are rarely used and end up using more space than they save since most of them are never referenced.\n\nReplace VARSTR() with VARSTRDEF() where these constants are being used."
},
{
"commit": "6a39c51f8f1d992c53bc3af80d9db0037c09fb41",
"date": "2021-04-22 18:18:34 -0400",
"subject": "Test pull requests in Cirrus CI.",
"body": "Both FreedBSD and MacOS use clang as their default compiler and clang catches some errors that gcc does not. Specifically, wide integers being assigned to short integers resulting in possible truncations."
},
{
"commit": "06fa18582a405417c8ab4ba667cb01a13a5c3103",
"date": "2021-04-22 12:23:08 -0400",
"subject": "Free no longer needed remotes so they do not timeout during restore.",
"body": "The remotes are no longer needed in the main process after the manifest is loaded. If the restore is long enough the connection will timeout and WARN at the end of the restore. This is harmless for the restore but distracting for the user.\r\n\r\nTo prevent this, free the remotes once they are no longer needed."
},
{
"commit": "45f83558ea862c6f496a27b886e1160e6303bbe8",
"date": "2021-04-22 11:48:04 -0400",
"subject": "Fix help when a valid option is invalid for the specified command.",
"body": "Getting help for a valid option that was invalid for the command would segfault.\r\n\r\nAdd a check to ensure the option is valid for the command's default role."
},
{
"commit": "72dac5b10b7cd31a00212be9268df95c2d12615c",
"date": "2021-04-22 08:15:36 -0400",
"subject": "Use option constants in warnings.",
"body": "In once case the constant replaces a formatted statement, which is more efficient, and in the other case plain text, which is more maintainable."
},
{
"commit": "20a018a8ae9ce8768044621e19ef716c5622f209",
"date": "2021-04-21 18:27:18 -0400",
"subject": "Fix incorrect test title."
},
{
"commit": "c5b446d406937d35b277cd0d9131e6c058183f3b",
"date": "2021-04-21 10:09:07 -0400",
"subject": "Fix indentation."
},
{
"commit": "fd69357302053a79fdef6decf1ff284a8a442e67",
"date": "2021-04-20 18:43:16 -0400",
"subject": "Add const to inline functions where appropriate.",
"body": "This lets the compiler know that these variables are not modified which should lead to better optimization.\n\nSmart compilers should be able to figure this out on their own, but marking parameters const is still good for documentation."
},
{
"commit": "ed0d48f52cb5332f6804737ac01c43bf76d11a50",
"date": "2021-04-20 15:22:42 -0400",
"subject": "Add StringId type.",
"body": "It is often useful to represent identifiers as strings when they cannot easily be represented as an enum/integer, e.g. because they are distributed among a number of unrelated modules or need to be passed to remote processes. Strings are also more helpful in debugging since they can be recognized without cross-referencing the source. However, strings are awkward to work with in C since they cannot be directly used in switch statements leading to less efficient if-else structures.\n\nA StringId encodes a short string into an integer so it can be used in switch statements but may also be readily converted back into a string for debugging purposes. StringIds may also be suitable for matching user input providing the strings are short enough.\n\nThis patch includes a sample of StringId usage by converting protocol commands to StringIds. There are many other possible use cases. To list a few:\n\n* All \"types\" in storage, filters. IO , etc. These types are primarily for identification and debugging so they fit well with this model.\n\n* MemContext names would work well as StringIds since these are entirely for debugging.\n\n* Option values could be represented as StringIds which would mean we could remove the functions that convert strings to enums, e.g. CipherType.\n\n* There are a number of places where enums need to be converted back to strings for logging/debugging purposes. An example is protocolParallelJobToConstZ. If ProtocolParallelJobState were defined as:\n\ntypedef enum\n{\n protocolParallelJobStatePending = STRID5(\"pend\", ...),\n protocolParallelJobStateRunning = STRID5(\"run\", ...),\n protocolParallelJobStateDone = STRID5(\"done\", ...),\n} ProtocolParallelJobState;\n\nthen protocolParallelJobToConstZ() could be replaced with strIdToZ(). This also applies to many enums that we don't covert to strings for logging, such as CipherMode.\n\nAs an example of usage, convert all protocol commands from strings to StringIds."
},
{
"commit": "292f836f1243e51d102bb4be202e7b21a7a386b1",
"date": "2021-04-19 15:01:00 -0400",
"subject": "Add db-exclude option.",
"body": "Restore excluding the specified databases. Databases excluded will be restored as sparse, zeroed files to save space but still allow PostgreSQL to perform recovery. After recovery, those databases will not be accessible but can be removed with the drop database command. The --db-exclude option can be passed multiple times to specify more than one database to exclude.\r\n\r\nWhen used in combination with the --db-include option, --db-exclude will only apply to standard system databases (template0, template1, and postgres)."
},
{
"commit": "a75b413ac228452acfd33aa3d296d8edbeae9604",
"date": "2021-04-19 14:22:36 -0400",
"subject": "Add storageDriver() inlines missed in b715c70b."
},
{
"commit": "d859fe8c4d60e961cf688f17fb80d0cdc8fb810d",
"date": "2021-04-14 15:48:04 -0400",
"subject": "Update to remove files after archive-get test completes.",
"body": "This cleans up the spool path for the next test. Currently there isn't one but there will be."
},
{
"commit": "040ad71f8cd7b57ec6546e4733749c827ed0aaa3",
"date": "2021-04-14 15:41:55 -0400",
"subject": "Remove lockClear().",
"body": "This function has not been used since the switch to the fork/exec model.\n\nlockClear() was still used in one test (other than the lock test) so update the test and remove the function."
},
{
"commit": "c2d4a0286e5899f3382bd34f9d285f122753bca5",
"date": "2021-04-13 18:06:07 -0400",
"subject": "Define DEBUG in build.auto.c.",
"body": "Both NDEBUG and DEBUG were used in the code, which was a bit confusing.\n\nDefine DEBUG in build.auto.c so it is available in all C and header files and stop using NDEBUG. This is preferable to using NDEBUG everywhere since there are multiple DEBUG* defines, e.g. DEBUG_COVERAGE.\n\nNote that NDEBUG is still required since it is used by the C libraries."
},
{
"commit": "c1aae434ca18ce06a6ea56b779fbdb5702ee1034",
"date": "2021-04-13 17:03:28 -0400",
"subject": "Update Cirrus CI FreeBSD release to 12.2."
},
{
"commit": "a0e24d492f8df97788018fc91d6e408c1c787e15",
"date": "2021-04-13 16:58:02 -0400",
"subject": "Add THIS_PUB() macro to simplify inline object accessors.",
"body": "In combination with the thisPub() function, this macro simplifies accessing the public part of a private object struct.\n\nthisPub() asserts this != NULL so the caller does not need to do it."
},
{
"commit": "9fec4ce98c69044eae4e299e6e95bc45990d6d5c",
"date": "2021-04-13 14:37:02 -0400",
"subject": "Refactor remaining common/io modules with inline getters/setters.",
"body": "Extend the pattern introduced in 79a2d02c to the remaining common/io modules."
},
{
"commit": "5bf160643b53699a28a8f0920c36d6ded767d249",
"date": "2021-04-13 14:02:20 -0400",
"subject": "Clarify that repo-s3-role is not an ARN."
},
{
"commit": "2c9c59170f6c1a3aacfdf0fb5c6197feb87afcc9",
"date": "2021-04-13 12:38:17 -0400",
"subject": "Add bash to Cirrus CI FreeBSD package install.",
"body": "It appears bash was removed from the base image so install explicitly."
},
{
"commit": "8844ced384bf0d5feb5fe395560ec976cc292a73",
"date": "2021-04-12 16:05:40 -0400",
"subject": "Refactor common/io/filter module with inline getters/setters.",
"body": "Extend the pattern introduced in 79a2d02c to the common/io/filter module."
},
{
"commit": "3b9bed95186118a3fbf47e3e0900e74f4ad01217",
"date": "2021-04-09 17:29:14 -0400",
"subject": "Refactor common/type/keyValue module with inline getters/setters.",
"body": "Extend the pattern introduced in 79a2d02c to the common/type/keyValue module."
},
{
"commit": "c434b9ed885e083baed79c76426a7996d1a17d30",
"date": "2021-04-09 17:03:55 -0400",
"subject": "Refactor common/type/xml module with inline getters/setters.",
"body": "Extend the pattern introduced in 79a2d02c to the common/type/xml module."
},
{
"commit": "e18f3c1701b83037431354c41871e9daf16db9d4",
"date": "2021-04-09 15:56:42 -0400",
"subject": "Remove unused XML constructors.",
"body": "These alternate constructors may have been used in the Perl days but they are no longer used so remove them."
},
{
"commit": "ddd37ebf7dcef30322346c34f09aae44a0ca35a2",
"date": "2021-04-09 15:31:31 -0400",
"subject": "Refactor common/exec module with inline getters/setters.",
"body": "Extend the pattern introduced in 79a2d02c to the common/exec module."
},
{
"commit": "1d674c352f1d6fc1875946d32aa0f5db5c0082b7",
"date": "2021-04-09 14:32:21 -0400",
"subject": "Refactor db module with inline getters/setters.",
"body": "Extend the pattern introduced in 79a2d02c to the db module."
},
{
"commit": "442b2e41b1561a5d7f5e06097116279ee173e626",
"date": "2021-04-09 13:48:40 -0400",
"subject": "Refactor info modules with inline getters/setters.",
"body": "Extend the pattern introduced in 79a2d02c to the info modules."
},
{
"commit": "4937653a3df1948ec8c5d9f62075e0f287852ce8",
"date": "2021-04-08 16:46:42 -0400",
"subject": "Refactor protocol modules with inline getters/setters.",
"body": "Extend the pattern introduced in 79a2d02c to the protocol modules."
},
{
"commit": "235e32b57db36ca43bc47c5028ad9b619c223a68",
"date": "2021-04-08 14:47:53 -0400",
"subject": "Add const keyword to module scope constants.",
"body": "These pointers should never be modified, so mark them const."
},
{
"commit": "6c005afd5bcd7260976908dd2ddb2cdb9031996a",
"date": "2021-04-08 14:38:20 -0400",
"subject": "Add Ubuntu 20.04 test VM definition."
},
{
"commit": "d30ec9c9aeaaa454078b67a5998614f0b4c9c81d",
"date": "2021-04-08 10:04:57 -0400",
"subject": "Replace OBJECT_DEFINE_MOVE() and OBJECT_DEFINE_FREE() with inlines.",
"body": "Inline functions are more efficient and if they are not used are automatically omitted from the binary.\n\nThis also makes the implementation of these functions easier to find and removes the need for a declaration. That is, the complete implementation is located in the header rather than being spread between the header and C file."
},
{
"commit": "351e7db4c4df6329f87ceb63b7c0fb253bed1463",
"date": "2021-04-07 16:27:55 -0400",
"subject": "Replace OBJECT_DEFINE_FREE_RESOURCE_BEGIN() with normal functions.",
"body": "OBJECT_DEFINE_MOVE() and OBJECT_DEFINE_FREE() will be replaced with inlines so this would be the only macro left that is constructing functions.\n\nIt is not a great pattern anyway since it makes it hard to find the function implementation."
},
{
"commit": "cc85c4f03d78492cf8158cf02c51e8eb8bab24e6",
"date": "2021-04-07 14:27:57 -0400",
"subject": "Replace OBJECT_DEFINE_GET() with *Pub struct pattern.",
"body": "This macro was originally intended to simplify the creation of simple getters but it has been superseded by the pattern introduced in 79a2d02c.\n\nRemove instances of OBJECT_DEFINE_GET() to avoid confusion with the new pattern."
},
{
"commit": "b715c70b464d4bb2eaa347b6b83902040caa8cd8",
"date": "2021-04-07 14:04:38 -0400",
"subject": "Refactor storage modules with inline getters/setters.",
"body": "Extended the pattern introduced in 79a2d02c to the storage modules: Storage, StorageRead, StorageWrite."
},
{
"commit": "79a2d02c9c8c00a2db6c34ddf73223f159288c56",
"date": "2021-04-07 12:50:33 -0400",
"subject": "Refactor List, StringList, and VariantList for performance.",
"body": "Introduce a standard pattern for exposing public struct members (as documented in CODING.md) and use it to inline lstSize() which should improve the performance of iterating large lists.\n\nSince many functions in these modules are just thin wrappers of other functions, inline where appropriate.\n\nRemove strLstExistsZ() and strLstInsertZ() since they were only used in tests, where the String version of the function is sufficient.\n\nMove strLstNewSplitSizeZ() to command/help/help.c and remove strLstNewSplitSize(). This function has only ever been used by help and does not seem widely applicable."
},
{
"commit": "904738a5f180ee3040fd7626c894b134dbaf164a",
"date": "2021-04-05 10:25:01 -0400",
"subject": "Update config.sub to latest version."
},
{
"commit": "8461961e5c832ffd8e255b76ccd0125e0cd83e00",
"date": "2021-04-05 10:23:16 -0400",
"subject": "Begin v2.34 development."
},
{
"commit": "a3d89143d6b34c6019cd29e059d28487037fd109",
"date": "2021-04-05 09:18:20 -0400",
"subject": "v2.33: Multi-Repository and GCS Support"
},
{
"commit": "a6a544c7f9cda61af854ef980924d36c02b514bd",
"date": "2021-04-02 15:35:41 -0400",
"subject": "Fix extraneous hrnReplaceKey() calls in unit tests.",
"body": "hrnReplaceKey() was added to the TEST_ERROR*() macros in 58760486 but some calls to TEST_ERROR*() already used it. This led to the function being called twice on the same buffer which had no effect but valgrind definitely did not like.\n\nRemove extraneous calls to make valgrind happy. Since this is test code there are no implications for production."
},
{
"commit": "1615cb02610668b6eae2e3907519212eabd1ad30",
"date": "2021-03-31 10:36:22 -0400",
"subject": "Add --gen-check option to test.pl to check autogenerated code.",
"body": "Make sure that auto-generated code does not change during CI.\n\nThis is useful for catching missed code generation, especially help.auto.c."
},
{
"commit": "e89452557ee8b0b883716331e8d542310875eadd",
"date": "2021-03-31 09:41:33 -0400",
"subject": "Update to help.auto.c missed in d372dd652c9."
},
{
"commit": "d372dd652c9a01b72444998d87f0f44464676803",
"date": "2021-03-31 09:36:56 -0400",
"subject": "Update reference to include links to user guide examples.",
"body": "The command-example and command-example-list elements were removed from the documentation rendering some time ago so these tags were dead code. The tags, however, contained some examples and information that were pertinent to the command, so where possible, the information was included in the description of the command and/or the user-guide and links to the relevant user guide sections were added.\r\n\r\nNote that some commands could not be updated with user guide references since doing so would cause a cyclical reference in the user guide. These commands have an internal comment to indicate this.\r\n\r\nIn addition, some clarifications were added (e.g. expire --set option) where information was lacking."
},
{
"commit": "fead2360da5634b278dba621aa98790add120762",
"date": "2021-03-30 15:49:03 -0400",
"subject": "Link Github issues/PRs to release notes.",
"body": "This makes it easier to determine which release notes relate to issues and PRs, especially for bug fixes or user requests."
},
{
"commit": "21db7f65ef497d323b37c0aa60c89f4c7c754622",
"date": "2021-03-29 09:49:42 -0400",
"subject": "Update to help.auto.c missed in 75987621."
},
{
"commit": "75987621fab5f57d0e95b42eabd301731587c438",
"date": "2021-03-26 10:11:06 -0400",
"subject": "Add note about required NFS settings being the same as PostgreSQL."
},
{
"commit": "3e206088e79c4a73a20b8f2fda1706c6b95fa188",
"date": "2021-03-26 09:25:31 -0400",
"subject": "Add compress-level defaults per compress-type value.",
"body": "Document these defaults until they can be added to the config parser and automated."
},
{
"commit": "b6106f3c1f586b410c50c9da8dcea583cc157423",
"date": "2021-03-25 15:33:50 -0400",
"subject": "Add archive-header-check option.",
"body": "Enabled by default, this option checks the WAL header against the PostgreSQL version and system identifier to ensure that the WAL is being copied to the correct stanza. This is in addition to checking pg_control against the stanza and verifying that WAL is being copied from the same PostgreSQL data directory where pg_control is located.\r\n\r\nTherefore, disabling this check is fairly safe but should only be done when required, e.g. if the WAL is encrypted."
},
{
"commit": "01b8e2258f6efa5386665c33cb5c267c154376fb",
"date": "2021-03-25 12:54:49 -0400",
"subject": "Improve archive-push command fault tolerance.",
"body": "3b8f0ef missed some cases that could cause archive-push to fail:\r\n\r\n* Checking archive info.\r\n* Checking to see if a WAL segment already exists.\r\n\r\nThese cases are now handled so archive-push can succeed on any valid repos."
},
{
"commit": "2789d3b6206c4de9299a3bc459e04cdab793abc9",
"date": "2021-03-25 12:29:36 -0400",
"subject": "Improve info command fault tolerance.",
"body": "This improvement reduces the number of errors thrown; these errors will now be reported as a status for the stanza or repo as appropriate. Invalid option configurations are still thrown but all other errors are caught, formatted and reported. This was necessary for multiple repositories so that the command can complete gathering information from each repository and report the results rather than immediately aborting when an error occurs.\r\n\r\nTwo new error codes were introduced:\r\n6 = requested backup not found\r\n99 = other, which is used to indicate an error has occurred that requires more details to be provided\r\n\r\nA new stanza name of \"[invalid]\" was created for instances where a stanza was not specified and no stanza can be found.\r\n\r\nIf there is only one repository configured the error will move up to the stanza level with the standard error formatting of 'error (message)' where the message will be \"other\" and the details of the error will be listed on the next line(s):\r\n\r\nstanza: stanza1\r\n status: error (other)\r\n [CryptoError] unable to load info file '/var/lib/pgbackrest/repo/backup/stanza1/backup.info' or '/var/lib/pgbackrest/repo/backup/stanza1/backup.info.copy':\r\n CryptoError: cipher header invalid\r\n HINT: is or was the repo encrypted?\r\n FileMissingError: unable to open missing file '/var/lib/pgbackrest/repo/backup/stanza1/backup.info.copy' for read\r\n HINT: backup.info cannot be opened and is required to perform a backup.\r\n HINT: has a stanza-create been performed?\r\n HINT: use option --stanza if encryption settings are different for the stanza than the global\r\n cipher: aes-256-cbc\r\n\r\nIf a backup set is requested but is not found on any repo, a stanza-level status error of 'requested backup not found' is reported when there are no other errors:\r\n\r\npgbackrest info --stanza=demo --set=bogus\r\nstanza: demo\r\n status: error (requested backup not found)\r\n cipher: mixed\r\n repo1: aes-256-cbc\r\n repo2: none\r\n\r\nIf there are multiple repositories configured and a single repo is in error but the other repos are ok or have a different error:\r\n\r\npgbackrest info --stanza=demo --set=20210322-171211F\r\nstanza: demo\r\n status: mixed\r\n repo1: error\r\n [CryptoError] unable to load info file '/var/lib/pgbackrest/repo/backup/stanza1/backup.info' or '/var/lib/pgbackrest/repo/backup/stanza1/backup.info.copy':\r\n CryptoError: cipher header invalid\r\n HINT: is or was the repo encrypted?\r\n FileMissingError: unable to open missing file '/var/lib/pgbackrest/repo/backup/stanza1/backup.info.copy' for read\r\n HINT: backup.info cannot be opened and is required to perform a backup.\r\n HINT: has a stanza-create been performed?\r\n HINT: use option --stanza if encryption settings are different for the stanza than the global\r\n repo2: ok\r\n cipher: mixed\r\n repo1: aes-256-cbc\r\n repo2: none\r\n\r\n db (current)\r\n wal archive min/max (12): 000000010000000000000001/000000010000000000000003\r\n\r\n full backup: 20210322-171211F\r\n timestamp start/stop: 2021-03-22 17:12:11 / 2021-03-22 17:12:28\r\n wal start/stop: 000000010000000000000002 / 000000010000000000000002\r\n database size: 23.4MB, database backup size: 23.4MB\r\n repo2: backup set size: 2.8MB, backup size: 2.8MB\r\n database list: postgres (13359)\r\n\r\nJson output will include the repository information and any error information. If no stanzas are found, then [invalid] will be set as the name:\r\n\r\n[\r\n {\r\n \"archive\":[],\r\n \"backup\":[],\r\n \"cipher\":\"none\",\r\n \"db\":[],\r\n \"name\":\"[invalid]\",\r\n \"repo\":[\r\n {\r\n \"cipher\":\"none\",\r\n \"key\":1,\r\n \"status\":{\r\n \"code\":99,\r\n \"message\":\"[PathOpenError] unable to list file info for path '/var/lib/pgbackrest/repo2/backup': [13] Permission denied\"\r\n }\r\n }\r\n ],\r\n \"status\":{\r\n \"code\":99,\r\n \"lock\":{\"backup\":{\"held\":false}},\r\n \"message\":\"other\"\r\n }\r\n }\r\n]"
},
{
"commit": "7d7ac0e0eb63a02bbc1dd8bd8fc89c6008c740f8",
"date": "2021-03-25 07:07:16 -0400",
"subject": "Exclude content-length from S3 signed headers.",
"body": "The content-length header was being signed since it was the only header that didn't need to be and it seemed simpler just to sign it as well. Also, the S3 documentation encourages signing as many headers as possible to avoid tampering.\r\n\r\nHowever, some proxies munge this header causing authentication failure, so skip signing content-length."
},
{
"commit": "5876048675dceb76b8ddac8757ad47be8b55a817",
"date": "2021-03-23 18:20:26 -0400",
"subject": "Allow key replacements in TEST_ERROR*() macros.",
"body": "Allow standard replacements (e.g. {[path]}) in TEST_ERROR*() macros.\n\nUpdate command/archive-push unit test as an example of usage."
},
{
"commit": "b2440947fb0e585aa515fc6b1edfa0d164606a54",
"date": "2021-03-18 16:29:14 -0400",
"subject": "Fix comment type and phrasing."
},
{
"commit": "6800f9e9cd578c61799c8c0dff803fff15e53021",
"date": "2021-03-18 16:26:30 -0400",
"subject": "Changed unnecessary strNewFmt() to strNew()."
},
{
"commit": "73e94a4e9c32a3dd32e1a1e763a55eb3ea121e05",
"date": "2021-03-16 17:02:03 -0400",
"subject": "Fix comment typo."
},
{
"commit": "2016fac0d9d5ef9196d7b3058d0b854adf4472ca",
"date": "2021-03-16 13:09:34 -0400",
"subject": "Improve protocol handlers.",
"body": "Make protocol handlers have one function per command. This allows the logic of finding the handler to be in ProtocolServer, isolates each command to a function, and removes the need to test the \"not found\" condition for each handler."
},
{
"commit": "b1d945ebb774c25676155af439b0558e8582bbe5",
"date": "2021-03-16 12:42:55 -0400",
"subject": "Fix repo-ls / on S3 repositories.",
"body": "S3 returns 200 for HEAD / which indicates it is a file but does not return the expected headers which causes an error.\r\n\r\nRather than fix this for S3, just automatically return / as not existing for any storage that does not support paths.\r\n\r\nAlso add some defensive checks to prevent this from generating a segfault if it happens again."
},
{
"commit": "0eb5b22ffa02bb01e8dcf013c7b716c867d4acee",
"date": "2021-03-15 17:24:58 -0400",
"subject": "Add back performance tests lost during Github Actions switch.",
"body": "These tests do not provide code coverage but testing them regularly is important so they work when needed."
},
{
"commit": "6942ff569dd950a5146faa0bebfee69e241c4179",
"date": "2021-03-15 12:54:14 -0400",
"subject": "Include recreated system databases during selective restore.",
"body": "Some standard system databases (e.g. postgres) may be recreated by the user and have an OID that makes them look like user databases.\r\n\r\nIdentify the standard three system databases (template0, template1, postgres) and restore them non-zeroed no matter what OID they have."
},
{
"commit": "c0283eec99325cafe0b4e94750a8efc99976cccf",
"date": "2021-03-12 17:13:34 -0500",
"subject": "Explicitly free local processes after restore error unit test.",
"body": "Local processes are still running after this error and it is best to free them before ending the test."
},
{
"commit": "ec347847e5f1f38a646220bdbeb59b77d1c8e89f",
"date": "2021-03-12 15:19:32 -0500",
"subject": "Pass cipher type directly to backupFileProtocol().",
"body": "Cipher type was inferred from the presence of cipherSubPass rather than being passed explicitly in order to maintain compatibility with Perl backupFile().\n\nNow that Perl is gone it makes sense to pass it explicitly, as we do elsewhere."
},
{
"commit": "e07040c2e4a7fd290fa8c26f4297dc7a5b2b9ab1",
"date": "2021-03-12 12:54:34 -0500",
"subject": "Add HRN_STORAGE_TIME() harness macro.",
"body": "Makes updating the time of a path/file more streamlined in tests.\n\nAlso update all tests where utime() was being used directly."
},
{
"commit": "3c85a497a618aed8fe7a26463b4e281c513deb50",
"date": "2021-03-11 14:40:14 -0500",
"subject": "Add backup delta unit test.",
"body": "This test was added to take the place of another test, which turned out not to be workable.\n\nEven so, it adds coverages at little cost so it seems worth keeping."
},
{
"commit": "dc1052f1da0065bf5d8d1b8d50c93d16662dcb51",
"date": "2021-03-11 14:11:21 -0500",
"subject": "Remove extra spaces before macro continuation."
},
{
"commit": "c18abb0af70307b6ec0bfeb08f713e32d8728aaa",
"date": "2021-03-11 12:13:43 -0500",
"subject": "Update to help.auto.c missed in 9506ffae and 92d12ccb."
},
{
"commit": "92d12ccb9bd0787e30441794e2a2a4d4a4e0fe9c",
"date": "2021-03-11 10:19:50 -0500",
"subject": "Update selective restore documentation with caveats.",
"body": "Recovery may error unless --type=immediate is specified. This is because after consistency is reached PostgreSQL will flag zeroed pages as errors even for a full-page write.\r\n\r\nFor PostgreSQL ≥ 13 the ignore_invalid_pages setting may be used to ignore invalid pages. In this case it is important to check the logs after recovery to ensure that no invalid pages were reported in the selected databases."
},
{
"commit": "c862e9654aff198167efeb897957bf93c1afe453",
"date": "2021-03-11 08:22:44 -0500",
"subject": "Log archive copy during backup.",
"body": "Copying can be a fairly expensive operation so it makes sense to log it so the user gets some status during long copy operations."
},
{
"commit": "9506ffae39dd86d2c5454511026f1249097d96a2",
"date": "2021-03-11 07:53:10 -0500",
"subject": "Add compress-type clarification to archive-copy documentation.",
"body": "It is best if the archive-push and backup commands have the same compress-type (e.g. lz4) when using archive-copy. Otherwise, the WAL segments will need to be recompressed with the compress-type used by the backup, which can be fairly expensive depending on how much WAL was generated during the backup."
},
{
"commit": "28301199ebf647909ff31a0fe6df417bd44b6208",
"date": "2021-03-10 18:42:22 -0500",
"subject": "Rename FUNCTION_HARNESS_RESULT*() macros to FUNCTION_HARNESS_RETURN*().",
"body": "When the FUNCTION_*_RESULT*() macros were renamed to FUNCTION_*_RETURN_*() in the core code the test harness macros were missed.\n\nUpdate them to make the naming consistent."
},
{
"commit": "778adbf19f71ceb90071f01197bf189d59b14df0",
"date": "2021-03-10 09:15:35 -0500",
"subject": "Fix memory leak in backup during archive copy.",
"body": "There was already leakage here but when the compression transcoding was added it became a deluge.\n\nThere is some argument to be made that the filters should clean themselves up better but a temp mem context makes sense here anyway so do that."
},
{
"commit": "31c7824a4d84cbf5a0ba0938f4caa546fa67af0a",
"date": "2021-03-10 08:10:46 -0500",
"subject": "Allow stanza-* commands to be run remotely.",
"body": "The stanza-create, stanza-upgrade and stanza-delete were required to be run on the repository host. When there was only one repository allowed this was not a problem.\r\n\r\nHowever, with the introduction of multiple repository support, this becomes more of a burden to the user, therefore the stanza-create, stanza-upgrade and stanza-delete commands have been improved to allow for them to be run remotely."
},
{
"commit": "c4a3dc4e46406634fa0426d80a4fd2f1cd495285",
"date": "2021-03-10 07:44:18 -0500",
"subject": "Combine multi-repo release notes."
},
{
"commit": "dde2e2326b8b8d732ebdc6e48764d0fc381062ca",
"date": "2021-03-08 17:32:36 -0500",
"subject": "Print module type (e.g. c or h) in stack trace.",
"body": "Now that there are inline functions in .h files it is important to include the extension so the functions can be found when debugging."
},
{
"commit": "fe4ba455ed7f5c0685ce928d5dec8ca1247736ac",
"date": "2021-03-08 16:01:05 -0500",
"subject": "Move configuration definition to src/build/config/config.yaml.",
"body": "Moving to YAML allows the configuration data to be read by C programs.\n\nAlso go back to using YAML::XS since it is the only implementation that has proper boolean support."
},
{
"commit": "1dbb3bf50b94dcc9d53dfe1e5ad57a17bd6d38e8",
"date": "2021-03-08 13:31:13 -0500",
"subject": "Multiple repository support.",
"body": "Up to four repositories may be configured. A potential benefit is the ability to have a local repository for fast restores and a remote repository for redundancy.\r\n\r\nSome commands, e.g. stanza-create/stanza-upgrade, will automatically work with all configured repositories while others, e.g. stanza-delete, will require a repository to be specified using the repo option. See the command reference for details on which commands require the repository to be specified.\r\n\r\nNote that the repo option is not required when only repo1 is configured in order to maintain backward compatibility. However, the repo option is required when a single repo is configured as, e.g. repo2. This is to prevent command breakage if a new repository is added later.\r\n\r\nThe archive-push command will always push WAL to the archive in all configured repositories but backups will need to be scheduled individually for each repository. In many cases this is desirable since backup types and retention will vary by repository. Likewise, restores must specify a repository. It is generally better to specify a repository for restores that has low latency/cost even if that means more recovery time. Only restore testing can determine which repository will be most efficient.\r\nFor single repository configurations there should be no change in behavior."
},
{
"commit": "8b87e66448a30b07c12ac00cb2c6ee2f5f29f043",
"date": "2021-03-05 17:48:53 -0500",
"subject": "Update to help.auto.c missed in e7bbdf38."
},
{
"commit": "a5f07dff0afdc776a04ca1c4554ad016168f5d63",
"date": "2021-03-05 16:27:57 -0500",
"subject": "Remove autoconf cache when configure is built."
},
{
"commit": "e7bbdf38ecae3705908a267c91c7d98adec3f927",
"date": "2021-03-05 12:57:07 -0500",
"subject": "Fix option validity by role and make sections conform to C help.",
"body": "The HTML command reference was showing some options that were not valid because it did not properly understand the new role validity system. Also, the custom section for the new repo option was not being honored.\n\nThis is a bit messy because it leads to some duplicated code in help.c but there doesn't seem to be any way to fix that with the Perl data structures as they are.\n\nThis code is being migrated to C so it doesn't seem worth messing with it too much with the risk of breaking other things."
},
{
"commit": "088662d986288843d1bfd118b724091c93df4569",
"date": "2021-03-05 12:13:51 -0500",
"subject": "GCS support for repository storage.",
"body": "GCS and GCS-compatible object stores can now be used for repository storage."
},
{
"commit": "20bb544e7a321562bf0c9061a91369bb6a12d7c1",
"date": "2021-03-05 08:41:15 -0500",
"subject": "Fix .gitignore in doc directory.",
"body": "doc/output/* was invalid and use output/ to exclude the dir as well as the files in it."
},
{
"commit": "753b60d3d51b89798ce5126f599126c77bbbec03",
"date": "2021-03-04 14:21:30 -0500",
"subject": "Add missing assert."
},
{
"commit": "95063f6812279cd59380fd72e16e67b631582bd0",
"date": "2021-03-03 09:21:06 -0500",
"subject": "Make --repo optional for remaining commands except stanza-delete.",
"body": "Some commands (repo-*, verify) still required the --repo option but it makes sense to give them the same treatment as backup and simply use the first repo when one is not specified.\n\nThis leaves stanza-delete as the only remaining command that requires --repo. This is by design to enhance safe usage."
},
{
"commit": "cb26e8c72d74cc36373a8e882a446ef0e37043ed",
"date": "2021-03-02 17:00:08 -0500",
"subject": "Update to help.auto.c missed in d1aa765a."
},
{
"commit": "d1aa765a9d5f290738c1de00c5ea99d5f6056ba5",
"date": "2021-03-02 13:51:40 -0500",
"subject": "Consolidate less commonly used repository storage options.",
"body": "The following options are renamed as specified:\r\n\r\nrepo1-azure-ca-file -> repo1-storage-ca-file\r\nrepo1-azure-ca-path -> repo1-storage-ca-path\r\nrepo1-azure-host -> repo1-storage-host\r\nrepo1-azure-port -> repo1-storage-port\r\nrepo1-azure-verify-tls -> repo1-storage-verify-tls\r\nrepo1-s3-ca-file -> repo1-storage-ca-file\r\nrepo1-s3-ca-path -> repo1-storage-ca-path\r\nrepo1-s3-host -> repo1-storage-host\r\nrepo1-s3-port -> repo1-storage-port\r\nrepo1-s3-verify-tls -> repo1-storage-verify-tls\r\n\r\nThe old option names (e.g. repo1-s3-port) will continue to work for repo1, but repo2, etc. will require the new names."
},
{
"commit": "e64999db7744cad55117f582c2cd42fb4b836f6f",
"date": "2021-03-01 13:44:47 -0500",
"subject": "Add HttpUrl object.",
"body": "Parse a URL into component parts."
},
{
"commit": "1d77db31433032041bd1cf5ff318fb3630bd4500",
"date": "2021-02-28 18:02:09 -0500",
"subject": "Add storageInfoLevelType.",
"body": "This allows the removal of the callback in the S3/Azure storage drivers that existed only to parse the size/time information.\n\nThe extra callback was required because not all callers of storage*ListInternal() want size/time info, so it was wasteful to add it to storage*ListInternal(). Now those callers can request type info only."
},
{
"commit": "54c4eb0c10758879b4bf2b96efd2a1523ecccc21",
"date": "2021-02-28 17:42:32 -0500",
"subject": "Make remote storage objects writeable.",
"body": "This wasn't exposed before because the remote protocol directly uses the storage driver, which bypasses the writeable checks.\n\nHowever, the upcoming GCS driver explicitly requests write permissions so remote operations fail when a write is required.\n\nIt would be far better if the remote itself was marked as writeable but that will require much more work."
},
{
"commit": "46922ff2e98a7c1a3c7950c18d2a86653938dcb4",
"date": "2021-02-28 17:31:23 -0500",
"subject": "Fix comments."
},
{
"commit": "0766b7e524f62c00d61d5588ef1491bbcccaf9a0",
"date": "2021-02-28 17:27:48 -0500",
"subject": "Suppress implicit-fallthrough warning.",
"body": "Warning on missing breaks in switch statements works great until it is intended.\n\nSuppressing on a case by case basis varies by compiler and version so is not very practical. Our tests should be sufficient to the task of finding missing breaks."
},
{
"commit": "a1341b4af013a757c60de0f0595e2839f2ac27e6",
"date": "2021-02-28 17:00:41 -0500",
"subject": "Make S3/Azure file missing error messages match Posix.",
"body": "The S3 driver was missed when the constants were added and then Azure was copied from S3."
},
{
"commit": "3fb6da6412fd403820ba92e5076cf3b36bda138c",
"date": "2021-02-28 16:01:38 -0500",
"subject": "Add missing linefeed."
},
{
"commit": "3b8f0ef7ae8a81ae969934fff4ad3da299454b24",
"date": "2021-02-26 16:52:59 -0500",
"subject": "Add write fault-tolerance to archive-push command.",
"body": "The archive-push command will continue to push even after it gets a write error on one or more repos. The idea is to archive to as many repos as possible even we still need to throw an error to PostgreSQL to prevent it from removing the WAL file."
},
{
"commit": "a1280c41e530500e5bbde73a900683f6db207686",
"date": "2021-02-26 15:58:11 -0500",
"subject": "Refactor archive-push command warnings to work like archive-get.",
"body": "Warnings are logged individually in the async log rather than all together."
},
{
"commit": "13dc8e68d74fa9e06180e67b7e59994767b4a34d",
"date": "2021-02-26 14:49:50 -0500",
"subject": "Make --repo optional for backup command.",
"body": "If there are multiple repos and the --repo option is not specified then backup will automatically select the highest priority repo."
},
{
"commit": "9243962b9504787c6f4af42318af6dc27094136d",
"date": "2021-02-25 12:03:44 -0500",
"subject": "Allow custom config-path default with ./configure --with-configdir.",
"body": "Add --with-confdir=DIR option to configure, which can be used to override the default configuration directory of /etc/pgbackrest.\r\n\r\nProbably in the future it would be better to just leverage ${sysconfdir} which is based on prefix, but since previously the config directory was hard coded to /etc/pgbackrest, we retain that default value by not relying on sysconfdir for now."
},
{
"commit": "0ddc0380ff408f9ed6e8bcd4d328df500681ce77",
"date": "2021-02-24 11:32:13 -0500",
"subject": "Remove restore default repo from integration tests.",
"body": "The default is now to scan all repos so update the integration tests to reflect that."
},
{
"commit": "8f03c3574b40b589b19a601a48c469da8305fc78",
"date": "2021-02-24 08:27:58 -0500",
"subject": "Reduce default file log level for integration tests.",
"body": "The real/all test could fill the ramdisk depending on which vm and pg version were selected.\n\nDebug level should be fine for most purposes and the level can be increased when needed."
},
{
"commit": "065b2ff2300a9f06a8c32621fac521451ca942bd",
"date": "2021-02-23 16:27:05 -0500",
"subject": "Refactor info command repoMin/Max."
},
{
"commit": "118d9e64fea71c2e049b52802e55f72f5793871b",
"date": "2021-02-23 16:17:27 -0500",
"subject": "Enhance restore command multi-repo support.",
"body": "The restore command automatically defaults to selecting the latest backup from a single repository. With multiple repositories configured, the restore command will now default to selecting the latest backup from the first repository where backups exist. The order in which the repositories are checked is dictated by the pgbackrest.conf order.\n\nTo select from a specific repository, the --repo option can be passed (e.g. --repo=1). The --set option can be passed if a backup other than the latest is desired."
},
{
"commit": "bec3e20b2cb061ef0413df24234ebe246ea53063",
"date": "2021-02-23 15:34:28 -0500",
"subject": "Add archive-get command multi-repo support.",
"body": "Repositories will be searched in order for the requested archive file.\n\nErrors will be reported as warnings as long as a valid copy of the archive file is found."
},
{
"commit": "e28f6f11e97a80e9c1adf1a6eaeeabbfc991914f",
"date": "2021-02-23 12:20:02 -0500",
"subject": "Expire continues if an error occurs processing a repository.",
"body": "Errors are logged to the log file rather than thrown. If, after processing all repos, one or more errors occurred, then a single error error will be thrown to indicate there were errors and the log file should be inspected.\n\nAlso update log messages to be more consistent with new patterns."
},
{
"commit": "e14036bf57866ea7c2ed4c6fdf7cc204a8f00cb7",
"date": "2021-02-23 07:33:32 -0500",
"subject": "Remove unused header files in S3 and Azure storage modules."
},
{
"commit": "6fb9de9a48630722df3b398cacb09ae964dc825d",
"date": "2021-02-23 06:35:45 -0500",
"subject": "Use list to search for WAL segments to preserve in queueNeed().",
"body": "The regular expression predates strLstFind() on sorted lists. Using the list is both simpler and faster."
},
{
"commit": "00b60e564eef13f8adba0ab867fcde2c352669d6",
"date": "2021-02-19 19:21:06 -0500",
"subject": "Add base64url encoding.",
"body": "For now only encoding is supported. Decoding is not needed and may never be."
},
{
"commit": "a1f4fd32a1790e569ccae3598cd9648bb25d13b6",
"date": "2021-02-19 19:03:42 -0500",
"subject": "Add ASSERT_MSG().",
"body": "Used when execution reaches an invalid location rather than an invalid condition."
},
{
"commit": "f6c3262861252b24e7e0cffd6d67e0c5e3291f3e",
"date": "2021-02-19 18:25:50 -0500",
"subject": "Do not expose valid/validate functions from encode module.",
"body": "These functions have never been used externally. Validation is always part of decoding so performing validation separately would be wasteful."
},
{
"commit": "edab2a0b89eabc5fd5ba6e795d938670bd5d3105",
"date": "2021-02-19 17:57:13 -0500",
"subject": "Use switch rather than if-else for encoding types.",
"body": "This is more efficient and the error case can be an assert rather than a runtime error.\n\nFor extra safety initialize destinationSize to SIZE_MAX to increase the chances of an error if the switch fails."
},
{
"commit": "abcbe0f9c1804ecb1b93b811cfb0a362c17e1b85",
"date": "2021-02-19 17:25:00 -0500",
"subject": "Combine encode module files into a single file.",
"body": "There is not enough code here to justify multiple files and declaring the functions for each encoding as static allows the compiler to inline where appropriate."
},
{
"commit": "d4856096587c72daee76f8ad8408db677a16d6dd",
"date": "2021-02-19 17:05:15 -0500",
"subject": "Add strNewEncode(), strCatEncode(), and bufNewDecode().",
"body": "These constructors wrap encodeToStr() and decodeToBin(), making them convenient and safe by eliminating the need to create intermediate buffers. Encoding/decoding is performed directly into the target String/Buffer. Sizing of the destination buffer is handled by the new functions so it doesn't have to be done at each call site."
},
{
"commit": "5b98968605d5ce73918ee84d8bb3ec83b6f21c65",
"date": "2021-02-19 10:29:29 -0500",
"subject": "Do not lower-case help summaries when first word is an acronym.",
"body": "If the second letter is capital or a digit then the word is likely an acronym so don't lower-case the first letter.\n\nFor now only the digit case is checked since there are no summaries with a capital as the second letter."
},
{
"commit": "66a4ff496afe63305cb1a437bcb52d1efc11edf7",
"date": "2021-02-19 09:05:32 -0500",
"subject": "Encode path before passing to HttpRequest.",
"body": "GCS requires mixed encoding in the path so encoding inside HttpRequest does not work.\n\nInstead, require the path to be correctly encoded before being passed to HttpRequest."
},
{
"commit": "1b4b3538cc218f66ed1e903c3caeade4b0ab1120",
"date": "2021-02-19 08:22:50 -0500",
"subject": "Rename uri to path where appropriate in HTTP and storage modules.",
"body": "The path was originally named uri due to the canonicalized path being called \"canonicalized uri\" in the S3 authentication documentation. The name got propagated everywhere from there.\n\nThis is not correct for general usage, however, so rename to path when describing the path component of an HTTP request."
},
{
"commit": "dcb79ab8fb18c63c2d56ecacd9d680b999ea044b",
"date": "2021-02-19 07:32:40 -0500",
"subject": "Decode JSON \\u escaped characters.",
"body": "ASCII may occasionally be encoded (e.g. &) to prevent ambiguity depending on where the JSON is located.\n\nOnly ASCII can be decoded. In general Unicode should not be encoded in JSON."
},
{
"commit": "c4243331de250926328045aa25c60a0c94262fa2",
"date": "2021-02-19 07:24:59 -0500",
"subject": "Silence chmod warning of empty path when removing unit test data."
},
{
"commit": "3837e61a7504b1e211e4b3a70cbe97343c1cf2e6",
"date": "2021-02-18 13:29:09 -0500",
"subject": "Fix option warnings breaking async archive-get/archive-push.",
"body": "Option warnings will cause the async process to fail because a warning is logged but stdout is closed so the process aborts.\r\n\r\nThis bug has existed for quite some time, but it was made worse by abb8ebe because now the async role can have different valid options than the default role. Previously at least a warning would be emitted before the async process died.\r\n\r\nFix this by only allowing warnings for the default role. Warnings were already suppressed for local and remote roles so the logic already exists."
},
{
"commit": "d7befd4189cbfafb8984468fc13318fa087dc812",
"date": "2021-02-16 16:28:19 -0500",
"subject": "Fix tests that ensure log levels are not set for local/remote roles.",
"body": "These tests were broken because they were being gated by resetLogLevel. So they were not setting the log levels, but not because of the role setting. Because resetLogLevel was being checked last coverage testing indicated that the tests were working.\n\nFix the resetLogLevel parameter in the tests and move resetLogLevel to be tested first so coverage reporting works as expected. This isn't perfect but it is an improvement."
},
{
"commit": "d29855bd0bf8b957fa8c06445d22e425c443a704",
"date": "2021-02-12 10:08:47 -0500",
"subject": "Fix stack overflow in cipher passphrase generation.",
"body": "The destination buffer on the stack was not large enough to contain the zero-terminating character.\r\n\r\nIncrease the buffer size and add an assertion to prevent regressions.\r\n\r\nFound on arm64 running musl libc. Other architectures and glibc do not seem to be affected though it is clearly a bug."
},
{
"commit": "920c746adb1f4db5850bc2e5fdfbb5e1b89d313f",
"date": "2021-02-10 15:54:37 -0500",
"subject": "Better exclusions for configure help.",
"body": "Exclude known unused options rather than trying to include used options. This works better when new options are added."
},
{
"commit": "6a717e032f1309ddc9dc955042b5e2ac2bc7324d",
"date": "2021-02-10 14:46:26 -0500",
"subject": "Set config path in configure script.",
"body": "This allows the config path to be modified with a parameter to the configure script, though this commit does not do that.\n\nUpdate the Perl code generator to allow literals so that defaults can be C defines rather than static strings."
},
{
"commit": "3408f1ee2ee3f774699a15de045e0afe3eaf9a26",
"date": "2021-02-10 12:03:52 -0500",
"subject": "Enhance expire command multi-repo support.",
"body": "The expire command has been enhanced to expire backups and archives from all configured repositories by default.\n\nIn addition, it will accept the --repo option to expire backups and archives only from the specified repository. Using the --repo options the --set option can also be refined further to the specified repo. If --set is provided but the --repo option has not, then all repositories will be searched and retention settings will be applied on each whether the backup set has been found or not."
},
{
"commit": "26cbebbda7b04d0b142e28b41205337717959616",
"date": "2021-02-10 09:10:51 -0500",
"subject": "Use latex sloppypar to fix monospace wrapping in PDF rendering.",
"body": "Monospaced identifiers could end up running over if latex was not able to find a place to break the line. Using sloppypar forces breaks so monospaced identifiers don't run over or get broken up.\n\nAlso add vspace to admonitions so they have some separation from the prior text."
},
{
"commit": "c7d7280fa8f2b91cca2517b1bdab4b40603b9bd6",
"date": "2021-02-08 16:36:38 -0500",
"subject": "Ensure test user has permissions before removing test files.",
"body": "This allows files to be deleted even when tests have limited the permissions."
},
{
"commit": "b2bba678a0c7de2a8a0e2c949c68c4897e986151",
"date": "2021-02-08 16:28:16 -0500",
"subject": "Add missing linefeeds."
},
{
"commit": "b9f0070d91ef79dab3ee34015418f0d3bd941089",
"date": "2021-02-08 13:44:50 -0500",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "00f06065e70916f626e4a5278fed6a1f23898c4c",
"date": "2021-02-08 13:18:22 -0500",
"subject": "Begin v2.33 development."
},
{
"commit": "aadc9e2fe6ac54783e61c1ff1660feea4d7b1da0",
"date": "2021-02-08 09:08:16 -0500",
"subject": "v2.32: Repository Commands"
},
{
"commit": "d350d1cc2139038d6f45cfcb5b59a5dc5994d269",
"date": "2021-02-05 11:48:07 -0500",
"subject": "Improve expire command documentation."
},
{
"commit": "b65c370346948708af6f762770836aa27b1acf86",
"date": "2021-02-05 10:39:03 -0500",
"subject": "Add repo-get command."
},
{
"commit": "218cd078a65f4cf15191cc9232eda8d576523592",
"date": "2021-02-05 10:07:43 -0500",
"subject": "Add repo-ls command."
},
{
"commit": "73f61a1f60856d6d7a05d36458981c46222cf3cf",
"date": "2021-02-04 17:24:42 -0500",
"subject": "Add missed comment."
},
{
"commit": "9154d730308f4bf7a37e4a7c513d45b845d2a2cd",
"date": "2021-02-02 17:05:55 -0500",
"subject": "Add -g accidentally removed in 4e8d469f.",
"body": "The tests all run fine without debug info but gdb and valgrind are a lot less useful without it."
},
{
"commit": "4b46115345c8eddaa658bc2051dba30676444fef",
"date": "2021-02-02 13:43:14 -0500",
"subject": "Add archive-mode-check option.",
"body": "This option disallows the PostgreSQL archive_mode=always setting and disabling it allows the setting."
},
{
"commit": "101bf5d11466990092530709e419e83b0d9ce4d4",
"date": "2021-02-01 14:50:22 -0500",
"subject": "Log configuration parameters in config test harness.",
"body": "This makes it easier to find the current configuration in tests."
},
{
"commit": "9baf5d7da7bc7107584c613ccf8ef7192d304ef5",
"date": "2021-02-01 14:42:22 -0500",
"subject": "Set dry-run before updating options in config test harness.",
"body": "This is the same order that is used in cfgLoad() so apply it here as well.\n\nAlso remove vestigial HRN_FEATURE_STORAGE define."
},
{
"commit": "67d444b9e8673aafa6c68ef14e8a7352dda9571e",
"date": "2021-02-01 09:22:01 -0500",
"subject": "Add bufEmpty().",
"body": "This seems more readable than bufUsed() == 0, just like 7d6c0319."
},
{
"commit": "7d6c0319f0cafa1b0ac0d62db57f3970290b40e2",
"date": "2021-01-29 14:27:56 -0500",
"subject": "Add lstEmpty(), strLstEmpty(), and varLstEmpty().",
"body": "This seems more readable than lst*Size() == 0.\n\nHopefully this will also eliminate usage of lst*Size() > 0/lst*Size() != 0 variants for the inverse."
},
{
"commit": "5281e314221538ca2c09a36cd0a3110458457dbe",
"date": "2021-01-27 17:25:13 -0500",
"subject": "Add configurable error handlers.",
"body": "The stackTrace and memContext error handlers were hard-coded which made testing the error module in isolation impossible.\n\nMaking the error handlers configurable also makes adding new ones in the future easier."
},
{
"commit": "8e9f04cc3290f378b90120243b3694dfb113fe16",
"date": "2021-01-27 16:54:41 -0500",
"subject": "Add HRN_INTEST_* define to indicate when a test is being run.",
"body": "This is useful for initialization that needs to be done for the test and all subsequent tests.\n\nUse the new defines to implement initialization for sockets and statistics."
},
{
"commit": "d5b919e65772557f98a211a1e1628c8192053df2",
"date": "2021-01-27 16:33:01 -0500",
"subject": "Update expire command log messages with repo prefix.",
"body": "In preparation for multi-repo support, a repo tag is added in this commit to the expire command log and error messages. This change also affects the expect logs and the user-guide. The format of the tag is \"repoX:\" where X is the repo key used in the configuration.\r\n\r\nUntil multi-repo support has been completed, this tag will always be \"repo1:\"."
},
{
"commit": "5d34bf3f38ff8ce3f88c8aed6c6ff01eb929d62b",
"date": "2021-01-27 11:50:10 -0500",
"subject": "Move cvtDoubleToStr() to strNewDbl().",
"body": "This is a more logical location and it reduces the dependencies required to compile the common/convert module."
},
{
"commit": "87eb081a8f7bf35f7f993316a17d5d42ad225176",
"date": "2021-01-27 10:57:42 -0500",
"subject": "Make unit test builds incremental based on coverage in prior tests.",
"body": "When building tests only include files covered by the current test or by prior tests. This increases performance (less compilation and linking) and also helps detect cross-dependencies in the code. Since there are currently cross-dependencies the depend option is used to document them and allow compilation. The idea is to resolve them incrementally over time.\n\nAdd the harness option to include harness modules when the minimum requirements for compilation are met.\n\nAdd the feature option to indicate which features are now available in the harness (based on source modules already tested). This allows conditional compilation in harness modules when some features are not yet available."
},
{
"commit": "73a8e91868f80b21e35685966aec343cca6a9c7a",
"date": "2021-01-27 10:29:23 -0500",
"subject": "Disable DEBUG_TEST_TRACE when NDEBUG defined.",
"body": "The underlying functions used by the FUNCTION_TEST*() macros will not be able when NDEBUG is defined so disable them.\n\nIt would be better to change #ifndef NDEBUG to #ifdef DEBUG_TEST_TRACE where needed to bring these into alignment but that will be a larger effort best undertaken separately."
},
{
"commit": "088df03355be88150e8a91c9d51dd73c895f5e4c",
"date": "2021-01-26 19:59:14 -0500",
"subject": "Fix indentation in .cirrus.yml."
},
{
"commit": "14f2b41bdaf44eb697b80cbdf58289235234bb74",
"date": "2021-01-26 19:58:28 -0500",
"subject": "Fix .editorconfig indent for yaml files."
},
{
"commit": "59e57c7231488006e5a3681dc72c9328d1998450",
"date": "2021-01-26 19:55:20 -0500",
"subject": "Remove storageLocal() dependency from common/parse module.",
"body": "storageLocal() requires the storage helper which is a huge dependency for this module.\n\nPass in a storage object instead."
},
{
"commit": "468507843f0217f5eb7e9ba437691f4b6dcdb760",
"date": "2021-01-26 19:34:39 -0500",
"subject": "Replace storageLocal() with storageTest in postgres/interface test."
},
{
"commit": "77823af53db1e8efb43def926e5b5e63d989c8c4",
"date": "2021-01-26 19:31:48 -0500",
"subject": "Add test in common/error module.",
"body": "This is required for coverage when the common/error module is run with just the source files required to make it run, rather than all source files as we do now.\n\nLikely something in the harness is providing coverage, but cover it explicitly so the coverage won't be lost if the harness changes."
},
{
"commit": "85ad1aa2be9a2702dbcd923bb1a4e08abc4c7445",
"date": "2021-01-26 12:47:52 -0500",
"subject": "Remove version comment left over from Perl."
},
{
"commit": "456a300bb703024df46cbc34746649c7b54181b2",
"date": "2021-01-26 12:10:24 -0500",
"subject": "Remove too-verbose braces in switch statements.",
"body": "The original intention was to enclose complex code in braces but somehow braces got propagated almost everywhere.\n\nDocument the standard for braces in switch statements and update the code to reflect the standard."
},
{
"commit": "f669da7dcc228da2167b6ad1966a9c035506553f",
"date": "2021-01-26 11:25:29 -0500",
"subject": "Use minio latest in documentation and integration tests.",
"body": "At one time Minio had stability problems with latest but that appears to be resolved for the last year or so.\n\nUse latest so we'll know if something breaks since Minio is frequently used in production."
},
{
"commit": "2e60b937097313be135bce551b59e3f6b9ebb51a",
"date": "2021-01-26 11:21:36 -0500",
"subject": "Add backup verification to internal verify command.",
"body": "This is phase 2 of verify command development (phase 1 was processing the archives and phase 3 will be reconciling the archives and backups). In this phase the backups are verified by verifying each file listed in the manifest for the backup and creating a result set with the list of invalid files, if any. A summary is then rendered.\r\n\r\nUnit tests have been added and duplicate tests have been removed."
},
{
"commit": "5d48dd2fb3717167062acf7c157d0caffb77b2e4",
"date": "2021-01-25 11:33:41 -0500",
"subject": "Use explicit characters instead of Posix class in restore expression.",
"body": "It is not clear how portable/supported the Posix character classes are. This way seems simpler and more portable.\n\nUpdated from 5c98157b."
},
{
"commit": "e251ec574a29b9137defc0f493bc84ce5b82014a",
"date": "2021-01-25 11:14:28 -0500",
"subject": "Add note about removing configuration to stanza-delete documentation."
},
{
"commit": "00fac1c0d18aef6c29067bb00500abc5867f702c",
"date": "2021-01-25 09:19:05 -0500",
"subject": "Improve info command text output and --set handling.",
"body": "The info command provides total sizes for files in the backup on the database as well as the repository. The text output and associated user documentation has been updated to provide more clarity regarding the sizes being displayed.\n\nIn addition, the info command is updated to allow a user to optionally specify the repository when requesting a specific backup set. In this case, the text output will reflect the status of the stanza, the cipher types and archive min/max over all the repositories instead of a single repository when the repo option is specified."
},
{
"commit": "8e48308b0b4110cc11276231c4dee2067ca54e38",
"date": "2021-01-24 18:30:14 -0500",
"subject": "Add XML::Checker::Parser to MacOS Perl modules."
},
{
"commit": "ee71eb28c4ea7986cfd86cd00a9cd30cd058669a",
"date": "2021-01-24 16:27:00 -0500",
"subject": "Add .editorconfig to help enforce project style."
},
{
"commit": "4e8d469f4d02e0956fcbafc54e762252c8964513",
"date": "2021-01-24 16:24:14 -0500",
"subject": "Use configure to generate Makefile variables for unit tests.",
"body": "The unit test Makefile generation was a hodge-podge of constants and rules based on distros/versions that easily got out of date and did not work on an unknown system. All of this dates from the mixed Perl/C unit test implementation.\n\nInstead use configure to generate most of the important Makefile variables, which allows the unit tests to run on multiple platforms, e.g. MacOS and FreeBSD.\n\nThere is plenty of work to be done here and not all the unit tests work on MacOS and FreeBSD for various reasons.\n\nAs a POC update the MacOS and FreeBSD tests on Cirrus-CI to run a few command unit tests."
},
{
"commit": "ef2dc6d3f4fe10251e5ed67375723ec20b87e096",
"date": "2021-01-24 15:48:32 -0500",
"subject": "Add chmod to make file removal after tests more reliable.",
"body": "MacOS does not allow files to be removed recursively unless the owner has write and execute permissions on all the directories.\n\nSome tests leave the permissions in a bad state so fix them up before trying to delete."
},
{
"commit": "04e84da0effa5d3be312c123e5203a9ebc1d04d3",
"date": "2021-01-24 15:35:40 -0500",
"subject": "Allow the make command to be configured for test.pl."
},
{
"commit": "aafd2f528d0536f4a83cb7086b55bb6ff1e6d89c",
"date": "2021-01-24 15:29:10 -0500",
"subject": "Cast constants explicitly in command/backupCommon test.",
"body": "Clang was not clear that these constants should be uint64_t.\n\nFound on MacOS M1."
},
{
"commit": "d922cb6b8e3995cf0303184e2a2c24ed36f2d56b",
"date": "2021-01-24 15:25:02 -0500",
"subject": "Add wheel as possible group name in storage/posix test.",
"body": "Some platforms use wheel as the group for symlinks instead of root."
},
{
"commit": "88e54ee6c7156da4359134cfb2838925d16bc315",
"date": "2021-01-24 15:22:29 -0500",
"subject": "More reliable log expect in common/log test.",
"body": "The exact message is platform dependent so get the platform error to use in the expect.\n\nIt doesn't matter what the message is as long as there is an error and it is logged."
},
{
"commit": "cbccae05b8619019a17dd8bfe2fca8cc7f7cb098",
"date": "2021-01-24 15:18:02 -0500",
"subject": "Skip lz4 in performance/storage test when it is not present."
},
{
"commit": "fda105ebd18f050d8071f62add2933ecbff8b8a7",
"date": "2021-01-24 15:15:50 -0500",
"subject": "Add casts to performance/storage test for 32-bit architectures."
},
{
"commit": "d2057c53bd91ffb96d46d4ee71cc8029d30d6d49",
"date": "2021-01-24 15:06:38 -0500",
"subject": "Use YAML::Any module instead of YAML::XS in Perl.",
"body": "YAML::XS requires libyaml so it not as portable as pure Perl versions of YAML.\n\nInstead of using YAML:PP just use the general YAML::Any module which uses whatever is installed. We are not concerned about performance for YAML so whatever works is fine."
},
{
"commit": "ea0dc8c2cb5c7e6e9d4b09b4fbf451b2d30bfdc8",
"date": "2021-01-24 13:39:13 -0500",
"subject": "Add header required for test harness to compile on FreeBSD."
},
{
"commit": "5c98157bce2ae74a11c04cc6ecc01cd067fadb9a",
"date": "2021-01-24 11:46:55 -0500",
"subject": "Use [[:blank:]] instead of \\s for leading space matching in restore.",
"body": "This is more accurate since we don't really want lf/cr anyway, though the lines have already been split so that's not possible in this code for lf.\n\nFound on MacOS M1. FreeBSD also seems to be fine with the new expression."
},
{
"commit": "3b05f77d083d03c34f47a2372e7eeb684ad5b655",
"date": "2021-01-24 09:08:26 -0500",
"subject": "Add optional warnings to configure.",
"body": "These warnings do not exist on all compilers/versions but are useful when present."
},
{
"commit": "4a83ca4f78c75e905b4b84aff1529ba91213c4dc",
"date": "2021-01-24 08:55:13 -0500",
"subject": "Remove semicolons from TEST_RESULT*() macros.",
"body": "These prevented the macros from being used in single line statements (e.g. if-else).\n\nAlso fix some missing semicolons in macro invocations."
},
{
"commit": "5cb9f166ecf191891f7defcb41d03f4b0ea93475",
"date": "2021-01-24 08:23:59 -0500",
"subject": "Add stderr to unit test error messages.",
"body": "Messages on stderr were being lost due to the error suppression used to customize the error message.\n\nAlso update the formatting to be more informative and concise."
},
{
"commit": "f95850c546ae6c5407eb0b1682362101d5e77c95",
"date": "2021-01-24 08:12:31 -0500",
"subject": "Fix logical -> bitwise boolean operator in backup unit test.",
"body": "This unset more than the storageFeatureCompress flag but the test was not affected.\n\nFound on MacOS M1."
},
{
"commit": "a7d32259cf00565986d065c93be25dc82bb1a024",
"date": "2021-01-24 08:05:31 -0500",
"subject": "Avoid NULL pointer arithmetic in MemContext unit test.",
"body": "Similar to b23a2a0b. In this case add 1 to avoid a NULL pointer.\n\nFound on MacOS M1."
},
{
"commit": "fe8ef3197e85ff30950867254cba15b9112f34bd",
"date": "2021-01-24 07:58:07 -0500",
"subject": "Add MacOS error messages to RegExp unit test."
},
{
"commit": "483695cac6508b03b621742eef9940f4c1fe0bc9",
"date": "2021-01-22 13:16:48 -0500",
"subject": "Don't pass --ignore-missing-args to rsync on MacOS.",
"body": "MacOS has a very old version of rsync that does not support this option.\n\nRather than require a newer version of rsync exclude the option since the plan is to remove the requirement for it."
},
{
"commit": "708c3e9135d69a2d7ac670fe8efbc4ff08b95fa5",
"date": "2021-01-22 12:52:30 -0500",
"subject": "Move version check against release notes to release.pl.",
"body": "This is a more appropriate place for the check and means test.pl can avoid loading any XML files if --no-gen is specified.\n\nThe XML::Checker::Parser module originally selected for XML in Perl is not very portable so the requirement reduces the number of platforms where tests can be run."
},
{
"commit": "fdf1c299f90ccc3b02758af072a58e5d20eaf2c1",
"date": "2021-01-22 11:51:36 -0500",
"subject": "Remove unused VerifyFileResult struct."
},
{
"commit": "b23a2a0baf51b27c3c02fc99074fb033ad61d4dd",
"date": "2021-01-22 10:48:22 -0500",
"subject": "Use uintptr_t in ASSERT_ALLOC_VALID() to avoid pointer arithmetic.",
"body": "Clang justifiably complains about pointer arithmetic on a known NULL value during testing. We know this is fine but use uintptr_t to silence the warnings.\n\nFound on MacOS M1."
},
{
"commit": "185a508f44bbb4cf939658424c2bdb8012cfcb0f",
"date": "2021-01-22 09:50:29 -0500",
"subject": "Add format attribute to stackTraceFmt().",
"body": "Let the compiler know this is a printf-style function so a non-literal format is allowed.\n\nFound on MacOS M1."
},
{
"commit": "a5ebaab249764ccb0727b481d4f7a65512117b34",
"date": "2021-01-22 09:16:36 -0500",
"subject": "Use enum for signalType in exitSignalName().",
"body": "This should have been an enum all along but was somehow missed.\n\nFound on MacOS M1."
},
{
"commit": "547b297387b2097e457c2893beefc1cb1d3ccd1d",
"date": "2021-01-22 09:04:28 -0500",
"subject": "Use uint variant to store enum in verifyProtocol().",
"body": "Avoid the need for a cast by using a matching type.\n\nFound on MacOS M1."
},
{
"commit": "8d883ea76b2e4d48bea3772367ca3e3257434a07",
"date": "2021-01-21 18:30:24 -0500",
"subject": "Fix return type for PQresultStatus().",
"body": "Found on MacOS M1."
},
{
"commit": "bc25e9bf056b7082a1e69a7a59affb1b61ae6f51",
"date": "2021-01-21 17:36:33 -0500",
"subject": "Change variant to uint when building option lists.",
"body": "Enums are uints on most platforms so this works without casting.\n\nFound on MacOS M1."
},
{
"commit": "0869b8afffed2664331a68f72194648593dc7b45",
"date": "2021-01-21 17:29:24 -0500",
"subject": "Cast result of cfgParseOptionId() to int.",
"body": "It would probably make more sense to add an \"invalid\" enum value, but at least fix the cast for now. The function was originally designed to interface with Perl which required -1 in this case.\n\nFound on MacOS M1."
},
{
"commit": "3f72eca90954e26cb060037b97aada4f6f323ccf",
"date": "2021-01-21 17:26:12 -0500",
"subject": "Remove useless casts of vsnprintf() return value.",
"body": "The return value is not checked because we are happy with a truncated result in this case, which is guaranteed by passing the buffer size.\n\nFound on MacOS M1."
},
{
"commit": "6a992a5884976555c20754d57b7ea1f1c30b7b5e",
"date": "2021-01-21 17:23:24 -0500",
"subject": "Add missing mode_t casts.",
"body": "Found on MacOS M1 where mode_t is short."
},
{
"commit": "4b3200961ed8aca74e2fb47feff40b9206fd59b4",
"date": "2021-01-21 17:20:13 -0500",
"subject": "Fix cast for timeval.tv_usec.",
"body": "Found testing on MacOS M1."
},
{
"commit": "6f529155b673fc5c04a51e6d2549655fe2667f3a",
"date": "2021-01-21 17:17:03 -0500",
"subject": "Remove useless assignment."
},
{
"commit": "f32eb9b94ecf01d12f53a1bd6addeba81e811d7f",
"date": "2021-01-21 15:21:50 -0500",
"subject": "Partial multi-repository implementation.",
"body": "Multi-repository implementations for the archive-push, check, info, stanza-create, stanza-upgrade, and stanza-delete commands.\r\n\r\nMulti-repo configuration is disabled so there should be no behavioral changes between these commands and their current single-repo implementations.\r\n\r\nMulti-repo documentation and integration tests are still in the multi-repo development branch. All unit tests work as multi-repo since they are able to bypass the configuration restrictions."
},
{
"commit": "1333748550d61b98c83f0ea1e730ff8360328a8c",
"date": "2021-01-21 14:20:39 -0500",
"subject": "Fix incorrect variable in parameter logging."
},
{
"commit": "d3d484b27c8f9b695ef283a789796751cba43531",
"date": "2021-01-21 11:59:19 -0500",
"subject": "Use standard environment variable format in hrnCfgEnv*().",
"body": "The option portion was not being capitalized or replacing - with _.\n\nThe parser does not care, but in cases where we have mixed hrnCfgEnv*()/setenv() calls the env variable might not get cleared, which can lead to funny test results."
},
{
"commit": "4e56948128878cbeb8ac6faf89d65aae644679bc",
"date": "2021-01-19 12:07:05 -0500",
"subject": "Compensate for numeric auto conversion in newer Perls."
},
{
"commit": "d9fae0984853173f9f867f2eaf640a21e424ec32",
"date": "2021-01-19 11:59:47 -0500",
"subject": "Remove errant todo comment.",
"body": "The test is not a duplicate of the one above because it adds the archive-async option."
},
{
"commit": "a1365b26d4c2383eaacea3714eeb521435ca79aa",
"date": "2021-01-18 23:41:09 -0500",
"subject": "Remove duplicate mkdir for /tmp/pgbackrest in Vagrantfile."
},
{
"commit": "8322dfd7af97e307b952cfb37e6a65b65f55be0f",
"date": "2021-01-18 23:39:14 -0500",
"subject": "Add pkg-config package to Vagrantfile.",
"body": "Newer Ubuntu versions do not install this package by default."
},
{
"commit": "49582c13cfbb49736cc50d333ec74e5be1b9388e",
"date": "2021-01-18 23:05:55 -0500",
"subject": "Use test lock path in archive-get test.",
"body": "The default lock path should fail since the test VM gives ownership of /tmp to root.\n\nFor some reason this was not working as expected under u18 but it fails under u20."
},
{
"commit": "065b5f93aec471b4ac5c189520eb354a3d078b5f",
"date": "2021-01-15 10:56:51 -0500",
"subject": "Improve test coverage list handling.",
"body": "All unit tests now require full coverage so the \"full\" keyword is obsolete and has been removed.\n\nThe covered code modules are simply listed, with only \"no code\" modules annotated."
},
{
"commit": "a8fb285756853bbe2f7b2e88bc817236d23b7ed8",
"date": "2021-01-15 10:15:52 -0500",
"subject": "Improve archive-get performance.",
"body": "Check that archive files exist in the main process instead of the local process. This means that the archive.info file only needs to be loaded once per execution rather than once per file to get.\r\n\r\nStop looking when a file is missing or in error. PostgreSQL will never request anything past the missing file so there is no point in getting them. This also reduces \"unable to find\" logging in the async process.\r\n\r\nCache results of storageList() when looking for multiple files to reduce storage I/O.\r\n\r\nLook for all requested archive files in the archive-id where the first file is found. They may not all be there, but this reduces the number of list calls. If subsequent files are in another archive id they will be found on the next archive-get call."
},
{
"commit": "38583b6414d8d55c92a25a1d32c4bc9457b912c4",
"date": "2021-01-15 08:59:16 -0500",
"subject": "Add cfgOptionValid() check to assert in cfgOptionIdxTest().",
"body": "Skip the rest of the assert if the option is not valid since this function is intended to work with invalid options."
},
{
"commit": "7f263dceb7aee6c8d43313ac954d279868be3661",
"date": "2021-01-15 08:30:56 -0500",
"subject": "Fix inverted cfgOption*() calls.",
"body": "These currently work because repoIdx is always 0."
},
{
"commit": "298cc4d5e5d79b400beac4b70352e625e56b0ed6",
"date": "2021-01-14 10:39:25 -0500",
"subject": "Remove non-conforming periods and reformat some comments."
},
{
"commit": "c2c702c09d4ac3ea858d0450695a789c999b99da",
"date": "2021-01-13 17:32:42 -0500",
"subject": "Add co7 package to support llvm.",
"body": "This is required for new package versions.\n\nAlso remove the obsolete 9.2 package and update the supported versions list."
},
{
"commit": "a57e0be395146aa13d136b583a015c8077adbadd",
"date": "2021-01-13 13:01:40 -0500",
"subject": "Add duplicate WAL test to synchronous archive-get."
},
{
"commit": "22fd223fc393908f6f0d5f0a64ee8f93317ce24e",
"date": "2021-01-13 10:24:47 -0500",
"subject": "Improve logging in archive-get command.",
"body": "Append \"asynchronously\" to messages when the async process fetched the file (not in the actual async process log, though).\n\nAdd \"repo1\" to make it clear what archive we are talking about. This is not very useful by itself but soon we'll be able to add the archive id, which is very useful.\n\nAdd constants for messages that are used multiple times to ensure they stay consistent."
},
{
"commit": "c6aaf66e9d8c83ba7443bcce145802b1147a4daf",
"date": "2021-01-13 07:49:47 -0500",
"subject": "Add FUNCTION_LOG_RETURN_STRUCT() and update where appropriate.",
"body": "The FUNCTION_LOG_RETURN() macro requires logging macros (e.g. FUNCTION_LOG_*_TYPE and FUNCTION_LOG_*_FORMAT) when returning a struct but these macros don't deliver much value since they only output the name of the struct rather than the contents. A copy of the struct is also made during this operation, which is wasteful.\n\nFUNCTION_LOG_RETURN_STRUCT() does not make a copy of the struct and does not require any logging macros. Returned structures are logged as \"struct\" but this could be made more accurate using __typeof in the future.\n\nStructures as parameters are not addressed here and work as before, i.e. they require logging macros."
},
{
"commit": "b21ed979821b247ed50ccd48c515ed3d742dc9da",
"date": "2021-01-12 18:47:19 -0500",
"subject": "Check for missing files in queueNeed().",
"body": "Missing files would indicate that another process is running on the same spool path, which would be a very bad thing.\n\nThis check doesn't cost any additional I/O so it seems like a good idea."
},
{
"commit": "aae6f06bcf69794e843486bb88c490f180d5f2e5",
"date": "2021-01-12 18:20:28 -0500",
"subject": "Add tests for the archive-get command.",
"body": "Provide additional coverage for less common use cases."
},
{
"commit": "aeee83044d97555723fdc6039be1c4d51e329d28",
"date": "2021-01-12 12:38:32 -0500",
"subject": "Fix resume after partial delete of backup by prior resume.",
"body": "If files other than backup.manifest.copy were left in a backup path by a prior resume then the next resume would skip the backup rather than removing it. Since the backup path still existed, it would be found during backup label generation and cause an error if it appeared to be later than the new backup label. This occurred if the skipped backup was full.\r\n\r\nThe error was only likely on object stores such as S3 because of the order of file deletion. Posix file systems delete from the bottom up because directories containing files cannot be deleted. Object stores do not have directories so files are deleted in whatever order they are provided by the list command. However, the issue can be reproduced on a Posix file system by manually deleting backup.manifest.copy from a resumable backup path.\r\n\r\nFix the issue by removing the resumable backup if it has no manifest files. Also add a new warning message for this condition.\r\n\r\nNote that this issue could be resolved by running expire or a new full backup."
},
{
"commit": "96fd678662775032254906ed7365fad5c223ab74",
"date": "2021-01-11 15:15:25 -0500",
"subject": "Add job-retry and job-retry-interval options.",
"body": "These options specify the number of local worker job retries and the retry interval after one immediate retry.\r\n\r\nThere is some value in allowing retries to be specified by the user but for the most part these options are for suppressing retries during testing, which can save a lot of time. The bug introduced in d1d25c7 and fixed in 8b86d5e also suggests it is better not to use retries in tests.\r\n\r\nRemove the default delayed retries for archive-get/archive-push, leaving only the immediate retry. These commands are retried by PostgreSQL so it doesn't make sense to do too many retries internally.\r\n\r\nThese options are currently internal."
},
{
"commit": "8b86d5ea7a7dcdfaa087f1de05d4b1332235124d",
"date": "2021-01-11 11:34:03 -0500",
"subject": "Restore storageRepo() call in archiveGetProtocol().",
"body": "This call was removed by d1d25c71, which worked for archivePushProtocol() and verifyProtocol() since the encryption options are passed from the main process.\n\narchiveGetProtocol() still retrieves these options in the local process so the repo storage must be loaded first."
},
{
"commit": "f35d69c1c73719caaa5b6222ea6a836b84f933d5",
"date": "2021-01-08 16:48:32 -0500",
"subject": "Refactor common/archiveGet unit test.",
"body": "The test was pretty old and written in stages during the migration, so storage use was a bit archaic and the organization was poor.\n\nUpdate using the new storage macros and reorganize the tests to provide better coverage."
},
{
"commit": "8567b7f733ce821dad8955a8086209e9b592ebf2",
"date": "2021-01-08 16:29:56 -0500",
"subject": "Make archive-get locality error generate a global.error file.",
"body": "Moving this error into the try block ensures that a global.error file is generated, which will be seen by archive-get."
},
{
"commit": "7d3d6ecbe1e04d577687e8d4da7465c40f211344",
"date": "2021-01-08 16:14:26 -0500",
"subject": "Add storage test macros for common operations.",
"body": "The macros should make it much easier to write complex tests, especially when compression and encryption are involved.\n\nUpdate the command/archiveGet test to show how the new macros are used."
},
{
"commit": "97c260bb56b14842e5fa272b6f5ef54cbc880dcb",
"date": "2021-01-08 12:49:33 -0500",
"subject": "Add TEST_RESULT_STRLST_*() unit test macros.",
"body": "This avoids the need for strLstJoin() when testing lists.\n\nLists are \\n delimited (rather than command or pipe) so that non-trivial lists can be more easily diff'd."
},
{
"commit": "1ef36b403235320269bc4a4f232ff0157447f351",
"date": "2021-01-08 10:54:17 -0500",
"subject": "Add clarifications to unit test string diff messages."
},
{
"commit": "17e29eb1bdeb0fd70516eb1f835e3b87062923ca",
"date": "2021-01-08 10:45:26 -0500",
"subject": "Improve formatting of unit test titles.",
"body": "Add separation and some visual cues to help identify the start of a test.\n\nAlso add a counter which can be used to search for a specific test, which is useful if there is a lot of debug output to search through."
},
{
"commit": "dc0284412bf17cfc65218702f081dfca6da0b9a6",
"date": "2021-01-08 10:35:26 -0500",
"subject": "Add test paths for pg, repo, and spool.",
"body": "These may be used as standard locations for these paths in tests."
},
{
"commit": "6bdbcdc7fe9edf51979ec082cf6616e978dc2b6e",
"date": "2021-01-08 10:32:57 -0500",
"subject": "Create TEST_PATH define in test.c.",
"body": "This allows paths to be constructed without using sprintf(), which makes the tests simpler and faster."
},
{
"commit": "ca9c1707f020ee52348d488352e2a27fc16e14ec",
"date": "2021-01-06 11:36:42 -0500",
"subject": "Remove forks from command/archive-get test.",
"body": "These were required to deal with the legacy Perl code being unable to load new options between tests.\n\nThe C code does not have this issue so remove the forks and update process ids in the log tests."
},
{
"commit": "6e7a3eb38391b17fd82fccb4def1fae72532de4f",
"date": "2021-01-05 18:11:28 -0500",
"subject": "Remove archive-timeout from test in mock/archive.",
"body": "No timeout is expected here but the small timeout prevents errors from being thrown.\n\nThis is not a bug since the error would be thrown on the next archive-get call but it does make the tests harder to debug when there is an error.\n\nIt is not clear why there was a timeout here at all. It is likely cruft from a prior test or a copy/paste error."
},
{
"commit": "656e7112965ddb2fb31234f3bf7cc9d979f6d4af",
"date": "2021-01-05 15:14:16 -0500",
"subject": "Remove duplicate tests from command/infoTest.",
"body": "Tests that are duplicated are being removed from the info command unit tests. Specifically tests where the only thing different was whether a lock was held or not which affects only the status display. Removing these tests will reduce churn in the upcoming multi-repo support."
},
{
"commit": "a7491182dccade65fa84fc40524cac878b32caa3",
"date": "2021-01-04 09:18:17 -0500",
"subject": "Set build-max to 2 for Github actions.",
"body": "Github runners only provide 2 virtual CPUs so the default build-max of 4 is not ideal."
},
{
"commit": "9345fe4cb2e85d2a1273bfb072ccf7a427399350",
"date": "2021-01-03 13:56:37 -0500",
"subject": "Update LICENSE.txt and PostgreSQL copyright for 2020."
},
{
"commit": "af17bc4b6d249d29617085aae696d630fcffac98",
"date": "2020-12-31 15:34:07 -0500",
"subject": "Update test to work with different collations.",
"body": "The data returned by the protocol has not been sorted yet so it is vulnerable to differences in collation.\n\nMultiple records are not needed for this test so limit it to one path to solve this issue."
},
{
"commit": "0e1612cda16ddad3fa537351b8ef23a4912367d0",
"date": "2020-12-31 12:29:11 -0500",
"subject": "Remove explicit command lists where they equal the default.",
"body": "This reduces noise in the file and new commands will automatically get these options."
},
{
"commit": "108038292c1aa96a261c152d8b7995a20ae01f51",
"date": "2020-12-31 12:13:20 -0500",
"subject": "Audit options valid for expire command."
},
{
"commit": "0acfcb669e7458ccc518d9fc1c704772be914c76",
"date": "2020-12-31 11:10:48 -0500",
"subject": "Audit options valid for start/stop commands."
},
{
"commit": "82a75268c1cc7bef2eedacec1c8464e26da00804",
"date": "2020-12-31 10:22:09 -0500",
"subject": "Remove option exclusions now handled by command role validity.",
"body": "These options were explicitly excluded because it was possible for them to be mangled by SSH if they contained spaces.\n\nThey are now excluded by command role validity rules."
},
{
"commit": "09fdde359c8b70653fcafe9ad39fcb25bdbc672b",
"date": "2020-12-31 10:08:58 -0500",
"subject": "Limit pg option validity and make it command-line only.",
"body": "The pg option only has one current usage, to let the backup local know which pg index it should copy files from.\n\nThere are other possible uses for this option, but they need thought, tests, and documentation."
},
{
"commit": "951cfa9e900a5ff98acc2a9ce8df9d83e0314862",
"date": "2020-12-31 08:12:35 -0500",
"subject": "Remove repo option.",
"body": "This option was added in advance of the multi-repo functionality but it has no purpose and it is not clear what the validity rules should be.\n\nThe option will be added back when multi-repo functionality is committed."
},
{
"commit": "e3762945c2344d6d2f8fa727cbbc40e87300e75c",
"date": "2020-12-30 17:33:33 -0500",
"subject": "Call storageRemoteInfoParse() in prior context to avoid dups.",
"body": "This results in fewer data duplications and makes the code less fragile since new data add in storageRemoteInfoParse() does not need to be added to an additional list for duplication."
},
{
"commit": "cc901632337ed9d50801037e1a31ad66ade6ad21",
"date": "2020-12-30 16:17:56 -0500",
"subject": "Add empty archive array to info command JSON when stanza is missing.",
"body": "There is an inconsistency when the JSON is output for the case when a stanza is requested and it does not exist in the repo. This was the only case where the archive array was not added to the JSON. Adding it will simplify the upcoming multi-repo support code.\r\n\r\nAlso, a redundant test was removed rather than updating it for this case."
},
{
"commit": "9bf7dbf6a2684c529da501eb95a1426ebb5d64ca",
"date": "2020-12-30 16:03:49 -0500",
"subject": "Do not pass pg-local/repo-local to a remote process.",
"body": "This was a hack to prevent the remote from loading host settings, which is now handled by option validity for command roles.\n\nThese options are still useful so don't remove them, but do leave them internal for now."
},
{
"commit": "141466875f42f2dc09567efbcf757ad1000e715c",
"date": "2020-12-30 10:51:26 -0500",
"subject": "Remove redundant command list in repo-s3-key option.",
"body": "Use the repo-type command list as similar repo options do."
},
{
"commit": "abb8ebe58b7a1325dd95d967347d221e2b196ba3",
"date": "2020-12-29 15:49:37 -0500",
"subject": "Limit option validity by command role.",
"body": "Building on 23f5712, limit option validity by role. This is mostly for options that weren't needed for certain roles but were harmless. However, the upcoming multi repository functionality requires the granularity implemented here.\r\n\r\nThe remote role benefits since host options can automatically excluded when building the options. Also, many options that are only required for the default role (e.g. repo-retention-full) no longer need to be passed in tests for other roles."
},
{
"commit": "26e81785d92775c6643e800644c6a73d01e54b53",
"date": "2020-12-28 15:22:21 -0500",
"subject": "Update unit tests for stricter option validity.",
"body": "Some tests used options in contexts that are currently valid but are not correct usage, i.e. usage of internal options for the default role.\n\nUpdate these tests in advance of the option validity becoming stricter."
},
{
"commit": "23f5712d022ab34d370b7832813a597088842ca2",
"date": "2020-12-28 09:43:23 -0500",
"subject": "Allow option validity to be determined by command role.",
"body": "Validity by command was not granular enough so numerous options needed be marked internal so users would not stumble across them. Options were also needlessly being passed to roles that had no use for them.\r\n\r\nIntroduce per-role validity lists that depend on what roles are valid per command. Also add a check to ensure that only valid roles are used with a command.\r\n\r\nThis commit adds the functionality but does not introduce any new behavior, i.e. all options are valid for all roles that the command is valid for. A subsequent commit will introduce the new role restrictions to make the changes easier to audit."
},
{
"commit": "715fa7a2f1f52dd1a82bb9ff3b0261ae046b1240",
"date": "2020-12-28 08:51:22 -0500",
"subject": "Fix indentation error preventing pull requests from being tested."
},
{
"commit": "9e9e7c4a0d59b9dbcdaaefb5b5a2cf51621ef64a",
"date": "2020-12-17 09:32:31 -0500",
"subject": "Move all parse-related rules to parse module.",
"body": "Data required for parsing was spread between the config and defined modules, mostly for historical reasons because the same data was used by Perl.\n\nRequiring all the parse rules to be accessed with function interfaces makes the code more complicated and new rules harder to implement.\n\nInstead, move the data to the parse module so in the most complex cases no interface functions are needed. This reduces the total amount of code and paves the way for more complex parse rules."
},
{
"commit": "f520ecc89a211dbbe22a38c0b887e910bc1f866b",
"date": "2020-12-16 15:59:36 -0500",
"subject": "Move help data from define.auto.c/config.auto.c to a pack.",
"body": "The help data can be represented more compactly in a pack and this separates data needed for help from data needed for parsing, freeing each to have a more appropriate representation."
},
{
"commit": "996de0a3e6901219a84e7c1a20636835daf606a4",
"date": "2020-12-16 11:33:51 -0500",
"subject": "Remove cfgCmdNone from CFG_COMMAND_TOTAL.",
"body": "cfgCmdNone is used to indicate a missing or invalid command so should not be used in the total used for command process."
},
{
"commit": "558ff1e55587645ba033e30f147e56fe444b1276",
"date": "2020-12-16 09:59:48 -0500",
"subject": "Always advance id when pack field is NULL.",
"body": "This was done in the internal versions but not the user-facing function. That meant the field had to be explicitly read after determining it was NULL, which is wasteful.\n\nSince there is only one behavior now, remove pckReadDefaultNull() and move the logic to pckReadNullInternal()."
},
{
"commit": "39963f6aa5f86648da6cc6b36f856585654af28c",
"date": "2020-12-14 14:37:23 -0500",
"subject": "Remove cfgDefOptionIndexTotal().",
"body": "This function was only used in one place, which was better served by cfgOptionGroupIdxTotal()."
},
{
"commit": "7f66ba5762703af2b5ddaa504d092685184ec7c8",
"date": "2020-12-10 17:58:59 -0500",
"subject": "Remove deprecated option from command/archive-push unit test."
},
{
"commit": "7429aca8fa4269e1370cc31283688b97b0848769",
"date": "2020-12-09 17:26:52 -0500",
"subject": "Remove redundant distro specification."
},
{
"commit": "d01669aa58cfabeeff859819334b697984e69988",
"date": "2020-12-09 15:19:01 -0500",
"subject": "Move most tests to Github Actions.",
"body": "Testing on Travis-CI has been getting slower (from ~18 minutes to 3-6 hours) and the travis-ci.org service will be terminated at the end of the year. Moving to travis-ci.com is an option but the quotas are too low for our purposes.\n\nInstead use Github Actions, which does not currently have quotas, and runs our current tests with just a few tweaks.\n\nThis still leaves multi-architecture tests on Travis-CI but we may be able to run those and stay within the new quotas.\n\nAlso fix a minor bug in restoreTest.c exposed by Github Actions using a different name for the user and group."
},
{
"commit": "8361a97482c9b481863cf0d7300936a7d3dbe9df",
"date": "2020-12-09 12:05:14 -0500",
"subject": "Add pack type.",
"body": "The pack type is an architecture-independent format for serializing data compactly, inspired by ProtocolBuffers and Avro.\r\n\r\nAlso add ioReadSmall(), which is optimized for small binary reads, similar to ioReadLineParam()."
},
{
"commit": "87996558d2cc12d3795709cf07e9c36ebb21e127",
"date": "2020-12-09 08:59:51 -0500",
"subject": "Replace double type with time in config module.",
"body": "The C code does not use doubles to represent seconds like the Perl code did so time can be represented as an integer which reduces the number of data types that config has to understand.\r\n\r\nAlso remove Variant doubles since they are no longer used.\r\n\r\nNote that not all double code was removed since we still need to display times to the user in seconds and it is possible for the times to be fractional. In the future this will likely be simplified by storing the original user input and using that value when the time needs to be displayed."
},
{
"commit": "a137c6baaa17341ff4c9c85fe5954bbc02f47540",
"date": "2020-12-07 11:26:34 -0500",
"subject": "Update install-sh, config.guess, and config.sub to latest versions."
},
{
"commit": "ab0500789e762d3a8cedf3c692c2646ea8db9cd6",
"date": "2020-12-07 11:13:45 -0500",
"subject": "Begin v2.32 development."
},
{
"commit": "e116b535e6ad21248c00a6d0d948575ed06c6e38",
"date": "2020-12-07 09:55:00 -0500",
"subject": "v2.31: Minor Bug Fixes and Improvements"
},
{
"commit": "31becf05b7445f201250d5956e3b725dd4b9338e",
"date": "2020-12-04 10:59:57 -0500",
"subject": "Add RHEL/CentOS 8 documentation.",
"body": "Update RHEL/CentOS 7 to cover the versions that were previously covered by RHEL/CentOS 6.\n\nSince RHEL/CentOS 7/8 work the same update the documentation logic and labels to reflect this compatibility."
},
{
"commit": "b0ea3379651f610113cb63f0743b6245dd9d5ffe",
"date": "2020-12-02 22:42:50 -0500",
"subject": "Add pg-database option.",
"body": "In some rare cases there is no postgres database so this option may be used to specify an alternate database."
},
{
"commit": "1913ecee639e0d40e0d7bfedb898f2d881ac49f0",
"date": "2020-12-02 22:42:05 -0500",
"subject": "Fix incorrect usage of TEST_RESULT_DOUBLE().",
"body": "These work fine but it's better to use the correct macro."
},
{
"commit": "d4211d3aaf6137f0a2e635c1ac9b089771356bfd",
"date": "2020-12-02 22:41:14 -0500",
"subject": "Add retries to PostgreSQL sleep when starting a backup.",
"body": "Inaccuracies in sleep time or clock skew might make a single sleep insufficient to reach the next second.\n\nAdd a few retries to make the process more reliable but still avoid an infinite loop if something is seriously wrong."
},
{
"commit": "ec9f23d31f809902156466a0e4c96ef042d31edb",
"date": "2020-12-02 16:23:05 -0500",
"subject": "Remove CentOS 6 from tests and documentation.",
"body": "CentOS6 EOL'd and the mirrors were swiftly deleted, leading to failures in tests and documentation.\n\nRemove CentOS 6 for now to get builds going again with the intention to replace it in the near future with CentOS 8."
},
{
"commit": "ffc50719d90832d1c24ca9b56ac36f76f5bfcaa6",
"date": "2020-12-01 15:15:35 -0500",
"subject": "Improve error message when PQgetCancel() returns NULL.",
"body": "There is not a lot to be done in this case since it looks like PostgreSQL disconnected while the query was running, but at least improve the error message and remove the assert, which indicates a coding error."
},
{
"commit": "d1d25c710d736a0946d53164b814f1c914603bdd",
"date": "2020-11-30 18:03:24 -0500",
"subject": "Remove extraneous storageRepo() calls.",
"body": "These calls are not required since cipher info is passed explicitly. They are probably a copy-pasto from some past time when one of these functions required it."
},
{
"commit": "5488de8b6a77e8fcd635af707cbd604f985d1b9a",
"date": "2020-11-25 12:14:03 -0500",
"subject": "Report page checksum errors in info command text output.",
"body": "This feature currently only works for text output. JSON output is planned for the future."
},
{
"commit": "3ed7b93b90eb61d40221701e0aef1318c1ea2b2b",
"date": "2020-11-24 09:40:44 -0500",
"subject": "Conform retry in lockAcquireFile() to the common retry pattern."
},
{
"commit": "117f03eba15378cfa15097828041331b67d16f12",
"date": "2020-11-23 15:55:46 -0500",
"subject": "Prepare configuration module for multi-repository support.",
"body": "Refactor the code to allow a dynamic number of indexes for indexed options, e.g. pg-path. Our reliance on getopt_long() still limits the number of indexes we can have per group, but once this limitation is removed the rest of the code should be happy with dynamic numbers of indexes (with a reasonable maximum).\n\nAdd an option to set a default in each group. This was previously handled by the host-id option but now there is a specific option for each group, pg and repo. These remain internal until they can be fully tested with multi-repo support. They are fully tested for internal usage.\n\nRemove the ConfigDefineOption enum and use the ConfigOption enum instead. They are now equal since the indexed options (e.g. cfgOptRepoHost2) have been removed from ConfigOption.\n\nRemove the config/config test module and add required tests to the config/parse test module. Parsing is now the only way to load a config so this removes some redundancy.\n\nSplit new internal config structures and functions into a new header file, config.intern.h. More functions will need to be moved over from config.h but that will need to be done in a future commit to reduce churn.\n\nAdd repoIdx to repoIsLocal() and storageRepo*(). Multi-repository support requires that repo locality and storage be accessible by index. This allows, for example, multiple repos to be iterated in a loop. This could be done in a separate commit but doesn't seem worth it since the code is related.\n\nRemove the type parameter from storageRepoGet(). This parameter existed solely to provide coverage for the case where the storage type was invalid. A better pattern is to check that the type is S3 once all other types have been ruled out."
},
{
"commit": "7fda83b31e73467c881dca43cc6165e4a3ae3963",
"date": "2020-11-23 12:41:54 -0500",
"subject": "Allow multiple remote locks from the same main process.",
"body": "Improve locking on remote processes by introducing an exec-id that is unique to the main process and passed to all remote processes. This allows the remote processes to determine if a lock is held by a remote from the same main process. If so, the lock is allowed.\r\n\r\nThe exec-id is also useful for associating remote logs with main logs for debugging purposes."
},
{
"commit": "77198dce97dd70fdf59ade2886b41e9029553217",
"date": "2020-11-22 16:26:30 -0500",
"subject": "Update Vagrant box version."
},
{
"commit": "191b8ec18ba6a2fceb55fb280c64f1a49767b646",
"date": "2020-11-19 16:57:19 -0500",
"subject": "Create standby.signal only on PostgreSQL 12 when restore type is standby.",
"body": "When restore type standby is provided, the recovery.signal isn't needed and may lead to some confusion (see #1236).\r\n\r\nLately, when using pg_basebackup --write-recovery-conf, only the standby.signal file is created. This change would then align with that behaviour."
},
{
"commit": "9aacd3c54a82ca27d6950300a34fbad8bd1ec45c",
"date": "2020-11-18 18:19:49 -0500",
"subject": "Move retrieval of archiveResult before while loop in verifyArchive().",
"body": "The result structure for the archive id being processed only needs to be retrieved once so moving it outside of the WAL path list processing loop is more efficient."
},
{
"commit": "62d9f2396127c305be2a2463cfe98ad872709403",
"date": "2020-11-17 10:48:40 -0500",
"subject": "Rename hrnCfgEnvId*() to hrnCfgEnvKey*().",
"body": "The hrnCfg*() functions were renamed before commit but these got missed."
},
{
"commit": "dd708e6d27ac7b5917704fd07b40bb6fe2a2eee7",
"date": "2020-11-09 16:37:05 -0500",
"subject": "Fix override of user option reset.",
"body": "If a user reset an option such as pg-default on the command-line then an override in the code would not take effect.\n\nIgnore a reset when the code explicitly sets an option to prevent this."
},
{
"commit": "6acd76b60ce9bacb7180da1661745f3eaa7d6674",
"date": "2020-11-09 16:28:53 -0500",
"subject": "Fix test title in storage/remote test."
},
{
"commit": "63c12d25418d6252da643d50020f17cc496f0a11",
"date": "2020-11-09 16:26:43 -0500",
"subject": "Fix spacing and typos in backup/manifest modules."
},
{
"commit": "3f7a66fffc1062027166056b9cad2459d160c613",
"date": "2020-11-09 16:19:37 -0500",
"subject": "Remove obsolete call to storageRepo() in archivePushProtocol().",
"body": "This call to storageRepo() was used to fetch cipher options from a remote to determine if a repo cipher was enabled.\n\nNow the main process does this work and passes the cipher options directly to the local so there is no need to pre-load the repo storage here."
},
{
"commit": "cbb9b8fd2b8579ea1e9f129c2b79e4a7151a2757",
"date": "2020-11-09 16:16:41 -0500",
"subject": "Check archive push queue limit before checking repository.",
"body": "If the push queue limit has been exceeded then nothing will be pushed to the repo so there is no point in checking it. Worse, a failure in the check would cause drop not to run and potentially fill up the disk, exactly the case this feature was designed to prevent.\n\nThe async version already checks the push queue limit before checking the repository so now both versions have the same behavior."
},
{
"commit": "8cf47f82e49cb3151cd48c8430a1a38c7b3ccaa0",
"date": "2020-11-09 16:10:59 -0500",
"subject": "Log warnings in archive-push async log.",
"body": "These warnings were only being reported to PostgreSQL on the console. Now they are also recorded in the async log increasing the chance that they will be seen.\n\nThis also improves coverage by requiring a warning during async processing to have a test case, which has been added."
},
{
"commit": "d5d1ec6f6f4820808f30f4e9015bf22f2534de4e",
"date": "2020-11-04 11:09:05 -0500",
"subject": "Use a constant to check restore target action.",
"body": "Checking the default here was fragile. If the default were to change the code would break.\n\nThis also removes the only dependency on cfgOptionDefault() outside of the help command."
},
{
"commit": "021a34a55bef5370441c7a416514efebb7086177",
"date": "2020-10-29 17:16:15 -0400",
"subject": "Fix typos."
},
{
"commit": "f87a117b71ce0d99137b6df5405fa1fd592af4b4",
"date": "2020-10-28 08:59:43 -0400",
"subject": "Spell out three exclamation points in git-history.cache.",
"body": "Three exclamation points are used by convention as a marker for code that needs attention before it can be committed to integration.\n\nIf the markers are in this file they come up in every search."
},
{
"commit": "d25e965c475e0a36aad8e4a2df7e0d840185cded",
"date": "2020-10-27 13:29:58 -0400",
"subject": "Use harnessCfgLoad() in config/load unit tests.",
"body": "The tests were originally written by loading values directly into the configuration before the parser was available.\n\nUpdate to use harnessCfgLoad() to simplify the tests and make them compatible with upcoming config changes."
},
{
"commit": "d91e6014bd1b6ff6f68abee7944250ed16ee254c",
"date": "2020-10-27 13:18:25 -0400",
"subject": "Fix comment."
},
{
"commit": "abe9d90c891fe61b0b0e7d1729dc89ca10b3b2e8",
"date": "2020-10-27 08:34:18 -0400",
"subject": "Improve info command output when a stanza is specified but missing.",
"body": "Return a path missing error when a stanza is specified for the info command but the stanza does not exist in the repository.\r\n\r\nPreviously [] was returned, which is still the case if no stanza is specified and the repository does not exist."
},
{
"commit": "770b65de804fc56a3e6a00d3916958c99774880d",
"date": "2020-10-26 12:18:45 -0400",
"subject": "Improve performance of large file lists in backup/restore commands.",
"body": "lstRemoveIdx(list, 0) resulted in the entire list being moved down to the first position which could take a long time for big lists. This is a common pattern in backup/restore when processing file queues.\r\n\r\nInstead simply move the list pointer up when first item is removed. Then on insert check if there is space at the beginning when there is no longer space at the end and do the move then. This way if a list is built and then drained without any new inserts then no move is required."
},
{
"commit": "d452e9cc38001e2258cc05137508ab692d226df2",
"date": "2020-10-26 10:25:16 -0400",
"subject": "Use zero-based indexes when referring to option indexes.",
"body": "There were a number of places in the code where \"hostId\" was used, but hostId is just the option group index + 1 so this led to a lot of +1 and -1 to convert the id to an index and vice versa.\r\n\r\nInstead just use the zero based index wherever possible. This is pretty much everywhere except when the host-id option is read or set, or where a message is being formatted for the user.\r\n\r\nAlso fix a bug in protocolRemoteParam() where remotes spawned from the main process could get process ids that were not 0. Only the locals should spawn remotes with process id > 0. This seems to have been harmless since the process id is only a label, but it could be confusing when debugging."
},
{
"commit": "ae35c4f0292e410c06e71eed6c5d8565017351d1",
"date": "2020-10-26 07:41:08 -0400",
"subject": "Remove unused FUNCTION_LOG_VERIFY_WAL_RANGE* defines.",
"body": "The defines for FUNCTION_LOG_VERIFY_WAL_RANGE* are not used in the current verify.c and are currently not planned in the continuing development of the verify command, so they are dead code and are therefore being removed."
},
{
"commit": "ea49151746a2d349ccb3c25e8e41df1e88d59a06",
"date": "2020-10-24 13:18:02 -0400",
"subject": "Replace misuse of bufSize() with bufUsed().",
"body": "bufSize() should only be used whem checking the total size of the buffer, not how much of it is currently used.\n\nIn these cases bufUsed() and bufSize() are returning the same value but benign-looking code changes could break this assumption."
},
{
"commit": "80a770ed2ea8d060d8ea77dabb239cf7e861774d",
"date": "2020-10-24 11:16:06 -0400",
"subject": "Clarify intended usage of harnessCfgLoadRaw()."
},
{
"commit": "76cfd8ca703f4d6a71c6fe10b683209a2040368c",
"date": "2020-10-24 11:07:07 -0400",
"subject": "Allow [, #, and space as the first character in database names.",
"body": "iniLoad() was trimming lines which meant that a leading space would not pass checksum validation when a manifest was reloaded. Remove the trims since files we write should never contain extraneous spaces. This further diverges the format for the functions that read conf files (e.g. pgbackrest.conf) and those that read info (e.g. manifest) files.\r\n\r\nWhile we are at it also allow [ and # as initial characters. # was reserved for comments but we never put comments into info files. [ denotes a section but we can get around this by never allowing arrays as values in info files, so if a line ends in ] it must be a section. This is currently the case but enforce it by adding an assert to info/info.c."
},
{
"commit": "c573ef281489e274c9b59185275f9c595885f359",
"date": "2020-10-20 16:14:03 -0400",
"subject": "Add indexed option > 1 to config/exec unit test."
},
{
"commit": "176cf0bf609ac2fc49c411537d4aa518dccd33d9",
"date": "2020-10-20 14:54:28 -0400",
"subject": "Use harnessCfgLoadRaw() in command/command and common/exit unit tests.",
"body": "The tests were originally written by loading values directly into the configuration before the parser was available.\n\nUpdate to use harnessCfgLoadRaw() to simplify the tests and make them compatible with upcoming config changes.\n\nNote that some unreachable conditions were removed since they could not be reached via a parsed config, only by munging values directly into the config. cfgOptionTest(optionId) was removed because a non-default value must always be set. cfgOptionValid(cfgOptLogTimestamp) was removed because it is true for all commands except for cfgCmdNone, which is checked with an assert."
},
{
"commit": "156b7d48cce789cc6e435219062ceeadbbb7b494",
"date": "2020-10-20 12:39:23 -0400",
"subject": "Get target-action default from cfgOptionDefault() in restore command.",
"body": "cfgDefOptionDefault() worked but the default is available without having to peek into config definitions."
},
{
"commit": "41789d70d16a3921c68132187f08a1b8fa058cf1",
"date": "2020-10-20 11:24:26 -0400",
"subject": "Remove cfgOptionId() and replace it with cfgParseOption().",
"body": "cfgOptionId() did not recognize deprecated options which made the help command throw errors when they were specified on the command line. cfgParseOption() will correctly identify deprecated options.\n\ncfgParseOption() can also be used in cfgParse() to reduce code duplication when parsing info out of the option value returned by optionFind().\n\nFinally, code the option key index separately in parse.auto.c. For now they are simply added back together but future code will need them separated."
},
{
"commit": "6414ae9707ab637f298df1ce55fe4bcf46fbe910",
"date": "2020-10-19 18:17:47 -0400",
"subject": "Remove ConfigDefineCommand enum.",
"body": "This has always been equivalent to the ConfigCommand enum so it just adds complexity.\n\nIt was created for symmetry with ConfigDefineOption, which will also be removed soon."
},
{
"commit": "ba29e24684414c610e58374c000cb66e28315975",
"date": "2020-10-19 17:17:47 -0400",
"subject": "Fix repo/pg-local option being overwritten.",
"body": "This option would get overwritten when the option values were moved to index 1.\n\nSet the repo/pg-local option after options are moved to fix this."
},
{
"commit": "2d38d2fc824db1bb3f56899addd51ab018977d12",
"date": "2020-10-19 17:06:52 -0400",
"subject": "Reset additional options in real/all integration test.",
"body": "Currently indexes above 1 do not have dependencies checked, so this doesn't error.\n\nIn a future commit we will enable those checks and this will error if it is not fixed."
},
{
"commit": "996387ea9312459db664e59d68b94455c9c56acc",
"date": "2020-10-19 16:27:52 -0400",
"subject": "Use harnessCfgLoadRaw() in command/help unit test.",
"body": "This correctly set defaults from cfgLoadUpdateOption(), e.g. repo-host-cmd."
},
{
"commit": "303b9b17e700dca00aa12a3afe23b1f7c9741752",
"date": "2020-10-19 14:19:28 -0400",
"subject": "Remove extraneous calls to cfgOptionValid() in unit tests."
},
{
"commit": "7d069a2b9178498293372913b0fa287005aa93b4",
"date": "2020-10-19 14:03:48 -0400",
"subject": "Remove indexed option constants.",
"body": "These constants don't scale well as the index total is increased for an option.\n\nThe core code rarely uses these options and they are easily replaced with cfgOptionName().\n\nThe tests had started to make use of the constants, so provide functions that build the option name from the optionId and, optionally, the optionKey."
},
{
"commit": "86275c4f85668d4576c16c85c629a7f3515ade59",
"date": "2020-10-16 07:42:03 -0400",
"subject": "Expire history files.",
"body": "WAL timeline history files were not being expired because they were small and generally not very plentiful.\r\n\r\nHowever, in some cases large numbers of history files may be generated so it makes sense to remove useless history files to keep things tidy.\r\n\r\nThe history file for the oldest retained timeline is kept for debugging purposes even though it is not used for recovery."
},
{
"commit": "4b8dfd34c0a9ced0977c43c2b4159eb700eadf28",
"date": "2020-10-08 17:09:21 -0400",
"subject": "Assert when buffer used is greater than size limit.",
"body": "099281c5 reduced used but this could lead to surprising behavior so assert instead.\n\nCall bufUsedSet() before bufLimitSet() to avoid the assertion."
},
{
"commit": "401e4f1df41a40860c784f1908994c6ee51f6a51",
"date": "2020-10-08 16:09:38 -0400",
"subject": "Optimize small reads in IoRead.",
"body": "Instead of using memmove() to manage the internal output buffer for every small read, track the current buffer position and only move data when the small read cannot be satisfied and more data is needed."
},
{
"commit": "e0f09687e49805a4349933f5e244a2e88b27220b",
"date": "2020-10-08 10:52:19 -0400",
"subject": "Add option groups.",
"body": "Group related options together so operations (e.g. valid, test, index total) can be performed on all options in the group.\r\n\r\nPreviously, options at the top of the hierarchy of the related options were used to do these tests. This was prone to error as option relationships changed and it was not always clear which option (or options) should be used."
},
{
"commit": "dc8a9dab1b4e9b00a0e3b1394f519464c702cd60",
"date": "2020-10-08 08:37:53 -0400",
"subject": "Add missing assertion in lstSort()."
},
{
"commit": "099281c51070fce5c801f90388b8f4316cea7f64",
"date": "2020-10-07 18:02:05 -0400",
"subject": "Reduce buffer used when size limit set.",
"body": "If the size is reduced then the amount used should be reduced as well.\n\nThis is a bug but does not affect current use cases."
},
{
"commit": "39aca3269c440e635ae6ff04235628a9f9d30a79",
"date": "2020-10-07 16:34:13 -0400",
"subject": "Add bufSizeAlloc()."
},
{
"commit": "c8a94d9eb6bb3972071eb3a4eb8e54ece1a5b56e",
"date": "2020-10-07 15:17:16 -0400",
"subject": "Add missing assertion in lstFind()."
},
{
"commit": "98f6a1cffdd6eb2667a3d042aa5ec3c192129700",
"date": "2020-10-07 12:15:50 -0400",
"subject": "Remove unused cfgDefOptionPrefix() function and data.",
"body": "This function was made obsolete when Perl was removed in f0ef73db."
},
{
"commit": "434282d343c131387ffc080ec5db9aa02ba3c413",
"date": "2020-10-07 12:03:23 -0400",
"subject": "Declare cfgDefOptionAllowListValue/Total() static.",
"body": "These have not been used externally since Perl was removed in f0ef73db."
},
{
"commit": "9377d050724d334a18706b49090575f2160433f1",
"date": "2020-10-06 17:15:48 -0400",
"subject": "Add repo-azure-endpoint option.",
"body": "This option allows alternate endpoints (e.g. Azure Government) to be configured."
},
{
"commit": "3ce6b3e5058a7b1893aeb0c587fe8938956bbef5",
"date": "2020-10-05 13:12:48 -0400",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "3c8774fbab80a4300fa1d6935bc87036e41057dc",
"date": "2020-10-05 12:02:31 -0400",
"subject": "Begin v2.31 development."
},
{
"commit": "9229d6c866ee6296180bfefdbce42660b9e59b98",
"date": "2020-10-05 11:51:45 -0400",
"subject": "v2.30: PostgreSQL 13 Support"
},
{
"commit": "74151d57ba03a4e9386f8e988d7f832ccfbe1e25",
"date": "2020-10-05 08:42:18 -0400",
"subject": "Add apt-get update to contributing guide.",
"body": "This allows apt-get to work correctly even if the base container is a bit out of date."
},
{
"commit": "293add28fdd306b863b077d27b0f3438b6594110",
"date": "2020-10-05 08:37:48 -0400",
"subject": "Add text rendering for page links missed in 597739fa.",
"body": "Since links are not possible in the command line help just display the name of the linked section.\n\nAlso, during reference text rendering there is no out key so make sure it is defined before trying to use it."
},
{
"commit": "597739fafecf349af470134200aafc65a53eabf2",
"date": "2020-09-25 11:26:27 -0400",
"subject": "Move info command text to the reference and link to user guide.",
"body": "This means the same text will appear in both places, which should make it easier to find.\r\n\r\nAlso update the link code to allow both page and section to be specified rather than only one or the other."
},
{
"commit": "31962377d9d53aed4b8b01accdba7801fa5ce435",
"date": "2020-09-25 10:30:29 -0400",
"subject": "Add hint and documentation for protocol version mismatches.",
"body": "Update the documentation to explicitly state that versions must match across hosts when running remotely.\r\n\r\nAdd a hint to the protocol version mismatch error to help the user identify the problem."
},
{
"commit": "b096a25b49875b1303c066b6f659dd5afffebc56",
"date": "2020-09-24 11:19:51 -0400",
"subject": "Update test containers for PostgreSQL 13.",
"body": "Add older PostgreSQL versions to the u18 container that were not available before.\n\nThis also updates all minor versions for prior versions of PostgreSQL."
},
{
"commit": "ad79932ba5bf3df7e59677c29b32477b7022ea16",
"date": "2020-09-22 11:57:38 -0400",
"subject": "Add internal verify command.",
"body": "Scan the WAL archive for missing or invalid files and build up ranges of WAL that will be used to verify backup integrity. A number of errors and warnings are currently emitted but they should not be considered authoritative (yet).\r\n\r\nThe command is incomplete so is marked internal."
},
{
"commit": "3e8a6febe66ef30dee104a895fd7e3c5f8ad0660",
"date": "2020-09-21 14:37:07 -0400",
"subject": "Update yum repository path for CentOS/RHEL user guide.",
"body": "Update to the current yum.p.o repository so the CentOS/RHEL user guide will build on PostgreSQL 13."
},
{
"commit": "927d9adbee780a51639955edb74ce7a4850db100",
"date": "2020-09-18 16:55:26 -0400",
"subject": "Improve PostgreSQL version identification.",
"body": "Previously, catalog versions were fixed for all versions which made maintaining the catalog versions during PostgreSQL beta and release candidate cycles very painful. A version of pgBackRest which was functionally compatible was rendered useless by a catalog version bump in PostgreSQL.\r\n\r\nInstead use only the control version to identify a PostgreSQL version when possible. Some older versions require a catalog version to positively identify a PostgreSQL version, so include them when required.\r\n\r\nSince the catalog number is required to work with tablespaces it will need to be stored. There's already a copy of it in backup.info so use that (even though we have been ignoring it in the C versions)."
},
{
"commit": "94475bfbe6a694b150091d5f7208b0d01ab07a40",
"date": "2020-09-17 15:17:13 -0400",
"subject": "Add missing semicolon in backtrace debug code.",
"body": "Apparently backtrace has not been used for debugging since it was broken in 7fba1f0b.\n\nEven though this is test code it might be good to find a way to test it to prevent regressions."
},
{
"commit": "4cd61152f510140a30525e995b0901590d55012c",
"date": "2020-09-17 12:39:30 -0400",
"subject": "Update PostgreSQL 13 test catalog versions missed in 6bb111c1.",
"body": "These values are not used by the Perl integration tests so maybe it would be better to remove them, but for now just update since they should not be changing again for PG13."
},
{
"commit": "9db314397302bc01d81a24cb0edaceefa2b2e9d0",
"date": "2020-09-17 10:35:27 -0400",
"subject": "Error with hints when backup user cannot read pg_settings.",
"body": "This condition used to give a not-very-clear error which we have been intending to improve. But in the meantime the changes in fbff299 resulted in a segfault for this condition instead because the data_directory was assumed to be non-NULL.\r\n\r\nFix this by explicitly throwing an error with hints when any row in pg_settings cannot be selected."
},
{
"commit": "c71609879bb3782dd7da40c14313e75e78262bfc",
"date": "2020-09-16 09:33:37 -0400",
"subject": "Fix incorrect control/catalog versions in command/stanza test.",
"body": "These were not caught because backup info load automatically corrects them."
},
{
"commit": "8dce7bbb608c65a16a4e41ae2cd95c588154e9e0",
"date": "2020-09-14 10:15:40 -0400",
"subject": "Ignore backup_manifest in PG13.",
"body": "This file is created by pg_basebackup so might be in the data directory if the cluster was restored from a pg_basebackup backup. Also exclude backup_manifest.tmp since it is possible to find that in the backup directory."
},
{
"commit": "fc77c511824feb77c0a5f4cd5d95795184b65d2e",
"date": "2020-09-11 10:10:25 -0400",
"subject": "Improve working directory error message.",
"body": "Improve the wording of the error message and add a hint to make it clearer what is wrong and how the user can fix it.\r\n\r\nAlso change the assert to a regular error since this is not an internal error."
},
{
"commit": "dac182c06e84ba94a3e03cc0769367bdc89ba3b7",
"date": "2020-09-11 08:23:26 -0400",
"subject": "Improve alignment in TEST_ERROR output.",
"body": "Align the error types and messages so they are easier to compare."
},
{
"commit": "ecb112f802be958fdccf003be2e9b62aada98bb3",
"date": "2020-09-08 13:02:13 -0400",
"subject": "Add infoArchiveMove() and infoBackupMove()."
},
{
"commit": "5941f5631afc73e504d67827587a90ca91ead399",
"date": "2020-09-08 12:55:56 -0400",
"subject": "Extern infoBackupNewLoad() and infoArchiveNewLoad()."
},
{
"commit": "4239f8a81aa5da52667149a4933956347492b748",
"date": "2020-09-08 12:47:35 -0400",
"subject": "Add manifestFree()."
},
{
"commit": "fead0046918ad50eafa30991c2e8d6aabbf254a0",
"date": "2020-09-08 12:44:08 -0400",
"subject": "Move WAL constants to postgres/interface header."
},
{
"commit": "b8efb13bcb11027fcbb3bd386446280cd8b625ce",
"date": "2020-09-08 12:28:56 -0400",
"subject": "Move archiveIdComparator() to archive/common module."
},
{
"commit": "9fd31913a8cbff1f1371ccabfebb003cb3c47c05",
"date": "2020-09-03 07:49:49 -0400",
"subject": "Add hint about starting the stanza when WAL segment not found.",
"body": "If a stop command has been issued the check command fails due to archiving timing out.\n\nProvide a hint to document this situation and point the user in the proper direction."
},
{
"commit": "76900d676416758e82b12ea3966daadf6e3b3464",
"date": "2020-09-02 14:45:09 -0400",
"subject": "Fix contributor name."
},
{
"commit": "41118e1b6813ea41a13c0441c726f3e7c28051d9",
"date": "2020-09-02 11:03:49 -0400",
"subject": "Allow ProtocolParallel to complete with no jobs.",
"body": "If the callback never returned any jobs then protocolParallelDone() would never be true. The reason is that the done state was being set in protocolParallelResult(), which never gets called if there are no results.\r\n\r\nCalling protocolParallelResult() doesn't make much sense in this case so instead move the done logic to protocolParallelDone().\r\n\r\nFor current usage of ProtocolParallel we ensure there are jobs before processing so this is not a live issue, but the new behavior is required for future development."
},
{
"commit": "ce6c492620d9408a432f5b7c04a437ec812788ac",
"date": "2020-09-01 11:02:44 -0400",
"subject": "Add notes about optional symlinks to repo format 6 design."
},
{
"commit": "bb87d989b840e77d1ceafc8f699972101fb94d96",
"date": "2020-08-31 08:20:40 -0400",
"subject": "Update config.guess and config.sub to latest versions."
},
{
"commit": "05ef03feb5550f7151ee34afe6b0358637f65fc8",
"date": "2020-08-31 07:41:48 -0400",
"subject": "Begin v2.30 development."
},
{
"commit": "1df7d3eee5baa38504478fafa27de2b1b0fce724",
"date": "2020-08-31 07:28:22 -0400",
"subject": "v2.29: Auto S3 Credentials on AWS"
},
{
"commit": "14e1fd10ca74ff9c6cdf32c66d374efb09067919",
"date": "2020-08-27 10:59:04 -0400",
"subject": "Add none to compress-type option reference and fix example."
},
{
"commit": "8c2960fab39e3eda96f791d8a7b1f88f8dedd4f9",
"date": "2020-08-25 15:05:41 -0400",
"subject": "Add archive-mode option to disable archiving on restore.",
"body": "When restoring a cluster that will be promoted but is not intended to be the new primary, it is important to disable archiving to avoid polluting the repository with useless WAL. This option makes disabling archiving a bit easier."
},
{
"commit": "1812725c8e0cdd7335efdd9909c204e11c01c200",
"date": "2020-08-25 12:50:06 -0400",
"subject": "Fix typo."
},
{
"commit": "851f2e814e1d733989c0330e7efef3def2cace80",
"date": "2020-08-25 10:38:49 -0400",
"subject": "Automatically retrieve temporary S3 credentials on AWS instances.",
"body": "Automatically retrieve the role and temporary credentials for S3 when the AWS instance is associated with an IAM role. Credentials are automatically updated when they are <= 5 minutes from expiring.\r\n\r\nBasic configuration is to set repo1-s3-key-type=auto. repo1-s3-role can be used to set a specific role, otherwise it will be retrieved automatically."
},
{
"commit": "1d2b8ae7bb1ff0621229514acff587793276a123",
"date": "2020-08-24 14:51:08 -0400",
"subject": "Improve detailed error output.",
"body": "Add more info (command, version, options) to asserts, and errors when debug logging is enabled. This won't cover all cases but might mean we get more info in some circumstances."
},
{
"commit": "7fba1f0bbef7072964eb4ad00275fbff00f94d50",
"date": "2020-08-21 16:12:44 -0400",
"subject": "Consolidate variables into structs in common/stackTrace module.",
"body": "This makes it easier to determine which variables are used in which parts of the module and reduces the chance of name conflicts while unit testing."
},
{
"commit": "2a73bd6cbf89135d652d5cff1c63095858068a6d",
"date": "2020-08-21 11:45:54 -0400",
"subject": "Move backTraceState variable inside #ifdef WITH_BACKTRACE.",
"body": "This variable is only used when WITH_BACKTRACE is defined so there's no need to declare it otherwise."
},
{
"commit": "0e8e5881d8859945760aa873b53a4b39ac26dfc3",
"date": "2020-08-21 11:43:26 -0400",
"subject": "Remove invalid call to stackTraceTestFileLineSet().",
"body": "When testing the common/stack-trace module it is important not to call this test function since the trace stack is empty and it will cause a buffer under run.\n\nInstead use a macro that is only defined under the correct circumstances and add an assert() to catch future regressions."
},
{
"commit": "25ee913932a9de1ca2a57d0b7c37309504af8a1f",
"date": "2020-08-20 15:53:01 -0400",
"subject": "Rearrange members in StackTraceData struct to save memory.",
"body": "This arrangement is more efficient on 64-bit systems due to alignment. There is no difference on 32-bit systems."
},
{
"commit": "859b8a50fdacad0ffa92210e0e8a3c98a2eba1b7",
"date": "2020-08-20 14:16:36 -0400",
"subject": "Remove unused parameter from cmdBegin()."
},
{
"commit": "fccca0d716de2be92ddd5c7d8f532dcad41fd828",
"date": "2020-08-20 14:11:40 -0400",
"subject": "Refactor option logging into a general-purpose function."
},
{
"commit": "959f77cd6a3be9dffa049d9b25901c72a7c947bb",
"date": "2020-08-20 14:04:26 -0400",
"subject": "Add general-purpose statistics collector.",
"body": "Currently each module that needs to collect statistics implements custom code to do so. This is cumbersome.\r\n\r\nCreate a general purpose module for collecting and reporting statistics. Statistics are output in the log at detail level, but there are other uses they could be put to eventually.\r\n\r\nNo new functionality is added. This is just a drop-in replacement for the current statistics, with the advantage of being more flexible.\r\n\r\nThe new stats are slower because they involve a list lookup, but performance testing shows stats can be updated at about 40,000/ms which seems fast enough for our purposes."
},
{
"commit": "53f8e7a9cf842745282cde66b99268b500073776",
"date": "2020-08-20 12:12:21 -0400",
"subject": "Asynchronous list/remove for S3/Azure storage.",
"body": "Improve the performance of list/delete operations by using async requests.\r\n\r\nIt's questionable whether this will have any impact on Azure deletes since they are sent one at a time with little work done in between, but it doesn't hurt to try."
},
{
"commit": "9876d7096d35496226fdbab788af9499f1b085d3",
"date": "2020-08-20 11:24:27 -0400",
"subject": "Disable s390x builds on Travis-CI (again).",
"body": "s390x currently is too unreliable to be part of required CI builds. They can sometimes take hours or days to get queued which makes getting commits through our workflow very time-consuming."
},
{
"commit": "de0f8c2654ce5a924e3b93959a26c39930f02b60",
"date": "2020-08-18 10:01:24 -0400",
"subject": "Add user-agent to HTTP requests."
},
{
"commit": "4391497a05b0d645c5ed472f0b139ce545ece5e9",
"date": "2020-08-18 08:17:13 -0400",
"subject": "Enable s390x builds on Travis-CI.",
"body": "These were disabled in 6fc25c7a because s390x builds were not being queued. It looks like they are working again."
},
{
"commit": "d935af5e598e27f0bff58f34f60a81d432d0491e",
"date": "2020-08-18 07:26:02 -0400",
"subject": "Update *((Type *)lstGet()) pattern to *(Type *)lstGet().",
"body": "This pattern has extra parens and was only used in a few places so replace it with the general *(Type *)lstGet() pattern."
},
{
"commit": "fbee6ec170a5f4629fa0d40494cc89c40cfa934c",
"date": "2020-08-14 13:11:33 -0400",
"subject": "Add support for HTTP/1.0.",
"body": "HTTP/1.0 connections are closed by default after a single response. Other than that, treat 1.0 the same as 1.1.\r\n\r\nHTTP/1.0 allows different date formats that we can't parse but for now, at least, we don't need any date headers from 1.0 requests."
},
{
"commit": "6bb111c1700d34bed23ca65518d4b10970aa8554",
"date": "2020-08-14 10:08:25 -0400",
"subject": "PostgreSQL 13 beta3 support."
},
{
"commit": "afcc4d193dea3dfa13b56035e49fbc55a259e936",
"date": "2020-08-11 14:38:38 -0400",
"subject": "Add missing azure type in repo-type option reference."
},
{
"commit": "f40c7b65fa4e9b10eaad687300007a4510766a4b",
"date": "2020-08-11 10:41:06 -0400",
"subject": "Fix typo in repo-cipher-type option reference."
},
{
"commit": "65858d12dd67f3bf6983ad5c8521edb168da004b",
"date": "2020-08-10 16:16:11 -0400",
"subject": "Improve server test harness to support multiple protocols/connections.",
"body": "The prior implementation only supported a single connection on TLS. This is not flexible enough for complex testing scenarios which might require multiple simultaneous connections on different protocols.\n\nAllow multiple simultaneous connections and add plain sockets as a protocol option. Rename the functions used for server scripting to hrnServerScript*() to make it clear they are related. Improve error messages when less input is received by the server than expected.\n\nAlso, do a bit of cleanup and add more comments."
},
{
"commit": "7fdbd94e39ff6a97d00f1aa4a40c02c0b7b2ef4c",
"date": "2020-08-10 16:03:38 -0400",
"subject": "Implement IoClient/IoSession interfaces for SocketClient/SocketSession.",
"body": "Following up on 111d33c, implement the new interfaces for socket client/session. Now HTTP objects can be used over TLS or plain sockets.\r\n\r\nThis required adding ioSessionFd() and ioSessionRole() to provide the functionality of sckSessionFd() and sckSessionType(). sckClientHost() and sckClientPort don't make sense in a generic interface so they were replaced with ioSessionName()."
},
{
"commit": "54c3c39645b84867c3e4bc04c6ad07a2da7f5f2d",
"date": "2020-08-10 11:35:09 -0400",
"subject": "Delay backup remote connection close until after archive check.",
"body": "Only close the remote connection after verifying that the WAL files have been received. This is necessary if the archive_command on the PostgreSQL host is conditional, i.e. archiving only happens while a backup lock is held, to ensure all WAL segments are archived."
},
{
"commit": "63ad4786af704cf20670f67271444c04a3cc0e32",
"date": "2020-08-08 16:06:05 -0400",
"subject": "Remove deleteMax parameter from storageS3New().",
"body": "This was included primarily for testing but now that storageS3New() is not called directly in the tests the value needs to be modified after configuring storage anyway.\n\nSince there is no need to make this parameter user-configurable just remove it."
},
{
"commit": "8b34f854f3b88fb8c361d5b9d559f8b00295b894",
"date": "2020-08-08 15:52:33 -0400",
"subject": "Simplify S3 configuration tests and add security token tests.",
"body": "Rather than calling storageS3New() directly, create the storage by loading a configuration and calling repoStorageGet(). This is a better end-to-end test and cuts down on a lot of redundant tests.\n\nAdd tests that include security tokens in error messages to ensure they are redacted."
},
{
"commit": "38f66d4bd390ee0994559951b09298d700d02533",
"date": "2020-08-08 14:32:21 -0400",
"subject": "Add debug log function for HttpClient."
},
{
"commit": "426e6933daec2ee71619bb14e7082983049de9d5",
"date": "2020-08-08 14:18:03 -0400",
"subject": "Redact x-amz-security-token header in errors.",
"body": "This header should not be displayed to the user in error output, even if it is useless by itself."
},
{
"commit": "4d22d6eeca23aef038b85dc1c4c3a69fb79f1942",
"date": "2020-08-08 11:23:37 -0400",
"subject": "Move file descriptor read/write ready into IoRead/IoWrite.",
"body": "Move sckSessionReadyRead()/Write() into the IoRead/IoWrite interfaces. This is a more logical place for them and the alternative would be to add them to the IoSession interface, which does not seem like a good idea.\r\n\r\nThis is mostly a refactor, but a big change is the select() logic in fdRead.c has been replaced by ioReadReady(). This was duplicated code that was being used by our protocol but not TLS. Since we have not had any problems with requiring poll() in the field this seems like a good time to remove our dependence on select().\r\n\r\nAlso, IoFdWrite now requires a timeout so update where required, mostly in the tests."
},
{
"commit": "111d33c12324a27e68cc3a1349f0566a319eef42",
"date": "2020-08-08 10:39:39 -0400",
"subject": "Add IoClient and IoSession interfaces.",
"body": "These interfaces allow the HttpClient and HttpSession objects to work with protocols other than TLS, .e.g. plain sockets. This is necessary to allow standard HTTP -- right now only HTTPS is allowed, i.e. HTTP over TLS.\r\n\r\nFor now only TlsClient and TlsSession have been converted to the new interfaces. SocketClient and SocketSession will also need to be converted but first sckSessionReadyRead() and sckSessionReadyWrite() need to be moved into the IoRead and IoWrite interfaces, since they are not a good fit for IoSession."
},
{
"commit": "9b7fd1a894ad9fb9cb443458e2296337750b963f",
"date": "2020-08-08 10:02:04 -0400",
"subject": "Improve error message in HARNESS_FORK_END().",
"body": "Also include expected exit status to make debugging easier."
},
{
"commit": "0b349c0f2f54d1e45beaa604dba40c2cf9efc15e",
"date": "2020-08-07 13:44:01 -0400",
"subject": "Clear the callback before calling storageReadPosixFreeResource().",
"body": "If storageReadPosixFreeResource() errors then it will be called again when the object is freed, which is not ideal since it might error in a different way and lose the original error."
},
{
"commit": "cde2c756ea8ae32663e0a817098fc9f5d4f2a1f2",
"date": "2020-08-05 18:25:07 -0400",
"subject": "Rename handle to fd.",
"body": "Pretty much everywhere handle is used what is really meant is file descriptor (fd). This terminology got migrated over from Perl and is just not quite correct, or at least not as correct as fd.\n\nThere were also plenty of places fd was used so now all uses are consistent.\n\nThe Perl code was not updated but might be in a future commit."
},
{
"commit": "a1d7d50223510eda06d68234a03e3c19f972dc47",
"date": "2020-08-05 17:30:38 -0400",
"subject": "Fix macro spacing."
},
{
"commit": "d5edc3fe371e16d5612e841861ae9c10ae69cca7",
"date": "2020-08-05 15:24:13 -0400",
"subject": "Remove unused port struct member.",
"body": "This does not appear to have been used in quite some time and the tests are equally useless because they don't prove the correct port was passed to httpClientNew()."
},
{
"commit": "d74c8f4b5813f3b0ce5df246c36469257a549e4d",
"date": "2020-08-05 14:07:04 -0400",
"subject": "Add memContextFreeing().",
"body": "This can be used to determine if functions are running in a callback from memContextFree(). In this case, data in child mem contexts is not valid."
},
{
"commit": "6fc25c7a69a09f105f9fdd41ddb33c700d983a2e",
"date": "2020-08-05 13:38:44 -0400",
"subject": "Disable s390x builds on Travis-CI.",
"body": "s390x has not been building for about a day which is clogging the integration branch."
},
{
"commit": "847e61ce21710cc0cb7baa9af9b3740d9250b4fa",
"date": "2020-08-04 15:15:24 -0400",
"subject": "Improve TLS error reporting.",
"body": "Before 9f2d647 TLS errors included additional details in at least some cases. After 9f2d647 a connection to an HTTP server threw `TLS error [1]` instead of `unable to negotiate TLS connection: [336031996] unknown protocol`.\r\n\r\nBring back the detailed messages to make debugging TLS errors easier. Since the error routine is now generic the `unable to negotiate TLS connection context` is not available so the error looks like `TLS error [1:336031996] unknown protocol`."
},
{
"commit": "94d3a01f7368a547dfecaafce67995e24738be78",
"date": "2020-08-04 13:20:01 -0400",
"subject": "Proactively close file descriptors after forking async process.",
"body": "PostgreSQL may be using most of the available file descriptors when it executes the the archive-get/archive-push commands (especially archive-get). This can lead to problems depending on how many file descriptors are needed for parallelism in the async process.\r\n\r\nProactively free file descriptors between 3 and 1023 to help ensure there are enough available for reasonable values of process-max, i.e. <= 300."
},
{
"commit": "e81533bbabb2e4f809596c0a88671b2b6616da01",
"date": "2020-08-04 10:16:51 -0400",
"subject": "Improve memory usage of unlogged relation detection in manifest build.",
"body": "This loop was using a lot of memory without freeing it at intervals.\r\n\r\nRewrite to use char arrays when possible to reduce memory that needs to be allocated and freed."
},
{
"commit": "e044eaf55faf102d84389b04ff79a7a00fef0965",
"date": "2020-08-04 09:23:59 -0400",
"subject": "Use forkSafe() in common/exec module.",
"body": "forkSafe() will throw an exception if the fork fails. This is a pretty unlikely scenario but the function is already there so may as well use it."
},
{
"commit": "5a9856c2f9aeb6efccada86c229713665100eba0",
"date": "2020-08-01 09:42:03 -0400",
"subject": "Add functions for Zigzag encoding/decoding.",
"body": "Zigzag encoding places the sign bit in the least significant bit so that -1 is encoded as 1, 1 as 2, etc. This moves as many bits as possible into the low order bits which is good for other types of encoding, e.g. base-128.\n\nSee https://en.wikipedia.org/wiki/Variable-length_quantity#Zigzag_encoding."
},
{
"commit": "f6d22ccb6fab7d7308d26c11c770362e312e600f",
"date": "2020-07-31 17:33:15 -0400",
"subject": "Improve comment locations."
},
{
"commit": "caef2ba482a887113d08fd926a582ff68786a39f",
"date": "2020-07-31 16:35:58 -0400",
"subject": "Accept NULL filenames in hrnStorageInfoListCallback().",
"body": "This allows it to be used with StorageInfo objects returned from storageInfo(), which do not contain a filename."
},
{
"commit": "a8e47c38c6d70c202070fa585d4096592a9961cf",
"date": "2020-07-31 16:27:57 -0400",
"subject": "Add lstGetLast() and lstRemoveLast().",
"body": "When a list is being treated as a stack it is useful to get/remove the last (top) item."
},
{
"commit": "bfb489a82d7451830abec45e3d8a79f4d8580827",
"date": "2020-07-31 16:18:56 -0400",
"subject": "Add file name to make performance/storage test more realistic.",
"body": "Also add timing information."
},
{
"commit": "9f1e7d88da845083a1e45d99c123b1718af9808d",
"date": "2020-07-31 16:13:05 -0400",
"subject": "Remove special protocol encoding for StorageType.",
"body": "It seems like overkill to encode this when other enums (e.g. StorageInfoLevel) are passed as integers.\n\nInstead note that StorageType values should not be changed and remove the special encoding."
},
{
"commit": "afe1568bb1713c3520618bac87ba15e4374274bb",
"date": "2020-07-31 15:55:17 -0400",
"subject": "Fix missing space."
},
{
"commit": "ac72e1f193d8d4a9de7d8877528e78e317c135e2",
"date": "2020-07-30 10:59:50 -0400",
"subject": "Preserve Variant parsed from JSON in iniLoad().",
"body": "The fix for = characters in info files (039d314) added JSON validation but discarded the resulting Variant which means the JSON is being parsed twice. This nearly doubles the time to load a manifest since a lot of complex JSON is involved.\r\n\r\nTime to load a million file manifest:\r\nBefore 039d314: 7.8s\r\n039d314: 15.5s\r\nThis patch: 7.5s\r\n\r\nTo fix this regression return the Variant in the callback so the caller does not have to parse it again. The new code appears slightly more efficient overall, probably because there are fewer operations against Strings."
},
{
"commit": "3e9dce0d7615f0f56f3eff754095c57c6d56fd6b",
"date": "2020-07-30 07:49:06 -0400",
"subject": "Rename strPtr()/strPtrNull() to strZ()/strZNull().",
"body": "We use the Z suffix in many functions to indicate that we are expecting a zero-terminated string so make this function conform to the pattern.\n\nAs a bonus the new name is a bit shorter, which is a good quality in a commonly-used function."
},
{
"commit": "039d314438f7881e7c7062d645f7800ee2dd8872",
"date": "2020-07-28 14:00:23 -0400",
"subject": "Fix issue with = character in file or database names.",
"body": "The manifest uses the = character as the key/value separator so = characters in the key cause parsing errors and lead to an error or segfault.\r\n\r\nSince the value must be valid JSON we can keep checking the value on the right side of the = and stop building the key when the value is valid. It's a bit hackish but it does seem to do the job without breaking the manifest format.\r\n\r\nUnsurprisingly this makes parsing about 50% slower but it's still more than fast enough. Parsing 10 million key/values takes about 6.5s for the old code and 10s for the new code. Since the value is used as JSON downstream we can reclaim most of this time by just passing the JSON value rather than making the callback reparse it. We'll save that for another commit, though."
},
{
"commit": "63a93db6fd97c6e8e22478ee69b05487fa3db69d",
"date": "2020-07-28 12:15:33 -0400",
"subject": "Suppress errors when closing local/remote processes.",
"body": "Since the command has completed it is counterproductive to throw an error but still warn to indicate that something unusual happened.\r\n\r\nAlso fix the related issue that the local processes were not being shut down when they completed, which meant that they might timeout before being closed when pgbackrest terminated."
},
{
"commit": "d9309f13a4c7b962b401832881a593b92f29c438",
"date": "2020-07-28 11:20:07 -0400",
"subject": "Add quarterly press release instructions to doc/RELEASE.md."
},
{
"commit": "a260d4a53b68e40f8ebbdc9129143ac61d0ac88b",
"date": "2020-07-28 08:09:10 -0400",
"subject": "Add zstd to CentOS/RHEL 6 test container.",
"body": "Zstd is now required by the upstream yum package."
},
{
"commit": "aa37a21084f75c7af8d8ca047be0376057a86bb6",
"date": "2020-07-25 13:37:39 -0400",
"subject": "Add strBaseZ().",
"body": "Since the base name is at the end of the filename it is possible to return the char pointer without making a copy, which is preferred in some cases."
},
{
"commit": "8e140ad7e06f7e4abdd2c6fa32018ff463d63a6f",
"date": "2020-07-25 11:39:24 -0400",
"subject": "Build new manifest inside a temporary context.",
"body": "There is a fair amount of temporary data that is created during the build and it should not end up as a permanent part of the manifest."
},
{
"commit": "8e776cc537117292504bc17a1691481fce9bae3d",
"date": "2020-07-25 11:26:14 -0400",
"subject": "Add manifestNewBuild() to performance/type test.",
"body": "Use a test storage driver to allow manifestNewBuild() to be run against a test cluster at any scale without having to write files to disk.\n\nSimplify the test by using the output of manifestNewBuild() to feed manifestSave() and manifestNewLoad().\n\nAlso add manifest size to the output."
},
{
"commit": "f9d923ca3b2c7b2d3eacb3a3cd4fba347cef701e",
"date": "2020-07-25 11:06:25 -0400",
"subject": "Add memContextSize().",
"body": "Calculates the memory used by the context and all child contexts.\n\nThis is primarily useful for debugging but it is not conditional on DEBUG because it is useful for profile/performance tests."
},
{
"commit": "216a61d93626683acdcd0fbf2e145c8751aa7064",
"date": "2020-07-25 08:44:41 -0400",
"subject": "Move dummy storage driver to test harness.",
"body": "The dummy driver is the basis for creating test storage drivers so it makes sense to locate it in the harness where all tests can access it."
},
{
"commit": "cbf5dd19c2e273ce8ec65eab256bde9591fb0760",
"date": "2020-07-24 11:05:09 -0400",
"subject": "Fix non-JSON ini values in tests.",
"body": "A number of tests used invalid JSON values where an error was expected or the value would be ignored.\n\nUpdate these tests to use valid JSON values so all values in the file can be validated even if they are not used."
},
{
"commit": "9d8f6d9fc2a91f20dfc1d3c531459f37fa642a49",
"date": "2020-07-24 10:47:51 -0400",
"subject": "Error in jsonToVar() when input not entirely consumed.",
"body": "Something like 3=\"string\" would return an Int64 variant and ignore the invalid portion after the integer. Other JSON interface functions have this check but it was forgotten here.\n\nThere are no current issues because of this but we want to be able to validate arbitrary JSON strings and this function was not working correctly for that usage."
},
{
"commit": "78ef442a18d62368f4bd05d946660bdcfb7ea40b",
"date": "2020-07-21 16:28:05 -0400",
"subject": "Add storage parameter to pgWalFromFile()."
},
{
"commit": "ed8829386103b27053c4a1d9e29f1d767d0238ce",
"date": "2020-07-21 10:57:47 -0400",
"subject": "Clarify that expire must be run regularly when expire-auto is disabled."
},
{
"commit": "d1ac2f7637866c2044f0d40068dcae2de373aa3b",
"date": "2020-07-21 07:34:02 -0400",
"subject": "Rearrange Travis CI jobs based on current runtimes.",
"body": "In general it is better to have slower jobs run earlier."
},
{
"commit": "90ffde8881f50ba8b91d9d9e881bf59c6488052e",
"date": "2020-07-20 18:09:32 -0400",
"subject": "Remove unused constructor strLstNewParam().",
"body": "This function is not used in the core code so remove it and update the test where it was used.\n\nThere may eventually be a need for a strLstNewP() function but it doesn't seem worth the code churn until there is an actual requirement."
},
{
"commit": "1783e0490abe266233e65ba1904670a7adde48bb",
"date": "2020-07-20 15:22:33 -0400",
"subject": "Remove lstNew() constructor in favor of lstNewP().",
"body": "The old constructor was left around to reduce code churn during the migration but it just makes the code harder to read and search.\n\nRemove the old constructor and rename all remaining instances to lstNewP(), which by default has the same semantics."
},
{
"commit": "a92b1f9776acea52627d59fc734707ec90d78b4e",
"date": "2020-07-20 13:44:11 -0400",
"subject": "Small wording change in website index / Github readme."
},
{
"commit": "738900a3a9e9fb7d63fbc5e4e4642977b8b65e2e",
"date": "2020-07-20 11:08:18 -0400",
"subject": "Update config.guess and config.sub to latest versions.",
"body": "Also update the policy in doc/RELEASE.md to get the latest versions at the beginning of the release cycle. The older policy was created when we were getting new versions right before the release."
},
{
"commit": "3f0b41eb9c1137b0b19138d22d2c26009d477602",
"date": "2020-07-20 09:59:16 -0400",
"subject": "Add support for testing on 64-bit big-endian architectures.",
"body": "In particular add support for s390x but we hope this will work for other 64-bit big-endian architectures.\n\nRun basic unit tests on Travis CI for 390x."
},
{
"commit": "55277357b8457e3a215bc00e8e97de523949eba6",
"date": "2020-07-20 09:47:43 -0400",
"subject": "Reduce reliance on static checksums in unit tests.",
"body": "Testing against static checksums is valuable but it can be become burdensome when supporting multiple architectures.\n\nReduce the number of tests we are doing against static checksums when the architecture can cause the checksum to vary."
},
{
"commit": "f8c1957127c148e36843d77ef0bd26a8c8c78fd1",
"date": "2020-07-20 09:22:53 -0400",
"subject": "Fix ill-advised cast in CipherBlock.",
"body": "Little-endian architectures store the low-order bytes in the lowest memory location so this worked even in the case that size_t and int had different byte representations. Since buffer sizes are constrained there was no chance of the integer becoming negative and causing a problem that way.\n\nOn big-endian architectures this cast caused the low-order bytes to get loaded into the high-order bytes resulting in a huge buffer size that immediately triggered an assertion (and without the assertion would have certainly segfaulted).\n\nInstead use a temporary int variable and cast that to size_t after the function call. This is the correct way to do it regardless of architecture.\n\nThis issue was detected while testing on the s390x architecture."
},
{
"commit": "615c41e52564a8629e57b9892fd3361c92ae22f6",
"date": "2020-07-20 09:08:59 -0400",
"subject": "Begin v2.29 development."
},
{
"commit": "5a4b91f90a81019e456a50c0f7311824f7e61475",
"date": "2020-07-20 08:57:22 -0400",
"subject": "v2.28: Azure Repository Storage"
},
{
"commit": "67d9d3350c8a844bd4cf3c2bc5496739b6c8ed8a",
"date": "2020-07-17 13:27:14 -0400",
"subject": "Update recovery.conf in user guide for PostgreSQL >= 12.",
"body": "The postgresql.auto.conf file was being used instead of recovery.conf, but there were still instances in the text that used recovery.conf. Update to postgresql.auto.conf for PostgreSQL >= 10 and change wording where needed."
},
{
"commit": "24d2c5b27780ad8bc8a5a255eeed422a3a4c7a49",
"date": "2020-07-16 13:57:14 -0400",
"subject": "Remove real/all integration tests now covered by unit tests.",
"body": "Remove all check and stanza-* tests except for the ones that are intended to succeed. The successful tests show that the queries run with expected results against each version of PG which should also validate queries for the failure tests in the unit tests.\r\n\r\nAlso remove the tests for --no-online backups since they don't require a database and are well tested in the unit tests."
},
{
"commit": "332f2fb7f56483e266e7fbc046c96576cb58ac39",
"date": "2020-07-16 12:54:52 -0400",
"subject": "Update PostgreSQL versions used to build user guides.",
"body": "Also add version ranges to indicate that a user guide is accurate for a range of PostgreSQL versions even if it was built for a specific version."
},
{
"commit": "232d14993dac215571fbc152368913c3fb0cfc90",
"date": "2020-07-16 12:45:24 -0400",
"subject": "Fix CentOS path for PostgreSQL >= 10 logs in user guide.",
"body": "Debian worked since logs default to another location, but CentOS/RHEL on PostgreSQL >= 10 requires the new location."
},
{
"commit": "047d85c26395bd8f47845fc3ba9d5de0b8c37cf0",
"date": "2020-07-16 12:24:03 -0400",
"subject": "Automatically determine cipher passphrase in repo-get command.",
"body": "The prior code was only able to use the main passphrase automatically and expected sub passphrases to be specified for each operation. This was fine for testing but hardly sufficient for a user-facing feature.\r\n\r\nUpdate the code to determine which passphrase to use for any file in the repository and error when an invalid file or location is selected.\r\n\r\nThe repo-get command is still internal for now, but with this improvement it should be ready to be made public."
},
{
"commit": "aa4e13b665b71b249bb74e124109d29b438bd654",
"date": "2020-07-16 11:27:14 -0400",
"subject": "Move encrypted files as raw in integration tests.",
"body": "The encryption key should not be changed when moving a file so no need to decrypt/encrypt."
},
{
"commit": "50ff5d905eddd46f8780a0b1bebc04ed40dd3c12",
"date": "2020-07-15 13:54:01 -0400",
"subject": "Update comment and parameter in HttpRequest."
},
{
"commit": "88b0f6245d5f3b49ece2ce33b8d0f9c131b53190",
"date": "2020-07-15 13:19:16 -0400",
"subject": "Run non version specific real/tests on the expect version.",
"body": "There are a few non version specific tests that need to be run in integration because we can't get coverage in the unit tests.\n\nTo save some time we'll only run those tests against the same version we use for expect testing."
},
{
"commit": "574f36c9d2a64d5caac18c2311defcd0c949dcb6",
"date": "2020-07-14 15:14:41 -0400",
"subject": "Rename httpRequest() to httpRequestResponse() and fix comment."
},
{
"commit": "620a8d17cfc0d6d8bdd892171abeea9ab7b9c1b3",
"date": "2020-07-14 15:05:31 -0400",
"subject": "Automatic retry for backup, restore, archive-get, and archive-push.",
"body": "If a local command, e.g. backupFile(), fails it will stop the entire process. Instead, retry local commands to deal with transient errors.\r\n\r\nRemove special logic in the S3 storage driver to retry RequestTimeTooSkewed errors since this is now handled by the general retry mechanism in the places where it is most likely to happen, i.e. file read/write. Also, this error should have been entirely eliminated by the asynchronous TLS implementation."
},
{
"commit": "91c7adc8341db64390156336e487d5fc9b45e851",
"date": "2020-07-14 13:09:48 -0400",
"subject": "Allow redactions for HTTP queries.",
"body": "The Azure storage driver exposes secrets in the query when using SAS authorization. These secrets can show up during logging or when an error occurs.\n\nAllow redaction of queries to prevent secrets from being exposed in logs and errors."
},
{
"commit": "d3dd32a031fa7dab98bbef3eee5c7390a774a9d9",
"date": "2020-07-14 08:12:25 -0400",
"subject": "Add expire-auto option.",
"body": "This allows automatic expiration after a successful backup to be disabled."
},
{
"commit": "083350aeda2f1ccf5b6cb5f0988a84d174208152",
"date": "2020-07-10 08:18:15 -0400",
"subject": "Inline Buffer functions when possible.",
"body": "It makes sense to inline these functions for the same reasons String functions were inlined in fbff2995 and f1edf0ad."
},
{
"commit": "f1edf0ad100db961e4ddaa429c1c4c60c933800c",
"date": "2020-07-10 08:00:18 -0400",
"subject": "Inline strSize().",
"body": "Inlining strPtr() in fbff2995 does not seem to have caused any problems so do the same with strSize()."
},
{
"commit": "d5df3974b51efccc628461c6428414e3a6307e23",
"date": "2020-07-09 17:32:36 -0400",
"subject": "Read segment size from WAL headers.",
"body": "This allows validation of the WAL segment size for PostgreSQL versions <= 10."
},
{
"commit": "2f7823c627c62715a7970233fd6171da94b4b479",
"date": "2020-07-09 14:46:48 -0400",
"subject": "Add shared access signature (SAS) authorization for Azure.",
"body": "A shared access signature (SAS) provides granular, delegated access to resources in a storage account. This is often preferable to using a shared key which provides more access and is a greater security risk if compromised."
},
{
"commit": "511e5db5bf9016ce74722ebc019a33fab72955dc",
"date": "2020-07-09 11:16:45 -0400",
"subject": "Improve buffer size limit implementation.",
"body": "Rework size limits so that this->size is always the current size no matter how much is allocated.\n\nMost importantly, this removes the conditional in bufSize(), which makes it a better candidate for inlining."
},
{
"commit": "15502f5b4b21f4e4b932714c387f7ba029e6fcb0",
"date": "2020-07-09 07:16:15 -0400",
"subject": "Remove bufNewUseC().",
"body": "This was used in the Perl LibC interface to wrap Perl-allocated buffers but is no longer needed since LibC was removed."
},
{
"commit": "18f36752ae4d048006a835192e0b11e4e6c62d46",
"date": "2020-07-08 17:31:48 -0400",
"subject": "Add ASSERT_INLINE() macro.",
"body": "When coverage testing ASSERT() macros in inline functions will be expanded and won't be recognized in our coverage rules that ignore ASSERT(). Since there are then uncovered conditions the coverage is incomplete.\n\nThe prior method required copying several lines of code and an explanatory comment into each inline function. Instead create a special macro for inclusion in inline functions.\n\nAnother possibility would be to automatically identify inline functions and add them to the coverage exclusions but that's an idea for another day."
},
{
"commit": "eaa05fdc49e3ee5166655c28105eea58138d4ffa",
"date": "2020-07-08 15:07:29 -0400",
"subject": "Write HTTP request as a buffer to hide secrets.",
"body": "The prior method of writing headers as strings could expose secrets in trace level logs.\n\nInstead write the entire request as a buffer to prevent secrets from being logged and also reduce the amount of logging."
},
{
"commit": "dd9e14b628db37fe7e87e3ab3a6e70cd105a9637",
"date": "2020-07-08 12:25:39 -0400",
"subject": "Add pgLsnFromWalSegment().",
"body": "Provides the reverse operation for pgLsnToWalSegment()."
},
{
"commit": "a27ff7c33578c5e262a20ad126229cb23aed0a09",
"date": "2020-07-07 08:24:08 -0400",
"subject": "Remove dead test code that should have been removed in 3f4371d7."
},
{
"commit": "57ddd38c51dfa202eeec720a230f08de47685f5e",
"date": "2020-07-06 16:57:12 -0400",
"subject": "S3 storage driver cleanup inspired by Azure review.",
"body": "These improvements were suggested during the review of 3f4371d7 and it seemed a good idea to apply them to the S3 driver as well."
},
{
"commit": "682ac656f552a35dba946c303610a69c70a4de42",
"date": "2020-07-06 15:03:24 -0400",
"subject": "Fix restore --force acting like --force --delta.",
"body": "This caused restore to replace files based on timestamp and size rather than overwriting, which meant some files that should have been updated were left unchanged. Normal restore and restore --delta were not affected by this issue."
},
{
"commit": "8409ab7b2ba798ceaf738e1e38805bc2998feb7b",
"date": "2020-07-06 12:04:35 -0400",
"subject": "Fix typo."
},
{
"commit": "cf284fbe8ad8dd9c32ca9b5b39869e32fe04f9ac",
"date": "2020-07-06 07:48:12 -0400",
"subject": "Add httpUriDecode(), httpQueryNewStr(), and httpQueryMerge().",
"body": "httpUriDecode() reverses the encoding in httpUriEncode().\n\nhttpQueryNewStr() creates a new HttpQuery by parsing a query string.\n\nhttpQueryMerge() merges the contents of one query into another query."
},
{
"commit": "3f4371d7a2407b0ef12404cc2ff2661229bdf283",
"date": "2020-07-02 16:24:34 -0400",
"subject": "Azure support for repository storage.",
"body": "Azure and Azure-compatible object stores can now be used for repository storage.\n\nCurrently only shared key authentication is supported but SAS will be added soon."
},
{
"commit": "3e2c8874f7249cc5a70ec8738370f654e280e582",
"date": "2020-07-01 07:39:29 -0400",
"subject": "Fix typo."
},
{
"commit": "be16bf69a8e66f3eb42bb0789ff210e6d36ddee3",
"date": "2020-06-29 15:07:17 -0400",
"subject": "Remove internal commands from HTML and man command references.",
"body": "Some of these commands will be made public in the future but for now their interfaces are not stable so they remain internal."
},
{
"commit": "c2dea180fbac39782ed0051205affbb1266642a2",
"date": "2020-06-26 16:50:29 -0400",
"subject": "Remove redundant storage type constants.",
"body": "These constants predate the C storage drivers which now provide their own constants."
},
{
"commit": "1416dc32251e66992bbf1639079f7137af3f2d99",
"date": "2020-06-26 16:44:10 -0400",
"subject": "Add missing end braces in debug log functions.",
"body": "These had no effect on functionality but made debug messages harder to read."
},
{
"commit": "96adf8e513f62d4fbcc2905286127b3558b5aa3d",
"date": "2020-06-26 07:44:56 -0400",
"subject": "PostgreSQL 13 beta2 support.",
"body": "There don't appear to be any behavioral changes since PostgreSQL 12 and all the tests pass.\n\nChanges to the control/catalog/WAL versions in subsequent betas may break compatibility but pgBackRest will be updated with each release to keep pace."
},
{
"commit": "e53de3ce46497edee69dc4fb65d54185ccbcfd66",
"date": "2020-06-26 06:50:20 -0400",
"subject": "Add/update comments in storage/s3 module."
},
{
"commit": "974cc10b90b11d67ba32ba765e1c445cf3a3b3c7",
"date": "2020-06-26 06:46:25 -0400",
"subject": "Minor improvements to storage/s3 unit test."
},
{
"commit": "e46eeefadae218c2552b17a0303b15b6af90718d",
"date": "2020-06-26 06:34:21 -0400",
"subject": "Add review for ea04ec7b."
},
{
"commit": "ea04ec7b3f4c6cf25c1b827c25c6a3c5896159a8",
"date": "2020-06-25 08:02:48 -0400",
"subject": "Disable query parallelism in PostgreSQL sessions used for backup control.",
"body": "There is no need to have parallelism enabled in a backup control session. In particular, 9.6 marks pg_stop_backup() as parallel-safe but an error will be thrown if pg_stop_backup() is run in a worker."
},
{
"commit": "c5a507b9a64b2d775f3269690e925698ce56e9e1",
"date": "2020-06-24 19:33:56 -0400",
"subject": "Add comment about setting application_name."
},
{
"commit": "ce98e326e1a9477d2cb1253e00f917e350f96527",
"date": "2020-06-24 18:40:19 -0400",
"subject": "Replace HRNPQ_MACRO_OPEN_92() test macro with HRNPQ_MACRO_OPEN_GE_92()."
},
{
"commit": "f55cb386d4d1ab87404643619f054e1b27d35944",
"date": "2020-06-24 18:33:20 -0400",
"subject": "Fix versions passed to HRNPQ_MACRO_OPEN_GE_92() test macro.",
"body": "These were not noticed because currently 9.3 and 9.6 behave the same on open."
},
{
"commit": "c5892d129169b2d6e62390e7aaa597bc412f528b",
"date": "2020-06-24 13:44:00 -0400",
"subject": "Asynchronous S3 multipart upload.",
"body": "When uploading large files the upload is split into multiple parts which are assembled at the end to create the final file. Previously we waited until each part was acknowledged before starting on the processing (i.e. compression, etc.) of the next part.\r\n\r\nNow, the request for each part is sent while processing continues and the response is read just before sending the request for the next part. This asynchronous method allows us to continue processing while the S3 server formulates a response.\r\n\r\nTesting from outside AWS in a high-bandwidth, low-latency environment showed a 35% improvement in the upload time of 1GB files. The time spent waiting for multipart notifications was reduced by ~300% (this measurement included the final part which is not uploaded asynchronously).\r\n\r\nThere are still some possible improvements: 1) the creation of the multipart id could be made asynchronous when it looks like the upload will need to be multipart (this may incur cost if the upload turns out not to be multipart). 2) allow more than one async request (this will use more memory).\r\n\r\nA fair amount of refactoring was required to make the HTTP responses asynchronous. This may seem like overkill but having well-defined request, response, and session objects will also be advantageous for the upcoming HTTP server functionality.\r\n\r\nAnother advantage is that the lifecycle of an HttpSession is better defined. We only want to reuse sessions that complete the request/response cycle successfully, otherwise we consider the session to be in a bad state and would prefer to start clean with a new one. Previously, this required complex notifications to mark a session as \"successfully done\". Now, ownership of the session is passed to the request and then the response and only returned to the client after a successful response. If an error occurs anywhere along the way the session will be automatically closed by the object destructor when the request/response object is freed (depending on which one currently owns the session)."
},
{
"commit": "45d9b0313632dce934d842e8daf7245a70bc026c",
"date": "2020-06-24 12:09:24 -0400",
"subject": "Add strCatZ().",
"body": "strCat() did not follow our convention of appending Z to functions that accept zero-terminated strings rather than String objects.\r\n\r\nAdd strCatZ() to accept zero-terminated strings and update strCat() to accept String objects.\r\n\r\nUse LF_STR where appropriate but don't use other String constants because they do not improve readability."
},
{
"commit": "dab00e2010dca8acdd559ebfc0161b69a936842d",
"date": "2020-06-24 07:45:00 -0400",
"subject": "Remove expect logs obsoleted in a3e5e66f.",
"body": "These expect logs are no longer used but are not automatically removed by test.pl."
},
{
"commit": "a3e5e66f05362cc3a0ea41db0098c2fca56c4cd7",
"date": "2020-06-23 13:44:29 -0400",
"subject": "Simplify test matrix for real/all tests.",
"body": "Test matrices were previously simplified for the mock/* tests (e.g. d4410611, d489eb87) but not for real/all since the rules for which tests would run with which options was extremely complex. This only got more complex when new compression formats were added.\n\nBecause the loop-generated matrix was so large, mosts tests were skipped for most option combinations following arcane logic which was nearly impossible to decipher even when reading the code, and completely impossible from the test.pl interface. As a consequence, important tests got excluded. For example, backup from standby was excluded for most versions of PostgreSQL because it was only run once per distro, against the latest version to be included in that distro.\n\nSimplify the tests by having a single run per PostgreSQL version and vary test parameters according to the capabilities of each version and the underlying distro. So, ZST testing is based on whether the distro supports ZST. Every test is run for each set of parameters based on the capabilities of the PostgreSQL version, e.g. backup from standby is not attempted on versions that don't support it.\n\nNote that since more tests are running the overall time to run the mock/all tests has increased by about 20-25%. Some time may be saved my removing tests that are adequately covered by unit tests but that should the subject of another commit. Another option would be to limit some non version-specific tests to a single, well defined version of PostgreSQL, .e.g the version that is run by expect tests, currently 9.6.\n\nThe motivation for this refactor is that new storage drivers are coming and the loop-generated test matrix simply was not up to the task of adding them.\n\nThe following is an example of the new test log (note longer runtime of each test):\n\nmodule=real, test=all, run=1, pg-version=10 (106.91s)\nmodule=real, test=all, run=1, pg-version=9.5 (151.09s)\nmodule=real, test=all, run=1, pg-version=9.2 (123.11s)\nmodule=real, test=all, run=1, pg-version=9.1 (129s)\n\nvs. the old test log (sub-second tests were skipped entirely):\n\nmodule=real, test=all, run=2, pg-version=10 (0.31s)\nmodule=real, test=all, run=3, pg-version=10 (0.26s)\nmodule=real, test=all, run=4, pg-version=10 (60.39s)\nmodule=real, test=all, run=1, pg-version=10 (69.12s)\nmodule=real, test=all, run=6, pg-version=10 (34s)\nmodule=real, test=all, run=5, pg-version=10 (42.75s)\nmodule=real, test=all, run=2, pg-version=9.5 (0.21s)\nmodule=real, test=all, run=3, pg-version=9.5 (0.21s)\nmodule=real, test=all, run=4, pg-version=9.5 (0.21s)\nmodule=real, test=all, run=5, pg-version=9.5 (0.26s)\nmodule=real, test=all, run=6, pg-version=9.5 (0.21s)\nmodule=real, test=all, run=1, pg-version=9.2 (72.78s)\nmodule=real, test=all, run=2, pg-version=9.2 (0.26s)\nmodule=real, test=all, run=3, pg-version=9.2 (0.31s)\nmodule=real, test=all, run=4, pg-version=9.2 (0.21s)\nmodule=real, test=all, run=5, pg-version=9.2 (0.21s)\nmodule=real, test=all, run=6, pg-version=9.2 (0.21s)\nmodule=real, test=all, run=1, pg-version=9.5 (88.41s)\nmodule=real, test=all, run=2, pg-version=9.1 (0.21s)\nmodule=real, test=all, run=3, pg-version=9.1 (0.26s)\nmodule=real, test=all, run=4, pg-version=9.1 (0.21s)\nmodule=real, test=all, run=5, pg-version=9.1 (0.31s)\nmodule=real, test=all, run=6, pg-version=9.1 (0.26s)\nmodule=real, test=all, run=1, pg-version=9.1 (72.4s)"
},
{
"commit": "d560c1bf19b2ef3699971790e1f887dac4168964",
"date": "2020-06-23 12:42:46 -0400",
"subject": "Ignore \"unsupported frontend protocol\" error on Centos/RHEL 6.",
"body": "The unsupported version error is showing up on older versions of PostgreSQL (e.g. 9.1, 9.2) on RHEL6 when setting up a standby with streaming replication. The error occurs when a client does not properly send a version number and it's not clear why it is happening here, but it does not appear to have anything to do with pgBackRest and only affects RHEL6, i.e. 9.1 and 9.2 do not show this error on other distros.\n\nFor now ignore the error since RHEL6 is nearly EOL."
},
{
"commit": "04b2e4a831409d1a2edff669bedb6108a9ca20ed",
"date": "2020-06-23 09:24:18 -0400",
"subject": "Increase log level of checkManifest() to debug.",
"body": "This function is only called once and is very likely throw errors so debug level is more appropriate."
},
{
"commit": "1aedc75b03c5d17acde853918150c2dc043dae35",
"date": "2020-06-21 11:47:41 -0400",
"subject": "Rename http/Http to HTTP in comments and messages.",
"body": "HTTP is an acronym so it should be capitalized. Coding conventions dictate otherwise for function and type names but that should not have been propagated to comments and messages."
},
{
"commit": "911384d9b9b7cfd042a18eeb79b5a6f0c79544e7",
"date": "2020-06-21 11:07:18 -0400",
"subject": "Add httpDateFromTime().",
"body": "Also rename httpLastModifiedToTime() to httpDateToTime() since the RFC-2822 date format used by HTTP is used in all Date headers."
},
{
"commit": "fbff29957cd165e6262359629a672e240d45c3bb",
"date": "2020-06-18 13:13:55 -0400",
"subject": "Inline strPtr() to increase profiling accuracy.",
"body": "strPtr() is called more than any other function and during profiling (with or without optimization) it can end up using a disproportionate amount of the total runtime. Even though it is fast, the profiler has a minimum resolution for each function call so strPtr() will often end up towards the top of the list even though the real runtime is quite small.\r\n\r\nInstead, inline strPtr() and indicate to gcc that it should be inlined even for non-optimized builds, since that's how profiles are usually generated.\r\n\r\nTo make strPtr() smaller require \"this\" to be non-NULL and add another function, strPtrNull(), to deal with the few cases where we need NULL handling.\r\n\r\nAs a bonus this makes the executable about 1% smaller even when compared to a prior optimized build which would inline some percentage of strPtr() calls."
},
{
"commit": "3d74ec1190c14f103c88852e3419d8b1b49cca50",
"date": "2020-06-17 15:14:59 -0400",
"subject": "Use PostgreSQL instead of postmaster where appropriate.",
"body": "Using postmaster in messages was not very helpful since users rarely interact directly with the postmaster. Using PostgreSQL instead seems clearer."
},
{
"commit": "417818dccae7b6e1b559d3adb423a26999040882",
"date": "2020-06-17 15:07:30 -0400",
"subject": "Add --no-coverage-report to test.pl to disable report generation.",
"body": "There is no sense in generating detailed coverage reports in CI environments where they will never be seen. It takes time and format differences in some older versions can cause problems in the report generation code.\n\nNote that missing coverage will still be reported on stdout and the test will fail."
},
{
"commit": "ea984c4d3e4749afa8b17bfd991023e590cb76b8",
"date": "2020-06-17 09:46:09 -0400",
"subject": "Update TEST_RESULT_PTR() to TEST_RESULT_STR() where appropriate.",
"body": "These were missed in d41eea68 when the functionality of TEST_RESULT_STR() was changed. Using TEST_RESULT_STR() instead of TEST_RESULT_PTR() is more type-safe and clearer.\n\nAdd a comment to make it clear that TEST_RESULT_PTR() should be used only when a better alternative is not available."
},
{
"commit": "c4fe09dabe48c9aa2ccff2b1cd94d0614c3808e9",
"date": "2020-06-16 19:25:16 -0400",
"subject": "Fix incorrect param log types."
},
{
"commit": "6a851994f3c2822115e1819f9739368344d9c08a",
"date": "2020-06-16 15:40:32 -0400",
"subject": "Make sure functions/types needed for profiling are defined.",
"body": "Profiling runs with debugging disabled but the tests still need TestError and stackTraceTestFileLineSet() to be valid even if they are noops."
},
{
"commit": "0680cfc8dca832d4733302cce5bc67bfe1fedee2",
"date": "2020-06-16 14:06:38 -0400",
"subject": "Rename most instances of master to primary in tests.",
"body": "This aligns better with general PostgreSQL usage and our own documentation (updated in 4bcef702).\n\nUsage in the backup.manifest tests has not been updated since it might break the file format."
},
{
"commit": "11c192f30ee859e011f1db026fcff76e6560eed0",
"date": "2020-06-16 13:20:01 -0400",
"subject": "Add hint when checksum delta is enabled after a timeline switch.",
"body": "This warning is normal when restoring a backup or promoting a standby so add a hint to make that clear."
},
{
"commit": "1094a2d802a9c3e0af9f222e8e0e74dc81128086",
"date": "2020-06-12 11:27:18 -0400",
"subject": "Update the PITR FAQ to clarify the default behavior."
},
{
"commit": "a60d4c939accb0e3d380968ed2bbcbe55ac8249c",
"date": "2020-06-11 14:06:36 -0400",
"subject": "Update FAQ page for expiring a specific backup set.",
"body": "The FAQ should have been updated with the addition of ad hoc expire in 1c1a7104."
},
{
"commit": "6fe60a2428f5c28a2da66b84cb2d7910155df60c",
"date": "2020-06-11 13:17:35 -0400",
"subject": "Improve behavior of the repo-ls command.",
"body": "* Exclude linefeed when there is no output to avoid a blank line.\r\n* Honor filter when adding . path or listing a single file."
},
{
"commit": "237ba54d206b2a598ba0113bbaa5bedf39b6f583",
"date": "2020-06-11 11:48:42 -0400",
"subject": "Fix expression when recursion enabled in storageInfoListP().",
"body": "Expressions only worked at the first level of recursion because the expression was also being applied to paths so the path had to match the filter in order to recurse.\r\n\r\nThis is not considered a bug since it does not affect any existing code paths, but it is required for the general-purpose repo-ls command."
},
{
"commit": "da4f15663b517ce7922012efc05105e1f9d0e6e6",
"date": "2020-06-10 11:41:08 -0400",
"subject": "Improve error when pg1-path option missing for archive-get command.",
"body": "The assert thrown was not as descriptive as a proper option missing error."
},
{
"commit": "d0e08a537d36bb1b321ab3c8a305e4988666364d",
"date": "2020-06-05 15:08:39 -0400",
"subject": "Better error when closing an already closed session in TLS test harness."
},
{
"commit": "38bf3d51546486a5085e9dda3cfc7c5bdad24b46",
"date": "2020-06-03 09:02:53 -0400",
"subject": "Add missing ioReadClose().",
"body": "This probably wouldn't be a big issue since the close would happen when the IoRead object was destroyed, but better to be safe."
},
{
"commit": "9efbafc84c4a51f48aaf64616c10de1f395fda10",
"date": "2020-06-01 13:19:47 -0400",
"subject": "Fix incorrect example for repo-retention-full-type option."
},
{
"commit": "ae15aced9983daebe5b935670e55095e8b03e4f6",
"date": "2020-06-01 12:24:19 -0400",
"subject": "Update RHEL package to add logrotate script."
},
{
"commit": "fe829af4ece88afabc026e876250fc04851bb51c",
"date": "2020-05-28 10:27:45 -0400",
"subject": "Remove exclamations from test data.",
"body": "Three exclamations are commonly used to mark areas of the code that need attention before commit so having them in a test is distracting."
},
{
"commit": "28676e1707a36e273b7f236d495b3e611a06328d",
"date": "2020-05-28 09:19:12 -0400",
"subject": "Add missing parameter logging."
},
{
"commit": "3b5f76b434a2c5831104fc582327ef1f584f5fe0",
"date": "2020-05-27 15:13:55 -0400",
"subject": "Improve handling of invalid HTTP response status.",
"body": "A truncated HTTP response status could lead to an an unfriendly error message, which would be retried, but could be confusing if the error was persistent and required debugging.\r\n\r\nImprove the error handling overall to catch more error cases explicitly and respond better to edge cases.\r\n\r\nAlso update the terminology in comments to align with the RFC. Variable and function names were not changed because a refactor is intended for HTTP response and it doesn't seem worth the additional code churn."
},
{
"commit": "d05090ab7bacdd95cc5c2d4b45fd25b7bc71a602",
"date": "2020-05-27 09:22:30 -0400",
"subject": "Remove Debian package patch now that it has been merged upstream."
},
{
"commit": "b27f9e886b4f21ac199ededde3a189355eac9f88",
"date": "2020-05-26 09:16:57 -0400",
"subject": "Refactor TLS server test harness for ease of use.",
"body": "The prior harness required a separate function to contain the server behavior but this made keeping the client/server code in sync very difficult and in general meant test writing took longer.\n\nNow, commands to define server behavior are inline with the client code, which should greatly simplify test writing."
},
{
"commit": "d92d0513c09c3e28a4c5961c4fc5a62aaac263d8",
"date": "2020-05-26 08:40:40 -0400",
"subject": "Update install-sh to v1.16.2.",
"body": "No version bump for some reason.\n\nhttps://git.savannah.gnu.org/gitweb/?p=automake.git;a=commit;h=6774c9b219cd78445964cd694588cfc4df9b8316"
},
{
"commit": "943b80e1a712b9040967ff8a4aeb4a0f0e8f39a9",
"date": "2020-05-26 08:30:27 -0400",
"subject": "Begin v2.28 development."
},
{
"commit": "d8214e0d78ca8922eecb4da03008034c6a258b3b",
"date": "2020-05-26 08:11:50 -0400",
"subject": "v2.27: Expiration Improvements and Compression Drivers"
},
{
"commit": "20d8c76b6cbf4d803b155680802e8dd245f3d107",
"date": "2020-05-22 13:51:26 -0400",
"subject": "Ignore pg-host* and repo-host* options for the remote command.",
"body": "The purpose of the remote command is to get access to local resources, so a remote should never start another remote. However, this could happen if there were host settings on the remote host, which ended badly with lock errors, loops, etc.\r\n\r\nAdd pg-local and repo-local options to indicate that the resource is local even if there are host settings.\r\n\r\nNote that for the time being these options are internal and not intended for general usage. However, this is likely the direction needed to allow for more symmetric and manageable configurations."
},
{
"commit": "35ab61da708c6b42341449ed5fb68b24bd3a854c",
"date": "2020-05-22 09:28:50 -0400",
"subject": "Remove extra spaces.",
"body": "These spaces crept in over time and then got copy-pasted all over the place."
},
{
"commit": "ae75ffc1731e2d3e7f230d8cceee1e6050b37a33",
"date": "2020-05-21 16:09:23 -0400",
"subject": "Fix possibly missing pg1-* options for the remote command.",
"body": "Some pg1-* options are required by the remote so if they are not provided in the remote's configuration file then it may cause a configuration error, depending on the operation. This currently only applies to the pg1-path option.\r\n\r\nThis is still an issue for repo-* options but the same solution cannot be applied because some repo-* options are secure and cannot be passed on the command-line."
},
{
"commit": "ec7b7c5a3e2062de05e68baec987c35eef4d0a27",
"date": "2020-05-21 13:46:16 -0400",
"subject": "PostgreSQL 13 beta1 support.",
"body": "There don't appear to be any behavioral changes since PostgreSQL 12 and all the tests pass.\r\n\r\nChanges to the control/catalog/WAL versions in subsequent betas may break compatibility but pgBackRest will be updated with each release to keep pace."
},
{
"commit": "ed814321514259a55e84607cd28358ec8cfae754",
"date": "2020-05-21 13:43:12 -0400",
"subject": "Revert PostgreSQL comment to original source version.",
"body": "Not sure how \"iff\" got changed to \"if\". Perhaps an unintentional spell check."
},
{
"commit": "f15d6104d245330db0de59714e9872a18a65e658",
"date": "2020-05-20 14:56:13 -0400",
"subject": "Add local MD5 implementation so S3 works when FIPS is enabled.",
"body": "S3 requires the Content-MD5 header for many requests but MD5 is not available via OpenSSL when FIPS is enabled because it is considered to be insecure.\r\n\r\nEven though our usage does not present any security risks a local M5 implementation is required to circumvent the over-broad FIPS restriction.\r\n\r\nVendorize the MD5 implementation found at https://openwall.info/wiki/people/solar/software/public-domain-source-code/md5 and add full coverage for the module in the common/crypto unit tests."
},
{
"commit": "d5f451a8b99609b220e24346df636e902e9f1aee",
"date": "2020-05-20 08:52:15 -0400",
"subject": "Add missing asserts."
},
{
"commit": "ea9147e2e082ef4bcb793de31b166e65719e9d08",
"date": "2020-05-19 16:58:49 -0400",
"subject": "Reduce buffer-size default to 1MiB.",
"body": "The prior default was determined by benchmarking the Perl code prior to the 1.0 release. In general buffer allocation was more expensive in Perl so large buffers gave the best performance. This was due to multiple buffer allocations for each filter in an IO operation.\n\nThe C code allocates fixed buffers for each IO operation so the cost for buffer allocation is lower than Perl. That being the case it made sense to benchmark the C code to determine the optimal buffer default.\n\nThe performance/storage tests were used to measure the performance of a variety of filters. 1GiB of data was processed by each filter 10 times and the results of the tests were averaged.\n\nWhile most buffer sizes gave similar performance, 1MiB appeared to perform the best overall. Of course, different architectures are likely to yield different results but this seems like a sensible default. The buffer-size option may still need to be manually configured to give optimal results.\n\nRaw test data for reference:\n\n4MB buffer (prior default)\n\ncopy time 1807ms, avg time 180ms, avg throughput: 5942MB/s\nmd5 time 14200ms, avg time 1420ms, avg throughput: 756MB/s\nsha1 time 11431ms, avg time 1143ms, avg throughput: 939MB/s\nsha256 time 23463ms, avg time 2346ms, avg throughput: 457MB/s\ngzip -6 time 381199ms, avg time 38119ms, avg throughput: 28MB/s\nlz4 -1 time 15484ms, avg time 1548ms, avg throughput: 693MB/s\n\n1MB buffer (new default)\n\ncopy time 1760ms, avg time 176ms, avg throughput: 6100MB/s\nmd5 time 13739ms, avg time 1373ms, avg throughput: 781MB/s\nsha1 time 11025ms, avg time 1102ms, avg throughput: 973MB/s\nsha256 time 22539ms, avg time 2253ms, avg throughput: 476MB/s\ngzip -6 time 372995ms, avg time 37299ms, avg throughput: 28MB/s\nlz4 -1 time 15118ms, avg time 1511ms, avg throughput: 710MB/s\n\n512K buffer\n\ncopy time 1782ms, avg time 178ms, avg throughput: 6025MB/s\nmd5 time 13724ms, avg time 1372ms, avg throughput: 782MB/s\nsha1 time 10959ms, avg time 1095ms, avg throughput: 979MB/s\nsha256 time 22982ms, avg time 2298ms, avg throughput: 467MB/s\ngzip -6 time 378120ms, avg time 37812ms, avg throughput: 28MB/s\nlz4 -1 time 15484ms, avg time 1548ms, avg throughput: 693MB/s\n\n256K buffer\n\ncopy time 1805ms, avg time 180ms, avg throughput: 5948MB/s\nmd5 time 13706ms, avg time 1370ms, avg throughput: 783MB/s\nsha1 time 11074ms, avg time 1107ms, avg throughput: 969MB/s\nsha256 time 22588ms, avg time 2258ms, avg throughput: 475MB/s\ngzip -6 time 372645ms, avg time 37264ms, avg throughput: 28MB/s\nlz4 -1 time 16346ms, avg time 1634ms, avg throughput: 656MB/s"
},
{
"commit": "f773d909be42ba68125df991e8fbabb30f2bbe4a",
"date": "2020-05-19 14:35:20 -0400",
"subject": "Improve storage filter performance tests.",
"body": "Improve the accuracy of the calculations in several areas with better integer expressions.\n\nMake the input buffer size configurable. Previously it was always 1mb, i.e. block size.\n\nUse a macro for output results to reduce code duplication."
},
{
"commit": "a3d9d9a387c61d02cf66eac0c6ab84517898dc34",
"date": "2020-05-19 08:20:33 -0400",
"subject": "Handle missing reason phrase in HTTP response.",
"body": "Reason phrases (e.g. OK) are optional in HTTP 1.1 but the space after the status code is not. When the reason phrase was missing the required space was trimmed along with the trailing CR leading to a format error.\n\nRework the logic to preserve the space and allow empty reason phrases.\n\nFound while testing against the Backblaze S3-compatible API."
},
{
"commit": "cffdadad927e3860bd33247ef6b7c3037fc7d9cb",
"date": "2020-05-18 19:55:09 -0400",
"subject": "Fix typo pp64le -> ppc64le.",
"body": "Travis-CI guessed the correct value but logged a warning."
},
{
"commit": "688ec2a8f5634694a3985ec003d118ed8c74b540",
"date": "2020-05-18 19:11:26 -0400",
"subject": "Use an extension to denote vendorized code.",
"body": "Vendorized code is copied from another project when a library is not available and a git subproject won't work. Currently all the vendorized code is copied from PostgreSQL but it makes sense to have a more general mechanism for indicating vendorized code.\n\nThe .vendor extension will be used to denote vendorized code in the same way that .auto is used to denote auto-generated code."
},
{
"commit": "a329afd3be16206e0397732f0de79c93686702f1",
"date": "2020-05-18 19:02:11 -0400",
"subject": "Add MD5 hash filter to performance tests."
},
{
"commit": "92c036b966b3f88b4914c5be24c96c22d5019e98",
"date": "2020-05-18 18:09:41 -0400",
"subject": "Add code count rule for valgrind suppression missed in 6be5ea33.",
"body": "6be5ea33 changed valgrind suppression file naming but failed to update the code count rules."
},
{
"commit": "ac5d46dc50a662c97c2948aac9101c0df71110f3",
"date": "2020-05-16 18:25:31 -0400",
"subject": "Increase buffer size for lz4 compression flush.",
"body": "Some lz4 versions between r131 and 1.7.5 did not return a sufficient buffer size from LZ4F_compressBound() to allow LZ4F_compressEnd() to complete reliably. While this issue was fixed in lz4 1.7.5 there are affected versions in supported distributions such as CentOS/RHEL 7.\n\nUse one of the hacks suggested in https://github.com/lz4/lz4/issues/290 to increase the buffer size enough for LZ4F_compressEnd() to complete. This means that a slightly larger buffer size is required for all versions but it seems worth it to (hopefully) to fix the issue in all lz4 versions."
},
{
"commit": "f4e6e6bd80c68dca6a33a8e23e0fa32026f52d23",
"date": "2020-05-15 07:49:23 -0400",
"subject": "Add missing cryptoInit() in cryptoHmacOne().",
"body": "If cryptoInit() had not already been called then EVP_get_digestbyname() would fail.\n\nThis does not appear to be a problem currently because of call order. Also, newer versions of OpenSSL auto-initialize."
},
{
"commit": "ea485e916bb29c9c0306b7c28148f09883835482",
"date": "2020-05-14 18:45:23 -0400",
"subject": "Add jq to tools installed by Vagrantfile."
},
{
"commit": "ed5149c9be9e41ba4b2ccccac3644f24ecb36bd7",
"date": "2020-05-14 18:27:26 -0400",
"subject": "Disable package builds for CentOS 7 which are broken upstream."
},
{
"commit": "e7ad795ffba6f963457b27142fe17d4aa6bd5c01",
"date": "2020-05-13 19:00:48 -0400",
"subject": "Move common HTTP headers to HTTP client.",
"body": "Some headers in the S3 driver were common HTTP headers that may be used by other drivers that utilize HTTP.\n\nAlso change the order of HTTP_HEADER_TRANSFER_ENCODING to be alphabetical."
},
{
"commit": "4cbd1f1e7efe5217540e2e69bb3baf5d55556068",
"date": "2020-05-13 14:27:28 -0400",
"subject": "Fix incorrect whitespace."
},
{
"commit": "b5dd14e6f306b18f4a1f555ccde28ffda8e41ac8",
"date": "2020-05-12 18:55:20 -0400",
"subject": "Make storage type more generic in the integration tests.",
"body": "Rather than bS3 use strStorage which can indicate more than two storage types.\n\nFor the moment there are still only two storage types but this change is required before more can be added."
},
{
"commit": "9639a2c15fa3e3bb5cffc6bf6ac4eb82f85aef49",
"date": "2020-05-12 13:30:46 -0400",
"subject": "Add missing do...while loop to harness macro."
},
{
"commit": "b8a5c3ac6fe5b4c321270ae256492e11b8276445",
"date": "2020-05-12 13:13:04 -0400",
"subject": "Fix incorrect command in reference documentation.",
"body": "Also update process to command to be more consistent with the surrounding text."
},
{
"commit": "33cbdb78fd3f51f758b2da948faaee97d6bcd870",
"date": "2020-05-11 10:10:22 -0400",
"subject": "Add ppc64le to Travis-CI build matrix.",
"body": "apt.postgresql.org provides packages for ppcle64 so it's important that we support it.\n\nRearrange jobs a bit based on current runtimes and importance. Also reduce the number of tests run for arm64 since it is slower than other architectures."
},
{
"commit": "86855e271d476e9cf04d5844a7630a979b0398d6",
"date": "2020-05-09 12:12:29 -0400",
"subject": "Fix subtle timing issue in command/expire tests.",
"body": "cdebfb09 added relative times to backup.into but a subtle issue was introduced that would cause the tests to fail if the time acquired by cmdExpire() was exactly the same as timeNow used to format backup.info. cmdExpire() was working correctly given the inputs, but the tests did not run predictably.\n\nThis was found while running the tests with --no-valgrind --no-coverage which allows them to run a lot faster, thus exposing the timing issue."
},
{
"commit": "22d260ad53c4517ece42fe64ff75e022e5054466",
"date": "2020-05-09 09:17:33 -0400",
"subject": "Allow more tests to run outside of containers.",
"body": "These tests required sudo to achieve complete coverage.\n\nAdd a new coverage exception, vm_covered, that applies to code that can only be covered in a container. When the test is run outside of a container code sections that require a container will be excluded with TEST_CONTAINER_REQUIRED and the coverage exception will be added to prevent a coverage error.\n\nThis does require marking up the core code with vm_covered, which in some modules (e.g. common/io/tls/client) can be extensive. It's possible that some of these tests can be rewritten to be less dependent on sudo but no attempt was made to do that here.\n\nOnly allow coverage summaries in a vm since coverage summaries outside a vm will not be complete, which was true even before this commit."
},
{
"commit": "b4fc1804a83beb2628b1094cec2962f550e40bcd",
"date": "2020-05-08 16:27:54 -0400",
"subject": "Minor updates for bzip2 compression after more review.",
"body": "Update error types throw by bzip2 to be more consistent with gzip.\r\n\r\nUpdate the bzip2 and gzip error default to be AssertError as that's the more common case in both, and add a 'break;' to the default clause -- we don't intend to be just falling through those case statements, even if the default is the last, we should be explicit about that.\r\n\r\nClean up some tabs that snuck in, rename a variable to be more clear, and add some comments."
},
{
"commit": "14369c1c3c8231e7b09b60493f2ad5047f39053c",
"date": "2020-05-08 15:36:20 -0400",
"subject": "Mark variables modified in TRY block as volatile.",
"body": "It's important that the values in these variables are maintained even after an exception is thrown, so they must be marked volatile.\n\nFound while testing on the ppc64le architecture."
},
{
"commit": "cdebfb09e01e64d6acfe650345a56d2b1805374e",
"date": "2020-05-08 15:25:03 -0400",
"subject": "Add time-based retention for full backups.",
"body": "The --repo-retention-full-type option allows retention of full backups based on a time period, specified in days.\r\n\r\nThe new option will default to 'count' and therefore will not affect current installations. Setting repo-retention-full-type to 'time' will allow the user to use a time period, in days, to indicate full backup retention. Using this method, a full backup can be expired only if the time the backup completed is older than the number of days set with repo-retention-full (calculated from the moment the 'expire' command is run) and at least one full backup meets the retention period. If archive retention has not been configured, then the default settings will expire archives that are prior to the oldest retained full backup. For example, if there are three full backups ending in times that are 25 days old (F1), 20 days old (F2) and 10 days old (F3), then if the full retention period is 15 days, then only F1 will be expired; F2 will be retained because F1 is not at least 15 days old."
},
{
"commit": "e873ad6da0b1c2b15a360a117f71df386aa23a0d",
"date": "2020-05-07 17:26:46 -0400",
"subject": "Update Minio version to 2020-05-06T23-23-25Z in tests/documentation.",
"body": "This release fixes the issue we submitted regarding an unquoted eTag: https://github.com/minio/minio/issues/9517"
},
{
"commit": "faabf1227d05dcfbefcd0dfa57fae9a537e2fc08",
"date": "2020-05-07 11:06:56 -0400",
"subject": "Update Fedora container to Fedora 32.",
"body": "This allows unit testing on gcc 10.\n\nAlso fix an incorrect enum in the config/config unit test that was caught by the new compiler."
},
{
"commit": "6646446d2a1ed6182c8388c0007e184d15522127",
"date": "2020-05-07 10:22:22 -0400",
"subject": "Use Z_STREAM_END to detect gz compression finish.",
"body": "Checking for free space in the output buffer worked, but if the buffer was completely filled then deflate() would need to be called again, which was wasteful and a bit confusing for debugging.\n\nInstead, use Z_STREAM_END to detect that compression is done.\n\nThis change was inspired by the bz2 implementation in a021c9fe since bz2 does not allow BZ2_bzCompress() to be called after BZ_STREAM_END is returned. That made it obvious that gz would prefer the same implementation, even if it is more tolerant. The documentation at https://www.zlib.net/manual.html agrees."
},
{
"commit": "f8509ab76ca9fc3469ab8a9752223c6462213e00",
"date": "2020-05-07 07:38:28 -0400",
"subject": "Don't allow sudo to disable core dumps in test containers.",
"body": "Newer versions of sudo output this message to stderr when run in a container:\n\nsudo: setrlimit(RLIMIT_CORE): Operation not permitted\n\nSee https://github.com/sudo-project/sudo/issues/42 for details.\n\nA simple workaround is to prevent sudo from disabling core dumps. This seems safe enough because if sudo is segfaulting then core files are the least of our worries."
},
{
"commit": "3a7558985505ce1a764e846aa01e943dc1e470d1",
"date": "2020-05-07 07:23:15 -0400",
"subject": "Don't allow sudo to disable core dumps in documentation.",
"body": "Newer versions of sudo output this message to stdout when run in a container:\n\nsudo: setrlimit(RLIMIT_CORE): Operation not permitted\n\nSee https://github.com/sudo-project/sudo/issues/42 for details.\n\nA simple workaround is to prevent sudo from disabling core dumps. This seems safe enough because if sudo is segfaulting then core files are the least of our worries."
},
{
"commit": "ad784e19971d43d886abdec9ee2c326954d9d7a3",
"date": "2020-05-07 07:12:42 -0400",
"subject": "Add libz-dev to required build packages in Debian documentation.",
"body": "This is apparently not installed by default in Ubuntu 20.04 as it was in prior versions."
},
{
"commit": "12a5d8a155aeb999a4683caaa0e2ca22925be443",
"date": "2020-05-06 19:11:28 -0400",
"subject": "Add arm64 to Travis-CI build matrix.",
"body": "apt.postgresql.org will soon be providing packages for arm64 so it's important that we support it.\n\nTesting on multiple architectures also helps expose potential issues in popular architectures. See 10a5182d for an example."
},
{
"commit": "6be5ea3388a0238247e2a2cf47f9efd6b1a21d74",
"date": "2020-05-06 18:24:48 -0400",
"subject": "Suppress Valgrind errors on a per-VM basis.",
"body": "There are a number of Valgrind errors on Ubuntu 12.04 which do not happen on newer distro versions. However, suppressions for these errors have masked legitimate issues in subsequent code.\n\nInstead, make suppressions VM specific so errors in other VMs are not masked."
},
{
"commit": "28967951abb47d82914b3b8822a6bc4b79502ac0",
"date": "2020-05-06 18:17:50 -0400",
"subject": "Fix leak in TlsClient object.",
"body": "sckClientOpen() is the most likely part of this code to error so move it up above SSL session creation to reduce the chance of a leak."
},
{
"commit": "e67792980249b2e35c81d26d2fa574bab52250cb",
"date": "2020-05-06 18:09:11 -0400",
"subject": "Fix leak in CipherBlock object.",
"body": "EVP_CIPHER_CTX_cleanup() was being called instead of EVP_CIPHER_CTX_free() so most of the memory was being freed but not all of it.\n\nThis leak was masked by Valgrind suppressions which are only applicable to Ubuntu 12.04, which will be addressed in a future commit."
},
{
"commit": "10a5182d626bd4ba55d4c6ae711555fb030121ca",
"date": "2020-05-06 15:00:34 -0400",
"subject": "Simplify retry handling in tls/http/socket clients.",
"body": "Travis-CI arm64 was not happy with this pattern, perhaps because connected was being reset after a longjmp() even though it should have stayed with its originally initialized value of false. In any case, tlsClientOpen() ended up returning NULL on error rather than throwing an exception.\n\nThe new pattern seems simpler and passes all tests unmodified, so even though the error was only seen in TlsClient it makes sense to propagate to the other clients."
},
{
"commit": "8aede3353cac6a7ddd08f89e23343c6e8b81d3fd",
"date": "2020-05-06 14:49:03 -0400",
"subject": "Always use 127.0.0.1 on TLS tests outside of containers.",
"body": "Resolving localhost can vary based on the local network configuration so it is safer to just use a static IP.\n\nThis was found while testing on Travis-CI arm64."
},
{
"commit": "3fe6ad5047515f51b6ef9bf783e41900eca21c24",
"date": "2020-05-06 10:23:42 -0400",
"subject": "Build branches with -cit suffix on Travis-CI.",
"body": "This allows a branch to be targeted at only Travis-CI and not other CI services."
},
{
"commit": "4c6dbe17eaea15b342f03292dd899de335ff2971",
"date": "2020-05-06 09:12:50 -0400",
"subject": "Remove redundant Cirrus-CI branch filter."
},
{
"commit": "a021c9fe053934b9b620f20caffbbf311c457bb8",
"date": "2020-05-05 16:49:01 -0400",
"subject": "Add bzip2 compression support.",
"body": "bzip2 is a widely available, high-quality data compressor. It typically compresses files to within 10% to 15% of the best available techniques (the PPM family of statistical compressors), while being around twice as fast at compression and six times faster at decompression.\r\n\r\nbzip2 is currently available on all supported platforms."
},
{
"commit": "98f30ef2225e849ecaf501ff11db3952c7ff93c7",
"date": "2020-05-05 15:00:13 -0400",
"subject": "Move PostgreSQL 9.4 real integration tests to Ubuntu 18.04.",
"body": "PostgreSQL 9.4 packages for RHEL 6 were dropped from yum.p.o."
},
{
"commit": "99405cbb1582c6dcc133ce9d722beef6e4a0cf78",
"date": "2020-05-05 13:23:36 -0400",
"subject": "Replace booleans with enums in compressType parameters.",
"body": "This was an oversight in 438b957f which added multiple compression type support. The booleans were interpreted as none and gz which works fine for the CompressType enum until the position of gz or none changes."
},
{
"commit": "d04c21ca83163e875ad4d9e06c57402f45979272",
"date": "2020-05-04 19:05:38 -0400",
"subject": "Centralize String and Buffer constants in stringz.h.",
"body": "It's not clear how useful single-character zero-terminated constants are or if we want propagate them through the code, but it at least makes sense to centralize the constants used by the Buffer and String objects."
},
{
"commit": "47aa765375844509edc1b6e406d4d020590b2e1d",
"date": "2020-05-04 15:25:27 -0400",
"subject": "Add Zstandard compression support.",
"body": "Zstandard is a fast lossless compression algorithm targeting real-time compression scenarios at zlib-level and better compression ratios. It's backed by a very fast entropy stage, provided by Huff0 and FSE library.\n\nZstandard version >= 1.0 is required, which is generally only available on newer distributions."
},
{
"commit": "1aaaa94253c3d50b5f4adbe5521cf2cee6cadbe3",
"date": "2020-05-04 14:02:25 -0400",
"subject": "Remove Ubuntu 19.04 container definition.",
"body": "Ubuntu 19.04 is no longer supported."
},
{
"commit": "39f5f3a0b484f16c2820bd47c0a12a530bd04c30",
"date": "2020-05-04 13:12:52 -0400",
"subject": "Remove PostgreSQL 9.4 for Fedora 30 dropped from yum.p.o."
},
{
"commit": "64a21920e2cbe8444f78ce281d06c9dfa118ed12",
"date": "2020-05-03 18:42:33 -0400",
"subject": "Move S3 initialization in user guide quickstart.",
"body": "The previous location was too late to allow --var=s3-all=y to work with --require=/repo-host, which depends on /quickstart/configure-archiving.\n\nSince the section is not included in production documentation, the position is not very important to flow so just move it to where it works."
},
{
"commit": "ef9324992250028657f7fcc9393d79fbbd0148c3",
"date": "2020-05-01 17:32:31 -0400",
"subject": "Add contributor for 816ba924 and reclassify as a bug."
},
{
"commit": "816ba9244f31bc9cc333eeed1e7e12e76e36edc3",
"date": "2020-05-01 10:30:35 -0400",
"subject": "Allow pg-path1 to be optional for synchronous archive-push.",
"body": "If the WAL path is absolute then pg1-path should be optional but in fact it was required to load pg_control.\n\nSkip the pg_control check when pg1-path is not specified. The check against the stanza version/system-id remains to protect the repo from corruption."
},
{
"commit": "1d45282b9723a05d0b14e7222c42b915aa217735",
"date": "2020-05-01 09:31:50 -0400",
"subject": "Add missing spaces between while keyword and condition.",
"body": "Our convention is to have a space here but some were missed."
},
{
"commit": "28ab65df1049be7623ce7af99a58a6dee616ea36",
"date": "2020-05-01 09:08:37 -0400",
"subject": "Remove unused struct member.",
"body": "Perhaps this was intended to verify the WAL size but was never implemented.\n\nVerifying the WAL size is probably a good idea so this member may be added back if the feature is implemented."
},
{
"commit": "22ba1f02ceca93a8a0fba1f1ba93243bbcb12337",
"date": "2020-04-30 11:01:38 -0400",
"subject": "Convert storagePosixNew() to storagePosixNewP().",
"body": "An upcoming feature requires new parameters for storagePosixNew() and this causes a lot of churn because almost every test creates a Posix storage object. Some refactoring in the tests might reduce this duplication but storagePosixNew() is collecting a lot of parameters so converting to storagePosixNewP() makes sense in any case.\n\nThere are relatively few call sites in the core code but they still benefit from better readability after this change."
},
{
"commit": "baf8cb90684fe743e51412f305f4194196f429ea",
"date": "2020-04-30 10:47:09 -0400",
"subject": "Fix issue checking if file links are contained in path links.",
"body": "There is no conflict if the path containing a file link is a parent path of a path link. The Perl code apparently had this right but the migration to C missed it.\n\nExclude this case when checking for link conflicts."
},
{
"commit": "ce55866714ac706e542bba7e14a9306b5de848f1",
"date": "2020-04-30 10:34:44 -0400",
"subject": "Enforce non-null for most string options.",
"body": "There have been a number of segfaults reported because a string option expected to be non-null was actually null. This is generally due to options that are expected to be set but are in fact optional.\n\nProtect against this by creating cfgOptionStrNull() to get options that can be null, while changing cfgOptionStr() to always expect non-null. There are relatively few places where nulls are expected.\n\nThere is definitely a chance for breakage here as null options might currently be working in the field but will be caught by this new check. Hopefully introducing the check early in the release cycle will allow us to catch any issues."
},
{
"commit": "1158e7d645331ed364542f10b2c92a1740229601",
"date": "2020-04-29 13:55:05 -0400",
"subject": "Move command-line decompress check in common/compress test.",
"body": "It makes sense to do this check right after the first compression so any issues are caught early.\n\nAlso, none of the current compression formats omit decompressCmd so make the test mandatory."
},
{
"commit": "c5241e5007c4736b52a519e1eefd9a38f7971dc2",
"date": "2020-04-29 08:06:49 -0400",
"subject": "Expire WAL archive only when repo-retention-archive threshold is met.",
"body": "Previously when retention-archive was set (either by the user or by default), archives prior to the archive-start of the oldest remaining full backup (after backup expiration occurred) would be expired even though the retention-archive threshold had not been met. For example, if there were 1 full backup remaining after backup expiration and the retention-archive was set to 2 and retention-archive-type=full, then archives prior to the archive-start of the remaining full backup would still be removed even though retention-archive required 2 full backups remaining before archives should be expired.\n\nThe thought was to keep the archive directory clean and since the full backup did not require prior archives, it was safe to delete them. However, this has caused problems for some users in the past (because they needed the WAL for other purposes) and with the new adhoc and time-based retention features, it was decided that the archives should remain until the threshold was met. The archives will eventually be removed and if having them causes space issues, the expire command and the retention-archive can always be run and adjusted."
},
{
"commit": "775e81a74deb4da274c1e4fc86b218e957a2173d",
"date": "2020-04-28 15:55:54 -0400",
"subject": "Refactor regular expression error handling per Coverity report.",
"body": "Coverity was concerned that regExpError() might return and lead to an invalid reference of \"this\". This was unlikely since the function should never return but Coverity didn't know that. Also, a difference in error-handling logic at the two sites could cause the issue Coverity reported if they were to get out of sync.\n\nFix by refactoring out the core error function so that it is clear it will never return."
},
{
"commit": "e421cf9dd31e0916885e1510278f918afc2318fd",
"date": "2020-04-28 15:04:34 -0400",
"subject": "Fix possible NULL reference reported by Coverity.",
"body": "this->input is set to NULL when the read input goes to EOF but it was possible that this->input could be used again in a subsequent loop, according to Coverity.\n\nIn fact this would really only be a problem if EOF suddenly went back to false, which is not allowed. However, checking this->input is cheaper than calling ioReadEofDriver() driver on each loop so this change makes sense as an optimization and it makes Coverity happy, too."
},
{
"commit": "f764953b70ee1ec839079fbda262a60d91b284c9",
"date": "2020-04-27 17:25:38 -0400",
"subject": "Check that options are valid when requested.",
"body": "If an option may not be valid for a command it should be checked with cfgOptionValid() or cfgOptionTest().\n\nIt appears this rule is followed pretty strictly since the only changes required were in unit tests."
},
{
"commit": "1c1a7104604073feff3109a74d1d8ee4a2efc86d",
"date": "2020-04-27 14:00:36 -0400",
"subject": "Add --set option to the expire command.",
"body": "The specified backup set (i.e. the backup label provided and all of its dependent backups, if any) will be expired regardless of backup retention rules except that at least one full backup must remain in the repository."
},
{
"commit": "ad33f545d165260c85cb41f39fd9b0044cc97841",
"date": "2020-04-27 13:17:30 -0400",
"subject": "Move latest backup link functionality to backup/common module.",
"body": "This function is needed for new expire features."
},
{
"commit": "483838233fb4d36425a84dc6274cc1f8833feaa2",
"date": "2020-04-27 10:57:19 -0400",
"subject": "The expire command now checks if a stop file is present.",
"body": "This check has always been missing but it was not noticed because expire is not usually run independently of backup, which does the check correctly."
},
{
"commit": "a5b2630d7c089b229f48e2f9cbd1e9b390fcf496",
"date": "2020-04-27 10:49:05 -0400",
"subject": "Throw user-friendly error if expire is not run on repository host.",
"body": "Running the expire command on a non-repository host threw an assertion because the command is not yet configured for remote execution."
},
{
"commit": "987df62ec014c9b3f21b1ff9cd6db9a33f837a84",
"date": "2020-04-26 17:22:37 -0400",
"subject": "Centralize enforcement of option constraints.",
"body": "Each option type enforced its own constraints but there was a lot of duplication. Centralize the enforcement to remove the duplication.\n\nAlso convert the option type assert to a production error. This is unlikely to happen in production but the test is quite cheap so it can't hurt.\n\nFinally, add a NULL check. Most option types can never be NULL."
},
{
"commit": "12069ff8f388171cf094a579ad27f5969d92b60e",
"date": "2020-04-24 08:45:54 -0400",
"subject": "Add reviewer."
},
{
"commit": "0dd6629a2dba7c011e03c5f39659dc516da28456",
"date": "2020-04-24 08:40:54 -0400",
"subject": "Automatically add default user as reviewer.",
"body": "Contributions looked like they had no reviewer when reviewed by the default user."
},
{
"commit": "e92eb709d6c60e44f406af139b8346b12fee1868",
"date": "2020-04-24 08:00:00 -0400",
"subject": "Add backup/expire running status to the info command.",
"body": "This is implemented by checking for a backup lock on the host where info is running so there are a few limitations:\n\n* It is not currently possible to know which command is running: backup, expire, or stanza-*. The stanza commands are very unlikely to be running so it's pretty safe to guess backup/expire. Command information may be added to the lock file to improve the accuracy of the reported command.\n\n* If the info command is run on a host that is not participating in the backup, e.g. a standby, then there will be no backup lock. This seems like a minor limitation since running info on the repo or primary host is preferred."
},
{
"commit": "2e6938fad9ab4e93c472a3f86812ed82fba1df4d",
"date": "2020-04-21 17:55:36 -0400",
"subject": "Restore works when PGDATA is a link.",
"body": "Make the restore clean process look more like manifest build, i.e. do cleanup of each target root directory outside the main cleanup callback. This means some code duplication but removes the logic handling \"dot\" paths.\n\nAdd tests for both restore and backup (which already worked but was not tested)."
},
{
"commit": "1eb26789387eff604e5902848be4ea7cb633557e",
"date": "2020-04-21 17:20:42 -0400",
"subject": "Fix minor leak in TLS host verification.",
"body": "sk_GENERAL_NAME_free() only freed the name stack, not the names in the stack. sk_GENERAL_NAME_pop_free() frees both.\n\nDue to aggressive connection reuse this leak was unlikely to be very noticeable."
},
{
"commit": "6d11fe53f773163407cf28096f3e48f75c119460",
"date": "2020-04-21 10:51:38 -0400",
"subject": "Update RHEL package location (again).",
"body": "This changed (again) upstream so update the file paths."
},
{
"commit": "a999500d2c6fe07cfc935ba40dbf2d9a192a8f0c",
"date": "2020-04-20 16:21:53 -0400",
"subject": "Remove XML source for test/README.md.",
"body": "63b9f46a removed test/README.md but did not remove the XML source so it reappeared when the release documentation was built."
},
{
"commit": "3e2dc058173bdd01f6d48d7715c70e3c5b17facb",
"date": "2020-04-20 15:58:06 -0400",
"subject": "Begin v2.27 development."
},
{
"commit": "2352ecf7c0db8d12cda4759709b4cd570e1b5de4",
"date": "2020-04-20 15:44:31 -0400",
"subject": "v2.26: Non-blocking TLS"
},
{
"commit": "93e4fe0199bdff3de34eee92b6ace99dab1acb98",
"date": "2020-04-20 13:11:34 -0400",
"subject": "Specify that the io-timeout option is measured in seconds."
},
{
"commit": "1c319e051b26930da69bef8eebbe1414db820a1a",
"date": "2020-04-20 11:49:11 -0400",
"subject": "Remove stray copy of LibCAuto.pm.",
"body": "This was removed in 79cfd3ae but accidentally added back in 2fa69af8, probably due to an incorrectly resolved merge conflict."
},
{
"commit": "4b28f79c92b497eb336ab9b180f029a6bffda5c1",
"date": "2020-04-20 11:08:58 -0400",
"subject": "Clear error queue before each SSL_*() call.",
"body": "The documentation recommends clearing the error queue before each SSL_*() call.\n\nSince we always check the results of SSL_*() for errors instead of blindly calling SSL_get_error() it's not clear this makes any difference, but it still seems like a good idea to be sure there are no stray errors in the queue."
},
{
"commit": "6f41ce1182c3417f4a7844cbe5de5875c27e4363",
"date": "2020-04-20 09:45:08 -0400",
"subject": "Add expire to commands that support io-timeout.",
"body": "The command list was not complete. Copy the command list from buffer-size to make sure all commands are included."
},
{
"commit": "21a1cf9a2f18cc294474efda064a2ae08cc8d18d",
"date": "2020-04-17 09:55:40 -0400",
"subject": "Add sck-block option.",
"body": "This option puts sockets into blocking mode.\n\nIt is only intended for internal use and is not included in the test matrix."
},
{
"commit": "5d25e508aeb8febd509f26225425b391fe45ad06",
"date": "2020-04-17 09:18:52 -0400",
"subject": "Add io-timeout option.",
"body": "Timeout used for connections and read/write operations.\n\nNote that the entire read/write operation does not need to complete within this timeout but some progress must be made, even if it is only a single byte."
},
{
"commit": "c88684e2bf32cef8cc185cca4ef213457b03fa62",
"date": "2020-04-16 16:05:44 -0400",
"subject": "Non-blocking TLS implementation.",
"body": "The prior blocking implementation seemed to be prone to locking up on some (especially recent) kernel versions. Since we were unable to reproduce the issue in a development environment we can only speculate as to the cause, but there is a good chance that blocking sockets were the issue or contributed to the issue.\n\nSo move to a non-blocking implementation to hopefully clear up these issues. Testing in production environments that were prone to locking shows that the approach is promising and at the very least not a regression.\n\nThe main differences from the blocking version are the non-blocking connect() implementation and handling of WANT_READ/WANT_WRITE retries for all SSL*() functions.\n\nTimeouts in the tests needed to be increased because socket connect() and TLS SSL_connect() were not included in the timeout before. The tests don't run any slower, though. In fact, all platforms but Ubuntu 12.04 worked fine with the shorter timeouts."
},
{
"commit": "2260a7512aab7a50473466cc524aabb2a5002edf",
"date": "2020-04-16 15:02:33 -0400",
"subject": "Use poll() instead of select() for monitoring socket read/write ready.",
"body": "select() is a bit old-fashioned and cumbersome to use. Since the select() code needed to be modified to handle write ready this seems like a good time to upgrade to poll().\n\npoll() has been around for a long time so there doesn't seem to be any need to provide a fallback to select().\n\nAlso change the error on timeout from FileReadError to ProtocolError. This works better for read vs. write and failure to poll() is indicative of a protocol error or unexpected EOF."
},
{
"commit": "e5e81d3839648617266285ca519f76835b79f611",
"date": "2020-04-16 14:48:16 -0400",
"subject": "Only limit backup copy size for WAL-logged files.",
"body": "The prior behavior introduced in dcddf3a5 could possibly lead to postgresql.conf or postgresql.auto.conf being truncated in the backup since they are copied via tmp files and could change size during the backup.\n\nIn general it seems safer to limit this feature to WAL-logged files which will be reconstructed during recovery."
},
{
"commit": "85f4eef55e62dcaf05705ce3123cb04b59c2a1f4",
"date": "2020-04-16 14:13:53 -0400",
"subject": "Add Cirrus CI and Vagrant configuration for FreeBSD and MacOS.",
"body": "Building on these platforms gives us better coverage for our build code. Cirrus CI was chosen because it is the only service that supports FreeBSD (that we could find).\n\nThe FreedBSD configuration for Vagrant is currently just enough to perform a build.\n\nThe MacOS configuration is not actually for Vagrant (yet) but does show the steps needed to setup the build environment on MacOS."
},
{
"commit": "09fc69f3e8a0f8ccf6ce95b5d7e59b68b00d14ff",
"date": "2020-04-16 13:58:46 -0400",
"subject": "Make existing Vagrantfile configuration the default.",
"body": "This allows us to add new configurations mostly without changing the behavior of vagrant from the command line, i.e. vagrant up and vagrant ssh will continue to bring up the default configuration.\n\nHowever, vagrant destroy -f will remove all configurations. That's really only a change in behavior if more than one configuration is running, which is not currently possible."
},
{
"commit": "34d7338604b423b858e315db58a7a0976ad30e17",
"date": "2020-04-16 11:50:35 -0400",
"subject": "Fix headers for FreeBSD/MacOS.",
"body": "It looks like Linux is tolerant of the BSD headers so remove the conditionals.\n\nEventually it might be a good idea to include these based on configure rules but that seems over overkill for now."
},
{
"commit": "492180837ee654bb5052bbaca3d04111ee89a4c6",
"date": "2020-04-14 18:03:41 -0400",
"subject": "Classify all .h files as C.",
"body": "Github classifies many C header files as C++, perhaps because they don't contain anything definitively C-like.\n\nAdd an override to ensure .h files are always classified as C since this project contains no C++."
},
{
"commit": "0c07c5111fb73821abed678166cc7bfb132f2285",
"date": "2020-04-14 15:33:43 -0400",
"subject": "Remove empty subexpression from manifest regular expression.",
"body": "MacOS was not happy about this though other platforms seemed to work fine.\n\nThis was likely a typo or a relic from refactoring."
},
{
"commit": "8fb0a8fd6ed7453202ca6bee6516bb5489f9a555",
"date": "2020-04-14 15:28:43 -0400",
"subject": "Remove incorrect Github id.",
"body": "This was a copy-pasto from another contributor entry."
},
{
"commit": "02ebba02b29739b0ff7a1c8e3833c3ff8732041c",
"date": "2020-04-14 15:23:19 -0400",
"subject": "Fix typo."
},
{
"commit": "9ffa2c618fe54710a37448302a0efa1368a041f0",
"date": "2020-04-14 15:22:49 -0400",
"subject": "Use SocketSession/TlsSession for test servers.",
"body": "A session looks much the same whether it is initiated from the client or the server, so use the session objects to implement the TLS, HTTP, and S3 test servers.\n\nFor TLS, at least, there are some differences between client and server sessions so add a client/server type to SocketSession to determine how the session was initiated.\n\nAside from reducing code duplication, the main advantage is that the test server will now timeout rather than hanging indefinitely when less input that expected is received."
},
{
"commit": "71fb28bf3f7387a225c8a32b810772f3f2b09820",
"date": "2020-04-14 15:20:50 -0400",
"subject": "Always throw error when OpenSSL returns SSL_ERROR_SYSCALL.",
"body": "Previously an error was only thrown when errno was set but in practice this is usually not the case. This may have something to do with getting errno late but attempts to get it earlier have not been successful. It appears that errno usually gets cleared and spot research seems to indicate that other users have similar issues.\n\nAn error at this point indicates unexpected EOF so it seems better to just throw an error all the time and be consistent.\n\nTo test this properly our test server needs to call SSL_shutdown() except when the client expects this error."
},
{
"commit": "9f2d647badb666c31ba25c4df8c7294331287a23",
"date": "2020-04-14 15:02:18 -0400",
"subject": "Split session functionality of TlsClient out into TlsSession.",
"body": "This abstraction allows the session code to be shared between the TLS client and (upcoming) server code.\n\nSession management is no longer implemented in TlsClient so the HttpClient was updated to free and create sessions as needed. No test changes were required for HttpClient so the functionality should be unchanged.\n\nMechanical changes to the TLS tests were required to use TlsSession where appropriate rather than TlsClient. There should be no change in functionality other than how sessions are managed, i.e. using tlsClientOpen()/tlsSessionFree() rather than just tlsClientOpen()."
},
{
"commit": "c9481bb95f1edaa93b26f8fce767950e00b40543",
"date": "2020-04-14 14:51:14 -0400",
"subject": "Update contributing.xml to use Ubuntu 18.04.",
"body": "Ubuntu 19.04 was EOL in January and has been removed from the repository servers.\n\nIt may be best to stick to LTS versions from now on."
},
{
"commit": "f03d1b5b7b880b25a19a087ec5e29e3393e2ce43",
"date": "2020-04-14 11:43:50 -0400",
"subject": "Use __noreturn_ on error functions when coverage testing.",
"body": "The errorInternalThrowSys*() functions were marked as returning during coverage testing even when they had no possibility to return, i.e. the error parameter was set to constant true. This meant the compiler would treat the functions as returning even when they would not.\n\nInstead create completely separate functions for coverage to use for THROW_ON_SYS_ERROR*() that can return and leave the regular functions marked __noreturn__."
},
{
"commit": "b7d8d61526e1ed7e617953fc36736d89f9295252",
"date": "2020-04-13 16:59:02 -0400",
"subject": "Split session functionality of SocketClient out into SocketSession.",
"body": "This abstraction allows the session code to be shared between the socket client and (upcoming) server code. There should no difference in how the code works -- only the organization has changed. Note that no changes to the tests were required.\n\nThis same abstraction will be required for TlsClient but that will be done in a separate commit because it requires test changes."
},
{
"commit": "b5347070af5e3e5b9d6a44555aed0212b5cd022a",
"date": "2020-04-13 16:44:29 -0400",
"subject": "Remove extraneous assignment.",
"body": "This is likely leftover cruft from a prior refactor."
},
{
"commit": "9d2223b18881bf862d6ca5da7a2ad28b86421fb1",
"date": "2020-04-13 14:57:01 -0400",
"subject": "Improve comments and fix typos in the storage interface."
},
{
"commit": "310d42ca35431bb196dfc81300b7d8dfa96bbd35",
"date": "2020-04-13 14:51:04 -0400",
"subject": "Correct option name in test.pl help."
},
{
"commit": "71ce6375571bf9253b7aebad5ee44774fb3cbb07",
"date": "2020-04-12 09:01:41 -0400",
"subject": "Use standard HARNESS_FORK*() macros to fork test servers.",
"body": "These forks were done in a custom way (not sure why) and lack the capability of the standard macros for the parent to wait for child exit.\n\nThis mean that the server would continue to run after the tests were complete and that multiple servers could run at once. This caused subtle timing and connection issues that required larger timeouts to resolve.\n\nDon't change the timeouts here since they need to be adjusted in future commits anyway."
},
{
"commit": "42246401b8805c14d8b2a6938dfef152d2905d70",
"date": "2020-04-11 16:24:45 -0400",
"subject": "Add comment."
},
{
"commit": "674b65886face9b2f7966c4f9ff1dc321b90e61c",
"date": "2020-04-11 16:21:03 -0400",
"subject": "Suppress uncoverable error in common/io-tls test module.",
"body": "It is pretty much impossible for a static IP to not resolve to an address but in theory the error could catch other conditions so it seems best to keep it."
},
{
"commit": "9a751c2d98f27c4e270d6d47c0262cad68aee68f",
"date": "2020-04-10 12:56:28 -0400",
"subject": "Fix typo."
},
{
"commit": "63b9f46a34ce20c172394a625858d807b1e2a5a9",
"date": "2020-04-09 18:25:25 -0400",
"subject": "Update contributing documentation and remove test/README.md.",
"body": "When the Vagrant file was updated to use pgbackrest/ vs /backrest/ as the location for executing tests and building the documentation, parts of the contributing.xml (and hence the CONTRIBUTING.md) were not updated since some parts of the document are not actually executed when the CONTRIBUTING.md is built from contributing.xml: those parts that are executed were updated but those parts that are not executed were not.\n\nThis commit fixes the contributing.xml issue but also removes test/README.md as its contents were out of date and redundant given that they are covered in CONTRIBUTING.md."
},
{
"commit": "55c3a3c8d3d58c4b02327be39b3cf080f3805358",
"date": "2020-04-09 18:13:35 -0400",
"subject": "Allow zero wait times in Wait object.",
"body": "This limitation forced extra logic in cases where zero wait times were needed.\n\nRemove the limitation and the extra logic in cases where zero wait times are possible."
},
{
"commit": "c292e8957ded825483f08060ce8857ad935637fd",
"date": "2020-04-07 14:56:09 -0400",
"subject": "Add some debugging to tests that fork servers.",
"body": "Help identify whether errors are happening in the forked server or the main test by showing the line number where the server was forked off in the stack trace."
},
{
"commit": "099bd85ed7cdca017fbfae4d12134a00fcf2236b",
"date": "2020-04-07 14:42:05 -0400",
"subject": "Reset line number in TEST_ERROR*() macros.",
"body": "If these are not reset then an error not wrapped in a TEST_ERROR*() macro may show the line number of the previous error in a stack trace, which is confusing.\n\nIt is better for the line number to be unreported than wrong."
},
{
"commit": "627b49535222bf8408b2593b633a79c8eba3b832",
"date": "2020-04-07 14:35:36 -0400",
"subject": "Add waitRemaining() to get remaining wait time.",
"body": "This can be used to set timeouts so they do not wait longer than needed."
},
{
"commit": "ac3cfa4c9c31a00fb9f88ad65430cd0c550fee49",
"date": "2020-04-07 14:23:31 -0400",
"subject": "Allow default process id to be specified in logInit().",
"body": "The default process id was previously always 0 but there are cases where it is useful to be able to set the default.\n\nCurrently the only use case is for testing but the upcoming server code will also make use of it."
},
{
"commit": "2ec379fa40142462fd018a385affa14346ca76e7",
"date": "2020-04-07 11:10:58 -0400",
"subject": "Add ideator to release note."
},
{
"commit": "5e55d588507e7948dbb48bb8d9427ab4d4503c20",
"date": "2020-04-06 16:09:18 -0400",
"subject": "Simplify storage driver info and list functions.",
"body": "The storage driver requires two list functions to be implemented, list and infoList. But the former is a subset of the latter so implementing both in every driver is wasteful. The reason both exist is that in Posix it is cheaper to get a list of names than it is to stat files to get size, time, etc. In S3 these operations are equivalent.\n\nIntroduce storageInfoLevelType to determine the amount of information required by the caller. That way Posix can work efficiently and all drivers can return only the data required which saves some bandwidth. The storageList() and storageInfoList() functions remain in the storage interface since they are useful -- the only change is simplifying the drivers with no external impact.\n\nNote that since list() accepted an expression infoList() must now do so. Checking the expression is optional for the driver but can be used to limit results or save IO costs.\n\nSimilarly, exists() and pathExists() are just specialized forms of info() so adapt them to call info() instead."
},
{
"commit": "7679f8f88622cd14d442e69d133bd108783cdd80",
"date": "2020-04-04 13:59:50 -0400",
"subject": "Fix issue with THROW*_SYS_ERROR_CODE*() using wrong errno.",
"body": "When DEBUG_COVERAGE was defined errno was being used instead of the value being passed. This apparently worked by happenstance in the single existing usage but it won't work in general."
},
{
"commit": "f984aec66508354e8537b3f8c226f0e574592306",
"date": "2020-04-03 18:15:32 -0400",
"subject": "Standardize some section names in headers.",
"body": "It's better to start out with plural forms rather than flip back and forth as functions are added and subtracted. So, use \"Constructors\" instead of \"Constructor\".\n\nUse \"Getters/Setters\" rather than \"Getters\" or \"Setters\" to avoid similar churn."
},
{
"commit": "1aca2cc90290ffefcc95530dba55e19313754219",
"date": "2020-04-03 18:01:28 -0400",
"subject": "Move extern function comments to headers.",
"body": "This has been the policy for some time but due to migration pressure only new functions and refactors have been following this rule. Now it seems sensible to make a clean sweep and move all the comments that have not been moved already (i.e. most of them).\n\nOnly obvious typos and gross inaccuracies in the comments have been fixed. For this most part this was a copy and paste operation.\n\nUseless comments, e.g. \"New object\", were not copied. Even so, there are surely many deficient comments left.\n\nSome rearranging was done where needed and functions were placed in the proper sections, e.g. \"Constructors\", \"Functions\", etc.\n\nA few function prototypes were found that not longer had an implementation. These were removed, but there may be more.\n\nThe coding document has been updated to reflect this policy, which is not new but has never been documented."
},
{
"commit": "3fbde30c6fac4c752a3a1f47bbf309571b123b7a",
"date": "2020-04-03 13:25:38 -0400",
"subject": "Add/remove dependent backups during backup.info reconstruct.",
"body": "Prior to performing a backup or expiring backups, the backup.info file is validated by reconstructing it from the backups in the repository. When a backup had already been removed from the repo, it was removed from the backup.info file but its dependents were not.\n\nNow, the dependent backups will also be removed from backup.info and only backups in the repo that have their full dependency chain will be added to backup.info if they are missing."
},
{
"commit": "f3ae74b0d62a7b85e1452d46dd60aafbeb88226d",
"date": "2020-04-03 08:38:28 -0400",
"subject": "Remove storageRead() and storageWriteDriver().",
"body": "These functions were only being used in the tests. This usage likely dates to before the include directive was available in define.yaml."
},
{
"commit": "1214f1d70b5a34bd648892519777c6bd3b33619d",
"date": "2020-04-03 08:18:07 -0400",
"subject": "Update RHEL package location.",
"body": "This changed upstream so update the file paths."
},
{
"commit": "713211d89fd341e5b39b5273c4cb0cea495c245d",
"date": "2020-04-02 17:25:49 -0400",
"subject": "Clean up const usage in bufPtr() and bufRemainsPtr().",
"body": "These functions accepted const Buffer objects and returned non-const pointers which is definitely not a good idea. Add bufPtrConst() to handle cases where only a const return value is needed and update call sites.\n\nUse UNCONSTIFY() in cases where library code out of our control requires a non-const pointer. This includes the already-documented exception in command/backup/pageChecksum and input buffers in the gzCompress and gzDecompress filters."
},
{
"commit": "76b88a3cd58cb69ba8660247ed0959707c12401c",
"date": "2020-04-02 16:58:38 -0400",
"subject": "Add UNCONSTIFY() macro.",
"body": "Allows casting const-ness away from an expression, but doesn't allow changing the type. Enforcement of the latter currently only works for gcc-like compilers.\n\nNote that it is not safe to cast const-ness away if the result will ever be modified (it would be undefined behavior). Doing so can cause compiler mis-optimizations or runtime crashes (by modifying read-only memory). It is only safe to use when the result will not be modified, but API design or language restrictions prevent you from declaring that (e.g. because a function returns both const and non-const variables).\n\nNote that this only works in function scope, not for global variables (it would be nice, but not trivial, to improve that).\n\nUNCONSTIFY() requires static assert which is a feature in its own right."
},
{
"commit": "78beb16d6f30b2de561b391579c30b2811a94cd3",
"date": "2020-04-01 19:33:11 -0400",
"subject": "Remove unused getters in common/io/write module.",
"body": "These were probably added for symmetry with IoRead but we would prefer to remove those getters.\n\nSo, just remove the equivalents in IoWrite."
},
{
"commit": "f19c59ab38452bd4d247aa3a073c5c525b3b3cbe",
"date": "2020-04-01 18:03:16 -0400",
"subject": "Remove unused exports from pgBackRestBuild::Config::Data.",
"body": "These were once used heavily in the Perl code but now only a few of them are used in the documentation.\n\nRemove the unused exports as there is generally no need create them for new commands/options."
},
{
"commit": "3aedcd17760e677058e679ffaa7500ce57e42805",
"date": "2020-04-01 17:20:47 -0400",
"subject": "Enable FD_CLOEXEC.",
"body": "PostgreSQL enables this option when available which seems like a good idea since we also do not share connections between processes.\n\nNote that as in PostgreSQL there is no way to disable this option."
},
{
"commit": "967f2c0d7f56702059f433c248c1d2640dc26fde",
"date": "2020-04-01 16:56:15 -0400",
"subject": "Enable TCP_NODELAY.",
"body": "PostgreSQL enables this option when available which seems like a good idea since we also buffer transmissions.\n\nNote that as in PostgreSQL there is no way to disable this option."
},
{
"commit": "a1a0a23c6a086bb9f95ebdd280cca4c4f7ce683d",
"date": "2020-04-01 16:51:29 -0400",
"subject": "Fix typo."
},
{
"commit": "789e364e6b35260a5805f1643761cd7f24b2bfdc",
"date": "2020-04-01 15:44:51 -0400",
"subject": "Rename tcp-keep-alive option to sck-keep-alive.",
"body": "This is really a socket option so the new name is clearer.\n\nSince common/io/socket/tcp will contains a mix of options it makes sense to rename it to socket and cascade name changes as needed."
},
{
"commit": "5c6fb88bef242c071fd02671798b296bd65fa47f",
"date": "2020-03-31 18:13:11 -0400",
"subject": "TCP keep-alive options are configurable.",
"body": "Prior to 2.25 the individual TCP keep-alive options were not being configured due to a missing header. In 2.25 they were being configured incorrectly due to a disconnect between the timeout specified in ms and what was expected by the TCP options, i.e. seconds.\n\nInstead make the TCP keep-alive options directly configurable, with correct units and better testing. Keep-alive is enabled by default (though it can be defaulted to the system setting instead) and the rest of the options are not set by default. This is in line with what PostgreSQL does, though PostgreSQL does not allow keep-alive to be defaulted.\n\nAlso move configuration of TCP options before connect() as PostgreSQL does."
},
{
"commit": "8989118cc656eeb3458404a4a9beff059c0c984c",
"date": "2020-03-31 12:43:29 -0400",
"subject": "Add SocketClient object.",
"body": "This functionality was embedded into TlsClient but that was starting to get unwieldy.\n\nAdd SocketClient to contain all socket-related client functionality."
},
{
"commit": "abb76398079fdfb7842bbd1f83fe46e33a5121b5",
"date": "2020-03-31 11:10:26 -0400",
"subject": "Add OBJECT_DEFINE_GET() macro to define object getters.",
"body": "Simple object getters involve a lot of boilerplate code so create a macro to simplify implementing them."
},
{
"commit": "da43db354343d629029fd78ceefecaa57bf58c73",
"date": "2020-03-30 20:52:57 -0400",
"subject": "Move common/object.h to common/type/object.h.",
"body": "This header does not contain a type but is used to define types so this seems like a better location."
},
{
"commit": "a29e25a845bed5d3b635766dd3ea7ca6a793ac47",
"date": "2020-03-29 21:25:48 -0400",
"subject": "Add storage filter performance test.",
"body": "This test allows the important storage filters to be benchmarked by MiB/s."
},
{
"commit": "1e0b0c9344c3cdb7e11ff67820a681bba1c1c05d",
"date": "2020-03-29 09:17:39 -0400",
"subject": "Remove Debian package patch now that it has been merged upstream."
},
{
"commit": "bf7b989103d6804362b4fb0994b96f13f5cc0dd8",
"date": "2020-03-28 18:25:51 -0400",
"subject": "Add time since last test started to test output.",
"body": "This makes it easier to see the timing of each step in the test."
},
{
"commit": "7e519e72d516dc03f60c25252928a24de8cc6e58",
"date": "2020-03-28 18:20:29 -0400",
"subject": "Add TEST_TITLE_FMT() macro."
},
{
"commit": "e1c72f6f97e9020874e1f31c97d1e1ff7269104d",
"date": "2020-03-28 17:48:57 -0400",
"subject": "Fix typos."
},
{
"commit": "af734d69f4fc32502ae9b5baa7ba2ee244d0462c",
"date": "2020-03-27 08:22:58 -0400",
"subject": "Restore prefix/exec_prefix Makefile variables removed in 237a3da4."
},
{
"commit": "4b1d995bbacac8baebd8a71045d87a2126ad851b",
"date": "2020-03-26 22:20:09 -0400",
"subject": "Update packages required for each CI job.",
"body": "Documentation builds and tests have only a few packages in common so rearrange packages to save some time and clarify dependencies.\n\nRemove the libperl-dev package which became obsolete when the LibC module was removed in 79cfd3ae.\n\nAdd a few comments for good measure."
},
{
"commit": "65285ff5b28f81a5e223337f93fe127d2eed2872",
"date": "2020-03-26 22:00:40 -0400",
"subject": "Rearrange Travis CI jobs based on current runtimes.",
"body": "The runtimes of the tests have change with recent updates and it is generally best to order the slowest tests first."
},
{
"commit": "0f742204e84c1a9529085fcfad61318e1c1a1842",
"date": "2020-03-26 21:39:40 -0400",
"subject": "Add comments to make the purpose of each CI job clearer."
},
{
"commit": "09d26d54ceb42a1f14de4ed59541f602b7c99ee6",
"date": "2020-03-26 21:16:21 -0400",
"subject": "Updates for key changes in travis.yaml.",
"body": "The format has evolved over time and the old keys were showing warnings during builds."
},
{
"commit": "3d255dce3c83fe0de49ab5a5ff3d71151e0761b3",
"date": "2020-03-26 21:05:36 -0400",
"subject": "Add performance/storage test.",
"body": "The primary purpose of this test (currently) is to measure the performance of storageRemoteInfoList(), which is critical for building a manifest when the PostgreSQL host is remote.\n\nThe starting baseline of 1 million files is perhaps a bit aggressive but it seems very likely to blow up if there are performance regressions."
},
{
"commit": "b64755d6352c9e3e4ac2508b47e2a223f755afe5",
"date": "2020-03-26 20:52:05 -0400",
"subject": "Increase baseline of the performance/type test.",
"body": "Recent performance improvements allow increasing the baseline of this test.\n\nIn general it is best if the baseline is large enough to cause the test to blow up if there are performance regressions."
},
{
"commit": "50cf7370ee171053225a5d4511fd186da2c4c61e",
"date": "2020-03-26 20:36:09 -0400",
"subject": "Add --no-performance to test.pl to suppress performance tests.",
"body": "Performance tests do not need to be run on all platforms. Using vm=none to run performance tests seems best ... for performance."
},
{
"commit": "24e03e1320fcc19059599c136de293183cb77f43",
"date": "2020-03-26 20:25:42 -0400",
"subject": "Remove RHEL package patch now that it has been merged upstream."
},
{
"commit": "fa8642237146bc1b79fd57271219e0e9aa07882e",
"date": "2020-03-26 17:20:58 -0400",
"subject": "Begin v2.26 development."
},
{
"commit": "fd3dca036b1436564dec17b7c23b62b9d9fa1051",
"date": "2020-03-26 17:14:53 -0400",
"subject": "v2.25: LZ4 Compression Support"
},
{
"commit": "8af0462c5d749ca798bc524e7a05d0e24f4ed0c7",
"date": "2020-03-26 15:30:59 -0400",
"subject": "Fix race condition in real/all integration tests.",
"body": "If the tests are running quickly then the time target might end up the same as the end time of the prior full backup. That means restore auto-select will not pick it as a candidate and restore the last backup instead causing the restore compare to fail.\n\nSo, sleep one second."
},
{
"commit": "86f71349efdc5970b9985c0155a65c2e3b193a04",
"date": "2020-03-26 14:05:40 -0400",
"subject": "Improve and centralize backup dependency calculation.",
"body": "Add functions to select a current backup by label and to retrieve a backup dependency list for any given backup.\n\nUpdate the expire code to utilize the new functions and to expire backup sets from newest dependency to oldest."
},
{
"commit": "048a36ea390334ddc019e958242c4d4ca0f9096f",
"date": "2020-03-26 13:04:59 -0400",
"subject": "Order commands alphabetically in definition of set option."
},
{
"commit": "2c2bc8a32ba6e91e2a0241cc2d93d9809ab6c068",
"date": "2020-03-26 12:16:22 -0400",
"subject": "Debug and optimize flag cleanup for unit tests.",
"body": "Decisions about when to optimize or enable debug code were spread out in too many places making it hard to keep them consistent.\n\nCentralize the logic as much as possible to make it easier to maintain."
},
{
"commit": "e63fdfbfd24bb1893ed5c0abb9aed72d2a230d56",
"date": "2020-03-26 11:16:35 -0400",
"subject": "Debug and optimize flag cleanup for unit tests.",
"body": "Decisions about when to optimize or enable debug code were spread out in too many places making it hard to keep them consistent.\n\nCentralize the logic as much as possible to make it easier to maintain."
},
{
"commit": "d242114dc0feec9e87932e810ec3c1027752949b",
"date": "2020-03-25 19:00:09 -0400",
"subject": "Rough script to add tables to the user guide for performance tests.",
"body": "This really needs to be worked on but for now at least preserve to code to be improved later."
},
{
"commit": "10b4b9af8712c558ad1d3d1674dd494716fa1cb9",
"date": "2020-03-25 18:52:20 -0400",
"subject": "Improve performance of jsonToStrInternal() and jsonFromStrInternal().",
"body": "Most strings do not contain escape/d characters, so optimize the path where the string contains few or no escape/d characters.\n\nThis means far fewer calls to strCatChr() in favor of strCatZN(), which is much more efficient."
},
{
"commit": "88d7ee621547b28113af9c00712267642729b7ec",
"date": "2020-03-25 18:37:35 -0400",
"subject": "Add srtCatZN().",
"body": "Append N characters from a zero-terminated string.\n\nNote that the string does not actually need to be zero-terminated as long as N is <= the end of the string being concatenated."
},
{
"commit": "b10270eee87ebaa1c595d0ba486a61fefabd8d6d",
"date": "2020-03-25 16:03:33 -0400",
"subject": "Use conditional in strPtr() to encourage inlining.",
"body": "This construct is logically equivalent but it seems to make the compiler more likely to inline the function, probably because the compiled code is slightly smaller."
},
{
"commit": "eb7f7dd5caf9f48368b6c24b401f9094ad85a95e",
"date": "2020-03-25 15:47:03 -0400",
"subject": "Fix backup-prior for diff backups in mock/expire integration test.",
"body": "In the ExpireEnvTest.pm backupCreate() function, backup-prior was incorrectly set for diff backups to the previous backup regardless of what backup type the previous backup was. This did not cause any issues in the Mock Expire tests before because it was not being checked. However, in order to reduce churn in the expect logs for a new feature where the backup-prior is utilized, this is being fixed so that the full backup is always used as backup-prior."
},
{
"commit": "4c31a922a3b258b075c095b92d637eb2d367d7f2",
"date": "2020-03-25 12:17:20 -0400",
"subject": "Remove backup after timeline switch from user guide.",
"body": "It is no longer necessary (since 2.07, 34c63276) to do a backup manually after a timeline switch."
},
{
"commit": "480a11066db83ecb57d2ca3f23924a93d8590b5e",
"date": "2020-03-25 12:04:23 -0400",
"subject": "More refactoring of command/expire unit test module.",
"body": "Buffer cleanup following on from e170c53e."
},
{
"commit": "d20115d29e0b33062fce5dfc8285c0f884ef4246",
"date": "2020-03-25 09:12:51 -0400",
"subject": "Allocate a minimum amount of space when a string is likely to grow.",
"body": "This helps prevent excessive memory reallocation."
},
{
"commit": "ad4187eb9f5ff3cfca20537dd6d998d1afa4a96b",
"date": "2020-03-24 19:08:00 -0400",
"subject": "Improve performance of memResize().",
"body": "The major bottleneck was finding the memory allocation to be resized since it required a sequential search through a list.\n\nInstead, put the allocation header at the beginning of the allocation and return an offset to the user for their buffer. This allows us to use pointer arithmetic to get back to the allocation header quickly when resizing. A side effect is to make memFree() faster as well. The downside is we won't detect garbage pointers passed to memResize()/memFree(), which is also true for MemContext pointers.\n\nThe performance benefits can be pretty large in certain cases, in particular when loading and saving manifests. The following are the before and after performance tests on a 900K file manifest.\n\nBefore:\n\nrun 003 - manifestNewLoad()/manifestSave()\n 000.000s l0125 - generate manifest\n 183.411s l0236 - 101.2MB manifest generated with 900000 files\n 183.411s l0239 - load manifest\n 403.816s l0243 - completed in 220405ms\n 403.816s l0245 - check file total\n 403.816s l0248 - save manifest\n 670.217s l0253 - completed in 266401ms\n 670.217s l0256 - find all files\n 671.263s l0266 - completed in 1046ms\n\nAfter:\n\nrun 003 - manifestNewLoad()/manifestSave()\n 000.000s l0125 - generate manifest\n 007.730s l0236 - 101.2MB manifest generated with 900000 files\n 007.730s l0239 - load manifest\n 033.431s l0243 - completed in 25701ms\n 033.431s l0245 - check file total\n 033.431s l0248 - save manifest\n 057.755s l0253 - completed in 24324ms\n 057.755s l0256 - find all files\n 058.689s l0266 - completed in 934ms"
},
{
"commit": "98e5affa8aa1b1f7076e2d389d3afdf71dd80644",
"date": "2020-03-24 18:44:13 -0400",
"subject": "Free temp mem context periodically in storageRemoteInfoList().",
"body": "Other storage*InfoList() functions do this but it was missed here.\n\nmemResize()/memFree() operations become more expensive as the mem context grows larger so freeing it periodically saves processing time."
},
{
"commit": "e170c53e7efb84dc65e3a0c0b8e4ed3c060030d8",
"date": "2020-03-23 14:31:04 -0400",
"subject": "Refactor command/expire unit test module.",
"body": "Add titles and use a Buffer to store backup.info instead of a String."
},
{
"commit": "f9c86b11a54e5c37ad98afd5a2de76cd96ae1061",
"date": "2020-03-23 12:17:34 -0400",
"subject": "More improvements to custom coverage report.",
"body": "* Fix a few issues with file names being truncated introduced in 787d3fd6.\n\n* Use function line info from the lcov file to calculate which lines to show for uncovered functions. This is more accurate than what we were doing before and function comment headers are now excluded which reduces clutter in the report."
},
{
"commit": "dbb1248bfbb1d469bae030084e6672772702f89d",
"date": "2020-03-22 20:44:51 -0400",
"subject": "Implement TEST_RESULT_*() macros with functions, mostly.",
"body": "The prior macros had grown over time to be pretty significant pieces of code that required a lot of compile time, though runtime was efficient.\n\nMove most of the macro code into functions to reduce compile time, perhaps at a slight expense to runtime. The overall performance benefit is 10-15% so this seems like a good tradeoff.\n\nAdd TEST_RESULT_UINT_INT() to safely compare uint to int with range checking."
},
{
"commit": "d6ffa9ea6d45fcae46abd79a5f6d6123e79c9168",
"date": "2020-03-22 20:25:31 -0400",
"subject": "Fix incorrect result types in unit tests.",
"body": "Upcoming changes to the TEST_RESULT_* macros are more type safe and identified that the wrong macros were being used to test results in many cases.\n\nCommit these changes separately to verify that they work with the current macro versions.\n\nNote that no core bugs were exposed by these changes."
},
{
"commit": "e1da6a45e0e7f5223ac5210b2485f7946421a723",
"date": "2020-03-22 16:14:33 -0400",
"subject": "Remove TRY...CATCH blocks from TEST_RESULT*() macros.",
"body": "TRY...CATCH blocks are fairly expensive and when all the TEST_RESULT*() macros succeed they are not needed.\n\nInstead just record info at the start of the result test so a detailed exception can be thrown in test.c in the rare case where an exception occurs."
},
{
"commit": "5a8758cc8a49b88f731bb33d81579115cb1ea3c3",
"date": "2020-03-22 16:04:24 -0400",
"subject": "Add test function to set stack trace function line number.",
"body": "This is helpful for test macros that know the line number.\n\nThe line number can now be non-zero below the top of the stack without WITH_BACKTRACE so instead ignore the line number for output when it is zero."
},
{
"commit": "bd461a18997dd38443004eb962e37d348bcef03a",
"date": "2020-03-22 14:40:36 -0400",
"subject": "Add TestError for testing.",
"body": "This error type distinguishes test errors with detailed debug info from normal errors which may need, for example, a stack trace to be added for context."
},
{
"commit": "c2df383aec3960fcc8046f93089114de8043cb14",
"date": "2020-03-22 14:24:28 -0400",
"subject": "Fix missing parameter in common/stack-trace test module.",
"body": "This was passing since we don't test WITH_BACKTRACE in CI because it is used only for test builds.\n\nIdeally we would test this but it doesn't seem worth the trouble at the moment."
},
{
"commit": "8c76ea2d93926cb3c714490884fb42966a859cf2",
"date": "2020-03-22 14:18:16 -0400",
"subject": "Fix space lost in d70ca259."
},
{
"commit": "4c831d8e83f4ffda02023351c17cb3072b5b6e10",
"date": "2020-03-22 13:50:31 -0400",
"subject": "Use --clean-only for reproducible builds in contributing documentation.",
"body": "If the work or result directories already contain data then the docs might be generated slightly differently. Doing a clean ensures they will always produce the same output (provided the code does not change)."
},
{
"commit": "06a3f82e912b549add76b65f51075bc389f4e29c",
"date": "2020-03-22 13:46:30 -0400",
"subject": "Add --clean and --clean-only options to test.pl."
},
{
"commit": "d70ca2592f7df7d9a0adc2b91fd03c8cafc757b0",
"date": "2020-03-22 10:17:03 -0400",
"subject": "Suppress timestamps in contributing documentation.",
"body": "Timestamps cause a lot of churn and make it hard to tell if important changes are working."
},
{
"commit": "3ec630f5b2008af92d1baab36afda4d20b8329a8",
"date": "2020-03-22 10:12:29 -0400",
"subject": "Allow suppression of times in testing for reproducibility.",
"body": "Timestamps, timings, etc. cause a lot of log churn when included in documentation."
},
{
"commit": "a1802510111297b479c6150631df92bc6b065613",
"date": "2020-03-22 09:59:38 -0400",
"subject": "Do variable replacements for cmd-extra in documentation."
},
{
"commit": "6a9fbccf7603bc1ae9626ff387013933271a1c05",
"date": "2020-03-21 19:08:27 -0400",
"subject": "Remove custom lcov build from contributing documentation.",
"body": "Using the stock lcov no longer seems to be a problem, probably due to a better implementation in CoverageTest.pm."
},
{
"commit": "56fb39937368463474c96307454051a66c1742c4",
"date": "2020-03-21 18:45:58 -0400",
"subject": "Build contributing documentation on Travis CI.",
"body": "Building the contributing document has some special requirements because it runs Docker in Docker so the repo path must align on the host and all Docker containers. Run `pgbackrest/doc/doc.pl` from within the home directory of the user that will do the doc build, e.g. `home/vagrant`. If the repo is not located directly in the home directory, e.g. `/home/vagrant/pgbackrest`, then a symlink may be used, e.g. `ln -s /path/to/repo /home/vagrant/pgbackrest`.\n\nMount the repo in the Vagrantfile at /home/vagrant/pgbackrest but provide a link from the old location at /backrest to make the transition less painful."
},
{
"commit": "ee2e15bf5524cf8bac3454d409dee250792411d9",
"date": "2020-03-21 09:51:12 -0400",
"subject": "Add missing package to contributing documentation."
},
{
"commit": "f405c82dcc99da8e8da2fc19b8e13f2dd9b542d2",
"date": "2020-03-20 15:00:20 -0400",
"subject": "Don't list directories as changed from the last run.",
"body": "It's not very useful information and just clutters the list."
},
{
"commit": "cfab67a775e0e1eb80e15df2fb5b1acc4d911432",
"date": "2020-03-20 13:49:23 -0400",
"subject": "Enable coverage testing on Fedora 30.",
"body": "Now that coverage testing works reliably with gcc9 it makes sense to enable it for CI."
},
{
"commit": "782c9f89f47fcb8bac75b21c241c1f34d744c13c",
"date": "2020-03-20 13:43:08 -0400",
"subject": "Remove old coverage data before starting new test.",
"body": "The old coverage data has been recorded so it is no longer needed. In newer versions of gcc leaving this file around can lead to an error when writing profile data after forking off to a non-pgbackrest binary (which we do in some unit tests)."
},
{
"commit": "787d3fd67b3549b9b04a8053e751cda9494d8df5",
"date": "2020-03-20 12:54:29 -0400",
"subject": "Improve custom coverage report.",
"body": "* Show all uncovered branch parts even when there are more than two parts per branch. This is the way gcc9 reports coverage so it needs to work even if it doesn't make as much sense as the old way.\n\n* Show covered branches in functions where coverage is missing. Showing just the uncovered branches can be confusing because it's not always clear how the coverage relates to the code. By showing all branch coverage (+ or -) this correspondence is made easier."
},
{
"commit": "8af802900657174e1b24a1bdf9992c9fa78909d9",
"date": "2020-03-20 09:16:38 -0400",
"subject": "Fix lcov report when test module missing coverage.",
"body": "We don't report branch coverage on test modules (e.g. test/src/module/common/errorTest.c) but the code that excluded branch coverage from the test module would also exclude it from all core modules if the test module was included in the lcov report due to lack of function/line coverage.\n\nAdjust the coverage code to only exclude branches during the extraction of test module coverage."
},
{
"commit": "f6e9bb081963932b4a35e6fd6c01ac2a523195f1",
"date": "2020-03-19 19:30:09 -0400",
"subject": "Remove obsolete -O2 option for Fedora 30 unit test builds.",
"body": "For some reason gcc9 would not do -O0 builds in combination with one of the options that libperl required. Now that libperl is gone this exception is no longer required."
},
{
"commit": "2241524c0bdc92e1a04ac18e91a188a2bc1bcbdf",
"date": "2020-03-19 18:34:10 -0400",
"subject": "Remove obsolete deletes from Vagrantfile.",
"body": "pgBackRest no longer writes files into the .vagrant path so there's no longer anything to delete."
},
{
"commit": "dcddf3a58bc6c4a8fbc9ac2c000cd5ff7b669cb5",
"date": "2020-03-19 13:16:05 -0400",
"subject": "Limit backup file copy size to size reported at backup start.",
"body": "If a file grows during the backup it will be reconstructed by WAL replay during recovery so there is no need to copy the additional data.\n\nThis also reduces the likelihood of seeing torn pages during the copy. Torn pages can still occur in the middle of the file, though, so they must be handled."
},
{
"commit": "e5bcc0c47e9db98ff99366a1e5806c1dcd6ebadd",
"date": "2020-03-19 12:34:27 -0400",
"subject": "Clarifications of what limit == NULL or UINT64_MAX means."
},
{
"commit": "73315268fd9d405eee7da019014e8117c6a20693",
"date": "2020-03-19 12:11:20 -0400",
"subject": "Fix typo."
},
{
"commit": "d677b0708126302e3b01e24664866b29913b1c1d",
"date": "2020-03-19 12:07:51 -0400",
"subject": "Move coverage code to CoverageTest module.",
"body": "This code needs some work, which will be easier if it is all in one place."
},
{
"commit": "f538da0571e9e6b224b208fa5f2b3bc3025f5f02",
"date": "2020-03-18 17:30:36 -0400",
"subject": "Updates to contributing documentation."
},
{
"commit": "26c89b2c8c9ea362b9bd075cc4d541dc515af28b",
"date": "2020-03-18 13:40:16 -0400",
"subject": "Improve testing of files that change size during the backup.",
"body": "Files can change size during a backup so update and add tests to cover the various scenarios more thoroughly."
},
{
"commit": "4ec04e5163a361f88e3f2e09bdc22465a0868982",
"date": "2020-03-18 10:10:10 -0400",
"subject": "Added redacted manifest to testBackupValidate().",
"body": "The manifest is excellent for validation but including the entire manifest is too noisy and some values are architecture/algorithm dependent.\n\nOutput a redacted version that contains the most important information which can be improved on over time."
},
{
"commit": "b8cd1b6790b85f3ac36ae3fcb024be3997ac6ad1",
"date": "2020-03-18 10:05:08 -0400",
"subject": "Add TEST_RESULT_STR_Z_KEYRPL() test macro.",
"body": "This macro will automatically do key replacement before the comparison. This saves the indentation required for an embedded function call.\n\nPossibly TEST_RESULT_Z_KEYRPL() would also be useful but it will be added when needed."
},
{
"commit": "f2548f45ce4c1e444e9d3175b2349e0a97b2783a",
"date": "2020-03-17 18:16:17 -0400",
"subject": "Allow storage reads to be limited by bytes.",
"body": "The current use case is reading files from the PostgreSQL cluster during backup.\n\nA file may grow during backup but we only need to copy the number of bytes that were reported during the manifest build. The rest will be rebuilt from the WAL during recovery so copying more is just a waste of space.\n\nLimiting the copy sizes in backup will be part of a future commit."
},
{
"commit": "307e741298cd068e68bcbe8994c871a989bdff01",
"date": "2020-03-17 16:01:17 -0400",
"subject": "Test that shrunk file is backed up correctly.",
"body": "It's possible, though rare, for a file to shrink during a backup.\n\nThere was no issue with the code but having a test is always a good idea."
},
{
"commit": "7f1817c8adea02e58af3ae82044e8e91e6f2c4f4",
"date": "2020-03-17 11:43:38 -0400",
"subject": "Fix typos."
},
{
"commit": "9a47b88da3effe24b835908c12ce5dd5abf2304d",
"date": "2020-03-16 20:02:36 -0400",
"subject": "Add links to custom coverage report.",
"body": "When multiple files were missing coverage it could be hard to locate the coverage report for a specific file.\n\nAdd links for uncovered files to make this easier.\n\nAlso move table titles out of the table so they are valid html."
},
{
"commit": "d6cea422a01b6645d78aebe0e547d4fd1688001b",
"date": "2020-03-16 18:18:30 -0400",
"subject": "Make cfgLoadLogSetting() static.",
"body": "This function was once required by the test harness."
},
{
"commit": "f7dac144a6393736e16f44d4103ec4d4ff6133dc",
"date": "2020-03-16 18:16:27 -0400",
"subject": "Reduce variables extern'd by the common/log module in debug builds.",
"body": "These days it is better to include the module in define.yaml when we need to poke at the internal implementation.\n\nThis doesn't quite work for the log test harness, so for now some variables will need to remain extern'd in debug builds."
},
{
"commit": "3fbfcba811499a59b943dd893eef9ff52090f7b6",
"date": "2020-03-16 17:27:01 -0400",
"subject": "Forbid access to /tmp/pgbackrest in the Vagrantfile.",
"body": "This matches the error that will be thrown in the vm=none test on Travis CI if a unit test writes to /tmp/pgbackrest."
},
{
"commit": "46911c64c19dc8ff76d2a6ff4548fc01647043e0",
"date": "2020-03-16 17:24:21 -0400",
"subject": "Make storage and logging dry-run aware.",
"body": "Enhance dry-run support added in 2fa69af8 by forbidding writes in the storage layer and adding prefixes to log messages.\n\nThe former will protect against mistakes in dry-run implementations and the latter will make it clear when a command was executed in dry-run mode.\n\nUpdate expire unit tests with the new log prefix."
},
{
"commit": "2fa69af8da4075e82359a8585ecde2f2030db546",
"date": "2020-03-16 13:56:52 -0400",
"subject": "Add --dry-run option to the expire command.",
"body": "Use dry-run to see which backups/archive would be removed by the expire command without actually removing anything."
},
{
"commit": "4608ca473e6d8c92762eee08169b50072bec0821",
"date": "2020-03-16 12:50:37 -0400",
"subject": "Fix indentation."
},
{
"commit": "4328bc1ac64726e810dfa76d0d1149ded6c93770",
"date": "2020-03-16 08:41:32 -0400",
"subject": "Move raw coverage results to test/result/raw path.",
"body": "These results were stored in the vagrant path along with a full copy of src.\n\nInstead store the raw coverage data in test/result/raw and change source references to the files that already exist in [test-path]/repo."
},
{
"commit": "d7022495075682b35441a31e22606bdcffdb9b86",
"date": "2020-03-15 10:09:27 -0400",
"subject": "Build binaries in the test path rather than the vagrant path.",
"body": "It makes more sense to build in the test path since many developers won't have a vagrant path. Anyway, it's better not to modify the vagrant path since it belongs to vagrant.\n\nInstead of installing the binary just mount it into the container from where it was built. This saves a bit of time and space."
},
{
"commit": "19d975346b2688aa1a7b9e2dc68baecb9f6e7af2",
"date": "2020-03-15 09:59:22 -0400",
"subject": "Improve stability of command/check test module.",
"body": "When pgbackrest was present this test behaved unexpectedly.\n\nWhile the binary is not currently required for this test is might be in the future so fix the test to prevent a regression."
},
{
"commit": "da89d0ad6157487f820632cbc7109c8a91f56cc9",
"date": "2020-03-15 09:53:42 -0400",
"subject": "Add VPATH to Makefile.",
"body": "This allows builds in a separate directory without copying the source."
},
{
"commit": "959dce569b150cf221f2f38a3c4f438964ca324e",
"date": "2020-03-14 18:30:24 -0400",
"subject": "Update code classification and remove XS definition."
},
{
"commit": "213cc6e8becd9974351cb28d08bef01184bf6ad3",
"date": "2020-03-14 15:40:37 -0400",
"subject": "Move docker files to test/result."
},
{
"commit": "6827e248cd3ce9b92ef4bbddb79dfe0b32c1a6ef",
"date": "2020-03-14 15:29:42 -0400",
"subject": "Move coverage results to test/result."
},
{
"commit": "75ff25f17fda6e3198aa8e227bc535dc5d8fb969",
"date": "2020-03-14 14:50:36 -0400",
"subject": "Move profile results to test/result."
},
{
"commit": "0f7fe55f728345426da2514e2c866678921114a6",
"date": "2020-03-14 14:35:09 -0400",
"subject": "Build packages on demand only and change build path.",
"body": "Building packages is not a normal part of development so don't build packages by default. Instead build them in CI as needed.\n\nDo the builds in test/result instead of .vagrant to be friendlier with hosts that are not running vagrant. Anyway, it's probably not a good idea to be creating files in the .vagrant path."
},
{
"commit": "5645c91ed5cb48f0dbcb92439405dcefe7d1156a",
"date": "2020-03-14 14:18:22 -0400",
"subject": "Add comments to test/.gitignore."
},
{
"commit": "b4c94e42b903059c044128710ef9e61ff5f1aa67",
"date": "2020-03-14 13:06:21 -0400",
"subject": "Auto-detect presence of clobbered warning.",
"body": "Not all compilers (e.g. clang) support this warning so only disable it (i.e. -Wno-clobbered) when supported."
},
{
"commit": "4cd060b7fe6e2f9cc7ca8f8c128d1b5c1de9c137",
"date": "2020-03-14 12:48:08 -0400",
"subject": "Generate src/build/aclocal.m4 automatically.",
"body": "This file is required when macros from the autoconf archive are used in configure.ac"
},
{
"commit": "9e80c5710e8e8005dee553b4583dc062dfc3ca62",
"date": "2020-03-14 12:39:29 -0400",
"subject": "Use a checksum to build configure.ac more efficiently.",
"body": "Building the configure.ac script can take multiple seconds depending on the state of the autoconf cache. Use a checksum to only rebuild when configure.ac has changed no matter how the timestamps have changed."
},
{
"commit": "748f9502eb06b1315551b5967eb5c6255fe9e072",
"date": "2020-03-14 10:04:49 -0400",
"subject": "Remove obsolete ignore."
},
{
"commit": "237a3da4d69bf068652c6f5cc805c313f725b129",
"date": "2020-03-13 09:07:57 -0400",
"subject": "Configure and make improvements.",
"body": "Configure:\n\n* Use standard make variables, e.g. CFLAGS, rather than our own, e.g. CINCLUDE\n* Add PG_CONFIG var for configuring custom pg_config location\n* Don't error if xml_config or pg_config is missing (but error if libs/headers not found)\n* Check for zlib.h header\n* Check for lz4frame.h header when liblz4 is present\n\nMake:\n\n* Use gcc-style auto dependencies\n* Put src list at the top since it is most frequently modified\n* Add clean-all target to also remove auto-generated config files"
},
{
"commit": "810b2a5265888a7ba46c85cee52ca7b7b269608d",
"date": "2020-03-12 13:18:08 -0400",
"subject": "Remove obsolete ignore."
},
{
"commit": "4b24a74afb5c3ed1f176287070a3b1f58fa4b479",
"date": "2020-03-12 11:38:50 -0400",
"subject": "Fix detection of keepalive options on Linux.",
"body": "This code stanza was not being included on Linux platforms because of a missing header file.\n\nAlso update the order of operations and make the timeout calculations more sensible."
},
{
"commit": "e9c1569d8e2b55762784b8c74c1092b4ad3cadf9",
"date": "2020-03-12 10:48:40 -0400",
"subject": "Fix missing cast.",
"body": "This was a problem in testing when -Wconversion was enabled and TCP_KEEPIDLE was defined."
},
{
"commit": "d6ef6c57c336d56561ce84e63a75880e293e0b8f",
"date": "2020-03-12 10:37:19 -0400",
"subject": "Add configure host detection to set standards flags correctly.",
"body": "Linux and MacOS were tolerant of having all standards flags set but BSD was not.\n\nInstead detect the host type and set standards flags as appropriate."
},
{
"commit": "fa1f63198d7af2ae7c3a7d26af972f81de15d215",
"date": "2020-03-12 10:03:57 -0400",
"subject": "Add scripts required for host detection by src/configure.",
"body": "Add to the src/build directory so they will be out of the way.\n\nAlso add instructions for updating the scripts to RELEASE.md."
},
{
"commit": "c3b6bd2e831c4f29fdfb69d36fe6d21da1a322be",
"date": "2020-03-12 09:50:10 -0400",
"subject": "Add separators to make configure.ac easier to read."
},
{
"commit": "ccdf4bf3ccb091a1371646f65583a77105c43e0d",
"date": "2020-03-12 09:43:29 -0400",
"subject": "Add repo path env var to make release commands easier to run."
},
{
"commit": "838ef4eca1a1fa2c791fa4913a3cae803eb4c8a8",
"date": "2020-03-12 09:34:52 -0400",
"subject": "Move configure.ac to src/build.",
"body": "This file is used to generate src/configure and is not required to make pgbackrest since src/configure is updated before distribution.\n\nMove to src/build so it is out of the way."
},
{
"commit": "79a6798f39124db044f0af5091027ecb255ba033",
"date": "2020-03-12 09:28:59 -0400",
"subject": "Remove extra spaces."
},
{
"commit": "2ac9c19d4a2a3e75373b97ab2360f11469998448",
"date": "2020-03-12 09:28:16 -0400",
"subject": "Fix misleading comment."
},
{
"commit": "181fa1fc8bbc4af06e1ff491b165b3b0e78cdfd6",
"date": "2020-03-12 09:27:44 -0400",
"subject": "Detect changes in reference.xml for code auto-generation.",
"body": "Changes to reference.xml can affect the command-line documentation built into the binary so changes must trigger an auto-generated code build during smart builds."
},
{
"commit": "0ba8062f5f04e22edb5700be3d8eb26255ea68d4",
"date": "2020-03-12 08:48:45 -0400",
"subject": "Get package source files dynamically during package build.",
"body": "The prior method was to build a special container to hold these files which meant they would get stale on development systems. On CI the container was always rebuilt so failures would be seen there even when dev seemed to be working.\n\nInstead get the package source when the package is built to ensure it is as up-to-date as possible.\n\nThis change was prompted by failures on the Ubuntu 12.04 container while getting the package source, probably due to an ancient version of git. Package builds are no longer supported on that platform with the addition of lz4 compression so it didn't seem worth fixing."
},
{
"commit": "4a5bd002c0071960b537e6d1dc35efe626146956",
"date": "2020-03-10 17:57:02 -0400",
"subject": "Move pgBackRest::Version module to pgBackRestDoc::ProjectInfo.",
"body": "The primary source for project info is now src/version.h.\n\nThe pgBackRestDoc::ProjectInfo module loads the project info from src/version.h at runtime so there is no need to update it."
},
{
"commit": "731b862e6faf266c7ddbbd01a85496147d8bf7a6",
"date": "2020-03-10 15:41:56 -0400",
"subject": "Rename BackRestDoc Perl module to pgBackRestDoc.",
"body": "This is consistent with the way BackRest and BackRest test were renamed way back in 18fd2523.\n\nMore modules will be moving to pgBackRestDoc soon so renaming now reduces churn later."
},
{
"commit": "36d4ab9bff668efcbbbf3393d80bd53f0be09a67",
"date": "2020-03-10 15:12:44 -0400",
"subject": "Move Perl modules out of lib directory.",
"body": "This directory was once the home of the production Perl code but since f0ef73db this is no longer true.\n\nMove the modules to test in most cases, except where the module is expected to be useful for the doc engine beyond the expected lifetime of the Perl test code (about a year if all goes well).\n\nThe exception is pgBackRest::Version which requires more work to migrate since it is used to track pgBackRest versions."
},
{
"commit": "c279a00279e3c5b956f6dc4496454a9c4ccaa487",
"date": "2020-03-10 14:45:27 -0400",
"subject": "Add lz4 compression support.",
"body": "LZ4 compresses data faster than gzip but at a lower ratio. This can be a good tradeoff in certain scenarios.\n\nNote that setting compress-type=lz4 will make new backups and archive incompatible (unrestorable) with prior versions of pgBackRest."
},
{
"commit": "cc9d7315dbb4e66cd281dc2156faf529e566ddbc",
"date": "2020-03-10 14:05:00 -0400",
"subject": "Rename flush->flushing to be consistent with usage in other modules."
},
{
"commit": "79cfd3aebf4848c325d6eb98f5fe88f7f03805b0",
"date": "2020-03-09 17:41:59 -0400",
"subject": "Remove LibC.",
"body": "This was the interface between Perl and C introduced in 36a5349b but since f0ef73db has only been used by the Perl integration tests. This is expensive code to maintain just for testing.\n\nThe main dependency was the interface to storage, no matter where it was located, e.g. S3. Replace this with the new-introduced repo commands (d3c83453) that allow access to repo storage via the command line.\n\nThe other dependency was on various cfgOption* functions and CFGOPT_ constants that were convenient but not necessary. Replace these with hard-coded strings in most places and create new constants for commonly used values.\n\nRemove all auto-generated Perl code. This means that the error list will no longer be maintained automatically so copy used errors to Common::Exception.pm. This file will need to be maintained manually going forward but there is not likely to be much churn as the Perl integration tests are being retired.\n\nUpdate test.pl and related code to remove LibC builds.\n\nDing, dong, LibC is dead."
},
{
"commit": "d3c83453deffa6435ec5c4a932ad62a3d4d2cd95",
"date": "2020-03-09 17:15:03 -0400",
"subject": "Add repo-create, repo-get, repo-put, and repo-rm commands.",
"body": "These commands are generally useful but more importantly they allow removing LibC by providing the Perl integration tests an alternate way to work with repository storage.\n\nAll the commands are currently internal only and should not be used on production repositories."
},
{
"commit": "948835fb84010f515ec90395bd0c009e9884ad82",
"date": "2020-03-09 16:54:07 -0400",
"subject": "Update repo-ls command to work better with files.",
"body": "If the command was passed a file it would return no results since it was originally intended to list files when passed a path.\n\nHowever, as a general purpose command working directly with files makes sense."
},
{
"commit": "5e1291a29f65d0430966756c4031f6cc307ca208",
"date": "2020-03-09 16:41:04 -0400",
"subject": "Rename ls command to repo-ls.",
"body": "This command only makes sense for the repository storage since other storage (e.g. pg and spool) must be located on a local Posix filesystem and can be listed using standard unix commands. Since the repo storage can be located lots of places having a common way to list it makes sense.\n\nPrefix with repo- to make the scope of this command clear.\n\nUpdate documentation to reflect this change."
},
{
"commit": "f581edfa509c0879164597eba5ecf9dc287ca08d",
"date": "2020-03-09 13:36:46 -0400",
"subject": "Remove valgrind suppressions made obsolete by f0ef73db."
},
{
"commit": "3c4f91b31929c56f43ebb8f9bd48f39295dae917",
"date": "2020-03-09 13:35:26 -0400",
"subject": "Remove Perl unit tests made obsolete in 434cd832.",
"body": "These were replaced by C unit tests but not all the unit test setup code was removed in the Perl module."
},
{
"commit": "e93f1dd898ea76e4068d3723f36282bf715cd9d8",
"date": "2020-03-06 15:33:57 -0500",
"subject": "Fix incorrect parameter in logging function."
},
{
"commit": "54bc3b454a18677610d54e37813c51ad36b6c7d8",
"date": "2020-03-06 15:01:50 -0500",
"subject": "Cleanup pgPageChecksum() test in postgres/interface module.",
"body": "Some of the comments were wrong or inconsistent.\n\nUpdate TEST_RESULT_U16_HEX() to the less-specific TEST_RESULT_UINT_HEX()."
},
{
"commit": "438b957f9cf11b1c23636ec781c67f59bf4a8af1",
"date": "2020-03-06 14:41:03 -0500",
"subject": "Add infrastructure for multiple compression type support.",
"body": "Add compress-type option and deprecate compress option. Since the compress option is boolean it won't work with multiple compression types. Add logic to cfgLoadUpdateOption() to update compress-type if it is not set directly. The compress option should no longer be referenced outside the cfgLoadUpdateOption() function.\n\nAdd common/compress/helper module to contain interface functions that work with multiple compression types. Code outside this module should no longer call specific compression drivers, though it may be OK to reference a specific compression type using the new interface (e.g., saving backup history files in gz format).\n\nUnit tests only test compression using the gz format because other formats may not be available in all builds. It is the job of integration tests to exercise all compression types.\n\nAdditional compression types will be added in future commits."
},
{
"commit": "02aa03d1a266827b7ff5cb739b9598e475777086",
"date": "2020-03-06 14:10:09 -0500",
"subject": "Remove obsolete methods in pgBackRest::Storage::Storage module.",
"body": "All the methods in this module will need to be implemented via the command-line in order to get rid of LibC, so the first step is to reduce the code in the module as much as possible.\n\nFirst remove storageDb() and use storageTest() instead. Then create storageTest() using pgBackRestTest::Common::Storage which has no dependencies on LibC. Now the only storage using the LibC interface is storageRepo().\n\nRemove all link functions since those operations cannot be performed on a repo unless it is Posix, in which case the LibC interface is not needed. Same for owner().\n\nRemove pathSync() because syncs are not required in the tests. No test data is reused after a crash.\n\nPath create/exists functions should never be explicitly performed on a repo so remove those. File exists can be implemented by calling info() instead.\n\nRemove encryption detection functions which were only used by Backup/Archive::Info reconstruct() which are now obsolete.\n\nRemove all filters except pgBackRest::Storage::Filter::CipherBlock since they are not being used. That also means there are no filters returning results so remove all the result code.\n\nMove hashSize() and pathAbsolute() into pgBackRest::Storage::Base where they can be shared between pgBackRest::Storage::Storage and pgBackRestTest::Common::Storage."
},
{
"commit": "00647c7109cab28110d7dabd3da039b391507d50",
"date": "2020-03-06 07:21:17 -0500",
"subject": "Remove Perl Db module and LibC dependencies.",
"body": "This was mostly dead code except the DB_BACKUP_ADVISORY_LOCK constant, moved to the real/all test module, and the function that pulls info from pg_control, moved to ExpireEnvTest.pm."
},
{
"commit": "2e0fe2565025d0408e3d0f740fe1e5916d3ebbc0",
"date": "2020-03-05 18:34:59 -0500",
"subject": "Remove dependency on LibC hash filter.",
"body": "Perl provides Digest::SHA for hashing so there is no need to expose this via LibC anymore."
},
{
"commit": "e55443c890181ea63a350275447885331c8254e4",
"date": "2020-03-05 16:12:54 -0500",
"subject": "Move logic from postgres/pageChecksum to command/backup/pageChecksum().",
"body": "The postgres/pageChecksum module was designed as an interface to the C structs for the Perl code. The new C code can do this directly so no need for an interface.\n\nMove the remaining test for pgPageChecksum() into the postgres/interface test module."
},
{
"commit": "3796b74dcac29d7e7e7f89b69d3fa92b9d105a17",
"date": "2020-03-05 14:23:01 -0500",
"subject": "Use stock PostgreSQL page checksum implementation.",
"body": "We were using a customized version which worked fine but was hard to merge with upstream changes. Now this code is maintained much like the types in static.auto.h that we copy and check with each release.\n\nThe goal is to eventually build directly against PostgreSQL (either source or libcommon) and this brings us one step closer."
},
{
"commit": "1b647a1a22ae36e2447dc04384ab794b011a74aa",
"date": "2020-03-05 14:06:36 -0500",
"subject": "Remove invalid page checksum test.",
"body": "All zero pages should not have checksums. Not only is this test invalid but it will not work with the stock page checksum implementation in PostgreSQL, which checks for zero pages. Since we will be using that code verbatim soon this test needs to go."
},
{
"commit": "eb4347f20b85fa86208bb31b24b8b6f383432706",
"date": "2020-03-05 13:56:20 -0500",
"subject": "Use static checksums in mock/all integration tests.",
"body": "Using static values serves as a better cross-check against the page checksum code. The downside is that these checksums may not work with some big endian systems but in that case neither will the unit tests.\n\nWe can also remove the page checksum interface from LibC which brings us one step closer to eliminating it."
},
{
"commit": "77853d3c1387cd6ba42396e7ca29fae0f18ab6ac",
"date": "2020-03-05 11:14:53 -0500",
"subject": "Remove invalid const in pgPageChecksum() parameter.",
"body": "pgPageChecksum() must modify the page header in order to calculate the checksum. The modification is temporary but make it clear that it happens by removing the const.\n\nAlso make a note about our non-entirely-kosher usage of a const Buffer in the PageChecksum filter. This is safe as currently coded but at the least we need to be aware of what is going on."
},
{
"commit": "4ab8943ca886ec61934cea55182c1123cd4596a7",
"date": "2020-03-05 09:14:27 -0500",
"subject": "Use PG_PAGE_SIZE_DEFAULT constant instead of pageSize variable.",
"body": "Page size is passed around a lot but in fact it can only have one value, PG_PAGE_SIZE_DEFAULT, which is checked when pg_control is loaded. There may be an argument for supporting multiple page sizes in the future but for now just use the constant to simplify the code.\n\nThere is also a significant performance benefit. Because pageSize was being used in pageChecksumBlock() the main loop was neither unrolled nor vectorized (-funroll-loops -ftree-vectorize) as it is now with a constant loop boundary."
},
{
"commit": "91f321fb865fe4569f50d3a280d9ad1f502b7cbd",
"date": "2020-03-04 14:24:40 -0500",
"subject": "Rename old page*() functions to conform to new conventions.",
"body": "The general convention now is to prefix PostgreSQL functions with \"pg\"."
},
{
"commit": "a86253f1128ad7cd3921826df4baec2e899667f9",
"date": "2020-03-04 14:12:02 -0500",
"subject": "Remove obsolete function pageChecksumBufferTest().",
"body": "This function made validation faster in Perl because fewer calls (and buffer transformations) were required when all checksums were valid.\n\nIn C calling pageChecksumTest() directly is just as efficient so there is no longer a need for pageChecksumBufferTest()."
},
{
"commit": "9d488822682ec425e5ac4b0946a89eef240fc172",
"date": "2020-03-04 13:31:27 -0500",
"subject": "Centralize PostgreSQL page header data structures.",
"body": "These data structures were copied a few places (but only once in the core code) so put them in a place where everyone can use them.\n\nTo do this create a new file, static.auto.h, to contain data types and macros that have stayed the same through all the versions of PostgreSQL that we support. This allows us to have single, non-versioned set of headers and code for stable data structures like page headers.\n\nMigrate a few types from version.auto.h that are required for page header structures and pull the remaining types from PostgreSQL directly.\n\nWe had previously renamed xlog to wal so update those where required since we won't be modifying the PostgreSQL names anymore."
},
{
"commit": "a88d709962f761a51b21dd60688c5915bbdccddb",
"date": "2020-03-03 18:05:54 -0500",
"subject": "Add missing copyright notice."
},
{
"commit": "e8daabb963e6220f8b14672a6a9e3b3a118b4655",
"date": "2020-03-03 18:01:56 -0500",
"subject": "Remove incorrect comment.",
"body": "This was likely pasted from pageChecksum() and not removed."
},
{
"commit": "507a58460e9c33361baf3f1cbf2b95c9cb0dd5ae",
"date": "2020-02-29 07:52:54 -0500",
"subject": "Minor adjustments to common prefix code updated in 8ec41efb."
},
{
"commit": "8ec41efb04ee45854d18ffaf765e4a4800dd3879",
"date": "2020-02-28 17:41:34 -0500",
"subject": "Improve poor man's regular expression common prefix generator.",
"body": "The S3 driver depends on being able to generate a common prefix to limit the number of results from list commands, which saves on bandwidth.\n\nThe prior implementation could be tricked by an expression like ^ABC|^DEF where there is more than one possible prefix. To fix this disallow any prefix when another ^ anchor is found in the expression. [^ and \\^ are OK since they are not anchors.\n\nNote that this was not an active bug because there are currently no expressions with multiple ^ anchors."
},
{
"commit": "3bbead548026155c8bb5b212bed80903a3ef6a97",
"date": "2020-02-28 15:03:01 -0500",
"subject": "Add missing asserts.",
"body": "These interface functions did not exist when the Storage object was created but they are now required."
},
{
"commit": "19ea699e90a4f797c7f168cc853faf4b8e807056",
"date": "2020-02-28 15:00:09 -0500",
"subject": "Add function comment."
},
{
"commit": "ceb050e950c596835a9ab3b136b0de4983c69a54",
"date": "2020-02-28 14:50:50 -0500",
"subject": "Fix flapping test in real/all module.",
"body": "The restore test function was passing strBackup to the restoreCompare function but when the restore is expected to pick a backup based on a timestamp, then strBackup may not be the one chosen.\n\nModified the code so that strBackupExpected is set based on the parameters passed to the function and this is then passed to restoreCompare."
},
{
"commit": "089049ec563b021a69c46929f5fae13a1fdf0528",
"date": "2020-02-28 14:30:39 -0500",
"subject": "Add sleep before/after retrieving timestamp in the user guide.",
"body": "Adding a sleep before was necessary since only adding a sleep after did not always work. This helps to ensure the backup stop time for the previous backup does not equal time-recovery-timestamp. The sleep after allows enough time between the time retrieval and dropping important_table so PostgreSQL can consistently recover to before the table drop.\n\nNote that these issues were caused by picking a timestamp too close to the restore command or a database operation, not due to any problem in backup selection of the restore command."
},
{
"commit": "7d8c0d29fb5b2663c9c4b6be0b9f697a6c19c0fc",
"date": "2020-02-27 14:51:40 -0500",
"subject": "Remove compress option from config tests.",
"body": "This option was used for boolean testing but it will soon be deprecated and the semantics changed. To reduce churn it seems easiest to just use other options for testing. This will also be helpful when the option is eventually removed."
},
{
"commit": "dbf6255ab8ca9a141f9a7fbd1fda99006cce9e05",
"date": "2020-02-27 12:25:32 -0500",
"subject": "Remove compress/compress-level options from commands where unused.",
"body": "These commands (e.g. restore, archive-get) never used the compress options but allowed them to be passed on the command line. Now they will error when these options are passed on the command line. If these errors occur then remove the unused options."
},
{
"commit": "8f5337a136bcb8edf672a335164fc36768f22a73",
"date": "2020-02-27 12:21:53 -0500",
"subject": "Add missing static keywords.",
"body": "Interface functions should be marked static since they can only be called through the IoFilter interface."
},
{
"commit": "3f77a83e7367a05d7fee9612159e671910db25e0",
"date": "2020-02-27 12:19:40 -0500",
"subject": "Remove raw option for gz compression.",
"body": "This was a minor optimization used in protocol layer compression. Even though it was slightly faster, it omitted the crc-32 that is generated during normal compression which could lead to corrupt data after a bad network transmission. This would be caught on restore by our checksum but it seems better to catch an issue like this early.\n\nThe raw option also made the function signature different than future compression formats which may not support raw, or require different code to support raw.\n\nIn general, it doesn't seem worth the extra testing to support a format that has minimal benefit and is seldom used, since protocol compression is only enabled when the transmitted data is uncompressed."
},
{
"commit": "ee351682dae215ccbb2ae9d5c0932a41580635dd",
"date": "2020-02-27 12:09:05 -0500",
"subject": "Rename \"gzip\" to \"gz\".",
"body": "\"gz\" was used as the extension but \"gzip\" was generally used for function and type naming.\n\nWith a new compression format on the way, it makes sense to standardize on a single abbreviation to represent a compression format in the code. Since the extension is standard and we must use it, also use the extension for all naming."
},
{
"commit": "5afd950ed98b7eea0bc0c52851fdbe4fb7637698",
"date": "2020-02-26 21:15:39 -0500",
"subject": "Improve performance of MEM_CONTEXT*() macros.",
"body": "The prior code used TRY...CATCH blocks to cleanup mem contexts when an error occurred. This included freeing new mem contexts that were still being initialized when the error occurred and ensuring that the prior memory context was restored.\n\nThis worked fine in production but it involved a lot of setjmp()/longjmp() calls that resulted in longer compilation times and sluggish performance under valgrind, profiling, and coverage testing.\n\nInstead maintain a stack of new contexts and context switches that can be used to do cleanup after an error. Normally, the stack is not used for this purpose and pushing/popping is a cheap operation. In the prior implementation most of the TRY...CATCH logic needed to be run even on success.\n\nOne bonus is that the binary is about 8% smaller after this change. Another benefit is that new contexts *must* be explicitly freed/discarded or an error will occur. See info/manifest.c for an example of where this is useful outside the standard macros."
},
{
"commit": "d68771a4a5f0f349ba31679a27bc7b2ab8b0d736",
"date": "2020-02-26 20:40:24 -0500",
"subject": "Fix incorrect lcov version in contributing guide."
},
{
"commit": "99b052a38ab41c2f10a68f234830508904341139",
"date": "2020-02-25 17:25:12 -0500",
"subject": "Update enum formatting and NULL test to project style."
},
{
"commit": "9e0dc83e878fbe407b8daf05710a8b8e73638c6e",
"date": "2020-02-25 17:18:25 -0500",
"subject": "Begin v2.25 development."
},
{
"commit": "495dec44f0f512478ac942091ca2a29c60ad4911",
"date": "2020-02-25 17:05:45 -0500",
"subject": "v2.24: Auto-Select Backup Set for Time Target"
},
{
"commit": "ace41d57d1a76d031350f3ba458ba1d1e393866d",
"date": "2020-02-25 09:34:27 -0500",
"subject": "Clarify that gzip is always used to compress history files."
},
{
"commit": "cc743f2e04db05cc3277e43023ebd8e2007ef4ed",
"date": "2020-02-21 11:51:39 -0500",
"subject": "Skip pg_internal.init temp file during backup.",
"body": "If PostgreSQL crashes it can leave behind a pg_internal.init temp file with the pid as the extension, as discussed in https://www.postgresql.org/message-id/flat/20200131045352.GB2631%40paquier.xyz#7700b9481ef5b0dd5f09cc410b4750f6. On restart this file is not cleaned up so it can persist for the lifetime of the cluster or until another process with the same id happens to write pg_internal.init.\n\nThis is arguably a bug in PostgreSQL, but in any case it makes sense not to backup this file."
},
{
"commit": "48d0f77fe3e6edf7347b49d9e8c67052db00355b",
"date": "2020-02-21 11:31:31 -0500",
"subject": "Remove dead LibC macros.",
"body": "These macros were made obsolete when code was removed from LibC after the C migration was completed."
},
{
"commit": "dfc5f6723379526fd3c5fe5de61a37793e2cced8",
"date": "2020-02-17 17:12:22 -0600",
"subject": "Fix typo."
},
{
"commit": "ea0af890d82b2b335cc4d9a9dcc29d440a583706",
"date": "2020-02-12 17:27:44 -0700",
"subject": "Reclassify release note to documentation improvement."
},
{
"commit": "c6b89d74ec5a21fc644f8f5106ee42def1135c98",
"date": "2020-02-12 17:20:21 -0700",
"subject": "Add reviewer."
},
{
"commit": "6353e9428df1d241b97d02c843f1a737e7c36c85",
"date": "2020-02-12 17:18:48 -0700",
"subject": "Error when archive-get/archive-push/restore are not run on a PostgreSQL host.",
"body": "This error was lost during the migration to C. The error that occurred instead (generally an SSH auth error) was hard to debug.\n\nRestore the original behavior by throwing an error immediately if pg1-host is configured for any of these commands. reset-pg1-host can be used to suppress the error when required."
},
{
"commit": "dac8119bf11e74b7d393b601bcfbe447a80e85e4",
"date": "2020-02-12 15:47:07 -0700",
"subject": "Add pgIsLocalVerify().",
"body": "This functionality is required in commands other than restore, so centralize it."
},
{
"commit": "e2c304d4738144f1c5c72d43d70ec5c9e67d052b",
"date": "2020-02-12 12:17:23 -0700",
"subject": "Prevent defunct processes in asynchronous archive commands.",
"body": "The main improvement is a double-fork to prevent zombie processes if the parent process exits after the (child) async process. This is a real possibility since the parent process sticks around to monitor the results of the async process.\n\nIn the first fork, ignore SIGCHLD in the very unlikely case that the async process exits before the first fork. This is probably only possible if the async process exits immediately, perhaps due to a chdir() failure. Set SIGCHLD back to default in the async process so waitpid() will work as expected.\n\nAlso update the comment on chdir() to more accurately reflect what is happening.\n\nFinally, add a test in certain debug builds to ensure the first fork exits very quickly. This only works when valgrind is not in use because valgrind makes forking so slow that it is hard to tell if the async process performed work or not (in the case that the second fork goes missing and the async process is a direct child)."
},
{
"commit": "1fa3ae2fcd5b90a6f2a4e5dc83b3580297e83c1b",
"date": "2020-02-11 19:54:17 -0700",
"subject": "Prevent lock-bot from marking locked issues as \"resolved\".",
"body": "This is certainly not true in all cases, e.g. an issue may be closed if it is added to the backlog."
},
{
"commit": "1be9e6854e8ab4bc21d693371a09290a6c3d5db6",
"date": "2020-02-11 19:52:23 -0700",
"subject": "Prevent lock-bot from adding comments to locked issues.",
"body": "This will hopefully prevent users from getting notifications when an issue is locked."
},
{
"commit": "43936c58a894187b41501ba5acaf16e92842c261",
"date": "2020-02-11 19:44:06 -0700",
"subject": "Fix resume when the resumable backup was created by Perl.",
"body": "In this case the resumable backup should be ignored, but the C code was not able to load the partial manifest written by Perl since the format differs slightly. Add validations to catch this case and continue gracefully."
},
{
"commit": "44adf21c834ca8624b47dc6dbc2794bc429463ad",
"date": "2020-02-10 21:30:43 -0700",
"subject": "Consolidate archive async exec code.",
"body": "Move duplicated code to the common module. This will reduce copy and paste between the get and push modules when changes are made."
},
{
"commit": "0eaedc9a6ae98eaf4e733a3f63cb462a5ebcfa05",
"date": "2020-02-10 19:17:11 -0700",
"subject": "Improve async archive error file removal.",
"body": "2a06df93 removed the error file so an old error would not be reported before the async process had a chance to try again. However, if the async process was already running this might lead to a timeout error before reporting the correct error.\n\nInstead, remove the error files once we know that the async process will start, i.e. after the archive lock has been acquired.\n\nThis effectively reverts 2a06df93."
},
{
"commit": "8cfbc294fcc066fce594c09649865f3d88bb2364",
"date": "2020-02-10 18:48:47 -0700",
"subject": "Fix incorrect error code."
},
{
"commit": "1ce71b1e9b5e0613182d64673e9f730efd0e8176",
"date": "2020-02-10 17:44:39 -0700",
"subject": "Add missing linefeed."
},
{
"commit": "71b4cc56cbcf20ce6a39e2155e0d9da11c83aaf8",
"date": "2020-02-06 21:11:15 -0800",
"subject": "Rename confessOnError to throwOnError.",
"body": "Confess is awfully Perl-ish and was likely copied verbatim during the migration. Rename to what we do now, i.e. throw."
},
{
"commit": "2a06df93f379bdc28a6c5084d204cb1e5391dbb3",
"date": "2020-02-06 20:59:04 -0800",
"subject": "Remove async archive error file when not throwing an error.",
"body": "This ensures that the error will not be thrown before the async process has a chance to retry."
},
{
"commit": "3721e57a0ec709326c28eb6d31f9b4fe9e3fd7b5",
"date": "2020-02-06 18:28:54 -0800",
"subject": "Clarify why some recovery options are not commented out for PG >= 12."
},
{
"commit": "efff54490f456b653e51abb05507b0917792376e",
"date": "2020-02-04 21:19:21 -0800",
"subject": "Fix release note typo."
},
{
"commit": "296aec03be7c924f2689e091e667e80daf06e6f7",
"date": "2020-01-31 07:50:03 -0700",
"subject": "Update contributor name."
},
{
"commit": "0f8ec3e478cc17243bc3f043a13f5da73f98de66",
"date": "2020-01-30 14:51:26 -0700",
"subject": "Read HTTP content to eof when size/encoding not specified.",
"body": "Generally, the content-size or content-encoding headers will be used to specify how much content should be expected.\n\nThere is a special case where the server sends 'Connection:close' without the content headers and the content may be read up until eof.\n\nThis appears to be an atypical usage but it is required by the specification."
},
{
"commit": "856980ae99efe088e0cf10588c2a18cd78ff32e6",
"date": "2020-01-30 14:38:05 -0700",
"subject": "Auto-select backup set on restore when time target is specified.",
"body": "Auto-selection is performed only when --set is not specified. If a backup set for the given target time cannot not be found, the latest (default) backup set will be used.\n\nCurrently a limited number of date formats are recognized and timezone names are not allowed, only timezone offsets."
},
{
"commit": "f46d1fa74c4c0cef7a0ac00f3e43ebeecdc1315e",
"date": "2020-01-30 11:28:30 -0700",
"subject": "Add timezone calculations to time module.",
"body": "Add tzPartsValid() and tzOffsetSecond() to calculate timezone offsets from user provided values.\n\nUpdate epochFromParts() to accept a timezone offset in seconds."
},
{
"commit": "dbaa5e3473ebfb4651e879edaab6817fdd79092a",
"date": "2020-01-29 08:21:36 -0700",
"subject": "Add linefeeds to function declarations."
},
{
"commit": "80687cbe740ad786a15db5e76777f24fd7cb8c69",
"date": "2020-01-28 10:19:58 -0700",
"subject": "Free TLS connection in common/io-http test.",
"body": "The test that checks for no output from the server was leaving a connection open which valgrind was complaining about.\n\nWait on the server long enough to cause the error on the client then close the connection to free the memory."
},
{
"commit": "846efaa40f2a04273a61057a3684973098deb690",
"date": "2020-01-28 07:36:20 -0700",
"subject": "Revert 'Add lib path for libpq in case it is in a non-standard location.`",
"body": "Putting this before AC_CHECK_LIB breaks on many systems because the location of pg_config is not yet known."
},
{
"commit": "324f7cebe04e97a9ec34e325f6fbd927f77edb2c",
"date": "2020-01-27 17:50:07 -0700",
"subject": "Designated initializer cleanup.",
"body": "Cleanup designated initializers created in b134175f by moving struct members in or out for clarity."
},
{
"commit": "24d2494c8209079d0288784de38e9045d5c6cb95",
"date": "2020-01-27 11:25:24 -0700",
"subject": "Fix incomplete comment."
},
{
"commit": "0a845214a1d306d16dce5618f2f998f8f6e6778d",
"date": "2020-01-26 23:10:29 -0700",
"subject": "Fix typo."
},
{
"commit": "697150eaf875742a4522e2ed8c00dfaf0489c4ac",
"date": "2020-01-26 23:07:07 -0700",
"subject": "Add more validations to the manifest on backup.",
"body": "Validate that checksums exist for zero size files. This means that the checksums for zero size files are explicitly set by backup even though they'll always be the same. Also validate that zero length files have the correct checksum.\n\nValidate that repo size is > 0 if size is > 0. No matter what compression type is used a non-zero amount of data cannot be stored in zero bytes."
},
{
"commit": "bb45a80d46b738a9b6672fc77158585395b04473",
"date": "2020-01-26 22:47:53 -0700",
"subject": "Begin v2.24 development."
},
{
"commit": "2358d3448507f5dc4fd50edf65172285bca69c4b",
"date": "2020-01-26 22:38:21 -0700",
"subject": "v2.23: Bug Fix"
},
{
"commit": "7ab07dc580989452d807332bc91d26a42e5a0d3a",
"date": "2020-01-26 21:58:59 -0700",
"subject": "Validate checksums are set in the manifest on backup/restore.",
"body": "This is a modest start but it addresses the specific issue that was caused by the bug fixed in 45ec694a. This validation will produce an immediate error rather than erroring out partway through the restore.\n\nMore validations are planned but this is the most important one and seems safest for this release."
},
{
"commit": "45ec694af22dda84b124f0df242bbcfdd28726d1",
"date": "2020-01-26 13:19:13 -0700",
"subject": "Fix missing files corrupting the manifest.",
"body": "If a file was removed by PostgreSQL during the backup (or was missing from the standby) then the next file might not be copied and updated in the manifest. If this happened then the backup would error when restored.\n\nThe issue was that removing files from the manifest invalidated the pointers stored in the processing queues. When a file was removed, all the pointers shifted to the next file in the list, causing a file to be unprocessed. Since the unprocessed file was still in the manifest it would be saved with no checksum, causing a failure on restore.\n\nWhen process-max was > 1 then the bug would often not express since the file had already been pulled from the queue and updates to the manifest are done by name rather than by pointer."
},
{
"commit": "9b47ff2746b74bf41d20fa43d6ed2697b0a99087",
"date": "2020-01-26 12:29:53 -0700",
"subject": "Sort last processing queue on backup from standby.",
"body": "The last queue was not being sorted when a primary queue was added first.\n\nThis did not affect the backup or integrity but could lead to slightly lower performance since large files were not always copied first."
},
{
"commit": "0444d3741423004e0f94116b528d94090c1e4303",
"date": "2020-01-24 10:43:47 -0700",
"subject": "Remove obsolete include to ../libc."
},
{
"commit": "b1c5885017c035320804c5d16ed57b149a33ab10",
"date": "2020-01-24 10:40:42 -0700",
"subject": "Add lib path for libpq in case it is in a non-standard location."
},
{
"commit": "90abc3cf170a3d5da8bbc5307cf5032d6af5ed6c",
"date": "2020-01-24 10:08:05 -0700",
"subject": "Use pkg-config instead of xml2-config for libxml2 build options.",
"body": "pkg-config is a generic way to get build options rather than relying on a package-specific utility.\n\nXML2_CONFIG can be used to override this utility for systems that do not ship pkg-config."
},
{
"commit": "b134175fc7a98836f49f20d552f7c31138b66b1b",
"date": "2020-01-23 14:15:58 -0700",
"subject": "Use designated initializers to initialize structs.",
"body": "Previously memNew() used memset() to initialize all struct members to 0, NULL, false, etc. While this appears to work in practice, it is a violation of the C specification. For instance, NULL == 0 must be true but neither NULL nor 0 must be represented with all zero bits.\n\nInstead use designated initializers to initialize structs. These guarantee that struct members will be properly initialized even if they are not specified in the initializer. Note that due to a quirk in the C99 specification at least one member must be explicitly initialized even if it needs to be the default value.\n\nSince pre-zeroed memory is no longer required, adjust memAllocInternal()/memReallocInternal() to return raw memory and update dependent functions accordingly. All instances of memset() have been removed except in debug/test code where needed.\n\nAdd memNewPtrArray() to allocate an array of pointers and automatically set all pointers to NULL.\n\nRename memGrowRaw() to the more logical memResize()."
},
{
"commit": "cf2024beafba82b3899d9c46c7ea64716835a292",
"date": "2020-01-21 18:47:14 -0700",
"subject": "Add XML2_CONFIG environment variable to configure.",
"body": "This allows the default 'xml2-config' to be replaced with, e.g. 'pkg-config libxml-2.0', for libxml2 configuration."
},
{
"commit": "600a51815feacb149add2bb777d6a3b4d284c8aa",
"date": "2020-01-21 18:42:22 -0700",
"subject": "Set client_encoding to UTF8 on PostgreSQL connect.",
"body": "This is the only non-ASCII character encoding we have tested so make sure that's all we get from PostgreSQL."
},
{
"commit": "1706c599bd1c4d1eeac5bf44d1811e0259809027",
"date": "2020-01-21 18:37:43 -0700",
"subject": "Set encoding to UTF8 for Debian documentation containers.",
"body": "This allows testing multi-byte encodings in PostgreSQL."
},
{
"commit": "382ddfd79dfec12f4cdf821f36a47dd404a51356",
"date": "2020-01-21 16:43:44 -0700",
"subject": "Begin v2.23 development."
},
{
"commit": "bae6e1c9e3a035f3793739ef1b469015777aa70b",
"date": "2020-01-21 16:12:33 -0700",
"subject": "v2.22: Bug Fix"
},
{
"commit": "94842ccecee642cc58f6c177c19e642d86a8d997",
"date": "2020-01-21 11:59:25 -0700",
"subject": "Fix comment."
},
{
"commit": "03d434c7e112eb3a8649e9c11149e08929f9651b",
"date": "2020-01-21 11:57:59 -0700",
"subject": "Remove RHEL package patch now that it has been merged upstream.",
"body": "Also revert 731ffcfb and update ContainerTest.pm for upstream changes."
},
{
"commit": "b89e6b7f69677fdaff3bb1ed5e908c843f72a4b5",
"date": "2020-01-21 10:29:46 -0700",
"subject": "Fix error in timeline conversion.",
"body": "The timeline is required to verify WAL segments in the archive after a backup. The conversion was performed base 10 instead of 16, which led to errors when the timeline was ≥ 0xA."
},
{
"commit": "c2da9aa907802a59a0c6fd5c111a1dbe7ea16c76",
"date": "2020-01-19 14:54:38 -0700",
"subject": "Fix invalid bufSize().",
"body": "bufUsed() should be used here to avoid a possible segfault or xml parse error when bufSize() > bufUsed()."
},
{
"commit": "c630bda1c184d475155220884f8a25fa4b788aaf",
"date": "2020-01-19 10:37:08 -0700",
"subject": "Remove Debian package patch now that it has been merged upstream."
},
{
"commit": "d9efbc3698f92b874abb6eff3298c44fd35b0d5c",
"date": "2020-01-18 10:46:48 -0700",
"subject": "Add UTF8 strings to manifest and restore tests.",
"body": "The most likely place to get UTF8 characters is in database names so make sure UTF8 works in the places where database names are processed."
},
{
"commit": "19c39fe1e262dd7c259e9f1e68d0695c43afefe3",
"date": "2020-01-17 22:54:19 -0700",
"subject": "Fix redundancy in comment."
},
{
"commit": "ec173f12fb9c26553b2021473dd62d73a006835a",
"date": "2020-01-17 13:29:49 -0700",
"subject": "Add MEM_CONTEXT_PRIOR() block and update current call sites.",
"body": "This macro block encapsulates the common pattern of switching to the prior (formerly called old) mem context to return results from a function.\n\nAlso rename MEM_CONTEXT_OLD() to memContextPrior(). This violates our convention of macros being in all caps but memContextPrior() will become a function very soon so this will reduce churn."
},
{
"commit": "b5fa9951e36641d0ad751f0c89751e84b5b1df0d",
"date": "2020-01-17 13:08:47 -0700",
"subject": "Use MEM_CONTEXT_BEGIN() block in varFree().",
"body": "We probably arrived at this unusual construction because of the complexity of getting the mem context. Whether or not this is a good way to store the mem context, it still makes sense to use the standard pattern for switching mem contexts."
},
{
"commit": "c6d6b7dbefb62578be64133e36836fc936945555",
"date": "2020-01-17 11:58:41 -0700",
"subject": "Use MEM_CONTEXT_NEW_BEGIN() block instead of memContextNew().",
"body": "A few places were using just memContextNew(), probably because they did not immediately need to create anything in the new context, but it's better if we use the same pattern everywhere, even if it results in a few extra mem context switches."
},
{
"commit": "d3be1e41a4cdb5b7bbc40d73de8f185b22a97efd",
"date": "2020-01-16 16:23:40 -0700",
"subject": "Add braces and spaces for clarity.",
"body": "This should make it a little easier to see how the TRY macros work together."
},
{
"commit": "254f79803fca8cd591849b77d1266c79580ab08c",
"date": "2020-01-16 16:20:59 -0700",
"subject": "Use MEM_CONTEXT_BEGIN() block instead of memContextSwitch().",
"body": "This is the standard pattern but was missed here."
},
{
"commit": "8068a610d566cf9b5bcc79a3602a3a8442192bad",
"date": "2020-01-16 16:19:45 -0700",
"subject": "Use MEM_CONTEXT_NEW_BEGIN() block.",
"body": "This pattern makes more sense. The prior code was probably copy-pasted from code with slightly different requirements."
},
{
"commit": "4274fcbf6f99f6d8414d2ba095809341bcf56797",
"date": "2020-01-16 14:42:01 -0700",
"subject": "Add missing semicolon.",
"body": "This worked when the FUNCTION_TEST_RETURN_VOID() macro expanded to nothing because of the final semicolon. If the FUNCTION_TEST_RETURN_VOID() macro expanded to something then there was one semicolon too few."
},
{
"commit": "731ffcfb3d77e6a9d17091f9819cf3e21e25d951",
"date": "2020-01-16 14:29:04 -0700",
"subject": "Disable RHEL package builds since upstream is broken."
},
{
"commit": "e81629b4420759f80bd18017ee47b89942c90090",
"date": "2020-01-15 13:53:30 -0700",
"subject": "Reclassify Perl and LibC code as test/harness.",
"body": "These were still being included in the core totals but they are no longer used by core."
},
{
"commit": "193b78e150919470b33f3941be03f0ef589a3e79",
"date": "2020-01-15 13:40:17 -0700",
"subject": "Remove -s from make instructions.",
"body": "It's a good option but not required so let the user make the choice.\n\nAlso combine configure and make into a single line."
},
{
"commit": "9414ad2300f5ab87000da333fbbfa58228dae0c4",
"date": "2020-01-15 13:29:52 -0700",
"subject": "Begin v2.22 development."
},
{
"commit": "2c0ba0820d3e4adea31ef6b8ee201be653ef9579",
"date": "2020-01-15 13:21:52 -0700",
"subject": "v2.21: C Migration Complete"
},
{
"commit": "8d3710b2fe94c90783374d19a435bded1903fe1b",
"date": "2020-01-15 12:24:58 -0700",
"subject": "Fix options being ignored by asynchronous commands.",
"body": "The local, remote, archive-get-async, and archive-push-async commands were used to run functionality that was not directly available to the user. Unfortunately that meant they would not pick up options from the command that the user expected, e.g. backup, archive-get, etc.\n\nRemove the internal commands and add roles which allow pgBackRest to determine what functionality is required without implementing special commands. This way the options are loaded from the expected command section.\n\nSince remote is no longer a specific command with its own options, more manipulation is required when calling remote. This might be something we can improve in the config system but it may be worth leaving as is because it is a one-off, for now at least."
},
{
"commit": "c43ec9d38c7cd543d7a832f1e362705658ca5c12",
"date": "2020-01-15 08:19:32 -0700",
"subject": "Fix function return logging type.",
"body": "This was working because the stack was being cleaned up by a try block at the call site."
},
{
"commit": "f8a29c266e1e9b6e207fdd74478e3aca9b728cb9",
"date": "2020-01-13 20:36:42 -0700",
"subject": "Clarify comment."
},
{
"commit": "a7738ebba3cfd3a732c5de997a113746136133af",
"date": "2020-01-13 13:21:28 -0700",
"subject": "Update comments in command/remote module."
},
{
"commit": "a969a860abea7384572a1244913bcfbd8851545d",
"date": "2020-01-13 11:13:37 -0700",
"subject": "Fix misaligned braces."
},
{
"commit": "fe263e87b1822b051ccea3fc0a8fea64f944dd7b",
"date": "2020-01-12 11:31:06 -0700",
"subject": "Allow path-style URIs in S3 driver.",
"body": "Although path-style URIs have been deprecated by AWS, they may still be used with products like Minio because no additional DNS configuration is required.\n\nPath-style URIs must be explicitly enabled since it is not clear how they can be auto-detected reliably. More importantly, faulty detection could cause regressions in current installations."
},
{
"commit": "069345d33959eb7b2ff0f4ae2b2ec65023ac7186",
"date": "2020-01-12 11:00:10 -0700",
"subject": "Add string constants."
},
{
"commit": "3f89ecf8d9b848c2ca063581bc75064d9d353255",
"date": "2020-01-10 09:39:33 -0700",
"subject": "Add time to storage ls JSON output.",
"body": "Time is supported in all drivers with the update to S3 at 61538f93, so it is now possible to add time to the ls command and have it work on all repo types."
},
{
"commit": "0fe7bb2ec4d6ba10af8f2a6fd736e2c4cbdb2af2",
"date": "2020-01-09 12:20:13 -0700",
"subject": "Improve code that updates/removes pg options passed to a remote.",
"body": "The prior code was updating/removing hard-coded options but new options are added all the time and there was no indication that this code needed to be updated. For example, dc1e7ca2 added the pg-user option but this code was not updated.\n\nInstead find the options to update/remove dynamically. The new code uses prefixes, which is not perfect, but the patterns for pg options are pretty well established and this seems safer than the existing code."
},
{
"commit": "4c8653fc8bc6e8b3070c59ba12af4e5f2131c21c",
"date": "2020-01-09 11:56:03 -0700",
"subject": "Update inaccurate comments."
},
{
"commit": "2e11389ed4db29d530ec8e480134c44eab9a5896",
"date": "2020-01-09 11:52:51 -0700",
"subject": "Fix comment typo."
},
{
"commit": "0c5c78e5e16b10f79dcfa023c6276a65ad87481d",
"date": "2020-01-09 09:23:15 -0700",
"subject": "Make quoting in cfgExeParam() optional.",
"body": "Parameter lists that are passed directly to exec*() do not need quoting when spaces are present. Worse, the quotes will not be stripped and the option value will be garbled.\n\nUnfortunately this still does not fix all issues with quoting since we don't know how it might need to be escaped to work with SSH command configuration. The answer seems to be to pass the options in the protocol layer but that's beyond the scope of this commit."
},
{
"commit": "7de5ce23ad387602125f478ceec2c834703080d5",
"date": "2020-01-08 18:59:02 -0700",
"subject": "Add internal remote-type option.",
"body": "This option was overloaded on the general type option but it makes sense to split this out since the meaning is pretty different.\n\nRename the values to conform to current standards, i.e. pg and repo, now that the Perl code won't care anymore."
},
{
"commit": "7a1871c341c2ae530927bcf018792733530fc417",
"date": "2020-01-08 09:54:44 -0700",
"subject": "Fix test log message to match pg-version parameter name.",
"body": "It was confusing that this part of the log message did not match the parameter name, which made reproducing test failures from CI a little harder."
},
{
"commit": "8e1f78b4c82d3b4f7ecbdb053df1c8fd46bf3c1e",
"date": "2020-01-07 12:20:51 -0700",
"subject": "Remove obsolete Perl code missed in f0ef73db."
},
{
"commit": "a84ae6be04fc21c52c04284004836292089fa0e1",
"date": "2020-01-06 16:16:48 -0700",
"subject": "Fix comment typos."
},
{
"commit": "61538f932c58c3bb0afad5b6c16cf997604e3606",
"date": "2020-01-06 15:53:53 -0700",
"subject": "Parse dates in storageS3InfoList() and storageS3Info().",
"body": "Previously dates were not being filled by these functions which was fine since dates were not used.\n\nWe plan to use dates for the ls command plus it makes sense for the driver to be complete since it will be used as an example."
},
{
"commit": "d2fb4f977ceba499f134ad363ea3170f0d9ef5b9",
"date": "2020-01-06 15:24:49 -0700",
"subject": "Add httpLastModifiedToTime() to parse HTTP last-modified header."
},
{
"commit": "a08298ce1b9ee96a9f84b613848327f7f60eb063",
"date": "2020-01-06 15:18:52 -0700",
"subject": "Add basic time management functions.",
"body": "These are similar to what mktime() and strptime() do but they ignore the local system timezone which saves having to munge the TZ env variable to do time conversions."
},
{
"commit": "fc47907fe32560e8d3086287023d6f727027a0a1",
"date": "2020-01-03 09:32:52 -0700",
"subject": "Update LICENSE.txt for 2020."
},
{
"commit": "011bcb48697ddb56fe1396502a36254718f74dfa",
"date": "2019-12-29 21:22:18 -0700",
"subject": "Remove command option from Perl db application name.",
"body": "The command option will be removed from the C code so it needs to be removed here as well.\n\nThis code is now used only for testing so it's not important that it be so precise."
},
{
"commit": "33e328abbf5992caccc15ff42ca2dca14502c983",
"date": "2019-12-28 18:30:32 -0700",
"subject": "Remove unused LibC code.",
"body": "The code was made obsolete by the migration to C."
},
{
"commit": "e72a9dd0d2b6aad58a5d845112631253382e20e2",
"date": "2019-12-28 13:37:03 -0700",
"subject": "Add error parameter to cfgCommandId().",
"body": "This allows commands to be checked for validity without generating an error."
},
{
"commit": "d28837a300d4b585792c049dce25fd73387408b3",
"date": "2019-12-28 13:31:59 -0700",
"subject": "Remove obsolete function declaration."
},
{
"commit": "d41eea685a732fa80d99d0af0fc52746e13d1152",
"date": "2019-12-26 18:08:27 -0700",
"subject": "Change meaning of TEST_RESULT_STR() macro.",
"body": "This macro was created before the String object existed so subsequent usage with String always included a lot of strPtr() wrapping.\n\nTEST_RESULT_STR_Z() had already been introduced but a wholesale replacement of TEST_RESULT_STR() was not done since the priority was on the C migration.\n\nUpdate all calls to (old) TEST_RESULT_STR() with one of the following variants: (new) TEST_RESULT_STR(), TEST_RESULT_STR_Z(), TEST_RESULT_Z(), TEST_RESULT_Z_STR()."
},
{
"commit": "02d3918b3233276651fff443b7fcee3f325cf263",
"date": "2019-12-19 19:37:55 -0500",
"subject": "Remove duplicate header and extra linefeed."
},
{
"commit": "74c3842595f49b81be341faf56f2343e9a5c60c8",
"date": "2019-12-19 16:25:46 -0500",
"subject": "Remove errant tabs and fix spacing."
},
{
"commit": "7dfea6b71728bc4985021ce8eb993c1376344581",
"date": "2019-12-19 16:20:11 -0500",
"subject": "Remove errant tab."
},
{
"commit": "dc1e7ca22dbdae2556513468433b0591d7cf5a44",
"date": "2019-12-19 11:26:38 -0500",
"subject": "Add pg-user option.",
"body": "Specifies the database user name when connecting to PostgreSQL.\n\nIf not specified pgBackRest will connect with the local OS user or PGUSER, which was the previous behavior."
},
{
"commit": "9452084dd174925c554273eb2f8b224c89069123",
"date": "2019-12-17 23:32:39 -0500",
"subject": "Fix misspellings of libpq."
},
{
"commit": "63a855e2f7108f54100b973e23e4bcf3005a1647",
"date": "2019-12-17 23:26:52 -0500",
"subject": "Fix misaligned continuation character."
},
{
"commit": "2f7e139534de54fb19fa46edf7eeb7ecf00d8284",
"date": "2019-12-17 22:35:30 -0500",
"subject": "Error if option prefix and index total are not both defined.",
"body": "They are both required for indexed options."
},
{
"commit": "d780d084b7b4ad0950bd35b905c778c3a47e8860",
"date": "2019-12-17 21:56:02 -0500",
"subject": "Add comments about increasing Vagrantfile disk size."
},
{
"commit": "d89d9f1c52b9fc7bf4827d1b367da6e8520a79d2",
"date": "2019-12-17 21:47:19 -0500",
"subject": "Skip vagrant disksize option if no plugin.",
"body": "Previously, `vagrant up` would bail if no `vagrant-disksize` plugin was\ninstalled. This option is just a nice-to-have, so skip it rather than\nbailing."
},
{
"commit": "ac35dcac39699b5ecae5f3d178cb837bac1446dc",
"date": "2019-12-17 21:28:40 -0500",
"subject": "Add note about symlink required for contributing documentation to build."
},
{
"commit": "3394a5017091e57b0adc296b43ac00010a223c3d",
"date": "2019-12-17 21:25:54 -0500",
"subject": "Remove unused Perl library missed in f0ef73db."
},
{
"commit": "620386f034fd97371c467bda4dc0d90f423bf663",
"date": "2019-12-17 20:14:45 -0500",
"subject": "Remove integration tests that are now covered in the unit tests.",
"body": "Most of these tests are just checking that errors are thrown when required. These are well covered in various unit tests.\n\nThe \"cannot resume\" tests are also well covered in the backup unit tests.\n\nFinally, config warnings are well covered in the config unit tests.\n\nThere is more to be done here, but this accounts for the low-hanging fruit."
},
{
"commit": "977ec2e307c5487df9ed6fadebd486a92c75f269",
"date": "2019-12-17 15:23:07 -0500",
"subject": "Integration test improvements for disk and memory efficiency.",
"body": "Set log-level-file=off when more that one test will run. In this case is it impossible to see the logs anyway since they will be automatically cleaned up after the test. This improves performance pretty dramatically since trace-level logging is expensive. If a singe integration test is run then log-level-file is trace by default but can be changed with the --log-level-test-file option.\n\nReduce buffer-size to 64k to save memory during testing and allow more processes to run in parallel.\n\nUpdate log replacement rules so that these options can change without affecting expect logs."
},
{
"commit": "ccea30b8d8970acf9c1826c5c988d819aabf2d0f",
"date": "2019-12-14 10:20:23 -0500",
"subject": "Increase memory in ramdisk for Travis CI testing.",
"body": "The co6 tests were occasionally running out of space so bump up the size of the ramdisk a bit to hopefully prevent this.\n\nA longer term solution would be to disable the trace-level file logs when running on Travis CI since they seem to be using most of the space."
},
{
"commit": "6bd280f7bd667305317a7c825d913dac9719c475",
"date": "2019-12-14 09:53:50 -0500",
"subject": "Don't warn when stop-auto is enabled on PostgreSQL >= 9.6.",
"body": "PostgreSQL >= 9.6 uses non-exclusive backup which has implicit stop-auto since the backup will stop when the connection is terminated.\n\nThe warning was made more verbose in 1f2ce45e but this now seems like a bad idea since there are likely users with mixed version environments where stop-auto is enabled globally. There's no reason to fill their logs with warnings over a harmless option. If anything we should warn when stop-auto is explicitly set to false but this doesn't seem very important either.\n\nRevert to the prior behavior, which is to warn and reset when stop-auto is enabled on PostgreSQL < 9.3."
},
{
"commit": "03849840b813fdfdc2e00874fa8e3bbe9ac95338",
"date": "2019-12-13 21:33:13 -0500",
"subject": "Fix handling of \\ in filenames.",
"body": "\\ was not being properly escaped when calculating the manifest checksum which prevented the manifest from loading.\n\nUse jsonFromStr() to properly quote and escape \\.\n\nSince instances of \\ in cluster filenames should be rare to nonexistent this does not seem likely to be a serious problem in the field."
},
{
"commit": "f0ef73db7009cd6e08740d270a6ee7565efc9f8c",
"date": "2019-12-13 17:55:41 -0500",
"subject": "pgBackRest is now pure C.",
"body": "Remove embedded Perl from the distributed binary. This includes code, configure, Makefile, and packages. The distributed binary is now pure C.\n\nRemove storagePathEnforceSet() from the C Storage object which allowed Perl to write outside of the storage base directory. Update mock/all and real/all integration tests to use storageLocal() where they were violating this rule.\n\nRemove \"c\" option that allowed the remote to tell if it was being called from C or Perl.\n\nCode to convert options to JSON for passing to Perl (perl/config.c) has been moved to LibC since it is still required for Perl integration tests.\n\nUpdate build and installation instructions in the user guide.\n\nRemove all Perl unit tests.\n\nRemove obsolete Perl code. In particular this included all the Perl protocol code which required modifications to the Perl storage, manifest, and db objects that are still required for integration testing but only run locally. Any remaining Perl code is required for testing, documentation, or code generation.\n\nRename perlReq to binReq in define.yaml to indicate that the binary is required for a test. This had been the actual meaning for quite some time but the key was never renamed."
},
{
"commit": "1f2ce45e6b613edfb628ac40fd2369c9455692ba",
"date": "2019-12-13 17:14:26 -0500",
"subject": "The backup command is implemented entirely in C.",
"body": "For the most part this is a direct migration of the Perl code into C except as noted below.\n\nA backup can now be initiated from a linked directory. The link will not be stored in the manifest or recreated on restore. If a link or directory does not already exist in the restore location then a directory will be created.\n\nThe logic for creating backup labels has been improved and it should no longer be possible to get a backup label earlier than the latest backup even with timezone changes or clock skew. This has never been an issue in the field that we know of, but we found it in testing.\n\nFor online backups all times are fetched from the PostgreSQL primary host (before only copy start was). This doesn't affect backup integrity but it does prevent clock skew between hosts affecting backup duration reporting.\n\nArchive copy now works as expected when the archive and backup have different compression settings, i.e. when one is compressed and the other is not. This was a long-standing bug in the Perl code.\n\nResume will now work even if hardlink settings have been changed."
},
{
"commit": "e206093beb43981f11b532f05897c383f93d8f63",
"date": "2019-12-12 18:52:16 -0500",
"subject": "Allow end anchor to be excluded in backupRegExp().",
"body": "This is useful for matching files in the backup history directory which have characters after the backup label."
},
{
"commit": "8acfb6adf410571464c956ad161ad3df227b73a5",
"date": "2019-12-12 16:43:34 -0500",
"subject": "Add pgLsnRangeToWalSegmentList() to convert lsn range to wal segments."
},
{
"commit": "81295fd3889ce05829b6443aa29032ccffdfef3e",
"date": "2019-12-12 16:28:26 -0500",
"subject": "Move not found error into walSegmentFind().",
"body": "This error is also needed in backup so move it here to centralize it."
},
{
"commit": "1378d9c58b05f2f45352df155463ab8cd55276a6",
"date": "2019-12-12 16:21:51 -0500",
"subject": "Fix bad arithmetic in pgLsnToWalSegment().",
"body": "/ takes precedence over & but the appropriate parens were not provided.\n\nBy some bad luck the tests worked either way, so add a new test that only works the correct way to prevent a regression."
},
{
"commit": "676be2c77390587bb36c9d88bcf1a54d333ee0f3",
"date": "2019-12-12 16:11:09 -0500",
"subject": "Add pgWalPath() to return version-specific WAL path.",
"body": "Also update the manifest module to use the new function."
},
{
"commit": "94cb9540f1c94746d78ae4efb16246b26daf79a0",
"date": "2019-12-12 09:05:10 -0500",
"subject": "Begin v2.21 development."
},
{
"commit": "39fc2b7ad68d97cf5f23757e8a341428935621f4",
"date": "2019-12-12 08:20:21 -0500",
"subject": "v2.20: Bug Fixes"
},
{
"commit": "b031dbbcf8fa83ef60cfabc20fbf16046904f9aa",
"date": "2019-12-11 22:11:04 -0500",
"subject": "Allow timezones to be explicitly set for testing.",
"body": "The TZ environment variable was not reliably pushed down to the test processes.\n\nInstead pass TZ via a command line parameter and set explicitly in the test process."
},
{
"commit": "db5175915a0dc09b7591d71886ee8ce3bf5a12c3",
"date": "2019-12-11 21:51:32 -0500",
"subject": "Use localtime() to format time_t in cvtTimeToZ().",
"body": "Using gmtime() produced output skewed by the local timezone.\n\nSince this function is currently only used for debug logging this is not a live bug in the field."
},
{
"commit": "811ecd758d9e2ca12966995ec6cfc1e4ff8c0cfd",
"date": "2019-12-11 14:57:32 -0500",
"subject": "Make type in comment more specific."
},
{
"commit": "0194a9867182435c7a181be6466ca2b91f05801d",
"date": "2019-12-11 14:36:39 -0500",
"subject": "Fix archive-push/archive-get when PGDATA is symlinked.",
"body": "Commit 7168e074 tried to use cwd() as PGDATA but this would disagree with the path configured in pgBackRest if PGDATA was symlinked.\n\nIf cwd() does not match the pgBackRest path then chdir() to the path and make sure the next cwd() matches the result from the first call."
},
{
"commit": "8c840c28a65dae3cca581691e88e51839cd64bca",
"date": "2019-12-11 08:48:46 -0500",
"subject": "Fix segfault on unexpected EOF in gzip decompression.",
"body": "If the compressed stream terminated early then the decompression process would get a flush request (NULL input buffer) since the filter was not marked as done. This could happen on a zero-length or truncated (i.e. invalid) compressed file.\n\nChange the existing assertion to an error to catch this condition in production gracefully."
},
{
"commit": "c933f12f9c39d7c076f84252c081c3430be72e55",
"date": "2019-12-10 13:28:15 -0500",
"subject": "Remove obsolete --perl-option option.",
"body": "This option was used when Perl was executed instead of being embedded.\n\nIt has been obsolete for a long time so remove it."
},
{
"commit": "d0ba8ff58c46c15facb4dba19eab8db83835b07c",
"date": "2019-12-10 13:16:47 -0500",
"subject": "Remove test point infrastructure.",
"body": "82df7e6f and 9856fef5 updated tests that used test points in preparation for the feature not being available in the C code.\n\nSince tests points are no longer used remove the infrastructure.\n\nAlso remove one stray --test option in mock/all that was essentially a noop but no longer works now that the option has been removed."
},
{
"commit": "d7d663c2b93fd6a3bdfb1c6a4bd1feae0cd8cc63",
"date": "2019-12-10 13:02:36 -0500",
"subject": "Make buildPutDiffers() work with empty files.",
"body": "If the file was empty the timestamp was updated. If the file is empty and there is no content then file should not be saved."
},
{
"commit": "800d2972b00bb381c92cdadead9a1c04141853be",
"date": "2019-12-09 18:28:20 -0500",
"subject": "Remove stray uint type.",
"body": "This was probably copied from an example but some compilers don't like it."
},
{
"commit": "471d54a738887dd5c99afced36420cf6fb5c631b",
"date": "2019-12-09 17:55:20 -0500",
"subject": "Add stringz module to define some commonly used strings.",
"body": "This module will eventually contain various useful zero-terminated string functions.\n\nFor now, using NULL_Z instead of strPtr(NULL_STR) avoids a strict aliasing warning on RHEL 6. This is likely a compiler issue, but adding these constants seems like a good idea anyway and we are not going to get a fix in a gcc that old."
},
{
"commit": "ca33545630a073579ef763294d897dd06820f5a5",
"date": "2019-12-09 14:06:32 -0500",
"subject": "Remove redundant test and move another test."
},
{
"commit": "61ad3a44c9e562a306064770428726a5664056e9",
"date": "2019-12-09 09:12:34 -0500",
"subject": "Note that next repo format should use UTC for backup labels."
},
{
"commit": "d3132dae26ad40c2a47db62d4cc5f4502465d7c6",
"date": "2019-12-08 18:43:47 -0500",
"subject": "Add functions for building new manifests.",
"body": "New manifests are built before a backup is performed."
},
{
"commit": "2cfde18755f305008af134ac833aca6989321ca7",
"date": "2019-12-08 14:19:47 -0500",
"subject": "Add pgLsnFromStr(), pgLsnToStr(), and pgLsnToWalSegment()."
},
{
"commit": "f517b141fb065efd21878fc774f51b52c014d887",
"date": "2019-12-08 14:15:23 -0500",
"subject": "Update pq harness to play nicely with variable LSNs."
},
{
"commit": "d2587250da82a90257534268e2175bfcfd3e15ac",
"date": "2019-12-07 18:44:06 -0500",
"subject": "Add backup functions to Db object.",
"body": "These functions implement the database backup functionality for all supported versions."
},
{
"commit": "8766326da812f6aae00bdbfef4b1382805de8c3e",
"date": "2019-12-07 17:48:53 -0500",
"subject": "Add protocolRemoteFree() to shutdown a specific remote.",
"body": "Sometimes it is useful to shutdown remotes that are no longer needed instead of waiting for them to be shutdown at program exit."
},
{
"commit": "5175d52e9466c339f5a4cd5c7d7e8724c3bbb2e3",
"date": "2019-12-07 17:42:42 -0500",
"subject": "Add constant for pg_tblspc path."
},
{
"commit": "78b1e05b7e6f8d09a424a2e8864e317d63c474f3",
"date": "2019-12-07 17:39:25 -0500",
"subject": "Remove unused Perl module."
},
{
"commit": "35a262951a1ed74431cdfa92c36ee2c9ae867c1a",
"date": "2019-12-07 17:33:34 -0500",
"subject": "Pq test harness usability and error reporting improvements.",
"body": "Pq script errors are now printed in test output in case they are being masked by a later error.\n\nOnce a script error occurs, the same error will be thrown forever rather than throwing a new error on the next item in the script.\n\nHRNPQ_MACRO_CLOSE() is not required in scripts unless harnessPqScriptStrictSet(true) is called. Most higher-level tests should not need to run in strict mode.\n\nThe command/check test seems to require strict mode but there's no apparent reason why it should. This would be a good thing to look into at some point."
},
{
"commit": "d6479ddd0efda9bb442f4bbfe937daa0ab46ac72",
"date": "2019-12-07 17:15:20 -0500",
"subject": "Add log replacements to help test non-deterministic log output.",
"body": "Some log output (e.g. time) is hard to test because the values can change between tests.\n\nAdd expressions to replace substrings in the log with predictable values to simplify testing.\n\nThis is similar to the log replacement facility available for Perl expect log testing."
},
{
"commit": "e4716ee036e8a4417f6dcb8d108c0d7b9e3f2b7d",
"date": "2019-12-07 17:02:41 -0500",
"subject": "Improve diff output in tests.",
"body": "Always compare expected vs actual (in that order) and give a hint in the error message to indicate what should be added and what removed."
},
{
"commit": "8c47ee296a1f311682b46b3f1de98d4eb7dcaf6a",
"date": "2019-12-07 16:55:50 -0500",
"subject": "Improve storage harness test callback.",
"body": "Add ability to omit the root (i.e. dot) path and get real size of compressed files."
},
{
"commit": "1b3770e248f4a5b59ba16f6a4c6cba7cf23de883",
"date": "2019-12-07 09:48:33 -0500",
"subject": "Recopy during backup when resumed file is missing or corrupt.",
"body": "A recopy would occur if the size or checksum was invalid but on error the backup would terminate.\n\nInstead, recopy the resumed file on any error. If the error is systemic (e.g. network failure) then it should show up again during the recopy."
},
{
"commit": "d3f717c89208ef132e75b634ad2e91efbda25a04",
"date": "2019-12-07 09:26:51 -0500",
"subject": "Storage hardlink and symlink features require path feature.",
"body": "Since there is only one driver that supports (or is likely to support) links (Posix), require the path feature to make logic in the code simpler.\n\nThe checks are added just in case another driver supports links."
},
{
"commit": "e632c605250438a9e06f133b55c88e578ea709cd",
"date": "2019-12-06 11:48:41 -0500",
"subject": "Fix backup labels in mock/all resume integration tests.",
"body": "These were not getting updated to match the directory name when the manifests were copied.\n\nThe Perl code didn't care but the C code expects labels to be set correctly."
},
{
"commit": "5395aa0c92febadbf0c71f93799877cfe7268b6b",
"date": "2019-12-05 22:34:38 -0500",
"subject": "Allocate one extra process for backup from standby.",
"body": "The connection to the primary is process-max + 1 so make space for it."
},
{
"commit": "b2d82bd2484dbe3dee12479efb6e9aceba5aac57",
"date": "2019-12-04 19:43:26 -0500",
"subject": "Add functions to get the substring found by regExpMatch().",
"body": "For now this is only used in testing but there are places where it could be useful in the core code.\n\nEven if that turns out not to be true, it doesn't seem worth implementing a new version in testing just to capture a few values that we already have."
},
{
"commit": "053af2f54db0eaaaca3ac67cbdd68ba1b701048a",
"date": "2019-12-04 19:31:39 -0500",
"subject": "Add asserts to ensure hostId > 0.",
"body": "hostId is 1-based (e.g. pg1-*) so it should always be > 0."
},
{
"commit": "d1f49825b11ba88ac2024734c4c8a1c961f05854",
"date": "2019-12-02 11:54:45 -0500",
"subject": "Add missing header."
},
{
"commit": "8dfe0e48e25725978738ecb3fec24e5ce2e9076b",
"date": "2019-12-02 10:49:25 -0500",
"subject": "Use more general error code when tablespace linked into PGDATA.",
"body": "The specific error code was not that useful since we also test the error message which contains details of the link error."
},
{
"commit": "33a63aae503adf8d7f3f4430ee6478b845d38e2c",
"date": "2019-12-02 07:39:42 -0500",
"subject": "Add flag to dbGet() to require a standby.",
"body": "This is needed from backup from standby functionality."
},
{
"commit": "28116918ff3a00b133d74d524df452e29398082d",
"date": "2019-12-02 07:35:36 -0500",
"subject": "Error in remote command when stop file exists.",
"body": "This duplicates the Perl functionality."
},
{
"commit": "fc291b6f28753329afdd7b65b115f90d31569df1",
"date": "2019-12-01 17:47:47 -0500",
"subject": "Reduce the scope of mock/all exclusion tests.",
"body": "Run exclusions only on the tests where they will have an effect to reduce churn in the expect logs when they change."
},
{
"commit": "d15ed338217667f0bd7ffff3eb9f5e24052477fd",
"date": "2019-12-01 16:32:21 -0500",
"subject": "Make MCV return false when a boolean tie.",
"body": "This is to maintain compatibility with the older Perl code that returned the lowest sorted order item in a tie.\n\nFor other datatypes the C code returns the same value, often enough at least to not cause churn in the expect tests."
},
{
"commit": "ab0974cc8ea0cff70a9f680ff8e1dc10b1ba3c48",
"date": "2019-12-01 16:30:44 -0500",
"subject": "Add PostgreSQL version where backup from standby is supported."
},
{
"commit": "218698088f0e4d5a978b8f4c8df6b114980889b9",
"date": "2019-12-01 16:28:33 -0500",
"subject": "Add PostgreSQL file and path names used for building manifests."
},
{
"commit": "56ee321a9565e7c1e076c58744e0cfc408801e28",
"date": "2019-12-01 15:49:34 -0500",
"subject": "Add pgLsnName() and pgXactPath()."
},
{
"commit": "bc83354fb53a1ba8a86366478c5be871775dd04a",
"date": "2019-11-29 11:29:16 -0500",
"subject": "Add storage feature flags.",
"body": "Even though storagePathSync() is a noop when path sync is not supported, it is useful to know in advance if the function will do anything so add the storageFeaturePathSync flag.\n\nThe storageFeatureSymLink and storageFeatureHardLink flags are currently informational only since links are not yet implemented in the storage interface."
},
{
"commit": "0933aeb1ad954f8c7b2ed6d4e160d7e132ada8b7",
"date": "2019-11-29 10:56:13 -0500",
"subject": "Remove unused reference to use pgBackRest::Backup::File."
},
{
"commit": "50eb062e0e7a6aac326e411ed28e0c8aa397bf01",
"date": "2019-11-28 09:34:19 -0500",
"subject": "Fix reference list when backup.info is reconstructed in expire command.",
"body": "Adding a manifest to backup.info was migrated to C in 4e4d1f41 but deduplication of the references was missed leading to a reference for every file being added to backup.info.\n\nSince the backup command is still using the Perl version of reconstruct this issue will not express unless 1) there is a backup missing from backup.info and 2) the expire command is run directly instead of running after backup as usual.\n\nThis unlikely combination of events means this is probably not a problem in the field."
},
{
"commit": "686b6f91da4cfdbc8708b0f08ced460c10e4326c",
"date": "2019-11-28 08:27:21 -0500",
"subject": "Set archive-check option in manifest correctly when offline.",
"body": "Archive check does not run when in offline backup mode but the option was set to true in the manifest. It's harmless since these options are informational only but it could cause confusion when debugging."
},
{
"commit": "5506e5de27b1a61015f6e18d5582ca81f696e30f",
"date": "2019-11-27 15:09:07 -0500",
"subject": "Remove obsolete call to perlExec() for stand-alone expire command.",
"body": "This was missed in ecae5e34."
},
{
"commit": "4683557c54d2f2511fd754ae7c0c5e34ac1e5ba4",
"date": "2019-11-26 17:22:30 -0500",
"subject": "Remove unused reference to pgBackRest::Db."
},
{
"commit": "158e439689c8247ba2e53da4bfe65934e391b690",
"date": "2019-11-26 17:16:45 -0500",
"subject": "Remove obsolete Perl archive code.",
"body": "This should have been removed in a1c13a50 but was missed."
},
{
"commit": "82df7e6f3bf53409b3c3a15eff7bbc33c13197f8",
"date": "2019-11-26 11:32:12 -0500",
"subject": "Update integration tests in real/all that use test points.",
"body": "Test points are not supported by the new C code so these will be replaced with unit tests.\n\nThe fact that the tests still pass even when the changes aren't made mid-backup (except application_name) shows how weak they were in the first place.\n\nEven so, this does represent a regression in (soon to be be removed) Perl coverage."
},
{
"commit": "b145c72b5c27ad299ad1fa7dcd84f45fb0797e0f",
"date": "2019-11-25 08:51:28 -0500",
"subject": "Update missing manifest warning in BackupInfo.",
"body": "This brings the Perl message in line with C to reduce expect log churn."
},
{
"commit": "8800f32ad9b6b9b1351afd4280cc8dfe1ada2d92",
"date": "2019-11-25 08:35:26 -0500",
"subject": "Remove exclusions once they have been tested in mock/all.",
"body": "The exclusions no longer have any effect after a restore and just add noise to the expect log."
},
{
"commit": "9856fef5861fbf054007233f78582d3584c03565",
"date": "2019-11-25 07:48:52 -0500",
"subject": "Update integration tests in mock/all that use test points.",
"body": "Test points will not be available in the C code so update these tests as best as possible without using them.\n\nThis represents a loss of coverage for the Perl code (soon to be removed) which will be made up in the C code with unit tests."
},
{
"commit": "3cd45a7411ce67630915c89cf5c69a37265d0e07",
"date": "2019-11-25 07:45:58 -0500",
"subject": "Remove start/stop --force integration tests in mock/all.",
"body": "These tests require test points which are not being implemented in the C code.\n\nThis functionality is fully tested in the command/control unit tests so integration tests are no longer required."
},
{
"commit": "01aefc563dbabc7c7b1b7dbed27716692898597f",
"date": "2019-11-25 07:37:09 -0500",
"subject": "Update Perl page checksum expression.",
"body": "This expression determines which files contain page checksums but it was also including the directory above the relation directories. In a real PostgreSQL installation this not a problem because these directories don't contain any files.\n\nHowever, our tests place a file in `base` which the Perl code thought should have page checksums while the new C code says no.\n\nUpdate the expression to document the change and avoid churn in the expect logs later."
},
{
"commit": "18e43c5955217838ad55e68e176b83a9187533ec",
"date": "2019-11-24 09:24:52 -0500",
"subject": "Fix comment typo."
},
{
"commit": "cace54151f3dc9f686b99923f1dbd1c010ab84f4",
"date": "2019-11-23 10:32:57 -0500",
"subject": "Add hostId to protocolLocalGet().",
"body": "Previously this function was only creating locals that talked to the repository. Backup will need to be able to talk to multiple PostgreSQL hosts."
},
{
"commit": "ab65ffdfacf47b6d182cbf6461d49a76c0cc8b00",
"date": "2019-11-23 10:22:11 -0500",
"subject": "Add protocolStorageType*() to manage protocol storage types.",
"body": "Abstract the string representation of storage types that are passed over the protocol layer."
},
{
"commit": "a4b9440d354c3cf95f7ca3aa68dc691c10c65e21",
"date": "2019-11-22 19:25:49 -0500",
"subject": "Only install specific lcov version when required.",
"body": "Installing lcov 1.14 everywhere turned out to be a problem just as using 1.13 on Ubuntu 19.04 was.\n\nSince we primarily use Ubuntu 18.04 for coverage testing and reporting, we definitely want to make sure that works. So, revert to using the default packaged lcov except when specified otherwise in VmTest.pm.\n\nPostgreSQL minor version releases are also included since all containers have been rebuilt."
},
{
"commit": "52a3ba6b6f25443b5ed456969b794f63a809a606",
"date": "2019-11-22 15:18:56 -0500",
"subject": "Revert \"Forbid % character in parameters.\"",
"body": "The issue \"fixed\" in f01aa586 was caused by treating all strings as format strings while logging, which was fixed in 0c05df45.\n\nRevert because there no longer seems a reason for the extra logic, and it was only partially applied, i.e. not to env vars, command-line options, or config options."
},
{
"commit": "381aecae4eeb15c538318e95c3101fa07a6712d4",
"date": "2019-11-22 14:30:56 -0500",
"subject": "Fix walPath() when CWD is / and path is relative.",
"body": "The function would return a // prefix in this case, which works fine but looks odd while debugging."
},
{
"commit": "0c05df458287c77df1188a68bbd74e145ed0f059",
"date": "2019-11-22 13:33:26 -0500",
"subject": "Add _FMT() logging macro variants.",
"body": "Using the same macros for formatted and unformatted logging had several disadvantages.\n\nFirst, the compiler was unable to verify the format string against the parameters.\n\nSecond, legitimate % characters in messages were being interpreted as format characters with garbage output ensuing.\n\nAdd _FMT() variants and update all call sites to use the correct variant."
},
{
"commit": "99edcca55b3b8b1d144bdeb32c4d98c8ee13bf34",
"date": "2019-11-22 09:18:24 -0500",
"subject": "Add missing linefeeds."
},
{
"commit": "29ab06cf133b6a3d18d7bc39507f92a45927b2e8",
"date": "2019-11-21 17:30:18 -0500",
"subject": "Add missing static keyword."
},
{
"commit": "f01aa5861d341a19d85ddf3d7307c250994fecd4",
"date": "2019-11-21 17:28:03 -0500",
"subject": "Forbid % character in parameters.",
"body": "This character causes problems in C and in the shell if we try to output it in an error message.\n\nForbid it completely and spell it out in error messages to avoid strange effects.\n\nThere is likely a better way deal with the issue but this will do for now."
},
{
"commit": "6be9c7b63a61464d60d15133662eb44776401b1d",
"date": "2019-11-21 17:20:42 -0500",
"subject": "Don't log secrets in cipherBlock module.",
"body": "In practice there are lots of ways secrets can be leaked (e.g. info load, protocol) but at least remove this instance."
},
{
"commit": "c524ec4f95462bfbc1484e139d754280ec05e94c",
"date": "2019-11-21 16:06:27 -0500",
"subject": "Remove obsolete integration tests from mock/all.",
"body": "The protocol timeout tests have been superceded by unit tests.\n\nThe TEST_BACKUP_RESUME test point was incorrectly included into a number of tests, probably a copy pasto. It didn't hurt anything but it did add 200ms to each test where it appeared.\n\nCatalog and control version tests were redundant. The database version and system id tests covered the important code paths and the C code gets these values from a lookup table.\n\nFinally, fix an incomplete update to the backup.info file while munging for tests."
},
{
"commit": "53cd530bbf3921c9500963d12393344425574d08",
"date": "2019-11-21 12:09:24 -0500",
"subject": "Safely initialize manifest object.",
"body": "Using a designated initializer is safer than zeroing the struct. It is also better for debugging because Valgrind should be able to detect access to areas that are not initialized due to alignment."
},
{
"commit": "270f9496e432109b243e8db5d497805f72c56d91",
"date": "2019-11-21 12:08:32 -0500",
"subject": "Add manifestMove()."
},
{
"commit": "c5a6631d2791ca5ae69a6178fac758b6c96f9781",
"date": "2019-11-21 11:44:40 -0500",
"subject": "Rearrange manifest module.",
"body": "Put functions with related functions, move getters above the helper functions, and rename manifestPgPath() to manifestPathPg()."
},
{
"commit": "9f71a019c815af58bdd10ca2ceaaf6f1506fb560",
"date": "2019-11-21 10:55:03 -0500",
"subject": "Allow storageInfo() to operate outside the base storage path.",
"body": "It is occasionally useful to get information about a file outside of the base storage path. storageLocal() can be used in some cases but when the storage is remote is doesn't seem worth creating a separate storage object for adhoc info requests.\n\nstorageInfo() is a read-only operation so this seems pretty safe. The noPathEnforce parameter will make auditing exceptions easy."
},
{
"commit": "d3b1897625c5b200724fb087cedd975fce07672f",
"date": "2019-11-21 10:34:32 -0500",
"subject": "Allow adhoc enforcement in storagePath().",
"body": "The ability to disable enforcement (i.e., the requested absolute path is within the storage path) globally will be removed after the Perl migration.\n\nThe feature will still be needed occasionally so allow it in an adhoc fashion."
},
{
"commit": "e1dad720a126e2145718ccc78614727fa67cd619",
"date": "2019-11-21 10:21:35 -0500",
"subject": "Rename storagePath() to storageP() in places where it was missed.",
"body": "Correct this since it will be enforced in a subsequent patch."
},
{
"commit": "cef9f0f37f33fe46ffcb229535a82479700b8de2",
"date": "2019-11-21 09:40:15 -0500",
"subject": "Process . in strPathAbsolute().",
"body": "A . in a link will always lead to an error since the destination will be inside PGDATA. However, it is accepted symlink syntax so it's better to resolve it and get the correct error message.\n\nAlso, we may have other uses for this function in the future."
},
{
"commit": "a6fc0bf2ca778844448885192f11d17bf933b551",
"date": "2019-11-21 08:15:37 -0500",
"subject": "Add contributor."
},
{
"commit": "3d2c0b0f3bcd4fbae0409a374f13d1aebb3bba81",
"date": "2019-11-20 14:24:58 -0500",
"subject": "Fix inverted page checksum load/save.",
"body": "This was not caught before because the on-disk format was correct even though the representation in memory was inverted."
},
{
"commit": "63c4c148361c75ec53d2d6b53a3ec69389b925c3",
"date": "2019-11-19 20:52:01 -0500",
"subject": "Fix lcov build in Vagrantfile.",
"body": "-q was being instead of -s for silent mode which caused the build to fail."
},
{
"commit": "5f034714453f28a04d8e48828e8ee53a61401c4e",
"date": "2019-11-19 15:56:13 -0500",
"subject": "Remove --force option from stanza-create documentation.",
"body": "This should have been removed when the support for the option was removed in c7333190.\n\nThe option cannot be removed entirely because we don't want to error in the case where --force was specified but the stanza is valid."
},
{
"commit": "c5ee56a724fe6c49b7e3496090ff1bf6d73e33f8",
"date": "2019-11-19 10:34:14 -0500",
"subject": "Markdown update missed in 1db9e3b1."
},
{
"commit": "20162ed3feec8d3de5de8e2cca7bb065a47bcc67",
"date": "2019-11-19 10:32:18 -0500",
"subject": "Fix typo."
},
{
"commit": "74317f0ab6024d6c3a2f9635677f26489786e166",
"date": "2019-11-17 17:35:03 -0500",
"subject": "Use variable parameter macros to make the storage interface tidier.",
"body": "Many functions don't take optional parameters, so tacking the struct onto the end was pretty burdensome.\n\nAdd macros to get the interface under a variety of circumstances to make this practical."
},
{
"commit": "1db9e3b144d886ec4159176312345d154b7178b8",
"date": "2019-11-17 15:10:40 -0500",
"subject": "Remove *MP() macros variants.",
"body": "Adding a dummy column which is always set by the P() macro allows a single macro to be used for parameters or no parameters without violating C's prohibition on the {} initializer.\n\n-Wmissing-field-initializers remains disabled because it still gives wildly different results between versions of gcc."
},
{
"commit": "5c65d88f6254176c257f0bf58ca5c9f59bb99177",
"date": "2019-11-17 14:17:03 -0500",
"subject": "Use structs to pass optional parameters to storage drivers.",
"body": "New optional parameters can be added without breaking the interface and this reduces noise in the function prototypes."
},
{
"commit": "09e129886e10a036e75493d55625f01c34e15d85",
"date": "2019-11-16 17:47:42 -0500",
"subject": "Add storageInfoList() support to remote storage driver."
},
{
"commit": "26e1da82e7970ac03b8300da5f55ed7da1c2ab96",
"date": "2019-11-16 17:32:49 -0500",
"subject": "Allow zero-length substrings to be extracted from the end of a string.",
"body": "The previous assert was a bit overzealous and did not allow this case. It's not very common but still occasionally useful."
},
{
"commit": "8a3de1e05a427bf40b7742ac476c01ef219f6b46",
"date": "2019-11-16 17:30:08 -0500",
"subject": "Add storageInfo() support to remote storage driver."
},
{
"commit": "8d6a8c3bf0401705578d05902f8e7f871f3ab266",
"date": "2019-11-16 17:12:16 -0500",
"subject": "Store base path for remote storage locally.",
"body": "It wasn't practical for the main process to be ignorant of the remote path, and in any case knowing the path makes debugging easier.\n\nPull the remote path when connecting and pass the result of local storagePath() to the remote when making calls."
},
{
"commit": "6827a13f3a4b1943769601acf34676bd1f689b4b",
"date": "2019-11-16 17:05:34 -0500",
"subject": "Add facility for reading and writing adhoc protocol output.",
"body": "Pushing output through a JSON blob is not practical if the output is extremely large, e.g. a backup manifest with 100K+ files.\n\nAdd read/write routines so that output can be returned in chunks but errors will still be detected."
},
{
"commit": "90e19d99bab6b448484865cb6b46fb786352009c",
"date": "2019-11-16 09:38:42 -0500",
"subject": "Add mock module to CentOS6/7 Travis CI testing.",
"body": "This was dropped at some point but is important for integration coverage."
},
{
"commit": "c8db11e65bed37ec18d83b527c895b8b86c9f11b",
"date": "2019-11-15 17:50:12 -0500",
"subject": "Add user-id/group-id to hrnReplaceKey()."
},
{
"commit": "53a2d04ab0e0c6d3ef75afcef1663492d9db98e7",
"date": "2019-11-15 17:48:25 -0500",
"subject": "Allow \"null\" in jsonToStr()."
},
{
"commit": "64ddc163c95b6bc87a7589462b1b16ca70cb08bc",
"date": "2019-11-15 10:50:17 -0500",
"subject": "Allow cipherPassSub() to be set in Info without the constructor.",
"body": "This value is not always known when the object is created so allow it to be set later."
},
{
"commit": "48e8942e86b1471568116dc7fe604878ca9afd70",
"date": "2019-11-15 08:53:15 -0500",
"subject": "Allow trailing / for relative paths in strPathAbsolute().",
"body": "The trailing / does nothing but is nevertheless valid syntax."
},
{
"commit": "83ab272171887092df85704e27ddfec22c9f335f",
"date": "2019-11-14 16:50:58 -0500",
"subject": "Update varNew*() calls to Variant constant macros.",
"body": "The constants created by the macros are faster and use less memory."
},
{
"commit": "3b879c2cb3cfdbcd03dad1d6cc898052f8d8863d",
"date": "2019-11-14 16:48:41 -0500",
"subject": "Filter logged command options based on the command definition.",
"body": "Previously, options were being filtered based on what was currently valid. For chained commands (e.g. backup then expire) some options may be valid for the first command but not the second.\n\nFilter based on the command definition rather than what is currently valid to avoid logging options that are not valid for subsequent commands. This reduces the number of options logged and will hopefully help avoid confusion and expect log churn."
},
{
"commit": "c5b76d213bc24d703e7b973df171a2b01595dabc",
"date": "2019-11-12 17:05:09 -0500",
"subject": "Modify InfoBackupData struct to use time_t for backup start/stop times.",
"body": "The uint64_t types worked but were not consistent with how timestamps are handled in other parts of the code."
},
{
"commit": "6f65dde8d39436a31f90030e9b3cef5cf10d04e3",
"date": "2019-11-12 15:56:28 -0500",
"subject": "Begin v2.20 development."
},
{
"commit": "2d10293d041cbbc72e4a2bac32401f6f384ecb1a",
"date": "2019-11-12 15:51:28 -0500",
"subject": "v2.19: C Migrations and Bug Fixes"
},
{
"commit": "a44c5d0315e49c42eb908a4ed0605bee0c509f6d",
"date": "2019-11-12 13:12:07 -0500",
"subject": "Add Strings for STORAGE_REPO_ARCHIVE and STORAGE_REPO_BACKUP.",
"body": "These constants are used often enough that they deserve to have String constants rather than repeatedly calling STRDEF()."
},
{
"commit": "10c8eeaf6c0413da265047aeb02a047209ef9d69",
"date": "2019-11-08 18:58:45 -0500",
"subject": "Fix handling of repeated HTTP headers.",
"body": "When HTTP headers are repeated they should be considered equivalent to a single comma-separated header rather than generating an error, which was the prior behavior."
},
{
"commit": "43171786336733d8e1efe672b801236fd3e2d829",
"date": "2019-11-08 17:56:34 -0500",
"subject": "Update MinIO to newest release.",
"body": "We had some problems with newer versions so had held off on updating. Those problems appear to have been resolved.\n\nIn addition, the --compat flag is no longer required. Prior versions of MinIO required all parts of a multi-part upload (except the last) to be of equal size. The --compat flag was introduced to restore the default S3 behavior. Now --compat is only required when ETag is being used for MD5 verification, which we don't do."
},
{
"commit": "edcc7306a39852ddff507d384555230001442bf4",
"date": "2019-11-08 09:46:00 -0500",
"subject": "Add TIME parameter debug type.",
"body": "Previously we were using int64_t to debug time_t but this may not be right depending on how the compiler represents time_t, e.g. it could be a float.\n\nSince a mismatch would have caused a compiler error we are not worried that this has actually happened, and anyway the worst case is that the debug log would be wonky.\n\nThe primary benefit, aside from correctness, is that it makes choosing a parameter debug type for time_t obvious."
},
{
"commit": "eca00e0be00bcd692b10de1b89a700f6525d51a7",
"date": "2019-11-07 13:11:01 -0500",
"subject": "Add building a development environment to contributing documentation.",
"body": "This documentation shows how to build a development environment on Ubuntu 19.04 and should work for other Debian-based distros.\n\nNote that this document is not included in automated testing due to some unresolved issues with Docker in Docker on Travis CI. We'll address this in the future when we add contributing documentation to the website."
},
{
"commit": "8b682b75d2ade2e52c75b417fad2eb61150616d1",
"date": "2019-11-02 10:35:48 +0100",
"subject": "Allow mock integration tests for all VM types.",
"body": "Previously the mock integration tests would be skipped for VMs other than the standard four used in CI. Now VMs outside the standard four will run the same tests as VM4 (currently U18)."
},
{
"commit": "b3e5d88304860fbcb566059d08cbf85e2c3cd95a",
"date": "2019-11-02 09:59:39 +0100",
"subject": "Add markdown renderer for execute-list block."
},
{
"commit": "7168e0744018d7d27668d59bfe9b6deafe923efa",
"date": "2019-10-30 14:55:25 +0100",
"subject": "Use getcwd() to construct path when WAL path is relative.",
"body": "Using pg1-path, as we were doing previously, could lead to WAL being copied to/from unexpected places. PostgreSQL sets the current working directory to PGDATA so we can use that to resolve relative paths."
},
{
"commit": "e06db21e35f701b62c625b9f25436459b8fd5c26",
"date": "2019-10-17 14:00:18 +0200",
"subject": "Error when specified vm is invalid."
},
{
"commit": "a52faf83a502427a7079ec2bae0593b318c2594c",
"date": "2019-10-17 11:56:45 +0200",
"subject": "Disable code generation on dry-run."
},
{
"commit": "fa6a54bb4503efdc8e02a98089a935b6d52a3797",
"date": "2019-10-16 17:05:24 +0200",
"subject": "Update last tests that required sudo.",
"body": "All tests should now run in a sudo-less environment."
},
{
"commit": "48bd9e22f124163aa61574027476af8b3737dc39",
"date": "2019-10-16 15:48:33 +0200",
"subject": "C test harness refactor.",
"body": "Consolidate setting configuration into hrnInit() and rename other functions for consistency.\n\nSplit out internal functions into a new header."
},
{
"commit": "b4aeb217e665a166cb75577e07f80b01bc0345d1",
"date": "2019-10-15 17:19:42 +0200",
"subject": "Allow parameters to be passed to travis.pl.",
"body": "This makes configuring tests easier.\n\nAlso add a parameter for tests that require sudo. This should be retired at some point but some tests still require it."
},
{
"commit": "f3b2189659a7f0e8e660c1be42175f0ff82cffb0",
"date": "2019-10-15 13:27:03 +0200",
"subject": "Remove package build sudo into the container.",
"body": "By running this in the container we no longer need sudo on the host system for package builds."
},
{
"commit": "67dde73727d2b30ce3f329054398a1f516a65899",
"date": "2019-10-14 11:51:14 +0200",
"subject": "Run tests in tmpfs.",
"body": "This will likely improve performance, but it also makes the filesystem consistent between platforms.\n\nA number of tests were failing on shiftfs, which was the default for arm64 on Travis."
},
{
"commit": "b1dc5a6d269b858960061e59f3885303d2417051",
"date": "2019-10-13 14:02:52 -0400",
"subject": "Add disk/mem info for Travis.",
"body": "This is helpful for determining the virtual machine resources."
},
{
"commit": "64c6102a1536ba94f4957fe950038f31525748b5",
"date": "2019-10-12 14:47:01 -0400",
"subject": "Update packages required for Travis-CI builds.",
"body": "These packages are expected on the arm64 build even though we are using the same os image as amd64. It appears the arm64 image is slimmer."
},
{
"commit": "35eef2b8676115036b9d68b14223629dd1e1b773",
"date": "2019-10-12 14:16:22 -0400",
"subject": "Use a lower user id for posix storage tests.",
"body": "arm64 was not happy with the old user id, so use something smaller."
},
{
"commit": "827e95944a2f13301fa14af5a8f11324e17a1cd9",
"date": "2019-10-12 13:52:45 -0400",
"subject": "Use < 0 and > 0 for strCmp() tests.",
"body": "Using -1 and 1 was a bit sloppy since the spec only guarantees that the values will be < 0 and > 0.\n\nFound on arm64 where the values were -64 and 64."
},
{
"commit": "a2fa1d04b0cbd6dbedaa2447273371c20bd46e56",
"date": "2019-10-12 11:26:13 -0400",
"subject": "Update container images to PostgreSQL 12 GA."
},
{
"commit": "397a41e0f9f82987952912b8127a5e6929e29752",
"date": "2019-10-12 11:24:55 -0400",
"subject": "Add Ubuntu 19.04 container definition."
},
{
"commit": "93656db186e6da286bd704dc65235fcc209bb19d",
"date": "2019-10-12 11:24:21 -0400",
"subject": "Update lcov to 1.14.",
"body": "1.13 is not compatible with gcc 8 which is what ships with newer distributions. Build from source to get a more recent version.\n\n1.13 is not compatible with gcc 9 so we'll need to address that at a later date."
},
{
"commit": "11c7c8fabb1e3eb9dadce2231fbb9cb3d76d553f",
"date": "2019-10-12 09:45:18 -0400",
"subject": "Remove pgbackrest test user.",
"body": "This user was created before we tested in containers to ensure isolation between the pg and repo hosts which were then just directories. The downside is that this resulted in a lot of sudos to set the pgbackrest user and to remove files which did not belong to the main test user.\n\nContainers provide isolation without needing separate users so we can now safely remove the pgbackrest user. This allows us to remove most sudos, except where they are explicitly needed in tests.\n\nWhile we're at it, remove the code that installed the Perl C library (which also required sudo) and simply add the build path to @INC instead."
},
{
"commit": "6f0e7f00af3e83d071713a671a6f155cd1fa3b88",
"date": "2019-10-12 09:26:19 -0400",
"subject": "Fix recovery test failing in PostgreSQL 12.0.",
"body": "This test was not creating recovery.signal when testing with --type=preserve. The preserve recovery type only keeps existing files and does not create any.\n\nRC1 was just ignoring recovery.signal and going right into recovery. Weirdly, 12.0 used restore_command to do crash recovery which made the problem harder to diagnose, but this has now been fixed in PostgreSQL and should be released in 12.1."
},
{
"commit": "59a4a0c1b1726812126a13e57bee29689b0a8fdc",
"date": "2019-10-11 13:14:47 -0400",
"subject": "Add a warning about jq rounding numbers to the documentation."
},
{
"commit": "db1dc4f275667903f560c140c2c61cce7f9b4020",
"date": "2019-10-11 13:03:52 -0400",
"subject": "Remove pretty-printing from jsonFromKv() and jsonFromVar().",
"body": "Now that pretty-printing has been removed from the info command it no longer has a purpose, so remove it."
},
{
"commit": "d90b2724f883686afdae386c1350abfdcfb0d5fa",
"date": "2019-10-11 12:56:03 -0400",
"subject": "JSON output from the info command is no longer pretty-printed.",
"body": "Monitoring systems can more easily ingest the JSON without linefeeds.\n\nExternal tools such as jq can be used to pretty-print if desired."
},
{
"commit": "29725805668656a920283401ef144a98cee2c5f9",
"date": "2019-10-11 12:38:03 -0400",
"subject": "Remove info expect tests from mock/all and mock/stanza.",
"body": "These tests are redundant now that we have full coverage in the unit tests are are not worth maintaining anymore."
},
{
"commit": "e4408c7dd390b13bb022b29e8f0b151fa0526362",
"date": "2019-10-11 12:28:47 -0400",
"subject": "Refactor --pre option in documentation.",
"body": "Mark all pre commands as skip so they won't be run again after the container is built.\n\nEnsure that pre commands added to the container are run as the container user if they are not intended to run as root."
},
{
"commit": "642ce003c8e8f59ec67d3bda4c18decb4aa21ae2",
"date": "2019-10-11 11:32:51 -0400",
"subject": "Don't autogenerate embedded libc code by default.",
"body": "This is only needed when new code is added to the Perl C library, which is becoming rare as the migration progresses.\n\nAlso, the code will vary slightly based on the Perl version used for generation so for normal users it is just noise."
},
{
"commit": "bcd3e4953aa1c8e8ccfadd141f38473b2ecbaff6",
"date": "2019-10-10 22:10:20 -0400",
"subject": "Make perl/exec test container required.",
"body": "This test fails in some cases when --vm=none but it's not worth investigating since this code will be going away soon."
},
{
"commit": "e3d87ebace36984728ae571a77ca1e11ae383d5b",
"date": "2019-10-10 19:43:42 -0400",
"subject": "Fix mismatched timezone in expect test.",
"body": "Also run the --vm-none tests in a non-UTC timezone to prevent regressions."
},
{
"commit": "6db4e59a6631eb47758fd0dff772e2ca086e924b",
"date": "2019-10-10 16:13:43 -0400",
"subject": "Allow tests that use ports to run in parallel.",
"body": "Set the test index in the C unit test code so it can assign port numbers that won't conflict between tests."
},
{
"commit": "13fcbb24e940084710acc13627515522215369dc",
"date": "2019-10-10 15:09:11 -0400",
"subject": "Fix container test path being used when --vm=none."
},
{
"commit": "e732720d855cffa0e4bb80997529254323fd7767",
"date": "2019-10-10 11:28:37 -0400",
"subject": "Disable docker service for --vm=none test.",
"body": "Starting this service wastes time and this will help catch any regressions where containers are being built when they should not be."
},
{
"commit": "9a3ba649e111f3529bb6fe09238d9fcb81454487",
"date": "2019-10-10 11:25:59 -0400",
"subject": "Remove code to generate .travis.yml.",
"body": "Most of the logic has been moved to test/travis.pl so there wasn't much purpose to this code anymore."
},
{
"commit": "696e6a7c444ba0ec3a28f8762b6a7266751faa0f",
"date": "2019-10-10 11:21:09 -0400",
"subject": "Don't require sudo to run tests with --vm=none.",
"body": "Run these tests without sudo privileges on Travis to prevent regressions."
},
{
"commit": "50d1d0a4e8f232842a27c4998cb6af3f1d906bf3",
"date": "2019-10-10 09:28:50 -0400",
"subject": "Move release note to correct section."
},
{
"commit": "47e0ba2502e5c3e8eb088ffcbd774144741b599b",
"date": "2019-10-10 09:27:46 -0400",
"subject": "Fix remote timeout in delta restore.",
"body": "When performing a delta restore on a largely unchanged cluster the remote could timeout if no files were fetched from the repository within protocol-timeout.\n\nAdd keep-alives to prevent remote timeout."
},
{
"commit": "82baf1e521e2a1ed7b27403478aa4a1dc4a6afcc",
"date": "2019-10-10 08:33:40 -0400",
"subject": "Fix typo."
},
{
"commit": "7f369006b5c812d0d3e05f4735d03623c3873b45",
"date": "2019-10-09 15:03:03 -0400",
"subject": "Add gcc 9 support.",
"body": "A number of tests have been updated and Fedora 30 has been added to the test suite so the unit tests can run on gcc 9.\n\nStop running unit tests on co6/7 since we appear to have ample unit test coverage."
},
{
"commit": "528f4c4347d89a0c05b0a9521e8ef91432616b0c",
"date": "2019-10-09 14:38:24 -0400",
"subject": "Remove dependency on aws cli for testing.",
"body": "This tool was only being used it a few places but was a pretty large dependency.\n\nRework the forceStorageMove() code using our storage layer and replace one aws cli cp with a storage put.\n\nAlso, remove the Dockerfile that was once used to build the Scality S3 test container."
},
{
"commit": "ac870b42de5a51436a4a08c6ad405ac4f1dd0763",
"date": "2019-10-09 08:43:30 -0400",
"subject": "Refactor error logic to make sure Db object gets freed immediately.",
"body": "Because db can be reset to NULL on an error in the try block we need nested try blocks to ensure that db is non-NULL and can be freed on an error after being created.\n\nThis is not a production issue because the db will be freed when the temp mem context is freed, but it does affect reproducibility in the tests and is a bit tidier."
},
{
"commit": "61c4f64895497da4cbe1e9225f274d255dd5133e",
"date": "2019-10-08 18:56:55 -0400",
"subject": "Be smarter about which packages are loaded for testing.",
"body": "Now that our tests are more diversified it makes sense to load only the packages that are needed for each test.\n\nMove the package loads from .travis.yaml to test/travis.pl where we have more control over what is loaded."
},
{
"commit": "a1c13a50dd0886076a1f32e58901eec271d9ec9a",
"date": "2019-10-08 18:04:09 -0400",
"subject": "The check command is implemented entirely in C.",
"body": "Note that building the manifest on each host has been temporarily removed.\n\nThis feature will likely be brought back as a non-default option (after the manifest code has been fully migrated to C) since it can be fairly expensive."
},
{
"commit": "ecae5e34e5063838bb55d55b1752c6b2eaaaa75b",
"date": "2019-10-08 17:30:33 -0400",
"subject": "Update expire command to use C backup.info reconstruct.",
"body": "This was still being done in Perl until the C Manifest object was available."
},
{
"commit": "4e4d1f414a153232079f2e2e9ce203ffc5a2362c",
"date": "2019-10-08 16:04:27 -0400",
"subject": "Add infoBackupLoadFileReconstruct() to InfoBackup object.",
"body": "Check the backup.info file against the backup path. Add any backups that are missing and remove any backups that no longer exist.\n\nIt's important to run this before backup or expire to be sure we are using the most up-to-date list of backups."
},
{
"commit": "b2825b82c7b8cf140969dd4e9fd04552e921bbfc",
"date": "2019-10-08 15:47:47 -0400",
"subject": "Add missing header file."
},
{
"commit": "6d8d0eeba71fa7cd00af6e40c0adf74638a371bd",
"date": "2019-10-08 15:37:08 -0400",
"subject": "Add pgBackRest version to Info and Manifest objects.",
"body": "This was not being exposed previously because it is primarily informational, but now it is needed to reconstruct the backup.info file."
},
{
"commit": "38b72eded4b0f295ed1f30f849f0a99f69e396d2",
"date": "2019-10-08 15:27:17 -0400",
"subject": "Document how to contribute to pgBackRest.",
"body": "There's a lot more to be done here, but this is a good start."
},
{
"commit": "a4152a0ea1dc5c28515aedf9690cab22765076cb",
"date": "2019-10-08 12:29:42 -0400",
"subject": "Update release instructions with a reminder to install latex.",
"body": "Latex is no longer installed by default in the Vagrantfile."
},
{
"commit": "45881c74aeff4bb25559ec0254fa7fc1960d9cab",
"date": "2019-10-08 12:06:30 -0400",
"subject": "Allow most unit tests to run outside of a container.",
"body": "Three major changes were required to get this working:\n\n1) Provide the path to pgbackrest in the build directory when running outside a container. Tests in a container will continue to install and run against /usr/bin/pgbackrest.\n\n1) Set a per-test lock path so tests don't conflict on the default /tmp/pgbackrest path. Also set a per-test log-path while we are at it.\n\n2) Use localhost instead of a custom host for TLS test connections. Tests in containers will continue to update /etc/hosts and use the custom host.\n\nAdd infrastructure and update harnessCfgLoad*() to get the correct exe and paths loaded for testing.\n\nSince new tests are required to verify that running outside a container works, also rework the tests in Travis CI to provide coverage within a reasonable amount of time. Mainly, break up to doc tests by VM and run an abbreviated unit test suite on co6 and co7."
},
{
"commit": "77b0c6c993a0e6ff45a6a99f343c3709a016d152",
"date": "2019-10-08 10:35:47 -0400",
"subject": "Add missing spaces."
},
{
"commit": "5394893e33a844991a913e3b3c8874b435ac88d1",
"date": "2019-10-03 11:14:22 -0400",
"subject": "Remove pgPath parameter from pgControlFromFile().",
"body": "In practice this function is always used with storagePg*() so pgPath is known."
},
{
"commit": "887ec97e0743f758a0a2d2222cd1553b91f0908d",
"date": "2019-10-03 06:58:52 -0400",
"subject": "Document maximum version for auto-stop option."
},
{
"commit": "008ec6b05c631adf08cba312d6bab972f02881ef",
"date": "2019-10-01 17:04:26 -0400",
"subject": "Begin v2.19 development."
},
{
"commit": "4629237d6a308a250cd52fff49693cd0a1069253",
"date": "2019-10-01 16:02:07 -0400",
"subject": "v2.18: PostgreSQL 12 Support"
},
{
"commit": "29e132f5e928298e9be135d76674f2016b122029",
"date": "2019-10-01 13:20:43 -0400",
"subject": "PostgreSQL 12 support.",
"body": "Recovery settings are now written into postgresql.auto.conf instead of recovery.conf. Existing recovery_target* settings will be commented out to help avoid conflicts.\n\nA comment is added before recovery settings to identify them as written by pgBackRest since it is unclear how, in general, old settings will be removed.\n\nrecovery.signal and standby.signal are automatically created based on the recovery settings."
},
{
"commit": "6be7e6fde54f2dc3edbed802efc3f5cb1e050fd2",
"date": "2019-10-01 10:25:08 -0400",
"subject": "Fix misplaced String declarations."
},
{
"commit": "309ae66e2fbd128b54f0859b231c14f6ab1518c4",
"date": "2019-10-01 08:47:56 -0400",
"subject": "Remove unneeded static declarations and use sizeof() where appropriate."
},
{
"commit": "f96c54c4ba0e526cda4cf9bed5cc1231b1d819b5",
"date": "2019-09-30 12:39:38 -0400",
"subject": "Add info command set option for detailed text output.",
"body": "The additional details include databases that can be used for selective restore and a list of tablespaces and symlinks with their default destinations.\n\nThis information is not included in the JSON output because it requires reading the manifest which is too IO intensive to do for all manifests. We plan to include this information for JSON in a future release."
},
{
"commit": "33ec5a3aacdfe0dd258463c0cbcd43f0d155152e",
"date": "2019-09-29 09:05:55 -0400",
"subject": "Sort lists where it might help performance.",
"body": "Most of these lists should be quite small with the exception of the list in get.c, but it doesn't cost much to sort them and may help in corner cases we have not thought of."
},
{
"commit": "a58635ac0285fbb3178329bdc222221fe7160380",
"date": "2019-09-28 14:24:27 -0400",
"subject": "Move C performance tests out of unit tests.",
"body": "Performance tests were being done in unit tests until there was a better place to put them.\n\nNow there is, so move them there."
},
{
"commit": "f1ba428fb037eac7b6c6ea5b9f617d1ad4579026",
"date": "2019-09-28 14:02:12 -0400",
"subject": "Add performance test capability in C with scaling.",
"body": "Scaling allows the starting values to be increased from the command-line without code changes.\n\nAlso suppress valgrind and assertions when running performance testing. Optimization is left at -O0 because we should not be depending on compiler optimizations to make our code performant, and it makes profiling more informative."
},
{
"commit": "004ff99a2d918fa3a5079ce9d7ff2f5b120176e3",
"date": "2019-09-28 13:17:21 -0400",
"subject": "Identify Perl performance test by appending -perl.",
"body": "This is intended to differentiate the upcoming C performance tests from the Perl performance tests that will eventually be migrated."
},
{
"commit": "cb62bebadf62613b770f79cd4fd43e20ec7db10c",
"date": "2019-09-28 10:08:20 -0400",
"subject": "Use bsearch() on sorted lists rather than an iterative method.",
"body": "bsearch() is far more efficient than an iterative approach except in the most trivial cases.\n\nFor now insert will reset the sort order to none and the list will need to be resorted before bsearch() can be used. This is necessary because item pointers are not stable after a sort, i.e. they can move around. Until lists are stable it's not a good idea to surprise the caller by mixing up their pointers on insert."
},
{
"commit": "d3d2a7cd8606be9696957eb052ca6569db1a8167",
"date": "2019-09-28 09:57:06 -0400",
"subject": "Add line number and fix spacing in TEST_LOG*() macros."
},
{
"commit": "afc483ef86aefe2cf8f057b6159af2c54f77c28b",
"date": "2019-09-27 13:37:59 -0400",
"subject": "Clarify which timeline should be used for timeline integration test."
},
{
"commit": "0a4122c77dc2e3fb866b95be73c2831530b2def1",
"date": "2019-09-27 13:34:59 -0400",
"subject": "Add reviewer."
},
{
"commit": "6355451870c90be346a378ef8b301f182c635edb",
"date": "2019-09-27 13:33:14 -0400",
"subject": "Fix old option name in documentation."
},
{
"commit": "d82102d6ef5445e5c96e47a095210f36a618b800",
"date": "2019-09-27 13:04:36 -0400",
"subject": "Add explicit promotes to recovery integration tests.",
"body": "PostgreSQL 12 will shutdown in these cases which seems to be the correct action (according to the documentation) when hot_standby = off, but older versions are promoting instead. Set target_action explicitly so all versions will behave the same way.\n\nThis does beg the question of whether the PostgreSQL 12 behavior is wrong (though it matches the docs) or the previous versions are."
},
{
"commit": "833d0da0d96036ada9e2397e2b1484d2032c25fa",
"date": "2019-09-27 12:29:33 -0400",
"subject": "Store recovery file name in integration when testing preserve recovery.",
"body": "This makes the test a little more maintainable and is friendly with the changes needed for PostgreSQL 12."
},
{
"commit": "80eb561cafc1af645e689cca865158e4336c143d",
"date": "2019-09-27 09:45:11 -0400",
"subject": "Add missing PostgreSQL 11 control/WAL versions in Perl tests.",
"body": "These values don't seem to be used for testing but better to be tidy."
},
{
"commit": "d6a6d93a041af1b8e333d8e9b68b151ae43e564d",
"date": "2019-09-27 09:35:59 -0400",
"subject": "Add PostgreSQL 12 to u18 container.",
"body": "This does not add PostgresQL 12 support; it simply adds PostgreSQL 12 to the u18 container for development and testing."
},
{
"commit": "03a7bda511b293cf40fd8324951ace1252d40ac2",
"date": "2019-09-27 09:19:12 -0400",
"subject": "Refactor recovery file generation.",
"body": "Separate the generation of recovery values and formatting them into recovery.conf format. This is generally a good idea, but also makes the code ready to deal with a different recovery file in PostgreSQL 12.\n\nAlso move the recovery file logic out of cmdRestore() into restoreRecoveryWrite()."
},
{
"commit": "cf1e96e827d154a62c0b52ff5531dd687695bf73",
"date": "2019-09-27 08:50:33 -0400",
"subject": "Refactor handling of ignored files in restore delta cleanup.",
"body": "Replace the boolean logic with a simple list that will be checked to see if the file should be ignored."
},
{
"commit": "c41fb575fbef7b4ce9714986b08f48d32b719862",
"date": "2019-09-26 17:39:45 -0400",
"subject": "Add standby restore type.",
"body": "This restore type automatically adds standby_mode=on to recovery.conf.\n\nThis could be accomplished previously by setting --recovery-option=standby_mode=on but PostgreSQL 12 requires standby mode to be enabled by a special file named standby.signal.\n\nThe new restore type allows us to maintain a common interface between PostgreSQL versions."
},
{
"commit": "89793368196e4073ca7137f2bf21edb385fb9ef6",
"date": "2019-09-26 16:02:39 -0400",
"subject": "Comment out unprivileged user documentation.",
"body": "We haven't had the time to complete this documentation and it has suffered bit rot.\n\nThis prevents us from building the docs on PostgreSQL >= 11 so just comment it all out until it can be updated."
},
{
"commit": "451ae397bec3f3bc070c4db674cc5df61bd63498",
"date": "2019-09-26 07:52:02 -0400",
"subject": "The restore command is implemented entirely in C.",
"body": "For the most part this is a direct migration of the Perl code into C.\n\nThere is one important behavioral change with regard to how file permissions are handled. The Perl code tried to set ownership as it was in the manifest even when running as an unprivileged user. This usually just led to errors and frustration.\n\nThe C code works like this:\n\nIf a restore is run as a non-root user (the typical scenario) then all files restored will belong to the user/group executing pgBackRest. If existing files are not owned by the executing user/group then an error will result if the ownership cannot be updated to the executing user/group. In that case the file ownership will need to be updated by a privileged user before the restore can be retried.\n\nIf a restore is run as the root user then pgBackRest will attempt to recreate the ownership recorded in the manifest when the backup was made. Only user/group names are stored in the manifest so the same names must exist on the restore host for this to work. If the user/group name cannot be found locally then the user/group of the PostgreSQL data directory will be used and finally root if the data directory user/group cannot be mapped to a name."
},
{
"commit": "92e48c856ac87838c479c2a454fe007cf026d4bd",
"date": "2019-09-26 07:27:07 -0400",
"subject": "Add missing asserts."
},
{
"commit": "f2781bdad4bbe2afba4a0eda7df90753c63ccf03",
"date": "2019-09-25 16:38:13 -0400",
"subject": "Allow documentation to be built without encryption.",
"body": "This is mainly useful for testing, where an encrypted repo is a real nuisance."
},
{
"commit": "e968acbdd74db8f78f718cbe5bd6358107bcf822",
"date": "2019-09-24 16:55:11 -0400",
"subject": "Fix outdated comment.",
"body": "This was probably missed when a new test was added and the timeline was updated."
},
{
"commit": "6af64df9b6519897a55a733583ee40a571a51ee6",
"date": "2019-09-23 19:26:24 -0400",
"subject": "Thoughts on repository version 6."
},
{
"commit": "71349c89aecdb3b158d1638d0310cdba6c96362a",
"date": "2019-09-23 17:56:17 -0400",
"subject": "Add TEST_TITLE() macro.",
"body": "This macro displays a title for each test. A test frequently has multiple parts and it was hard to tell which subparts went together. We used ad hoc indentation to do this.\n\nAnything that is a not a title is automatically indented so manually indenting is not longer needed. This should make the tests and the test output easier to read."
},
{
"commit": "2fd2fe509f3039ef28766b865f3b66cc524dee04",
"date": "2019-09-23 17:20:47 -0400",
"subject": "Add TEST_RESULT_LOG*() and TEST_SYSTEM*() macros.",
"body": "These macros encapsulate the functionality provided by direct calls to harnessLogResult() and system(). They both have _FMT() variants.\n\nThe primary advantage is that {[path]}, {[user]}, and {[group]} will be replaced with the test path, user, and group respectively. This saves a log of strNewFmt() calls and makes the tests less noisy."
},
{
"commit": "d3a7055ee5d290da0196ba266051846c107ddede",
"date": "2019-09-23 15:15:04 -0400",
"subject": "Only enable test.pl --debug-test-trace option when --debug also enabled.",
"body": "The other way makes no sense and leads to compile errors since --debug-test-trace requires some code that is only enabled by --debug."
},
{
"commit": "072aeb810932605bb5e2b8ef64288f24913ddd04",
"date": "2019-09-23 15:10:31 -0400",
"subject": "Add LFs to storage list tests.",
"body": "This makes the diffs easier to read when testing."
},
{
"commit": "c969137021da5dc03e5f95d36080f4e4fd08522b",
"date": "2019-09-23 13:50:46 -0400",
"subject": "Migrate backup manifest load/save to C.",
"body": "The backup manifest stores a complete list of all files, links, and paths in a backup along with metadata such as checksums, sizes,\ntimestamps, etc. A list of databases is also included for selective restore.\n\nThe purpose of the manifest is to allow the restore command to confidently reconstruct the PostgreSQL data directory and ensure that\nnothing is missing or corrupt. It is also useful for reporting, e.g. size of backup, backup time, etc.\n\nFor now, migrate enough functionality to implement the restore command."
},
{
"commit": "5b64c93e8b1de010176b8d3927f80cc8039f4dbc",
"date": "2019-09-20 17:50:49 -0400",
"subject": "Add local option for cfgExecParam().",
"body": "cfgExecParam() was originally written to provide options for remote processes. Remotes processes do not have access to the local config so it was necessary to pass every non-default option.\n\nLocal processes on the other hand, e.g. archive-get, archive-get-async, archive-push-async, and local, do have access to the local config and therefore don't need every parameter to be passed on the command-line. The previous way was not wrong, but it was overly verbose and did not align with the way Perl had worked.\n\nUpdate cfgExecParam() to accept a local option which excludes options from the command line which can be read from local configs."
},
{
"commit": "3f18040aab5707c9be9b51fe37f3464d222fceb5",
"date": "2019-09-20 08:13:36 -0400",
"subject": "Rename MANIFEST_FILE to BACKUP_MANIFEST_FILE.",
"body": "This is a bit more descriptive and avoids a naming conflict in the new C manifest code."
},
{
"commit": "174cb7b3af6b40d171186060509252c256208cd6",
"date": "2019-09-19 22:42:28 -0400",
"subject": "Add strPathAbsolute() and strLstRemoveIdx().",
"body": "strPathAbsolute() generates an absolute path from an absolute base path and an absolute/relative path.\n\nstrLstRemoveIdx() is a support function based on lstRemoveIdx()."
},
{
"commit": "9421493d09033efda2d5e2cc6eb60d13491beca3",
"date": "2019-09-19 22:34:12 -0400",
"subject": "Allow resets when generating local/remote command options.",
"body": "Somehow this was left out of the original implementation, but it is particularly important for certain types of restores."
},
{
"commit": "e24b2e3f4dcb0a288b4e742fd0b198b768d6320a",
"date": "2019-09-18 22:23:04 -0400",
"subject": "Only test timestamps for files.",
"body": "In general we don't care about path and link times since they are easily recreated when restoring.\n\nSo, outside of storageInfo() we don't need to bother testing them."
},
{
"commit": "54638e87042b2315f24abef2d7f8c5610c53762e",
"date": "2019-09-18 22:17:22 -0400",
"subject": "Add strLstRemove().",
"body": "Allow a string to be removed from a StringList using the underlying lstRemove()."
},
{
"commit": "a6a42b18a9c28b1410df803d7073340b2d7d52c6",
"date": "2019-09-18 22:09:49 -0400",
"subject": "Use switch instead of if else tree in jsonFromKvInternal().",
"body": "This is more efficient but more importantly it is easier to read."
},
{
"commit": "60d93df503c234730109c87114068dde4203804e",
"date": "2019-09-18 07:15:16 -0400",
"subject": "Use a callback to feed jobs to ProtocolParallel.",
"body": "Loading jobs in advance uses a lot of memory in the case that there are millions of jobs to be performed. We haven't seen this yet, but with backup and restore on the horizon it will become the norm.\n\nInstead, use a callback so that jobs are only created as they are needed and can be freed as soon as they are completed."
},
{
"commit": "ce1c7b02520f2e37dfcfb283471fb4ec263b5d50",
"date": "2019-09-17 21:04:38 -0400",
"subject": "Ignore write errors when the ls command is writing to stdout.",
"body": "It's possible (even likely) that the ls output is being piped to something like head which will exit when it gets what it needs and leave us writing to a broken pipe.\n\nIt would be better to just ignore the broken pipe error but currently we don't store system error codes."
},
{
"commit": "8675699d08b91c57294becfcf27dbf7ddb594c46",
"date": "2019-09-16 14:09:53 -0400",
"subject": "Add FAQ for time-based Point-in-Time Recovery."
},
{
"commit": "49b421d372144df726d71552850e55cee298a566",
"date": "2019-09-16 13:56:25 -0400",
"subject": "Add documentation clarifications regarding standby repositories.",
"body": "Clarify that placing the repository on a standby is not a robust configuration and recommend against it."
},
{
"commit": "09ef03b7ef69d2760756146cad86b784b0b5d7c3",
"date": "2019-09-15 08:27:38 -0400",
"subject": "Add FAQ regarding backup-standby."
},
{
"commit": "f9c8bd31de89cc1140fe37e3996672bbb1c99934",
"date": "2019-09-14 14:10:04 -0400",
"subject": "Add required FreeBSD header."
},
{
"commit": "56bf9d0566bbb9708d1687e9d2e59be306e32dda",
"date": "2019-09-14 12:21:08 -0400",
"subject": "Update HINT messages to conform to new standard detailed in CODING.md."
},
{
"commit": "c5f496b903ab9a4fa545d5f1a0a8dae9ec5c49af",
"date": "2019-09-14 11:56:29 -0400",
"subject": "Rename parameter processId to processIdx in harnessFork.h for clarity."
},
{
"commit": "f57e119b25d73a4b33aa83b5484898c5d7e84dfb",
"date": "2019-09-13 12:28:39 -0400",
"subject": "Document the relationship between db-timeout and protocol-timeout."
},
{
"commit": "15d04ca19c0bd1aafe9d4389e8429bcc392e842d",
"date": "2019-09-12 16:29:50 -0400",
"subject": "Add recursion and json output to the ls command.",
"body": "These features finally make the ls command practical.\n\nCurrently the JSON contains only name, type, and size. We may add more fields in the future, but these seem like the minimum needed to be useful."
},
{
"commit": "e45baa1830ac5251fc4284d094c3e12920e50862",
"date": "2019-09-12 16:03:05 -0400",
"subject": "Add sorting, filters, and recursion to storageInfoList().",
"body": "These are needed for the ls command and are also useful for testing."
},
{
"commit": "92365fb801543f8d6d52037b1936b3cd42512238",
"date": "2019-09-12 15:55:18 -0400",
"subject": "Disable missing-field-initializers warnings in unit testing.",
"body": "This warning gives very unpredictable results between compiler versions and seems unrealistic since most of our structs are zeroed for initialization.\n\nThis warning has been disabled in the Makefile for a long time."
},
{
"commit": "f809d2f008a4d8d769b72a68ffff9ef75ab9de22",
"date": "2019-09-12 15:16:42 -0400",
"subject": "Ignore apt-get update errors in Travis CI.",
"body": "Broken vendor packages have been causing builds to break due to an error on apt-get update.\n\nIgnore errors and proceed directory to apt-get install. It's possible that we'll try to reference an expired package version and get an error anyway, but that seems better than a guaranteed hard error."
},
{
"commit": "506c10f7f270806aca8acecaa303bf4458463720",
"date": "2019-09-12 12:04:25 -0400",
"subject": "Sort and find improvements to List and StringList objects.",
"body": "Push the responsibility for sort and find down to the List object by introducing a general comparator function that can be used for both sorting and finding.\n\nUpdate insert and add functions to return the item added rather than the list. This is more useful in the core code, though numerous updates to the tests were required."
},
{
"commit": "e4a071ce033ae53dafb35eb9ccd4daba1030064c",
"date": "2019-09-12 10:56:45 -0400",
"subject": "Add missing header in common/user module."
},
{
"commit": "b53305cc361e9978807d506e3e8ec13b3ae93511",
"date": "2019-09-12 08:17:07 -0400",
"subject": "Update incorrect pipelining references to connection reuse.",
"body": "Connection reuse and pipelining are not the same thing and should not have been conflated.\n\nUpdate comments and release notes to reflect the correct usage."
},
{
"commit": "dca5b63f970be8a13cd11222f4b5a9d4ca71261e",
"date": "2019-09-10 13:06:44 -0400",
"subject": "Move documentation job first for Travis CI.",
"body": "Since this job has been running long recently this should improved overall performance when multiple commits are queued up."
},
{
"commit": "f4f21d0df7217bcb583189d0fc4ecaac3faed146",
"date": "2019-09-10 13:02:05 -0400",
"subject": "Add groupIdFromName() and userIdFromName() to user module.",
"body": "Update StorageWritePosix to use the new functions.\n\nA side effect is that storageWritePosixOpen() will no longer error when the user/group name does not exist. It will simply retain the original user/group, i.e. the user that executed the restore.\n\nIn general this is a feature since completing a restore is more important than setting permissions exactly from the source host. However, some notification of this omission to the user would be beneficial."
},
{
"commit": "f8d0574759340f0260f06e377da412041987f582",
"date": "2019-09-10 12:29:36 -0400",
"subject": "Increase process timeout and emit occasional warnings.",
"body": "Travis will timeout after 10 minutes with no output. Emit a warning every 5 minutes to keep Travis alive and increase the total timeout to 20 minutes.\n\nDocumentation builds have been timing out a lot recently so hopefully this will help."
},
{
"commit": "e043c6b1bc388422aee9255077544c3644b8f69d",
"date": "2019-09-09 07:37:57 -0400",
"subject": "Update comment missed in d957acb3."
},
{
"commit": "1049632873d5a70cda90e5c4ed87312bfe4810d6",
"date": "2019-09-08 20:11:51 -0400",
"subject": "Add user module for managing system users/groups.",
"body": "Centralize the management of users and groups.\n\nAlso update Posix storage driver where users/groups were already in use."
},
{
"commit": "d957acb36b6b50c6166d9a68b03f239cdc508fa7",
"date": "2019-09-08 06:53:23 -0400",
"subject": "Add function to generate PostgreSQL tablespace identifier.",
"body": "In PostgreSQL >= 9.0 each tablespace data is stored in a specially named directory so different major versions can share the same tablespace path."
},
{
"commit": "051128ed9ee0ebc63fb35e69818c6213397a053f",
"date": "2019-09-08 06:47:52 -0400",
"subject": "Add test macro for comparing String to zero-terminated strings.",
"body": "This macro avoids the need to wrap the first parameter in strPtr() and should improve readability."
},
{
"commit": "0a96764cb8daa615121069e840268e216d1983ff",
"date": "2019-09-07 18:04:39 -0400",
"subject": "Remove most references to PostgreSQL control and catalog versions.",
"body": "The control and catalog versions were stored a variety of places in the optimistic hope that they would be useful. In fact they never were.\n\nWe can't remove them from the backup.info and backup.manifest files due to backwards compatibility concerns, but we can at least avoid loading and storing them in C structures.\n\nAdd functions to the PostgreSQL interface which will return the control and catalog versions for any supported version of PostgreSQL to allow backwards compatibility for backup.info and backup.manifest. These functions will be useful in other ways, e.g. generating the tablespace identifier in PostgreSQL >= 9.0."
},
{
"commit": "843a602080e13ea0f205720892f7bfee58e075fb",
"date": "2019-09-07 15:41:55 -0400",
"subject": "Add user/group id to storageInfo().",
"body": "This is required for some operations on Posix storage."
},
{
"commit": "1c7c1042b4509ff3ad42dad240d895617f01d644",
"date": "2019-09-07 12:32:25 -0400",
"subject": "Remove extraneous semicolons and add spaces."
},
{
"commit": "2eb1d1fee315e1e757856d3d88eb74b8434dad74",
"date": "2019-09-06 16:50:57 -0400",
"subject": "Rename lstRemove() to lstRemoveIdx().",
"body": "This works better with the names of upcoming functions and seems sensible even in isolation."
},
{
"commit": "dde0c2b0c9c9743a863b6064e7dbb69de26fa364",
"date": "2019-09-06 16:43:53 -0400",
"subject": "Rename INFO_MANIFEST_FILE to MANIFEST_FILE.",
"body": "This was missed in 5c314df0 when the module was renamed."
},
{
"commit": "4d84820021ad2a96922c87263d9200aace42358f",
"date": "2019-09-06 13:48:28 -0400",
"subject": "Improve performance of info file load/save.",
"body": "Info files required three copies in memory to be loaded (the original string, an ini representation, and the final info object). Not only was this memory inefficient but the Ini object does sequential scans when searching for keys making large files very slow to load.\n\nThis has not been an issue since archive.info and backup.info are very small, but it becomes a big deal when loading manifests with hundreds of thousands of files.\n\nInstead of holding copies of the data in memory, use a callback to deliver the ini data directly to the object when loading. Use a similar method for save to avoid having an intermediate copy. Save is a bit complex because sections/keys must be written in alpha order or older versions of pgBackRest will not calculate the correct checksum.\n\nAlso move the load retry logic to helper functions rather than embedding it in the Info object. This allows for more flexibility in loading and ensures that stack traces will be available when developing unit tests."
},
{
"commit": "7334f30c350b5275106b9acf28b60d999287d800",
"date": "2019-09-06 13:35:28 -0400",
"subject": "Add helper function for adding CipherBlock filters to groups."
},
{
"commit": "5c314df098ee2295af400fb0b6b4f0cccd96fb69",
"date": "2019-09-05 19:53:00 -0400",
"subject": "Rename infoManifest module to manifest.",
"body": "The manifest is not an info file so if anything it should be called backupManifest. But that seems too long for such a commonly used object so manifest seems better.\n\nNote that unlike Perl there is no storage manifest method so this stands as the only manifest in the C code, as befits its importance."
},
{
"commit": "8df7d68c8dca2c61b665bbbd1f26800c0dca3ae8",
"date": "2019-09-03 18:28:53 -0400",
"subject": "Fix sudo missed in \"Build pgBackRest as an unprivileged user\".",
"body": "286a106a updated the documentation to build pgBackRest as an unprivileged user, but the wget command was missed. This command is not actually run, just displayed, because the release is not yet available when the documentation is built.\n\nUpdate the wget command to run as the local user."
},
{
"commit": "005684bf1f55206f122e1d0fcb4164cc84875ff5",
"date": "2019-09-03 17:53:50 -0400",
"subject": "Begin v2.18 development."
},
{
"commit": "ce2bf2999892f689001b084af4d5feb63dc9b402",
"date": "2019-09-03 16:39:32 -0400",
"subject": "v2.17: C Migrations and Bug Fixes"
},
{
"commit": "0b5720c642c040e16373f72a9058df094d05ca10",
"date": "2019-09-03 14:34:49 -0400",
"subject": "Fix yum.p.o package being installed when custom package specified.",
"body": "The {[os-type-is-centos]} expression was missing parens which meant \"and\" expressions built on it would always evaluate true if the os-type was centos6."
},
{
"commit": "7d8068f27b6b695f9616fd985517692236dda47d",
"date": "2019-09-03 12:30:45 -0400",
"subject": "Don't decode manifest data when it is generated on a remote.",
"body": "Decoding a manifest from the JSON provided by C to the hash required by Perl is an expensive process. If manifest() was called on a remote it was being decoded into a hash and then immediately re-encoded into JSON for transmission over the protocol layer.\n\nInstead, provide a function for the remote to get the raw JSON which can be transmitted as is and decoded in the calling process instead.\n\nThis makes remote manifest calls as fast as they were before 2.16, but local calls must still pay the decoding penalty and are therefore slower. This will continue to be true until the Perl storage interface is retired at the end of the C migration.\n\nNote that for reasonable numbers of tables there is no detectable difference. The case in question involved 250K tables with a 10 minute decode time (which was being doubled) on a fast workstation."
},
{
"commit": "1e55b876206c73d0ce32424814d100ef82d8da05",
"date": "2019-09-03 07:49:04 -0400",
"subject": "Add more commonly-used buffer constants."
},
{
"commit": "7ade3fc1c31f09425547d1869e82863582b1b137",
"date": "2019-09-02 21:09:43 -0400",
"subject": "Move constants from the infoManifest module to the infoBackup module.",
"body": "These constants should be kept separate because the implementation of any info file might change in the future and only the interface should be expected to remain consistent.\n\nIn any case, infoBackup requires Variant constants while infoManifest uses String constants so they are not shareable. Modern compilers should combine the underlying const char * constants."
},
{
"commit": "3a28b68b8bde996252ad8941107744c74a062453",
"date": "2019-09-02 19:06:12 -0400",
"subject": "Disable S3 and encryption on u18 integration tests for mock/all/1.",
"body": "This test is commonly used for sanity checking but the combination of S3 and encryption makes it hard to use and encourages temporary changes to make it usable.\n\nAcknowledge this and disable S3 and encryption for this test and move them to mock/all/2."
},
{
"commit": "05abab5e72e2e4d5d394b79533621dcf06d1f324",
"date": "2019-08-30 14:36:02 -0400",
"subject": "Add OBJECT_DEFINE_MOVE() macro.",
"body": "The object *Move() functions are very repetitive so replace them with a macro that works similarly to OBJECT_DEFINE_FREE()."
},
{
"commit": "d1675b7e914a3e25a3d6cff2c73f36f69ec9f729",
"date": "2019-08-28 10:46:54 -0400",
"subject": "Add ioReadLineParam() to allow return on eof.",
"body": "ioReadLine() errors on eof because it has previously been used only for protocol reads.\n\nReturning on eof is handy for reading lines from files where eof is not considered an error."
},
{
"commit": "a605117a2329965d65f985b4b8e991a5267416c2",
"date": "2019-08-28 10:36:21 -0400",
"subject": "Add required header.",
"body": "Apparently this header is already included everywhere convert.h is included."
},
{
"commit": "8074ca6a2613f6b9310654b5e0f5c468ae7821e8",
"date": "2019-08-26 12:30:22 -0400",
"subject": "Fix typos in variable names."
},
{
"commit": "4a88791a0af78ba6f5496ec4e4351e9726662546",
"date": "2019-08-26 12:29:43 -0400",
"subject": "Fix typos in the release notes."
},
{
"commit": "545ccfa8786b631476c232a1d78791687e638432",
"date": "2019-08-26 12:26:00 -0400",
"subject": "Fix typos in the documentation."
},
{
"commit": "08bac74d38b126515e2620cdf129cd4cbd53f6e8",
"date": "2019-08-26 12:20:51 -0400",
"subject": "Fix typo in stack trace message."
},
{
"commit": "c2771e5469ecd94899243e86668a4bcc0d2c65f5",
"date": "2019-08-26 12:05:36 -0400",
"subject": "Fix comment typos.",
"body": "This includes some variable names in tests which don't seem important enough for their own commits."
},
{
"commit": "22aa532be1be83c5b1df8db5fa85047e1255a789",
"date": "2019-08-26 11:37:21 -0400",
"subject": "Add storage tests for files beginning with dots.",
"body": "Prevent a regression of the issue fixed in f88012ce by adding some tests."
},
{
"commit": "8c9df8c290f760b6a1f8a6a0acb6b4d9b8fa4056",
"date": "2019-08-26 11:35:35 -0400",
"subject": "Fix typo in httpClientReponseHeader() function name."
},
{
"commit": "d1cc22f886a865d5b7e0c3e699e4fbe89c11aade",
"date": "2019-08-26 11:25:14 -0400",
"subject": "Fix typo in CFGDEFDATA_OPTION_OPTIONAL_COMMAND_OVERRIDE macro name."
},
{
"commit": "01c2669b9764491ec3ca96ffd0de6676bef9e5dc",
"date": "2019-08-23 07:47:54 -0400",
"subject": "Fix exclusions for special files.",
"body": "Prior to 2.16 the Perl manifest code would skip any file that began with a dot. This was not intentional but it allowed PostgreSQL socket files to be located in the data directory. The new C code in 2.16 did not have this unintentional exclusion so socket files in the data directory caused errors.\n\nWorse, the file type error was being thrown before the exclusion check so there was really no way around the issue except to move the socket files out of the data directory.\n\nSpecial file types (e.g. socket, pipe) will now be automatically skipped and a warning logged to notify the user of the exclusion. The warning can be suppressed with an explicit --exclude."
},
{
"commit": "2862f480cd1712ee9c188c28d79f2f9ed1bb9c6b",
"date": "2019-08-23 07:24:25 -0400",
"subject": "Add special file type to storageInfo().",
"body": "There's not much we can do with special files, but higher level logic can at least exclude them gracefully rather than throwing a hard error."
},
{
"commit": "04e4fde5733bbe885ef94098f0114a3a160a88e5",
"date": "2019-08-22 10:28:08 -0400",
"subject": "Remove unneeded strFree() in storagePosixInfoListEntry().",
"body": "This strFree() was the primary culprit in the performance issue fixed in 9eaeb33c.\n\nSince the parent mem context is now freed regularly, this strFree() performs better, but still adds time so removing it seems best."
},
{
"commit": "f88012cef3acc29fb5311c73ea1a84c1409d88ee",
"date": "2019-08-22 10:18:34 -0400",
"subject": "Fix regexp to ignore ./.. directories in the Posix driver.",
"body": "In versions <= 2.15 the old regexp caused any file or directory beginning with . to be ignored during a backup. This has caused behavioral differences in 2.16 because the new C code correctly excludes ./.. directories.\n\nThis Perl code is only used for testing now, but it should still match the output of the C functions."
},
{
"commit": "c002a2ce2fb7a1bc4bbeaa5dee2f3e7d719ccc24",
"date": "2019-08-21 19:45:48 -0400",
"subject": "Move info file checksum to the end of the file.",
"body": "Putting the checksum at the beginning of the file made it impossible to stream the file out when saving. The entire file had to be held in memory while it was checksummed so the checksum could be written at the beginning.\n\nInstead place the checksum at the end. This does not break the existing Perl or C code since the read is not order dependent.\n\nThere are no plans to improve the Perl code to take advantage of this change, but it will make the C implementation more efficient."
},
{
"commit": "c733319063bbc9d67ba99b96c178f1d9f863b8fe",
"date": "2019-08-21 16:26:28 -0400",
"subject": "The stanza-create/update/delete commands are implemented entirely in C."
},
{
"commit": "53f27da3a6d770608de6aa6059c40526b83b31dd",
"date": "2019-08-21 15:41:52 -0400",
"subject": "Add checkDbConfig() to compare pgBackRest/PostgreSQL configs.",
"body": "Checking the PostgreSQL-reported path and version against the pgBackRest configuration helps ensure that pgBackRest is operating against the correct cluster.\n\nIn Perl this functionality was in the Db object, but check seems like a better place for it in C."
},
{
"commit": "8b93fdf3493d96fcbbc127604b502d246928ec8e",
"date": "2019-08-21 15:26:52 -0400",
"subject": "Add storagePg*() variants to get storage for a specified host id.",
"body": "Previously the host id to use was pulled from the host-id option or defaulted to 1.\n\nThe stanza, check, and backup commands will all need the ability to address a specified pg host, so add functions to make that possible."
},
{
"commit": "fa640f22add9af88c2ddd584812d8fde93c8f8c5",
"date": "2019-08-21 15:12:00 -0400",
"subject": "Allow Info* objects to be created from scratch in C.",
"body": "Previously, info files (e.g. archive.info, backup.info) were created in Perl and only loaded in C.\n\nThe upcoming stanza commands in C need to create these files so refactor the Info* objects to allow new, empty objects to be created. Also, add functions needed to initialize each Info* object to a valid state."
},
{
"commit": "aa6f7eb862f71bf0b8f64d3c5e3d67903b048214",
"date": "2019-08-21 14:14:30 -0400",
"subject": "Fix comment indents."
},
{
"commit": "71d96531f8b581d460ff24a229b676607fc8992b",
"date": "2019-08-21 12:10:09 -0400",
"subject": "Fix comment typo."
},
{
"commit": "c4533765fb5cd4b72f9fcb27f53db2a30165b9b2",
"date": "2019-08-21 11:59:51 -0400",
"subject": "Add Db object getters missed in e4901d50.",
"body": "dbOpen() loaded the version and data directory but there was no way to get the data externally."
},
{
"commit": "27e823581201374df831abc4cf299ce4da29b910",
"date": "2019-08-21 11:41:36 -0400",
"subject": "Add repoIsLocalVerify() to verify repository locality.",
"body": "Some commands can only be run on a host where the repository is local. This function centralizes the check and error."
},
{
"commit": "6a09d9294d0ef13158fbc96c9d38a28ac7a6f150",
"date": "2019-08-21 11:29:30 -0400",
"subject": "Require storage when calling pgControlFromFile().",
"body": "Previously storageLocal() was being used internally but loading pg_control from remote storage is often required.\n\nAlso, storagePg() is more appropriate than storageLocal() for all current usage."
},
{
"commit": "286a106ae4932ae8213d62528de934afa99c246e",
"date": "2019-08-20 09:46:29 -0400",
"subject": "Build pgBackRest as an unprivileged user.",
"body": "pgBackRest was being built by root in the documentation which is definitely not best practice.\n\nInstead build as the unprivileged default container user. Sudo privileges are still required to install."
},
{
"commit": "6b5366a663f8c408e56bb2f8e5b27821898a91cc",
"date": "2019-08-19 21:57:14 -0400",
"subject": "Remove Perl info command invocation missed in 205525b6."
},
{
"commit": "f6aef6e466ccba368fb53cc00450b501f35782fc",
"date": "2019-08-19 21:45:54 -0400",
"subject": "Properly reset conflicting pg-* options for the remote protocol.",
"body": "The pg1-socket-path and pg1-port options were not being reset when options from a higher index were being pushed down for processing by a remote. Since remotes only talk to one cluster they always use the options in index 1. This requires moving options from the original index to 1 before starting the remote. All options already set on index 1 must be removed if they are not being overwritten."
},
{
"commit": "9eaeb33c882b79a1cade3ce65b5d1b51b6978b05",
"date": "2019-08-19 21:36:01 -0400",
"subject": "Improve slow manifest build for very large quantities of tables/segments.",
"body": "storagePosixInfoList() processed each directory in a single memory context. If the directory contained hundreds of thousands of files processing became very slow due to the number of allocations.\n\nInstead, reset the memory context every thousand files to minimize the number of allocations active at once, improving both speed and memory consumption."
},
{
"commit": "d411321d28d2c94f3376b82984981624fe30e287",
"date": "2019-08-19 21:16:10 -0400",
"subject": "Add reset to temp memory contexts to save memory and processing time.",
"body": "Processing large datasets in a memory context can lead to high memory usage and long allocation times. Add a new MEM_CONTEXT_TEMP_RESET_BEGIN() macro that allows temp allocations to be automatically freed after N iterations."
},
{
"commit": "7d97d49f41e961dcaa0d54b56538d3c5a0b8f6ce",
"date": "2019-08-18 20:46:34 -0400",
"subject": "Add MostCommonValue object.",
"body": "Calculate the most common value in a list of variants. If there is a tie then the first value passed to mcvUpdate() wins.\n\nmcvResult() can be called multiple times because it does not end processing, but there is a cost to calculating the result each time\nsince it is not stored."
},
{
"commit": "8aa1e552b00cb3a9cf5665812e6de782f0805675",
"date": "2019-08-18 20:09:44 -0400",
"subject": "Add backup type conversion functions.",
"body": "Convert back and forth between the string and enum representations of backup types."
},
{
"commit": "3df075bf4022e84f0238591b18bc5e866d6a2aa8",
"date": "2019-08-18 15:29:18 -0400",
"subject": "Fix test writing \"null\" into manifest files.",
"body": "\"null\" is not allowed in the manifest format (null values should be missing instead) but Perl was treating the invalid values written by this test as if they were missing.\n\nUpdate the test code to remove the values rather than setting them to \"null\"."
},
{
"commit": "8edc57b5819a41d43524452de378ec409d05f4d9",
"date": "2019-08-18 15:19:10 -0400",
"subject": "Remove RHEL package patch merged to upstream."
},
{
"commit": "0da3352d59c3d985d6fad7b08d28446900932857",
"date": "2019-08-17 17:52:00 -0400",
"subject": "Add cvtZToMode() replacement missed in 969e5817."
},
{
"commit": "d0dee2e26027f866c282050457d61d6907f3263f",
"date": "2019-08-17 17:47:13 -0400",
"subject": "Add bool rendering to jsonFromVar()."
},
{
"commit": "8fc1d3883b2d96d4f518ff2bfa810b082cc48b38",
"date": "2019-08-17 17:43:56 -0400",
"subject": "Fix expire not immediately writing into separate file after backup.",
"body": "Logging stayed in the backup log until the Perl code started. Fix this so it logs to the correct file and will still work after the Perl code is removed."
},
{
"commit": "41b6795a374391d66dcfb2df0521f1d7acf84b3e",
"date": "2019-08-17 14:15:37 -0400",
"subject": "Create log directories/files with 0750/0640 mode.",
"body": "The log directories/files were being created with a mix of modes depending on whether they were created in C or Perl. In particular, the C code was creating log files with the execute bit set for the user and group which was just odd.\n\nStandardize on 750/640 for both code paths."
},
{
"commit": "bc5385142c75f5fa390531a8ff1bd660dd1380ef",
"date": "2019-08-09 15:18:42 -0400",
"subject": "Change comment for searchability."
},
{
"commit": "382ed9282504b2adced37275937d2414632bb968",
"date": "2019-08-09 15:17:18 -0400",
"subject": "The start/stop commands are implemented entirely in C.",
"body": "The Perl versions remain because they are still being used by the Perl stanza commands. Once the stanza commands are migrated they can be removed."
},
{
"commit": "fe196cb0dffacb5d2d1488e3b592cc8ba3f39a5e",
"date": "2019-08-09 14:52:26 -0400",
"subject": "Update RHEL patch for upstream changes.",
"body": "This isn't correct, but we can't test anything else if the package doesn't build."
},
{
"commit": "0e7134d114af1767addce36a3857ea3fd38abc5f",
"date": "2019-08-08 18:50:54 -0400",
"subject": "Constify some globals."
},
{
"commit": "e9517dcec05c75a03fa73029250de4f5b21fdfd3",
"date": "2019-08-08 18:47:02 -0400",
"subject": "Add hash constants for zero-length data.",
"body": "No need to calculate a hash when the data length is known to be zero. Use one of these constants instead."
},
{
"commit": "56c24b7669f1e636a8221106547469065eb7d161",
"date": "2019-08-08 16:20:51 -0400",
"subject": "Fix typo in parameter logging."
},
{
"commit": "1076b142e38a4960af1157bd117fa2aacee7d8e6",
"date": "2019-08-08 16:15:42 -0400",
"subject": "Remove Debian package patch merged to upstream."
},
{
"commit": "969e5817c5d29890cbe12fa95422cd8703abf8d9",
"date": "2019-08-08 11:59:39 -0400",
"subject": "Add cvtZToMode().",
"body": "The companion function to cvtModeToZ()."
},
{
"commit": "1f93e147fa8563028db8b58621db4a1a12387c87",
"date": "2019-08-08 11:41:49 -0400",
"subject": "Add kvGetDefault() to KeyValue object.",
"body": "Return the default only if the key is not found, not when the value is NULL."
},
{
"commit": "289b47902ba1f49a1baea9fdce53eec52d5358bb",
"date": "2019-08-08 10:50:25 -0400",
"subject": "Allow NULLs in strEq().",
"body": "Bring this function more in line with the way varEq() works. NULL == NULL but NULL != NOT NULL."
},
{
"commit": "feec674b6ff88bdfa62b20dd706d724c79ca1bcd",
"date": "2019-08-08 06:48:25 -0400",
"subject": "Add constant for lock file extension."
},
{
"commit": "efc62c90573bd7a0595d81bcf8a261f732fa1fa9",
"date": "2019-08-05 12:32:06 -0400",
"subject": "Begin v2.17 development."
},
{
"commit": "9e730c1bd61b00fa506ea443cdd6161e88ed31ae",
"date": "2019-08-05 12:03:04 -0400",
"subject": "v2.16: C Migrations and Bug Fixes"
},
{
"commit": "3d3003e9ca6dd449ea16c6812d1cabc392c9d294",
"date": "2019-08-01 20:35:01 -0400",
"subject": "The check command is implemented partly in C.",
"body": "Implement switch WAL and archive check in C but leave the rest in Perl for now.\n\nThe main idea was to have some real integration tests for the new database code so the rest of the migration can wait."
},
{
"commit": "e4901d50d5e99168f7962b93f7a327e45f7b7fed",
"date": "2019-08-01 15:38:27 -0400",
"subject": "Add Db object to encapsulate PostgreSQL queries and commands.",
"body": "Migrate functionality from the Perl Db module to C. For now this is just enough to implement the WAL switch check.\n\nAdd the dbGet() helper function to get Db objects easily.\n\nCreate macros in harnessPq to make writing pq scripts easier by grouping commonly used functions together."
},
{
"commit": "f9e1f3a79823ee1bd6656e4f7a8fb23e735b8ccf",
"date": "2019-08-01 14:28:30 -0400",
"subject": "Retry S3 RequestTimeTooSkewed errors instead of immediately terminating.",
"body": "The cause of this error seems to be that a failed request takes so long that a subsequent retry at the http level uses outdated headers.\n\nWe're not sure if pgBackRest it to blame here (in one case a kernel downgrade fixed it, in another case an incorrect network driver was the problem) so add retries to hopefully deal with the issue if it is not too persistent. If SSL_write() has long delays before reporting an error then this will obviously affect backup performance."
},
{
"commit": "2eb3c9f95f6e57072b65da81cb07a1268ebbf38e",
"date": "2019-08-01 09:58:24 -0400",
"subject": "Improve error handling for SSL_write().",
"body": "Error codes were not being caught for SSL_write() so it was hard to see exactly what was happening in error cases. Report errors to aid in debugging.\n\nAlso add a retry for SSL_ERROR_WANT_READ. Even though we have not been able to reproduce this case it is required by SSL_write() so go ahead and implement it."
},
{
"commit": "89c67287bcb8bc7884b5dd37703b0d7786c68b95",
"date": "2019-07-31 20:44:49 -0400",
"subject": "Improve multi-host handling in protocol helper.",
"body": "Multiple PostgreSQL hosts were supported via the host-id option but there are cases where it is useful to be able to directly specify the host id required, e.g. to iterate through pg* hosts when looking for candidate primaries and standbys during backup."
},
{
"commit": "893ae24284e506c551fbc28bec8719881a856e2a",
"date": "2019-07-31 19:58:57 -0400",
"subject": "Add timeout to walSegmentFind().",
"body": "Keep trying to locate the WAL segment until timeout. This is useful for the check and backup commands which must wait for segments to arrive in the archive."
},
{
"commit": "03b28da1cac8f39c7f57d2c15a83ad667a51b997",
"date": "2019-07-31 11:35:58 -0400",
"subject": "Rename control/control module to control/common.",
"body": "This is more consistent with how other common modules are named."
},
{
"commit": "a04baa1bdc07f85041bfaf910f122b7ae278d6aa",
"date": "2019-07-30 11:42:56 -0400",
"subject": "Fix incorrect comment (obviously pasted from S3 code)."
},
{
"commit": "3d892cfb75c3303b0b592d4481d415d25c3f0df9",
"date": "2019-07-30 11:39:01 -0400",
"subject": "Remove extra linefeed."
},
{
"commit": "88c1929ec5a41915753e3d3078bdaae62d14bf0f",
"date": "2019-07-26 08:37:58 -0400",
"subject": "Don't pass local config* options to the remote.",
"body": "The remotes have their own config options (repo-host-config, etc.) so don't pass the local config* options.\n\nThis was a regression from the behavior of the Perl code and while there have been no field reports it caused breakage on test systems with multiple configurations."
},
{
"commit": "f8b0676fd6edbe915bc23d2f082b4862004ca151",
"date": "2019-07-25 20:15:06 -0400",
"subject": "Allow modules to be included for testing without requiring coverage.",
"body": "Sometimes it is useful to get at the internals of a module that is not being tested for coverage in order to provide coverage for another module that is being tested. The include directive allows this.\n\nUpdate modules that had previously been added to coverage that only need to be included."
},
{
"commit": "554d98746a96d5a93e3449d62c81c9b7a7c84e9d",
"date": "2019-07-25 17:36:51 -0400",
"subject": "Add repo-s3-port option for setting a non-standard S3 service port.",
"body": "If this option is set then ports appended to repo-s3-endpoint or repo-s3-host will be ignored.\n\nSetting this option explicitly may be the only way to use a bare ipv6 address with S3 (since multiple colons confuse the parser) but we plan to improve this in the future."
},
{
"commit": "d8ca0e5c5bc2af6b85b20f48b40b83762d415b7a",
"date": "2019-07-25 17:05:39 -0400",
"subject": "Add Perl interface to C PgQuery object.",
"body": "This validates that all current queries work with the new interface and removes the dependency on DBD::Pg."
},
{
"commit": "415542b4a3589ff7b25dbd97d1041a9b1ff87815",
"date": "2019-07-25 14:50:02 -0400",
"subject": "Add PostgreSQL query client.",
"body": "This direct interface to libpq allows simple queries to be run against PostgreSQL and supports timeouts.\n\nTesting is performed using a shim that can use scripted responses to test all aspects of the client code. The shim will be very useful for testing backup scenarios on complex topologies."
},
{
"commit": "59f135340d4f76c522c8b24ecb23d56b57b2b0f8",
"date": "2019-07-25 14:34:16 -0400",
"subject": "The local command for backup is implemented entirely in C.",
"body": "The local process is now entirely migrated to C. Since all major I/O operations are performed in the local process, the vast majority of I/O is now performed in C."
},
{
"commit": "54ec8f151e4164c3f363f417bece7c4b1533dfd6",
"date": "2019-07-24 19:45:35 -0400",
"subject": "Add int rendering to jsonFromVar()."
},
{
"commit": "615735e7eed32c429a13559584a7268e4dbff3fc",
"date": "2019-07-24 06:52:49 -0400",
"subject": "Add new types to JSON render.",
"body": "Add bool, array, and int64 as valid array subtypes.\n\nPretty print for the array subtype is not correct but is currently not in use (this can be seen at line 328 in typeJsonTest.c)."
},
{
"commit": "62f0c7fb37e160d4a8a2dbe410fe8a569bc4ba38",
"date": "2019-07-22 13:09:51 -0400",
"subject": "Add lock bot configuration.",
"body": "Lock closed issues after ninety days to prevent posting on old issues."
},
{
"commit": "38ba458616f450232dc1090306e651561c9b3076",
"date": "2019-07-18 08:42:42 -0400",
"subject": "Add IoSink filter.",
"body": "Discard all data passed to the filter. Useful for calculating size/checksum on a remote system when no data needs to be returned.\n\nUpdate ioReadDrain() to automatically use the IoSink filter."
},
{
"commit": "d1dd6add4853a77d2ebbf27c326bbb4670b78955",
"date": "2019-07-17 16:55:21 -0400",
"subject": "Remove never-used infoBackupCheckPg() function.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "3bdba4933d45451a3fa6f5dafcb79fd976bffef6",
"date": "2019-07-17 16:49:42 -0400",
"subject": "Fix incorrect handling of transfer-encoding response to HEAD request.",
"body": "The HTTP server can use either content-length or transfer-encoding to indicate that there is content in the response. HEAD requests do not include content but return all the same headers as GET. In the HEAD case we were ignoring content-length but not transfer-encoding which led to unexpected eof errors on AWS S3. Our test server, minio, uses content-length so this was not caught in integration testing.\n\nIgnore all content for HEAD requests (no matter how it is reported) and add a unit test for transfer-encoding to prevent a regression."
},
{
"commit": "6f981c53bb63d3a644a8573cb9edb162c443d03b",
"date": "2019-07-17 15:44:55 -0400",
"subject": "Remove obsolete ignoreMissing parameter.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "7662d32e6020148d822fd5080f2a5ebda7ebe103",
"date": "2019-07-17 15:42:37 -0400",
"subject": "Fix comment typos and clarify HEAD response behavior."
},
{
"commit": "eee67db4d611bb18950daf7bddb84217b010d767",
"date": "2019-07-17 14:09:50 -0400",
"subject": "Allow pg storage to be remote.",
"body": "None of the currently migrated commands needed remote pg storage but now backup, check, stanza-* will need it."
},
{
"commit": "30f55a3c2a139ffd59547fd8e422c3fae3feecd3",
"date": "2019-07-15 17:36:24 -0400",
"subject": "Add compressed storage feature.",
"body": "This feature denotes storage that can compress files so that they take up less space than what was written. Currently this includes the Posix and CIFS drivers. The stored size of the file will be rechecked after write to determine if the reported size is different. This check would be wasted on object stores such as S3, and they might not report the file as existing immediately after write.\n\nAlso add tests to each storage driver to check features."
},
{
"commit": "3e1062825dde7cab506225a3b0658552b44de7ce",
"date": "2019-07-15 16:49:46 -0400",
"subject": "Allow multiple filters to be pushed to the remote and return results.",
"body": "Previously only a single filter could be pushed to the remote since order was not being maintained. Now the filters are strictly ordered.\n\nResults are returned from the remote and set in the local IoFilterGroup so they can be retrieved.\n\nExpand remote filter support to include all filters."
},
{
"commit": "d5654375a5152764f76335eb5265eb994d1df6bd",
"date": "2019-07-15 08:44:41 -0400",
"subject": "Add ioReadDrain().",
"body": "Read all data from an IoRead object and discard it. This is handy for calculating size, hash, etc. when the output is not needed.\n\nUpdate code where a loop was used before."
},
{
"commit": "cdb75ac8b38810e2e7c6f5d0161443650f94bb31",
"date": "2019-07-15 07:13:36 -0400",
"subject": "Add constants for path and archive.info/backup.info combinations.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "ede7df9fb1d937f228e982d987d306345007dfe0",
"date": "2019-07-14 15:53:31 -0400",
"subject": "Allow NULL in JSON list."
},
{
"commit": "c836c483dc7198a685991753300bae49d3caa73c",
"date": "2019-07-14 15:42:55 -0400",
"subject": "Add lstClear() to List object."
},
{
"commit": "e10577d0b0c8054a08513b069e2f2647ddd51fb7",
"date": "2019-07-11 09:13:56 -0400",
"subject": "Fix incorrect offline upper bound for ignoring page checksum errors.",
"body": "For offline backups the upper bound was being set to 0x0000FFFF0000FFFF rather than UINT64_MAX. This meant that page checksum errors might be ignored for databases with a lot of past WAL in offline mode.\n\nOnline mode is not affected since the upper bound is retrieved from pg_start_backup()."
},
{
"commit": "2fd0ebb78aabe882d4b080d4014d7ecabbded3da",
"date": "2019-07-10 15:08:35 -0400",
"subject": "Fix links broken by non-standard version.",
"body": "Using version 2.15.1 fixed the duplicate tarball problem but broke the auto-generated links. Fix them manually since this should not be a common problem."
},
{
"commit": "6a89c1526e1ecc2940ed2bf42258ceb9ef85f0e0",
"date": "2019-07-10 12:04:25 -0400",
"subject": "Revert a2dcdc07.",
"body": "It is simpler to implement the required logic in stanza-delete rather than add complexity to this function."
},
{
"commit": "04646599a776348914b3e9bb9b707d2845540aac",
"date": "2019-07-10 06:17:33 -0400",
"subject": "Remove extraneous test macro."
},
{
"commit": "4e7db608dc6488feb99e5f2707f06e3ca39d78e8",
"date": "2019-07-10 06:11:21 -0400",
"subject": "Clarify that return statements are not removed in production builds."
},
{
"commit": "a22a6dc08c25a2af9ac9a6f2331144f2bae8dcbe",
"date": "2019-07-10 06:06:07 -0400",
"subject": "Update contributor name."
},
{
"commit": "a2dcdc0711a8dfb7d562b2ee0a8586de9676669f",
"date": "2019-07-09 16:41:58 -0400",
"subject": "Update lockStopTest() to optionally return a result rather than error.",
"body": "Some commands (e.g. stanza-delete) would prefer to throw a customized error."
},
{
"commit": "27b3246e852e98902f21589f5cdfece9ebb27b39",
"date": "2019-07-08 08:29:25 -0400",
"subject": "Exclude more build files from rsync between tests.",
"body": "Files (especially build.auto.h) were being removed and forcing a full build between separate invocations of test.pl.\n\nThis affected ad-hoc testing at the command-line, not a full test run in CI."
},
{
"commit": "5e1ed2e8a52c2c4d2151ef17496f0847cd9ae939",
"date": "2019-07-05 18:34:15 -0400",
"subject": "Remove clang static analysis.",
"body": "This analysis never produced anything but false positives (var might be NULL) but took over a minute per test run and added 600MB to the test container."
},
{
"commit": "488fb672948c07abfd7e38604eacbd0f82610b1a",
"date": "2019-07-05 17:25:01 -0400",
"subject": "Force PostgreSQL versions to string for newer versions of JSON:PP.",
"body": "Since 2.91 JSON::PP has a bias for saving variables that look like numbers as numbers even if they were declared as strings.\n\nForce versions to strings where needed by appending ''.\n\nUpdate the json-pp-perl package on Ubuntu 18.04 to 2.97 to provide test coverage."
},
{
"commit": "9836578520e3fb5c038230ebfb123001a7eb32fa",
"date": "2019-07-05 16:55:17 -0400",
"subject": "Remove perl critic and coverage.",
"body": "No new Perl code is being developed, so these tools are just taking up time and making migrations to newer platforms harder. There are only a few Perl tests remaining with full coverage so the coverage tool does not warn of loss of coverage in most cases.\n\nRemove both tools and associated libraries."
},
{
"commit": "fc2101352206a87f8471fd37455d9cd990fce95d",
"date": "2019-07-05 16:25:28 -0400",
"subject": "Fix scoping violations exposed by optimizations in gcc 9.",
"body": "gcc < 9 makes all compound literals function scope, even though the C spec requires them to be invalid outside the current scope. Since the compiler and valgrind were not enforcing this we had a few violations which caused problems in gcc >= 9.\n\nEven though we are not quite ready to support gcc 9 officially, fix the scoping violations that currently exist in the codebase."
},
{
"commit": "1708f1d1514b3f2afb69664317df705a1fccfaf7",
"date": "2019-07-02 22:20:35 -0400",
"subject": "Use minio for integration testing.",
"body": "ScalityS3 has not received any maintenance in years and is slow to start which is bad for testing. Replace it with minio which starts quickly and ships as a single executable or a tiny container.\n\nMinio has stricter limits on allowable characters but should still provide enough coverage to show that our encoding is working correctly.\n\nThis commit also includes the upgrade to openssl 1.1.1 in the Ubuntu 18.04 container."
},
{
"commit": "b9b21315ead6610bb41ee19794763555a7265261",
"date": "2019-07-02 22:09:12 -0400",
"subject": "Updates for openssl 1.1.1.",
"body": "Some HTTP error tests were failing after the upgrade to openssl 1.1.1, though the rest of the unit and integration tests worked fine. This seemed to be related to the very small messages used in the error testing, but it pointed to an issue with the code not being fully compliant, made worse by auto-retry being enabled by default.\n\nDisable auto-retry and implement better error handling to bring the code in line with openssl recommendations.\n\nThere's no evidence this is a problem in the field, but having all the tests pass seems like a good idea and the new code is certainly more robust.\n\nCoverage will be complete in the next commit when openssl 1.1.1 is introduced."
},
{
"commit": "c55009d0f9ebfea746ab270be167dc2d78976ce9",
"date": "2019-06-27 14:39:11 -0400",
"subject": "Community yum package can be installed with --var=package=yum.",
"body": "Like apt, the community yum package can now be installed instead of a user-specified package."
},
{
"commit": "b0728c33dbd7c99a7b785c152f20d5cdfa902bff",
"date": "2019-06-27 14:30:20 -0400",
"subject": "Remove Debian package patch merged to upstream."
},
{
"commit": "020101b30bfe9f2d34b878fcd51fad932781d9f8",
"date": "2019-06-27 09:38:40 -0400",
"subject": "Update release notes to explicitly select release commit when tagging."
},
{
"commit": "33e3d316d63a41cd64d217abe30786cfb48bf09e",
"date": "2019-06-26 19:52:04 -0400",
"subject": "Reverse loop in infoPgSave() to be consistent with infoPgNewLoad().",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "4bffa0c5bb7d551c60b8d8bcff9a3bbe6e02eddd",
"date": "2019-06-26 15:02:30 -0400",
"subject": "Add test function to create the S3 bucket instead of using aws cli.",
"body": "Eventually the idea is to remove the dependency on aws cli since Python is a big install."
},
{
"commit": "4815752ccc46ff742f67b369bc75ad3efcf11204",
"date": "2019-06-26 08:24:58 -0400",
"subject": "Add Perl interface to C storage layer.",
"body": "Maintaining the storage layer/drivers in two languages is burdensome. Since the integration tests require the Perl storage layer/drivers we'll need them even after the core code is migrated to C. Create an interface layer so the Perl code can be removed and new storage drivers/features introduced without adding Perl equivalents.\n\nThe goal is to move the integration tests to C so this interface will eventually be removed. That being the case, the interface was designed for maximum compatibility to ease the transition. The result looks a bit hacky but we'll improve it as needed until it can be retired."
},
{
"commit": "bd6c0941e9e3aa2dab84f7404da1f9dc60cd693b",
"date": "2019-06-25 17:27:19 -0400",
"subject": "Fix missing dash in site name.",
"body": "Without this the project name and tagline just run together."
},
{
"commit": "466602387bc279aa44a811dc2948b893e4127b2c",
"date": "2019-06-25 08:42:20 -0400",
"subject": "Begin v2.16 development."
},
{
"commit": "6650d8144cba46f93ad75c11ad98d87c57d2ea7f",
"date": "2019-06-25 08:29:06 -0400",
"subject": "v2.15: C Implementation of Expire"
},
{
"commit": "51fcaee43edf022aea0f94b76d254f2de8b6e1d1",
"date": "2019-06-25 07:58:38 -0400",
"subject": "Add host-repo-path variable internal replacement.",
"body": "This variable needs to be replaced right before being used without being added to the cache since the host repo path will vary from system to system.\n\nThis is frankly a bit of a hack to get the documentation to build in the Debian packages for the upcoming release. We'll need to come up with something more flexible going forward."
},
{
"commit": "5cbe2dee855577ccd14051cad35f30376db21d50",
"date": "2019-06-25 07:36:16 -0400",
"subject": "Add compress-level-network option to ls command.",
"body": "039e515a added a dependency on compress-level-network but the ls command did not get updated."
},
{
"commit": "d7f12f268a370e388c6a6375666831ecd8fad72c",
"date": "2019-06-24 19:27:13 -0400",
"subject": "Redact secure options in the help command.",
"body": "Secure options could show up in the help as \"current\". While the user must have permissions to see the source of the options (e.g. environment, config file) it's still not a good idea to display them in an unexpected context.\n\nInstead show secure options as in the help command."
},
{
"commit": "c22e10e4a938b444ac7912efc3b751829401360f",
"date": "2019-06-24 15:42:33 -0400",
"subject": "Honor configure --prefix option.",
"body": "The --prefix option was entirely ignored and DESTDIR was a combination of DESTDIR and bindir.\n\nBring both in line with recommendations for autoconf and make as specified in https://www.gnu.org/software/make/manual/html_node/Directory-Variables.html and https://www.gnu.org/prep/standards/html_node/DESTDIR.html."
},
{
"commit": "b498188f01f8d2ccd4d0ce2cce3af2e5069d9ac3",
"date": "2019-06-24 11:59:44 -0400",
"subject": "Error on db history mismatch when expiring.",
"body": "Amend commit 434cd832 to error when the db history in archive.info and backup.info do not match.\n\nThe Perl code would attempt to reconcile the history by matching on system id and version but we are not planning to migrate that code to C. It's possible that there are users with mismatches but if so they should have been getting errors from info for the last six months. It's easy enough to manually fix these files if there are any mismatches in the field."
},
{
"commit": "039e515a319216035187c89efccf97143d4cac03",
"date": "2019-06-24 10:20:47 -0400",
"subject": "Allow protocol compression when read/writing remote files.",
"body": "If the file is compressible (i.e. not encrypted or already compressed) it can be marked as such in storageNewRead()/storageNewWrite(). If the file is being read from/written to a remote it will be compressed in transit using gzip.\n\nSimplify filter group handling by having the IoRead/IoWrite objects create the filter group automatically. This removes the need for a lot of NULL checking and has a negligible effect on performance since a filter group needs to be created eventually unless the source file is missing.\n\nAllow filters to be created using a VariantList so filter parameters can be passed to the remote."
},
{
"commit": "62715ebf2d8b0585c35cd2ee14d6aabf9cc0f1f8",
"date": "2019-06-19 17:49:38 -0400",
"subject": "Fix archive retention expiring too aggressively.",
"body": "The problem expressed when repo1-archive-retention-type was set to diff. In this case repo1-archive-retention ended up being effectively equal to one, which meant PITR recovery was only possible from the last backup. WAL required for consistency was still preserved for all backups.\n\nThis issue is not present in the C migration committed at 434cd832, which was written before this bug was reported. Even so, we wanted to note this issue in the release notes in case any other users have been affected.\n\nFixed by Cynthia Shang.\nReported by Mohamad El-Rifai."
},
{
"commit": "a7d64bab7abe56132ad1c83eb6bfcca1166e0000",
"date": "2019-06-18 19:02:09 -0400",
"subject": "Add FAQ on where to find old Debian/Ubuntu packages."
},
{
"commit": "e2d791394a3577aac53a21e3141e4e337ac8edf0",
"date": "2019-06-18 18:42:47 -0400",
"subject": "Add FAQ to the documentation.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "434cd832855e4e189403962753fd8771e29880a4",
"date": "2019-06-18 15:19:20 -0400",
"subject": "The expire command is implemented entirely in C.",
"body": "This implementation duplicates the functionality of the Perl code but does so with different logic and includes full unit tests.\n\nAlong the way at least one bug was fixed, see issue #748."
},
{
"commit": "f88bee7b3321a2c79f0317913ba1e83a56d19c7d",
"date": "2019-06-18 10:13:28 -0400",
"subject": "TLS/HTTP statistics log replacements.",
"body": "These statistics can change with any code update so they cause a lot of churn in the expect logs."
},
{
"commit": "0efdf2576f02b1768fb8805b27571e403ac3cb52",
"date": "2019-06-18 07:35:34 -0400",
"subject": "Remove hard-coded PostgreSQL user so $PGUSER works.",
"body": "The PostgreSQL user was hard-coded to the OS user which libpq will automatically use if $PGUSER is not set, so this code was redundant and prevented $PGUSER from working when set."
},
{
"commit": "593446718a8997bfd674cf5e54230290cb5bcdea",
"date": "2019-06-18 06:45:47 -0400",
"subject": "Add S3 info type missed in 7f2f5354.",
"body": "File is the only type possible in S3."
},
{
"commit": "0a96a2895d7a1e4c5eec402d3742f1d1e25cc126",
"date": "2019-06-17 09:16:44 -0400",
"subject": "Add storage layer for tests and documentation.",
"body": "The tests and documentation have been using the core storage layer but soon that will depend entirely on the C library, creating a bootstrap problem (i.e. the storage layer will be needed to build the C library).\n\nCreate a simplified Posix storage layer to be used by documentation and the parts of the test code that build and execute the actual tests. The actual tests will still use the core storage driver so they can interact with any type of storage."
},
{
"commit": "ceafd8e19d416106f50c4ff440bf1cf7fcb5553f",
"date": "2019-06-17 07:52:03 -0400",
"subject": "Migrate page checksum filter to C.",
"body": "This filter exactly mimics the behavior of the Perl filter so is a drop-in replacement.\n\nThe filter is not integrated yet since it requires the Perl-to-C storage layer interface coming in a future commit."
},
{
"commit": "892f35a7283462fae0bc3077aeb23c9624a50dea",
"date": "2019-06-17 07:42:12 -0400",
"subject": "Add new types to JSON render.",
"body": "Still not a complete list, but we are getting there."
},
{
"commit": "c64c9c05905d435cd650195ed9470355a4d2be2f",
"date": "2019-06-17 06:59:06 -0400",
"subject": "Add backup management functions to InfoBackup.",
"body": "Allow current backups to be listed and deleted.\n\nAlso expose some constants required by expire and stanza-* commands."
},
{
"commit": "44bafc127d9d4e38478aa44d0adc0f34695c6640",
"date": "2019-06-17 06:47:15 -0400",
"subject": "Rename info*New() functions to info*NewLoad().",
"body": "These names more accurately reflect what the functions do and follow the convention started in Info and InfoPg.\n\nAlso remove the ignoreMissing parameter since it was never used."
},
{
"commit": "f05fbc54a8f00a56937439fb88eafe8e239781e8",
"date": "2019-06-14 08:04:28 -0400",
"subject": "Fix filters not processing when there is no input.",
"body": "Some filters (e.g. encryption and compression) produce output even if there is no input. Since the filter group was marked as \"done\" initially, processing would not run when there was zero input and that resulted in zero output.\n\nAll filters start not done so start the filter group the same way."
},
{
"commit": "9ba95e993ba3dbf73f8967a875608980e6380633",
"date": "2019-06-13 17:58:33 -0400",
"subject": "Use retries to wait for test S3 server to start.",
"body": "The prior method of tailing the docker log no longer seems reliable. Instead, keep retrying the make bucket command until it works and show the error if it times out."
},
{
"commit": "b9233f7412e44c8daf41db05bd9699fa088ece5d",
"date": "2019-06-13 12:44:40 -0400",
"subject": "Create filter group in read/write object's memory context.",
"body": "The filter group was being created in the parent context so it would go away if the parent context was freed."
},
{
"commit": "20be5c9bf39d606b8586ffcf575a7443c6375479",
"date": "2019-06-13 12:35:13 -0400",
"subject": "Remove extra spaces."
},
{
"commit": "fdd375b63d3962845efbb38a7020d852143b97fd",
"date": "2019-06-11 16:26:32 -0400",
"subject": "Integrate S3 storage driver with HTTP client cache.",
"body": "This allows copying from one S3 object to another. We generally try to avoid doing this but there are a few cases where it is needed and the tests do it quite a bit.\n\nOne thing to look out for here is that reads require the http client to be explicitly released by calling httpClientDone(). This means than clients could grow if they are not released properly. The http statistics will hopefully alert us if this is happening."
},
{
"commit": "ced42d6511e9b5735a2281dd0e1faec41870fd37",
"date": "2019-06-11 10:48:22 -0400",
"subject": "Add HTTP client cache.",
"body": "This cache manages multiple http clients and returns one to the caller that is not busy. It is the responsibility of the caller to indicate when they are done with a client. If returnContent is set then the client will automatically be marked done.\n\nAlso add special handing for HEAD requests to recognize that content-length is informational only and no content is expected."
},
{
"commit": "6e809e578fbd24269205de25cc6e9c84cefc5647",
"date": "2019-06-11 10:34:42 -0400",
"subject": "Add tag to specify minio version to use for documentation build.",
"body": "The new minio major release broke the build. We'll need to figure that out but for now use the last major version, which is known to work."
},
{
"commit": "7f2f535460e3499c1811b5beca9130f84b78c982",
"date": "2019-06-10 16:09:38 -0400",
"subject": "Add info() and infoList() to S3 driver.",
"body": "These should be the last functions required to complete the implementation of the S3 driver."
},
{
"commit": "9d1b03781f9fe88b868cdfaf4808d84ad1f072fb",
"date": "2019-06-10 15:52:51 -0400",
"subject": "Revert removal of aws cli in 3e1b06ac.",
"body": "This is required for integration tests to create buckets."
},
{
"commit": "456391f67c220647e130fdc7a7fc805b075cfd87",
"date": "2019-06-10 12:23:04 -0400",
"subject": "Create general-purpose S3 list function.",
"body": "There are already two functions which need file lists and more on the way, so create a general-purpose function to reduce code duplication."
},
{
"commit": "fb8bd095ca93e2bf77eaec0f7573f961f691c3ab",
"date": "2019-06-10 10:37:20 -0400",
"subject": "Add missing const qualifiers."
},
{
"commit": "78b333790c69aca991f740a9ea6b1982fb70c3d6",
"date": "2019-06-07 10:35:44 -0400",
"subject": "Return IoRead/IoWrite from io*FilterGroupSet()",
"body": "This makes is possible to chain functions more effectively."
},
{
"commit": "e701e8fd846539ec20f2a9be90b0590ceb6a7be6",
"date": "2019-06-05 11:50:49 -0400",
"subject": "Expose storage type.",
"body": "Code calling the storage should be driver agnostic but knowing the storage type can be useful for debugging and error reporting."
},
{
"commit": "6ff3325c7744a8f6f0e1e965fa673040a2f40a71",
"date": "2019-06-05 11:43:17 -0400",
"subject": "Enforce requiring repo-cipher-pass at config parse time.",
"body": "This was not enforced at parse time because repo1-cipher-type could be passed on the command-line even in cases where encryption was not needed by the subprocess.\n\nFilter repo-cipher-type so it is never passed on the command line. If the subprocess does not have access to the passphrase then knowing the encryption type is useless anyway."
},
{
"commit": "d7bd0c58cdd9a434aa5893db16e6bcf8425e26b9",
"date": "2019-06-05 07:27:24 -0400",
"subject": "Use wal_level=replica in the documentation for PostgreSQL >= 9.6.",
"body": "The documentation was using wal_level=hot_standby which is a deprecated setting.\n\nAlso remove the reference to wal_level=archive since it is no longer supported and is not recommended for older versions."
},
{
"commit": "aca11b2fa19337f934fc095e33f014d5e6df71f3",
"date": "2019-06-04 17:40:27 -0400",
"subject": "Add String to types supported by JSON list render.",
"body": "All types should be supported eventually but for now this answers the need."
},
{
"commit": "0ab6f3bb87005d5a5d102156730b1e3099894189",
"date": "2019-06-04 13:38:05 -0400",
"subject": "Fix incorrect error type on missing path."
},
{
"commit": "4b91259de8d7feec6d33d154032169aa32c879e3",
"date": "2019-06-04 12:56:04 -0400",
"subject": "Make working with filter groups less restrictive.",
"body": "Filter groups could not be manipulated once they had been assigned to an IO object. Now they can be freely manipulated up to the time the IO object is opened.\n\nAlso, move the filter group into the IO object's context so they don't need to be tracked separately."
},
{
"commit": "92e04ea9f4e0eb3f6cd88a72497a026cbd348280",
"date": "2019-06-04 10:34:19 -0400",
"subject": "Remove per-stanza repo cache clear during testing.",
"body": "This was not being used and is not supported by the equivalent C code."
},
{
"commit": "44eb21ea935fdaa4e96d4637c7b62cb5a73d3e77",
"date": "2019-06-04 10:05:27 -0400",
"subject": "Use HEAD to check if a file exists on S3.",
"body": "The previous implementation searched for the file in a list which worked but was not optimal. For arbitrary bucket structures it would also produce a false negative if a match was not found in the first 1000 entries. This was not an issue for our repo structure since the max hits on exists calls is two but it seems worth fixing to avoid future complications."
},
{
"commit": "15b8e3b6af7327179d8bdd2e0c6833ed28005b0b",
"date": "2019-06-04 09:39:08 -0400",
"subject": "Make C S3 requests use the same host logic as Perl.",
"body": "The C code was passing the host (if specified) with the request which could force the server into path-style URLs, which are not supported.\n\nInstead, use the Perl logic of always passing bucket.endpoint in the request no matter what host is used for the HTTPS connection.\n\nIt's an open question whether we should support path-style URLs but since we don't it's useless to tell the server otherwise. Note that Amazon S3 has deprecated path-style URLs and they are no longer supported on newly created buckets."
},
{
"commit": "5f92c36b30072edb71b12f79163c37c67d9806bc",
"date": "2019-06-04 08:04:33 -0400",
"subject": "Fix erroneous parameter name.",
"body": "The exists() function only checks for files so the parameter name should reflect that."
},
{
"commit": "0945d9666b5af1a5893ba0b4537e9cd1f72be478",
"date": "2019-06-01 11:09:01 -0400",
"subject": "Bring back PATH_PAX for platforms that don't define it.",
"body": "This define was replaced in 8c712d89 with limits.h but that caused an issue with the hurd-i386 build for Debian which apparently does not define this value."
},
{
"commit": "a207af79215d05539825c484dbfa9aa2a26cf7d0",
"date": "2019-06-01 09:44:40 -0400",
"subject": "Fix mismatched log/test macros."
},
{
"commit": "12bca3c43eb2ee0df80ef5e10850657b52fb680b",
"date": "2019-06-01 09:28:31 -0400",
"subject": "Add CPPFLAGS to compile rules.",
"body": "This should silence the last of the Debian package warnings."
},
{
"commit": "388ba0458c37ab4e8b82df0c0fa2b6a4d7462ecb",
"date": "2019-05-31 18:37:31 -0400",
"subject": "Fix build.flags being removed on each build.",
"body": "This was being removed by rsync which forced a full build even when a partial should have been fine. Rewrite the file after the rsync so it is preserved."
},
{
"commit": "6cba50c3f23a7a7822ae0fd03ff3b5a3f6d8a32a",
"date": "2019-05-31 18:32:40 -0400",
"subject": "Remove Debian package patch merged to upstream."
},
{
"commit": "3a5fd7b28a79c1564ddd2b5bad36d4d4be358453",
"date": "2019-05-30 11:19:59 -0400",
"subject": "Fix typo in macro name."
},
{
"commit": "a2ec1253e97805e2a3b990d8bc23c98ab8013d09",
"date": "2019-05-30 10:44:35 -0400",
"subject": "Add code classification exclusion missed in 3e1b06ac."
},
{
"commit": "64260b2e9878944116dc78812a3a21633c5f3d15",
"date": "2019-05-29 08:38:45 -0400",
"subject": "Build all docs with S3 using --var=s3-all=y",
"body": "Force repo-type=s3 for all tests. This is not currently the default for any OS builds."
},
{
"commit": "404284b90ff0f67fe29fa5a7b2831ebf51d459aa",
"date": "2019-05-28 12:18:05 -0400",
"subject": "Add internal flag for commands.",
"body": "Allow commands to be skipped by default in the command help but still work if help is requested for the command directly. There may be other uses for the flag in the future.\n\nUpdate help for ls now that it is exposed."
},
{
"commit": "20e5b92f366848ec1464e2272c6af2c29ac7b36d",
"date": "2019-05-28 10:03:48 -0400",
"subject": "Add ls command.",
"body": "Allows listing repo paths/files from the command-line, to be used primarily for testing and debugging.\n\nThis command is internal-only so the interface may change at any time without notice."
},
{
"commit": "3b3327eae6dd14f67f1002f094bd33ab7785f765",
"date": "2019-05-28 09:50:59 -0400",
"subject": "Move tls/http statistics output to command/command.",
"body": "This module already has the filtering required to keep these messages from being displayed by default for commands that output to stdout (e.g. info)."
},
{
"commit": "3e1b06acaa84399abcfaa8c684f437b63aa38de5",
"date": "2019-05-27 07:37:20 -0400",
"subject": "Use minio as local S3 emulator in documentation.",
"body": "The documentation was relying on a ScalityS3 container built for testing which wasn't very transparent. Instead, use the stock minio container and configure it in the documentation.\n\nAlso, install certificates and CA so that TLS verification can be enabled."
},
{
"commit": "a474ba54c5c9c7bdba6ffa3e92671bb9565889f6",
"date": "2019-05-26 12:41:15 -0400",
"subject": "Refactoring path support in the storage module.",
"body": "Not all storage types support paths as a physical thing that must be created/destroyed. Add a feature to determine which drivers use paths and simplify the driver API as much as possible given that knowledge and by implementing as much path logic as possible in the Storage object.\n\nRemove the ignoreMissing parameter from pathSync() since it is not used and makes little sense.\n\nCreate a standard list of error messages for the drivers to use and apply them where the code was modified -- there is plenty of work still to be done here."
},
{
"commit": "38f28bd52081405321939fec66046bd9ada35c23",
"date": "2019-05-26 12:32:49 -0400",
"subject": "Log TLS and HTTP statistics on exit.",
"body": "These stats measure how efficiently TLS and HTTP are reusing connections."
},
{
"commit": "819eda0818669ea9cc45bcd65c57e3b4c7d29129",
"date": "2019-05-26 12:29:29 -0400",
"subject": "Set log level of protocol processing functions to debug.",
"body": "Setting these to trace effectively made debug level useless in local/remote processes since all debug messages were demoted to trace when called from these functions."
},
{
"commit": "d12d94c53c466eb808459b98669a877c19b5716b",
"date": "2019-05-24 18:09:16 -0400",
"subject": "Make info(), pathCreate() and pathSync() optional for storage drivers.",
"body": "These functions are not required for repository storage so make them optional and error if they are not implemented for non-repository storage, .e.g. pg or spool.\n\nThe goal is to simplify the drivers (e.g. S3) that are intended only for repository storage."
},
{
"commit": "39645fc1a99540063399a7a3b86177a330bd743c",
"date": "2019-05-24 14:33:47 -0400",
"subject": "Add pathRemove() and remove() to S3 storage.",
"body": "These functions will be needed for the expire command."
},
{
"commit": "6c385dfa7a7f489159c06c5a31fd3cd7c77c39a8",
"date": "2019-05-24 13:56:38 -0400",
"subject": "Add function to determine if HTTP response code is OK.",
"body": "OK responses are a range rather than a single value, so simplify the check with a function."
},
{
"commit": "96770c529be4df408b9d1fc39fc5157e90555375",
"date": "2019-05-24 13:12:56 -0400",
"subject": "storageList() returns an empty list by default for missing paths.",
"body": "The prior behavior was to return NULL so the caller would know the path was missing, but this is rarely useful, complicates the calling code, and increases the chance of segfaults.\n\nThe .nullOnMissing param has been added to enable the prior behavior."
},
{
"commit": "707e4a29f04a733cff868f37b90f8bf83a02394c",
"date": "2019-05-24 11:09:43 -0400",
"subject": "Notify compiler that cryptoErrorCode() does not return."
},
{
"commit": "01f3024b5c0a83819d58ee6ccc2edb5109277aaa",
"date": "2019-05-24 11:06:11 -0400",
"subject": "Add missing const qualifier."
},
{
"commit": "39cb6248314e21530924886e6e669ac395daeeb1",
"date": "2019-05-24 07:45:03 -0400",
"subject": "Add missing menus to the new user guides.",
"body": "Since the CentOS 6/7 user guides were generated as a single page they did not get menus. Generate the entire site for each user guide so menus are included."
},
{
"commit": "04f8b4ea52f89d1542b25d2fb0ba28a43ddaba6d",
"date": "2019-05-24 07:41:55 -0400",
"subject": "Use git url for website clone."
},
{
"commit": "ec9622cde883c649c1346cbc0b9057e7f3fcb787",
"date": "2019-05-22 18:54:49 -0400",
"subject": "Use the git log to ease release note management.",
"body": "The release notes are generally a direct reflection of the git log. So, ease the burden of maintaining the release notes by using the git log to determine what needs to be added.\n\nCurrently only non-dev items are required to be matched to a git commit but the goal is to account for all commits.\n\nThe git history cache is generated from the git log but can be modified to correct typos and match the release notes as they evolve. The commit hash is used to identify commits that have already been added to the cache.\n\nThere's plenty more to do here. For instance, links to the commits for each release item should be added to the release notes."
},
{
"commit": "86482c7db943375d48fcee0e243ca96bdf50d35c",
"date": "2019-05-22 18:23:44 -0400",
"subject": "Reduce log level for all expect tests to detail.",
"body": "The C code is designed to be efficient rather than deterministic at the debug log level. As we move more testing from integration to unit tests it makes less sense to try and maintain the expect logs at this log level.\n\nMost of the expect logs have already been moved to detail level but mock/all still had tests at debug level. Change the logging defaults in the config file and remove as many references to log-level-console as possible."
},
{
"commit": "e4cc008b982d47ac526962e310c18626e2aefbc2",
"date": "2019-05-22 11:31:38 -0400",
"subject": "Remove duplicated hint.",
"body": "At some point this hint got added to the underlying code so it is no longer needed here."
},
{
"commit": "ff9c1bed5de380a6e7df1cbc6870b972d93b3dc4",
"date": "2019-05-22 11:24:18 -0400",
"subject": "Save cipher-pass key/value missed in f492f057.",
"body": "This value is required when encryption is enabled.\n\nIn passing simplify the expression used to skip the checksum when calculating the checksum."
},
{
"commit": "3da60f4b5ee8ed663fc5e8d8968709dbaadee1f6",
"date": "2019-05-22 11:10:43 -0400",
"subject": "Don't escape / when rendering JSON.",
"body": "/ is escaped in the spec but the Perl renderer we use does not escape it which leads to checksum mismatches between the two sets of code.\n\nThis particular escape seems to be a more recent addition to the spec and is targeted toward embedding JSON in JavaScript.\n\n\\/ is still allowed when parsing JSON."
},
{
"commit": "664054fea94186374dcae84e31e0cd7329c279d0",
"date": "2019-05-22 06:55:31 -0400",
"subject": "Remove RHEL package patch merged to upstream."
},
{
"commit": "e1cce9c6147446c026f528cc4afe518de0bcb87f",
"date": "2019-05-21 14:07:35 -0400",
"subject": "Remove extraneous parens."
},
{
"commit": "936b8a289c4884dd22f7ff0d3d624d6e70980512",
"date": "2019-05-21 10:37:30 -0400",
"subject": "Allow separate paragraphs in release items.",
"body": "The first paragraph should match the first line of the commit message as closely as possible. The following paragraphs add more information.\n\nRelease items have been updated back to 2.01."
},
{
"commit": "e3fe3434b4428398ffbee5359f0e0cdec8e55bcb",
"date": "2019-05-21 10:14:41 -0400",
"subject": "Rename repo-s3-verify-ssl option to repo-s3-verify-tls.",
"body": "The new name is preferred because pgBackRest does not support any SSL protocol versions (they are all considered to be insecure).\n\nThe old name will continue to be accepted."
},
{
"commit": "1bc84c647490d6cf78975b5dde5b1937016d24c6",
"date": "2019-05-20 17:07:37 -0400",
"subject": "The local command for restore is implemented entirely in C.",
"body": "This is just the part of restore run by the local helper processes, not the entire command.\n\nEven so, various optimizations in the code (like connection reuse and optimizations for zero-length files) should make the restore command faster on object stores."
},
{
"commit": "a839830333490555800377ea095d756765f476e4",
"date": "2019-05-20 16:19:14 -0400",
"subject": "Add most unimplemented functions to the remote storage driver.",
"body": "Add pathCreate(), pathRemove(), pathSync(), and remove() to the driver."
},
{
"commit": "bbf2e0d5b0876d3663cc69d10925c6e0d08cd729",
"date": "2019-05-20 12:24:43 -0400",
"subject": "Remove extra linefeed."
},
{
"commit": "a9f589b87a09bd37ad903b5c37bcd3000d47840d",
"date": "2019-05-20 12:23:40 -0400",
"subject": "Begin v2.15 development."
},
{
"commit": "0f685a33a02adde45792711b957a75391fc5f34e",
"date": "2019-05-20 11:51:58 -0400",
"subject": "v2.14: Bug Fix and Improvements"
},
{
"commit": "51d67ce1ba932476b2349dbe611f77ab4f15213d",
"date": "2019-05-16 09:59:34 -0400",
"subject": "Update contributor name."
},
{
"commit": "2b75f57232e3d2c983e0a703b6807dadd0b4c0e6",
"date": "2019-05-16 09:56:48 -0400",
"subject": "Add linefeeds for clarity."
},
{
"commit": "19d8358cba0064392cd519e7bce66bb3dcce3dc9",
"date": "2019-05-16 09:53:55 -0400",
"subject": "Update mock/expire module test matrix so expect tests output.",
"body": "Also add an error message to prevent regression."
},
{
"commit": "c51274d1b6a85aeb8ecf1dfffcdc68a503ac3de9",
"date": "2019-05-16 08:32:02 -0400",
"subject": "Add user guides for CentOS/RHEL 6/7.",
"body": "It would be better if the documentation could be generated on multiple operating systems all in one go, but the doc system currently does not allow vars to be changed once they are set.\n\nThe solution is to run the docs for each required OS and stitch the documentation together. It's not pretty but it works and the automation in release.pl should at least make it easy to use."
},
{
"commit": "bc7b42e71811e1b3231c1386496efbdf8338e086",
"date": "2019-05-16 07:35:45 -0400",
"subject": "Restore index menu url default lost in b85e51d6.",
"body": "The url for the menu item referring to the index (i.e. site root page) should use {[project-url-root]}.\n\nThis allows the url to be set to different values depending on the location of the index."
},
{
"commit": "a4561dc0879fd1fb383ecbeafa6936729a515190",
"date": "2019-05-16 07:29:17 -0400",
"subject": "Add --out-preserve to preserve contents of output path.",
"body": "Useful for building a single set of documentation over multiple doc.pl runs."
},
{
"commit": "bc30027d730e4ce7090919406eb0d7f5c7f7e51e",
"date": "2019-05-16 07:04:28 -0400",
"subject": "Fix typo in doc.pl command-line help."
},
{
"commit": "18d4cb574180d279dbbdabd8b87b9dab43115659",
"date": "2019-05-15 13:14:58 -0400",
"subject": "Bypass database checks when stanza-delete issued with force.",
"body": "Previously it was not possible to delete a stanza if the PostgreSQL server could not be contacted."
},
{
"commit": "5c1d4bcd0d41590e722f2d184cf64a62b740625c",
"date": "2019-05-15 13:04:56 -0400",
"subject": "Automate coverage summary report generation.",
"body": "This report replaces the lcov report that was generated manually for each release.\n\nThe lcov report was overly verbose just to say that we have virtually 100% coverage."
},
{
"commit": "5bba72b87445f3edd2c7a2e636ffcb46cac5d9dd",
"date": "2019-05-15 12:55:08 -0400",
"subject": "Remove -Wswitch-enum compiler option.",
"body": "The -Wswitch option included in -Wall provides the same level of coverage and allows enum options to be grouped into default."
},
{
"commit": "53f6232264f27a029d3f6261c75a16585ade1951",
"date": "2019-05-14 10:35:39 -0400",
"subject": "Improve coverage in config/parse module."
},
{
"commit": "1e5ab69cada2862cbc458ae322bdc166c244f0f8",
"date": "2019-05-13 19:10:24 -0400",
"subject": "Improve coverage in config/config module."
},
{
"commit": "57281d479296627e30cccd00c089f3fb40a076ca",
"date": "2019-05-13 18:05:54 -0400",
"subject": "Add MAX_ASSIGN() macro.",
"body": "This improves coverage in cases where the compared values may be always ascending or descending."
},
{
"commit": "15a33bf74be84bda822e96c91e37479419b451a9",
"date": "2019-05-13 17:10:41 -0400",
"subject": "Error on multiple option alternate names and simplify help command.",
"body": "There are currently no options with multiple alternate (deprecated) names so the code to render them in the help command could not be covered.\n\nRemove the uncovered code and add an error when multiple alternate names are configured. It's not clear that the current code was handling this correctly, so it will need to be reviewed if it comes up again."
},
{
"commit": "2d2bec842a2c424d5a36c98dc3a465da1696caf4",
"date": "2019-05-13 13:36:24 -0400",
"subject": "Improve coverage in perl/exec module."
},
{
"commit": "431532574b1e2e59979bd6cf3c333979d0817ad2",
"date": "2019-05-13 07:51:11 -0400",
"subject": "Add testUser() and testGroup().",
"body": "Retrieve the name of the current user/group used for testing."
},
{
"commit": "31d0fe5f50a1a061c3ffbf7d194fafffee6a34b7",
"date": "2019-05-11 18:20:57 -0400",
"subject": "Improve log performance, simplify macros, rename logWill() to logAny().",
"body": "Pre-calculate the value used by logAny() to improve performance and make it more likely to be inlined.\n\nMove IF_LOG_ANY() into LOG_INTERNAL() to simplify the macros and improve performance of LOG() and LOG_PID(). If the message has no chance of being logged there's no reason to call logInternal().\n\nRename logWill() to logAny() because it seems more intuitive."
},
{
"commit": "87f36e814ea95696870711018c050725e8e7269f",
"date": "2019-05-11 14:51:51 -0400",
"subject": "Improve macros and coverage rules that were hiding missing coverage.",
"body": "The branch coverage exclusion rules were overly broad and included functions that ended in a capital letter, which disabled all coverage for the statement. Improve matching so that all characters in the name must be upper-case for a match.\n\nSome macros with internal branches accepted parameters that might contain conditionals. This made it impossible to tell which branches belonged to which, and in any case an overzealous exclusion rule was ignoring all branches in such cases. Add the DEBUG_COVERAGE flag to build a modified version of the macros without any internal branches to be used for coverage testing. In most cases, the branches were optimizations (like checking logWill()) that improve production performance but are not needed for testing. In other cases, a parameter needed to be added to the underlying function to handle the branch during coverage testing.\n\nAlso tweak the coverage rules so that macros without conditionals are automatically excluded from branch coverage as long as they are not themselves a parameter.\n\nFinally, update tests and code where missing coverage was exposed by these changes. Some code was updated to remove existing coverage exclusions when it was a simple change."
},
{
"commit": "f819a32cdf94bc799a4902ab6aaa559cd11d4ef8",
"date": "2019-05-11 07:57:49 -0400",
"subject": "Improve efficiency of FUNCTION_LOG*() macros.",
"body": "Call stackTraceTestStop()/stackTraceTestStart() once per block instead of with every param call. This was done to be cautious but is not necessary and slows down development.\n\nThese functions were never built into production so had no impact there."
},
{
"commit": "7e2f6a6a4365b48fc89672b5d7de4c1d8937caa6",
"date": "2019-05-09 12:28:39 -0400",
"subject": "Clarify that sort order must be ascending."
},
{
"commit": "f0f105ddeca7b3434d9c3bb78e25247b3c6b7584",
"date": "2019-05-09 12:10:46 -0400",
"subject": "Improve filter's notion of \"done\" to optimize filter processing.",
"body": "Filters had different ideas about what \"done\" meant and this added complication to the group filter processing. For example, gzip decompression would detect end of stream and mark the filter as done before it had been flushed.\n\nImprove the IoFilter interface to give a consistent definition of done across all filters, i.e. no filter can be done until it has started flushing no matter what the underlying driver reports. This removes quite a bit of tricky logic in the processing loop which tried to determine when a filter was \"really\" done.\n\nAlso improve management of the input buffers by pointing directly to the prior output buffer (or the caller's input) to eliminate loops that set/cleared these buffers."
},
{
"commit": "d5fac35fe3efe79f2b39a0e1b5ad3bb1cb1dd173",
"date": "2019-05-09 09:53:24 -0400",
"subject": "Improve zero-length content handling in HttpClient object.",
"body": "If content was zero-length then the IO object was not created. This put the burden on the caller to test that the IO object existed before checking eof.\n\nInstead, create an IO object even if it will immediately return eof. This has little cost and makes the calling code simpler.\n\nAlso add an explicit test for zero-length files in S3 and a few assertions."
},
{
"commit": "15531151d7b3c07f51c442cb8951a5781bcc39d4",
"date": "2019-05-09 08:55:48 -0400",
"subject": "Add --c option to request a C remote.",
"body": "The rules for when a C remote is required are getting complicated and will get worse when restoreFile() is migrated.\n\nInstead, set the --c option when a C remote is required. This option will be removed when the remote is entirely implemented in C."
},
{
"commit": "c99c7c458b0a04d1f1a637be70bb4f8e8011feb0",
"date": "2019-05-09 08:28:58 -0400",
"subject": "Add pathExists() to Storage object.",
"body": "The S3 driver did not get an implementation since S3 has a weak notion of paths, and it is not currently required."
},
{
"commit": "cb00030ee38148a99df9d5ddcaef64252b0b50c9",
"date": "2019-05-08 18:58:07 -0400",
"subject": "Remove dead code missed in 1b486847.",
"body": "This commit removed all Perl references to spool storage but some stuff was left behind."
},
{
"commit": "f1eea2312104ce7fa87119d6ef50a554b154e954",
"date": "2019-05-03 18:52:54 -0400",
"subject": "Add macros for object free functions.",
"body": "Most of the *Free() functions are pretty generic so add macros to make creating them as easy as possible.\n\nCreate a distinction between *Free() functions that the caller uses to free memory and callbacks that free third-party resources. There are a number of cases where a driver needs to free resources but does not need a normal *Free() because it is handled by the interface.\n\nAdd common/object.h for macros that make object maintenance easier. This pattern can also be used for many more object functions."
},
{
"commit": "7ae96949f18af90a9b07f1dd712f939ca7a1ec41",
"date": "2019-05-03 18:09:58 -0400",
"subject": "Various MemContext callback improvements.",
"body": "Rename memContextCallback() to memContextCallbackSet() to be more consistent with other parts of the code.\n\nFree all context memory when an exception is thrown from a callback. Previously only the child contexts would be freed and this resulted in some allocations being lost. In practice this is probably not a big deal since the process will likely terminate shortly, but there may well be cases where that is not true."
},
{
"commit": "4a20d44c6b118143f1c1607bacac0d4e268f6ffe",
"date": "2019-05-03 17:49:57 -0400",
"subject": "Add common/macro.h for general-purpose macros.",
"body": "Add GLUE() macro which is useful for creating identifiers.\n\nMove MACRO_TO_STR() here and rename it STRINGIFY(). This appears to be the standard name for this type of macro and it is also an awesome name."
},
{
"commit": "32ca27a20b13941cfab27672d6f383a0ba44fa20",
"date": "2019-05-03 15:46:15 -0400",
"subject": "Simplify storage object names.",
"body": "Remove \"File\" and \"Driver\" from object names so they are shorter and easier to keep consistent.\n\nAlso remove the \"driver\" directory so storage implementations are visible directly under \"storage\"."
},
{
"commit": "8c712d89ebe10e3d318952a0b4db8cd09f8a580c",
"date": "2019-05-02 17:52:24 -0400",
"subject": "Improve type safety of interfaces and drivers.",
"body": "The function pointer casting used when creating drivers made changing interfaces difficult and led to slightly divergent driver implementations. Unit testing caught production-level errors but there were a lot of small issues and the process was harder than it should have been.\n\nUse void pointers instead so that no casts are required. Introduce the THIS_VOID and THIS() macros to make dealing with void pointers a little safer.\n\nSince we don't want to expose void pointers in header files, driver functions have been removed from the headers and the various driver objects return their interface type. This cuts down on accessor methods and the vast majority of those functions were not being used. Move functions that are still required to .intern.h.\n\nRemove the special \"C\" crypto functions that were used in libc and instead use the standard interface."
},
{
"commit": "28359eea83206f6eeddd3fbc91a52cd42399e529",
"date": "2019-05-02 16:33:23 -0400",
"subject": "Update code count rules missed in 027c2638."
},
{
"commit": "0c816f94814767dd96040aa2cb299dfa169d59e5",
"date": "2019-05-02 15:19:26 -0400",
"subject": "Update comments for storageExists() and driver functions."
},
{
"commit": "498017bcf02560e101703e89b1119d0b48944835",
"date": "2019-05-02 12:43:09 -0400",
"subject": "Various Buffer improvements.",
"body": "Add bufDup() and bufNewUsedC().\n\nArrange bufNewC() params to match bufNewUsedC() since they have always seemed backward.\n\nFix bufHex() to only render the used portion of the buffer and fix some places where used was not being set correctly.\n\nUse a union to make macro assignments for all legal values without casting. This is much more likely to catch bad assignments."
},
{
"commit": "59234f249e73a4038ee1ba5d2e80f8acc11640ce",
"date": "2019-04-29 18:36:57 -0400",
"subject": "Use THROW_ON_SYS_ERROR*() to improve code coverage.",
"body": "There is only one instance in the core code where this helps. It is mostly helpful in the tests.\n\nThere is an argument to be made that only THROW_SYS_ERROR*() variants should be used in the core code to improve test coverage. If so, that will be the subject of a future commit."
},
{
"commit": "683b096e187605c5cf16a727cd2c413540e4d150",
"date": "2019-04-29 18:03:32 -0400",
"subject": "Don't append strerror() to error message when errno is 0.",
"body": "Some functions (e.g. getpwnam()/getgrnam()) will return an error but not set errno. In this case there's no use in appending strerror(), which will be \"Success\". This is confusing since an error has just been reported.\n\nAt least in the examples above, an error with no errno set just means \"missing\" and our current error message already conveys that."
},
{
"commit": "6ad44db9a0a30ad933a6ca8012de52558b7b9c02",
"date": "2019-04-29 17:30:06 -0400",
"subject": "Merge duplicated contributor."
},
{
"commit": "518bba1ed950633746f33474cbfa90f76324e345",
"date": "2019-04-29 17:22:01 -0400",
"subject": "Add missing assert."
},
{
"commit": "af33126cb68915db9644ca941fc2490d09107b0c",
"date": "2019-04-29 17:17:14 -0400",
"subject": "Allow StorageFileWrite to set user, group, and modification time.",
"body": "The S3 driver will throw an error if these options are set since they are not supported."
},
{
"commit": "d0c296bd5b67966fd35fd9f70c25788dd6de0c34",
"date": "2019-04-29 16:10:27 -0400",
"subject": "Fix segfault when process-max > 8 for archive-push/archive-get.",
"body": "The remote list was at most 9 (based on pg[1-8]-* max index) so anything over 8 wrote into unallocated memory.\n\nThe remote for the main process is (currently) stored in position zero so do the same for remotes started from locals, since there should only be one. The main process will need to start more remotes in the future which is why there is extra space."
},
{
"commit": "c935b1c9e83d6f14644de3aa5f36011234e69423",
"date": "2019-04-29 15:20:54 -0400",
"subject": "Add missing httpUriEncode() in S3 request.",
"body": "This was not a live bug since the files currently handled by C can't have special characters in them."
},
{
"commit": "62b48d8a5a9bb7aa962e96566073dd58cfdb4436",
"date": "2019-04-29 15:14:10 -0400",
"subject": "Allow storageInfo() to follow links.",
"body": "This allows info to be retrieved from linked files/paths in a single step."
},
{
"commit": "60edadf71dbbe6c82c5a83bcebee36a16b42ed88",
"date": "2019-04-29 14:54:49 -0400",
"subject": "Expose handle (file descriptor) from IoWrite when applicable.",
"body": "This is a followup to dee90d3e which exposed file handles for IoRead.\n\nAlso expose handle for StorageDriverPosixFileRead missed in dee90d3e."
},
{
"commit": "e2141cc05faa4032f7da55afacc57bf17ce11838",
"date": "2019-04-29 14:23:37 -0400",
"subject": "Add missing space."
},
{
"commit": "027c2638719dffa9ba99250085c403e89a2a8a9a",
"date": "2019-04-26 08:08:23 -0400",
"subject": "Add configure script for improved multi-platform support.",
"body": "Use autoconf to provide a basic configure script. WITH_BACKTRACE is yet to be migrated to configure and the unit tests still use a custom Makefile.\n\nEach C file must include \"build.auto.conf\" before all other includes and defines. This is enforced by test.pl for includes, but it won't detect incorrect define ordering.\n\nUpdate packages to call configure and use standard flags to pass options."
},
{
"commit": "3505559a808855600016dc73c5aec3843e51bfaf",
"date": "2019-04-24 13:23:32 -0400",
"subject": "Update test containers with PostgreSQL minor releases and liblz4.",
"body": "Update RHEL repos that have changed upstream. Remove PostgreSQL 9.3 since the RHEL6/7 packages have disappeared.\n\nRemove PostgreSQL versions from U12 that are still getting minor updates so the container does not need to be rebuilt.\n\nLZ4 is included for future development, but this seems like a good time to add it to the containers."
},
{
"commit": "1ae8a6a71665c12bec6e20741df29ba4792bf8f8",
"date": "2019-04-23 20:52:03 -0400",
"subject": "Add build-max option to set max build processes.",
"body": "Currently this controls make processes via -j."
},
{
"commit": "c11c936366fd93a6cdb143d7d93a1d8f249ee9c2",
"date": "2019-04-23 20:19:31 -0400",
"subject": "Reduce ScalityS3 processes since only two are needed."
},
{
"commit": "52b0b81976df5583ebe12189d8697dd66d23e84b",
"date": "2019-04-23 19:33:55 -0400",
"subject": "Add storageInfoList() to get detailed info about all entries in a path.",
"body": "The function provides all the file/path/link information required to build a backup manifest.\n\nAlso update storageInfo() to provide the same information for a single file."
},
{
"commit": "f492f0571b145d499f4ff9017219794a5a3c7a1b",
"date": "2019-04-23 17:08:34 -0400",
"subject": "Add *Save() functions to most Info objects.",
"body": "At the same time change the way that load constructors work (and are named) so that Ini objects do not persist after the constructors complete.\n\ninfoArchiveSave() is excluded from this commit since it is just a trivial call to infoPgSave() and won't be required soon."
},
{
"commit": "f41112a4634421071d80686ae19042c652576cb3",
"date": "2019-04-23 14:02:30 -0400",
"subject": "Add harnessInfoChecksum/Z() to ease creation of test info files."
},
{
"commit": "aebac47cd5fa21f6e62ee3dce3ef13abf59ca61f",
"date": "2019-04-23 13:58:19 -0400",
"subject": "Extern infoHash() so it can be used by other modules.",
"body": "This is currently needed only for testing, but there's no reason not to expose the function to everyone."
},
{
"commit": "cddb0c05b444aaed388e53e0cd0b02148307ca87",
"date": "2019-04-23 13:03:22 -0400",
"subject": "Add iniSave() and iniMove() to Ini object.",
"body": "iniSave() sorts alphabetically to maintain compatibility with the expect tests, but we plan to change this behavior when the migration is complete."
},
{
"commit": "c650134a0414c154eb21609b363aeceafbfdda60",
"date": "2019-04-22 18:46:29 -0400",
"subject": "Add ioWriteStr() and ioWriteStrLine().",
"body": "These function names make it clearer what is being written.\n\nThe old ioWriteLine() has been repurposed to write buffers."
},
{
"commit": "81f652137c8f3179aad24d3283a4141b0075ae66",
"date": "2019-04-22 18:41:01 -0400",
"subject": "Add separate functions to encode/decode each JSON type.",
"body": "In most cases the JSON type is known so this is more efficient than converting to Variant first, both in terms of memory and time.\n\nAlso rename some of the existing functions for consistency."
},
{
"commit": "f100ea0ff44e173299e8f691115b9e7ce68d422b",
"date": "2019-04-22 17:52:23 -0400",
"subject": "Add constant for maximum buffer sizes required by cvt*() functions.",
"body": "Also update Variant to use cvt*() in all cases. Variant was written before these functions were available and not all cases were updated."
},
{
"commit": "f5739051eba3dae6cbee6d1fc0f72c36705c3be1",
"date": "2019-04-22 17:17:56 -0400",
"subject": "Add true and false String constants."
},
{
"commit": "47491e3c47e84be17263ce3b897ab3fcd8879a3f",
"date": "2019-04-22 16:04:04 -0400",
"subject": "varNewKv() accepts a KeyValue object rather than creating one.",
"body": "This allows for more flexibility about when the Variant is created."
},
{
"commit": "fdf19e5ab68c64f6c063c265bd3ddc5b39b56620",
"date": "2019-04-22 09:00:50 -0400",
"subject": "Refactor Ini interface to expose String values instead of Variant.",
"body": "Variants were being used to expose String and StringList types but this can be done more simply with an additional method.\n\nUsing only strings also allows for a more efficient implementation down the road."
},
{
"commit": "cc39bddc15b7cb5bba5dd8443325ee199e8aa12b",
"date": "2019-04-22 08:47:32 -0400",
"subject": "Refactor main() as a switch() statement.",
"body": "This makes it clearer what has been migrated and where the new C implementations should go."
},
{
"commit": "38286272596d7b53b88c3f4f081d6c7dfc9360d8",
"date": "2019-04-21 14:59:32 -0400",
"subject": "Fix missing const."
},
{
"commit": "e7255be108b6b85bb736934b19abdef32cbd39e8",
"date": "2019-04-20 11:25:04 -0400",
"subject": "Only process next filter in IoFilterGroup when input buffer is full or flushing.",
"body": "This greatly reduces calls to filter processing, which is a performance benefit, but also makes the trace logs smaller and easier to read.\n\nHowever, this means that ioWriteFlush() will no longer work with filters since a full flush of IoFilterGroup would require an expensive reset. Currently ioWriteFlush() is not used in this scenario so for now just add an assert to ensure it stays that way."
},
{
"commit": "e513c52c0973772465a81a5db2ba18d0f956d686",
"date": "2019-04-20 08:16:17 -0400",
"subject": "Add macros to create constant Buffer objects.",
"body": "These are more efficient than creating buffers in place when needed.\n\nAfter replacement discovered that bufNewStr() and BufNewZ() were not being used in the core code so removed them. This required using the macros in tests which is not the usual pattern."
},
{
"commit": "c9168028c6c43d535a5663cb17ce93945951cb7e",
"date": "2019-04-19 14:38:11 -0400",
"subject": "Improve performance of non-blocking reads by using maximum buffer size.",
"body": "Since the introduction of blocking read drivers (e.g. IoHandleRead, TlsClient) the non-blocking drivers have used the same rules for determining maximum buffer size, i.e. read only as much as requested. This is necessary so the blocking drivers don't get stuck waiting for data that might not be coming.\n\nInstead mark blocking drivers so IoRead knows how much buffer to allow for the read. The non-blocking drivers can now request the maximum number of bytes allowed by buffer-size."
},
{
"commit": "0c866f52c69ee2bd6af20e67af78bad94c4048af",
"date": "2019-04-19 11:40:39 -0400",
"subject": "Update code to use new unsigned int Variant type and config methods."
},
{
"commit": "9f0829cbf2fcd9be869cac21fbf974fd7ecce019",
"date": "2019-04-19 11:29:08 -0400",
"subject": "Add cfgOptionUInt() and cfgOptionUInt64().",
"body": "These are better than casting from cfgOptionInt() since bounds checking is performed."
},
{
"commit": "1adcbc5c913bddac3a2078b2c5b7329617fa504c",
"date": "2019-04-19 11:22:43 -0400",
"subject": "Add unsigned int Variant type.",
"body": "This is better than using (unsigned int)varUInt64() because bounds checking is performed."
},
{
"commit": "c45ae5f221ba9cc5e65f585920cc1ea23e3dd293",
"date": "2019-04-19 08:41:17 -0400",
"subject": "Begin v2.14 development."
},
{
"commit": "41f3874822faf3f859f46867c0fe965f7156b123",
"date": "2019-04-18 21:26:02 -0400",
"subject": "v2.13: Bug Fixes"
},
{
"commit": "7390952d8e99649077a6d4b577a483e6c38a3ecd",
"date": "2019-04-18 21:24:10 -0400",
"subject": "Harden IO filters against zero input and optimize zero output case.",
"body": "Add production checks to ensure no filter gets a zero-size input buffer.\n\nAlso, optimize the case where a filter returns no output. There's no sense in running downstream filters if they have no new input."
},
{
"commit": "2d73de1d360e0b7bc66b4db9e6b3a0e441927230",
"date": "2019-04-18 21:21:35 -0400",
"subject": "Fix zero-length reads causing problems for IO filters that did not expect them.",
"body": "The IoRead object was passing zero-length buffers into the filter processing code but not all the filters were happy about getting them.\n\nIn particular, the gzip compression filter failed if it was given no input directly after it had flushed all of its buffers. This made the problem rather intermittent even though a zero-length buffer was being passed to the filter at the end of every file. It also explains why tweaking compress-level or buffer-size allowed the file to go through.\n\nSince this error was happening after all processing had completed, there does not appear to be any risk that successfully processed files were corrupted."
},
{
"commit": "670fa88a98c7e12c4e2e948d92476918d3048f7e",
"date": "2019-04-18 13:21:24 -0400",
"subject": "Add CHECK() macro for production assertions.",
"body": "CHECK() works just like ASSERT() but is kept in production builds."
},
{
"commit": "b258aec0adcf6fdaf7a2494c66f1540aa720e345",
"date": "2019-04-18 13:19:05 -0400",
"subject": "Move lockRelease() to the end of exitSafe().",
"body": "Releasing the lock too early was allowing other async processes to sneak in and start running before the current process was completely shut down.\n\nThe only symptom seems to have been mixed up log messages so not a very serious issue."
},
{
"commit": "b960919cf7322f03ee4f9681f0cb06da6b4c52de",
"date": "2019-04-18 10:36:21 -0400",
"subject": "Fix reliability of error reporting from local/remote processes.",
"body": "Asserts were only only reported on stderr rather than being returned through the protocol layer. This did not appear to be very reliable.\n\nInstead, report the assert through the protocol layer like any other error. Add a stack trace if an assert error or debug logging is enabled."
},
{
"commit": "281d2848b92bf7dba36018127cb9238662d7875b",
"date": "2019-04-17 18:39:35 -0400",
"subject": "Option to build documentation from current apt.postgres.org packages.",
"body": "This is useful for testing any issue currently being seen in the field.\n\nWe'll also need to add a \"yum\" option at some point."
},
{
"commit": "0d4ba3a39f10667bb0234a94850548ab2dd7ab2d",
"date": "2019-04-17 18:18:55 -0400",
"subject": "Fix Posix/CIFS error messages reporting the wrong filename on write/sync/close.",
"body": "The reported file name was the destination file, not the temp file that is written to during atomic write operations."
},
{
"commit": "4c13955c05662c2df3fb13cfc1d5538c2a0010a0",
"date": "2019-04-17 08:04:22 -0400",
"subject": "Add macros to create constant Variant types.",
"body": "These work almost exactly like the String constant macros. However, a struct per variant type was required which meant custom constructors and destructors for each type.\n\nPropagate the variant constants out into the codebase wherever they are useful."
},
{
"commit": "2dac4b598620693d1d564c0ecb2c124693357d6f",
"date": "2019-04-16 13:39:58 -0400",
"subject": "Add STR() macro to create constant String objects from runtime strings.",
"body": "The STRING_CONST() macro worked fine for constants but was not able to constify strings created at runtime.\n\nAdd the STR() macro to do this by using strlen() to get the size.\n\nAlso rename STRING_CONST() to STRDEF() for brevity and to match the other macro name."
},
{
"commit": "a029eba8d56dc2167814669bc8c5ba12f2eaab80",
"date": "2019-04-16 13:18:30 -0400",
"subject": "Use a macro instead of a nested struct to create common String variables.",
"body": "This makes the code a bit less obfuscated while still ensuring that these variables will be common to both String structures."
},
{
"commit": "a7281878ac8e058b528e49f80a525c09f62a39ed",
"date": "2019-04-15 08:29:25 -0400",
"subject": "Migrate backupRegExp() to C.",
"body": "Removed the \"anchor\" parameter because it was never used in any calls in the Perl code so it was just a dead parameter that always defaulted to true."
},
{
"commit": "39ed4f763b923905b651938b7fe65c48e099b880",
"date": "2019-04-12 18:13:01 -0400",
"subject": "Various comment and assert fixes in the info modules."
},
{
"commit": "65a26ac4ba111c1e7e4bfd6c0a0bf1d84afd66e8",
"date": "2019-04-12 18:10:39 -0400",
"subject": "Convert commented cipherPass params to test params.",
"body": "This param will show up in stack traces for test builds, but not production."
},
{
"commit": "c5157c03345eaf4b8e9e7e06190d75021e9d8e39",
"date": "2019-04-12 09:03:34 -0400",
"subject": "Automatically generate constants for command and option names.",
"body": "These constants are easier than using cfgOptionName() and cfgCommandName() and lead to cleaner code and simpler to construct messages.\n\nString versions are provided. Eventually all the strings will be used in the config structures, but for now they are useful to avoid wrapping with strNew()."
},
{
"commit": "867690c08d5710d0cab27a9ee5ba879f7216abda",
"date": "2019-04-12 08:33:10 -0400",
"subject": "Begin v2.13 development.",
"body": "Also update CentOS packages so documentation builds."
},
{
"commit": "4e57b689165cffd8c686f0f36d0c5dccb553b3e1",
"date": "2019-04-11 09:14:22 -0400",
"subject": "v2.12: C Implementation of Archive Push"
},
{
"commit": "df12cbb1625ed61c74d43ae3a308445f943b0570",
"date": "2019-04-10 17:48:34 -0400",
"subject": "Fix C code to recognize host:port option format like Perl does.",
"body": "This was not an intentional feature in Perl, but it works, so it makes sense to implement the same syntax in C.\n\nThis is a break from other places where a -port option is explicitly supplied, so it may make sense to support both styles going forward. This commit does not address that, however."
},
{
"commit": "3aa521fed0838021209b4be36849feb2c7e40a2e",
"date": "2019-04-10 13:37:24 -0400",
"subject": "Fix compile flag accidentally removed in 5ee8388f."
},
{
"commit": "25cea0bd0a22de2f83a2ded786e2facc86ff4b10",
"date": "2019-04-09 11:08:27 -0400",
"subject": "Add process id to C archive-get and archive-push logging.",
"body": "This was missed in the original migration. There was no functional issue, but logging the process ids is useful for debugging."
},
{
"commit": "8c202c77dac74d919962f69acb279b583b4272ff",
"date": "2019-04-09 11:01:35 -0400",
"subject": "Add process id to ProtocolParallelJob.",
"body": "This exposes the process that performed to job to the caller for logging purposes."
},
{
"commit": "4ace7edbd9e849d5a7a5d8b20e08c0c3e2098a02",
"date": "2019-04-09 10:54:36 -0400",
"subject": "Allow process id in C logging",
"body": "The default process id in C logging has always been zero. This should have been updated when multi-processing was introduced in C, but it was missed."
},
{
"commit": "6099729e922893312e001a3394db43d0c2b341ad",
"date": "2019-04-08 19:38:06 -0400",
"subject": "Improve error message when an S3 bucket name contains dots.",
"body": "The Perl lib we have been using for TLS allows dots in wildcards, but this is forbidden by RFC-2818. The new TLS implementation in C forbids this pattern, just as PostgreSQL and curl do.\n\nHowever, this does present a problem for users who have been using bucket names with dots in older versions of pgBackRest. Since this limitation exists for security reasons there appears to be no option but to take a hard line and do our best to notify the user of the issue as clearly as possible."
},
{
"commit": "21c83eea59f5fb4d3c366a1e9782d26356801675",
"date": "2019-04-08 17:21:20 -0400",
"subject": "Fix issues when log-level-file=off is set for the archive-get command.",
"body": "This problem was not specific to archive-get, but that was the only place it was expressing in the last release. The new archive-push was also affected.\n\nThe issue was with daemon processes that had closed all their file descriptors. When exec'ing and setting up pipes to communicate with a child process the dup2() function created file descriptors that overlapped with the first descriptor (stdout) that was being duped into. This descriptor was subsequently closed and wackiness ensued.\n\nIf logging was enabled (the default) that increased all the file descriptors by one and everything worked.\n\nFix this by checking if the file descriptor to be closed is the same one being dup'd into. This solution may not be generally applicable but it works fine in this case."
},
{
"commit": "8ac422dca95c8761fc57450ed74061ff286ff0c3",
"date": "2019-04-07 21:09:29 -0400",
"subject": "Close log file before exec().",
"body": "The log file should be closed before exec() so the child process does not retain a reference to it."
},
{
"commit": "ade20e5c657f1a05bbe00c1f693346bfadd8b795",
"date": "2019-04-07 19:11:20 -0400",
"subject": "Fix typo in error message."
},
{
"commit": "9f3425f6dd2892721935103ff3f75555b7408dd5",
"date": "2019-04-07 18:47:04 -0400",
"subject": "Skip coverage for macros with numbers in their name.",
"body": "This was an oversight in the old regular expression."
},
{
"commit": "c72a94cfec64096d0f18fa1385b1347918be4fdb",
"date": "2019-04-07 18:20:03 -0400",
"subject": "Increase process-max limit to 999.",
"body": "Recent hardware has outstripped the old default so increase it to something that should last for a while."
},
{
"commit": "9a7eab9428b8ce34b31b878bd5e6af4f842ce8d7",
"date": "2019-04-07 18:12:07 -0400",
"subject": "Allow three-digits process IDs in logging.",
"body": "This is required to support process-max > 99 or else there will be formatting/alignment issues in the logs."
},
{
"commit": "2a85df95c121528d826e30526a2fd251638624e7",
"date": "2019-04-03 17:48:45 +0100",
"subject": "Add assert missed in 1b486847.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "1e5f2713b2936bd3252e0081a979a9d84eba19d0",
"date": "2019-04-03 16:40:19 +0100",
"subject": "Add memContextSwitch() missed in 5bdaa35f.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "5504f286eb6765d3131f2ff99cb2b464a02c4589",
"date": "2019-04-03 12:32:56 +0100",
"subject": "Add test and asserts missed in abba2bd1.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "be58b8fee799d29cc5f1df0147bce59b09982208",
"date": "2019-04-03 12:04:44 +0100",
"subject": "Add assert missed in 1b486847.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "e97b8241a59f4dd56ea374b00b3fb9905a1febc3",
"date": "2019-04-03 11:40:12 +0100",
"subject": "Clarify that S3-compatible object stores are supported.",
"body": "The documentation mentioned Amazon S3 frequently but failed to mention that other S3-compatible object stores are also supported.\n\nTone down the specific mentions of Amazon S3 and replace them with \"S3-compatible object store\" when appropriate."
},
{
"commit": "4c63279a19a6baa1f6854eee59cc804f6f89cb23",
"date": "2019-04-02 13:50:02 +0100",
"subject": "Add forkSafe() to handle fork errors.",
"body": "fork() rarely fails but we should definitely detect when it does so."
},
{
"commit": "1b48684713220b3436b24b266e543196824e974f",
"date": "2019-03-29 13:26:33 +0000",
"subject": "The archive-push command is implemented entirely in C.",
"body": "This new implementation should behave exactly like the old Perl code with the exception of updated log messages.\n\nRemove as much of the Perl code as possible without breaking other commands."
},
{
"commit": "251dbede8ff8a7206986106b8df8b08257cd7ebd",
"date": "2019-03-27 21:14:06 +0000",
"subject": "Add locking capability to the remote command.",
"body": "When a repository server is configured, commands that modify the repository acquire a remote lock as well as a local lock for extra protection against multiple writers.\n\nInstead of the custom logic used in Perl, make remote locking part of the command configuration.\n\nThis also means that the C remote needs the stanza since it is used to construct the lock name. We may need to revisit this at a later date."
},
{
"commit": "7db8cedd68477dd511bb8bdf8b94b2d2925470dd",
"date": "2019-03-27 20:59:28 +0000",
"subject": "Add protocolKeepAlive() to send noops to all remotes.",
"body": "While the local processes are doing their jobs the remote connection from the main process may timeout.\n\nSend occasional noops to ensure that doesn't happen."
},
{
"commit": "f8cbf5d78cbacfef253f8e75983e403e10049df0",
"date": "2019-03-27 20:52:23 +0000",
"subject": "Add TEST_64BIT() macro to detect 64-bit platforms.",
"body": "This may not be the best way to detect 64-bit platforms but it seems to be working fine so far.\n\nCreate a macro to make it clearer what is being done and to make it easier to change the implementation."
},
{
"commit": "1fa103a4d23742af0fb16214a74b974cbe875724",
"date": "2019-03-27 18:14:00 +0200",
"subject": "Fix missing semicolon in code example."
},
{
"commit": "3181cd0ab8f09cbeca87d97e670e0901feb412a3",
"date": "2019-03-26 18:46:44 +0200",
"subject": "Set WAL long header flag in test function missed in e938a892.",
"body": "This was missed because the unit tests were reusing a buffer without resetting it to zero, so this flag ended up still set when the test function was called.\n\nThis was not a live issue since it only expressed in tests and this code is not used in master yet."
},
{
"commit": "7364d859da8b4ee67e4b0d76e9c0d08a15fa546d",
"date": "2019-03-26 16:00:15 +0200",
"subject": "Add missing parens."
},
{
"commit": "5ee8388f482adc52129a9960bdb077e8c054edb0",
"date": "2019-03-26 08:20:55 +0200",
"subject": "Build test harness with the same warnings as code being tested.",
"body": "The test harness was not being built with warnings which caused some wackiness with an improperly structured switch. Just use the same warnings as the code being tested.\n\nAlso enable warnings on code that is not directly being tested since other code modules are frequently modified during testing."
},
{
"commit": "f709334851cfbe254ce9f13266adba4504e9af64",
"date": "2019-03-25 23:59:56 +0200",
"subject": "Fix comment content and formatting."
},
{
"commit": "abba2bd13269b3d51802cb7bfba18a0abae47342",
"date": "2019-03-25 20:35:20 +0400",
"subject": "Add strLstMergeAnti() for merge anti-joins.",
"body": "We deal with some pretty big lists in archive-push so a nested-loop anti-join looked like it would not be efficient enough.\n\nThis merge anti-join should do the trick even though both lists must be sorted first."
},
{
"commit": "538e2c7474394f1f24bb0899bc7d85bf7c68bd5a",
"date": "2019-03-25 09:45:36 +0400",
"subject": "Add storagePg()/storagePgWrite() to storage helper.",
"body": "Add read/write storage helper functions for the PostgreSQL data directory."
},
{
"commit": "444b4f86403088f24883ffe0b940a6402159bfc0",
"date": "2019-03-25 09:17:15 +0400",
"subject": "Allow warnings to be written by archiveAsyncStatusOkWrite().",
"body": "Migrate this feature to the C code since archive-push will need it."
},
{
"commit": "8820d695747b40b73ead6d32a408e7d2804bd192",
"date": "2019-03-25 08:12:38 +0400",
"subject": "Use a single file to handle global errors in async archiving.",
"body": "The prior behavior on a global error (i.e. not file specific) was to write an individual error file for each WAL file being processed. On retry each of these error files would be removed, and if the error was persistent, they would then be recreated. In a busy environment this could mean tens or hundreds of thousands of files.\n\nAnother issue was that the error files could not be written until a list of WAL files to process had been generated. This was easy enough for archive-get but archive-push requires more processing and any errors that happened when generating the list would only be reported in the pgBackRest log rather than the PostgreSQL log.\n\nInstead write a global.error file that applies to any WAL file that does not have an explicit ok or error file. This reduces churn and allows more errors to be reported directly to PostgreSQL."
},
{
"commit": "1f6f3f673e49a2dff4dff465d183a2f6928138e6",
"date": "2019-03-24 18:29:20 +0400",
"subject": "Update default WAL segment size comment."
},
{
"commit": "1fff60ad2ad56f303080af666ed76e82dbb171b7",
"date": "2019-03-24 14:34:45 +0400",
"subject": "Remove unused infoArchiveCheckPg() function.",
"body": "The idea was to use this function for archive-push, but in the end archive-push required two very different versions of the function."
},
{
"commit": "8560db5c42fdc07de44b86daf76ad195282f67d7",
"date": "2019-03-24 13:54:05 +0400",
"subject": "Add constants for .ok/.error status extensions."
},
{
"commit": "7cf7373761cb83253a502e8d0af4f925c86a7944",
"date": "2019-03-21 21:11:36 +0400",
"subject": "Refactor PostgreSQL interface to remove most code duplication.",
"body": "Having a copy per version worked well until it was time to add new features or modify existing functions. Then it was necessary to modify every version and try to keep them all in sync.\n\nConsolidate all the PostgreSQL types into a single file using #if for type versions. Many types do not change or change infrequently so this cuts down on duplication. In addition, it is far easier to see what has changed when a new version is added.\n\nUse macros to write the interface functions. There is still duplication here since some changes require a new copy of the macro, but it is far less than before."
},
{
"commit": "e938a89250bd6a6512d4d6b5217a9750c848ca49",
"date": "2019-03-19 19:44:06 +0400",
"subject": "Add WAL info to PostgreSQL interface.",
"body": "This allows the WAL header to be read for any supported version on PostgreSQL."
},
{
"commit": "1c9645d4166165f70bf837b7d053415d78a216f2",
"date": "2019-03-19 19:20:38 +0400",
"subject": "Add missing static keyword."
},
{
"commit": "5c732e992904bc7f3201c119787d84cf05a8997d",
"date": "2019-03-18 22:10:25 +0400",
"subject": "Remove redundant documentation from PostgreSQL interface files and clarify ambiguous function names.",
"body": "Move the documentation to postgres/interface.c so it can be updated without having to update N source files.\n\nThe \"is\" function was not very specific so rename to \"controlIs\"."
},
{
"commit": "e26d510d0c1d8157ef5d9149bed9c2902ec29ba2",
"date": "2019-03-17 22:11:35 +0400",
"subject": "Use restore command for remote performances tests.",
"body": "Since archive-push is being moved to C, the Perl remote will no longer work with that command.\n\nEventually this module will need to be rewritten in C, but for now just use the restore command which is planned to be migrated last."
},
{
"commit": "856a369b863fb134ec249b7036eea70ba56d89ac",
"date": "2019-03-17 22:00:54 +0400",
"subject": "Add file write to the S3 storage driver.",
"body": "Now that repositories are writable the storage drivers that don't yet support file writes need to be updated to do so.\n\nNote that the part size for multi-part upload has not been defined as a proper constant. This will become an option in the near future so it doesn't seem worth creating a constant that we might then forget to remove."
},
{
"commit": "7193738288e7c25bba526f5133fad9d4cf70d4c0",
"date": "2019-03-17 21:38:07 +0400",
"subject": "Add document creation to XML objects.",
"body": "The xml objects only exposed read methods of the underlying libxml2.\n\nThis worked for S3 commands that only received data but to send data we need to be able to create XML documents from scratch.\n\nAdd the ability to create empty documents and add nodes and contents."
},
{
"commit": "fc974626cd060271c39480ea5ac960b8db903699",
"date": "2019-03-17 08:35:40 +0400",
"subject": "Add a note regarding verifying checkpoint against replay position."
},
{
"commit": "8ebc6d6c34e7ccc7e4d07f1321fd4b1dce1579c7",
"date": "2019-03-16 21:50:19 +0400",
"subject": "Add file write to the remote storage driver.",
"body": "Now that repositories are writable the storage drivers that don't yet support file writes need to be updated to do so."
},
{
"commit": "2d386cd26672ed6c1ff2ca20465b7c7505cf9de6",
"date": "2019-03-16 16:14:10 +0400",
"subject": "Move WAL path prefix logic into walPath().",
"body": "This logic is used by both archive-push and archive-get."
},
{
"commit": "12273a10346a5520ce556a19df7b0cd4f9be74be",
"date": "2019-03-16 15:48:50 +0400",
"subject": "Add storageRepoWrite() to storage helper.",
"body": "Writable repos are allowed with the addition of the CIFS driver, so add a helper function."
},
{
"commit": "66c2f4cd2e43f05d65e06f3c89094fbdf702d60d",
"date": "2019-03-16 15:27:38 +0400",
"subject": "Make notion of current PostgreSQL info ID in C align with Perl.",
"body": "The C code was assuming that the current PostgreSQL version in archive.info/backup.info was the most recent item in the history, but this is not always the case with some stanza-upgrade scenarios. If a cluster is restored from before the upgrade and stanza-upgrade is run again, it will revert db-id to the original history item.\n\nInstead, load db-id from the db section explicitly as the Perl code does.\n\nThis did not affect archive-get since it does a reverse scan through the history versions and does not rely on the current version."
},
{
"commit": "b2b2cf0511b326c695e825bee0c5f5faf648224c",
"date": "2019-03-16 15:00:02 +0400",
"subject": "Fix issues with remote/local command logging options.",
"body": "Logging was being enable on local/remote processes even if --log-subprocess was not specified, so fix that.\n\nAlso, make sure that stderr is enabled at error level as it was on Perl. This helps expose error information for debugging.\n\nFor remotes, suppress log and lock paths since these are not applicable on remote hosts. These options should be set in the local config if they need to be overridden."
},
{
"commit": "d377e926c806faa8d61744e27eacfa7bf610c445",
"date": "2019-03-16 13:07:43 +0400",
"subject": "httpClientRequest() accepts a body parameter.",
"body": "None of our C HTTP requests have needed to output a body, but they will with the migration of archive-push.\n\nAlso, add constants that are useful when POSTing/PUTing data."
},
{
"commit": "078df66e2c66ea992c423ffc92a789a4f036b622",
"date": "2019-03-16 12:51:37 +0400",
"subject": "Add httpHeaderDup().",
"body": "Allow duplication of headers and updating of redactions."
},
{
"commit": "be670e25450a174f6652850af765805de1139263",
"date": "2019-03-16 12:32:54 +0400",
"subject": "Add hash size constants and extern hash type constant.",
"body": "The size constants are convenient for creating data structures of the proper size.\n\nThe hash type constant must be extern'd so that results can be pulled from a filter."
},
{
"commit": "76560b3cf0959c11b92e3b98c640f5e6070b1e7a",
"date": "2019-03-16 12:26:25 +0400",
"subject": "Add missing const to cryptoHashOne() and cryptoHashOneStr()."
},
{
"commit": "0eb4c2c8291ed0dc5c211594b5e85e1b31a9d84d",
"date": "2019-03-16 12:21:16 +0400",
"subject": "Fix incorrect buffer size used in cryptoHashOne().",
"body": "This was missing when bufUsed() was introduced.\n\nIt is not currently a live issue, but becomes a problem in the new archive-push code where the entire buffer is not always used."
},
{
"commit": "9c1549585e0d8a4613954bbfc194dd0dc0a537a8",
"date": "2019-03-15 22:18:56 +0400",
"subject": "Add command for removing all Docker containers to the Vagrantfile."
},
{
"commit": "b68d1d60a1532e9d1ef2703b043d538643d6f8cc",
"date": "2019-03-15 22:16:50 +0400",
"subject": "Add cvtSSizeToZ() and debug macros."
},
{
"commit": "d16bff64cdcb5be6c6ac3b8f31d394c2393b7649",
"date": "2019-03-15 10:30:48 +0400",
"subject": "Add missing log param and assert."
},
{
"commit": "a6e219bc8bf1f6d93a24ba120fa9614d7b667ce3",
"date": "2019-03-15 10:25:24 +0400",
"subject": "Improve comment, remove duplicated header and extraneous braces."
},
{
"commit": "5554377632807a3e778273b9882a191e8a6edae6",
"date": "2019-03-15 10:20:52 +0400",
"subject": "Make strLstDup() null-tolerant.",
"body": "Duping a NULL StringList without checking if it is NULL is a useful capability."
},
{
"commit": "9382283586da4794d3585dbf6680c3a2f3d10a33",
"date": "2019-03-14 13:48:33 +0400",
"subject": "Fix issues when a path option is / terminated.",
"body": "This condition was not being properly checked for in the C code and it caused problems in the info command, at the very least.\n\nInstead of applying a local fix, introduce a new path option type that will rigorously check the format of any incoming paths."
},
{
"commit": "b8ebea6b1c3cf2a26c44f04c7552c66fd9acb44a",
"date": "2019-03-14 13:38:55 +0400",
"subject": "Add separate archive-push-async command.",
"body": "This command was previously forked off from the archive-push command which required a bit of artificial option and log manipulation.\n\nA separate command is easier to test and will work on platforms that don't have fork(), e.g. Windows."
},
{
"commit": "982b47c5ecec475703860f52a0eabe7d501a96e2",
"date": "2019-03-14 13:28:33 +0400",
"subject": "Add CIFS storage driver.",
"body": "This driver borrows heavily from the Posix driver.\n\nAt this point the only difference is that CIFS does not allow explicit directory fsyncs so they need to be suppressed. At some point the CIFS diver will also omit link support.\n\nWith the addition of this driver repository storage is now writable."
},
{
"commit": "941dbb47313b25339d438e7a57975bcd88c65168",
"date": "2019-03-14 13:02:19 +0400",
"subject": "Remove package patch merged to upstream."
},
{
"commit": "cf5a5b7b9a97fb5907990812745d42ec4e3de7fb",
"date": "2019-03-11 10:43:35 +0200",
"subject": "Begin v2.12 development."
},
{
"commit": "68d20edea6cbfc7b8b6db69633e08ac473821547",
"date": "2019-03-10 18:56:00 +0200",
"subject": "v2.11: C Implementation of Archive Get"
},
{
"commit": "2ef5ad70a29b36db570f8f50a2ba821fc4ee02ff",
"date": "2019-03-10 13:27:30 +0200",
"subject": "Move crypto module to common/crypto.",
"body": "It makes sense for the crypto code to be in common since it is not pgBackRest-specific.\n\nAlso combine the crypto tests into a single module."
},
{
"commit": "95597be81e7450fdbb88a6c17b549e9eb750d5dd",
"date": "2019-03-10 13:11:20 +0200",
"subject": "Move compress module to common/compress.",
"body": "It makes sense for the compression code to be in common since it is not pgBackRest-specific."
},
{
"commit": "2f63babe9dfa6f49d5fbc9a6e039e1a1dfa5054d",
"date": "2019-03-10 11:55:01 +0200",
"subject": "Move help/help test module to command/help."
},
{
"commit": "e4e2606fce1ef28e82f359581e1a90be6d10414c",
"date": "2019-03-10 11:03:52 +0200",
"subject": "Add additional options to backup.manifest for debugging purposes.",
"body": "Add the buffer-size, compress-level, compress-level-network, and process-max options to the backup:option section in backup.manifest to aid in debugging.\n\nIt may also make sense to propagate these options up to backup.info so they can be displayed in the info command, but for now this is deemed sufficient."
},
{
"commit": "21f56f64ebe0af34b61793efad1730707a8e9f39",
"date": "2019-03-10 10:38:12 +0200",
"subject": "Add hints when unable to find a WAL segment in the archive.",
"body": "When this error happens in the context of a backup it can be a bit mystifying as to why the backup is failing. Add some hints to get the user started.\n\nThese hints will appear any time a WAL segment can't be found, which makes the hint about the check command redundant when the user is actually running the check command, but it doesn't seem worth trying to exclude the hint in that case."
},
{
"commit": "bc9fb0f59ae4d9cc843fa8ac2d9d434cf850910d",
"date": "2019-03-10 09:16:25 +0200",
"subject": "Add note for CSTD settings on BSD variants.",
"body": "Suggested by ucando, jungle-boogie, Luca Ferrari."
},
{
"commit": "786e77a9feb0ec3133d7f1ab7efe0037816a1382",
"date": "2019-03-09 11:40:55 +0200",
"subject": "Make DESTDIR fully-configurable in the Makefile.",
"body": "DESTDIR always had /usr/bin appended which was a problem systems that don't use /usr/bin as the install location for binaries.\n\nInstead, use the value of DESTDIR exactly and update the Debian packages accordingly."
},
{
"commit": "60fe5b7365c9eaaa03e954cac7dec14777aa2461",
"date": "2019-03-09 11:03:47 +0200",
"subject": "Error when parameters are passed to a command that does not accept parameters.",
"body": "This behavior allowed a command like this to run without error:\n\npgbackrest backup --stanza=db full\n\nEven though it actually performed an incremental backup in most circumstances because the `full` parameter was ignored.\n\nInstead, output an error and exit."
},
{
"commit": "cad6fedb7ba2877f7ea1b2e23415c42b6bda3483",
"date": "2019-03-07 15:54:59 +0200",
"subject": "Prevent option warning from being output when running help command.",
"body": "This warning was being output when getting help if retention was not set:\n\nWARN: option repo1-retention-full is not set, the repository may run out of space\n\nSuppress this when getting help since the warning will display by default on a system that is not completely configured."
},
{
"commit": "3d7edc4ca4db2f75a33d43ffc5131a6a20086507",
"date": "2019-03-07 14:08:35 +0200",
"subject": "Add clean and uninstall targets to Makefile.",
"body": "Contributed by Luca Ferrari."
},
{
"commit": "d441061168ec56d22082a6ff54e5f1fb02cc8eae",
"date": "2019-03-02 15:01:02 +0200",
"subject": "Create test matrix for mock/all to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests. Be sure to include each major feature (remote, s3, encryption) in each VM at least once."
},
{
"commit": "f7d1d4400f1edcdd3216dfa5c9d1e306946c36a2",
"date": "2019-03-01 19:04:26 +0200",
"subject": "Create test matrix for mock/expire to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests."
},
{
"commit": "91622942c2e465cb46571343d0e40f8b7cef8742",
"date": "2019-03-01 17:12:41 +0200",
"subject": "Create test matrix for mock/archive-stop to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests. Be sure to include each major feature (remote, s3, encryption) in each VM at least once."
},
{
"commit": "c307d9fdf9439661d2a94f215bbc7b1ef714e34f",
"date": "2019-03-01 15:58:52 +0200",
"subject": "Don't make a copy of the context name in the MemContext module.",
"body": "This is very inefficient in terms of memory and time and dynamic context names were never utilized.\n\nJust require that context names be valid for the life of the context.\n\nIn practice they are all static strings."
},
{
"commit": "90709dfd213b1eb1dab3daff0101768f61be4b5f",
"date": "2019-03-01 14:57:01 +0200",
"subject": "Improve performance of context and memory allocations in MemContext module.",
"body": "Allocations required a sequential scan through the allocation list for both contexts and memory. This was very inefficient since for the most part individual memory allocations are seldom freed directly, rather they are freed when their context is freed.\n\nFor both types of allocations track an index for the lowest free position. After an allocation of the free position, a sequential search will be required for the next allocation but this is still far better than doing a scan for every allocation.\n\nWith a moderately-sized dataset (500 history entries in backup.info), there is a 237X performance improvement when combined with the f74e88bb refactor.\n\nBefore:\n\n % cumulative self\n time seconds seconds name\n 65.11 331.37 331.37 memContextAlloc\n 16.19 413.78 82.40 memContextCurrent\n 14.74 488.81 75.03 memContextTop\n 2.65 502.29 13.48 memContextNewIndex\n 1.18 508.31 6.02 memFind\n\nAfter:\n\n % cumulative self\n time seconds seconds name\n 94.69 2.14 2.14 memFind\n\nFinding memory allocations in order to free or resize them is the next bottleneck, but this does not seem to be a major issue presently."
},
{
"commit": "f74e88bba9c7a7912f0b1fc322823f1b527042f8",
"date": "2019-03-01 13:33:58 +0200",
"subject": "Use contextTop/contextCurrent instead of memContextTop()/memContextCurrent() in MemContext module.",
"body": "Using the functions internally is great for abstraction but not so great for performance on non-optimized builds.\n\nAlso, the functions end up prominent in any profiled build."
},
{
"commit": "6ce3310f8a2900d1af717da8d4c3345a9016933b",
"date": "2019-03-01 09:10:14 +0200",
"subject": "Update default documentation version to PostgreSQL 10.",
"body": "Also update CentOS 6 and 7 versions to PostgreSQL 9.5 and 9.6 respectively."
},
{
"commit": "409360924151a561dd5dc122dbcd9173a4e6c950",
"date": "2019-03-01 09:00:51 +0200",
"subject": "Documentation builds on PostgreSQL 9.4-10.",
"body": "More than likely 9.2-11 will work as well, but this has not been tested.\n\nHowever, 11 needs work on the group permissions introduced in that version."
},
{
"commit": "cb3b4fa24bbe271a517b50a3522bc5075d8fe6c7",
"date": "2019-02-28 14:33:29 +0200",
"subject": "Enable socket keep-alive on older Perl versions.",
"body": "The prior method depended on IO:Socket:SSL to push the keep-alive options down to the socket but it only worked for recent versions of the module.\n\nInstead, create the socket directly using IO::Socket::IP if available or IO:Socket:INET as a fallback. The keep-alive option is set directly on the socket before it is passed to IO:Socket:SSL."
},
{
"commit": "0913523096cf9178ffa46595171dc16ab815148b",
"date": "2019-02-28 09:51:19 +0200",
"subject": "Cleanup local/remote protocol interaction from 9367cc46.",
"body": "The command option was not being set correctly when a remote was started from a local. It was being set as 'local' rather than the command that the local was running as.\n\nAlso automatically select the remote protocol id based on whether it is started from a local (use the local protocol id) or from the main process (use 0).\n\nThese were not live issues but could cause strange behaviors as new features are added that might be hard to diagnose."
},
{
"commit": "db4b447be89878496f0a50905b2f51c1306b9de5",
"date": "2019-02-27 23:03:02 +0200",
"subject": "The archive-get command is implemented entirely in C.",
"body": "This new implementation should behave exactly like the old Perl code with the exception of a few updated log messages.\n\nRemove as much of the Perl code as possible without breaking other commands."
},
{
"commit": "9367cc461cda63698caa04ddb262405eef05890d",
"date": "2019-02-27 22:34:21 +0200",
"subject": "Migrate local command to C.",
"body": "The C local is only used for C commands in the main process.\n\nSome tweaking of the existing protocolGet() command was required. Originally the idea was to share the function for local and remote requests but the differences (as in Perl) were too great to make that practical."
},
{
"commit": "35abd4cd9517c4acf02d98bf386e1ef2ed2e8485",
"date": "2019-02-27 21:10:52 +0200",
"subject": "Add ProtocolParallel* objects for parallelizing commands.",
"body": "Allows commands to be easily parallelized if the jobs are broken up into discrete, non-overlapping chunks."
},
{
"commit": "35acfae7c2328a70f978973aa1c7ed91af750d88",
"date": "2019-02-27 19:48:30 +0200",
"subject": "Add ProtocolCommand object.",
"body": "This formalizes the creation of protocol commands, which was previously done by creating KeyValue objects manually."
},
{
"commit": "dee90d3e606262fe99dcc099867a96039540a1c2",
"date": "2019-02-27 18:11:09 +0200",
"subject": "Expose handle (file descriptor) from IoRead when applicable.",
"body": "Some IO objects have file descriptors which can be useful for monitoring with select().\n\nIt might also be useful to expose handles for write objects but there is currently no use case."
},
{
"commit": "b1957b07f351a93fa64658f8c898420b4bbe68f5",
"date": "2019-02-27 18:10:18 +0200",
"subject": "Improve null-handling of varToLog()."
},
{
"commit": "ea2aef1d0ceff366b75f663281df511b8169eadd",
"date": "2019-02-27 18:09:21 +0200",
"subject": "Add lstRemove() to List object.",
"body": "Because it is sometimes useful to remove items from a list."
},
{
"commit": "4be271ea2a1a7bed4e5165f10a8e62a19b4e7dc9",
"date": "2019-02-27 18:07:16 +0200",
"subject": "Improve fork harness to allow multiple children and setup pipes automatically.",
"body": "There was a lot of extra boilerplate involved in setting up pipes so that is now automated.\n\nIn some cases testing with multiple children is useful so allow that as well."
},
{
"commit": "18b62a4220acabc4ba0018ed884e20f695304aed",
"date": "2019-02-27 17:09:19 +0200",
"subject": "Only run test-level stack trace by default for unit-tested modules.",
"body": "This amends 70c30dfb which disabled test tracing in general.\n\nInstead, only enable test tracing by default for modules that are being unit tested. This saves lots of time but still ensures that test tracing is working and helps with debugging in unit tests.\n\nAlso rename the option to --debug-test-trace for a clarity."
},
{
"commit": "3a05359087560248dc0bc7d1ce35516c6a5d622f",
"date": "2019-02-24 07:42:41 +0200",
"subject": "Create test matrix for mock/stanza to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests. Be sure to include each major feature (remote, s3, encryption) in each VM at least once."
},
{
"commit": "6d3e18b181d08f4e1ed64c097346a3532e6005af",
"date": "2019-02-24 06:55:59 +0200",
"subject": "Reduce expect log level in mock/stanza tests.",
"body": "The expect tests were originally a rough-and-ready type of unit test so monitoring changes in the expect log helped us detect changes in behavior.\n\nNow the stanza code is heavily unit-tested so the detailed logs mainly cause churn and don't have any measurable benefit.\n\nReduce the log level to DETAIL to make the logs less verbose and volatile, yet still check user-facing log messages."
},
{
"commit": "2f081f3ec7a0c9bb664eb5a426ec21859bb48722",
"date": "2019-02-23 18:51:52 +0200",
"subject": "Rename test modules for consistency.",
"body": "The conventions for command and info tests have shifted in the C modules, though not even all the C modules got the message."
},
{
"commit": "d489eb87f7f7da58dd02812e5088f507e1cab491",
"date": "2019-02-23 15:59:39 +0200",
"subject": "Create test matrix for mock/archive to increase coverage and reduce tests.",
"body": "The same test configurations are run on all four test VMs, which seems a real waste of resources.\n\nVary the tests per VM to increase coverage while reducing the total number of tests. Be sure to include each major feature (remote, s3, encryption) in each VM at least once."
},
{
"commit": "4a7588e604d3b39858f09e8c879e973bd4432ded",
"date": "2019-02-23 15:13:23 +0200",
"subject": "Create aliases for test VMs ordered by age.",
"body": "This will allow for smarter allocation of tests in the next commit."
},
{
"commit": "59d7958914d2965d0690ebd579541c21a40ad201",
"date": "2019-02-23 15:05:06 +0200",
"subject": "Reduce expect log level in mock/archive tests.",
"body": "The expect tests were originally a rough-and-ready type of unit test so monitoring changes in the expect log helped us detect changes in behavior.\n\nNow the archive code is heavily unit-tested so the detailed logs mainly cause churn and don't have any measurable benefit.\n\nReduce the log level to DETAIL to make the logs less verbose and volatile, yet still check user-facing log messages."
},
{
"commit": "a9cbf23f4cacb18d85e7a6f02cff198790a9e21f",
"date": "2019-02-23 07:28:27 +0200",
"subject": "Improve error when hostname cannot be found in a certificate.",
"body": "Update error message with the hostname and more detail about what went wrong. Hopefully this will help in diagnosing certificate/hostname issues."
},
{
"commit": "1f66bda02ec9ae92403af2feeaf61505b3482932",
"date": "2019-02-22 12:02:26 +0200",
"subject": "Fix non-compliant JSON for options passed from C to Perl.",
"body": "We have been using a hacked-up JSON generator to pass options from C to Perl since the C binary was introduced. This generator was not very compliant which led to issues with \\n, \", etc. inside strings.\n\nWe have a fully-compliant JSON generator now so use that instead."
},
{
"commit": "70c30dfb619a3ec2ea7d465d5b8e2014518b723d",
"date": "2019-02-22 11:40:30 +0200",
"subject": "Disable test-level stack trace by default.",
"body": "Detailed stack traces for low-level functions (e.g. strCat, bufMove) can be very useful for debugging but leaving them on for all tests has become quite burdensome in terms of time. Complex operations like generating JSON on a large KevValue can lead to timeouts even with generous values.\n\nAdd a new param, --debug-trace, to enable test-level stack trace, but leave it off by default."
},
{
"commit": "ae86e6d5b2f6f86bc3ec1a4b1378d9b49e89799e",
"date": "2019-02-22 11:31:37 +0200",
"subject": "Add missing ToLog() coverage to String, List, and PgControl.",
"body": "Missing coverage is exposed in the next commit which disables test tracing by default."
},
{
"commit": "a7c8906581e8fc875c3cac99153aacb323de034f",
"date": "2019-02-21 18:49:02 +0200",
"subject": "Fix incorrect tags."
},
{
"commit": "e14c0eeb65a998a419e5a2e6c0ce833e8d7d03dc",
"date": "2019-02-21 16:20:46 +0200",
"subject": "Use driver for remote protocol introduced in da628be8.",
"body": "The remote protocol was calling into the Storage object but this required some translation which will get more awkward as time goes by.\n\nInstead, call directly into the local driver so the communication is directly driver to driver. This still requires resolving the path and may eventually have more duplication with the Storage object methods but it seems the right thing to do."
},
{
"commit": "b1eb8af7d5093a26a2e221a428540e5e7b356eed",
"date": "2019-02-21 15:40:21 +0200",
"subject": "Resolve storage path expressions before passing to remote.",
"body": "Expressions such as require a stanza name in order to be resolved correctly. However, if the stanza name is passed to the remote then that remote will only work correctly for that one stanza.\n\nInstead, resolved the expressions locally but still pass a relative path to the remote. That way, a storage path that is only configured on the remote does not need to be known locally."
},
{
"commit": "b4d4680f8c3126d1c2016d30aa2a1b77aac085c0",
"date": "2019-02-21 14:40:35 +0200",
"subject": "Allow cfgExecParam() to exclude options.",
"body": "It is useful to be able to exclude an option even if it is shared by both commands."
},
{
"commit": "be6a3f131e746304c6a30c39fcab4fe4b44dcb7f",
"date": "2019-02-21 14:26:06 +0200",
"subject": "Improve null-handling of strToLog().",
"body": "NULL was returning {\"(null)\"} which was comprehensible but not very pretty. Instead return null on NULL."
},
{
"commit": "1fd89f05afd8d8614d7b38a006eda4418f6324ce",
"date": "2019-02-21 14:16:17 +0200",
"subject": "Add kvKeyExists() to KeyValue object.",
"body": "Check if a key exists even if the value is NULL, which is the same result for a missing key."
},
{
"commit": "80df1114bdc97a930421f491bb7f41d9aeab6069",
"date": "2019-02-21 12:09:12 +0200",
"subject": "Fix info command missing WAL min/max when stanza specified.",
"body": "This issue was a result of STORAGE_REPO_PATH prepending an extra stanza when the stanza was specified on the command line.\n\nThe tests missed this because by some strange coincidence the WAL dirs were empty for each test that specified a stanza. Add new tests to prevent a regression.\n\nFixed by Stefan Fercot."
},
{
"commit": "1519f5b04540d5a431044f83a45b604ad8757397",
"date": "2019-02-21 11:40:30 +0200",
"subject": "Add storageHelperFree() to storage helper.",
"body": "Free all cached objects in the storage helper, especially the stanza name.\n\nThis clears the storage environment for tests that switch stanza names or go from a stanza name to no stanza name or vice versa. This is only useful for testing right now, but may be used in the future for commands than act on multiple stanzas."
},
{
"commit": "b0b5989acae29b962b9101719459234968a8e6c1",
"date": "2019-02-20 22:57:18 +0200",
"subject": "Migrate remote archive-get command to C.",
"body": "All required protocol commands are implemented so this is mostly a matter of enabling the feature and updating expect logs."
},
{
"commit": "6866ff031a6a48d6cd966f5df78bcbc2c84a3890",
"date": "2019-02-20 22:43:02 +0200",
"subject": "Add exists() to remote storage."
},
{
"commit": "71bc5697b1a35c8460af7885b888b1d43bd994b1",
"date": "2019-02-20 22:23:19 +0200",
"subject": "Increase per-call stack trace size to 4096.",
"body": "This was previously 256, which was too small to log protocol parameters. Not only did this truncate important debug information but varying path lengths caused spurious differences in the expect logs."
},
{
"commit": "73be64ce49aaff9d94f70c47590476c404365ce4",
"date": "2019-02-20 15:52:07 +0200",
"subject": "Add separate archive-get-async command.",
"body": "This command was previously forked off from the archive-get command which required a bit of artificial option and log manipulation.\n\nA separate command is easier to test and will work on platforms that don't have fork(), e.g. Windows."
},
{
"commit": "e48b406cdc3c73056137d6767a7f70e08bee9806",
"date": "2019-02-20 15:48:14 +0200",
"subject": "Add instructions for building the coverage report.",
"body": "These are intended to be temporary until a fully automated report is developed.\n\nSince we don't know when that will happen, at least make it easier to generate the current report."
},
{
"commit": "da628be8a8045e73b621fb229ac149b545008327",
"date": "2019-02-19 20:57:38 +0200",
"subject": "Migrate remote command to C.",
"body": "Prior to this the Perl remote was used to satisfy C requests. This worked fine but since the remote needed to be migrated to C anyway there was no reason to wait.\n\nAdd the ProtocolServer object and tweak ProtocolClient to work with it. It was also necessary to add a mechanism to get option values from the remote so that encryption settings could be read and used in the storage object.\n\nUpdate the remote storage objects to comply with the protocol changes and add the storage protocol handler.\n\nIdeally this commit would have been broken up into smaller chunks but there are cross-dependencies in the protocol layer and it didn't seem worth the extra effort."
},
{
"commit": "d211c2b8b51ae5b796bbb581d21a4a406e3ed972",
"date": "2019-02-15 11:52:39 +0200",
"subject": "Fix possible truncated WAL segments when an error occurs mid-write.",
"body": "The file write object destructors called close() and finalized the file even if it was not completely written. This was an issue in both the C and Perl code.\n\nRewrite the destructors to simply free resources (like file handles) rather than calling the close() method. This leaves the temp file in place for filesystems that use temp files.\n\nAdd unit tests to prevent regression."
},
{
"commit": "2cd204f38037f1465c84bb4e6b55893204ee8f93",
"date": "2019-02-12 14:59:51 +0200",
"subject": "Change execRead() to return a size_t.",
"body": "execRead() should be returning a size_t, not a void. Thankfully, this isn't actually used and therefore shouldn't be an issue, but we should fix it anyway."
},
{
"commit": "a5f6f801d7651606363715471dcb958e3339414c",
"date": "2019-02-12 14:11:16 +0200",
"subject": "Begin v2.11 development."
},
{
"commit": "35903b94d9f2de14fb116c4b15649466eff78ef2",
"date": "2019-02-09 19:52:31 +0200",
"subject": "v2.10: Bug Fixes"
},
{
"commit": "51971617a82a3f58efe33dff8386bc94fe1ac628",
"date": "2019-02-09 19:01:16 +0200",
"subject": "Fix year on 2.09 release.",
"body": "Reported by Achilleas Mantzios."
},
{
"commit": "057e2e27822ffd053f735762e1441fccea24c5ed",
"date": "2019-02-09 18:57:30 +0200",
"subject": "Add unimplemented S3 driver method required for archive-get.",
"body": "This was not being caught because the integration tests for S3 were running remotely and going through the Perl code rather than the new C code.\n\nImplement the exists method for the S3 driver and add tests to prevent a regression."
},
{
"commit": "6e88f93991171632f33fd1b12fc1090d4a9f02a5",
"date": "2019-02-05 18:55:07 +0200",
"subject": "Fix check for improperly configured pg-path.",
"body": "The check to verify that pg-path and data_directory are equal was not working because pg-path was getting overwritten with data_directory before validation took place."
},
{
"commit": "be8f31a9524f7b6c47e52a01f89aaf9f0a65ddc2",
"date": "2019-02-05 15:34:18 +0200",
"subject": "JSON improvements.",
"body": "Optimize the parser implementation and make the renderer more null tolerant.\n\nAlso make some string and variant constructors null tolerant."
},
{
"commit": "b3d1a2a8023adc6d1e35221dc6c3789a1b772c5c",
"date": "2019-02-02 15:18:10 +0200",
"subject": "FIx typos and missing debug param."
},
{
"commit": "b29a8dd9c541b755381f2e103abbe0b05fc65190",
"date": "2019-02-02 15:03:19 +0200",
"subject": "Automatically adjust db-timeout when protocol-timeout is smaller.",
"body": "This already worked in reverse, but this case is needed when a command that only uses protocol-timeout (e.g. info) calls a remote process where protocol-timeout and db-timeout can be set. If protocol-timeout was set to less than the default db-timeout then an error resulted."
},
{
"commit": "abc613b454f8f1aa9da5e842c5da822d26504163",
"date": "2019-02-02 14:50:24 +0200",
"subject": "Begin v2.10 development."
},
{
"commit": "a89a3761191444ef28b22434f94bc42fd84b83ee",
"date": "2019-01-30 22:37:35 +0200",
"subject": "v2.09: Minor Improvements and Bug Fixes"
},
{
"commit": "02dff53d45b3db2daf69ee45ac694696dc051cc3",
"date": "2019-01-30 22:02:42 +0200",
"subject": "Add openssl-devel install to documentation build in 711b3e67."
},
{
"commit": "fb342c312591d2980bbbd490a04fb26967d04fb1",
"date": "2019-01-30 21:11:52 +0200",
"subject": "Add latex install to documentation build in 711b3e67."
},
{
"commit": "aa3e5b8c72a75a4f5fea93b543a8fbedcd713f02",
"date": "2019-01-30 17:03:17 +0200",
"subject": "Allow primary gid for the test user to be different from uid.",
"body": "Apparently up until now they have always been the same, which is pretty typical. However, if they were not then ContainerTest.pm was not happy."
},
{
"commit": "711b3e67cbfc7b404ffe2ce196ffb42159c95040",
"date": "2019-01-30 16:53:59 +0200",
"subject": "Add examples for building a documentation host."
},
{
"commit": "dada50ee26e3891ebfca73e12a8f14080cc8ad7e",
"date": "2019-01-30 13:39:22 +0200",
"subject": "Fix hard-coded repository path.",
"body": "This prevented packages from being passed to the documentation unless they were in the /backrest directory on the host.\n\nAlso make the local path /pgbackrest instead of the deprecated /backrest."
},
{
"commit": "8634eb8c43c8666634fe64a49a39c6384caee64d",
"date": "2019-01-29 12:08:14 +0200",
"subject": "Include Posix-compliant header for fd_set.",
"body": "Similar to f3ae3c4f, add Posix-compliant header to make FreeBSD happy."
},
{
"commit": "b5a103f2df4999219ef509356ba2c46c292ecccb",
"date": "2019-01-28 22:33:29 +0200",
"subject": "Improve P/PP type macro handling.",
"body": "Rather than create _P/_PP variants for every type that needs to pass/return pointers, create FUNCTION_*_P/PP() macros that will properly pass or return any single/double pointer types.\n\nThere remain a few unresolved edge cases such as CHARPY but this handles the majority of types well."
},
{
"commit": "8b2a344cfecc2438aafeba7f1c1b7b0572973562",
"date": "2019-01-28 15:06:28 +0200",
"subject": "Remove unused type parameter from FUNCTION_TEST_RETURN().",
"body": "This parameter was always useless but commit 7333b630 removed all references to it so remove the parameter at all call sites as well.\n\nThe original intention was probably to allow logging of TEST return values but that never happened."
},
{
"commit": "7333b6302fb26191a322cc1513fd85c76b066346",
"date": "2019-01-28 09:44:10 +0200",
"subject": "Improve CONST type macro handling.",
"body": "Rather than create a CONST_ variant for every type that needs to be returned const, create a FUNCTION_LOG_RETURN_CONST() macro that will return any type as const."
},
{
"commit": "d29aa6128681a3912c1c48ed71cdad9395d0d347",
"date": "2019-01-27 11:50:09 +0200",
"subject": "Allocate extra space for concatenations in the String object.",
"body": "The string object was reallocating memory with every concatenation which is not very efficient. This is especially true for JSON rendering which does a lot of concatenations.\n\nInstead allocate a pool of extra memory on the first concatenation (50% of size) to be used for future concatenations and reallocate when needed.\n\nAlso add a 1GB size limit to ensure that there are no overflows."
},
{
"commit": "82c2d615b3ecdb851029ad691f5a8061f949535b",
"date": "2019-01-27 11:34:12 +0200",
"subject": "Move MACRO_TO_STR() to common/debug.h.",
"body": "This macro is handy for constructing static message strings so move it where the core code can see it."
},
{
"commit": "4027123ef19629ff1d5638a75677fa81b3831d03",
"date": "2019-01-27 08:01:17 +0200",
"subject": "Update contributor name."
},
{
"commit": "8f6d324b2c2576456bd0ba7f691297df1f5aba1e",
"date": "2019-01-26 16:59:54 +0200",
"subject": "Fix issue with multiple async status files causing a hard error.",
"body": "Multiple status files were being created by asynchronous archiving if a high-level error occurred after one or more WAL segments had already been transferred successfully. Error files were being written for every file in the queue regardless of whether it had already succeeded. To fix this, add an option to skip writing error files when an ok file already exists.\n\nThere are other situations where both files might exist (various fsync and filesystem error scenarios) so it seems best to retry in the case that multiple status files are found rather than throwing a hard error (which then means that archiving is completely stuck). In the case of multiple status files, a warning will be logged to alert the user that something unusual is happening and the command will be retried."
},
{
"commit": "f3ae3c4f9d0dd63c583ab27ef1f6aa869db12a3a",
"date": "2019-01-26 13:48:46 +0200",
"subject": "Include Posix-compliant header for strcasecmp().",
"body": "gcc has apparently merged this function in string.h but Posix specifies that it should be in strings.h. FreeBSD at at least is sticking to the standard.\n\nIn the long run it might be better to implement our own strcasecmp() function but for now just add the header."
},
{
"commit": "1401c023f0cfdd0266144bdd8b181e8194bbd91e",
"date": "2019-01-26 12:02:48 +0200",
"subject": "Fix release note typo."
},
{
"commit": "053972bfe01948a463fed56b11e3522b3b10457f",
"date": "2019-01-26 12:01:18 +0200",
"subject": "Update address lookup in C TLS client to use modern methods.",
"body": "The implementation using gethostbyname() was only intended to be used during prototyping but was forgotten when the code was finalized.\n\nReplace it with gettaddrinfo() which is more modern and supports IPv6."
},
{
"commit": "4d1060ea6bdf60d8e9fc7ca372386f53461ed6d1",
"date": "2019-01-26 10:39:51 +0200",
"subject": "Replace FileOpenError with HostConnectError in TlsClient.",
"body": "HostConnectError is more appropriate in this context."
},
{
"commit": "33d39d248c5ae6fab6b4bb7564ca85b18786332c",
"date": "2019-01-24 16:45:28 +0200",
"subject": "Allow if condition in documentation lists and list items."
},
{
"commit": "bec52b6f41a6101ab1357fb5b65ce36faefee9e4",
"date": "2019-01-24 11:11:12 +0200",
"subject": "Allow if in manifest variables.",
"body": "The code supported this feature but the manifest DTD did now allow it."
},
{
"commit": "db08656537b22c39e5278f9f2770b816278e771a",
"date": "2019-01-21 17:41:59 +0200",
"subject": "Rename FUNCTION_DEBUG_* and consolidate ASSERT_* macros for consistency.",
"body": "Rename FUNCTION_DEBUG_* macros to FUNCTION_LOG_* to more accurately reflect what they do. Further rename FUNCTION_DEBUG_RESULT* macros to FUNCTION_LOG_RETURN* to make it clearer that they return from the function as well as logging. Leave FUNCTION_TEST_* macros as they are.\n\nConsolidate the various ASSERT* macros into a single ASSERT macro that is always compiled out of production builds. It was difficult to figure out when an assert would be checked with all the different types in play. When ASSERTs are compiled in they will always be checked regardless of the log level -- tying these two concepts together was not a good idea."
},
{
"commit": "d245f8eb425322f0efcd05ab4c12b3b45cc87138",
"date": "2019-01-21 13:51:45 +0200",
"subject": "The info command is implemented entirely in C.",
"body": "The C info code has already been committed but this commit wires it into main.\n\nAlso remove the info Perl code and tests since they are no longer called."
},
{
"commit": "f79af47bd4ffff693e1a882955323fe73972eeb6",
"date": "2019-01-19 20:44:40 +0200",
"subject": "Increase timeout in storage/s3 module to improve reliability."
},
{
"commit": "e57f1b529327ebeca41405b6b57602013de9d625",
"date": "2019-01-19 12:57:40 +0200",
"subject": "Fix escaping in JSON string parser."
},
{
"commit": "7355248d6b2b1db0a7ca997db0dc2943331325a0",
"date": "2019-01-18 22:04:37 +0200",
"subject": "Add remote storage objects.",
"body": "This is a partial implementation of remote storage with just enough functionality to get the info command working. The client is written in C but the server is still in Perl, which limits progress until a C server is written."
},
{
"commit": "88201f37a3b7156dcf6f4aaa659136215485c40d",
"date": "2019-01-18 21:32:51 +0200",
"subject": "Add ProtocolClient object and helper functions.",
"body": "This is a complete protocol client implementation in C.\n\nCurrently there is no C server implementation so the C client is talking to a Perl server. This won't work very long, though, as the protocol format, even though in JSON, has a lot of language-specific structure. While it would be possible to maintain compatibility between C and Perl it's probably not worth the effort in the long run.\n\nJust as in Perl there are helper functions to make constructing protocol objects easier. Currently only repository remotes are supported."
},
{
"commit": "0986db630cf3c931ccb135a86e60ee098fdc2dec",
"date": "2019-01-18 13:15:43 +0200",
"subject": "Fix comment typo."
},
{
"commit": "9cac403f610ff3fd4a176b9cf5a7c0543bdd892c",
"date": "2019-01-18 11:45:40 +0200",
"subject": "Add Exec object.",
"body": "Executes a child process and allows the calling process to communicate with it using read/write io.\n\nThis object is specially tailored to implement the protocol layer and may or may not be generally applicable to general purpose\nexecution."
},
{
"commit": "797f8098d1383d05960566174859f75d4e835613",
"date": "2019-01-18 11:14:44 +0200",
"subject": "Add ioReadBuf() to easily read into a buffer.",
"body": "Moves some boilerplate into a function and makes it easier to get coverage in cases where a single buffer read captures all the data."
},
{
"commit": "06d41b4dc0f84f756b57d44cc2e2ceb6b5aec493",
"date": "2019-01-17 22:29:19 +0200",
"subject": "Add cfgExecParam() to generate parameters for executing commands.",
"body": "Parameters for the local/remote commands are based on parameters that are passed to the current command.\n\nGenerate parameters for the new command based on the intersection of parameters between the current command and the command to be executed."
},
{
"commit": "ecd56105e688e74ad71f8a1fc0fc3e785989abe5",
"date": "2019-01-17 22:08:31 +0200",
"subject": "Add IoHandleRead and IoHandleWrite objects.",
"body": "General i/o objects for reading and writing file descriptors, in particular those that can block. In other words, these are not generally to be used with file descriptors for actual files, but rather pipes, sockets, etc."
},
{
"commit": "bf0c41d9d6d5fd53cc4bf190b0c577f506323b5b",
"date": "2019-01-16 22:23:25 +0200",
"subject": "Add const VariantList * debug type."
},
{
"commit": "7d4bbf290cf33de06fca9854f21ec9690cfd51bb",
"date": "2019-01-16 22:16:50 +0200",
"subject": "Fix difference in cipher type reporting missed in 8304d452.",
"body": "The C code can't get the cipher type from the storage object because the C storage object does not have encryption baked in like the Perl code does.\n\nInstead, check backup.info to see if encryption is enabled. This will need to rethought if another cipher type is added but for now it works fine."
},
{
"commit": "e68d1e73042342c4cea0881e216e6979a3bcb140",
"date": "2019-01-16 19:23:10 +0200",
"subject": "Simplify info command text message when no stanzas are present.",
"body": "Replace the repository path with just \"the repository\". The path is not important in this context and it is clearer to state where the stanzas are missing from."
},
{
"commit": "ef9dc89e080d7b364a00fec138d1961c703dd02a",
"date": "2019-01-16 18:49:12 +0200",
"subject": "Update Storage::Local->list() to accept an undefined path.",
"body": "The Perl code has a tendency to generate absolute paths even when they are not needed. This change helps the C and Perl storage work together via the protocol layer."
},
{
"commit": "b4146b6bff99c8d82445bfda96b237ef0cff3050",
"date": "2019-01-16 18:45:19 +0200",
"subject": "Update Perl repo rules to work when stanza is not specified.",
"body": "The C storage object strives to use rules whenever possible instead of generating absolute paths. This change helps the C and Perl storage work together via the protocol layer."
},
{
"commit": "0014e159443354a46197e58f0631d7363d038cde",
"date": "2019-01-16 18:34:50 +0200",
"subject": "Fix escaping in JSON string renderer."
},
{
"commit": "49bd8e0e3e6e2c7f5e840c613919e55ee0074414",
"date": "2019-01-16 12:04:35 +0200",
"subject": "Fix missing linefeed and param debug."
},
{
"commit": "c0a904853664396d3ee9ffd5599634f489d924a1",
"date": "2019-01-16 09:11:01 +0200",
"subject": "Fix null output in JSON renderer.",
"body": "In some cases nulls were being rendered as \"(null)\" because no special logic existed to handle them."
},
{
"commit": "ec26a0594e2f1da3f2f0041ceef606f70eaeef5e",
"date": "2019-01-16 09:05:13 +0200",
"subject": "Allow string Variant objects to contain null.",
"body": "This is more useful than the variant itself being null as it saves conditionals when creating."
},
{
"commit": "1b334da87ffcddc5393fa0f900ec8c0395155aa7",
"date": "2019-01-14 22:02:23 +0200",
"subject": "Add kvMove() and varLstMove().",
"body": "Allow these objects to be moved to another mem context."
},
{
"commit": "aab9e38b9a070e8707c0a316784b456ecaeba64e",
"date": "2019-01-14 21:34:22 +0200",
"subject": "Return UnknownError from errorTypeFromCode() for invalid error codes.",
"body": "The prior behavior was to throw an exception but this was not very helpful when something unexpected happened. Better to at least emit the error message even if the error code is not very helpful."
},
{
"commit": "2b02d37602e3bfc451d598032d0e3793a06e8673",
"date": "2019-01-14 21:21:37 +0200",
"subject": "Allow empty arrays in JSON parser."
},
{
"commit": "8304d452b3683d5d1d59cf7a6cc14801ddc35efd",
"date": "2019-01-13 22:44:58 +0200",
"subject": "Make the C version of the info command conform to the Perl version.",
"body": "There were some small differences in ordering and how the C version handled missing directories. It may be that the C version is more consistent, but for now it is more important to be compatible with the Perl version.\n\nThese differences were missed because the C info command was not wired into main.c so it was not being tested in regression. This commit does not fix the wiring issue because there will likely be a release soon and it is too big a change to put in at the last moment."
},
{
"commit": "f314a1f8aa101b5f73cbb0902af7ebed9804a143",
"date": "2019-01-13 22:22:15 +0200",
"subject": "Improve accuracy of strSizeFormat().",
"body": "Casting to int caused large values to be slightly inaccurate so cast to uint64_t instead.\n\nAlso, use multiplication where possible since the compiler should precompute multiplied values."
},
{
"commit": "cebcb3f027d2a95f5b350df113efef78d449c72f",
"date": "2019-01-10 09:49:28 +0200",
"subject": "Null-terminate list returned by strLstPtr().",
"body": "The null-terminator is required by many C functions that accept a string list so just add it in all cases rather than making it optional."
},
{
"commit": "f8a9fc203909696293e57d84bc8f6d83d737097b",
"date": "2019-01-09 19:20:38 +0200",
"subject": "Fix typos in monitoring examples."
},
{
"commit": "ade2c3102d7459d274f0988d7d3cc2de49c7c9b4",
"date": "2019-01-06 17:42:44 +0200",
"subject": "Ignore SIGPIPE signals and check EPIPE result instead.",
"body": "SIGPIPE immediately terminates the process but we would rather catch the EPIPE error and gracefully shutdown.\n\nIgnore SIGPIPE and throw the EPIPE error via normal error handling."
},
{
"commit": "7272d6e2475f7fe8dd327206591b83cf4b9f498b",
"date": "2019-01-06 17:28:17 +0200",
"subject": "Add _DARWIN_C_SOURCE flag to Makefile for MacOS builds.",
"body": "For some reason adding -D_POSIX_C_SOURCE=200112L caused MacOS builds to stop working. Combining both flags seems to work fine for all tested systems."
},
{
"commit": "9560baf659cafec2614e90ce72d988635cb945c1",
"date": "2019-01-06 15:52:59 +0200",
"subject": "Move C module include in test.c above headers included for testing.",
"body": "Including the C module after the headers required for testing meant that if headers were missing from the C module they were not caught while directly testing the C module.\n\nThe missing headers were caught in general testing, but it is frustrating to get an error in a module that has already passed while testing another module or running CI.\n\nMove the C module include to the very top so missing headers cause immediate failures."
},
{
"commit": "0e0000f59c571a3889927288a536c8e220f97fac",
"date": "2019-01-06 15:27:30 +0200",
"subject": "Add debug macros and extra space missed in 256b727a."
},
{
"commit": "1de22cac2b0d2f9bddc794693dd2b97e61efdf85",
"date": "2019-01-06 14:37:39 +0200",
"subject": "Rename common/io/handle module to common/io/handleWrite.",
"body": "ioHandleWriteOneStr() will become a helper function for the IoHandleWrite object."
},
{
"commit": "f52e0187e61b6f74c66573580523018509541f98",
"date": "2019-01-05 18:10:30 +0200",
"subject": "Fix object struct comment to be conforming."
},
{
"commit": "842147321ff39a523608e281ade7ccb5fcad7bba",
"date": "2019-01-05 14:43:40 +0200",
"subject": "Fix typo in error message."
},
{
"commit": "59d7352f31a646c2f2491aacb922116caf125c50",
"date": "2019-01-05 14:38:31 +0200",
"subject": "Command-line help update missed in 200fd3aa."
},
{
"commit": "200fd3aa05174e109488f533d57db503d18ce25a",
"date": "2019-01-04 12:25:58 +0200",
"subject": "Clarify that encryption is always performed client-side.",
"body": "Suggested by Bruce Burdick."
},
{
"commit": "50717aa846a41852179feaa69b35a924bffc66c6",
"date": "2019-01-04 11:00:59 +0200",
"subject": "Begin v2.09 development."
},
{
"commit": "db24ff8df4b2c2de133461df3ab4f28167516dbf",
"date": "2019-01-02 22:04:47 +0200",
"subject": "v2.08: Minor Improvements and Bug Fixes"
},
{
"commit": "98ba7ece23637ead3b6a458372f32517aef0c20f",
"date": "2019-01-01 18:46:27 +0200",
"subject": "Update LICENSE.txt for 2019."
},
{
"commit": "26c888873e3c0956ec1e4a160715433ae3dd9eaf",
"date": "2019-01-01 18:14:43 +0200",
"subject": "Merge common/typeVariantListTest module into common/typeVariantTest.",
"body": "These modules are closely related so it makes sense for them to be merged."
},
{
"commit": "07b9176f257148d02c479207180c6af536ad43e1",
"date": "2019-01-01 18:05:13 +0200",
"subject": "Merge common/typeStringListTest module into common/typeStringTest.",
"body": "These modules are closely related so it makes sense for them to be merged."
},
{
"commit": "493fb78787b0929831899d333484140bfc636a89",
"date": "2019-01-01 17:31:23 +0200",
"subject": "Add strLstInsert() and strLstInsertZ() to StringList object.",
"body": "Use lstInsert() to implement insertions into any position in a StringList."
},
{
"commit": "cc6376fdb6bb3bff8ce0b432e23b1fa4ed13a210",
"date": "2018-12-31 09:19:38 +0200",
"subject": "Modify general document elements to allow any child element.",
"body": "This allows for nesting of elements such as and ."
},
{
"commit": "2b7440ddf313e6dbf8b53443a26cdf211161ad26",
"date": "2018-12-31 08:51:00 +0200",
"subject": "Allow custom logo for PDF documentation.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "72865ca33ba383fba54da8db0bb8595890a12a3e",
"date": "2018-12-30 16:40:20 +0200",
"subject": "Add admonitions to documentation renderers.",
"body": "Admonitions call out places where the user should take special care.\n\nSupport added for HTML, PDF, Markdown and help text renderers. XML files have been updated accordingly."
},
{
"commit": "3dc327fd05882b2dc27e77a7922f5c275a7e2b25",
"date": "2018-12-20 23:20:54 +0200",
"subject": "Add optional table captions.",
"body": "All renderers now support table captions, when requested."
},
{
"commit": "8cf8d29f124723d717fa809168c6ea587bd5d592",
"date": "2018-12-19 19:13:26 +0200",
"subject": "Escape special characters in latex when not in a code block.",
"body": "A number of common characters are not allowed in latex without being escaped.\n\nAlso convert some HTML-specific codes that are used in the documentation."
},
{
"commit": "23b583336f3095b3e64d6068199b5c449dc776ac",
"date": "2018-12-18 22:12:59 +0200",
"subject": "Set TCP keepalives on S3 connections.",
"body": "Keepalives may help in situations where RST packets are being blocked by a firewall or otherwise do not arrive.\n\nThe C code uses select on all reads so it should never block, but add keepalives just in case."
},
{
"commit": "96028073cb45fffc5df0d510f3dd143ca10d7d62",
"date": "2018-12-18 22:02:23 +0200",
"subject": "Add HTML table rendering and update PDF/Markdown renderers to support header-less tables.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "b85e51d6d545df61cf22501c1db09371219a83da",
"date": "2018-12-14 18:46:12 -0500",
"subject": "Base menu ordering on natural ordering in the manifest.",
"body": "Menu ordering was alphabetical which is not ideal for a user interface."
},
{
"commit": "35bbb5bd6881e3f405cbd99c3992c32aa5c6d69f",
"date": "2018-12-14 18:25:31 -0500",
"subject": "Reorder info command text output so most recent backup is output last.",
"body": "After a stanza-upgrade backups for the old cluster are displayed until they expire. Cluster info was output newest to oldest which meant after an upgrade the most recent backup would no longer be output last.\n\nUpdate the text output ordering so the most recent backup is always output last."
},
{
"commit": "205525b60780587366b9786750535a55977f0221",
"date": "2018-12-13 16:22:34 -0500",
"subject": "Migrate local info command to C.",
"body": "The info command will only be executed in C if the repository is local, i.e. not located on a remote repository host. S3 is considered \"local\" in this case.\n\nThis is a direct migration from Perl to integrate as seamlessly with the remaining Perl code as possible. It should not be possible to determine if the C version is running unless debug-level logging is enabled."
},
{
"commit": "e6ef40e8a327d94e5111d21dd056eefbe5d19a86",
"date": "2018-12-13 15:46:18 -0500",
"subject": "Add infoBackup object to encapsulate the backup.info file.",
"body": "The infoBackup object is the counterpart to the infoArchive object which encapsulates the archive.info file.\n\nCurrently the object is read-only, i.e. it is not possible to create a new or modify an existing backup.info file.\n\nThere a number of constants that will also be used in the infoManifest object so go ahead and create a module to contain them so they don't need to be moved later."
},
{
"commit": "56d466ce4b39173c777e70e16914a0a76a400dfb",
"date": "2018-12-13 15:20:57 -0500",
"subject": "Add null support to jsonToKv().",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "d6dfbfd2f3cc2c838d6c1d28ba96076efa9364a6",
"date": "2018-12-12 14:35:44 -0500",
"subject": "Add zlib1g-dev to Debian builds.",
"body": "Not all debian-based distros were getting this installed."
},
{
"commit": "df947cfcb22928ac4487c74483a49075e35ea15d",
"date": "2018-12-12 13:52:23 -0500",
"subject": "Add documentation for building the documentation.",
"body": "A basic primer for building the documentation. Lots that could be added, but it's a start."
},
{
"commit": "fdc76742c8e98e630fa4219ba8e9aad79c882e40",
"date": "2018-12-12 13:48:31 -0500",
"subject": "Use absolute paths so that ./doc.pl runs.",
"body": "The relative paths used would not correctly find required libraries and DTD files."
},
{
"commit": "ee04ebe3142b0f170ef6662db3b6be3e2ba2e32e",
"date": "2018-12-12 11:15:09 -0500",
"subject": "Fix Centos/RHEL 7 documentation builds.",
"body": "This was caused by a new container version that was released around December 5th. The new version explicitly denies user logons by leaving /var/run/nologin in place after boot.\n\nThe solution is to enable the service that is responsible for removing this file on a successful boot."
},
{
"commit": "2f15a90d18e0cdc0d91e9915b400acfc78ccaf26",
"date": "2018-12-10 18:45:57 -0500",
"subject": "Add infoArchiveIdHistoryMatch() to the InfoArchive object.",
"body": "Match a PostgreSQL system identifier and version to a pgBackRest archive id."
},
{
"commit": "f0417ee524d1759b1aa5949abcae4769741ce550",
"date": "2018-12-10 18:31:49 -0500",
"subject": "Use cast to make for loop more readable in InfoPg module.",
"body": "The previous way worked but was a head-scratcher when reading the code. This cast hopefully makes it a bit more obvious what is going on."
},
{
"commit": "2514d08d0dc6d28a59bd884a751b734c70e2c0c0",
"date": "2018-12-10 18:15:06 -0500",
"subject": "Remove #define statements in the InfoPg module to conform with newly-adopted coding standards.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "fe152b8f29ff794cd6108c8295e35c44fe37c847",
"date": "2018-12-10 18:08:26 -0500",
"subject": "Rename constants in Info module for consistency.",
"body": "INFO is generally used as the prefix for info file constants so rename these accordingly.\n\nAlso follow newly-adopted coding standards for when #define is required for a static String constant."
},
{
"commit": "e3435ec386c19fc7a6f08b9d08d4cee4bf8e36f4",
"date": "2018-12-10 17:35:31 -0500",
"subject": "Add path expression for repository backup to the storage helper.",
"body": "This is the counterpart to the archive path expression and constructs paths into the backup part of the repository."
},
{
"commit": "4f539db8d9c666fa5a9c4e020e387a3b26886b83",
"date": "2018-12-10 17:01:33 -0500",
"subject": "Allow NULL stanza in storage helper.",
"body": "Some commands (e.g. info) do not take a stanza or the stanza is optional. In that case it is the job of the command to construct the repository path with a stanza as needed.\n\nUpdate helper functions to omit the stanza from the constructed path when it is NULL."
},
{
"commit": "cbf514e191783937de63b5a276fcefc426e6f430",
"date": "2018-12-10 16:32:41 -0500",
"subject": "Improve info error messages introduced in 74b72df9.",
"body": "- Add detail to errors when info files are loaded with incorrect encryption settings.\n- Throw FileMissingError rather than FileOpenError when both copies of the info file are missing.\n- If one file is present (but errors) and the other is missing, then return the error for the file that was present."
},
{
"commit": "80a3e215213090878e1519f4f4866de2ff6ee67a",
"date": "2018-12-10 16:11:51 -0500",
"subject": "Add strSizeFormat() to String object.",
"body": "Converts sizes in bytes to a more human-readable form, .e.g. 1KB, 1.1GB."
},
{
"commit": "947fa6fc2b086f0c2fad602b9921861c0bd18fd3",
"date": "2018-12-10 15:43:52 -0500",
"subject": "Fix comment typo.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "1c5f8f45b68ad87553c2219ffb8e0da0314ad920",
"date": "2018-12-07 12:32:10 -0500",
"subject": "Add configuration to the standby so it works as a primary when promoted.",
"body": "This code was generated during testing and it seemed a good idea to keep it. It is only a partial solution since the primary also needs additional configuration to be able to fail back and forth."
},
{
"commit": "495391c7430ee8f4aafc006f6cea829e6a3ca981",
"date": "2018-12-07 12:19:28 -0500",
"subject": "Pick pg_switch_wal()/pg_switch_xlog() based on PostgreSQL version.",
"body": "One step in making the documentation build for all versions that we support."
},
{
"commit": "e6abdfb5b864b6526e0e5cb147911bd8ff5c8e15",
"date": "2018-12-07 07:41:26 -0500",
"subject": "Add error message when current user uid/gid does not map to a name.",
"body": "This condition resulted in a nasty stack trace dump when the undefined value was used later on."
},
{
"commit": "ac84ffb90156585c3f7a84ed757bc2603da13f31",
"date": "2018-12-06 11:57:30 -0500",
"subject": "Clarify that storageExists() is only valid for files.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "a72759eb5bad455fc1cca5e1e073628643d6dc0b",
"date": "2018-12-06 11:53:38 -0500",
"subject": "Add comments on String and Variant usage regarding memory contexts.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "11181e69b818452a0b01d388ca5ce0879e6c3a3d",
"date": "2018-12-06 09:04:01 -0500",
"subject": "Disable Centos/RHEL 7 documentation builds.",
"body": "These were introduced in 33fa2ede and ran for a day or so before they started failing consistently on CI. Local builds work fine.\n\nDisable them to free the pipeline for further commits while we determine the issue."
},
{
"commit": "e73416e9e39118a3eb7a10d4d3f434ef7cc1c4ba",
"date": "2018-12-05 17:56:47 -0500",
"subject": "Change file ownership only when required.",
"body": "Previously chown() would be called even when no ownership changes were required.\n\nIn most cases changes are not required and it seems better to perform an extra stat() rather than an extra chown().\n\nAlso add unit tests for owner() since there weren't any."
},
{
"commit": "e96986a4e1e7aa5302686f559ca2848e1518669f",
"date": "2018-12-05 16:21:45 -0500",
"subject": "Error when --target-action=shutdown specified for PostgreSQL < 9.5.",
"body": "This equaled \"promote\" on unsupported versions which qualifies as a surprising behavior."
},
{
"commit": "5b52f020212d75b4f1001727e1a0d8acbae0fe60",
"date": "2018-12-05 15:58:45 -0500",
"subject": "Clarify when target-action is effective and PostgreSQL version support.",
"body": "Suggested by Keith Fiske."
},
{
"commit": "a0ecf53ead32070045119e8a129d0d07da3662fa",
"date": "2018-12-05 13:07:55 -0500",
"subject": "Fix documentation typo."
},
{
"commit": "bf873be4aa2688416ec63c8920144a847df142f7",
"date": "2018-12-05 12:51:13 -0500",
"subject": "Redact authentication header when throwing S3 errors.",
"body": "The authentication header contains the access key (not the secret key) so don't include it in errors that can be seen at any log level."
},
{
"commit": "cc6447356ef436582fdd3501311cb8da0f4f0342",
"date": "2018-12-05 09:15:45 -0500",
"subject": "Fix test binary name for gprof.",
"body": "This got missed in 1f8931f7 when the test binary was renamed.\n\nAlso output call graph along with the flat report. The flat report is generally most useful but it doesn't hurt to have both."
},
{
"commit": "33fa2ede7d106db6bf95712747bd0a8ed52f1be5",
"date": "2018-12-05 07:12:28 -0500",
"subject": "Add Centos/RHEL 7 option to documentation build.",
"body": "Centos/RHEL 7 builds can be specified with --var=os-type=centos7.\n\nAlso added to the documentation release and CI builds."
},
{
"commit": "baeff9e4f04c7f86f9cbe84efaf4dc66b3a4add4",
"date": "2018-12-04 17:33:56 -0500",
"subject": "Create common if expressions for testing os-type.",
"body": "These expressions simplify os-type testing. This will be especially true as more OS types are added."
},
{
"commit": "9e217d02564d30bcdcb865f87323221aa2969169",
"date": "2018-12-04 13:17:55 -0500",
"subject": "Documentation may be built with user-specified packages.",
"body": "By default the documentation builds pgBackRest from source, but the documentation is also a good way to smoke-test packages.\n\nAllow a package file to be specified by passing --var=package=/path/to/package.ext. This works for Debian and CentOS 6 builds."
},
{
"commit": "0db030fa63b74fb6e0a8ad58f1417e39cd1eac9e",
"date": "2018-12-04 11:46:25 -0500",
"subject": "Add coding standards for String constants."
},
{
"commit": "14190f9e6c290383676a4332ff5c71e9cc83c66a",
"date": "2018-12-03 12:41:53 -0500",
"subject": "Update URL for Docker install.",
"body": "As usual the old URL started providing a broken version of Docker rather than producing a clear error message. This happens once a year or so."
},
{
"commit": "17e611cb883b6086a802c2adfbda384817feaa09",
"date": "2018-12-01 12:40:01 -0500",
"subject": "Replace keywords with more flexible if statements.",
"body": "Keywords were extremely limited and prevented us from generating multi-version documentation and other improvements.\n\nReplace keywords with an if statement that can evaluate a Perl expression with variable replacement.\n\nSince keywords were used to generate cache keys, add a --key-var parameter to identify which variables should make up the key."
},
{
"commit": "47490ba9600c25f75a9d833d9a42da3633257751",
"date": "2018-11-30 18:47:42 -0500",
"subject": "Fix comment typo.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "977506b44615cc9d9d9c581ffd0fd407b7d174d8",
"date": "2018-11-30 11:15:52 -0500",
"subject": "Clarify that region/endpoint must be configured correctly for the bucket.",
"body": "Suggested by Pritam Barhate."
},
{
"commit": "64b97fd7ca3410cd6bca3c01bc438bb104191f78",
"date": "2018-11-30 10:55:29 -0500",
"subject": "Correct archive-get-queue-max to be size type.",
"body": "This somehow was not configured as a size option when it was added. It worked, but queue sizes could not be specified in shorthand, e.g. 128GB.\n\nThis is not a breaking change because currently configured integer values will be read as bytes."
},
{
"commit": "1ad67644dade53595e2f210d0f75cc247b3ea2a5",
"date": "2018-11-30 10:38:02 -0500",
"subject": "Remove request for S3 object info directly after putting it.",
"body": "After a file is copied during backup the size is requested from the storage in case it differs from what was written so that repo-size can be reported accurately. This is useful for situations where compression is being done by the filesystem (e.g. ZFS) and what is stored can differ in size from what was written.\n\nIn S3 the reported size will always be exactly what was written so there is no need to check the size and doing so immediately can cause problems because the new file might not appear in list commands. This has not been observed on S3 (though it seems to be possible) but it has been reported on the Swift S3 gateway.\n\nAdd a driver capability to determine if size needs to be called after a file is written and if not then simply use the number of bytes written for repo-size."
},
{
"commit": "5d3c8e47f14c9f497866a899bed7d6e25f0fb67f",
"date": "2018-11-29 14:45:15 -0500",
"subject": "Pre-build containers for any execute elements marked pre.",
"body": "This allows the documentation to be built more quickly and offline during development when --pre is specified on the command line.\n\nEach host gets a pre-built container with all the execute elements marked pre. As long as the pre elements do not change the container will not need to be rebuilt.\n\nThe feature should not be used for CI builds as it may hide errors in the documentation."
},
{
"commit": "74b72df9dbfbfb00d5b729cb83bef35e77fd73c6",
"date": "2018-11-28 18:41:21 -0500",
"subject": "Improve error message when info files are missing/corrupt.",
"body": "The previous error message only showed the last error. In addition, some errors were missed (such as directory permission errors) that could prevent the copy from being checked.\n\nShow both errors below a generic \"unable to load\" error. Details are now given explaining exactly why the primary and copy failed.\n\nPreviously if one file could not be loaded a warning would be output. This has been removed because it is not clear what the user should do in this case. Should they do a stanza-create --force? Maybe the best idea is to automatically repair the corrupt file, but on the other hand that might just spread corruption if pgBackRest makes the wrong choice."
},
{
"commit": "47687dd13a24a49409f07b99141b508739228791",
"date": "2018-11-28 18:10:54 -0500",
"subject": "Add xmlNodeAttribute() to XmlNode object.",
"body": "Retrieves a node attribute unless it is the root node."
},
{
"commit": "7c2fcb63e4ab62e880ebca935fb67e25fa03d5b3",
"date": "2018-11-28 14:56:26 -0500",
"subject": "Enable encryption for archive-get command in C.",
"body": "The decryption filter was added in archiveGetFile() and archiveGetCheck() was modified to return the WAL decryption key stored in archive.info. The rest was plumbing.\n\nThe mock/archive/1 integration test added encryption to provide coverage for the new code paths while mock/archive/2 dropped encryption to provide coverage for the existing code paths. This caused some churn in the expect logs but there was no change in behavior."
},
{
"commit": "6c23830991558d74ecade1d510fbd50acf5b0f18",
"date": "2018-11-28 14:41:10 -0500",
"subject": "Add encryption capability to Info* objects.",
"body": "Info objects can be stored encrypted and loaded with a cipher type and passphrase."
},
{
"commit": "410a04a58ee59de3055483a2f971c2e42015267e",
"date": "2018-11-28 14:20:12 -0500",
"subject": "Allow arbitrary InOut filters to be chained in IoFilterGroup.",
"body": "If InOut filters were placed next to each other then the second filter would never get a NULL input signaling it to flush. This arrangement only worked if the second filter had some other indication that it should flush, such as a decompression filter where the flush is indicated in the input stream.\n\nThis is not a live issue because currently no InOut filters are chained together."
},
{
"commit": "838cfa44b76ed885f030ebf75649df7eaace6593",
"date": "2018-11-28 14:02:14 -0500",
"subject": "Allow arbitrary multiplier and flush character in IoTestFilterMultiply.",
"body": "This allows for more complex test filter chains.\n\nRename from IoTestFilterDouble to reflect the new functionality."
},
{
"commit": "3e254f4cff349f2de95b557b77e3bb0baa1450c9",
"date": "2018-11-28 12:42:36 -0500",
"subject": "Add IoFilter interface to CipherBlock object.",
"body": "This allows CipherBlock to be used as a filter in an IoFilterGroup. The C-style functions used by Perl are now deprecated and should not be used for any new code.\n\nAlso add functions to convert between cipher names and CipherType."
},
{
"commit": "c3a84ccae08cf7506f26a000344ea1ba2517f9a8",
"date": "2018-11-28 12:03:27 -0500",
"subject": "Merge cipher.h into crypto.h.",
"body": "There is not enough in cipher.h to make it worth having a separate header."
},
{
"commit": "7df7cf6e6d1e04fef41ba37cb13020ada6bf4b22",
"date": "2018-11-27 22:49:24 -0500",
"subject": "Rename cipherBlock*() functions to cipherBlock*C().",
"body": "Some of the old names conflict with the new functions that must be created to implement the filter. Rename these to cipherBlock*C() to indicate that they take C-style parameters.\n\nThese functions are only used by the Perl LibC code and will be removed or refactored eventually."
},
{
"commit": "fea27dbd7eb4ea72a8c792628bba6ed849f68c08",
"date": "2018-11-27 22:02:08 -0500",
"subject": "Return IoFilterGroup * from ioFilterGroupAdd().",
"body": "This allows filters adds to be chained."
},
{
"commit": "56ce98b2f0710b77e9df720722d200add670238e",
"date": "2018-11-25 10:06:31 -0500",
"subject": "Explicitly compile with Posix 2001 standard.",
"body": "This standard was being selectively applied in modules that needed it.\n\nInstead, apply the standard to all compilation for consistency."
},
{
"commit": "315aa2c4512c2789889d68d1253366c5c75d405b",
"date": "2018-11-25 08:39:41 -0500",
"subject": "Conditional compilation of Perl logic in exit.c.",
"body": "This file is the only one to contain Perl logic outside of the perl module. Make the Perl logic conditional to improve reusability."
},
{
"commit": "78fe642eaeae4f7f73796fdc45b5c2a81e9f3e9f",
"date": "2018-11-24 20:31:35 -0500",
"subject": "Remove extraneous use/include statements.",
"body": "Use conditional loading to make docs work in the absence of LibC.\n\nSomehow this also required a use statement to be added. Perl, go figure."
},
{
"commit": "801e2a5a2ce14f6ef447526c646f0c641c94efa2",
"date": "2018-11-24 19:05:03 -0500",
"subject": "Rename PGBACKREST/BACKREST constants to PROJECT.",
"body": "This brings consistency between the C and Perl constants and allows for easier code reuse."
},
{
"commit": "7a1a68883546bbfa0b24fc65054b0a7bf4f09b66",
"date": "2018-11-24 09:12:44 -0500",
"subject": "Add EOF detection to content read in HttpClient.",
"body": "If the connection closed before all content was sent httpClientRead() would get stuck in an infinite loop waiting for it to arrive.\n\nEOF should never be reached during content read so immediately error if EOF is detected."
},
{
"commit": "f4a1751abc9b42d03e0d041fa386a879beb3ee5b",
"date": "2018-11-23 16:02:33 -0500",
"subject": "Improve JSON to Variant conversion and add Variant to JSON conversion.",
"body": "Add boolean and one-dimensional list types to jsonToKv().\n\nAdd varToJson() and kvToJson() to convert Variants and KeyValues to JSON."
},
{
"commit": "e641c130d30706755775ee328637e3be9d6dba55",
"date": "2018-11-23 12:19:56 -0500",
"subject": "Fix release note typo."
},
{
"commit": "beae37533041e63a71b33757e4df933e197e575f",
"date": "2018-11-23 12:18:07 -0500",
"subject": "Enable S3 storage for archive-get command in C.",
"body": "The only change required was to remove the filter that prevented S3 storage from being used. The archive-get command did not require any modification which demonstrates that the storage interface is working as intended.\n\nThe mock/archive/3 integration test was modified to run S3 storage locally to provide coverage for the new code paths while mock/stanza/3 was modified to run S3 storage remotely to provide coverage for the existing code paths. This caused some churn in the expect logs but there was no change in behavior."
},
{
"commit": "b5690e21a4ad453f004087adf434adf13d109a8c",
"date": "2018-11-23 12:01:36 -0500",
"subject": "Allow I/O read interface to explicitly request blocking reads.",
"body": "TlsClient introduced a non-blocking read which is required to read protocol messages that are linefeed-terminated rather than a known size. However, in many cases the expected number of bytes is known in advance so in that case it is more efficient to have tlsClientRead() block until all the bytes are read.\n\nAdd block parameter to all read functions and use it when a blocking read is required. For most read functions this is a noop, i.e. if the read function never blocks then it can ignore the parameter.\n\nIn passing, set the log level of storageNew*() functions to debug to expose more high-level I/O operations."
},
{
"commit": "256b727a3d13b680ab2a4c7b3669649c857d1daf",
"date": "2018-11-21 19:32:49 -0500",
"subject": "Add S3 storage driver.",
"body": "Only the storageNewRead() and storageList() functions are currently implemented, but this is enough to enable S3 for the archive-get command."
},
{
"commit": "72252ed2a102bf9c43d45500de1a29834d36721c",
"date": "2018-11-21 19:11:45 -0500",
"subject": "Add HttpClient object.",
"body": "A robust HTTP client with connection reuse and automatic retries.\n\nUsing a single object to make multiple requests is more efficient because connections are reused whenever possible. Requests are automatically retried when the connection has been closed by the server. Any 5xx response is also retried.\n\nOnly the HTTPS protocol is currently supported."
},
{
"commit": "1dd06a6e460049ff888e152f33697b1e49046c30",
"date": "2018-11-21 18:43:25 -0500",
"subject": "Add TlsClient object.",
"body": "A simple, secure TLS client intended to allow access to services that are exposed via HTTPS. We call it TLS instead of SSL because SSL methods are disabled so only TLS connections are allowed.\n\nThis object is intended to be used for multiple TLS connections against a service so tlsClientOpen() can be called each time a new connection is needed. By default, an open connection will be reused so the user must be prepared to retry their transaction on a read/write error if the server closes the connection before it can be reused. If this behavior is not desirable then tlsClientClose() may be used to ensure that the next call to tlsClientOpen() will create a new TLS session.\n\nNote that tlsClientRead() is non-blocking unless there are *zero* bytes to be read from the session in which case it will raise an error after the defined timeout. In any case the tlsClientRead()/tlsClientWrite()/tlsClientEof() functions should not generally be called directly. Instead use the read/write interfaces available from tlsClientIoRead()/tlsClientIoWrite()."
},
{
"commit": "ac426bc456425d68e33a7facc8393f26b9d17bb1",
"date": "2018-11-21 18:13:37 -0500",
"subject": "New test containers with static test certificates.",
"body": "Test certificates were generated dynamically but there are advantages to using static certificates. For example, it possible to use the same certificate between container versions. Mostly, it is easier to document the certificates if they are not buried deep in the container code.\n\nThe new test certificates are initially intended to be used with the C unit tests but they will eventually be used for integration tests as well.\n\nTwo new certificates have been defined. See test/certificate/README.md for details.\n\nThe old dynamic certificates will be retained until they are replaced."
},
{
"commit": "53e3651ccaaaa1652f53903534974377a2808aec",
"date": "2018-11-21 08:30:14 -0500",
"subject": "Remove embedded semicolon from String constant macros.",
"body": "The embedded semicolon led to inconsistent semicolons when using the macro and is not our general convention.\n\nRemove embedded semicolons from the macros and add semicolons in usage where they were not present."
},
{
"commit": "bc25db5667b3b05ba47c547591717ee9627f650c",
"date": "2018-11-20 20:40:11 -0500",
"subject": "Add interface objects for libxml2.",
"body": "Add XmlDocument, XmlNode, and XmlNodeList objects as a thin interface layer on libxml2.\n\nThis interface is not intended to be comprehensive. Only a few libxml2 capabilities are exposed but more can be added as needed."
},
{
"commit": "6680130c6f5553e6d0c587dccc57b4a8508c4ab1",
"date": "2018-11-20 19:24:53 -0500",
"subject": "Require S3 key options except for local/remote commands.",
"body": "S3 key options (repo1-s3-key/repo1-s3-key-secret) were not required which meant that users got an ugly assertion when they were missing rather than a tidy configuration error.\n\nOnly the local/remote commands need them to be optional. This is because local/remote commands get all their options from the command line but secrets cannot be passed on the command line. Instead, secrets are passed to the local/remote commands via the protocol for any operation that needs them.\n\nThe configuration system allows required to be set per command so use that to improve the error messages while not breaking the local/remote commands."
},
{
"commit": "f743d4e92418d73717225599e3dbd03a4af7dec9",
"date": "2018-11-20 15:48:56 -0500",
"subject": "Add testRepoPath() to let C unit tests know where the code repository is located.",
"body": "This allows a C unit test to access data in the code repository that might be useful for testing.\n\nAdd testRepoPathSet() to set the repository path.\n\nIn passing remove extra whitespace in the TEST_RESULT_VOID() macro."
},
{
"commit": "b0659278cc7ab45519d791c10edbb494024f5148",
"date": "2018-11-16 17:22:22 -0500",
"subject": "Add ServiceError for errors from a service that can be retried.",
"body": "An example is HTTP 5xx errors which should mostly be retried."
},
{
"commit": "3aa4fda573d95839d617c65880a240d4093951b7",
"date": "2018-11-16 16:17:24 -0500",
"subject": "Add missing LOG_DEBUG() macro."
},
{
"commit": "d0e553e4c2a024be44a92dfa5eb0ce77330bcef7",
"date": "2018-11-16 16:05:06 -0500",
"subject": "Reduce debug level for infoIni() to test.",
"body": "Getters should generally not be logging at debug or trace level since it clutters the log.\n\nIn passing move the destructor to the end of the file."
},
{
"commit": "6532912d51050df4587ec54eee567e37fcb8b74e",
"date": "2018-11-16 10:04:14 -0500",
"subject": "Begin v2.08 development."
},
{
"commit": "04d9e4d5a88512707c350e3885e359d53c3ca36b",
"date": "2018-11-16 09:50:50 -0500",
"subject": "v2.07: Automatic Backup Checksum Delta"
},
{
"commit": "332a68ea8d713f24d1db08e20d5b95bcf32cc74e",
"date": "2018-11-16 08:48:02 -0500",
"subject": "Fix incorrect config constant introduced in 5e3b7cbe.",
"body": "This commit introduced PGBACKREST_CONFIG_ORIG_PATH_FILE_STR as a String constant for PGBACKREST_CONFIG_ORIG_PATH_FILE but failed to get the value correct.\n\nAlso, no test was added for PGBACKREST_CONFIG_ORIG_PATH_FILE_STR to prevent regressions as there is for PGBACKREST_CONFIG_ORIG_PATH_FILE."
},
{
"commit": "75f6e45de26cf4ab087dc791f2aa177553584472",
"date": "2018-11-15 16:31:46 -0500",
"subject": "Add \\n, \\r, and 0 String constants."
},
{
"commit": "b6f7cbc31531b6e88a89ecfe9c8d3ebc1e682d2e",
"date": "2018-11-15 16:25:46 -0500",
"subject": "Add destructors to IoRead and IoWrite objects.",
"body": "These interfaces previously used the memory context of the object they were associated with and did not have their own destructors.\n\nThere are times when it is useful to free the interface without also freeing the underlying object so give IoRead and IoWrite their own memory contexts and destructors.\n\nIn passing fix a comment type in bufferRead.c."
},
{
"commit": "480e1da7986a278a3b5c8aca965e539d383da9cc",
"date": "2018-11-14 08:53:42 -0500",
"subject": "Add ioWriteFlush() to flush pending output.",
"body": "By default the IoWrite object does not write until the output buffer is full but this is a problem for protocol messages that must be sent in order to get a response.\n\nioWriteFlush() is not called internally by IoWrite but can be used at any time to immediately write all bytes from the output buffer without closing the IoWrite object."
},
{
"commit": "7918629f5931b2eeca316d8b37191718db4650f4",
"date": "2018-11-14 08:16:53 -0500",
"subject": "Modify value of PERL_EMBED_ERROR macro.",
"body": "Remove three exclamation points which by convention we use as a marker for code that needs attention before it can be committed to master."
},
{
"commit": "504e7d77faeecd213df99ec320246e10a526f9ad",
"date": "2018-11-14 08:13:01 -0500",
"subject": "Add comment regarding vars being required in blocks.",
"body": "Documentation block syntax requires that at least one var be specified.\n\nThis limitation should be removed but for now add a comment to describe why a bogus var is defined."
},
{
"commit": "14d2f8b86c4fd3755af6cd9f5210cf1e34e8d090",
"date": "2018-11-14 08:11:11 -0500",
"subject": "Reword misleading message in stack trace when parameter buffer is full.",
"body": "The prior message stated that there had been a buffer overrun which is not true since the code prevents that.\n\nIn fact, this message means the parameter buffer filled while building the parameter list. Rather than display a partial list we output this message instead.\n\nAlso remove three exclamation points which by convention we use as a marker for code that needs attention before it can be committed to master."
},
{
"commit": "8c7e97a369a145f2d71856f2ff2ed734452a9040",
"date": "2018-11-14 08:08:26 -0500",
"subject": "Clarify comment about main.c being excluded from unit testing.",
"body": "Also remove three exclamation points which by convention we use as a marker for code that needs attention before it can be committed to master."
},
{
"commit": "73102034913ec2e3ca1b1cc485f8ce04820bba27",
"date": "2018-11-14 07:42:28 -0500",
"subject": "Remove obsolete comments."
},
{
"commit": "a0b2af567a8b6893c6e9b7f3b9a73acd4496332e",
"date": "2018-11-13 20:58:32 -0500",
"subject": "Add TEST_LOG() and TEST_LOG_FMT() macros.",
"body": "These macros provide a convenient way to output debug information in tests.\n\nThey are not intended to be left in test code when it is committed to master."
},
{
"commit": "a582ad837f9ada7b924d6c0a23580f88c495ce2e",
"date": "2018-11-13 20:43:08 -0500",
"subject": "Add logging macros for TimeMSec type."
},
{
"commit": "acb579c4698f856e4c1ceedca751aaeadc9d2d3f",
"date": "2018-11-13 10:37:58 -0500",
"subject": "Tighten limits on code coverage context selection.",
"body": "If the last } of a function was marked as uncovered then the context selection would overrun into the next function.\n\nStart checking context on the current line to prevent this. Make the same change for start context even though it doesn't seem to have an issue."
},
{
"commit": "086bc35ddc71b008a5d20f8e5e3d0305508dfdf5",
"date": "2018-11-12 21:18:53 -0500",
"subject": "Make ioReadLine() read less aggressively.",
"body": "ioReadLine() calls ioRead(), which aggressively tries to fill the output buffer, but this doesn't play well with blocking reads.\n\nGive ioReadLine() an option that tells it to read only what is available. That doesn't mean the function will never block but at least it won't do so by reading too far."
},
{
"commit": "bc810e5a87176ee68491e79473325a8a411a34c9",
"date": "2018-11-12 20:44:56 -0500",
"subject": "Remove error suppression for pgBackRest make.",
"body": "This looks like a copy-pasto because make works just fine without it."
},
{
"commit": "a2672557f80da95d6103d49e307321568285e5d6",
"date": "2018-11-12 20:00:57 -0500",
"subject": "Allow storage path and file mode to be 0.",
"body": "Not all storage drivers support Posix-style permissions, e.g. S3."
},
{
"commit": "7107cc68d23f344e7b13206eaec506a039a00350",
"date": "2018-11-12 18:11:16 -0500",
"subject": "Expand context shown in coverage and update colors.",
"body": "Too few lines were shown for coverage context so show the entire function if it has any missing coverage.\n\nUpdate colors to work with light and dark browser modes."
},
{
"commit": "0ba2292a29fcef873991098cc48b488580fbb713",
"date": "2018-11-12 14:23:42 -0500",
"subject": "Add EMPTY_STR to String object."
},
{
"commit": "aff9693e640c8a0b76e46f31d4fa569fd7d63289",
"date": "2018-11-12 14:13:55 -0500",
"subject": "Add strEmpty() to String object.",
"body": "strEmpty() is more concise and explanatory than strSize() == 0."
},
{
"commit": "38c5f657704c4c6899a0bf86bbce5fd332d97971",
"date": "2018-11-11 18:12:43 -0500",
"subject": "Use THROW_ON_SYS_ERROR macro to improve fork code coverage.",
"body": "Lack of code coverage in this module is just noise since these functions cannot generally be made to fail.\n\nAny failures are fatal."
},
{
"commit": "72ea47bfb341ff78f2582607e27e7b7df2ac25f8",
"date": "2018-11-11 18:07:56 -0500",
"subject": "Add KernelError to report miscellaneous kernel errors."
},
{
"commit": "257df96b12f38cba45751449dcd64ca712dd96c2",
"date": "2018-11-11 18:06:09 -0500",
"subject": "Add THROW*_ON_SYS_ERROR* macros to test and throw system errors.",
"body": "These macros check the error result internally and are appropriate for system calls that won't return errors and so break coverage."
},
{
"commit": "22ecbc153a447b4f635fad2ab71fdd92ed8294bc",
"date": "2018-11-11 17:32:42 -0500",
"subject": "New, concise coverage report for C.",
"body": "The report HTML generated by lcov is overly verbose and cumbersome to navigate. Since we maintain 100% coverage it's far more interesting to look at what is not covered than what is.\n\nThe new report presents all missing coverage on a single page and excludes code that is covered for brevity."
},
{
"commit": "3cd43fd60cd46430f86084f37b6ed874124e2848",
"date": "2018-11-11 16:34:15 -0500",
"subject": "Add new HTML tags and strExtra to DocHtmlElement.",
"body": "Add HTML tags for table elements.\n\nThe strExtra parameter allows adhoc tags to be added to an element for features that can't be implemented with CSS, e.g. colspan."
},
{
"commit": "5e3b7cbe6ee7a409ad6e311668eb764fee82939c",
"date": "2018-11-10 18:32:49 -0500",
"subject": "Apply String constant macros where appropriate.",
"body": "This may not be all the places where the macros can be useful but it's a good start."
},
{
"commit": "8f857a975e22d6a7c0e99a494169f24ed50b6c06",
"date": "2018-11-10 09:37:12 -0500",
"subject": "Add constant macros to String object.",
"body": "There are many places (and the number is growing) where a zero-terminated string constant must be transformed into a String object to be usable. This pattern wastes time and memory, especially since the created string is generally used in a read-only fashion.\n\nDefine macros to create constant String objects that are initialized at compile time rather than at run time."
},
{
"commit": "df200bee2acf614edf9d008cccde67f02d89f103",
"date": "2018-11-09 16:50:22 -0500",
"subject": "Add regExpPrefix() to aid in static prefix searches.",
"body": "The storageList() command accepts a regular expression as a filter. This works fine for local filesystems where it is relatively cheap to get a complete list of files and filter them in code. However, for remote filesystems like S3 it can be expensive to fetch a complete list of files only to discard the bulk of them locally.\n\nS3 does not filter on regular expressions but it can accept a static prefix so this function extracts a prefix from a regular expression when possible.\n\nEven a few characters can drastically reduce the amount of data that must be fetched remotely so the function does not try to be too clever. It requires a ^ anchor and stops scanning when the first special character is found."
},
{
"commit": "8c504bd2f9e6c14f134b6115f469ec3fe064cb73",
"date": "2018-11-09 10:37:59 -0500",
"subject": "Improve alignment of expected vs. got error test results.",
"body": "It is easier to compare the error messages when they start at the same column."
},
{
"commit": "b5a3c8c84b789558d11d67199fbcc4029721d939",
"date": "2018-11-09 09:54:55 -0500",
"subject": "Add strCatChr() to String object."
},
{
"commit": "3e695af9614e61f72e9f0d7c3dc729cc5a27f3eb",
"date": "2018-11-08 21:41:41 -0500",
"subject": "New test containers.",
"body": "* Add libxml2 library needed for S3 development.\n* Minor version updates for PostgreSQL.\n* Remove PostgreSQL 11 beta/rc repository."
},
{
"commit": "7cf1f42c5c65deed8ad0bdb86a33d273438fe9a0",
"date": "2018-11-08 19:50:31 -0500",
"subject": "Add time since the beginning of the run to each test statement.",
"body": "Output the time in seconds of each test statement since the start of the test run.\n\nThis helps find individual tests that are running slowly."
},
{
"commit": "2150a26424cacc80ded57697b67af1e3c2a47211",
"date": "2018-11-08 18:03:18 -0500",
"subject": "Storage interface methods no longer declare the driver as const.",
"body": "This works for the Posix driver but is bad for more dynamic drivers (e.g. S3) that need write access to the driver object."
},
{
"commit": "12b3be1d8ed38beea67c4d4de582af9039c5bd4b",
"date": "2018-11-08 16:48:33 -0500",
"subject": "Limit usable Buffer size without changing allocated size.",
"body": "Allow buffers to report a lower size than their allocated size. This means a larger buffer can be used to do the work of a smaller buffer without having to create a new buffer and concatenate.\n\nThis is useful for blocking I/O where the buffer may be too large for the amount of data that is available to read."
},
{
"commit": "edb2c6eb26ca77eb3e3e05c006f3036dee2865b7",
"date": "2018-11-08 08:37:57 -0500",
"subject": "Construct Wait object in milliseconds instead of fractional seconds.",
"body": "The Wait object accepted a double in the constructor for wait time but used TimeMSec internally. This was done for compatibility with the Perl code.\n\nInstead, use TimeMSec in the Wait constructor and make changes as needed to calling code.\n\nNote that Perl still uses a double for its Wait object so translation is needed in some places. There are no plans to update the Perl code as it will become obsolete."
},
{
"commit": "a9feaba9e521e39928ff5fdbc025eeff8fc17646",
"date": "2018-11-07 08:51:32 -0500",
"subject": "Add memContextCallbackClear() to prevent double free() calls.",
"body": "If an object free() method was called manually when a callback was set then the callback would call free() again. This meant that each free() method had to protect against a subsequent call.\n\nInstead, clear the callback (if present) before calling memContextFree(). This is faster (since there is no unnecessary callback) and removes the need for semaphores to protect against a double free()."
},
{
"commit": "48d2795f312224f03dc88e99434865540ca71c7e",
"date": "2018-11-06 20:04:16 -0500",
"subject": "Merge crypto/random module into crypto/crypto.",
"body": "There wasn't enough code to justify a separate module/test and it seems to fit just fine in crypto/crypto."
},
{
"commit": "8efa5e6a6af848a2a9d3e4c3260084d259949ee5",
"date": "2018-11-06 19:38:38 -0500",
"subject": "Rename CipherError to CryptoError.",
"body": "This aligns with the general renaming from cipher to crypto."
},
{
"commit": "2cb312ef5aa9f57da607229f9fe22ce5d7aa0352",
"date": "2018-11-06 19:16:00 -0500",
"subject": "Add cryptoError() and update crypto code to use it.",
"body": "This adds detail to error messages when available and improves code coverage."
},
{
"commit": "bef31f1802f231ce7b6ab06371148b74eb9eb6ab",
"date": "2018-11-06 18:32:44 -0500",
"subject": "Add base variants to all integer to string conversion functions.",
"body": "Previously these functions were fixed at base 10 conversion. Add variants that can convert from any base."
},
{
"commit": "7de9584435839f8e7b20e8f336820b84a70cafd8",
"date": "2018-11-04 08:39:48 -0500",
"subject": "Ignore deleted files in rsync to test/repo.",
"body": "Deleted files are showing up in git ls-files (added 57d78092) but they don't actually exist on disk.\n\nIf there is someway to exclude deleted files from ls-files then I can't find it, so just tell rsync to ignore missing files."
},
{
"commit": "57d780929741e3d09f60b252a26ad12fb645254e",
"date": "2018-11-03 19:52:46 -0400",
"subject": "Improve efficiency of code generation.",
"body": "Code generation saved files even when they had not changed, which often caused code generation cascades. So, don't save files unless they have changed.\n\nUse rsync to determine which files have changed since the last test run. The manifest of changed files is saved and not removed until all code generation and builds have completed. If an error occurs the work will be redone on the next run.\n\nThe eventual goal is to do all the builds from the test/repo directory created by rsync but for now it is only used to track changes."
},
{
"commit": "1f8931f73274163f27ba38aea378ea50488ba557",
"date": "2018-11-03 16:34:04 -0400",
"subject": "Improve single test run performance.",
"body": "Improve on 7794ab50 by including the build flag files directly into the Makefile as dependencies (even though they are not includes). This simplifies some of the rsync logic and allows make to do what it does best.\n\nAlso split build flag files into test, harness, and build to reduce rebuilds. Test flags are used to build test.c, harness flags are used to build the rest of the files in the test harness, and build flags are used for the files that are not directly involved in testing."
},
{
"commit": "7794ab50dc839088fc1e1137edaaf65354faa76a",
"date": "2018-11-02 11:56:13 -0400",
"subject": "Preserve contents of C unit test build directory between test.pl executions.",
"body": "The contents were already preserved between tests in a single test.pl run but for a separate execution the entire project had to be built from scratch, which was getting slower as we added code.\n\nSave the important build flags in a file so the new execution knows whether the build contents can be reused."
},
{
"commit": "1a98bd41b48b2619b318639faeeb688481dbc07e",
"date": "2018-11-02 08:37:27 -0400",
"subject": "Mount tmpfs in Vagrantfile instead test.pl.",
"body": "Mounting/unmounting tmpfs on /home/[user]/test takes time, forces at least 3GB of memory to be available for tests, and makes it harder to preserve data between tests.\n\nInstead, move mounting of tmpfs to the Vagrantfile and add it to fstab so it survives reboots."
},
{
"commit": "34c63276cd26cd5310169343bb8e17e323feef95",
"date": "2018-11-01 11:31:25 -0400",
"subject": "Automatically enable backup checksum delta when anomalies (e.g. timeline switch) are detected.",
"body": "There are a number of cases where a checksum delta is more appropriate than the default time-based delta:\n\n* Timeline has switched since the prior backup\n* File timestamp is older than recorded in the prior backup\n* File size changed but timestamp did not\n* File timestamp is in the future compared to the start of the backup\n* Online option has changed since the prior backup\n\nA practical example is that checksum delta will be enabled after a failover to standby due to the timeline switch. In this case, timestamps can't be trusted and our recommendation has been to run a full backup, which can impact the retention schedule and requires manual intervention.\n\nNow, a checksum delta will be performed if the backup type is incr/diff. This means more CPU will be used during the backup but the backup size will be smaller and the retention schedule will not be impacted."
},
{
"commit": "cca7a4ffd477871d5eab323f1a5f621fbe48a568",
"date": "2018-10-30 16:45:42 -0400",
"subject": "Retry all S3 5xx errors rather than just 500 internal errors.",
"body": "We were already retrying 500 errors but 503 (rate-limiting) errors were not being retried and would cause an instant failure which aborted the command.\n\nThere are only two 5xx errors currently implemented by S3 but instead of adding 503 simply retry all 5xx errors. This is consistent with the http definition of this error class, \"the server failed to fulfill an apparently valid request.\""
},
{
"commit": "286f7e501154a05d147d146d25e3dd0ea0d49d5c",
"date": "2018-10-27 20:00:00 +0100",
"subject": "Fix static WAL segment size used to determine if archive-push-queue-max has been exceeded.",
"body": "This calculation was missed when the WAL segment size was made dynamic in preparation for PostgreSQL 11.\n\nFix the calculation by checking the actual WAL file sizes instead of using an estimate based on WAL segment size. This is more accurate because it takes into account .history and .backup files, which are smaller. Since the calculation is done in the async process the additional processing time should not adversely affect performance.\n\nRemove the PG_WAL_SIZE constant and instead use local constants where the old value is still required. This is only the case for some tests and PostgreSQL 8.3 which does not provide a way to get the WAL segment size from pg_control."
},
{
"commit": "41b00dc204a04a87b337aa5bebe7cfd4032d5eae",
"date": "2018-10-27 16:57:57 +0100",
"subject": "Fix issue with archive-push-queue-max not being honored on connection error.",
"body": "If an error occurred while acquiring a lock on a remote server the error would be reported correctly, but the queue max detection code was not reached. The tests failed to detect this because they fixed the connection before queue max, allowing the ccde to be reached.\n\nMove the queue max code before the lock so it will run even when remote connections are not working. This means that no attempt will be made to transfer WAL once queue max has been exceeded, but it makes it much more likely that the code will be reach without error.\n\nUpdate tests to continue errors up to the point where queue max is exceeded."
},
{
"commit": "03b9db9aa2e84bf6b23af8331712d1480520ca19",
"date": "2018-10-25 14:58:25 +0100",
"subject": "Fix error after log file open failure when processing should continue.",
"body": "The C code was warning on failure and continuing but the Perl logging code was never updated with the same feature.\n\nRather than add the feature to Perl, just disable file logging if the log file cannot be opened. Log files are always opened by C first, so this will eliminate the error in Perl."
},
{
"commit": "d301720c58145910189829e8b2ceacccd3543c1e",
"date": "2018-10-25 10:48:37 +0100",
"subject": "Change infoArchiveCheckPg() to display the PostgreSQL version as a string in errors.",
"body": "Previously an integer representation (e.g. 90400) would be displayed which is correct but not as friendly to the user."
},
{
"commit": "5590bfa84c0a91d1e93ed03441e12c4dab1078c5",
"date": "2018-10-19 18:31:05 +0200",
"subject": "Add tests for InfoPg history fixes introduced in 070455ce.",
"body": "The existing tests were not adequate to ensure the history was being added in the correct order when some entries were loaded from a file and others added with infoPgAdd()."
},
{
"commit": "070455ce44504c63a5bf2f70093c64ed278fa12e",
"date": "2018-10-19 12:31:56 +0200",
"subject": "Correct current history item in InfoPg to always be in position 0.",
"body": "The InfoPg object was partially modified in 960ad732 to place the current history item in position 0, but infoPgDataCurrent() didn't get updated correctly.\n\nRemove this->indexCurrent and make the current position always equal 0. Use the new lstInsert() function when adding new history items via infoPgAdd(), but continue to use lstAdd() when loading from a file for efficiency.\n\nThis does not appear to be a live bug because infoPgDataCurrent() and infoPgAdd() are not yet used in any production code. The archive-get command is the only C code using InfoPG and it always looks at the entire list of items rather than just the current item."
},
{
"commit": "f345db3f7ca15480c5aa70d015150b399f3ce33a",
"date": "2018-10-19 11:52:17 +0200",
"subject": "Add lstInsert() to List object.",
"body": "Add general purpose insert function and make lstAdd() a special insert case."
},
{
"commit": "09a1ad2c10fa17e165b88731322f4dcf8de73ecc",
"date": "2018-10-19 10:51:33 +0200",
"subject": "Correct cfgDefDataFind() to use UINTP instead of VOIDPP.",
"body": "Also add the UINTP macro."
},
{
"commit": "06d68eada00e6ec57c662aa9ad2bacdc86eb5861",
"date": "2018-10-16 17:21:01 +0100",
"subject": "Begin v2.07 development."
},
{
"commit": "904550c97f674d3f576d3113756f2b5c89b55ddf",
"date": "2018-10-16 14:56:51 +0100",
"subject": "v2.06: Checksum Delta Backup and PostgreSQL 11 Support"
},
{
"commit": "2c272c220b39739ff324305593034487df81b466",
"date": "2018-10-15 23:23:49 +0100",
"subject": "PostgreSQL 11 support.",
"body": "PostgreSQL 11 RC1 support was tested in 9ae3d8c46 when the u18 container was rebuilt. Nothing substantive changed after RC1 so pgBackRest is ready for PostgreSQL 11 GA."
},
{
"commit": "9ae3d8c46ac10273ca53c942410f768e27395230",
"date": "2018-10-15 23:13:08 +0100",
"subject": "Install nodejs from deb.nodesource.com.",
"body": "The standard npm packages on Ubuntu 18.04 suddenly required libssl1.0 which broke the pgbackrest package builds. Installing nodejs from deb.nodesource.com seems to work fine with standard libssl.\n\nThis package is required by ScalityS3 which is used for local S3 testing."
},
{
"commit": "98ff8ccc59fa1e344426f3084e0a37498e56ce12",
"date": "2018-10-09 15:08:49 +0100",
"subject": "Improve documentation in filter.h and filter.internal.h.",
"body": "When the filter interface internals were split out into a new header file the documentation was not moved as it should have been. Additionally some functions which should have been moved were left behind.\n\nMove the documentation and functions to filter.internal.h and add more documentation. Filters are a tricky subject so the more documentation the better.\n\nAlso add documentation for the user-facing filter functions in filter.h."
},
{
"commit": "68110d04b24dc633e5b5b6869924dd36a2307135",
"date": "2018-10-07 17:50:10 +0100",
"subject": "Add ioReadLine()/ioWriteLine() to IoRead/IoWrite objects.",
"body": "Allow a single linefeed-terminated line to be read or written. This is useful for various protocol implementations, including HTTP and pgBackRest's protocol.\n\nOn read the maximum line size is limited to buffer-size to prevent runaway memory usage in case a linefeed is not found. This seems fine for HTTP but we may need to revisit this decision when implementing the pgBackRest protocol. Another option would be to increase the minimum buffer size (currently 16KB)."
},
{
"commit": "db8dce7adcf277a021ad8766ab91e86fad913eff",
"date": "2018-10-02 17:54:43 +0100",
"subject": "Disable flapping archive/get unit on CentOS 6.",
"body": "This test has been flapping since 9b9396c7. It seems to be some kind of timing issue since all integration tests pass and this unit passes on all other VMs. It only happens on Travis and is not reproducible in any development environment that we have tried.\n\nFor now, disable the test since the constant flapping is causing major delays in testing and quite a bit of time has been spent trying to identify the root cause. We are actively developing these tests and hope the issue will be identified during the course of normal development.\n\nA number of improvements were made to the tests while searching for this issue. While none of them helped, it makes sense to keep the improvements."
},
{
"commit": "ed5d7a53de7cd952825e824ae507e275c4648e18",
"date": "2018-09-30 12:27:05 +0100",
"subject": "Add .gitignore to C src directory.",
"body": "Suggested by Stephen Frost."
},
{
"commit": "3be9f2dee79c02e728e2339dd047d6990ec215c5",
"date": "2018-09-30 11:45:37 +0100",
"subject": "Avoid calling strlen() twice in bufNewZ()."
},
{
"commit": "5404628148a3039f3933607c7f63cb4620f71761",
"date": "2018-09-27 17:48:40 +0100",
"subject": "Fix incorrect error message for duplicate options in configuration files.",
"body": "Duplicating a non-multi-value option was not throwing the correct message when the option was a boolean.\n\nThe reason was that the option was being validated as a boolean before the multi-value check was being done. The validation code assumed it was operating on a string but was instead operating on a string list causing an assertion to fail.\n\nSince it's not safe to do the multi-value check so late, move it up to the command-line and configuration file parse phases instead."
},
{
"commit": "be2271f6d312e6497e98df2c792d2455afb461eb",
"date": "2018-09-27 17:24:06 +0100",
"subject": "Add cfgDefOptionMulti() to identify multi-value options.",
"body": "Previously this was done in two separate places by checking if an option was type hash or list.\n\nBad enough that it was in two places, but an upcoming bug fix will add another instance so make it a function."
},
{
"commit": "e66e68e324fb8381e0592a419b3aafdf70703b56",
"date": "2018-09-27 09:20:47 +0100",
"subject": "Add cryptoHmacOne() for HMAC support.",
"body": "There doesn't seem to be any need to implement this as a filter since current use cases (S3 authentication) work on small datasets.\n\nSo, use the single function method provided by OpenSSL for simplicity."
},
{
"commit": "6470f03fa28a72c9603d4d913ce58c7223b6cc0b",
"date": "2018-09-26 22:36:42 +0100",
"subject": "Comment fixes."
},
{
"commit": "bcca625062b4ee8394f933218e890238a75e9419",
"date": "2018-09-26 22:33:48 +0100",
"subject": "Add bufHex()to Buffer object.",
"body": "A general-purpose function for converting buffers to hex strings."
},
{
"commit": "51484a008f1172b51c2296974de7bfcd37ab24b8",
"date": "2018-09-26 18:46:52 +0100",
"subject": "Add bufNewZ() to Buffer object.",
"body": "This constructor creates a Buffer object directly from a zero-terminated string. The old way was to create a String object first, then convert that to a Buffer using bufNewStr().\n\nUpdated in all places that used the old pattern."
},
{
"commit": "d038b9a029f0c981e32a94b8b8632c356ffec7ac",
"date": "2018-09-25 10:24:42 +0100",
"subject": "Support configurable WAL segment size.",
"body": "PostgreSQL 11 introduces configurable WAL segment sizes, from 1MB to 1GB.\n\nThere are two areas that needed to be updated to support this: building the archive-get queue and checking that WAL has been archived after a backup. Both operations require the WAL segment size to properly build a list.\n\nChecking the archive after a backup is still implemented in Perl and has an active database connection, so just get the WAL segment size from the database.\n\nThe archive-get command does not have a connection to the database, so get the WAL segment size from pg_control instead. This requires a deeper inspection of pg_control than has been done in the past, so it seemed best to copy the relevant data structures from each version of PostgreSQL and build a generic interface layer to address them. While this approach is a bit verbose, it has the advantage of being relatively simple, and can easily be updated for new versions of PostgreSQL.\n\nSince the integration tests generate pg_control files for testing, teach Perl how to generate files with the correct offsets for both 32-bit and 64-bit architectures."
},
{
"commit": "c0b0b4e541fc7cc5077e7f6b9fa646e7654ca9a4",
"date": "2018-09-21 13:25:27 -0400",
"subject": "PostgreSQL 11 Beta 4 support.",
"body": "Catalog version changed for this release, so update it.\n\nAlso update and upload a new container with beta 4 installed."
},
{
"commit": "d513a46e6d9d34a28dd4b99636d6ea11d3e0dff4",
"date": "2018-09-19 18:26:12 -0400",
"subject": "Update introduction to be pithy."
},
{
"commit": "50266cc26c2c76fd155779e85c82dbed58cc2d84",
"date": "2018-09-19 16:41:20 -0400",
"subject": "Use command in authorized_hosts to improve SSH security.",
"body": "Unsecured, passwordless SSH can be a scary thing. If an attacker gains access to one system they can easily hop to other systems.\n\nAdd documentation on how to use the command parameter in authorized_keys to limit ssh to running a single command, pgbackrest. There is more that could be done for security but this likely addresses most needs.\n\nAlso change references to \"trusted ssh\" to \"passwordless ssh\" since this seems more correct."
},
{
"commit": "880fbb5e578c387e52f83c8eca1040b42f4e21a8",
"date": "2018-09-19 11:12:45 -0400",
"subject": "Add checksum delta for incremental backups.",
"body": "Use checksums rather than timestamps to determine if files have changed. This is useful in cases where the timestamps may not be trustworthy, e.g. when performing an incremental after failing over to a standby.\n\nIf checksum delta is enabled then checksums will be used for verification of resumed backups, even if they are full. Resumes have always used checksums to verify the files in the repository, enabling delta performs checksums on the database files as well.\n\nNote that the user must manually enable this feature in cases were it would be useful or just keep in enabled all the time. A future commit will address automatically enabling the feature in cases where it seems likely to be useful."
},
{
"commit": "bf0691576a56df0d662488cee19d21e924a3cecb",
"date": "2018-09-18 13:29:05 -0400",
"subject": "Allow delta option to be specified in the pgBackRest configuration file.",
"body": "This option was previously allowed on the command-line only for no particular reason that we could determine.\n\nBeing able to specify it in the config file seems like a good idea and won't change current usage."
},
{
"commit": "b6b2c915b24fdcfb64e1fe6a0c8a796da50c9fe4",
"date": "2018-09-18 11:39:48 -0400",
"subject": "Allow hashSize() to run on remote storage.",
"body": "Apparently we never needed to run this function remotely.\n\nIt will be needed by the backup checksum delta feature, so implement it now."
},
{
"commit": "052e483057e4ee55d29c229c39b92c90a9cee0af",
"date": "2018-09-18 10:18:39 -0400",
"subject": "Restore bIgnoreMissing flag in backupFile() lost in storage refactor.",
"body": "The test to make sure that some files (e.g. pg_control) do not get removed during the backup was lost during the storage refactor committed at de7fc37f.\n\nThis did not impact the integrity of the backups, but bring it back since it is a nice sanity check."
},
{
"commit": "03003562d86f7fdbab21cad9f7a7ee56c3070f93",
"date": "2018-09-17 11:45:41 -0400",
"subject": "Merge all posix storage tests into a single unit.",
"body": "As we add storage drivers it's important to keep the tests for each completely separate. Rather than have three tests for each driver, standardize on having a single test unit for each driver."
},
{
"commit": "e55d73304102145c46c32f25dbe103cd4c750d37",
"date": "2018-09-17 11:38:10 -0400",
"subject": "Add -ftree-coalesce-vars option to unit test compilation.",
"body": "This is a workaround for inefficient handling of many setjmps in gcc >= 4.9. Setjmp is used in all error handling, but in the unit tests each test macro contains an error handling block so they add up pretty quickly for large unit tests.\n\nEnabling -ftree-coalesce-vars in affected versions reduces build time and memory requirements by nearly an order of magnitude. Even so, compiles are much slower than gcc <= 4.8.\n\nWe submitted a bug for this at: https://gcc.gnu.org/bugzilla/show_bug.cgi?id=87316\nWhich was marked as a duplicate of: https://gcc.gnu.org/bugzilla/show_bug.cgi?id=63155"
},
{
"commit": "b5f749b21cbf51e3ba9f3bc2129c337cb6ebec92",
"date": "2018-09-16 18:41:30 -0400",
"subject": "Add CIFS driver to storage helper for read-only repositories.",
"body": "For read-only repositories the Posix and CIFS drivers behave exactly the same. Since that's all we support in C right now it's valid to treat them as the same thing. An assertion has been added to remind us to add the CIFS driver before allowing the repository to be writable.\n\nMostly we want to make sure that the C code does not blow up when the repository type is CIFS."
},
{
"commit": "a6c346cb04d8977d37e52072488d89a7fb3a89b6",
"date": "2018-09-16 17:26:04 -0400",
"subject": "Clear test directory between test runs.",
"body": "Previously it was the responsibility of the individual tests to clean up after themselves. Now the test harness now does the cleanup automatically.\n\nThis means that some paths/files need to be recreated with each run but that doesn't happen very often.\n\nAn attempt has been made to remove all redundant cleanup code but it's hard to know if everything has been caught. No issues will be caused by anything that was missed, but they will continue to chew up time in the tests."
},
{
"commit": "4119ce208d1d6de2b096d0465721e93dcb981d3f",
"date": "2018-09-16 15:58:46 -0400",
"subject": "Move test expect log out of the regular test directory.",
"body": "Storing the expect log (created by common/harnessLog) in the regular test directory was not ideal. It showed up in tests and made it difficult to clear the test directory between each run.\n\nMove the expect log to a purpose-built directory one level up so it does not interfere with regular testing."
},
{
"commit": "8852622fa241836b0a6c5c08d755f2c3d990427d",
"date": "2018-09-16 15:53:19 -0400",
"subject": "Fix missing test caused by a misplaced YAML tag."
},
{
"commit": "c47fc28c8b9cba4fba60f206ec029773f60171af",
"date": "2018-09-16 14:15:21 -0400",
"subject": "Make comment blocks consistent across all tests."
},
{
"commit": "84ab787b1a7f8ca42d9b2be72a730ace852667a1",
"date": "2018-09-16 14:12:53 -0400",
"subject": "Merge protocol storage helper into storage helper.",
"body": "These are separated the same way in the Perl code where the remote storage driver is located in the Protocol module. However, in the C code the intention is to implement the remote storage driver as a regular driver in the storage layer rather than making a special case out of it.\n\nSo, merge the storage helpers. This also has the benefit of making the code a bit simpler.\n\nAlso separate storageSpool() and storageSpoolWrite() to make it clearer which operations require write access and to maintain consistency with the other storage helper functions."
},
{
"commit": "3014b05dabaa66fbb3ccfba89c79cca49905a695",
"date": "2018-09-16 13:41:49 -0400",
"subject": "Fix buffer underrun in configuration test harness.",
"body": "If the total bytes read from the expect log file was 0 then the last byte of whatever was in memory before harnessLogBuffer would be set to 0.\n\nOn 32-bit systems this expressed as the high order byte of a pointer being cleared and wackiness (in the form of segfaults) ensued."
},
{
"commit": "0c02481d6e5cb7c85cd7caf770d06820137f27b4",
"date": "2018-09-15 21:07:00 -0400",
"subject": "Update all interfaces to use variable parameter constructors.",
"body": "Fixed parameter constructors made adding new interface functions a burden, so we switched to using structs to define interfaces in the storage module at c49eaec7.\n\nWhile propagating this pattern to the IO interfaces it became obvious that the existing variable parameter function pattern (begun in the storage module) was more succinct and consistent with the existing code.\n\nSo, use variable parameter functions to define all interfaces. This assumes that the non-interface parameters will be fixed, which seems reasonable for low-level code."
},
{
"commit": "f0ed89f21fe2ae6278e64395f4191519807e529b",
"date": "2018-09-15 13:27:06 -0400",
"subject": "Allow C or Perl coverage to run on more than one VM.",
"body": "C or Perl coverage tests can now be run on any VM provided a recent enough version of Devel::Cover or lcov is available.\n\nFor now, leave u18 as the only VM to run coverage tests due to some issues with older versions of lcov."
},
{
"commit": "31cdd9d20b114f5c71c585a6effc4e71fae0d9c2",
"date": "2018-09-15 08:23:55 -0400",
"subject": "Remove compiler warnings that are not valid for u16."
},
{
"commit": "c49eaec776014806af194e7a2d9e88691f361f99",
"date": "2018-09-14 16:08:33 -0400",
"subject": "Full abstraction of storage driver interface.",
"body": "The external storage interfaces (Storage, StorageFileRead, etc.) have been stable for a while, but internally they were calling the posix driver functions directly.\n\nCreate driver interfaces for storage, fileRead, and fileWrite and remove all references to the posix driver outside storage/driver/posix (with the exception of a direct call to pathRemove() in Perl LibC).\n\nPosix is still the only available driver so more adjustment may be needed, but this should represent the bulk of the changes."
},
{
"commit": "aeb1fa3dfbf4a4b7384f8f2bc5a18a23e741396e",
"date": "2018-09-13 19:12:40 -0400",
"subject": "Don't perform valgrind when requested.",
"body": "The --no-valgrind flag was not being honored. It's not clear if this flag ever worked, but it does now."
},
{
"commit": "fd14ceb3995fca731141f09f7c940819138c63a2",
"date": "2018-09-13 18:58:22 -0400",
"subject": "Rename posix driver files/functions for consistency.",
"body": "The posix driver was developed over time and the naming is not very consistent.\n\nRename the files and functions to work well with other drivers and generally favor longer names since the driver functions are seldom (eventually never) used outside the driver itself."
},
{
"commit": "ab1762663cdcc3564113c5524dc384991228c0a4",
"date": "2018-09-13 17:53:48 -0400",
"subject": "Don't use negations in objects below Storage.",
"body": "The Storage object represents some some optional parameters as negated if the default is true. This allows sensible defaults without having to specify most optional parameters.\n\nHowever, there's no need to propagate this down to functions that require all parameters to be passed -- it makes the code and logging more confusing. Rename the parameters and update logic to remove negations."
},
{
"commit": "1fb9fe7026f355f86c44fac375a370458c10fc99",
"date": "2018-09-12 18:14:23 -0400",
"subject": "Update comments missed in 5aa458ff."
},
{
"commit": "5aa458ffaecc42cbf6ee37ee4f985d255e31443e",
"date": "2018-09-11 18:32:56 -0400",
"subject": "Simplify debug logging by allowing log functions to return String objects.",
"body": "Previously, debug log functions had to handle NULLs and truncate output to the available buffer size. This was verbose for both coding and testing.\n\nInstead, create a function/macro combination that allows log functions to return a simple String object. The wrapper function takes care of the memory context, handles NULLs, and truncates the log string based on the available buffer size."
},
{
"commit": "9b9396c7b7745cc4c765285e24ed131e7f72f343",
"date": "2018-09-11 15:42:31 -0400",
"subject": "Migrate local, unencrypted, non-S3 archive-get command to C.",
"body": "The archive-get command will only be executed in C if the repository is local, unencrypted, and type posix or cifs. Admittedly a limited use case, but this is just the first step in migrating the archive-get command entirely into C.\n\nThis is a direct migration from the Perl code (including messages) to integrate as seamlessly with the remaining Perl code as possible. It should not be possible to determine if the C version is running unless debug-level logging is enabled."
},
{
"commit": "787e7c295ff64b7f862693784fa901d8b046a3d4",
"date": "2018-09-11 14:43:16 -0400",
"subject": "Change locking around async process forking to be more test friendly.",
"body": "The lock is now released before the fork and reacquired after the fork so the parent process no longer needs to worry about clearing the lock.\n\nThis is the same locking mechanism that will be used once archive-get-async is exec'd as a separate command, so introduce it now to simplify testing."
},
{
"commit": "9e574a37dc4a5c03155a00673a944c2da0a51528",
"date": "2018-09-11 12:30:48 -0400",
"subject": "Make archive-get info messages consistent between C and Perl implementations.",
"body": "The info messages were spread around and logged differently based on the execution path and in some cases logged nothing at all.\n\nTemporarily track the async server status with a flag so that info messages are not output in the async process. The async process will be refactored as a separate command to be exec'd in a future commit."
},
{
"commit": "6c1d48b0186f4df40787349d37b35d822e043289",
"date": "2018-09-11 10:55:55 -0400",
"subject": "Command-line help update missed in cabb3f857."
},
{
"commit": "cabb3f8577d6de2a6fec7b6e78e68671fc39a65b",
"date": "2018-09-10 13:33:39 -0400",
"subject": "List allowable values for the buffer-size option in the configuration reference.",
"body": "Contributed by Cynthia Shang.\nSuggested by Stéphane Schildknecht."
},
{
"commit": "e351b8c67ca16f4210449c9d51916db1b3ad2416",
"date": "2018-09-10 13:09:45 -0400",
"subject": "Improve info command to display the stanza cipher type.",
"body": "Contributed by Cynthia Shang.\nSuggested by Douglas J Hunley."
},
{
"commit": "c688bc86276fcc43bf53747ebbf3259bb8d5a62b",
"date": "2018-09-10 10:54:34 -0400",
"subject": "Improve support for special characters in filenames.",
"body": "% characters caused issues in backup/restore due to filenames being appended directly into a format string.\n\nReserved XML characters (<>&') caused issues in the S3 driver due to improper escaping.\n\nAdd a file with all common special characters to regression testing."
},
{
"commit": "80ef6fce7529c5f9b8309ac0b8451ddce2a08e2b",
"date": "2018-09-10 10:47:00 -0400",
"subject": "Fix missing URI encoding in S3 driver.",
"body": "File names with uncommon characters (e.g. @) caused authentication failures due to S3 encoding them correctly while the S3 driver did not."
},
{
"commit": "f7fc8422f780d18d045f42124dc40aa0920fe416",
"date": "2018-09-07 16:50:01 -0700",
"subject": "Make Valgrind return an error even when a non-fatal issue is detected.",
"body": "By default Valgrind does not exit with an error code when a non-fatal error is detected, e.g. unfreed memory. Use the --error-exitcode option to enabled this behavior.\n\nUpdate some minor issues discovered in the tests as a result. Luckily, no issues were missed in the core code."
},
{
"commit": "faaa9a91fda78f8e38d0a479675f08a5b17a7302",
"date": "2018-09-07 08:03:56 -0700",
"subject": "Fix typo in unit test error messages, EXECTED => EXPECTED."
},
{
"commit": "6e9b6fdca919b9f6fe2bfdb88447ee1f4f7abea7",
"date": "2018-09-07 08:03:05 -0700",
"subject": "Migrate control functions to detect stop files to C from Perl.",
"body": "Basic functions to detect the presence of stanza or all stop files and error when they are present.\n\nThe functionality to detect stop files without error was not migrated. This functionality is only used by stanza-delete and will be migrated with that command."
},
{
"commit": "5bdaa35fa5fea30bf7cdf10a5077cb3b661aa3db",
"date": "2018-09-07 08:00:18 -0700",
"subject": "Migrate walIsPartial(), walIsSegment(), and walSegmentFind() from Perl to C.",
"body": "Also refactor regular expression defines to make them more reusable."
},
{
"commit": "96600760930d1713645ffab211d98d2314818432",
"date": "2018-09-07 07:58:08 -0700",
"subject": "Add helper for repository storage.",
"body": "Implement rules for generating paths within the archive part of the repository. Add a helper function, storageRepo(), to create the repository storage based on configuration settings.\n\nThe repository storage helper is located in the protocol module because it will support remote file systems in the future, just as the Perl version does.\n\nAlso, improve the existing helper functions a bit using string functions that were not available when they were written."
},
{
"commit": "960ad73298fa9c3b9ea60b24428a10ede9a58828",
"date": "2018-09-06 10:12:14 -0700",
"subject": "Info objects now parse JSON and use specified storage.",
"body": "Use JSON code now that it is available and remove temporary hacks used to get things working initially.\n\nUse passed storage objects rather than using storageLocal(). All storage objects in C are still local but this won't always be the case.\n\nAlso, move Postgres version conversion functions to postgres/info.c since they have no dependency on the info objects and will likely be useful elsewhere."
},
{
"commit": "de1b74da0cf9c4f182e3a4cde52d0b5163111a44",
"date": "2018-09-06 09:35:34 -0700",
"subject": "Move encryption in mock/archive tests to remote tests.",
"body": "The new archive-get C code can't run (yet) when encryption is enabled. Therefore move the encryption tests so we can test the new C code. We'll move it back when encryption is enabled in C.\n\nAlso, push one WAL segment with compression to test decompression in the C code."
},
{
"commit": "6361a061812b20efeb89db110ebd592a0d52404f",
"date": "2018-09-04 21:46:41 -0400",
"subject": "Fix incorrectly reported error return in info logging.",
"body": "A return code of 1 from the archive-get was being logged as an error message at info level but otherwise worked correctly.\n\nAlso improve info messages when an archive segment is or is not found."
},
{
"commit": "800afeef70464da57af023614b1dfeecce5e112c",
"date": "2018-09-04 17:47:23 -0400",
"subject": "Posix file functions now differentiate between open and missing errors.",
"body": "The Perl functions do so and the integration tests rely on checking for these errors. This has been exposed as more functionality is moved into C.\n\nPassing the errors types is now a bit complicated so instead use a flag to determine which errors to throw."
},
{
"commit": "375ff9f9d283842da3620f22c9c5bdb61249ae9e",
"date": "2018-08-31 16:06:40 -0400",
"subject": "Ignore all files in a linked tablespace directory except the subdirectory for the current version of PostgreSQL.",
"body": "Previously an error would be generated if other files were present and not owned by the PostgreSQL user. This hasn't been a big deal in practice but it could cause issues.\n\nAlso add tests to make sure the same logic applies with links to files, i.e. all other files in the directory should be ignored. This was actually working correctly, but there were no tests for it before."
},
{
"commit": "41746b53cd91c0d7203d855f9186c685ea59af47",
"date": "2018-08-31 14:24:36 -0400",
"subject": "Begin v2.06 development."
},
{
"commit": "bc7462d86d3529712cf7c196a04f7d6f8dd8ee34",
"date": "2018-08-31 13:19:43 -0400",
"subject": "v2.05: Environment Variable Options and Exclude Temporary/Unlogged Relations"
},
{
"commit": "d41570c37a2820380fa1708f31ed21c09e4065f8",
"date": "2018-08-31 11:31:13 -0400",
"subject": "Improve log file names for remote processes started by locals.",
"body": "The log-subprocess feature added in 22765670 failed to take into account the naming for remote processes spawned by local processes. Not only was the local command used for the naming of log files but the process id was not pass through. This meant every remote log was named \"[stanza]-local-remote-000\" which is confusing and meant multiple processes were writing to the same log.\n\nInstead, pass the real command and process id to the remote. This required a minor change in locking to ignore locks if process id is greater than 0 since remotes started by locals never lock."
},
{
"commit": "c2d0a21d63a3c76bf513ac79c622e694ca9dfe1d",
"date": "2018-08-30 18:44:40 -0400",
"subject": "Allow secrets to be passed via environment variables.",
"body": "When environment variables were added in d0b9f986 they were classified as cfgSourceParam, but one of the restrictions on this type is that they can't pass secrets because they might be exposed in the process list.\n\nThe solution is to reclassify environment variables as cfgSourceConfig. This allows them to handle secrets because they will not pass values to subprocesses as parameters. Instead, each subprocess is expected to check the environment directly during configuration parsing.\n\nIn passing, move the error about secrets being passed on the command-line up to command-line parsing and make the error more generic with respect to the configuration file now that multiple configuration files are allowed."
},
{
"commit": "70514061fdca620ba99dd0e36bb99dccbca43e1d",
"date": "2018-08-30 16:27:36 -0400",
"subject": "Fix issue where relative links in $PGDATA could be stored in the backup with the wrong path.",
"body": "Relative link paths were being combined with the paths of previous links (relative or absolute) due to the $strPath variable being modified in the current iteration rather than simply being passed to the next level of recursion.\n\nThis issue did not affect absolute links and relative tablespace links were caught by other checks, though the error was confusing."
},
{
"commit": "1631f8b3cebbe761f5eb71c9b7203664f2ae5005",
"date": "2018-08-29 16:45:58 -0500",
"subject": "Embedded documentation update missed in c6384904."
},
{
"commit": "c6384904512363baaa8c6dbec42799c0ddb1d4db",
"date": "2018-08-28 16:49:29 -0400",
"subject": "Documentation updates for exclude feature based on review.",
"body": "Reviewed by Cynthia Shang."
},
{
"commit": "14cde54b37bec6ac831a2ddc870531bd61b034dd",
"date": "2018-08-28 16:27:10 -0400",
"subject": "Limit manifest build recursion (i.e. links followed) to sixteen levels to detect link loops."
},
{
"commit": "a6cecf7d5ef722bc962a1e6a3808dce3424ca710",
"date": "2018-08-28 16:22:30 -0400",
"subject": "Prevent manifest from being built more than once."
},
{
"commit": "4498f726a59132421f8a1530783f8bb6cc8905c3",
"date": "2018-08-28 16:04:53 -0400",
"subject": "Improve asynchronous archive-get/archive-push performance by directly checking status files.",
"body": "Prior to this commit, an expression was used to search the spool directory for ok/error files for a specific WAL segment. This involved setting up a regular expression and using opendir/readdir.\n\nInstead, directly probe for the status files, checking directly if a '.ok' or '.error' file exists, avoiding the regular expression and eliminating the directory scan.\n\nOnly the two files now probed for could have ever matched the regular expression which had been provided and it's unlikely that many more additional files will be added, so this is a good improvement, and optimization, with little downside."
},
{
"commit": "bef58a79743d3273d14de221e26291a5d90409b3",
"date": "2018-08-27 15:51:05 -0400",
"subject": "Allow arbitrary directories and/or files to be excluded from a backup.",
"body": "Misuse of this feature can lead to inconsistent backups so read the --exclude documentation carefully before using."
},
{
"commit": "77dca5b96817d0e0d49e34fb7d8e0944e60f71a8",
"date": "2018-08-24 19:31:45 -0400",
"subject": "Allow command/option constants to autonumber in both C and Perl to reduce churn when a new command/option is added."
},
{
"commit": "4c3cf435c036037ff32b7a76e53753e765358173",
"date": "2018-08-24 17:08:00 -0400",
"subject": "Add cvtZToUInt() to convert string to unsigned int."
},
{
"commit": "eb30d88b6a6048353b269d590c43fad9e6233a25",
"date": "2018-08-24 16:50:33 -0400",
"subject": "Allow zero-size files in backup manifest to reference a prior manifest regardless of timestamp delta.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "0ed37ab9e73fb59a5558b39bb292e0eb4f331ec9",
"date": "2018-08-24 12:13:10 -0400",
"subject": "Update Archive::Info->archiveIdList() to return a valid error code instead of unknown."
},
{
"commit": "22765670270067c5102a2ab9b3277d4cbc86c6af",
"date": "2018-08-22 20:05:49 -0400",
"subject": "Add log-subprocess option to allow file logging for local and remote subprocesses."
},
{
"commit": "512da125ad7314d2d58931186316423f039c8c35",
"date": "2018-08-22 19:03:13 -0400",
"subject": "Improve error reporting for TEST_ASSIGN() and TEST_RESULT_VOID() macros."
},
{
"commit": "ad989068d283a99a8aaf20be2eb0337a47bb8f73",
"date": "2018-08-22 16:45:25 -0400",
"subject": "Fix issue when a boolean option (e.g. delta) was specified more than once.",
"body": "Reported by Yogesh Sharma."
},
{
"commit": "8a8738308c08ec9ac7a12b08f2ab7358dc4aa3af",
"date": "2018-08-22 14:48:37 -0400",
"subject": "Enable -Wvla."
},
{
"commit": "de5614db6b027900ef48f4ade456643cfecad79c",
"date": "2018-08-15 14:05:39 -0400",
"subject": "PostgreSQL 11 Beta 3 support."
},
{
"commit": "d0b9f986a0eb30c550b2dc9031ad10dda941a26c",
"date": "2018-08-15 10:52:53 -0400",
"subject": "Allow any option to be set in an environment variable.",
"body": "This includes options that previously could only be specified on the command line, e.g. stanza."
},
{
"commit": "4a822d3032389543d2bb53018cff9062155cd3f9",
"date": "2018-08-15 10:32:18 -0400",
"subject": "Correct OptionInvalidError to OptionInvalidValueError in boolean option parsing."
},
{
"commit": "238e5dae3c12ff37b3873e5db5a9c1cff3bed64f",
"date": "2018-08-14 17:17:14 -0400",
"subject": "Allow resolve array from cd5df357 to autosize to detect short arrays in testing."
},
{
"commit": "cb4b715533c1a566add50cb3e245cd2a65fba5fa",
"date": "2018-08-14 16:49:38 -0400",
"subject": "Add strReplaceChr() to String object."
},
{
"commit": "4a176681c3d7767c1f5cb98d1d5e46b7adb3f76b",
"date": "2018-08-14 16:18:17 -0400",
"subject": "Add cvtCharToZ() and macro for debugging char params."
},
{
"commit": "9e3273fdf91e31d6f13ecd12658fa624dfbf4f3d",
"date": "2018-08-14 16:08:58 -0400",
"subject": "Define cipher magic size with sizeof() rather than using a constant."
},
{
"commit": "6643afe9a86bf617d2e90687130248c4a6ee6c14",
"date": "2018-08-14 14:56:59 -0400",
"subject": "Add gzip compression/decompression filters for C."
},
{
"commit": "e3ff6b209d9cf50f88f51a70ac7247949b63ac55",
"date": "2018-08-14 14:21:53 -0400",
"subject": "Filters can now produce output that differs from input.",
"body": "This allows filters such as compression, encryption, etc. to be implemented."
},
{
"commit": "a45d1b4a60545940a6a5eac37cf16473b97d2c41",
"date": "2018-08-14 13:38:11 -0400",
"subject": "Update to command-line docs missed in 40924e8f."
},
{
"commit": "40924e8f5c84cfdac7eadde4b6cca092f3900430",
"date": "2018-08-13 07:47:26 -0400",
"subject": "Fix invalid log level in log-path option reference.",
"body": "Reported by Camilo Aguilar."
},
{
"commit": "343424009795014bce2474f46762d76cc9ec4ef7",
"date": "2018-08-12 19:24:21 -0400",
"subject": "Remove incompletely implemented online option from the check command.",
"body": "Offline operation runs counter to the purpose of this command, which is to check if archiving and backups are working correctly."
},
{
"commit": "cb6821e8533a9ff3c4e3727746bd1d259255d86a",
"date": "2018-08-12 18:19:34 -0400",
"subject": "Stop trying to arrange contributors in release.xml by last/first name.",
"body": "Contributor names have always been presented in the release notes exactly as given, but we tried to assign internal IDs based on last/first name which can be hard to determine and ultimately doesn't make sense.\n\nInspired by Christophe Pettus' PostgresOpen 2017 talk, \"Human Beings Do Not Have a Primary Key\"."
},
{
"commit": "cd5df3570b0fcd5011e2339b48a3359a1f2c54da",
"date": "2018-08-11 12:55:33 -0400",
"subject": "Validate configuration options in a single pass.",
"body": "By pre-calculating and storing the option dependencies in parse.auto.c validation can be completed in a single pass, which is both simpler and faster."
},
{
"commit": "f06bf9e8329fcb083271fab8d7aeccad1122a5b1",
"date": "2018-08-11 09:47:07 -0400",
"subject": "Improve error message when a command is missing the stanza option.",
"body": "Suggested by Sarah Conway."
},
{
"commit": "8ab2e72960de60557331fe7087015519a516f318",
"date": "2018-08-09 08:57:21 -0400",
"subject": "Migrate minimum set of code for reading archive.info files from Perl to C.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "7993f1a96620ac6c00ba961036ba5ff6abc58f22",
"date": "2018-08-09 08:06:23 -0400",
"subject": "Add basic C JSON parser."
},
{
"commit": "31167d8f987cf171bd655c5ccb1bebebac9d7997",
"date": "2018-08-05 08:35:18 -0400",
"subject": "Enable -Wduplicated-branches, and -Wduplicated-cond."
},
{
"commit": "14f21a8f6c0f1bec4c4af82af51235ddf8617beb",
"date": "2018-08-04 19:37:28 -0400",
"subject": "Enable -Wpointer-arith."
},
{
"commit": "429a356e3323acf99f3d73a527baf7aaa55a3b5b",
"date": "2018-08-03 19:19:14 -0400",
"subject": "Enable -Wstrict-prototypes and update all void functions to conform."
},
{
"commit": "bec4c176dc478d5eff855c18ba05d4a8301f0b22",
"date": "2018-07-30 18:53:34 -0400",
"subject": "Exclude temporary and unlogged relation (table/index) files from backup.",
"body": "Implemented using the same logic as the patches adding this feature to PostgreSQL, 8694cc96 and 920a5e50. Temporary relation exclusion is enabled in PostgreSQL ≥ 9.0. Unlogged relation exclusion is enabled in PostgreSQL ≥ 9.1, where the feature was introduced."
},
{
"commit": "ac16cb7ff16b58c9de4ba9c27d5322b69639594e",
"date": "2018-07-28 09:39:52 -0400",
"subject": "Add cvtBoolToConstZ() to simplify conversion of boolean to string."
},
{
"commit": "7a00bbebfafc94f17b7897b2074cfd079e6882b6",
"date": "2018-07-28 09:04:06 -0400",
"subject": "Do nothing in memContextMove() when the context is already in the specified parent."
},
{
"commit": "cb975a533095f863232843cac1b3831f24a8fe3c",
"date": "2018-07-28 08:43:58 -0400",
"subject": "Remove redundant lines from embedded Perl by combining blank lines."
},
{
"commit": "666537cbdee986ebdc323f6c9d412edf2a5c7145",
"date": "2018-07-28 08:13:30 -0400",
"subject": "Update code count for new file types and exclusions."
},
{
"commit": "01aea0c067c2e667c47346620c563218f4c0f568",
"date": "2018-07-24 21:08:27 -0400",
"subject": "Implement filters that do not modify the buffer.",
"body": "Update cryptoHash to use the new interface."
},
{
"commit": "8e1017c1622bed5ebddc910545cbcaf288dd2f2f",
"date": "2018-07-23 07:59:24 -0400",
"subject": "Move most host setup to containers defined in the documentation.",
"body": "This includes PostgreSQL installation which had previously been included in the documentation. This way produces faster builds and there is no need for us to document PostgreSQL installation."
},
{
"commit": "27238310322096a52f1babf478cd4fffb344d949",
"date": "2018-07-23 07:49:15 -0400",
"subject": "Allow containers to be defined in a document.",
"body": "The defined containers are built before the document build begins which allows them to be reused."
},
{
"commit": "ae72772e5b366f02f8a5026e3109cfd43aacb8f4",
"date": "2018-07-23 07:17:24 -0400",
"subject": "Fix typo in 18626306."
},
{
"commit": "1862630629bdf435a76575a31ed722cc351def11",
"date": "2018-07-21 17:02:42 -0400",
"subject": "Use pre-built images from Docker Hub when the container definition has not changed.",
"body": "Downloading an image is quite a bit faster than building a new image from scratch and saves minutes per test run in CI."
},
{
"commit": "8568622a6f5941cbe9e0ef40ea9f605b62675838",
"date": "2018-07-20 19:03:46 -0400",
"subject": "Add --log-level-test option.",
"body": "This allows setting the test log level independently from the general test harness setting, but current only works for the C tests. It is useful for seeing log output from functions on the console while a test is running."
},
{
"commit": "58e9f1e50cfbc2df22af17293fe8a298cac5513a",
"date": "2018-07-20 18:51:42 -0400",
"subject": "Refactor the common/log tests to not depend on common/harnessLog.",
"body": "common/harnessLog was not ideally suited for general testing and made all the tests quite awkward. Instead, move all code used to test the common/log module into the logTest module and repurpose common/harnessLog to do log expect testing for all other tests in a cleaner way.\n\nAdd a few exceptions for config testing since the log levels are reset by default in config/parse."
},
{
"commit": "1359e2908c777ef7b8cb128f7d7ede3b53bc2018",
"date": "2018-07-20 08:11:34 -0400",
"subject": "Fix issue where errors raised in C were not logged when called from Perl.",
"body": "pgBackRest properly terminated with the correct error code but lacked an error message to aid in debugging."
},
{
"commit": "d3cfeebdf91a559a0af80bba5fc424f4d091b944",
"date": "2018-07-20 08:03:44 -0400",
"subject": "Rename error-handling variables in Main.pm to conform to standard."
},
{
"commit": "fa53e2eddb95822553b6a860ef3e6d09fdb31f4a",
"date": "2018-07-20 07:15:28 -0400",
"subject": "Show exact log level required for stack trace param output instead of just \"debug\"."
},
{
"commit": "0ac176b722fe93301ec9f4d706698f0f01125666",
"date": "2018-07-19 16:04:20 -0400",
"subject": "Abstract IO layer out of the storage layer.",
"body": "This allows the routines to be used for IO objects that do not have a storage representation.\n\nImplement buffer read and write IO objects."
},
{
"commit": "5dc8a2ec08ee7569063915c7a1b3399ac1f2d16c",
"date": "2018-07-17 19:01:54 -0400",
"subject": "storageFileRead() accepts a buffer for output rather than creating one.",
"body": "This is more efficient overall and allows the caller to specify how many bytes will be read on each call. Reads are appended if the buffer already contains data but the buffer size will never increase.\n\nAllow Buffer object \"used size\" to be different than \"allocated size\". Add functions to manage used size and remaining size and update automatically when possible."
},
{
"commit": "0acf70541601d99795f6da06ebca030eff69cd46",
"date": "2018-07-16 17:25:15 -0400",
"subject": "Require PostgreSQL catalog version when instantiating a Manifest object (and not loading it from disk).",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "4e38cbaea9fdfbc8618971c5148ffd0a7e7ef4ab",
"date": "2018-07-12 15:28:46 -0400",
"subject": "Add iniSectionList() to Ini object and remove dead code.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "0e6b927a172368a77473571d8c27265253894c0e",
"date": "2018-07-12 15:23:18 -0400",
"subject": "Add uint64 variant type and supporting conversion functions.",
"body": "Contributed by Cynthia Shang.\nReviewed by Stephen Frost."
},
{
"commit": "0e331b12ba0cf377e4292a89ae84de7bb74281d6",
"date": "2018-07-12 15:15:32 -0400",
"subject": "Improve performance of string to int conversion.",
"body": "Use strtoll() instead of sprintf() for conversion. Also use available integer min/max constants rather than hard-coded values.\n\nReviewed by Stephen Frost.\nSuggested by Stephen Frost."
},
{
"commit": "cf889790e60972adcacc6e21fa3853378676889a",
"date": "2018-07-10 15:39:03 -0400",
"subject": "Error if LibC build is performed outside the test environment.",
"body": "LibC is no longer required for production builds."
},
{
"commit": "b1bc53657d9e683f30bdfcce190da286a383328f",
"date": "2018-07-09 08:15:16 -0400",
"subject": "Begin v2.05 development."
},
{
"commit": "a8143ec1253f3d9187c053def0b8c515d4f13fd5",
"date": "2018-07-05 20:16:41 -0400",
"subject": "v2.04: Critical Bug Fix for Backup Resume"
},
{
"commit": "6f6dad6dd5fb0f2ba5824b1812e71abf047704a4",
"date": "2018-07-05 16:49:46 -0400",
"subject": "Remove call to lscpu which can vary widely by build host."
},
{
"commit": "22adb395db804e03646fc53d84b6e7935c38c46e",
"date": "2018-07-05 15:40:50 -0400",
"subject": "Add zero-length file to mock/all test."
},
{
"commit": "db17973cd0a8a5692e408621703fd83fbce40166",
"date": "2018-07-03 14:01:57 -0400",
"subject": "Fix critical bug in resume that resulted in inconsistent backups.",
"body": "A regression in v0.82 removed the timestamp comparison when deciding which files from the aborted backup to keep on resume. All resumed backups should be considered inconsistent. A resumed backup can be identified by checking the log for the message \"aborted backup of same type exists, will be cleaned to remove invalid files and resumed\"."
},
{
"commit": "3d07e01fe920bef0d4848ddd55560dc13e38ef85",
"date": "2018-07-01 20:02:37 -0400",
"subject": "Make ls ordering deterministic in mock/all test."
},
{
"commit": "1bd98b61df7aeaec25b6d6b5baa71f8a458784ee",
"date": "2018-07-01 08:17:27 -0400",
"subject": "Fix non-compliant ISO-8601 timestamp format in S3 authorization headers.",
"body": "AWS and some gateways were tolerant of space rather than zero-padded hours while others were not.\n\nFixed by Andrew Schwartz."
},
{
"commit": "7e65ddad34db74a14e54aab125f0e62596268f6e",
"date": "2018-06-30 14:55:25 -0400",
"subject": "PostgreSQL 11 Beta 2 support."
},
{
"commit": "7b0e65d48823e94a7a17ae377e54a898bb07d7fb",
"date": "2018-06-26 17:27:22 -0400",
"subject": "Improve the HTTP client to set content-length to 0 when not specified by the server.",
"body": "S3 (and gateways) always set content-length or transfer-encoding but HTTP 1.1 does not require it and proxies (e.g. HAProxy) may not include either."
},
{
"commit": "e8c68b9c6657d7fabfd70cbd8ad3778e123bcb41",
"date": "2018-06-26 16:56:05 -0400",
"subject": "Update parameters for VBoxService start."
},
{
"commit": "ead70e16bbead338b7ba14b4a03014187bb80c23",
"date": "2018-06-23 13:09:56 -0400",
"subject": "Add sample S3 policy to restrict bucket privileges.",
"body": "Suggested by Douglas J Hunley, Jason O'Donnell."
},
{
"commit": "aa41e00c9cdbb966a6cda088a21fb16c443163d4",
"date": "2018-06-21 11:39:37 -0400",
"subject": "Set search_path = 'pg_catalog' on PostgreSQL connections.",
"body": "Suggested by Stephen Frost."
},
{
"commit": "7fee739710b052f41ff881b513ae376acb1e5c2a",
"date": "2018-06-20 18:26:53 -0400",
"subject": "Remove Debian package patch since it has been committed upstream."
},
{
"commit": "6084e9be04dd958f8ab8906c1af8e3ed1fca4994",
"date": "2018-06-16 13:07:01 -0400",
"subject": "Fix default location of pgbackrest.conf in option reference."
},
{
"commit": "1a0d56860059e7f9998e1faf5d384017ca1511ee",
"date": "2018-06-14 19:05:35 -0400",
"subject": "Preliminary documentation for PostgreSQL 11 unprivileged user backup."
},
{
"commit": "3793ae1e4f0a4deeb156fa3d0ace4ddab0b85804",
"date": "2018-06-14 17:59:10 -0400",
"subject": "Convert the not very portable uint type to unsigned int.",
"body": "Suggested by Devrim Gündüz."
},
{
"commit": "4e7692b74d229538fdde123a6020258a9ff5f8f3",
"date": "2018-06-14 17:44:44 -0400",
"subject": "Fix error in selective restore when only one user database exists in the cluster.",
"body": "Fixed by Cynthia Shang.\nReported by Nj Baliyan."
},
{
"commit": "fbd1da05230bb4790f143443dd515453fada0bba",
"date": "2018-06-13 13:43:17 -0400",
"subject": "Create a new section to describe building pgBackRest and build on a separate host."
},
{
"commit": "d55e609959547750116be2954f956e7e918013b5",
"date": "2018-06-12 13:43:15 -0400",
"subject": "Use a prebuilt s3 server container for documentation and tests."
},
{
"commit": "350b30fa4977e23b205e05b787d707eaceb5a67f",
"date": "2018-06-11 14:52:26 -0400",
"subject": "Move cryptographic hash functions to C using OpenSSL."
},
{
"commit": "064ec757e9da187ff4a6dad481dc32775454dee3",
"date": "2018-06-11 10:53:16 -0400",
"subject": "Rename cipher module to the more general crypto."
},
{
"commit": "835396751f220be3f8e46f344d4eadfd7b7305b3",
"date": "2018-06-10 14:13:56 -0400",
"subject": "Document generator improvements.",
"body": "* Build containers from scratch for more accurate testing.\n* Allow environment load to be skipped.\n* Allow bash wrapping to be skipped.\n* Allow forcing a command to run as a user without sudo."
},
{
"commit": "5c0099781d170409a0121355fb8b4917ca06ac0a",
"date": "2018-06-06 22:19:01 -0400",
"subject": "Update Debian package to add debug symbols to pgBackRest executable."
},
{
"commit": "a385cb520b02c8e216bde78de51e57c216534778",
"date": "2018-06-06 15:52:28 -0400",
"subject": "Update primary test environment (Vagrant and Docker) to Ubuntu 18.04."
},
{
"commit": "d309a85b51d732cb983ea781b69a9a1d2d4a1831",
"date": "2018-06-05 08:59:17 -0400",
"subject": "PostgreSQL 11 Beta 1 support."
},
{
"commit": "e57840d739e12aec86fb4772044e0d722f1d9dd6",
"date": "2018-05-25 13:42:09 -0400",
"subject": "Document generator improvements.",
"body": "* Allow parameters to be passed when a container is created.\n* Allow /etc/hosts update to be skipped (for containers without bash)."
},
{
"commit": "40093f160cf891c9bb522f4da1f0414aeacbc3e5",
"date": "2018-05-24 14:01:24 -0400",
"subject": "Improve efficiency of C library builds now that they are used only for testing."
},
{
"commit": "915b09635a5300f1cb45506c5237c3b883b5a85a",
"date": "2018-05-24 11:00:47 -0400",
"subject": "Remove RHEL package patch since it has been committed upstream."
},
{
"commit": "8eb9921c7ca3d3aaacf1894756be02cbe7d17e18",
"date": "2018-05-23 14:57:08 -0400",
"subject": "Auto-generate Makefile with dependencies."
},
{
"commit": "2f6017511fda3c6aeb67c3daafcc6c1dc35b2dd4",
"date": "2018-05-23 09:45:08 -0400",
"subject": "Split log levels into separate header file.",
"body": "Many modules that use debug.h do not need to do logging so this reduces dependencies for those modules."
},
{
"commit": "dfa92b359deddb37b10db5e1bac47750d8d1011c",
"date": "2018-05-23 09:10:14 -0400",
"subject": "Begin v2.04 development."
},
{
"commit": "f7123c1bbf239814b33ddc97e53b472cf0e69d16",
"date": "2018-05-22 19:53:25 -0400",
"subject": "v2.03: Single Executable to Deploy"
},
{
"commit": "4c7408ea52af7f8faec5244c65a55440643616eb",
"date": "2018-05-22 12:53:08 -0400",
"subject": "Embed exported C functions and Perl modules directly into the pgBackRest executable."
},
{
"commit": "ada5c5c0d96e63f9f13009b6b0818457b49c6591",
"date": "2018-05-21 10:46:45 -0400",
"subject": "Fix archive write lock being taken for the synchronous archive-get command.",
"body": "Reported by Uspen."
},
{
"commit": "e69d5fbf624bbab45dcc820798284244fecd18c3",
"date": "2018-05-21 08:06:31 -0400",
"subject": "Fix potential buffer overrun in error message handling.",
"body": "Reported by Lætitia."
},
{
"commit": "72a9684d4e9dc15f7252b259dafb35a310fe2cd6",
"date": "2018-05-18 12:03:39 -0400",
"subject": "Print total runtime in milliseconds at command end."
},
{
"commit": "52bc07323407668f49282d011b710f85fc9b11b6",
"date": "2018-05-18 11:57:32 -0400",
"subject": "Add stack trace macros to all functions.",
"body": "Low-level functions only include stack trace in test builds while higher-level functions ship with stack trace built-in. Stack traces include all parameters passed to the function but production builds only create the parameter list when the log level is set high enough, i.e. debug or trace depending on the function."
},
{
"commit": "abb9651f4c58446bbcf3f2013d075157a20beed5",
"date": "2018-05-18 06:45:14 -0400",
"subject": "Test harness improvements.",
"body": "* Allow more than one test to provide coverage for the same module.\n* Add option to disable valgrind.\n* Add option to disabled coverage.\n* Add option to disable debug build.\n* Add option to disable compiler optimization.\n* Add --dev-test mode."
},
{
"commit": "bce3d0fe1c96c0204fffd38145e4ddd56362a837",
"date": "2018-05-17 17:09:06 -0400",
"subject": "Build libc using links rather than referencing the C files in src directly.",
"body": "The C library builds with different options which should not be reused for the C binary or vice versa."
},
{
"commit": "91be372e6ac1601249df05e334ee93ba5540633c",
"date": "2018-05-11 11:24:38 -0400",
"subject": "Set log-timestamp=n for integration tests.",
"body": "This means less filtering of logs needs to be done and new timestamps can be added without adding new filters."
},
{
"commit": "a1be8e16cdfd364591c3a7104b1cc30084b13a08",
"date": "2018-05-11 10:39:36 -0400",
"subject": "Update SSL error message test on CentOS 7."
},
{
"commit": "4b4af1cbfc0859a3db2981229e864853a38722bb",
"date": "2018-05-09 11:14:35 -0400",
"subject": "Use time_t instead of __time_t for better portability.",
"body": "Suggested by Nick Floersch."
},
{
"commit": "a9069f3fd3236d020c589265117817d3fddc6a5d",
"date": "2018-05-09 10:50:05 -0400",
"subject": "Begin v2.03 development."
},
{
"commit": "ee8aafb3cadd77682c97bcc74adb457e0723ebee",
"date": "2018-05-06 19:53:42 -0400",
"subject": "v2.02: Parallel Asynchronous Archive Get and Configuration Includes"
},
{
"commit": "4d6a51ac47e168811531cb4d388f0dde2b89cbcd",
"date": "2018-05-06 08:56:42 -0400",
"subject": "Add HARNESS_FORK for tests that require fork().",
"body": "A standard pattern for tests makes fork() easier to use and should help prevent some common mistakes."
},
{
"commit": "790f7c73128a4b3f0f98600aa7475d88f774fd1b",
"date": "2018-05-05 11:50:11 -0400",
"subject": "Enforce full branch coverage in C code."
},
{
"commit": "0a860e0b6049bd6922a1583ede6748b46cfb9d23",
"date": "2018-05-05 09:38:09 -0400",
"subject": "Full branch coverage for command/help/help, common/error, common/ini, and common/log modules."
},
{
"commit": "90aadc6534be12e8a49d4da5ff231a1f439e378c",
"date": "2018-05-04 12:49:25 -0400",
"subject": "Full branch coverage for config module."
},
{
"commit": "6c3b40152fa88e101564867ed55338bb63eff626",
"date": "2018-05-04 09:21:32 -0400",
"subject": "Improve module branch coverage.",
"body": "Add full branch coverage for cipher/block, command/command, common/wait, and postgres/pageChecksum modules."
},
{
"commit": "c3a8fbe706ed31e2414fa454d6090d0346f34f4a",
"date": "2018-05-03 11:24:29 -0400",
"subject": "Add _FMT variants for all THROW macros so format types are checked by the compiler."
},
{
"commit": "6a40c916d4307c2de79de250ed444237d47e6b7a",
"date": "2018-05-02 14:06:40 -0400",
"subject": "Add repo-s3-token option to allow temporary credentials tokens to be configured.",
"body": "pgBackRest currently has no way to request new credentials so the entire command (e.g. backup, restore) must complete before the credentials expire."
},
{
"commit": "5e090ba30501b76717dcb034420aba06847955f2",
"date": "2018-05-02 12:19:54 -0400",
"subject": "Fix failure in manifest build when two or more files in PGDATA are linked to the same directory.",
"body": "Reported by Vitaliy Kukharik."
},
{
"commit": "6a01db2b3297fc103577b8bd25da011f09fc8a17",
"date": "2018-05-02 12:06:12 -0400",
"subject": "Fix delta restore failing when a linked file is missing."
},
{
"commit": "9d9fad88a25b0f4bafcae1f2e9b1cf81d00b8d9e",
"date": "2018-05-02 07:31:44 -0400",
"subject": "Add example of command section usage to archiving configuration.",
"body": "Suggested by Christophe Courtois."
},
{
"commit": "fd1984239e5d60293b86419d77bcb1c990dbbc7e",
"date": "2018-05-01 14:07:08 -0400",
"subject": "Fix rendering of key/value and list options in help.",
"body": "Reported by Clinton Adams."
},
{
"commit": "1a1ed8d6b9973e069325b1dee7b54c9bbc2740d1",
"date": "2018-05-01 13:20:48 -0400",
"subject": "Update help test to use restore command to provide better coverage."
},
{
"commit": "8dbbf2de929813d5ed2068c13b8cc5b3c3cfafc2",
"date": "2018-05-01 12:37:06 -0400",
"subject": "Fix archive-copy throwing \"path not found\" error for incr/diff backups.",
"body": "Reported by yummyliu, Vitaliy Kukharik."
},
{
"commit": "71ba08f579be228a8975c0a59bd485e5c11bebe5",
"date": "2018-05-01 11:05:37 -0400",
"subject": "Make backup/restore path sync more efficient.",
"body": "Remove recursive path sync functionality since it is no longer used."
},
{
"commit": "54dd6f3ed4fcfeabe0254fdb9d88f560efd5f8ca",
"date": "2018-04-30 17:27:39 -0400",
"subject": "Add asynchronous, parallel archive-get.",
"body": "This feature maintains a queue of WAL segments to help reduce latency when PostgreSQL requests a WAL segment with restore_command."
},
{
"commit": "c48b0a2a1e40764a33b42485a7edf21a544b0db1",
"date": "2018-04-30 08:13:56 -0400",
"subject": "Update docs with 32-bit support and caveats.",
"body": "32-bit support was added in v1.26."
},
{
"commit": "321a28f6b0c6c522b8b8120e9fccfec09de4c6f4",
"date": "2018-04-29 11:47:50 -0400",
"subject": "Add walSegmentNext() and walSegmentRange()."
},
{
"commit": "be02c6750376e9a0312b7c707c5c96025eb1cfa6",
"date": "2018-04-29 11:20:51 -0400",
"subject": "Add pgControlInfo() to read pg_control and determine the PostgreSQL version."
},
{
"commit": "8c6e2bdbc7ac2b0e887d9d30931a532141974821",
"date": "2018-04-29 11:02:21 -0400",
"subject": "Add storageInfo() and track size in read objects."
},
{
"commit": "d74c167420b1c2eba74b29cf13b87f1143951b19",
"date": "2018-04-29 10:41:05 -0400",
"subject": "Add bufNewC() and only reallocate buffer when the size has changed."
},
{
"commit": "d44848baa0cc6583208d1d5ddb2db8cf69b866f3",
"date": "2018-04-29 10:32:46 -0400",
"subject": "Add strLstExists(), strLstExistsZ(), strSub(), and strSubN() to String and StringList objects."
},
{
"commit": "89d3476e325a94cb75457354e26b1ab4f5bcc8b0",
"date": "2018-04-29 10:16:59 -0400",
"subject": "Refactor archive common functions in preparation for parallel async archive-get."
},
{
"commit": "721432f6ae55c2a06d645629703c5103f8d89190",
"date": "2018-04-25 15:46:05 -0400",
"subject": "Update the archive-push-queue-max, manifest-save-threshold, and buffer-size options to accept values in KB, MB, GB, TB, or PB where the multiplier is a power of 1024.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "8eabc52f3b5872c898cc14b2691a01a2559ad6bd",
"date": "2018-04-25 15:16:42 -0400",
"subject": "Add strUpper, strLower, strChr, and strTrunc to String object.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "88a633da17d53261e0131e2d77209f22403112d6",
"date": "2018-04-24 09:12:25 -0400",
"subject": "Divide tests into three types (unit, integration, performance).",
"body": "Many options that were set per test can instead be inferred from the types, i.e. container, c, expect, and individual.\n\nAlso finish renaming Perl unit tests with the -perl suffix."
},
{
"commit": "bb8c315cadc6329a03cd975a6c865b1ce29d751c",
"date": "2018-04-23 17:26:27 -0400",
"subject": "Storage object improvements.",
"body": "* Add storageCopy(), storageMove(), and storagePathSync().\n* Separate StorageFile object into separate read and write objects.\n* Abstract out Posix file read/write objects."
},
{
"commit": "02cc8ccbd45221ef03f30cd6b068fc7675011592",
"date": "2018-04-23 10:24:04 -0400",
"subject": "Add THROWP_* macro variants for error handling.",
"body": "These macros allow an ErrorType pointer to be passed and are required for functions that may return different errors based on a parameter."
},
{
"commit": "18882cb8822ab8af04ff57853c2bc35145cb7b65",
"date": "2018-04-23 10:19:45 -0400",
"subject": "Add bufEq and bufCat to Buffer object."
},
{
"commit": "f146502eae44d7366d79f3d73f695209d3189040",
"date": "2018-04-23 10:10:55 -0400",
"subject": "Add TEST_ERROR_FMT macro to simplify testing of formatted error messages."
},
{
"commit": "27aa5f756e32e8e1713588695b86451fde2e5b02",
"date": "2018-04-19 11:09:39 -0400",
"subject": "Add support for additional pgBackRest configuration files.",
"body": "Configuration files are loaded from the directory specified by the --config-include-path option.\n\nAdd --config-path option for overriding the default base path of the --config and --config-include-path option."
},
{
"commit": "79b7552940971ab73cc63676655c6614fd535e21",
"date": "2018-04-18 19:37:35 -0400",
"subject": "Rename archive-queue-max option to archive-push-queue-max.",
"body": "This avoids confusion with the archive-get-queue-max option. The old option name will continue to be accepted."
},
{
"commit": "ab26c765d454cd8f757ccc7ada593746dbddae0d",
"date": "2018-04-18 18:57:45 -0400",
"subject": "Don't copy CFGDEF_NAME_ALT or CFGDEF_INHERIT when processing config option inheritance."
},
{
"commit": "ea4046a607cddef588b5eb061f1df1e602a497bf",
"date": "2018-04-18 18:47:43 -0400",
"subject": "Try tweaking time sync settings to prevent clock drift rather than restarting VBoxService on every test run."
},
{
"commit": "b3e668421b03b2869c0dac1be6f22a9faf753341",
"date": "2018-04-17 20:25:42 -0400",
"subject": "Fix document update missed in e9790fd3."
},
{
"commit": "0381945caa198f833adde7806af2368c2627678a",
"date": "2018-04-17 18:47:14 -0400",
"subject": "Show command parameters as well as command options in initial info log message."
},
{
"commit": "e9790fd3b13f87a7f4726471019ead36d5b7b08d",
"date": "2018-04-17 17:38:25 -0400",
"subject": "Update out-of-date description for the spool-path option."
},
{
"commit": "cf0ec44ededb357c4fe2783814a2575119a4c498",
"date": "2018-04-17 12:03:03 -0400",
"subject": "Rename Perl tests so they don't conflict with their C counterparts."
},
{
"commit": "dce11ce3cf0473b127e56c21436dd4c4159d8646",
"date": "2018-04-16 15:52:17 -0400",
"subject": "Generate code counts for all source files.",
"body": "The source files are also classified by type and purpose."
},
{
"commit": "3e229774840f82e4488d0077b07ae80971f7c385",
"date": "2018-04-16 15:25:50 -0400",
"subject": "Use pip 9.03 in test VMs.",
"body": "pip 10 drops support for Python 2.6 which is still used by the older test VMs."
},
{
"commit": "2a4ff2f904b411f623239f02f54cdb2622017298",
"date": "2018-04-13 16:05:52 -0400",
"subject": "Split cfgLoad() into multiple functions to make testing easier.",
"body": "Mainly this helps with unit tests that need to do log expect testing. Add harnessCfgLoad() test function, which allows a new config to be loaded for unit testing without resetting log functions, opening a log file, or taking locks."
},
{
"commit": "49fc737cd0fc053339f26b4e3b01d2b598124bb4",
"date": "2018-04-13 14:31:33 -0400",
"subject": "Add monitoring examples using PostgreSQL and jq.",
"body": "Suggested by Stephen Frost, Brian Faherty."
},
{
"commit": "d924f3d50a1be296a65096b0b1014ade14c2dd59",
"date": "2018-04-13 12:00:22 -0400",
"subject": "Add logic to find the real oid of the test1 database during restore testing."
},
{
"commit": "f0250dab4b7fba2eda57fc0a483352f7cd70d0ab",
"date": "2018-04-12 20:42:26 -0400",
"subject": "Move async forking and more error handling to C.",
"body": "The Perl process was exiting directly when called but that interfered with proper locking for the forked async process. Now Perl returns results to the C process which handles all errors, including signals."
},
{
"commit": "6fd0c3dcaa68e168b05364c699f6c1a6f87f1de0",
"date": "2018-04-11 09:36:12 -0400",
"subject": "Improved lock implementation written in C.",
"body": "Now only two types of locks can be taken: archive and backup. Most commands use one or the other but the stanza-* commands acquire both locks. This provides better protection than the old command-based locking scheme."
},
{
"commit": "4744eb93878da6b7aa2173be16928b081c865b1d",
"date": "2018-04-11 08:21:09 -0400",
"subject": "Add storagePathRemove() and use it in the Perl Posix driver.",
"body": "This implementation should be faster because it does not stat each file. It simply assumes that most directory entries are files so attempts an unlink() first. If the entry is reported by error codes to be a directory then it attempts an rmdir()."
},
{
"commit": "c9ce20d41a0c6edc3087511eaff5e0a80e95c8da",
"date": "2018-04-09 16:46:36 -0400",
"subject": "Skip version checks when testing in --dev mode."
},
{
"commit": "3bcf637aeeebfeb135e693fb0191dbb2c70f9420",
"date": "2018-04-08 12:57:02 -0400",
"subject": "Move archive-stop and expire tests to the mock module.",
"body": "These are mock integration tests so they should be grouped with the other mock integration tests."
},
{
"commit": "3b661f4ad550cfce993afc5d767ed7f2ac4cea81",
"date": "2018-04-08 12:16:32 -0400",
"subject": "Move help/version integration tests to mock/all.",
"body": "Help and version are covered by unit tests, so we really just to need to make sure there is output when called from the command line."
},
{
"commit": "741acfd7799b7b1b2afe850ccf078cf84a421353",
"date": "2018-04-08 10:19:24 -0400",
"subject": "Move test definitions to test/define.yaml.",
"body": "The location is better because it is no longer buried in the Perl test libs. Also, the data can be easily accessed from C."
},
{
"commit": "b77b4250964ca47ac622c83ae72bfc9d453ea5d7",
"date": "2018-04-07 19:44:00 -0400",
"subject": "Allow -DDEBUG_UNIT to be suppressed to test how debug macros behave."
},
{
"commit": "82751b3b511e9a55724d3836b2454df8c97d8a25",
"date": "2018-04-07 13:12:35 -0400",
"subject": "Split debug and assert code into separate headers.",
"body": "Assert can be used earlier because it only depends on the error-handler and not logging."
},
{
"commit": "e00f2dd4ad574c7680bce2126df4d320c9c8d6ac",
"date": "2018-04-06 21:46:45 -0400",
"subject": "More C type cleanup.",
"body": "* Remove typec.h entirely.\n* Order all typdefs above local includes."
},
{
"commit": "f3b56cf8f328dc68dc4c978f0d82d3f5efbbe939",
"date": "2018-04-06 17:04:52 -0400",
"subject": "Allow MemContext objects to be copied to a new parent.",
"body": "This makes it easier to create objects and then copy them to another context when they are complete without having to worry about freeing them on error. Update List, StringList, and Buffer to allow moves. Update Ini and Storage to take advantage of moves."
},
{
"commit": "b9f636cab470165ff0d69baa54efa5f8b2a79d43",
"date": "2018-04-05 22:38:11 -0400",
"subject": "Cleanup C types.",
"body": "* Remove pgBackRest defined types included with the C types.\n* Remove redefinition of standard C types."
},
{
"commit": "bd25248df02d4a21315e73c1a4dc28fe8458fe97",
"date": "2018-04-05 14:48:16 -0400",
"subject": "Abstract Posix storage driver code into a separate module."
},
{
"commit": "348278bb68ea4cebc3140404729f12fc63d6071d",
"date": "2018-04-03 21:30:15 -0400",
"subject": "Make backup directory sync more efficient.",
"body": "Scanning the entire backup directory can be very expensive if there are a lot of small tables. The backup manifest contains the backup directory list so use it to perform syncs instead of scanning the backup directory."
},
{
"commit": "0dce8ba2fa096faafa3871517458bfe6d742350f",
"date": "2018-04-03 20:54:18 -0400",
"subject": "Make backup.history sync more efficient.",
"body": "Only the backup.history/[year] directory was being synced, so check if the backup.history is newly created and sync it as well."
},
{
"commit": "58902722477518d7daa202241772bf499ea136a3",
"date": "2018-04-03 18:12:03 -0400",
"subject": "Fix directory syncs running recursively when only the specified directory should be synced.",
"body": "Reported by Craig A. James."
},
{
"commit": "46b6be6d7269ae35ff633736c4c5ddcde313d0d2",
"date": "2018-04-03 13:35:56 -0400",
"subject": "Fix header exclusion defines that do not match the general pattern."
},
{
"commit": "93fdb98d1500ca72a1d3355ed0c7ff23e27e074c",
"date": "2018-04-03 12:25:21 -0400",
"subject": "Storage object improvements.",
"body": "* Convert all functions to variadic functions.\n* Enforce read-only storage.\n* Add storageLocalWrite() helper function. Add storageExists(), storagePathCreate(), storageRemove(), and storageStat().\n* Add StorageFile object and storageOpenRead()/storageOpenWrite()."
},
{
"commit": "90f980fe91b8dff96523a8089613b31b4485b923",
"date": "2018-03-30 21:33:30 -0400",
"subject": "Remove documentation describing info --output=json as experimental."
},
{
"commit": "635caff573315d5fe0dd267f968a4c40c98d524f",
"date": "2018-03-30 19:10:34 -0400",
"subject": "Add ASSERT() that is preserved in production builds."
},
{
"commit": "a8721ffe118e0c6ae93f6bc45c6bb79aaf78b440",
"date": "2018-03-27 22:48:22 -0400",
"subject": "Improve logic for smart builds to include version changes."
},
{
"commit": "5518a2ac51be91f71bfed0e27eba5e8bb6e465d2",
"date": "2018-03-27 20:40:33 -0400",
"subject": "Full branch coverage for storage/storage module."
},
{
"commit": "c1ab7b3c98c0a21b2b1b78ef3e64dfd891f68a11",
"date": "2018-03-25 11:39:24 -0400",
"subject": "Start work on C handle io object and use it to output help."
},
{
"commit": "9001b9b9576cb2d852984214e8bdd3b583dc552f",
"date": "2018-03-24 14:11:29 -0400",
"subject": "Replace THROW_ON_SYS_ERROR() with THROW_SYS_ERROR().",
"body": "The former macro was hiding missing branch coverage for critical error handling."
},
{
"commit": "c7a6e9d2f2b58ca7832c58c3e25c65c1d03079e3",
"date": "2018-03-23 16:08:32 -0400",
"subject": "Document build improvements.",
"body": "* Perform apt-get update to ensure packages are up to date before installing.\n* Add -p to the repository mkdir so it won't fail if the directory already exists, handy for testing packages."
},
{
"commit": "dabf727d91704dac6bfd59019d112857cbf963f3",
"date": "2018-03-21 16:08:08 -0400",
"subject": "Include VM type in gcov path to avoid conflicts between VMs with different architectures."
},
{
"commit": "c6457b070f5bdf26bb9146004e5ba2116b161df7",
"date": "2018-03-21 13:46:08 -0400",
"subject": "Full branch coverage for config/parse module."
},
{
"commit": "b234f43c9d8e6abde99947c64e0776e0054091c8",
"date": "2018-03-21 09:18:48 -0400",
"subject": "Refactor usec to msec in common/time.c.",
"body": "The implementation provides usec resolution but this is not needed in practice and it makes the interface more complicated due to the extra zeros."
},
{
"commit": "31830bdc55bd603e90a13b54b81b919526cf03a5",
"date": "2018-03-20 16:08:52 -0400",
"subject": "Full branch coverage for all common/type modules."
},
{
"commit": "a2030da20048845c879c45279e839c9109a92418",
"date": "2018-03-20 16:01:38 -0400",
"subject": "Specify prefix for lcov output.",
"body": "This prevents pages from moving around depending on the subtest."
},
{
"commit": "f4ed36d128ba7bda602f0c6451325ce377f422b4",
"date": "2018-03-20 10:17:53 -0400",
"subject": "Add switch() to lcov branch exclusions.",
"body": "lcov requires default to show complete coverage but --Wswitch-enum enforces all enum values be present so no default is needed.\n\nAdd documentation for each branch exclusion."
},
{
"commit": "d34142dee82e41f983517a181f721d6009d70a81",
"date": "2018-03-20 09:47:51 -0400",
"subject": "Update lcov settings.",
"body": "Mark any coverage less that 100% as yellow, less that 90% as red.\n\nAdd comments to config file and make genhtml use it as well as lcov."
},
{
"commit": "07f38f584a6014e10888fe0f8016febab79ce67b",
"date": "2018-03-19 23:33:28 -0400",
"subject": "Use lcov for C unit test coverage reporting.",
"body": "Switch from Devel::Cover because it would not report on branch coverage for reports converted from gcov.\n\nBranch coverage is not complete, so for the time being errors will only be generated when statement coverage is not complete. Coverage of unit tests is not displayed in the report unless they are incomplete for either statement or branch coverage."
},
{
"commit": "2a3d6ecde8a86154cfaba067dfcbe459ef2aa8e1",
"date": "2018-03-19 21:49:41 -0400",
"subject": "v2.01: Minor Bug Fixes and Improvements"
},
{
"commit": "45c6a0e864189a309ad3e5c0f643b46dd50fb303",
"date": "2018-03-19 21:03:42 -0400",
"subject": "Remove hard-coded release version from loadTest.c."
},
{
"commit": "5b0748cf93d49d52bf74290e05c208fc88017a26",
"date": "2018-03-19 20:25:55 -0400",
"subject": "Always autogenerate code if --smart is not specified."
},
{
"commit": "f0a4264f77a7d9cb1dc5434e3c76c8313c600c79",
"date": "2018-03-19 19:54:03 -0400",
"subject": "Fix manifest test in the check command when tablespaces are present.",
"body": "Fixed by Cynthia Shang.\nReported by Thomas Flatley."
},
{
"commit": "8e9e97728c5f58790ba91305f465b04d8a7a061a",
"date": "2018-03-19 17:38:44 -0400",
"subject": "Remove --smart from --expect tests.",
"body": "This ensures that new binaries are built before running the tests."
},
{
"commit": "2c1687721e57b1917dc3f3bed62aa01b59078f5c",
"date": "2018-03-19 13:08:42 -0400",
"subject": "Fix issue where specifying log-level-stderr > warn would cause a local/remote process to error on exit due to output found on stderr when none was expected.",
"body": "The max value for a local/remote process is now error since there's no reason for these processes to emit warnings."
},
{
"commit": "0c313713b1f40f09a970bee70e4e1ca3bcbbe082",
"date": "2018-03-18 13:32:19 -0400",
"subject": "Use clang for static code analysis.",
"body": "Nothing found except for some functions that should have been marked __noreturn__."
},
{
"commit": "f0451c1494d0886c8fc24734eb8f98d403ce91dc",
"date": "2018-03-15 13:53:03 -0400",
"subject": "Enable -Wformat=2 and -Wformat-nonliteral and silence new warnings."
},
{
"commit": "8a1ce42c30e7e9ac79b1f7b66aa870d84c7419de",
"date": "2018-03-15 12:02:09 -0400",
"subject": "Immediately error when a secure option (e.g. repo1-s3-key) is passed on the command line.",
"body": "Since pgBackRest would not pass secure options on to sub-processes an obscure error was thrown. The new error is much clearer and provides hints about how to fix the problem.\n\nUpdate command documentation to omit secure options that cannot be specified on the command-line."
},
{
"commit": "dd3ce7081070aca3a5c915af2a7e642c3ebece4b",
"date": "2018-03-15 11:09:46 -0400",
"subject": "Config test code writes secure options to a file instead of passing on the command-line."
},
{
"commit": "4fb75c9cc1c594d462adb31b8146e789ce639fb3",
"date": "2018-03-15 11:03:28 -0400",
"subject": "Improve conversion of C exceptions to Exception objects.",
"body": "Colons in the message would prevent all of the message from being loaded into the Exception object."
},
{
"commit": "599e291b366e0c0217c81fad44a3f7cdbd800d98",
"date": "2018-03-14 14:34:06 -0400",
"subject": "Check int size in common/type.h.",
"body": "This ensures that integers are at least 32-bits without having to run the test suite."
},
{
"commit": "e7fd94ee23f7b0b353f926c55086c9163f6f4881",
"date": "2018-03-14 11:10:46 -0400",
"subject": "Simplify table of contents on command page by only listing commands.",
"body": "Suggested by Stephen Frost."
},
{
"commit": "4b6cd92a4ca8de743ddf3d62e71e548ead06644b",
"date": "2018-03-12 17:15:14 -0400",
"subject": "Improve debugging.",
"body": "* Replace remaining NDEBUG blocks with the more granular DEBUG_UNIT.\n* Remove some debug memset() calls in MemContext since valgrind is more useful for these checks."
},
{
"commit": "cced6ec03aa212310a940e643cc8f2b484d95a8c",
"date": "2018-03-12 14:31:22 -0400",
"subject": "Add ASSERT_DEBUG() macro for debugging.",
"body": "Replace all current assert() calls except in tests that can't use the debug code."
},
{
"commit": "dd31ae832d6d5278079d5e84c471b0258f51940b",
"date": "2018-03-12 11:25:20 -0400",
"subject": "Port most of Config::Config::configLoad() from Perl to C.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "03f1082e86ac82477f09f212332e9c82946d28ad",
"date": "2018-03-12 11:03:38 -0400",
"subject": "Improve logging.",
"body": "Move command begin to C except when it must be called after another command in Perl (e.g. expire after backup). Command begin logs correctly for complex data types like hash and list. Specify which commands will log to file immediately and set the default log level for log messages that are common to all commands. File logging is initiated from C."
},
{
"commit": "94494a632f0d217810a0cd0da462529c6c60b032",
"date": "2018-03-12 11:02:46 -0400",
"subject": "Update pip before installing awscli."
},
{
"commit": "f047cd0dfd3de01ff4ea678f394af8302e89e7c0",
"date": "2018-03-09 23:00:20 -0500",
"subject": "Improve code generation performance."
},
{
"commit": "b987f05f3529654515e5cddee4057fe5f83cfd20",
"date": "2018-03-09 21:24:30 -0500",
"subject": "Improve bin and libc build performance."
},
{
"commit": "c32ee346128182b9742417c27b0ae9c5bd768cb8",
"date": "2018-03-09 18:28:34 -0500",
"subject": "Build with -DNDEBUG by default but disable for testing."
},
{
"commit": "fbe4c40386d9b8666514703996b5734d2719b652",
"date": "2018-03-09 09:30:50 -0500",
"subject": "Move logic for setting Perl configuration defaults to C."
},
{
"commit": "919635b6f42eff1c1de0638626314caf4b0e2f2a",
"date": "2018-03-08 16:24:16 -0500",
"subject": "Set config before Main::main() call to avoid secrets being exposed in a stack trace."
},
{
"commit": "34898ce471214e234e14d9532bbb34b8095381cc",
"date": "2018-03-08 14:15:05 -0500",
"subject": "Error when multiple arguments are set in the config file for an option that does not accept multiple arguments.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "e331564c9025077a0f3922408a90d5f8f18baed1",
"date": "2018-03-08 12:36:55 -0500",
"subject": "Add new test for Common::Io::Process.",
"body": "Show that output on stderr will raise an exception on close() even if the exit code is 0."
},
{
"commit": "62a9bdbd4c25b9801bcc6a4892d442f38e6d4da5",
"date": "2018-03-08 10:43:09 -0500",
"subject": "Fix issue passing --no-config to embedded Perl.",
"body": "Reported by Ibrahim Edib Kokdemir."
},
{
"commit": "5e0ce3e996db90c44eba835093549f9634525f21",
"date": "2018-03-06 17:12:16 -0500",
"subject": "Fix --target-action and --recovery-option options being reported as invalid when restoring with --type=immediate.",
"body": "Reported by Brad Nicholson."
},
{
"commit": "4c8ed3530c05e2a88a1515a1cdd31ac3871b4bc2",
"date": "2018-03-06 14:20:12 -0500",
"subject": "Show index in examples for indexed options, i.e. repo-*, pg-*.",
"body": "Suggested by Stephen Frost."
},
{
"commit": "45ffe37e4ff3fd955a10bad93c17f443793855b8",
"date": "2018-03-05 18:51:48 -0500",
"subject": "Add cfgOptionTest().",
"body": "Update cfgOption() calls that are better implemented as cfgOptionTest()."
},
{
"commit": "a50b1eb5be64c0ea68c468cbe0b793be93136c33",
"date": "2018-03-05 10:03:10 -0500",
"subject": "Remove references to the C library being optional."
},
{
"commit": "c07aa2ae1940f2c6cf0f7a2e701b20e2d0c32ff9",
"date": "2018-03-02 22:42:02 -0500",
"subject": "Improve code documentation in config module."
},
{
"commit": "406acf9cba16fc93fdcd7d6ee93483ef8ef5d073",
"date": "2018-03-02 12:07:12 -0500",
"subject": "Enable -Wconversion and silence new warnings."
},
{
"commit": "6ca6424fb1b32fb43eafc481d179508e958e5e7e",
"date": "2018-03-01 16:59:49 -0500",
"subject": "Remove extraneous sudo commands from src/Makefile.",
"body": "Contributed by Adrian Vondendriesch."
},
{
"commit": "af805af044317265a786214bed4c506977e934b4",
"date": "2018-03-01 16:59:13 -0500",
"subject": "Remove Debian package patch now that it has been merged upstream."
},
{
"commit": "5d1722b8ef7dd86ef717ce0425fb5b55d73f5f1d",
"date": "2018-03-01 13:32:51 -0500",
"subject": "Disable console display of coverage for C files.",
"body": "Devel::Cover does not handle it well."
},
{
"commit": "57d70a5649c2d4f0500c495d0fb065d1eda06e4b",
"date": "2018-03-01 13:31:03 -0500",
"subject": "Remove RHEL package patch since upstream has been updated."
},
{
"commit": "5b491b3035502819a31e1200636c8d2757a78a18",
"date": "2018-02-26 19:32:27 -0500",
"subject": "Add CentOS/RHEL package builds."
},
{
"commit": "f9c1a3b156a07ecfd4916fe0386f90022406d721",
"date": "2018-02-26 10:43:49 -0500",
"subject": "Enable -Wswitch-enum and silence new warnings."
},
{
"commit": "c8df690931561c4b172d2ea48e68a0597e0a272b",
"date": "2018-02-26 10:02:33 -0500",
"subject": "Fix incorrect enum types in config.c that throw warnings under clang.",
"body": "Found by Douglas J Hunley."
},
{
"commit": "09223a733dd8a4b9fc3deeec72ee5a168a9c625d",
"date": "2018-02-23 23:44:10 -0500",
"subject": "Remove github CNAME file."
},
{
"commit": "1f954b324ae8c2ae43af1da2a97090dde586fb8f",
"date": "2018-02-23 23:42:29 -0500",
"subject": "Update how versions are displayed in the documentation."
},
{
"commit": "13cdb75ac56609c6a1d2f7cb3c31c0f0b29ecc3b",
"date": "2018-02-23 22:38:45 -0500",
"subject": "v2.00: Performance Improvements for Archive Push"
},
{
"commit": "ed5876810d616a6dc59bddf722f74cccd9b8ddec",
"date": "2018-02-23 14:16:20 -0500",
"subject": "Fix missing variable replace for PDF code-block title.",
"body": "Found by Jason O'Donnell."
},
{
"commit": "2485fabbadf56aa51f821048e72550ddac026691",
"date": "2018-02-22 09:31:53 -0500",
"subject": "PDF rendering improvements.",
"body": "* Fill is now the default for table columns.\n* Column width is specified as a percentage rather that using latex-specific notation."
},
{
"commit": "d4418e7764bf6b3d3e8b6d2bc204cfd0e00bca13",
"date": "2018-02-21 18:15:40 -0500",
"subject": "Rename pg-primary and pg-standby variables to pg1 and pg2.",
"body": "It would be better if the hostnames were also pg1 and pg2 to illustrate that primaries and standbys can change hosts, but at this time the configuration ends up being confusing since pg1, pg2, etc. are also used in the option naming. So, for now leave the names as pg-primary and pg-standby to avoid confusion."
},
{
"commit": "5eb682a569cdc4f33ea053e3619163c98aefcdd1",
"date": "2018-02-21 18:10:53 -0500",
"subject": "Add id param for hosts created with host-add.",
"body": "The host-*-ip variable is created from the id param so the name param can be changed without affecting the host-*-ip variable. If id is not specified then it is copied from name."
},
{
"commit": "246d4415079550f4f1391c09ad874c2cf4e3fa37",
"date": "2018-02-21 15:30:35 -0500",
"subject": "More flexible replacements for PDF titles and footers."
},
{
"commit": "aed578a4bd201d16512b1adb87a327504a0c335c",
"date": "2018-02-21 15:26:30 -0500",
"subject": "Allow sections to be excluded from table of contents in PDF output."
},
{
"commit": "64a7196cb64d90fe8801f7be6c4c634ba17bf32a",
"date": "2018-02-19 15:07:24 -0500",
"subject": "Rename retention-* options to repo-retention-*."
},
{
"commit": "f75ba7db9426dd05dc868beb00528aae04ea3a4b",
"date": "2018-02-19 13:17:58 -0500",
"subject": "Update backup host to repository host in the documentation.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "435240777766afc7effb81cdb5e6cf03fea6e0fa",
"date": "2018-02-19 10:12:51 -0500",
"subject": "Option rename cleanup based on review.",
"body": "* Remove --reset tags from v1 options.\n* Use constants for repo prefix.\n* Specify CFGDEF_INDEX_PG in option structure rather than adding in code.\n* Fix error message references to \"backup host\"."
},
{
"commit": "f981283b8dea28214072ace05b67acc27989c76f",
"date": "2018-02-18 15:45:32 -0500",
"subject": "Remove exit() calls from main() to make it cleaner and more testable."
},
{
"commit": "599e41a2514eda36c1cd7f2a69754a5f94c30dcd",
"date": "2018-02-18 14:54:32 -0500",
"subject": "Improve S3 delete performance.",
"body": "The constant S3_BATCH_MAX had been replaced with a hard-coded value of 2, probably during testing."
},
{
"commit": "90703257603f04446872b2b39eea26fec2c1b460",
"date": "2018-02-18 14:53:27 -0500",
"subject": "Improve performance of HTTPS client.",
"body": "Buffering now takes the pending bytes on the socket into account (when present) rather than relying entirely on select(). In some instances the final bytes would not be flushed until the connection was closed."
},
{
"commit": "27678f6188534d1233eeb9424a6fa590c79a5c9d",
"date": "2018-02-18 10:44:58 -0500",
"subject": "Clean up and document Makefile."
},
{
"commit": "3eed4bbb4390ecf8d7f2b9ad349a568bfa06a9c8",
"date": "2018-02-16 15:09:37 -0500",
"subject": "PDF rendering improvements.",
"body": "* Check both doc-path and bin-path for logo.\n* Allow PDF to be output to a location other than the output directory.\n* Use PDF-specific version variable for more flexible formatting."
},
{
"commit": "0e27060952b49254574d017346beb8f834afee4f",
"date": "2018-02-16 14:55:48 -0500",
"subject": "Add table render for Markdown format.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "ca52a0485e23da55bd0c15299a52303c6de439bb",
"date": "2018-02-16 14:46:02 -0500",
"subject": "Allow code blocks to have a type.",
"body": "Currently this is only rendered in Markdown."
},
{
"commit": "2dc0737e95efc858bcc7e4318b3003b3bd57f5ee",
"date": "2018-02-16 14:39:42 -0500",
"subject": "Improve section source feature to not require a title or content.",
"body": "The title will be pulled from the source document."
},
{
"commit": "1f62237684f78b0d13268f7be59776a9cbd7f5d6",
"date": "2018-02-14 19:52:46 -0500",
"subject": "Clarify that S3 buckets must be created by the user.",
"body": "Suggested by David Youatt."
},
{
"commit": "72cbb9a9d47ec7a2066fbe12bd75619f9f43e4f7",
"date": "2018-02-14 17:19:54 -0500",
"subject": "Call Perl with built-in interpreter instead of execvp().",
"body": "Exec'ing Perl worked fine but generated a very large command line in the process list and potentially exposed secrets."
},
{
"commit": "81952c41f4592aec05ecd60f8097f4f1fcb83437",
"date": "2018-02-14 17:13:18 -0500",
"subject": "Report coverage errors via the console.",
"body": "This helps with debugging coverage issues on remote services like Travis."
},
{
"commit": "5f2884cb296a2c71dd9d6432c2c387efc96ceeef",
"date": "2018-02-14 16:46:52 -0500",
"subject": "Suppress coverage failures for Archive/Push/Async on Travis.",
"body": "The coverage report shows some code as never being run -- but that makes no sense because the tests pass. This may be due to trying to combine the C and Perl coverage reports and overwriting some runs.\n\nSuppress for now with a plan to implement LCOV for the C unit tests."
},
{
"commit": "a907fd7d2d21f01714427d0c769e3973a99f1a45",
"date": "2018-02-14 10:33:21 -0500",
"subject": "Build C binary/library for C unit tests that require Perl."
},
{
"commit": "fda62dfc485d435b4996137844f029464e87222c",
"date": "2018-02-14 09:49:01 -0500",
"subject": "Move Perl option JSON generation to a new module.",
"body": "Linking exec.c into LibC will not be an option once the perl exec loads the Perl interpreter."
},
{
"commit": "68a83ea2dcdc168aedefc856acc2c261889613fa",
"date": "2018-02-14 09:21:55 -0500",
"subject": "Add missing const to strLstAdd()."
},
{
"commit": "5242e8eec59b0cb91437fad95289dcc8b5dc61a7",
"date": "2018-02-14 09:18:27 -0500",
"subject": "Generate suppressions when running Valgrind.",
"body": "This makes it easier to suppress errors that are only occurring on Travis."
},
{
"commit": "00e9aca872745d2552aa1b562c0dc034fe867356",
"date": "2018-02-13 15:58:14 -0500",
"subject": "Fixed issue where --reset-* was not passing the default value to Perl.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "213724907b5eb3acd5af158601d74913f30af67f",
"date": "2018-02-09 22:27:21 -0500",
"subject": "Add contributor."
},
{
"commit": "a3b80768bdaf627a2fa71c561ebc8c1962196580",
"date": "2018-02-09 15:56:22 -0500",
"subject": "Merge 1.28 release notes."
},
{
"commit": "ea296372d4c920bdcfde85e138719f20d881f16c",
"date": "2018-02-09 15:42:11 -0500",
"subject": "Add allow range to int/float options that did not already have one."
},
{
"commit": "7c58fe7451666778b71d3b934d35dc1550a36387",
"date": "2018-02-09 13:54:33 -0500",
"subject": "Use 64-bit integers for config options.",
"body": "In particular, archive-queue-max requires a greater range than is provided by a 32-bit integer."
},
{
"commit": "305a3e176185edaedec68be5824c950121297213",
"date": "2018-02-09 13:52:02 -0500",
"subject": "Add int64 variant type."
},
{
"commit": "1659598cfe957f06e74f1584591337674cb19e81",
"date": "2018-02-08 16:11:47 -0500",
"subject": "Create a master list of errors in build/error.yaml.",
"body": "The C and Perl errors lists are created automatically by Build.pm so they stay up to date."
},
{
"commit": "eba31fbfe5e58c66b776c2c09a6a53a533819c20",
"date": "2018-02-08 14:49:35 -0500",
"subject": "Update URL for Debian package repository."
},
{
"commit": "7d13087c4b0bf2f5e3ca08065edc04a83c37f1b4",
"date": "2018-02-06 11:26:06 -0500",
"subject": "Rename -no to -reset for non-boolean options."
},
{
"commit": "808b6000eb4434a66d1073d8b903b1236a082445",
"date": "2018-02-05 15:48:26 -0500",
"subject": "Fix some bugs in C config code:",
"body": "1) Error when the same option is defined multiple times in a section using alternate names.\n2) Fix logging of invalid command error.\n3) Warn when a stanza-only option is in a global section.\n\nAlso, make a note to add validation of section names to the check command.\n\nPer review by Cynthia Shang."
},
{
"commit": "d35757c05f1b4b30c57997c6221d888660a4ee52",
"date": "2018-02-05 15:19:28 -0500",
"subject": "Fix missing log-level-stderr option for stanza-* commands."
},
{
"commit": "2074e6fbf9a4c0b7b5a8759e9dd9be2a9bd46b41",
"date": "2018-02-05 12:41:42 -0500",
"subject": "Move log option update to after fork() in archive-push.",
"body": "The log-level-console option should not be changed in the parent process. Even though it is harmless at the moment, that may not always be true.\n\nPer review by Cynthia Shang."
},
{
"commit": "c3f47bf240cc2eaf4c6fa441c0c2d95979477379",
"date": "2018-02-05 12:32:30 -0500",
"subject": "Move config parsing out of Perl tests.",
"body": "cfgParseTest() is provided in the C library for parsing configs in unit tests."
},
{
"commit": "db21b7a360fdc3aea4a22480c634b8d6f2ee52eb",
"date": "2018-02-05 11:50:09 -0500",
"subject": "Cleanup usage of internal options.",
"body": "Apply internal to options that need to be read to determine locality but should not appear in the help."
},
{
"commit": "be900281003f67c549630186482242cc40f0685b",
"date": "2018-02-03 18:27:38 -0500",
"subject": "Rename db-* options to pg-* and backup-* options to repo-* to improve consistency.",
"body": "* repo-* options are now indexed although only one is allowed.\n* List deprecated option names in documentation and command-line help."
},
{
"commit": "dc73abdb6e9612f7af8e38408639be53daba0575",
"date": "2018-02-01 14:12:03 -0500",
"subject": "Improve stanza-create command so that it does not error when the stanza already exists.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "298b33988c34ac5777c8174435e20a863dd6f730",
"date": "2018-01-31 18:22:25 -0500",
"subject": "Fix non-compliant formatting for function declarations.",
"body": "Per review by Cynthia Shang."
},
{
"commit": "b4d434b41c8302e48cf2f2dcec8a465378507b73",
"date": "2018-01-31 17:34:27 -0500",
"subject": "Update stanza-create --force documentation to urge caution when using.",
"body": "Suggested by Jason O'Donnell."
},
{
"commit": "bacc08792dae400de652ce2f769aeeda73f0ef8e",
"date": "2018-01-30 16:49:47 -0500",
"subject": "Ensure latest db-id is selected on when matching archive.info to backup.info.",
"body": "This provides correct matching in the event there are system-id and db-version duplicates (e.g. after reverting a pg_upgrade).\n\nFixed by Cynthia Shang.\nReported by Adam K. Sumner."
},
{
"commit": "00f58ec8c0349e6941ae6fd0957f2c1196ce0cad",
"date": "2018-01-30 16:13:54 -0500",
"subject": "Fixed inability to restore a single database contained in a tablespace using --db-include.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "a91a648019bc8871c9e74868c59a933d74c3dc5c",
"date": "2018-01-28 21:37:09 -0500",
"subject": "Config parsing no longer implemented in Perl.",
"body": "Options are passed to Perl as JSON from the C process."
},
{
"commit": "f0ef1dee05266f7be1acd8943a3bcda11f0d2e59",
"date": "2018-01-26 16:41:17 -0500",
"subject": "Improve speed of C unit tests.",
"body": "Preserve object files between tests and use a Makefile to avoid rebuilding object files."
},
{
"commit": "b58a45e0676f9bc5b7e2e136cd338db572a6a604",
"date": "2018-01-23 13:34:24 -0500",
"subject": "Implement help command in C."
},
{
"commit": "404ec30d039866a83d7c0707aaab838ccffe433f",
"date": "2018-01-23 12:58:35 -0500",
"subject": "Move Perl help test to real module."
},
{
"commit": "3dd882a79eb26b443f74aa8c34328add10baf976",
"date": "2018-01-23 12:49:04 -0500",
"subject": "Add internal flag to config definition."
},
{
"commit": "41bd5e8148b307e8285fa855dc715b889d5a0617",
"date": "2018-01-23 12:40:02 -0500",
"subject": "Improve KeyValue object.",
"body": "Add kvGetList() to get a value as a list (of 1) even if it is a scalar."
},
{
"commit": "2afb73da1cac6447c01a042fe7105e9910f3b20e",
"date": "2018-01-23 12:17:30 -0500",
"subject": "Improve String, StringList, and List objects.",
"body": "* Add strCmp*() and strFirst*() to String.\n* Add strLstSort() and strLstNewSplitSize() to StringList.\n* Add strLstNewSplitZ() to StringList a update calls to strLstNewSplit() as needed.\n* Add lstSort to List."
},
{
"commit": "47c048b42a0cbf45d97da701521b8ddaeccfd2cf",
"date": "2018-01-18 08:56:03 -0500",
"subject": "Update LICENSE.txt for 2018."
},
{
"commit": "2cc9b2287bf4bf7bc0a4b98f274bb737e0d5e961",
"date": "2018-01-17 15:52:00 -0500",
"subject": "The archive-push command is now partially coded in C.",
"body": "This allows the PostgreSQL archive_command to run significantly faster when processing status messages from the asynchronous archive process."
},
{
"commit": "a4c058d070dfc6f6098fad051a14893ef449eae6",
"date": "2018-01-17 15:03:55 -0500",
"subject": "Add 30 second wait loop to lockAcquire() when fail on no lock enabled.",
"body": "This should help prevent processes that are shutting down from interfering with processes that are starting up."
},
{
"commit": "1f39a34abc65c43a0635403b246168acdef4dbbe",
"date": "2018-01-17 10:31:21 -0500",
"subject": "Move lock release later in exitSafe().",
"body": "This reduce the chance of a new process starting and acquiring a lock before the old process has exited."
},
{
"commit": "7c73f4f6c981e8a2806bbca3c035d7ba1e6c7713",
"date": "2018-01-17 09:15:51 -0500",
"subject": "Add command and exit modules."
},
{
"commit": "39cb971afb79b1368b9f1dd9185ad49fbb0de9c5",
"date": "2018-01-16 13:52:20 -0500",
"subject": "Add log module."
},
{
"commit": "eb452c8addb345c02246b8c97e088cca6c66c6d1",
"date": "2018-01-16 13:38:37 -0500",
"subject": "Improvements to Storage object.",
"body": "* storagePath() and storageList() commands\n* Helper functions for local and spool storag"
},
{
"commit": "8f81620b9f5a8de4f2d2ebb0a5ecc2fe49d26435",
"date": "2018-01-16 13:29:27 -0500",
"subject": "Improve error module.",
"body": "Add functions to convert error codes to C errors and handle system errors."
},
{
"commit": "bffc6c49b31a98fc5a6ae68b80db0251da6e9441",
"date": "2018-01-16 13:23:08 -0500",
"subject": "Add perl-bin option to specify the Perl binary location when /usr/bin/env perl won't work."
},
{
"commit": "d633417e5db447e3689097c1d31ad1356eb94745",
"date": "2018-01-16 13:05:00 -0500",
"subject": "Add Wait object and time module."
},
{
"commit": "721d1127a03b9fbd3fab04554c92f949954cf514",
"date": "2018-01-16 12:57:23 -0500",
"subject": "Add RegExp object."
},
{
"commit": "05c731692b93d171ffdd0e0e297c2274998bfc16",
"date": "2018-01-16 12:54:06 -0500",
"subject": "Add varStrForce() to Variant object."
},
{
"commit": "83ddd75d824fca293d88bb53f7349cf637926458",
"date": "2018-01-16 12:47:08 -0500",
"subject": "Improvements to String object.",
"body": "* Add strBeginsWith(), strEndsWith(), strEq(), and strBase().\n* Enable compiler type checking for strNewFmt() and strCatFmt().\n* Rename strNewSzN() to strNewN()."
},
{
"commit": "d992851456f4aef9a0218be0411f1d6815fb9be0",
"date": "2018-01-16 12:36:22 -0500",
"subject": "Rename Perl tests so they don't conflict with their C counterparts."
},
{
"commit": "0e9ba98a50159fc1f26792f9032603fae0aed24c",
"date": "2018-01-03 12:23:33 -0500",
"subject": "Add stanza-delete command to cleanup unused stanzas.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "526acca5bd7d86a7d8b34a1eb37ec3e49e042073",
"date": "2017-12-22 23:27:49 -0500",
"subject": "Config parsing implemented in C."
},
{
"commit": "d8c575801daf6d17e6cbf2daeb2d265c75199032",
"date": "2017-12-22 22:55:17 -0500",
"subject": "Add Ini object."
},
{
"commit": "69488ca8ff11f8256b89828e97f62c8b7039bd4f",
"date": "2017-12-22 22:36:01 -0500",
"subject": "Add Storage object."
},
{
"commit": "b2a64b1f43be7045ba904b156225496bc6dd405e",
"date": "2017-12-22 22:05:37 -0500",
"subject": "Add KeyValue object."
},
{
"commit": "2add6cef95beba05e9c2539d8831273a5b675163",
"date": "2017-12-22 21:50:27 -0500",
"subject": "Add Variant and VariantList objects."
},
{
"commit": "c4b30af64598579f87b0556d974264a9248e5e82",
"date": "2017-12-22 19:56:01 -0500",
"subject": "Add Buffer object."
},
{
"commit": "f89b027decd35c87ee9b531db1a2d0bf5c671802",
"date": "2017-12-22 19:30:15 -0500",
"subject": "Improve String and StringList modules."
},
{
"commit": "5667932063454d0a8851aa1f43b07933307de655",
"date": "2017-12-22 18:54:39 -0500",
"subject": "Improve MemContext module.",
"body": "Add temporary context blocks and refactor allocation arrays to include allocation size."
},
{
"commit": "5ea1263d8e4541405722a0064a133f71be8fedaf",
"date": "2017-12-22 18:36:36 -0500",
"subject": "Run valgrind on all C unit tests.",
"body": "Also refactor code to make valgrind happy."
},
{
"commit": "b00c6d86b3020bb2babdd6d1c77c7ffd61594862",
"date": "2017-12-19 20:27:31 -0500",
"subject": "Merge 1.27 release notes."
},
{
"commit": "70e38a2bd6cad0697128a637f471ec39f1d50c1b",
"date": "2017-12-19 19:14:16 -0500",
"subject": "Deploy historical documentation to prior rather than the root directory."
},
{
"commit": "9fe265d24c55caa4cc7f67cc65e3ee36cf35bd7d",
"date": "2017-12-19 17:03:17 -0500",
"subject": "No longer run master branch through CI.",
"body": "The integration branch will be run through CI and then pushed to master with github status checks."
},
{
"commit": "c34a76690fbceb8f7289c23206a9c9fcbe874c17",
"date": "2017-12-19 15:39:39 -0500",
"subject": "Fixed info command to eliminate \"db (prior)\" output if no backups or archives exist for a prior version of the cluster.",
"body": "Fixed by Cynthia Shang.\nReported by Stephen Frost."
},
{
"commit": "717a14754202b8662fbec5356ce825fd293bb6c8",
"date": "2017-12-18 18:55:15 -0500",
"subject": "Update command-line help from commits 58b08930 and 0bfda1a9."
},
{
"commit": "ef3ef85c33ac871a4910267b34757e8fcbb7e59c",
"date": "2017-12-18 18:51:19 -0500",
"subject": "Fixed an issue where WAL was not expired on PostgreSQL 10.",
"body": "This was caused by a faulty regex that expected all PostgreSQL major versions to be X.X."
},
{
"commit": "3cc367185e1a9bec69954895ecb6ae9d54c8d71f",
"date": "2017-12-15 11:12:37 -0500",
"subject": "Add documentation for command-line negation."
},
{
"commit": "41f5b2cec2e065b8a9ed9245c5338772ad7e77d8",
"date": "2017-12-14 15:44:06 -0500",
"subject": "All clusters in the documentation are initialized with checksums."
},
{
"commit": "e5511d0f82839cd8a13d938e4035ffada872067a",
"date": "2017-12-13 11:16:27 -0500",
"subject": "Improve check command to verify that the backup manifest can be built.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "0bfda1a908edd1ca4990a330ba2dcec7260ccd02",
"date": "2017-12-11 07:48:30 -0500",
"subject": "Document the relationship between the archive-copy and archive-check options.",
"body": "Suggested by Markus Nullmeier."
},
{
"commit": "58b0893067fe33fbeb1e23eb96e080c2d5a9b8ba",
"date": "2017-12-11 07:31:30 -0500",
"subject": "Improve archive-copy reference documentation."
},
{
"commit": "99a072163192e7546632119df89511a173d9048e",
"date": "2017-12-05 15:23:32 -0500",
"subject": "Allow any non-boolean, non-command-line option to be negated.",
"body": "This allows specific options in pgbackrest.conf to be ignored (and set to default) which reduces the need to write new configuration files for specific needs.\n\nNote that boolean, non-command-line options are already negatable."
},
{
"commit": "c5fc88d34097ba03cd4fce3fbfce1f4c337b83e6",
"date": "2017-12-05 14:59:09 -0500",
"subject": "Fixed an issue that suppressed locality errors for backup and restore.",
"body": "When a backup host is present, backups should only be allowed on the backup host and restores should only be allowed on the database host unless an alternate configuration is created that ignores the remote host."
},
{
"commit": "5eb5d94d65ee159605273b57e504652c980c9cc7",
"date": "2017-12-05 14:46:52 -0500",
"subject": "Allow internal options that do not show up in the documentation.",
"body": "Used for test options initially but other use cases are on the horizon."
},
{
"commit": "8d4674031e63d7a3c0bfc07f2524551dcf1474de",
"date": "2017-12-05 10:09:07 -0500",
"subject": "More config parsing in C in preparation for all config parsing in C."
},
{
"commit": "4f1725dc3684233b444d6d0c0efe6bce6468a623",
"date": "2017-12-05 09:45:51 -0500",
"subject": "Replace cfgCommandTotal()/cfgOptionTotal() functions with constants.",
"body": "The constants are applicable in more cases and allow the compiler to optimize certain loops more efficiently."
},
{
"commit": "59fd92fdd5c39f0c48897513a2d01205efa278e4",
"date": "2017-12-03 17:08:49 -0500",
"subject": "Move restore test infrastructure to HostBackup.pm.",
"body": "Required to test restores on the backup server, a fairly common scenario.\n\nImprove the restore function to accept optional parameters rather than a long list of parameters. In passing, clean up extraneous use of strType and strComment variables."
},
{
"commit": "915ae5662abc9a0e31e03d56bf27b739ed8b263b",
"date": "2017-11-28 21:44:05 -0500",
"subject": "Implement version command in C."
},
{
"commit": "bd74711ceb1d3faf49f0349d4dbef4f4cd8434ba",
"date": "2017-11-28 11:44:24 -0500",
"subject": "Add unit tests for the Manifest module.",
"body": "Also minor changes to Manifest module, mostly for test reproducibility."
},
{
"commit": "4a0eb6863d3517151fdec6b450bac2fa2c7ddfb4",
"date": "2017-11-27 22:16:24 -0500",
"subject": "Sync time to prevent build failures when running on VirtualBox."
},
{
"commit": "332861c6c95966b38b457b785c2a8db39d205648",
"date": "2017-11-27 21:19:59 -0500",
"subject": "Only build C binary/library for Perl unit/integration tests."
},
{
"commit": "2ed426a70b5659cbf1628eb4aaf8c7994580ea63",
"date": "2017-11-27 20:43:44 -0500",
"subject": "Remove deprecated archive-max-mb option."
},
{
"commit": "c5ea53bcf9a07cd07bb077a5764b3cc164e8424b",
"date": "2017-11-27 16:02:49 -0500",
"subject": "Add coding standards document."
},
{
"commit": "74d6398ad2a893b1413c8202814c6284846087da",
"date": "2017-11-26 18:43:51 -0500",
"subject": "The pgbackrest executable is now a C binary instead of Perl.",
"body": "This allows certain time-critical commands (like async archive-push) to run more quickly."
},
{
"commit": "4d8ad4ac18498835107a26f1a442429ac9dcf50c",
"date": "2017-11-26 18:23:11 -0500",
"subject": "Add List and StringList objects to simplify list handling."
},
{
"commit": "1b3e8e0a5bd8a343a78ecfb51f78d22b405b9a9f",
"date": "2017-11-26 17:49:10 -0500",
"subject": "Add String object to simplify string handling."
},
{
"commit": "7cf955425ef998ba198f9668f69c2052c089dcd8",
"date": "2017-11-26 17:45:00 -0500",
"subject": "The C library is now required.",
"body": "This eliminates conditional loading and eases development of new library features."
},
{
"commit": "c164fc5fb906d73fcc4d5dcfd960d62caa57effb",
"date": "2017-11-26 12:22:50 -0500",
"subject": "Add memGrowRaw() to memory context module."
},
{
"commit": "c360ca5a08ecd812610a0a26414e650da6b4b50e",
"date": "2017-11-25 20:32:35 -0500",
"subject": "Split \"refactor\" sections into \"improvements\" and \"development\" in the release notes.",
"body": "Many development notes are not relevant to users and simply clutter the release notes, so they are no longer shown on the website."
},
{
"commit": "13893a97313757162e061b855bbd494abdbec8ce",
"date": "2017-11-21 19:52:56 -0500",
"subject": "Relax permissions set by release.pl."
},
{
"commit": "ba6b49ecb7226e5dab0990403afa6f8878048e35",
"date": "2017-11-21 18:31:54 -0500",
"subject": "v1.26: Repository Encryption"
},
{
"commit": "033dbcdc208657e3569c0197ec98e9ff1a052ff1",
"date": "2017-11-21 17:59:30 -0500",
"subject": "Update release.pl to push data to site repository."
},
{
"commit": "ac54aac448e1ed84f6d083fcf95158619d729be3",
"date": "2017-11-21 13:17:44 -0500",
"subject": "Fixed an issue passing parameters to remotes.",
"body": "When more than one db was specified the path, port, and socket path would for db1 were passed no matter which db was actually being addressed."
},
{
"commit": "c77fc1fa61582e1983324e7caa5b573fc0eae5e8",
"date": "2017-11-21 12:57:00 -0500",
"subject": "Refactor protocol param generation into a new function.",
"body": "This allows the code to be tested more precisely and doesn't require executing a remote process."
},
{
"commit": "062e714307de357ae49bcac8c48e397b1debfa0f",
"date": "2017-11-21 09:31:15 -0500",
"subject": "Disable gzip filter when --compress-level-network=0.",
"body": "The filter was used with compress level set to 0 which added overhead without any benefit."
},
{
"commit": "1da63aff07de90cd7734b5afd2674b1452c59cf3",
"date": "2017-11-20 12:46:35 -0500",
"subject": "Fixed an issue with invalid backup groups being set correctly on restore.",
"body": "If the backup cannot map a group to a name it stores the group in the manifest as false then uses either the owner of $PGDATA to set the group during restore or failing that the group of the current user. This logic was not working correctly because the selected group was overwriting the user on restore leaving the group undefined and the user incorrectly set to the group. (Reported by Jeff McCormick.)"
},
{
"commit": "8ccfaa9ad366802525cbf1053af2226f2789b493",
"date": "2017-11-20 09:05:55 -0500",
"subject": "Designate a single distro (Ubuntu 16.04) for C coverage testing",
"body": "Enable optimizations on the distros that don't do coverage testing."
},
{
"commit": "deae0b8cd7ec102babf584698b15e73a7822283c",
"date": "2017-11-20 08:58:47 -0500",
"subject": "Refactor C page checksum unit test to compile with -Wstrict-aliasing."
},
{
"commit": "5d741ea9a9993397bd7aa6602ff8562302d82c8e",
"date": "2017-11-19 16:46:31 -0500",
"subject": "Refactor C unit test macros so they compile with -Wstrict-aliasing."
},
{
"commit": "3b43047e0d40ea7e00049df77d20f26498c89be1",
"date": "2017-11-19 16:44:33 -0500",
"subject": "Disable -Wclobber compiler warning.",
"body": "...because it is mostly useless but keep the rest of of -Wextra."
},
{
"commit": "dc1a5c18acfef55f8d4cdfa21e9543975070b373",
"date": "2017-11-19 16:30:23 -0500",
"subject": "Wrap try in a do...while loop to make sure that no random else is attached to the main if block."
},
{
"commit": "9395ad7043d4d7ef8a687e0baa5d25e98d553112",
"date": "2017-11-18 22:49:43 -0500",
"subject": "Improve base64 implementation.",
"body": "Different encoded strings could be generated based on compiler optimizations. Even though decoding was still successful the encoded strings did not match the standard."
},
{
"commit": "500d6b4b66fab197ae39db2d3f79a3e7ef29f66c",
"date": "2017-11-18 20:14:14 -0500",
"subject": "Automated tests for 32-bit i386/i686 architecture."
},
{
"commit": "8a3425ec04fea8c0876df0420d5dd3e318812c4e",
"date": "2017-11-18 20:02:54 -0500",
"subject": "Automate generation of WAL and pg_control test files.",
"body": "The existing static files would not work with 32-bit or big-endian systems so create functions to generate these files dynamically rather than creating a bunch of new static files."
},
{
"commit": "b701cd5a5f43ffd5b39df5298bd66ea886dedbdd",
"date": "2017-11-18 19:53:41 -0500",
"subject": "Designate a single distro (Ubuntu 16.04) for Perl coverage testing.",
"body": "Running coverage testing on multiple distros takes time but doesn't add significant value. Also ensure that the distro designated to run coverage tests is one of the default test distros."
},
{
"commit": "6ef2167e972039e67668d7f7700aab505d0ea595",
"date": "2017-11-16 17:18:51 -0500",
"subject": "Fixed an issue retrieving WAL for old database versions.",
"body": "After a stanza-upgrade it should still be possible to restore backups from the previous version and perform recovery with archive-get. However, archive-get only checked the most recent db version/id and failed.\n\nAlso clean up some issues when the same db version/id appears multiple times in the history.\n\nFixed by Cynthia Shang.\nReported by Clinton Adams."
},
{
"commit": "550d4fb9c591a269253a675f6f3585a777ea9b33",
"date": "2017-11-16 16:53:49 -0500",
"subject": "Fix incorrect WAL offset for 32-bit architectures.",
"body": "Fixed by Javier Wilson."
},
{
"commit": "1cb11a582de59480af3a5f656dbb0ec3da14e854",
"date": "2017-11-15 13:17:57 -0500",
"subject": "Fix flapping protocol timeout test.",
"body": "It only matters that the correct error code is returned, so disable logging to prevent message ordering from failing the expect test."
},
{
"commit": "bc8543494a07ef126b0d223e7a90da22a26389e8",
"date": "2017-11-15 11:59:27 -0500",
"subject": "Add template to improve initial information gathered for issue submissions.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "22fe684b1fe213df6c9a74a7c0bec4aa6eed3837",
"date": "2017-11-14 17:16:39 -0500",
"subject": "Only check expect logs on CentOS 7.",
"body": "Variations in distros cause false negatives in tests but don't add much value."
},
{
"commit": "3ee269c0998ea3bbf96ccbcc04857ba6b9789146",
"date": "2017-11-14 17:07:22 -0500",
"subject": "Add encryption to features list."
},
{
"commit": "b8746f368dbd76eee19e4c3fecc6853696be1908",
"date": "2017-11-14 15:12:31 -0500",
"subject": "Inflate performance improvement for gzip filter and full unit test coverage."
},
{
"commit": "04e55fe71bea32b2666df59a9891362ea6717964",
"date": "2017-11-14 14:48:44 -0500",
"subject": "Fixed an issue that could cause copying large manifests to fail during restore.",
"body": "Reported by Craig A. James."
},
{
"commit": "cf7da546a3b7c1395faf2958f45572f82fe0127a",
"date": "2017-11-13 21:22:13 -0500",
"subject": "Simplify try..catch..finally names."
},
{
"commit": "bcdfc7d0b52dc92ae22aef1c93bbfda7e6fa24f3",
"date": "2017-11-06 22:55:34 -0500",
"subject": "Enable additional warnings for C builds."
},
{
"commit": "b03c26968a2817df33b60c8240cbe2c037281783",
"date": "2017-11-06 12:51:12 -0500",
"subject": "Repository encryption support.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "f07d2a3d0dbfa7ea510e41a9ea66265b46db1158",
"date": "2017-11-06 12:40:54 -0500",
"subject": "Add eof to S3 file driver (required for encryption support)."
},
{
"commit": "8d6a08a32b1221db5b6eae0db615731d19754bc8",
"date": "2017-11-03 13:57:58 -0400",
"subject": "Library code for repository encryption support."
},
{
"commit": "ac542788da8264e39b3f3d817535df918f65a342",
"date": "2017-11-02 08:14:13 -0400",
"subject": "Convert configuration definitions from auto-generated functions to auto-generated data structures."
},
{
"commit": "2be93036f1c8de73414650fd6c6710e2f2b9fc73",
"date": "2017-10-30 14:18:05 -0400",
"subject": "Clarify usage of the archive-timeout option.",
"body": "Also describe how it is distinct from the PostgreSQL archive_timeout setting."
},
{
"commit": "55f68ef0136362be1ee8dbe3dabd1b3132e485d1",
"date": "2017-10-30 10:58:04 -0400",
"subject": "Remove configurable option hints.",
"body": "db-path was the only option with a hint so the feature seemed wasteful. All missing stanza options now output the same hint without needing configuration."
},
{
"commit": "1ef27ec8c2273fce99685c9354a6778d14a54792",
"date": "2017-10-30 10:50:35 -0400",
"subject": "Add list type for options.",
"body": "The hash type was being used for lists with an additional flag (`value-hash`) to indicate that it was not really a hash."
},
{
"commit": "f57e376c4489cba94b5dba443e6421b085ef9ea4",
"date": "2017-10-30 09:29:46 -0400",
"subject": "Update Debian/Ubuntu containers to download lastest version of pip."
},
{
"commit": "85b35f30a4a4ea07e92ad5ded6ce73bc2937f0ef",
"date": "2017-10-24 17:36:21 -0400",
"subject": "v1.25: S3 Performance Improvements"
},
{
"commit": "8674a4f7aea3bea2db7e92be599c034170b81706",
"date": "2017-10-24 12:35:36 -0400",
"subject": "Allow functions with sensitive options to be logged at debug level with redactions.",
"body": "Previously, functions with sensitive options had to be logged at trace level to avoid exposing them. Trace level logging may still expose secrets so use with caution."
},
{
"commit": "b2cc65d886a5c1fe4845f655c53b0c809beefb72",
"date": "2017-10-24 10:35:42 -0400",
"subject": "Improve performance of test code.",
"body": "Wait when all tests have been assigned to reduce CPU load."
},
{
"commit": "d989cf8ac21e0978174cc94747965743f252a45d",
"date": "2017-10-22 19:07:17 -0400",
"subject": "Replace dynamically built class hierarchies in I/O layer with fixed parent() calls."
},
{
"commit": "d82fe88031a3c9ca88bd70652bc4f9fc0e12d4bf",
"date": "2017-10-22 18:05:46 -0400",
"subject": "Fix custom settings for compress-level option being ignored.",
"body": "Reported by Jens Wilke."
},
{
"commit": "3553ccae449b7b9ad71290234e55c57d9c9455a5",
"date": "2017-10-22 13:27:47 -0400",
"subject": "Add I/O performance tests."
},
{
"commit": "9b98c2e7d6492b626267ffa0c50c67922dd43bda",
"date": "2017-10-22 13:11:03 -0400",
"subject": "Run all tests on tempfs rather than local disk."
},
{
"commit": "e1cb9ae86a596d0c1e833ba60730e65805c4ef4f",
"date": "2017-10-21 14:40:14 -0400",
"subject": "Improve labeling for errors in helper processes."
},
{
"commit": "44c7c0475ad30873075751ea23083861fe53278a",
"date": "2017-10-21 14:11:33 -0400",
"subject": "Improve protocol error handling.",
"body": "In particular, \"stop\" errors are no longer reported as \"unexpected\"."
},
{
"commit": "1f120f3fce1f8f30739a0cc178e8eea2053fd2f2",
"date": "2017-10-20 14:10:16 -0400",
"subject": "Improve performance of list requests on S3.",
"body": "Any beginning literal portion of a filter expression is used to generate a search prefix which often helps keep the request small enough to avoid rate limiting."
},
{
"commit": "f4524aeaa92baf2cdae2125c87661036e2bdc0a0",
"date": "2017-10-18 11:14:26 -0400",
"subject": "Add base64 encode/decode."
},
{
"commit": "2d56de00fcb04f2f949c1855f68cbeee25cdee6f",
"date": "2017-10-18 08:42:32 -0400",
"subject": "Fix instances where database-id was not rendered as an integer in JSON info output.",
"body": "Fixed by Cynthia Shang.\nReported by Jason O'Donnell."
},
{
"commit": "b1efd598cfe82c02db1a5943cd900dfc4be28e05",
"date": "2017-10-16 18:21:47 -0400",
"subject": "Add PostgreSQL versions to Debian VMs for testing."
},
{
"commit": "c94e52f697cdae67c35fe8cb0f95088029231b95",
"date": "2017-10-16 14:34:44 -0400",
"subject": "Remove error when overlapping timelines are detected.",
"body": "Overlapping timelines are valid in many Point-in-Time-Recovery (PITR) scenarios."
},
{
"commit": "583a76f605cd49d03fe2fe4a756e7de08966a62d",
"date": "2017-10-16 11:25:49 -0400",
"subject": "Add C memory contexts."
},
{
"commit": "6f5186f9e620693815133dc1444c0b627a3ab6a1",
"date": "2017-10-16 11:13:51 -0400",
"subject": "Convert config tests into C unit tests."
},
{
"commit": "9d78948a14b20813201b5bf7f21e3525577aa7dc",
"date": "2017-10-16 11:03:06 -0400",
"subject": "Improvements to page checksum module and tests:",
"body": "* Page checksum module uses new C error handler.\n* Convert page checksum tests into C unit tests."
},
{
"commit": "80758f002311dd58497f95a5fd9a8f9de92920e8",
"date": "2017-10-16 10:54:35 -0400",
"subject": "Add test macros for C results and errors."
},
{
"commit": "904b83747cd8140aa64a0eb2ac598cc8c1cf310b",
"date": "2017-10-16 10:47:31 -0400",
"subject": "Perl error handler recognizes errors thrown from the C library."
},
{
"commit": "f1e739b4aa85f4b57613b8191e29c2abd303ed8e",
"date": "2017-10-16 10:09:56 -0400",
"subject": "Add C error handler.",
"body": "Basic try ... catch ... finally pattern to simplify error handling in C."
},
{
"commit": "10dfbd90b5c3af6ebb6c651760d2d62ced738b84",
"date": "2017-10-12 12:55:48 -0400",
"subject": "Add C unit test infrastructure."
},
{
"commit": "08d6f14603e7248dd7cc865129527963d9e3df49",
"date": "2017-10-10 18:21:44 -0400",
"subject": "Add LibC.template.pm to simplify LibC module generation."
},
{
"commit": "abea4d1fd5f8cd2a8e0c8625dbb3d700b5317cc7",
"date": "2017-10-05 12:33:13 -0400",
"subject": "Remove Debian test repo after PostgreSQL 10 release."
},
{
"commit": "d89b7d5862201051732274f622742888dbf09315",
"date": "2017-09-30 10:48:25 -0400",
"subject": "Warnings in C builds treated as errors."
},
{
"commit": "8efcc38304dae4e224ae1ac0211ed03691ae5c8a",
"date": "2017-09-30 10:44:03 -0400",
"subject": "Improvements in C codebase:",
"body": "* Update C naming conventions.\n* Use int datatype wherever possible.\n* Better separation of C source from Perl interface."
},
{
"commit": "d0bf946857d73dcca2ce2a7bf0b78fd8aee2a19b",
"date": "2017-09-28 19:06:41 -0400",
"subject": "v1.24: New Backup Exclusions"
},
{
"commit": "40a85e34f1b12620b5520f620779396b7ead525a",
"date": "2017-09-20 19:57:05 -0400",
"subject": "Improve C library smart build.",
"body": "Ignore changes outside of /lib/pgBackRest/Config."
},
{
"commit": "4d6c56b4d76572f5a45a45ca8f55ddc269d2d6d1",
"date": "2017-09-20 08:08:36 -0400",
"subject": "Open log file after async process is completely separated from the main process.",
"body": "This prevents the main process from also logging to the file."
},
{
"commit": "266c9ddcc12c377dd2b3d90b79468eaa6c22f101",
"date": "2017-09-19 10:14:18 -0400",
"subject": "Fixed an issue where some db-* options (e.g. db-port) were not being passed to remotes."
},
{
"commit": "c857015a38edd6db641987f8084930f59cfb9309",
"date": "2017-09-19 10:03:53 -0400",
"subject": "Fixed an issue where warnings were being emitted in place of lower priority log messages during backup from standby initialization."
},
{
"commit": "d36c52271f994fc6332c40c9a101f9451ccb7266",
"date": "2017-09-17 15:52:19 -0400",
"subject": "Break up LibC.xs into separate module files."
},
{
"commit": "20af8ecf505f3b8b490dfb76969d5e39dabf0362",
"date": "2017-09-17 14:49:23 -0400",
"subject": "Dynamically generate list of files for C library build."
},
{
"commit": "7c95a2f4de43905bc7b22afbc8d70432156bc033",
"date": "2017-09-08 21:50:00 -0700",
"subject": "Updates to installation documentation.",
"body": "* Add trusted SSH configuration.\n* Add full installation where required and remove doc containers that included parts of the installation."
},
{
"commit": "4bcef7020ee25104b687580a7089a06d4b597cf8",
"date": "2017-09-07 10:59:40 -0700",
"subject": "Rename master to primary in documentation to align with PostgreSQL convention."
},
{
"commit": "6343fdd5846ef05d9f4883d8ffd09e0b47f744ce",
"date": "2017-09-04 08:26:57 -0400",
"subject": "Additional backup exclusions.",
"body": "* Exclude contents of pg_snapshots, pg_serial, pg_notify, and pg_dynshmem from backup since they are rebuilt on startup.\n* Exclude pg_internal.init files from backup since they are rebuilt on startup."
},
{
"commit": "df1ec0aaeb02fb1359f5f893dad8af06c2e05eeb",
"date": "2017-09-03 17:42:00 -0400",
"subject": "v1.23: Multiple Standbys and PostgreSQL 10 Support"
},
{
"commit": "eea2ccc3ab52ee588d6f894d291931bd9aa52147",
"date": "2017-09-03 16:48:41 -0400",
"subject": "Add HTTP retries to harden against transient S3 network errors."
},
{
"commit": "80e5e8db01b97ad7878817152d2a9a933d59d415",
"date": "2017-09-01 19:16:57 -0400",
"subject": "Increase HTTP timeout for S3."
},
{
"commit": "75511d24813266b87a7b65e25141f2fd6b1dd78a",
"date": "2017-09-01 15:07:20 -0400",
"subject": "Allow content-length (in addition to chunked encoding) when reading XML data to improve compatibility with third-party S3 gateways.",
"body": "Suggested by Victor Gdalevich."
},
{
"commit": "fcb7c6fd1d0f37ed371079537b95899eaac44812",
"date": "2017-09-01 12:29:34 -0400",
"subject": "PostgreSQL 10 support."
},
{
"commit": "36e576b4839d5d9323597014d6f478def7308d9e",
"date": "2017-08-31 19:15:44 -0400",
"subject": "Up to seven standbys can be configured for backup from standby.`",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "206415d4c754053275666bfcc0eb138f39884c21",
"date": "2017-08-30 16:34:05 -0400",
"subject": "Fixed an issue that could cause compression to abort on growing files.",
"body": "Reported by Jesper St John, Aleksandr Rogozin."
},
{
"commit": "81ffd094455fb006993a3b9e65c801c127454dc7",
"date": "2017-08-30 08:41:46 -0400",
"subject": "Fixed an issue with keep-alives not being sent to the remote from the local process.",
"body": "Reported by William Cox."
},
{
"commit": "1e0ed074555df7d9079fdf52c4b6b5b049b6d155",
"date": "2017-08-25 16:47:47 -0400",
"subject": "Configuration rules are now pulled from the C library when present."
},
{
"commit": "8d3436bce775845d45eaf8b55e526ad784e54e0f",
"date": "2017-08-19 09:02:24 -0400",
"subject": "Merge release 2 container build changes."
},
{
"commit": "7dab459cacd9e1b5934294176e5929a86f7b48de",
"date": "2017-08-19 08:48:13 -0400",
"subject": "Simplified smart logic for C Library and package builds."
},
{
"commit": "1be69d5ac71db241f0c41bf28c4c36c5cc0b32c4",
"date": "2017-08-16 16:54:35 -0400",
"subject": "Fixed document generation to include section summaries on the Configuration page.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "1d2b08ce94d31e2d0a19cb7f489d73e2e04700d2",
"date": "2017-08-11 18:43:21 -0400",
"subject": "Move contributor list to the end of release.xml for convenience."
},
{
"commit": "4c2c612b6f68001b2cf0ccd29b02648f0f11ae8c",
"date": "2017-08-11 18:38:40 -0400",
"subject": "Ignore auto-generated C code created by release 2."
},
{
"commit": "4331e09376a124e597c4a0e8e4c9641239f8f64e",
"date": "2017-08-11 18:31:25 -0400",
"subject": "Drain stderr during test process execution as well as termination to prevent lockups if there is a lot of output."
},
{
"commit": "f8de73674c5e97bd7103a4892ce4d17cc12d1173",
"date": "2017-08-10 20:52:29 -0400",
"subject": "Updated Docker build in Vagrantfile."
},
{
"commit": "ac1574448e8b6e2a6b6c3690f3998aac35e4d40d",
"date": "2017-08-10 18:11:29 -0400",
"subject": "Changed log test order to ignore unimportant log errors while shutting down PostgreSQL."
},
{
"commit": "84caca0f341982d7d61d1c310faf5c6a3a601a48",
"date": "2017-08-09 11:50:02 -0400",
"subject": "v1.22: Fixed S3 Retry"
},
{
"commit": "61c38f58085ebe5ad769bf5937c41793deafc884",
"date": "2017-08-09 11:27:09 -0400",
"subject": "Fixed authentication issue in S3 retry."
},
{
"commit": "cbc026418cdc03bbe645a3c44ccf9e40435c62ca",
"date": "2017-08-08 18:09:07 -0400",
"subject": "v1.21: Improved Info Output and SSH Port Option"
},
{
"commit": "038d47bcc05d3de5b377c330576bcc76648ccb8b",
"date": "2017-08-08 17:15:01 -0400",
"subject": "Retry when S3 returns an internal error (500)."
},
{
"commit": "961f7033d1f82f279e02500506a255c58064fe55",
"date": "2017-08-08 16:26:44 -0400",
"subject": "Generate global fake cert in containers for testing."
},
{
"commit": "b6da509c9f909bcbd1c76b6b920b78e5945b9d1e",
"date": "2017-08-04 16:10:51 -0400",
"subject": "Consolidate stanza-create and stanza-upgrade tests into new stanza test.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "f9bdc092bac8cdfe1c7145c0adf1123ae2ea6dd1",
"date": "2017-08-04 16:03:55 -0400",
"subject": "Fixed an issue that could cause the empty archive directory for an old PostgreSQL version to be left behind after a stanza-upgrade.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "ce2b18c5b84c506606861010331965ad503af48a",
"date": "2017-08-01 10:34:53 -0400",
"subject": "Added --backup-ssh-port and --db-ssh-port options to support non-default SSH ports.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "fa992433da396f8fe3a3c49dfd539d4dd6c54ae1",
"date": "2017-07-27 11:31:42 -0400",
"subject": "Update CI code to prevent deprecated VM from being rewritten."
},
{
"commit": "cf3110b0d896c75db775f6b2296c704a54d61142",
"date": "2017-07-26 19:22:54 -0400",
"subject": "Use new Travis Trusty image."
},
{
"commit": "14d6974d1b54977ab678d0967c6fa8275b0959c7",
"date": "2017-07-26 13:40:09 -0400",
"subject": "Use Google DNS in test environment for consistency."
},
{
"commit": "97c4d9ec1874fa2acbb33d6442d62089be07786b",
"date": "2017-07-26 10:22:22 -0400",
"subject": "Reduce log verbosity in doc.pl.",
"body": "Reduce verbosity by only logging sections that contain an execute list directly or in a child section."
},
{
"commit": "df7d63368396c1030e178621136f0b304f970987",
"date": "2017-07-26 09:33:10 -0400",
"subject": "Improvements to command/command-line help:",
"body": "* Move repository options into a separate section in command/command-line help. (Suggested by Stephen Frost.)\n* Fix description of --online based on the command context.\n* Remove vestigial repository options from backup command."
},
{
"commit": "156fd4d54d2387767d298dd295518f847788f845",
"date": "2017-07-25 12:44:38 -0400",
"subject": "Add bIgnoreMissing parameter to Local->manifest()."
},
{
"commit": "49449feab3d13fa6aedd5271d60e55f3720e8f08",
"date": "2017-07-24 21:14:42 -0400",
"subject": "Add creation of /etc/pgbackrest.conf to manual installation instructions."
},
{
"commit": "cbb749e12a6c752d9172d7038f3f683c84d50d03",
"date": "2017-07-24 21:12:05 -0400",
"subject": "Debian/Ubuntu documentation now builds on Ubuntu 16."
},
{
"commit": "d5c1f02c7289284cb0cd7bd5c79e9e6a2dc8fb69",
"date": "2017-07-24 07:57:47 -0400",
"subject": "Include archive_status directory in online backups.",
"body": "The archive_status directory is now recreated on restore to support PostgreSQL 8.3 which does not recreate it automatically like more recent versions do.\n\nAlso fixed log checking after PostgreSQL shuts down to include FATAL messages and disallow immediate shutdowns which can throw FATAL errors in the log."
},
{
"commit": "cda3b9821b83b3cc96ad13b63483499ff5a52e42",
"date": "2017-07-21 17:32:41 -0400",
"subject": "Improved WAL data returned by info command.",
"body": "Modified the info command (both text and JSON output) to display the archive ID and minimum/maximum WAL currently present in the archive for the current and prior, if any, database cluster version."
},
{
"commit": "33d769e14786098b6fa02e666c624531dc7d5bea",
"date": "2017-06-27 22:42:31 -0400",
"subject": "v1.20: Critical 8.3/8.4 Bug Fix"
},
{
"commit": "884413b251935aa7c1f82758a34c37664c200b82",
"date": "2017-06-27 22:27:48 -0400",
"subject": "Remove mount and user from host cache-key because it can vary by system."
},
{
"commit": "7759a94fa2ac0af8ef037c466808685b091c2cc2",
"date": "2017-06-27 18:29:48 -0400",
"subject": "Add Debian 9 to test suite."
},
{
"commit": "9e9286ee205e7202bed7fc0d688e43949c3a687c",
"date": "2017-06-27 18:00:39 -0400",
"subject": "Add performance module and basic performance test for archive-push."
},
{
"commit": "9e248a66279eab87c18040917f5bdcd94075e6c2",
"date": "2017-06-27 17:54:30 -0400",
"subject": "Minor optimizations to package loads and ordering for archive-get and archive-push commands."
},
{
"commit": "f3b62d2d671592881f5e646b100604020fa52e70",
"date": "2017-06-27 17:07:12 -0400",
"subject": "Fixed misleading error message when a file was opened for write in a missing directory."
},
{
"commit": "2310e423e98259838826ccc8093e43668fab061a",
"date": "2017-06-27 16:47:40 -0400",
"subject": "Fixed an issue that prevented tablespaces from being backed up on PostgreSQL ≤ 8.4.",
"body": "The integration tests that were supposed to prevent this regression did not work as intended. They verified the contents of a table in the (supposedly) restored tablespace, deleted the table, and then deleted the tablespace. All of this was deemed sufficient to prove that the tablespace had been restored correctly and was valid.\n\nHowever, PostgreSQL will happily recreate a tablespace on the basis of a single full-page write, at least in the affected versions. Since writes to the test table were replayed from WAL with each recovery, all the tests passed even though the tablespace was missing after the restore.\n\nThe tests have been updated to include direct comparisons against the file system and a new table that is not replayed after a restore because it is created before the backup and never modified again.\n\nVersions ≥ 9.0 were not affected due to numerous synthetic integration tests that verify backups and restores file by file."
},
{
"commit": "fdabf33604cdc5f253187d559b3d4be52c2d843d",
"date": "2017-06-27 15:58:02 -0400",
"subject": "Revert removal of Ubuntu 12.04 and PostgreSQL 8.3."
},
{
"commit": "001cff9eb990cf246df42c7d06f5e377da313299",
"date": "2017-06-27 15:48:34 -0400",
"subject": "Automatically check that all supported PostgreSQL versions are being tested on a single default VM."
},
{
"commit": "7a1385cc2716de93b7f0388ea2017dfa1a8734a4",
"date": "2017-06-24 18:04:02 -0400",
"subject": "Add documentation builds to CI."
},
{
"commit": "7a9b1f69937f5866ab0bc888d700527fda460d47",
"date": "2017-06-24 10:59:00 -0400",
"subject": "Container build improvements:",
"body": "* More optimized container suite that greatly improves build time.\n* Added static Debian packages for Devel::Cover to reduce build time.\n* Add deprecated state for containers. Deprecated containers may only be used to build packages.\n* Remove Debian 8 from CI because it does not provide additional coverage over Ubuntu 14.04 and Ubuntu 16.04."
},
{
"commit": "53184a7b30c7b3000a4be8af90c9419b22fae3e2",
"date": "2017-06-23 10:30:22 -0400",
"subject": "Update CentOS 6 documentation to build on PostgreSQL 9.5."
},
{
"commit": "3d224ad8fa54f007032a5a2c6077c004c4d7c395",
"date": "2017-06-23 10:10:48 -0400",
"subject": "Improve S3 server implementation in documentation."
},
{
"commit": "eb4325fa9ac8b6e3da6344d561a861651a4b23f9",
"date": "2017-06-22 19:04:52 -0400",
"subject": "Remove exhaustive version list from Stable Releases TOC."
},
{
"commit": "a10a22127d025367655037c1ca9fee0dde248e3c",
"date": "2017-06-22 18:51:39 -0400",
"subject": "Consolidate archive-get test into new archive test."
},
{
"commit": "918c1c6f490d3097c46e27fa0226c3fa3b08ec9b",
"date": "2017-06-22 18:22:49 -0400",
"subject": "Add s3-repo-ca-path and s3-repo-ca-file options.",
"body": "The options accommodate systems where CAs are not automatically found by IO::Socket::SSL, i.e. RHEL7, or to load custom CAs."
},
{
"commit": "6327799c9ae828a56f7f8686d3e35da2441a6e15",
"date": "2017-06-22 18:13:59 -0400",
"subject": "Use old trusty image until new image works with RHEL6."
},
{
"commit": "a1a5d18aa436d50f3dff4e845bad51855168071b",
"date": "2017-06-22 14:44:21 -0400",
"subject": "Balance database versions between VMs to minimize test duration."
},
{
"commit": "d3054d919b6efc831c9a5a596496e0be80309bc7",
"date": "2017-06-22 12:57:10 -0400",
"subject": "Fixed missing flag in C library build.",
"body": "The missing flag resulted in a mismatched binary on 32-bit systems."
},
{
"commit": "f8849d735937c16211b0cc905de22088ae467ec6",
"date": "2017-06-22 12:37:21 -0400",
"subject": "Remove patch directory before Debian package builds.",
"body": "Patches should be merged into master before trying a new build after a release with patches."
},
{
"commit": "f596702c5badb5dbd3b15b6c4ee0e54444ab6e8c",
"date": "2017-06-21 20:46:49 -0400",
"subject": "Improve S3 error reporting."
},
{
"commit": "8b9965abcb30421157e11ecc5969bcffbbed93a5",
"date": "2017-06-21 19:21:16 -0400",
"subject": "Remove process-max option.",
"body": "Parallelism is now tested in a more targeted manner and the high level option is no longer needed."
},
{
"commit": "234869338913ab411baa33b58f28e8d460c74335",
"date": "2017-06-21 18:47:25 -0400",
"subject": "Reduce process redundancy in mock tests."
},
{
"commit": "cc0e3f843e0bf3c4982af6423d07f527cc8fd617",
"date": "2017-06-21 17:24:36 -0400",
"subject": "Remove support for PostgreSQL 8.3."
},
{
"commit": "73274fc608d7aa4c93af645a85bcbceb3f276847",
"date": "2017-06-21 17:02:01 -0400",
"subject": "Remove Ubuntu 12.04 from CI now that it is EOL (it can still be run manually)."
},
{
"commit": "c69baa2de1ed4d00a87f90634c347e730f3babc3",
"date": "2017-06-21 16:51:41 -0400",
"subject": "Install sudo in base containers rather than on demand."
},
{
"commit": "64ec7eb49077421f28dbd3cf889e68fc226a4f3d",
"date": "2017-06-21 16:07:13 -0400",
"subject": "Eliminate redundancy in real tests."
},
{
"commit": "edada218660a67bd4e87e8450e2491eb2bb47a5c",
"date": "2017-06-21 08:45:58 -0400",
"subject": "Rename archive-push unit test.",
"body": "This is part of the archive consolidation but is committed separately so that git will follow the rename."
},
{
"commit": "2337be863690c73fc2e141191a3167d959c35263",
"date": "2017-06-21 08:38:53 -0400",
"subject": "Consolidate archive-push tests into new archive test."
},
{
"commit": "11ee528e0e11a849612c67dcb297c35c29995c11",
"date": "2017-06-21 08:02:21 -0400",
"subject": "Rename Archive modules to remove redundancy."
},
{
"commit": "692b1e274adb9f1f23e3d29d127af521a53a27e9",
"date": "2017-06-19 18:55:00 -0400",
"subject": "Split full module into mock and real to allow better test combinations and save time in CI."
},
{
"commit": "f6d4457d58b3f752dadd14c9e341ff86910f72b3",
"date": "2017-06-15 15:32:10 -0400",
"subject": "Full/Synthetic test refactor.",
"body": "* Combine hardlink and non/compressed in synthetic tests to reduce test time and improve coverage.\n* Change log level of hardlink logging to detail.\n* Cast size in S3 manifest to integer."
},
{
"commit": "269ae4556d00da463d43ef95aaa461821e77f4f3",
"date": "2017-06-15 15:20:02 -0400",
"subject": "Fix timeouts in ExecuteTest to speed multi-process testing."
},
{
"commit": "6e29f616b347b66c62c36adf019a7a4d42e4bdac",
"date": "2017-06-15 15:12:28 -0400",
"subject": "Harden protocol handshake to handle race conditions."
},
{
"commit": "c10c5bb0ef1de519371e1bdae0b9da7cf8670c95",
"date": "2017-06-12 11:36:00 -0400",
"subject": "v1.19: S3 Support"
},
{
"commit": "051c961151e75114c59980e9feb883a8d58dc7b0",
"date": "2017-06-12 10:52:32 -0400",
"subject": "S3 repository support."
},
{
"commit": "de7fc37f88f670a1b4b4f95ff354384f37d983b1",
"date": "2017-06-09 17:51:41 -0400",
"subject": "Storage and IO layer refactor:",
"body": "Refactor storage layer to allow for new repository filesystems using drivers. (Reviewed by Cynthia Shang.)\nRefactor IO layer to allow for new compression formats, checksum types, and other capabilities using filters. (Reviewed by Cynthia Shang.)"
},
{
"commit": "7e982f05f564e560b6ca23f61365fc7f11a5da36",
"date": "2017-05-16 11:28:51 -0400",
"subject": "Fixed config warnings raised from a remote process causing errors in the master process.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "74053ed842a4f3c37ce3fa2c9b6e32b4f5aa36e6",
"date": "2017-05-16 11:15:31 -0400",
"subject": "Fixed missing sudo in installation section.",
"body": "Fixed by Lætitia."
},
{
"commit": "529674727148a7ec6d04ef6bd3ec86f69575f6f2",
"date": "2017-05-15 16:01:00 -0400",
"subject": "Move backup modules into Backup directory."
},
{
"commit": "2a23157bf2912bbcdbfe5350ca40ca398cc1001e",
"date": "2017-05-15 11:12:14 -0400",
"subject": "Move modules in Protocol directory in subdirectories."
},
{
"commit": "33c87b2a1ccbaf43f56765285ac4918f4b1cdf1c",
"date": "2017-05-15 10:24:46 -0400",
"subject": "Remove flapping protocol timeout test that will be replaced in the upcoming storage patch."
},
{
"commit": "c31da3f961b9494cb8f8f351d8a4cf7f22557062",
"date": "2017-05-12 16:43:04 -0400",
"subject": "Moved test and env modules to new directories to avoid namespace conflicts with common tests."
},
{
"commit": "4049d59c9e1c4abaa0d96ce0fc307139d1b32a64",
"date": "2017-05-12 16:27:06 -0400",
"subject": "Fixed issue with --dry-run requiring --vm-out to work properly."
},
{
"commit": "7d0c50fcd6dd6d7800b53ae2a1abf35f923ec7da",
"date": "2017-05-12 16:05:44 -0400",
"subject": "Fixed the backup command so the backup-standby option is reset (and the backup proceeds on the master) if the standby is not configured and/or reachable.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "5bf4f52e3d1ddb3cacb6821080b59e378baf4cb1",
"date": "2017-05-12 15:49:14 -0400",
"subject": "Fixed the info command so the WAL archive min/max displayed is for the current database version.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "64be6400fe1f6614c2788e7237e9f75e465fd95f",
"date": "2017-04-17 06:39:29 -0400",
"subject": "Changed invalid max-archive-mb option in configuration reference to archive-queue-max."
},
{
"commit": "979610a07d5c201e4e7f93f0540be2b19e4b33a5",
"date": "2017-04-13 20:10:28 -0400",
"subject": "Fixed an undefined variable when a module had no uncoverable code exceptions."
},
{
"commit": "77ef4fde20327a6615daaf096930de711fdb4ddf",
"date": "2017-04-13 07:42:45 -0400",
"subject": "Set --vm-max=2 for CI."
},
{
"commit": "76161bd8451e581a8f9aa11c1f37d14863585d29",
"date": "2017-04-12 19:17:39 -0400",
"subject": "v1.18: Stanza Upgrade, Refactoring, and Locking Improvements"
},
{
"commit": "5c635e0f0a1f5dc8ab8ef8c65204e81d3495afcb",
"date": "2017-04-12 18:36:33 -0400",
"subject": "Go back to using static user for documentation.",
"body": "Making this dynamic in commit 5d2e792 broke doc builds from cache. The long-term solution is to create a special user for doc builds but that’s beyond the scope of this release."
},
{
"commit": "f207dc71238097a0fded50cc87bb7ef2afb006de",
"date": "2017-04-12 12:41:34 -0400",
"subject": "Renumber return codes between 25 and 125 to avoid PostgreSQL interpreting some as fatal signal exceptions.",
"body": "Suggested by Yogesh Sharma."
},
{
"commit": "f5f8d51366faae6ac31f355d021eaff67bef8f7f",
"date": "2017-04-12 09:53:07 -0400",
"subject": "Improved error message when the restore command detects the presence of postmaster.pid.",
"body": "Suggested by Yogesh Sharma."
},
{
"commit": "b0119914d4633431b208a5a327a3758a06258087",
"date": "2017-04-12 09:22:51 -0400",
"subject": "Do not set timestamps of files in the backup directories to match timestamps in the cluster directory.",
"body": "This was originally done to enable backup resume, but that process is now implemented with checksums."
},
{
"commit": "fe02b40293fec08c819c5f41110203b8919fbae4",
"date": "2017-04-12 09:05:57 -0400",
"subject": "Backup and restore commands no longer copy via temp files.",
"body": "In both cases the files are checksummed on resume so there's no danger of partial copies."
},
{
"commit": "21a000d002bae2fa87cd09952740cbe14770aada",
"date": "2017-04-10 17:23:39 -0400",
"subject": "Silence some perl critic warnings.",
"body": "* Variables::RequireNegativeIndice\n* Variables::ProhibitUnusedVariables\n* Variables::ProhibitAugmentedAssignmentInDeclaration\n* Modules::ProhibitConditionalUseStatements"
},
{
"commit": "8546571461215eb65ffcff649c6baa17bc57d605",
"date": "2017-04-10 17:20:21 -0400",
"subject": "Ignore clock skew in container libc/package builds using make.",
"body": "It is common for containers to have clock skew so the build process takes care of this issue independently."
},
{
"commit": "b63ede5614fed0dce32449f1450b7a5627eeeb3d",
"date": "2017-04-10 13:53:19 -0400",
"subject": "Added ability to test warning messages.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "3d84f2ce5e02c5bd7f9bdcbb3b4579b146bf7ccf",
"date": "2017-04-10 13:24:45 -0400",
"subject": "Improvements to Ini.pm.",
"body": "* Refactor Ini.pm to facilitate testing.\n* Complete statement/branch coverage for Ini.pm.\n* Improved functions used to test/munge manifest and info files."
},
{
"commit": "367e06f4be9133f399d4b7380ace8c5ca087c4b6",
"date": "2017-04-10 12:31:30 -0400",
"subject": "Coverage testing always enabled on Debian-based containers.",
"body": "* Full coverage is verified when specified.\n* Modules marked with partial coverage will error if they are actually fully covered.\n* Simplified test representation is DefineTest.\n* Added new representation for queries in DefineTest and added API functions.\n* Update modules using DefineTest to use new API."
},
{
"commit": "eb4918d01881c20448e37da4d931d6e8a19f659a",
"date": "2017-04-07 10:31:49 -0400",
"subject": "Fixed locking bug and refactoring.",
"body": "* Fixed an issue where read-only operations that used local worker processes (i.e. restore) were creating write locks that could interfere with parallel archive-push. (Reported by Jens Wilke.)\n* Simplify locking scheme. Now, only the master process will hold write locks (archive-push, backup) and not all the local and remote worker processes as before."
},
{
"commit": "edfb0962b678a5ebb3021d37d487fafb843dbf2a",
"date": "2017-04-06 21:47:43 -0400",
"subject": "Update wording for release note sections."
},
{
"commit": "b620e6b282d3fc0bd1354b9490fbd84ee8d22d6e",
"date": "2017-04-06 19:36:37 -0400",
"subject": "Improvements and additional tests for stanza-upgrade.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "0da216c034d484927fa8ad0845e08f25c5227b5a",
"date": "2017-04-05 10:50:32 -0400",
"subject": "Require description in every call to testResult() and make iWaitSeconds optional."
},
{
"commit": "c7b61a200258b2f10d1c62f2aedc7441e27bb6b1",
"date": "2017-04-05 10:16:16 -0400",
"subject": "Refactor backupLabel() and add unit tests."
},
{
"commit": "b2f43b56014f3d43404a17531887a09a78eb0db1",
"date": "2017-04-04 21:17:19 -0400",
"subject": "Allow functions to accept optional parameters as a hash.",
"body": "Refactor File->list() and fileList() to accept optional parameters."
},
{
"commit": "9eae36a7028a7c08869ec2e7c2f31f0aa49ecb4c",
"date": "2017-04-04 21:15:22 -0400",
"subject": "Fixed flapping archive stop tests."
},
{
"commit": "beead043ac1f988e3757dc8689638ee5d443d9f9",
"date": "2017-04-03 10:42:55 -0400",
"subject": "Added stanza-upgrade command.",
"body": "The stanza-upgrade command provides a mechanism for upgrading a stanza after upgrading to a new major version of PostgreSQL."
},
{
"commit": "af7e4f4b4b6070e566865872e5240b824a14983f",
"date": "2017-03-22 19:03:28 -0400",
"subject": "Added validation of pgbackrest.conf to display warnings if options are not valid or are not in the correct section.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "5d2e79242da79854ee922c1a84dec0e67d52f090",
"date": "2017-03-16 19:50:59 -0400",
"subject": "Fixed user change in docs missed in vagrant upgrade."
},
{
"commit": "cbd879a9830d2585b3df3209f59c4a9581a3c166",
"date": "2017-03-14 22:05:17 -0400",
"subject": "Updated vagrant to new version and image."
},
{
"commit": "cc9f8fc4b6cb9a2da5bd7419630c4f3eb1c71186",
"date": "2017-03-13 16:54:51 -0400",
"subject": "v1.17: Page Checksum Bug Fix"
},
{
"commit": "b0947fdaa8af9c434c85ff33b1140d8ca6d98cbb",
"date": "2017-03-13 15:50:13 -0400",
"subject": "Fixed an issue where newly initialized (but unused) pages would cause page checksum warnings.",
"body": "Reported by Stephen Frost."
},
{
"commit": "3cec6702e85e901ff3894e047cf5a461562b7b67",
"date": "2017-03-02 20:15:14 -0500",
"subject": "v1.16: Page Checksum Improvements, CI, and Package Testing"
},
{
"commit": "02730526fc1a157231293ae532882847f7015a46",
"date": "2017-03-02 13:50:29 -0500",
"subject": "Fixed an issue where databases created with a non-default tablespace would raise bogus warnings about pg_filenode.map and pg_internal.init not being page aligned.",
"body": "Reported by blogh."
},
{
"commit": "5957f8566f1f8cd90964423321660e457fab57b7",
"date": "2017-03-02 11:47:23 -0500",
"subject": "Archive test improvements:",
"body": "* Fixed flapping archive-stop test with testResult() retries.\n* Added final test of archive contents to archive-push test."
},
{
"commit": "5eb585c9bae50e02ac5d53d3e20d0b5083283ac9",
"date": "2017-03-01 14:38:05 -0500",
"subject": "Improved truncation when outputting errors logs in the ExecuteTest module."
},
{
"commit": "c2666cc7f365fbd294b36dbcf5b11676bbcbf0d1",
"date": "2017-03-01 14:15:46 -0500",
"subject": "Fixed an issue where tables over 1GB would report page checksum errors after the first segment.",
"body": "Reported by Stephen Frost."
},
{
"commit": "774b243719675a27e0d4f02369df7cb0bdac6524",
"date": "2017-03-01 12:22:47 -0500",
"subject": "Fixed dev version string in Debian changelog."
},
{
"commit": "2c48cf8d0d4a4049ffcb8e01549f080bccfcc037",
"date": "2017-03-01 09:36:33 -0500",
"subject": "Fixed Vagrantfile to match user/group changes made for Travis CI."
},
{
"commit": "8161ab1c505f811b8aeb8ca33a57133411c4b755",
"date": "2017-02-26 12:58:48 -0500",
"subject": "Temporarily disable flapping keep-alive test."
},
{
"commit": "abe0935ea51a78f182549a82b62ca3e1964fe877",
"date": "2017-02-26 12:53:41 -0500",
"subject": "Disable CI config writing with —no-ci-config."
},
{
"commit": "ac485cc3552f3b1e35baebaa0140236bf550c6a8",
"date": "2017-02-22 18:43:10 -0500",
"subject": "Change —retry default to 0."
},
{
"commit": "31d2d790bd070e2b58a192cb56f6b04cdd307a6f",
"date": "2017-02-21 22:10:02 -0500",
"subject": "Added --retry option."
},
{
"commit": "023578c008dec24000c268f29cda25dc2948a86a",
"date": "2017-02-21 14:22:03 -0500",
"subject": "Make package tests work with dev builds."
},
{
"commit": "0e9bc513c986140f9bc239dc4b1d3f54c46444a5",
"date": "2017-02-21 12:54:27 -0500",
"subject": "Suppress lint on all but the first test."
},
{
"commit": "14ca4dac6fe9ab594c0915486f88ff27f4a5dc7d",
"date": "2017-02-21 11:56:55 -0500",
"subject": "Improved the code and tests for fileManifest().",
"body": "Done to prevent a possible race condition when files are removed by the database while the manifest is being built."
},
{
"commit": "01312f6260e4f36541d90b5f62be1cbbe6847d13",
"date": "2017-02-21 11:47:45 -0500",
"subject": "Improved formatting of testResult() output."
},
{
"commit": "86fee3da18e2646705fdac8853ae4153689d6484",
"date": "2017-02-21 08:59:23 -0500",
"subject": "Continuous integration using travis-ci."
},
{
"commit": "56543f7a9916b554204572fb015a24a33c0f74f0",
"date": "2017-02-17 22:31:16 -0500",
"subject": "Added package builds to test suite and other improvements:",
"body": "* Automated builds of Debian packages for all supported distributions.\n* Added --dev option to aggregate commonly used dev options.\n* Added --no-package option to skip package builds.\n* C library and packages are built by default, added -smart option to rebuild only when file changes are detected.\n* The --libc-only option has been changed to --build-only now that packages builds have been added."
},
{
"commit": "ac7ff755b3533181f7f26a7140cbdefa1cb68442",
"date": "2017-02-16 17:18:48 -0500",
"subject": "Container executions now load the user's environment."
},
{
"commit": "2d7d9626bb60640a77ac71559f2a714a1aac8b94",
"date": "2017-02-13 20:00:30 -0500",
"subject": "v1.15: Refactoring and Bug Fixes"
},
{
"commit": "e2ac7e1ea624a1dd0e4c5ac214d3dfc1cdc266ab",
"date": "2017-02-13 19:59:14 -0500",
"subject": "Fixed a regression introduced in v1.13 that could cause backups to fail.",
"body": "This happened if files were removed (e.g. tables dropped) while the manifest was being built."
},
{
"commit": "845c6112bf592fb54b61156b47bbf2ebc5985f29",
"date": "2017-02-13 10:07:04 -0500",
"subject": "v1.14: Bug Fixes"
},
{
"commit": "a54018d573926d5d5718727a9f169ad7751577f4",
"date": "2017-02-13 10:03:02 -0500",
"subject": "Improved performance of wal archive min/max provided by the info command.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "adcc7cb9543714b420d429512f259d14ea265acf",
"date": "2017-02-13 09:58:50 -0500",
"subject": "Fixed a race condition in parallel archiving.",
"body": "Creation of new paths generated an error when multiple processes attempted to do so at the same time."
},
{
"commit": "bc2bb040c5bf75cb56ec3fa7a00a993d33371a99",
"date": "2017-02-13 09:57:10 -0500",
"subject": "Fixed an issue where an archive-push error would not be retried.",
"body": "It would instead return errors to PostgreSQL indefinitely (unless the .error file was manually deleted)."
},
{
"commit": "12041f73e2a4f4c91c068b7f43f7ff52f24c72f5",
"date": "2017-02-12 21:09:34 -0500",
"subject": "Fixed syntax from d68b48d that was not backwards compatible to Perl 5.10."
},
{
"commit": "d68b48d19b53727bafd55e97cde41db309763daa",
"date": "2017-02-11 10:26:54 -0500",
"subject": "Improved support for --require option and section depends now default to the previous section."
},
{
"commit": "498f52da094832d5ffe84ea0eed121acf46f360c",
"date": "2017-02-10 10:22:05 -0500",
"subject": "Improvements to documentation engine:",
"body": "* Documentation can now be built with reusable blocks to reduce duplication.\n* Added ability to pass options to containers within the documentation.\n* Add proper tag to slightly emphasize proper nouns."
},
{
"commit": "aab763d558b586f0ce4f77a8cc67c2c7e9db07eb",
"date": "2017-02-08 09:37:17 -0500",
"subject": "Additional notes on the async spool directory."
},
{
"commit": "b813bfaff68fa9d2e1271b3f6fcf61955e24de3e",
"date": "2017-02-08 08:41:43 -0500",
"subject": "Updated async archiving documentation.",
"body": "More accurately describe how the new method works and how it differs from the old method."
},
{
"commit": "41eba95155b1fab4c5f98dab3327c1563968fcab",
"date": "2017-02-05 20:23:03 -0500",
"subject": "v1.13: Parallel Archiving, Stanza Create, Improved Info and Check"
},
{
"commit": "0daeace1cd2e2ef55c3df3e43b4b622418fe625b",
"date": "2017-02-05 19:58:52 -0500",
"subject": "Fixed alignment issues with multiline logging."
},
{
"commit": "cded35791d160a6fc2f99daaaaabf0db21c9bb38",
"date": "2017-02-05 10:59:49 -0500",
"subject": "Added --log-timestamp option.",
"body": "Allow timestamps to be suppressed in logging. This is primarily used to avoid filters in the automated documentation."
},
{
"commit": "55feae645e92eda928ad0eb5be74431807f3c604",
"date": "2017-02-05 10:37:54 -0500",
"subject": "Log file banner is not output until the first log entry is written.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "2237c3fc1bafd620f5cafda4d38acbfc7b490aa5",
"date": "2017-02-05 10:35:53 -0500",
"subject": "Added documentation for parallel archive-push."
},
{
"commit": "8b5f37c2a87b221fe40f1883f6583ee31ad977d7",
"date": "2017-02-05 10:31:29 -0500",
"subject": "Added archive and backup WAL ranges to the info command."
},
{
"commit": "1666ee177f059c3566e531fa697cb229eb68c0c4",
"date": "2017-02-02 20:44:42 -0500",
"subject": "Fixed --no-online tests to suppress expected errors."
},
{
"commit": "efdf64506ae075cadc24de0805c8238478dfd28f",
"date": "2017-02-02 20:42:45 -0500",
"subject": "Remove remote lock requirements for the archive-get, restore, info, and check commands since they are read-only operations.",
"body": "Suggested by Michael Vitale."
},
{
"commit": "3e54aad88f473db619dc7546cf144c3987224943",
"date": "2017-01-31 10:38:45 -0500",
"subject": "Removed --lock option.",
"body": "This option was introduced before the lock directory could be located outside the repository and is now obsolete."
},
{
"commit": "7418559a6751959727836e462002a14c41461198",
"date": "2017-01-31 10:36:59 -0500",
"subject": "Fixed a spurious archive-get log message that indicated an exit code of 1 was an abnormal termination."
},
{
"commit": "9b92edddbe506c3ebaa6f970e62270facdcc5a27",
"date": "2017-01-30 17:06:35 -0500",
"subject": "Remove Intel-specific optimization from C library build flags.",
"body": "Contributed by Adrian Vondendriesch."
},
{
"commit": "eb1a1e53080375d947b94e58f917bc2816528264",
"date": "2017-01-30 16:22:12 -0500",
"subject": "Missed expect logs from commit 455c604."
},
{
"commit": "34e4cfaeec473ba1c90f8c203f82b1146510deee",
"date": "2017-01-30 15:48:10 -0500",
"subject": "Fixed minor typos."
},
{
"commit": "455c6048ee4794a2d334067e4651460b3ad2b416",
"date": "2017-01-30 14:00:40 -0500",
"subject": "C Library builds immune to clock differences between VM and host."
},
{
"commit": "6b99d770b5203680ac53813d9c3c73f476d895bb",
"date": "2017-01-30 13:59:00 -0500",
"subject": "Reduced the likelihood of torn pages causing a false positive in page checksums by filtering on start backup LSN."
},
{
"commit": "43ada9fb33b51479b959ea6a93fcb53fa0803e25",
"date": "2017-01-27 11:02:27 -0500",
"subject": "Improved, multi-process implementation of asynchronous archiving."
},
{
"commit": "2a9ba877e1dbce234f1b44d8f3163ce38f9c1781",
"date": "2017-01-27 10:06:16 -0500",
"subject": "Refactor process IO and process master/minion code out from the common protocol code."
},
{
"commit": "0163d3b3e02f22179f9854246e6f5009e8ff4e40",
"date": "2017-01-27 10:04:41 -0500",
"subject": "Allow empty files to be created with FileCommon::fileStringWrite() and use temp files to avoid partial reads."
},
{
"commit": "2553c7a9982f630226923ec14b0f56350607db44",
"date": "2017-01-27 10:02:00 -0500",
"subject": "Represent .gz extension with a constant."
},
{
"commit": "f3ccf3b897e9bab58e2ab1f15dabf54fef9b34db",
"date": "2017-01-27 09:56:26 -0500",
"subject": "Added Exception::exceptionCode() and Exception::exceptionMessage() to simplify error handling logic."
},
{
"commit": "6620594b7724f5950b20c1c103a2b0fee194e816",
"date": "2017-01-27 09:53:46 -0500",
"subject": "Various improvements in Lock.pm:",
"body": "* Allow for locks to be taken more than once in the same process without error.\n* Lock directories can be created when more than one directory level is required.\n* Clean up optionValid()/optionTest() logic in Lock.pm."
},
{
"commit": "18db178ac3a03540bcaf4bd5c23f6a34ab419f55",
"date": "2017-01-27 09:42:30 -0500",
"subject": "Various improvements to the test suite:",
"body": "* Allow logging to be suppressed via logDisable() and logEnable().\n* Added more flexibility in initializing and cleaning up after modules and tests.\n* testResult() suppresses logging and reports exceptions.\n* testException() allows messages to be matched with regular expressions.\n* Refactor name/locations of common modules that setup test environments."
},
{
"commit": "e876a222fcb68fb4a95455113d3378d5e6b81c7a",
"date": "2017-01-24 14:58:55 -0500",
"subject": "Fixed an issue where protocol mismatch errors did not output the expected value."
},
{
"commit": "b6fa146f9b1b9e622f456d73585423538c04ad17",
"date": "2017-01-22 19:29:56 -0500",
"subject": "Added warning to update pg_tablespace.spclocation when remapping tablespaces in PostgreSQL < 9.2.",
"body": "Contributed by blogh."
},
{
"commit": "7d1347cdec4f4c563d5a6fa0a1d66297a2742f0f",
"date": "2017-01-10 19:59:32 -0500",
"subject": "Split the archive-get and archive-push commands into separate modules."
},
{
"commit": "155c8081632d1081da8b7e94ebd3a7d422f0f280",
"date": "2017-01-10 19:54:51 -0500",
"subject": "Split the check command out of the Archive.pm module."
},
{
"commit": "b58045f5757b03a1e15e1955402917b9003c5692",
"date": "2017-01-10 19:51:20 -0500",
"subject": "Moved the Archive modules to the Archive directory."
},
{
"commit": "2ab63f27b23b8932e9685c5179284fddbb6cf49c",
"date": "2017-01-10 13:12:53 -0500",
"subject": "C Library builds only run when C library has actually changed."
},
{
"commit": "0b4055e588331ec70d789ced6e5685f54def197b",
"date": "2017-01-10 13:08:03 -0500",
"subject": "Moved File->manifest() into the FileCommon.pm module."
},
{
"commit": "0e4f51c27110f2d3eb6f3d1d15dc3f8ac4675e34",
"date": "2017-01-09 20:49:04 -0500",
"subject": "Added integration for testing coverage with Devel::Cover."
},
{
"commit": "39744a4f1dbbe4e593bebaa37a6be93dae0da214",
"date": "2017-01-05 15:19:56 -0500",
"subject": "Fixed an issue where a missing user/group on restore could cause an \"uninitialized value\" error in File->owner().",
"body": "Reported by Leonardo Avellar."
},
{
"commit": "4ff2714bf00063534ddf90d4995f9f1abcb60c99",
"date": "2017-01-04 18:39:50 -0500",
"subject": "Return proper error code when unable to convert a relative path to an absolute path.",
"body": "Suggested by Yogesh Sharma."
},
{
"commit": "c8dfc673b87bc04f87e7e3c01f5e227a71f415d8",
"date": "2017-01-04 18:31:16 -0500",
"subject": "Moved tests into new modules to better reflect actual usage."
},
{
"commit": "e3d63c0252bfbd0cccb746d405c7e3cdeb8f75c1",
"date": "2017-01-04 18:29:13 -0500",
"subject": "Allow multiple --module, --test, and --run options to be used for test.pl."
},
{
"commit": "be337c951aee0121dc3d1a251bdb5218d72769a0",
"date": "2017-01-04 10:12:29 -0500",
"subject": "Improvements to stanza-create:",
"body": "* Force only required when a change is needed for backup.info or archive.info.\n* Identical files are not overwritten."
},
{
"commit": "b91ca113298104a3c718db93a1dad0fa7336c8c6",
"date": "2017-01-04 10:09:21 -0500",
"subject": "Added expect log expression to replace year subdirectories in backup.history."
},
{
"commit": "314ef2c8b317c7d56ae2770231e49748183fdd96",
"date": "2017-01-04 10:05:43 -0500",
"subject": "Update LICENSE.txt for 2017."
},
{
"commit": "d5ee7d3535ea3961db2cb73120ee94632463e737",
"date": "2016-12-23 16:50:02 -0500",
"subject": "Added documentation to the User Guide for the process-max option.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "83beab7ec368ffebb5d8526e06eb65a9abd568c2",
"date": "2016-12-23 11:43:26 -0500",
"subject": "Refactor File module to improve test coverage.",
"body": "Added unit tests for low-level functions in the BackupCommon module."
},
{
"commit": "5d3473b52dfe1f67d557d434a9ee373b6317dcfc",
"date": "2016-12-23 08:30:34 -0500",
"subject": "Refactor File module to improve test coverage."
},
{
"commit": "6b2666a9d7ee179e237a4ad34117024f2ed62f7f",
"date": "2016-12-23 08:22:59 -0500",
"subject": "Split test modules into separate files.",
"body": "Makes the code more maintainable. Tests are dynamically loaded by name rather than requiring an if-else block."
},
{
"commit": "56144c99c0570daf7f1dba85968b79cbc3a84b15",
"date": "2016-12-21 14:35:20 -0500",
"subject": "Improved check command to run on a standby.",
"body": "Only basic checks are done because pg_switch_xlog() cannot be executed on a replica."
},
{
"commit": "974a02dbe41372d28d2c234ebea8a8ac6352865a",
"date": "2016-12-20 16:52:20 -0500",
"subject": "Improved stanza-create command so that it can repair broken repositories in most cases and is robust enough to be made mandatory.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "aecc0f737e40dfb7304753e37612b11402e4c51c",
"date": "2016-12-19 14:40:22 -0500",
"subject": "Fixed a few directory syncs that were missed for the --repo-sync option."
},
{
"commit": "4e1b74688df11f31e2d5caf76bf7c1d53623ae45",
"date": "2016-12-13 08:22:36 -0500",
"subject": "Fixed const assignment giving compiler warning in C library.",
"body": "Fixed by Adrian Vondendriesch."
},
{
"commit": "8e3464da805fc0975b6cf25ecb9ba16146b45c9e",
"date": "2016-12-12 19:18:27 -0500",
"subject": "v1.12: Page Checksums, Configuration, and Bug Fixes"
},
{
"commit": "36a5349b1c6b6bcd513464029733b62fe4200759",
"date": "2016-12-12 18:54:07 -0500",
"subject": "Added the --checksum-page option.",
"body": "This option allows pgBackRest to validate page checksums in data files when checksums are enabled on PostgreSQL >= 9.3. Note that this functionality requires a C library which may not initially be available in OS packages. The option will automatically be enabled when the library is present and checksums are enabled on the cluster."
},
{
"commit": "6dd0829033fb600e0aa5d9c60d3315e65a6bb289",
"date": "2016-12-12 18:47:17 -0500",
"subject": "File copy protocol now accepts a function that can do additional processing on the copy buffers and return a result to the calling process."
},
{
"commit": "b4884e5a0bdb572aeb766f6d5f1be8b159de5ea7",
"date": "2016-12-10 14:05:28 -0500",
"subject": "Fixed an issue where the db-port option specified on the backup server would not be properly passed to the remote unless it was from the first configured database.",
"body": "Reported by Michael Vitale."
},
{
"commit": "1a5fa920e6baec14fc092d202839ab16d403b7fb",
"date": "2016-12-10 09:15:20 -0500",
"subject": "Improved parameter/result logging in debug/trace functions."
},
{
"commit": "e61ef6ebce004ebacf95796acae835845b25758e",
"date": "2016-12-10 09:13:55 -0500",
"subject": "Add more realistic data files to synthetic backup and restore tests."
},
{
"commit": "eff7b46eb1abb0d80de01730e6834f39f450f890",
"date": "2016-12-10 09:11:12 -0500",
"subject": "Various improvements to validation of backup and restore."
},
{
"commit": "b45e0d81898f21f8d65f029e382c3d202a3b0e7a",
"date": "2016-12-10 09:09:16 -0500",
"subject": "Fixed issues in the protocol layer when additional message fields were added."
},
{
"commit": "f818901c0e619b50afa50412d246d0b1771fac11",
"date": "2016-12-10 09:06:45 -0500",
"subject": "Added the --repo-sync option to allow directory syncs in the repository to be disabled.",
"body": "This is for file systems that do not support them, e.g. NTFS"
},
{
"commit": "36378c47bd3058b3986bf2913539724965c39e56",
"date": "2016-12-04 18:11:23 -0500",
"subject": "Added Retention to QuickStart section."
},
{
"commit": "896984848bf46f85893d4f05cf06534b4fe49327",
"date": "2016-12-04 17:51:00 -0500",
"subject": "Improved errors returned from child processes by removing redundant error level and code."
},
{
"commit": "817592837ce08d412dc97e3cfeb543590a83d04f",
"date": "2016-12-04 14:44:53 -0500",
"subject": "Added a predictable log entry to signal that a command has completed successfully.",
"body": "For example a backup ends successfully with: INFO: backup command end: completed successfully."
},
{
"commit": "f823a25ac20fac867038a4797d96c26e27f8388b",
"date": "2016-12-04 09:25:40 -0500",
"subject": "Fixed an issue where options that were invalid for the specified command could be provided on the command-line without generating an error.",
"body": "* The options were ignored and did not cause any change in behavior, but it did lead to some confusion. Invalid options will now generate an error.\n* Removed erroneous --no-config option in help test module.\n* Changed the --no-fork test option to --fork with negation to match all other boolean parameters."
},
{
"commit": "d18cd7ad0faa80c4ceacd708d0ae1e964f170a7a",
"date": "2016-12-03 18:01:17 -0500",
"subject": "Fixed an issue that prevented errors from being output to the console before the logging system was initialized.",
"body": "That is, while parsing options. Error codes were still being returned accurately so this would not have made a process look like it succeeded when it did not."
},
{
"commit": "2e01e6b9e1a9c598715f7ad86177930fb3963e56",
"date": "2016-12-03 17:34:51 -0500",
"subject": "Improved consistency and flexibility of the protocol layer by using JSON for all messages."
},
{
"commit": "b7f17382002046b7f52fdd874025428a649713a6",
"date": "2016-12-03 10:28:08 -0500",
"subject": "Code cleanup in preparation for improved stanza-create command.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "005fc08795c0bd299f999eff665b4eb4e789b2d2",
"date": "2016-12-03 10:23:26 -0500",
"subject": "Added the --repo-link option.",
"body": "Allow internal symlinks to be suppressed when the repository is located on a filesystem that does not support symlinks. This does not affect any pgBackRest functionality, but the convenience link latest will not be created and neither will internal tablespace symlinks, which will affect the ability to bring up clusters in-place manually using filesystem snapshots."
},
{
"commit": "6ae4d7de81cfdb8982f3bde0e920fb2a76250208",
"date": "2016-12-03 09:56:05 -0500",
"subject": "Fixed a bug where internal symlinks were not being created for tablespaces in the repository.",
"body": "This issue was only apparent when trying to bring up clusters in-place with filesystem snapshots and did not affect normal backup and restore."
},
{
"commit": "22cd29771fc87d98bc7269aad1e30b7c3d7de425",
"date": "2016-12-01 09:33:14 -0500",
"subject": "Update control and wal test files to 9.4 with matching system identifiers.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "a850335015207c95a05b4219997d025bcc854e1f",
"date": "2016-11-30 14:36:39 -0500",
"subject": "Simplified the result hash of File->manifest(), Db->tablespaceMapGet(), and Db->databaseMapGet()."
},
{
"commit": "09df07efb7496db9ac426da243acc636a628d2bb",
"date": "2016-11-30 14:23:05 -0500",
"subject": "For simplicity, the pg_control file is now copied with the rest of the files instead of by itself of at the end of the process.",
"body": "The backup command does not require this behavior and the restore copies to a temporary file which is renamed at the end of the restore."
},
{
"commit": "4e9f8da9a6c85b8f486d4207d637f9d0b14b3049",
"date": "2016-11-30 14:18:12 -0500",
"subject": "Improved IO->bufferRead to always return requested number of bytes until EOF."
},
{
"commit": "e951c4f9c267a7a860c22b29fc1208c3d96f7c89",
"date": "2016-11-30 14:15:11 -0500",
"subject": "Abstracted code to determine which database cluster is the master and which are standbys.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "d101e9c84e1e9bc7339a3d52a57964faf3aac51e",
"date": "2016-11-30 14:03:58 -0500",
"subject": "Improved exception handling in file unit tests."
},
{
"commit": "4df3eabf6d5acda7e7095933ea7f85ce9c618151",
"date": "2016-11-22 17:31:27 -0500",
"subject": "Builds in release.pl now remove all docker containers to get consistent IP address assignments."
},
{
"commit": "dbd16d25b97ba2d2cd86bcfb35e1ca41a2323c33",
"date": "2016-11-22 17:29:24 -0500",
"subject": "Fixed regression in section links introduced in v1.10.",
"body": "This was introduced in an effort to make the html output XHTML 1.0 STRICT compliant because the standard does not allow / characters in anchors.\n\nHowever, the / characters were changed to . in the anchors but not in the links. For now revert the anchors to / so further though can be given to this issue."
},
{
"commit": "c9b49b0d7e1f0cc612511c1691dcde89ec0cee92",
"date": "2016-11-17 16:35:11 -0500",
"subject": "Doc engine improvements.",
"body": "Bug Fixes:\n\n* Fixed and issue that suppressed exceptions in PDF builds.\n\nFeatures:\n\n* Allow a source to be included as a section so large documents can be broken up.\n* Added section link support to Markdown output.\n* Added list support to PDF output.\n* Added include option to explicitly build sources (complements the exclude option though both cannot be used in the same invocation).\n* Added keyword-add option to add keywords without overriding the default keyword.\n* Added debug option to doc.pl to easily add the debug keyword to documentation builds.\n* Added pre option to doc.pl to easily add the pre keyword to documentation builds.\n\nRefactoring:\n\n* Improvements to markdown rendering.\n* Remove code dependency on project variable, instead use title param."
},
{
"commit": "54b1a784b55fdee915b550e5151f20dabea4e67c",
"date": "2016-11-17 09:57:59 -0500",
"subject": "v1.11: Bug Fix for Asynchronous Archiving Efficiency"
},
{
"commit": "dbb9d80dab5a69130b34d1949a4aec889a49b758",
"date": "2016-11-17 09:39:21 -0500",
"subject": "Fixed an issue where asynchronous archiving was transferring one file per execution instead of transferring files in batches.",
"body": "This regression was introduced in v1.09 and affected efficiency only, all WAL segments were correctly archived in asynchronous mode."
},
{
"commit": "06cac30c33733d3894a3143a6866a9dbd3972199",
"date": "2016-11-08 10:47:47 +0000",
"subject": "v1.10: Stanza Creation and Minor Bug Fixes"
},
{
"commit": "9d9c438f59461e17383cd55dd067a467132ba2de",
"date": "2016-11-07 17:06:35 +0200",
"subject": "Doc engine improvements.",
"body": "Bug Fixes:\n\n* Fixed missing variable replacements.\n* Removed hard-coded host names from configuration file paths.\n\nDocumentation Features:\n\n* Allow command-line length to be configured using cmd-line-len param.\n* Added compact param to allow CSS to be embedded in HTML file.\n* Added pretty param to produce HTML with proper indenting.\n* Only generate HTML menu when required and don't require index page.\n* Assign numbers to sections by default.\n* VM mount points are now optional."
},
{
"commit": "dd621081b95e5dcf737807053346b7c89e9f962d",
"date": "2016-11-07 16:37:16 +0200",
"subject": "Fixed an issue where tablespace paths with the same prefix would cause an invalid link error.",
"body": "Reported by Nikhilchandra Kulkarni."
},
{
"commit": "21ca4127026e80f93664d78fcf1e81d8dda0d25d",
"date": "2016-11-05 19:22:30 +0200",
"subject": "Fixed an issue where a backup could error if no changes were made to a database between backups and only pg_control changed."
},
{
"commit": "f43e5bc52d31b6f1efe3b92b44752aa49ab1645a",
"date": "2016-11-04 13:56:26 +0200",
"subject": "Removed extraneous use lib directives from Perl modules.",
"body": "Suggested by Devrim Gündüz."
},
{
"commit": "171c5835bbed34e118e554a291849baa36ecfce0",
"date": "2016-11-03 17:48:59 +0200",
"subject": "Another expect log update for stanza-create feature."
},
{
"commit": "26f76762b5ca80bb2ff6c7c5c8e2da11f825420d",
"date": "2016-10-17 10:03:42 +0100",
"subject": "Expect log updates for stanza-create feature."
},
{
"commit": "8d1880ca4a15567778b1c295451b3bb62886cc7b",
"date": "2016-10-14 12:21:47 +0100",
"subject": "Added the stanza-create command to formalize creation of stanzas in the repository.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "1e0ca3056a84abb07214b54ea2945fcdacd65000",
"date": "2016-10-10 17:35:58 -0400",
"subject": "v1.09: 9.6 Support, Configurability, and Bug Fixes"
},
{
"commit": "49a5e8a3f59716cf8f73b458f4cd0c5e47175e48",
"date": "2016-10-07 08:51:10 -0400",
"subject": "Fixed a remote timeout.",
"body": "The timeout occurred when a local process generated checksums (during resume or restore) but did not copy files, allowing the remote to go idle."
},
{
"commit": "41669a826ee48c7bbcd7a6c2ef849093d3287b6a",
"date": "2016-10-05 21:22:42 -0400",
"subject": "Added --dev option to doc.pl to easily add dev keyword to documentation builds."
},
{
"commit": "16d0e767ef40f22d83166c88bc7177ff01e7fb3c",
"date": "2016-10-05 21:15:10 -0400",
"subject": "Set application_name to \"pgBackRest [command]\" for database connections.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "0a4099fff87458265a5a14006967c48c3cf912bf",
"date": "2016-10-05 21:13:29 -0400",
"subject": "Clarified error message when unable to acquire pgBackRest advisory lock to make it clear that it is not a PostgreSQL backup lock.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "5dc801d59db9c8ce2f0872deb13b532b32af80ee",
"date": "2016-10-05 09:47:34 -0400",
"subject": "Fixed an issue where the async archiver would not be started if archive-push did not have enough space to queue a new WAL segment.",
"body": "This meant that the queue would never be cleared without manual intervention (such as calling archive-push directly). PostgreSQL now receives errors when there is not enough space to store new WAL segments but the async process will still be started so that space is eventually freed."
},
{
"commit": "2a18674111d8ee01e15960dd1fcd0da3282bb38c",
"date": "2016-10-05 09:09:30 -0400",
"subject": "Added the log-level-stderr option.",
"body": "Controls whether console log messages are sent to stderr or stdout. By default this is set to warn which represents a change in behavior from previous versions, even though it may be more intuitive. Setting log-level-stderr=off will preserve the old behavior."
},
{
"commit": "d81198e65e2cca8272d52cc586dcc76016b91f2d",
"date": "2016-10-05 08:55:54 -0400",
"subject": "Added the cmd-ssh to allow the ssh client to be specified.",
"body": "Suggested by Jens Wilke."
},
{
"commit": "6f34fbc6957f16719749372d78c014abe9b8a5f7",
"date": "2016-10-03 09:15:29 -0400",
"subject": "Vagrant build improvements:",
"body": "* Minimize TeXLive package list to save time during VM builds.\n* General cleanup and added timestamps.\n* Pin to specific box version."
},
{
"commit": "07898d33e332aa892e406d2df729c5d900110d41",
"date": "2016-10-03 07:28:44 -0400",
"subject": "Fixes for archive checks added in 5d033d0:",
"body": "* Don't execute pg_is_in_recovery() on PostreSQL < 9.0.\n* Don't check archive_mode or archive_command on the standby."
},
{
"commit": "1491862716aeff6c3a9434b207dcdaf7962ce387",
"date": "2016-10-01 13:39:44 -0400",
"subject": "Regression tests can now be run as any properly-configured user, not just vagrant."
},
{
"commit": "198e498b41e85dfcd3698bfb5a79907f41ca5656",
"date": "2016-09-29 19:09:19 -0400",
"subject": "Non-exclusive backups will automatically be used on PostgreSQL 9.6.",
"body": "This feature carries over from 1.08 but has now been tested with the official 9.6 release."
},
{
"commit": "156859c5d519b5bb757412a805208b78a46d3832",
"date": "2016-09-29 19:07:46 -0400",
"subject": "Update CentOS/Debian package definitions."
},
{
"commit": "3e4ca153cea6750a3efbf1b1a319623afcfee86a",
"date": "2016-09-29 18:26:32 -0400",
"subject": "Fixed broken vm-max option in test.pl."
},
{
"commit": "5d033d028c54142c872ca4ce8cef6ac05e9ec55a",
"date": "2016-09-28 19:45:33 -0400",
"subject": "Archive validation improvements:",
"body": "* Fixed error message to properly display the archive command when an invalid archive command is detected.\n* Check that archive_mode is enabled when archive-check option enabled."
},
{
"commit": "48f968b344138f6309f1203f26ecce7198d453b0",
"date": "2016-09-28 12:29:29 -0400",
"subject": "Added archive-timeout option documentation to the user guide.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "76673a8e62636a1cbcd364b4252130b6b5a83bd0",
"date": "2016-09-27 18:01:38 -0400",
"subject": "Fixed the check command to prevent an error message from being logged if the backup directory does not exist.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "25f40f9b15f987989b8286da47c631d6e6246abf",
"date": "2016-09-17 11:53:28 -0400",
"subject": "Log improvements:",
"body": "* pgBackRest version number included in command start INFO log output.\n* Process ID logged for local process start/stop INFO log output.\n* Fixed missing expect output for help module."
},
{
"commit": "d98df8c8cff41970a5549328722d90cbc7f8f19d",
"date": "2016-09-14 17:36:43 -0500",
"subject": "v1.08: Bug Fixes and Log Improvements"
},
{
"commit": "69c6afb1dfa3c494f3fd8c3c5d98a8ab5e10a1e2",
"date": "2016-09-14 16:40:13 -0500",
"subject": "Cache file log output until the file is created to create a more complete log."
},
{
"commit": "f54145c0ccd4676eebd7184edee4746c02981bfe",
"date": "2016-09-14 16:37:07 -0500",
"subject": "Fixed timeout issues.",
"body": "* Fixed an issue where local processes were not disconnecting when complete and could later timeout. (Reported by Todd Vernick.)\n* Fixed an issue where the protocol layer could timeout while waiting for WAL segments to arrive in the archive. (Reported by Todd Vernick.)"
},
{
"commit": "e08b56a4e33436d8fdff11020897fc8f73bbaa57",
"date": "2016-09-14 16:30:57 -0500",
"subject": "Show Process ID in log output instead of filtering it out with the timestamp."
},
{
"commit": "f253a4d85ce47d5706123ce15c460e068e983595",
"date": "2016-09-08 17:29:26 -0400",
"subject": "Suppress \"dpkg-reconfigure: unable to re-open stdin: No file or directory\" warning in Vagrant VM build.",
"body": "Contributed by John Harvey."
},
{
"commit": "a8590c9aded9a6603eb0ed64ac1a5792f700e22e",
"date": "2016-09-07 08:29:21 -0400",
"subject": "v1.07: Thread to Process Conversion and Bug Fixes"
},
{
"commit": "d2add293c7959d8b1919520f98202f07a0c1cba0",
"date": "2016-09-07 08:07:37 -0400",
"subject": "Archive retention improvements:",
"body": "* Fixed an issue where retention-archive was not automatically being set when retention-archive-type=diff, resulting in a less aggressive than intended expiration of archive.\n* Additional warnings when archive retention settings may not have the intended effect or would allow indefinite retention.\n* Closed #235: \"Retention policy question\" by adding documentation for archive retention."
},
{
"commit": "0d5a1eaf9efc3e051221cc32b373139cc1a274a6",
"date": "2016-09-07 07:20:07 -0400",
"subject": "The archive-start and archive-stop settings are now filled in backup.manifest."
},
{
"commit": "cc9c8819eee1257b08f44eaf43597f5e97833932",
"date": "2016-09-06 14:01:39 -0400",
"subject": "Make uid/gid selection for containers dynamic."
},
{
"commit": "cedfcbd4be9be7c37d211731f1b10f5e0d50e25a",
"date": "2016-09-06 11:02:01 -0400",
"subject": "Update Vagrantfile:",
"body": "* Change box provider to bento (hoping for better stability with Docker).\n* Install texlive from Debian packages."
},
{
"commit": "dd8d7812170c4312654dd12d2c742c1963653a92",
"date": "2016-09-06 09:44:50 -0400",
"subject": "Safely check eval blocks and convert $@ to $EVAL_ERROR."
},
{
"commit": "a701309453a7df8f8808f6739e06e357ec0bf63f",
"date": "2016-09-06 09:35:02 -0400",
"subject": "Converted Perl threads to processes."
},
{
"commit": "4026ad649d4383c500bd40717e2fb177d01a7692",
"date": "2016-09-06 09:15:22 -0400",
"subject": "Refactor of protocol minions in preparation for the new local minion."
},
{
"commit": "f71073c11f413f99f35b3c253f35a0aaed34edfb",
"date": "2016-09-04 19:29:30 -0400",
"subject": "Improved temp file handling for archiving."
},
{
"commit": "56ee666e69302b291ec5cc7d04caa25c651d7bfb",
"date": "2016-09-04 09:27:56 -0400",
"subject": "Suppress TOC for unsupported versions of pgBackRest.",
"body": "The intent is to tidy the releases page and nobody should care much about the old, unsupported releases,"
},
{
"commit": "8f61473955e212b605088cfe387c625b40c9863c",
"date": "2016-09-04 09:25:20 -0400",
"subject": "Improve ASSERT error handling."
},
{
"commit": "f986e6ae33a5c87da7a8a5f5e5a11b8d4637a172",
"date": "2016-09-04 09:22:53 -0400",
"subject": "File module improvements.",
"body": "* Remove obsolete thread index variable from File() module.\n* Changed temporary file names to consistently use .pgbackrest.tmp."
},
{
"commit": "bcdb5cdac80372536539c46e12b3d1a5d244f5a9",
"date": "2016-09-04 09:19:44 -0400",
"subject": "Fixed a issue where tablespaces were copied from the master during standby backup."
},
{
"commit": "2feaaf225e2200fd92ad7d12a1281080cbb5603f",
"date": "2016-09-04 09:13:13 -0400",
"subject": "Exclude contents of $PGDATA/pg_replslot directory."
},
{
"commit": "316da4421ec0780963ab8a32d2fee141ff50122d",
"date": "2016-09-03 18:34:38 -0400",
"subject": "Experimental support for non-exclusive backups in PostgreSQL 9.6 rc1."
},
{
"commit": "634f5c6829ce0d4ece466ac2d4c29215b13d6f89",
"date": "2016-08-29 14:09:37 -0400",
"subject": "Closed #250: Fixed the check command so backup info is checked remotely and not just locally.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "f6c24039e1d360b9be9b39ed77488212167570b2",
"date": "2016-08-29 09:43:22 -0400",
"subject": "Fixed minor documentation reproducibility issues related to binary paths."
},
{
"commit": "be77136eaeca4d0943bd00280afcbe3f5a53a096",
"date": "2016-08-25 11:49:09 -0400",
"subject": "v1.06: Backup from Standby and Bug Fixes"
},
{
"commit": "c9bdf6a9ae2f2657ba06eb97a7fbaba38251ef1c",
"date": "2016-08-25 11:27:00 -0400",
"subject": "Fixed timeout issue.",
"body": "The protocol-timeout option was not automatically increased when the db-timeout option was increased."
},
{
"commit": "5ada189a92813a57b9050dec54ba3ddf69f68bf0",
"date": "2016-08-25 11:25:46 -0400",
"subject": "Backup from a standby cluster.",
"body": "A connection to the primary cluster is still required to start/stop the backup and copy files that are not replicated, but the vast majority of files are copied from the standby in order to reduce load on the master."
},
{
"commit": "ecf827579edc9dc620a27985c0bd75a1d8cb3d23",
"date": "2016-08-25 10:04:46 -0400",
"subject": "Improve host tag rendering."
},
{
"commit": "d0b6f78b20cb7c74b43717a97242fce7160d2604",
"date": "2016-08-24 12:39:27 -0400",
"subject": "More flexible configuration for databases",
"body": "Master and standby can both be configured on the backup server and pgBackRest will automatically determine which is the master. This means no configuration changes for backup are required after failing over from a master to standby when a separate backup server is used."
},
{
"commit": "cd6278e5af22119cb0c4e3714dc2a66d3cd219c0",
"date": "2016-08-24 12:27:48 -0400",
"subject": "Revert some backup exclusions until they have been tested more thoroughly."
},
{
"commit": "9c13ca1d091e38dddcd38656fc8af748e8c19675",
"date": "2016-08-24 12:01:08 -0400",
"subject": "mprove backup log messages to indicated which host the files are being copied from."
},
{
"commit": "f1412baccf9ab4b5015d839ae0b598d92dd32586",
"date": "2016-08-16 09:35:16 -0400",
"subject": "Exclude directories during backup that are cleaned, recreated, or zeroed by PostgreSQL at startup.",
"body": "These include (depending on the version where they were introduced): pgsql_tmp, pg_dynshmem, pg_notify, pg_replslot, pg_serial, pg_snapshots, pg_stat_tmp, pg_subtrans. The postgresql.auto.conf.tmp file is now excluded in addition to files that were already excluded: backup_label.old, postmaster.opts, postmaster.pid, recovery.conf, recovery.done."
},
{
"commit": "332055971e29beb031276d7ce32ad4827dabf6d2",
"date": "2016-08-15 20:54:17 -0400",
"subject": "Added hints to error message when relative paths are detected in archive-push or archive-get."
},
{
"commit": "b25f10949a016cc4dc6d2e3ca1c8a63f764059c9",
"date": "2016-08-15 20:15:17 -0400",
"subject": "Fixed #229: Check fails on target db host.",
"body": "Options that should not allow multiple values could be specified multiple times in pgbackrest.conf without an error being raised."
},
{
"commit": "88d9bd3d37475c907a4fffdbf907deafc0b44bc3",
"date": "2016-08-15 17:44:51 -0400",
"subject": "Improvements in Db module.",
"body": "* Separated out connect() function.\n* Allow executeSql() calls that do not return data.\n* Improve error handling."
},
{
"commit": "1e0f15f4253319ff141455a46d597d2f387c8ff1",
"date": "2016-08-15 17:23:37 -0400",
"subject": "Improve error message for links that reference links in manifest build."
},
{
"commit": "f9fa1270b24e2511717d4b4a3ddbee861bb32760",
"date": "2016-08-15 17:11:45 -0400",
"subject": "Fixed #236: Recursive user tablespace symlink.",
"body": "A tablespace link that referenced another link would not produce an error, but instead skip the tablespace entirely."
},
{
"commit": "35931305d71186935534b26d0b08c25946decd58",
"date": "2016-08-15 16:48:24 -0400",
"subject": "Update control version for PostgreSQL beta4."
},
{
"commit": "17b79d62799ac82876b71d79a57d5e5259a2431d",
"date": "2016-08-11 22:35:24 -0400",
"subject": "Database version refactoring.",
"body": "* Refactor db version constants into a separate module.\n* Update synthetic backup tests to PostgreSQL 9.4."
},
{
"commit": "bff262ac4791fae834f13ee4c422da8a4e7cdb1d",
"date": "2016-08-11 17:32:28 -0400",
"subject": "Removed all OP_* function constants that were used only for debugging, not in the protocol, and replaced with __PACKAGE__."
},
{
"commit": "9f19e13095628bf1b654db08ea3eec883c2cc5cd",
"date": "2016-08-09 10:06:21 -0400",
"subject": "v1.05: Bug Fix for Tablespace Link Checking"
},
{
"commit": "34afe5e85b682803dec846bfe480c82d3b3ca05c",
"date": "2016-08-09 09:05:27 -0400",
"subject": "Fixed issue with tablespace link checking.",
"body": "* Tablespace paths that had $PGDATA as a substring would be identified as a subdirectories of $PGDATA even when they were not.\n* Also hardened relative path checking a bit."
},
{
"commit": "af790be34f8cc58c39100f125cff6f539aa47946",
"date": "2016-08-02 12:55:09 -0400",
"subject": "Added documentation for scheduling backups with cron.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "730262678a2f250076c1b772cdc4a457dd6708f4",
"date": "2016-08-02 12:49:39 -0400",
"subject": "Improved rendering of spaces in code blocks."
},
{
"commit": "f0c97289215174cb95d3b4df89cbf9e13ca03243",
"date": "2016-08-02 11:38:12 -0400",
"subject": "Moved the backlog from the pgBackRest website to the GitHub repository wiki.",
"body": "Contributed by Cynthia Shang."
},
{
"commit": "277934447b0f4602260978ecb12d2e3d580632df",
"date": "2016-07-30 09:42:35 -0400",
"subject": "v1.04: Various Bug Fixes"
},
{
"commit": "f2b3dda647c9abc487a099876fa0b03f7cd4fa53",
"date": "2016-07-30 08:49:26 -0400",
"subject": "Fixed an issue where a remote could try to start its own remote.",
"body": "This is a better approach than 93320b8 (reverted in this commit) because it ensures that the remote type will be none so any functions that utilize optionRemoteTypeTest will work correctly.\n\nThis bug was only an issue when backup-host was not properly configured on the database host."
},
{
"commit": "94a4cb4123c9a300d66e1f34b666bba84f4d727b",
"date": "2016-07-30 08:43:38 -0400",
"subject": "Disable control master for older OS versions where it is less stable."
},
{
"commit": "1b6b26956ab2d0ee7957d48b148b080376c0a3fe",
"date": "2016-07-29 18:46:19 -0400",
"subject": "Reduce the frequency that certain tests are run to save time in regression."
},
{
"commit": "ac23716d26aaa14470f1ff8307dfe6010e0c3c05",
"date": "2016-07-29 18:46:19 -0400",
"subject": "Enhancements to the protocol layer for improved reliability and error handling."
},
{
"commit": "b44786321889a2f7599c505c9f7b1b3726810dff",
"date": "2016-07-29 18:46:19 -0400",
"subject": "Exceptions are now passed back from threads as messages when possible rather than raised directly."
},
{
"commit": "93320b865e891701dea7383166f8bca6117d5efc",
"date": "2016-07-29 18:45:37 -0400",
"subject": "Fixed a issue where a remote could try to start its own remote."
},
{
"commit": "af5965a6ef9ebe76a1b5ff5c6a82fdaa5f4d3658",
"date": "2016-07-29 18:45:23 -0400",
"subject": "Fixed an invalid log call in lock routines."
},
{
"commit": "a3b8808f94cb8ca6931517002cf30c8b3987357b",
"date": "2016-07-29 18:44:53 -0400",
"subject": "Fixed an issue where the contents of pg_xlog were being copied if the directory was symlinked."
},
{
"commit": "ef33febfb73f449085d6f3da9b0bd6157560e52f",
"date": "2016-07-29 18:43:59 -0400",
"subject": "Temp files created during backup are now placed in the same directory as the target file."
},
{
"commit": "95bbc8ad544cac4a95a90f94de2ca8856811dc37",
"date": "2016-07-29 18:02:16 -0400",
"subject": "Fixed an issue where multi-threaded tests were not being run when requested."
},
{
"commit": "6e9d5f5bd31c835bf6aa7058c3c00a160d56b6c8",
"date": "2016-07-29 14:02:11 -0400",
"subject": "Fixed check command to throw an error when database version/id does not match that of the archive.",
"body": "Fixed by Cynthia Shang."
},
{
"commit": "f95d4af64a9e7cee15e190704fa9b4522f08e31e",
"date": "2016-07-26 18:50:58 -0400",
"subject": "Closed #220: Installation documentation misinformation.",
"body": "Updated information about package availability on supported platforms."
},
{
"commit": "ee80b7b255edeac3513781a6d77c84d916832baf",
"date": "2016-07-26 18:30:25 -0400",
"subject": "Added clarification on why the default for the backrest-user option is backrest."
},
{
"commit": "18447569906f915c7801e9ac07500e6d72c8482d",
"date": "2016-07-26 17:40:42 -0400",
"subject": "Closed #209: Don't use \"localtime\" for HTML-docs.",
"body": "HTML footer dates are statically created in English in order to be reproducible."
},
{
"commit": "273d1c08d8cae647afe1b228a865de9a92177cd1",
"date": "2016-07-26 16:57:38 -0400",
"subject": "Improved remote error messages to identify the host where the error was raised."
},
{
"commit": "bc5c04ffe71faed09519e0bfff1f9ef579fc5aae",
"date": "2016-07-26 16:39:01 -0400",
"subject": "Updated control/catalog/WAL versions for 9.6 beta3."
},
{
"commit": "b6ac6b0f1c0d011ada945d9d027c67923a98173b",
"date": "2016-07-26 16:28:43 -0400",
"subject": "Suppress banners on SSH protocol connections."
},
{
"commit": "f31ec20fcb249027a4aa455a9193eee40842497d",
"date": "2016-07-26 16:21:14 -0400",
"subject": "Reduce calls to protocolGet() in backup/restore."
},
{
"commit": "98a67792ecd02c05511de7ec9c1830a200326ea7",
"date": "2016-07-26 16:14:15 -0400",
"subject": "Output lock file name when a lock cannot be acquired to aid in debugging."
},
{
"commit": "d96b1a0dbc86fab538bf1be53825675774e9cbc9",
"date": "2016-07-26 16:12:38 -0400",
"subject": "All remote types now take locks.",
"body": "The exceptions date to when the test harness and pgBackRest were running in the same VM and no longer apply."
},
{
"commit": "095351f145003c62b24770e8a5ef96ec6125e624",
"date": "2016-07-26 16:08:05 -0400",
"subject": "Fixed #219: Unable to acquire restore lock.",
"body": "Fixed an issue an where an extraneous remote was created causing threaded backup/restore to possibly timeout and/or throw a lock conflict."
},
{
"commit": "5893c3cd2e7e6dd77283b17d59a5e72c34f6dec7",
"date": "2016-07-19 15:26:41 -0400",
"subject": "Fixed an issue where db-path was not required for the check command so an assert was thrown when it was missing rather than a polite error message.",
"body": "Reported by Michael Vitale."
},
{
"commit": "9ae6c01432ba66f5b2b743394af0ac00908a0ea9",
"date": "2016-07-19 15:22:20 -0400",
"subject": "Fixed a version checking issue in test.pl."
},
{
"commit": "6e528080650dda98109d2bc31c48197804a29eda",
"date": "2016-07-02 11:08:25 -0400",
"subject": "Added release.pl to make releases reproducible."
},
{
"commit": "1b62354dcb6cd815fc8a5b235b0aaf52eb85a692",
"date": "2016-07-02 10:22:52 -0400",
"subject": "v1.03: Check Command and Bug Fixes"
},
{
"commit": "186ca18659f42e1cc287f0737db0f2138fa3dc54",
"date": "2016-07-02 09:19:10 -0400",
"subject": "Update WAL/catalog versions for 9.5 beta 2."
},
{
"commit": "5df2eed72916bc68dbf2bb0d772b4a5e3fcfbe55",
"date": "2016-07-02 09:07:48 -0400",
"subject": "Order database versions during test.pl --vm-build."
},
{
"commit": "418039027b32c680680f83183dabb1f7e1adbcb4",
"date": "2016-07-02 09:02:55 -0400",
"subject": "Closed #213: Archive command should not be validate when archive-check=n"
},
{
"commit": "0f2eb424bb6d53f2c6619f70535706e649f7c9a9",
"date": "2016-07-02 08:59:11 -0400",
"subject": "Fix for container build in Vagrantfile."
},
{
"commit": "9f9396943f20e00157b53494bc074d355456b689",
"date": "2016-06-30 19:38:28 -0400",
"subject": "Added documentation for asynchronous archiving.",
"body": "Also removed some obsolete sections."
},
{
"commit": "304d890f6c0ead8d49cf8f31fcef9f918904896a",
"date": "2016-06-27 23:07:47 -0400",
"subject": "Release note edits."
},
{
"commit": "9516db4ad660a4be29fd43b34ab9e0ef848daaf8",
"date": "2016-06-27 20:37:25 -0400",
"subject": "Closed #209: Don't use \"localtime\" for HTML-docs.",
"body": "The release-date-static var has been added to allow the html footer to use the last release date instead of localtime()."
},
{
"commit": "cc2a8777d5efdaebfc17b053f747e8683a8ce3b1",
"date": "2016-06-26 21:01:20 -0400",
"subject": "User/group permissions improvements.",
"body": "Improved handling of users/groups captured during backup that do not exist on the restore host. Also explicitly handle the case where user/group is not mapped to a name."
},
{
"commit": "b571218930c4ef5578e2c42f73c3e24bcfaba216",
"date": "2016-06-26 20:53:45 -0400",
"subject": "Minor refactor of version variable to a constant.",
"body": "It had originally been designed to play nice with a specific packaging tool but that tool was never used."
},
{
"commit": "6ee485cc76ec05421ac4f45e50cd90911739163d",
"date": "2016-06-24 13:16:07 -0400",
"subject": "Added more keep-alives.",
"body": "Keep-alives were also missing from multi-threaded backup/restore and single-threaded restore."
},
{
"commit": "bd25223fd6167ef2e1cc4e9788de46371a647572",
"date": "2016-06-24 10:54:31 -0400",
"subject": "Rename test paths for clarity.",
"body": "This was worked out as part of the test suite refactor [c8f806a] but not committed with it because of the large number of expect logs changes involved. Keeping them separate made it easier to audit the changes in the refactor."
},
{
"commit": "c8f806a293813323affea96c73b1aa177a0ac15a",
"date": "2016-06-24 08:12:58 -0400",
"subject": "Major refactor of the test suite.",
"body": "* Make the code more modular and object-oriented.\n* Multiple Docker containers can now be created for a single test to simulate more realistic environments."
},
{
"commit": "23a39118301384d939f431a344a724c8fc39f5e0",
"date": "2016-06-24 08:06:20 -0400",
"subject": "Stop using pg_xlogfile_name().",
"body": "The pg_xlogfile_name() function is no longer used to construct WAL filenames from LSNs. While this function is convenient it is not available on a standby. Instead, the archive is searched for the LSN in order to find the timeline. If due to some misadventure the LSN appears on multiple timelines then an error will be thrown, whereas before this condition would have passed unnoticed."
},
{
"commit": "41b27c0456793694316daa882ffbd2209fd249c3",
"date": "2016-06-22 18:01:18 -0400",
"subject": "Protocol timeout option and keep-alive fixes.",
"body": "* Fixed an issue where keep-alives could be starved out by lots of small files during multi-threaded operation and were completely absent during single-threaded operation when resuming from a previous incomplete backup.\n\n* Added the protocol-timeout option. Previously protocol-timeout was set as db-timeout + 30 seconds.\n* Failure to shutdown remotes at the end of the backup no longer throws an exception. A warning is still generated that recommends a higher protocol-timeout."
},
{
"commit": "4cff5bb0e69f03f047f8e8fe96a9ea336d7b4f31",
"date": "2016-06-18 10:59:45 -0400",
"subject": "Fixed pgBackRest config sections being blank in the output when not loaded from cache."
},
{
"commit": "012405a33b01a3f215a0ee610a2648c5f5afb0f6",
"date": "2016-06-18 09:55:00 -0400",
"subject": "Closed #207: Expire fails with unhandled exception.",
"body": "* Fixed an issue where the expire command would refuse to run when explicitly called from the command line if the db-host option was set. This was not an issue when expire was run after a backup, which is the usual case.\n* Option handling is now far more strict. Previously it was possible for a command to use an option that was not explicitly assigned to it. This was especially true for the backup-host and db-host options which are used to determine locality."
},
{
"commit": "e988b96eceafd1619d2f8c51c94e38523a051f54",
"date": "2016-06-18 09:22:26 -0400",
"subject": "Fixed issue in doc info output with --require.",
"body": "Section names were being repeated in the info output when multiple --require options depended on the same sections."
},
{
"commit": "cb32a8ab1f1aa2f71070cfd61c70d7fb4933abb4",
"date": "2016-06-13 11:18:06 -0400",
"subject": "VM build improvements.",
"body": "* Properly set user env before calling test.pl --vm-build.\n* Remove squid proxy made obsolete by more efficient builds."
},
{
"commit": "7e45ed8366f8933a0e8f52b5777f6618d57766a2",
"date": "2016-06-12 09:13:46 -0400",
"subject": "Added check command.",
"body": "The check command validates that pgBackRest is configured correctly for archiving and backups."
},
{
"commit": "7c9eaf7210181ca806c1e8b477bc8a0df8d4af3a",
"date": "2016-06-12 09:01:56 -0400",
"subject": "Add cmd-description tag.",
"body": "Allow command summaries to be inserted anywhere in the documentation to avoid duplication."
},
{
"commit": "f1e92804cef8e2fa7f85d231aaf5d5710130bee9",
"date": "2016-06-12 09:00:16 -0400",
"subject": "Docker container improvements.",
"body": "* Containers now use a squid proxy for apt/yum to speed builds.\n* Obsolete containers are removed by the --vm-force option.\n* Greatly reduced the quantity of Docker containers built by default. Containers are only built for PostgreSQL versions specified in db-minimal and those required to build documentation. Additional containers can be built with --db-version=all or by specifying a version, e.g. --db-version=9.4."
},
{
"commit": "3d761b726aeb243ffda53e6c8d122aa9d323ac32",
"date": "2016-06-10 21:22:36 -0400",
"subject": "Update TeX Live to 2016 version."
},
{
"commit": "5660f69859f02be53b328f7b7773b651ba4e13c1",
"date": "2016-06-06 13:27:52 -0400",
"subject": "Fixed DTDs not being loaded from test.pl."
},
{
"commit": "3f7ca876c255f7e3af772cf374ba9bc44a2be701",
"date": "2016-06-04 12:24:31 -0400",
"subject": "PostgreSQL version is now a variable to allow multi-version documentation."
},
{
"commit": "bfed78ef42599ea5c7e883b16efef973ee84b23a",
"date": "2016-06-04 12:04:09 -0400",
"subject": "New, consolidated implementation for link rendering."
},
{
"commit": "1ddfb1e453aef26590b649c77330d5206978917d",
"date": "2016-06-04 11:40:33 -0400",
"subject": "Fixed pgBackRest-specific xml that was loaded for non-pgBackRest projects."
},
{
"commit": "8ddfab0cbc646bfd11fcee1b4a47d3a3b617ae7a",
"date": "2016-06-04 11:38:23 -0400",
"subject": "Fixed DTD search path.",
"body": "The search path that did not work properly when --doc-path was used."
},
{
"commit": "e796f563c4af7a265a1f8ecd94e7f3f795a78839",
"date": "2016-06-03 20:07:28 -0400",
"subject": "Add cmd-extra field.",
"body": "Allow hidden options to be added to a command. This allows certain commands (like apt-get) to be forced during the build without making that a part of the documentation."
},
{
"commit": "36cf0b18f5c7db870f8b0338ee43e84c32ad4661",
"date": "2016-06-03 18:59:12 -0400",
"subject": "Update installation documentation.",
"body": "* Recommended install location for pgBackRest modules is now /usr/share/perl5 since /usr/lib/perl5 has been removed from the search path in newer versions of Perl.\n\n* Added instructions for removing prior versions of pgBackRest."
},
{
"commit": "bfaee7380d6aa0a4a4573df2a6a28581537d169b",
"date": "2016-06-02 11:10:24 -0400",
"subject": "v1.02: Bug Fix for Perl 5.22"
},
{
"commit": "eaa981c5aae6b3d8a04fd2d518f180be0921ba4c",
"date": "2016-06-02 09:32:56 -0400",
"subject": "Added execution cache for document generation.",
"body": "Added an execution cache so that documentation can be generated without setting up the full container environment. This is useful for packaging, keeps the documentation consistent for a release, and speeds up generation when no changes are made in the execution list."
},
{
"commit": "df6086bd24ce9d9322e5c048e5337719e9a43a0a",
"date": "2016-06-02 09:25:12 -0400",
"subject": "Added a man page to document generation."
},
{
"commit": "9a9f26a96f0365b0223231f74426602edb5caad9",
"date": "2016-05-27 18:36:25 -0400",
"subject": "Some wordsmithing in the introduction."
},
{
"commit": "174b16165b2cd555fd63a6516520900089d643ab",
"date": "2016-05-26 16:57:35 -0400",
"subject": "Replaced overzealous perl -cW check.",
"body": "It failed on Perl 5.22 so replaced with with perl -cw."
},
{
"commit": "379ab1b3533c525d87b2dacd34ac7d3a9796305e",
"date": "2016-05-26 15:04:18 -0400",
"subject": "Improve log directory/file creation.",
"body": "Log directory create and file open now using FileCommon functions which produce more detailed error messages on failure."
},
{
"commit": "e4e885d602781afd42f78c74378af2e78e0a4d27",
"date": "2016-05-26 14:22:26 -0400",
"subject": "Add notes for Ubuntu 16.04 upgrade."
},
{
"commit": "cf344c144f6c12cca2950429ce61ae075f69d902",
"date": "2016-05-26 14:17:50 -0400",
"subject": "Fixed absolute paths that were used for the PDF logo."
},
{
"commit": "b19143b6eaf0a04f921c791a7e62e2aa4f367547",
"date": "2016-05-26 14:07:29 -0400",
"subject": "Fixed syntax in doc code that was not compatible with Perl 5.2X."
},
{
"commit": "28f1c927e715b55aa4b5dcba936a6f6c03d46ed5",
"date": "2016-05-26 14:03:32 -0400",
"subject": "Upgrade doc/test VM to Ubuntu 16.04.",
"body": "* This will help catch Perl errors in the doc code since it is not run across multiple OSs like the core and test code.\n* It is to be hoped that a newer kernel will make Docker more stable."
},
{
"commit": "3d437d9278488d25b30da828a173042774c0e009",
"date": "2016-05-26 11:23:52 -0400",
"subject": "Fix usage of sprintf() for Perl 5.22.",
"body": "Parameters not referenced in the format string are no longer allowed."
},
{
"commit": "b1c779e606bf6d7e1a30c338694ae628fbac853b",
"date": "2016-05-26 11:04:19 -0400",
"subject": "Next development cycle."
},
{
"commit": "bfec2d2f89a0e746d145bd896b8f9c4ba02dde9d",
"date": "2016-05-26 11:03:10 -0400",
"subject": "Fixed release version test when the current version is development."
},
{
"commit": "c8d68bcf2d33b206634d0d537ef6d4bfb84229ba",
"date": "2016-05-26 10:34:10 -0400",
"subject": "More detailed release notes.",
"body": "Release notes are now broken into sections so that bugs, features, and refactors are clearly delineated. An \"Additional Notes\" section has been added for changes to documentation and the test suite that do not affect the core code."
},
{
"commit": "0fb8bcbfb7107b83c345dac1858aab02eeeb4302",
"date": "2016-05-26 09:34:03 -0400",
"subject": "Lists can now be used outside of p and text tags.",
"body": "This allows for more flexible document structuring."
},
{
"commit": "5a85122841ff38bea5b7b3d02a5d8ace40a4e81f",
"date": "2016-05-26 09:20:55 -0400",
"subject": "Moved change log to website.",
"body": "The change log was the last piece of documentation to be rendered in Markdown only. Wrote a converter so the document can be output by the standard renderers. The change log will now be located on the website and has been renamed to \"Releases\"."
},
{
"commit": "e2094c3d312a69544cd144e4758508c7966075b8",
"date": "2016-05-26 09:09:42 -0400",
"subject": "Remove function constants and pass strings directly to logDebugParam().",
"body": "The function names were only used once so creating constants for them was wasteful."
},
{
"commit": "e7d4a25d6a5613b89e3186517f6d4888b3ed9faa",
"date": "2016-05-24 08:17:13 -0400",
"subject": "Added Ubuntu 16.04 and Debian 8 to regression tests.",
"body": "Also added some new fields to make container generation simpler for distros that share a common package base."
},
{
"commit": "f2a14a06e5a3b9b702cdbcf5f7cfdfb0acfa6e51",
"date": "2016-05-23 20:04:36 -0400",
"subject": "Moved version checking code so it doesn't run in containers.",
"body": "The required modules were not loaded so errors were occurring during regression tests."
},
{
"commit": "c604b6e657a0ff195d291d6b7f972ef02f508011",
"date": "2016-05-23 19:33:02 -0400",
"subject": "Test release version using change-log.xml instead of CHANGELOG.md.",
"body": "This is in preparation for moving the change log to the website and removing it from Github."
},
{
"commit": "3af48f1d7818287d9e4443748becc63b86958ab7",
"date": "2016-05-20 11:18:51 -0400",
"subject": "Initialize local variable variable immediately, per Perl Critic."
},
{
"commit": "c9632e987437031d40765019bd6ee279cb101197",
"date": "2016-05-19 17:10:34 -0400",
"subject": "Closed #195: Added type from source node in manifest.xml.",
"body": "This parameter `allows the doc code to determine if special handling is needed for the xml document."
},
{
"commit": "3a309256fa9547f8a26fe0563a873a5be1385c2f",
"date": "2016-05-19 10:25:04 -0400",
"subject": "Closed #193: Fix perl warnings in doc/ tree.",
"body": "Somewhere between perl 5.14 and 5.20, constructs like this:\n perl -e '$a = {}; keys $a'\nstarted to throw warnings:\n keys on reference is experimental at -e line 1.\n\nFix by adding a bunch of %{} and @{} casts."
},
{
"commit": "b710c016302d8d29c502aab5688197bf9a664131",
"date": "2016-05-17 01:04:01 -0400",
"subject": "v1.01: Enhanced Info, Selective Restore, and 9.6 Support"
},
{
"commit": "0451d3afddfd6af2b6d32c2aba898e13f4cd170a",
"date": "2016-05-16 17:59:26 -0400",
"subject": "Support for non-exclusive backups in PostgreSQL 9.6."
},
{
"commit": "28c5e54b09c5428c53f43a8e6b9b2c2ce727ad09",
"date": "2016-05-16 17:01:48 -0400",
"subject": "Added SEO and sharing features to the website.",
"body": "Descriptions wordsmithed (for better or worse) by committer."
},
{
"commit": "48eecc2c04d59f74755d7f4db2b73da8e9e29ce6",
"date": "2016-05-16 16:49:54 -0400",
"subject": "Added vim to test virtual machine."
},
{
"commit": "9b5a27f6578b7041d72f8527e71c35aa60c0e8ab",
"date": "2016-05-14 10:39:56 -0400",
"subject": "Add Manifest->addFile().",
"body": "Some files need to be added to the manifest after the initial build. This is currently done in only one place but usage will expand in the future so the functionality has been encapsulated in addFile()."
},
{
"commit": "77b01e980fc82d81585531bd688d8a32bed759d5",
"date": "2016-05-14 10:36:35 -0400",
"subject": "Make the initial capital for hints consistent.",
"body": "Some hints started with a capital letter and others did not. Make them all lower case for consistency."
},
{
"commit": "512d006346a06ef2eaf7af7ac2863a2c1a62f3de",
"date": "2016-05-14 10:33:12 -0400",
"subject": "Refactor database version identification for archive and backup commands.",
"body": "Added database version constants and changed version identification code to use hash tables instead of if-else. Propagated the db version constants to the rest of the code and in passing fixed some path/filename constants.\n\nAdded new regression tests to check that specific files are never copied."
},
{
"commit": "4d9920cc48d871035a9a601095c6700510dd5388",
"date": "2016-05-14 10:29:35 -0400",
"subject": "Fix null and linefeed handling in Db->executeSql().",
"body": "The join() used was not able to handle nulls and was replaced by a loop. An injudicious trim was removed when the source of extra linefeeds was determined to be an additional loop execution that was not handled correctly."
},
{
"commit": "0c320e7df77a63e3bbebf43dc931b5884531a772",
"date": "2016-05-11 09:21:39 -0400",
"subject": "Allow selective restore of databases from a cluster backup.",
"body": "This feature can result in major space and time savings when only specific databases are restored. Unrestored databases will not be accessible but must be manually dropped before they will be removed from the shared catalogue."
},
{
"commit": "e430f0a05439ff851d3c4fa8b5a19cd1c743b945",
"date": "2016-05-11 08:59:34 -0400",
"subject": "Added `--db-version=minimal` option as default.",
"body": "This change assigns each version of PostgreSQL to a specific OS version for testing to minimize the number of tests being run. In general, older versions of PostgreSQL are assigned to older OS versions.\n\nThe old behavior can be enabled with `--db-version=all`."
},
{
"commit": "a6a19e3735f5edfa449fe351372b9d4be625d03e",
"date": "2016-05-10 18:12:37 -0400",
"subject": "Test directories are now located on the host VM rather than in the Docker container.",
"body": "This change allows for easier testing since all files are local on the host VM and can be easily accessed without using `docker exec`. In addition, this change is required to allow multiple Docker containers per test case which is coming soon."
},
{
"commit": "60b901948af90126700685b5424f332a490d1ad1",
"date": "2016-05-06 10:25:46 -0400",
"subject": "Enhanced text output of info command to include timestamps, sizes, and the reference list for all backups."
},
{
"commit": "7b64843221277d4afb7a6a2c8ac4222faf7c551b",
"date": "2016-05-06 09:37:01 -0400",
"subject": "Added trim() to process id read from lock file.",
"body": "The prior way worked fine but added extraneous linefeeds to the log output."
},
{
"commit": "c477d6f8998f9e8fa8d7015b1c850e1332ab00cc",
"date": "2016-05-05 18:13:50 -0400",
"subject": "Next development cycle."
},
{
"commit": "6cd1c42ddc19f2511f159ea1ccdcc5469f728594",
"date": "2016-05-03 16:28:20 -0400",
"subject": "Add usage documentation for test.pl."
},
{
"commit": "7b030c5173b6d67c72b3efe54b3542ae3d694432",
"date": "2016-05-03 16:12:44 -0400",
"subject": "User Guide clarifications."
},
{
"commit": "afc8a76ee9ed26738f8b0777a14e5084e9087d20",
"date": "2016-04-25 16:33:08 -0400",
"subject": "Fixed typos in user guide."
},
{
"commit": "226d266d087b1d686e2171aa6f20ab216ef63e97",
"date": "2016-04-17 11:43:33 -0400",
"subject": "Added current stable release to documentation."
},
{
"commit": "0d34c34cea1d8cca005e659e03c1520792b5c6a1",
"date": "2016-04-17 11:27:19 -0400",
"subject": "Added feature backlog.",
"body": "This backlog is intended to hold long-lived feature requests that clutter up the issues area on Github."
},
{
"commit": "7bdfa7839a1fa260b857bcde9a7e91414d7196e6",
"date": "2016-04-17 09:32:03 -0400",
"subject": "Minor wording change: problems => challenges."
},
{
"commit": "7bd9b28ff4e5c296ff5c76b0259b40fe90c58b54",
"date": "2016-04-17 08:23:09 -0400",
"subject": "Expanded feature bullet points into a new section with detailed explanations.",
"body": "Copy editing by John Harvey (@crunchyjohn), Jason O'Donnell (@Dwaligon), and Stephen Frost (@sfrost)."
},
{
"commit": "ed20c2eda3790b6a327f05a1c08761cdec38f8eb",
"date": "2016-04-16 16:38:44 -0400",
"subject": "Close #172: Unable to unpack Int64 when running on 32-bit OS",
"body": "Added a note to documentation that only 64-bit distributions are supported. It seems unlikely that anybody would be running a production server on anything else these days so we'll wait for a field report before taking further action."
},
{
"commit": "dee3e86ff8444689f427147e9199070b8bb46ab3",
"date": "2016-04-16 11:55:23 -0400",
"subject": "README.md is now rendered by new Markdown code."
},
{
"commit": "ad8ad11e4f555fb5b50c963eb6a61eae642e6750",
"date": "2016-04-16 11:11:29 -0400",
"subject": "Update URLs for new Github org."
},
{
"commit": "9ab0dd80f70cc69a6edc9e61b6053752a789fde3",
"date": "2016-04-14 23:04:20 -0400",
"subject": "v1.00: New Repository Format and Configuration Scheme, Link Support"
},
{
"commit": "9457e15347b05b4565074a3455f9edc4d1edaae3",
"date": "2016-04-14 22:50:02 -0400",
"subject": "New manifest format.",
"body": "* All files and directories linked from PGDATA are now included in the backup. By default links will be restored directly into PGDATA as files or directories. The --link-all option can be used to restore all links to their original locations. The --link-map option can be used to remap a link to a new location.\n\n* Removed --tablespace option and replaced with --tablespace-map-all option which should more clearly indicate its function.\n\n* Added detail log level which will output more information than info without being as verbose as debug."
},
{
"commit": "9a7d8b26cceb435d69378dd4bdc4eab74af11167",
"date": "2016-04-14 13:50:58 -0400",
"subject": "Fixed some inaccurate statements in the user guide. Fixed typo in documentation code comments."
},
{
"commit": "18fd25233b1db7b3197f5d8dc537d239dcfc7aba",
"date": "2016-04-14 09:30:54 -0400",
"subject": "New simpler configuration and consistent project/exe/path naming.",
"body": "* The repo-path option now always refers to the repository where backups and archive are stored, whether local or remote, so the repo-remote-path option has been removed. The new spool-path option can be used to define a location for queueing WAL segments when archiving asynchronously. Otherwise, a local repository is no longer required.\n\n* Implemented a new config format which should be far simpler to use. See the User Guide and Configuration Reference for details but for a simple configuration all options can now be placed in the stanza section. Options that are shared between stanzas can be placed in the [global] section. More complex configurations can still make use of command sections though this should be a rare use case.\n\n* The default configuration filename is now pgbackrest.conf instead of pg_backrest.conf. This was done for consistency with other naming changes but also to prevent old config files from being loaded accidentally.\n\n* The default repository name was changed from /var/lib/backup to /var/lib/pgbackrest.\n\n* Lock files are now stored in /tmp/pgbackrest by default. These days /run/pgbackrest would be the preferred location but that would require init scripts which are not part of this release. The lock-path option can be used to configure the lock directory.\n\n* Log files are now stored in /var/log/pgbackrest by default and no longer have the date appended so they can be managed with logrotate. The log-path option can be used to configure the lock directory.\n\n* Executable filename changed from pg_backrest to pgbackrest."
},
{
"commit": "885797e4b58a675487a3531ba16908c1d1e9f970",
"date": "2016-04-13 19:09:35 -0400",
"subject": "Migrated many functions from File.pm to FileCommon.pm.",
"body": "This makes make the migrated file functions available to parts of the code that don't have access to a File object. They still exist as wrappers in the File object to support remote calls."
},
{
"commit": "be8487dbad8a52f8b1f5083e3d7e2e3e47140dce",
"date": "2016-04-13 19:05:31 -0400",
"subject": "Changed some TBD comments from urgent to whenever."
},
{
"commit": "723abadb750c78b661c9d29404455d4a95cfc7aa",
"date": "2016-04-13 18:55:34 -0400",
"subject": "Change spacing in expect logs to accommodate DETAIL level."
},
{
"commit": "64b2858bb50c6b5f5f3cc6934c6dab671c203bbe",
"date": "2016-04-13 18:47:29 -0400",
"subject": "Test VM build improvements.",
"body": "* Specific VMs can now be built by using --vm along with --vm-build.\n* Docker caching can be disabled with --vm-force.\n* ControlMaster is now used for al VMs to improve test speed."
},
{
"commit": "0e4fdda6d8f7da0b737f2ffd3f0d1ad9ec3a33ab",
"date": "2016-04-12 15:50:25 -0400",
"subject": "Improved error handling when remote closes unexpectedly.",
"body": "In conditions where an error is known to have occurred wait to try and capture the error in the first call that detects the error. Due to timing sometimes the error could be caught later, which worked, but it made the functionality inconsistent in testing."
},
{
"commit": "8adbcccd02d133f9650486019911f41afe80100d",
"date": "2016-04-06 10:00:11 -0400",
"subject": "Closed #184: Change test/log directory to test/expect.",
"body": "This should make it clearer that these are expect logs for regression testing."
},
{
"commit": "aacc369e4fc5ff40c8731f47303c547934315988",
"date": "2016-04-06 09:41:33 -0400",
"subject": "Next development cycle."
},
{
"commit": "5307c858a7007c9b17f63aaef0439ac951d8741a",
"date": "2016-04-06 09:14:06 -0400",
"subject": "v0.92: Command-line Repository Path Fix"
},
{
"commit": "1ce9961f8a65e0e127418905c54a11736e8b6ad3",
"date": "2016-04-06 08:57:46 -0400",
"subject": "Closed #183: Options --repo-path and --repo-remote-path ignored in archive-push.",
"body": "Fixed an issue where the master process was passing --repo-remote-path instead of --repo-path to the remote and causing the lock files to be created in the default repository directory (/var/lib/backup), generally ending in failure. This was only an issue when --repo-remote-path was defined on the command line rather than in pg_backrest.conf."
},
{
"commit": "1bbf3e6db4d4e1d43b03e75b3eb308565a700952",
"date": "2016-03-22 22:18:33 -0400",
"subject": "Fixed #181: Missing semicolon violates code style."
},
{
"commit": "1d4779cfe6645bcfe508cd117c3f77146164066f",
"date": "2016-03-22 10:23:20 -0400",
"subject": "Next development cycle."
},
{
"commit": "aea14c85531b564777e60ce4a6259a22413fae10",
"date": "2016-03-22 10:16:42 -0400",
"subject": "v0.91: Tablespace Bug Fix and Minor Enhancements"
},
{
"commit": "d4899141734a4ae1abe52721d7f32f2148e05579",
"date": "2016-03-22 09:57:39 -0400",
"subject": "Closed #180: Backup format regression in v0.90."
},
{
"commit": "c669dc01e957701161ea7a7ff15392157451d750",
"date": "2016-03-10 10:58:07 -0500",
"subject": "Fixed url references in latex documentation to use \\href instead of \\hyperref."
},
{
"commit": "87dd0a127ffc4a55aeefca16ebf740b0e12a1731",
"date": "2016-03-09 11:27:08 -0500",
"subject": "Clarification for delta restore documentation to indicate that files may be removed."
},
{
"commit": "004067a5fab8d7d91e24503cd560c319feccb08f",
"date": "2016-03-08 09:29:03 -0500",
"subject": "Correct retention-diff example value in documentation."
},
{
"commit": "0b317d9040d33c46f466155f9873757c11517884",
"date": "2016-02-27 10:11:58 -0500",
"subject": "Fix minor bug in protocol compression.",
"body": "This erroneous last caused a warning (which threw an error) and masked the error in decompression. It was found when accidentally attempting to decompress an already-decompressed file, so not a big deal in practice which is probably why it hug around for so long."
},
{
"commit": "d4c46acf489910ccf248f7e04438a8108647d03a",
"date": "2016-02-23 09:39:37 -0500",
"subject": "Working on #174: Get Perl Critic to pass on stern",
"body": "Added single exception for the violation of BuiltinFunctions::ProhibitStringyEval and removed from policy file."
},
{
"commit": "048571e23fc9e5b0756c0f19590fe4b74706a01e",
"date": "2016-02-23 09:25:22 -0500",
"subject": "Closed #173: Add static source code analysis",
"body": "Perl Critic added and passes on gentle. A policy file has been created with some permanent exceptions and a list of policies to be fixed in approximately the order they should be fixed in."
},
{
"commit": "d35ab82a83895049ea542b3a53b2e90f9428d176",
"date": "2016-02-19 19:32:02 -0500",
"subject": "Closed #167: Rename `--no-start-stop` option to `--no-online`."
},
{
"commit": "fb63a981cb89b7741120d87be78f7ffd38c4d5de",
"date": "2016-02-14 20:42:11 -0500",
"subject": "Closed #166: Copy global/pg_control last during backup."
},
{
"commit": "053f25d870836c001fd826927fa32b5d4ef97a58",
"date": "2016-02-11 21:42:27 -0500",
"subject": "Closed #170: Write .info and .manifest files to temp before moving to final location and syncing"
},
{
"commit": "17cbab524aa8e4ef541253aa5923afffb8f98820",
"date": "2016-02-11 21:40:43 -0500",
"subject": "Combine chmod commands in tests for efficiency."
},
{
"commit": "f360d5072e6a7ec29489a72732783153ba0c4a92",
"date": "2016-02-07 11:20:43 -0500",
"subject": "Next development cycle."
},
{
"commit": "631535ae4fc443102cac0f2da5bdc8fb2671468e",
"date": "2016-02-07 10:47:16 -0500",
"subject": "v0.90: 9.5 Support, Various Enhancements, and Minor Bug Fixes"
},
{
"commit": "de9b6d5133c5fbbb02cb0c8b7d4596843a2d3545",
"date": "2016-02-06 16:49:12 -0500",
"subject": "Closed #113: Better error message when repo does not exist."
},
{
"commit": "f8b47997a314ed6502b915a0514b20ac23598dab",
"date": "2016-02-05 23:03:29 -0500",
"subject": "Closed #127: More sanity checking for --delta restores",
"body": "Added checks for `--delta` and `--force` restore options to ensure that the destination is a valid $PGDATA directory. pgBackRest will check for the presence of `PG_VERSION` or `backup.manifest` (left over from an aborted restore). If neither is found then `--delta` and `--force` will be disabled but the restore will proceed unless there are files in the $PGDATA directory (or any tablespace directories) in which case the operation will be aborted."
},
{
"commit": "5c815e4fc0e2c8a9ea162963f32d5679d54fc852",
"date": "2016-02-02 14:33:15 -0500",
"subject": "Closed #58: Get catalog number for better tablespace copying",
"body": "When backing up and restoring tablespaces pgBackRest only operates on the subdirectory created for the version of PostgreSQL being run against. Since multiple versions can live in a tablespace (especially during a binary upgrade) this prevents too many files from being copied during a backup and other versions possibly being wiped out during a `--delta` restore. This only applies to PostgreSQL >= 9.0 -- before that only one PostgreSQL version could use a tablespace."
},
{
"commit": "24a1ad31d0dfcd8c72a71c589902446a9da75e11",
"date": "2016-02-02 11:57:46 -0500",
"subject": "Minor rewording in user guide."
},
{
"commit": "02405e851cc6f1941f0de8001cdf6829d6fa06c0",
"date": "2016-01-22 18:01:21 -0500",
"subject": "Closed #163: Document Generation Issue",
"body": "Fixed an issue where document generation failed because some OSs are not tolerant of having multiple installed versions of PostgreSQL. A separate VM is now created for each version. Also added a sleep after database starts during document generation to ensure the database is running before the next command runs."
},
{
"commit": "bacdd5583dc7dfc807c385789b26e346db6c219a",
"date": "2016-01-22 14:38:48 -0500",
"subject": "User guide highlighting fixes for #93."
},
{
"commit": "e42b8de618b0a8bd003d8b62eefadf7ed0aee34f",
"date": "2016-01-20 21:45:03 -0500",
"subject": "Updated Copyright for 2016."
},
{
"commit": "83b1a3cb4446fb59d1295706a547b41fc5bd84be",
"date": "2016-01-20 21:28:40 -0500",
"subject": "Closed #150: Fixed an issue where a temp WAL file left over after a well-timed system crash could cause the next `archive-push` to fail."
},
{
"commit": "747346db674705d7db15e8f9293016b00875b4d5",
"date": "2016-01-20 18:34:42 -0500",
"subject": "Closed #162: When restore `--set=latest` (the default) the actual backup restored will be output to the log."
},
{
"commit": "2d38876bc4676344936ad72d65d0f697c4e921c1",
"date": "2016-01-20 17:24:44 -0500",
"subject": "Closed #93: The `retention-archive` option can now be be safely set to less than backup retention (`retention-full` or `retention-diff`) without also specifying `archive-copy=n`. The WAL required to make the backups that fall outside of archive retention consistent will be preserved in the archive. However, in this case PITR will still not be possible for backups that fall outside of archive retention."
},
{
"commit": "904a8c956f53ae5f6832e6188a668d94a84220b9",
"date": "2016-01-19 07:39:29 -0500",
"subject": "Refactor of expiration to use backup.info for a list of what needs to be expired rather than looking at the backup directory."
},
{
"commit": "65cce69dcc7b03605ab46f0f542bc653ecb4154c",
"date": "2016-01-15 23:37:17 -0500",
"subject": "Closed #131: Offline backups make expire command fail."
},
{
"commit": "fce72615366dd5a78359bd05c0919210eb128019",
"date": "2016-01-15 23:22:30 -0500",
"subject": "Only allow --no-cleanup option when a single test is selected."
},
{
"commit": "4d12cc233e26e568fa8449691051b8f33b238873",
"date": "2016-01-15 20:31:29 -0500",
"subject": "Fix for typo in error message."
},
{
"commit": "e91e481f3dcdb5e03320663bfa732b3aef49b49e",
"date": "2016-01-15 07:07:00 -0500",
"subject": "Closed #19: The following tablespace checks have been added: paths or files in pg_tblspc, relative links in pg_tblspc, tablespaces in $PGDATA. All three will generate errors."
},
{
"commit": "67fb7a23bc2d448938c000ec7189cc1f9b979440",
"date": "2016-01-14 19:37:06 -0500",
"subject": "Master test log is output to file."
},
{
"commit": "65d0c7dc3bd60eb432dd4a582419c3c39866801a",
"date": "2016-01-13 22:48:35 -0500",
"subject": "Updated Crunchy URL."
},
{
"commit": "c2b1620c53555924dd4ef666db1a124702ebd5b1",
"date": "2016-01-13 22:43:26 -0500",
"subject": "Logging enhancements:",
"body": "1) Show log output realtime when --max-process=1 or only 1 test is being run.\n2) Dry run now shows test output when --vm-out is specified."
},
{
"commit": "a0a3d1e97e91ddb6ebbb2ac8ff3f2445f3c455f0",
"date": "2016-01-13 20:35:12 -0500",
"subject": "Closed #122: 9.5 Integration",
"body": "The archive_mode = always setting is not included but is covered by issue #125."
},
{
"commit": "c7502f341b4ffbe976ff08bf311f24d6d377a408",
"date": "2016-01-11 09:50:45 -0500",
"subject": "Generate an error when `archive-check=y` but `archive_command` does not execute `pg_backrest`."
},
{
"commit": "81a2fde21fc9fe98bb3473164b5ac4717bdb067b",
"date": "2016-01-10 21:07:07 -0500",
"subject": "Fixed typos in test documentation."
},
{
"commit": "0f88943b7b2e142d86d3a03755a41a1b31754338",
"date": "2016-01-10 19:30:51 -0500",
"subject": "Database versions are now run as separate tests."
},
{
"commit": "cd9fa6f028114f4e44068137a6d14bcd74d882d7",
"date": "2016-01-10 09:19:21 -0500",
"subject": "Updated test logs for partial WAL segment support."
},
{
"commit": "29102b2887dc6f0a1ad0603c48d14bc92e15fa8a",
"date": "2016-01-09 23:08:54 -0500",
"subject": "Added error when archive_mode=always is configured."
},
{
"commit": "7f0f8823df16f3bb4f68fbe7fca4da259ade6409",
"date": "2016-01-09 19:37:28 -0500",
"subject": "Added support for partial WAL segments."
},
{
"commit": "e72165a689889f87a863821f6d5edbada425feae",
"date": "2016-01-09 10:11:03 -0500",
"subject": "Provisional support for PostgreSQL 9.5. No support for `archive_mode = 'always'` or `.partial` WAL on a standby."
},
{
"commit": "c8f863fbabaf5060e6c8b837856363339740d346",
"date": "2016-01-09 08:21:53 -0500",
"subject": "Text execution improvements:",
"body": "1) Tests for all operating systems can now be run with a single command.\n2) Tests can be run in parallel with --process-max.\n3) Container generation now integrated into test.pl\n4) Some basic test documentation."
},
{
"commit": "4a384ffbdb3824b116fcf1db63920fc6eddd18ea",
"date": "2016-01-03 20:24:14 -0500",
"subject": "Added archive-check config test. Fixed capitalization error in optionboolSetTest()."
},
{
"commit": "6f6c796fbf9d4cdafcede1368b63904e9690f598",
"date": "2016-01-03 20:21:30 -0500",
"subject": "Fixed an issue where specifying --no-archive-check would throw a configuration error."
},
{
"commit": "7f630aec49eceada43d3c60f2a810cc3e5960a08",
"date": "2015-12-29 13:57:10 -0500",
"subject": "Switched to using docker for all unit tests as this allows for greater automation."
},
{
"commit": "91d1e940769cf81bd511745c9b303833d8940b66",
"date": "2015-12-24 12:49:47 -0500",
"subject": "Next development cycle."
},
{
"commit": "50a62fab6ded931efd9c87fe3767fd26f4f7318b",
"date": "2015-12-24 11:32:29 -0500",
"subject": "v0.89: Timeout Bug Fix and Restore Read-Only Repositories"
},
{
"commit": "ba098d7b91c189d8ee7f45a157ba8e5a243eb85b",
"date": "2015-12-24 10:32:25 -0500",
"subject": "Fixed an issue where longer-running backups/restores would timeout when remote and threaded.",
"body": "Keepalives are now used to make sure the remote for the main process does not timeout while the thread remotes do all the work. The error messages for timeouts was also improved to make debugging easier."
},
{
"commit": "b0a6954671dcee50e16a72f4c44d0eaa84b67c5c",
"date": "2015-12-23 11:04:26 -0500",
"subject": "A number of doc improvements:",
"body": "1) Started on a general markdown renderer\n2) Internal links now work in PDF\n3) Improvements to PDF styling\n4) Some comment and formatting fixes\n5) User guide edits."
},
{
"commit": "fdc99e30bd2e154623fb71134413a11d695d3420",
"date": "2015-12-23 10:48:33 -0500",
"subject": "Allow restores to be run against a read-only repository.",
"body": "Two things needed to be changed:\n1) Don't open a log file when log-level-file=off\n2) New --no-lock option to suppress lock file creation for restores."
},
{
"commit": "d5cef05a6857512bc1c1410909a58df4d1c102da",
"date": "2015-12-21 19:25:50 -0500",
"subject": "Added rc to version check."
},
{
"commit": "a840808bc6916e089dcb119998a742fbb8629fea",
"date": "2015-12-21 19:25:17 -0500",
"subject": "Regression test for issue #159: duplicated log section entries in config file",
"body": "Add a perl -cW test to prevent similar errors in the future."
},
{
"commit": "fe9c66591f3a0324b0bae483d825d75c4ac38d74",
"date": "2015-12-21 14:29:54 -0500",
"subject": "Fixed issue #159: Duplicated log section entries in config file",
"body": "This would cause a warning when run with perl -cw but appears to have been harmless otherwise."
},
{
"commit": "4925756dee22faee7bf6e1ca9bcd417d09cf5ba4",
"date": "2015-11-22 18:16:54 -0500",
"subject": "Merge branch 'master' into dev after release 0.88"
},
{
"commit": "e04c21b012d8196f716f093a5bbc46f16cc4a1fb",
"date": "2015-11-22 17:27:30 -0500",
"subject": "v0.88: Documentation and Minor Bug Fixes"
},
{
"commit": "fa05715dec955a30f271df9c1c059c9c876e3f4d",
"date": "2015-11-22 16:44:01 -0500",
"subject": "Added documentation in the user guide for delta restores, expiration, dedicated backup hosts, starting and stopping pgBackRest, and replication."
},
{
"commit": "8ddfdcdd3bc2ee5e76487d903696840655357f87",
"date": "2015-11-22 14:02:14 -0500",
"subject": "Various fixes and features implemented during doc development",
"body": "* Better messaging for expiration.\n* Fixed already stopped message.\n* retention-archive and retention-archive-type now use retention-full and 'full' when not specified.\n* Fixed issue where backup-user was required (should default to backrest).\n* ExecuteTest now supports retries.\n* Fixed issue where log test was not comparing test logs.\n* Fixed issue where test logs would not match for ssh connection errors"
},
{
"commit": "7ff9fc996c6f43e6c6aeff68624b145efa3fea89",
"date": "2015-11-20 11:03:06 -0500",
"subject": "Release notes for fixes and rebuild command-line help."
},
{
"commit": "4c5470e0499e336b704e9472d8a3c7463b256cc2",
"date": "2015-11-20 10:55:28 -0500",
"subject": "Implemented issue #156: Don't create backup symlinks in the repository."
},
{
"commit": "11f724bdfc31f7a3fa701d44ce985f47362f65a2",
"date": "2015-11-20 10:28:58 -0500",
"subject": "Fixed issue #155: Start/Stop do not automatically read config file."
},
{
"commit": "d89cd955d0fb5b45ec69e02e948c18eab9feb9bf",
"date": "2015-11-20 09:18:12 -0500",
"subject": "Fixed issue #154: Log files are overwritten rather than appended."
},
{
"commit": "e5cf1d84a710eb03c179b41c271e203613a89377",
"date": "2015-10-29 17:45:29 +0100",
"subject": "CSS Tweaks."
},
{
"commit": "2f83362f32114f2f516d344334e3fa25e0aaad4b",
"date": "2015-10-28 13:02:35 +0100",
"subject": "Minor user guide fix."
},
{
"commit": "a498becf11f385c4b525c318412ec8154c0ebd34",
"date": "2015-10-28 11:29:04 +0100",
"subject": "Merge branch 'master' into dev after release 0.87"
},
{
"commit": "2813c4d4ebdeccff8a54cbf8157fa3bdca01c44b",
"date": "2015-10-28 11:15:38 +0100",
"subject": "v0.87: Website and User Guide"
},
{
"commit": "32ce87d56d0def3a4249606eca9dec765fb1fca4",
"date": "2015-10-28 10:19:33 +0100",
"subject": "Fixed minor path issue in README.md."
},
{
"commit": "57a06ba3b12533d623090714c99d1604a74085e6",
"date": "2015-10-28 10:10:36 +0100",
"subject": "Implemented issue #148: Website with basic user guide."
},
{
"commit": "3dc014224487c8ab32a86874396b3e78b647315e",
"date": "2015-10-08 14:36:39 -0400",
"subject": "Renamed userguide.xml to reference.xml so it doesn't conflict with the new user guide."
},
{
"commit": "994ead1f05eac573948993b51dcb9a1f45f4876e",
"date": "2015-10-08 13:47:51 -0400",
"subject": "Removed IO::String dependency from docs."
},
{
"commit": "0bcbe21520f66f58d6795cd0e0969ba90afa8332",
"date": "2015-10-08 12:44:55 -0400",
"subject": "Merge branch 'master' into dev after release 0.85"
},
{
"commit": "097eb7ca419a49464fdcfccac873760acf4fee3e",
"date": "2015-10-08 12:34:50 -0400",
"subject": "v0.85: Start/Stop Commands and Minor Bug Fixes"
},
{
"commit": "6e170d27e4ec69b94f38f0f5db4a6abe5232f393",
"date": "2015-10-08 12:23:37 -0400",
"subject": "Replaced expired CentOS VMs with new ones."
},
{
"commit": "1f9d6c330a35cdfb7402439240e5fc8a77811fea",
"date": "2015-10-08 12:22:57 -0400",
"subject": "Updated WAL magic for PostgreSQL 9.5 beta1."
},
{
"commit": "ddd4c14773176d03ffbb30d958f6c3d8596e41a3",
"date": "2015-10-08 11:43:56 -0400",
"subject": "Implemented issue #129: Stop/Start Commands. Implemented issue #136: Add stderr back into protocol layer.",
"body": "There were also miscellaneous bug fixes and improvements to buffering in IO.pm."
},
{
"commit": "e488f7bb198b4af6f7b1595392b57648bf985dcb",
"date": "2015-09-22 21:07:49 -0400",
"subject": "Fixed issue #144: Error on resume when temp files (file.tmp.*) present."
},
{
"commit": "a3d82eef9897965dbe1bff08a92418877447acca",
"date": "2015-09-16 15:23:19 -0500",
"subject": "Document code in Db.pm."
},
{
"commit": "210f8ef723a56d0f0d4d8c4a0120729ef952a44a",
"date": "2015-09-14 12:28:22 -0400",
"subject": "Merge branch 'master' into dev after release 0.82"
},
{
"commit": "9be15d00f8527309fd81118bb483adb0b1956651",
"date": "2015-09-14 11:18:50 -0400",
"subject": "v0.82: Refactoring, Command-line Help, and Minor Bug Fixes"
},
{
"commit": "e0dafbff7ff294b137e085cde63f0e69685b31b3",
"date": "2015-09-09 15:40:54 -0400",
"subject": "Improvements to issue #132: Improved command-line help. Regression tests are now more comprehensive by default. Better handling for errors in safeExit(). Release notes."
},
{
"commit": "d7e3be1ebff5d0d017a7406552acd9b3a97f0bb8",
"date": "2015-09-08 18:29:13 -0400",
"subject": "Fixed issue #138: Fix --no-start-stop working on running db without --force.",
"body": "Unable to reproduce this anymore. It seems to have been fixed with the last round of config changes. Add regression tests to make sure it doesn't happen again."
},
{
"commit": "b17bf31fb6dbe67b6efdcd634a4d29ede1cf9d76",
"date": "2015-09-08 16:58:00 -0400",
"subject": "Implement issue #130: Info files should be updated with new version when pgBackRest is upgraded."
},
{
"commit": "59b2261a8ee15d061367ffefe598c05cb93fcb3e",
"date": "2015-09-08 16:44:47 -0400",
"subject": "Fix issue #137: Info command throws an exception if no stanzas exist."
},
{
"commit": "8d01138f6def41f12a1c3adcf4e7fbfea65b9aae",
"date": "2015-09-08 15:47:34 -0400",
"subject": "Improved issue #135: Suppress PostgreSQL notices.",
"body": "Regression tests now fail if there is any unexpected output on stderr."
},
{
"commit": "bb6963cf3b7ba30e2fa13e8df57b234d283d2cbe",
"date": "2015-09-08 14:01:19 -0400",
"subject": "Implement issue #135: Suppress PostgreSQL notices."
},
{
"commit": "adc5568b15090c797863206830730e1974bfdc7a",
"date": "2015-09-08 12:58:13 -0400",
"subject": "Fixed issue #132: Improved command-line help.",
"body": "Some platform specific fixes and added regression tests to detect issues."
},
{
"commit": "ac3c0d43ab8701855b45bc40f1298e9707dc0e14",
"date": "2015-09-08 07:31:24 -0400",
"subject": "Implemented issue #132: Improved command-line help. Implemented issue #133: Dynamic module loading where possible."
},
{
"commit": "0913072c4554d62a50e393158f4685dd52831390",
"date": "2015-09-02 19:07:21 -0400",
"subject": "Removed unused parameter from Info::new()."
},
{
"commit": "ee55817fcee2184b353e26f608b461d9d3fc9d7f",
"date": "2015-09-02 18:55:04 -0400",
"subject": "Refactoring documentation generator."
},
{
"commit": "bf3ef15ccc2991686c51ba10946ef095d248951f",
"date": "2015-09-01 19:05:10 -0400",
"subject": "Implemented issue #117: Refactor expiration tests to be purely synthetic"
},
{
"commit": "6a9377a0a9389d285cd36b1fe179d47f46e15d9a",
"date": "2015-08-29 14:20:46 -0400",
"subject": "Code cleanup and refactoring to standardize on patterns that have evolved over time."
},
{
"commit": "d3262822efff785911fa1d2450d1fb1ac0d1b950",
"date": "2015-08-27 15:55:29 -0400",
"subject": "Fixed issue #128: Replace config name in test logs",
"body": "It was actually the bin path that was causing the issue."
},
{
"commit": "83473eb9fb4e437c47a1773c7f4cb7e93f71ee2a",
"date": "2015-08-09 11:29:00 -0400",
"subject": "Merge branch 'master' into dev after release 0.80"
},
{
"commit": "a59284a4cca37a0c299f411e44cdfe7e43bb9ba7",
"date": "2015-08-09 11:20:43 -0400",
"subject": "v0.80: DBI Support, Stability, and Convenience Features"
},
{
"commit": "65d9de4ee76bcce4f102e2b17d7f7ced809880a0",
"date": "2015-08-09 09:18:58 -0400",
"subject": "Document issue #114: Better description of repo-path."
},
{
"commit": "7e49e4596f9fdaae102c5caae7dae35c25e75bef",
"date": "2015-08-08 20:17:33 -0400",
"subject": "Removed dead function wait_for_file()."
},
{
"commit": "45259a487f2522ac961ceba0bb38cc8ad0089d00",
"date": "2015-08-08 18:36:36 -0400",
"subject": "Change log for issue #94: backup_stop needs a timeout."
},
{
"commit": "1ab6239b4e9b37ed34564e9de9ee102fea82b329",
"date": "2015-08-08 18:32:41 -0400",
"subject": "Implemented issue #118: Clean up database vs. database cluster in the docs."
},
{
"commit": "e82afac8854e74fb1451491abde5f353ca496b1b",
"date": "2015-08-08 18:22:38 -0400",
"subject": "Implemented issue #94: backup_stop needs a timeout.",
"body": "The timeout applies to all queries agains the cluster during a backup."
},
{
"commit": "8c0508789e5debc508aae05d28ebe5f7f4700809",
"date": "2015-08-08 17:11:20 -0400",
"subject": "Implemented issue #25: Option to call stop_backup with every backup."
},
{
"commit": "12e8a7572c07fc4ea1d44ba944e530c391396047",
"date": "2015-08-08 00:51:58 -0400",
"subject": "Worked on issue #122: 9.5 Integration.",
"body": "Expiration tests worked differently with checkpoint_segments. Only allow this test < 9.5 until purely synthetic tests are written."
},
{
"commit": "2edf5d4bf7b47b4fd3fd446740a82c35be84dbda",
"date": "2015-08-07 14:43:53 -0400",
"subject": "Split most of README.md out into CHANGELOG.md and USERGUIDE.md. Added release dates to change log."
},
{
"commit": "61c729b37b7787740a1e011544dd97971c44d0ce",
"date": "2015-08-07 10:21:08 -0400",
"subject": "Worked on issue #122: 9.5 Integration.",
"body": "Skip copying tablespace_map instead of deleting it later.\nCleaned up the skip code for pg_control as well."
},
{
"commit": "4e7bd4468a785a00c37b5d29262d86f76f725a78",
"date": "2015-08-06 16:36:55 -0400",
"subject": "Worked on issue #122: 9.5 Integration.",
"body": "Most tests are working now. What's not working:\n\n1) --target-resume option fails because pause_on_recovery setting was removed. Need to implement to the new 9.5 option and make that work with older versions in a consistent way.\n2) No tests for the new .partial WAL segments that can be generated on timeline switch."
},
{
"commit": "adb8a009255fdfcd726bf7ded3aef60c80b645cf",
"date": "2015-08-06 00:24:02 -0400",
"subject": "Improvements to release notes."
},
{
"commit": "ca1fd9740aede681866e8a52bcece052de631597",
"date": "2015-08-06 00:00:30 -0400",
"subject": "Working on issue #117: Refactor expiration tests to be purely synthetic.",
"body": "Split BackupTest.pm into two modules. It was getting ungainly to work on."
},
{
"commit": "8b57188bc1e5e6941bf46e9fc4cfd6d8e5bd7856",
"date": "2015-08-05 23:37:46 -0400",
"subject": "Fixed issue #120: Wrong \"oldest backup timestamp\" in info output."
},
{
"commit": "a10dd8ba98b2c0e16b560e447336c663e7b865de",
"date": "2015-08-05 22:05:45 -0400",
"subject": "Implemented issue #121: Check data from db against what's passed to backrest."
},
{
"commit": "576d50fc1ed0283b5b77e99a72bdf787b473a1c3",
"date": "2015-08-05 18:54:41 -0400",
"subject": "Added ssh control master config to speed regression testing. Added vagrant config for Centos 7."
},
{
"commit": "ba4e5fc4cb486c28ddba44f60cfc77fe8b171b39",
"date": "2015-08-05 13:35:19 -0400",
"subject": "Release notes for issue #20: Convert Postgres calls from psql to DBD::Pg."
},
{
"commit": "23e6267adc90293d80887492208f68de3c40297d",
"date": "2015-08-05 12:32:12 -0400",
"subject": "Implemented issue #20: Convert Postgres calls from psql to DBD::Pg."
},
{
"commit": "f8a2da940012187d5a48c10018ded60128793f5d",
"date": "2015-08-05 08:43:41 -0400",
"subject": "Work on issue #48: Abandon threads and go to processes",
"body": "* Major refactoring of the protocol layer to support this work.\n* Fixed protocol issue that was preventing ssh errors (especially connect) from being logged."
},
{
"commit": "021afa804638c609a7a8074a9502f4bf05c01688",
"date": "2015-08-01 17:26:15 -0400",
"subject": "Ensure that info output is terminated by a linefeed.",
"body": "On some systems the JSON->encode() function was adding a linefeed and on others it was not. This was causing regression test failures in in the test logs and may have also been inconvenient for users."
},
{
"commit": "1b0f997f59ef67358b7091fe832b9a5b026da0de",
"date": "2015-07-24 18:05:06 -0400",
"subject": "Implemented issue #119: Make sure all repo permissions are 640/750.",
"body": "Updated remaining test logs."
},
{
"commit": "97c036973cb945912a08ee7774bc5619a331db7f",
"date": "2015-07-23 13:11:38 -0400",
"subject": "Implemented issue #119: Make sure all repo permissions are 640/750."
},
{
"commit": "f3199d13b1c213fe6a52c16ca935fe878dcfbc97",
"date": "2015-07-16 11:12:48 -0400",
"subject": "Implement issue #115: When restoring copy pg_control last."
},
{
"commit": "702afeb6f0e14003d4e694e5d3f2b3b39f5b6164",
"date": "2015-07-13 15:37:50 -0400",
"subject": "Merge branch 'master' into dev after release 0.78"
},
{
"commit": "c568f5e72745ec9a799c8cd42a5bb8492a5dbec2",
"date": "2015-07-13 14:44:32 -0400",
"subject": "v0.78: Remove CPAN dependencies, stability improvements"
},
{
"commit": "65847b5fb1c2886ea7d2d546236c2db3202a34ae",
"date": "2015-07-13 13:25:04 -0400",
"subject": "Vagrant backrest mount is no longer RO so development can be done entirely within VMs."
},
{
"commit": "89c0f23f372aa08dd7eaff51eb08fb09f8749d89",
"date": "2015-07-13 12:13:07 -0400",
"subject": "Update release notes and some test fixes."
},
{
"commit": "073e3b7c0055a45b0717d4a4b91ede54a3b68569",
"date": "2015-07-11 22:47:22 -0400",
"subject": "Minor for regression tests. Improved CentOS 6 vagrant config."
},
{
"commit": "ea7914d9805aea676b25bd31ce38459f32803294",
"date": "2015-07-11 19:07:28 -0400",
"subject": "Wait now uses a Fibonacci backoff rather than exponential."
},
{
"commit": "b777525f62fdde71dab702a9afef9b5ad8f6a4b5",
"date": "2015-07-11 17:16:35 -0400",
"subject": "Added --exe param to allow testing of packaged versions. Updates to u12 vagrant vm."
},
{
"commit": "e9ce4efedfb653338a5a9a40bbe1238393ea6886",
"date": "2015-07-10 09:20:28 -0400",
"subject": "Removed dependency on dequeue_timed() which eliminates the CPAN install. Added vagrant config for CentOS 6."
},
{
"commit": "1df8c305499ee698f91dacf9958c8eb56e71e64c",
"date": "2015-07-09 10:21:02 -0400",
"subject": "Swapped config and operation sections to hopefully make the docs flow a little better."
},
{
"commit": "e799361e90adcb1648b2ce208f2fb3ffdd47df2e",
"date": "2015-07-09 10:11:49 -0400",
"subject": "Clarification for CPAN requirements."
},
{
"commit": "8b7fd99637d26cff0df192534a729effa435d97a",
"date": "2015-07-06 21:00:48 -0400",
"subject": "Added vagrant configuration for Ubuntu 12.04. Changes to regression tests to work better with VMs."
},
{
"commit": "bb443dd098140e07d8ceddc56673b45f303c748d",
"date": "2015-07-06 17:59:44 -0400",
"subject": "Renamed pg_backrest.pl to pg_backrest in the docs."
},
{
"commit": "38f48be3cf7be6a24ee513f48fd4a55eb54a1ee5",
"date": "2015-07-02 10:05:13 -0400",
"subject": "Improvements to help to make it more dynamic depending on environment. Changed PgBackRest to pgBackRest."
},
{
"commit": "12932dc54cf24a43b7db7c7e829ad04cbc8816d6",
"date": "2015-06-30 14:57:17 -0400",
"subject": "Merge branch 'master' into dev after release 0.77"
},
{
"commit": "b1ded135df1e3dd4d4b40a0cbb1a7c1303e7a037",
"date": "2015-06-30 14:47:58 -0400",
"subject": "v0.77: CentOS/RHEL 6 support and protocol improvements"
},
{
"commit": "7248795b91dcc6fe749561afb556f625dfe20497",
"date": "2015-06-29 22:07:42 -0400",
"subject": "Work on issue #48: Abandon threads and go to processes",
"body": "Replaced IPC::System::Simple and Net::OpenSSH with IPC::Open3 to eliminate CPAN dependency for multiple distros. Using open3 will also be used for local processes so it make sense to switch now."
},
{
"commit": "c59adfc68dd10e2ab42a686cace1829b6e4d4e2a",
"date": "2015-06-27 11:12:44 -0400",
"subject": "Shorted test command line params."
},
{
"commit": "760baab6b25196df2e1aa430e8736debad34a433",
"date": "2015-06-22 14:35:25 -0400",
"subject": "Implemented issue #111: Add the psql path for *BSD.",
"body": "Author: Eric Radman\nModified by Committer"
},
{
"commit": "dcad0f70070488692c39409b99cb082fe3d0e796",
"date": "2015-06-22 14:20:56 -0400",
"subject": "Merged issue #111: Print the real exception when DBH->connect fails.",
"body": "Author: Eric Radman"
},
{
"commit": "f210fe99c33fbab478fc3e75cc09bd5e5089446f",
"date": "2015-06-22 13:11:07 -0400",
"subject": "Implemented issue #109: Move VERSION into source code.",
"body": "Also stopped replacing FORMAT number which explains the large number of test log changes. FORMAT should change very rarely and cause test log failures when it does."
},
{
"commit": "af580168712ac0c370cc5532bb34ab1805823ffa",
"date": "2015-06-22 10:04:58 -0400",
"subject": "Release notes for issue #108: Incompatibility with Perl 5.10.1."
},
{
"commit": "fdd9e8eb176ec0f5c087726393f15a19d121fabd",
"date": "2015-06-22 09:58:01 -0400",
"subject": "Improved release notes on fsync to include restore."
},
{
"commit": "3f841fcd95c17541d5f04012a72153a8d5cbd8ce",
"date": "2015-06-22 09:51:16 -0400",
"subject": "Improved issue #110: 'db-version' is required but not defined.",
"body": "Improved the error message and added hints."
},
{
"commit": "61dfeca3c1d2ddfce53de9fafd137607e21223b8",
"date": "2015-06-21 12:06:13 -0400",
"subject": "Fixed issue #108: Incompatibility with Perl 5.10.1"
},
{
"commit": "49f1a3e4812e962201ae80c92ad377f3f8dc4643",
"date": "2015-06-19 14:27:44 -0400",
"subject": "Document issue #108: Incompatibility with Perl 5.10.1"
},
{
"commit": "0695c0e7af347478c86a6aaddf068f712f27d91d",
"date": "2015-06-19 14:02:26 -0400",
"subject": "Document issue #108: Incompatibility with Perl 5.10.1"
},
{
"commit": "06c290421240ed74f0388a3b71e240fc1a9e6162",
"date": "2015-06-18 16:55:09 -0400",
"subject": "Change operation constants and functions to command."
},
{
"commit": "4e2c14623b5fe018ab71f797c2c1b9d9a58634cc",
"date": "2015-06-18 15:39:30 -0400",
"subject": "Work on issue #48: Abandon threads and go to processes",
"body": "More separation of the protocol and remote layers than was done in issue #106.\nSettings are passed to the remote via command-line parameters rather than in the protocol."
},
{
"commit": "22e126eda7802ac30d7f275a58425528238ee265",
"date": "2015-06-17 15:40:12 -0400",
"subject": "Fix for logic that removes trailing spaces from code."
},
{
"commit": "a050b76fa9a6785f67a7b492b8b8bad7dd94a482",
"date": "2015-06-17 15:33:58 -0400",
"subject": "Implement issue #107: Better debug commands."
},
{
"commit": "a5d9d6d84d584ed1f574f0eb7f77b32ea2c8e6e6",
"date": "2015-06-17 12:53:33 -0400",
"subject": "Added file and directory syncs to the File object for additional safety during backup and archiving."
},
{
"commit": "9511f9c35cbc4b5fac38fb67b86ad9c2f859be69",
"date": "2015-06-17 11:26:07 -0400",
"subject": "Implemented issue #106: Roll pg_backup_remote into pg_backrest"
},
{
"commit": "0ba40292532c11d00b6f1e3a5096d0e1a021cac5",
"date": "2015-06-16 16:21:24 -0400",
"subject": "Update version to 0.80."
},
{
"commit": "da8b337ee80b7c28ffb8fde7a4b0a11418b926c8",
"date": "2015-06-16 15:44:27 -0400",
"subject": "Added supported versions of PostreSQL."
},
{
"commit": "c23916d6de7004a5c039ea7810e7306e6fe99b6e",
"date": "2015-06-14 20:59:48 -0400",
"subject": "Merge branch 'master' into dev after release 0.75"
},
{
"commit": "1afbab010fc89476ba8a234772f86ca38e6c4f26",
"date": "2015-06-14 20:59:32 -0400",
"subject": "v0.75: New repository format, info command and experimental 9.5 support"
},
{
"commit": "8459e25e32433c7ecba8d4e5189fee45681ef8ae",
"date": "2015-06-14 11:49:55 -0400",
"subject": "Test fix for issue #96."
},
{
"commit": "b365d9aacc38dd8f8d6d43a99d034cb1cf8b20ff",
"date": "2015-06-14 11:48:33 -0400",
"subject": "Updated release notes for 0.75."
},
{
"commit": "b865070eddb4eedbeab70e5de287e250680b3f85",
"date": "2015-06-14 10:12:36 -0400",
"subject": "Experimental 9.5 support. Unit tests are not working yet."
},
{
"commit": "0b6f81a812a02c34b2f8cc9e5b14139d27dc4895",
"date": "2015-06-14 09:36:58 -0400",
"subject": "Implemented issue #50: Reverse ordering by file size."
},
{
"commit": "57640d1ac33c6a38c6afe632e1b8a3d6271740fc",
"date": "2015-06-14 08:37:37 -0400",
"subject": "Implemented issue #96: Executable names"
},
{
"commit": "6c807f2ddd6a996a46e0d3733f09e61110361742",
"date": "2015-06-13 18:30:10 -0400",
"subject": "Fixed release notes for info command."
},
{
"commit": "148836fe44e81622d1836f851b8b87e21d32188e",
"date": "2015-06-13 18:25:49 -0400",
"subject": "Implemented issue #26: Info command.",
"body": "* Includes updating the manifest to format 4. It turns out the manifest and .info files were not very good for providing information. A format update was required anyway so worked through the backlog of changes that would require a format change.\n\n* Multiple database versions are now supported in the archive. Doesn't actually work yet but the structure should be good.\n\n* Tests use more constants now that test logs can catch name regressions."
},
{
"commit": "5a73b1a2408fd22f90417fcbf70edd41a6a99f3b",
"date": "2015-06-10 15:54:24 -0400",
"subject": "Fixed minor typos in the documentation."
},
{
"commit": "aca4511350ff6a2d30e712ac0eda39774a93ffa0",
"date": "2015-06-10 15:44:13 -0400",
"subject": "Documentation for issue #93: Prevent misconfigured retention-archive setting",
"body": "Not an actual fix - just some documentation to (hopefully) keep users from getting bitten until then."
},
{
"commit": "af98f164cd5f5dfce97b88434e8fe19f7bc0d6aa",
"date": "2015-06-02 09:42:56 -0400",
"subject": "Fixed issue #97: Interleaved log lines during parallel operations."
},
{
"commit": "7e06e53a69e79c49a44bbab14a99f15ac20548d9",
"date": "2015-06-01 09:39:02 -0400",
"subject": "Merge branch 'master' into dev after release 0.70"
},
{
"commit": "f83f0fa54d1a3b13524fa0ded8a6dffe88276bbc",
"date": "2015-06-01 09:24:38 -0400",
"subject": "v0.70: Stability improvements for archiving, improved logging and help"
},
{
"commit": "95d62a82d94985165145d1d543cfdf4acb197992",
"date": "2015-05-31 09:50:42 -0400",
"subject": "Minor log changes for formatting and consistency."
},
{
"commit": "200e3b26fe902ae1c71a5954c72455902676f90a",
"date": "2015-05-29 22:11:51 -0400",
"subject": "Prevent log test regexp replacement when multithreaded. Logging should be completely disabled in this case."
},
{
"commit": "1586e0eb7555a6f2d44925b3572ab2457ff3e069",
"date": "2015-05-29 17:58:13 -0400",
"subject": "Implement issue #92: Check for ERRORs in backup full tests"
},
{
"commit": "e7d2d704fe4befc028257e5f88a97b810a423449",
"date": "2015-05-29 16:31:12 -0400",
"subject": "Fixed issue #91: Race condition in async archive-push."
},
{
"commit": "5fd4f3bd5b68db1f68f1df9c00e513a15fbd387b",
"date": "2015-05-29 14:39:43 -0400",
"subject": "Improvements to log testing.",
"body": "Replaced tokens are now numbered to give a more accurate rendition of the logs.\nSome formatting improvements."
},
{
"commit": "5fce709ae7d925c6969aa002da2dd262fe93d73a",
"date": "2015-05-29 12:33:38 -0400",
"subject": "Document issue #88: Thoughts on repo & release management."
},
{
"commit": "d321ef0b6d5af0c1dce8fd5701edbadffffce5af",
"date": "2015-05-29 12:26:31 -0400",
"subject": "Implement issue #89: Make confess backtraces log-level dependent.",
"body": "ASSERTs still dump stack traces to the console and file in all cases. ERRORs only dump stack traces to the file when the file log level is DEBUG or TRACE."
},
{
"commit": "13e4eec629df044c90c64424a6992ff3e99b5173",
"date": "2015-05-29 11:41:19 -0400",
"subject": "Implement issue #90: Move archive-max-mb archive-stop checks to end of archive-push."
},
{
"commit": "639c27e113fb8fd76be5ca5533e420c2ed11b44c",
"date": "2015-05-29 08:18:12 -0400",
"subject": "Release notes for issue #68: Allow duplicate WAL to be pushed if the checksum matches."
},
{
"commit": "7ace66e544cd4da848b30c893131b61403242b33",
"date": "2015-05-29 08:12:39 -0400",
"subject": "Implement issue #68: Allow duplicate WAL to be pushed if the checksum matches."
},
{
"commit": "6d2f2d3f91227dffe635ab14de3db3d83c09e0c6",
"date": "2015-05-28 20:52:42 -0400",
"subject": "Fix for issue #74: More helpful message when targeting missing stanzas."
},
{
"commit": "3083e5fc7ef96368351a9558fe04e4e7c71c9490",
"date": "2015-05-28 13:17:34 -0400",
"subject": "Fix for issue #83: Provide more helpful error message during archive-stop situations. Fix for issue #84: archive-async in combination with archive-max-mb doesn't work as documented. Unit tests for archive stop."
},
{
"commit": "a4974f8996c519024f6b645650c9f598b41be553",
"date": "2015-05-26 15:29:42 -0400",
"subject": "Fix for issue #70: command line help improvements"
},
{
"commit": "ca0c866d3babd68fb433a12e9efda066ffb8e9eb",
"date": "2015-05-26 12:26:59 -0400",
"subject": "Implement issue #71: log a message when waiting for a checkpoint Some other log improvements"
},
{
"commit": "5c43e7035a2adfafa0c8f3a72dd46913ce0cb771",
"date": "2015-05-26 11:36:03 -0400",
"subject": "Implement issue #79: Support comment characters in config file"
},
{
"commit": "e9099b99aad5cec0b87668fa90babfc18472e63f",
"date": "2015-05-26 10:01:05 -0400",
"subject": "Updated required modules. Minor doc fixes."
},
{
"commit": "d5335b40e83539bf137ff9051ecac84e6d85a2b6",
"date": "2015-05-22 14:49:14 -0400",
"subject": "Fix for issue #80: enabling archive-copy causes failing differential & incremental backups"
},
{
"commit": "5ada7fb5adf25d7127d08879cd270164d231a1be",
"date": "2015-05-12 15:44:10 -0400",
"subject": "Use JSON::PP instead of JSON since it is shipped with core Perl."
},
{
"commit": "ab4efce5d1064cf887dfea4e541d95c8605444a8",
"date": "2015-05-11 18:36:02 -0400",
"subject": "Merge branch 'master' into dev after release 0.65"
},
{
"commit": "49fe40850fad0a850e52d9ebe79e32b7029c5735",
"date": "2015-05-11 18:29:40 -0400",
"subject": "v0.65: Improved resume and restore logging, compact restores"
},
{
"commit": "a7d6382cf2317a0d2502f4410fb372778059206f",
"date": "2015-05-08 19:33:34 -0400",
"subject": "Unit test fix for absolute path change in a0d985b7ad37bb2582d6d92ddd225a9090da1b64."
},
{
"commit": "9aa41ee76bc4f14b8f8e2856893ac09ad68c33d0",
"date": "2015-05-08 18:34:27 -0400",
"subject": "Added tablespace setting to allow compact database restores for development, staging, etc."
},
{
"commit": "a0d985b7ad37bb2582d6d92ddd225a9090da1b64",
"date": "2015-05-07 17:37:25 -0500",
"subject": "Fixed an issue where an absolute path was not written into recovery.conf when the restore was run with a relative path."
},
{
"commit": "1ac4b781fd304fcc6aa663afc324cdb2d1fdcb06",
"date": "2015-05-07 15:56:56 -0600",
"subject": "Better info logging for restore. Most of the messages were debug before and some important ones were missing."
},
{
"commit": "095a9a0b831877b9b5d62b4b37da4caca0edb7df",
"date": "2015-05-07 10:29:30 -0600",
"subject": "Added resume setting to allow disabling resume feature."
},
{
"commit": "328c2ca5c0dd5ed67ddc2c5d76102cee16235f20",
"date": "2015-05-06 18:24:34 -0600",
"subject": "Much better resume: 1) Re-checksums files that have checksums in the manifest 2) Recopies files that do not have a checksum 3) Saves the manifest at regular intervals to preserve checksums 4) Unit tests for all cases (that I can think of)"
},
{
"commit": "56588f6fdd30378728372e1dea2a4920c043acb3",
"date": "2015-05-05 11:08:48 -0600",
"subject": "Log testing can now be enabled for certain deterministic tests. This works by comparing the generated logs against a previous copy. Currently only enabled for the backup/synthetic tests."
},
{
"commit": "1d1c7e47d149fc9b3b9b0c1db6238e998d56c804",
"date": "2015-05-01 19:13:12 -0400",
"subject": "Doc fixes for archive-max-mb setting."
},
{
"commit": "b0db7c04979d4f012bfd66067a25088bd84687ad",
"date": "2015-04-29 17:43:28 -0400",
"subject": "Fixed case error in Perl module name."
},
{
"commit": "174896e7971931662a7672dd0271fe0f23b846d0",
"date": "2015-04-23 20:52:41 -0400",
"subject": "Centralized wait functions."
},
{
"commit": "2dac171642b6bd876ee44c4d4c9bcb238f7df999",
"date": "2015-04-22 16:39:53 -0400",
"subject": "More modular locking - this is the first part of a series of improvements."
},
{
"commit": "87f69508e3500ff7c93a7637bfeb4643f68f2c74",
"date": "2015-04-21 10:48:01 -0400",
"subject": "Set version to 0.75"
},
{
"commit": "6987cfaa536555bcb1cb0df3e40c03802a786aa0",
"date": "2015-04-21 09:46:28 -0400",
"subject": "Merge branch 'master' into dev after release 0.61"
},
{
"commit": "a9b9ec249234b9106f7c8a7615e227d1b7783a07",
"date": "2015-04-21 09:45:03 -0400",
"subject": "v0.61: bug fix for uncompressed remote destination"
},
{
"commit": "4b51f5dc500d9ba63246b953db57deb30afb3a57",
"date": "2015-04-19 18:00:51 -0400",
"subject": "Removed unused font."
},
{
"commit": "4bc9ee9b8a39ffeab8b2bab434698106ada795c6",
"date": "2015-04-19 17:53:45 -0400",
"subject": "Merge branch 'master' into dev after release v0.60."
},
{
"commit": "5185d49873914c3207894452abfb0a504625821d",
"date": "2015-04-19 17:53:29 -0400",
"subject": "v0.60: better version support and WAL improvements"
},
{
"commit": "279bd07623be81d9197e5612ac8a85b2d57c5335",
"date": "2015-04-19 17:29:52 -0400",
"subject": "Each option is assigned a source to designate where it came from (param, config, default). operationWrite() created to easily pass parameters on to a new process."
},
{
"commit": "e20a3c991d3868afa050a20e99af7f98895c5d99",
"date": "2015-04-19 17:28:19 -0400",
"subject": "Added tests for set = latest."
},
{
"commit": "cb153f7242a8249fe34ee3f391260f6a108acde2",
"date": "2015-04-19 17:27:40 -0400",
"subject": "Docs and comment fixes."
},
{
"commit": "6646089f9a15b7500ee18082e8a01222a8eaac16",
"date": "2015-04-19 17:27:01 -0400",
"subject": "wait_remainder() now waits until .05 seconds after the second to resolve some resolution problems."
},
{
"commit": "f1cc1d6123fac516dc797ab7fce5ac1a6be62390",
"date": "2015-04-11 15:02:04 -0400",
"subject": "Refactored backup manifest update by centralizing the code."
},
{
"commit": "b8ce891603d66dddf9d71bdfabc8e6d9908f60e8",
"date": "2015-04-11 12:31:39 -0400",
"subject": "Altered rsync comparison test to use a specially crafted table that has a 70% compression ratio. Improved the output of file_size_format()."
},
{
"commit": "9fe7f87e3a2dc206b4d7464f34b5f200fa30df9f",
"date": "2015-04-07 19:21:48 -0400",
"subject": "Allow any boolean option that is not command-line only to be negated."
},
{
"commit": "43d86e64a4ce73d69c4d9c73f32ef5cff23d5344",
"date": "2015-04-07 18:36:59 -0400",
"subject": "First pass at tests comparing rsync to backrest. Decent results, but room for improvement.",
"body": "All tests local over SSH with rsync default compression, 4 threads and default compression on backrest. Backrest default is gzip = 6, assuming rsync is the same.\n\nOn a 1GB DB:\n\nrsync time = 32.82\nbackrest time = 19.48\n\nbackrest is 171% faster.\n\nOn a 5GB DB:\n\nrsync time = 171.16\nbackrest time = 86.97\n\nbackrest is 196% faster."
},
{
"commit": "7081c8b86701c88abfee03b01382364f79a7cae9",
"date": "2015-04-07 07:34:37 -0400",
"subject": "New model where threads are created early and destroyed late. Backups now work like restores in terms of how jobs are queued. Split out BackupFile and RestoreFile for easier multi-threading/processing."
},
{
"commit": "808c7863b64ba56f3fe588f31ef86139a133896c",
"date": "2015-04-03 09:56:03 -0400",
"subject": "Duplicate WAL issue in 9.3 was fixed in 9.3.6."
},
{
"commit": "3f651a8ce8d489a680e08467b9baccd7edef188b",
"date": "2015-04-02 22:07:23 -0400",
"subject": "Unit tests will now work across all installed versions of Postgres. Created a function to list all supported versions. Now used for all version checking."
},
{
"commit": "0b27c749991ac58de400c81c5e0fe4d0e890f957",
"date": "2015-04-01 16:28:16 -0400",
"subject": "Increased version to 0.60 and added release notes."
},
{
"commit": "984fceea67770938d6a4030278d2226cd9e14b5a",
"date": "2015-04-01 15:58:33 -0400",
"subject": "Moved archive functions from pg_backrest.pl and Backup.pl to Archive.pm. Moved Remote code from pg_backrest.pl to Config.pm. Added version specific code to regression tests and Db.pm. archive-push checks for duplicate WAL in the archive. archive-push reads the db sys id to match up WAL to the correct archive."
},
{
"commit": "9caccc2ce242c1ee6980c50918f022992c5235fa",
"date": "2015-03-29 13:35:36 -0400",
"subject": "Doc fixes."
},
{
"commit": "92a4d648ace8d112bb80f2ebffc6441fca94d11e",
"date": "2015-03-26 17:42:45 -0400",
"subject": "Fixed issues in collision unit tests."
},
{
"commit": "16cc2110c54648d2ddabe86e6533518b80edc29c",
"date": "2015-03-25 15:17:59 -0400",
"subject": "Merge branch 'master' into dev"
},
{
"commit": "b37d59832f6c3dc2050879e7231228d497b4059c",
"date": "2015-03-25 15:15:55 -0400",
"subject": "v0.50: restore and much more"
},
{
"commit": "82fa497511850c7dfe7521b99150bfd95a090a6c",
"date": "2015-03-25 14:43:21 -0400",
"subject": "Last doc fixes."
},
{
"commit": "4a6f4e23408b3c65a5594a09c6218ceef90615ee",
"date": "2015-03-24 18:50:54 -0400",
"subject": "Getting docs in shape for the next release."
},
{
"commit": "a998119cbaff2ffbff7e469ef5e5edbfee03d132",
"date": "2015-03-24 18:50:14 -0400",
"subject": "Various option and unit test fixes."
},
{
"commit": "a3604bc5121cd4a427c90bcd72468b5b32c5d938",
"date": "2015-03-24 11:43:37 -0400",
"subject": "Changed retention section to expire."
},
{
"commit": "58d6c37f4af5bc040a15bacd90c1ab056f7bca03",
"date": "2015-03-23 17:17:43 -0400",
"subject": "Changed permission to mode in manifest."
},
{
"commit": "8a3c6388b2b7981318f2e7c626cd1b88f907218a",
"date": "2015-03-23 16:01:15 -0400",
"subject": "Removed WAL from some option names - still waffling on this naming thing."
},
{
"commit": "66c474abe21d412ef6f4f5db0fc30063a8466cc4",
"date": "2015-03-23 15:45:25 -0400",
"subject": "A few unit test fixes."
},
{
"commit": "1729fa1c51c369c57a79061186818ce4781f408c",
"date": "2015-03-17 18:31:05 -0400",
"subject": "Added unit tests for expiration."
},
{
"commit": "f4f31302f0529c510ca535e3c57e67181f637092",
"date": "2015-03-16 14:45:53 -0400",
"subject": "Broke archive-required into two options: backup-wal-check and backup-wal-store."
},
{
"commit": "258fb9c6e24445e8be390b729cae005208decdca",
"date": "2015-03-16 14:01:01 -0400",
"subject": "More work on automated docs. Merging this to go back to some feature/bug work for a while."
},
{
"commit": "882f068254242ed06bceb57e14f5f52e5ed317f8",
"date": "2015-03-12 12:15:19 -0400",
"subject": "All config options can now be provided on the command-line. Lots of name changes, but more thought needed there. Still needs cleanup."
},
{
"commit": "7675a11dedaeebaeb5f546bb6c1849f989af794a",
"date": "2015-03-08 14:05:41 -0400",
"subject": "First pass at building automated docs for markdown/html. This works pretty well, but the config sections of doc.xml still require too much maintenance. With the new Config code, it should be possible to generate those sections automatically."
},
{
"commit": "ae6bdecfaf47893346443620a0a57586cf22ebdf",
"date": "2015-03-08 13:26:09 -0400",
"subject": "Split command-line parameter processing out into a separate file. This is in preparation allowing all parameters to be specified/overridden on the command line, with pg_backrest.conf being option."
},
{
"commit": "f115e01b71b23f1fc4fc8b98c42993a31b87a3e0",
"date": "2015-03-04 22:38:27 -0500",
"subject": "More work on docs."
},
{
"commit": "8dc3ba184d661a5c865c395618d20f22e7f4ccc4",
"date": "2015-03-04 20:09:26 -0500",
"subject": "More work on docs."
},
{
"commit": "163f8982624632674c55bf5fddadf3423460a228",
"date": "2015-03-04 18:50:02 -0500",
"subject": "HTML docs look to be in a workable format."
},
{
"commit": "bfb2c05357521718ef115ca40af60ac51f11ed69",
"date": "2015-03-04 00:36:54 -0500",
"subject": "Started on new HTML docs. The markdown is not cutting it."
},
{
"commit": "942b29d5b42a9ad62c96023def0c8cf1a3fc6b19",
"date": "2015-03-03 23:15:40 -0500",
"subject": "Added unit test for recovery type=preserve."
},
{
"commit": "d19baefdb99e4853f3dec7abaae757b18e117a16",
"date": "2015-03-03 22:33:41 -0500",
"subject": "Removed db-timestamp-start and stop from manifest. Better to get these values from"
},
{
"commit": "7509b01e22352404ef89ded72b8bd413c7f0a726",
"date": "2015-03-03 21:21:07 -0500",
"subject": "Added format to manifest to identify a manifest/dir structure version."
},
{
"commit": "f5761a41c12df812ef6c3dd3f9a15654deead958",
"date": "2015-03-03 10:03:55 -0500",
"subject": "Modules cleanup."
},
{
"commit": "3d0d308a98ff95b60a4b1258344443cdef934230",
"date": "2015-03-03 00:57:20 -0500",
"subject": "Made all warnings FATAL. Fixed one bug that was exposed."
},
{
"commit": "c0ec62b131a6f3a780c659ed82a8e3403d16092b",
"date": "2015-03-02 23:42:55 -0500",
"subject": "Fixed bug in File->hash() and removed improper last statements from do loops."
},
{
"commit": "7dbb11e8b85a81305f25d840433d6b125fdf5a76",
"date": "2015-03-02 22:58:32 -0500",
"subject": "Added buffer-size param and added config validation improvements."
},
{
"commit": "8e8f2f3c77793d24ef1a4aaa7f373abdc9610ac0",
"date": "2015-03-02 20:36:12 -0500",
"subject": "New config options compress-level and compress-level-network to control compression levels."
},
{
"commit": "49112eb6d3a43446bfe7c0830a99b6eef5b0b8fa",
"date": "2015-03-02 09:46:11 -0500",
"subject": "Better compression window settings."
},
{
"commit": "d874e122aaa5382b6610089cae1b2379ee97985f",
"date": "2015-03-01 23:41:01 -0500",
"subject": "Optimized compression to disable headers/crc when the source and destination are both uncompressed. Set different compression levels based on usage."
},
{
"commit": "0df1b7c4733cd354b2e6e55e2de7e034fb3fe1c9",
"date": "2015-03-01 22:43:32 -0500",
"subject": "Changed file sizes are now detected and stored in the manifest. Remove thread file minimums - they are unrealistic for a real db and hinder unit tests."
},
{
"commit": "23102f19e57f1548aab5b9709fc7aebed3567ba5",
"date": "2015-03-01 22:23:52 -0500",
"subject": "All copy() cases generate checksums during copy. Unit tests for bAppendChecksum option for copy()."
},
{
"commit": "83658a477820eae8e20238d9fc11034724cb6699",
"date": "2015-03-01 16:43:54 -0500",
"subject": "Docs for checksum option being removed."
},
{
"commit": "76391dde90856f5cbbc4be3b506524000938a412",
"date": "2015-03-01 16:42:27 -0500",
"subject": "Archive checksums are not calculated in stream."
},
{
"commit": "393525d28030711e0aaf0226d7744673d7b01097",
"date": "2015-03-01 15:17:57 -0500",
"subject": "Full refactor of binary_xfer. Compression now uses Compress::Raw::Zlib."
},
{
"commit": "77bc4238dc1afd854049fd901eb1dce76185371f",
"date": "2015-03-01 13:41:35 -0500",
"subject": "ZLib stuff starting to look good. All references removed from File and using binary_xfer for all de/compression."
},
{
"commit": "7ede058b456cb708acdcdba93b52a6729adf9380",
"date": "2015-02-28 20:31:56 -0500",
"subject": "Backup checksums are no longer optional."
},
{
"commit": "28326d6b4c4a815882acb1d6e95a28701fd12b2b",
"date": "2015-02-28 19:07:29 -0500",
"subject": "File->copy now returns hash and size in all cases, though the local copies are not optimal. They just call hash_size()."
},
{
"commit": "260a6cb8f1c7a98ad44f1c4ba0d654c6ca49f544",
"date": "2015-02-28 15:54:49 -0500",
"subject": "Working on calculating hash and file size in binary_xfer()."
},
{
"commit": "0f94476a1f3c4af2cb6aa9bc631bc4a01e05a8ad",
"date": "2015-02-28 12:10:50 -0500",
"subject": "Changed buffer sizes."
},
{
"commit": "f6b9ab732671b75a7ebb708c8ce85b79b575d46b",
"date": "2015-02-28 10:28:25 -0500",
"subject": "Minor param fix."
},
{
"commit": "f93c6caec206071c91d814b3d490da5d357ff44f",
"date": "2015-02-28 10:23:33 -0500",
"subject": "Backup/restore copy will be run in the main process when thread-max=1. I've resisted this change because it adds complexity, but I have to accept that threads are not stable on all platforms. Or maybe any platform."
},
{
"commit": "5d10a18b257a92ce520c575a488d8921e8284f5e",
"date": "2015-02-28 10:21:36 -0500",
"subject": "Added thread-max parameter to test.pl to allow backup threads to be specified."
},
{
"commit": "d6205d95011e5efb3856f5e62d09571374070492",
"date": "2015-02-27 23:31:39 -0500",
"subject": "Looks like all unit tests pass - now for a long test run to see if that is really true. And to see if the old lockup is gone."
},
{
"commit": "25442655c84cd10d026e23f5ad66aa17e5c96ae5",
"date": "2015-02-27 18:42:28 -0500",
"subject": "Hash of compressed file is working. Something still broken in binary_xfer because some 0 length archive files are showing up. Investigating."
},
{
"commit": "53f783d3fecd725aed2b7e1a203e11e8f8c85e0b",
"date": "2015-02-27 16:36:40 -0500",
"subject": "binary_xfer compress/decompression working without threads. All unit tests passing. Hooray."
},
{
"commit": "c18c629878705c01798e099de4f300b26129b679",
"date": "2015-02-27 14:11:59 -0500",
"subject": "Compress looks good, back to decompress."
},
{
"commit": "bd44b2c471a093e350fa5f18bb33832cf75c784b",
"date": "2015-02-27 13:48:29 -0500",
"subject": "Making binary xfer more modular."
},
{
"commit": "2506bbb21a044725309e3e8c2ba6761082114676",
"date": "2015-02-26 19:12:22 -0500",
"subject": "Working on decompression."
},
{
"commit": "64e1b1cea789b6751fc285a9861912cf09aca04b",
"date": "2015-02-26 14:16:12 -0500",
"subject": "Simple compression case is working. Still need to implement decompress, handle flags, and do checksum decompression."
},
{
"commit": "b9378d94a21f28c466a2e9fea9fa19d60987be86",
"date": "2015-02-26 09:22:05 -0500",
"subject": "Working on removing threads from instream compress/decompression."
},
{
"commit": "d2602a5c0762ca7ad1cd275587556f2a280b8098",
"date": "2015-02-03 20:33:33 -0500",
"subject": "Tracking down a lockup in the restore threads. It doesn't happen in backup - they are the same except that restore uses the ThreadGroup object. I'm beginning to think that threads and objects don't play together very nicely. Objects in threads seems OK, but threads in objects, not so much."
},
{
"commit": "7bee43372d41df531d6c571140dbb8eed805adf2",
"date": "2015-02-02 21:10:44 -0500",
"subject": "Increase timeout."
},
{
"commit": "d4aae88becf6e82df8f5e3eb71c24a17098bed88",
"date": "2015-02-02 20:11:32 -0500",
"subject": "Try non-blocking dequeue in backup."
},
{
"commit": "850c978240329d536f641e6832871e738526e435",
"date": "2015-02-02 19:56:48 -0500",
"subject": "All restore compares no-start-stop for now."
},
{
"commit": "d93b246a692b29f09fcb1b8539dbaad443da1e14",
"date": "2015-02-02 19:34:34 -0500",
"subject": "Empty restore queues in a non-blocking way."
},
{
"commit": "7f38461c6814e0e092ee83a3222112aa21c85456",
"date": "2015-02-02 18:48:33 -0500",
"subject": "Remove ThreadQueue->end(). Not supported on all platforms."
},
{
"commit": "bde8943517ad260d87414ba6f8aa03c3e799e790",
"date": "2015-02-02 18:33:11 -0500",
"subject": "Fixes to restore compare unit tests."
},
{
"commit": "8abcf6caf109479e069f2ec36bf37d7007261c22",
"date": "2015-02-02 08:28:37 -0500",
"subject": "For no just ignore sizes in the tests since they are normal and do not indicate a bad backup."
},
{
"commit": "a6d3b7e1a960052728cc274645ebb011b741ab18",
"date": "2015-01-31 23:04:24 -0500",
"subject": "Working on checking restores against the manifest. Current issue is that the manifest does not always record the final size of the file - it may change while the file is being copied. This is fine in principal but makes testing a pain."
},
{
"commit": "018a2afacadbf9e6a848c1e0ff66f0cd9d732755",
"date": "2015-01-31 18:23:37 -0500",
"subject": "Moved bNoStartStop tablespace mapping to Manifest object."
},
{
"commit": "d7b669d5605bf75116c2d9584c745dfff9fee54c",
"date": "2015-01-31 18:15:08 -0500",
"subject": "Moved manifest build to manifest object."
},
{
"commit": "cd500484a2ddebdd43730c051835c3b5b18d83fe",
"date": "2015-01-31 17:37:55 -0500",
"subject": "Revert \"Working on doc formatting.\"",
"body": "This reverts commit a0559799fd2330e7d6c7a28f431bbdd2828eb80e."
},
{
"commit": "a0559799fd2330e7d6c7a28f431bbdd2828eb80e",
"date": "2015-01-31 17:36:25 -0500",
"subject": "Working on doc formatting."
},
{
"commit": "682d419d082f96628811909a969101d61b5a2c4f",
"date": "2015-01-31 17:32:16 -0500",
"subject": "Fixed file list."
},
{
"commit": "1ba176285e38e85e03dab31718cfc1a742bcd574",
"date": "2015-01-31 17:10:19 -0500",
"subject": "Work on restore/recovery docs."
},
{
"commit": "f94812932a3fc3c3a59ac2da499268c9768ba2e6",
"date": "2015-01-31 16:27:32 -0500",
"subject": "Working on operations docs."
},
{
"commit": "267efbd71d56af8b2dc68dc5d21c710b69e16bbb",
"date": "2015-01-31 15:37:59 -0500",
"subject": "Fixed restore::thread-max"
},
{
"commit": "0c9da6a5ab8cdfe8283cebfbb7ea8fb751857e1d",
"date": "2015-01-31 15:06:53 -0500",
"subject": "Removed version file - redundant to the version in backup.manifest."
},
{
"commit": "e524c4dd1a9e1fe0ae4a46f90eb12ae7a50bb333",
"date": "2015-01-31 13:48:09 -0500",
"subject": "Timeline unit tests are working. Options from config file are being written to recovery.conf. Fixed issue with .history files not being picked up by archive-xfer."
},
{
"commit": "cd9df8b4f87cb2042c1b2ddfbba1a1fe76a1fdee",
"date": "2015-01-31 09:05:05 -0500",
"subject": "Renamed uninit to cleanup."
},
{
"commit": "11c257296a7632ae760b1ddae66beec2f9e114ca",
"date": "2015-01-30 20:16:21 -0500",
"subject": "In the end it was a single non-undefed reference holding up the show. The Backup file should be split into Archive, Backup, Expire, and made into objects. That would cut down on this kind of nastiness."
},
{
"commit": "50e015a8385e347e2ba75fb84f9ab7c5fef7fa70",
"date": "2015-01-30 18:58:49 -0500",
"subject": "Revert \"Abortive attempt at cleaning up some thread issues - I realized the issue is in mixing threads and objects too liberally. Trying another approach but want to keep this code for historical and reference purposes.\"",
"body": "This reverts commit e95631f82ac8c15cb2492bb321703797be54eff6."
},
{
"commit": "e95631f82ac8c15cb2492bb321703797be54eff6",
"date": "2015-01-30 14:55:55 -0500",
"subject": "Abortive attempt at cleaning up some thread issues - I realized the issue is in mixing threads and objects too liberally. Trying another approach but want to keep this code for historical and reference purposes."
},
{
"commit": "fb934ecce9c204a5ed1d444b8c3876c8393af440",
"date": "2015-01-30 14:54:08 -0500",
"subject": "Allow immediate stops when discarding data at end of unit test. Makes the shutdowns faster."
},
{
"commit": "19e455afc1c152f212d0de771bb373a03ab5a8a1",
"date": "2015-01-28 16:25:38 -0500",
"subject": "Some fixes in unit tests - more needed."
},
{
"commit": "499d6c84220d9b9e916686aeef2c605aa6995b0b",
"date": "2015-01-28 13:14:46 -0500",
"subject": "Added tests for all --delta --force combinations. Added error check for postmaster running. Added error check for path not empty."
},
{
"commit": "16dd2717942eb52004e4cee3510fc524d8042fc9",
"date": "2015-01-28 11:12:21 -0500",
"subject": "Added an incremental backup to vary the unit tests."
},
{
"commit": "139b1cf87242995e41a68dbcb35a10c72da9d592",
"date": "2015-01-28 10:29:29 -0500",
"subject": "Fixed small race condition in cleanup - the archiver was recreating paths after they had been deleted. Put in a loop to make sure it gets done."
},
{
"commit": "60550cd45b802b9d1859d9bdd22f5211b9908944",
"date": "2015-01-28 00:28:21 -0500",
"subject": "Archive async now works local, but there is a pending bug to make sure archive::path != backup::path. Added code to be sure that restore will not try to log into the backup path unless it is local."
},
{
"commit": "b98b2df9f83c70516de37d574d36dcf6194b8f1d",
"date": "2015-01-28 00:26:20 -0500",
"subject": "Fixed wait_for_file() so that it will not error if the path does not yet exist."
},
{
"commit": "a59bd8c3281237f35da0ad4b7af33953cf53a26b",
"date": "2015-01-27 22:59:59 -0500",
"subject": "Restores except for type=none are mostly working. There are some failing unit tests to fix."
},
{
"commit": "13544d51bf9be1128486b167a3ecb5dc3fb6a09c",
"date": "2015-01-27 11:44:23 -0500",
"subject": "Recovery is working for none and default, but unit tests are not complete."
},
{
"commit": "f59aae101df6cb877f644a47e461e5e35440b21d",
"date": "2015-01-26 14:59:58 -0500",
"subject": "Ready to start writing recovery unit tests."
},
{
"commit": "ac22c314a90143f1a23f782b88d3f60e14dc6b32",
"date": "2015-01-26 11:01:24 -0500",
"subject": "Working on plumbing for recovery options."
},
{
"commit": "eeffd62a12d7afa70794dfefcdbfdc08a4083760",
"date": "2015-01-25 17:27:46 -0500",
"subject": "Working on recovery options."
},
{
"commit": "6db49e10831cafa4088b300b2884139bfd0662d0",
"date": "2015-01-25 12:20:12 -0500",
"subject": "Cleaned up some time functions."
},
{
"commit": "9069c34e3412889848da22abd5f4697ef8151010",
"date": "2015-01-24 11:05:26 -0500",
"subject": "Added more tablespace changes to backup unit tests."
},
{
"commit": "e1c5f7f8edf23d561ba7e730eb718cb2166e32e4",
"date": "2015-01-23 18:28:39 -0500",
"subject": "Now able to check for specific errors in unit tests - as long as they are raised with an error code."
},
{
"commit": "c6dad127486b569d683ae9cdff4f10693a3b4453",
"date": "2015-01-23 14:12:53 -0500",
"subject": "Using usleep for more resolution,"
},
{
"commit": "d3763908e741d9d675d9967e2531dfd195ca03ba",
"date": "2015-01-22 21:20:49 -0500",
"subject": "Added longer sleep to show how big an issue this can be."
},
{
"commit": "a3b3f98f66e6e36154831800434e1a7ad3dac431",
"date": "2015-01-22 20:55:16 -0500",
"subject": "Fixed some issues with remote backups after restore (unit test bugs only)."
},
{
"commit": "21c715b25c2fd484e8b4e8d53b64a9b2d59ad7d6",
"date": "2015-01-22 20:11:33 -0500",
"subject": "Restore tablespace remaps are working."
},
{
"commit": "df4b50b9778d50b1c39fa5828c18cb2e68a5c92c",
"date": "2015-01-22 19:04:55 -0500",
"subject": "Restore with base path remap working."
},
{
"commit": "82969eb4971eb78b6a992b2f48e46c1a49189737",
"date": "2015-01-22 17:43:19 -0500",
"subject": "Wrote some helper functions to make backup unit tests simpler. Fixed an issue with checksum generation in resume."
},
{
"commit": "b53cb9f64e4d665ce138d98aecc99404db0a127c",
"date": "2015-01-22 10:54:02 -0500",
"subject": "Unit tests for backup resume. Improved warning message when a backup cannot be resumed."
},
{
"commit": "fc2838d60fea12347de7be0c239ed72a80446774",
"date": "2015-01-21 18:37:49 -0500",
"subject": "All references to old-style manifest eliminated (hopefully)."
},
{
"commit": "ade9ad78b4523b51051c536ca3814e5f1acf8521",
"date": "2015-01-21 13:57:58 -0500",
"subject": "Allow file keys to be validated on remove."
},
{
"commit": "ba7a939798d2499d40e5c1fd8ece9b6b6141777b",
"date": "2015-01-21 10:44:08 -0500",
"subject": "More migration to manifest object."
},
{
"commit": "a938813c017095dbba6160b433cc164bdea04fac",
"date": "2015-01-20 19:04:45 -0500",
"subject": "More migration to manifest object."
},
{
"commit": "c33bc1e899af1ef6ec23ec9bd73bdcc257636428",
"date": "2015-01-20 18:00:03 -0500",
"subject": "More migration to manifest object."
},
{
"commit": "26c568b7bcd58934a44f93a55a8ef28e5259ef17",
"date": "2015-01-20 16:20:27 -0500",
"subject": "Manifest checksum failure shows expected value to allow manual fix - though not recommended."
},
{
"commit": "92c9ed8963b9f73c104d684fd73ad376b751323b",
"date": "2015-01-20 16:05:15 -0500",
"subject": "Added checksum to manifest to detect corruption."
},
{
"commit": "44fad1f4a442cf18cf712c70f2eb4018f3f66a02",
"date": "2015-01-20 14:42:22 -0500",
"subject": "Improvements to manifest save."
},
{
"commit": "8a7ee1bb1f69928d37c8803cdd018197b68567be",
"date": "2015-01-20 14:13:35 -0500",
"subject": "Integration of new Manifest object."
},
{
"commit": "15a45f31f4632250620aa955cddb3e4f46427eec",
"date": "2015-01-20 12:17:39 -0500",
"subject": "Added feature list."
},
{
"commit": "e20f93ef1bca2fcac214b8ce6a732053c55f201c",
"date": "2015-01-12 09:05:26 -0500",
"subject": "Cleaned up test usage."
},
{
"commit": "84abcd7d61ce46eead29f790d6b528f3105f499b",
"date": "2015-01-11 11:53:03 -0500",
"subject": "Minor fixes."
},
{
"commit": "34116d3816ac0425bb0e787be266abade3e501c0",
"date": "2015-01-11 11:52:16 -0500",
"subject": "Added usage to test.pl and automatic search for psql-bin."
},
{
"commit": "425e9485aaf171864e4e0ad7a327f9a60378a33d",
"date": "2015-01-08 16:36:45 -0500",
"subject": "Re-added File-hash() - accidentally deleted it when working on owner()."
},
{
"commit": "131d91090614382780d16daec1815b53ebda97f2",
"date": "2015-01-08 15:43:43 -0500",
"subject": "New structure for --delta and --force params."
},
{
"commit": "2e09df2cec296b3b639ae14238c56e48836b1ff0",
"date": "2015-01-08 12:04:56 -0500",
"subject": "More work on new manifest object."
},
{
"commit": "0085e88966a48f1e5667f1e7618474c03578b04d",
"date": "2015-01-07 12:58:21 -0500",
"subject": "Added File-owner()"
},
{
"commit": "4f5ad8496d8d31b27a1da60de064716ce073062e",
"date": "2015-01-07 10:59:43 -0500",
"subject": "Integrating new manifest object."
},
{
"commit": "d6d57e654e48101fdbd2ef06316f71b395dbdfd1",
"date": "2015-01-06 13:08:56 -0500",
"subject": "Fixed the way wait was done after the manifest is created. Previously, waits were done for base and each tablespace which is not very efficient. Now one wait is done after the entire manifest is built. Also storing the exact time that copy began."
},
{
"commit": "43098086afd9cbf4e487a18fd2c2d6c486e4e224",
"date": "2015-01-03 16:49:26 -0500",
"subject": "Implemented timestamp last modified to record the time of the last modified file in the backup. Also added timestamp-db-start and timestamp-db-stop to for more info. timestamp-db-start can be used for PITR."
},
{
"commit": "91b06bef475d6ad17036c27337be59db35460f0d",
"date": "2015-01-03 14:22:59 -0500",
"subject": "File->manifest detects files that are modified in the future."
},
{
"commit": "2449d7384cd725587d8ee1ddff884581105fe796",
"date": "2015-01-03 12:56:44 -0500",
"subject": "Wrote a new test to check rsync collisions."
},
{
"commit": "2e080eedb85f7394d40fb14ec6c92b0a3e11aba5",
"date": "2015-01-02 14:18:07 -0500",
"subject": "Added an optional delay after manifest build so that files are not copied in the same second that the manifest is built. This can result in (admittedly unlikely) race conditions that can produce an invalid backup. I was also able to reduce the sleep types when waiting for thread termination - so unit test times are improved by almost 100%."
},
{
"commit": "297b22cb2bde9dddf99f557a40f8a6fb6e0807c8",
"date": "2015-01-02 14:15:15 -0500",
"subject": "Added INFO level logging when paths/files/links are removed during the clean phase of restore deltas."
},
{
"commit": "32b37335a14dd1f7ed98200df3869b0443afb2d8",
"date": "2014-12-31 19:03:03 -0500",
"subject": "Trying to find realistic conditions where a file can be changed without the timestamp changing between backups. So far, this is the only case I can make work - it looks like adding a 1 second pause after creation of the manifest would cover this case."
},
{
"commit": "59e901684d0119ec6547356386190bec90837c72",
"date": "2014-12-31 14:59:33 -0500",
"subject": "Working on improved backup/restore unit tests."
},
{
"commit": "fb948de55946fee59f9503df4c377ef19c82a1f8",
"date": "2014-12-31 12:28:16 -0500",
"subject": "Fixed some minor issues in ownership code found by unit tests."
},
{
"commit": "7e083e8749d5c767040e451d908bb2d9d9f419e1",
"date": "2014-12-31 11:20:46 -0500",
"subject": "Restore as root is now working."
},
{
"commit": "0805055d4b96de49f4ee0e7514f3fde31d95f98e",
"date": "2014-12-30 15:41:43 -0500",
"subject": "More work on restore ownership code."
},
{
"commit": "46ba3a18dfb2a0fa5c034571e46edd4297b6272f",
"date": "2014-12-30 11:59:57 -0500",
"subject": "Ownership code runs through - may not work for all cases."
},
{
"commit": "9f8f33f957ee7d1db68c48c84ebef2cb43c85cce",
"date": "2014-12-23 18:52:38 -0500",
"subject": "Working on restore options and integration with unit tests."
},
{
"commit": "a96b83beb84d1c82b24c8d79e08c674757a4bf25",
"date": "2014-12-23 15:03:06 -0500",
"subject": "Restore can now remap base/tablespace locations. Made Restore more modular."
},
{
"commit": "653ab486af8897f1058bf0e846aa739f14a4a33f",
"date": "2014-12-23 12:48:25 -0500",
"subject": "All restore module variables are now object local."
},
{
"commit": "51544edc70319b38e000003d50af16eb333c191a",
"date": "2014-12-23 11:48:51 -0500",
"subject": "Some cleanup in restore."
},
{
"commit": "2db71e91adf078eda5d687155e8e8beaf98996f3",
"date": "2014-12-22 11:24:32 -0500",
"subject": "Basic restore functionality is working."
},
{
"commit": "9086728b73e4c5f2063d9ed3e39a66ed9eade216",
"date": "2014-12-21 10:11:17 -0500",
"subject": "Restore removes paths/files/links and recreated paths/links."
},
{
"commit": "1557327d2bb2f3aedb2e3363d89569de02acca82",
"date": "2014-12-19 17:49:56 +0000",
"subject": "Restore cleans out missing files and some basic unit tests."
},
{
"commit": "161a73159e9723ada085423ead853ba4d68da0af",
"date": "2014-12-18 22:05:06 +0000",
"subject": "Added some constants."
},
{
"commit": "b9d9c7fa66e681266ad213ec4b31691bec313d14",
"date": "2014-12-18 16:47:03 +0000",
"subject": "Incremented version to .50 since restore functionality if going in."
},
{
"commit": "1dc00c9d4b14af15febebde963cc70a44f357ec8",
"date": "2014-12-18 16:42:54 +0000",
"subject": "Starting on restore functionality, finally."
},
{
"commit": "1a3c5cd9dbd832bb8a6a01a897c2368b21d5418c",
"date": "2014-12-18 16:14:30 +0000",
"subject": "Added latest link so it is easy to get to the last backup."
},
{
"commit": "7d19504d3a84867cf910ce03b554f7f5ef0d49b6",
"date": "2014-12-18 14:58:07 +0000",
"subject": "Removed some tests in full that were redundant with the tests in backup."
},
{
"commit": "93c7ef3c9ea429c64f035bec1acb6f41a18a3397",
"date": "2014-12-18 14:56:01 +0000",
"subject": "Moved some code into a more logical order."
},
{
"commit": "c76a8d64d0abca36fc217c94d22542190e1045ee",
"date": "2014-12-16 17:41:54 +0000",
"subject": "Moved more config logic to Config.pm"
},
{
"commit": "61245583472b1a621e69ffbdddedd5bd68d9133a",
"date": "2014-12-15 22:20:42 +0000",
"subject": "Moved config functions to a new file."
},
{
"commit": "6dd9e881dc06862d7361a2a1db0d91cf93296e61",
"date": "2014-11-27 14:07:09 +0000",
"subject": "Added reminder."
},
{
"commit": "602db70d6a9100d80ec421f66d4e76812cd81b85",
"date": "2014-10-20 11:44:36 -0400",
"subject": "More backup unit tests."
},
{
"commit": "9765b4e20b0d1e3878806387ccf0f0cda124abbe",
"date": "2014-10-19 17:41:11 -0400",
"subject": "Backup unit test - more work on tablespaces and references."
},
{
"commit": "66a5da6fd1757afc1647a051464417497e49e18f",
"date": "2014-10-19 16:30:16 -0400",
"subject": "More work on backup unit tests - added tablespace tests."
},
{
"commit": "4de1d9aa5aed934a293d2540816186656c4b58e1",
"date": "2014-10-19 11:46:01 -0400",
"subject": "Backup unit tests are working."
},
{
"commit": "1d43c633265e218fc2346786c5f9046d1bd792db",
"date": "2014-10-18 13:25:20 -0400",
"subject": "Working on better backup unit tests."
},
{
"commit": "ed5777101f4402c940f551b9e0321dec98d1e260",
"date": "2014-10-16 13:22:34 -0400",
"subject": "Changes in how paths are removed."
},
{
"commit": "b6e0bb2ae550a0ea83f2b1139b771add43d1eb6f",
"date": "2014-10-16 08:58:11 -0400",
"subject": "Small unit test changes."
},
{
"commit": "5c216c93d5f62a0c395d2830dcc840c84256f4a8",
"date": "2014-10-15 19:11:09 -0400",
"subject": "Working on backup unit tests."
},
{
"commit": "f9ff7c6ec7303ae938df9542af98b45b29e779f2",
"date": "2014-10-14 23:58:17 -0400",
"subject": "Comments."
},
{
"commit": "0ba838cd3e06c2464db399eed6b08216b65138ab",
"date": "2014-10-14 21:44:42 -0400",
"subject": "Checksums seem to be working again - still waiting on the new backup unit tests to confirm."
},
{
"commit": "59a267d6387c463ff0cd469ca8ac1c00e4125d38",
"date": "2014-10-14 15:46:03 -0400",
"subject": "Fixed typos."
},
{
"commit": "b19dd9b5529fab599b536dd5819bc7050d884df7",
"date": "2014-10-14 15:44:50 -0400",
"subject": "Changes to the aborted backups code."
},
{
"commit": "3a54eaf9dec90896cedb9a3ab34219c02babcae9",
"date": "2014-10-14 08:27:50 -0400",
"subject": "Last backup type is now checked - still need a unit test for it."
},
{
"commit": "c8aeadce8eb7f1b9f9bb76b4fc291a920118cb8c",
"date": "2014-10-11 00:16:34 -0400",
"subject": "Comments."
},
{
"commit": "aafc0fef6918938a4f32551220afac4340d72c32",
"date": "2014-10-10 16:03:33 -0400",
"subject": "Removed Moose from the Db object."
},
{
"commit": "2c173ba53e5dafd5fd090d31c05227250b403ff8",
"date": "2014-10-10 15:13:28 -0400",
"subject": "Removed moose from File object."
},
{
"commit": "c1d6890c604c1d9f4e6c940f0ff6e0f552e40e19",
"date": "2014-10-09 16:01:06 -0400",
"subject": "More Moose removal."
},
{
"commit": "3d86adadb5a7d3cba91e6839721681d3b1237f37",
"date": "2014-10-08 13:54:31 -0400",
"subject": "Remote object now using ProcessAsync for de/compression. Removed dependency on Moose from Remote."
},
{
"commit": "16ebbd2279e25e46b91b65b2684f4e3a7fce9525",
"date": "2014-10-06 20:53:34 -0400",
"subject": "Documentation fixes."
},
{
"commit": "74cae73ee0ddee2d16bd5d7e923f23538cd94bc7",
"date": "2014-10-05 20:21:15 -0400",
"subject": "Moved version number to v0.31."
},
{
"commit": "4bc4d97f2bfc8702937fe931b5b8d956a73d42f6",
"date": "2014-10-05 19:49:30 -0400",
"subject": "v0.30: core restructuring and unit tests"
},
{
"commit": "de35cedc277615bfb777f8a522d35a0d807de9dd",
"date": "2014-10-05 18:52:05 -0400",
"subject": "Working on getting async process thread into Remote.pl"
},
{
"commit": "122dc65351f9553f06d374c6c7b29e6357261dc4",
"date": "2014-10-03 09:31:23 -0400",
"subject": "Added compress and checksum settings to backup manifest."
},
{
"commit": "fbc2ae132541eafe92e27cd6d6be0d003bf4e16d",
"date": "2014-10-02 14:34:58 -0400",
"subject": "Fixed function names in comments."
},
{
"commit": "4cbc6c650a6c1fe3924e91e3fb5b53181a9dfcd9",
"date": "2014-10-02 13:54:26 -0400",
"subject": "File->hash now works on compressed files."
},
{
"commit": "991afe3b161e06d940be7acb70a2f8596a495eb2",
"date": "2014-10-02 10:55:38 -0400",
"subject": "Merge from dev-0.30."
},
{
"commit": "168398e58a374f062a156088fc4e3571d5772f98",
"date": "2014-09-30 15:51:08 -0400",
"subject": "Merge from dev-0.30."
},
{
"commit": "5151b103e8eb985b9cbb91a90a580db122b4afe8",
"date": "2014-09-29 23:10:53 -0400",
"subject": "Formatting."
},
{
"commit": "5f30ae3c463ba28759dd5e87a339599f3e95fabd",
"date": "2014-09-29 19:51:51 -0400",
"subject": "Merge branch 'dev-0.30' of https://github.com/dwsteele/pg_backrest into dev"
},
{
"commit": "aab5ec2943919c7990d0da202275bd978ce384c1",
"date": "2014-09-29 19:39:28 -0400",
"subject": "Converting _ to -. Last one I hope."
},
{
"commit": "bdbdaf39d35e8bfcc88976179716843571890c23",
"date": "2014-09-29 19:08:08 -0400",
"subject": "Work in progress - new hash method."
},
{
"commit": "82b0bc0e72c6a47efb7891098ffa854ca2c69621",
"date": "2014-09-29 22:51:02 +0000",
"subject": "Fixed relative path issue in archive-get."
},
{
"commit": "7ed6587c42c4594dc4bd9939e12386cb1f4e73ad",
"date": "2014-09-19 17:51:51 -0400",
"subject": "ISSUE-11: Added --no-start-stop and --force options."
},
{
"commit": "07801a9a3c9573d44a664c109d4e48affe5406a2",
"date": "2014-09-19 11:22:26 -0400",
"subject": "Changed timestamp keys to be more consistent."
},
{
"commit": "121cb8a811710ab739f680e2b97d0f03c6075024",
"date": "2014-09-19 10:47:22 -0400",
"subject": "Title fix."
},
{
"commit": "7b1039dbe284beb436557a7db2c7da20967c3ad7",
"date": "2014-09-18 17:39:24 -0400",
"subject": "Fixed error message."
},
{
"commit": "535f32c8275c780b64e04dc30da2d4ec4333b744",
"date": "2014-09-18 17:24:40 -0400",
"subject": "Removed old unit tests."
},
{
"commit": "6ac124493d1cd0aacbb0d342745c43f240f1eddd",
"date": "2014-09-18 16:42:13 -0400",
"subject": "Added prior backup label to backup.manifest"
},
{
"commit": "82f22dd9fedbb01cbad24697b605a16a25d5f541",
"date": "2014-09-18 16:41:36 -0400",
"subject": "Documentation for config functions."
},
{
"commit": "fd12299ecd1b39246ede3a2100419cc624c64bbc",
"date": "2014-09-18 15:18:52 -0400",
"subject": "Some fixes in test logging."
},
{
"commit": "77802d3689b7e8f2c161165c50cdff12f0ce6ae6",
"date": "2014-09-18 13:13:04 -0400",
"subject": "Fixed some language."
},
{
"commit": "97c12f4eda0847025c78e98bab91bde92dfd3b93",
"date": "2014-09-18 12:57:50 -0400",
"subject": "Update backrest project description."
},
{
"commit": "a5f09caff7b4017a09e4f80888c211d5d3d7c713",
"date": "2014-09-18 12:37:14 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "3ab81752c00f69c6981bb53d06df60ebc0083666",
"date": "2014-09-18 11:50:27 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "d3238daf7ec8926635306c2b8d3294b37405c557",
"date": "2014-09-18 11:28:23 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "06ad947102fb54fbe4a48f5b1f77353610c9c716",
"date": "2014-09-16 11:22:55 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "65f89bd643f2b14338d80fef1644c1fd4a9ada8f",
"date": "2014-09-16 08:55:40 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "4d8c97eb55edd3a6472942cf924cf5965e6b69ef",
"date": "2014-09-16 08:21:29 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "48b0e0d4612d3f9156f7d4fccce2fdd3c13c3ac5",
"date": "2014-09-16 08:15:49 -0400",
"subject": "Using ' instead of \" where appropriate."
},
{
"commit": "411e870c7a04551614132b3a4f461e88d74ef9b8",
"date": "2014-09-15 22:04:26 -0400",
"subject": "Notes."
},
{
"commit": "1125397aae9fc4c59b516b133d5c82337041e070",
"date": "2014-09-15 19:00:40 -0400",
"subject": "Updated readme."
},
{
"commit": "f86674da02a7f15f98cf1f64c331277e7fa7f3d3",
"date": "2014-09-15 18:26:03 -0400",
"subject": "Documentation."
},
{
"commit": "8c9aa3ab7c511c317b32896aaa2958a198e67927",
"date": "2014-09-15 18:18:40 -0400",
"subject": "Documentation."
},
{
"commit": "c5192e0fa5ea46e01d9ec0cf39bb1364c10aeed1",
"date": "2014-09-15 18:12:30 -0400",
"subject": "More docs, changed hardline default to Y."
},
{
"commit": "b9b038b328526fb0ea24b2fe879be23d63708e6e",
"date": "2014-09-14 20:06:45 -0400",
"subject": "Added docs and fixed spaces."
},
{
"commit": "ab7323711f83d833d391751f0f8a5205282f6214",
"date": "2014-09-14 17:07:44 -0400",
"subject": "Fixed issue in archive extension."
},
{
"commit": "cfe8851174e861ae707989874bbe2de3ae50de38",
"date": "2014-09-14 16:48:33 -0400",
"subject": "A few more fixes for differential."
},
{
"commit": "c0d81f0d10986e1308b3d90d082d2c65b07bd53a",
"date": "2014-09-14 16:30:53 -0400",
"subject": "Fixed issues in differential expiration."
},
{
"commit": "9555775d72800cf69f7859651548298e3c22d350",
"date": "2014-09-14 15:55:27 -0400",
"subject": "Retention defaults, single-quotes."
},
{
"commit": "6315d326ea7bb184eea63598cc80b6cda42a6f84",
"date": "2014-09-14 15:31:56 -0400",
"subject": "Fixed a few issues in manifest."
},
{
"commit": "23870f60f5038302c8e47aee7d231f4fb89d64ec",
"date": "2014-09-14 13:17:07 -0400",
"subject": "Small change to fix branch."
},
{
"commit": "4903a818f3e63494f80525be151911d5f3358b0b",
"date": "2014-09-14 13:15:21 -0400",
"subject": "Merge branch 'dev' of https://github.com/dwsteele/pg_backrest into dev"
},
{
"commit": "4551a2d089c448c1e4a61606d63e1510a3fa3b91",
"date": "2014-09-14 13:12:37 -0400",
"subject": "Docs and unit test fix."
},
{
"commit": "d83820d962c7ea1c28788129487b2c210e12b374",
"date": "2014-09-14 12:50:21 -0400",
"subject": "More documentation."
},
{
"commit": "d7faf578f3e4d5d1e694e704e874b71003a357c7",
"date": "2014-09-14 11:46:22 -0400",
"subject": "Test configuration formatting."
},
{
"commit": "b0b6c6a91658993a1186a8e005bd78cb307cd92f",
"date": "2014-09-14 11:40:17 -0400",
"subject": "More doc tests."
},
{
"commit": "2dc90edb07f22c30ff89d05cb469866f4a300b4c",
"date": "2014-09-14 11:38:49 -0400",
"subject": "More work on docs."
},
{
"commit": "8964ba4502591cd77f65de79607eb8e98c35a2fa",
"date": "2014-09-13 14:18:59 -0400",
"subject": "Testing formatting."
},
{
"commit": "e47ec0ab2b370cc531961efed4e91d253abe7e08",
"date": "2014-09-13 14:13:50 -0400",
"subject": "Working on documentation formatting."
},
{
"commit": "e7ccced3b4a97433fb7c0061462ae80dc10278a5",
"date": "2014-09-13 14:04:54 -0400",
"subject": "More work on documentation."
},
{
"commit": "934159eef0a508913f4b36de71bd019a87a4f3bf",
"date": "2014-09-13 11:43:39 -0400",
"subject": "More table tests."
},
{
"commit": "826f9cde2c92f780bd43b0f767612b97b777b420",
"date": "2014-09-13 11:35:58 -0400",
"subject": "Playing with tables."
},
{
"commit": "9eb2015d9fbb933dff00d1fb866f7edbc719e7f4",
"date": "2014-09-13 11:25:35 -0400",
"subject": "Working on documentation."
},
{
"commit": "fa82d5f0af3d5151a58ad44157a74a82d16428d0",
"date": "2014-08-15 10:48:50 -0400",
"subject": "Added help (issue #10)"
},
{
"commit": "679005e537bb0c2bf0a115330a8d9646a7e69c65",
"date": "2014-08-14 09:40:20 -0400",
"subject": "Some cleanup of the diff/incr code."
},
{
"commit": "3798071c5f2b9c0f8d89c83c65d962ccfbd7fd1d",
"date": "2014-08-12 20:01:36 -0400",
"subject": "Added backup.manifest change to last commit."
},
{
"commit": "e8e7c82b147e2deac127187ae758c0c47061ea5a",
"date": "2014-08-12 20:00:52 -0400",
"subject": "pg_backrest.pl returns version. Version is also stored in the backup path in the version and backup.manifest files. Merged the two date string functions."
},
{
"commit": "b48a7e6cc2b4702bf1ad26d652142fbb1c28d931",
"date": "2014-08-12 19:17:16 -0400",
"subject": "The backup label (and path name) are now created at the end of the backup instead of the beginning. This makes selecting a backup for PITR much easier."
},
{
"commit": "672c6b2ccb3b5926cd0e6bb0d78524d07bc74db6",
"date": "2014-08-12 19:04:46 -0400",
"subject": "Backup start/stop timestamp now stored in backup.manifest"
},
{
"commit": "34cb57f925e0f794e1845eae9b3f85dbdc65fe0e",
"date": "2014-08-12 18:36:38 -0400",
"subject": "Using checkpoint command instead of pg_switch_xlog."
},
{
"commit": "6b4a8fbc217bc2aa227d879753695bec860e6c3d",
"date": "2014-08-10 21:22:17 -0400",
"subject": "Unit tests now working on Ubuntu 12.04"
},
{
"commit": "0298e8dd16b3bce2c6e8d51ab231b079f148ecd8",
"date": "2014-08-10 15:02:14 -0400",
"subject": "Created unit tests for files deleted by the db during backup."
},
{
"commit": "09e2351ae8b17a8eaccba81337e16fc4d7aeb7a4",
"date": "2014-08-09 18:35:55 -0400",
"subject": "Test log mode is working."
},
{
"commit": "83d0db27d10ca966f7675239069fbdbd1c4ffc3a",
"date": "2014-07-27 18:18:59 -0400",
"subject": "Added release comment."
},
{
"commit": "2d9f027e3a8e7ded65efda2fe93780f6e624a1bf",
"date": "2014-07-27 18:13:23 -0400",
"subject": "Cleanup, work on test framework."
},
{
"commit": "a849f2d2fdf4709790246bf9d3f65c5b71cee5ee",
"date": "2014-07-27 14:26:07 -0400",
"subject": "Removed remaining decencies on Config::IniFiles"
},
{
"commit": "6f4310db426da453f498eb7eac47d6c32608993e",
"date": "2014-07-27 14:03:21 -0400",
"subject": "Changes for testing - finished changing config to local implementation."
},
{
"commit": "50dd95c005136aeb03ae5907028c696af6b173db",
"date": "2014-07-25 19:07:40 -0400",
"subject": "Sync up - hopefully."
},
{
"commit": "287e15f01facef1d7174d31d6b1f8e4f86323562",
"date": "2014-07-25 18:31:56 -0400",
"subject": "Test commit."
},
{
"commit": "6614f50cc824de153454d86c9c7c3a3d273ecf99",
"date": "2014-07-25 18:18:20 -0400",
"subject": "Test change"
},
{
"commit": "9dd3df6fd324e33411f539aa63b901cd9895205b",
"date": "2014-07-23 08:04:48 -0400",
"subject": "Added to feature backlog."
},
{
"commit": "75160a41b9690e01575df334c00f671a5f4f1d01",
"date": "2014-07-21 08:11:04 -0400",
"subject": "Added notes for some changes."
},
{
"commit": "06b5ee3f753e87d15a0c7d34488346c0d3c225f4",
"date": "2014-07-16 23:38:38 -0400",
"subject": "Working on new config load/save functions and unit tests."
},
{
"commit": "f6e01de7ced32b89a1cf0f68a2c631fcaa1b127d",
"date": "2014-07-16 20:28:47 -0400",
"subject": "Improved backup::full unit test."
},
{
"commit": "5d39b4f64660ccbd4cee64033c186d9a78f0b231",
"date": "2014-07-16 20:07:50 -0400",
"subject": "Local backups are now completely local."
},
{
"commit": "9ad1d79f0000497225366981979cb228be66e266",
"date": "2014-07-16 19:15:56 -0400",
"subject": "Unit tests for archive-get."
},
{
"commit": "9d9dae418bc03a4586bdb579d113a651927c4d1a",
"date": "2014-07-15 22:32:41 -0400",
"subject": "Added archive-put unit tests. Lots of other unit test improvements."
},
{
"commit": "8d398e4bffe30bdb1b33fb5aa4b5d5880592681c",
"date": "2014-07-13 10:37:16 -0400",
"subject": "Starting on archive unit tests."
},
{
"commit": "375545320d3278dc9a585ad136e5cc3d93e28475",
"date": "2014-07-13 09:13:19 -0400",
"subject": "Added tests for large files (16MB archive log). Fixed a sync error in binary_xfer()."
},
{
"commit": "ed4bcf3e4681a5002b50d8fc165ba7af0be4035c",
"date": "2014-07-12 19:36:12 -0400",
"subject": "Whitespace is now cleaned in test.pl"
},
{
"commit": "353cdb6b31e68d7751b44496ebbab72e26be9a92",
"date": "2014-07-12 19:03:39 -0400",
"subject": "Local archiving is working again."
},
{
"commit": "e36a785b1bd7480b0445c118c2ed926132038f75",
"date": "2014-07-12 10:26:51 -0400",
"subject": "Fixed execute function - now only displays output when there is an error."
},
{
"commit": "7f4c4e13d2031e78f276ed1fc560e97d3c1f9191",
"date": "2014-07-02 19:15:21 -0400",
"subject": "Back to Open3."
},
{
"commit": "fead7aa5f1ae741b25b0bc17458a307f7e08515e",
"date": "2014-07-02 18:58:38 -0400",
"subject": "Not loving IPC::Run, but saving my work just in case."
},
{
"commit": "d0ca69d433edf407d6b3ea47032444adb61b3209",
"date": "2014-06-30 18:35:05 -0400",
"subject": "Integrating IPC::Run - IPC::Open3 is out."
},
{
"commit": "c300c841eb3177519d16073f2312dd597348fb53",
"date": "2014-06-30 08:29:25 -0400",
"subject": "Added release notes."
},
{
"commit": "934b7dbe9b5865d505e1726c299a09597f8c1ce8",
"date": "2014-06-29 17:23:34 -0400",
"subject": "De/compression is now done in threads instead of forked processes."
},
{
"commit": "c85413ec6837a36ccf3911f07d63f9eb8648e770",
"date": "2014-06-29 10:53:39 -0400",
"subject": "Lots of improvements to unit tests. A few bug fixes."
},
{
"commit": "f9ec149ffe866c1a43b020f1a0e2dfa57b9fdc50",
"date": "2014-06-28 14:32:34 -0400",
"subject": "Working on unit tests."
},
{
"commit": "97b9560e5c03eb314282dac3984fc21b5d2a2fad",
"date": "2014-06-28 11:47:21 -0400",
"subject": "Fixed binary_xfer() issue. Now seems to work in all cases."
},
{
"commit": "9c160a03e36029c8d4eaaf81344f972820a5a2e8",
"date": "2014-06-23 19:08:36 -0400",
"subject": "Some refinements to compression."
},
{
"commit": "e1829bb2d269192fa5af4effcf74e53b293d4ea0",
"date": "2014-06-23 18:54:00 -0400",
"subject": "First fully working backup in a while."
},
{
"commit": "88bbbb4222a5de1eb572219b16e92ce92d9817e3",
"date": "2014-06-22 20:19:13 -0400",
"subject": "Fighting with a relative path issue in archive logging."
},
{
"commit": "5d01aac92e4f27da4f6459885bfd4d00e0d22da6",
"date": "2014-06-22 16:05:00 -0400",
"subject": "Working on backup - mostly working except for the last archive step."
},
{
"commit": "f91dce259f30b20608e882052c91c8466c95c20d",
"date": "2014-06-22 14:51:28 -0400",
"subject": "Working on backup unit tests."
},
{
"commit": "8fff74ccfb518dcd837d2407b6a6427dbf8fedbd",
"date": "2014-06-22 11:56:01 -0400",
"subject": "Backup unit test able to create and drop clusters."
},
{
"commit": "3c748c4b10ad200c7284c0900f8518fc8b73015f",
"date": "2014-06-22 10:54:31 -0400",
"subject": "More work on unit tests."
},
{
"commit": "0b597d8da9ddab0c29bee8de24515ccf1066f667",
"date": "2014-06-22 10:30:17 -0400",
"subject": "Working on getting backup running again."
},
{
"commit": "0dd15dd216e5084b7594dba7a23e61d65c07d73d",
"date": "2014-06-21 20:08:49 -0400",
"subject": "Cleanup."
},
{
"commit": "753fa11b5d4417952424680d723050a2c76e431c",
"date": "2014-06-21 19:16:55 -0400",
"subject": "remove() and hash() now working."
},
{
"commit": "7c161be995a0a157f6f91e3179fc6d8664f96b5e",
"date": "2014-06-21 18:19:37 -0400",
"subject": "manifest() and list() are working."
},
{
"commit": "53f1d3c78e795546665ee8b51ef4a3be902955b5",
"date": "2014-06-21 15:46:26 -0400",
"subject": "path_create() working."
},
{
"commit": "7bc464a44b4145db527a97012cafc74735dbcd17",
"date": "2014-06-21 15:17:09 -0400",
"subject": "Working on BackRest::File methods."
},
{
"commit": "936b8d0db03ee00e24f81a47d24fa8f612ee7018",
"date": "2014-06-21 14:19:03 -0400",
"subject": "move() is working."
},
{
"commit": "80206a28e930b7b769494eb05ee035fac69e9c3d",
"date": "2014-06-21 12:22:25 -0400",
"subject": "Ignore missing source in copy() working."
},
{
"commit": "e1903d53d01bb707bf9ac3347710d03b24dc4851",
"date": "2014-06-21 11:05:29 -0400",
"subject": "copy() works when both files are local or both files are remote."
},
{
"commit": "4a113cae66e8ef4ac83b6089ca2f3fe4c82ff185",
"date": "2014-06-21 10:05:49 -0400",
"subject": "Better error handling for missing source file in copy()."
},
{
"commit": "3af52398006b8f2bfd689cea6d9ce94a7a87fbff",
"date": "2014-06-21 08:42:30 -0400",
"subject": "Various compression options working in copy()."
},
{
"commit": "08750f2fdafb157721aff191aacbc2f2d927f852",
"date": "2014-06-16 06:12:38 -0400",
"subject": "Still working on copy()."
},
{
"commit": "0b3b743f5a6030bedf92f736bc6cb6021f2ced48",
"date": "2014-06-15 19:18:26 -0400",
"subject": "Stupid compress issue was in the unit test - but did tighten up the code a bit."
},
{
"commit": "d162ce203d6c70bb80dc0f5224329ae76b53f3f7",
"date": "2014-06-15 18:32:43 -0400",
"subject": "Trying to get various compression options working in copy()."
},
{
"commit": "9526975ad357a25d16c37e5c337a8d4186746b53",
"date": "2014-06-15 16:53:20 -0400",
"subject": "Cleanup, comments."
},
{
"commit": "adf654edb34df2a6ae67eff691e3e469cd95a5d5",
"date": "2014-06-15 15:56:45 -0400",
"subject": "In-stream compression now working in copy."
},
{
"commit": "f51c06119c8d5f52312d41f6d4738bac3abeb0c8",
"date": "2014-06-15 09:32:11 -0400",
"subject": "copy() works through multiple runs an multiple remotes."
},
{
"commit": "d568b6525b51b33301a4edb2a7b38660975602cc",
"date": "2014-06-14 20:47:32 -0400",
"subject": "copy() works with remote in either direction."
},
{
"commit": "79f85fe6c426ad536382d28ce97bf56e91232207",
"date": "2014-06-14 19:50:54 -0400",
"subject": "Finally a working copy() with new protocol."
},
{
"commit": "3a32363a568e09f34d2ec3154ce64754a4175d0e",
"date": "2014-06-12 21:56:20 -0400",
"subject": "Working on copy."
},
{
"commit": "976bafca9e84f9efcf43dbbf27183ead85bece4c",
"date": "2014-06-07 17:29:11 -0400",
"subject": "Added new tests."
},
{
"commit": "ca6823986d2e6ab6aeebe0d8cc4389eff83a0929",
"date": "2014-06-07 16:29:03 -0400",
"subject": "Sample install file."
},
{
"commit": "58e70422acb9d8a53d348479da8cdcdaf2ffc655",
"date": "2014-06-07 16:27:30 -0400",
"subject": "Testing install.md"
},
{
"commit": "166318d00d324504f242a84a134309ff496c06e2",
"date": "2014-06-07 16:25:20 -0400",
"subject": "Moved remaining libraries and other files."
},
{
"commit": "31b05eaab3c22346ef6bdec305889f3ca70cfd78",
"date": "2014-06-07 16:13:41 -0400",
"subject": "Moved pg_backrest_utility."
},
{
"commit": "0a8a5c7ed484bae9487d6fe3eb0536c70395f787",
"date": "2014-06-07 16:06:46 -0400",
"subject": "Refactoring - added version file."
},
{
"commit": "ea1a158d828485ea45cf137ba232497ba00aaab9",
"date": "2014-06-07 15:30:13 -0400",
"subject": "Improved logging."
},
{
"commit": "e60e2b22ed4c6d26d39e5c1732871df8f9815ad1",
"date": "2014-06-07 15:01:29 -0400",
"subject": "Much improved param protocol."
},
{
"commit": "e07a6b4e3f14fd24b15497f907d3c5589ec80b93",
"date": "2014-06-07 13:15:55 -0400",
"subject": "Cleaner remote implementation."
},
{
"commit": "1bc80c50edf1461ff87eec127221569ff4b327a7",
"date": "2014-06-07 11:51:27 -0400",
"subject": "First passing test with new protocol."
},
{
"commit": "ae130229ef89c1360796bfbe593c265aae4b6494",
"date": "2014-06-06 21:16:24 -0400",
"subject": "Working on remote protocol."
},
{
"commit": "e71a986ef3e1cf43a7edd0207b7d4f97ee21cdac",
"date": "2014-06-05 23:51:27 -0400",
"subject": "More work on copy()"
},
{
"commit": "e44cd6c1ca1d789cb0b6a6ef81418d68072377d1",
"date": "2014-06-05 22:42:47 -0400",
"subject": "More paths through copy() working."
},
{
"commit": "ca6b435c4ffbfb7459298535cc06fa48f6900d36",
"date": "2014-06-05 16:40:05 -0400",
"subject": "June Hackathon: copy_in and copy_out functions written, some paths through File->copy() working, basic unit tests setup."
},
{
"commit": "c2dd53f90885a0ce8bd4399d8e2555c96b36159d",
"date": "2014-06-05 10:20:03 -0400",
"subject": "Changes to allow specific tests to be run."
},
{
"commit": "5813aedaa3894d36c4645744fa47b005a635ef08",
"date": "2014-06-05 09:59:04 -0400",
"subject": "Added recognition section to read me."
},
{
"commit": "5d09af9cc04c42271a3b5d2879f28a0d6483dfc8",
"date": "2014-06-04 13:47:17 -0400",
"subject": "Better include markdown."
},
{
"commit": "82814aebdd0c37206538b8b55229ee686f7d0f68",
"date": "2014-06-04 11:58:30 -0400",
"subject": "Whitespace cleaning."
},
{
"commit": "1793b7a5c4d70ee262c57c56faaa2d975d5b9673",
"date": "2014-06-03 22:02:56 -0400",
"subject": "Comments and formatting."
},
{
"commit": "1b9782cb9e566fcc08a8c0f23ceba8ecf44e7f15",
"date": "2014-06-03 21:22:07 -0400",
"subject": "Converted path_create(), improved unit tests."
},
{
"commit": "ffa45d07bf9d3ba6134341c1f1293560a76e57bc",
"date": "2014-06-03 19:03:03 -0400",
"subject": "New version of move()."
},
{
"commit": "816c67edfdc9b263bfed9ab7a7fa213d78990436",
"date": "2014-06-02 17:48:07 -0400",
"subject": "Converted File::compress"
},
{
"commit": "0249d3516b274b650afc04c16e56fd160f53bc71",
"date": "2014-06-02 16:26:37 -0400",
"subject": "Manifest is working (unit tests at least)."
},
{
"commit": "361c2c24bfb92d78b0a7006df6945f714a0c511f",
"date": "2014-06-01 18:39:35 -0400",
"subject": "Working on manifest."
},
{
"commit": "03383691932d7951ae036409a16d6b364483b97d",
"date": "2014-06-01 17:23:33 -0400",
"subject": "Working on more robust file functions."
},
{
"commit": "85f591f801fc7cc19044fb2190829ad1ec057d80",
"date": "2014-05-27 09:00:24 -0400",
"subject": "More unit tests for file functions."
},
{
"commit": "3e12f9230b35bc625cc653b620452090ab9b2260",
"date": "2014-05-14 15:07:37 -0400",
"subject": "Working on unit tests for file_copy. Still need to add specific error tests, timestamp, and permissions."
},
{
"commit": "db40553434035ffc4ab1f61061f429f023bde5b8",
"date": "2014-05-13 16:41:20 -0400",
"subject": "Changed version."
},
{
"commit": "1fa8dbb778bfe43bb345639f8e29c9978347c9ef",
"date": "2014-05-13 11:47:14 -0400",
"subject": "v0.19: Improved error reporting/handling"
},
{
"commit": "d234aeea64b9cf6e7ec643fdd0d53961769c768f",
"date": "2014-05-13 11:23:15 -0400",
"subject": "More work on error-handling."
},
{
"commit": "a2b28623d42d1979d91bc112a411588d8996a66b",
"date": "2014-04-28 09:13:25 -0400",
"subject": "Working on better error handling."
},
{
"commit": "53fa574d7eaf5a1574e3f87d41abd8ff5077faf9",
"date": "2014-04-13 11:58:35 -0400",
"subject": "Merge branch 'master' of github.com:dwsteele/pg_backrest into dev"
},
{
"commit": "9acbba173e65f40d6032ed47a1760ec48e383b91",
"date": "2014-04-13 09:51:51 -0400",
"subject": "v0.18: Return soft error from archive-get when file is missing"
},
{
"commit": "d8c488f73f1453295028d7b464c99869c084f862",
"date": "2014-04-11 14:15:56 -0400",
"subject": "Added the feature backlog."
},
{
"commit": "06b8eefd19dc7d75259888a281962d54fa7e121c",
"date": "2014-04-03 18:20:46 -0400",
"subject": "Fixed up README"
},
{
"commit": "7aa6c8ecaf3b15e7c4f58ce345f205b7aef2b423",
"date": "2014-04-03 18:17:40 -0400",
"subject": "v0.17: Warn when archive directories cannot be deleted"
},
{
"commit": "49536498e6d54e283f656a41d7e1dcd5fbaed487",
"date": "2014-04-03 16:52:39 -0400",
"subject": "Warning for non-empty dirs instead of error"
},
{
"commit": "194696f6742d571bdeb49e75f6d9d980c2cbf1fe",
"date": "2014-04-02 17:25:37 -0400",
"subject": "Working on unit tests."
},
{
"commit": "9a5bb36c0f5ec13a03c86f61644ac02c46fba679",
"date": "2014-04-01 21:41:34 -0400",
"subject": "Added notes."
},
{
"commit": "be1163b948200c409199302ab5c03e724c7b7331",
"date": "2014-04-01 10:49:37 -0400",
"subject": "v0.16: RequestTTY=yes for SSH sessions"
},
{
"commit": "235c75b1b00f05312a437bc53c313fd2e19a2d42",
"date": "2014-04-01 09:01:34 -0400",
"subject": "Added ;"
},
{
"commit": "7624d65edf340887559c87a806cee6e6da41db65",
"date": "2014-04-01 08:59:09 -0400",
"subject": "Added TTY code."
},
{
"commit": "2b8972936ffb52d27678d69f1fc332f712df014e",
"date": "2014-03-30 21:02:17 -0400",
"subject": "Updates to README."
},
{
"commit": "765af10c88ff08de48133629c124d472da68af1c",
"date": "2014-03-29 18:18:03 -0400",
"subject": "Merge branch 'master' of github.com:dwsteele/pg_backrest into dev"
},
{
"commit": "dafaeb0b82994172ffc8238e14a50db027c53262",
"date": "2014-03-29 18:16:08 -0400",
"subject": "v0.15: Added archive-get"
},
{
"commit": "ba2590dc8eb014152ddcb0a1b1e0c59fd8d1fb22",
"date": "2014-03-28 15:20:36 -0400",
"subject": "archive-get function is working. Added option to force checkpoint at backup start."
},
{
"commit": "8ae6c2719dfb83a8404265c5e0b72d93bfbdd36a",
"date": "2014-03-28 11:59:44 -0400",
"subject": "Better code in file_list_get()."
},
{
"commit": "23df43e781f9a0631b79b723bf4f09ecb3a07a7e",
"date": "2014-03-28 11:40:37 -0400",
"subject": "file_list_get now works locally and remotely"
},
{
"commit": "9d949b7ad6446be70316a50d84adf5c24f6f37c5",
"date": "2014-03-26 10:53:49 -0400",
"subject": "v0.11: Minor fixes"
},
{
"commit": "126b39855d6680453bbc2af8a565e776b07d4046",
"date": "2014-03-25 18:56:05 -0400",
"subject": "Working on archive-get"
},
{
"commit": "e68f836b2e719c822df6b17df68b2a825a4702c9",
"date": "2014-03-08 09:12:53 -0500",
"subject": "Documented enhancements planned for v0.15"
},
{
"commit": "bbb3b48cf8181e0a69328dbb12dcf75169f08e24",
"date": "2014-03-05 20:06:13 -0500",
"subject": "Added comments."
},
{
"commit": "587bd1f8d9fa3329d95239501399166aa147bda7",
"date": "2014-03-05 19:53:13 -0500",
"subject": "v0.10: Backup and archiving are functional"
},
{
"commit": "1617afb704bab58c0e8c8153c8f116f36d196e95",
"date": "2014-03-05 19:51:03 -0500",
"subject": "Initial commit."
},
{
"commit": "1a4f2527e32e4ecf2efac9d47a0ab46bd5da891b",
"date": "2014-03-05 19:49:05 -0500",
"subject": "Fixed version number."
},
{
"commit": "ae30ec98e9c1ce41bfcbba02adbf7a3e6add95db",
"date": "2014-03-05 19:47:05 -0500",
"subject": "First release merge from master."
},
{
"commit": "81616e19bd43ecd1ffae3401dc713149cffb18e7",
"date": "2014-03-05 19:45:01 -0500",
"subject": "v0.01: Backup and archiving are functional"
},
{
"commit": "951419178bed96227cff47d1b08a87b40610dce3",
"date": "2014-03-05 19:43:23 -0500",
"subject": "Initial commit."
},
{
"commit": "2b55b8ca5ef7eea92f24515155596a5bb46db112",
"date": "2014-03-05 19:10:23 -0500",
"subject": "Merge branch 'master' of github.com:dwsteele/pg_backrest into dev"
},
{
"commit": "1eb8e1be2d31724c2f7b01899734411e25b068b5",
"date": "2014-03-05 18:56:15 -0500",
"subject": "v0.01: Backup and archiving are functional"
},
{
"commit": "80d5332fa032f604f63e2833e1c919e8c52a460e",
"date": "2014-03-04 08:00:51 -0500",
"subject": "Squashed commit of the following: "
},
{
"commit": "f0d82151b91828fece28a57d2de24f5ccc92e0d1",
"date": "2014-03-03 16:38:01 -0500",
"subject": "Changed thread timeout from WARN to ERROR"
},
{
"commit": "571d449717fecee1eac64088bde42606fcddc4eb",
"date": "2014-02-27 19:15:00 -0500",
"subject": "Redirect find error output to /dev/null. Sometimes files are removed from the db while find is running. We only want to error if the find process errors."
},
{
"commit": "84c4cec257b25fc026f12560d6c0bc5cfb5822ec",
"date": "2014-02-27 13:00:41 -0500",
"subject": "Put redirects in common places where errors are be output but we don't want to see them."
},
{
"commit": "ae782d08845e2d9f5fd9df8ce8a05cb472da6f56",
"date": "2014-02-25 07:30:45 -0500",
"subject": "Made archiving single-threaded so it will work"
},
{
"commit": "a84478045e7e25d197368a19ac375509f80dfc9c",
"date": "2014-02-24 18:04:42 -0500",
"subject": "No attempt to kill threads - just abort"
},
{
"commit": "da41eb3883622a333e6e84056c05964bc2e4e402",
"date": "2014-02-24 17:59:42 -0500",
"subject": "Added more warnings"
},
{
"commit": "21b15b7cf6a8b48a4e9c65691eaece5306e47c22",
"date": "2014-02-24 09:33:47 -0500",
"subject": "Added thread timeout."
},
{
"commit": "5de8f275f0e9f06a45f1d2dafb540d5db244d505",
"date": "2014-02-22 11:14:01 -0500",
"subject": "Removed stderr redirects from the master ssh connection"
},
{
"commit": "0e4f0f1308e15dad9e6d6d07cf9bc92bc1aa1492",
"date": "2014-02-22 10:54:02 -0500",
"subject": "Fixed issue with archive path expiration"
},
{
"commit": "e8c7d7aca69dae3ff14cf0065815bced3f2002f1",
"date": "2014-02-22 09:05:58 -0500",
"subject": "When archive_retention_type is full, use the oldest backup if there are fewer than required"
},
{
"commit": "9270a6789206a0f2fcd5f92d5faaae5e6ac54973",
"date": "2014-02-21 16:09:34 -0500",
"subject": "Removed some more stderr redirects"
},
{
"commit": "6d975d283073e90247214961e31d49959e7765c6",
"date": "2014-02-21 08:49:27 -0500",
"subject": "No longer discarding stderr"
},
{
"commit": "0387a8ee09e5fbd66fe8d4dae055f9fea07e6039",
"date": "2014-02-21 07:34:17 -0500",
"subject": "replaced process id with thread id. Added use thread to all modules."
},
{
"commit": "ac3ce81621fab54c925eead8c53dee01c797d63e",
"date": "2014-02-21 06:42:42 -0500",
"subject": "Add process id to logging, don't generate checksum for 0 length files"
},
{
"commit": "3d8e933343d8b7fa0900d37f68cd235b923980bf",
"date": "2014-02-19 16:06:21 -0500",
"subject": "More threads"
},
{
"commit": "857e1774292da086f3ad4e9fca4ed28efea6683f",
"date": "2014-02-19 15:13:07 -0500",
"subject": "Using separate master queues"
},
{
"commit": "800cd898317d76b24e8aa7f3acdbcb39cb2de052",
"date": "2014-02-19 13:37:18 -0500",
"subject": "Thread files are no longer in an array"
},
{
"commit": "81433c0fdde660c3357526a3447cd1146a6b9f8c",
"date": "2014-02-19 13:03:52 -0500",
"subject": "Now using one control master for threading."
},
{
"commit": "b4ac9552d24a12ddf06d4df293a360cd72a1cf4d",
"date": "2014-02-18 19:29:57 -0500",
"subject": "Skipped files removed from manifest, checksums stored"
},
{
"commit": "27b820cfb4c5ac0ff5695202cdab98d471e0b95f",
"date": "2014-02-18 15:42:51 -0500",
"subject": "Backup handles files that were removed by the db"
},
{
"commit": "187fdaf49bd1d9abb1805e28afc2fab9161bc405",
"date": "2014-02-16 19:01:06 -0500",
"subject": "Better compression choices."
},
{
"commit": "5c695a6522fd0092934e60dec7634760cde0673f",
"date": "2014-02-16 18:20:55 -0500",
"subject": "Improved archive logging and put in max limit"
},
{
"commit": "13086e96266f8872ad0a07dfbac3289233742242",
"date": "2014-02-16 17:02:25 -0500",
"subject": "Renamed processes."
},
{
"commit": "eb25dbdb9dedae5ef7dd35e8e5dbff839168373d",
"date": "2014-02-16 16:58:25 -0500",
"subject": "Added stanza to command string"
},
{
"commit": "b45d9c946e74434a01e62b371f9c382dcb64210d",
"date": "2014-02-16 16:51:05 -0500",
"subject": "Improved command string"
},
{
"commit": "6d7f89fc98ad2e511e6e549943ff5c8311de89cf",
"date": "2014-02-16 01:31:24 -0500",
"subject": "change process string"
},
{
"commit": "577c5af33fe05c961273d0d62c42dbd3320b4d87",
"date": "2014-02-16 01:24:54 -0500",
"subject": "testing"
},
{
"commit": "b514058cee5801897530e6d27d1a61b0f6b7692f",
"date": "2014-02-15 16:46:13 -0500",
"subject": "Changed to perl storable - at least it works"
},
{
"commit": "392da9162084cb17eb7eff8bf1815e970df8ac3e",
"date": "2014-02-15 15:28:22 -0500",
"subject": "Remove old local archive dirs."
},
{
"commit": "0bc40d206cdbf777f56bfa2cb21472da71185872",
"date": "2014-02-15 14:33:31 -0500",
"subject": "Some fixes for config"
},
{
"commit": "0979841f1a08352ece1ade8821d69080f82b1132",
"date": "2014-02-15 14:18:15 -0500",
"subject": "Async compress, thread kill improvements"
},
{
"commit": "bd00fb7f0ceb86092c3998ac1ac923bb4f28ae2f",
"date": "2014-02-15 10:45:01 -0500",
"subject": "Still working on thread kill"
},
{
"commit": "3b2dd68aac9bc00e1b45d2a8d6dfd74da17112f7",
"date": "2014-02-15 10:31:57 -0500",
"subject": "More robust join code."
},
{
"commit": "27bf9b65720e278419c0c0a414141fb7b729c789",
"date": "2014-02-15 10:09:47 -0500",
"subject": "First SSH session is shared between objects and thread 0"
},
{
"commit": "c7aebf05c4e12dc9fbd7ba4bed838c6110e6cdd0",
"date": "2014-02-14 21:39:18 -0500",
"subject": "Handle term signals gracefully."
},
{
"commit": "d100294894e1f1a5b2d35f6807d3e3a18a8c0b7e",
"date": "2014-02-14 19:56:28 -0500",
"subject": "Ability to resume failed backups, better locking"
},
{
"commit": "308652cc657f5f015c6affde2d01a784862c96a0",
"date": "2014-02-14 09:05:14 -0500",
"subject": "Remove a lot of path creates - percent logging."
},
{
"commit": "e14d52c42a48b2c707ae585e9470c637c9966d46",
"date": "2014-02-14 08:23:25 -0500",
"subject": "Improved backup threading"
},
{
"commit": "e93a444a415244de15769f07b69741530254f882",
"date": "2014-02-13 23:37:52 -0500",
"subject": "Changes to manifest."
},
{
"commit": "5c393a0df9beb7ce8e78b3b3627bc1114aa1f94d",
"date": "2014-02-13 21:44:19 -0500",
"subject": "Increased time to wait for log files"
},
{
"commit": "dccdec2ffa5d145f0dd8efceafaef651f59d72c6",
"date": "2014-02-13 21:41:20 -0500",
"subject": "trying to make labels stick"
},
{
"commit": "ae3dcc57f01983e4eac6ca72bb482b9fa2e6e4d3",
"date": "2014-02-13 21:31:57 -0500",
"subject": "Thread errors now exit"
},
{
"commit": "6d9e7db1c69ee2f862e2941574c5c60ec8d5130f",
"date": "2014-02-13 20:54:41 -0500",
"subject": "Increased thread total."
},
{
"commit": "405d36497dc326b12dbc243a1b3bcd97ce438168",
"date": "2014-02-13 20:33:05 -0500",
"subject": "Less logging"
},
{
"commit": "a78d677b1e226cf9cda517ffeb662b63480c4099",
"date": "2014-02-13 20:29:42 -0500",
"subject": "Wait for archive files."
},
{
"commit": "d4ba078183f0edd290f136cdb13c43f9f70ffd43",
"date": "2014-02-13 18:14:15 -0500",
"subject": "Only save manifest once"
},
{
"commit": "1bec36b65b9ed5f2ca31879dc03877708ce048df",
"date": "2014-02-13 18:07:58 -0500",
"subject": "Better thread logging."
},
{
"commit": "2bafa5cf26773ba14da891c1079140c2b9ff08af",
"date": "2014-02-13 17:52:38 -0500",
"subject": "Logging tweak"
},
{
"commit": "8453681ccdb41e8ad1e3cf71c2df761bb2341768",
"date": "2014-02-13 17:50:14 -0500",
"subject": "Logging tweaks"
},
{
"commit": "4349f0caff1e9a9e1501483af8a64ec594513082",
"date": "2014-02-13 17:47:53 -0500",
"subject": "Fixes to log level and more logging"
},
{
"commit": "7d55ce865bf9bf0580c256ae25acbf776692ec3a",
"date": "2014-02-13 17:11:53 -0500",
"subject": "Work on log levels"
},
{
"commit": "133e27d813e3e70f7c322fe6705e7104909e8b3f",
"date": "2014-02-13 15:26:07 -0500",
"subject": "Archive tmp file fix."
},
{
"commit": "19f9a5193f547a874b871e7388328043da4ad274",
"date": "2014-02-13 14:54:28 -0500",
"subject": "Minor config changes."
},
{
"commit": "13a1f0cf246f24dd1fba09543b5fc19ebb065c70",
"date": "2014-02-13 13:54:43 -0500",
"subject": "Lots and lots of logging improvements"
},
{
"commit": "14b13d48404aedaf629ea647592b058db324b5c4",
"date": "2014-02-13 12:02:45 -0500",
"subject": "Async archive log backup working."
},
{
"commit": "f0df759bb97f3499e6c245fee88fceb491e4b551",
"date": "2014-02-13 00:21:25 -0500",
"subject": "Small debug fix"
},
{
"commit": "7c4d463b1da98c4f9c94693ee64c4776075e36e3",
"date": "2014-02-12 23:49:40 -0500",
"subject": "More balanced backup."
},
{
"commit": "b770c8ebece6c40190cc9d62f6798eeb32d4a105",
"date": "2014-02-12 22:33:09 -0500",
"subject": "More work on archive-pull"
},
{
"commit": "8e60a3111fd22095c6bdbbe99b51c3af87e661a0",
"date": "2014-02-12 20:28:27 -0500",
"subject": "Lots of archive-pull plumbing"
},
{
"commit": "16df430b73834c97410565bd96edeb7e7f79714d",
"date": "2014-02-12 17:34:34 -0500",
"subject": "New constants and basic fork."
},
{
"commit": "564bd65b3e8241113998558208d561c61b73fbb3",
"date": "2014-02-12 16:01:48 -0500",
"subject": "Basic plumbing for archive-pull function"
},
{
"commit": "5181282b7402ecbba88544e4cafddac1c7eb8f76",
"date": "2014-02-12 08:04:42 -0500",
"subject": "Command line parameter checks"
},
{
"commit": "729b07fed5eaa8247eaee65bd8f3e1a996bd7752",
"date": "2014-02-12 07:45:29 -0500",
"subject": "Hardlink now a conf option."
},
{
"commit": "219120ba811ad102f3c0df60119d645d919d534b",
"date": "2014-02-12 07:39:42 -0500",
"subject": "Archiving and flag changes."
},
{
"commit": "b9a2e7093ef381ce3b5e6bf2ee9ebf9cf03fa3d7",
"date": "2014-02-11 21:17:30 -0500",
"subject": "Some more file debug info"
},
{
"commit": "1a9f73b781db87e98ea1a42db2b43a29dec950f3",
"date": "2014-02-11 17:07:49 -0500",
"subject": "Added timestamp to log"
},
{
"commit": "49dbc897a635262db27de5091e8d330f92efa948",
"date": "2014-02-11 16:57:51 -0500",
"subject": "Small file allocation improvements."
},
{
"commit": "9a1de327a197af06ab647d88cd7669ff938b4daa",
"date": "2014-02-11 16:37:20 -0500",
"subject": "Turned ssh compression on"
},
{
"commit": "71812fca996ca53d205694c796694bb46dd4fbae",
"date": "2014-02-11 16:21:33 -0500",
"subject": "Thread total is defined in the conf file."
},
{
"commit": "171ca709d62a129907e241012e493162c6be2472",
"date": "2014-02-11 16:08:55 -0500",
"subject": "Better file ordering for threads."
},
{
"commit": "c58ccb588e846d7012923a927c2b955cffef3a3c",
"date": "2014-02-11 15:31:16 -0500",
"subject": "Parallel backup now working"
},
{
"commit": "a55b37efc31e6a6074ed98fe8c92ff10cfaf277b",
"date": "2014-02-07 19:34:14 -0500",
"subject": "Working on parallel backup"
},
{
"commit": "820791cf922e4c186288ee005e87a914df4d6c3e",
"date": "2014-02-06 17:31:33 -0500",
"subject": "FF log is skipped for pre-9.3 databases."
},
{
"commit": "60b2be58ac5e410719335993dabf218decc266d5",
"date": "2014-02-06 16:37:37 -0500",
"subject": "Finished db object abstraction"
},
{
"commit": "f20f3b3ee642c02b3b4295b235bc59b99a48af20",
"date": "2014-02-06 15:54:22 -0500",
"subject": "Started db object abstraction."
},
{
"commit": "9d08f2a64494c9528c30531bd95b7306484f229e",
"date": "2014-02-06 12:49:54 -0500",
"subject": "More robust config. Retention is read from config."
},
{
"commit": "a2b0d7a674a1524f53440be45d333409a3ad1a2b",
"date": "2014-02-05 22:26:10 -0500",
"subject": "Backup expiration working again. Other changes."
},
{
"commit": "27986e0c10999660078e7c74b25bc99eb3e028ce",
"date": "2014-02-05 21:39:08 -0500",
"subject": "File is now an object."
},
{
"commit": "3e7faf0e5f7d3f61856f0c7f3b50329172e69585",
"date": "2014-02-05 16:53:25 -0500",
"subject": "Some path fixes."
},
{
"commit": "7bee0f3141a301c0a1fa1bb8d092dbbd317fe296",
"date": "2014-02-05 15:56:05 -0500",
"subject": "Moved backup location."
},
{
"commit": "a15fcb8c23e11bb2ec056abe13120591cd70c515",
"date": "2014-02-05 13:10:36 -0500",
"subject": "Moved tmp path."
},
{
"commit": "7ffade2453afafb98d2d67d3612742e17075947e",
"date": "2014-02-05 11:35:09 -0500",
"subject": "Fixed file mod time and permissions"
},
{
"commit": "c86a61ca3e15acc1afc09c400aa866a958e1fd27",
"date": "2014-02-05 10:40:49 -0500",
"subject": "Relative links working for tablespaces."
},
{
"commit": "12a960f91a59fbcce53659b1ed4fbed5a1ba8fc9",
"date": "2014-02-05 08:21:27 -0500",
"subject": "File copy supports decompression"
},
{
"commit": "a81049995859666f378ee804ef15aba1d87543e2",
"date": "2014-02-04 18:48:39 -0500",
"subject": "Remote backup fully working."
},
{
"commit": "e38c482a26d270b19813c67829f0df977afa0996",
"date": "2014-02-03 20:48:02 -0500",
"subject": "Cleanup"
},
{
"commit": "946b8261cfedd62114642344614392426196ba00",
"date": "2014-02-03 20:29:03 -0500",
"subject": "Moved archive_push function"
},
{
"commit": "d5832a70c05dd40e73d6457e2b287f500454b781",
"date": "2014-02-03 20:23:04 -0500",
"subject": "Moved last backup function."
},
{
"commit": "aef6730267af465eea3ab99ecd06917f1628d176",
"date": "2014-02-03 19:57:21 -0500",
"subject": "Moved backup functions."
},
{
"commit": "316a5b559858b3aea89306efd4f0557c2f386d09",
"date": "2014-02-03 19:03:17 -0500",
"subject": "Working on remote"
},
{
"commit": "fa668d50072542890f15d9ebda77bb2ed552e3e9",
"date": "2014-02-03 14:50:23 -0500",
"subject": "Move file init code to file module"
},
{
"commit": "aef4adf1f3864de9e844d7fb7bb31afce5e887d2",
"date": "2014-02-02 19:03:05 -0500",
"subject": "Splitting main perl file"
},
{
"commit": "4c2e4f7e4924a0cd4ba9d3cae1f99f5fe115d147",
"date": "2014-02-02 12:45:59 -0500",
"subject": "Lots more work on remote functionality"
},
{
"commit": "bf8ac7abe6210b2300375ba879ade54f8dd69167",
"date": "2014-02-02 11:12:55 -0500",
"subject": "manifest_get() now works remotely"
},
{
"commit": "4556de472240b161eb3e8ac37ece2eac7f5c3278",
"date": "2014-02-02 10:40:05 -0500",
"subject": "Source and destination can now be remote."
},
{
"commit": "de972ef5d3bb73f69839a06a43dc9448ccd500cd",
"date": "2014-02-01 12:57:27 -0500",
"subject": "More work on file_copy"
},
{
"commit": "52ba8801efe419988a8900b5696944e8015a3a12",
"date": "2014-02-01 11:04:33 -0500",
"subject": "Working on remote file copy"
},
{
"commit": "2ad7a3d815da205d2b84372ad3f8279c2572a76e",
"date": "2014-01-31 00:04:08 -0500",
"subject": "Formatting."
},
{
"commit": "c5de8fa6e637a877aee003ef623b606d113070c8",
"date": "2014-01-30 23:58:26 -0500",
"subject": "Created variable for compression extension"
},
{
"commit": "151ff8ba6049b8a4b98900cbbde23bb540d71796",
"date": "2014-01-30 23:24:34 -0500",
"subject": "Removed unused strPath param from path_get()"
},
{
"commit": "52004d3c84b5886e229dcab67729eff2e1ae7291",
"date": "2014-01-30 23:16:19 -0500",
"subject": "Comments"
},
{
"commit": "447d83fcdc64c0a075772a6b6f7affb0191e2b2a",
"date": "2014-01-30 23:09:34 -0500",
"subject": "Removing more copies."
},
{
"commit": "f86618377c5b8efe7fe18683f0fb009f7391ad59",
"date": "2014-01-30 11:35:34 -0500",
"subject": "Lots of backup refactoring."
},
{
"commit": "e13a706c0a251baf9f69126653bb2eabb78064b5",
"date": "2014-01-29 15:38:57 -0500",
"subject": "More moving. Links now also get references."
},
{
"commit": "54c73b38139127e0acb9a13be6cd7a94d84851ca",
"date": "2014-01-29 15:03:57 -0500",
"subject": "Moving stuff around"
},
{
"commit": "c26b47d4c7d346dd67168333114ee8770baa6efd",
"date": "2014-01-29 12:06:30 -0500",
"subject": "Abstracting file functions."
},
{
"commit": "47c3c82540ab3acbf741b6e511b86898e40c9b5c",
"date": "2014-01-29 06:40:15 -0500",
"subject": "Fixed checksum function."
},
{
"commit": "12f6d889de8ec6363b3275ccf887b41b3336d994",
"date": "2014-01-28 17:16:07 -0500",
"subject": "More modular file copy."
},
{
"commit": "6625ea1405aef8b19b0f5e0c347cb1b7f9761747",
"date": "2014-01-23 19:39:51 -0500",
"subject": "Coded paths needed for archive logging"
},
{
"commit": "cdd1ef73069062720af4061b1955d09c3af27330",
"date": "2014-01-22 21:40:56 -0500",
"subject": "Added general path function"
},
{
"commit": "161de23c3bf7e4ce7e58f6611acbf227a675cd8f",
"date": "2014-01-22 19:03:20 -0500",
"subject": "Starting new structure"
},
{
"commit": "89b96954f6f6aa87d7ad138c7a87a8cf64558fc4",
"date": "2014-01-21 22:02:14 -0500",
"subject": "Allow any archive file start starts with 24 hex characters."
},
{
"commit": "7e73cf22cf8df6410600760390c7600eff3b5152",
"date": "2014-01-21 21:59:54 -0500",
"subject": "Changed where .backup files were copied"
},
{
"commit": "62ae46e2139e37d2a036131801c85db13148cd0d",
"date": "2014-01-21 21:12:24 -0500",
"subject": "Archive expiration working."
},
{
"commit": "a83e94ba27dd0c0958eaca145d4630ef5d7e0fbe",
"date": "2014-01-21 20:38:58 -0500",
"subject": "Fixed error in the backup regexp"
},
{
"commit": "faaaa5690f5c2f7999a692a999e3b3de67ff648f",
"date": "2014-01-20 20:09:50 -0500",
"subject": "Working on archive retention."
},
{
"commit": "df7ada85c226fb7e851fa4c3e1182e9f1a78fe47",
"date": "2014-01-18 10:14:35 -0500",
"subject": "Working on expiration"
},
{
"commit": "1e0f2485dbcf73b730fb04e6f2ef212d46df725d",
"date": "2014-01-18 00:03:32 -0500",
"subject": "Working on expiration"
},
{
"commit": "3719d54cc99d6be4b3d22fb853a2c7ff46b4b3dc",
"date": "2014-01-15 20:41:29 -0500",
"subject": "Some notes. removed dead .backup move"
},
{
"commit": "a7de734105b876654b7cbc8d9d448f2749176369",
"date": "2014-01-12 20:12:49 -0500",
"subject": "Some cleanup - fixed tablespace path regression."
},
{
"commit": "05dcbc2246ed949fec256e45c6c441b26f30673b",
"date": "2014-01-12 15:28:19 -0500",
"subject": "Working on making backups consistent"
},
{
"commit": "c1e59048808f969b2380a0607a2447d27822d25b",
"date": "2014-01-12 01:46:27 -0500",
"subject": "Fixed xlog copy - working on correctness"
},
{
"commit": "3ed83e78f2dd8a424a9adc396aa3c2eeed6cf39f",
"date": "2014-01-11 02:16:14 -0500",
"subject": "Working on archive log copy"
},
{
"commit": "387439ac8e0b01d61f896c67bd92be88acb9b063",
"date": "2014-01-10 16:01:25 -0500",
"subject": "Working on processing archive logs"
},
{
"commit": "e23820098d7a1dc83e3e8a1f88616a7aa298e388",
"date": "2014-01-10 14:02:56 -0500",
"subject": "Notices are not emitted on start and stop backup"
},
{
"commit": "8b73a26b8425a14ce233f16fa29d38fbaf428331",
"date": "2014-01-10 00:49:19 -0500",
"subject": "Some notes for things to do."
},
{
"commit": "49c1fcd3eb33873d402e486bc2b7ede8280d4fc9",
"date": "2014-01-10 00:43:26 -0500",
"subject": "Backup file is being copied to pg_xlog"
},
{
"commit": "8e966c50dd1a28e5cfabc8670c88bfbdcb9913aa",
"date": "2014-01-10 00:22:51 -0500",
"subject": "Removed commented code"
},
{
"commit": "b5f965942bc370beb7803395f79872323f7c59ba",
"date": "2014-01-10 00:21:46 -0500",
"subject": "Added optional hard-linking."
},
{
"commit": "cceac444ad357bf8babe36f906bacdc25b845841",
"date": "2014-01-09 21:55:09 -0500",
"subject": "Added comment"
},
{
"commit": "c47ec3d2609539d5437664aad4535bc2a2edad81",
"date": "2014-01-09 21:40:33 -0500",
"subject": "All backup references are now stored."
},
{
"commit": "ed5f8226a4a08ca4665bd49b3413bcaf7e4959c5",
"date": "2014-01-09 20:12:46 -0500",
"subject": "References are from oldest backup"
},
{
"commit": "bb8fb5b54f14b622af02899c95ad9e8e88d74e8b",
"date": "2014-01-09 20:00:34 -0500",
"subject": "Sparse backup dirs implemented"
},
{
"commit": "854972dde65f9560ff8177115e5b2e785e478a28",
"date": "2014-01-09 18:23:50 -0500",
"subject": "Basic deltas work."
},
{
"commit": "c89984cd59dc2ca1792d8cd99df1978719aed16e",
"date": "2014-01-09 18:02:42 -0500",
"subject": "Revert 2914a6d..e31b21f",
"body": "This rolls back to commit 2914a6dcc67b120be0ee5d808590849ebe9c3664."
},
{
"commit": "e31b21f95aa5bad69ab2a31f9fd569d1a2e01a78",
"date": "2014-01-09 18:01:34 -0500",
"subject": "Revert 52d8697..e0be213",
"body": "This rolls back to commit 52d86971183da8f8a88775f0196f44c3ab9440a1."
},
{
"commit": "e0be2132063932108069a0754d7416c2e2c58624",
"date": "2014-01-09 18:01:12 -0500",
"subject": "Revert 2914a6d..9633e17",
"body": "This rolls back to commit 2914a6dcc67b120be0ee5d808590849ebe9c3664."
},
{
"commit": "9633e17d04d00e31c80c3d12f848a5351b97963b",
"date": "2014-01-09 17:58:40 -0500",
"subject": "Revert \"Removed tmp file.\"",
"body": "This reverts commit 52d86971183da8f8a88775f0196f44c3ab9440a1."
},
{
"commit": "2914a6dcc67b120be0ee5d808590849ebe9c3664",
"date": "2014-01-09 17:58:01 -0500",
"subject": "Working on delta"
},
{
"commit": "52d86971183da8f8a88775f0196f44c3ab9440a1",
"date": "2014-01-03 21:24:13 -0500",
"subject": "Removed tmp file."
},
{
"commit": "ba5075a3e0458874f8b8dff0b4bc1f8cb07243ae",
"date": "2014-01-03 21:19:41 -0500",
"subject": "New implementation for archive logging"
},
{
"commit": "6379b723dee94d63ef55134468ff86f588c717f8",
"date": "2014-01-03 20:10:53 -0500",
"subject": "Set the backup label"
},
{
"commit": "78457a2f420428cab317e6cdb57446008ad9751c",
"date": "2014-01-03 19:59:47 -0500",
"subject": "Simplified incremental naming"
},
{
"commit": "ef846ac8db0d44339214676a88e0ee7c06d1a217",
"date": "2014-01-03 19:28:49 -0500",
"subject": "Working on backup rotation."
},
{
"commit": "e6e995ec19f8cb01311ce0f9f2772edbc009b7d2",
"date": "2013-12-18 22:08:49 -0500",
"subject": "Fixed typo in config."
},
{
"commit": "ba72eda700cdde982a360cdf99a4a5d367403cf4",
"date": "2013-12-18 21:30:51 -0500",
"subject": "Commented out dir mod time variable."
},
{
"commit": "9907c8b7b74bc2b3bef76a47567c695de680a2e3",
"date": "2013-12-17 07:47:24 -0500",
"subject": "Set file mtime."
},
{
"commit": "b1ffa9419034ef7f3b6795f64633cf3dab87d052",
"date": "2013-12-16 21:59:22 -0500",
"subject": "New storage structure, saved archive start/stop location."
},
{
"commit": "6d992855d213edae6f1f6986226c7b9d9ad55116",
"date": "2013-12-15 20:56:42 -0500",
"subject": "Cleaning up start stop backup code."
},
{
"commit": "0d3fa39117e17d1f7cf83927079da7fdaea826a9",
"date": "2013-12-15 20:04:07 -0500",
"subject": "Added start and stop backup."
},
{
"commit": "1d21f4f9fa2f659d1f8e441fae00a87d4150373a",
"date": "2013-12-15 18:18:54 -0500",
"subject": "Added diff to commands."
},
{
"commit": "31fca50eae78b777c1113957806ad8658d744235",
"date": "2013-12-15 17:18:50 -0500",
"subject": "Backup more or less works - no start/stop backup or archiving."
},
{
"commit": "21b7a3f27a373e877f2da845f6f5ac4974d3daac",
"date": "2013-12-14 15:02:47 -0500",
"subject": "Added manifest load and save."
},
{
"commit": "8b40ea7d598d3110c04f664b38060336c744290f",
"date": "2013-12-14 14:03:08 -0500",
"subject": "Tablespace names are now recorded"
},
{
"commit": "2ba26ffc262404347a46211545a5a2948a3e656c",
"date": "2013-12-14 13:14:59 -0500",
"subject": "More refactoring."
},
{
"commit": "d12773ca85fb73fedac018aecdc6ea5283ddbd2f",
"date": "2013-12-11 20:39:07 -0500",
"subject": "Added generic config command"
},
{
"commit": "4aa480b858bba7a0114c292132f7289b726258b0",
"date": "2013-12-11 20:13:39 -0500",
"subject": "Cleaned up some var names."
},
{
"commit": "299d402209fd4535f1d7aa8dcb32d6c440f61577",
"date": "2013-12-11 19:57:54 -0500",
"subject": "More cleanup"
},
{
"commit": "aa6e72bb9cf9e0523db135790c2cf3097db4c97d",
"date": "2013-12-11 19:22:41 -0500",
"subject": "Refactoring"
},
{
"commit": "0dba2ab8c7178ec592fe25a0178b5be482f6d544",
"date": "2013-12-10 20:16:43 -0500",
"subject": "Added backup command"
},
{
"commit": "0bdccd298269113aa0454506824a230923cfbb17",
"date": "2013-12-10 19:18:41 -0500",
"subject": "Reversed order of tests."
},
{
"commit": "f09505f60efbd715fd72b617036db4124c2b5054",
"date": "2013-12-10 19:11:54 -0500",
"subject": "Working on unit tests for archiving."
},
{
"commit": "39989dd01c2fd77147a1b775ae6b092f3d86c65b",
"date": "2013-12-09 17:26:47 -0500",
"subject": "Working on manifest."
},
{
"commit": "02a9a693b8881698008ba9f83cbffcc2e8be7f3f",
"date": "2013-12-06 20:24:14 -0500",
"subject": "Working on backup."
},
{
"commit": "4d42d448e95df1c7535c3b73594483462f5f893c",
"date": "2013-12-05 23:29:05 -0500",
"subject": "Working on backup."
},
{
"commit": "12518e72967ee6f54419f1acdb8f01b3cb2da26e",
"date": "2013-12-05 08:59:39 -0500",
"subject": "Working on backup."
},
{
"commit": "ae6886c8e058f3a094d7fbb7544122e3e33dc935",
"date": "2013-12-04 22:30:26 -0500",
"subject": "Started backup command."
},
{
"commit": "c9c7e340a7d89feb96d1070b45a15dd4fecfeb4d",
"date": "2013-12-04 21:37:45 -0500",
"subject": "Added config file."
},
{
"commit": "53b2aae10640d6abb287f9c163f2b6700dc7b9de",
"date": "2013-12-02 21:37:01 -0500",
"subject": "Added note."
},
{
"commit": "4a2b009c2e24c4c7c52849ad53358557658ee2a3",
"date": "2013-12-02 21:34:25 -0500",
"subject": "Removed unused include."
},
{
"commit": "1e114cdc9de43efdf43ccbd1d296c01f297a2907",
"date": "2013-12-02 21:26:32 -0500",
"subject": "Fix comments."
},
{
"commit": "9553baf540404c528b73a1608e5308b93d06d166",
"date": "2013-12-02 21:23:10 -0500",
"subject": "Basic error checking and options for archive-local command"
},
{
"commit": "c7c049902fd87c6f4c43d25b9d60d9289a1742f5",
"date": "2013-12-02 16:21:40 -0500",
"subject": "Added warnings, comments, removed dead code."
},
{
"commit": "5761832df5ce2e7655602d92f9d1a55a75a75bee",
"date": "2013-12-02 15:10:18 -0500",
"subject": "Implemented strict."
},
{
"commit": "a2c98391dfe7f360de7e97f0cb06d55dbb06af3d",
"date": "2013-12-02 14:34:37 -0500",
"subject": "Starting on configuration."
},
{
"commit": "2be8c5d9e7cef1256bb9f530d0594aec8bbf1351",
"date": "2013-11-23 20:05:04 -0500",
"subject": "Working on unit tests."
},
{
"commit": "5d0251be2f05dbb44063b874a62057040dcc0f66",
"date": "2013-11-23 19:16:09 -0500",
"subject": "Working on archive-local and beefing up unit tests."
},
{
"commit": "8b37786e5b640c7a1c270388ac1158cce45ebf72",
"date": "2013-11-22 23:24:37 -0500",
"subject": "Now connecting to db."
},
{
"commit": "8db52c115a18f690d42db975ee1bb28363b5135f",
"date": "2013-11-22 17:29:01 -0500",
"subject": "Fixed whitespace."
},
{
"commit": "d86e7eb6276bbe1df025c372690c19da8133c4bb",
"date": "2013-11-20 22:30:26 -0500",
"subject": "Added checksums."
},
{
"commit": "bc46aefe61871e27281b9b8c9ffc185c8e2846af",
"date": "2013-11-20 22:24:30 -0500",
"subject": "Fixed for OSX. Do not ever use TextEditor on code!"
},
{
"commit": "e67821a23096f4788f6bef71e7d4d361b7d9858f",
"date": "2013-11-20 21:49:07 -0500",
"subject": "Working on OSX port."
},
{
"commit": "9ce37308b5a3fb81e204a37cfbe28bec968126e4",
"date": "2013-11-17 21:48:53 -0500",
"subject": "Working on archive-local command."
},
{
"commit": "548578c8c96d304fb777c9aeb233733f97145818",
"date": "2013-11-17 13:58:21 -0500",
"subject": "Working on unit test."
},
{
"commit": "d7283f20f9607f0a73931462d88866487500f087",
"date": "2013-11-11 20:10:38 -0500",
"subject": "Updated license."
},
{
"commit": "4a562eb55a691c0658b2f148703afacb38587b0d",
"date": "2013-11-11 13:08:39 -0800",
"subject": "Initial commit"
}
]
pgbackrest-release-2.55.1/doc/resource/html/ 0000775 0000000 0000000 00000000000 15006170376 0020714 5 ustar 00root root 0000000 0000000 pgbackrest-release-2.55.1/doc/resource/html/default.css 0000664 0000000 0000000 00000024164 15006170376 0023061 0 ustar 00root root 0000000 0000000 /*******************************************************************************
Html and body
*******************************************************************************/
html
{
font-family: Avenir, Corbel, sans-serif;
font-size: 12pt;
margin-top: 8px;
margin-left: 1%;
margin-right: 1%;
width: 98%;
}
body
{
background: #f8f8f8;
margin: 0px auto;
padding: 0px;
width: 100%;
text-align: justify;
font-weight: 400;
counter-reset: section1-counter;
counter-reset: section1-toc-counter;
}
a:link, a:visited, a:hover, a:active
{
text-decoration: underline;
color: black;
display: inline-block;
}
@media (min-width: 1000px)
{
body
{
width: 1000px;
}
}
@media (prefers-color-scheme: dark)
{
body
{
color: #e2e2e2;
background: #181818;
font-weight: 350;
}
body a:link, body a:visited, body a:hover, body a:active
{
text-decoration: underline;
color: #e2e2e2;
}
}
/*******************************************************************************
Header
*******************************************************************************/
.page-header
{
width:100%;
text-align:center;
}
.page-header-title
{
font-size: xx-large;
font-weight: bolder;
}
.page-header-subtitle
{
position: relative;
top: -.25em;
font-size: large;
font-weight: bold;
}
.page-header-logo
{
float: left;
margin-top: 0.3em;
}
.page-header-logo > img
{
width: 69px;
height: 69px;
}
/*******************************************************************************
Menu
*******************************************************************************/
/*.page-menu*/
.menu-body
{
text-align: center;
}
.menu
{
white-space: nowrap;
display: inline;
margin-left: .5em;
font-size: 13pt;
}
.menu:first-of-type
{
margin-left: 0px;
}
.menu:before
{
content: "[";
}
.menu:after
{
content: "]";
}
/*.menu-link*/
a.menu-link:link, a.menu-link:visited, a.menu-link:active
{
text-decoration: none;
}
a.menu-link:hover
{
text-decoration: underline;
}
/*******************************************************************************
Table of Contents
*******************************************************************************/
.page-toc-body
{
margin-top: .25em;
margin-bottom: 2em;
}
.section1-toc:first-of-type
{
margin-top: 0;
}
.section1-toc
{
margin-top: .5em;
}
.section1-toc-number
{
display: inline;
font-size: 14pt;
margin-right: .75em;
counter-reset: section2-toc-counter;
}
.section1-toc-number:before
{
counter-increment: section1-toc-counter;
content: counter(section1-toc-counter);
}
.section1-toc-title
{
display: inline;
font-size: 14pt;
}
.section2-toc
{
margin-left: 1.8em;
}
.section2-toc-number
{
display: inline;
margin-right: .75em;
counter-reset: section3-toc-counter;
}
.section2-toc-number:before
{
counter-increment: section2-toc-counter;
content: counter(section1-toc-counter) "." counter(section2-toc-counter);
}
.section2-toc-title
{
display: inline;
}
.section3-toc
{
margin-left: 2.3em;
}
.section3-toc-number
{
display: inline;
margin-right: .75em;
}
.section3-toc-number:before
{
counter-increment: section3-toc-counter;
content: counter(section1-toc-counter) "." counter(section2-toc-counter) "." counter(section3-toc-counter);
}
.section3-toc-title
{
display: inline;
}
/*******************************************************************************
Section
*******************************************************************************/
.section1
{
margin-top: 2.5em;
counter-reset: section2-counter;
counter-increment: section1-counter;
}
.section1:first-of-type
{
margin-top: 1em;
}
.section2, .section3
{
margin-top: 1em;
}
.section2
{
counter-reset: section3-counter;
counter-increment: section2-counter;
}
.section3
{
counter-increment: section3-counter;
}
.section1-header, .section2-header, .section3-header, .page-toc-header
{
margin-top: .5em;
font-weight: 500;
}
.section1-header, .page-toc-header
{
border-radius: 3px;
background-color: #205581;
color: #f2f2f2;
font-size: 22pt;
padding-left: .5em;
margin-bottom: .5em;
}
.section1-number, .section2-number, .section3-number
{
display: inline;
margin-right: .5em;
}
.section1-title, .section2-title, .section3-title
{
display: inline;
}
.section1-subtitle, .section2-subtitle, .section3-subtitle
{
font-weight: bold;
font-size: 16pt;
margin-top: .5em;
}
.section1-subsubtitle, .section2-subsubtitle, .section3-subsubtitle
{
font-style: italic;
font-size: 14pt;
margin-top: 0px;
}
.section1-number:before
{
content: counter(section1-counter);
}
.section1-subtitle
{
font-size: 16pt;
}
.section1-subsubtitle
{
font-size: 14pt;
}
.section2
{
margin-top: 1em;
}
.section2-header
{
border-bottom: 2px #27689d solid;
color: #27689d;
font-size: 16pt;
}
.section2-number:before
{
content: counter(section1-counter) "." counter(section2-counter);
}
.section2-subtitle, .section2-subtitle
{
font-size: 14pt;
}
.section2-subsubtitle, .section3-subsubtitle
{
font-size: 12pt;
}
.section3
{
margin-left: 1em;
margin-top: 1em;
}
.section3:first-of-type
{
border-top: none;
}
.section3-header
{
display: inline;
font-size: 14pt;
color: #27689d;
border-bottom: 1px #27689d solid;
}
.section3-number:before
{
content: counter(section1-counter) "." counter(section2-counter) "." counter(section3-counter);
}
.section-intro
{
margin-top: .75em;
}
/*.section-body*/
/*******************************************************************************
Table Elements
*******************************************************************************/
.table
{
margin-top: .5em;
border-spacing: .5em 0;
}
.table-caption
{
text-align: left;
font-size: 12pt;
font-weight: bold;
color: #27689d;
}
.table-header-row
{
}
.table-header-left,
.table-header-center,
.table-header-right
{
white-space: nowrap;
border-bottom: 1px black solid;
}
.table-header-left
{
text-align: left;
}
.table-header-center
{
text-align: center;
}
.table-header-right
{
text-align: right;
}
.table-header-fill
{
width: 100%;
}
.table-row
{
}
.table-data-left,
.table-data-center,
.table-data-right
{
white-space: nowrap;
}
.table-data-left
{
padding-top: 0px;
text-align: left;
}
.table-data-center
{
text-align: center;
}
.table-data-right
{
text-align: right;
}
/*******************************************************************************
Config, Execute, Code Block, Release Elements
*******************************************************************************/
.section-body-text
{
margin-top: 1em;
}
.section-body-text:first-of-type
{
margin-top: .75em;
}
.execute,
.config,
.code-block
{
/*white-space: nowrap;*/
margin-left: 1em;
margin-right: 1em;
margin-top: .8em;
margin-bottom: 1em;
}
.execute-title,
.config-title
{
font-size: 11pt;
margin-bottom: .125em;
}
.execute-body,
.config-body,
.code-block
{
border-radius: 3px;
background-color: #444444;
font-family: monospace;
unicode-bidi: embed;
color: #f8f8f8;
/*color: white;*/
font-size: 10pt;
}
.execute-body-cmd,
.execute-body-output, .execute-body-output-highlight,
.config-body-title,
.code-block
{
padding-left: .5em;
padding-right: .5em;
}
/* Would rather not use pre at all, but Firefox won't copy code samples correctly without it */
pre
{
margin: 0px;
padding: 0px;
white-space: pre-wrap;
}
.execute-body-cmd:before
{
content: "$ ";
}
.execute-body-cmd:first-of-type, .execute-body-output,
.config-body-title, .config-body-output,
.code-block,
.execute-body-output-highlight, .execute-body-output-highlight-error
{
padding-top: .25em;
}
.execute-body-cmd, .execute-body-output,
.config-body-title, .config-body-output,
.code-block,
.execute-body-output-highlight, .execute-body-output-highlight-error
{
padding-bottom: .25em;
}
.execute-body-output,
.config-body-output,
.code-block
{
border-radius: 3px;
background-color: #606060;
}
.execute-body-output-highlight
{
border-radius: 3px;
background-color: #1e7b1e;
}
.execute-body-output-highlight-error
{
border-radius: 3px;
background-color: #a32929;
}
.execute-body-output, .execute-body-output-highlight, .execute-body-output-highlight-error,
.config-body-output
{
padding-left: 1.75em;
}
/*.code-block*/
/*.section-body-execute-output*/
/*******************************************************************************
Lists
*******************************************************************************/
ul.list-unordered
{
margin-top: .5em;
}
li.list-unordered
{
margin-top: .5em;
}
/*******************************************************************************
Admonition
*******************************************************************************/
.admonition
{
padding-left: 20px;
font-style: italic;
margin: 10px 0px;
}
.admonition>.note, .admonition>.warning, .admonition>.caution, .admonition>.important, .admonition>.tip
{
font-weight: bold;
float: left;
padding-right: 10px;
}
.admonition>.note-text, .admonition>.warning-text, .admonition>.caution-text, .admonition>.important-text, .admonition>.tip-text
{
overflow: hidden;
}
/*******************************************************************************
Keywords
*******************************************************************************/
.backrest, .cmd, .postgres, .host, .proper
{
font-weight: 500;
}
.path, .br-option, .br-setting, .pg-option, .pg-setting, .id, .user, .file, .path
{
unicode-bidi: embed;
font-family: monospace;
white-space: nowrap;
}
/*******************************************************************************
Footer
*******************************************************************************/
.page-footer
{
border-top: 2px #cccccc solid;
margin-top: 1em;
padding-top: .25em;
font-size: x-small;
white-space: nowrap;
text-align: center;
}
pgbackrest-release-2.55.1/doc/resource/html/favicon.png 0000664 0000000 0000000 00000036701 15006170376 0023056 0 ustar 00root root 0000000 0000000 ‰PNG
IHDR szzô pHYs šœ ;®iTXtXML:com.adobe.xmp
Adobe Photoshop CC 2015 (Macintosh)
2016-05-14T16:50:19-04:00
2016-05-14T17:10:09-04:00
2016-05-14T17:10:09-04:00
image/png
3
xmp.iid:d9e4410d-ca59-49b8-8098-ad17fe93c96c
adobe:docid:photoshop:901a563a-5aa6-1179-89fa-991d02f05b6a
xmp.did:c8495a23-30be-496a-b761-dc67c0d8dfe2
created
xmp.iid:c8495a23-30be-496a-b761-dc67c0d8dfe2
2016-05-14T16:50:19-04:00
Adobe Photoshop CC 2015 (Macintosh)
saved
xmp.iid:a2b493b0-578b-4cd4-8b14-7f81bc6b2cb4
2016-05-14T16:59:42-04:00
Adobe Photoshop CC 2015 (Macintosh)
/
saved
xmp.iid:d9e4410d-ca59-49b8-8098-ad17fe93c96c
2016-05-14T17:10:09-04:00
Adobe Photoshop CC 2015 (Macintosh)
/
1
720000/10000
720000/10000
2
65535
32
32
ZÁ‰À cHRM z% €ƒ ùÿ €é u0 ê` :˜ o’_ÅF IDATxÚì—½KÃ@Æ
QŠ:ˆvê¢â".Nââæ$]Ä?@ÄAÐQ\T‚‚³ƒƒ"
~M \ì"Žuñ‡.‘mt¹ƒ#ä’»|Ð%/¼$áž÷yž ïÝ%` cÀðÈC BŽ1
\^ˆ¸L¸f².»@7B8˜]`OÔ¦ŠAàÖB8˜wÀ@)Äe^'_Ï@\æ¦x%Cq™ãaBŽÆÀ,ðüfÐÄ= Ì%)ž îS¼õ£à°ZrÕé:J ^ÙÀªº¥Y¶•b x•ñ†…xCá^ ^ã;A#'¢Žbbø1ï‰]QÛÑàN¥ø’(Ò~(Íúl` ©ÌZ+çËNé¼ `••ËíX¬€/째N™›8ß ëÛp;Àý‹-W 85`Å à 8‹Á´ ÅŸ€sù0 >/PUT
}ifelse
pdfmark_5
}forall
}bdf
/ds{
Adobe_AGM_Utils begin
}bdf
/dt{
currentdict Adobe_AGM_Utils eq{
end
}if
}bdf
systemdict/setpacking known
{setpacking}if
%%EndResource
%%BeginResource: procset Adobe_AGM_Core 2.0 0
%%Version: 2.0 0
%%Copyright: Copyright(C)1997-2007 Adobe Systems, Inc. All Rights Reserved.
systemdict/setpacking known
{
currentpacking
true setpacking
}if
userdict/Adobe_AGM_Core 209 dict dup begin put
/Adobe_AGM_Core_Id/Adobe_AGM_Core_2.0_0 def
/AGMCORE_str256 256 string def
/AGMCORE_save nd
/AGMCORE_graphicsave nd
/AGMCORE_c 0 def
/AGMCORE_m 0 def
/AGMCORE_y 0 def
/AGMCORE_k 0 def
/AGMCORE_cmykbuf 4 array def
/AGMCORE_screen[currentscreen]cvx def
/AGMCORE_tmp 0 def
/AGMCORE_&setgray nd
/AGMCORE_&setcolor nd
/AGMCORE_&setcolorspace nd
/AGMCORE_&setcmykcolor nd
/AGMCORE_cyan_plate nd
/AGMCORE_magenta_plate nd
/AGMCORE_yellow_plate nd
/AGMCORE_black_plate nd
/AGMCORE_plate_ndx nd
/AGMCORE_get_ink_data nd
/AGMCORE_is_cmyk_sep nd
/AGMCORE_host_sep nd
/AGMCORE_avoid_L2_sep_space nd
/AGMCORE_distilling nd
/AGMCORE_composite_job nd
/AGMCORE_producing_seps nd
/AGMCORE_ps_level -1 def
/AGMCORE_ps_version -1 def
/AGMCORE_environ_ok nd
/AGMCORE_CSD_cache 0 dict def
/AGMCORE_currentoverprint false def
/AGMCORE_deltaX nd
/AGMCORE_deltaY nd
/AGMCORE_name nd
/AGMCORE_sep_special nd
/AGMCORE_err_strings 4 dict def
/AGMCORE_cur_err nd
/AGMCORE_current_spot_alias false def
/AGMCORE_inverting false def
/AGMCORE_feature_dictCount nd
/AGMCORE_feature_opCount nd
/AGMCORE_feature_ctm nd
/AGMCORE_ConvertToProcess false def
/AGMCORE_Default_CTM matrix def
/AGMCORE_Default_PageSize nd
/AGMCORE_Default_flatness nd
/AGMCORE_currentbg nd
/AGMCORE_currentucr nd
/AGMCORE_pattern_paint_type 0 def
/knockout_unitsq nd
currentglobal true setglobal
[/CSA/Gradient/Procedure]
{
/Generic/Category findresource dup length dict copy/Category defineresource pop
}forall
setglobal
/AGMCORE_key_known
{
where{
/Adobe_AGM_Core_Id known
}{
false
}ifelse
}ndf
/flushinput
{
save
2 dict begin
/CompareBuffer 3 -1 roll def
/readbuffer 256 string def
mark
{
currentfile readbuffer{readline}stopped
{cleartomark mark}
{
not
{pop exit}
if
CompareBuffer eq
{exit}
if
}ifelse
}loop
cleartomark
end
restore
}bdf
/getspotfunction
{
AGMCORE_screen exch pop exch pop
dup type/dicttype eq{
dup/HalftoneType get 1 eq{
/SpotFunction get
}{
dup/HalftoneType get 2 eq{
/GraySpotFunction get
}{
pop
{
abs exch abs 2 copy add 1 gt{
1 sub dup mul exch 1 sub dup mul add 1 sub
}{
dup mul exch dup mul add 1 exch sub
}ifelse
}bind
}ifelse
}ifelse
}if
}def
/np
{newpath}bdf
/clp_npth
{clip np}def
/eoclp_npth
{eoclip np}def
/npth_clp
{np clip}def
/graphic_setup
{
/AGMCORE_graphicsave save store
concat
0 setgray
0 setlinecap
0 setlinejoin
1 setlinewidth
[]0 setdash
10 setmiterlimit
np
false setoverprint
false setstrokeadjust
//Adobe_AGM_Core/spot_alias gx
/Adobe_AGM_Image where{
pop
Adobe_AGM_Image/spot_alias 2 copy known{
gx
}{
pop pop
}ifelse
}if
/sep_colorspace_dict null AGMCORE_gput
100 dict begin
/dictstackcount countdictstack def
/showpage{}def
mark
}def
/graphic_cleanup
{
cleartomark
dictstackcount 1 countdictstack 1 sub{end}for
end
AGMCORE_graphicsave restore
}def
/compose_error_msg
{
grestoreall initgraphics
/Helvetica findfont 10 scalefont setfont
/AGMCORE_deltaY 100 def
/AGMCORE_deltaX 310 def
clippath pathbbox np pop pop 36 add exch 36 add exch moveto
0 AGMCORE_deltaY rlineto AGMCORE_deltaX 0 rlineto
0 AGMCORE_deltaY neg rlineto AGMCORE_deltaX neg 0 rlineto closepath
0 AGMCORE_&setgray
gsave 1 AGMCORE_&setgray fill grestore
1 setlinewidth gsave stroke grestore
currentpoint AGMCORE_deltaY 15 sub add exch 8 add exch moveto
/AGMCORE_deltaY 12 def
/AGMCORE_tmp 0 def
AGMCORE_err_strings exch get
{
dup 32 eq
{
pop
AGMCORE_str256 0 AGMCORE_tmp getinterval
stringwidth pop currentpoint pop add AGMCORE_deltaX 28 add gt
{
currentpoint AGMCORE_deltaY sub exch pop
clippath pathbbox pop pop pop 44 add exch moveto
}if
AGMCORE_str256 0 AGMCORE_tmp getinterval show( )show
0 1 AGMCORE_str256 length 1 sub
{
AGMCORE_str256 exch 0 put
}for
/AGMCORE_tmp 0 def
}{
AGMCORE_str256 exch AGMCORE_tmp xpt
/AGMCORE_tmp AGMCORE_tmp 1 add def
}ifelse
}forall
}bdf
/AGMCORE_CMYKDeviceNColorspaces[
[/Separation/None/DeviceCMYK{0 0 0}]
[/Separation(Black)/DeviceCMYK{0 0 0 4 -1 roll}bind]
[/Separation(Yellow)/DeviceCMYK{0 0 3 -1 roll 0}bind]
[/DeviceN[(Yellow)(Black)]/DeviceCMYK{0 0 4 2 roll}bind]
[/Separation(Magenta)/DeviceCMYK{0 exch 0 0}bind]
[/DeviceN[(Magenta)(Black)]/DeviceCMYK{0 3 1 roll 0 exch}bind]
[/DeviceN[(Magenta)(Yellow)]/DeviceCMYK{0 3 1 roll 0}bind]
[/DeviceN[(Magenta)(Yellow)(Black)]/DeviceCMYK{0 4 1 roll}bind]
[/Separation(Cyan)/DeviceCMYK{0 0 0}]
[/DeviceN[(Cyan)(Black)]/DeviceCMYK{0 0 3 -1 roll}bind]
[/DeviceN[(Cyan)(Yellow)]/DeviceCMYK{0 exch 0}bind]
[/DeviceN[(Cyan)(Yellow)(Black)]/DeviceCMYK{0 3 1 roll}bind]
[/DeviceN[(Cyan)(Magenta)]/DeviceCMYK{0 0}]
[/DeviceN[(Cyan)(Magenta)(Black)]/DeviceCMYK{0 exch}bind]
[/DeviceN[(Cyan)(Magenta)(Yellow)]/DeviceCMYK{0}]
[/DeviceCMYK]
]def
/ds{
Adobe_AGM_Core begin
/currentdistillerparams where
{
pop currentdistillerparams/CoreDistVersion get 5000 lt
{<>setdistillerparams}if
}if
/AGMCORE_ps_version xdf
/AGMCORE_ps_level xdf
errordict/AGM_handleerror known not{
errordict/AGM_handleerror errordict/handleerror get put
errordict/handleerror{
Adobe_AGM_Core begin
$error/newerror get AGMCORE_cur_err null ne and{
$error/newerror false put
AGMCORE_cur_err compose_error_msg
}if
$error/newerror true put
end
errordict/AGM_handleerror get exec
}bind put
}if
/AGMCORE_environ_ok
ps_level AGMCORE_ps_level ge
ps_version AGMCORE_ps_version ge and
AGMCORE_ps_level -1 eq or
def
AGMCORE_environ_ok not
{/AGMCORE_cur_err/AGMCORE_bad_environ def}if
/AGMCORE_&setgray systemdict/setgray get def
level2{
/AGMCORE_&setcolor systemdict/setcolor get def
/AGMCORE_&setcolorspace systemdict/setcolorspace get def
}if
/AGMCORE_currentbg currentblackgeneration def
/AGMCORE_currentucr currentundercolorremoval def
/AGMCORE_Default_flatness currentflat def
/AGMCORE_distilling
/product where{
pop systemdict/setdistillerparams known product(Adobe PostScript Parser)ne and
}{
false
}ifelse
def
/AGMCORE_GSTATE AGMCORE_key_known not{
/AGMCORE_GSTATE 21 dict def
/AGMCORE_tmpmatrix matrix def
/AGMCORE_gstack 32 array def
/AGMCORE_gstackptr 0 def
/AGMCORE_gstacksaveptr 0 def
/AGMCORE_gstackframekeys 14 def
/AGMCORE_&gsave/gsave ldf
/AGMCORE_&grestore/grestore ldf
/AGMCORE_&grestoreall/grestoreall ldf
/AGMCORE_&save/save ldf
/AGMCORE_&setoverprint/setoverprint ldf
/AGMCORE_gdictcopy{
begin
{def}forall
end
}def
/AGMCORE_gput{
AGMCORE_gstack AGMCORE_gstackptr get
3 1 roll
put
}def
/AGMCORE_gget{
AGMCORE_gstack AGMCORE_gstackptr get
exch
get
}def
/gsave{
AGMCORE_&gsave
AGMCORE_gstack AGMCORE_gstackptr get
AGMCORE_gstackptr 1 add
dup 32 ge{limitcheck}if
/AGMCORE_gstackptr exch store
AGMCORE_gstack AGMCORE_gstackptr get
AGMCORE_gdictcopy
}def
/grestore{
AGMCORE_&grestore
AGMCORE_gstackptr 1 sub
dup AGMCORE_gstacksaveptr lt{1 add}if
dup AGMCORE_gstack exch get dup/AGMCORE_currentoverprint known
{/AGMCORE_currentoverprint get setoverprint}{pop}ifelse
/AGMCORE_gstackptr exch store
}def
/grestoreall{
AGMCORE_&grestoreall
/AGMCORE_gstackptr AGMCORE_gstacksaveptr store
}def
/save{
AGMCORE_&save
AGMCORE_gstack AGMCORE_gstackptr get
AGMCORE_gstackptr 1 add
dup 32 ge{limitcheck}if
/AGMCORE_gstackptr exch store
/AGMCORE_gstacksaveptr AGMCORE_gstackptr store
AGMCORE_gstack AGMCORE_gstackptr get
AGMCORE_gdictcopy
}def
/setoverprint{
dup/AGMCORE_currentoverprint exch AGMCORE_gput AGMCORE_&setoverprint
}def
0 1 AGMCORE_gstack length 1 sub{
AGMCORE_gstack exch AGMCORE_gstackframekeys dict put
}for
}if
level3/AGMCORE_&sysshfill AGMCORE_key_known not and
{
/AGMCORE_&sysshfill systemdict/shfill get def
/AGMCORE_&sysmakepattern systemdict/makepattern get def
/AGMCORE_&usrmakepattern/makepattern load def
}if
/currentcmykcolor[0 0 0 0]AGMCORE_gput
/currentstrokeadjust false AGMCORE_gput
/currentcolorspace[/DeviceGray]AGMCORE_gput
/sep_tint 0 AGMCORE_gput
/devicen_tints[0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0]AGMCORE_gput
/sep_colorspace_dict null AGMCORE_gput
/devicen_colorspace_dict null AGMCORE_gput
/indexed_colorspace_dict null AGMCORE_gput
/currentcolor_intent()AGMCORE_gput
/customcolor_tint 1 AGMCORE_gput
/absolute_colorimetric_crd null AGMCORE_gput
/relative_colorimetric_crd null AGMCORE_gput
/saturation_crd null AGMCORE_gput
/perceptual_crd null AGMCORE_gput
currentcolortransfer cvlit/AGMCore_gray_xfer xdf cvlit/AGMCore_b_xfer xdf
cvlit/AGMCore_g_xfer xdf cvlit/AGMCore_r_xfer xdf
<<
/MaxPatternItem currentsystemparams/MaxPatternCache get
>>
setuserparams
end
}def
/ps
{
/setcmykcolor where{
pop
Adobe_AGM_Core/AGMCORE_&setcmykcolor/setcmykcolor load put
}if
Adobe_AGM_Core begin
/setcmykcolor
{
4 copy AGMCORE_cmykbuf astore/currentcmykcolor exch AGMCORE_gput
1 sub 4 1 roll
3{
3 index add neg dup 0 lt{
pop 0
}if
3 1 roll
}repeat
setrgbcolor pop
}ndf
/currentcmykcolor
{
/currentcmykcolor AGMCORE_gget aload pop
}ndf
/setoverprint
{pop}ndf
/currentoverprint
{false}ndf
/AGMCORE_cyan_plate 1 0 0 0 test_cmyk_color_plate def
/AGMCORE_magenta_plate 0 1 0 0 test_cmyk_color_plate def
/AGMCORE_yellow_plate 0 0 1 0 test_cmyk_color_plate def
/AGMCORE_black_plate 0 0 0 1 test_cmyk_color_plate def
/AGMCORE_plate_ndx
AGMCORE_cyan_plate{
0
}{
AGMCORE_magenta_plate{
1
}{
AGMCORE_yellow_plate{
2
}{
AGMCORE_black_plate{
3
}{
4
}ifelse
}ifelse
}ifelse
}ifelse
def
/AGMCORE_have_reported_unsupported_color_space false def
/AGMCORE_report_unsupported_color_space
{
AGMCORE_have_reported_unsupported_color_space false eq
{
(Warning: Job contains content that cannot be separated with on-host methods. This content appears on the black plate, and knocks out all other plates.)==
Adobe_AGM_Core/AGMCORE_have_reported_unsupported_color_space true ddf
}if
}def
/AGMCORE_composite_job
AGMCORE_cyan_plate AGMCORE_magenta_plate and AGMCORE_yellow_plate and AGMCORE_black_plate and def
/AGMCORE_in_rip_sep
/AGMCORE_in_rip_sep where{
pop AGMCORE_in_rip_sep
}{
AGMCORE_distilling
{
false
}{
userdict/Adobe_AGM_OnHost_Seps known{
false
}{
level2{
currentpagedevice/Separations 2 copy known{
get
}{
pop pop false
}ifelse
}{
false
}ifelse
}ifelse
}ifelse
}ifelse
def
/AGMCORE_producing_seps AGMCORE_composite_job not AGMCORE_in_rip_sep or def
/AGMCORE_host_sep AGMCORE_producing_seps AGMCORE_in_rip_sep not and def
/AGM_preserve_spots
/AGM_preserve_spots where{
pop AGM_preserve_spots
}{
AGMCORE_distilling AGMCORE_producing_seps or
}ifelse
def
/AGM_is_distiller_preserving_spotimages
{
currentdistillerparams/PreserveOverprintSettings known
{
currentdistillerparams/PreserveOverprintSettings get
{
currentdistillerparams/ColorConversionStrategy known
{
currentdistillerparams/ColorConversionStrategy get
/sRGB ne
}{
true
}ifelse
}{
false
}ifelse
}{
false
}ifelse
}def
/convert_spot_to_process where{pop}{
/convert_spot_to_process
{
//Adobe_AGM_Core begin
dup map_alias{
/Name get exch pop
}if
dup dup(None)eq exch(All)eq or
{
pop false
}{
AGMCORE_host_sep
{
gsave
1 0 0 0 setcmykcolor currentgray 1 exch sub
0 1 0 0 setcmykcolor currentgray 1 exch sub
0 0 1 0 setcmykcolor currentgray 1 exch sub
0 0 0 1 setcmykcolor currentgray 1 exch sub
add add add 0 eq
{
pop false
}{
false setoverprint
current_spot_alias false set_spot_alias
1 1 1 1 6 -1 roll findcmykcustomcolor 1 setcustomcolor
set_spot_alias
currentgray 1 ne
}ifelse
grestore
}{
AGMCORE_distilling
{
pop AGM_is_distiller_preserving_spotimages not
}{
//Adobe_AGM_Core/AGMCORE_name xddf
false
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 0 eq
AGMUTIL_cpd/OverrideSeparations known and
{
AGMUTIL_cpd/OverrideSeparations get
{
/HqnSpots/ProcSet resourcestatus
{
pop pop pop true
}if
}if
}if
{
AGMCORE_name/HqnSpots/ProcSet findresource/TestSpot gx not
}{
gsave
[/Separation AGMCORE_name/DeviceGray{}]AGMCORE_&setcolorspace
false
AGMUTIL_cpd/SeparationColorNames 2 copy known
{
get
{AGMCORE_name eq or}forall
not
}{
pop pop pop true
}ifelse
grestore
}ifelse
}ifelse
}ifelse
}ifelse
end
}def
}ifelse
/convert_to_process where{pop}{
/convert_to_process
{
dup length 0 eq
{
pop false
}{
AGMCORE_host_sep
{
dup true exch
{
dup(Cyan)eq exch
dup(Magenta)eq 3 -1 roll or exch
dup(Yellow)eq 3 -1 roll or exch
dup(Black)eq 3 -1 roll or
{pop}
{convert_spot_to_process and}ifelse
}
forall
{
true exch
{
dup(Cyan)eq exch
dup(Magenta)eq 3 -1 roll or exch
dup(Yellow)eq 3 -1 roll or exch
(Black)eq or and
}forall
not
}{pop false}ifelse
}{
false exch
{
/PhotoshopDuotoneList where{pop false}{true}ifelse
{
dup(Cyan)eq exch
dup(Magenta)eq 3 -1 roll or exch
dup(Yellow)eq 3 -1 roll or exch
dup(Black)eq 3 -1 roll or
{pop}
{convert_spot_to_process or}ifelse
}
{
convert_spot_to_process or
}
ifelse
}
forall
}ifelse
}ifelse
}def
}ifelse
/AGMCORE_avoid_L2_sep_space
version cvr 2012 lt
level2 and
AGMCORE_producing_seps not and
def
/AGMCORE_is_cmyk_sep
AGMCORE_cyan_plate AGMCORE_magenta_plate or AGMCORE_yellow_plate or AGMCORE_black_plate or
def
/AGM_avoid_0_cmyk where{
pop AGM_avoid_0_cmyk
}{
AGM_preserve_spots
userdict/Adobe_AGM_OnHost_Seps known
userdict/Adobe_AGM_InRip_Seps known or
not and
}ifelse
{
/setcmykcolor[
{
4 copy add add add 0 eq currentoverprint and{
pop 0.0005
}if
}/exec cvx
/AGMCORE_&setcmykcolor load dup type/operatortype ne{
/exec cvx
}if
]cvx def
}if
/AGMCORE_IsSeparationAProcessColor
{
dup(Cyan)eq exch dup(Magenta)eq exch dup(Yellow)eq exch(Black)eq or or or
}def
AGMCORE_host_sep{
/setcolortransfer
{
AGMCORE_cyan_plate{
pop pop pop
}{
AGMCORE_magenta_plate{
4 3 roll pop pop pop
}{
AGMCORE_yellow_plate{
4 2 roll pop pop pop
}{
4 1 roll pop pop pop
}ifelse
}ifelse
}ifelse
settransfer
}
def
/AGMCORE_get_ink_data
AGMCORE_cyan_plate{
{pop pop pop}
}{
AGMCORE_magenta_plate{
{4 3 roll pop pop pop}
}{
AGMCORE_yellow_plate{
{4 2 roll pop pop pop}
}{
{4 1 roll pop pop pop}
}ifelse
}ifelse
}ifelse
def
/AGMCORE_RemoveProcessColorNames
{
1 dict begin
/filtername
{
dup/Cyan eq 1 index(Cyan)eq or
{pop(_cyan_)}if
dup/Magenta eq 1 index(Magenta)eq or
{pop(_magenta_)}if
dup/Yellow eq 1 index(Yellow)eq or
{pop(_yellow_)}if
dup/Black eq 1 index(Black)eq or
{pop(_black_)}if
}def
dup type/arraytype eq
{[exch{filtername}forall]}
{filtername}ifelse
end
}def
level3{
/AGMCORE_IsCurrentColor
{
dup AGMCORE_IsSeparationAProcessColor
{
AGMCORE_plate_ndx 0 eq
{dup(Cyan)eq exch/Cyan eq or}if
AGMCORE_plate_ndx 1 eq
{dup(Magenta)eq exch/Magenta eq or}if
AGMCORE_plate_ndx 2 eq
{dup(Yellow)eq exch/Yellow eq or}if
AGMCORE_plate_ndx 3 eq
{dup(Black)eq exch/Black eq or}if
AGMCORE_plate_ndx 4 eq
{pop false}if
}{
gsave
false setoverprint
current_spot_alias false set_spot_alias
1 1 1 1 6 -1 roll findcmykcustomcolor 1 setcustomcolor
set_spot_alias
currentgray 1 ne
grestore
}ifelse
}def
/AGMCORE_filter_functiondatasource
{
5 dict begin
/data_in xdf
data_in type/stringtype eq
{
/ncomp xdf
/comp xdf
/string_out data_in length ncomp idiv string def
0 ncomp data_in length 1 sub
{
string_out exch dup ncomp idiv exch data_in exch ncomp getinterval comp get 255 exch sub put
}for
string_out
}{
string/string_in xdf
/string_out 1 string def
/component xdf
[
data_in string_in/readstring cvx
[component/get cvx 255/exch cvx/sub cvx string_out/exch cvx 0/exch cvx/put cvx string_out]cvx
[/pop cvx()]cvx/ifelse cvx
]cvx/ReusableStreamDecode filter
}ifelse
end
}def
/AGMCORE_separateShadingFunction
{
2 dict begin
/paint? xdf
/channel xdf
dup type/dicttype eq
{
begin
FunctionType 0 eq
{
/DataSource channel Range length 2 idiv DataSource AGMCORE_filter_functiondatasource def
currentdict/Decode known
{/Decode Decode channel 2 mul 2 getinterval def}if
paint? not
{/Decode[1 1]def}if
}if
FunctionType 2 eq
{
paint?
{
/C0[C0 channel get 1 exch sub]def
/C1[C1 channel get 1 exch sub]def
}{
/C0[1]def
/C1[1]def
}ifelse
}if
FunctionType 3 eq
{
/Functions[Functions{channel paint? AGMCORE_separateShadingFunction}forall]def
}if
currentdict/Range known
{/Range[0 1]def}if
currentdict
end}{
channel get 0 paint? AGMCORE_separateShadingFunction
}ifelse
end
}def
/AGMCORE_separateShading
{
3 -1 roll begin
currentdict/Function known
{
currentdict/Background known
{[1 index{Background 3 index get 1 exch sub}{1}ifelse]/Background xdf}if
Function 3 1 roll AGMCORE_separateShadingFunction/Function xdf
/ColorSpace[/DeviceGray]def
}{
ColorSpace dup type/arraytype eq{0 get}if/DeviceCMYK eq
{
/ColorSpace[/DeviceN[/_cyan_/_magenta_/_yellow_/_black_]/DeviceCMYK{}]def
}{
ColorSpace dup 1 get AGMCORE_RemoveProcessColorNames 1 exch put
}ifelse
ColorSpace 0 get/Separation eq
{
{
[1/exch cvx/sub cvx]cvx
}{
[/pop cvx 1]cvx
}ifelse
ColorSpace 3 3 -1 roll put
pop
}{
{
[exch ColorSpace 1 get length 1 sub exch sub/index cvx 1/exch cvx/sub cvx ColorSpace 1 get length 1 add 1/roll cvx ColorSpace 1 get length{/pop cvx}repeat]cvx
}{
pop[ColorSpace 1 get length{/pop cvx}repeat cvx 1]cvx
}ifelse
ColorSpace 3 3 -1 roll bind put
}ifelse
ColorSpace 2/DeviceGray put
}ifelse
end
}def
/AGMCORE_separateShadingDict
{
dup/ColorSpace get
dup type/arraytype ne
{[exch]}if
dup 0 get/DeviceCMYK eq
{
exch begin
currentdict
AGMCORE_cyan_plate
{0 true}if
AGMCORE_magenta_plate
{1 true}if
AGMCORE_yellow_plate
{2 true}if
AGMCORE_black_plate
{3 true}if
AGMCORE_plate_ndx 4 eq
{0 false}if
dup not currentoverprint and
{/AGMCORE_ignoreshade true def}if
AGMCORE_separateShading
currentdict
end exch
}if
dup 0 get/Separation eq
{
exch begin
ColorSpace 1 get dup/None ne exch/All ne and
{
ColorSpace 1 get AGMCORE_IsCurrentColor AGMCORE_plate_ndx 4 lt and ColorSpace 1 get AGMCORE_IsSeparationAProcessColor not and
{
ColorSpace 2 get dup type/arraytype eq{0 get}if/DeviceCMYK eq
{
/ColorSpace
[
/Separation
ColorSpace 1 get
/DeviceGray
[
ColorSpace 3 get/exec cvx
4 AGMCORE_plate_ndx sub -1/roll cvx
4 1/roll cvx
3[/pop cvx]cvx/repeat cvx
1/exch cvx/sub cvx
]cvx
]def
}{
AGMCORE_report_unsupported_color_space
AGMCORE_black_plate not
{
currentdict 0 false AGMCORE_separateShading
}if
}ifelse
}{
currentdict ColorSpace 1 get AGMCORE_IsCurrentColor
0 exch
dup not currentoverprint and
{/AGMCORE_ignoreshade true def}if
AGMCORE_separateShading
}ifelse
}if
currentdict
end exch
}if
dup 0 get/DeviceN eq
{
exch begin
ColorSpace 1 get convert_to_process
{
ColorSpace 2 get dup type/arraytype eq{0 get}if/DeviceCMYK eq
{
/ColorSpace
[
/DeviceN
ColorSpace 1 get
/DeviceGray
[
ColorSpace 3 get/exec cvx
4 AGMCORE_plate_ndx sub -1/roll cvx
4 1/roll cvx
3[/pop cvx]cvx/repeat cvx
1/exch cvx/sub cvx
]cvx
]def
}{
AGMCORE_report_unsupported_color_space
AGMCORE_black_plate not
{
currentdict 0 false AGMCORE_separateShading
/ColorSpace[/DeviceGray]def
}if
}ifelse
}{
currentdict
false -1 ColorSpace 1 get
{
AGMCORE_IsCurrentColor
{
1 add
exch pop true exch exit
}if
1 add
}forall
exch
dup not currentoverprint and
{/AGMCORE_ignoreshade true def}if
AGMCORE_separateShading
}ifelse
currentdict
end exch
}if
dup 0 get dup/DeviceCMYK eq exch dup/Separation eq exch/DeviceN eq or or not
{
exch begin
ColorSpace dup type/arraytype eq
{0 get}if
/DeviceGray ne
{
AGMCORE_report_unsupported_color_space
AGMCORE_black_plate not
{
ColorSpace 0 get/CIEBasedA eq
{
/ColorSpace[/Separation/_ciebaseda_/DeviceGray{}]def
}if
ColorSpace 0 get dup/CIEBasedABC eq exch dup/CIEBasedDEF eq exch/DeviceRGB eq or or
{
/ColorSpace[/DeviceN[/_red_/_green_/_blue_]/DeviceRGB{}]def
}if
ColorSpace 0 get/CIEBasedDEFG eq
{
/ColorSpace[/DeviceN[/_cyan_/_magenta_/_yellow_/_black_]/DeviceCMYK{}]def
}if
currentdict 0 false AGMCORE_separateShading
}if
}if
currentdict
end exch
}if
pop
dup/AGMCORE_ignoreshade known
{
begin
/ColorSpace[/Separation(None)/DeviceGray{}]def
currentdict end
}if
}def
/shfill
{
AGMCORE_separateShadingDict
dup/AGMCORE_ignoreshade known
{pop}
{AGMCORE_&sysshfill}ifelse
}def
/makepattern
{
exch
dup/PatternType get 2 eq
{
clonedict
begin
/Shading Shading AGMCORE_separateShadingDict def
Shading/AGMCORE_ignoreshade known
currentdict end exch
{pop<>}if
exch AGMCORE_&sysmakepattern
}{
exch AGMCORE_&usrmakepattern
}ifelse
}def
}if
}if
AGMCORE_in_rip_sep{
/setcustomcolor
{
exch aload pop
dup 7 1 roll inRip_spot_has_ink not {
4{4 index mul 4 1 roll}
repeat
/DeviceCMYK setcolorspace
6 -2 roll pop pop
}{
//Adobe_AGM_Core begin
/AGMCORE_k xdf/AGMCORE_y xdf/AGMCORE_m xdf/AGMCORE_c xdf
end
[/Separation 4 -1 roll/DeviceCMYK
{dup AGMCORE_c mul exch dup AGMCORE_m mul exch dup AGMCORE_y mul exch AGMCORE_k mul}
]
setcolorspace
}ifelse
setcolor
}ndf
/setseparationgray
{
[/Separation(All)/DeviceGray{}]setcolorspace_opt
1 exch sub setcolor
}ndf
}{
/setseparationgray
{
AGMCORE_&setgray
}ndf
}ifelse
/findcmykcustomcolor
{
5 makereadonlyarray
}ndf
/setcustomcolor
{
exch aload pop pop
4{4 index mul 4 1 roll}repeat
setcmykcolor pop
}ndf
/has_color
/colorimage where{
AGMCORE_producing_seps{
pop true
}{
systemdict eq
}ifelse
}{
false
}ifelse
def
/map_index
{
1 index mul exch getinterval{255 div}forall
}bdf
/map_indexed_devn
{
Lookup Names length 3 -1 roll cvi map_index
}bdf
/n_color_components
{
base_colorspace_type
dup/DeviceGray eq{
pop 1
}{
/DeviceCMYK eq{
4
}{
3
}ifelse
}ifelse
}bdf
level2{
/mo/moveto ldf
/li/lineto ldf
/cv/curveto ldf
/knockout_unitsq
{
1 setgray
0 0 1 1 rectfill
}def
level2/setcolorspace AGMCORE_key_known not and{
/AGMCORE_&&&setcolorspace/setcolorspace ldf
/AGMCORE_ReplaceMappedColor
{
dup type dup/arraytype eq exch/packedarraytype eq or
{
/AGMCORE_SpotAliasAry2 where{
begin
dup 0 get dup/Separation eq
{
pop
dup length array copy
dup dup 1 get
current_spot_alias
{
dup map_alias
{
false set_spot_alias
dup 1 exch setsepcolorspace
true set_spot_alias
begin
/sep_colorspace_dict currentdict AGMCORE_gput
pop pop pop
[
/Separation Name
CSA map_csa
MappedCSA
/sep_colorspace_proc load
]
dup Name
end
}if
}if
map_reserved_ink_name 1 xpt
}{
/DeviceN eq
{
dup length array copy
dup dup 1 get[
exch{
current_spot_alias{
dup map_alias{
/Name get exch pop
}if
}if
map_reserved_ink_name
}forall
]1 xpt
}if
}ifelse
end
}if
}if
}def
/setcolorspace
{
dup type dup/arraytype eq exch/packedarraytype eq or
{
dup 0 get/Indexed eq
{
AGMCORE_distilling
{
/PhotoshopDuotoneList where
{
pop false
}{
true
}ifelse
}{
true
}ifelse
{
aload pop 3 -1 roll
AGMCORE_ReplaceMappedColor
3 1 roll 4 array astore
}if
}{
AGMCORE_ReplaceMappedColor
}ifelse
}if
DeviceN_PS2_inRip_seps{AGMCORE_&&&setcolorspace}if
}def
}if
}{
/adj
{
currentstrokeadjust{
transform
0.25 sub round 0.25 add exch
0.25 sub round 0.25 add exch
itransform
}if
}def
/mo{
adj moveto
}def
/li{
adj lineto
}def
/cv{
6 2 roll adj
6 2 roll adj
6 2 roll adj curveto
}def
/knockout_unitsq
{
1 setgray
8 8 1[8 0 0 8 0 0]{}image
}def
/currentstrokeadjust{
/currentstrokeadjust AGMCORE_gget
}def
/setstrokeadjust{
/currentstrokeadjust exch AGMCORE_gput
}def
/setcolorspace
{
/currentcolorspace exch AGMCORE_gput
}def
/currentcolorspace
{
/currentcolorspace AGMCORE_gget
}def
/setcolor_devicecolor
{
base_colorspace_type
dup/DeviceGray eq{
pop setgray
}{
/DeviceCMYK eq{
setcmykcolor
}{
setrgbcolor
}ifelse
}ifelse
}def
/setcolor
{
currentcolorspace 0 get
dup/DeviceGray ne{
dup/DeviceCMYK ne{
dup/DeviceRGB ne{
dup/Separation eq{
pop
currentcolorspace 3 gx
currentcolorspace 2 get
}{
dup/Indexed eq{
pop
currentcolorspace 3 get dup type/stringtype eq{
currentcolorspace 1 get n_color_components
3 -1 roll map_index
}{
exec
}ifelse
currentcolorspace 1 get
}{
/AGMCORE_cur_err/AGMCORE_invalid_color_space def
AGMCORE_invalid_color_space
}ifelse
}ifelse
}if
}if
}if
setcolor_devicecolor
}def
}ifelse
/sop/setoverprint ldf
/lw/setlinewidth ldf
/lc/setlinecap ldf
/lj/setlinejoin ldf
/ml/setmiterlimit ldf
/dsh/setdash ldf
/sadj/setstrokeadjust ldf
/gry/setgray ldf
/rgb/setrgbcolor ldf
/cmyk[
/currentcolorspace[/DeviceCMYK]/AGMCORE_gput cvx
/setcmykcolor load dup type/operatortype ne{/exec cvx}if
]cvx bdf
level3 AGMCORE_host_sep not and{
/nzopmsc{
6 dict begin
/kk exch def
/yy exch def
/mm exch def
/cc exch def
/sum 0 def
cc 0 ne{/sum sum 2#1000 or def cc}if
mm 0 ne{/sum sum 2#0100 or def mm}if
yy 0 ne{/sum sum 2#0010 or def yy}if
kk 0 ne{/sum sum 2#0001 or def kk}if
AGMCORE_CMYKDeviceNColorspaces sum get setcolorspace
sum 0 eq{0}if
end
setcolor
}bdf
}{
/nzopmsc/cmyk ldf
}ifelse
/sep/setsepcolor ldf
/devn/setdevicencolor ldf
/idx/setindexedcolor ldf
/colr/setcolor ldf
/csacrd/set_csa_crd ldf
/sepcs/setsepcolorspace ldf
/devncs/setdevicencolorspace ldf
/idxcs/setindexedcolorspace ldf
/cp/closepath ldf
/clp/clp_npth ldf
/eclp/eoclp_npth ldf
/f/fill ldf
/ef/eofill ldf
/@/stroke ldf
/nclp/npth_clp ldf
/gset/graphic_setup ldf
/gcln/graphic_cleanup ldf
/ct/concat ldf
/cf/currentfile ldf
/fl/filter ldf
/rs/readstring ldf
/AGMCORE_def_ht currenthalftone def
/clonedict Adobe_AGM_Utils begin/clonedict load end def
/clonearray Adobe_AGM_Utils begin/clonearray load end def
currentdict{
dup xcheck 1 index type dup/arraytype eq exch/packedarraytype eq or and{
bind
}if
def
}forall
/getrampcolor
{
/indx exch def
0 1 NumComp 1 sub
{
dup
Samples exch get
dup type/stringtype eq{indx get}if
exch
Scaling exch get aload pop
3 1 roll
mul add
}for
ColorSpaceFamily/Separation eq
{sep}
{
ColorSpaceFamily/DeviceN eq
{devn}{setcolor}ifelse
}ifelse
}bdf
/sssetbackground{
aload pop
ColorSpaceFamily/Separation eq
{sep}
{
ColorSpaceFamily/DeviceN eq
{devn}{setcolor}ifelse
}ifelse
}bdf
/RadialShade
{
40 dict begin
/ColorSpaceFamily xdf
/background xdf
/ext1 xdf
/ext0 xdf
/BBox xdf
/r2 xdf
/c2y xdf
/c2x xdf
/r1 xdf
/c1y xdf
/c1x xdf
/rampdict xdf
/setinkoverprint where{pop/setinkoverprint{pop}def}if
gsave
BBox length 0 gt
{
np
BBox 0 get BBox 1 get moveto
BBox 2 get BBox 0 get sub 0 rlineto
0 BBox 3 get BBox 1 get sub rlineto
BBox 2 get BBox 0 get sub neg 0 rlineto
closepath
clip
np
}if
c1x c2x eq
{
c1y c2y lt{/theta 90 def}{/theta 270 def}ifelse
}{
/slope c2y c1y sub c2x c1x sub div def
/theta slope 1 atan def
c2x c1x lt c2y c1y ge and{/theta theta 180 sub def}if
c2x c1x lt c2y c1y lt and{/theta theta 180 add def}if
}ifelse
gsave
clippath
c1x c1y translate
theta rotate
-90 rotate
{pathbbox}stopped
{0 0 0 0}if
/yMax xdf
/xMax xdf
/yMin xdf
/xMin xdf
grestore
xMax xMin eq yMax yMin eq or
{
grestore
end
}{
/max{2 copy gt{pop}{exch pop}ifelse}bdf
/min{2 copy lt{pop}{exch pop}ifelse}bdf
rampdict begin
40 dict begin
background length 0 gt{background sssetbackground gsave clippath fill grestore}if
gsave
c1x c1y translate
theta rotate
-90 rotate
/c2y c1x c2x sub dup mul c1y c2y sub dup mul add sqrt def
/c1y 0 def
/c1x 0 def
/c2x 0 def
ext0
{
0 getrampcolor
c2y r2 add r1 sub 0.0001 lt
{
c1x c1y r1 360 0 arcn
pathbbox
/aymax exch def
/axmax exch def
/aymin exch def
/axmin exch def
/bxMin xMin axmin min def
/byMin yMin aymin min def
/bxMax xMax axmax max def
/byMax yMax aymax max def
bxMin byMin moveto
bxMax byMin lineto
bxMax byMax lineto
bxMin byMax lineto
bxMin byMin lineto
eofill
}{
c2y r1 add r2 le
{
c1x c1y r1 0 360 arc
fill
}
{
c2x c2y r2 0 360 arc fill
r1 r2 eq
{
/p1x r1 neg def
/p1y c1y def
/p2x r1 def
/p2y c1y def
p1x p1y moveto p2x p2y lineto p2x yMin lineto p1x yMin lineto
fill
}{
/AA r2 r1 sub c2y div def
AA -1 eq
{/theta 89.99 def}
{/theta AA 1 AA dup mul sub sqrt div 1 atan def}
ifelse
/SS1 90 theta add dup sin exch cos div def
/p1x r1 SS1 SS1 mul SS1 SS1 mul 1 add div sqrt mul neg def
/p1y p1x SS1 div neg def
/SS2 90 theta sub dup sin exch cos div def
/p2x r1 SS2 SS2 mul SS2 SS2 mul 1 add div sqrt mul def
/p2y p2x SS2 div neg def
r1 r2 gt
{
/L1maxX p1x yMin p1y sub SS1 div add def
/L2maxX p2x yMin p2y sub SS2 div add def
}{
/L1maxX 0 def
/L2maxX 0 def
}ifelse
p1x p1y moveto p2x p2y lineto L2maxX L2maxX p2x sub SS2 mul p2y add lineto
L1maxX L1maxX p1x sub SS1 mul p1y add lineto
fill
}ifelse
}ifelse
}ifelse
}if
c1x c2x sub dup mul
c1y c2y sub dup mul
add 0.5 exp
0 dtransform
dup mul exch dup mul add 0.5 exp 72 div
0 72 matrix defaultmatrix dtransform dup mul exch dup mul add sqrt
72 0 matrix defaultmatrix dtransform dup mul exch dup mul add sqrt
1 index 1 index lt{exch}if pop
/hires xdf
hires mul
/numpix xdf
/numsteps NumSamples def
/rampIndxInc 1 def
/subsampling false def
numpix 0 ne
{
NumSamples numpix div 0.5 gt
{
/numsteps numpix 2 div round cvi dup 1 le{pop 2}if def
/rampIndxInc NumSamples 1 sub numsteps div def
/subsampling true def
}if
}if
/xInc c2x c1x sub numsteps div def
/yInc c2y c1y sub numsteps div def
/rInc r2 r1 sub numsteps div def
/cx c1x def
/cy c1y def
/radius r1 def
np
xInc 0 eq yInc 0 eq rInc 0 eq and and
{
0 getrampcolor
cx cy radius 0 360 arc
stroke
NumSamples 1 sub getrampcolor
cx cy radius 72 hires div add 0 360 arc
0 setlinewidth
stroke
}{
0
numsteps
{
dup
subsampling{round cvi}if
getrampcolor
cx cy radius 0 360 arc
/cx cx xInc add def
/cy cy yInc add def
/radius radius rInc add def
cx cy radius 360 0 arcn
eofill
rampIndxInc add
}repeat
pop
}ifelse
ext1
{
c2y r2 add r1 lt
{
c2x c2y r2 0 360 arc
fill
}{
c2y r1 add r2 sub 0.0001 le
{
c2x c2y r2 360 0 arcn
pathbbox
/aymax exch def
/axmax exch def
/aymin exch def
/axmin exch def
/bxMin xMin axmin min def
/byMin yMin aymin min def
/bxMax xMax axmax max def
/byMax yMax aymax max def
bxMin byMin moveto
bxMax byMin lineto
bxMax byMax lineto
bxMin byMax lineto
bxMin byMin lineto
eofill
}{
c2x c2y r2 0 360 arc fill
r1 r2 eq
{
/p1x r2 neg def
/p1y c2y def
/p2x r2 def
/p2y c2y def
p1x p1y moveto p2x p2y lineto p2x yMax lineto p1x yMax lineto
fill
}{
/AA r2 r1 sub c2y div def
AA -1 eq
{/theta 89.99 def}
{/theta AA 1 AA dup mul sub sqrt div 1 atan def}
ifelse
/SS1 90 theta add dup sin exch cos div def
/p1x r2 SS1 SS1 mul SS1 SS1 mul 1 add div sqrt mul neg def
/p1y c2y p1x SS1 div sub def
/SS2 90 theta sub dup sin exch cos div def
/p2x r2 SS2 SS2 mul SS2 SS2 mul 1 add div sqrt mul def
/p2y c2y p2x SS2 div sub def
r1 r2 lt
{
/L1maxX p1x yMax p1y sub SS1 div add def
/L2maxX p2x yMax p2y sub SS2 div add def
}{
/L1maxX 0 def
/L2maxX 0 def
}ifelse
p1x p1y moveto p2x p2y lineto L2maxX L2maxX p2x sub SS2 mul p2y add lineto
L1maxX L1maxX p1x sub SS1 mul p1y add lineto
fill
}ifelse
}ifelse
}ifelse
}if
grestore
grestore
end
end
end
}ifelse
}bdf
/GenStrips
{
40 dict begin
/ColorSpaceFamily xdf
/background xdf
/ext1 xdf
/ext0 xdf
/BBox xdf
/y2 xdf
/x2 xdf
/y1 xdf
/x1 xdf
/rampdict xdf
/setinkoverprint where{pop/setinkoverprint{pop}def}if
gsave
BBox length 0 gt
{
np
BBox 0 get BBox 1 get moveto
BBox 2 get BBox 0 get sub 0 rlineto
0 BBox 3 get BBox 1 get sub rlineto
BBox 2 get BBox 0 get sub neg 0 rlineto
closepath
clip
np
}if
x1 x2 eq
{
y1 y2 lt{/theta 90 def}{/theta 270 def}ifelse
}{
/slope y2 y1 sub x2 x1 sub div def
/theta slope 1 atan def
x2 x1 lt y2 y1 ge and{/theta theta 180 sub def}if
x2 x1 lt y2 y1 lt and{/theta theta 180 add def}if
}
ifelse
gsave
clippath
x1 y1 translate
theta rotate
{pathbbox}stopped
{0 0 0 0}if
/yMax exch def
/xMax exch def
/yMin exch def
/xMin exch def
grestore
xMax xMin eq yMax yMin eq or
{
grestore
end
}{
rampdict begin
20 dict begin
background length 0 gt{background sssetbackground gsave clippath fill grestore}if
gsave
x1 y1 translate
theta rotate
/xStart 0 def
/xEnd x2 x1 sub dup mul y2 y1 sub dup mul add 0.5 exp def
/ySpan yMax yMin sub def
/numsteps NumSamples def
/rampIndxInc 1 def
/subsampling false def
xStart 0 transform
xEnd 0 transform
3 -1 roll
sub dup mul
3 1 roll
sub dup mul
add 0.5 exp 72 div
0 72 matrix defaultmatrix dtransform dup mul exch dup mul add sqrt
72 0 matrix defaultmatrix dtransform dup mul exch dup mul add sqrt
1 index 1 index lt{exch}if pop
mul
/numpix xdf
numpix 0 ne
{
NumSamples numpix div 0.5 gt
{
/numsteps numpix 2 div round cvi dup 1 le{pop 2}if def
/rampIndxInc NumSamples 1 sub numsteps div def
/subsampling true def
}if
}if
ext0
{
0 getrampcolor
xMin xStart lt
{
xMin yMin xMin neg ySpan rectfill
}if
}if
/xInc xEnd xStart sub numsteps div def
/x xStart def
0
numsteps
{
dup
subsampling{round cvi}if
getrampcolor
x yMin xInc ySpan rectfill
/x x xInc add def
rampIndxInc add
}repeat
pop
ext1{
xMax xEnd gt
{
xEnd yMin xMax xEnd sub ySpan rectfill
}if
}if
grestore
grestore
end
end
end
}ifelse
}bdf
}def
/pt
{
end
}def
/dt{
}def
/pgsv{
//Adobe_AGM_Core/AGMCORE_save save put
}def
/pgrs{
//Adobe_AGM_Core/AGMCORE_save get restore
}def
systemdict/findcolorrendering known{
/findcolorrendering systemdict/findcolorrendering get def
}if
systemdict/setcolorrendering known{
/setcolorrendering systemdict/setcolorrendering get def
}if
/test_cmyk_color_plate
{
gsave
setcmykcolor currentgray 1 ne
grestore
}def
/inRip_spot_has_ink
{
dup//Adobe_AGM_Core/AGMCORE_name xddf
convert_spot_to_process not
}def
/map255_to_range
{
1 index sub
3 -1 roll 255 div mul add
}def
/set_csa_crd
{
/sep_colorspace_dict null AGMCORE_gput
begin
CSA get_csa_by_name setcolorspace_opt
set_crd
end
}
def
/map_csa
{
currentdict/MappedCSA known{MappedCSA null ne}{false}ifelse
{pop}{get_csa_by_name/MappedCSA xdf}ifelse
}def
/setsepcolor
{
/sep_colorspace_dict AGMCORE_gget begin
dup/sep_tint exch AGMCORE_gput
TintProc
end
}def
/setdevicencolor
{
/devicen_colorspace_dict AGMCORE_gget begin
Names length copy
Names length 1 sub -1 0
{
/devicen_tints AGMCORE_gget 3 1 roll xpt
}for
TintProc
end
}def
/sep_colorspace_proc
{
/AGMCORE_tmp exch store
/sep_colorspace_dict AGMCORE_gget begin
currentdict/Components known{
Components aload pop
TintMethod/Lab eq{
2{AGMCORE_tmp mul NComponents 1 roll}repeat
LMax sub AGMCORE_tmp mul LMax add NComponents 1 roll
}{
TintMethod/Subtractive eq{
NComponents{
AGMCORE_tmp mul NComponents 1 roll
}repeat
}{
NComponents{
1 sub AGMCORE_tmp mul 1 add NComponents 1 roll
}repeat
}ifelse
}ifelse
}{
ColorLookup AGMCORE_tmp ColorLookup length 1 sub mul round cvi get
aload pop
}ifelse
end
}def
/sep_colorspace_gray_proc
{
/AGMCORE_tmp exch store
/sep_colorspace_dict AGMCORE_gget begin
GrayLookup AGMCORE_tmp GrayLookup length 1 sub mul round cvi get
end
}def
/sep_proc_name
{
dup 0 get
dup/DeviceRGB eq exch/DeviceCMYK eq or level2 not and has_color not and{
pop[/DeviceGray]
/sep_colorspace_gray_proc
}{
/sep_colorspace_proc
}ifelse
}def
/setsepcolorspace
{
current_spot_alias{
dup begin
Name map_alias{
exch pop
}if
end
}if
dup/sep_colorspace_dict exch AGMCORE_gput
begin
CSA map_csa
/AGMCORE_sep_special Name dup()eq exch(All)eq or store
AGMCORE_avoid_L2_sep_space{
[/Indexed MappedCSA sep_proc_name 255 exch
{255 div}/exec cvx 3 -1 roll[4 1 roll load/exec cvx]cvx
]setcolorspace_opt
/TintProc{
255 mul round cvi setcolor
}bdf
}{
MappedCSA 0 get/DeviceCMYK eq
currentdict/Components known and
AGMCORE_sep_special not and{
/TintProc[
Components aload pop Name findcmykcustomcolor
/exch cvx/setcustomcolor cvx
]cvx bdf
}{
AGMCORE_host_sep Name(All)eq and{
/TintProc{
1 exch sub setseparationgray
}bdf
}{
AGMCORE_in_rip_sep MappedCSA 0 get/DeviceCMYK eq and
AGMCORE_host_sep or
Name()eq and{
/TintProc[
MappedCSA sep_proc_name exch 0 get/DeviceCMYK eq{
cvx/setcmykcolor cvx
}{
cvx/setgray cvx
}ifelse
]cvx bdf
}{
AGMCORE_producing_seps MappedCSA 0 get dup/DeviceCMYK eq exch/DeviceGray eq or and AGMCORE_sep_special not and{
/TintProc[
/dup cvx
MappedCSA sep_proc_name cvx exch
0 get/DeviceGray eq{
1/exch cvx/sub cvx 0 0 0 4 -1/roll cvx
}if
/Name cvx/findcmykcustomcolor cvx/exch cvx
AGMCORE_host_sep{
AGMCORE_is_cmyk_sep
/Name cvx
/AGMCORE_IsSeparationAProcessColor load/exec cvx
/not cvx/and cvx
}{
Name inRip_spot_has_ink not
}ifelse
[
/pop cvx 1
]cvx/if cvx
/setcustomcolor cvx
]cvx bdf
}{
/TintProc{setcolor}bdf
[/Separation Name MappedCSA sep_proc_name load]setcolorspace_opt
}ifelse
}ifelse
}ifelse
}ifelse
}ifelse
set_crd
setsepcolor
end
}def
/additive_blend
{
3 dict begin
/numarrays xdf
/numcolors xdf
0 1 numcolors 1 sub
{
/c1 xdf
1
0 1 numarrays 1 sub
{
1 exch add/index cvx
c1/get cvx/mul cvx
}for
numarrays 1 add 1/roll cvx
}for
numarrays[/pop cvx]cvx/repeat cvx
end
}def
/subtractive_blend
{
3 dict begin
/numarrays xdf
/numcolors xdf
0 1 numcolors 1 sub
{
/c1 xdf
1 1
0 1 numarrays 1 sub
{
1 3 3 -1 roll add/index cvx
c1/get cvx/sub cvx/mul cvx
}for
/sub cvx
numarrays 1 add 1/roll cvx
}for
numarrays[/pop cvx]cvx/repeat cvx
end
}def
/exec_tint_transform
{
/TintProc[
/TintTransform cvx/setcolor cvx
]cvx bdf
MappedCSA setcolorspace_opt
}bdf
/devn_makecustomcolor
{
2 dict begin
/names_index xdf
/Names xdf
1 1 1 1 Names names_index get findcmykcustomcolor
/devicen_tints AGMCORE_gget names_index get setcustomcolor
Names length{pop}repeat
end
}bdf
/setdevicencolorspace
{
dup/AliasedColorants known{false}{true}ifelse
current_spot_alias and{
7 dict begin
/names_index 0 def
dup/names_len exch/Names get length def
/new_names names_len array def
/new_LookupTables names_len array def
/alias_cnt 0 def
dup/Names get
{
dup map_alias{
exch pop
dup/ColorLookup known{
dup begin
new_LookupTables names_index ColorLookup put
end
}{
dup/Components known{
dup begin
new_LookupTables names_index Components put
end
}{
dup begin
new_LookupTables names_index[null null null null]put
end
}ifelse
}ifelse
new_names names_index 3 -1 roll/Name get put
/alias_cnt alias_cnt 1 add def
}{
/name xdf
new_names names_index name put
dup/LookupTables known{
dup begin
new_LookupTables names_index LookupTables names_index get put
end
}{
dup begin
new_LookupTables names_index[null null null null]put
end
}ifelse
}ifelse
/names_index names_index 1 add def
}forall
alias_cnt 0 gt{
/AliasedColorants true def
/lut_entry_len new_LookupTables 0 get dup length 256 ge{0 get length}{length}ifelse def
0 1 names_len 1 sub{
/names_index xdf
new_LookupTables names_index get dup length 256 ge{0 get length}{length}ifelse lut_entry_len ne{
/AliasedColorants false def
exit
}{
new_LookupTables names_index get 0 get null eq{
dup/Names get names_index get/name xdf
name(Cyan)eq name(Magenta)eq name(Yellow)eq name(Black)eq
or or or not{
/AliasedColorants false def
exit
}if
}if
}ifelse
}for
lut_entry_len 1 eq{
/AliasedColorants false def
}if
AliasedColorants{
dup begin
/Names new_names def
/LookupTables new_LookupTables def
/AliasedColorants true def
/NComponents lut_entry_len def
/TintMethod NComponents 4 eq{/Subtractive}{/Additive}ifelse def
/MappedCSA TintMethod/Additive eq{/DeviceRGB}{/DeviceCMYK}ifelse def
currentdict/TTTablesIdx known not{
/TTTablesIdx -1 def
}if
end
}if
}if
end
}if
dup/devicen_colorspace_dict exch AGMCORE_gput
begin
currentdict/AliasedColorants known{
AliasedColorants
}{
false
}ifelse
dup not{
CSA map_csa
}if
/TintTransform load type/nulltype eq or{
/TintTransform[
0 1 Names length 1 sub
{
/TTTablesIdx TTTablesIdx 1 add def
dup LookupTables exch get dup 0 get null eq
{
1 index
Names exch get
dup(Cyan)eq
{
pop exch
LookupTables length exch sub
/index cvx
0 0 0
}
{
dup(Magenta)eq
{
pop exch
LookupTables length exch sub
/index cvx
0/exch cvx 0 0
}{
(Yellow)eq
{
exch
LookupTables length exch sub
/index cvx
0 0 3 -1/roll cvx 0
}{
exch
LookupTables length exch sub
/index cvx
0 0 0 4 -1/roll cvx
}ifelse
}ifelse
}ifelse
5 -1/roll cvx/astore cvx
}{
dup length 1 sub
LookupTables length 4 -1 roll sub 1 add
/index cvx/mul cvx/round cvx/cvi cvx/get cvx
}ifelse
Names length TTTablesIdx add 1 add 1/roll cvx
}for
Names length[/pop cvx]cvx/repeat cvx
NComponents Names length
TintMethod/Subtractive eq
{
subtractive_blend
}{
additive_blend
}ifelse
]cvx bdf
}if
AGMCORE_host_sep{
Names convert_to_process{
exec_tint_transform
}
{
currentdict/AliasedColorants known{
AliasedColorants not
}{
false
}ifelse
5 dict begin
/AvoidAliasedColorants xdf
/painted? false def
/names_index 0 def
/names_len Names length def
AvoidAliasedColorants{
/currentspotalias current_spot_alias def
false set_spot_alias
}if
Names{
AGMCORE_is_cmyk_sep{
dup(Cyan)eq AGMCORE_cyan_plate and exch
dup(Magenta)eq AGMCORE_magenta_plate and exch
dup(Yellow)eq AGMCORE_yellow_plate and exch
(Black)eq AGMCORE_black_plate and or or or{
/devicen_colorspace_dict AGMCORE_gget/TintProc[
Names names_index/devn_makecustomcolor cvx
]cvx ddf
/painted? true def
}if
painted?{exit}if
}{
0 0 0 0 5 -1 roll findcmykcustomcolor 1 setcustomcolor currentgray 0 eq{
/devicen_colorspace_dict AGMCORE_gget/TintProc[
Names names_index/devn_makecustomcolor cvx
]cvx ddf
/painted? true def
exit
}if
}ifelse
/names_index names_index 1 add def
}forall
AvoidAliasedColorants{
currentspotalias set_spot_alias
}if
painted?{
/devicen_colorspace_dict AGMCORE_gget/names_index names_index put
}{
/devicen_colorspace_dict AGMCORE_gget/TintProc[
names_len[/pop cvx]cvx/repeat cvx 1/setseparationgray cvx
0 0 0 0/setcmykcolor cvx
]cvx ddf
}ifelse
end
}ifelse
}
{
AGMCORE_in_rip_sep{
Names convert_to_process not
}{
level3
}ifelse
{
[/DeviceN Names MappedCSA/TintTransform load]setcolorspace_opt
/TintProc level3 not AGMCORE_in_rip_sep and{
[
Names/length cvx[/pop cvx]cvx/repeat cvx
]cvx bdf
}{
{setcolor}bdf
}ifelse
}{
exec_tint_transform
}ifelse
}ifelse
set_crd
/AliasedColorants false def
end
}def
/setindexedcolorspace
{
dup/indexed_colorspace_dict exch AGMCORE_gput
begin
currentdict/CSDBase known{
CSDBase/CSD get_res begin
currentdict/Names known{
currentdict devncs
}{
1 currentdict sepcs
}ifelse
AGMCORE_host_sep{
4 dict begin
/compCnt/Names where{pop Names length}{1}ifelse def
/NewLookup HiVal 1 add string def
0 1 HiVal{
/tableIndex xdf
Lookup dup type/stringtype eq{
compCnt tableIndex map_index
}{
exec
}ifelse
/Names where{
pop setdevicencolor
}{
setsepcolor
}ifelse
currentgray
tableIndex exch
255 mul cvi
NewLookup 3 1 roll put
}for
[/Indexed currentcolorspace HiVal NewLookup]setcolorspace_opt
end
}{
level3
{
currentdict/Names known{
[/Indexed[/DeviceN Names MappedCSA/TintTransform load]HiVal Lookup]setcolorspace_opt
}{
[/Indexed[/Separation Name MappedCSA sep_proc_name load]HiVal Lookup]setcolorspace_opt
}ifelse
}{
[/Indexed MappedCSA HiVal
[
currentdict/Names known{
Lookup dup type/stringtype eq
{/exch cvx CSDBase/CSD get_res/Names get length dup/mul cvx exch/getinterval cvx{255 div}/forall cvx}
{/exec cvx}ifelse
/TintTransform load/exec cvx
}{
Lookup dup type/stringtype eq
{/exch cvx/get cvx 255/div cvx}
{/exec cvx}ifelse
CSDBase/CSD get_res/MappedCSA get sep_proc_name exch pop/load cvx/exec cvx
}ifelse
]cvx
]setcolorspace_opt
}ifelse
}ifelse
end
set_crd
}
{
CSA map_csa
AGMCORE_host_sep level2 not and{
0 0 0 0 setcmykcolor
}{
[/Indexed MappedCSA
level2 not has_color not and{
dup 0 get dup/DeviceRGB eq exch/DeviceCMYK eq or{
pop[/DeviceGray]
}if
HiVal GrayLookup
}{
HiVal
currentdict/RangeArray known{
{
/indexed_colorspace_dict AGMCORE_gget begin
Lookup exch
dup HiVal gt{
pop HiVal
}if
NComponents mul NComponents getinterval{}forall
NComponents 1 sub -1 0{
RangeArray exch 2 mul 2 getinterval aload pop map255_to_range
NComponents 1 roll
}for
end
}bind
}{
Lookup
}ifelse
}ifelse
]setcolorspace_opt
set_crd
}ifelse
}ifelse
end
}def
/setindexedcolor
{
AGMCORE_host_sep{
/indexed_colorspace_dict AGMCORE_gget
begin
currentdict/CSDBase known{
CSDBase/CSD get_res begin
currentdict/Names known{
map_indexed_devn
devn
}
{
Lookup 1 3 -1 roll map_index
sep
}ifelse
end
}{
Lookup MappedCSA/DeviceCMYK eq{4}{1}ifelse 3 -1 roll
map_index
MappedCSA/DeviceCMYK eq{setcmykcolor}{setgray}ifelse
}ifelse
end
}{
level3 not AGMCORE_in_rip_sep and/indexed_colorspace_dict AGMCORE_gget/CSDBase known and{
/indexed_colorspace_dict AGMCORE_gget/CSDBase get/CSD get_res begin
map_indexed_devn
devn
end
}
{
setcolor
}ifelse
}ifelse
}def
/ignoreimagedata
{
currentoverprint not{
gsave
dup clonedict begin
1 setgray
/Decode[0 1]def
/DataSourcedef
/MultipleDataSources false def
/BitsPerComponent 8 def
currentdict end
systemdict/image gx
grestore
}if
consumeimagedata
}def
/add_res
{
dup/CSD eq{
pop
//Adobe_AGM_Core begin
/AGMCORE_CSD_cache load 3 1 roll put
end
}{
defineresource pop
}ifelse
}def
/del_res
{
{
aload pop exch
dup/CSD eq{
pop
{//Adobe_AGM_Core/AGMCORE_CSD_cache get exch undef}forall
}{
exch
{1 index undefineresource}forall
pop
}ifelse
}forall
}def
/get_res
{
dup/CSD eq{
pop
dup type dup/nametype eq exch/stringtype eq or{
AGMCORE_CSD_cache exch get
}if
}{
findresource
}ifelse
}def
/get_csa_by_name
{
dup type dup/nametype eq exch/stringtype eq or{
/CSA get_res
}if
}def
/paintproc_buf_init
{
/count get 0 0 put
}def
/paintproc_buf_next
{
dup/count get dup 0 get
dup 3 1 roll
1 add 0 xpt
get
}def
/cachepaintproc_compress
{
5 dict begin
currentfile exch 0 exch/SubFileDecode filter/ReadFilter exch def
/ppdict 20 dict def
/string_size 16000 def
/readbuffer string_size string def
currentglobal true setglobal
ppdict 1 array dup 0 1 put/count xpt
setglobal
/LZWFilter
{
exch
dup length 0 eq{
pop
}{
ppdict dup length 1 sub 3 -1 roll put
}ifelse
{string_size}{0}ifelse string
}/LZWEncode filter def
{
ReadFilter readbuffer readstring
exch LZWFilter exch writestring
not{exit}if
}loop
LZWFilter closefile
ppdict
end
}def
/cachepaintproc
{
2 dict begin
currentfile exch 0 exch/SubFileDecode filter/ReadFilter exch def
/ppdict 20 dict def
currentglobal true setglobal
ppdict 1 array dup 0 1 put/count xpt
setglobal
{
ReadFilter 16000 string readstring exch
ppdict dup length 1 sub 3 -1 roll put
not{exit}if
}loop
ppdict dup dup length 1 sub()put
end
}def
/make_pattern
{
exch clonedict exch
dup matrix currentmatrix matrix concatmatrix 0 0 3 2 roll itransform
exch 3 index/XStep get 1 index exch 2 copy div cvi mul sub sub
exch 3 index/YStep get 1 index exch 2 copy div cvi mul sub sub
matrix translate exch matrix concatmatrix
1 index begin
BBox 0 get XStep div cvi XStep mul/xshift exch neg def
BBox 1 get YStep div cvi YStep mul/yshift exch neg def
BBox 0 get xshift add
BBox 1 get yshift add
BBox 2 get xshift add
BBox 3 get yshift add
4 array astore
/BBox exch def
[xshift yshift/translate load null/exec load]dup
3/PaintProc load put cvx/PaintProc exch def
end
gsave 0 setgray
makepattern
grestore
}def
/set_pattern
{
dup/PatternType get 1 eq{
dup/PaintType get 1 eq{
currentoverprint sop[/DeviceGray]setcolorspace 0 setgray
}if
}if
setpattern
}def
/setcolorspace_opt
{
dup currentcolorspace eq{pop}{setcolorspace}ifelse
}def
/updatecolorrendering
{
currentcolorrendering/RenderingIntent known{
currentcolorrendering/RenderingIntent get
}
{
Intent/AbsoluteColorimetric eq
{
/absolute_colorimetric_crd AGMCORE_gget dup null eq
}
{
Intent/RelativeColorimetric eq
{
/relative_colorimetric_crd AGMCORE_gget dup null eq
}
{
Intent/Saturation eq
{
/saturation_crd AGMCORE_gget dup null eq
}
{
/perceptual_crd AGMCORE_gget dup null eq
}ifelse
}ifelse
}ifelse
{
pop null
}
{
/RenderingIntent known{null}{Intent}ifelse
}ifelse
}ifelse
Intent ne{
Intent/ColorRendering{findresource}stopped
{
pop pop systemdict/findcolorrendering known
{
Intent findcolorrendering
{
/ColorRendering findresource true exch
}
{
/ColorRendering findresource
product(Xerox Phaser 5400)ne
exch
}ifelse
dup Intent/AbsoluteColorimetric eq
{
/absolute_colorimetric_crd exch AGMCORE_gput
}
{
Intent/RelativeColorimetric eq
{
/relative_colorimetric_crd exch AGMCORE_gput
}
{
Intent/Saturation eq
{
/saturation_crd exch AGMCORE_gput
}
{
Intent/Perceptual eq
{
/perceptual_crd exch AGMCORE_gput
}
{
pop
}ifelse
}ifelse
}ifelse
}ifelse
1 index{exch}{pop}ifelse
}
{false}ifelse
}
{true}ifelse
{
dup begin
currentdict/TransformPQR known{
currentdict/TransformPQR get aload pop
3{{}eq 3 1 roll}repeat or or
}
{true}ifelse
currentdict/MatrixPQR known{
currentdict/MatrixPQR get aload pop
1.0 eq 9 1 roll 0.0 eq 9 1 roll 0.0 eq 9 1 roll
0.0 eq 9 1 roll 1.0 eq 9 1 roll 0.0 eq 9 1 roll
0.0 eq 9 1 roll 0.0 eq 9 1 roll 1.0 eq
and and and and and and and and
}
{true}ifelse
end
or
{
clonedict begin
/TransformPQR[
{4 -1 roll 3 get dup 3 1 roll sub 5 -1 roll 3 get 3 -1 roll sub div
3 -1 roll 3 get 3 -1 roll 3 get dup 4 1 roll sub mul add}bind
{4 -1 roll 4 get dup 3 1 roll sub 5 -1 roll 4 get 3 -1 roll sub div
3 -1 roll 4 get 3 -1 roll 4 get dup 4 1 roll sub mul add}bind
{4 -1 roll 5 get dup 3 1 roll sub 5 -1 roll 5 get 3 -1 roll sub div
3 -1 roll 5 get 3 -1 roll 5 get dup 4 1 roll sub mul add}bind
]def
/MatrixPQR[0.8951 -0.7502 0.0389 0.2664 1.7135 -0.0685 -0.1614 0.0367 1.0296]def
/RangePQR[-0.3227950745 2.3229645538 -1.5003771057 3.5003465881 -0.1369979095 2.136967392]def
currentdict end
}if
setcolorrendering_opt
}if
}if
}def
/set_crd
{
AGMCORE_host_sep not level2 and{
currentdict/ColorRendering known{
ColorRendering/ColorRendering{findresource}stopped not{setcolorrendering_opt}if
}{
currentdict/Intent known{
updatecolorrendering
}if
}ifelse
currentcolorspace dup type/arraytype eq
{0 get}if
/DeviceRGB eq
{
currentdict/UCR known
{/UCR}{/AGMCORE_currentucr}ifelse
load setundercolorremoval
currentdict/BG known
{/BG}{/AGMCORE_currentbg}ifelse
load setblackgeneration
}if
}if
}def
/set_ucrbg
{
dup null eq{pop/AGMCORE_currentbg load}{/Procedure get_res}ifelse setblackgeneration
dup null eq{pop/AGMCORE_currentucr load}{/Procedure get_res}ifelse setundercolorremoval
}def
/setcolorrendering_opt
{
dup currentcolorrendering eq{
pop
}{
clonedict
begin
/Intent Intent def
currentdict
end
setcolorrendering
}ifelse
}def
/cpaint_gcomp
{
convert_to_process//Adobe_AGM_Core/AGMCORE_ConvertToProcess xddf
//Adobe_AGM_Core/AGMCORE_ConvertToProcess get not
{
(%end_cpaint_gcomp)flushinput
}if
}def
/cpaint_gsep
{
//Adobe_AGM_Core/AGMCORE_ConvertToProcess get
{
(%end_cpaint_gsep)flushinput
}if
}def
/cpaint_gend
{np}def
/T1_path
{
currentfile token pop currentfile token pop mo
{
currentfile token pop dup type/stringtype eq
{pop exit}if
0 exch rlineto
currentfile token pop dup type/stringtype eq
{pop exit}if
0 rlineto
}loop
}def
/T1_gsave
level3
{/clipsave}
{/gsave}ifelse
load def
/T1_grestore
level3
{/cliprestore}
{/grestore}ifelse
load def
/set_spot_alias_ary
{
dup inherit_aliases
//Adobe_AGM_Core/AGMCORE_SpotAliasAry xddf
}def
/set_spot_normalization_ary
{
dup inherit_aliases
dup length
/AGMCORE_SpotAliasAry where{pop AGMCORE_SpotAliasAry length add}if
array
//Adobe_AGM_Core/AGMCORE_SpotAliasAry2 xddf
/AGMCORE_SpotAliasAry where{
pop
AGMCORE_SpotAliasAry2 0 AGMCORE_SpotAliasAry putinterval
AGMCORE_SpotAliasAry length
}{0}ifelse
AGMCORE_SpotAliasAry2 3 1 roll exch putinterval
true set_spot_alias
}def
/inherit_aliases
{
{dup/Name get map_alias{/CSD put}{pop}ifelse}forall
}def
/set_spot_alias
{
/AGMCORE_SpotAliasAry2 where{
/AGMCORE_current_spot_alias 3 -1 roll put
}{
pop
}ifelse
}def
/current_spot_alias
{
/AGMCORE_SpotAliasAry2 where{
/AGMCORE_current_spot_alias get
}{
false
}ifelse
}def
/map_alias
{
/AGMCORE_SpotAliasAry2 where{
begin
/AGMCORE_name xdf
false
AGMCORE_SpotAliasAry2{
dup/Name get AGMCORE_name eq{
/CSD get/CSD get_res
exch pop true
exit
}{
pop
}ifelse
}forall
end
}{
pop false
}ifelse
}bdf
/spot_alias
{
true set_spot_alias
/AGMCORE_&setcustomcolor AGMCORE_key_known not{
//Adobe_AGM_Core/AGMCORE_&setcustomcolor/setcustomcolor load put
}if
/customcolor_tint 1 AGMCORE_gput
//Adobe_AGM_Core begin
/setcustomcolor
{
//Adobe_AGM_Core begin
dup/customcolor_tint exch AGMCORE_gput
1 index aload pop pop 1 eq exch 1 eq and exch 1 eq and exch 1 eq and not
current_spot_alias and{1 index 4 get map_alias}{false}ifelse
{
false set_spot_alias
/sep_colorspace_dict AGMCORE_gget null ne
3 1 roll 2 index{
exch pop/sep_tint AGMCORE_gget exch
}if
mark 3 1 roll
setsepcolorspace
counttomark 0 ne{
setsepcolor
}if
pop
not{/sep_tint 1.0 AGMCORE_gput}if
pop
true set_spot_alias
}{
AGMCORE_&setcustomcolor
}ifelse
end
}bdf
end
}def
/begin_feature
{
Adobe_AGM_Core/AGMCORE_feature_dictCount countdictstack put
count Adobe_AGM_Core/AGMCORE_feature_opCount 3 -1 roll put
{Adobe_AGM_Core/AGMCORE_feature_ctm matrix currentmatrix put}if
}def
/end_feature
{
2 dict begin
/spd/setpagedevice load def
/setpagedevice{get_gstate spd set_gstate}def
stopped{$error/newerror false put}if
end
count Adobe_AGM_Core/AGMCORE_feature_opCount get sub dup 0 gt{{pop}repeat}{pop}ifelse
countdictstack Adobe_AGM_Core/AGMCORE_feature_dictCount get sub dup 0 gt{{end}repeat}{pop}ifelse
{Adobe_AGM_Core/AGMCORE_feature_ctm get setmatrix}if
}def
/set_negative
{
//Adobe_AGM_Core begin
/AGMCORE_inverting exch def
level2{
currentpagedevice/NegativePrint known AGMCORE_distilling not and{
currentpagedevice/NegativePrint get//Adobe_AGM_Core/AGMCORE_inverting get ne{
true begin_feature true{
<>setpagedevice
}end_feature
}if
/AGMCORE_inverting false def
}if
}if
AGMCORE_inverting{
[{1 exch sub}/exec load dup currenttransfer exch]cvx bind settransfer
AGMCORE_distilling{
erasepage
}{
gsave np clippath 1/setseparationgray where{pop setseparationgray}{setgray}ifelse
/AGMIRS_&fill where{pop AGMIRS_&fill}{fill}ifelse grestore
}ifelse
}if
end
}def
/lw_save_restore_override{
/md where{
pop
md begin
initializepage
/initializepage{}def
/pmSVsetup{}def
/endp{}def
/pse{}def
/psb{}def
/orig_showpage where
{pop}
{/orig_showpage/showpage load def}
ifelse
/showpage{orig_showpage gR}def
end
}if
}def
/pscript_showpage_override{
/NTPSOct95 where
{
begin
showpage
save
/showpage/restore load def
/restore{exch pop}def
end
}if
}def
/driver_media_override
{
/md where{
pop
md/initializepage known{
md/initializepage{}put
}if
md/rC known{
md/rC{4{pop}repeat}put
}if
}if
/mysetup where{
/mysetup[1 0 0 1 0 0]put
}if
Adobe_AGM_Core/AGMCORE_Default_CTM matrix currentmatrix put
level2
{Adobe_AGM_Core/AGMCORE_Default_PageSize currentpagedevice/PageSize get put}if
}def
/driver_check_media_override
{
/PrepsDict where
{pop}
{
Adobe_AGM_Core/AGMCORE_Default_CTM get matrix currentmatrix ne
Adobe_AGM_Core/AGMCORE_Default_PageSize get type/arraytype eq
{
Adobe_AGM_Core/AGMCORE_Default_PageSize get 0 get currentpagedevice/PageSize get 0 get eq and
Adobe_AGM_Core/AGMCORE_Default_PageSize get 1 get currentpagedevice/PageSize get 1 get eq and
}if
{
Adobe_AGM_Core/AGMCORE_Default_CTM get setmatrix
}if
}ifelse
}def
AGMCORE_err_strings begin
/AGMCORE_bad_environ(Environment not satisfactory for this job. Ensure that the PPD is correct or that the PostScript level requested is supported by this printer. )def
/AGMCORE_color_space_onhost_seps(This job contains colors that will not separate with on-host methods. )def
/AGMCORE_invalid_color_space(This job contains an invalid color space. )def
end
/set_def_ht
{AGMCORE_def_ht sethalftone}def
/set_def_flat
{AGMCORE_Default_flatness setflat}def
end
systemdict/setpacking known
{setpacking}if
%%EndResource
%%BeginResource: procset Adobe_CoolType_Core 2.31 0
%%Copyright: Copyright 1997-2006 Adobe Systems Incorporated. All Rights Reserved.
%%Version: 2.31 0
10 dict begin
/Adobe_CoolType_Passthru currentdict def
/Adobe_CoolType_Core_Defined userdict/Adobe_CoolType_Core known def
Adobe_CoolType_Core_Defined
{/Adobe_CoolType_Core userdict/Adobe_CoolType_Core get def}
if
userdict/Adobe_CoolType_Core 70 dict dup begin put
/Adobe_CoolType_Version 2.31 def
/Level2?
systemdict/languagelevel known dup
{pop systemdict/languagelevel get 2 ge}
if def
Level2? not
{
/currentglobal false def
/setglobal/pop load def
/gcheck{pop false}bind def
/currentpacking false def
/setpacking/pop load def
/SharedFontDirectory 0 dict def
}
if
currentpacking
true setpacking
currentglobal false setglobal
userdict/Adobe_CoolType_Data 2 copy known not
{2 copy 10 dict put}
if
get
begin
/@opStackCountByLevel 32 dict def
/@opStackLevel 0 def
/@dictStackCountByLevel 32 dict def
/@dictStackLevel 0 def
end
setglobal
currentglobal true setglobal
userdict/Adobe_CoolType_GVMFonts known not
{userdict/Adobe_CoolType_GVMFonts 10 dict put}
if
setglobal
currentglobal false setglobal
userdict/Adobe_CoolType_LVMFonts known not
{userdict/Adobe_CoolType_LVMFonts 10 dict put}
if
setglobal
/ct_VMDictPut
{
dup gcheck{Adobe_CoolType_GVMFonts}{Adobe_CoolType_LVMFonts}ifelse
3 1 roll put
}bind def
/ct_VMDictUndef
{
dup Adobe_CoolType_GVMFonts exch known
{Adobe_CoolType_GVMFonts exch undef}
{
dup Adobe_CoolType_LVMFonts exch known
{Adobe_CoolType_LVMFonts exch undef}
{pop}
ifelse
}ifelse
}bind def
/ct_str1 1 string def
/ct_xshow
{
/_ct_na exch def
/_ct_i 0 def
currentpoint
/_ct_y exch def
/_ct_x exch def
{
pop pop
ct_str1 exch 0 exch put
ct_str1 show
{_ct_na _ct_i get}stopped
{pop pop}
{
_ct_x _ct_y moveto
0
rmoveto
}
ifelse
/_ct_i _ct_i 1 add def
currentpoint
/_ct_y exch def
/_ct_x exch def
}
exch
@cshow
}bind def
/ct_yshow
{
/_ct_na exch def
/_ct_i 0 def
currentpoint
/_ct_y exch def
/_ct_x exch def
{
pop pop
ct_str1 exch 0 exch put
ct_str1 show
{_ct_na _ct_i get}stopped
{pop pop}
{
_ct_x _ct_y moveto
0 exch
rmoveto
}
ifelse
/_ct_i _ct_i 1 add def
currentpoint
/_ct_y exch def
/_ct_x exch def
}
exch
@cshow
}bind def
/ct_xyshow
{
/_ct_na exch def
/_ct_i 0 def
currentpoint
/_ct_y exch def
/_ct_x exch def
{
pop pop
ct_str1 exch 0 exch put
ct_str1 show
{_ct_na _ct_i get}stopped
{pop pop}
{
{_ct_na _ct_i 1 add get}stopped
{pop pop pop}
{
_ct_x _ct_y moveto
rmoveto
}
ifelse
}
ifelse
/_ct_i _ct_i 2 add def
currentpoint
/_ct_y exch def
/_ct_x exch def
}
exch
@cshow
}bind def
/xsh{{@xshow}stopped{Adobe_CoolType_Data begin ct_xshow end}if}bind def
/ysh{{@yshow}stopped{Adobe_CoolType_Data begin ct_yshow end}if}bind def
/xysh{{@xyshow}stopped{Adobe_CoolType_Data begin ct_xyshow end}if}bind def
currentglobal true setglobal
/ct_T3Defs
{
/BuildChar
{
1 index/Encoding get exch get
1 index/BuildGlyph get exec
}bind def
/BuildGlyph
{
exch begin
GlyphProcs exch get exec
end
}bind def
}bind def
setglobal
/@_SaveStackLevels
{
Adobe_CoolType_Data
begin
/@vmState currentglobal def false setglobal
@opStackCountByLevel
@opStackLevel
2 copy known not
{
2 copy
3 dict dup/args
7 index
5 add array put
put get
}
{
get dup/args get dup length 3 index lt
{
dup length 5 add array exch
1 index exch 0 exch putinterval
1 index exch/args exch put
}
{pop}
ifelse
}
ifelse
begin
count 1 sub
1 index lt
{pop count}
if
dup/argCount exch def
dup 0 gt
{
args exch 0 exch getinterval
astore pop
}
{pop}
ifelse
count
/restCount exch def
end
/@opStackLevel @opStackLevel 1 add def
countdictstack 1 sub
@dictStackCountByLevel exch @dictStackLevel exch put
/@dictStackLevel @dictStackLevel 1 add def
@vmState setglobal
end
}bind def
/@_RestoreStackLevels
{
Adobe_CoolType_Data
begin
/@opStackLevel @opStackLevel 1 sub def
@opStackCountByLevel @opStackLevel get
begin
count restCount sub dup 0 gt
{{pop}repeat}
{pop}
ifelse
args 0 argCount getinterval{}forall
end
/@dictStackLevel @dictStackLevel 1 sub def
@dictStackCountByLevel @dictStackLevel get
end
countdictstack exch sub dup 0 gt
{{end}repeat}
{pop}
ifelse
}bind def
/@_PopStackLevels
{
Adobe_CoolType_Data
begin
/@opStackLevel @opStackLevel 1 sub def
/@dictStackLevel @dictStackLevel 1 sub def
end
}bind def
/@Raise
{
exch cvx exch errordict exch get exec
stop
}bind def
/@ReRaise
{
cvx $error/errorname get errordict exch get exec
stop
}bind def
/@Stopped
{
0 @#Stopped
}bind def
/@#Stopped
{
@_SaveStackLevels
stopped
{@_RestoreStackLevels true}
{@_PopStackLevels false}
ifelse
}bind def
/@Arg
{
Adobe_CoolType_Data
begin
@opStackCountByLevel @opStackLevel 1 sub get
begin
args exch
argCount 1 sub exch sub get
end
end
}bind def
currentglobal true setglobal
/CTHasResourceForAllBug
Level2?
{
1 dict dup
/@shouldNotDisappearDictValue true def
Adobe_CoolType_Data exch/@shouldNotDisappearDict exch put
begin
count @_SaveStackLevels
{(*){pop stop}128 string/Category resourceforall}
stopped pop
@_RestoreStackLevels
currentdict Adobe_CoolType_Data/@shouldNotDisappearDict get dup 3 1 roll ne dup 3 1 roll
{
/@shouldNotDisappearDictValue known
{
{
end
currentdict 1 index eq
{pop exit}
if
}
loop
}
if
}
{
pop
end
}
ifelse
}
{false}
ifelse
def
true setglobal
/CTHasResourceStatusBug
Level2?
{
mark
{/steveamerige/Category resourcestatus}
stopped
{cleartomark true}
{cleartomark currentglobal not}
ifelse
}
{false}
ifelse
def
setglobal
/CTResourceStatus
{
mark 3 1 roll
/Category findresource
begin
({ResourceStatus}stopped)0()/SubFileDecode filter cvx exec
{cleartomark false}
{{3 2 roll pop true}{cleartomark false}ifelse}
ifelse
end
}bind def
/CTWorkAroundBugs
{
Level2?
{
/cid_PreLoad/ProcSet resourcestatus
{
pop pop
currentglobal
mark
{
(*)
{
dup/CMap CTHasResourceStatusBug
{CTResourceStatus}
{resourcestatus}
ifelse
{
pop dup 0 eq exch 1 eq or
{
dup/CMap findresource gcheck setglobal
/CMap undefineresource
}
{
pop CTHasResourceForAllBug
{exit}
{stop}
ifelse
}
ifelse
}
{pop}
ifelse
}
128 string/CMap resourceforall
}
stopped
{cleartomark}
stopped pop
setglobal
}
if
}
if
}bind def
/ds
{
Adobe_CoolType_Core
begin
CTWorkAroundBugs
/mo/moveto load def
/nf/newencodedfont load def
/msf{makefont setfont}bind def
/uf{dup undefinefont ct_VMDictUndef}bind def
/ur/undefineresource load def
/chp/charpath load def
/awsh/awidthshow load def
/wsh/widthshow load def
/ash/ashow load def
/@xshow/xshow load def
/@yshow/yshow load def
/@xyshow/xyshow load def
/@cshow/cshow load def
/sh/show load def
/rp/repeat load def
/.n/.notdef def
end
currentglobal false setglobal
userdict/Adobe_CoolType_Data 2 copy known not
{2 copy 10 dict put}
if
get
begin
/AddWidths? false def
/CC 0 def
/charcode 2 string def
/@opStackCountByLevel 32 dict def
/@opStackLevel 0 def
/@dictStackCountByLevel 32 dict def
/@dictStackLevel 0 def
/InVMFontsByCMap 10 dict def
/InVMDeepCopiedFonts 10 dict def
end
setglobal
}bind def
/dt
{
currentdict Adobe_CoolType_Core eq
{end}
if
}bind def
/ps
{
Adobe_CoolType_Core begin
Adobe_CoolType_GVMFonts begin
Adobe_CoolType_LVMFonts begin
SharedFontDirectory begin
}bind def
/pt
{
end
end
end
end
}bind def
/unload
{
systemdict/languagelevel known
{
systemdict/languagelevel get 2 ge
{
userdict/Adobe_CoolType_Core 2 copy known
{undef}
{pop pop}
ifelse
}
if
}
if
}bind def
/ndf
{
1 index where
{pop pop pop}
{dup xcheck{bind}if def}
ifelse
}def
/findfont systemdict
begin
userdict
begin
/globaldict where{/globaldict get begin}if
dup where pop exch get
/globaldict where{pop end}if
end
end
Adobe_CoolType_Core_Defined
{/systemfindfont exch def}
{
/findfont 1 index def
/systemfindfont exch def
}
ifelse
/undefinefont
{pop}ndf
/copyfont
{
currentglobal 3 1 roll
1 index gcheck setglobal
dup null eq{0}{dup length}ifelse
2 index length add 1 add dict
begin
exch
{
1 index/FID eq
{pop pop}
{def}
ifelse
}
forall
dup null eq
{pop}
{{def}forall}
ifelse
currentdict
end
exch setglobal
}bind def
/copyarray
{
currentglobal exch
dup gcheck setglobal
dup length array copy
exch setglobal
}bind def
/newencodedfont
{
currentglobal
{
SharedFontDirectory 3 index known
{SharedFontDirectory 3 index get/FontReferenced known}
{false}
ifelse
}
{
FontDirectory 3 index known
{FontDirectory 3 index get/FontReferenced known}
{
SharedFontDirectory 3 index known
{SharedFontDirectory 3 index get/FontReferenced known}
{false}
ifelse
}
ifelse
}
ifelse
dup
{
3 index findfont/FontReferenced get
2 index dup type/nametype eq
{findfont}
if ne
{pop false}
if
}
if
dup
{
1 index dup type/nametype eq
{findfont}
if
dup/CharStrings known
{
/CharStrings get length
4 index findfont/CharStrings get length
ne
{
pop false
}
if
}
{pop}
ifelse
}
if
{
pop
1 index findfont
/Encoding get exch
0 1 255
{2 copy get 3 index 3 1 roll put}
for
pop pop pop
}
{
currentglobal
4 1 roll
dup type/nametype eq
{findfont}
if
dup gcheck setglobal
dup dup maxlength 2 add dict
begin
exch
{
1 index/FID ne
2 index/Encoding ne and
{def}
{pop pop}
ifelse
}
forall
/FontReferenced exch def
/Encoding exch dup length array copy def
/FontName 1 index dup type/stringtype eq{cvn}if def dup
currentdict
end
definefont ct_VMDictPut
setglobal
}
ifelse
}bind def
/SetSubstituteStrategy
{
$SubstituteFont
begin
dup type/dicttype ne
{0 dict}
if
currentdict/$Strategies known
{
exch $Strategies exch
2 copy known
{
get
2 copy maxlength exch maxlength add dict
begin
{def}forall
{def}forall
currentdict
dup/$Init known
{dup/$Init get exec}
if
end
/$Strategy exch def
}
{pop pop pop}
ifelse
}
{pop pop}
ifelse
end
}bind def
/scff
{
$SubstituteFont
begin
dup type/stringtype eq
{dup length exch}
{null}
ifelse
/$sname exch def
/$slen exch def
/$inVMIndex
$sname null eq
{
1 index $str cvs
dup length $slen sub $slen getinterval cvn
}
{$sname}
ifelse def
end
{findfont}
@Stopped
{
dup length 8 add string exch
1 index 0(BadFont:)putinterval
1 index exch 8 exch dup length string cvs putinterval cvn
{findfont}
@Stopped
{pop/Courier findfont}
if
}
if
$SubstituteFont
begin
/$sname null def
/$slen 0 def
/$inVMIndex null def
end
}bind def
/isWidthsOnlyFont
{
dup/WidthsOnly known
{pop pop true}
{
dup/FDepVector known
{/FDepVector get{isWidthsOnlyFont dup{exit}if}forall}
{
dup/FDArray known
{/FDArray get{isWidthsOnlyFont dup{exit}if}forall}
{pop}
ifelse
}
ifelse
}
ifelse
}bind def
/ct_StyleDicts 4 dict dup begin
/Adobe-Japan1 4 dict dup begin
Level2?
{
/Serif
/HeiseiMin-W3-83pv-RKSJ-H/Font resourcestatus
{pop pop/HeiseiMin-W3}
{
/CIDFont/Category resourcestatus
{
pop pop
/HeiseiMin-W3/CIDFont resourcestatus
{pop pop/HeiseiMin-W3}
{/Ryumin-Light}
ifelse
}
{/Ryumin-Light}
ifelse
}
ifelse
def
/SansSerif
/HeiseiKakuGo-W5-83pv-RKSJ-H/Font resourcestatus
{pop pop/HeiseiKakuGo-W5}
{
/CIDFont/Category resourcestatus
{
pop pop
/HeiseiKakuGo-W5/CIDFont resourcestatus
{pop pop/HeiseiKakuGo-W5}
{/GothicBBB-Medium}
ifelse
}
{/GothicBBB-Medium}
ifelse
}
ifelse
def
/HeiseiMaruGo-W4-83pv-RKSJ-H/Font resourcestatus
{pop pop/HeiseiMaruGo-W4}
{
/CIDFont/Category resourcestatus
{
pop pop
/HeiseiMaruGo-W4/CIDFont resourcestatus
{pop pop/HeiseiMaruGo-W4}
{
/Jun101-Light-RKSJ-H/Font resourcestatus
{pop pop/Jun101-Light}
{SansSerif}
ifelse
}
ifelse
}
{
/Jun101-Light-RKSJ-H/Font resourcestatus
{pop pop/Jun101-Light}
{SansSerif}
ifelse
}
ifelse
}
ifelse
/RoundSansSerif exch def
/Default Serif def
}
{
/Serif/Ryumin-Light def
/SansSerif/GothicBBB-Medium def
{
(fonts/Jun101-Light-83pv-RKSJ-H)status
}stopped
{pop}{
{pop pop pop pop/Jun101-Light}
{SansSerif}
ifelse
/RoundSansSerif exch def
}ifelse
/Default Serif def
}
ifelse
end
def
/Adobe-Korea1 4 dict dup begin
/Serif/HYSMyeongJo-Medium def
/SansSerif/HYGoThic-Medium def
/RoundSansSerif SansSerif def
/Default Serif def
end
def
/Adobe-GB1 4 dict dup begin
/Serif/STSong-Light def
/SansSerif/STHeiti-Regular def
/RoundSansSerif SansSerif def
/Default Serif def
end
def
/Adobe-CNS1 4 dict dup begin
/Serif/MKai-Medium def
/SansSerif/MHei-Medium def
/RoundSansSerif SansSerif def
/Default Serif def
end
def
end
def
Level2?{currentglobal true setglobal}if
/ct_BoldRomanWidthProc
{
stringwidth 1 index 0 ne{exch .03 add exch}if setcharwidth
0 0
}bind def
/ct_Type0WidthProc
{
dup stringwidth 0 0 moveto
2 index true charpath pathbbox
0 -1
7 index 2 div .88
setcachedevice2
pop
0 0
}bind def
/ct_Type0WMode1WidthProc
{
dup stringwidth
pop 2 div neg -0.88
2 copy
moveto
0 -1
5 -1 roll true charpath pathbbox
setcachedevice
}bind def
/cHexEncoding
[/c00/c01/c02/c03/c04/c05/c06/c07/c08/c09/c0A/c0B/c0C/c0D/c0E/c0F/c10/c11/c12
/c13/c14/c15/c16/c17/c18/c19/c1A/c1B/c1C/c1D/c1E/c1F/c20/c21/c22/c23/c24/c25
/c26/c27/c28/c29/c2A/c2B/c2C/c2D/c2E/c2F/c30/c31/c32/c33/c34/c35/c36/c37/c38
/c39/c3A/c3B/c3C/c3D/c3E/c3F/c40/c41/c42/c43/c44/c45/c46/c47/c48/c49/c4A/c4B
/c4C/c4D/c4E/c4F/c50/c51/c52/c53/c54/c55/c56/c57/c58/c59/c5A/c5B/c5C/c5D/c5E
/c5F/c60/c61/c62/c63/c64/c65/c66/c67/c68/c69/c6A/c6B/c6C/c6D/c6E/c6F/c70/c71
/c72/c73/c74/c75/c76/c77/c78/c79/c7A/c7B/c7C/c7D/c7E/c7F/c80/c81/c82/c83/c84
/c85/c86/c87/c88/c89/c8A/c8B/c8C/c8D/c8E/c8F/c90/c91/c92/c93/c94/c95/c96/c97
/c98/c99/c9A/c9B/c9C/c9D/c9E/c9F/cA0/cA1/cA2/cA3/cA4/cA5/cA6/cA7/cA8/cA9/cAA
/cAB/cAC/cAD/cAE/cAF/cB0/cB1/cB2/cB3/cB4/cB5/cB6/cB7/cB8/cB9/cBA/cBB/cBC/cBD
/cBE/cBF/cC0/cC1/cC2/cC3/cC4/cC5/cC6/cC7/cC8/cC9/cCA/cCB/cCC/cCD/cCE/cCF/cD0
/cD1/cD2/cD3/cD4/cD5/cD6/cD7/cD8/cD9/cDA/cDB/cDC/cDD/cDE/cDF/cE0/cE1/cE2/cE3
/cE4/cE5/cE6/cE7/cE8/cE9/cEA/cEB/cEC/cED/cEE/cEF/cF0/cF1/cF2/cF3/cF4/cF5/cF6
/cF7/cF8/cF9/cFA/cFB/cFC/cFD/cFE/cFF]def
/ct_BoldBaseFont
11 dict begin
/FontType 3 def
/FontMatrix[1 0 0 1 0 0]def
/FontBBox[0 0 1 1]def
/Encoding cHexEncoding def
/_setwidthProc/ct_BoldRomanWidthProc load def
/_bcstr1 1 string def
/BuildChar
{
exch begin
_basefont setfont
_bcstr1 dup 0 4 -1 roll put
dup
_setwidthProc
3 copy
moveto
show
_basefonto setfont
moveto
show
end
}bind def
currentdict
end
def
systemdict/composefont known
{
/ct_DefineIdentity-H
{
/Identity-H/CMap resourcestatus
{
pop pop
}
{
/CIDInit/ProcSet findresource begin
12 dict begin
begincmap
/CIDSystemInfo 3 dict dup begin
/Registry(Adobe)def
/Ordering(Identity)def
/Supplement 0 def
end def
/CMapName/Identity-H def
/CMapVersion 1.000 def
/CMapType 1 def
1 begincodespacerange
<0000>
endcodespacerange
1 begincidrange
<0000>0
endcidrange
endcmap
CMapName currentdict/CMap defineresource pop
end
end
}
ifelse
}
def
/ct_BoldBaseCIDFont
11 dict begin
/CIDFontType 1 def
/CIDFontName/ct_BoldBaseCIDFont def
/FontMatrix[1 0 0 1 0 0]def
/FontBBox[0 0 1 1]def
/_setwidthProc/ct_Type0WidthProc load def
/_bcstr2 2 string def
/BuildGlyph
{
exch begin
_basefont setfont
_bcstr2 1 2 index 256 mod put
_bcstr2 0 3 -1 roll 256 idiv put
_bcstr2 dup _setwidthProc
3 copy
moveto
show
_basefonto setfont
moveto
show
end
}bind def
currentdict
end
def
}if
Level2?{setglobal}if
/ct_CopyFont{
{
1 index/FID ne 2 index/UniqueID ne and
{def}{pop pop}ifelse
}forall
}bind def
/ct_Type0CopyFont
{
exch
dup length dict
begin
ct_CopyFont
[
exch
FDepVector
{
dup/FontType get 0 eq
{
1 index ct_Type0CopyFont
/_ctType0 exch definefont
}
{
/_ctBaseFont exch
2 index exec
}
ifelse
exch
}
forall
pop
]
/FDepVector exch def
currentdict
end
}bind def
/ct_MakeBoldFont
{
dup/ct_SyntheticBold known
{
dup length 3 add dict begin
ct_CopyFont
/ct_StrokeWidth .03 0 FontMatrix idtransform pop def
/ct_SyntheticBold true def
currentdict
end
definefont
}
{
dup dup length 3 add dict
begin
ct_CopyFont
/PaintType 2 def
/StrokeWidth .03 0 FontMatrix idtransform pop def
/dummybold currentdict
end
definefont
dup/FontType get dup 9 ge exch 11 le and
{
ct_BoldBaseCIDFont
dup length 3 add dict copy begin
dup/CIDSystemInfo get/CIDSystemInfo exch def
ct_DefineIdentity-H
/_Type0Identity/Identity-H 3 -1 roll[exch]composefont
/_basefont exch def
/_Type0Identity/Identity-H 3 -1 roll[exch]composefont
/_basefonto exch def
currentdict
end
/CIDFont defineresource
}
{
ct_BoldBaseFont
dup length 3 add dict copy begin
/_basefont exch def
/_basefonto exch def
currentdict
end
definefont
}
ifelse
}
ifelse
}bind def
/ct_MakeBold{
1 index
1 index
findfont
currentglobal 5 1 roll
dup gcheck setglobal
dup
/FontType get 0 eq
{
dup/WMode known{dup/WMode get 1 eq}{false}ifelse
version length 4 ge
and
{version 0 4 getinterval cvi 2015 ge}
{true}
ifelse
{/ct_Type0WidthProc}
{/ct_Type0WMode1WidthProc}
ifelse
ct_BoldBaseFont/_setwidthProc 3 -1 roll load put
{ct_MakeBoldFont}ct_Type0CopyFont definefont
}
{
dup/_fauxfont known not 1 index/SubstMaster known not and
{
ct_BoldBaseFont/_setwidthProc /ct_BoldRomanWidthProc load put
ct_MakeBoldFont
}
{
2 index 2 index eq
{exch pop }
{
dup length dict begin
ct_CopyFont
currentdict
end
definefont
}
ifelse
}
ifelse
}
ifelse
pop pop pop
setglobal
}bind def
/?str1 256 string def
/?set
{
$SubstituteFont
begin
/$substituteFound false def
/$fontname 1 index def
/$doSmartSub false def
end
dup
findfont
$SubstituteFont
begin
$substituteFound
{false}
{
dup/FontName known
{
dup/FontName get $fontname eq
1 index/DistillerFauxFont known not and
/currentdistillerparams where
{pop false 2 index isWidthsOnlyFont not and}
if
}
{false}
ifelse
}
ifelse
exch pop
/$doSmartSub true def
end
{
5 1 roll pop pop pop pop
findfont
}
{
1 index
findfont
dup/FontType get 3 eq
{
6 1 roll pop pop pop pop pop false
}
{pop true}
ifelse
{
$SubstituteFont
begin
pop pop
/$styleArray 1 index def
/$regOrdering 2 index def
pop pop
0 1 $styleArray length 1 sub
{
$styleArray exch get
ct_StyleDicts $regOrdering
2 copy known
{
get
exch 2 copy known not
{pop/Default}
if
get
dup type/nametype eq
{
?str1 cvs length dup 1 add exch
?str1 exch(-)putinterval
exch dup length exch ?str1 exch 3 index exch putinterval
add ?str1 exch 0 exch getinterval cvn
}
{
pop pop/Unknown
}
ifelse
}
{
pop pop pop pop/Unknown
}
ifelse
}
for
end
findfont
}if
}
ifelse
currentglobal false setglobal 3 1 roll
null copyfont definefont pop
setglobal
}bind def
setpacking
userdict/$SubstituteFont 25 dict put
1 dict
begin
/SubstituteFont
dup $error exch 2 copy known
{get}
{pop pop{pop/Courier}bind}
ifelse def
/currentdistillerparams where dup
{
pop pop
currentdistillerparams/CannotEmbedFontPolicy 2 copy known
{get/Error eq}
{pop pop false}
ifelse
}
if not
{
countdictstack array dictstack 0 get
begin
userdict
begin
$SubstituteFont
begin
/$str 128 string def
/$fontpat 128 string def
/$slen 0 def
/$sname null def
/$match false def
/$fontname null def
/$substituteFound false def
/$inVMIndex null def
/$doSmartSub true def
/$depth 0 def
/$fontname null def
/$italicangle 26.5 def
/$dstack null def
/$Strategies 10 dict dup
begin
/$Type3Underprint
{
currentglobal exch false setglobal
11 dict
begin
/UseFont exch
$WMode 0 ne
{
dup length dict copy
dup/WMode $WMode put
/UseFont exch definefont
}
if def
/FontName $fontname dup type/stringtype eq{cvn}if def
/FontType 3 def
/FontMatrix[.001 0 0 .001 0 0]def
/Encoding 256 array dup 0 1 255{/.notdef put dup}for pop def
/FontBBox[0 0 0 0]def
/CCInfo 7 dict dup
begin
/cc null def
/x 0 def
/y 0 def
end def
/BuildChar
{
exch
begin
CCInfo
begin
1 string dup 0 3 index put exch pop
/cc exch def
UseFont 1000 scalefont setfont
cc stringwidth/y exch def/x exch def
x y setcharwidth
$SubstituteFont/$Strategy get/$Underprint get exec
0 0 moveto cc show
x y moveto
end
end
}bind def
currentdict
end
exch setglobal
}bind def
/$GetaTint
2 dict dup
begin
/$BuildFont
{
dup/WMode known
{dup/WMode get}
{0}
ifelse
/$WMode exch def
$fontname exch
dup/FontName known
{
dup/FontName get
dup type/stringtype eq{cvn}if
}
{/unnamedfont}
ifelse
exch
Adobe_CoolType_Data/InVMDeepCopiedFonts get
1 index/FontName get known
{
pop
Adobe_CoolType_Data/InVMDeepCopiedFonts get
1 index get
null copyfont
}
{$deepcopyfont}
ifelse
exch 1 index exch/FontBasedOn exch put
dup/FontName $fontname dup type/stringtype eq{cvn}if put
definefont
Adobe_CoolType_Data/InVMDeepCopiedFonts get
begin
dup/FontBasedOn get 1 index def
end
}bind def
/$Underprint
{
gsave
x abs y abs gt
{/y 1000 def}
{/x -1000 def 500 120 translate}
ifelse
Level2?
{
[/Separation(All)/DeviceCMYK{0 0 0 1 pop}]
setcolorspace
}
{0 setgray}
ifelse
10 setlinewidth
x .8 mul
[7 3]
{
y mul 8 div 120 sub x 10 div exch moveto
0 y 4 div neg rlineto
dup 0 rlineto
0 y 4 div rlineto
closepath
gsave
Level2?
{.2 setcolor}
{.8 setgray}
ifelse
fill grestore
stroke
}
forall
pop
grestore
}bind def
end def
/$Oblique
1 dict dup
begin
/$BuildFont
{
currentglobal exch dup gcheck setglobal
null copyfont
begin
/FontBasedOn
currentdict/FontName known
{
FontName
dup type/stringtype eq{cvn}if
}
{/unnamedfont}
ifelse
def
/FontName $fontname dup type/stringtype eq{cvn}if def
/currentdistillerparams where
{pop}
{
/FontInfo currentdict/FontInfo known
{FontInfo null copyfont}
{2 dict}
ifelse
dup
begin
/ItalicAngle $italicangle def
/FontMatrix FontMatrix
[1 0 ItalicAngle dup sin exch cos div 1 0 0]
matrix concatmatrix readonly
end
4 2 roll def
def
}
ifelse
FontName currentdict
end
definefont
exch setglobal
}bind def
end def
/$None
1 dict dup
begin
/$BuildFont{}bind def
end def
end def
/$Oblique SetSubstituteStrategy
/$findfontByEnum
{
dup type/stringtype eq{cvn}if
dup/$fontname exch def
$sname null eq
{$str cvs dup length $slen sub $slen getinterval}
{pop $sname}
ifelse
$fontpat dup 0(fonts/*)putinterval exch 7 exch putinterval
/$match false def
$SubstituteFont/$dstack countdictstack array dictstack put
mark
{
$fontpat 0 $slen 7 add getinterval
{/$match exch def exit}
$str filenameforall
}
stopped
{
cleardictstack
currentdict
true
$SubstituteFont/$dstack get
{
exch
{
1 index eq
{pop false}
{true}
ifelse
}
{begin false}
ifelse
}
forall
pop
}
if
cleartomark
/$slen 0 def
$match false ne
{$match(fonts/)anchorsearch pop pop cvn}
{/Courier}
ifelse
}bind def
/$ROS 1 dict dup
begin
/Adobe 4 dict dup
begin
/Japan1 [/Ryumin-Light/HeiseiMin-W3
/GothicBBB-Medium/HeiseiKakuGo-W5
/HeiseiMaruGo-W4/Jun101-Light]def
/Korea1 [/HYSMyeongJo-Medium/HYGoThic-Medium]def
/GB1 [/STSong-Light/STHeiti-Regular]def
/CNS1 [/MKai-Medium/MHei-Medium]def
end def
end def
/$cmapname null def
/$deepcopyfont
{
dup/FontType get 0 eq
{
1 dict dup/FontName/copied put copyfont
begin
/FDepVector FDepVector copyarray
0 1 2 index length 1 sub
{
2 copy get $deepcopyfont
dup/FontName/copied put
/copied exch definefont
3 copy put pop pop
}
for
def
currentdict
end
}
{$Strategies/$Type3Underprint get exec}
ifelse
}bind def
/$buildfontname
{
dup/CIDFont findresource/CIDSystemInfo get
begin
Registry length Ordering length Supplement 8 string cvs
3 copy length 2 add add add string
dup 5 1 roll dup 0 Registry putinterval
dup 4 index(-)putinterval
dup 4 index 1 add Ordering putinterval
4 2 roll add 1 add 2 copy(-)putinterval
end
1 add 2 copy 0 exch getinterval $cmapname $fontpat cvs exch
anchorsearch
{pop pop 3 2 roll putinterval cvn/$cmapname exch def}
{pop pop pop pop pop}
ifelse
length
$str 1 index(-)putinterval 1 add
$str 1 index $cmapname $fontpat cvs putinterval
$cmapname length add
$str exch 0 exch getinterval cvn
}bind def
/$findfontByROS
{
/$fontname exch def
$ROS Registry 2 copy known
{
get Ordering 2 copy known
{get}
{pop pop[]}
ifelse
}
{pop pop[]}
ifelse
false exch
{
dup/CIDFont resourcestatus
{
pop pop
save
1 index/CIDFont findresource
dup/WidthsOnly known
{dup/WidthsOnly get}
{false}
ifelse
exch pop
exch restore
{pop}
{exch pop true exit}
ifelse
}
{pop}
ifelse
}
forall
{$str cvs $buildfontname}
{
false(*)
{
save exch
dup/CIDFont findresource
dup/WidthsOnly known
{dup/WidthsOnly get not}
{true}
ifelse
exch/CIDSystemInfo get
dup/Registry get Registry eq
exch/Ordering get Ordering eq and and
{exch restore exch pop true exit}
{pop restore}
ifelse
}
$str/CIDFont resourceforall
{$buildfontname}
{$fontname $findfontByEnum}
ifelse
}
ifelse
}bind def
end
end
currentdict/$error known currentdict/languagelevel known and dup
{pop $error/SubstituteFont known}
if
dup
{$error}
{Adobe_CoolType_Core}
ifelse
begin
{
/SubstituteFont
/CMap/Category resourcestatus
{
pop pop
{
$SubstituteFont
begin
/$substituteFound true def
dup length $slen gt
$sname null ne or
$slen 0 gt and
{
$sname null eq
{dup $str cvs dup length $slen sub $slen getinterval cvn}
{$sname}
ifelse
Adobe_CoolType_Data/InVMFontsByCMap get
1 index 2 copy known
{
get
false exch
{
pop
currentglobal
{
GlobalFontDirectory 1 index known
{exch pop true exit}
{pop}
ifelse
}
{
FontDirectory 1 index known
{exch pop true exit}
{
GlobalFontDirectory 1 index known
{exch pop true exit}
{pop}
ifelse
}
ifelse
}
ifelse
}
forall
}
{pop pop false}
ifelse
{
exch pop exch pop
}
{
dup/CMap resourcestatus
{
pop pop
dup/$cmapname exch def
/CMap findresource/CIDSystemInfo get{def}forall
$findfontByROS
}
{
128 string cvs
dup(-)search
{
3 1 roll search
{
3 1 roll pop
{dup cvi}
stopped
{pop pop pop pop pop $findfontByEnum}
{
4 2 roll pop pop
exch length
exch
2 index length
2 index
sub
exch 1 sub -1 0
{
$str cvs dup length
4 index
0
4 index
4 3 roll add
getinterval
exch 1 index exch 3 index exch
putinterval
dup/CMap resourcestatus
{
pop pop
4 1 roll pop pop pop
dup/$cmapname exch def
/CMap findresource/CIDSystemInfo get{def}forall
$findfontByROS
true exit
}
{pop}
ifelse
}
for
dup type/booleantype eq
{pop}
{pop pop pop $findfontByEnum}
ifelse
}
ifelse
}
{pop pop pop $findfontByEnum}
ifelse
}
{pop pop $findfontByEnum}
ifelse
}
ifelse
}
ifelse
}
{//SubstituteFont exec}
ifelse
/$slen 0 def
end
}
}
{
{
$SubstituteFont
begin
/$substituteFound true def
dup length $slen gt
$sname null ne or
$slen 0 gt and
{$findfontByEnum}
{//SubstituteFont exec}
ifelse
end
}
}
ifelse
bind readonly def
Adobe_CoolType_Core/scfindfont/systemfindfont load put
}
{
/scfindfont
{
$SubstituteFont
begin
dup systemfindfont
dup/FontName known
{dup/FontName get dup 3 index ne}
{/noname true}
ifelse
dup
{
/$origfontnamefound 2 index def
/$origfontname 4 index def/$substituteFound true def
}
if
exch pop
{
$slen 0 gt
$sname null ne
3 index length $slen gt or and
{
pop dup $findfontByEnum findfont
dup maxlength 1 add dict
begin
{1 index/FID eq{pop pop}{def}ifelse}
forall
currentdict
end
definefont
dup/FontName known{dup/FontName get}{null}ifelse
$origfontnamefound ne
{
$origfontname $str cvs print
( substitution revised, using )print
dup/FontName known
{dup/FontName get}{(unspecified font)}
ifelse
$str cvs print(.\n)print
}
if
}
{exch pop}
ifelse
}
{exch pop}
ifelse
end
}bind def
}
ifelse
end
end
Adobe_CoolType_Core_Defined not
{
Adobe_CoolType_Core/findfont
{
$SubstituteFont
begin
$depth 0 eq
{
/$fontname 1 index dup type/stringtype ne{$str cvs}if def
/$substituteFound false def
}
if
/$depth $depth 1 add def
end
scfindfont
$SubstituteFont
begin
/$depth $depth 1 sub def
$substituteFound $depth 0 eq and
{
$inVMIndex null ne
{dup $inVMIndex $AddInVMFont}
if
$doSmartSub
{
currentdict/$Strategy known
{$Strategy/$BuildFont get exec}
if
}
if
}
if
end
}bind put
}
if
}
if
end
/$AddInVMFont
{
exch/FontName 2 copy known
{
get
1 dict dup begin exch 1 index gcheck def end exch
Adobe_CoolType_Data/InVMFontsByCMap get exch
$DictAdd
}
{pop pop pop}
ifelse
}bind def
/$DictAdd
{
2 copy known not
{2 copy 4 index length dict put}
if
Level2? not
{
2 copy get dup maxlength exch length 4 index length add lt
2 copy get dup length 4 index length add exch maxlength 1 index lt
{
2 mul dict
begin
2 copy get{forall}def
2 copy currentdict put
end
}
{pop}
ifelse
}
if
get
begin
{def}
forall
end
}bind def
end
end
%%EndResource
currentglobal true setglobal
%%BeginResource: procset Adobe_CoolType_Utility_MAKEOCF 1.23 0
%%Copyright: Copyright 1987-2006 Adobe Systems Incorporated.
%%Version: 1.23 0
systemdict/languagelevel known dup
{currentglobal false setglobal}
{false}
ifelse
exch
userdict/Adobe_CoolType_Utility 2 copy known
{2 copy get dup maxlength 27 add dict copy}
{27 dict}
ifelse put
Adobe_CoolType_Utility
begin
/@eexecStartData
def
/@recognizeCIDFont null def
/ct_Level2? exch def
/ct_Clone? 1183615869 internaldict dup
/CCRun known not
exch/eCCRun known not
ct_Level2? and or def
ct_Level2?
{globaldict begin currentglobal true setglobal}
if
/ct_AddStdCIDMap
ct_Level2?
{{
mark
Adobe_CoolType_Utility/@recognizeCIDFont currentdict put
{
((Hex)57 StartData
0615 1e27 2c39 1c60 d8a8 cc31 fe2b f6e0
7aa3 e541 e21c 60d8 a8c9 c3d0 6d9e 1c60
d8a8 c9c2 02d7 9a1c 60d8 a849 1c60 d8a8
cc36 74f4 1144 b13b 77)0()/SubFileDecode filter cvx exec
}
stopped
{
cleartomark
Adobe_CoolType_Utility/@recognizeCIDFont get
countdictstack dup array dictstack
exch 1 sub -1 0
{
2 copy get 3 index eq
{1 index length exch sub 1 sub{end}repeat exit}
{pop}
ifelse
}
for
pop pop
Adobe_CoolType_Utility/@eexecStartData get eexec
}
{cleartomark}
ifelse
}}
{{
Adobe_CoolType_Utility/@eexecStartData get eexec
}}
ifelse bind def
userdict/cid_extensions known
dup{cid_extensions/cid_UpdateDB known and}if
{
cid_extensions
begin
/cid_GetCIDSystemInfo
{
1 index type/stringtype eq
{exch cvn exch}
if
cid_extensions
begin
dup load 2 index known
{
2 copy
cid_GetStatusInfo
dup null ne
{
1 index load
3 index get
dup null eq
{pop pop cid_UpdateDB}
{
exch
1 index/Created get eq
{exch pop exch pop}
{pop cid_UpdateDB}
ifelse
}
ifelse
}
{pop cid_UpdateDB}
ifelse
}
{cid_UpdateDB}
ifelse
end
}bind def
end
}
if
ct_Level2?
{end setglobal}
if
/ct_UseNativeCapability? systemdict/composefont known def
/ct_MakeOCF 35 dict def
/ct_Vars 25 dict def
/ct_GlyphDirProcs 6 dict def
/ct_BuildCharDict 15 dict dup
begin
/charcode 2 string def
/dst_string 1500 string def
/nullstring()def
/usewidths? true def
end def
ct_Level2?{setglobal}{pop}ifelse
ct_GlyphDirProcs
begin
/GetGlyphDirectory
{
systemdict/languagelevel known
{pop/CIDFont findresource/GlyphDirectory get}
{
1 index/CIDFont findresource/GlyphDirectory
get dup type/dicttype eq
{
dup dup maxlength exch length sub 2 index lt
{
dup length 2 index add dict copy 2 index
/CIDFont findresource/GlyphDirectory 2 index put
}
if
}
if
exch pop exch pop
}
ifelse
+
}def
/+
{
systemdict/languagelevel known
{
currentglobal false setglobal
3 dict begin
/vm exch def
}
{1 dict begin}
ifelse
/$ exch def
systemdict/languagelevel known
{
vm setglobal
/gvm currentglobal def
$ gcheck setglobal
}
if
?{$ begin}if
}def
/?{$ type/dicttype eq}def
/|{
userdict/Adobe_CoolType_Data known
{
Adobe_CoolType_Data/AddWidths? known
{
currentdict Adobe_CoolType_Data
begin
begin
AddWidths?
{
Adobe_CoolType_Data/CC 3 index put
?{def}{$ 3 1 roll put}ifelse
CC charcode exch 1 index 0 2 index 256 idiv put
1 index exch 1 exch 256 mod put
stringwidth 2 array astore
currentfont/Widths get exch CC exch put
}
{?{def}{$ 3 1 roll put}ifelse}
ifelse
end
end
}
{?{def}{$ 3 1 roll put}ifelse} ifelse
}
{?{def}{$ 3 1 roll put}ifelse}
ifelse
}def
/!
{
?{end}if
systemdict/languagelevel known
{gvm setglobal}
if
end
}def
/:{string currentfile exch readstring pop}executeonly def
end
ct_MakeOCF
begin
/ct_cHexEncoding
[/c00/c01/c02/c03/c04/c05/c06/c07/c08/c09/c0A/c0B/c0C/c0D/c0E/c0F/c10/c11/c12
/c13/c14/c15/c16/c17/c18/c19/c1A/c1B/c1C/c1D/c1E/c1F/c20/c21/c22/c23/c24/c25
/c26/c27/c28/c29/c2A/c2B/c2C/c2D/c2E/c2F/c30/c31/c32/c33/c34/c35/c36/c37/c38
/c39/c3A/c3B/c3C/c3D/c3E/c3F/c40/c41/c42/c43/c44/c45/c46/c47/c48/c49/c4A/c4B
/c4C/c4D/c4E/c4F/c50/c51/c52/c53/c54/c55/c56/c57/c58/c59/c5A/c5B/c5C/c5D/c5E
/c5F/c60/c61/c62/c63/c64/c65/c66/c67/c68/c69/c6A/c6B/c6C/c6D/c6E/c6F/c70/c71
/c72/c73/c74/c75/c76/c77/c78/c79/c7A/c7B/c7C/c7D/c7E/c7F/c80/c81/c82/c83/c84
/c85/c86/c87/c88/c89/c8A/c8B/c8C/c8D/c8E/c8F/c90/c91/c92/c93/c94/c95/c96/c97
/c98/c99/c9A/c9B/c9C/c9D/c9E/c9F/cA0/cA1/cA2/cA3/cA4/cA5/cA6/cA7/cA8/cA9/cAA
/cAB/cAC/cAD/cAE/cAF/cB0/cB1/cB2/cB3/cB4/cB5/cB6/cB7/cB8/cB9/cBA/cBB/cBC/cBD
/cBE/cBF/cC0/cC1/cC2/cC3/cC4/cC5/cC6/cC7/cC8/cC9/cCA/cCB/cCC/cCD/cCE/cCF/cD0
/cD1/cD2/cD3/cD4/cD5/cD6/cD7/cD8/cD9/cDA/cDB/cDC/cDD/cDE/cDF/cE0/cE1/cE2/cE3
/cE4/cE5/cE6/cE7/cE8/cE9/cEA/cEB/cEC/cED/cEE/cEF/cF0/cF1/cF2/cF3/cF4/cF5/cF6
/cF7/cF8/cF9/cFA/cFB/cFC/cFD/cFE/cFF]def
/ct_CID_STR_SIZE 8000 def
/ct_mkocfStr100 100 string def
/ct_defaultFontMtx[.001 0 0 .001 0 0]def
/ct_1000Mtx[1000 0 0 1000 0 0]def
/ct_raise{exch cvx exch errordict exch get exec stop}bind def
/ct_reraise
{cvx $error/errorname get(Error: )print dup( )cvs print
errordict exch get exec stop
}bind def
/ct_cvnsi
{
1 index add 1 sub 1 exch 0 4 1 roll
{
2 index exch get
exch 8 bitshift
add
}
for
exch pop
}bind def
/ct_GetInterval
{
Adobe_CoolType_Utility/ct_BuildCharDict get
begin
/dst_index 0 def
dup dst_string length gt
{dup string/dst_string exch def}
if
1 index ct_CID_STR_SIZE idiv
/arrayIndex exch def
2 index arrayIndex get
2 index
arrayIndex ct_CID_STR_SIZE mul
sub
{
dup 3 index add 2 index length le
{
2 index getinterval
dst_string dst_index 2 index putinterval
length dst_index add/dst_index exch def
exit
}
{
1 index length 1 index sub
dup 4 1 roll
getinterval
dst_string dst_index 2 index putinterval
pop dup dst_index add/dst_index exch def
sub
/arrayIndex arrayIndex 1 add def
2 index dup length arrayIndex gt
{arrayIndex get}
{
pop
exit
}
ifelse
0
}
ifelse
}
loop
pop pop pop
dst_string 0 dst_index getinterval
end
}bind def
ct_Level2?
{
/ct_resourcestatus
currentglobal mark true setglobal
{/unknowninstancename/Category resourcestatus}
stopped
{cleartomark setglobal true}
{cleartomark currentglobal not exch setglobal}
ifelse
{
{
mark 3 1 roll/Category findresource
begin
ct_Vars/vm currentglobal put
({ResourceStatus}stopped)0()/SubFileDecode filter cvx exec
{cleartomark false}
{{3 2 roll pop true}{cleartomark false}ifelse}
ifelse
ct_Vars/vm get setglobal
end
}
}
{{resourcestatus}}
ifelse bind def
/CIDFont/Category ct_resourcestatus
{pop pop}
{
currentglobal true setglobal
/Generic/Category findresource
dup length dict copy
dup/InstanceType/dicttype put
/CIDFont exch/Category defineresource pop
setglobal
}
ifelse
ct_UseNativeCapability?
{
/CIDInit/ProcSet findresource begin
12 dict begin
begincmap
/CIDSystemInfo 3 dict dup begin
/Registry(Adobe)def
/Ordering(Identity)def
/Supplement 0 def
end def
/CMapName/Identity-H def
/CMapVersion 1.000 def
/CMapType 1 def
1 begincodespacerange
<0000>
endcodespacerange
1 begincidrange
<0000>0
endcidrange
endcmap
CMapName currentdict/CMap defineresource pop
end
end
}
if
}
{
/ct_Category 2 dict begin
/CIDFont 10 dict def
/ProcSet 2 dict def
currentdict
end
def
/defineresource
{
ct_Category 1 index 2 copy known
{
get
dup dup maxlength exch length eq
{
dup length 10 add dict copy
ct_Category 2 index 2 index put
}
if
3 index 3 index put
pop exch pop
}
{pop pop/defineresource/undefined ct_raise}
ifelse
}bind def
/findresource
{
ct_Category 1 index 2 copy known
{
get
2 index 2 copy known
{get 3 1 roll pop pop}
{pop pop/findresource/undefinedresource ct_raise}
ifelse
}
{pop pop/findresource/undefined ct_raise}
ifelse
}bind def
/resourcestatus
{
ct_Category 1 index 2 copy known
{
get
2 index known
exch pop exch pop
{
0 -1 true
}
{
false
}
ifelse
}
{pop pop/findresource/undefined ct_raise}
ifelse
}bind def
/ct_resourcestatus/resourcestatus load def
}
ifelse
/ct_CIDInit 2 dict
begin
/ct_cidfont_stream_init
{
{
dup(Binary)eq
{
pop
null
currentfile
ct_Level2?
{
{cid_BYTE_COUNT()/SubFileDecode filter}
stopped
{pop pop pop}
if
}
if
/readstring load
exit
}
if
dup(Hex)eq
{
pop
currentfile
ct_Level2?
{
{null exch/ASCIIHexDecode filter/readstring}
stopped
{pop exch pop(>)exch/readhexstring}
if
}
{(>)exch/readhexstring}
ifelse
load
exit
}
if
/StartData/typecheck ct_raise
}
loop
cid_BYTE_COUNT ct_CID_STR_SIZE le
{
2 copy cid_BYTE_COUNT string exch exec
pop
1 array dup
3 -1 roll
0 exch put
}
{
cid_BYTE_COUNT ct_CID_STR_SIZE div ceiling cvi
dup array exch 2 sub 0 exch 1 exch
{
2 copy
5 index
ct_CID_STR_SIZE
string
6 index exec
pop
put
pop
}
for
2 index
cid_BYTE_COUNT ct_CID_STR_SIZE mod string
3 index exec
pop
1 index exch
1 index length 1 sub
exch put
}
ifelse
cid_CIDFONT exch/GlyphData exch put
2 index null eq
{
pop pop pop
}
{
pop/readstring load
1 string exch
{
3 copy exec
pop
dup length 0 eq
{
pop pop pop pop pop
true exit
}
if
4 index
eq
{
pop pop pop pop
false exit
}
if
}
loop
pop
}
ifelse
}bind def
/StartData
{
mark
{
currentdict
dup/FDArray get 0 get/FontMatrix get
0 get 0.001 eq
{
dup/CDevProc known not
{
/CDevProc 1183615869 internaldict/stdCDevProc 2 copy known
{get}
{
pop pop
{pop pop pop pop pop 0 -1000 7 index 2 div 880}
}
ifelse
def
}
if
}
{
/CDevProc
{
pop pop pop pop pop
0
1 cid_temp/cid_CIDFONT get
/FDArray get 0 get
/FontMatrix get 0 get div
7 index 2 div
1 index 0.88 mul
}def
}
ifelse
/cid_temp 15 dict def
cid_temp
begin
/cid_CIDFONT exch def
3 copy pop
dup/cid_BYTE_COUNT exch def 0 gt
{
ct_cidfont_stream_init
FDArray
{
/Private get
dup/SubrMapOffset known
{
begin
/Subrs SubrCount array def
Subrs
SubrMapOffset
SubrCount
SDBytes
ct_Level2?
{
currentdict dup/SubrMapOffset undef
dup/SubrCount undef
/SDBytes undef
}
if
end
/cid_SD_BYTES exch def
/cid_SUBR_COUNT exch def
/cid_SUBR_MAP_OFFSET exch def
/cid_SUBRS exch def
cid_SUBR_COUNT 0 gt
{
GlyphData cid_SUBR_MAP_OFFSET cid_SD_BYTES ct_GetInterval
0 cid_SD_BYTES ct_cvnsi
0 1 cid_SUBR_COUNT 1 sub
{
exch 1 index
1 add
cid_SD_BYTES mul cid_SUBR_MAP_OFFSET add
GlyphData exch cid_SD_BYTES ct_GetInterval
0 cid_SD_BYTES ct_cvnsi
cid_SUBRS 4 2 roll
GlyphData exch
4 index
1 index
sub
ct_GetInterval
dup length string copy put
}
for
pop
}
if
}
{pop}
ifelse
}
forall
}
if
cleartomark pop pop
end
CIDFontName currentdict/CIDFont defineresource pop
end end
}
stopped
{cleartomark/StartData ct_reraise}
if
}bind def
currentdict
end def
/ct_saveCIDInit
{
/CIDInit/ProcSet ct_resourcestatus
{true}
{/CIDInitC/ProcSet ct_resourcestatus}
ifelse
{
pop pop
/CIDInit/ProcSet findresource
ct_UseNativeCapability?
{pop null}
{/CIDInit ct_CIDInit/ProcSet defineresource pop}
ifelse
}
{/CIDInit ct_CIDInit/ProcSet defineresource pop null}
ifelse
ct_Vars exch/ct_oldCIDInit exch put
}bind def
/ct_restoreCIDInit
{
ct_Vars/ct_oldCIDInit get dup null ne
{/CIDInit exch/ProcSet defineresource pop}
{pop}
ifelse
}bind def
/ct_BuildCharSetUp
{
1 index
begin
CIDFont
begin
Adobe_CoolType_Utility/ct_BuildCharDict get
begin
/ct_dfCharCode exch def
/ct_dfDict exch def
CIDFirstByte ct_dfCharCode add
dup CIDCount ge
{pop 0}
if
/cid exch def
{
GlyphDirectory cid 2 copy known
{get}
{pop pop nullstring}
ifelse
dup length FDBytes sub 0 gt
{
dup
FDBytes 0 ne
{0 FDBytes ct_cvnsi}
{pop 0}
ifelse
/fdIndex exch def
dup length FDBytes sub FDBytes exch getinterval
/charstring exch def
exit
}
{
pop
cid 0 eq
{/charstring nullstring def exit}
if
/cid 0 def
}
ifelse
}
loop
}def
/ct_SetCacheDevice
{
0 0 moveto
dup stringwidth
3 -1 roll
true charpath
pathbbox
0 -1000
7 index 2 div 880
setcachedevice2
0 0 moveto
}def
/ct_CloneSetCacheProc
{
1 eq
{
stringwidth
pop -2 div -880
0 -1000 setcharwidth
moveto
}
{
usewidths?
{
currentfont/Widths get cid
2 copy known
{get exch pop aload pop}
{pop pop stringwidth}
ifelse
}
{stringwidth}
ifelse
setcharwidth
0 0 moveto
}
ifelse
}def
/ct_Type3ShowCharString
{
ct_FDDict fdIndex 2 copy known
{get}
{
currentglobal 3 1 roll
1 index gcheck setglobal
ct_Type1FontTemplate dup maxlength dict copy
begin
FDArray fdIndex get
dup/FontMatrix 2 copy known
{get}
{pop pop ct_defaultFontMtx}
ifelse
/FontMatrix exch dup length array copy def
/Private get
/Private exch def
/Widths rootfont/Widths get def
/CharStrings 1 dict dup/.notdef
dup length string copy put def
currentdict
end
/ct_Type1Font exch definefont
dup 5 1 roll put
setglobal
}
ifelse
dup/CharStrings get 1 index/Encoding get
ct_dfCharCode get charstring put
rootfont/WMode 2 copy known
{get}
{pop pop 0}
ifelse
exch
1000 scalefont setfont
ct_str1 0 ct_dfCharCode put
ct_str1 exch ct_dfSetCacheProc
ct_SyntheticBold
{
currentpoint
ct_str1 show
newpath
moveto
ct_str1 true charpath
ct_StrokeWidth setlinewidth
stroke
}
{ct_str1 show}
ifelse
}def
/ct_Type4ShowCharString
{
ct_dfDict ct_dfCharCode charstring
FDArray fdIndex get
dup/FontMatrix get dup ct_defaultFontMtx ct_matrixeq not
{ct_1000Mtx matrix concatmatrix concat}
{pop}
ifelse
/Private get
Adobe_CoolType_Utility/ct_Level2? get not
{
ct_dfDict/Private
3 -1 roll
{put}
1183615869 internaldict/superexec get exec
}
if
1183615869 internaldict
Adobe_CoolType_Utility/ct_Level2? get
{1 index}
{3 index/Private get mark 6 1 roll}
ifelse
dup/RunInt known
{/RunInt get}
{pop/CCRun}
ifelse
get exec
Adobe_CoolType_Utility/ct_Level2? get not
{cleartomark}
if
}bind def
/ct_BuildCharIncremental
{
{
Adobe_CoolType_Utility/ct_MakeOCF get begin
ct_BuildCharSetUp
ct_ShowCharString
}
stopped
{stop}
if
end
end
end
end
}bind def
/BaseFontNameStr(BF00)def
/ct_Type1FontTemplate 14 dict
begin
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0]def
/FontBBox [-250 -250 1250 1250]def
/Encoding ct_cHexEncoding def
/PaintType 0 def
currentdict
end def
/BaseFontTemplate 11 dict
begin
/FontMatrix [0.001 0 0 0.001 0 0]def
/FontBBox [-250 -250 1250 1250]def
/Encoding ct_cHexEncoding def
/BuildChar/ct_BuildCharIncremental load def
ct_Clone?
{
/FontType 3 def
/ct_ShowCharString/ct_Type3ShowCharString load def
/ct_dfSetCacheProc/ct_CloneSetCacheProc load def
/ct_SyntheticBold false def
/ct_StrokeWidth 1 def
}
{
/FontType 4 def
/Private 1 dict dup/lenIV 4 put def
/CharStrings 1 dict dup/.notdefput def
/PaintType 0 def
/ct_ShowCharString/ct_Type4ShowCharString load def
}
ifelse
/ct_str1 1 string def
currentdict
end def
/BaseFontDictSize BaseFontTemplate length 5 add def
/ct_matrixeq
{
true 0 1 5
{
dup 4 index exch get exch 3 index exch get eq and
dup not
{exit}
if
}
for
exch pop exch pop
}bind def
/ct_makeocf
{
15 dict
begin
exch/WMode exch def
exch/FontName exch def
/FontType 0 def
/FMapType 2 def
dup/FontMatrix known
{dup/FontMatrix get/FontMatrix exch def}
{/FontMatrix matrix def}
ifelse
/bfCount 1 index/CIDCount get 256 idiv 1 add
dup 256 gt{pop 256}if def
/Encoding
256 array 0 1 bfCount 1 sub{2 copy dup put pop}for
bfCount 1 255{2 copy bfCount put pop}for
def
/FDepVector bfCount dup 256 lt{1 add}if array def
BaseFontTemplate BaseFontDictSize dict copy
begin
/CIDFont exch def
CIDFont/FontBBox known
{CIDFont/FontBBox get/FontBBox exch def}
if
CIDFont/CDevProc known
{CIDFont/CDevProc get/CDevProc exch def}
if
currentdict
end
BaseFontNameStr 3(0)putinterval
0 1 bfCount dup 256 eq{1 sub}if
{
FDepVector exch
2 index BaseFontDictSize dict copy
begin
dup/CIDFirstByte exch 256 mul def
FontType 3 eq
{/ct_FDDict 2 dict def}
if
currentdict
end
1 index 16
BaseFontNameStr 2 2 getinterval cvrs pop
BaseFontNameStr exch definefont
put
}
for
ct_Clone?
{/Widths 1 index/CIDFont get/GlyphDirectory get length dict def}
if
FontName
currentdict
end
definefont
ct_Clone?
{
gsave
dup 1000 scalefont setfont
ct_BuildCharDict
begin
/usewidths? false def
currentfont/Widths get
begin
exch/CIDFont get/GlyphDirectory get
{
pop
dup charcode exch 1 index 0 2 index 256 idiv put
1 index exch 1 exch 256 mod put
stringwidth 2 array astore def
}
forall
end
/usewidths? true def
end
grestore
}
{exch pop}
ifelse
}bind def
currentglobal true setglobal
/ct_ComposeFont
{
ct_UseNativeCapability?
{
2 index/CMap ct_resourcestatus
{pop pop exch pop}
{
/CIDInit/ProcSet findresource
begin
12 dict
begin
begincmap
/CMapName 3 index def
/CMapVersion 1.000 def
/CMapType 1 def
exch/WMode exch def
/CIDSystemInfo 3 dict dup
begin
/Registry(Adobe)def
/Ordering
CMapName ct_mkocfStr100 cvs
(Adobe-)search
{
pop pop
(-)search
{
dup length string copy
exch pop exch pop
}
{pop(Identity)}
ifelse
}
{pop (Identity)}
ifelse
def
/Supplement 0 def
end def
1 begincodespacerange
<0000>
endcodespacerange
1 begincidrange
<0000>0
endcidrange
endcmap
CMapName currentdict/CMap defineresource pop
end
end
}
ifelse
composefont
}
{
3 2 roll pop
0 get/CIDFont findresource
ct_makeocf
}
ifelse
}bind def
setglobal
/ct_MakeIdentity
{
ct_UseNativeCapability?
{
1 index/CMap ct_resourcestatus
{pop pop}
{
/CIDInit/ProcSet findresource begin
12 dict begin
begincmap
/CMapName 2 index def
/CMapVersion 1.000 def
/CMapType 1 def
/CIDSystemInfo 3 dict dup
begin
/Registry(Adobe)def
/Ordering
CMapName ct_mkocfStr100 cvs
(Adobe-)search
{
pop pop
(-)search
{dup length string copy exch pop exch pop}
{pop(Identity)}
ifelse
}
{pop(Identity)}
ifelse
def
/Supplement 0 def
end def
1 begincodespacerange
<0000>
endcodespacerange
1 begincidrange
<0000>0
endcidrange
endcmap
CMapName currentdict/CMap defineresource pop
end
end
}
ifelse
composefont
}
{
exch pop
0 get/CIDFont findresource
ct_makeocf
}
ifelse
}bind def
currentdict readonly pop
end
end
%%EndResource
setglobal
%%BeginResource: procset Adobe_CoolType_Utility_T42 1.0 0
%%Copyright: Copyright 1987-2004 Adobe Systems Incorporated.
%%Version: 1.0 0
userdict/ct_T42Dict 15 dict put
ct_T42Dict begin
/Is2015?
{
version
cvi
2015
ge
}bind def
/AllocGlyphStorage
{
Is2015?
{
pop
}
{
{string}forall
}ifelse
}bind def
/Type42DictBegin
{
25 dict begin
/FontName exch def
/CharStrings 256 dict
begin
/.notdef 0 def
currentdict
end def
/Encoding exch def
/PaintType 0 def
/FontType 42 def
/FontMatrix[1 0 0 1 0 0]def
4 array astore cvx/FontBBox exch def
/sfnts
}bind def
/Type42DictEnd
{
currentdict dup/FontName get exch definefont end
ct_T42Dict exch
dup/FontName get exch put
}bind def
/RD{string currentfile exch readstring pop}executeonly def
/PrepFor2015
{
Is2015?
{
/GlyphDirectory
16
dict def
sfnts 0 get
dup
2 index
(glyx)
putinterval
2 index
(locx)
putinterval
pop
pop
}
{
pop
pop
}ifelse
}bind def
/AddT42Char
{
Is2015?
{
/GlyphDirectory get
begin
def
end
pop
pop
}
{
/sfnts get
4 index
get
3 index
2 index
putinterval
pop
pop
pop
pop
}ifelse
}bind def
/T0AddT42Mtx2
{
/CIDFont findresource/Metrics2 get begin def end
}bind def
end
%%EndResource
currentglobal true setglobal
%%BeginFile: MMFauxFont.prc
%%Copyright: Copyright 1987-2001 Adobe Systems Incorporated.
%%All Rights Reserved.
userdict /ct_EuroDict 10 dict put
ct_EuroDict begin
/ct_CopyFont
{
{ 1 index /FID ne {def} {pop pop} ifelse} forall
} def
/ct_GetGlyphOutline
{
gsave
initmatrix newpath
exch findfont dup
length 1 add dict
begin
ct_CopyFont
/Encoding Encoding dup length array copy
dup
4 -1 roll
0 exch put
def
currentdict
end
/ct_EuroFont exch definefont
1000 scalefont setfont
0 0 moveto
[
<00> stringwidth
<00> false charpath
pathbbox
[
{/m cvx} {/l cvx} {/c cvx} {/cp cvx} pathforall
grestore
counttomark 8 add
}
def
/ct_MakeGlyphProc
{
] cvx
/ct_PSBuildGlyph cvx
] cvx
} def
/ct_PSBuildGlyph
{
gsave
8 -1 roll pop
7 1 roll
6 -2 roll ct_FontMatrix transform 6 2 roll
4 -2 roll ct_FontMatrix transform 4 2 roll
ct_FontMatrix transform
currentdict /PaintType 2 copy known {get 2 eq}{pop pop false} ifelse
dup 9 1 roll
{
currentdict /StrokeWidth 2 copy known
{
get 2 div
0 ct_FontMatrix dtransform pop
5 1 roll
4 -1 roll 4 index sub
4 1 roll
3 -1 roll 4 index sub
3 1 roll
exch 4 index add exch
4 index add
5 -1 roll pop
}
{
pop pop
}
ifelse
}
if
setcachedevice
ct_FontMatrix concat
ct_PSPathOps begin
exec
end
{
currentdict /StrokeWidth 2 copy known
{ get }
{ pop pop 0 }
ifelse
setlinewidth stroke
}
{
fill
}
ifelse
grestore
} def
/ct_PSPathOps 4 dict dup begin
/m {moveto} def
/l {lineto} def
/c {curveto} def
/cp {closepath} def
end
def
/ct_matrix1000 [1000 0 0 1000 0 0] def
/ct_AddGlyphProc
{
2 index findfont dup length 4 add dict
begin
ct_CopyFont
/CharStrings CharStrings dup length 1 add dict copy
begin
3 1 roll def
currentdict
end
def
/ct_FontMatrix ct_matrix1000 FontMatrix matrix concatmatrix def
/ct_PSBuildGlyph /ct_PSBuildGlyph load def
/ct_PSPathOps /ct_PSPathOps load def
currentdict
end
definefont pop
}
def
systemdict /languagelevel known
{
/ct_AddGlyphToPrinterFont {
2 copy
ct_GetGlyphOutline 3 add -1 roll restore
ct_MakeGlyphProc
ct_AddGlyphProc
} def
}
{
/ct_AddGlyphToPrinterFont {
pop pop restore
Adobe_CTFauxDict /$$$FONTNAME get
/Euro
Adobe_CTFauxDict /$$$SUBSTITUTEBASE get
ct_EuroDict exch get
ct_AddGlyphProc
} def
} ifelse
/AdobeSansMM
{
556 0 24 -19 541 703
{
541 628 m
510 669 442 703 354 703 c
201 703 117 607 101 444 c
50 444 l
25 372 l
97 372 l
97 301 l
49 301 l
24 229 l
103 229 l
124 67 209 -19 350 -19 c
435 -19 501 25 509 32 c
509 131 l
492 105 417 60 343 60 c
267 60 204 127 197 229 c
406 229 l
430 301 l
191 301 l
191 372 l
455 372 l
479 444 l
194 444 l
201 531 245 624 348 624 c
433 624 484 583 509 534 c
cp
556 0 m
}
ct_PSBuildGlyph
} def
/AdobeSerifMM
{
500 0 10 -12 484 692
{
347 298 m
171 298 l
170 310 170 322 170 335 c
170 362 l
362 362 l
374 403 l
172 403 l
184 580 244 642 308 642 c
380 642 434 574 457 457 c
481 462 l
474 691 l
449 691 l
433 670 429 657 410 657 c
394 657 360 692 299 692 c
204 692 94 604 73 403 c
22 403 l
10 362 l
70 362 l
69 352 69 341 69 330 c
69 319 69 308 70 298 c
22 298 l
10 257 l
73 257 l
97 57 216 -12 295 -12 c
364 -12 427 25 484 123 c
458 142 l
425 101 384 37 316 37 c
256 37 189 84 173 257 c
335 257 l
cp
500 0 m
}
ct_PSBuildGlyph
} def
end
%%EndFile
setglobal
Adobe_CoolType_Core begin /$Oblique SetSubstituteStrategy end
%%BeginResource: procset Adobe_AGM_Image 1.0 0
%%Version: 1.0 0
%%Copyright: Copyright(C)2000-2006 Adobe Systems, Inc. All Rights Reserved.
systemdict/setpacking known
{
currentpacking
true setpacking
}if
userdict/Adobe_AGM_Image 71 dict dup begin put
/Adobe_AGM_Image_Id/Adobe_AGM_Image_1.0_0 def
/nd{
null def
}bind def
/AGMIMG_&image nd
/AGMIMG_&colorimage nd
/AGMIMG_&imagemask nd
/AGMIMG_mbuf()def
/AGMIMG_ybuf()def
/AGMIMG_kbuf()def
/AGMIMG_c 0 def
/AGMIMG_m 0 def
/AGMIMG_y 0 def
/AGMIMG_k 0 def
/AGMIMG_tmp nd
/AGMIMG_imagestring0 nd
/AGMIMG_imagestring1 nd
/AGMIMG_imagestring2 nd
/AGMIMG_imagestring3 nd
/AGMIMG_imagestring4 nd
/AGMIMG_imagestring5 nd
/AGMIMG_cnt nd
/AGMIMG_fsave nd
/AGMIMG_colorAry nd
/AGMIMG_override nd
/AGMIMG_name nd
/AGMIMG_maskSource nd
/AGMIMG_flushfilters nd
/invert_image_samples nd
/knockout_image_samples nd
/img nd
/sepimg nd
/devnimg nd
/idximg nd
/ds
{
Adobe_AGM_Core begin
Adobe_AGM_Image begin
/AGMIMG_&image systemdict/image get def
/AGMIMG_&imagemask systemdict/imagemask get def
/colorimage where{
pop
/AGMIMG_&colorimage/colorimage ldf
}if
end
end
}def
/ps
{
Adobe_AGM_Image begin
/AGMIMG_ccimage_exists{/customcolorimage where
{
pop
/Adobe_AGM_OnHost_Seps where
{
pop false
}{
/Adobe_AGM_InRip_Seps where
{
pop false
}{
true
}ifelse
}ifelse
}{
false
}ifelse
}bdf
level2{
/invert_image_samples
{
Adobe_AGM_Image/AGMIMG_tmp Decode length ddf
/Decode[Decode 1 get Decode 0 get]def
}def
/knockout_image_samples
{
Operator/imagemask ne{
/Decode[1 1]def
}if
}def
}{
/invert_image_samples
{
{1 exch sub}currenttransfer addprocs settransfer
}def
/knockout_image_samples
{
{pop 1}currenttransfer addprocs settransfer
}def
}ifelse
/img/imageormask ldf
/sepimg/sep_imageormask ldf
/devnimg/devn_imageormask ldf
/idximg/indexed_imageormask ldf
/_ctype 7 def
currentdict{
dup xcheck 1 index type dup/arraytype eq exch/packedarraytype eq or and{
bind
}if
def
}forall
}def
/pt
{
end
}def
/dt
{
}def
/AGMIMG_flushfilters
{
dup type/arraytype ne
{1 array astore}if
dup 0 get currentfile ne
{dup 0 get flushfile}if
{
dup type/filetype eq
{
dup status 1 index currentfile ne and
{closefile}
{pop}
ifelse
}{pop}ifelse
}forall
}def
/AGMIMG_init_common
{
currentdict/T known{/ImageType/T ldf currentdict/T undef}if
currentdict/W known{/Width/W ldf currentdict/W undef}if
currentdict/H known{/Height/H ldf currentdict/H undef}if
currentdict/M known{/ImageMatrix/M ldf currentdict/M undef}if
currentdict/BC known{/BitsPerComponent/BC ldf currentdict/BC undef}if
currentdict/D known{/Decode/D ldf currentdict/D undef}if
currentdict/DS known{/DataSource/DS ldf currentdict/DS undef}if
currentdict/O known{
/Operator/O load 1 eq{
/imagemask
}{
/O load 2 eq{
/image
}{
/colorimage
}ifelse
}ifelse
def
currentdict/O undef
}if
currentdict/HSCI known{/HostSepColorImage/HSCI ldf currentdict/HSCI undef}if
currentdict/MD known{/MultipleDataSources/MD ldf currentdict/MD undef}if
currentdict/I known{/Interpolate/I ldf currentdict/I undef}if
currentdict/SI known{/SkipImageProc/SI ldf currentdict/SI undef}if
/DataSource load xcheck not{
DataSource type/arraytype eq{
DataSource 0 get type/filetype eq{
/_Filters DataSource def
currentdict/MultipleDataSources known not{
/DataSource DataSource dup length 1 sub get def
}if
}if
}if
currentdict/MultipleDataSources known not{
/MultipleDataSources DataSource type/arraytype eq{
DataSource length 1 gt
}
{false}ifelse def
}if
}if
/NComponents Decode length 2 div def
currentdict/SkipImageProc known not{/SkipImageProc{false}def}if
}bdf
/imageormask_sys
{
begin
AGMIMG_init_common
save mark
level2{
currentdict
Operator/imagemask eq{
AGMIMG_&imagemask
}{
use_mask{
process_mask AGMIMG_&image
}{
AGMIMG_&image
}ifelse
}ifelse
}{
Width Height
Operator/imagemask eq{
Decode 0 get 1 eq Decode 1 get 0 eq and
ImageMatrix/DataSource load
AGMIMG_&imagemask
}{
BitsPerComponent ImageMatrix/DataSource load
AGMIMG_&image
}ifelse
}ifelse
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
cleartomark restore
end
}def
/overprint_plate
{
currentoverprint{
0 get dup type/nametype eq{
dup/DeviceGray eq{
pop AGMCORE_black_plate not
}{
/DeviceCMYK eq{
AGMCORE_is_cmyk_sep not
}if
}ifelse
}{
false exch
{
AGMOHS_sepink eq or
}forall
not
}ifelse
}{
pop false
}ifelse
}def
/process_mask
{
level3{
dup begin
/ImageType 1 def
end
4 dict begin
/DataDict exch def
/ImageType 3 def
/InterleaveType 3 def
/MaskDict 9 dict begin
/ImageType 1 def
/Width DataDict dup/MaskWidth known{/MaskWidth}{/Width}ifelse get def
/Height DataDict dup/MaskHeight known{/MaskHeight}{/Height}ifelse get def
/ImageMatrix[Width 0 0 Height neg 0 Height]def
/NComponents 1 def
/BitsPerComponent 1 def
/Decode DataDict dup/MaskD known{/MaskD}{[1 0]}ifelse get def
/DataSource Adobe_AGM_Core/AGMIMG_maskSource get def
currentdict end def
currentdict end
}if
}def
/use_mask
{
dup/Mask known {dup/Mask get}{false}ifelse
}def
/imageormask
{
begin
AGMIMG_init_common
SkipImageProc{
currentdict consumeimagedata
}
{
save mark
level2 AGMCORE_host_sep not and{
currentdict
Operator/imagemask eq DeviceN_PS2 not and{
imagemask
}{
AGMCORE_in_rip_sep currentoverprint and currentcolorspace 0 get/DeviceGray eq and{
[/Separation/Black/DeviceGray{}]setcolorspace
/Decode[Decode 1 get Decode 0 get]def
}if
use_mask{
process_mask image
}{
DeviceN_NoneName DeviceN_PS2 Indexed_DeviceN level3 not and or or AGMCORE_in_rip_sep and
{
Names convert_to_process not{
2 dict begin
/imageDict xdf
/names_index 0 def
gsave
imageDict write_image_file{
Names{
dup(None)ne{
[/Separation 3 -1 roll/DeviceGray{1 exch sub}]setcolorspace
Operator imageDict read_image_file
names_index 0 eq{true setoverprint}if
/names_index names_index 1 add def
}{
pop
}ifelse
}forall
close_image_file
}if
grestore
end
}{
Operator/imagemask eq{
imagemask
}{
image
}ifelse
}ifelse
}{
Operator/imagemask eq{
imagemask
}{
image
}ifelse
}ifelse
}ifelse
}ifelse
}{
Width Height
Operator/imagemask eq{
Decode 0 get 1 eq Decode 1 get 0 eq and
ImageMatrix/DataSource load
/Adobe_AGM_OnHost_Seps where{
pop imagemask
}{
currentgray 1 ne{
currentdict imageormask_sys
}{
currentoverprint not{
1 AGMCORE_&setgray
currentdict imageormask_sys
}{
currentdict ignoreimagedata
}ifelse
}ifelse
}ifelse
}{
BitsPerComponent ImageMatrix
MultipleDataSources{
0 1 NComponents 1 sub{
DataSource exch get
}for
}{
/DataSource load
}ifelse
Operator/colorimage eq{
AGMCORE_host_sep{
MultipleDataSources level2 or NComponents 4 eq and{
AGMCORE_is_cmyk_sep{
MultipleDataSources{
/DataSource DataSource 0 get xcheck
{
[
DataSource 0 get/exec cvx
DataSource 1 get/exec cvx
DataSource 2 get/exec cvx
DataSource 3 get/exec cvx
/AGMCORE_get_ink_data cvx
]cvx
}{
DataSource aload pop AGMCORE_get_ink_data
}ifelse def
}{
/DataSource
Width BitsPerComponent mul 7 add 8 idiv Height mul 4 mul
/DataSource load
filter_cmyk 0()/SubFileDecode filter def
}ifelse
/Decode[Decode 0 get Decode 1 get]def
/MultipleDataSources false def
/NComponents 1 def
/Operator/image def
invert_image_samples
1 AGMCORE_&setgray
currentdict imageormask_sys
}{
currentoverprint not Operator/imagemask eq and{
1 AGMCORE_&setgray
currentdict imageormask_sys
}{
currentdict ignoreimagedata
}ifelse
}ifelse
}{
MultipleDataSources NComponents AGMIMG_&colorimage
}ifelse
}{
true NComponents colorimage
}ifelse
}{
Operator/image eq{
AGMCORE_host_sep{
/DoImage true def
currentdict/HostSepColorImage known{HostSepColorImage not}{false}ifelse
{
AGMCORE_black_plate not Operator/imagemask ne and{
/DoImage false def
currentdict ignoreimagedata
}if
}if
1 AGMCORE_&setgray
DoImage
{currentdict imageormask_sys}if
}{
use_mask{
process_mask image
}{
image
}ifelse
}ifelse
}{
Operator/knockout eq{
pop pop pop pop pop
currentcolorspace overprint_plate not{
knockout_unitsq
}if
}if
}ifelse
}ifelse
}ifelse
}ifelse
cleartomark restore
}ifelse
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
end
}def
/sep_imageormask
{
/sep_colorspace_dict AGMCORE_gget begin
CSA map_csa
begin
AGMIMG_init_common
SkipImageProc{
currentdict consumeimagedata
}{
save mark
AGMCORE_avoid_L2_sep_space{
/Decode[Decode 0 get 255 mul Decode 1 get 255 mul]def
}if
AGMIMG_ccimage_exists
MappedCSA 0 get/DeviceCMYK eq and
currentdict/Components known and
Name()ne and
Name(All)ne and
Operator/image eq and
AGMCORE_producing_seps not and
level2 not and
{
Width Height BitsPerComponent ImageMatrix
[
/DataSource load/exec cvx
{
0 1 2 index length 1 sub{
1 index exch
2 copy get 255 xor put
}for
}/exec cvx
]cvx bind
MappedCSA 0 get/DeviceCMYK eq{
Components aload pop
}{
0 0 0 Components aload pop 1 exch sub
}ifelse
Name findcmykcustomcolor
customcolorimage
}{
AGMCORE_producing_seps not{
level2{
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne AGMCORE_avoid_L2_sep_space not and currentcolorspace 0 get/Separation ne and{
[/Separation Name MappedCSA sep_proc_name exch dup 0 get 15 string cvs(/Device)anchorsearch{pop pop 0 get}{pop}ifelse exch load]setcolorspace_opt
/sep_tint AGMCORE_gget setcolor
}if
currentdict imageormask
}{
currentdict
Operator/imagemask eq{
imageormask
}{
sep_imageormask_lev1
}ifelse
}ifelse
}{
AGMCORE_host_sep{
Operator/knockout eq{
currentdict/ImageMatrix get concat
knockout_unitsq
}{
currentgray 1 ne{
AGMCORE_is_cmyk_sep Name(All)ne and{
level2{
Name AGMCORE_IsSeparationAProcessColor
{
Operator/imagemask eq{
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne{
/sep_tint AGMCORE_gget 1 exch sub AGMCORE_&setcolor
}if
}{
invert_image_samples
}ifelse
}{
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne{
[/Separation Name[/DeviceGray]
{
sep_colorspace_proc AGMCORE_get_ink_data
1 exch sub
}bind
]AGMCORE_&setcolorspace
/sep_tint AGMCORE_gget AGMCORE_&setcolor
}if
}ifelse
currentdict imageormask_sys
}{
currentdict
Operator/imagemask eq{
imageormask_sys
}{
sep_image_lev1_sep
}ifelse
}ifelse
}{
Operator/imagemask ne{
invert_image_samples
}if
currentdict imageormask_sys
}ifelse
}{
currentoverprint not Name(All)eq or Operator/imagemask eq and{
currentdict imageormask_sys
}{
currentoverprint not
{
gsave
knockout_unitsq
grestore
}if
currentdict consumeimagedata
}ifelse
}ifelse
}ifelse
}{
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne{
currentcolorspace 0 get/Separation ne{
[/Separation Name MappedCSA sep_proc_name exch 0 get exch load]setcolorspace_opt
/sep_tint AGMCORE_gget setcolor
}if
}if
currentoverprint
MappedCSA 0 get/DeviceCMYK eq and
Name AGMCORE_IsSeparationAProcessColor not and
//Adobe_AGM_Core/AGMCORE_pattern_paint_type get 2 ne{Name inRip_spot_has_ink not and}{false}ifelse
Name(All)ne and{
imageormask_l2_overprint
}{
currentdict imageormask
}ifelse
}ifelse
}ifelse
}ifelse
cleartomark restore
}ifelse
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
end
end
}def
/colorSpaceElemCnt
{
mark currentcolor counttomark dup 2 add 1 roll cleartomark
}bdf
/devn_sep_datasource
{
1 dict begin
/dataSource xdf
[
0 1 dataSource length 1 sub{
dup currentdict/dataSource get/exch cvx/get cvx/exec cvx
/exch cvx names_index/ne cvx[/pop cvx]cvx/if cvx
}for
]cvx bind
end
}bdf
/devn_alt_datasource
{
11 dict begin
/convProc xdf
/origcolorSpaceElemCnt xdf
/origMultipleDataSources xdf
/origBitsPerComponent xdf
/origDecode xdf
/origDataSource xdf
/dsCnt origMultipleDataSources{origDataSource length}{1}ifelse def
/DataSource origMultipleDataSources
{
[
BitsPerComponent 8 idiv origDecode length 2 idiv mul string
0 1 origDecode length 2 idiv 1 sub
{
dup 7 mul 1 add index exch dup BitsPerComponent 8 idiv mul exch
origDataSource exch get 0()/SubFileDecode filter
BitsPerComponent 8 idiv string/readstring cvx/pop cvx/putinterval cvx
}for
]bind cvx
}{origDataSource}ifelse 0()/SubFileDecode filter def
[
origcolorSpaceElemCnt string
0 2 origDecode length 2 sub
{
dup origDecode exch get dup 3 -1 roll 1 add origDecode exch get exch sub 2 BitsPerComponent exp 1 sub div
1 BitsPerComponent 8 idiv{DataSource/read cvx/not cvx{0}/if cvx/mul cvx}repeat/mul cvx/add cvx
}for
/convProc load/exec cvx
origcolorSpaceElemCnt 1 sub -1 0
{
/dup cvx 2/add cvx/index cvx
3 1/roll cvx/exch cvx 255/mul cvx/cvi cvx/put cvx
}for
]bind cvx 0()/SubFileDecode filter
end
}bdf
/devn_imageormask
{
/devicen_colorspace_dict AGMCORE_gget begin
CSA map_csa
2 dict begin
dup
/srcDataStrs[3 -1 roll begin
AGMIMG_init_common
currentdict/MultipleDataSources known{MultipleDataSources{DataSource length}{1}ifelse}{1}ifelse
{
Width Decode length 2 div mul cvi
{
dup 65535 gt{1 add 2 div cvi}{exit}ifelse
}loop
string
}repeat
end]def
/dstDataStr srcDataStrs 0 get length string def
begin
AGMIMG_init_common
SkipImageProc{
currentdict consumeimagedata
}{
save mark
AGMCORE_producing_seps not{
level3 not{
Operator/imagemask ne{
/DataSource[[
DataSource Decode BitsPerComponent currentdict/MultipleDataSources known{MultipleDataSources}{false}ifelse
colorSpaceElemCnt/devicen_colorspace_dict AGMCORE_gget/TintTransform get
devn_alt_datasource 1/string cvx/readstring cvx/pop cvx]cvx colorSpaceElemCnt 1 sub{dup}repeat]def
/MultipleDataSources true def
/Decode colorSpaceElemCnt[exch{0 1}repeat]def
}if
}if
currentdict imageormask
}{
AGMCORE_host_sep{
Names convert_to_process{
CSA get_csa_by_name 0 get/DeviceCMYK eq{
/DataSource
Width BitsPerComponent mul 7 add 8 idiv Height mul 4 mul
DataSource Decode BitsPerComponent currentdict/MultipleDataSources known{MultipleDataSources}{false}ifelse
4/devicen_colorspace_dict AGMCORE_gget/TintTransform get
devn_alt_datasource
filter_cmyk 0()/SubFileDecode filter def
/MultipleDataSources false def
/Decode[1 0]def
/DeviceGray setcolorspace
currentdict imageormask_sys
}{
AGMCORE_report_unsupported_color_space
AGMCORE_black_plate{
/DataSource
DataSource Decode BitsPerComponent currentdict/MultipleDataSources known{MultipleDataSources}{false}ifelse
CSA get_csa_by_name 0 get/DeviceRGB eq{3}{1}ifelse/devicen_colorspace_dict AGMCORE_gget/TintTransform get
devn_alt_datasource
/MultipleDataSources false def
/Decode colorSpaceElemCnt[exch{0 1}repeat]def
currentdict imageormask_sys
}{
gsave
knockout_unitsq
grestore
currentdict consumeimagedata
}ifelse
}ifelse
}
{
/devicen_colorspace_dict AGMCORE_gget/names_index known{
Operator/imagemask ne{
MultipleDataSources{
/DataSource[DataSource devn_sep_datasource/exec cvx]cvx def
/MultipleDataSources false def
}{
/DataSource/DataSource load dstDataStr srcDataStrs 0 get filter_devn def
}ifelse
invert_image_samples
}if
currentdict imageormask_sys
}{
currentoverprint not Operator/imagemask eq and{
currentdict imageormask_sys
}{
currentoverprint not
{
gsave
knockout_unitsq
grestore
}if
currentdict consumeimagedata
}ifelse
}ifelse
}ifelse
}{
currentdict imageormask
}ifelse
}ifelse
cleartomark restore
}ifelse
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
end
end
end
}def
/imageormask_l2_overprint
{
currentdict
currentcmykcolor add add add 0 eq{
currentdict consumeimagedata
}{
level3{
currentcmykcolor
/AGMIMG_k xdf
/AGMIMG_y xdf
/AGMIMG_m xdf
/AGMIMG_c xdf
Operator/imagemask eq{
[/DeviceN[
AGMIMG_c 0 ne{/Cyan}if
AGMIMG_m 0 ne{/Magenta}if
AGMIMG_y 0 ne{/Yellow}if
AGMIMG_k 0 ne{/Black}if
]/DeviceCMYK{}]setcolorspace
AGMIMG_c 0 ne{AGMIMG_c}if
AGMIMG_m 0 ne{AGMIMG_m}if
AGMIMG_y 0 ne{AGMIMG_y}if
AGMIMG_k 0 ne{AGMIMG_k}if
setcolor
}{
/Decode[Decode 0 get 255 mul Decode 1 get 255 mul]def
[/Indexed
[
/DeviceN[
AGMIMG_c 0 ne{/Cyan}if
AGMIMG_m 0 ne{/Magenta}if
AGMIMG_y 0 ne{/Yellow}if
AGMIMG_k 0 ne{/Black}if
]
/DeviceCMYK{
AGMIMG_k 0 eq{0}if
AGMIMG_y 0 eq{0 exch}if
AGMIMG_m 0 eq{0 3 1 roll}if
AGMIMG_c 0 eq{0 4 1 roll}if
}
]
255
{
255 div
mark exch
dup dup dup
AGMIMG_k 0 ne{
/sep_tint AGMCORE_gget mul MappedCSA sep_proc_name exch pop load exec 4 1 roll pop pop pop
counttomark 1 roll
}{
pop
}ifelse
AGMIMG_y 0 ne{
/sep_tint AGMCORE_gget mul MappedCSA sep_proc_name exch pop load exec 4 2 roll pop pop pop
counttomark 1 roll
}{
pop
}ifelse
AGMIMG_m 0 ne{
/sep_tint AGMCORE_gget mul MappedCSA sep_proc_name exch pop load exec 4 3 roll pop pop pop
counttomark 1 roll
}{
pop
}ifelse
AGMIMG_c 0 ne{
/sep_tint AGMCORE_gget mul MappedCSA sep_proc_name exch pop load exec pop pop pop
counttomark 1 roll
}{
pop
}ifelse
counttomark 1 add -1 roll pop
}
]setcolorspace
}ifelse
imageormask_sys
}{
write_image_file{
currentcmykcolor
0 ne{
[/Separation/Black/DeviceGray{}]setcolorspace
gsave
/Black
[{1 exch sub/sep_tint AGMCORE_gget mul}/exec cvx MappedCSA sep_proc_name cvx exch pop{4 1 roll pop pop pop 1 exch sub}/exec cvx]
cvx modify_halftone_xfer
Operator currentdict read_image_file
grestore
}if
0 ne{
[/Separation/Yellow/DeviceGray{}]setcolorspace
gsave
/Yellow
[{1 exch sub/sep_tint AGMCORE_gget mul}/exec cvx MappedCSA sep_proc_name cvx exch pop{4 2 roll pop pop pop 1 exch sub}/exec cvx]
cvx modify_halftone_xfer
Operator currentdict read_image_file
grestore
}if
0 ne{
[/Separation/Magenta/DeviceGray{}]setcolorspace
gsave
/Magenta
[{1 exch sub/sep_tint AGMCORE_gget mul}/exec cvx MappedCSA sep_proc_name cvx exch pop{4 3 roll pop pop pop 1 exch sub}/exec cvx]
cvx modify_halftone_xfer
Operator currentdict read_image_file
grestore
}if
0 ne{
[/Separation/Cyan/DeviceGray{}]setcolorspace
gsave
/Cyan
[{1 exch sub/sep_tint AGMCORE_gget mul}/exec cvx MappedCSA sep_proc_name cvx exch pop{pop pop pop 1 exch sub}/exec cvx]
cvx modify_halftone_xfer
Operator currentdict read_image_file
grestore
}if
close_image_file
}{
imageormask
}ifelse
}ifelse
}ifelse
}def
/indexed_imageormask
{
begin
AGMIMG_init_common
save mark
currentdict
AGMCORE_host_sep{
Operator/knockout eq{
/indexed_colorspace_dict AGMCORE_gget dup/CSA known{
/CSA get get_csa_by_name
}{
/Names get
}ifelse
overprint_plate not{
knockout_unitsq
}if
}{
Indexed_DeviceN{
/devicen_colorspace_dict AGMCORE_gget dup/names_index known exch/Names get convert_to_process or{
indexed_image_lev2_sep
}{
currentoverprint not{
knockout_unitsq
}if
currentdict consumeimagedata
}ifelse
}{
AGMCORE_is_cmyk_sep{
Operator/imagemask eq{
imageormask_sys
}{
level2{
indexed_image_lev2_sep
}{
indexed_image_lev1_sep
}ifelse
}ifelse
}{
currentoverprint not{
knockout_unitsq
}if
currentdict consumeimagedata
}ifelse
}ifelse
}ifelse
}{
level2{
Indexed_DeviceN{
/indexed_colorspace_dict AGMCORE_gget begin
}{
/indexed_colorspace_dict AGMCORE_gget dup null ne
{
begin
currentdict/CSDBase known{CSDBase/CSD get_res/MappedCSA get}{CSA}ifelse
get_csa_by_name 0 get/DeviceCMYK eq ps_level 3 ge and ps_version 3015.007 lt and
AGMCORE_in_rip_sep and{
[/Indexed[/DeviceN[/Cyan/Magenta/Yellow/Black]/DeviceCMYK{}]HiVal Lookup]
setcolorspace
}if
end
}
{pop}ifelse
}ifelse
imageormask
Indexed_DeviceN{
end
}if
}{
Operator/imagemask eq{
imageormask
}{
indexed_imageormask_lev1
}ifelse
}ifelse
}ifelse
cleartomark restore
currentdict/_Filters known{_Filters AGMIMG_flushfilters}if
end
}def
/indexed_image_lev2_sep
{
/indexed_colorspace_dict AGMCORE_gget begin
begin
Indexed_DeviceN not{
currentcolorspace
dup 1/DeviceGray put
dup 3
currentcolorspace 2 get 1 add string
0 1 2 3 AGMCORE_get_ink_data 4 currentcolorspace 3 get length 1 sub
{
dup 4 idiv exch currentcolorspace 3 get exch get 255 exch sub 2 index 3 1 roll put
}for
put setcolorspace
}if
currentdict
Operator/imagemask eq{
AGMIMG_&imagemask
}{
use_mask{
process_mask AGMIMG_&image
}{
AGMIMG_&image
}ifelse
}ifelse
end end
}def
/OPIimage
{
dup type/dicttype ne{
10 dict begin
/DataSource xdf
/ImageMatrix xdf
/BitsPerComponent xdf
/Height xdf
/Width xdf
/ImageType 1 def
/Decode[0 1 def]
currentdict
end
}if
dup begin
/NComponents 1 cdndf
/MultipleDataSources false cdndf
/SkipImageProc{false}cdndf
/Decode[
0
currentcolorspace 0 get/Indexed eq{
2 BitsPerComponent exp 1 sub
}{
1
}ifelse
]cdndf
/Operator/image cdndf
end
/sep_colorspace_dict AGMCORE_gget null eq{
imageormask
}{
gsave
dup begin invert_image_samples end
sep_imageormask
grestore
}ifelse
}def
/cachemask_level2
{
3 dict begin
/LZWEncode filter/WriteFilter xdf
/readBuffer 256 string def
/ReadFilter
currentfile
0(%EndMask)/SubFileDecode filter
/ASCII85Decode filter
/RunLengthDecode filter
def
{
ReadFilter readBuffer readstring exch
WriteFilter exch writestring
not{exit}if
}loop
WriteFilter closefile
end
}def
/spot_alias
{
/mapto_sep_imageormask
{
dup type/dicttype ne{
12 dict begin
/ImageType 1 def
/DataSource xdf
/ImageMatrix xdf
/BitsPerComponent xdf
/Height xdf
/Width xdf
/MultipleDataSources false def
}{
begin
}ifelse
/Decode[/customcolor_tint AGMCORE_gget 0]def
/Operator/image def
/SkipImageProc{false}def
currentdict
end
sep_imageormask
}bdf
/customcolorimage
{
Adobe_AGM_Image/AGMIMG_colorAry xddf
/customcolor_tint AGMCORE_gget
<<
/Name AGMIMG_colorAry 4 get
/CSA[/DeviceCMYK]
/TintMethod/Subtractive
/TintProc null
/MappedCSA null
/NComponents 4
/Components[AGMIMG_colorAry aload pop pop]
>>
setsepcolorspace
mapto_sep_imageormask
}ndf
Adobe_AGM_Image/AGMIMG_&customcolorimage/customcolorimage load put
/customcolorimage
{
Adobe_AGM_Image/AGMIMG_override false put
current_spot_alias{dup 4 get map_alias}{false}ifelse
{
false set_spot_alias
/customcolor_tint AGMCORE_gget exch setsepcolorspace
pop
mapto_sep_imageormask
true set_spot_alias
}{
//Adobe_AGM_Image/AGMIMG_&customcolorimage get exec
}ifelse
}bdf
}def
/snap_to_device
{
6 dict begin
matrix currentmatrix
dup 0 get 0 eq 1 index 3 get 0 eq and
1 index 1 get 0 eq 2 index 2 get 0 eq and or exch pop
{
1 1 dtransform 0 gt exch 0 gt/AGMIMG_xSign? exch def/AGMIMG_ySign? exch def
0 0 transform
AGMIMG_ySign?{floor 0.1 sub}{ceiling 0.1 add}ifelse exch
AGMIMG_xSign?{floor 0.1 sub}{ceiling 0.1 add}ifelse exch
itransform/AGMIMG_llY exch def/AGMIMG_llX exch def
1 1 transform
AGMIMG_ySign?{ceiling 0.1 add}{floor 0.1 sub}ifelse exch
AGMIMG_xSign?{ceiling 0.1 add}{floor 0.1 sub}ifelse exch
itransform/AGMIMG_urY exch def/AGMIMG_urX exch def
[AGMIMG_urX AGMIMG_llX sub 0 0 AGMIMG_urY AGMIMG_llY sub AGMIMG_llX AGMIMG_llY]concat
}{
}ifelse
end
}def
level2 not{
/colorbuf
{
0 1 2 index length 1 sub{
dup 2 index exch get
255 exch sub
2 index
3 1 roll
put
}for
}def
/tint_image_to_color
{
begin
Width Height BitsPerComponent ImageMatrix
/DataSource load
end
Adobe_AGM_Image begin
/AGMIMG_mbuf 0 string def
/AGMIMG_ybuf 0 string def
/AGMIMG_kbuf 0 string def
{
colorbuf dup length AGMIMG_mbuf length ne
{
dup length dup dup
/AGMIMG_mbuf exch string def
/AGMIMG_ybuf exch string def
/AGMIMG_kbuf exch string def
}if
dup AGMIMG_mbuf copy AGMIMG_ybuf copy AGMIMG_kbuf copy pop
}
addprocs
{AGMIMG_mbuf}{AGMIMG_ybuf}{AGMIMG_kbuf}true 4 colorimage
end
}def
/sep_imageormask_lev1
{
begin
MappedCSA 0 get dup/DeviceRGB eq exch/DeviceCMYK eq or has_color not and{
{
255 mul round cvi GrayLookup exch get
}currenttransfer addprocs settransfer
currentdict imageormask
}{
/sep_colorspace_dict AGMCORE_gget/Components known{
MappedCSA 0 get/DeviceCMYK eq{
Components aload pop
}{
0 0 0 Components aload pop 1 exch sub
}ifelse
Adobe_AGM_Image/AGMIMG_k xddf
Adobe_AGM_Image/AGMIMG_y xddf
Adobe_AGM_Image/AGMIMG_m xddf
Adobe_AGM_Image/AGMIMG_c xddf
AGMIMG_y 0.0 eq AGMIMG_m 0.0 eq and AGMIMG_c 0.0 eq and{
{AGMIMG_k mul 1 exch sub}currenttransfer addprocs settransfer
currentdict imageormask
}{
currentcolortransfer
{AGMIMG_k mul 1 exch sub}exch addprocs 4 1 roll
{AGMIMG_y mul 1 exch sub}exch addprocs 4 1 roll
{AGMIMG_m mul 1 exch sub}exch addprocs 4 1 roll
{AGMIMG_c mul 1 exch sub}exch addprocs 4 1 roll
setcolortransfer
currentdict tint_image_to_color
}ifelse
}{
MappedCSA 0 get/DeviceGray eq{
{255 mul round cvi ColorLookup exch get 0 get}currenttransfer addprocs settransfer
currentdict imageormask
}{
MappedCSA 0 get/DeviceCMYK eq{
currentcolortransfer
{255 mul round cvi ColorLookup exch get 3 get 1 exch sub}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 2 get 1 exch sub}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 1 get 1 exch sub}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 0 get 1 exch sub}exch addprocs 4 1 roll
setcolortransfer
currentdict tint_image_to_color
}{
currentcolortransfer
{pop 1}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 2 get}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 1 get}exch addprocs 4 1 roll
{255 mul round cvi ColorLookup exch get 0 get}exch addprocs 4 1 roll
setcolortransfer
currentdict tint_image_to_color
}ifelse
}ifelse
}ifelse
}ifelse
end
}def
/sep_image_lev1_sep
{
begin
/sep_colorspace_dict AGMCORE_gget/Components known{
Components aload pop
Adobe_AGM_Image/AGMIMG_k xddf
Adobe_AGM_Image/AGMIMG_y xddf
Adobe_AGM_Image/AGMIMG_m xddf
Adobe_AGM_Image/AGMIMG_c xddf
{AGMIMG_c mul 1 exch sub}
{AGMIMG_m mul 1 exch sub}
{AGMIMG_y mul 1 exch sub}
{AGMIMG_k mul 1 exch sub}
}{
{255 mul round cvi ColorLookup exch get 0 get 1 exch sub}
{255 mul round cvi ColorLookup exch get 1 get 1 exch sub}
{255 mul round cvi ColorLookup exch get 2 get 1 exch sub}
{255 mul round cvi ColorLookup exch get 3 get 1 exch sub}
}ifelse
AGMCORE_get_ink_data currenttransfer addprocs settransfer
currentdict imageormask_sys
end
}def
/indexed_imageormask_lev1
{
/indexed_colorspace_dict AGMCORE_gget begin
begin
currentdict
MappedCSA 0 get dup/DeviceRGB eq exch/DeviceCMYK eq or has_color not and{
{HiVal mul round cvi GrayLookup exch get HiVal div}currenttransfer addprocs settransfer
imageormask
}{
MappedCSA 0 get/DeviceGray eq{
{HiVal mul round cvi Lookup exch get HiVal div}currenttransfer addprocs settransfer
imageormask
}{
MappedCSA 0 get/DeviceCMYK eq{
currentcolortransfer
{4 mul HiVal mul round cvi 3 add Lookup exch get HiVal div 1 exch sub}exch addprocs 4 1 roll
{4 mul HiVal mul round cvi 2 add Lookup exch get HiVal div 1 exch sub}exch addprocs 4 1 roll
{4 mul HiVal mul round cvi 1 add Lookup exch get HiVal div 1 exch sub}exch addprocs 4 1 roll
{4 mul HiVal mul round cvi Lookup exch get HiVal div 1 exch sub}exch addprocs 4 1 roll
setcolortransfer
tint_image_to_color
}{
currentcolortransfer
{pop 1}exch addprocs 4 1 roll
{3 mul HiVal mul round cvi 2 add Lookup exch get HiVal div}exch addprocs 4 1 roll
{3 mul HiVal mul round cvi 1 add Lookup exch get HiVal div}exch addprocs 4 1 roll
{3 mul HiVal mul round cvi Lookup exch get HiVal div}exch addprocs 4 1 roll
setcolortransfer
tint_image_to_color
}ifelse
}ifelse
}ifelse
end end
}def
/indexed_image_lev1_sep
{
/indexed_colorspace_dict AGMCORE_gget begin
begin
{4 mul HiVal mul round cvi Lookup exch get HiVal div 1 exch sub}
{4 mul HiVal mul round cvi 1 add Lookup exch get HiVal div 1 exch sub}
{4 mul HiVal mul round cvi 2 add Lookup exch get HiVal div 1 exch sub}
{4 mul HiVal mul round cvi 3 add Lookup exch get HiVal div 1 exch sub}
AGMCORE_get_ink_data currenttransfer addprocs settransfer
currentdict imageormask_sys
end end
}def
}if
end
systemdict/setpacking known
{setpacking}if
%%EndResource
currentdict Adobe_AGM_Utils eq {end} if
%%EndProlog
%%BeginSetup
Adobe_AGM_Utils begin
2 2010 Adobe_AGM_Core/ds gx
Adobe_CoolType_Core/ds get exec
Adobe_AGM_Image/ds gx
currentdict Adobe_AGM_Utils eq {end} if
%%EndSetup
%%Page: (Page 1) 1
%%EndPageComments
%%BeginPageSetup
%ADOBeginClientInjection: PageSetup Start "AI11EPS"
%AI12_RMC_Transparency: Balance=75 RasterRes=300 GradRes=150 Text=0 Stroke=1 Clip=1 OP=0
%ADOEndClientInjection: PageSetup Start "AI11EPS"
Adobe_AGM_Utils begin
Adobe_AGM_Core/ps gx
Adobe_AGM_Utils/capture_cpd gx
Adobe_CoolType_Core/ps get exec
Adobe_AGM_Image/ps gx
%ADOBeginClientInjection: PageSetup End "AI11EPS"
/currentdistillerparams where
{pop currentdistillerparams /CoreDistVersion get 5000 lt} {true} ifelse
{ userdict /AI11_PDFMark5 /cleartomark load put
userdict /AI11_ReadMetadata_PDFMark5 {flushfile cleartomark } bind put}
{ userdict /AI11_PDFMark5 /pdfmark load put
userdict /AI11_ReadMetadata_PDFMark5 {/PUT pdfmark} bind put } ifelse
[/NamespacePush AI11_PDFMark5
[/_objdef {ai_metadata_stream_123} /type /stream /OBJ AI11_PDFMark5
[{ai_metadata_stream_123}
currentfile 0 (% &&end XMP packet marker&&)
/SubFileDecode filter AI11_ReadMetadata_PDFMark5
application/postscript
Kelik
Crunchy Data Solutions, Inc.
Adobe Illustrator CS3
2014-12-19T19:56:59+07:00
2014-12-19T19:56:59+07:00
2014-12-19T19:56:59+07:00
256
80
JPEG
/9j/4AAQSkZJRgABAgEASABIAAD/7QAsUGhvdG9zaG9wIDMuMAA4QklNA+0AAAAAABAASAAAAAEA
AQBIAAAAAQAB/+4ADkFkb2JlAGTAAAAAAf/bAIQABgQEBAUEBgUFBgkGBQYJCwgGBggLDAoKCwoK
DBAMDAwMDAwQDA4PEA8ODBMTFBQTExwbGxscHx8fHx8fHx8fHwEHBwcNDA0YEBAYGhURFRofHx8f
Hx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8fHx8f/8AAEQgAUAEAAwER
AAIRAQMRAf/EAaIAAAAHAQEBAQEAAAAAAAAAAAQFAwIGAQAHCAkKCwEAAgIDAQEBAQEAAAAAAAAA
AQACAwQFBgcICQoLEAACAQMDAgQCBgcDBAIGAnMBAgMRBAAFIRIxQVEGE2EicYEUMpGhBxWxQiPB
UtHhMxZi8CRygvElQzRTkqKyY3PCNUQnk6OzNhdUZHTD0uIIJoMJChgZhJRFRqS0VtNVKBry4/PE
1OT0ZXWFlaW1xdXl9WZ2hpamtsbW5vY3R1dnd4eXp7fH1+f3OEhYaHiImKi4yNjo+Ck5SVlpeYmZ
qbnJ2en5KjpKWmp6ipqqusra6voRAAICAQIDBQUEBQYECAMDbQEAAhEDBCESMUEFURNhIgZxgZEy
obHwFMHR4SNCFVJicvEzJDRDghaSUyWiY7LCB3PSNeJEgxdUkwgJChgZJjZFGidkdFU38qOzwygp
0+PzhJSktMTU5PRldYWVpbXF1eX1RlZmdoaWprbG1ub2R1dnd4eXp7fH1+f3OEhYaHiImKi4yNjo
+DlJWWl5iZmpucnZ6fkqOkpaanqKmqq6ytrq+v/aAAwDAQACEQMRAD8A9U4q7FXYq7FXYq7FXz3/
AM5Z+ctZ0y20HRNPlktY7mR76e4iYoxe2ZPRVWG/wO3P58TikJp+W/8Azkn5YuPJ1u3m69MXmKCQ
2zwQwySyXXEApMiQqwXmDQ1oOQPtitMl/wCV1S3Z/wBwvknzJqKdFuGsxbwtWlOLyP8AwxQv/wCV
pecv/Lc6z/yMt/8AmrFVjfnVJZlRrPkrzFYKx4+slolzEDSu7RSV+W2KphpP55flfqM/1b9Nx2N3
UK9tqCSWbqx6AmdUT/hsVZvbXVtdQrPbTJPA+6SxsHQj2Zag4qqYq7FXYq7FXYq7FUv1PzF5f0oE
6nqdpYBd2NzPHDTav7bL2xVjN3+dn5UWpIl8z2TEGn7pzMPviD4qgE/5yG/Jx5jCPMaB1qCWt7tV
28HMIU/fiqZWn5zflXdkCLzRYLypT1pRD18fV4UxVkuna9oepgNpuo2t6pFQbaaOUU6/sFsVR2Ku
xV2KuxV2KuxV2KuxV2KuxV2KuxV2KsM87fm75H8nXKWWq3jS6pIAY9MtEM9yQ32aquy8u3IiuKvM
/Mmi63+bGo2V95ksG0Hyxp5ZtN01+P6RmMlObztT9wrcR8HXb5NhVlOlaX5T8n2ypp8dro8dKery
WJ27fFKx5ufmcUM58rapJfxSOky3Vquyzqwccv5eQJrtiUvO/wA8vN3mzRHiTRWKQrb3FzcOE9Q0
gWIJGqkFau0xYkg/Cppir55vPzFvzevfa3NcX/mG0e2lsXr6UNrKkyyyokS8UWka+m9V5Ek9h8Sm
n1JqOj6frcQtdSsIdTjpRYrmJZ6D/J5Biv8AscWLFm/I6bT52vfJOo6j5TvSSxit5Wms3NP27eVq
mvu5A/lxSif+VgfnD5MX/ndPLg8w6Qn2tb0QfvVX+aW3IX6dkX3wKzHyp+cH5deaEX9Ga1Atyw3s
7lvq84Phwk48v9jUYqitZ/NL8utGqNR8x2ETjrEk6Syj/nnEXf8ADFWB6n/zlH5GWYWvl+x1HzBe
PURR20BjRv8AkZ+9+6M4rSBfzn/zkj5oH+4Hytb+WLN+lzqLAzLXp8M/A/8AJDFUO35Gfm7r+/mz
8wpkjbd7Wx9Z4jXtx5Wsf/CYqjdN/wCcS/y9gPPUL7Ur+UmrVljiQ19kj51/2eKbT63/AOca/wAn
Ik4vojznb4pLu7B/4SVBii01i/Iz8pYgQvlm0Nf5/Uf/AIkxxVQufyA/J+5BEnluFankfSmuYt/+
ecq7e2KpBf8A/OLH5XzkNZnUNNlU8o3t7nkVYUof3yy9xitoQfkd+Y2ifF5T/Ma+ijX7Fnfq0sQP
/Bun/JLFV6a7/wA5L+Wx/uT0TTfNlrH9uaxkEM5p4D93+EGKo/S/+cjfKa3KWPmvTtQ8p6g2xj1C
B/Sr7Oq8+vdowMVemaRrej6zZre6TewX9o/2Z7eRZV3FaEqTQ+2Ko3FXYq7FXYq7FXYq7FXYqh9R
uxZafdXhXkLaGSYr4+mpan4Yq+Nvyk/OCx0DzLruoeaopLs+YeLT6nEoknhlVmbZWI/dv6lGAPYY
pIe6WPnfRtS8t3uv6b6sthaQyTCSaJ4A/pozsFMgWtONCRt74WL5n8tfmR5ts/Ok3mSCK31TXbxH
ijN7GZljLspDQryXgU48V3oBtgZU+iPym/OXzH5n0S/tr97WfzBbfvraVYpYoWheqrzXinSRWUlD
hQUPafnDr/mPT7uW18h6le6zprvbXL2bKbP1oyVIErLyr/khSRirFPyd/LzRNa1PXvMPnHRZdLuN
KvTOY7tHggiRwZFQIVjDvGRvyB6rthhEyNAWSxyZIwiZSNRDONf/ADhuFd7Xy1ClnaIaC7kUPK9P
2grVVQf8oE/LpnS6XsWAF5dz3dHiNf7TZJExwDhj/OO5Pw5D7fgx/wD5Wh515cv0o9f9SKn3cKZn
fyZp/wCb9/63Vfy5rf8AVD8o/qZP5Y/Oq7jmS38wIs9uxAN7EoWRK92RfhYf6oB+eYGq7FiReLY9
zt+z/abICI5xxR/nDmPeOR+FfFNPP/5J/l153s21JUi07UbhecOs2fFQ5YVDSoKRyg+J+L/KGc2Y
EGiN3tI5ImIkD6Swzyh/zi95STSprPzRcR3eomUm1v8ATbmRGMRAorRSKUDKR1ANa+26YEdEjID1
Zf5E/KzX/wAvNVWPQNRj1XyzdsFvLC9RIruCrf30VxGtJONalGCgjpvkWT01rm2R+DSor/ylgDv7
ZIRPcxMwNrVCQASTQDck5Fkppc2z14So3EVajA0HiaZIxI6MRMHq3HPBLX0pFenXiwNPuwGJHNRI
HkV+Bkppc2ztwSVGf+UMCfuGSMSOjETB6qmRZKMt7ZwuEmnjjdvsq7qpPyBOSEJHkGEskRsSFYEE
Ag1B6HIs0JqdrpF3bm21SG3uLeTrDdKjo1P8lwQcIiTyQZAc2DXP5IeSfrZ1Ty29z5Y1Jh8N5o05
hQ07NCecLL2I44kUkG070eXzlpUy2WtXdnrdtXiuoRcbO8Wv2TNbsxhf3ZHX2Q4REnoxMwOrJfrV
tz9P1k9SvHhyFa+FMeE86XjF1apkWSk91aoxR5kVh1VmAP3E5IQJ6MTMDmVXIsnYq7FXYqwn81Pz
B8s+VPL1zBqdwW1DUYJIdP06EepcTPIpQcUHRandjt9O2KvlfyD+WE2oeYYdLvY/V1YUlurLZorG
Ift3hGxlP7NvXr/eUAKlSSy//nIDU7/QtF0ny1pjrBpF4jm5VTWaT0StFf8AyDyr7n2FMJQHlv5c
webZfM8P+F4PX1AKyvzWsSxOOLmVtuC+9Qa9N8CS9c/Knybe2Hmq6+r3VtPeRRtFfTWAd7DToWcP
Ipmk/vrqTjxSPfj1Y0FMKC9r053061W00+ltbqzMIogFHKRi7tt1LMxJPc4oYr+ePmO6gXT/AC6s
po0Qur0g/bNSkamnYFWNPlnQdiYBvkPuH6Xk/abUn04hy+o/o/HuVPym/LixvLCPzBrUQuFmJ+o2
cgrHxU09SRT9qpHwg7U33qKHtTtKUZeHA13n9DHsTsWEo+LlF3yj0957/Lp193WjZWZtvqpgjNsB
xEBReFPDjSmc/wAcru93rPDjXDQruefeZfyV0fU74XWl3X6JDA+tbpF6sZavVF5x8PkNvCmbfTdt
ThGpDj+Lz+s9m8WWXFA+H3irH3ikl86eVrzyt+Ws+nzal+kLf65C9uDEYjFy5c1H7ySoJ37b18cy
dJqxn1IkI8J4Te/P7HF13Z8tNojAy448Qraq7+p/FsK8q/l95i8z6fJf6aYBBFMYG9Vyrc1VXOwV
tqOM2Wp7Rx4ZcMrurdJouxsuogZQ4aBrdF6B5n8y+RPMq6fqTSpaxSBL6xZucZjf9uPqK0PIFevT
K9RgxarHxR59C5Gk1GbQ5hCd8IO8eld4+/ZV/MWdf+VrXHE1BnsiCOhBghyPZ/8Aig90vvLLtSN6
8/1ofdF7j5s/5RbWf+YG5/5MtnMaX+9h/WH3vZ68Xp8g/oS+4vCvyxfn/if20O7/AONc6ntE/wB3
/wAMi8N2Tj/vf+Ez/Qk3kzzjdeWtch1CIl4CeF5AP92RE/EP9YdV98yNZphmxmJ59Pe4/Z2rlpso
mOXUd4/HJ9OWF9aX9nDe2comtrhBJDIvQqwqM4mcDEmJ5h9Jx5IziJRNgvnz8pXr+Y1ivh9Z/wCT
Emdd2qf8Gl8PvD592FjrVw8uL/clP/zH/NbULnUZND8uSvFBG/ozXUNfVmkrQpGRuFDbVXdvl1w+
z+zYxj4mQb93d73adr9sTlPwsJIHIkcye4fjf3JTZfk756vrY3cywWsjjn6VzKfVau+4RZACf8oj
MmfbGCJoWfcNnBx+zupmOI8IPmd/0oK31jz1+XuqJb3AkgjPxmzlbnbTLXcqQSv0qajvlk8eDVxs
b+fUNePJqtBMA7Du/hP48t06/NzzNYa/ovlnVbI0jnF2JIyatHIvoB0b3B+8b5jdlYJYZ5In+j+l
zO3tRHUY8U48jxfD6Xo/5UGv5f6SfFZj/wAl5M0/an+MS+H3B6DsKNaSA9/+6LyL82np+Y18vj9W
/wCTEedB2Uf8Gj8fvLyPbuO9XPz4f9yE1/OnQ5dJ8xwa5a1jh1CjF1NClzFSpFOnJeLD3rlHY+o4
8Zxn+H7i5ntDozjzDLHYS/3Q/H3vTNF882N15FXzPcsAsEDG8RaCk8fwsgHYu1OI9xmkzaKUc/hD
qdvc9Np+0Iy03jS6Df3j9Z5PH/I+nXfnbz011fj1IBIb3UDuV4hvhiFezNRafy18M6LWZhpsFR58
h+v8dXkOztNLWarinuL4pfq/RXc+ic499BWTzxQQSTzMEhiUvI56BVFST8hiryPR/wA8vM/mJ5rv
yx5Hm1HQI5Xhj1KfULeyaUoeqRzqAfcBziqpdfmJ+aevXE2h+WfL9jpOqoB9ZvL3UrW8+rK3QtBa
GRg2xpz+44q8q17yX508sTT+YPNMGotLO3+5Lzbbpb6hcxIfhPoD11+qLQ058CwGysv2cKvQ/wAs
rzy3H5ekh8g6TcR6ZKxF75j1McDNJ0ZY1r6k7+NOKL/MOmKlS8/flL5V806PdzelLF5q4F7TVGmk
dXdR8MMkbH00iPT4F+Hr1ryVBQun6T5E/KbyXHbawz3eo6qvH6lalheahMfhogUh0iBPEGo/4I7q
obSfzJljjg8uaNpMV1rDt+68u6QqpYacp2C3FyFIaT/fr7/FsAO6r1rTtD1IxwSXhjhkAUydQC21
eINTSvSuKHkX5+M8fniPlsHsoWX5c5B+sZ1PYx/c/wCcf0PGe0Ef8IH9UfeXs/5eXdtdeRtCltiD
GLKGNqf78iURydP8tWzn9dEjNO/5xeo7OkDp4V/NH2bFkOYrmOxV57+ercfIbn/l6h/jm07H/v8A
4F0/bovTH3hhH5T/AJneWPLPly5sNVaYXEl486CKPmODRRoN6jeqHNj2loMmbIJRqqr7S6rsftDF
gxGMyb4r5eQYx5u8wXHn7zvGdKtWU3Hp2llCwHMqpJ5ycagfaLHwHfbMzS4hpsPqPLcuv1uU6zUD
gHOgP2/jkjPzF/cfmxNBWvpy2CV8aW8AyGhN6W/633lu7Qh/hvxh90Xv/mz/AJRbWf8AmBuf+TLZ
y+m/vY/1h972GqF4p/1T9zwL8ppOX+KfbQ7r/jXOn7SP93/XDx/Y8P73/hZY55Z8t33mGPU1sKvd
afam7SACpkVXVXRf8ri1R40p3zLz6kYuHi5SNODpdDLMJcPOIv3s+/I/8wPql6PLGoSUtbpidOdj
9idusW/aTt/lf62avtfR8Q8SPMc/d+x3PYWu4D4MuR+n393x+/3sR8j6jNZeaby8hNJrWy1KaMja
jR2krD8RmfrIiWIA9ZR+8Ot0FwzSkOcYzP8AsSyH8hNMtL/zZcXdwodtPtzJbqdwJHYIG+ha0zF7
ZymOIAfxFzPZ/TxlmMj/AAjb4voTOWeyUbmysroKLq3jnC7qJUV6V8OQOSjMx5GmMoCXMW8Y/wCc
hbe1s08vx20McEbG8YpGoQE/6OK0UDfOg7EmTx2b+n9Ly/tFjA8OhX1f71j/AJY/O3VdA0K10iHT
reeK1DBZXZwx5Oz7gbftZk6jsqOWZmZHdxdJ21PDjGMRBpjHmLzVceZPM51eeFIJbholMUZJUcFV
Bud/2czMGAYcfADdW6/U5zqM3GRV0+kfzB8sjzH5UvdPRQbpV9eyO208YJUb9OW6H2OcnodR4WUS
6dfc9v2jpBnwmHXmPf8AjZ8wp5g1SDR7jRBKyWM86TzQGo/eRAr/ABFR7DwzsDiiZif8QFPBjLOO
M4/4SbI8x+PsfRn5S+VDoHlSFp046hqNLm6qPiUMP3cZ/wBVe3iTnK9p6nxcu30x2D2vZGj8DCL+
qW5/UzXNc7R41+Zvn/V/MGu335ZeTXgS9Nq58wavOx420DcUkihVd2lIlAJHStNjUqqxXzL5x0b8
qfJ1h5WsXe+1WK3k+pKwAoZZHkaeanRfUduK7nt74V5sm/5x6uNL07yJa3cP+kz6k0k+p3NeUzXH
qMG5k7kgUG/zxUvVrjVtHuLSWOYrNDIjJLbuteasKFSpFCCNsCsbtLNWSCw062WC0tkEVpaRDjHF
EuwA/rhQnUehW9pbyXV5yn9JGkaGIE1CitAB8THwGKXztr/k/wA3a/5lS7vGEXmrzCzkuDyh0XSY
qKEQggeqwbgCP8qndsVes+W9G8s+Q9AFjo4jtYYl5XupzFVeRqbu7tT7z9FBiqnonm7T/MuoPDo7
y6kkbcJdQQH6sJP5Flcj1G/1OQHemKGvzt8h3ms6Hb6tYqZ9T0qMidF+1LBSrED+ZCOQHep9s2vZ
WrGOXDL6Zfe6jtjQnLASj9UfueZfln+bN35Qd7K7ia80WZubwKQJInNAXj5bGoG6kj5jvttd2eM+
42m6fs7tA6f0neH3e56y35+/l4Lcyia5aQCv1cQNzJ8Kk8K/7LNN/JGe6ofN3p7XwVdn5PMvNv57
+Z9T1ANocjaTYRgqkYCPLIT+1IxUj5AdPfNtp+yscI+v1F0+q7Xyzl+79MU882xebx+Tz33mm7ln
vr28t5IbeVVUww0biCFVaM1amvt3rmPpzi/NVjFAA/FydTHKdITlNyJHwecQ+VL+48lSeabastvb
Xr2d5GBvGojjdJf9UtJxPhtm0OpAy+GeZFj7XTR0ROHxB0lR+zd6z/zj7qXlWe1ntI7OK38yQAmW
43aSeAn7Sly3HiaB1Wg6H5abtiGQEG7h9xd72IcXCQABkH2hhX5zGXTvzTubx1qH+qXMQOwZUiRP
+JREZn9mHi04HvDru1IcGq4v6p+X9j1Xzh+avkyTyLfz2Wow3Fzf2jw21krL64edOA9SOvJeHKrV
8Ns0+m0GUZgCKAPPps7zVa/F4JIkCSOXXfyeZfk5aTvp/nG/APoQ6PNAzducqs4H3RHNt2nMcWMf
0w6fsjF6ch/o0jv+ccX5ea9S/wCYA/8AJ6PK+2v7uP8AW/Qz7BjWSXuQ/wCdnkWTy/rS6/pqGPTb
+Tk/p1AguftECnQP9pfeo8Ml2XrPEhwS+ofaGHa2g8OfiR5H7Ckn5PQRaj58gs7gloru3vIpt9ys
lvIrfgcyO0pGOEkdCPvaOycYlno9Qfub8vazqn5Z+fJkv4GdYS1texD4fVgcgrJHXbsHX7sGbHHV
Ydj5j3rp5S0ec2PI+Y730Hpv5j+RtQshdwa3ZpHSrJPMkMi/6ySFWH3Zzc9FmiaMS9TDWYpCxIfN
hHm7/nILRtNvUtdBt11dVB9e5LtFED2VPhJb3PTwrmfp+x5SFzPC67U9swgagONhv5w69qut+XvK
mq6lYjT5Lv69JBbhix9E/V+DmoX7XUe1MzuzcUcc8kYm64f0uv7WnLLDHKQ4b4tvkz/8rvJPlDUf
IWk3t9pFrc3UySGWaSMMzETOBUn2Ga7X6vLHNICRA/Y7Ps/RYZYYkxiTXc8o/NPTtO0r8yJ7LT7d
LW1jNsUgiAVQWjQmgHiTm40GSU8FyNnd0vaGCMNTURQ2fUmci9i+XprSzn/Ot7KWJWtZNcKPDSil
Tcbig7Z1omRpLHPg/Q8ecMTraI2431DnJPYMU1zSfzKuKtpHmLT7LwjfTHf/AIdrpv8AiOKvmy+/
5x1/Ou61u61lzbfpG6nkuZLpLpY3MkrFmYcfs1LHpim0Jcf84yfnBczNPcR200zmryyXaszHpuxq
Titpr5e/Iz8//LkjvotxDZeoayRpdRtGxHdo3DIT8xitsiuvJf8AzlLcQCE31nEKcWeJ7VHb35CO
oP8Aq0woekeRIvzM0mwtrfW9ESWeCJIZri3vIpPWCKAHIlMZDGm/xHFWeTSX89kypbGGWRaFXdPh
r13UsPuwKkY8t34YuETmQAWqKkCtBX2qcNqhdV8ktq2nz6fqFvFcWlwpSWNyCKHuK9COx7Yqhfyd
8han5Q8pWmmau8Ut7bGUK0JqoWSV3G9BU8WGBWfYq8686fkh5W8x3Ml9bO2k6jKS0ssChonY9WeE
8fi91YV75stN2pkxij6out1PZePKb+mXkwof84z3/q0Ovxel/P8AV25df5fUp+OZ38tj+b9rg/yF
/T+z9rOfJf5KeVfLdxHfTF9U1KM1jnuABHGw6NHEKgH3Yn2pmBqe08mUV9MXP03ZmLEb+qXmnP5k
eT7jzb5abSLe5S1kaaOX1ZFLCiV2oPnlOi1Aw5OIi2/WafxsZhdID8v/ACLF5P8AKV/pOsXUF3a3
NxJNPIw4RenLFHEUfmafsfjk9ZrPFyCcdqDXo9H4OMwJ4rLC9N/I7UtP1+PXvK3mCCO2imMtgWVp
P3daGN2RqOtKqfEZmy7VjPHwzjd83Dh2SYZOOEqZ359/LXR/OlnD9dY2mp260gvoRyK13KMppzSu
9Kg+BG9cHSa2WA7bxPRztXooZx6tiOrzOD/nGnUzdAXGtwi1B3eOFzIR/qkhQf8AZZtD23Gto7ur
HYe+8tvc9W0zyHpOjeULzy5pA9JbuCaOS5k+J3lmjKepIRSv0ds1GTVynkE5dC7fHpY48ZhFjP5X
flLf+TNYur+51CK7S4tzAEjRlIJdXrUn/JzK13aAzxAAqi4uh7POCRN3bPde0TT9c0i60nUE9S0u
0KSDuO6svgysAR75r8WWWOQlHmHPy4oziYy5F5n5A/JLUfK3mu31qXVIrqG3WVfSWNlY+pGyA7kj
9rNpq+0xlxmNU6zR9l+Dk4uK2Zeefy68vecbVV1BDDewgrbX8NBKg68TXZ0r+yfopmFpdZPCfTy7
nN1WjhmFS597ym4/5xp1lZiLbWreSGuzSROjU/1VLj8c247bjW8S6g9hnpL7GU+T/wDnH7QdJuo7
3Wbk6vPGQ0dvw9O3DD+ZSWMlPcgeIzE1Pa85iojhH2uVpuyMeM3I8R+xNvzW/LO887DSha3sdkNP
9fl6iM3L1vTpTj0p6WU6DWjBxWLuv0t2v0Pj8O9cN/bTJPJHl6by55WsNFmmW4ks1dWmQFVblIz7
A/62YuqzeJkMx1crTYfDxiPcwPz1+S+peZfOEuvQ6nDbxSejSB42Zh6SKp3BpvxzYaXtKOLFwEXz
cHVdmnLl47rk9YzUO1eT/wDKl9S/5WJ/iv8AScPofpH6/wDVfTbnx9Tnw5VpXNv/AClHwPDr+GnV
fyafH8W+t09YzUO1dirsVdirsVdirsVdirAPzou3tfLVpIjlCb1FqDT/AHVIe3ywhUr8tnydp7rr
Fprkt/fWNpNdyafyBDcIGMi/ZHT54oVB+eEH1Rbs6JOIDL6TTep+7GwIAfhQv1+H8caSlWveeNWn
89afJZW1xLa8YZbHT/UZBcq6llkC0oOQbwPTFDKNT/NRYb24sdN0ibUrmxjMmohH4rAVH7xSeDk8
DsTQb40lR1L85NItdM06/gtHuBfhw8fqBDE0RUOrfC1T8VR4jGlU5vzjhVdPMWjzSvqRb6tEJBzZ
RMYRRQhqxZT8I+VcaVVsfzes5V1KK+02WxvtOiaX6o71ZwhAZalUKsK1pTGlSy4/NfStd0XUYrjS
phawQCW5CzAbfWI4kVW4dSZAT/HGkIy3/MrStI0LQ7XTtMkludQQta6eJq8VMzxrWVlJJd1P7OKp
pdfmXDp2iNfaxpk9hfG4a2g01jWSQqqOXViqjhSTrTGkqvlv8wl1TW30PUdNl0jU+HqQQTMWLrx5
HqqUPHfGlYn+YvKb8xdM02W4eC3vYoFZ0anFXldCd9u2IQo+XPMZ0Hzxd6WdVa+0OCOV55y3NAsU
Bl5Chb4lYcPh6nFU5X85o/SF/JodwuiGb0BqAcH4qVpw4ha03pzxpKP1T80YI9ZTSNE059ZumjSW
scgjUrJGJRx+F+XwMCcaViXmjzxr8/mjRqafdWYDW8kelvIy/WH9WtKcQKlvg3GKGU6h+abwXn6O
tdFmu9Tgtxc6hbCQKIP3YkdOXBixQNQ/CN9saSgU/OcfoaTVZdFeOD1kt4CJ6rI7K7MORjFOAQV2
PXGlRcX5w6QdEk1SWzkj/fC2tLfkGeaQIryU2AVU5jf3HjjSrovzLubsappkmmTaXr0FpLPZW0h9
RpCsZcUBRPiA+LjTfGlYT5OOha2XW+1650/zFJL/AKMzNRHrSnxHcuWJ/aHtXFCdXVzf+dPzCvNC
N3Jb6XpxkEkcZp8MDCNzToWaRupGwxVC3Gqah5U8zah5cN5Jdadc2kvpCQ1ZS8DMjezArxNOoxVk
P5K3j3WhXzu5crdUBJr/ALrXxxKXoeBXYq7FXYq7FXYq7FXl3/OQzzL5PsTEjO36QjqEBJp6E3hh
CsWsvPfky40a903TPLE9pq82lXcP10QIvxLaOzmqkt8XDFUrt55m/Iq5Jif1l1gKEKNyr6aHYEeB
xQu1bWZtD8w+RdevrWY6eul2PL0lLMTEGjZRy4jn0NK98VQesW8Giebr648ywavbaJqpe6s7rTyi
uUuG9RVkLho2Kh+LqG2PiKYqpa1Dpcdp5abSbS/XTLu9uJGGoBWmI5wRkn0kVQpCbDf54qy3859a
g0n8zPK93OGaC3W3nlWMcnKR3ZZgo2qaDbFKR3w1nzRqPmjzqmnXFnpKWbi29ZWUyN6a26BR+0eI
LNSoBxQnNm0n/Qut86ROJzODInFuRP12MVpT+UDFKR6le+WJfJegWus21/b6glhJLZalbRepGztd
TL9XlRuPdQdj+127qEDc6P581HyDZazcQ3dzaafdTCGJw7TrBKkX7xAat6YaIjpt16Yqyn8tJ/Jm
pedNPm0lNel1GBZWuJr94GgiIiZSjMicmryoPs/wxSu/NC0OqfnBoumXMcjWNxFawSMgIojzScvi
A9zirNdS/LHR9O8oa1ZeXrY/pG8t2VJZHLyOUIdYgx2UMVptSvfFXkknmm5l/L+28ixaTfHzCl6T
JEYWHw82cbfb5VbjTj2xQv8AOY0WxgispoNRsvOGmQWtvzijL2106QoKq3wspShUMvUL3xVV8wXv
mTSG8ieYPMUNzL6KpJcM6ky8Ybwyojlv2zEy05b+OKoXz95w02Pz1Jf6XNeaXBqNlC+oOgR5St1C
rkelzUCsbJVS/wBrfwxSj/Ndx5bP5VaSPK8817AupN9caRKTCdoWJ9RFqF+EClKinc4oZN+bmh6r
c+TfLGp6ZbyT2+lwAXMUAJkWOWKIq4ABNF9Lc02rilj/AJW1vysmrjWfL9j5g1PWNMt5p5YrxoWi
UrEUMZaONpGrzp28fbFCX+cNe0rztqdjD5W8u3Vrrkr0vjwCqxalOQQldupkbjt1xSndxcax+Wf5
iXOs6nZz32i6gkgmvYF51ExWV6E0UMsq9GIqMVS201aTz/501vzBbp6Gn6fYTypC7L6pCWzJEvEG
pLP8RpsOlemKFv5afmrH5S0u6srrSLu7kuJ/WV4xxAHBVp8Q/wAnFL6OwK7FXYq7FXYq7FXYq7FX
Yq7FXYq7FXYq8x/MH8s/MnmH8x/K/mXT7i0i07RpLZ72Kd5VmYQ3XrN6apG6mqdKsN8VenYq7FXY
q7FXYq7FXYq7FXYq7FXkuuflF5ri84ar5h8razZwx64hj1Gz1K2FwoDkM3AkNyHJQQpA+nCrJ/ys
/LeDyJoMlh9bN9eXUnr3dyV4KW4hQqJVqKtO5qfwwKzPFXYq7FWmVWUqwDKwoyncEHscVYNd/kx5
Hl8zWHmK1tW0+8sp1uWitTwgmZN15xU4j4qH4aV74qzrFX//2Q==
uuid:9FF31C844B89E4118B38AD403A6910BE
uuid:A0F31C844B89E4118B38AD403A6910BE
uuid:9EF31C844B89E4118B38AD403A6910BE
uuid:9DF31C844B89E4118B38AD403A6910BE
15.000000
6.000000
Centimeters
1
False
False
Cyan
Magenta
Black
Default Swatch Group
0
% &&end XMP packet marker&&
[{ai_metadata_stream_123}
<>
/PUT AI11_PDFMark5
[/Document
1 dict begin /Metadata {ai_metadata_stream_123} def
currentdict end /BDC AI11_PDFMark5
%ADOEndClientInjection: PageSetup End "AI11EPS"
%%EndPageSetup
1 -1 scale 0 -118.425 translate
pgsv
[1 0 0 1 0 0 ]ct
gsave
np
gsave
0 0 mo
0 118.425 li
394.977 118.425 li
394.977 0 li
cp
clp
[1 0 0 1 0 0 ]ct
19.7549 69.0186 mo
25.5771 66.1777 li
28.5205 58.6543 li
25.5771 66.1797 li
19.7549 69.0186 li
cp
82.2852 15.5752 mo
84.7217 13.3574 li
96.2686 10.7109 li
96.3955 10.8467 li
88.6777 13.9385 li
88.6777 13.9385 99.0977 13.165 102.572 15.0986 cv
106.043 17.0293 106.043 20.1211 106.043 20.1211 cv
106.075 20.1699 li
105.454 21.5303 104.063 23.8545 101.815 23.8545 cv
98.6377 23.8545 96.1934 23.1201 94.7256 24.5859 cv
93.2588 26.0537 92.2822 28.9873 92.2822 28.9873 cv
93.9922 31.1865 li
93.9922 31.1865 100.593 29.2314 101.815 29.2314 cv
103.037 29.2314 107.193 31.6758 107.193 31.6758 cv
107.927 28.7422 li
107.927 28.7422 111.35 30.21 114.527 31.1865 cv
117.706 32.165 118.438 32.6543 119.66 32.165 cv
120.883 31.6758 122.839 29.4766 122.839 29.4766 cv
122.839 29.4766 118.683 29.7207 116.728 28.0088 cv
114.772 26.2979 114.283 21.6523 114.772 19.4531 cv
115.262 17.2539 116.728 15.7861 116.728 15.7861 cv
116.728 15.7861 115.731 16.7813 114.257 18.042 cv
114.477 16.5674 115.365 14.8818 118.008 13.9385 cv
126.554 10.8828 133.218 12.0322 141.788 14.5225 cv
149.307 16.709 157.038 19.4346 163.837 22.2197 cv
163.428 22.1738 li
151.748 20.9717 140.362 22.8691 131.74 31.4922 cv
130.414 32.8193 129.225 34.2129 128.177 35.6689 cv
127.334 35.2031 126.146 34.5889 125.065 34.1943 cv
123.127 33.4883 120.129 34.1943 118.017 34.373 cv
115.901 34.5498 113.608 40.0205 113.608 40.0205 cv
114.137 40.374 117.838 38.7861 124.184 39.667 cv
124.722 39.7422 125.196 39.8203 125.615 39.9014 cv
123.506 44.1309 122.433 48.8018 122.433 53.8604 cv
122.433 54.5771 122.454 55.2881 122.497 55.9922 cv
116.783 56.8545 114.653 58.2793 109.652 60.6357 cv
103.88 63.3516 93.6904 75.2373 93.6904 75.2373 cv
93.6904 75.2373 100.822 70.8223 105.916 66.748 cv
111.01 62.6729 121.879 60.9736 121.879 60.9736 cv
124.131 64.3604 li
124.386 65.0996 124.669 65.8281 124.981 66.543 cv
124.364 67.5469 122.562 70.4414 117.802 77.9531 cv
116.644 79.7852 116.043 81.2168 115.837 82.3408 cv
14.7275 82.3408 li
16.8047 75.5186 li
22.6475 76.7725 li
22.6475 76.7725 21.5977 73.8828 21.5977 72.3057 cv
21.5977 70.7305 23.1729 70.2031 25.5342 68.8906 cv
27.8926 67.5771 29.4668 64.6865 30.5186 61.7979 cv
31.5703 58.9082 39.6992 61.0098 45.7363 59.4326 cv
46.0195 59.3594 46.2881 59.2881 46.5459 59.2178 cv
44.8896 60.6709 40.3984 65.1582 44.5313 67.8672 cv
49.5156 71.1377 57.25 72.3398 58.626 71.8252 cv
60 71.3105 62.5762 67.5225 67.7354 62.5322 cv
72.8916 57.541 73.374 55.9209 76.2959 55.0615 cv
79.2188 54.2002 82.9795 60.835 85.6982 56.0654 cv
86.1523 55.3848 81.3145 51.3447 80.2832 51.3447 cv
79.251 51.3447 72.7188 54.4404 69.625 56.6797 cv
66.5322 58.918 61.7207 62.3594 61.7207 62.3594 cv
61.7207 62.3594 58.7979 58.4023 55.876 57.8838 cv
54.1602 57.5811 51.4395 57.9307 49.4844 58.2705 cv
51.9932 57.2949 52.7881 56.3555 56.2275 54.4434 cv
60.9512 51.8145 82.9863 31.8506 82.9863 31.8506 cv
82.9863 31.8506 81.4131 32.1123 77.4775 32.1123 cv
73.542 32.1123 71.4443 29.4863 71.4443 26.8584 cv
71.4443 24.2334 75.1162 24.2334 77.4775 23.1816 cv
79.2549 22.3916 82.8809 15.54 82.2852 15.5752 cv
cp
74.9365 44.0313 mo
74.9365 44.0313 67.5205 53.3809 63.9746 54.3496 cv
60.4277 55.3154 58.8164 55.9619 58.8164 55.9619 cv
58.8164 55.9619 63.9746 58.2188 67.5205 56.2822 cv
71.0674 54.3496 72.0342 52.4131 72.6797 50.8027 cv
73.3252 49.1885 74.6143 44.6758 74.9365 44.0313 cv
cp
111.285 40.6963 mo
111.285 40.6963 105.684 47.4189 101.481 49.6602 cv
97.2793 51.9023 88.5947 58.9043 87.4736 61.7051 cv
87.2842 62.1797 86.9492 62.8242 86.5244 63.5664 cv
84.6221 64.4219 70.2422 70.9756 68.5449 74.0361 cv
66.7266 77.3135 73.2734 81.6855 78.0039 81.6855 cv
82.7324 81.6855 83.4619 81.3184 84.1875 79.5 cv
84.9141 77.6787 87.8252 68.5713 87.8252 68.5713 cv
87.7754 68.3389 li
89.3232 65.0498 91.3223 60.666 97.2793 56.9453 cv
104.001 52.7422 110.725 47.4189 111.005 44.6172 cv
111.285 41.8164 111.285 40.6963 111.285 40.6963 cv
cp
183.195 25.4912 mo
185.947 24.9873 li
187.441 29.9678 li
183.195 25.4912 li
cp
false sop
/0
[/DeviceCMYK] /CSA add_res
0 0 0 0.2 cmyk
ef
61.3281 44.1543 mo
55.1865 48.2129 50.9814 52.3965 43.6748 55.8047 cv
43.1602 55.9365 38.2422 57.0195 32.9072 55.5977 cv
27.6162 55.1182 25.0918 57.7158 24.3955 59.8018 cv
23.7012 61.8877 23.7793 64.6689 21.6934 66.0586 cv
19.6074 67.4502 15.0879 70.9268 14.043 75.4463 cv
13.002 79.9658 12.6543 82.252 12.6543 82.252 cv
33.7949 82.2422 54.9355 82.2305 76.0742 82.2207 cv
62.0518 81.6533 62.1406 78.1113 63.0674 75.4463 cv
58.3457 79.0215 35.4531 79.5947 39.7725 66.0586 cv
41.1631 62.584 44.292 59.8018 44.292 59.8018 cv
44.292 59.8018 38.0322 60.4971 36.9912 64.6689 cv
35.9492 68.8408 30.6631 70.9268 30.6631 70.9268 cv
28.3242 79.9326 11.4922 72.9551 24.752 68.2148 cv
26.4902 66.1299 27.6045 66.0586 27.6045 64.3213 cv
27.6045 62.584 27.6045 58.4102 33.5137 58.4102 cv
39.4238 58.4102 44.292 59.4531 50.8975 55.6299 cv
57.5049 51.8047 80.4512 33.3779 80.4512 33.3779 cv
80.4512 33.3779 73.498 34.4199 70.0195 31.9863 cv
66.5449 29.5527 67.2393 24.6846 70.3672 24.6846 cv
78.1592 23.0488 79.8252 18.127 89.7666 13.8242 cv
102.715 9.4541 122.715 8.00391 139.905 12.168 cv
151.376 14.9502 179.54 26.0762 186.146 31.6406 cv
187.235 32.5537 189.251 31.7793 190.784 31.7793 cv
188.468 29.2822 188.928 27.8154 188.928 27.8154 cv
188.928 27.8154 196.228 28.1611 201.444 30.249 cv
204.53 31.4834 206.762 32.4756 208.071 33.0791 cv
208.071 32.1699 li
206.768 30.7266 204.817 28.6729 203.53 27.8154 cv
201.444 26.4238 199.009 26.4238 199.009 26.4238 cv
216.259 20.8223 240.3 15.5498 258.23 15.1221 cv
290.347 11.502 335.718 26.3477 356.526 33.5781 cv
336.302 20.4961 295.238 10.8369 268.892 9.73633 cv
254.43 8.62305 228.911 13.5596 218.132 16.6875 cv
207.355 19.8184 187.884 24.3379 184.06 24.3379 cv
180.234 24.3379 160.633 14.8193 149.639 11.8213 cv
130.78 6.52246 112.891 5.17871 94.0117 9.73633 cv
91.5771 10.083 90.5342 10.4307 90.5342 10.4307 cv
93.2041 8.8291 85.3389 1.17578 83.9268 0 cv
83.9268 0 79.7549 5.5625 79.7549 9.04004 cv
79.7549 12.5176 81.4922 14.9502 81.4922 14.9502 cv
81.4922 14.9502 76.9746 19.8184 72.1074 20.8613 cv
67.2393 21.9043 63.416 25.0332 62.0244 29.2041 cv
60.6338 33.3779 61.3281 38.9404 61.3281 40.6777 cv
61.3281 42.417 61.3281 44.1543 61.3281 44.1543 cv
0 0 0 1 cmyk
ef
129.473 13.5596 mo
131.212 12.5176 132.951 11.8213 132.951 11.8213 cv
134.479 14.9385 137.84 24.3486 133.646 26.7725 cv
130.863 28.5107 127.735 28.8574 127.735 28.8574 cv
128.083 30.4805 128.432 32.1025 128.778 33.7236 cv
129.188 34.3369 li
128.866 34.7383 128.557 35.1436 128.259 35.5557 cv
126.76 34.6396 125.137 33.2842 124.954 31.6406 cv
124.606 28.5107 125.301 27.4668 125.301 27.4668 cv
125.301 27.4668 132.951 25.3809 133.3 22.251 cv
133.646 19.1221 132.302 14.1963 132.302 14.1963 cv
132.302 14.1963 126.344 17.3838 125.301 20.8613 cv
124.26 24.3379 122.521 24.3379 122.521 24.3379 cv
121.314 23.9268 120.583 22.5762 120.781 20.8613 cv
121.459 16.9961 125.854 15.7324 129.473 13.5596 cv
ef
93.6631 25.0332 mo
88.7412 24.7881 85.1309 29.9209 85.3184 35.8115 cv
83.5811 39.2881 79.4092 43.1123 79.4092 43.1123 cv
79.8711 44.7354 80.334 46.3574 80.7979 47.9795 cv
79.0605 49.7197 77.3213 51.457 75.584 53.1963 cv
75.584 53.1963 79.4092 50.4141 82.5381 53.1963 cv
85.666 55.9766 85.666 57.7158 85.666 57.7158 cv
85.666 57.7158 93.5713 47.6592 97.7422 45.2246 cv
102.865 44.6953 105.324 42.8623 106.18 40.5537 cv
107.222 38.8145 106.227 36.4395 106.227 36.4395 cv
105.479 38.4326 99.54 43.2715 96.0967 40.5742 cv
93.9189 39.0029 94.252 36.5713 96.9131 34.6787 cv
99.5742 32.5439 104.094 33.0293 104.094 33.0293 cv
104.094 33.0293 103.051 28.5098 100.617 28.5098 cv
98.1826 28.5098 94.7061 30.5957 94.0117 28.5098 cv
93.3145 26.4238 93.6631 25.0332 93.6631 25.0332 cv
ef
109.196 30.5498 mo
111.975 31.8916 112.797 35.0342 112.124 39.0215 cv
113.693 39.0215 115.053 34.5322 119.366 34.5322 cv
120.85 34.5322 125.373 34.9561 127.54 36.584 cv
128.06 35.8076 128.616 35.0469 129.213 34.3027 cv
127.66 31.5342 126.934 30.5957 124.954 30.5957 cv
122.867 30.5957 119.591 32.7021 116.238 32.3447 cv
114.019 32.1377 112.034 29.0205 109.196 30.5498 cv
ef
110.699 40.3291 mo
110.699 40.3291 105.831 45.5459 102.008 47.6318 cv
98.1826 49.7197 96.791 52.1514 96.791 52.1514 cv
96.791 52.1514 101.659 50.7627 105.137 47.6318 cv
108.613 44.5029 110.699 40.3291 110.699 40.3291 cv
ef
104.441 52.499 mo
104.441 52.499 94.0117 58.7588 90.5342 62.9297 cv
87.0566 67.1016 85.3184 72.666 85.3184 72.666 cv
85.3184 72.666 94.0117 64.6699 97.4873 60.8447 cv
100.965 57.0195 104.441 52.499 104.441 52.499 cv
ef
112.437 54.585 mo
112.437 54.585 102.354 58.4102 97.4873 63.2773 cv
92.6201 68.1455 91.5771 75.0996 91.5771 75.0996 cv
91.5771 75.0996 100.269 63.9727 105.484 61.1904 cv
110.699 58.4102 112.437 54.585 112.437 54.585 cv
ef
124.023 26.2744 mo
125.671 22.1143 127.697 17.6133 130.58 16.7393 cv
130.58 16.7393 128.472 20.0527 129.665 21.2432 cv
130.857 22.4355 133.499 19.3496 133.773 18.334 cv
134.604 21.8398 133.959 25.877 129.785 26.6719 cv
125.613 27.4668 124.023 26.2744 124.023 26.2744 cv
ef
95.2402 38.0352 mo
94.8633 35.8799 101.882 31.4043 105.548 34.75 cv
105.546 38.6484 100.375 40.4961 97.3486 39.9102 cv
99.1445 39.248 103.124 38.0859 103.258 35.4717 cv
100.435 34.6602 97.7715 35.6523 95.2402 38.0352 cv
ef
100.445 34.6191 mo
101.738 34.6191 102.785 35.6689 102.785 36.9609 cv
102.785 38.2539 101.738 39.3037 100.445 39.3037 cv
99.1523 39.3037 98.1045 38.2539 98.1045 36.9609 cv
98.1045 35.6689 99.1523 34.6191 100.445 34.6191 cv
ef
78.1514 36.7051 mo
78.1514 36.7051 63.8828 49.2383 58.376 52.9971 cv
55.3379 54.9238 54.3398 55.3633 48.5801 56.7578 cv
56.5605 56.5664 62.7471 54.7754 68.1396 48.9883 cv
71.4883 43.6992 78.1514 36.7051 78.1514 36.7051 cv
ef
119.811 69.3398 mo
115.662 70.9775 111.518 72.6172 107.37 74.2568 cv
110.973 75.8018 111.531 78.3604 111.531 82.0762 cv
111.531 82.0762 113.916 82.3115 114.244 80.0176 cv
114.571 77.7217 113.588 75.5215 113.588 75.5215 cv
114.773 73.1777 118.063 70.9775 119.811 69.3398 cv
ef
49.6133 58.0928 mo
54.7139 57.292 59.9609 59.6162 62.0723 64.2617 cv
62.0723 64.2617 63.3408 62.0439 66.1943 59.8232 cv
69.0479 57.6035 75.3887 53.7988 75.3887 53.7988 cv
75.3887 53.7988 65.7305 58.5566 63.1943 58.2393 cv
58.2764 57.0146 55.5146 56.0361 49.6133 58.0928 cv
ef
89.2461 26.9473 mo
90.6973 23.8691 99.5195 23.1572 103.017 23.8711 cv
103.017 23.8711 96.6387 24.3037 94.748 25.7363 cv
93.4551 26.7178 93.084 28.877 93.084 28.877 cv
92.2139 28.5762 90.1143 27.2471 89.2461 26.9473 cv
ef
124.654 16.5166 mo
119.8 16.7285 117.983 20.7813 119.496 25.0674 cv
114.891 21.041 117.998 13.5713 124.654 16.5166 cv
ef
15.0635 77.6289 mo
0 79.1367 li
18.0771 81.3965 li
15.0635 77.6289 li
cp
ef
gsave
154.107 80.6592 mo
146.741 80.6592 140.455 78.0361 135.249 72.7852 cv
130.044 67.5371 127.441 61.2266 127.441 53.8604 cv
127.441 46.5361 130.055 40.2617 135.283 35.0342 cv
140.51 29.8057 146.786 27.1914 154.107 27.1914 cv
159.447 27.1914 164.343 28.6592 168.801 31.5918 cv
173.255 34.5264 176.542 38.3525 178.66 43.0742 cv
167.476 43.0742 li
165.931 41.2217 163.958 39.71 161.555 38.541 cv
159.149 37.3711 156.668 36.7881 154.107 36.7881 cv
149.389 36.7881 145.362 38.4521 142.032 41.7842 cv
138.7 45.1123 137.036 49.1377 137.036 53.8604 cv
137.036 58.624 138.692 62.6621 142 65.9688 cv
145.308 69.2793 149.346 70.9316 154.107 70.9316 cv
156.668 70.9316 159.138 70.3477 161.521 69.1797 cv
163.903 68.0098 165.888 66.4775 167.476 64.5801 cv
178.66 64.5801 li
176.586 69.3438 173.321 73.2168 168.865 76.1943 cv
164.41 79.1709 159.49 80.6592 154.107 80.6592 cv
cp
360.11 36.9668 mo
368.553 36.9668 li
377.102 54.9521 li
386.04 36.9668 li
394.977 36.9668 li
380.688 64.8281 li
380.688 80.6592 li
372.579 80.6592 li
372.579 64.2754 li
360.11 36.9668 li
cp
327.471 36.999 mo
335.63 36.999 li
335.63 55.0244 li
349.135 55.0244 li
349.135 36.999 li
357.295 36.999 li
357.295 80.6592 li
349.135 80.6592 li
349.135 63.2939 li
335.63 63.2939 li
335.63 80.6592 li
327.471 80.6592 li
327.471 36.999 li
cp
304.758 81.1563 mo
298.62 81.1563 293.383 78.9697 289.047 74.5957 cv
284.71 70.2227 282.542 64.9668 282.542 58.8281 cv
282.542 52.7285 284.719 47.5 289.074 43.1455 cv
293.429 38.791 298.656 36.6133 304.758 36.6133 cv
309.205 36.6133 313.285 37.835 316.995 40.2783 cv
320.708 42.7227 323.446 45.9111 325.209 49.8428 cv
315.893 49.8428 li
314.607 48.2988 312.964 47.04 310.959 46.0674 cv
308.957 45.0947 306.89 44.6064 304.758 44.6064 cv
300.826 44.6064 297.472 45.9951 294.697 48.7676 cv
291.923 51.543 290.536 54.8965 290.536 58.8281 cv
290.536 62.7979 291.914 66.1621 294.671 68.918 cv
297.426 71.6748 300.788 73.0527 304.758 73.0527 cv
306.89 73.0527 308.947 72.5645 310.933 71.5908 cv
312.916 70.6182 314.569 69.3398 315.893 67.7598 cv
325.209 67.7598 li
323.482 71.7295 320.764 74.9551 317.052 77.4365 cv
313.339 79.915 309.24 81.1563 304.758 81.1563 cv
cp
245.772 36.999 mo
253.104 36.999 li
272.068 64.7813 li
272.068 36.999 li
280.227 36.999 li
280.227 80.6592 li
272.675 80.6592 li
253.931 52.9297 li
253.931 80.6592 li
245.772 80.6592 li
245.772 36.999 li
cp
213.08 36.999 mo
221.241 36.999 li
221.241 62.6328 li
221.241 64.1768 li
221.241 66.125 221.432 67.7695 221.817 69.1104 cv
222.203 70.4521 222.93 71.4268 223.997 72.0313 cv
225.062 72.6396 226.146 72.9424 227.248 72.9424 cv
228.424 72.9424 229.546 72.6484 230.61 72.0596 cv
231.678 71.4717 232.422 70.4141 232.843 68.8906 cv
233.266 67.3652 233.478 65.7207 233.478 63.9561 cv
233.478 62.8535 li
233.478 36.999 li
241.692 36.999 li
241.692 63.9004 li
241.692 67.2451 241.195 70.1768 240.205 72.6934 cv
239.211 75.2109 237.437 77.2422 234.884 78.7861 cv
232.33 80.3301 229.767 81.1016 227.193 81.1016 cv
224.694 81.1016 222.103 80.3193 219.421 78.7568 cv
216.737 77.1943 215.01 75.1465 214.238 72.6123 cv
213.467 70.0742 213.08 66.748 213.08 62.6328 cv
213.08 36.999 li
cp
181.328 36.999 mo
193.29 36.999 li
197.002 36.999 200.088 37.5137 202.552 38.543 cv
205.015 39.5723 206.906 41.4268 208.229 44.1104 cv
209.553 46.793 210.215 49.291 210.215 51.6084 cv
210.215 54.4746 209.525 56.9199 208.146 58.9385 cv
206.769 60.96 205.279 62.4131 203.683 63.2939 cv
202.084 64.1768 200.512 64.7109 198.969 64.8945 cv
210.491 80.6592 li
200.677 80.6592 li
189.486 65.5 li
189.486 80.6592 li
181.328 80.6592 li
181.328 36.999 li
cp
195.604 58.1133 mo
197.406 58.1133 198.95 57.4668 200.236 56.1816 cv
201.521 54.8965 202.166 53.333 202.166 51.498 cv
202.166 49.6602 201.541 48.0986 200.291 46.8105 cv
199.043 45.5254 197.48 44.8818 195.604 44.8818 cv
189.486 44.8818 li
189.486 58.1133 li
195.604 58.1133 li
cp
clp
394.977 81.1563 mo
394.977 27.1914 li
127.441 27.1914 li
127.441 81.1563 li
394.977 81.1563 li
cp
level3{
gsave
clp
[-2.35879e-06 -53.9628 267.531 -4.75783e-07 261.265 81.1416 ]ct
/0
<<
/ShadingType 2
/ColorSpace /0 /CSA get_res
/Coords [0 0 1 0 ]
/Domain [0 1 ]
/Extend[ true true]
/Function
<<
/Domain[0 1 ]
/FunctionType 3
/Functions [
<<
/Domain[0 1 ]
/Range[0 1 0 1 0 1 0 1 ]
/FunctionType 0
/Order 1
/DataSource <~pRV?bpRM9apRD3`pR;-_pmM0_pm;$]pm1s\pltgZplb[XplYUWplGIUpl5=Spl#1Qpkf%OpkSnMq1\kL
q1J_Jq1/MGq0rAEq0`5Cq0N)Aq02l>q/u`
/BitsPerSample 8
/Encode [0 63 ]
/Decode [0 1 0 1 0 1 0 1 ]
/Size [64 ]
>>
]
/Bounds []
/Encode [0 1 ]
>>
>>/Gradient add_res /0 /Gradient get_res clonedict shfill grestore
}if
level3 not{
gsave
[-2.35879e-06 -53.9628 267.531 -4.75783e-07 261.265 81.1416 ]ct
clp
/0 {
/0 /CSA get_res setcolorspace
<<
/NumSamples 256
/NumComp 4
/Scaling[[0.00392157 0 ][0.00392157 0 ][0.00392157 0 ][0.00392157 0 ]]
/Samples[
<~p@e4Rp@e4Rp@e4Rp@n=Up\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\4FVp\=OYq"XXZ
q"XXZq"XXZq"XXZq"XXZq"XXZq"XXZq"XXZq"X[\q>'j^q>'j^q>'j^q>'j^q>'j^q>'j^q>'j^q>'m`
qYL'bqYL'bqYL'bqYL'bqYL'bqYL'bqYL'bqYL'cqtp9fqtp9fqtp9fqtp9fqtp9fqtp9fqtp9gr;?Kj
r;?Kjr;?Kjr;?Kjr;?Kjr;?Kjr;?KjrVc]nrVc]nrVc]nrVc]nrVc]nrVc]nrr2ors8W-!s8W-!s8W-!
~>
<~SXl=BSXc4?S=?";S!oe7R[KS2R$X/+Q^3r&Q'@MsPEM)lP*(lgOH5H_NfB$WN/NUOMM[1GLkgb?L4t>7
KS4u0JUr?%It)orI=6KjH[C'aG^+FVG'8"NFEDSEEcH&;Df9N1D/=!'C2.HsBP1phAS#C_@q&kT?sd5H
?!U`@>?Y35=BAR)<`N.!;c6Lj:esk^9he;S91hfJ84Z6?77BU36:*t'5X.Fq4Zkee3]T/Y2`g,pX][+sA*P+!)ID*#fh8)&O2,()7Ms&eP]e%hB-Z$k*LN#mgkB"pG,3!WiB&
~>
0 0 ]
>>
0 0 1 0 []true true []
/DeviceCMYK
GenStrips
} /Gradient add_res /0 /Gradient get_res exec grestore
}if
np
grestore
gsave
99.4893 96.4805 mo
103.66 96.5508 li
106.966 96.5508 li
107.243 96.7246 li
107.104 98.4639 li
107.035 100.068 li
106.757 100.376 li
103.278 100.376 li
99.4893 100.376 li
99.4893 106.219 li
103.905 106.219 li
108.043 106.219 li
108.321 106.427 li
108.112 108.27 li
107.973 110.078 li
107.625 110.321 li
93.9248 110.321 li
93.7852 110.078 li
93.8887 98.5674 li
93.7852 87.3691 li
93.8887 87.125 li
107.451 87.125 li
107.833 87.4395 li
107.694 89.3164 li
107.625 91.1309 li
107.278 91.3691 li
103.348 91.3691 li
99.4893 91.3691 li
99.4893 96.4805 li
cp
118.325 97.1758 mo
118.068 97.0361 117.751 96.9688 117.379 96.9688 cv
116.841 96.9688 116.389 97.0947 116.012 97.3496 cv
115.207 98.0107 li
115.207 101.837 li
115.207 103.182 115.225 104.584 115.265 106.044 cv
115.306 107.505 115.34 108.849 115.38 110.078 cv
115.207 110.321 li
110.024 110.321 li
109.815 110.078 li
109.921 101.939 li
109.815 93.8037 li
110.061 93.4561 li
110.447 93.4316 110.837 93.3994 111.214 93.3506 cv
111.596 93.3057 112.076 93.2354 112.65 93.1416 cv
115.102 92.6904 li
115.38 93.0381 li
115.38 94.5332 li
116.882 93.3057 118.383 92.6904 119.885 92.6904 cv
120.765 92.6904 121.681 92.9502 122.638 93.4736 cv
123.599 93.9951 124.22 94.7881 124.51 95.8535 cv
124.799 96.9209 124.944 98.1504 124.944 99.541 cv
124.944 101.837 li
124.944 103.389 124.967 104.845 125.014 106.199 cv
125.061 107.557 125.118 108.849 125.188 110.078 cv
124.944 110.321 li
119.832 110.321 li
119.554 110.078 li
119.727 102.498 li
119.727 102.219 119.727 101.945 119.727 101.68 cv
119.727 101.413 119.727 101.141 119.727 100.861 cv
119.727 99.9346 119.635 99.1631 119.449 98.5498 cv
119.258 97.9346 118.888 97.4785 118.325 97.1758 cv
cp
127.97 96.4111 mo
126.16 96.5156 li
125.918 96.2021 li
126.127 93.1074 li
126.403 92.793 li
127.97 92.793 li
127.899 88.7617 li
128.109 88.4824 li
133.082 87.0908 li
133.289 87.3008 li
133.289 92.793 li
136.28 92.793 li
136.525 93.1074 li
136.211 96.2021 li
135.932 96.4111 li
133.22 96.4111 li
133.289 103.158 li
133.289 104.479 li
133.289 105.083 133.33 105.547 133.412 105.87 cv
133.493 106.194 133.679 106.467 133.967 106.688 cv
134.258 106.908 134.658 107.017 135.168 107.017 cv
135.632 107.017 136.06 106.891 136.455 106.636 cv
136.768 106.844 li
136.65 107.237 136.542 107.776 136.437 108.461 cv
136.333 109.145 136.28 109.729 136.28 110.217 cv
135.793 110.53 li
135.093 110.692 134.171 110.774 133.035 110.774 cv
132.287 110.774 131.633 110.722 131.059 110.618 cv
130.49 110.513 129.923 110.275 129.365 109.904 cv
128.811 109.533 128.422 108.879 128.212 107.939 cv
128.004 107.001 127.899 105.917 127.899 104.687 cv
127.899 103.782 li
127.97 96.4111 li
cp
152.625 102.741 mo
152.208 102.983 li
142.366 103.192 li
142.481 104.027 142.725 104.723 143.097 105.278 cv
143.467 105.835 144.012 106.246 144.73 106.513 cv
145.449 106.779 146.169 106.913 146.888 106.913 cv
148.464 106.913 150.052 106.462 151.652 105.557 cv
151.929 105.765 li
151.755 109.487 li
151.304 109.834 li
149.75 110.461 148.034 110.774 146.157 110.774 cv
145.137 110.774 144.175 110.668 143.271 110.461 cv
142.366 110.251 141.357 109.787 140.245 109.069 cv
139.132 108.351 138.344 107.302 137.881 105.922 cv
137.417 104.542 137.185 102.926 137.185 101.07 cv
137.185 99.4727 137.486 98.0225 138.089 96.7246 cv
138.692 95.4268 139.671 94.4297 141.028 93.7334 cv
142.383 93.0381 143.815 92.6904 145.321 92.6904 cv
146.898 92.6904 148.231 93.0313 149.322 93.7158 cv
150.41 94.4004 151.234 95.4512 151.789 96.8643 cv
152.347 98.2773 152.625 100.236 152.625 102.741 cv
cp
146.394 96.5508 mo
146.064 96.3418 145.612 96.2363 145.026 96.2363 cv
144.632 96.2363 144.214 96.3359 143.786 96.5342 cv
143.352 96.7305 143.01 97.125 142.749 97.7158 cv
142.494 98.3076 142.366 98.915 142.366 99.541 cv
147.513 99.541 li
147.513 98.8223 147.455 98.2305 147.34 97.7676 cv
147.224 97.3037 146.905 96.8975 146.394 96.5508 cv
cp
159.718 110.078 mo
159.58 110.321 li
154.399 110.321 li
154.189 110.078 li
154.295 101.939 li
154.189 93.8037 li
154.427 93.4561 li
154.821 93.4316 155.204 93.3994 155.58 93.3506 cv
155.958 93.3057 156.434 93.2354 157.006 93.1416 cv
159.447 92.6904 li
159.718 93.0381 li
159.718 95.6816 li
160.276 94.6602 160.92 93.9248 161.649 93.4736 cv
162.38 93.0215 163.173 92.7598 164.031 92.6904 cv
164.31 93.0381 li
164.263 93.2695 164.165 93.7207 164.014 94.3936 cv
163.862 95.0664 163.764 95.5176 163.718 95.751 cv
163.369 98.4277 li
163.023 98.5332 li
162.652 98.2998 162.211 98.1846 161.702 98.1846 cv
161.307 98.1846 160.912 98.3242 160.518 98.6025 cv
160.124 98.8818 159.869 99.4141 159.754 100.201 cv
159.639 100.99 159.58 101.743 159.58 102.462 cv
159.58 103.76 159.598 105.083 159.627 106.427 cv
159.655 107.771 159.689 108.988 159.718 110.078 cv
cp
171.231 94.0811 mo
171.786 93.6172 172.436 93.2695 173.189 93.0381 cv
173.938 92.8057 174.674 92.6904 175.392 92.6904 cv
176.451 92.6904 177.46 92.9502 178.422 93.4736 cv
179.379 93.9951 180.166 94.9971 180.782 96.4805 cv
181.392 97.9639 181.697 99.3086 181.697 100.516 cv
181.697 102.162 181.368 103.819 180.707 105.488 cv
180.046 107.156 179.106 108.346 177.889 109.053 cv
176.673 109.759 175.565 110.211 174.568 110.407 cv
173.572 110.605 172.414 110.703 171.092 110.703 cv
171.231 118.181 li
171.022 118.425 li
165.84 118.425 li
165.631 118.181 li
165.77 105.174 li
165.631 93.8037 li
165.874 93.4561 li
166.27 93.4316 166.657 93.3994 167.039 93.3506 cv
167.423 93.3057 167.903 93.2354 168.482 93.1416 cv
170.952 92.6904 li
171.231 93.0381 li
171.231 94.0811 li
cp
171.022 105.07 mo
171.126 106.947 li
171.856 106.947 172.43 106.918 172.841 106.861 cv
173.253 106.803 173.769 106.606 174.383 106.27 cv
175.003 105.934 175.479 105.268 175.808 104.271 cv
176.14 103.273 176.307 102.288 176.307 101.313 cv
176.307 100.388 176.181 99.541 175.926 98.7764 cv
175.67 98.0107 175.266 97.4551 174.708 97.1064 cv
174.15 96.7578 173.605 96.585 173.074 96.585 cv
172.655 96.585 172.262 96.6494 171.892 96.7764 cv
171.521 96.9043 171.266 97.0488 171.126 97.21 cv
171.022 105.07 li
cp
188.652 110.078 mo
188.514 110.321 li
183.332 110.321 li
183.124 110.078 li
183.227 101.939 li
183.124 93.8037 li
183.361 93.4561 li
183.756 93.4316 184.139 93.3994 184.515 93.3506 cv
184.893 93.3057 185.366 93.2354 185.94 93.1416 cv
188.38 92.6904 li
188.652 93.0381 li
188.652 95.6816 li
189.209 94.6602 189.853 93.9248 190.584 93.4736 cv
191.313 93.0215 192.107 92.7598 192.966 92.6904 cv
193.243 93.0381 li
193.197 93.2695 193.098 93.7207 192.948 94.3936 cv
192.797 95.0664 192.698 95.5176 192.652 95.751 cv
192.304 98.4277 li
191.957 98.5332 li
191.585 98.2998 191.145 98.1846 190.635 98.1846 cv
190.24 98.1846 189.847 98.3242 189.452 98.6025 cv
189.059 98.8818 188.804 99.4141 188.688 100.201 cv
188.571 100.99 188.514 101.743 188.514 102.462 cv
188.514 103.76 188.529 105.083 188.562 106.427 cv
188.589 107.771 188.623 108.988 188.652 110.078 cv
cp
199.815 84.6924 mo
200.023 85.0039 li
200.023 87.125 li
200.023 89.2129 li
199.647 89.5957 li
197.417 89.8047 li
195.087 90.1162 li
194.844 89.8721 li
194.844 87.7871 li
194.844 85.5957 li
195.255 85.2822 li
197.347 85.0732 li
197.781 85.0732 198.239 85.0283 198.72 84.9346 cv
199.194 84.8428 199.567 84.7617 199.815 84.6924 cv
cp
194.809 110.321 mo
194.6 110.078 li
194.704 101.939 li
194.6 93.8037 li
194.844 93.4561 li
195.238 93.4316 195.625 93.3994 196.009 93.3506 cv
196.392 93.3057 196.872 93.2354 197.451 93.1416 cv
199.921 92.6904 li
200.198 93.0381 li
200.158 94.3125 200.122 95.7383 200.082 97.3154 cv
200.043 98.8916 200.023 100.4 200.023 101.837 cv
200.023 103.182 200.043 104.584 200.082 106.044 cv
200.122 107.505 200.158 108.849 200.198 110.078 cv
199.921 110.321 li
194.809 110.321 li
cp
214.456 93.9082 mo
214.317 94.6035 214.218 95.1826 214.161 95.6465 cv
214.103 96.1104 214.073 96.666 214.073 97.3154 cv
213.692 97.4551 li
213.11 96.9912 212.475 96.6367 211.777 96.3955 cv
211.083 96.1504 210.398 96.0273 209.728 96.0273 cv
209.332 96.0273 209.025 96.0684 208.805 96.1504 cv
208.585 96.2314 208.365 96.3467 208.145 96.498 cv
207.924 96.6494 207.791 96.8516 207.743 97.1064 cv
207.651 97.6182 207.743 98.0107 208.021 98.29 cv
208.301 98.5674 208.719 98.8223 209.274 99.0537 cv
210.179 99.3672 li
211.731 100.016 212.926 100.59 213.762 101.09 cv
214.596 101.588 215.013 102.717 215.013 104.479 cv
215.013 105.522 214.81 106.542 214.403 107.54 cv
213.998 108.535 213.425 109.237 212.671 109.644 cv
211.917 110.049 211.117 110.333 210.259 110.496 cv
209.408 110.657 208.539 110.738 207.664 110.738 cv
206.619 110.738 205.629 110.646 204.696 110.461 cv
203.758 110.275 203.015 109.997 202.458 109.627 cv
202.111 109.208 li
202.203 108.535 202.261 107.887 202.285 107.262 cv
202.309 106.636 202.33 106.032 202.354 105.453 cv
202.703 105.313 li
204.232 106.658 205.798 107.331 207.397 107.331 cv
207.722 107.331 208.034 107.291 208.335 107.21 cv
208.637 107.127 208.887 107.001 209.084 106.827 cv
209.28 106.653 209.425 106.443 209.519 106.199 cv
209.61 105.957 209.658 105.777 209.658 105.662 cv
209.658 105.384 209.564 105.121 209.379 104.879 cv
209.194 104.636 208.289 104.126 206.667 103.348 cv
205.044 102.572 204.024 101.935 203.606 101.436 cv
203.188 100.938 202.893 100.4 202.72 99.8184 cv
202.547 99.2393 202.458 98.6729 202.458 98.1152 cv
202.458 97.5596 202.615 96.7246 202.929 95.6123 cv
203.241 94.499 204.07 93.7334 205.415 93.3164 cv
206.759 92.8994 207.987 92.6904 209.101 92.6904 cv
210.956 92.6904 212.625 92.9912 214.107 93.5957 cv
214.456 93.9082 li
cp
231.496 102.741 mo
231.079 102.983 li
221.237 103.192 li
221.354 104.027 221.597 104.723 221.967 105.278 cv
222.34 105.835 222.885 106.246 223.604 106.513 cv
224.321 106.779 225.039 106.913 225.758 106.913 cv
227.334 106.913 228.922 106.462 230.523 105.557 cv
230.801 105.765 li
230.628 109.487 li
230.175 109.834 li
228.622 110.461 226.906 110.774 225.027 110.774 cv
224.008 110.774 223.046 110.668 222.142 110.461 cv
221.237 110.251 220.229 109.787 219.116 109.069 cv
218.003 108.351 217.214 107.302 216.75 105.922 cv
216.288 104.542 216.056 102.926 216.056 101.07 cv
216.056 99.4727 216.356 98.0225 216.96 96.7246 cv
217.563 95.4268 218.543 94.4297 219.898 93.7334 cv
221.256 93.0381 222.687 92.6904 224.193 92.6904 cv
225.771 92.6904 227.104 93.0313 228.192 93.7158 cv
229.282 94.4004 230.106 95.4512 230.661 96.8643 cv
231.219 98.2773 231.496 100.236 231.496 102.741 cv
cp
225.266 96.5508 mo
224.934 96.3418 224.482 96.2363 223.898 96.2363 cv
223.504 96.2363 223.086 96.3359 222.656 96.5342 cv
222.223 96.7305 221.881 97.125 221.621 97.7158 cv
221.366 98.3076 221.237 98.915 221.237 99.541 cv
226.385 99.541 li
226.385 98.8223 226.327 98.2305 226.21 97.7676 cv
226.095 97.3037 225.775 96.8975 225.266 96.5508 cv
cp
244.781 102.498 mo
244.919 110.078 li
244.746 110.321 li
239.218 110.321 li
239.078 110.078 li
239.182 98.5674 li
239.078 87.3691 li
239.182 87.125 li
245.522 87.125 li
248.356 87.125 250.455 87.3584 251.816 87.8223 cv
253.174 88.2861 254.106 88.9277 254.622 89.752 cv
255.132 90.5752 255.469 91.3574 255.631 92.0986 cv
255.794 92.8418 255.875 93.6172 255.875 94.4297 cv
255.875 96.167 255.526 97.6514 254.832 98.8818 cv
254.136 100.109 253.104 101.019 251.735 101.609 cv
250.368 102.202 248.444 102.498 245.964 102.498 cv
244.781 102.498 li
cp
244.781 98.4277 mo
245.928 98.4277 li
246.3 98.4277 246.752 98.3887 247.285 98.3076 cv
247.819 98.2256 248.345 98.0342 248.866 97.7334 cv
249.39 97.4307 249.76 97.0195 249.979 96.498 cv
250.2 95.9766 250.311 95.2979 250.311 94.4639 cv
250.311 93.6533 250.137 92.9971 249.782 92.498 cv
249.429 92.001 248.936 91.6641 248.305 91.4893 cv
247.667 91.3164 246.843 91.2295 245.834 91.2295 cv
244.781 91.2295 li
244.781 98.4277 li
cp
263.664 92.793 mo
264.082 92.7256 264.568 92.6904 265.125 92.6904 cv
266.307 92.6904 267.473 92.876 268.621 93.2461 cv
269.767 93.6172 270.683 94.2041 271.367 95.002 cv
272.052 95.8027 272.545 96.8398 272.845 98.1152 cv
273.146 99.3916 273.296 100.689 273.296 102.01 cv
273.296 102.773 273.262 103.453 273.192 104.045 cv
273.122 104.636 272.96 105.354 272.705 106.199 cv
272.451 107.048 271.958 107.857 271.228 108.634 cv
270.498 109.412 269.61 109.956 268.567 110.268 cv
267.524 110.582 266.389 110.738 265.161 110.738 cv
264.023 110.738 262.97 110.611 261.995 110.356 cv
261.021 110.102 260.118 109.627 259.281 108.93 cv
258.447 108.235 257.833 107.291 257.438 106.097 cv
257.044 104.903 256.848 103.61 256.848 102.219 cv
256.848 101.779 256.854 101.431 256.864 101.175 cv
256.877 100.92 256.929 100.312 257.022 99.3506 cv
257.114 98.3887 257.456 97.3496 258.048 96.2363 cv
258.639 95.124 259.584 94.2207 260.882 93.5244 cv
261.369 93.3164 261.826 93.1543 262.256 93.0381 cv
262.685 92.9229 263.154 92.8418 263.664 92.793 cv
cp
262.585 105.139 mo
262.771 105.743 262.999 106.206 263.265 106.531 cv
263.532 106.856 263.827 107.053 264.152 107.122 cv
264.477 107.192 264.754 107.227 264.986 107.227 cv
265.657 107.227 266.231 107.035 266.708 106.653 cv
267.183 106.27 267.513 105.633 267.698 104.739 cv
267.883 103.848 267.977 102.856 267.977 101.768 cv
267.977 101.256 267.964 100.811 267.942 100.427 cv
267.919 100.045 267.854 99.4941 267.751 98.7764 cv
267.645 98.0576 267.473 97.5195 267.229 97.1592 cv
266.984 96.7998 266.679 96.54 266.307 96.376 cv
265.937 96.2148 265.576 96.1328 265.23 96.1328 cv
264.719 96.1328 264.255 96.248 263.838 96.4805 cv
263.282 96.8516 262.876 97.5459 262.621 98.5674 cv
262.366 99.5879 262.239 100.712 262.239 101.939 cv
262.239 102.613 262.272 103.232 262.342 103.801 cv
262.412 104.369 262.494 104.815 262.585 105.139 cv
cp
286.511 93.9082 mo
286.373 94.6035 286.274 95.1826 286.217 95.6465 cv
286.157 96.1104 286.128 96.666 286.128 97.3154 cv
285.747 97.4551 li
285.168 96.9912 284.53 96.6367 283.834 96.3955 cv
283.14 96.1504 282.454 96.0273 281.782 96.0273 cv
281.389 96.0273 281.08 96.0684 280.859 96.1504 cv
280.641 96.2314 280.42 96.3467 280.199 96.498 cv
279.98 96.6494 279.846 96.8516 279.801 97.1064 cv
279.707 97.6182 279.801 98.0107 280.079 98.29 cv
280.356 98.5674 280.773 98.8223 281.33 99.0537 cv
282.233 99.3672 li
283.787 100.016 284.982 100.59 285.816 101.09 cv
286.651 101.588 287.067 102.717 287.067 104.479 cv
287.067 105.522 286.866 106.542 286.461 107.54 cv
286.054 108.535 285.479 109.237 284.728 109.644 cv
283.974 110.049 283.173 110.333 282.316 110.496 cv
281.463 110.657 280.595 110.738 279.718 110.738 cv
278.676 110.738 277.686 110.646 276.751 110.461 cv
275.812 110.275 275.069 109.997 274.514 109.627 cv
274.166 109.208 li
274.26 108.535 274.317 107.887 274.341 107.262 cv
274.363 106.636 274.388 106.032 274.41 105.453 cv
274.758 105.313 li
276.287 106.658 277.853 107.331 279.452 107.331 cv
279.776 107.331 280.091 107.291 280.391 107.21 cv
280.693 107.127 280.941 107.001 281.139 106.827 cv
281.335 106.653 281.482 106.443 281.573 106.199 cv
281.667 105.957 281.713 105.777 281.713 105.662 cv
281.713 105.384 281.619 105.121 281.434 104.879 cv
281.249 104.636 280.346 104.126 278.723 103.348 cv
277.1 102.572 276.078 101.935 275.662 101.436 cv
275.244 100.938 274.949 100.4 274.775 99.8184 cv
274.601 99.2393 274.514 98.6729 274.514 98.1152 cv
274.514 97.5596 274.67 96.7246 274.983 95.6123 cv
275.297 94.499 276.126 93.7334 277.47 93.3164 cv
278.814 92.8994 280.042 92.6904 281.157 92.6904 cv
283.012 92.6904 284.68 92.9912 286.164 93.5957 cv
286.511 93.9082 li
cp
289.259 96.4111 mo
287.45 96.5156 li
287.207 96.2021 li
287.416 93.1074 li
287.695 92.793 li
289.259 92.793 li
289.189 88.7617 li
289.398 88.4824 li
294.371 87.0908 li
294.58 87.3008 li
294.58 92.793 li
297.57 92.793 li
297.814 93.1074 li
297.502 96.2021 li
297.223 96.4111 li
294.511 96.4111 li
294.58 103.158 li
294.58 104.479 li
294.58 105.083 294.621 105.547 294.701 105.87 cv
294.782 106.194 294.967 106.467 295.259 106.688 cv
295.549 106.908 295.948 107.017 296.458 107.017 cv
296.922 107.017 297.352 106.891 297.745 106.636 cv
298.057 106.844 li
297.941 107.237 297.831 107.776 297.728 108.461 cv
297.622 109.145 297.57 109.729 297.57 110.217 cv
297.084 110.53 li
296.383 110.692 295.46 110.774 294.326 110.774 cv
293.577 110.774 292.923 110.722 292.349 110.618 cv
291.781 110.513 291.212 110.275 290.655 109.904 cv
290.101 109.533 289.711 108.879 289.504 107.939 cv
289.294 107.001 289.189 105.917 289.189 104.687 cv
289.189 103.782 li
289.259 96.4111 li
cp
314.575 92.8633 mo
314.714 93.1074 li
314.611 94.6035 li
314.575 96.2725 li
314.263 96.5508 li
312.211 96.376 li
312.651 97.3262 312.871 98.2666 312.871 99.1934 cv
312.871 100.027 312.675 100.827 312.281 101.593 cv
311.887 102.356 311.278 102.99 310.455 103.487 cv
309.631 103.986 308.92 104.3 308.316 104.427 cv
307.713 104.555 307.134 104.624 306.578 104.636 cv
306.021 104.648 305.604 104.653 305.325 104.653 cv
304.873 105.628 li
307.064 106.322 li
308.989 106.901 310.455 107.446 311.464 107.956 cv
312.471 108.468 313.121 109.117 313.41 109.904 cv
313.7 110.692 313.845 111.376 313.845 111.956 cv
313.845 112.65 313.741 113.318 313.533 113.956 cv
313.324 114.592 312.912 115.26 312.297 115.955 cv
311.683 116.651 310.755 117.189 309.516 117.572 cv
308.276 117.953 306.972 118.146 305.604 118.146 cv
304.792 118.146 304.017 118.088 303.273 117.973 cv
302.206 117.74 301.257 117.347 300.422 116.79 cv
299.588 116.233 299.048 115.619 298.805 114.946 cv
298.562 114.272 298.439 113.693 298.439 113.208 cv
298.439 112.65 298.526 112.113 298.701 111.591 cv
298.874 111.07 299.112 110.623 299.413 110.251 cv
299.715 109.881 299.958 109.608 300.144 109.434 cv
300.329 109.261 300.527 109.093 300.733 108.93 cv
300.527 108.79 300.329 108.641 300.144 108.479 cv
299.958 108.314 299.773 108.13 299.588 107.921 cv
299.588 107.505 li
299.982 106.926 300.363 106.304 300.733 105.645 cv
301.106 104.984 301.406 104.351 301.64 103.75 cv
299.97 102.658 299.09 101.62 298.996 100.636 cv
298.903 99.6514 298.858 98.9971 298.858 98.6729 cv
298.858 98 298.974 97.3213 299.205 96.6367 cv
299.436 95.9531 299.883 95.2637 300.544 94.5684 cv
301.205 93.8721 302.127 93.415 303.309 93.1953 cv
304.491 92.9746 305.882 92.8633 307.481 92.8633 cv
314.575 92.8633 li
cp
303.97 99.7852 mo
304.225 100.736 304.591 101.274 305.065 101.401 cv
305.54 101.529 305.835 101.593 305.95 101.593 cv
306.368 101.593 306.753 101.448 307.099 101.156 cv
307.447 100.869 307.696 100.498 307.848 100.045 cv
307.997 99.5928 308.072 99.1123 308.072 98.6025 cv
308.072 98.4873 308.062 98.3584 308.038 98.2188 cv
308.014 98.0791 307.992 97.8896 307.968 97.6445 cv
307.944 97.4014 307.806 97.0947 307.55 96.7246 cv
307.295 96.3535 307.019 96.1104 306.716 95.9932 cv
306.415 95.8779 306.159 95.8213 305.95 95.8213 cv
305.604 95.8213 305.256 95.9365 304.907 96.167 cv
304.562 96.4004 304.299 96.7764 304.127 97.2988 cv
303.951 97.8193 303.864 98.334 303.864 98.8447 cv
303.864 99.2168 303.899 99.5303 303.97 99.7852 cv
cp
302.961 113.208 mo
303.055 113.672 303.298 114.071 303.691 114.407 cv
304.086 114.744 304.508 114.962 304.961 115.068 cv
305.412 115.174 305.882 115.225 306.368 115.225 cv
306.693 115.225 306.983 115.2 307.238 115.155 cv
307.492 115.109 307.737 115.011 307.968 114.859 cv
308.201 114.708 308.392 114.471 308.542 114.147 cv
308.693 113.821 308.768 113.497 308.768 113.173 cv
308.768 113.012 308.722 112.795 308.63 112.53 cv
308.537 112.263 308.112 111.985 307.359 111.695 cv
306.605 111.404 305.87 111.145 305.152 110.912 cv
304.004 110.53 li
303.309 111.411 302.961 112.199 302.961 112.894 cv
302.961 113.208 li
cp
321.704 110.078 mo
321.564 110.321 li
316.385 110.321 li
316.176 110.078 li
316.281 101.939 li
316.176 93.8037 li
316.414 93.4561 li
316.807 93.4316 317.189 93.3994 317.567 93.3506 cv
317.943 93.3057 318.419 93.2354 318.992 93.1416 cv
321.433 92.6904 li
321.704 93.0381 li
321.704 95.6816 li
322.262 94.6602 322.905 93.9248 323.636 93.4736 cv
324.365 93.0215 325.159 92.7598 326.017 92.6904 cv
326.296 93.0381 li
326.249 93.2695 326.151 93.7207 326 94.3936 cv
325.849 95.0664 325.749 95.5176 325.704 95.751 cv
325.356 98.4277 li
325.008 98.5332 li
324.638 98.2998 324.198 98.1846 323.688 98.1846 cv
323.292 98.1846 322.897 98.3242 322.504 98.6025 cv
322.109 98.8818 321.854 99.4141 321.739 100.201 cv
321.623 100.99 321.564 101.743 321.564 102.462 cv
321.564 103.76 321.584 105.083 321.612 106.427 cv
321.642 107.771 321.675 108.988 321.704 110.078 cv
cp
342.535 102.741 mo
342.119 102.983 li
332.277 103.192 li
332.393 104.027 332.637 104.723 333.007 105.278 cv
333.378 105.835 333.923 106.246 334.642 106.513 cv
335.36 106.779 336.078 106.913 336.797 106.913 cv
338.374 106.913 339.962 106.462 341.562 105.557 cv
341.84 105.765 li
341.666 109.487 li
341.215 109.834 li
339.661 110.461 337.945 110.774 336.067 110.774 cv
335.048 110.774 334.085 110.668 333.182 110.461 cv
332.277 110.251 331.269 109.787 330.156 109.069 cv
329.042 108.351 328.255 107.302 327.79 105.922 cv
327.328 104.542 327.096 102.926 327.096 101.07 cv
327.096 99.4727 327.396 98.0225 327.999 96.7246 cv
328.603 95.4268 329.582 94.4297 330.937 93.7334 cv
332.294 93.0381 333.727 92.6904 335.233 92.6904 cv
336.809 92.6904 338.142 93.0313 339.23 93.7158 cv
340.322 94.4004 341.146 95.4512 341.701 96.8643 cv
342.259 98.2773 342.535 100.236 342.535 102.741 cv
cp
336.305 96.5508 mo
335.975 96.3418 335.522 96.2363 334.937 96.2363 cv
334.544 96.2363 334.126 96.3359 333.697 96.5342 cv
333.263 96.7305 332.919 97.125 332.659 97.7158 cv
332.404 98.3076 332.277 98.915 332.277 99.541 cv
337.425 99.541 li
337.425 98.8223 337.366 98.2305 337.248 97.7676 cv
337.133 97.3037 336.813 96.8975 336.305 96.5508 cv
cp
357.802 88.2383 mo
357.419 92.5508 li
357.14 92.6904 li
355.425 91.3691 353.758 90.708 352.133 90.708 cv
351.508 90.708 350.877 90.8809 350.238 91.2295 cv
349.601 91.5781 349.283 92.2021 349.283 93.1074 cv
349.283 93.6865 349.566 94.2041 350.134 94.6553 cv
350.703 95.1074 351.393 95.4961 352.202 95.8213 cv
353.073 96.167 li
354.836 96.8867 356.161 97.7451 357.054 98.7422 cv
357.947 99.7373 358.462 101.024 358.602 102.602 cv
358.602 103.853 358.393 105.1 357.977 106.339 cv
357.559 107.58 356.893 108.506 355.977 109.122 cv
355.061 109.737 354.115 110.164 353.142 110.407 cv
352.169 110.652 351.113 110.774 349.979 110.774 cv
348.702 110.774 347.515 110.641 346.413 110.373 cv
345.312 110.107 344.355 109.718 343.544 109.208 cv
343.302 108.825 li
343.347 108.525 343.412 108.148 343.493 107.696 cv
343.572 107.245 343.613 106.96 343.613 106.844 cv
343.788 104.653 li
344.102 104.514 li
345.955 105.929 347.798 106.636 349.63 106.636 cv
350.441 106.636 351.241 106.422 352.03 105.992 cv
352.818 105.563 353.211 104.85 353.211 103.853 cv
353.211 103.134 352.945 102.555 352.411 102.115 cv
351.878 101.674 351.078 101.198 350.012 100.689 cv
349.074 100.236 li
347.428 99.4482 346.153 98.5918 345.249 97.6641 cv
344.343 96.7363 343.892 95.4727 343.892 93.8721 cv
343.892 92.7129 344.112 91.5713 344.553 90.4463 cv
344.992 89.3223 345.764 88.4258 346.866 87.7529 cv
347.967 87.0801 349.56 86.7441 351.647 86.7441 cv
352.781 86.7441 353.896 86.8711 354.985 87.125 cv
356.075 87.3799 357.014 87.7529 357.802 88.2383 cv
cp
375.259 109.627 mo
375.746 109.857 376.291 110.107 376.893 110.373 cv
377.495 110.641 378 110.856 378.405 111.017 cv
378.813 111.179 379.269 111.342 379.779 111.505 cv
380.29 111.666 380.741 111.816 381.136 111.956 cv
381.24 112.304 li
379.502 115.955 li
379.084 116.128 li
378.344 115.688 377.536 115.231 376.667 114.749 cv
375.797 114.272 374.934 113.816 374.076 113.377 cv
373.218 112.935 372.204 112.433 371.034 111.875 cv
369.862 111.317 369.023 110.912 368.513 110.657 cv
367.424 110.542 366.426 110.309 365.521 109.956 cv
364.617 109.608 363.661 108.994 362.652 108.112 cv
361.645 107.227 360.891 105.998 360.394 104.415 cv
359.895 102.839 359.645 101.129 359.645 99.292 cv
359.645 98.8047 359.667 98.2998 359.714 97.7744 cv
359.761 97.252 359.854 96.4111 359.991 95.2471 cv
360.131 94.0889 360.624 92.7314 361.47 91.1885 cv
362.316 89.6416 363.336 88.5918 364.53 88.0371 cv
365.726 87.4736 366.56 87.125 367.034 86.9863 cv
367.51 86.8496 368.036 86.7783 368.617 86.7783 cv
369.081 86.7783 369.485 86.7783 369.833 86.7783 cv
371.318 86.7783 372.803 87.0332 374.285 87.5439 cv
375.77 88.0527 376.94 88.8359 377.797 89.8906 cv
378.655 90.9453 379.269 92.2266 379.642 93.7334 cv
380.012 95.2393 380.196 96.8271 380.196 98.498 cv
380.196 100.561 379.966 102.322 379.502 103.782 cv
379.038 105.244 378.48 106.443 377.831 107.382 cv
377.183 108.321 376.326 109.069 375.259 109.627 cv
cp
368.096 91.3691 mo
367.284 91.8779 366.628 92.8057 366.131 94.1504 cv
365.632 95.4961 365.383 97.0264 365.383 98.7422 cv
365.383 100.341 365.504 101.779 365.748 103.053 cv
365.991 104.329 366.42 105.186 367.034 105.628 cv
367.649 106.066 368.17 106.344 368.6 106.462 cv
369.028 106.577 369.463 106.636 369.902 106.636 cv
370.506 106.636 371.056 106.531 371.556 106.322 cv
372.054 106.113 372.528 105.703 372.981 105.088 cv
373.433 104.473 373.752 103.732 373.937 102.862 cv
374.122 101.993 374.261 101.164 374.354 100.376 cv
374.446 99.5879 374.494 98.7998 374.494 98.0107 cv
374.494 96.6904 374.366 95.4961 374.11 94.4297 cv
373.855 93.3623 373.473 92.5801 372.963 92.0811 cv
372.454 91.583 371.983 91.248 371.556 91.0732 cv
371.126 90.8984 370.669 90.8135 370.182 90.8135 cv
369.857 90.8135 369.562 90.8477 369.296 90.917 cv
369.028 90.9873 368.803 91.0508 368.617 91.1084 cv
368.433 91.167 368.258 91.2529 368.096 91.3691 cv
cp
381.762 110.321 mo
381.623 110.078 li
381.726 98.5674 li
381.623 87.3691 li
381.726 87.125 li
387.291 87.125 li
387.466 87.3691 li
387.418 88.9922 387.384 90.7998 387.361 92.793 cv
387.337 94.7881 387.326 96.7119 387.326 98.5674 cv
387.326 106.079 li
394.733 105.974 li
394.977 106.356 li
394.697 109.974 li
394.456 110.321 li
381.762 110.321 li
cp
clp
394.977 118.425 mo
394.977 84.6924 li
93.7852 84.6924 li
93.7852 118.425 li
394.977 118.425 li
cp
/0
<<
/Name (Black)
/CSA /0 get_csa_by_name
/MappedCSA /0 /CSA get_res
/TintMethod /Subtractive
/TintProc null
/NComponents 4
/Components [ 0 0 0 1 ]
>>
/CSD add_res
1 /0 /CSD get_res sepcs
level3{
gsave
clp
[0 -33.7323 301.188 0 244.39 118.423 ]ct
/1
<<
/ShadingType 2
/ColorSpace [/Separation /sep_colorspace_dict AGMCORE_gget dup /Name get exch /MappedCSA get /sep_colorspace_proc load]
/Coords [0 0 1 0 ]
/Domain [0 1 ]
/Extend[ true true]
/Function
<<
/Domain[0 1 ]
/FunctionType 3
/Functions [
<<
/Domain[0 1 ]
/FunctionType 2
/C0 [1 ]
/C1 [0.5 ]
/N 1
>>
]
/Bounds []
/Encode [0 1 ]
>>
>>/Gradient add_res /1 /Gradient get_res clonedict shfill grestore
}if
level3 not{
gsave
[0 -33.7323 301.188 0 244.39 118.423 ]ct
clp
/1 {
<<
/NumSamples 256
/NumComp 1
/Scaling[[0.00392157 0 ]]
/Samples[
<~s8N#rrVZTjqtg0bq=saZp\+=Rp%7nJoCDJBnaQ&:n*]W2mHj3*lg!d"l0.?okN:pgjlGL_j5T(WiS`YO
hqm5Gh;$f?gY1B7g"=s/f@JO'e^W*te'c[ldEp7dcd'h\c-4DTbK@uLaiMQDa2Z-<`Pf^4_ns:,_8*k$
^V7Fq]tD"i]=PSa\[]/Y\$i`Q[C!fV50o^US=KVTqJ'N
T:VXFSXc4>S!oe6R@'A.Q^3r&Q'@MsPEM)kOcYZcO,f6[NJrgSMi*CKM26tCLPCP;KnP,3K7\]+JUi9#
~>
]
>>
0 0 1 0 []true true []
/Separation
GenStrips
} /Gradient add_res /1 /Gradient get_res exec grestore
}if
np
grestore
%ADOBeginClientInjection: EndPageContent "AI11EPS"
userdict /annotatepage 2 copy known {get exec}{pop pop} ifelse
%ADOEndClientInjection: EndPageContent "AI11EPS"
grestore
grestore
pgrs
%%PageTrailer
%ADOBeginClientInjection: PageTrailer Start "AI11EPS"
[/EMC AI11_PDFMark5
[/NamespacePop AI11_PDFMark5
%ADOEndClientInjection: PageTrailer Start "AI11EPS"
[
[/CSA [/0 ]]
[/CSD [/0 ]]
[/Gradient [/0 /1 ]]
] del_res
Adobe_AGM_Image/pt gx
Adobe_CoolType_Core/pt get exec
Adobe_AGM_Core/pt gx
currentdict Adobe_AGM_Utils eq {end} if
%%Trailer
Adobe_AGM_Image/dt get exec
Adobe_CoolType_Core/dt get exec
Adobe_AGM_Core/dt get exec
%%EOF
%AI9_PrintingDataEnd
userdict /AI9_read_buffer 256 string put
userdict begin
/ai9_skip_data
{
mark
{
currentfile AI9_read_buffer { readline } stopped
{
}
{
not
{
exit
} if
(%AI9_PrivateDataEnd) eq
{
exit
} if
} ifelse
} loop
cleartomark
} def
end
userdict /ai9_skip_data get exec
%AI9_PrivateDataBegin
%!PS-Adobe-3.0 EPSF-3.0
%%Creator: Adobe Illustrator(R) 13.0
%%AI8_CreatorVersion: 13.0.0
%%For: (Fitri Ardiwahyudi) ()
%%Title: (Crunchy_EnterprisePostgreSQL.eps)
%%CreationDate: 12/19/14 7:57 PM
%AI9_DataStream
%Gb!R&q-NX9Z7,Y,!;?IC1./ni"r/"B5X@hY_O3ta&2:n'q`TG!CHpA*ktGVsf\bEG4T6D?Uf5fL;cctCV7ka6F?/Rr-XW_7J*#H:
%PAqr_S3+\8h8pAonp5)hS&&@e-H`X@!#e>UaUC"$7%"IMKdTbq2BC,\A,N^Cr#JHH9l\l+bie*PGUh![md`T5M>O%="a<#qd^[aF
%\\,nfe@RCS%tpqWgKD%m;$L<9j6ri+E8835rcSNUcCJK*F?/lO6/Bcd#(T(ualTj#DnPEIRK.EU5Pp/hF*&Z*Nk`%-MZr_pHGDl1
%aqsHV\mo\ZqXHf-%).JfL"KN:Vj#^4JUKWTSW,^h!?Q]AiM%cF,+Cokb'0g2N!$PH0[V/`-Fbo/`[%huQZ.!s)bjm"S3*9QUKNUK
%P%PJ,%K84)r&Y/Ukm]"ul27$0[5mRc+r/'cC\YYPfZ?,"3Ql!hC`7i%1MLn0AiUogGE^teL5B>O$%RqJIk]0Yj"_?/Y#!)27"q-m_aq7e)3)p+"-LqB+h3sM-F_HNh![chOc:^9E?HMGa58j8'BM1r!h5$Zh-'NBc!YWB`gojrLfo\,,o@1U
%"HB.,Tm<-C^ajF"24Wae5eT]N'2>CX'Obo[*;1-8VW7(Qq7m)iAlSf:oKVS#&7Mg\9Vdf$\sU_OPG^AM[0#?-kS(A`37NiG"G+G6Al5%6
%(:D9$5P0%UMcs\uW"o/`5#JA$)7:r\d?EZI\l15V2M-JI$3J8AVZd+W(Bj:;kqVEUkmtU$m\2)nrC"Na7A$Ln)ADs8XjEI!8BF"O
%,4p`GTFmkn1i>nlngk[mqF#h,&YVu'M9q)E7O(6lB\_f1\r+L\E"Zmur2:>K(]$O:"9Df'r'7Hd[,d2hE(C
%SFVKE+TG7g1d:Pg+;#*H;3Q?[A*>jdKuQVC9W1:L7H6b-kV"bR_LM2LHB,/$:Xf`2%t,'C&h+uG-28'A.KcX4<.67A8H/tG;(Fsl
%8f'7'dX0JbdP$3=5c4H'/a,FK#*"X8-5mnNRZ*]j7H6b-W"kG51d45>ngsW*D:%KO?7OW-G6m:9"sVl&L8h7NBgY$2P!W]1l368u
%Tf_KZTfU"_k_=CY3C:bUqMn`Vli]@pT%k^n8C*-)&nr[T-aY$."T4>%YG1FF)4-\)X.ia]:5\BOl)&L)a<,_3OWgah$C<3,'gA93
%;+dR\'l)+0df*.W">4s4Hj'?Xr?bR-Q2\b_jGrf#r(ABYho]m.cfIlta;*eqq3Oj?^Qm^;?RA/>c=A?kN:a;U,^5L1jBnlSr`4K3
%IkED#P:Odonukq7Ik/:U5=YWBloF&GqBUG7J()0RD\uhD=\bgsSh1:90p@J&I(CL-nOu')^R*?uGT-OVH1X7*8]BX-cbOsq2pJ8r
%@]#M)pim_FAd(Ad5ck067_m?Hip`.^B.Bi+q4HfsYW0`I/$hNOs'6ZgD'XA.7UPgf'#.5"W\QMRnPh!*e[b5oVEc^$L/3O<)?$pm=;WbbV=-n@T*3SrXdo\n`Pp#+B^S*6jVoB@9jIBJ?H@U)]6f\[1TJB_\PPBWb9l`diA?$cPOV&6U""Y`BV3L+Qe:\=--':+&
%H\pn[$G'#&J=pOQ$;T],-7+X3KCg#6:;V@:#t$$pbmJ2K'dV&"r#i;'Su,DEGsZHs-!Znr)2o5BSs?+>6VgA4&O3Ra*+gp,3'l(-
%[EBhRfR?BhKV%5=Op"6Of,@qG0dJ%1`6_g_[YdBK-5<@YLVf5NS>'7VY?60Q)ZC&V@PGh8t&!M+ZjB2fl`[o4*
%V7'&$oc/()@k%bU9K1B@O,)Fl7DaoS6.Q#qQDGLSIa\m:qIU=V#e-amV2@\7&;Ng&.BggKMqO%?SPgOa2j@Vlc=BfY%N.2C(V-<;
%!61HQ'I-Ef?sD;Dl4qiGU8>Bg)/A%pCU0+g^t&Yd'GaONpP:1[Kt4!GkZQ+P.RMJODg=/g6;R.krD+.Cg7k/@?&S>HdVmj*oUGC_
%rIqE'B+`/q.%+R-b7]4IFp>Ko!uDs5@[K&h'ZPK*_;aj)q4eE;1MHM]4KNk1CbU:h#+tX\Z(^U6bIB#gt:]"3-UbSqLe+(6&8U;-CVb$.n
%V7A@N'$EOf9[n8A$PJq!B4!D86=VlsQjUQ^Ij95*hpJqKmP'n_oN1l@d$>6s<"_m9K)S6.J9`A*66'Jbj?N&mU69U%[k3b,'>9L?
%a:t%baUAS&bYeo_$](lCob#8p8tC&mZ?Kur6OBNhR[OP;BZUUJG_o(g./'0[,,
%\VEdM&\"F\K\Amd(.XMud%DrL(ARVmKU^%*\jj\iY+es[eR4WhPOHT$8\HCtP,2'83)#p`UJ'#)+:EhA8Ol@JQWcgM7H3>@HVVU4
%c+-9r++bmI`?j^e[>NHQ`ip^o_ESe.J&E;]mrSb<%5l0sT,EG1aU"SY&gVL)C4SC&0II^;@h=d`M8`@5is]hH8:/g
%<517rTqL%\=`Q:IgE*-$`))BqhkC'VqR7>DRYl3t59OJteYG:Pj!C7F6qlDZ!kIs7e%="3BKM
%kRY[=7/3]u+aZa3$=$0G]W=qu,>LfE!KN<>co/#k=dF)nN0Hp9qFPXjqcHL93]=iRNP6a="i^MXe"ZX?U6ifqWrG^5IYl&e17,=H
%UQNHtYVij1e._P!MkT*KqVpBEcF5,_Mi`3hDT66#!c].g`3<3!Q051`e4rb9ZeG8PV\E@A&t^YEC`/OB.;A
%JW*Cpc'5^N7CNO)H6.CXOiS2#T9N`M&_0H*6CEJf(bHt$g!VuPg1,7UGMGOu&Q$RDYDO#9
%A$:ZJ;XV:bE[%k\'Jb5*k:H0_Z>6f^V&-jITiPKO%G\m)!(Mgkaj\=gi#EN9*]oA-Di`G\WoG`'ZiJF"=a:"^!MfN0=hZu.Q^QhYgoZjC^7sfl06bmEi$f^OcNJ/-N=c-2J&684b"GK3i:2j--
%O5a%.7ClD@[LL-UTSs/A7>5Jep*5q2Q*Ec9;b=oTQ+^j_&)jCOL-.a]8:*iMb4DE$+t:R2X:hP/Z4sA#Iuodl8DHkNF>Sas0:1bV
%0Y^3AU-bh(b>qfk7ESVnXWbHYY#(aTI]'D!+/SL^^EN%ACCpB,P5lW;Z2C5mTif?_->r;"O.$Z2#d[PK9?<+;92!7F#F%WkW3(5qXL5qTgrJ5[Y5'WN!OrID);nn]'=^jZ1=d6[h^M'F=]#8eJn'1A8DH4[?EcsA:S@\X;
%rj4b+2`lq9GA01,o]H7aFH-4_-;VG-`pd=;E\5u_c2s=$DFLq)i6-Q!r>G5Cn?@"#q:8^Z(B]"LXWCY#(YpBW3WF9[:8_U4J(e+I
%2l4^m.VeuJ"%O"h0Y*V`9!;]e)X&mj`Pqj:/C<)j"5NgH%)(F6O,%(OBD+LT)'L]D04Q4#ej(R@45rMN*ref]3tTSbI_4)!E;ln/
%UZtIX,;+_anY#R$HnkE(LW0igVrFn;D"qaVnuolS3`C0!^=&GAh%(NGAd'*Xl#SiKK8*c^8[,Htk+3R/sj^7&Q\Ckg3?7CL.#=dUjF[*HV0j7,N"#nmgSZWK='cc1n5;S4"4it+O'Qirn7-PD8H,*h(!ksQk\
%9b\8;6oi(2.L@8T1@amF,+2-%P$Bc5bTsO:@^;4L-i%:!.C`8LMT'A7a]'b/V:$gRJJM1\<&qpq.OfpY30oJD#qj>rcrMSJ_e$A&
%=5q@BcW)qJc(nL0jq?oh3gJjUBid?ZcDHNa;S%flXpj@5],8$O]d*YFaGql"RW>`JM\XFn4"Zfnh;D%BmUG6/==Nl2doO0im7P%8
%:d$YD#30I\GXq5H@QOoDlobs.;p@op*jIsC4U$pQ'9K7\(708"a>
%3jTsGaJ$j*Z_/mQd&8Lo>o$BQGYs#6*e)879F600:RB$^1X[/&r=%m[-CFllK?+J.28c3nS;uSphTI&77JOuV%\S:kW'gt,,Ct8;
%es1tt)1F'.3G%t7JKAA79[G7!Zmu;@Q2k1m6bkE*!ORmm/M)N,(88&?EuGsn5Z8?;[nX-#]L`.2R"q:hk]@DY)^5I\iBZ.]T_3;h
%dnL,;;ZV5A#.m]b&SJmSUqp61^hP.1HE[]&/q>h9)aX-3\P'*g&+YQ@oPSjf^47JP!AkgRmYZsK$u)htfKOGmE^
%lrt&6P=`C%kWpT4!5e=9[KZ0<;L?4%HT\^e@-'GT"jq-)D:a`q4.0bCbJmOo_6ecqKeRIqZfDVMe%5&ihpZ"L-a#SPCJP6#d-f#U,k?#[ZLT?Ip/nF#aqlUd(bDoiq(ncT?
%\:ZINV0aQk?SIV::o,-NaU,),GUS6/Mu[BZompG$NiHY/=WfN"(H82-=,C6.h5o
%h0MTXhi\VR,paOjJ(X"G#>PEZQE1$o7IMhkMs9\[Q`C)CAArThE]c>2e@@"-pW6i]hEc#eRe&e`S;Q?V]3[a0rWdT-rrk!FJ,]=p
%n8/"E(:.g($6`cr*P322`o^e0*XoftSS4AFnipoE'A4YLFrY-RY($uZMf0u\OrF=47jZcdg5P=3*9lI4H8N"]en-W9
%3#Tq)s67@M0e#hp(;o?2(Z=d>#+l9$puu
%q:D:KR#:3UV6OTq"Tj],8c,Abom<]9UNa9CS^uZok\1=rJ?Z#2QtM>)/&)kG+&ZL]qm2lAIS3refjTKc]\Wq_3Ef6(d@7Z#3-G-BAJcN@TM=&$+>N9q2gc_7)DotKf``e:+NCt,D03d%.9+C_8T-*&W5BX93Y:u
%>)c*!Xm$`8hRPmfUs>AAg^q+EQm`]qLNHSQX=*_:8A<-8=nH&2gO3:6SV^85b`)a?djGN4dUWBAAq1N%;oPj&XD'2-_!^@jT>6)n]DIYY(Pi#Wf#PZ^^7?0S^d:K(#W2Qrkd--S.iZ3QCXArr/1dDVQK!oc?MT_fs^dE7F,tKfspd;\YPro!=&Z0hq$kq^SU+c+OGDM36AWt6o$QRZG=cIb(OZ,#io)_HB&C8DV^^SBUEQ$
%XPm3'-31BC%L5B
%31=W0m@^^n0'q>mHL7B5c=E=;:G_N^3jDQfm'Za8*Lg9>(d*tt6L/MskJ_,/(\K89_a:,a?VZh)Gpc"h(Foe!j)u[iCZ?sZ@QHj]
%MtduaZotn&IsCN2$+Jd[5?8OgBfKCG)^fHZ[(/)+ZX1@@.W=5K.7\p4aE4j5dD%T?E^&m%YK/:q-G_=GIQe^3Qe4,g7J@R8LnS@P
%@7&kn$XWYn^F*QUa\$S5DId?R*l`-@/U"&ALZe"F/Lu-E+&;[pgc'TFHJ).NY1<]WMOf5T*N/U6r@k?7N1MlnYJkQ!e&euk/P^d#
%$=8ES`b*'P=oET/QF&sibf?2pK\MTtL/sX)H\J"?!?NkNMgnOA;8[]$0R^*72r0ibH"/WrQp,aV>q:nQ"B3H'_L5lh'Fcr,@3)Q@
%W)ABHk8c*<)2>fLQdJL>B!(K87\e#YdaPY1jY;ij@HCO;C>i4r.4f*]3[9R;Pd?6`YSGIB6!a:Af9TrGsm2.0W"^$lI(Ock3c\
%Va6sk#'@V@IH.Xt^`%Y3#GV/&9[GjDJ;2jZaUG;:5u5[p)-J[5;RZC>^S.nO'jAK(m?V3ZpKW$H[ent>K8Fs3q%jr]BAut'hi)Kjr^0hD)h!rHWAFO*3Uh&uIpdOgEHJG\U?-YOYlKdc9lAFcK/E,aWk.0@m9\;,=ZV;iV@r^#kUS_4EB7$MH#m!YYs
%SP=>K(+N\t[L"AF&pcM8<6u0=mc@u4MHZb"QjfX7ic&MslH//m<;'bI7INjXDgXA9\j1/,,kBH^!VJHK#-^(B+
%G4['eWIBB/Wo\4mLbmWB5qPh'aIpPdiVb">m4)N3"BTsJoc[TZ(WMNHcdMQ^r1/:G
%2<=NljEk_'YAemSHQ[:#bOb;Zf@q"R*WGSArA.4uP5.*d[NbS^dYGk
%qt'dTUL(,[6JmNkb%Kb(?tPg/-S5f=5'"QMo6tE?4nV7^d*&`IBH@)GrW`d#kMPJgLnjk!6?1HFrJ"'"Nah81Q]ki=*LhO*MIQ%5
%%?5D0%'djFcgQF$C#:'3OC7pq@6)m>rj!=fr^_91)Q0(>A-D:S[no7MhLDJWZ`,tSjm8Dic_nt8\'XYns#Cnam_<58q2#mlPimYq
%LaCC&"*ZmoFNTq>!A5RQk'b"\Ycmp?I&qC:.!S'S,/V3j)fHQ#DW:4Bh7^-?rZ92ia3qHWLJ"*o08D&""B`;W56K;]A4$*>,ol)D
%^J6%6%k#CfrL_7lbXo@_!:QqPP-@3Hd^e.a=/?##s5XAA)C4j\Pc)I7@o@sT4ABilgeY+ubQ!7jcWL.LdcpN:8mM,Y3ns9jhA*6:
%V'c5q)ZCKN??9I+D^jARI4)s\iqcH9G;aPM8j4#o"TITC]fc5O@Rm'*hCkT#).\;Kq2]XoVE\)MAQjSup#8sr=;U`t^J8H0#u+qP
%\A+D"Y=#5^SNem&4I>:HNc#Y[`S:"'Ecl%Vb,XYj)=],$.&[npc;f/KnlD@YhQQ^pnL;ci080NEJ`Df$JHtEFL-qeOp.`j`/S3Ik
%V2QO[F8A%,@Of2re9!`iPX>)@pE=X05C7tZ-@jXo=qoL!"pnl`]VBTJ*uMd*48T*1#6Tja48?]M0l"
%EFZ4_E8e8Kp2YqA>AF+q[?"+eb*-qYhUuPe(XE8^mf0E)8&*!lfm]'24)^a%iS.i`Y&t*:C[>+/564m9/N_C5FoPO25556;!neoG
%7XCLI+E.UjR/lVLDrB@\:RXh6B*=.J4k*"3#@mSkocR5)Q_-5Zom*MqUe@Y-(^fm9@3NP,&5f>,V&$Tg!Q1\L=O>NC'$4G1,AeDn
%ZjEBa>/9mq;q9@[MlU?$FE\'6cUB]?0m`k(JPu%5>"&KZcR7TrL%88D-js.aN&##4\r>"@6,jQ3<%5)FUJg^H4Je6r*2K.r-]o2r
%3=,4k+&']6KI(jGj;We$h:;F[_ufJJ6ng11ilTYGO%L"L?\0Bg*)9J3DdR`<@!8dO!+['$RnR<6hl9$Y=iV7H,1bU,XYL@9P1s.$rOpGnj[)E=X":k;[dFs_B%R;kVkUH
%1^l-;hi$(Y$Pm[LlP#uM)r-%Cru"m6(tmmOk/sl^n8Zk$$(bN=AhdoEc"6*T+#s>IKc_$Np@#`<_mfA,V)S64,ZC,RSOb?$k2D9Q
%m0Gl5E!Bc+D*W_8b'uh]Vo87DScrGb3DL6)1&HZOT0HQZ?J[g7p%i#e4eU7#TQi9OY6qBjYmVW>\F@[VZ%R)_OLo&Cn&LP$@B.']
%gC$,2&:-RAoYS)B&f6Qu<,j-el@/8U@&9aqeA-glR5\an:/($t@\r-:[,i_K"Z`.RQc8Dm.!*Te]c&U;J18`@Bhu\9D6mJq7kRbgcg62rX`=Au?S6GRo&5d7=q)j6kZtn8KC/b^G7M6^[eW5?Q32ep/Qm;2ar,
%@do#kfW)l7.XBH?emAk?BA+X?1A0_',S<;IB+HAhgu.43+OR1>N0VE1)]!t4-J7^)GmVL6]?G'PrQY3J
%ScA6pr^q*XH,f]HjUS@EGMiWsAC&Vmo2Y%pSq^Dj#$^G,*4nl8FlNilV=_[EXJMK"8^$aGU,&[[?$5&@2`X2/k;,s!Kp\39d\"2W
%oCn=i^4:l#Z!TIS]fY<$IYZ7GeGWmaGTCUL'lRtW!pGQOqO0$rfY4;-1e*=XOXkn=Gj0uXo4.H.]2]*S70],tcr'*[qjbZnJe!+N`r.-P<7j%b9Bg+bg0U_G1Y@cH.VL];1=9Zt>eK+nT7
%nu=[kT1t;U#k8')h:8kkb?fS9f]#o6;D0#TAnoXrlIiGW+@`Y0Ap3S(b[bHWJA17Rc>a`SaPNrqSX5f,q:d/0e_>NluFOZToPlO0SRA2V;2+Yd6@H%4WG,^(akK]EAoVN]Zj=YpO.d%d8
%DRho=;O3VTA9Ii$`Z)_l?^UdKjS+XDhh/BK9'S]?9odrXP-;RDkBsci;`\Cd@-<\ZE7Ji9
%r9(0f_&i4DX4"eiq$i3`Kh,JAtP(ja8+E&=r4.W"Q0&1'c!-^pkd2O,qHr6Uje:3"hTWq
%2o6S`'B6KUF4-Z,QrJC2$"/c]!sZ^7("98m!I2t/(8o,I^G-LsHp(sD_@PK:o9Hon-"&(54nL_^t,mUkMJP/Mq#t7gXRu4r=,:BLU/8teeF_&+?gX_A"6H<(hnqeegOD3%
%(GbI[0#1ptU6sVa`PSN4HDlM"Hm'Wj>K!OIrW:TRIK5ahW"EX.=2t283$&G.[1BDFehYi=Ur%WCb=_I1:FMq7r$eZ`8$J:m814E&
%5T<-?Qa,LumT=LCBd;Sb*94h(EoTL_nZ,R3<9FXroGnPAkE5WsHhTTd)WVBX@E^Y22H=l-j[Tr;GF.6P7mUiV5J(`n0OsHh(XNr\p?[l9Sp5
%4-,)@i,Og]T-lnjpId=0X?mUh%L+m\.e&Y,OlGq]_/m=lmYpr!0\0I5=gGT$/X:.J?8S,PRSW2&O*qTD>f";))tUoE1%QPrq'e]f
%We=cmGo/Rk&]O55cCrfjSJi3D=6ts]+dG8QeuJ[6N>8bCt9!(=RH(8M"gjISpK3?
%",KkuIk;iYD`jc$LI)(Y=nZ&RRFQ@p,F,n!>N5N&mRJb\FWUiIV4XB-Xa9jS@4r(S0pNh2SW?nZ(cKX8n(pA_RaB!kH=0D+#^]d(
%b1ths"8@B)Tn@qE[G[Zr/G/)UPa@doQNha&?Q`c:k3e]:)!L;c/Y?hOYQ]p'sPeUnBG6d61\a1'FS;`#*]nlZTR]#e+bkH/&&
%q!M)9$q.RD<5/M'M$ZE;kFPI=PK;G'UH1O1]TV]c2[^F5br&l77UYkX,*p7lkaf<&_8_]/A-m6\]`LZ#A'6''_<^.@X*'A?DqN"q+U2N+Y$0XP4o^]jb_rgK_DNe;EX3Ki%dtO/;]#F:cT0$!IP@%Cq+"@d6o4+!#/XO
%e(a>Le?P@$BCI#/hF*hXaf&Jpngm:2=NKB%@&(V]hT0C".+_?=C-*JEp/6]1t
%[-kmXA#.6?.jM^XD@B%H-d7XaUY("<#UtG?eaW.XA?=S#Dt$c:1)[&=-I-8K",&M@6JcK$Ga^70/c]U3k47fXg.7Ra'%1sAY=$I?
%)P_Y2[.5sb1a@Du0TG6fap=ui45[+;c-rHdCC[,i,J=A?6W9e7d'
%]__JMjH"qJ87*1\CQ&tP0<8U]D2&NBc&`:Vqt8jO1"**h5^Y30b;uFI[=Zb+INk9gJMT10_^3bS83;0VW`Eh/`T>!Y&g7^d.*^$$[ZNTNl^Co+[f2EBdHj&^"
%,'U15Dr<6i<'(,Y'VUMgR_h-EP&;9=!)d7)7k,!E!ts&;F]:HNg0MgIG`7b3:@B)1N"f\DA)2X+Vn12KKToU_n7D<4mr<>q#"[c)
%elaPI-[-_Pin4$D.0DK=IFi^(2nZolG`J2uQdEV1XtS+Ek08=L]>+Fjm.$AOG]_QY_UQ..H3jg-]"]FIHaW;[S]ZoZ:;leTCFuBp
%.s&J6=Cg(^;qh$2ZU7OIlCi68Ed)M&5VNK7K@skcag>m-4&b<"(
%`En2CZ?396rVh":m@hAPc=?c_0:Wg%-oQ=_'Gc$s"66:DRFcB7ce4oK?15[Rs5*4T4>j]#MC7lE/oRJ'mJ!CQdFJ-adb3/nkni/]
%0g]@>rHI[Tp$mc\QQJ5;d!P-T^irj.#5:mp_88RDUHG*>"cd59`&GS'.\Eg`r*\j0e39=43AaAJKkBVk_@s!mZ(DHkdDmOCG&W]`HNt"mr!V#UP.M2$d[!#C'Mu-8<&Ll?mR&[(B
%r-e^8s79S1luWbU7d>8+NA_Z!0h8f&]L>MV1.$i01-s(M6^0E!*5*k92+ZJ?(.bKtPW@0,:hR5*-#]5,arK@g<[C&5>LXco"2E0h$u4nLB_Y*@phS9T^NKjN`^s@0J+M
%0!o+O44J88%>1j8dGo-X,;,=28+!JQ#eZ93.VjUT/6g;Yo2D4F_UDqCW&1&P''Y0iA`Wl^@DYj`ar4X#\cE^V
%KVa`.7[:^(q&pGR-GqcWI;0gTH1X7dV1*W+9$ku@1dCU+DtR6X5[TCs%sTc(fU!0QF_NHWgB7D"k1O/,7mN%H"GC7Xo(e/Eo`:@U
%n[G>_QE"rrn;fJiL+DF>TZbQ)b3R"g8/O17L=EO[Gm&LChbDU""B3R*[1OH4Rtr]<;;e>]t_7bj'VRJOr"fC+W4K)+nYIVBMC&@r2[7Q0UB,&AHD/S>hE=g#NDlt
%Mu!#D4Z\iZ7BU0YW?l?&Fq/o-[4#r_pR!/H>>r6t\#-d\MHDpgdgf1GVPiu_SuE=CUXtqUQe.NBD\]_O3j6[K'#k'Uedj()bYTf?
%038P)ra=J%7N]tAV!ABT.O]nO)jtPaXULR,/TG`/DlbfQm4:^trN^?;l9h:5AfY:aSbG3W<,*<"N%/e&7qHL+gYnQDR]mZkM1qqA
%n551!Ok!8QkKKS:4k0>nC,Y1S07T??E^"b)_L1MD:M-s*[4F.CPpD,9J)69E>%"k2EH1$XJp$S^8IYf;VmHbN3jRbV&=flBc*W*!8!\q=OulG]c*@R+B]'8MR>9>FT)"AkNcDGj2IRd0?a2UahZ&]jmnB37!Z^
%ZcLm'%[BCsCra8)VXCk8]Ad3;q[,3/,eet5Ib!G]b>NbJ5ae_9Y&\Q&l;_LB7H3W3a*H;B[#oaZ($\bf^J<5`-=b0D'r,060+QWF
%(#nI=69HR3Y1QkX-QUV3Q5e5i:@2acBT*@k<5qsYG3N88i+X'>`$aTpD11%jF*1*h^/*(gpt"iUsLZKI,F:*k2a1^S^%4&'W9
%bATKLSZb`1)l,EAc^DUso\f;/jBI^oS#JFS"=#
%KX"8f\lP^i'42MP-b\A!,l=mc+4Eu-!ImYPIfi15fWs'iCTZ&X1)SuPf-aDc4e`neb,VDhHkc\uF.tb*k;EZaC!H-nkFe]uh\*")#l(:DN=;!7S(^Xu2&Ned(`(gm[Fo8p"oO.h$YC=Z>;US9R>J2-]]-?fNq`
%+s(YCP#CCj]"CN&\STZF"r?TDI>_^'+T^EOJOQ&hoW-Nf4a7':k)2EFY&q1*KRh%NpQWf3,..'PebqQSMme3)hlUhEN,f^OcLr%@
%DDu@7(s]bXdTM,=/FHtLHsEP:XXajuNYp4N>-iWpr5#1Ce`jFNjk7TRgMY@hGJfK)J;lb9?d
%D9pejrLd6S:Z#O-jk\WV6!Fgcc7Fo+*5*T+gb.B5FF3QF^aUM;b0X*F@ITCMu=NXo_B>]LAr-OEb^AQs#
%E4^o:79DG]Qu'h0B0u[],^_G>$T4%M!8BQt;?dU?%^r"K*nF,$)9u\%g\CL].+2A1eL^E%jPLnBEHuE[31:;Yk<`ol3dV\5D.Z/k
%>_ohALR#DH_QpKAAY\W`B_7?TF.k?jW]*^&gFurk
%J,6-5`L!u5D\0.,@j/:WR$2p'fuei2P=UiogM\ZpRCF*qBZsrW/P$#uTdn/PbX&/.d_ZdB--sY1%S1RVaJNnYI-Pp^phpYjT()JM
%$WY2(4HW=uh5GqNjkWW?STP+l9#]/320@CaFr'Uq2@i6gNS>gd^Oph]Q.NM,cJ%ESc&PW`
%R9lObF.L#*k%f?=TD;6g[HOu$A[Ats/Ej;T/E@q1U0Zfc!#FF;I+X(ZYFKYt^8RU:3$u4S0uq"$k*:ucBeYGtXd72)m-'m,F3\Sr
%402=qc/,&b$E2P.$:8jlCbs.:AN+CGAFHI*1!t;7ZZP$b>rT42DVCYClQlc"r3C1ZQkm:O0AG]c,hle;NOFFPXX+Ou@U3%URbEK>
%#aAT=5j&#&JSDT$6-NLABif*R>tf-4q<61;FnQlY[lC=/JeMKk4C/dI*
%fo"<.@p[f++(_SjVOiX-=*orV2[8"cmeQLn1s;LnLo5s[g.AA3kgID]*@u\
%W8k4dM(oeN9b"9/X>S[jA19#Nk*7C]!7T4C>>jh,->H\A@cg<,CCa=KBU_mnS+o^9.iY#pq74cmgG"0QWnA.A8ucct\$W*#dp!29
%!/eTIXaIcmabPk!02<#t">MMV_;7e!f-8j'Gt198eD<:B"p?En15oDddAt,u':PjmjYl2HlH4p.b[Xu=B!;+*j=jqMe;:jf0i[UA
%YTnpgk>JX8jb`oD'5)c)r,pkUCAl40];et20k=GQ6S!R3l_H+567(nG=Vf'r=<7!j-mK4ENn+ejZ)=:Q/Cu)T!cjVZbb3fc&ASCCBA.5IAZ[\H^&6AC;V':&gqRgr+1+%9q6lM$c0o)>oelf!eH61;B+DQ=eXNpGY?G,Xi-*Y-rcXYnJ.*mX87
%TVhSg2m%kamtRR[J%Mh<1O/@:!k.-83!X@.fKhZjMD+6HI64Te1Pj"DQ??"NA^^fD?+lV5/O5?j7-\)5D!kLgfb:p%94B^5^Y?K8
%*Z6,V4!AJ"=R?N?]Y]Tbk^qu?H6`;s(s]QIp&rNQghaV.hVP!_=XM)Zqjf%h[o>_IV*%_oAmL4f;*t*N+6,tsSQ&!_/R7$loG#rk
%\`T:30iKs2]X0UG-e3M&5jo_l@=,GH[fKtuS:!7XJ2$0Y'`JiX-d+"^hhU[KP(t.NMco#$/
%g+&ardO`Bdk%ma)#tlBEu(6.@_8_G$><_bU"8VQoHV;j[qZR[qT?\8MpRO^npa]f9CpTb`HCos4^$b543MUZV%,\%ieOadsB&QcsHF@fNjOE:&Cu-D>h:H:bLn)`(^)\4[O@On&mZDmcs-=3kJ)SqUK\Wk$ciAVDF)3PUtUmWp,IWl&=L1ZV<>[6F@H7LD=pZ)l&5VPG$[mUZs'c@#CbuR3hok>IIt+!24[V?R!*%O(Y*Us[<29@Ac$4',@Y=]bM#NFSV'P;*E:K*e^@Tja1$Hs
%Gj=H\*!#9L(]1LX0cUsbH$"-e31IfgiKIbe6+i+]T3#[T,tm]9U\!b%]aJIpZ9?lA,G[)[oQB/+%NGjh,/>jr!X7&QBB)ahG0,jq
%E-/\H>4Q4R-*k/CbX"D*;`Ye5Up.-Y(3CHSeQtrrQSp$C=F:$1f1lVVgT2t^F/iBer1LYZC=\?)\^S:Ub*bo:r\8WZ(?XDgqQSFY
%mOTiuS/'I4H7-5qrab8d].F80^''=1>MS5rQocZ5`Uib`q_?>D=r_YIUfOI2Fj(l.I9U>+Y\@,dEI>2]D9kn%"n;G?/?rR_*`B
%r+`u8$&4c;DdCOBX#o$n!V.].*AoIFZT52(?9[]'If:?%db4'eFZHHU1uH71ZmlLsL>0fsZFXc8:G9gb:>!EAEj_L;q.i%=)8@-5
%CqU(=X$ns,:dMi8WjTIp:p"$kL2&a(%:ulN\bYPjq.qN&"'[F4?mqnU"*]%BK58oP.a@3"Slj=ecJJtbJ<^pdH$JI856;UEZnkrEGF=WbB+WRTd_U44(/>#'ecP[ge8S-38C?62LRuU*j:?%]In`U\*\r^@F'jfsJ"]l$KI"/Si.1XmIWtXocqF]d(
%mP[t\PnWRD5IYs0'CIEaEI>d^/h.t=d#LlDZV_gb-fs`k0$3I=]u-!s_,jVXe^3Ks`R`7b-nl^?:Bh=Z;g]oSs3-Z\-+u"GL`8ZAuojiL%@r:;+&)ohJ',18]i7lIub)
%HDXs_r=:km*69mi=n
%r>W2'$^PE5DL^GOGE/R`7odn/(9MHLL+-EYZW3!cU:j5oG`N^#ULe%iZ7)6mh\5i@;l#@k>Il^ZlLL*Zf[No1
%HDDW`a4s+h.\tcJ0l`cmbuM:^rBYYLa7%$18aYE,hm>47>^io37+=9k7iVGFr1blR-h:1ee6
%f@sJ?;#mJCoAo%6Bm)QpV1#S.jCtV-c;"',nEXoD[-NlU1_')r1!uQ\d_bfjX&;4S4Rnm:@^/_05l.gu2ca^sU=5CHlZQBQ?D_]g
%QSW^UN72hq`CfIHE6C?Pm<';Z@.2gXg3TR2?M3aQE8\cYP!X/hJIH1#8^h
%DLAIfRdKH!XN0\W_K=h]?,akpd_QEW_1LpC3O5+3jS1bFYqF7-G%HoD_\BF<+%dPN-tCA=8/MR44.(
%akl[Y3Dd5tG)_cXo;9XLdOqZQ^\CP.VXHNai/OeL['EJAMc)gB]f.M(e@k%f]G,<8rb:XKHmeZNSI*2^<&a8a"YAf/?eXdK$XgDu
%s/n^Dg[fi`%l1jlMC!F;Z(rhQQ#bh`mnhDu9r\2aec=uZFDjtujrj;lDq-ND@9[pAW!3fQJ+G-T4o``@!*)*[2lHebY2NJc(Yc/$
%:a[`i&a&@B=>LG(F.s_LfVVZ!)O=LT!3XgRR?D'L'D55R(R%U"h)Qqo2EB<+([m)FkPFSAP&"_!L>)'#
%5OHhiKhWNQ[P^2!cT3Re:h-o\\UHT=e=Gm6l+X)-.
%AX:W,kEddHos5^nlM6^7Sa0p:Wo$8nJ/FgBB0@Bt*NJFtlY"9claN=$E3>i+N\clC6#3I[[/A"PpdjN>D0<"RogFR:H$4/0TCo14
%CVGABoNXWH:tK4oo\/L))=X.Pk=bDU]NR%2Q?;R>nqWUaff_A^deST9j;uPoD
%V2`YsUiZL9NLaC".oJ;jf2#>[[;r;)b'U9L4P.oJJFl7JHWEpfp&L-"?K%[d0LMBC3g)ReQ3qos6j4D`:[1G5F(#hVF^fB>*0'haOd6\UN,-qJC3nh\qt@XNok\qIM_YWI?oh
%O3]_MG4>3[eT:]?3JpUF@CA8LDl))QF/kj;0sp&QI^429T'EdVH*3d)S+H1Unbu;/p"MpkX8TSXcK\`F4kEJaip^dV
%c-GudDpO]b\UL"a_ontSC!K4LY:?Y[o43!DT>b$[eiMF/`/[E,^re4:iOOEg)kC#M8fOAfB3$(?[%j#[R\u\5R9"3RY2=PFjeh5;
%BaiV9WIEUg*`SctB.X]JLIkgaF8`0\6[9ttbB*W`$Y#A=H+S.rXAALFnAdFJf?_SG,!O4'cLl8D_eaP"T9b];;uJ8JCY(Ptc['W9
%WT&#IY+PCJ+F-RmWA;%?4Z&<;>pf0[lAcD2H_h>[fhm^Pql8-u?H"a$BBtQOg9O/<*D;-*[&Z-@)R]>>W`*6V0Zs]Qi%b=:!gQV1
%]Ce7A:dpblru>-e+u.tD1ssAccpj#*.)tF=:[h#iN^^Uk_o0G]WgMd4oC'$lhbuf^8o7+QM9juJH,S]*")VN;a4?uc-Xl$/G)nDLu+HT-]3`_ce`at
%NHpqEn"[ZsUN[g&L+`E"^OtDJdXCS;(WFj.dh@,2??kJ+X)[@%QRjflF.-`pgBW;/mS>L(lIG"*-k9#tipo2"S,:'h>r6M]<,%d#
%X+X5'Qd:I6*aJEY<:86(ir&+i+)0ie^sF2qI)5KPq>#Vl&rI.WUj14Q>iF,T.>9hS@W]-#3+PXB(r(moYcX7IGhnD_3D*;e@+/
%*DY'I(C8;CSub&=rpC0!7?A$kPMK??'!E&.g;S?roBu=X=Q;Rt6eTu2WK99Ql'Gc'pM5#LnPVGJ+_m!<48EfD8o&f(k5s3W9$GLkq_%@DY-pNY876HVk3;g@fq:%Yg?Q.N-$O!lYLFpbN`'J)[pqh>G*C
%!f#_;Lk@D\Q8gifrXdogcZSCAXmf=MC3W/1G?s%P0JiNdDZnTLb20:K"77(/h7@+nnu\ke`n/>1I"P;PL`Dq5di4VS4ArWAf^$W1
%6Fa;D9:Ar>U-8=JQa=53@9S:Fj[6Bl3+=G*Dk@*^bRCDCi"TM*4e3E
%\bob(ZC$+.qai>>M?f_V*_DOLcgg#`ZnX5b+!*T[6&Pu6r=L?m6Wdc&S?JJ+TC@EQH(9@F@u19V]rMkH#*R2kn)DdGjmsElqfjF6
%H!csAdEJJfRQ['a<:EoslC>Qc0X;HIenef(]T,1u.fdX?2r3Fea1,K!Bo5c3\4T?_$$(0oV=g:!f4*HXl2FJM?s+*4dUPK/(
%q"&'Wm`%SYqo9U!jbpL@3Q:jb0q7r+9_^Ca,eDmdCF(]G']":6QFHt,O,L-&:[nQDqn5P=FO3]''BAn6Q[:VaNdt\cOebDE5W@?"
%mlQ9r32"h#liQ9rlQNg^YL'7)k[V>cm>i@KlFU!:o&\2,9WD;]-2&IR^9?*J"5h&QP8j"c'\6!IHnU,9gqn]u_5$43jm%n16r/%VNdr)@cM>TaMW?!#gi:s[U!c[iGNiF[DnT37Q7LJ4;Y7q!5RWf0LW<#jXX=5bBU'[fs7iVU-)nq9K1m/)j(p8S>\#=[+-=6k0Kj0&J]3+hs,%up"qP9iJ*Ar)
%nnJY.`_L53819cp?]Ck5rV2OE8GA@X>bF*)O7l%CnK1_mi)r`q0aYY4T]<'f+p?%arAR?%BLG4@jI],!2`1p$?e7%>T%#$Yn(aQd
%M>9U>c]/:%j%G(3MU3TW`:/"61Jj`NJ?_;(=q_#kF&e+2BqZSI\^IW$Z7c-arX!7?3f&6"WQ.4qG[EDO$/anDn>JuN%_Hg6pa
%(Kkq8WnoMJCJB.>o(u+X/?>'kBhEJ4R.e=c^CFhVrB9%u3UMqhG?$D1$"C3q7U>Q;ki)e96dphPSol-2N*3,P\%AWZ;ZP^L,%DRD
%(cc$&jc%uc/@NrN!:[JQG"-@ns3uN^mI+g%%/u'DSPRf6UqSU[ID6G8OdX%[OMRNV*&>:.6E8>ImgBGnI4&kE$DV]$cJ_0eW/Lq<
%E_U#C-HDZ757VPWH4]X;CI&qKUGYg=Eo:,'qQh/1N`n"a5Gj8#%\Y4Xpdi;Mh)pVBk\_9&_P^uj
%MOOTt7hG%L%>3GJ(-_TYcc8$%6a@e-SDJk4M`DV6L^%OqkR@%qYa!fc$#08dMQnF!R7-1Nn.tdMIriJ,Bq3l&W+/lH3Y\i.:bM\j
%3P`1^XUf%ZarR6BEI#+,P?bYCGBiaWr_D'X`S9D5!==ATbg>kZI=/q`#CS-qmhla1Nc*L4Wk
%'7gV=ap`cK4Ct2-'s$O+fm#nQTR%6hj25B;$t0gHADmK3hNcAs;XR4.PBOuaQK*O@,n@\E'6i)OjGF\u=S?X\T*jRcE'*iu"[DB+
%Ig;0k46MV=>NN2t9SsqaVYu&b^Oma'O]I1_"MZ4^$+#>Z,BS*2M>te#8%&;bP7IW7[.>aRa)aTj;*.(%7PNkL6M]$6-ZJmGon:)8
%E9lO?l3T%`/Pl0$OnV82M`AYdD8W2O72NH]me>s*nf^]U%gf+OOA!fiFGo,2ja!PkS`_f:j+jQeI7i?t`0VhU^V^_g[p[sr\j4oh
%R]_:*!TFk0(n?&[,=AjYnTb=u3-Tk7=C_gLpm:ksrj&UoEejTb>,]8BQs5NeU8dWhnP?j9Ch=tU:o4:6b8IG$.1BW_pZbS
%a$pNh/7Wd>CbYEp"fksP/H'R!+Tc8q+R
%V@ETdO+PnqZ(a9+.A=SQPUV'mjctN6NWFknk$%@s3YV!
%0fH\5KTu."<4r[VU@Ai)81J$57.rLr<=N[>K$,)a49R`fM#e!LP[2lo0H^mH_Z^7MgFBF=G+H$4#2&)P7[Y,?66Qrh]\r[>OrtW@
%8:Z"B;CsRFT:/BX.1oeQUXk'NQFBWAb!hW;omP#&moPHCC]3NR%i=8Aup)r3!bZYCI3WNj6\F81eNHV'62.-jnYD6;5
%a=`)!oqC^]dCj]a&.Z7eL)ZhjK0HfX(;74f,MT<q4FZ5
%3*$'ZV=;APmEglO%s>M(?BA&#c[-:9ab2(cQka&0Dc%n[2=A-%d%;c8ASV67aeC*A5g]?q:On
%1GSQ^=]sD^WseGo^?SV0"1EO=QZp5OC3RIF0p&kj?:Jq)J5h^U_):EnP3GW*7%La7)t`=$)Ktj*KID1!"fB=%`9VP"98(@U>RR7IaS]Q[-OpALh]tBA?pkM\2\:,gQPgkOPW0:tbYiO<'>&U4dD[3*gGN
%U"MUZNNZLkiQ\'\OW_b8G&VH7o`AL6G*iT7QceMYjh'h2^O,?SMLg?3Ee'2"(7[GnQ2*^qk#\
%3#4%g#RG`Eb=^oQ#u/n-^JCu>W\5IW#`t7*L_)RFdsLPteob!c;gd.\_>_9cqg=E<4JuBMQO<#uIsCf=gHNZM4b*D.dnd^UdpIM"
%h4O`8ot0+0oD>`*rSdRu5l0#F`l!ODV;jq;DLYA@nRP/NrpAE$GApMn_SkBPHES)Bt)Qga')Mb`$0.GEGr:ZOk5VZ==l3_tY4_lL@k^\<1`+,A*;.@"E2FUh;13`KF+%h\,8X'@@E
%fWfK3XLg>bV/[Erm.Ri2KDT%D%X'>+qO3A%NGfp=`!n]ml_VOd&So3[j7e;AT\,dB31X)e4-O:"Q]/q:0l/c;CruqISSWRLYS1#Q
%%Y>]1RhIlP[bdj6Qd?,;1"faKRVd3=YTDNd\0s-NGM`\VGS$SCmhp*$hhArDmsqVgg?"+cg0]$FcF(Vp:rXg!W0f;It(V#uKeO%4k
%D-4Jd9-u2>f$Y&VfuV`uCs3fM^kTl4gRiNGB$[ntG(rpM*aiWBYA#l`WG:cPG(-JKE2cm?2&]nF`h8r&O#E=fF6Ce_>NE[8B]L\>
%:%%W\%`8P=q]R<`T"VHXD-?:hPgLg7/lWd@;eKI?i7(lg>`E5?Ru7^#R;h`JX@p!.
%`lEg?dg*F*`cPW;aTUE"TA)4E1WL[F^m!8I^5A)0$JaHig92$&U
%"!`7>XiqPP$`:FQ%6F97M/ZC7MC(GNX2=%Y2m$(/]qA<[BMJ)-Vk(Nf)4V5\)stj:`CPmt'FB,b,5,[t+/#9W\h\&Z4O#ua`\=pn
%+.aZY8u;e;P0#1-8m?"'<5Y.B.7<.\Qopk(&?)ba4ESfFak6e;HMqUI!FP[%C14Eq-M'7W&E"e+nE`QcVBXP=NKbQqmF5!f@03r?
%U)hG2];Dla@n/5O1a_n<9KafdWIleYdjEG[Ke<+brY1j,&"=&=K+2[V`L-4HkGnIm;\.Tep6b8fV'\"WZ;.Y$E\"VBTj+%[>ca9-h%7@
%,6Pr5#c$XWil"1L2(#7h32Pl,.+/ERFYFFW_Zebgq"G]7fA-d+T(dd3
%^?L+?6S2gM"k$FT4d?qgFtM:GApbjo*E0,9WL$FA_anT4fkoJ/1*=tS)^nTa9ep'@UQH3aU=_P_>+'V[`nHjJT\X1