net::i2p_address Class Reference

b32 i2p address; internal format not condensed/decoded. More...

#include <i2p_address.h>

Public Member Functions
	i2p_address () noexcept
	An object with port() == 0 and host_str() == unknown_str().
bool	_load (epee::serialization::portable_storage &src, epee::serialization::section *hparent)
	Load from epee p2p format, and.
bool	store (epee::serialization::portable_storage &dest, epee::serialization::section *hparent) const
	Store in epee p2p format.
	i2p_address (const i2p_address &rhs) noexcept
	~i2p_address ()=default
i2p_address &	operator= (const i2p_address &rhs) noexcept
bool	is_unknown () const noexcept
bool	equal (const i2p_address &rhs) const noexcept
bool	less (const i2p_address &rhs) const noexcept
bool	is_same_host (const i2p_address &rhs) const noexcept
std::string	str () const
const char *	host_str () const noexcept
std::uint16_t	port () const noexcept
bool	is_blockable () const noexcept

Static Public Member Functions
static constexpr std::size_t	buffer_size () noexcept
static const char *	unknown_str () noexcept
static i2p_address	unknown () noexcept
static expect< i2p_address >	make (boost::string_ref address, std::uint16_t default_port=0)
static constexpr bool	is_loopback () noexcept
static constexpr bool	is_local () noexcept
static constexpr epee::net_utils::address_type	get_type_id () noexcept
static constexpr epee::net_utils::zone	get_zone () noexcept

Detailed Description

b32 i2p address; internal format not condensed/decoded.

Definition at line 51 of file i2p_address.h.

Constructor & Destructor Documentation

i2p_address() [1/2]

net::i2p_address::i2p_address ( )

noexcept

An object with port() == 0 and host_str() == unknown_str().

Definition at line 99 of file i2p_address.cpp.

      : port_(0)
    {
        static_assert(sizeof(unknown_host) <= sizeof(host_), "bad buffer size");
        std::memcpy(host_, unknown_host, sizeof(unknown_host));
        std::memset(host_ + sizeof(unknown_host), 0, sizeof(host_) - sizeof(unknown_host));
    }

i2p_address() [2/2]

net::i2p_address::i2p_address ( const i2p_address & rhs )

noexcept

Definition at line 145 of file i2p_address.cpp.

      : port_(rhs.port_)
    {
        std::memcpy(host_, rhs.host_, sizeof(host_));
    }

~i2p_address()

net::i2p_address::~i2p_address ( )

default

Here is the call graph for this function:

Member Function Documentation

_load()

bool net::i2p_address::_load	(	epee::serialization::portable_storage &	src,
		epee::serialization::section *	hparent )

Load from epee p2p format, and.

Returns

false if not valid tor address

Definition at line 123 of file i2p_address.cpp.

    {
        i2p_serialized in{};
        if (in._load(src, hparent) && in.host.size() < sizeof(host_) && (in.host == unknown_host || !host_check(in.host).has_error()))
        {
            std::memcpy(host_, in.host.data(), in.host.size());
            std::memset(host_ + in.host.size(), 0, sizeof(host_) - in.host.size());
            port_ = in.port;
            return true;
        }
        static_assert(sizeof(unknown_host) <= sizeof(host_), "bad buffer size");
        std::memcpy(host_, unknown_host, sizeof(unknown_host)); // include null terminator
        port_ = 0;
        return false;
    }

buffer_size()

constexpr std::size_t net::i2p_address::buffer_size ( )

inlinestaticconstexprnoexcept

Returns

Size of internal buffer for host.

Definition at line 61 of file i2p_address.h.

{ return sizeof(host_); }

Here is the caller graph for this function:

equal()

bool net::i2p_address::equal ( const i2p_address & rhs ) const

noexcept

Definition at line 167 of file i2p_address.cpp.

    {
        return port_ == rhs.port_ && is_same_host(rhs);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

get_type_id()

constexpr epee::net_utils::address_type net::i2p_address::get_type_id ( )

inlinestaticconstexprnoexcept

Definition at line 112 of file i2p_address.h.

        {
            return epee::net_utils::address_type::i2p;
        }

Here is the caller graph for this function:

get_zone()

constexpr epee::net_utils::zone net::i2p_address::get_zone ( )

inlinestaticconstexprnoexcept

Definition at line 117 of file i2p_address.h.

        {
            return epee::net_utils::zone::i2p;
        }

host_str()

const char * net::i2p_address::host_str ( ) const

inlinenoexcept

Returns

Null-terminated x.b32.i2p value or unknown_str().

Definition at line 104 of file i2p_address.h.

{ return host_; }

Here is the call graph for this function:

Here is the caller graph for this function:

is_blockable()

bool net::i2p_address::is_blockable ( ) const

inlinenoexcept

Returns

!is_unknown().

Definition at line 123 of file i2p_address.h.

{ return !is_unknown(); }

Here is the call graph for this function:

is_local()

constexpr bool net::i2p_address::is_local ( )

inlinestaticconstexprnoexcept

Definition at line 110 of file i2p_address.h.

{ return false; }

is_loopback()

constexpr bool net::i2p_address::is_loopback ( )

inlinestaticconstexprnoexcept

Definition at line 109 of file i2p_address.h.

{ return false; }

is_same_host()

bool net::i2p_address::is_same_host ( const i2p_address & rhs ) const

noexcept

Returns

True if i2p addresses are identical.

Definition at line 177 of file i2p_address.cpp.

    {
        return std::strcmp(host_str(), rhs.host_str()) == 0;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

is_unknown()

bool net::i2p_address::is_unknown ( ) const

noexcept

Returns

True if default constructed or via unknown().

Definition at line 161 of file i2p_address.cpp.

    {
        static_assert(1 <= sizeof(host_), "host size too small");
        return host_[0] == '<'; // character is not allowed otherwise
    }

Here is the caller graph for this function:

less()

bool net::i2p_address::less ( const i2p_address & rhs ) const

noexcept

Definition at line 172 of file i2p_address.cpp.

    {
        return std::strcmp(host_str(), rhs.host_str()) < 0 || port() < rhs.port();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

make()

expect< i2p_address > net::i2p_address::make ( boost::string_ref address, std::uint16_t default_port = 0 )

static

Parse address in b32 i2p format (i.e. x.b32.i2p:80) with default_port being used if port is not specified in address.

Definition at line 107 of file i2p_address.cpp.

    {
        boost::string_ref host = address.substr(0, address.rfind(':'));
        const boost::string_ref port =
            address.substr(host.size() + (host.size() == address.size() ? 0 : 1));
 
        ELECTRONEUM_CHECK(host_check(host));
 
        std::uint16_t porti = default_port;
        if (!port.empty() && !epee::string_tools::get_xtype_from_string(porti, std::string{port}))
            return {net::error::invalid_port};
 
        static_assert(b32_length + sizeof(tld) == sizeof(i2p_address::host_), "bad internal host size");
        return i2p_address{host, porti};
    }

Here is the call graph for this function:

Here is the caller graph for this function:

operator=()

i2p_address & net::i2p_address::operator= ( const i2p_address & rhs )

noexcept

Definition at line 151 of file i2p_address.cpp.

    {
        if (this != std::addressof(rhs))
        {
            port_ = rhs.port_;
            std::memcpy(host_, rhs.host_, sizeof(host_));
        }
        return *this;
    }

port()

std::uint16_t net::i2p_address::port ( ) const

inlinenoexcept

Returns

Port value or 0 if unspecified.

Definition at line 107 of file i2p_address.h.

{ return port_; }

Here is the caller graph for this function:

store()

bool net::i2p_address::store	(	epee::serialization::portable_storage &	dest,
		epee::serialization::section *	hparent ) const

Store in epee p2p format.

Definition at line 139 of file i2p_address.cpp.

    {
        const i2p_serialized out{std::string{host_}, port_};
        return out.store(dest, hparent);
    }

str()

std::string net::i2p_address::str

(

)

const

Returns

x.b32.i2p or x.b32.i2p:z if port() != 0.

Definition at line 182 of file i2p_address.cpp.

    {
        const std::size_t host_length = std::strlen(host_str());
        const std::size_t port_length =
            port_ == 0 ? 0 : std::numeric_limits<std::uint16_t>::digits10 + 2;
 
        std::string out{};
        out.reserve(host_length + port_length);
        out.assign(host_str(), host_length);
 
        if (port_ != 0)
        {
            out.push_back(':');
            namespace karma = boost::spirit::karma;
            karma::generate(std::back_inserter(out), karma::ushort_, port());
        }
        return out;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

unknown()

i2p_address net::i2p_address::unknown ( )

inlinestaticnoexcept

Returns

A default constructed i2p_address object.

Definition at line 70 of file i2p_address.h.

{ return i2p_address{}; }

Here is the call graph for this function:

Here is the caller graph for this function:

unknown_str()

const char * net::i2p_address::unknown_str ( )

staticnoexcept

Returns

<unknown tor host>.

Definition at line 94 of file i2p_address.cpp.

    {
        return unknown_host;
    }

Here is the caller graph for this function:

---

The documentation for this class was generated from the following files:

• /home/abuild/rpmbuild/BUILD/electroneum-5.1.3.1-build/electroneum-5.1.3.1/src/net/i2p_address.h
• /home/abuild/rpmbuild/BUILD/electroneum-5.1.3.1-build/electroneum-5.1.3.1/src/net/i2p_address.cpp