/* * Copyright (c) 2021 Cisco and/or its affiliates. * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at: * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #pragma once #include #include #include #include #include #include #include #include #include #include namespace transport { namespace auth { class Signer; class Verifier; } // namespace auth namespace core { /* * Basic IP packet, modelled as circular chain of buffers: * Header = H * Payload = P * * H_0 --> H_1 --> H_2 --> P_0 --> P_1 --> P_2 * \_______________________________________| */ class Packet : public utils::MemBuf, public std::enable_shared_from_this { friend class auth::Signer; friend class auth::Verifier; public: using Ptr = std::shared_ptr; using MemBufPtr = std::shared_ptr; using Format = hicn_format_t; static constexpr size_t default_mtu = 1500; /** * Create new IP packet. Here we allocate just the header, * the eventual payload will be added by prepending the payload buffer * to the buffer chain whose the fist buffer is the header itself. */ Packet(Format format, std::size_t additional_header_size = 0); /* Copy buffer */ Packet(CopyBufferOp, const uint8_t *buffer, std::size_t size); /* Wrap buffer */ Packet(WrapBufferOp, uint8_t *buffer, std::size_t length, std::size_t size); /* Create new using pre-allocated buffer */ Packet(CreateOp, uint8_t *buffer, std::size_t length, std::size_t size, Format format, std::size_t additional_header_size = 0); Packet(MemBuf &&buffer); Packet(Packet &&other); Packet(const Packet &other); // Destructor virtual ~Packet(); // Operators Packet &operator=(const Packet &other); friend bool operator==(const Packet &l_packet, const Packet &r_packet); // Cast to MemBuf std::shared_ptr acquireMemBufReference(); // Format Format getFormat() const; void setFormat(Packet::Format format, std::size_t additional_header_size = 0); // Name virtual const Name &getName() const = 0; virtual Name &getWritableName() = 0; virtual void setName(const Name &name) = 0; // Lifetime virtual void setLifetime(uint32_t lifetime) = 0; virtual uint32_t getLifetime() const = 0; // Locator virtual void setLocator(const ip_address_t &locator) = 0; virtual ip_address_t getLocator() const = 0; // Payload type PayloadType getPayloadType() const; Packet &setPayloadType(PayloadType payload_type); // Payload std::unique_ptr getPayload() const; Packet &appendPayload(std::unique_ptr &&payload); Packet &appendPayload(const uint8_t *buffer, std::size_t length); // Sizes std::size_t headerSize() const; std::size_t payloadSize() const; // Digest auth::CryptoHash computeDigest(auth::CryptoHashType algorithm) const; // Reset packet void reset(); // Utils bool isInterest(); Packet &updateLength(std::size_t length = 0); void dump() const; // TCP methods void setChecksum(); bool checkIntegrity() const; Packet &setSyn(); Packet &resetSyn(); bool testSyn() const; Packet &setAck(); Packet &resetAck(); bool testAck() const; Packet &setRst(); Packet &resetRst(); bool testRst() const; Packet &setFin(); Packet &resetFin(); bool testFin() const; Packet &resetFlags(); std::string printFlags() const; Packet &setSrcPort(uint16_t srcPort); Packet &setDstPort(uint16_t dstPort); uint16_t getSrcPort() const; uint16_t getDstPort() const; Packet &setTTL(uint8_t hops); uint8_t getTTL() const; // Authentication Header methods bool hasAH() const; std::vector getSignature() const; std::size_t getSignatureFieldSize() const; std::size_t getSignatureSize() const; uint64_t getSignatureTimestamp() const; auth::KeyId getKeyId() const; auth::CryptoSuite getValidationAlgorithm() const; void setSignature(const std::vector &signature); void setSignatureFieldSize(std::size_t size); void setSignatureSize(std::size_t size); void setSignatureTimestamp(const uint64_t ×tamp_ms); void setKeyId(const auth::KeyId &key_id); void setValidationAlgorithm(const auth::CryptoSuite &algo); // Static methods static Format toAHFormat(const Format &format); static Format getFormatFromBuffer(const uint8_t *buffer, std::size_t length); static std::size_t getHeaderSizeFromFormat(Format format, std::size_t signature_size = 0); static std::size_t getHeaderSizeFromBuffer(Format format, const uint8_t *buffer); static std::size_t getPayloadSizeFromBuffer(Format format, const uint8_t *buffer); static bool isInterest(const uint8_t *buffer, Format format = Format::HF_UNSPEC); static void dump(uint8_t *buffer, std::size_t length); private: virtual void resetForHash() = 0; void prependPayload(const uint8_t **buffer, std::size_t *size); protected: hicn_header_t *packet_start_; std::size_t header_offset_; mutable Format format_; Name name_; mutable PayloadType payload_type_; static const core::Name base_name; }; } // end namespace core } // end namespace transport