/* * libretroshare/src/services: rsgrouteritems.h * * Services for RetroShare. * * Copyright 2013 by Cyril Soler * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License Version 2 as published by the Free Software Foundation. * * This library 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 * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 * USA. * * Please report all bugs and problems to "csoler@users.sourceforge.net". * */ #pragma once #include "serialiser/rsserial.h" #include "serialiser/rstlvkeys.h" #include "serialiser/rsserviceids.h" #include "retroshare/rstypes.h" #include "retroshare/rsgrouter.h" #include "p3grouter.h" const uint8_t RS_PKT_SUBTYPE_GROUTER_PUBLISH_KEY = 0x01 ; // used to publish a key const uint8_t RS_PKT_SUBTYPE_GROUTER_ACK_deprecated = 0x03 ; // acknowledgement of data received const uint8_t RS_PKT_SUBTYPE_GROUTER_RECEIPT = 0x04 ; // acknowledgement of data received const uint8_t RS_PKT_SUBTYPE_GROUTER_DATA_deprecated = 0x05 ; // used to send data to a destination const uint8_t RS_PKT_SUBTYPE_GROUTER_DATA = 0x06 ; // used to send data to a destination (Signed by source) const uint8_t RS_PKT_SUBTYPE_GROUTER_MATRIX_CLUES = 0x80 ; // item to save matrix clues const uint8_t RS_PKT_SUBTYPE_GROUTER_FRIENDS_LIST = 0x82 ; // item to save friend lists const uint8_t RS_PKT_SUBTYPE_GROUTER_ROUTING_INFO_deprecated = 0x87 ; // deprecated. Don't use. const uint8_t RS_PKT_SUBTYPE_GROUTER_ROUTING_INFO = 0x89 ; // item to save routing info const uint8_t QOS_PRIORITY_RS_GROUTER = 3 ; // irrelevant since all items travel through tunnels /***********************************************************************************/ /* Basic GRouter Item Class */ /***********************************************************************************/ class RsGRouterItem: public RsItem { public: RsGRouterItem(uint8_t grouter_subtype) : RsItem(RS_PKT_VERSION_SERVICE,RS_SERVICE_TYPE_GROUTER,grouter_subtype) {} virtual bool serialise(void *data,uint32_t& size) const = 0 ; virtual uint32_t serial_size() const = 0 ; virtual void clear() = 0 ; virtual std::ostream& print(std::ostream &out, uint16_t indent = 0) = 0; protected: bool serialise_header(void *data, uint32_t& pktsize, uint32_t& tlvsize, uint32_t& offset) const; }; /***********************************************************************************/ /* Helper base classes */ /***********************************************************************************/ class RsGRouterNonCopyableObject { public: RsGRouterNonCopyableObject() {} private: RsGRouterNonCopyableObject(const RsGRouterNonCopyableObject&) {} RsGRouterNonCopyableObject operator=(const RsGRouterNonCopyableObject&) { return *this ;} }; /***********************************************************************************/ /* Specific packets */ /***********************************************************************************/ class RsGRouterGenericDataItem: public RsGRouterItem, public RsGRouterNonCopyableObject { public: RsGRouterGenericDataItem() : RsGRouterItem(RS_PKT_SUBTYPE_GROUTER_DATA) { setPriorityLevel(QOS_PRIORITY_RS_GROUTER) ; } virtual ~RsGRouterGenericDataItem() { clear() ; } virtual bool serialise(void *data,uint32_t& size) const ; virtual uint32_t serial_size() const ; virtual void clear() { free(data_bytes); data_bytes=NULL; } virtual std::ostream& print(std::ostream &out, uint16_t indent = 0) ; RsGRouterGenericDataItem *duplicate() const ; // packet data // GRouterMsgPropagationId routing_id ; GRouterKeyId destination_key ; uint32_t data_size ; uint8_t *data_bytes; RsTlvKeySignature signature ; // signature by sender's key uint32_t randomized_distance ; // number of hops (tunnel wise. Does not preclude of the real distance) uint32_t flags ; // utility methods for signing data uint32_t signed_data_size() const ; bool serialise_signed_data(void *data,uint32_t& size) const ; }; class RsGRouterReceiptItem: public RsGRouterItem { public: RsGRouterReceiptItem() : RsGRouterItem(RS_PKT_SUBTYPE_GROUTER_RECEIPT) { setPriorityLevel(QOS_PRIORITY_RS_GROUTER) ; } virtual bool serialise(void *data,uint32_t& size) const ; virtual uint32_t serial_size() const ; virtual void clear() {} virtual std::ostream& print(std::ostream &out, uint16_t indent = 0) ; // packet data // GRouterMsgPropagationId mid ; // message id to which this ack is a response GRouterKeyId destination_key ; // This is the key to the peer we're reponding to. uint32_t state ; // packet was delivered, not delivered, bounced, etc RsTlvKeySignature signature ; // signs mid+destination_key+state }; // Items for saving the routing matrix information. class RsGRouterMatrixCluesItem: public RsGRouterItem { public: RsGRouterMatrixCluesItem() : RsGRouterItem(RS_PKT_SUBTYPE_GROUTER_MATRIX_CLUES) { setPriorityLevel(0) ; } // this item is never sent through the network virtual bool serialise(void *data,uint32_t& size) const ; virtual uint32_t serial_size() const ; virtual void clear() {} virtual std::ostream& print(std::ostream &out, uint16_t indent = 0) ; // packet data // GRouterKeyId destination_key ; std::list clues ; }; class RsGRouterMatrixFriendListItem: public RsGRouterItem { public: RsGRouterMatrixFriendListItem() : RsGRouterItem(RS_PKT_SUBTYPE_GROUTER_FRIENDS_LIST) { setPriorityLevel(0) ; } // this item is never sent through the network virtual bool serialise(void *data,uint32_t& size) const ; virtual uint32_t serial_size() const ; virtual void clear() {} virtual std::ostream& print(std::ostream &out, uint16_t indent = 0) ; // packet data // std::vector reverse_friend_indices ; }; class RsGRouterRoutingInfoItem: public RsGRouterItem, public GRouterRoutingInfo, public RsGRouterNonCopyableObject { public: RsGRouterRoutingInfoItem() : RsGRouterItem(RS_PKT_SUBTYPE_GROUTER_ROUTING_INFO) { setPriorityLevel(0) ; } // this item is never sent through the network virtual ~RsGRouterRoutingInfoItem() { clear() ; } virtual bool serialise(void *data,uint32_t& size) const ; virtual uint32_t serial_size() const ; virtual void clear() { if(data_item != NULL) delete data_item ; data_item = NULL ; } virtual std::ostream& print(std::ostream &out, uint16_t indent = 0) ; }; /***********************************************************************************/ /* Serialisation */ /***********************************************************************************/ class RsGRouterSerialiser: public RsSerialType { public: RsGRouterSerialiser() : RsSerialType(RS_PKT_VERSION_SERVICE, RS_SERVICE_TYPE_GROUTER) {} virtual uint32_t size (RsItem *item) { return dynamic_cast(item)->serial_size() ; } virtual bool serialise(RsItem *item, void *data, uint32_t *size) { return dynamic_cast(item)->serialise(data,*size) ; } virtual RsItem *deserialise (void *data, uint32_t *size) ; private: RsGRouterGenericDataItem *deserialise_RsGRouterGenericDataItem(void *data,uint32_t size) const ; RsGRouterReceiptItem *deserialise_RsGRouterReceiptItem(void *data,uint32_t size) const ; RsGRouterMatrixCluesItem *deserialise_RsGRouterMatrixCluesItem(void *data,uint32_t size) const ; RsGRouterMatrixFriendListItem *deserialise_RsGRouterMatrixFriendListItem(void *data,uint32_t size) const ; RsGRouterRoutingInfoItem *deserialise_RsGRouterRoutingInfoItem(void *data,uint32_t size) const ; };