Kea: option6_iaprefix.cc Source File

| Kea 3.0.3-git

option6_iaprefix.cc
Go to the documentation of this file.
1// Copyright (C) 2013-2025 Internet Systems Consortium, Inc. ("ISC")
2//
3// This Source Code Form is subject to the terms of the Mozilla Public
4// License, v. 2.0. If a copy of the MPL was not distributed with this
5// file, You can obtain one at http://mozilla.org/MPL/2.0/.
6
7#include <config.h>
8
9#include <asiolink/io_address.h>
10#include <dhcp/dhcp6.h>
11#include <dhcp/libdhcp++.h>
12#include <dhcp/option6_iaprefix.h>
13#include <dhcp/option_space.h>
14#include <exceptions/exceptions.h>
15#include <util/io.h>
16
17#include <sstream>
18
19#include <stdint.h>
20#include <arpa/inet.h>
21
22using namespace std;
23using namespace isc::asiolink;
24using namespace isc::util;
25
26namespace isc {
27namespace dhcp {
28
29Option6IAPrefix::Option6IAPrefix(uint16_t type, const isc::asiolink::IOAddress& prefix,
30 uint8_t prefix_len, uint32_t pref, uint32_t valid)
31 :Option6IAAddr(type, prefix, pref, valid), prefix_len_(prefix_len) {
32 setEncapsulatedSpace(DHCP6_OPTION_SPACE);
33 // Option6IAAddr will check if prefix is IPv6 and will throw if it is not
34 if (prefix_len > 128) {
35 isc_throw(BadValue, static_cast<unsigned>(prefix_len)
36 << " is not a valid prefix length. "
37 << "Allowed range is 0..128");
38 }
39}
40
41 Option6IAPrefix::Option6IAPrefix(uint32_t type, OptionBuffer::const_iterator begin,
42 OptionBuffer::const_iterator end)
43 :Option6IAAddr(type, begin, end) {
44 setEncapsulatedSpace(DHCP6_OPTION_SPACE);
45 unpack(begin, end);
46}
47
48 OptionPtr
49Option6IAPrefix::clone() const {
50 return (cloneInternal<Option6IAPrefix>());
51}
52
53 void Option6IAPrefix::pack(isc::util::OutputBuffer& buf, bool) const {
54 if (!addr_.isV6()) {
55 isc_throw(isc::BadValue, addr_ << " is not an IPv6 address");
56 }
57
58 buf.writeUint16(type_);
59
60 // len() returns complete option length. len field contains
61 // length without 4-byte option header
62 buf.writeUint16(len() - getHeaderLen());
63
64 buf.writeUint32(preferred_);
65 buf.writeUint32(valid_);
66 buf.writeUint8(prefix_len_);
67
68 buf.writeData(&addr_.toBytes()[0], isc::asiolink::V6ADDRESS_LEN);
69
70 // store encapsulated options (the only defined so far is PD_EXCLUDE)
71 packOptions(buf);
72}
73
74 void Option6IAPrefix::unpack(OptionBuffer::const_iterator begin,
75 OptionBuffer::const_iterator end) {
76 if (static_cast<size_t>(distance(begin, end)) < OPTION6_IAPREFIX_LEN) {
77 isc_throw(OutOfRange, "Option " << type_ << " truncated");
78 }
79
80 preferred_ = readUint32(&(*begin), distance(begin, end));
81 begin += sizeof(uint32_t);
82
83 valid_ = readUint32(&(*begin), distance(begin, end));
84 begin += sizeof(uint32_t);
85
86 prefix_len_ = *begin;
87 begin += sizeof(uint8_t);
88
89 // 16 bytes: IPv6 address
90 OptionBuffer address_with_mask;
91 mask(begin, begin + V6ADDRESS_LEN, prefix_len_, address_with_mask);
92 addr_ = IOAddress::fromBytes(AF_INET6, &(*address_with_mask.begin()));
93 begin += V6ADDRESS_LEN;
94
95 // unpack encapsulated options (the only defined so far is PD_EXCLUDE)
96 unpackOptions(OptionBuffer(begin, end));
97}
98
99std::string Option6IAPrefix::toText(int indent) const {
100 std::stringstream output;
101 output << headerToText(indent, "IAPREFIX") << ": "
102 << "prefix=" << addr_ << "/" << static_cast<int>(prefix_len_)
103 << ", preferred-lft=" << preferred_
104 << ", valid-lft=" << valid_;
105
106 output << suboptionsToText(indent + 2);
107 return (output.str());
108}
109
110uint16_t Option6IAPrefix::len() const {
111
112 uint16_t length = OPTION6_HDR_LEN + OPTION6_IAPREFIX_LEN;
113
114 // length of all suboptions
115 for (auto const& it : options_) {
116 length += it.second->len();
117 }
118 return (length);
119}
120
121void
122Option6IAPrefix::mask(OptionBuffer::const_iterator begin,
123 OptionBuffer::const_iterator end,
124 const uint8_t len,
125 OptionBuffer& output_address) const {
126 output_address.resize(16, 0);
127 if (len >= 128) {
128 std::copy(begin, end, output_address.begin());
129 } else if (len > 0) {
130 // All the bits that represent whole octets of the prefix are copied with
131 // no change.
132 std::copy(begin, begin + static_cast<uint8_t>(len/8), output_address.begin());
133 // The remaining significant bits of the last octet have to be left unchanged,
134 // but the remaining bits of this octet must be set to zero. The number of
135 // significant bits is calculated as a reminder from the division of the
136 // prefix length by 8 (by size of the octet). The number of bits to be set
137 // to zero is therefore calculated as: 8 - (len % 8).
138 // Next, the mask is created by shifting the 0xFF by the number of bits
139 // to be set to 0. By performing logical AND of this mask with the original
140 // value of the last octet we get the final value for the new octet.
141 output_address[len/8] = (*(begin + len/8) & (0xFF << (8 - (len % 8))));
142 }
143}
144
145
146} // end of namespace isc::dhcp
147} // end of namespace isc
isc::BadValue
A generic exception that is thrown if a parameter given to a method is considered invalid in that con...
Definition exceptions/exceptions.h:132
isc::OutOfRange
A generic exception that is thrown if a parameter given to a method would refer to or modify out-of-r...
Definition exceptions/exceptions.h:115
isc::asiolink::IOAddress
The IOAddress class represents an IP addresses (version agnostic).
Definition io_address.h:45
isc::asiolink::IOAddress::fromBytes
static IOAddress fromBytes(short family, const uint8_t *data)
Creates an address from over wire data.
Definition io_address.cc:65
isc::dhcp::Option6IAAddr::valid_
unsigned int valid_
contains valid-lifetime timer (in seconds)
Definition option6_iaaddr.h:123
isc::dhcp::Option6IAAddr::Option6IAAddr
Option6IAAddr(uint16_t type, const isc::asiolink::IOAddress &addr, uint32_t preferred, uint32_t valid)
Constructor, used for options constructed (during transmission).
Definition option6_iaaddr.cc:29
isc::dhcp::Option6IAAddr::addr_
isc::asiolink::IOAddress addr_
contains an IPv6 address
Definition option6_iaaddr.h:117
isc::dhcp::Option6IAAddr::preferred_
unsigned int preferred_
contains preferred-lifetime timer (in seconds)
Definition option6_iaaddr.h:120
isc::dhcp::Option6IAPrefix::OPTION6_IAPREFIX_LEN
static const size_t OPTION6_IAPREFIX_LEN
length of the fixed part of the IAPREFIX option
Definition option6_iaprefix.h:55
isc::dhcp::Option6IAPrefix::toText
virtual std::string toText(int indent=0) const
Returns string representation of the option.
Definition option6_iaprefix.cc:99
isc::dhcp::Option6IAPrefix::unpack
virtual void unpack(OptionBufferConstIter begin, OptionBufferConstIter end)
Parses received buffer.
Definition option6_iaprefix.cc:74
isc::dhcp::Option6IAPrefix::Option6IAPrefix
Option6IAPrefix(uint16_t type, const isc::asiolink::IOAddress &addr, uint8_t prefix_length, uint32_t preferred, uint32_t valid)
Constructor, used for options constructed (during transmission).
Definition option6_iaprefix.cc:29
isc::dhcp::Option6IAPrefix::clone
virtual OptionPtr clone() const
Copies this option and returns a pointer to the copy.
Definition option6_iaprefix.cc:49
isc::dhcp::Option6IAPrefix::len
virtual uint16_t len() const
returns data length (data length + DHCPv4/DHCPv6 option header)
Definition option6_iaprefix.cc:110
isc::dhcp::Option6IAPrefix::pack
void pack(isc::util::OutputBuffer &buf, bool check=true) const
Writes option in wire-format.
Definition option6_iaprefix.cc:53
isc::dhcp::Option::type_
uint16_t type_
option type (0-255 for DHCPv4, 0-65535 for DHCPv6)
Definition option.h:597
isc::dhcp::Option::headerToText
std::string headerToText(const int indent=0, const std::string &type_name="") const
Returns option header in the textual format.
Definition option.cc:294
isc::dhcp::Option::suboptionsToText
std::string suboptionsToText(const int indent=0) const
Returns collection of suboptions in the textual format.
Definition option.cc:313
isc::dhcp::Option::setEncapsulatedSpace
void setEncapsulatedSpace(const std::string &encapsulated_space)
Sets the name of the option space encapsulated by this option.
Definition option.h:442
isc::dhcp::Option::getHeaderLen
virtual uint16_t getHeaderLen() const
Returns length of header (2 for v4, 4 for v6).
Definition option.cc:327
isc::dhcp::Option::unpackOptions
void unpackOptions(const OptionBuffer &buf)
Builds a collection of sub options from the buffer.
Definition option.cc:155
isc::dhcp::Option::packOptions
void packOptions(isc::util::OutputBuffer &buf, bool check=true) const
Store sub options in a buffer.
Definition option.cc:136
isc::dhcp::Option::OPTION6_HDR_LEN
static const size_t OPTION6_HDR_LEN
length of any DHCPv6 option header
Definition option.h:87
isc::dhcp::Option::valid
virtual bool valid() const
returns if option is valid (e.g.
Definition option.cc:190
isc::dhcp::Option::options_
OptionCollection options_
collection for storing suboptions
Definition option.h:603
isc::dhcp::Option::cloneInternal
OptionPtr cloneInternal() const
Copies this option and returns a pointer to the copy.
Definition option.h:504
isc::util::OutputBuffer
The OutputBuffer class is a buffer abstraction for manipulating mutable data.
Definition buffer.h:346
isc::util::OutputBuffer::writeUint8
void writeUint8(uint8_t data)
Write an unsigned 8-bit integer into the buffer.
Definition buffer.h:476
isc::util::OutputBuffer::writeUint16
void writeUint16(uint16_t data)
Write an unsigned 16-bit integer in host byte order into the buffer in network byte order.
Definition buffer.h:501
isc::util::OutputBuffer::writeData
void writeData(const void *data, size_t len)
Copy an arbitrary length of data into the buffer.
Definition buffer.h:559
isc::util::OutputBuffer::writeUint32
void writeUint32(uint32_t data)
Write an unsigned 32-bit integer in host byte order into the buffer in network byte order.
Definition buffer.h:531
dhcp6.h
exceptions.h
isc_throw
#define isc_throw(type, stream)
A shortcut macro to insert known values into exception arguments.
Definition exceptions/exceptions.h:210
io.h
io_address.h
libdhcp++.h
isc::asiolink
Definition addr_utilities.cc:170
isc::dhcp
Definition dhcp4/client_handler.cc:20
isc::dhcp::OptionBuffer
std::vector< uint8_t > OptionBuffer
buffer types used in DHCP code.
Definition option.h:24
isc::dhcp::OptionPtr
boost::shared_ptr< Option > OptionPtr
Definition option.h:37
isc::util
Definition time_utils.cc:43
isc::util::readUint32
uint32_t readUint32(void const *const buffer, size_t const length)
uint32_t wrapper over readUint.
Definition io.h:82
isc
Defines the logger used by the top-level component of kea-lfc.
Definition agent_parser.cc:148
option6_iaprefix.h
option_space.h
DHCP6_OPTION_SPACE
#define DHCP6_OPTION_SPACE
Definition std_option_defs.h:17