diff options
author | Fujii Masao <fujii@postgresql.org> | 2021-11-02 22:49:57 +0900 |
---|---|---|
committer | Fujii Masao <fujii@postgresql.org> | 2021-11-02 22:49:57 +0900 |
commit | cd29be5459f0e138c0f19d49ee588feeda78e3c9 (patch) | |
tree | 0612bf66984245df7cca39fdd074865aa9649a59 /doc/src | |
parent | 335397456b7e3f9f619038cb322fbfc9dd649d4f (diff) |
pgbench: Improve error-handling in pgbench.
Previously failures of initial connection and logfile open caused pgbench
to proceed the benchmarking, report the incomplete results and exit with
status 2. It didn't make sense to proceed the benchmarking even when
pgbench could not start as prescribed.
This commit improves pgbench so that early errors that occur when
starting benchmark such as those failures should make pgbench exit
immediately with status 1.
Author: Yugo Nagata
Reviewed-by: Fabien COELHO, Kyotaro Horiguchi, Fujii Masao
Discussion: https://postgr.es/m/TYCPR01MB5870057375ACA8A73099C649F5349@TYCPR01MB5870.jpnprd01.prod.outlook.com
Diffstat (limited to 'doc/src')
-rw-r--r-- | doc/src/sgml/ref/pgbench.sgml | 10 |
1 files changed, 6 insertions, 4 deletions
diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml index 0f432767c25..c71dab644ca 100644 --- a/doc/src/sgml/ref/pgbench.sgml +++ b/doc/src/sgml/ref/pgbench.sgml @@ -904,10 +904,12 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>d <para> A successful run will exit with status 0. Exit status 1 indicates static - problems such as invalid command-line options. Errors during the run such - as database errors or problems in the script will result in exit status 2. - In the latter case, <application>pgbench</application> will print partial - results. + problems such as invalid command-line options or internal errors which + are supposed to never occur. Early errors that occur when starting + benchmark such as initial connection failures also exit with status 1. + Errors during the run such as database errors or problems in the script + will result in exit status 2. In the latter case, + <application>pgbench</application> will print partial results. </para> </refsect1> |