pgbackrest/build/error.yaml

# Error Definitions
#
# Master file for all errors in the C and Perl code.  For C, errors are written to src/common/error.auto.c/h.  For Perl, errors are
# written to lib/pgBackRest/Common/ExceptionAuto.pm.

# Errors in the code that it should not be possible for the user to encounter -- i.e., a likely bug
assert: 25

checksum: 26
config: 27
file-invalid: 28
format: 29
command-required: 30
option-invalid: 31
option-invalid-value: 32
option-invalid-range: 33
option-invalid-pair: 34
option-duplicate-key: 35
option-negate: 36
option-required: 37
postmaster-running: 38
protocol: 39
path-not-empty: 40
file-open: 41
file-read: 42
param-required: 43
archive-mismatch: 44
archive-duplicate: 45
version-not-supported: 46
path-create: 47
command-invalid: 48
host-connect: 49
lock-acquire: 50
backup-mismatch: 51
file-sync: 52
path-open: 53
path-sync: 54
file-missing: 55
db-connect: 56
db-query: 57
db-mismatch: 58
db-timeout: 59
file-remove: 60
path-remove: 61
stop: 62
term: 63
file-write: 64
protocol-timeout: 66
feature-not-supported: 67
archive-command-invalid: 68
link-expected: 69
link-destination: 70
host-invalid: 72
path-missing: 73
file-move: 74
backup-set-invalid: 75
tablespace-map: 76
path-type: 77
link-map: 78
file-close: 79
db-missing: 80
db-invalid: 81
archive-timeout: 82
file-mode: 83
option-multiple-value: 84
protocol-output-required: 85
link-open: 86
archive-disabled: 87
file-owner: 88
user-missing: 89
option-command: 90
group-missing: 91
path-exists: 92
file-exists: 93

# Memory allocation failed
memory: 94

crypto: 95
param-invalid: 96

# Unable to close a path
path-close: 97

# Unable to get info for a file
file-info: 98

# Invalid JSON format.  Eventually this should be a child of format error and share the same code
json-format: 99

# An error from the kernel that there's nothing we can do about.  It should always be fatal.
kernel: 100

# An error from a service that is not our fault, e.g. 5xx errors from an http server.  These may be retried.
service: 101

# An error while attempting to execute a binary
execute: 102

# This error should not be thrown directly -- it serves as a parent for the C errors
runtime: 122

# Error used when an invalid error code is passed to the Perl Exception object -- this should not happen
invalid: 123

# Used when a native Perl error is not caught before exitSafe() -- this should not happen
unhandled: 124

# Used when a specific error is not provided in the Perl code.  This should be rare.
unknown: 125
Create a master list of errors in build/error.yaml. The C and Perl errors lists are created automatically by Build.pm so they stay up to date. 2018-02-08 23:11:47 +02:00			`# Error Definitions`
			`#`
			`# Master file for all errors in the C and Perl code. For C, errors are written to src/common/error.auto.c/h. For Perl, errors are`
			`# written to lib/pgBackRest/Common/ExceptionAuto.pm.`

			`# Errors in the code that it should not be possible for the user to encounter -- i.e., a likely bug`
			`assert: 25`

			`checksum: 26`
			`config: 27`
			`file-invalid: 28`
			`format: 29`
			`command-required: 30`
			`option-invalid: 31`
			`option-invalid-value: 32`
			`option-invalid-range: 33`
			`option-invalid-pair: 34`
			`option-duplicate-key: 35`
			`option-negate: 36`
			`option-required: 37`
			`postmaster-running: 38`
			`protocol: 39`
			`path-not-empty: 40`
			`file-open: 41`
			`file-read: 42`
			`param-required: 43`
			`archive-mismatch: 44`
			`archive-duplicate: 45`
			`version-not-supported: 46`
			`path-create: 47`
			`command-invalid: 48`
			`host-connect: 49`
			`lock-acquire: 50`
			`backup-mismatch: 51`
			`file-sync: 52`
			`path-open: 53`
			`path-sync: 54`
			`file-missing: 55`
			`db-connect: 56`
			`db-query: 57`
			`db-mismatch: 58`
			`db-timeout: 59`
			`file-remove: 60`
			`path-remove: 61`
			`stop: 62`
			`term: 63`
			`file-write: 64`
			`protocol-timeout: 66`
			`feature-not-supported: 67`
			`archive-command-invalid: 68`
			`link-expected: 69`
			`link-destination: 70`
			`host-invalid: 72`
			`path-missing: 73`
			`file-move: 74`
			`backup-set-invalid: 75`
			`tablespace-map: 76`
			`path-type: 77`
			`link-map: 78`
			`file-close: 79`
			`db-missing: 80`
			`db-invalid: 81`
			`archive-timeout: 82`
			`file-mode: 83`
			`option-multiple-value: 84`
			`protocol-output-required: 85`
			`link-open: 86`
			`archive-disabled: 87`
			`file-owner: 88`
			`user-missing: 89`
			`option-command: 90`
			`group-missing: 91`
			`path-exists: 92`
			`file-exists: 93`

			`# Memory allocation failed`
			`memory: 94`

Rename CipherError to CryptoError. This aligns with the general renaming from cipher to crypto. 2018-11-07 02:38:38 +02:00			`crypto: 95`
Create a master list of errors in build/error.yaml. The C and Perl errors lists are created automatically by Build.pm so they stay up to date. 2018-02-08 23:11:47 +02:00			`param-invalid: 96`

Storage object improvements. * Add storageCopy(), storageMove(), and storagePathSync(). * Separate StorageFile object into separate read and write objects. * Abstract out Posix file read/write objects. 2018-04-23 23:26:27 +02:00			`# Unable to close a path`
			`path-close: 97`

Add storageInfo() and track size in read objects. 2018-04-29 17:02:21 +02:00			`# Unable to get info for a file`
			`file-info: 98`

Add basic C JSON parser. 2018-08-09 14:06:23 +02:00			`# Invalid JSON format. Eventually this should be a child of format error and share the same code`
			`json-format: 99`

Add KernelError to report miscellaneous kernel errors. 2018-11-12 01:07:56 +02:00			`# An error from the kernel that there's nothing we can do about. It should always be fatal.`
			`kernel: 100`

Add ServiceError for errors from a service that can be retried. An example is HTTP 5xx errors which should mostly be retried. 2018-11-17 00:22:22 +02:00			`# An error from a service that is not our fault, e.g. 5xx errors from an http server. These may be retried.`
			`service: 101`

Add Exec object. Executes a child process and allows the calling process to communicate with it using read/write io. This object is specially tailored to implement the protocol layer and may or may not be generally applicable to general purpose execution. 2019-01-18 11:45:40 +02:00			`# An error while attempting to execute a binary`
			`execute: 102`

Create a master list of errors in build/error.yaml. The C and Perl errors lists are created automatically by Build.pm so they stay up to date. 2018-02-08 23:11:47 +02:00			`# This error should not be thrown directly -- it serves as a parent for the C errors`
			`runtime: 122`

			`# Error used when an invalid error code is passed to the Perl Exception object -- this should not happen`
			`invalid: 123`

			`# Used when a native Perl error is not caught before exitSafe() -- this should not happen`
			`unhandled: 124`

			`# Used when a specific error is not provided in the Perl code. This should be rare.`
			`unknown: 125`