Node:Error Codes, Next:, Previous:Asynchronous Messages, Up:Top


Error Codes

Normal errors are sent in reply to syntactically correct calls to the server. The client should accept any error code in response to any call, even if the error code in question is not listed in the description of the call, and even if the error code in question is not defined in the protocol specification yet.

This table lists the currently defined error codes together with a short explanation. The explanation given below is the default semantics for the error code. It can be updated by the descriptions found for a specific call.

See Client-Server Dialog, for more information about error responses, including the syntax of the error response.


no-error (0)
No error has occurred. error-status is undefined. This should never happen, but it might.
not-implemented (2)
The call has not been implemented yet. error-status is undefined.
obsolete-call (3)
The call is obsolete and no longer implemented. error-status is undefined.
invalid-password (4)
Attempt to set a password containing illegal characters, or to use an incorrect password.
string-too-long (5)
A string was too long (see descriptions of each call.) error-status indicates the maximum string length.
login-first (6)
Login is required before issuing the call. error-status is undefined.
login-disallowed (7)
The system is in single-user mode. You need to be privileged to log in despite this. error-status is undefined.
conference-zero (8)
Attempt to use conference number 0. error-status is undefined.
undefined-conference (9)
Attempt to access a non-existent or secret conference. error-status contains the conference number in question.
undefined-person (10)
Attempt to access a non-existent or secret person. error-status contains the person number in question.
access-denied (11)
No read/write access to something. This might be returned in response to an attempt to create a text, when the recipient conference and its super conferences are read-only, or when attempting to add a member to a conference without enough permission to do so. error-status indicates the object to which we didn't have enough permissions to.
permission-denied (12)
Not enough permissions to do something. The exact meaning of this response depends on the call. error-status indicated the object for which permission was lacking, or zero.
not-member (13)
The call requires the caller to be a member of some conference that the caller is not a member of. error-status indicates the conference in question.
no-such-text (14)
Attempt to access a text that either does not exist or is secret in some way. error-status indicates the text number in question.
text-zero (15)
Attempt to use text number 0. error-status is undefined.
no-such-local-text (16)
Attempt to access a text using a local text number that does not represent an existing text. error-status indicates the offending number.
local-text-zero (17)
Attempt to use local text number zero. error-status is undefined.
bad-name (18)
Attempt to use a name that's too long, too short or contains invalid characters. error-status is undefined.
index-out-of-range (19)
Attempt to use a number that's out of range. The range and meaning of the numbers depends on the call issued. error-status is undefined unless stated otherwise in the call documentation.
conference-exists (20)
Attempt to create a conference or person with a name that's already occupied. error-status is undefined.
person-exists (21)
Attempt to create a person with a name that's already occupied. error-status is undefined. This error code is probably not used, but you never know for sure.
secret-public (22)
Attempt to give a conference a type with secret bit set and the rd-prot bit unset. This is an error since such a conference type is inconsistent. error-status is undefined.
letterbox (23)
Attempt to change the letterbox flag of a conference. error-status indicates the conference number.
ldb-error (24)
Database is corrupted. error-status is an internal code.
illegal-misc (25)
Attempt to create an illegal misc item. error-status contains the index of the illegal item.
illegal-info-type (26)
Attempt to use a Misc-Info type (or Info-Type value) that the server knows nothing about. error-status is the type.
already-recipient (27)
Attempt to add a recipient that is already a recipient of the same type. error-status contains the recipient that already is.
already-comment (28)
Attempt to add a comment to a text twice over. error-status contains the text number of the text that already is a comment.
already-footnote (29)
Attempt to add a footnote to a text twice over. error-status contains the text number of the text that already is a footnote.
not-recipient (30)
Attempt to remove a recipient that isn't really a recipient. error-status contains the conference number in question.
not-comment (31)
Attempt to remove a comment link that does not exist. error-status contains the text number that isn't a comment.
not-footnote (32)
Attempt to remove a footnote link that does not exist. error-status contains the text number that isn't a footnote.
recipient-limit (33)
Attempt to add a recipient to a text that already has the maximum number of recipients. error-status is the text that has the maximum number of recipients.
comment-limit (34)
Attempt to add a comment to a text that already has the maximum number of comments. error-status is the text with the maximum number of comments.
footnote-limit (35)
Attempt to add a footnote to a text that already has the maximum number of footnote. error-status is the text with the maximum number of footnotes.
mark-limit (36)
Attempt to add a mark to a text that already has the maximum number of marks. error-status is the text with the maximum number of marks.
not-author (37)
Attempt to manipulate a text in a way that required the user to be the author of the text, when not in fact the author. error-status contains the text number in question.
no-connect (38)
Currently unused.
out-of-memory (39)
The server ran out of memory.
server-is-crazy (40)
Currently unused.
client-is-crazy (41)
The client used an illegal call sequence, such as calling set-client-version more than once.
undefined-session (42)
Attempt to access a session that does not exist. error-status contains the offending session number.
regexp-error (43)
Error using a regexp. The regexp may be invalid or the server unable to compile it for other reasons. error-status is undefined.
not-marked (44)
Attempt to manipulate a text in a way that requires the text to be marked, when in fact it is not marked. error-status indicates the text in question.
temporary-failure (45)
Temporary failure. Try again later. error-status is undefined.
long-array (46)
An array sent to the server was too long. error-status is undefined.
anonymous-rejected (47)
Attempt to send an anonymous text to a conference that does not accept anonymous texts. error-status is undefined.
illegal-aux-item (48)
Attempt to create an invalid aux-item. Probably the tag or data are invalid. error-status contains the index in the aux-item list where the invalid item appears.
aux-item-permission (49)
Attempt to manipulate an aux-item without enough permissions. This response is sent when attempting to delete an item set by someone else or an item that can't be deleted, and when attempting to create an item without permissions to do so. error-status contains the index at which the item appears in the aux-item list sent to the server.
unknown-async (50)
Sent in response to a request for an asynchronous message the server does not send. The call succeeds, but this is sent as a warning to the client. error-status contains the message type the server did not understand.
internal-error (51)
The server has encountered a possibly recoverable internal error. error-status is undefined.
feature-disabled (52)
Attempt to use a feature that has been explicitly disabled in the server. error-status is undefined.
message-not-sent (53)
Attempt to send an asynchronous message failed for some reason. Perhaps the recipient is not accepting messages at the moment or there are no viable recipients for a group message. error-status is undefined.
invalid-membership-type (54)
A requested membership type was not compatible with restrictions set on the server or on a specific conference. error-status is undefined unless specifically mentioned in the documentation for a specific call.