Wiki / Protocol Messages / Frontend messages
CopyFail
CopyFail is a frontend protocol message. Identifies the message as a COPY -failure indicator.
Reading PostgreSQL 18.6.
Description
CopyFail is a frontend protocol message. Identifies the message as a COPY -failure indicator.
- Direction
- Frontend → backend
- First wire field
- Byte1('f')
- Field entries
- 3
- Documented flow contexts
- COPY Operations
Usage
CopyFail (F)Framing and repetition
The complete definition below retains repetition, counts and conditional fields. A numbered table row is a documented field definition, not a fixed byte offset. Integer encodings and flow rules follow the same-version protocol chapter.
Wire fields in documented order
| Position | Format | Meaning |
|---|---|---|
| 1 | Byte1('f') | Identifies the message as a COPY -failure indicator. |
| 2 | Int32 | Length of message contents in bytes, including self. |
| 3 | String | An error message to report as the cause of failure. |
Manual definition
-
- Byte1('f')
-
Identifies the message as a
COPY-failure indicator. - Int32
-
Length of message contents in bytes, including self.
- String
-
An error message to report as the cause of failure.
Related entries
Documentation and source
Source build
- Version
- 18.6
- Build
- https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- Source fingerprint
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f
Compare versions
PostgreSQL 17 → 18: unchanged.
Compares recorded interfaces and attributes. Source fingerprints and build metadata are excluded; an absent sample is not proof of the introduction or removal release.
Related entries
Export JSON · Back to Protocol Messages · Recorded in PostgreSQL 10 through 20; the first sample is not necessarily its introduction.