gnu-social/plugins/Irc/extlib/phergie/Phergie/Event/Response.php
2010-06-16 01:55:39 +01:00

954 lines
25 KiB
PHP
Executable File

<?php
/**
* Phergie
*
* PHP version 5
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.
* It is also available through the world-wide-web at this URL:
* http://phergie.org/license
*
* @category Phergie
* @package Phergie
* @author Phergie Development Team <team@phergie.org>
* @copyright 2008-2010 Phergie Development Team (http://phergie.org)
* @license http://phergie.org/license New BSD License
* @link http://pear.phergie.org/package/Phergie
*/
/**
* Event originating from the server in response to an event sent by the
* current client.
*
* @category Phergie
* @package Phergie
* @author Phergie Development Team <team@phergie.org>
* @license http://phergie.org/license New BSD License
* @link http://pear.phergie.org/package/Phergie
* @link http://www.irchelp.org/irchelp/rfc/chapter6.html
*/
class Phergie_Event_Response extends Phergie_Event_Abstract
{
/**
* <nickname> No such nick/channel
*
* Used to indicate the nickname parameter supplied to a command is currently
* unused.
*/
const ERR_NOSUCHNICK = '401';
/**
* <server name> No such server
*
* Used to indicate the server name given currently doesn't exist.
*/
const ERR_NOSUCHSERVER = '402';
/**
* <channel name> No such channel
*
* Used to indicate the given channel name is invalid.
*/
const ERR_NOSUCHCHANNEL = '403';
/**
* <channel name> Cannot send to channel
*
* Sent to a user who is either (a) not on a channel which is mode +n or (b) not
* a chanop (or mode +v) on a channel which has mode +m set and is trying to send
* a PRIVMSG message to that channel.
*/
const ERR_CANNOTSENDTOCHAN = '404';
/**
* <channel name> You have joined too many channels
*
* Sent to a user when they have joined the maximum number of allowed channels
* and they try to join another channel.
*/
const ERR_TOOMANYCHANNELS = '405';
/**
* <nickname> There was no such nickname
*
* Returned by WHOWAS to indicate there is no history information for that
* nickname.
*/
const ERR_WASNOSUCHNICK = '406';
/**
* <target> Duplicate recipients. No message delivered
*
* Returned to a client which is attempting to send PRIVMSG/NOTICE using the
* user@host destination format and for a user@host which has several
* occurrences.
*/
const ERR_TOOMANYTARGETS = '407';
/**
* No origin specified
*
* PING or PONG message missing the originator parameter which is required since
* these commands must work without valid prefixes.
*/
const ERR_NOORIGIN = '409';
/**
* No recipient given (<command>)
*/
const ERR_NORECIPIENT = '411';
/**
* No text to send
*/
const ERR_NOTEXTTOSEND = '412';
/**
* <mask> No toplevel domain specified
*/
const ERR_NOTOPLEVEL = '413';
/**
* <mask> Wildcard in toplevel domain
*
* 412 - 414 are returned by PRIVMSG to indicate that the message wasn't
* delivered for some reason. ERR_NOTOPLEVEL and ERR_WILDTOPLEVEL are errors that
* are returned when an invalid use of "PRIVMSG $<server>" or "PRIVMSG #<host>"
* is attempted.
*/
const ERR_WILDTOPLEVEL = '414';
/**
* <command> Unknown command
*
* Returned to a registered client to indicate that the command sent is unknown
* by the server.
*/
const ERR_UNKNOWNCOMMAND = '421';
/**
* MOTD File is missing
*
* Server's MOTD file could not be opened by the server.
*/
const ERR_NOMOTD = '422';
/**
* <server> No administrative info available
*
* Returned by a server in response to an ADMIN message when there is an error in
* finding the appropriate information.
*/
const ERR_NOADMININFO = '423';
/**
* File error doing <file op> on <file>
*
* Generic error message used to report a failed file operation during the
* processing of a message.
*/
const ERR_FILEERROR = '424';
/**
* No nickname given
*
* Returned when a nickname parameter expected for a command and isn't found.
*/
const ERR_NONICKNAMEGIVEN = '431';
/**
* <nick> Erroneus nickname
*
* Returned after receiving a NICK message which contains characters which do not
* fall in the defined set. See section x.x.x for details on valid nicknames.
*/
const ERR_ERRONEUSNICKNAME = '432';
/**
* <nick> Nickname is already in use
*
* Returned when a NICK message is processed that results in an attempt to change
* to a currently existing nickname.
*/
const ERR_NICKNAMEINUSE = '433';
/**
* <nick> Nickname collision KILL
*
* Returned by a server to a client when it detects a nickname collision
* (registered of a NICK that already exists by another server).
*/
const ERR_NICKCOLLISION = '436';
/**
* <nick> <channel> They aren't on that channel
*
* Returned by the server to indicate that the target user of the command is not
* on the given channel.
*/
const ERR_USERNOTINCHANNEL = '441';
/**
* <channel> You're not on that channel
*
* Returned by the server whenever a client tries to perform a channel effecting
* command for which the client isn't a member.
*/
const ERR_NOTONCHANNEL = '442';
/**
* <user> <channel> is already on channel
*
* Returned when a client tries to invite a user to a channel they are already
* on.
*/
const ERR_USERONCHANNEL = '443';
/**
* <user> User not logged in
*
* Returned by the summon after a SUMMON command for a user was unable to be
* performed since they were not logged in.
*/
const ERR_NOLOGIN = '444';
/**
* SUMMON has been disabled
*
* Returned as a response to the SUMMON command. Must be returned by any server
* which does not implement it.
*/
const ERR_SUMMONDISABLED = '445';
/**
* USERS has been disabled
*
* Returned as a response to the USERS command. Must be returned by any server
* which does not implement it.
*/
const ERR_USERSDISABLED = '446';
/**
* You have not registered
*
* Returned by the server to indicate that the client must be registered before
* the server will allow it to be parsed in detail.
*/
const ERR_NOTREGISTERED = '451';
/**
* <command> Not enough parameters
*
* Returned by the server by numerous commands to indicate to the client that it
* didn't supply enough parameters.
*/
const ERR_NEEDMOREPARAMS = '461';
/**
* You may not reregister
*
* Returned by the server to any link which tries to change part of the
* registered details (such as password or user details from second USER
* message).
*/
const ERR_ALREADYREGISTRED = '462';
/**
* Your host isn't among the privileged
*
* Returned to a client which attempts to register with a server which does not
* been setup to allow connections from the host the attempted connection is
* tried.
*/
const ERR_NOPERMFORHOST = '463';
/**
* Password incorrect
*
* Returned to indicate a failed attempt at registering a connection for which a
* password was required and was either not given or incorrect.
*/
const ERR_PASSWDMISMATCH = '464';
/**
* You are banned from this server
*
* Returned after an attempt to connect and register yourself with a server which
* has been setup to explicitly deny connections to you.
*/
const ERR_YOUREBANNEDCREEP = '465';
/**
* <channel> Channel key already set
*/
const ERR_KEYSET = '467';
/**
* <channel> Cannot join channel (+l)
*/
const ERR_CHANNELISFULL = '471';
/**
* <char> is unknown mode char to me
*/
const ERR_UNKNOWNMODE = '472';
/**
* <channel> Cannot join channel (+i)
*/
const ERR_INVITEONLYCHAN = '473';
/**
* <channel> Cannot join channel (+b)
*/
const ERR_BANNEDFROMCHAN = '474';
/**
* <channel> Cannot join channel (+k)
*/
const ERR_BADCHANNELKEY = '475';
/**
* Permission Denied- You're not an IRC operator
*
* Any command requiring operator privileges to operate must return this error to
* indicate the attempt was unsuccessful.
*/
const ERR_NOPRIVILEGES = '481';
/**
* <channel> You're not channel operator
*
* Any command requiring 'chanop' privileges (such as MODE messages) must return
* this error if the client making the attempt is not a chanop on the specified
* channel.
*/
const ERR_CHANOPRIVSNEEDED = '482';
/**
* You cant kill a server!
*
* Any attempts to use the KILL command on a server are to be refused and this
* error returned directly to the client.
*/
const ERR_CANTKILLSERVER = '483';
/**
* No O-lines for your host
*
* If a client sends an OPER message and the server has not been configured to
* allow connections from the client's host as an operator, this error must be
* returned.
*/
const ERR_NOOPERHOST = '491';
/**
* Unknown MODE flag
*
* Returned by the server to indicate that a MODE message was sent with a
* nickname parameter and that the a mode flag sent was not recognized.
*/
const ERR_UMODEUNKNOWNFLAG = '501';
/**
* Cant change mode for other users
*
* Error sent to any user trying to view or change the user mode for a user other
* than themselves.
*/
const ERR_USERSDONTMATCH = '502';
/**
* Dummy reply number. Not used.
*/
const RPL_NONE = '300';
/**
* [<reply>{<space><reply>}]
*
* Reply format used by USERHOST to list replies to the query list. The reply
* string is composed as follows <reply> = <nick>['*'] '=' <'+'|'-'><hostname>
* The '*' indicates whether the client has registered as an Operator. The '-' or
* '+' characters represent whether the client has set an AWAY message or not
* respectively.
*/
const RPL_USERHOST = '302';
/**
* [<nick> {<space><nick>}]
*
* Reply format used by ISON to list replies to the query list.
*/
const RPL_ISON = '303';
/**
* <nick> <away message>
*/
const RPL_AWAY = '301';
/**
* You are no longer marked as being away
*/
const RPL_UNAWAY = '305';
/**
* You have been marked as being away
*
* These replies are used with the AWAY command (if allowed). RPL_AWAY is sent to
* any client sending a PRIVMSG to a client which is away. RPL_AWAY is only sent
* by the server to which the client is connected. Replies RPL_UNAWAY and
* RPL_NOWAWAY are sent when the client removes and sets an AWAY message.
*/
const RPL_NOWAWAY = '306';
/**
* <nick> <user> <host> * <real name>
*/
const RPL_WHOISUSER = '311';
/**
* <nick> <server> <server info>
*/
const RPL_WHOISSERVER = '312';
/**
* <nick> is an IRC operator
*/
const RPL_WHOISOPERATOR = '313';
/**
* <nick> <integer> seconds idle
*/
const RPL_WHOISIDLE = '317';
/**
* <nick> End of /WHOIS list
*/
const RPL_ENDOFWHOIS = '318';
/**
* <nick> {[@|+]<channel><space>}
*
* Replies 311 - 313, 317 - 319 are all replies generated in response to a WHOIS
* message. Given that there are enough parameters present, the answering server
* must either formulate a reply out of the above numerics (if the query nick is
* found) or return an error reply. The '*' in RPL_WHOISUSER is there as the
* literal character and not as a wild card. For each reply set, only
* RPL_WHOISCHANNELS may appear more than once (for long lists of channel names).
* The '@' and '+' characters next to the channel name indicate whether a client
* is a channel operator or has been granted permission to speak on a moderated
* channel. The RPL_ENDOFWHOIS reply is used to mark the end of processing a
* WHOIS message.
*/
const RPL_WHOISCHANNELS = '319';
/**
* <nick> <user> <host> * <real name>
*/
const RPL_WHOWASUSER = '314';
/**
* <nick> End of WHOWAS
*
* When replying to a WHOWAS message, a server must use the replies
* RPL_WHOWASUSER, RPL_WHOISSERVER or ERR_WASNOSUCHNICK for each nickname in the
* presented list. At the end of all reply batches, there must be RPL_ENDOFWHOWAS
* (even if there was only one reply and it was an error).
*/
const RPL_ENDOFWHOWAS = '369';
/**
* Channel Users Name
*/
const RPL_LISTSTART = '321';
/**
* <channel> <# visible> <topic>
*/
const RPL_LIST = '322';
/**
* End of /LIST
*
* Replies RPL_LISTSTART, RPL_LIST, RPL_LISTEND mark the start, actual replies
* with data and end of the server's response to a LIST command. If there are no
* channels available to return, only the start and end reply must be sent.
*/
const RPL_LISTEND = '323';
/**
* <channel> <mode> <mode params>
*/
const RPL_CHANNELMODEIS = '324';
/**
* <channel> No topic is set
*/
const RPL_NOTOPIC = '331';
/**
* <channel> <topic>
*
* When sending a TOPIC message to determine the channel topic, one of two
* replies is sent. If the topic is set, RPL_TOPIC is sent back else RPL_NOTOPIC.
*/
const RPL_TOPIC = '332';
/**
* <channel> <nick>
*
* Returned by the server to indicate that the attempted INVITE message was
* successful and is being passed onto the end client.
*/
const RPL_INVITING = '341';
/**
* <user> Summoning user to IRC
*
* Returned by a server answering a SUMMON message to indicate that it is
* summoning that user.
*/
const RPL_SUMMONING = '342';
/**
* <version>.<debuglevel> <server> <comments>
*
* Reply by the server showing its version details. The <version> is the version
* of the software being used (including any patchlevel revisions) and the
* <debuglevel> is used to indicate if the server is running in "debug mode". The
* "comments" field may contain any comments about the version or further version
* details.
*/
const RPL_VERSION = '351';
/**
* <channel> <user> <host> <server> <nick> <H|G>[*][@|+] <hopcount> <real name>
*/
const RPL_WHOREPLY = '352';
/**
* <name> End of /WHO list
*
* The RPL_WHOREPLY and RPL_ENDOFWHO pair are used to answer a WHO message. The
* RPL_WHOREPLY is only sent if there is an appropriate match to the WHO query.
* If there is a list of parameters supplied with a WHO message, a RPL_ENDOFWHO
* must be sent after processing each list item with <name> being the item.
*/
const RPL_ENDOFWHO = '315';
/**
* <channel> [[@|+]<nick> [[@|+]<nick> [...]]]
*/
const RPL_NAMREPLY = '353';
/**
* <channel> End of /NAMES list
*
* To reply to a NAMES message, a reply pair consisting of RPL_NAMREPLY and
* RPL_ENDOFNAMES is sent by the server back to the client. If there is no
* channel found as in the query, then only RPL_ENDOFNAMES is returned. The
* exception to this is when a NAMES message is sent with no parameters and all
* visible channels and contents are sent back in a series of RPL_NAMEREPLY
* messages with a RPL_ENDOFNAMES to mark the end.
*/
const RPL_ENDOFNAMES = '366';
/**
* <mask> <server> <hopcount> <server info>
*/
const RPL_LINKS = '364';
/**
* <mask> End of /LINKS list
*
* In replying to the LINKS message, a server must send replies back using the
* RPL_LINKS numeric and mark the end of the list using an RPL_ENDOFLINKS reply.v
*/
const RPL_ENDOFLINKS = '365';
/**
* <channel> <banid>
*/
const RPL_BANLIST = '367';
/**
* <channel> End of channel ban list
*
* When listing the active 'bans' for a given channel, a server is required to
* send the list back using the RPL_BANLIST and RPL_ENDOFBANLIST messages. A
* separate RPL_BANLIST is sent for each active banid. After the banids have been
* listed (or if none present) a RPL_ENDOFBANLIST must be sent.
*/
const RPL_ENDOFBANLIST = '368';
/**
* <string>
*/
const RPL_INFO = '371';
/**
* End of /INFO list
*
* A server responding to an INFO message is required to send all its 'info' in a
* series of RPL_INFO messages with a RPL_ENDOFINFO reply to indicate the end of
* the replies.
*/
const RPL_ENDOFINFO = '374';
/**
* - <server> Message of the day -
*/
const RPL_MOTDSTART = '375';
/**
* - <text>
*/
const RPL_MOTD = '372';
/**
* End of /MOTD command
*
* When responding to the MOTD message and the MOTD file is found, the file is
* displayed line by line, with each line no longer than 80 characters, using
* RPL_MOTD format replies. These should be surrounded by a RPL_MOTDSTART (before
* the RPL_MOTDs) and an RPL_ENDOFMOTD (after).
*/
const RPL_ENDOFMOTD = '376';
/**
* You are now an IRC operator
*
* RPL_YOUREOPER is sent back to a client which has just successfully issued an
* OPER message and gained operator status.
*/
const RPL_YOUREOPER = '381';
/**
* <config file> Rehashing
*
* If the REHASH option is used and an operator sends a REHASH message, an
* RPL_REHASHING is sent back to the operator.
*/
const RPL_REHASHING = '382';
/**
* <server> <string showing server's local time>
*
* When replying to the TIME message, a server must send the reply using the
* RPL_TIME format above. The string showing the time need only contain the
* correct day and time there. There is no further requirement for the time
* string.
*/
const RPL_TIME = '391';
/**
* UserID Terminal Host
*/
const RPL_USERSSTART = '392';
/**
* %-8s %-9s %-8s
*/
const RPL_USERS = '393';
/**
* End of users
*/
const RPL_ENDOFUSERS = '394';
/**
* Nobody logged in
*
* If the USERS message is handled by a server, the replies RPL_USERSTART,
* RPL_USERS, RPL_ENDOFUSERS and RPL_NOUSERS are used. RPL_USERSSTART must be
* sent first, following by either a sequence of RPL_USERS or a single
* RPL_NOUSER. Following this is RPL_ENDOFUSERS.
*/
const RPL_NOUSERS = '395';
/**
* Link <version & debug level> <destination> <next server>
*/
const RPL_TRACELINK = '200';
/**
* Try. <class> <server>
*/
const RPL_TRACECONNECTING = '201';
/**
* H.S. <class> <server>
*/
const RPL_TRACEHANDSHAKE = '202';
/**
* ???? <class> [<client IP address in dot form>]
*/
const RPL_TRACEUNKNOWN = '203';
/**
* Oper <class> <nick>
*/
const RPL_TRACEOPERATOR = '204';
/**
* User <class> <nick>
*/
const RPL_TRACEUSER = '205';
/**
* Serv <class> <int>S <int>C <server> <nick!user|*!*>@<host|server>
*/
const RPL_TRACESERVER = '206';
/**
* <newtype> 0 <client name>
*/
const RPL_TRACENEWTYPE = '208';
/**
* File <logfile> <debug level>
*
* The RPL_TRACE* are all returned by the server in response to the TRACE
* message. How many are returned is dependent on the the TRACE message and
* whether it was sent by an operator or not. There is no predefined order for
* which occurs first. Replies RPL_TRACEUNKNOWN, RPL_TRACECONNECTING and
* RPL_TRACEHANDSHAKE are all used for connections which have not been fully
* established and are either unknown, still attempting to connect or in the
* process of completing the 'server handshake'. RPL_TRACELINK is sent by any
* server which handles a TRACE message and has to pass it on to another server.
* The list of RPL_TRACELINKs sent in response to a TRACE command traversing the
* IRC network should reflect the actual connectivity of the servers themselves
* along that path. RPL_TRACENEWTYPE is to be used for any connection which does
* not fit in the other categories but is being displayed anyway.
*/
const RPL_TRACELOG = '261';
/**
* <linkname> <sendq> <sent messages> <sent bytes> <received messages> <received
* bytes> <time open>
*/
const RPL_STATSLINKINFO = '211';
/**
* <command> <count>
*/
const RPL_STATSCOMMANDS = '212';
/**
* C <host> * <name> <port> <class>
*/
const RPL_STATSCLINE = '213';
/**
* N <host> * <name> <port> <class>
*/
const RPL_STATSNLINE = '214';
/**
* I <host> * <host> <port> <class>
*/
const RPL_STATSILINE = '215';
/**
* K <host> * <username> <port> <class>
*/
const RPL_STATSKLINE = '216';
/**
* Y <class> <ping frequency> <connect frequency> <max sendq>
*/
const RPL_STATSYLINE = '218';
/**
* <stats letter> End of /STATS report
*/
const RPL_ENDOFSTATS = '219';
/**
* L <hostmask> * <servername> <maxdepth>
*/
const RPL_STATSLLINE = '241';
/**
* Server Up %d days %d%02d%02d
*/
const RPL_STATSUPTIME = '242';
/**
* O <hostmask> * <name>
*/
const RPL_STATSOLINE = '243';
/**
* H <hostmask> * <servername>
*/
const RPL_STATSHLINE = '244';
/**
* <user mode string>
*
* To answer a query about a client's own mode, RPL_UMODEIS is sent back.
*/
const RPL_UMODEIS = '221';
/**
* There are <integer> users and <integer> invisible on <integer> servers
*/
const RPL_LUSERCLIENT = '251';
/**
* <integer> operator(s) online
*/
const RPL_LUSEROP = '252';
/**
* <integer> unknown connection(s)
*/
const RPL_LUSERUNKNOWN = '253';
/**
* <integer> channels formed
*/
const RPL_LUSERCHANNELS = '254';
/**
* I have <integer> clients and <integer> servers
*
* In processing an LUSERS message, the server sends a set of replies from
* RPL_LUSERCLIENT, RPL_LUSEROP, RPL_USERUNKNOWN, RPL_LUSERCHANNELS and
* RPL_LUSERME. When replying, a server must send back RPL_LUSERCLIENT and
* RPL_LUSERME. The other replies are only sent back if a non-zero count is found
* for them.
*/
const RPL_LUSERME = '255';
/**
* <server> Administrative info
*/
const RPL_ADMINME = '256';
/**
* <admin info>
*/
const RPL_ADMINLOC1 = '257';
/**
* <admin info>
*/
const RPL_ADMINLOC2 = '258';
/**
* <admin info>
*
* When replying to an ADMIN message, a server is expected to use replies
* RLP_ADMINME through to RPL_ADMINEMAIL and provide a text message with each.
* For RPL_ADMINLOC1 a description of what city, state and country the server is
* in is expected, followed by details of the university and department
* (RPL_ADMINLOC2) and finally the administrative contact for the server (an
* email address here is required) in RPL_ADMINEMAIL.
*/
const RPL_ADMINEMAIL = '259';
/**
* Reply code sent by the server, which can be compared to the ERR_* and
* RPL_* constants
*
* @var string
*/
protected $code;
/**
* Reply code description sent by the server.
*
* @var string
*/
protected $description;
/**
* Raw data sent by the server
*
* @var string
*/
protected $rawData;
/**
* Event type
*
* @var string
*/
protected $type = 'response';
/**
* Sets the reply code sent by the server.
*
* @param string $code Reply code
*
* @return Phergie_Event_Response Provides a fluent interface
*/
public function setCode($code)
{
$this->code = $code;
return $this;
}
/**
* Returns the reply code sent by the server.
*
* @return string
*/
public function getCode()
{
return $this->code;
}
/**
* Sets the reply code description sent by the server.
*
* @param string $description Reply code description
*
* @return Phergie_Event_Response Provides a fluent interface
*/
public function setDescription($description)
{
$this->description = $description;
return $this;
}
/**
* Returns the reply code description sent by the server.
*
* @return string
*/
public function getDescription()
{
return $this->description;
}
/**
* Sets the raw buffer for the given event
*
* @param string $buffer Raw event buffer
*
* @return Phergie_Event_Response Provides a fluent interface
*/
public function setRawData($buffer)
{
$this->rawData = $buffer;
return $this;
}
/**
* Returns the raw buffer that was sent from the server for that event
*
* @return string
*/
public function getRawData()
{
return $this->rawData;
}
}