diff options
| -rw-r--r-- | doc/src/sgml/protocol.sgml | 17 |
1 files changed, 10 insertions, 7 deletions
diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml index bc03ecb55f6..0416c94bad5 100644 --- a/doc/src/sgml/protocol.sgml +++ b/doc/src/sgml/protocol.sgml @@ -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> |