From a7fd74edb39abaa9ddd52b735778588a2fb65a52 Mon Sep 17 00:00:00 2001
From: Tom Lane
Date: Sat, 11 Sep 1999 22:02:51 +0000
Subject: 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...
---
doc/src/sgml/protocol.sgml | 17 ++++++++++-------
1 file 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.
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 s is specified it is the literal value.
+ Eg. String, String("user").
+
+
-Is 8193 bytes the largest allowed size?
+There is no predefined limit 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.
- If s is specified it is the literal value.
- Eg. String, String("user").
-
--
cgit v1.2.3