/* * 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 "rsgrouter.h" // To be put in serialiser/rsserviceids.h static const uint8_t RS_SERVICE_TYPE_GROUTER = 0x0016 ; const uint8_t RS_PKT_SUBTYPE_GROUTER_PUBLISH_KEY = 0x01 ; // used to publish a key const uint8_t RS_PKT_SUBTYPE_GROUTER_DATA = 0x02 ; // used to send data to a destination const uint8_t RS_PKT_SUBTYPE_GROUTER_ACK = 0x03 ; // acknowledgement of data received const uint8_t QOS_PRIORITY_RS_GROUTER_PUBLISH_KEY = 3 ; // slow items. No need to congest the network with this. const uint8_t QOS_PRIORITY_RS_GROUTER_ACK = 3 ; const uint8_t QOS_PRIORITY_RS_GROUTER_DATA = 3 ; const uint32_t RS_GROUTER_ACK_STATE_RECEIVED = 0x0001 ; // data was received, directly const uint32_t RS_GROUTER_ACK_STATE_RECEIVED_INDIRECTLY = 0x0002 ; // data was received indirectly const uint32_t RS_GROUTER_ACK_STATE_GIVEN_UP = 0x0003 ; // data was given up. No route. const uint32_t RS_GROUTER_ACK_STATE_NO_ROUTE = 0x0004 ; // data was given up. No route. const uint32_t RS_GROUTER_ACK_STATE_UNKNOWN = 0x0005 ; // unknown destination key /***********************************************************************************/ /* 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; }; /***********************************************************************************/ /* Specific packets */ /***********************************************************************************/ class RsGRouterPublishKeyItem: public RsGRouterItem { public: RsGRouterPublishKeyItem() : RsGRouterItem(RS_PKT_SUBTYPE_GROUTER_PUBLISH_KEY) { setPriorityLevel(QOS_PRIORITY_RS_GROUTER_PUBLISH_KEY) ; } 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 // GRouterKeyPropagationId diffusion_id ; GRouterKeyId published_key ; uint32_t service_id ; float randomized_distance ; std::string description_string ; }; class RsGRouterGenericDataItem: public RsGRouterItem { public: RsGRouterGenericDataItem() : RsGRouterItem(RS_PKT_SUBTYPE_GROUTER_DATA) { setPriorityLevel(QOS_PRIORITY_RS_GROUTER_DATA) ; } virtual ~RsGRouterGenericDataItem() { free(data_bytes); data_bytes=NULL;} 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) ; RsGRouterGenericDataItem *duplicate() const ; // packet data // GRouterMsgPropagationId routing_id ; GRouterKeyId destination_key ; uint32_t data_size ; uint8_t *data_bytes; }; class RsGRouterACKItem: public RsGRouterItem { public: RsGRouterACKItem() : RsGRouterItem(RS_PKT_SUBTYPE_GROUTER_ACK) { setPriorityLevel(QOS_PRIORITY_RS_GROUTER_ACK) ; } 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 uint32_t state ; // packet was delivered, not delivered, bounced, etc }; /***********************************************************************************/ /* 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: RsGRouterItem *deserialise_RsGRouterPublishKeyItem(void *data,uint32_t size) const ; RsGRouterItem *deserialise_RsGRouterGenericDataItem(void *data,uint32_t size) const ; RsGRouterItem *deserialise_RsGRouterACKItem(void *data,uint32_t size) const ; };