IP address (IPv6, or IPv4 using mapped IPv6 range (::FFFF:0:0/96)) More...

#include <netaddress.h>

Inheritance diagram for CNetAddr:

Public Member Functions
	CNetAddr ()
	Construct an unspecified IPv6 network address (::/128). More...

	CNetAddr (const struct in_addr &ipv4Addr)

void	SetIP (const CNetAddr &ip)

bool	SetInternal (const std::string &name)
	Try to make this a dummy address that maps the specified name into IPv6 like so: (0xFD + sha256("bitcoin")[0:5]) + sha256(name)[0:10]. More...

bool	SetSpecial (const std::string &strName)
	Try to make this a dummy address that maps the specified onion address into IPv6 using OnionCat's range and encoding. More...

bool	IsBindAny () const

bool	IsIPv4 () const

bool	IsIPv6 () const

bool	IsRFC1918 () const

bool	IsRFC2544 () const

bool	IsRFC6598 () const

bool	IsRFC5737 () const

bool	IsRFC3849 () const

bool	IsRFC3927 () const

bool	IsRFC3964 () const

bool	IsRFC4193 () const

bool	IsRFC4380 () const

bool	IsRFC4843 () const

bool	IsRFC7343 () const

bool	IsRFC4862 () const

bool	IsRFC6052 () const

bool	IsRFC6145 () const

bool	IsTor () const

bool	IsLocal () const

bool	IsRoutable () const

bool	IsInternal () const

bool	IsValid () const

enum Network	GetNetwork () const

std::string	ToString () const

std::string	ToStringIP () const

unsigned int	GetByte (int n) const

uint64_t	GetHash () const

bool	GetInAddr (struct in_addr *pipv4Addr) const
	Try to get our IPv4 address. More...

std::vector< unsigned char >	GetGroup () const
	Get the canonical identifier of our network group. More...

int	GetReachabilityFrom (const CNetAddr *paddrPartner=nullptr) const
	Calculates a metric for how reachable (*this) is from a given partner. More...

	CNetAddr (const struct in6_addr &pipv6Addr, const uint32_t scope=0)

bool	GetIn6Addr (struct in6_addr *pipv6Addr) const
	Try to get our IPv6 address. More...

template<typename Stream , typename Operation >
void	SerializationOp (Stream &s, Operation ser_action)

Public Attributes
	ADD_SERIALIZE_METHODS

Protected Attributes
unsigned char	ip [16]

uint32_t	scopeId {0}

Private Member Functions
void	SetRaw (Network network, const uint8_t *data)
	Set raw IPv4 or IPv6 address (in network byte order) More...

Friends
class	CSubNet

bool	operator== (const CNetAddr &a, const CNetAddr &b)

bool	operator!= (const CNetAddr &a, const CNetAddr &b)

bool	operator< (const CNetAddr &a, const CNetAddr &b)

Detailed Description

IP address (IPv6, or IPv4 using mapped IPv6 range (::FFFF:0:0/96))

Definition at line 32 of file netaddress.h.

Constructor & Destructor Documentation

◆ CNetAddr() [1/3]

CNetAddr::CNetAddr ( )

Construct an unspecified IPv6 network address (::/128).

Note: This address is considered invalid by CNetAddr::IsValid()

Definition at line 22 of file netaddress.cpp.

◆ CNetAddr() [2/3]

CNetAddr::CNetAddr ( const struct in_addr & ipv4Addr )

explicit

Definition at line 98 of file netaddress.cpp.

Here is the call graph for this function:

◆ CNetAddr() [3/3]

CNetAddr::CNetAddr	(	const struct in6_addr &	pipv6Addr,
		const uint32_t	scope = `0`
	)

explicit

Definition at line 103 of file netaddress.cpp.

Here is the call graph for this function:

Member Function Documentation

◆ GetByte()

unsigned int CNetAddr::GetByte ( int n ) const

Definition at line 109 of file netaddress.cpp.

Here is the caller graph for this function:

◆ GetGroup()

std::vector< unsigned char > CNetAddr::GetGroup ( ) const

Get the canonical identifier of our network group.

The groups are assigned in a way where it should be costly for an attacker to obtain addresses with many different group identifiers, even if it is cheap to obtain addresses with the same identifier.

Note: No two connections will be attempted to addresses with the same network group.

Definition at line 413 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetHash()

uint64_t CNetAddr::GetHash ( ) const

Definition at line 489 of file netaddress.cpp.

Here is the call graph for this function:

◆ GetIn6Addr()

bool CNetAddr::GetIn6Addr ( struct in6_addr * pipv6Addr ) const

Try to get our IPv6 address.

Parameters

[out] pipv6Addr The in6_addr struct to which to copy.

Returns: Whether or not the operation was successful, in particular, whether or not our address was an IPv6 address.

See also: CNetAddr::IsIPv6()

Definition at line 394 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetInAddr()

bool CNetAddr::GetInAddr ( struct in_addr * pipv4Addr ) const

Try to get our IPv4 address.

Parameters

[out] pipv4Addr The in_addr struct to which to copy.

Returns: Whether or not the operation was successful, in particular, whether or not our address was an IPv4 address.

See also: CNetAddr::IsIPv4()

Definition at line 376 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetNetwork()

enum Network CNetAddr::GetNetwork ( ) const

Definition at line 310 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetReachabilityFrom()

int CNetAddr::GetReachabilityFrom ( const CNetAddr * paddrPartner = nullptr ) const

Calculates a metric for how reachable (*this) is from a given partner.

Definition at line 511 of file netaddress.cpp.

Here is the call graph for this function:

◆ IsBindAny()

bool CNetAddr::IsBindAny ( ) const

Definition at line 114 of file netaddress.cpp.

Here is the call graph for this function:

◆ IsInternal()

bool CNetAddr::IsInternal ( ) const

Returns: Whether or not this is a dummy address that maps a name into IPv6.

See also: CNetAddr::SetInternal(const std::string &)

Definition at line 305 of file netaddress.cpp.

Here is the caller graph for this function:

◆ IsIPv4()

bool CNetAddr::IsIPv4 ( ) const

Definition at line 124 of file netaddress.cpp.

Here is the caller graph for this function:

◆ IsIPv6()

bool CNetAddr::IsIPv6 ( ) const

Definition at line 129 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsLocal()

bool CNetAddr::IsLocal ( ) const

Definition at line 223 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRFC1918()

bool CNetAddr::IsRFC1918 ( ) const

Definition at line 134 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRFC2544()

bool CNetAddr::IsRFC2544 ( ) const

Definition at line 142 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRFC3849()

bool CNetAddr::IsRFC3849 ( ) const

Definition at line 164 of file netaddress.cpp.

Here is the call graph for this function:

◆ IsRFC3927()

bool CNetAddr::IsRFC3927 ( ) const

Definition at line 147 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRFC3964()

bool CNetAddr::IsRFC3964 ( ) const

Definition at line 169 of file netaddress.cpp.

Here is the call graph for this function:

◆ IsRFC4193()

bool CNetAddr::IsRFC4193 ( ) const

Definition at line 191 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRFC4380()

bool CNetAddr::IsRFC4380 ( ) const

Definition at line 180 of file netaddress.cpp.

Here is the call graph for this function:

◆ IsRFC4843()

bool CNetAddr::IsRFC4843 ( ) const

Definition at line 202 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRFC4862()

bool CNetAddr::IsRFC4862 ( ) const

Definition at line 185 of file netaddress.cpp.

Here is the caller graph for this function:

◆ IsRFC5737()

bool CNetAddr::IsRFC5737 ( ) const

Definition at line 157 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRFC6052()

bool CNetAddr::IsRFC6052 ( ) const

Definition at line 174 of file netaddress.cpp.

◆ IsRFC6145()

bool CNetAddr::IsRFC6145 ( ) const

Definition at line 196 of file netaddress.cpp.

◆ IsRFC6598()

bool CNetAddr::IsRFC6598 ( ) const

Definition at line 152 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRFC7343()

bool CNetAddr::IsRFC7343 ( ) const

Definition at line 207 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsRoutable()

bool CNetAddr::IsRoutable ( ) const

Returns: Whether or not this network address is publicly routable on the global internet.

Note: A routable address is always valid. As in, the set of routable addresses is a subset of the set of valid addresses.

See also: CNetAddr::IsValid()

Definition at line 295 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsTor()

bool CNetAddr::IsTor ( ) const

Returns: Whether or not this is a dummy address that maps an onion address into IPv6.

See also: CNetAddr::SetSpecial(const std::string &)

Definition at line 218 of file netaddress.cpp.

Here is the caller graph for this function:

◆ IsValid()

bool CNetAddr::IsValid ( ) const

Returns: Whether or not this network address is a valid address that could be used to refer to an actual host.

Note: A valid address may or may not be publicly routable on the global internet. As in, the set of valid addresses is a superset of the set of publicly routable addresses.

See also: CNetAddr::IsRoutable()

Definition at line 247 of file netaddress.cpp.

Here is the caller graph for this function:

◆ SerializationOp()

template<typename Stream , typename Operation >

void CNetAddr::SerializationOp	(	Stream &	s,
		Operation	ser_action
	)

inline

Definition at line 95 of file netaddress.h.

◆ SetInternal()

bool CNetAddr::SetInternal ( const std::string & name )

Try to make this a dummy address that maps the specified name into IPv6 like so: (0xFD + sha256("bitcoin")[0:5]) + sha256(name)[0:10].

Such dummy addresses have a prefix of fd6b:88c0:8724::/48 and are guaranteed to not be publicly routable as it falls under RFC4193's fc00::/7 subnet allocated to unique-local addresses.

CAddrMan uses these fake addresses to keep track of which DNS seeds were used.

Returns: Whether or not the operation was successful.

See also: CNetAddr::IsInternal(), CNetAddr::IsRFC4193()

Definition at line 62 of file netaddress.cpp.

Here is the call graph for this function:

◆ SetIP()

void CNetAddr::SetIP ( const CNetAddr & ip )

Definition at line 27 of file netaddress.cpp.

Here is the call graph for this function:

◆ SetRaw()

void CNetAddr::SetRaw	(	Network	network,
		const uint8_t *	data
	)

private

Set raw IPv4 or IPv6 address (in network byte order)

Note: Only NET_IPV4 and NET_IPV6 are allowed for network.

Definition at line 32 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetSpecial()

bool CNetAddr::SetSpecial ( const std::string & strName )

Try to make this a dummy address that maps the specified onion address into IPv6 using OnionCat's range and encoding.

Such dummy addresses have a prefix of fd87:d87e:eb43::/48 and are guaranteed to not be publicly routable as they fall under RFC4193's fc00::/7 subnet allocated to unique-local addresses.

Returns: Whether or not the operation was successful.

See also: CNetAddr::IsTor(), CNetAddr::IsRFC4193()

Definition at line 84 of file netaddress.cpp.

Here is the call graph for this function:

◆ ToString()

std::string CNetAddr::ToString ( ) const

Definition at line 351 of file netaddress.cpp.

Here is the call graph for this function:

◆ ToStringIP()

std::string CNetAddr::ToStringIP ( ) const

Definition at line 327 of file netaddress.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Friends And Related Function Documentation

◆ CSubNet

friend class CSubNet

friend

Definition at line 99 of file netaddress.h.

◆ operator!=

bool operator!=	(	const CNetAddr &	a,
		const CNetAddr &	b
	)

friend

Definition at line 89 of file netaddress.h.

◆ operator<

bool operator<	(	const CNetAddr &	a,
		const CNetAddr &	b
	)

friend

Definition at line 361 of file netaddress.cpp.

◆ operator==

bool operator==	(	const CNetAddr &	a,
		const CNetAddr &	b
	)

friend

Definition at line 356 of file netaddress.cpp.

Member Data Documentation

◆ ADD_SERIALIZE_METHODS

CNetAddr::ADD_SERIALIZE_METHODS

Definition at line 92 of file netaddress.h.

◆ ip

unsigned char CNetAddr::ip[16]

protected

Definition at line 35 of file netaddress.h.

◆ scopeId

uint32_t CNetAddr::scopeId {0}

protected

Definition at line 36 of file netaddress.h.

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

src/netaddress.h
src/netaddress.cpp

Public Member Functions

Public Attributes

Protected Attributes

Private Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ CNetAddr() [1/3]

◆ CNetAddr() [2/3]

◆ CNetAddr() [3/3]

Member Function Documentation

◆ GetByte()

◆ GetGroup()

◆ GetHash()

◆ GetIn6Addr()

◆ GetInAddr()

◆ GetNetwork()

◆ GetReachabilityFrom()

◆ IsBindAny()

◆ IsInternal()

◆ IsIPv4()

◆ IsIPv6()

◆ IsLocal()

◆ IsRFC1918()

◆ IsRFC2544()

◆ IsRFC3849()

◆ IsRFC3927()

◆ IsRFC3964()

◆ IsRFC4193()

◆ IsRFC4380()

◆ IsRFC4843()

◆ IsRFC4862()

◆ IsRFC5737()

◆ IsRFC6052()

◆ IsRFC6145()

◆ IsRFC6598()

◆ IsRFC7343()

◆ IsRoutable()

◆ IsTor()

◆ IsValid()

◆ SerializationOp()

◆ SetInternal()

◆ SetIP()

◆ SetRaw()

◆ SetSpecial()

◆ ToString()

◆ ToStringIP()

Friends And Related Function Documentation

◆ CSubNet

◆ operator!=

◆ operator<

◆ operator==

Member Data Documentation

◆ ADD_SERIALIZE_METHODS

◆ ip

◆ scopeId