X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=include%2Fprotocol.h;h=aabb5b022c7d444be244b08ffe40313f1a866c1e;hb=e6601069038c35c546fd3f3dce95024b0d13f1b4;hp=44964e1e82e8e4f9ccc7c3a798e9df59a22b0cde;hpb=3f971b447fae258a92f2cc6645497cce93f1c04e;p=user%2Fhenk%2Fcode%2Finspircd.git diff --git a/include/protocol.h b/include/protocol.h index 44964e1e8..aabb5b022 100644 --- a/include/protocol.h +++ b/include/protocol.h @@ -1,59 +1,139 @@ -/* +------------------------------------+ - * | Inspire Internet Relay Chat Daemon | - * +------------------------------------+ +/* + * InspIRCd -- Internet Relay Chat Daemon * - * InspIRCd: (C) 2002-2008 InspIRCd Development Team - * See: http://www.inspircd.org/wiki/index.php/Credits + * Copyright (C) 2008 Robin Burchell + * Copyright (C) 2008 Craig Edwards * - * This program is free but copyrighted software; see - * the file COPYING for details. + * This file is part of InspIRCd. InspIRCd is free software: you can + * redistribute it and/or modify it under the terms of the GNU General Public + * License as published by the Free Software Foundation, version 2. * - * --------------------------------------------------- + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS + * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more + * details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . */ -#ifndef __PROTOCOL_H__ -#define __PROTOCOL_H__ + +#ifndef PROTOCOL_H +#define PROTOCOL_H #include "hashcomp.h" -class InspIRCd; +class User; -typedef std::deque parameterlist; +typedef std::vector parameterlist; -class ProtocolInterface : public Extensible +class ProtoServer { - protected: - InspIRCd* ServerInstance; public: - ProtocolInterface(InspIRCd* Instance) : ServerInstance(Instance) { } - virtual ~ProtocolInterface() { } + std::string servername; + std::string parentname; + std::string gecos; + unsigned int usercount; + unsigned int opercount; + unsigned int latencyms; +}; - virtual void SendEncapsulatedData(parameterlist &encap) { } +typedef std::list ProtoServerList; - virtual void SendMetaData(void* target, int type, const std::string &key, const std::string &data) { } +class ProtocolInterface +{ + public: + ProtocolInterface() { } + virtual ~ProtocolInterface() { } + /** Send an ENCAP message to one or more linked servers. + * See the protocol documentation for the purpose of ENCAP. + * @param encap This is a list of string parameters, the first of which must be a server ID or glob matching servernames. + * The second must be a subcommand. All subsequent parameters are dependant on the subcommand. + * ENCAP (should) be used instead of creating new protocol messages for easier third party application support. + * @return True if the message was sent out (target exists) + */ + virtual bool SendEncapsulatedData(const parameterlist &encap) { return false; } + + /** Send metadata for an object to other linked servers. + * @param target The object to send metadata for. + * @param key The 'key' of the data, e.g. "swhois" for swhois desc on a user + * @param data The string representation of the data + */ + virtual void SendMetaData(Extensible* target, const std::string &key, const std::string &data) { } + + /** Send a topic change for a channel + * @param channel The channel to change the topic for. + * @param topic The new topic to use for the channel. + */ virtual void SendTopic(Channel* channel, std::string &topic) { } - virtual void SendMode(const std::string &target, parameterlist &modedata) { } + /** Send mode changes for an object. + * @param target The channel name or user to send mode changes for. + * @param modedata The mode changes to send. + * @param translate A list of translation types + */ + virtual void SendMode(const std::string &target, const parameterlist &modedata, const std::vector &translate) { } + /** Convenience function, string wrapper around the above. + */ virtual void SendModeStr(const std::string &target, const std::string &modeline) { - /* Convenience function */ irc::spacesepstream x(modeline); parameterlist n; + std::vector types; std::string v; while (x.GetToken(v)) + { n.push_back(v); - SendMode(target, n); + types.push_back(TR_TEXT); + } + SendMode(target, n, types); } - virtual void SendOperNotice(const std::string &text) { } - - virtual void SendModeNotice(const std::string &modes, const std::string &text) { } - + /** Send a notice to users with a given snomask. + * @param snomask The snomask required for the message to be sent. + * @param text The message to send. + */ virtual void SendSNONotice(const std::string &snomask, const std::string &text) { } + /** Send raw data to a remote client. + * @param target The user to push data to. + * @param rawline The raw IRC protocol line to deliver (":me NOTICE you :foo", whatever). + */ virtual void PushToClient(User* target, const std::string &rawline) { } + + /** Send a message to a channel. + * @param target The channel to message. + * @param status The status character (e.g. %) required to recieve. + * @param text The message to send. + */ + virtual void SendChannelPrivmsg(Channel* target, char status, const std::string &text) { } + + /** Send a notice to a channel. + * @param target The channel to message. + * @param status The status character (e.g. %) required to recieve. + * @param text The message to send. + */ + virtual void SendChannelNotice(Channel* target, char status, const std::string &text) { } + + /** Send a message to a user. + * @param target The user to message. + * @param text The message to send. + */ + virtual void SendUserPrivmsg(User* target, const std::string &text) { } + + /** Send a notice to a user. + * @param target The user to message. + * @param text The message to send. + */ + virtual void SendUserNotice(User* target, const std::string &text) { } + + /** Fill a list of servers and information about them. + * @param sl The list of servers to fill. + * XXX: document me properly, this is shit. + */ + virtual void GetServerList(ProtoServerList &sl) { } }; #endif