Commit a7fd74ed authored by Tom Lane's avatar Tom Lane

Update protocol doc to emphasize that backend can return

arbitrarily long strings, and frontends should cope gracefully.  Goes
along with long query and long error message changes...
parent b399805e
......@@ -657,17 +657,20 @@ This section describes the base data types used in messages.
<ListItem>
<Para>
A conventional C '\0' terminated string with no length
limitation. A frontend should always read the full string
even though it may have to discard characters if its buffers
aren't big enough.
limitation.
If <Replaceable>s</Replaceable> is specified it is the literal value.
Eg. String, String("user").
</Para>
<Note>
<Para>
Is 8193 bytes the largest allowed size?
<Emphasis>There is no predefined limit</Emphasis> on the length of a string
that can be returned by the backend. Good coding strategy for a frontend
is to use an expandable buffer so that anything that fits in memory can be
accepted. If that's not feasible, read the full string and discard trailing
characters that don't fit into your fixed-size buffer.
</Para>
</Note>
If <Replaceable>s</Replaceable> is specified it is the literal value.
Eg. String, String("user").
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment