#pragma once #include "message.hpp" #include "session.hpp" namespace message { namespace parser { constexpr size_t RMCP_VERSION = 6; // RMCP Messages with class=IPMI should be sent with an RMCP Sequence // Number of FFh to indicate that an RMCP ACK message should not be // generated by the message receiver. constexpr size_t RMCP_SEQ = 0xFF; // RMCP Message Class 7h is for IPMI constexpr size_t RMCP_MESSAGE_CLASS_IPMI = 7; // RMCP Session Header Size constexpr size_t RMCP_SESSION_HEADER_SIZE = 4; // Maximum payload size constexpr size_t MAX_PAYLOAD_SIZE = 255; enum class SessionHeader { IPMI15 = 0x00, IPMI20 = 0x06, INVALID = 0xFF, }; struct BasicHeader_t { // RMCP Header uint8_t version; uint8_t reserved; uint8_t rmcpSeqNum; uint8_t classOfMsg; // IPMI partial session header union { uint8_t reserved1 : 4; uint8_t authType : 4; uint8_t formatType; } format; } __attribute__((packed)); /** * @brief Unflatten an incoming packet and prepare the IPMI message * * @param[in] inPacket - Incoming IPMI packet * * @return A tuple with IPMI message and the session header type to sent the * response packet. In case of success incoming message and session * header type. In case of failure nullptr and session header type * would be invalid. */ std::tuple, SessionHeader> unflatten(std::vector& inPacket); /** * @brief Flatten an IPMI message and generate the IPMI packet with the * session header * * @param[in] outMessage - IPMI message to be flattened * @param[in] authType - Session header type to be added to the IPMI * packet * * @return IPMI packet on success */ std::vector flatten(std::shared_ptr outMessage, SessionHeader authType, std::shared_ptr session); } // namespace parser namespace ipmi15parser { struct SessionHeader_t { struct parser::BasicHeader_t base; uint32_t sessSeqNum; uint32_t sessId; // uint8_t payloadLength; } __attribute__((packed)); struct SessionTrailer_t { uint8_t legacyPad; } __attribute__((packed)); /** * @brief Unflatten an incoming packet and prepare the IPMI message * * @param[in] inPacket - Incoming IPMI packet * * @return IPMI message in the packet on success */ std::shared_ptr unflatten(std::vector& inPacket); /** * @brief Flatten an IPMI message and generate the IPMI packet with the * session header * * @param[in] outMessage - IPMI message to be flattened * * @return IPMI packet on success */ std::vector flatten(std::shared_ptr outMessage, std::shared_ptr session); } // namespace ipmi15parser namespace ipmi20parser { constexpr size_t MAX_INTEGRITY_DATA_LENGTH = 12; constexpr size_t PAYLOAD_ENCRYPT_MASK = 0x80; constexpr size_t PAYLOAD_AUTH_MASK = 0x40; struct SessionHeader_t { struct parser::BasicHeader_t base; uint8_t payloadType; uint32_t sessId; uint32_t sessSeqNum; uint16_t payloadLength; } __attribute__((packed)); struct SessionTrailer_t { // Integrity Pad uint8_t padLength; uint8_t nextHeader; } __attribute__((packed)); /** * @brief Unflatten an incoming packet and prepare the IPMI message * * @param[in] inPacket - Incoming IPMI packet * * @return IPMI message in the packet on success */ std::shared_ptr unflatten(std::vector& inPacket); /** * @brief Flatten an IPMI message and generate the IPMI packet with the * session header * * @param[in] outMessage - IPMI message to be flattened * * @return IPMI packet on success */ std::vector flatten(std::shared_ptr outMessage, std::shared_ptr session); namespace internal { /** * @brief Add sequence number to the message * * @param[in] packet - outgoing packet to which to add sequence number * @param[in] session - session handle * */ void addSequenceNumber(std::vector& packet, std::shared_ptr session); /** * @brief Verify the integrity data of the incoming IPMI packet * * @param[in] packet - Incoming IPMI packet * @param[in] message - IPMI Message populated from the incoming packet * @param[in] payloadLen - Length of the IPMI payload * */ bool verifyPacketIntegrity(const std::vector& packet, const std::shared_ptr message, size_t payloadLen); /** * @brief Add Integrity data to the outgoing IPMI packet * * @param[in] packet - Outgoing IPMI packet * @param[in] message - IPMI Message populated for the outgoing packet * @param[in] payloadLen - Length of the IPMI payload */ void addIntegrityData(std::vector& packet, const std::shared_ptr message, size_t payloadLen); /** * @brief Decrypt the encrypted payload in the incoming IPMI packet * * @param[in] packet - Incoming IPMI packet * @param[in] message - IPMI Message populated from the incoming packet * @param[in] payloadLen - Length of encrypted IPMI payload * * @return on successful completion, return the plain text payload */ std::vector decryptPayload(const std::vector& packet, const std::shared_ptr message, size_t payloadLen); /** * @brief Encrypt the plain text payload for the outgoing IPMI packet * * @param[in] message - IPMI Message populated for the outgoing packet * * @return on successful completion, return the encrypted payload */ std::vector encryptPayload(std::shared_ptr message); } // namespace internal } // namespace ipmi20parser } // namespace message