Commit d7d71561 authored by Per Cederqvist's avatar Per Cederqvist
Browse files

(accept-async): Added the error code long-array.

(add-member): Added a comment.
(local-to-global): Documented.
(The User Area): Register WWW-kom.
parent 45776d3f
......@@ -2,7 +2,7 @@
@c
@c FIXME: Explain how the garb works with nice and keep-commented
@c
@c $Id: Protocol-A.texi,v 1.56 1999/04/05 20:11:41 ceder Exp $
@c $Id: Protocol-A.texi,v 1.57 1999/04/15 20:51:44 ceder Exp $
@c %**start of header
@setfilename protocol-a.info
@settitle LysKOM Protocol A
......@@ -6423,6 +6423,14 @@ first offending number.
Please note that a bug in lyskomd 1.9.0 prevented the server from
sending this error message (frankly, we simply forgot about it.)
@item long-array
The @code{request-list} was too long. Servers should always accept a
@code{request-list} that contains a lot more asynchronous messages than
the server sends, so that it can deal with newer clients. This error
message should only be returned if the client tries to trigger a buffer
overrun.
@end table
......@@ -7194,6 +7202,8 @@ Conference @code{conf-no} does not exist or is secret.
Person @code{pers-no} does not exist
@item access-denied
@c FIXME: the "or to change" part is bogus, right? Aren't those
@c cirumstances covered by permission-denied?
Not enough permissions or privileges to add members to conference or to
change privileges, position or type of a preexisting membership.
@code{conf-no}.
......@@ -7309,7 +7319,62 @@ restrictions set on the server or on the conference @code{conf}
-> ( Text-Mapping );
@end example
FIXME: more text here
This call retrieves information that makes it possible to convert
@code{no-of-existing-texts} existing local text numbers starting at
@code{first-local-no} to global text numbers, provided that there are
that many local texts.
The @code{conf-no} parameter specifies which conference to look up local
numbers in. @code{first-local-no} is the first number that the client
is interested in. @code{no-of-existing-texts} is the maximum number of
texts the client wants information about. Legal values for
@code{no-of-existing-texts} are 1-255 (inclusive).
The server will return a sparse or dense Text-Mapping depending on the
how many deleted texts there are after @code{first-local-no}.
@example
1 103 93 1 5
=1 1 7 1 1 1 6 @{ 1003 1005 1009 1029 0 1034 @}
2 103 93 1 6
=2 1 63 1 0 6 @{
1 1003
2 1005
3 1009
4 1029
6 1034
62 1302 @}
3 103 93 50 10
=3 50 70 0 0 2 @{
62 1302
69 1006 @}
@end example
The above example shows three calls to @code{local-to-global}. (Extra
newlines have been inserted in the result of the two final calls to make
the result more readable.)
The first call requests information about the first five existing texts
in conference 93. The result contains information about texts in the
range [1-7), and there are more texts. The server uses the dense form
of the Text-Mapping. As can be seen from the result, they have local
text numbers 1, 2, 3, 4 and 6. The global text number corresponding to
local text number 5 is sent as 0, indicating that it doesn't exist.
In the second call, the client requests the same information, but one
additional text. The result looks dramatically different, since the
next existing text in this example has local text number 62. The result
contains information about texts in the range [1-63), and there are more
texts. The server of course uses the sparse form of the Text-Mapping.
The final call shows what happens when @code{first-local-no} doesn't
exist. The result contains information about texts in the range
[50-70); only local text number 62 and 69 actually exists in that
range. 69 is the highest local text number.
(Note that local text number 69 corresponds to global text number 1006,
which is lower than 1302. Situations like this often occurs when
@code{add-recipient} is used.)
@unnumberedsubsec Error codes
......@@ -7317,7 +7382,26 @@ FIXME: more text here
@item login-first
Login required before issuing this call.
@c FIXME: more codes here
@item long-array
@code{no-of-existing-texts} was larger than 255.
@item conf-zero
@code{conf-no} was set to 0.
@item local-text-zero
@code{first-local-no} was set to 0.
@item undef-conf
The conference does not exist, or the client is not allowed to know that
it exists.
@item access-denied
The conference exists, but the client is not allowed to retrieve
information about the texts in the conference.
@item no-such-local-text
@code{first-local-no} is greater than the highest local text number that
ever existed in the conference.
@end table
......@@ -8048,6 +8132,9 @@ described below.
@item elisp
The block created by the Emacs list client. The format is completely
undocumented, but you'll need a lisp reader to parse it.
@item WWW-kom
The block created by the web gateway WWW-kom. It has the same syntax as
the common block, but the keys and values are not documented.
@end table
If you're writing a client that uses the user-area, please let us know
......
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