364 lines
9.6 KiB
C++
364 lines
9.6 KiB
C++
/*
|
|
* Copyright (c) 2017, Matias Fontanini
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are
|
|
* met:
|
|
*
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* * Redistributions in binary form must reproduce the above
|
|
* copyright notice, this list of conditions and the following disclaimer
|
|
* in the documentation and/or other materials provided with the
|
|
* distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
*/
|
|
|
|
#ifndef TINS_BOOTP_H
|
|
#define TINS_BOOTP_H
|
|
|
|
#include <stdint.h>
|
|
#include <vector>
|
|
#include <tins/pdu.h>
|
|
#include <tins/macros.h>
|
|
#include <tins/endianness.h>
|
|
#include <tins/ip_address.h>
|
|
#include <tins/hw_address.h>
|
|
|
|
namespace Tins {
|
|
|
|
/**
|
|
* \class BootP
|
|
* \brief Represents a BootP PDU
|
|
*/
|
|
class TINS_API BootP : public PDU {
|
|
public:
|
|
/**
|
|
* The type of the IP addresses.
|
|
*/
|
|
typedef IPv4Address ipaddress_type;
|
|
|
|
/**
|
|
* The type of the chaddr field.
|
|
*/
|
|
typedef HWAddress<16> chaddr_type;
|
|
|
|
/**
|
|
* The type of the vend field.
|
|
*/
|
|
typedef std::vector<uint8_t> vend_type;
|
|
|
|
/**
|
|
* \brief This PDU's flag.
|
|
*/
|
|
static const PDU::PDUType pdu_flag = PDU::BOOTP;
|
|
|
|
/**
|
|
* \brief Enum which contains the different opcodes BootP messages.
|
|
*/
|
|
enum OpCodes {
|
|
BOOTREQUEST = 1,
|
|
BOOTREPLY = 2
|
|
};
|
|
|
|
/**
|
|
* \brief Creates an instance of BootP.
|
|
*
|
|
* This sets the size of the vend field to 64, as the BootP RFC
|
|
* states.
|
|
*/
|
|
BootP();
|
|
|
|
/**
|
|
* \brief Constructs a BootP object from a buffer .
|
|
*
|
|
* If there's not enough size for a BootP header, then a
|
|
* malformed_packet exception is thrown.
|
|
*
|
|
* \param buffer The buffer from which this PDU will be constructed.
|
|
* \param total_sz The total size of the buffer.
|
|
* \param vend_field_size The vend field size to allocate.
|
|
* Subclasses might use 0 to provide their own interpretation of this field.
|
|
*/
|
|
BootP(const uint8_t* buffer, uint32_t total_sz, uint32_t vend_field_size = 64);
|
|
|
|
/* Getters */
|
|
|
|
/**
|
|
* \brief Getter for the opcode field.
|
|
* \return The opcode field for this BootP PDU.
|
|
*/
|
|
uint8_t opcode() const { return bootp_.opcode; }
|
|
|
|
/**
|
|
* \brief Getter for the htype field.
|
|
* \return The htype field for this BootP PDU.
|
|
*/
|
|
uint8_t htype() const { return bootp_.htype; }
|
|
|
|
/**
|
|
* \brief Getter for the hlen field.
|
|
* \return The hlen field for this BootP PDU.
|
|
*/
|
|
uint8_t hlen() const { return bootp_.hlen; }
|
|
|
|
/**
|
|
* \brief Getter for the hops field.
|
|
* \return The hops field for this BootP PDU.
|
|
*/
|
|
uint8_t hops() const { return bootp_.hops; }
|
|
|
|
/**
|
|
* \brief Getter for the xid field.
|
|
* \return The xid field for this BootP PDU.
|
|
*/
|
|
uint32_t xid() const { return Endian::be_to_host(bootp_.xid); }
|
|
|
|
/**
|
|
* \brief Getter for the secs field.
|
|
* \return The secs field for this BootP PDU.
|
|
*/
|
|
uint16_t secs() const { return Endian::be_to_host(bootp_.secs); }
|
|
|
|
/** \brief Getter for the padding field.
|
|
* \return The padding field for this BootP PDU.
|
|
*/
|
|
uint16_t padding() const { return Endian::be_to_host(bootp_.padding); }
|
|
|
|
/**
|
|
* \brief Getter for the ciaddr field.
|
|
* \return The ciaddr field for this BootP PDU.
|
|
*/
|
|
ipaddress_type ciaddr() const { return ipaddress_type(bootp_.ciaddr); }
|
|
|
|
/**
|
|
* \brief Getter for the yiaddr field.
|
|
* \return The yiaddr field for this BootP PDU.
|
|
*/
|
|
ipaddress_type yiaddr() const { return ipaddress_type(bootp_.yiaddr); }
|
|
|
|
/**
|
|
* \brief Getter for the siaddr field.
|
|
* \return The siaddr field for this BootP PDU.
|
|
*/
|
|
ipaddress_type siaddr() const { return ipaddress_type(bootp_.siaddr); }
|
|
|
|
/**
|
|
* \brief Getter for the giaddr field.
|
|
* \return The giaddr field for this BootP PDU.
|
|
*/
|
|
ipaddress_type giaddr() const { return ipaddress_type(bootp_.giaddr); }
|
|
|
|
/**
|
|
* \brief Getter for the chaddr field.
|
|
* \return The chddr field for this BootP PDU.
|
|
*/
|
|
chaddr_type chaddr() const { return bootp_.chaddr; }
|
|
|
|
/**
|
|
* \brief Getter for the sname field.
|
|
* \return The sname field for this BootP PDU.
|
|
*/
|
|
const uint8_t* sname() const { return bootp_.sname; }
|
|
|
|
/**
|
|
* \brief Getter for the file field.
|
|
* \return The file field for this BootP PDU.
|
|
*/
|
|
const uint8_t* file() const { return bootp_.file; }
|
|
|
|
/**
|
|
* \brief Getter for the vend field.
|
|
* \return The vend field for this BootP PDU.
|
|
*/
|
|
const vend_type& vend() const { return vend_; }
|
|
|
|
/**
|
|
* \brief Getter for the header size.
|
|
* \return Returns the BOOTP header size.
|
|
* \sa PDU::header_size
|
|
*/
|
|
uint32_t header_size() const;
|
|
/* Setters */
|
|
|
|
/**
|
|
* \brief Setter for the opcode field.
|
|
* \param code The opcode to be set.
|
|
*/
|
|
void opcode(uint8_t code);
|
|
|
|
/**
|
|
* \brief Setter for the hardware type field.
|
|
* \param type The hardware type field value to be set.
|
|
*/
|
|
void htype(uint8_t type);
|
|
|
|
/**
|
|
* \brief Setter for the hlen field.
|
|
* \param length The hlen field value to be set.
|
|
*/
|
|
void hlen(uint8_t length);
|
|
|
|
/**
|
|
* \brief Setter for the hops field.
|
|
* \param count The hops field value to be set.
|
|
*/
|
|
void hops(uint8_t count);
|
|
|
|
/**
|
|
* \brief Setter for the xid field.
|
|
* \param identifier The xid to be set.
|
|
*/
|
|
void xid(uint32_t identifier);
|
|
|
|
/**
|
|
* \brief Setter for the secs field.
|
|
* \param value The secs to be set.
|
|
*/
|
|
void secs(uint16_t value);
|
|
|
|
/**
|
|
* \brief Setter for the padding field.
|
|
* \param value The padding to be set.
|
|
*/
|
|
void padding(uint16_t value);
|
|
|
|
/**
|
|
* \brief Setter for the ciaddr field.
|
|
* \param address The ciaddr to be set.
|
|
*/
|
|
void ciaddr(ipaddress_type address);
|
|
|
|
/**
|
|
* \brief Setter for the yiaddr field.
|
|
* \param address The yiaddr to be set.
|
|
*/
|
|
void yiaddr(ipaddress_type address);
|
|
|
|
/**
|
|
* \brief Setter for the siaddr field.
|
|
* \param address The siaddr to be set.
|
|
*/
|
|
void siaddr(ipaddress_type address);
|
|
|
|
/**
|
|
* \brief Setter for the giaddr field.
|
|
* \param address The giaddr to be set.
|
|
*/
|
|
void giaddr(ipaddress_type address);
|
|
|
|
/**
|
|
* \brief Setter for the chaddr field.
|
|
* The new_chaddr pointer must be at least BOOTP::hlen() bytes long.
|
|
* \param new_chaddr The chaddr to be set.
|
|
*/
|
|
template<size_t n>
|
|
void chaddr(const HWAddress<n>& new_chaddr) {
|
|
size_t copy_threshold = std::min(n, sizeof(bootp_.chaddr));
|
|
for (size_t i = 0; i < copy_threshold; ++i) {
|
|
if (i < copy_threshold) {
|
|
bootp_.chaddr[i] = new_chaddr[i];
|
|
}
|
|
else {
|
|
bootp_.chaddr[i] = 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* \brief Setter for the sname field.
|
|
* \param new_sname The sname to be set.
|
|
*/
|
|
void sname(const uint8_t* new_sname);
|
|
|
|
/**
|
|
* \brief Setter for the file field.
|
|
* \param new_file The file to be set.
|
|
*/
|
|
void file(const uint8_t* new_file);
|
|
|
|
/**
|
|
* \brief Setter for the vend field.
|
|
* \param newvend_ The vend to be set.
|
|
*/
|
|
void vend(const vend_type& newvend_);
|
|
|
|
/**
|
|
* \brief Check whether ptr points to a valid response for this PDU.
|
|
*
|
|
* This returns true if the xid field is equal.
|
|
*
|
|
* \sa PDU::matches_response
|
|
* \param ptr The pointer to the buffer.
|
|
* \param total_sz The size of the buffer.
|
|
*/
|
|
bool matches_response(const uint8_t* ptr, uint32_t total_sz) const;
|
|
|
|
/**
|
|
* \brief Getter for the PDU's type.
|
|
* \sa PDU::pdu_type
|
|
*/
|
|
PDUType pdu_type() const { return pdu_flag; }
|
|
|
|
/**
|
|
* \sa PDU::clone
|
|
*/
|
|
BootP* clone() const {
|
|
return new BootP(*this);
|
|
}
|
|
protected:
|
|
/**
|
|
* \brief Getter for the vend field.
|
|
*
|
|
* This getter can be used by subclasses to avoid copying the
|
|
* vend field around.
|
|
*
|
|
* \return The vend field for this BootP PDU.
|
|
*/
|
|
vend_type& vend() { return vend_; }
|
|
|
|
void write_serialization(uint8_t* buffer, uint32_t total_sz);
|
|
|
|
/**
|
|
* Struct that represents the Bootp datagram.
|
|
*/
|
|
TINS_BEGIN_PACK
|
|
struct bootp_header {
|
|
uint8_t opcode;
|
|
uint8_t htype;
|
|
uint8_t hlen;
|
|
uint8_t hops;
|
|
uint32_t xid;
|
|
uint16_t secs;
|
|
uint16_t padding;
|
|
uint32_t ciaddr;
|
|
uint32_t yiaddr;
|
|
uint32_t siaddr;
|
|
uint32_t giaddr;
|
|
uint8_t chaddr[16];
|
|
uint8_t sname[64];
|
|
uint8_t file[128];
|
|
} TINS_END_PACK;
|
|
|
|
private:
|
|
bootp_header bootp_;
|
|
vend_type vend_;
|
|
};
|
|
|
|
} // Tins
|
|
|
|
#endif // TINS_BOOTP_H
|