rfc2812.txt
来自「中、英文RFC文档大全打包下载完全版 .」· 文本 代码 · 共 1,794 行 · 第 1/5 页
TXT
1,794 行
:WiZ!jto@tolsun.oulu.fi TOPIC #test :New topic ; User Wiz setting the topic. TOPIC #test :another topic ; Command to set the topic on #test to "another topic". TOPIC #test : ; Command to clear the topic on #test. TOPIC #test ; Command to check the topic for #test.3.2.5 Names message Command: NAMES Parameters: [ <channel> *( "," <channel> ) [ <target> ] ] By using the NAMES command, a user can list all nicknames that are visible to him. For more details on what is visible and what is not, see "Internet Relay Chat: Channel Management" [IRC-CHAN]. The <channel> parameter specifies which channel(s) to return information about. There is no error reply for bad channel names. If no <channel> parameter is given, a list of all channels and their occupants is returned. At the end of this list, a list of users who are visible but either not on any channel or not on a visible channel are listed as being on `channel' "*". If the <target> parameter is specified, the request is forwarded to that server which will generate the reply. Wildcards are allowed in the <target> parameter. Numerics: ERR_TOOMANYMATCHES ERR_NOSUCHSERVER RPL_NAMREPLY RPL_ENDOFNAMESKalt Informational [Page 20] RFC 2812 Internet Relay Chat: Client Protocol April 2000 Examples: NAMES #twilight_zone,#42 ; Command to list visible users on #twilight_zone and #42 NAMES ; Command to list all visible channels and users3.2.6 List message Command: LIST Parameters: [ <channel> *( "," <channel> ) [ <target> ] ] The list command is used to list channels and their topics. If the <channel> parameter is used, only the status of that channel is displayed. If the <target> parameter is specified, the request is forwarded to that server which will generate the reply. Wildcards are allowed in the <target> parameter. Numeric Replies: ERR_TOOMANYMATCHES ERR_NOSUCHSERVER RPL_LIST RPL_LISTEND Examples: LIST ; Command to list all channels. LIST #twilight_zone,#42 ; Command to list channels #twilight_zone and #423.2.7 Invite message Command: INVITE Parameters: <nickname> <channel> The INVITE command is used to invite a user to a channel. The parameter <nickname> is the nickname of the person to be invited to the target channel <channel>. There is no requirement that the channel the target user is being invited to must exist or be a valid channel. However, if the channel exists, only members of the channel are allowed to invite other users. When the channel has invite-only flag set, only channel operators may issue INVITE command.Kalt Informational [Page 21] RFC 2812 Internet Relay Chat: Client Protocol April 2000 Only the user inviting and the user being invited will receive notification of the invitation. Other channel members are not notified. (This is unlike the MODE changes, and is occasionally the source of trouble for users.) Numeric Replies: ERR_NEEDMOREPARAMS ERR_NOSUCHNICK ERR_NOTONCHANNEL ERR_USERONCHANNEL ERR_CHANOPRIVSNEEDED RPL_INVITING RPL_AWAY Examples: :Angel!wings@irc.org INVITE Wiz #Dust ; Message to WiZ when he has been invited by user Angel to channel #Dust INVITE Wiz #Twilight_Zone ; Command to invite WiZ to #Twilight_zone3.2.8 Kick command Command: KICK Parameters: <channel> *( "," <channel> ) <user> *( "," <user> ) [<comment>] The KICK command can be used to request the forced removal of a user from a channel. It causes the <user> to PART from the <channel> by force. For the message to be syntactically correct, there MUST be either one channel parameter and multiple user parameter, or as many channel parameters as there are user parameters. If a "comment" is given, this will be sent instead of the default message, the nickname of the user issuing the KICK. The server MUST NOT send KICK messages with multiple channels or users to clients. This is necessarily to maintain backward compatibility with old client software. Numeric Replies: ERR_NEEDMOREPARAMS ERR_NOSUCHCHANNEL ERR_BADCHANMASK ERR_CHANOPRIVSNEEDED ERR_USERNOTINCHANNEL ERR_NOTONCHANNELKalt Informational [Page 22] RFC 2812 Internet Relay Chat: Client Protocol April 2000 Examples: KICK &Melbourne Matthew ; Command to kick Matthew from &Melbourne KICK #Finnish John :Speaking English ; Command to kick John from #Finnish using "Speaking English" as the reason (comment). :WiZ!jto@tolsun.oulu.fi KICK #Finnish John ; KICK message on channel #Finnish from WiZ to remove John from channel3.3 Sending messages The main purpose of the IRC protocol is to provide a base for clients to communicate with each other. PRIVMSG, NOTICE and SQUERY (described in Section 3.5 on Service Query and Commands) are the only messages available which actually perform delivery of a text message from one client to another - the rest just make it possible and try to ensure it happens in a reliable and structured manner.3.3.1 Private messages Command: PRIVMSG Parameters: <msgtarget> <text to be sent> PRIVMSG is used to send private messages between users, as well as to send messages to channels. <msgtarget> is usually the nickname of the recipient of the message, or a channel name. The <msgtarget> parameter may also be a host mask (#<mask>) or server mask ($<mask>). In both cases the server will only send the PRIVMSG to those who have a server or host matching the mask. The mask MUST have at least 1 (one) "." in it and no wildcards following the last ".". This requirement exists to prevent people sending messages to "#*" or "$*", which would broadcast to all users. Wildcards are the '*' and '?' characters. This extension to the PRIVMSG command is only available to operators. Numeric Replies: ERR_NORECIPIENT ERR_NOTEXTTOSEND ERR_CANNOTSENDTOCHAN ERR_NOTOPLEVEL ERR_WILDTOPLEVEL ERR_TOOMANYTARGETS ERR_NOSUCHNICK RPL_AWAYKalt Informational [Page 23] RFC 2812 Internet Relay Chat: Client Protocol April 2000 Examples: :Angel!wings@irc.org PRIVMSG Wiz :Are you receiving this message ? ; Message from Angel to Wiz. PRIVMSG Angel :yes I'm receiving it ! ; Command to send a message to Angel. PRIVMSG jto@tolsun.oulu.fi :Hello ! ; Command to send a message to a user on server tolsun.oulu.fi with username of "jto". PRIVMSG kalt%millennium.stealth.net@irc.stealth.net :Are you a frog? ; Message to a user on server irc.stealth.net with username of "kalt", and connected from the host millennium.stealth.net. PRIVMSG kalt%millennium.stealth.net :Do you like cheese? ; Message to a user on the local server with username of "kalt", and connected from the host millennium.stealth.net. PRIVMSG Wiz!jto@tolsun.oulu.fi :Hello ! ; Message to the user with nickname Wiz who is connected from the host tolsun.oulu.fi and has the username "jto". PRIVMSG $*.fi :Server tolsun.oulu.fi rebooting. ; Message to everyone on a server which has a name matching *.fi. PRIVMSG #*.edu :NSFNet is undergoing work, expect interruptions ; Message to all users who come from a host which has a name matching *.edu.3.3.2 Notice Command: NOTICE Parameters: <msgtarget> <text> The NOTICE command is used similarly to PRIVMSG. The difference between NOTICE and PRIVMSG is that automatic replies MUST NEVER be sent in response to a NOTICE message. This rule applies to serversKalt Informational [Page 24] RFC 2812 Internet Relay Chat: Client Protocol April 2000 too - they MUST NOT send any error reply back to the client on receipt of a notice. The object of this rule is to avoid loops between clients automatically sending something in response to something it received. This command is available to services as well as users. This is typically used by services, and automatons (clients with either an AI or other interactive program controlling their actions). See PRIVMSG for more details on replies and examples.3.4 Server queries and commands The server query group of commands has been designed to return information about any server which is connected to the network. In these queries, where a parameter appears as <target>, wildcard masks are usually valid. For each parameter, however, only one query and set of replies is to be generated. In most cases, if a nickname is given, it will mean the server to which the user is connected. These messages typically have little value for services, it is therefore RECOMMENDED to forbid services from using them.3.4.1 Motd message Command: MOTD Parameters: [ <target> ] The MOTD command is used to get the "Message Of The Day" of the given server, or current server if <target> is omitted. Wildcards are allowed in the <target> parameter. Numeric Replies: RPL_MOTDSTART RPL_MOTD RPL_ENDOFMOTD ERR_NOMOTD3.4.2 Lusers message Command: LUSERS Parameters: [ <mask> [ <target> ] ] The LUSERS command is used to get statistics about the size of the IRC network. If no parameter is given, the reply will be about the whole net. If a <mask> is specified, then the reply will onlyKalt Informational [Page 25] RFC 2812 Internet Relay Chat: Client Protocol April 2000 concern the part of the network formed by the servers matching the mask. Finally, if the <target> parameter is specified, the request is forwarded to that server which will generate the reply. Wildcards are allowed in the <target> parameter. Numeric Replies: RPL_LUSERCLIENT RPL_LUSEROP RPL_LUSERUNKOWN RPL_LUSERCHANNELS RPL_LUSERME ERR_NOSUCHSERVER3.4.3 Version message Command: VERSION Parameters: [ <target> ] The VERSION command is used to query the version of the server program. An optional parameter <target> is used to query the version of the server program which a client is not directly connected to. Wildcards are allowed in the <target> parameter. Numeric Replies: ERR_NOSUCHSERVER RPL_VERSION Examples: VERSION tolsun.oulu.fi ; Command to check the version of⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?