Internet Draft File: <draft-pfenning-irc-extensions-00.txt>

Kent Cedola Thomas Pfenning Microsoft Corporation 31 January 1997

Extensions to the Internet Relay Chat Protocol (IRCX)

8. IRCX Command Responses

The new extended IRCX numeric replies follow the same convention as with IRC with a specific range for command responses and another range for error results. The IRCX command responses are in the ranage of 800 to 899 and 900 to 999 for the error results. The prefix field is optional if the host generating the error is the same as the host the client is connected to.

8.1. Command Replies

800 - IRCRPL_IRCX <state>

<version> <package-list> <option-list> :<admin url>

The response to the IRCX command. The <state> indicates if the has IRCX mode enabled (0 for disabled, 1 for enabled). The <version> is the version of the IRCX protocol starting at 0. The <package-list> contains a list of authentication packages supported by the server. The package name of "ANON" is reserved to indicate anonymous connections are permitted. The <option-list> contains a list of options supported by the server; theses are implementation dependent. If no options are available, the '*' character should be used. The <admin-url> field contains an administrator defined URL.

801 - IRCRPL_EVENTADD

<event> <mask>

The acknowledgment response to the EVENT ADD command. The <event> contains the name of the event added. The <mask> is the selection mask. If no mask was provided in the EVENT command, then the default mask of *!*@*$* is used.

802 - IRCRPL_EVENTDEL

<event> <mask>

The acknowledgment response to the EVENT DEL command. The <event> contains the name of the event deleted. The <mask> is the selection mask. If no mask was provided in the EVENT command, then the default mask of *!*@*$* is used.

803 - IRCRPL_EVENTLIST

<event> <mask>

Response to the EVENT LIST <event> message to display a list of current events the client is interested in.

804 - IRCRPL_EVENTEND

:End of events

Response to the EVENT LIST <event> message to indicate the end of the event list.

805 - IRCRPL_MODELIST

<object> <mode-list>

Response to the MODEX command of extended modes.

806 - IRCRPL_MODELIST2

<object> <mode-list>

Response to the MODEX command of extended flags that are only set by the server.

807 - IRCRPL_MODEEND

<object> :End of modes

Last message in an extended mode list.

808 - IRCRPL_ProPLIST

<object> <property-list>

Response to the ProP command to list properties of an object. Multiple IRCRPL_ProPLIST messages can be generated per list.

809 - IRCRPL_ProPEND

<object> :End of properties

Last message in a property list.

810 - IRCRPL_ProPVALUE

<object> <property> :<value>

Response to a ProP query of a specific property.

8.2. IRCX Error Replies.

900 - IRCERR_BADCOMMAND

<command> :Bad command

In response to an incorrectly formatted command.

<command> :Bad command prefix specified

A message prefix is not supported for this command.

<channel> <property> :Bad property specified

The message tag is incorrect.

903 - IRCERR_ALREADYAUTHENTICATED

<package> :Already authentication

The client has already authenticated with the server.

904 - IRCERR_AUTHENTICATIONFAILED

<package> :Authentication failed

The authentication failed due to a bad userid/password or server/network failure.

905 - IRCERR_AUTHENTICATIONSUSPENDED

<package> :Authentication suspended for this IP

Authentication has been temporary disabled due to too many authentication failures from this IP.

906 - IRCERR_UNKNOWNPACKAGE

<package> :Unsupported authentication package

The authentication package specified is not known to the server. ISIRCX command will return a list of supported authentication packages.

907 - IRCERR_EVENTDUP

<event> <mask> :Duplicate event entry

908 - IRCERR_EVENTMIS

<event> <mask> :Unknown event entry

909 - IRCERR_NOSUCHEVENT

<event> :No such event type

910 - IRCERR_TOOMANYEVENTS

<event> :Too many events specifed

911 - IRCERR_UNKNOWNFUNCTION

<command> :Unknown function

A unknown command function was specified.

912 - IRCERR_UNKNOWNMODE

<mode> :Unknown mode

913 - IRCERR_UNKNOWNProPERTY

<property> :Unknown property

914 - IRCERR_NODATA

<object> :Does not permit data messages

915 - IRCERR_NODATA

<object> :Does not permit data messages

916 - IRCERR_NOREMOTE

<object> :Does not permit whispers

917 - IRCERR_NOWHISPER

<object> :Does not permit whispers

918 - IRCERR_RESTRICTED

<command> :Restricted by the administrator

The command/function/operation was not executed due to an administrator restriction on this client connection.

919 - IRCERR_SECURITY

<command> :Security failure

The command/function/operation is not permited for this level of client due to security.

999 - IRCERR_INTERNALERroR

:Internal error code <error-code>

Internal error generated that doesn't map to a valid IRCX error reply. The error code is implementation dependent.

PREVIOUS PAGE | TABLE OF CONTENTS | NEXT PAGE

Comments about this page? Send them to webmaster (at) invlogic.com.

Return to Innovative Logic's Home Page.
Last modified: 17-Sep-2004 01:04PM.
Pages copyright ©1996-1997, Innovative Web Creations.
All rights reserved.