#include <tsIPSocketAddress.h>

Inheritance diagram for ts::IPSocketAddress:

[legend]

Collaboration diagram for ts::IPSocketAddress:

[legend]

Public Types
using	Port = uint16_t

Public Member Functions
	IPSocketAddress ()=default
	IPSocketAddress (const ::in6_addr &a, Port port)
	IPSocketAddress (const ::in_addr &a, Port port)
	IPSocketAddress (const ::sockaddr &a)
	IPSocketAddress (const ::sockaddr_in &a)
	IPSocketAddress (const ::sockaddr_in6 &a)
	IPSocketAddress (const ::sockaddr_storage &a)
	IPSocketAddress (const ByteBlock &bb, Port port)
	IPSocketAddress (const IPAddress &addr, Port port)
	IPSocketAddress (const UString &name, Report &report, IP preferred=IP::Any)
	IPSocketAddress (const void *addr, size_t size, Port port)
	IPSocketAddress (uint16_t h1, uint16_t h2, uint16_t h3, uint16_t h4, uint16_t h5, uint16_t h6, uint16_t h7, uint16_t h8, Port port)
	IPSocketAddress (uint32_t addr, Port port)
	IPSocketAddress (uint64_t net, uint64_t ifid, Port port)
	IPSocketAddress (uint8_t b1, uint8_t b2, uint8_t b3, uint8_t b4, Port port)
uint32_t	address4 () const
ByteBlock	address6 () const
virtual size_t	binarySize () const override
virtual void	clear ()
virtual void	clearAddress () override
virtual void	clearPort ()
bool	convert (IP gen)
virtual const UChar *	familyName () const override
IP	generation () const
size_t	get (::sockaddr_storage &a) const
bool	get4 (::sockaddr_in &a) const
bool	get6 (::sockaddr_in6 &a) const
size_t	getAddress (::sockaddr_storage &a, Port port) const
virtual size_t	getAddress (void *addr, size_t size) const override
bool	getAddress4 (::in_addr &a) const
bool	getAddress4 (::sockaddr_in &a, Port port) const
bool	getAddress6 (::in6_addr &a) const
bool	getAddress6 (::sockaddr_in6 &a, Port port) const
virtual bool	hasAddress () const override
virtual bool	hasPort () const
uint16_t	hexlet6 (size_t i) const
uint64_t	interfaceIdentifier6 () const
bool	isIPv4Mapped () const
bool	isLinkLocal () const
virtual bool	isMulticast () const override
bool	isSSM () const
bool	match (const IPAddress &other) const
bool	match (const IPSocketAddress &other) const
uint64_t	networkPrefix6 () const
bool	operator< (const IPAddress &other) const
bool	operator< (const IPSocketAddress &other) const
bool	operator== (const IPAddress &other) const
bool	operator== (const IPSocketAddress &other) const
virtual Port	port () const override
virtual bool	resolve (const UString &name, Report &report) override
virtual bool	resolve (const UString &name, Report &report, IP preferred) override
bool	sameMulticast6 (const IPAddress &mc) const
uint8_t	scopeMulticast6 () const
bool	set (const ::sockaddr &a)
bool	set (const ::sockaddr_in &a)
bool	set (const ::sockaddr_in6 &a)
bool	set (const ::sockaddr_storage &a)
bool	setAddress (const ::sockaddr &a)
bool	setAddress (const ::sockaddr_in &a)
bool	setAddress (const ::sockaddr_in6 &a)
bool	setAddress (const ::sockaddr_storage &a)
bool	setAddress (const ByteBlock &bb)
void	setAddress (const IPAddress &other)
virtual bool	setAddress (const void *addr, size_t size) override
void	setAddress4 (const ::in_addr &a)
void	setAddress4 (uint32_t addr)
void	setAddress4 (uint8_t b1, uint8_t b2, uint8_t b3, uint8_t b4)
void	setAddress6 (const ::in6_addr &a)
void	setAddress6 (uint16_t h1, uint16_t h2, uint16_t h3, uint16_t h4, uint16_t h5, uint16_t h6, uint16_t h7, uint16_t h8)
void	setAddress6 (uint64_t net, uint64_t ifid)
void	setDefault (const IPSocketAddress &other)
virtual void	setPort (Port port) override
virtual UString	toFullString () const override
virtual UString	toString () const override

Static Public Member Functions
static size_t	AddressBits (IP gen)
static const IPAddress &	AnyAddress (IP gen)
static const IPSocketAddress &	AnySocketAddress (IP gen)
static const IPAddress &	LocalHost (IP gen)
static void	RemovePort (UString &name)
static bool	ResolveAllAddresses (IPAddressVector &addresses, const UString &name, Report &report, IP gen=IP::Any)

Static Public Attributes
static const IPAddress	AnyAddress4
	Wildcard value for "any IPv4 address".
static const IPAddress	AnyAddress6
	Wildcard value for "any IPv6 address".
static constexpr Port	AnyPort = 0
static const IPSocketAddress	AnySocketAddress4
	Wildcard socket address, unspecified IPv4 address and port.
static const IPSocketAddress	AnySocketAddress6
	Wildcard socket address, unspecified IPv6 address and port.
static constexpr size_t	BITS4 = 32
	Size in bits of an IPv4 address.
static constexpr size_t	BITS6 = 128
	Size in bits of an IPv6 address.
static constexpr size_t	BYTES4 = 4
	Size in bytes of an IPv4 address.
static constexpr size_t	BYTES6 = 16
	Size in bytes of an IPv6 address.
static const IPAddress	LocalHost4
	Local host IPv4 address ("localhost").
static const IPAddress	LocalHost6
	Local host IPv6 address (::1, "localhost").

Detailed Description

Generic socket address class (IPv4 or IPv6 address & port).

The string representation is "addr[:port]" or "[addr:]port".

In this class, methods which apply to only one generation, IPv4 or IPv6, have a name ending in 4 or 6, respectively. Some constructors implicitly build one generation of address, IPv4 or IPv6, but their names remain IPAddress() without trailing 4 or 6 by design of C++.

Member Typedef Documentation

◆ Port

using ts::AbstractNetworkAddress::Port = uint16_t

inherited

The concept of port is used by TCP and UDP over IP networks.

Constructor & Destructor Documentation

◆ IPSocketAddress() [1/15]

ts::IPSocketAddress::IPSocketAddress ( )

default

Default constructor The default initial value is AnySocketAddress4.

◆ IPSocketAddress() [2/15]

ts::IPSocketAddress::IPSocketAddress	(	const IPAddress &	addr,
		Port	port )

inline

Generic constructor from an address and port.

Parameters

[in]	addr	Address.
[in]	port	Port number as an integer in host byte order.

◆ IPSocketAddress() [3/15]

ts::IPSocketAddress::IPSocketAddress	(	const void *	addr,
		size_t	size,
		Port	port )

inline

Generic constructor from an address in binary format.

Parameters

[in]	addr	Address of the memory area containing the address in binary format.
[in]	size	Size of the memory area. If the size is 4, this is an IPv4 address. If the size is 16, this is an IPv6 address. For all other sizes, the address is AnyAddress4.
[in]	port	Optional port number as an integer in host byte order.

◆ IPSocketAddress() [4/15]

ts::IPSocketAddress::IPSocketAddress	(	const ByteBlock &	bb,
		Port	port )

inline

Generic constructor from an address in binary format.

Parameters

[in]	bb	Byte block containing the address in binary format. If the size is 4, this is an IPv4 address. If the size is 16, this is an IPv6 address. For all other sizes, the address is AnyAddress4.
[in]	port	Optional port number as an integer in host byte order.

◆ IPSocketAddress() [5/15]

ts::IPSocketAddress::IPSocketAddress	(	uint32_t	addr,
		Port	port )

inline

IPv4 constructor from an integer IPv4 address.

Parameters

[in]	addr	The IP v4 address as an integer in host byte order.
[in]	port	Optional port number as an integer in host byte order.

◆ IPSocketAddress() [6/15]

ts::IPSocketAddress::IPSocketAddress	(	uint8_t	b1,
		uint8_t	b2,
		uint8_t	b3,
		uint8_t	b4,
		Port	port )

inline

IPv4 constructor from 4 bytes (classical IPv4 notation).

Parameters

[in]	b1	First address byte.
[in]	b2	Second address byte.
[in]	b3	Third address byte.
[in]	b4	Fourth address byte.
[in]	port	Optional port number as an integer in host byte order.

◆ IPSocketAddress() [7/15]

ts::IPSocketAddress::IPSocketAddress	(	uint16_t	h1,
		uint16_t	h2,
		uint16_t	h3,
		uint16_t	h4,
		uint16_t	h5,
		uint16_t	h6,
		uint16_t	h7,
		uint16_t	h8,
		Port	port )

inline

IPv6 constructor of an IPv6 address from 8 hexlets.

Parameters

[in]	h1	First address hexlet.
[in]	h2	2nd address hexlet.
[in]	h3	3rd address hexlet.
[in]	h4	4th address hexlet.
[in]	h5	5th address hexlet.
[in]	h6	6th address hexlet.
[in]	h7	7th address hexlet.
[in]	h8	8th address hexlet.
[in]	port	Optional port number as an integer in host byte order.

◆ IPSocketAddress() [8/15]

ts::IPSocketAddress::IPSocketAddress	(	uint64_t	net,
		uint64_t	ifid,
		Port	port )

inline

IPv6 constructor of an IPv6 address from network prefix and interface identifier.

Parameters

[in]	net	Network prefix.
[in]	ifid	Interface identifier.
[in]	port	Optional port number as an integer in host byte order.

◆ IPSocketAddress() [9/15]

ts::IPSocketAddress::IPSocketAddress ( const ::sockaddr & a )

Generic constructor from a system "struct sockaddr" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr" structure. Note: the structure "sockaddr" is deprecated because it cannot hold an IPv6 socket address. The structure "sockaddr_storage" should be used instead.

◆ IPSocketAddress() [10/15]

ts::IPSocketAddress::IPSocketAddress ( const ::sockaddr_storage & a )

inline

Generic constructor from a system "struct sockaddr_storage" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr_storage" structure.

◆ IPSocketAddress() [11/15]

ts::IPSocketAddress::IPSocketAddress	(	const ::in_addr &	a,
		Port	port )

inline

IPv4 constructor from a system "struct in_addr" structure (IPv4 socket API).

Parameters

[in]	a	A system "struct in_addr" structure.
[in]	port	Optional port number as an integer in host byte order.

◆ IPSocketAddress() [12/15]

ts::IPSocketAddress::IPSocketAddress ( const ::sockaddr_in & a )

inline

IPv4 constructor from a system "struct sockaddr_in" structure (IPv4 socket API).

Parameters

[in] a A system "struct sockaddr_in" structure.

◆ IPSocketAddress() [13/15]

ts::IPSocketAddress::IPSocketAddress	(	const ::in6_addr &	a,
		Port	port )

inline

IPv6 constructor from a system "struct in6_addr" structure (IPv6 socket API).

Parameters

[in]	a	A system "struct in6_addr" structure.
[in]	port	Optional port number as an integer in host byte order.

◆ IPSocketAddress() [14/15]

ts::IPSocketAddress::IPSocketAddress ( const ::sockaddr_in6 & a )

inline

IPv6 constructor from a system "struct sockaddr_in6" structure (IPv6 socket API).

Parameters

[in] a A system "struct sockaddr_in6" structure.

◆ IPSocketAddress() [15/15]

ts::IPSocketAddress::IPSocketAddress	(	const UString &	name,
		Report &	report,
		IP	preferred = IP::Any )

inline

Constructor from a string, host name or integer format. If name cannot be resolved, the address is set to AnyAddress4.

Parameters

[in]	name	A string containing either a host name or a numerical representation of the address.
[in]	report	Where to report errors.
[in]	preferred	Preferred IP generation of the returned address. Return the first availabale address by default.

Member Function Documentation

◆ AnySocketAddress()

const IPSocketAddress & ts::IPSocketAddress::AnySocketAddress ( IP gen )

inlinestatic

Get the "any socket address" template for a given generation of IP protocols.

Parameters

[in] gen Generation of IP protocols.

Returns: A constant reference to the corresponding "any socket address".

◆ port()

virtual Port ts::IPSocketAddress::port ( ) const

overridevirtual

Get the port if there is one. The default implementation returns AnyPort.

Returns: The port number or AnyPort if there is none.

Reimplemented from ts::AbstractNetworkAddress.

◆ setPort()

virtual void ts::IPSocketAddress::setPort ( Port port )

overridevirtual

Set the port. The default implementation does nothing.

Parameters

[in] port The port number as an integer in host byte order.

Reimplemented from ts::AbstractNetworkAddress.

◆ resolve() [1/2]

virtual bool ts::IPSocketAddress::resolve	(	const UString &	name,
		Report &	report )

overridevirtual

Decode a string containing a network address in family-specific format.

Parameters

[in]	name	A string containing either a host name or a numerical representation of the address.
[in]	report	Where to report errors.

Returns: True if name was successfully resolved, false otherwise. In the later case, the address is invalidated.

Reimplemented from ts::IPAddress.

◆ toFullString()

virtual UString ts::IPSocketAddress::toFullString ( ) const

overridevirtual

Convert to a string object in numeric format without the default compaction. The method toString() (inherited from StringifyInterface) returns a default representation of the string, with possible compaction of omitted defaults. This method returns a complete version of the address representation. The default implementation returns the same value as toString().

Returns: This object, converted as a string.

Reimplemented from ts::IPAddress.

◆ toString()

virtual UString ts::IPSocketAddress::toString ( ) const

overridevirtual

Convert to a string object.

Returns: This object, converted as a string.

Reimplemented from ts::IPAddress.

◆ RemovePort()

void ts::IPSocketAddress::RemovePort ( UString & name )

static

Remove the port number from a "addr[:port]" or "[addr:]port" string.

Parameters

[in,out] name A string where the port number is removed.

◆ set() [1/4]

bool ts::IPSocketAddress::set ( const ::sockaddr & a )

Set the IP address and port from a system "struct sockaddr" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr" structure. Note: the structure "sockaddr" is deprecated because it cannot hold an IPv6 socket address. The structure "sockaddr_storage" should be used instead.

Returns: True on success, false on error (incorrect family type).

◆ set() [2/4]

bool ts::IPSocketAddress::set ( const ::sockaddr_storage & a )

inline

Set the IP address and port from a system "struct sockaddr_storage" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr_storage" structure.

Returns: True on success, false on error (incorrect family type).

◆ set() [3/4]

bool ts::IPSocketAddress::set ( const ::sockaddr_in & a )

inline

Set the IPv4 address and port from a system "struct sockaddr_in" structure.

Parameters

[in] a A system "struct sockaddr_in" structure.

Returns: True on success, false on error (incorrect family type).

◆ set() [4/4]

bool ts::IPSocketAddress::set ( const ::sockaddr_in6 & a )

inline

Set the IPv6 address and port from a system "struct sockaddr_in6" structure.

Parameters

[in] a A system "struct sockaddr_in6" structure.

Returns: True on success, false on error (incorrect family type).

◆ get()

size_t ts::IPSocketAddress::get ( ::sockaddr_storage & a ) const

inline

Get the address and port into a system "struct sockaddr_storage" structure. Note: the structure "sockaddr" is deprecated because it cannot hold an IPv6 socket address. The structure "sockaddr_storage" should be used instead.

Parameters

[out] a A system "struct sockaddr_storage" structure. This type of structure is large enough to hold a structure sockaddr_in or sockaddr_in6.

Returns: Actual number of bytes used in the structure "sockaddr_storage", zero on error (system socket address structure is too small).

◆ get4()

bool ts::IPSocketAddress::get4 ( ::sockaddr_in & a ) const

inline

Get the IPv4 address and port into a system "struct sockaddr_in" structure.

Parameters

[out] a A system "struct sockaddr_in" structure.

Returns: True on success, false on error (incorrect family type).

◆ get6()

bool ts::IPSocketAddress::get6 ( ::sockaddr_in6 & a ) const

inline

Get the IPv6 address and port into a system "struct sockaddr_in6" structure.

Parameters

[out] a A system "struct sockaddr_in6" structure.

Returns: True on success, false on error (incorrect family type).

◆ match() [1/2]

bool ts::IPSocketAddress::match ( const IPSocketAddress & other ) const

Check if this socket address "matches" another one.

Parameters

[in] other Another instance to compare.

Returns: False if this and other addresses are both specified and are different or if the two ports are specified and different. True otherwise.

◆ setDefault()

void ts::IPSocketAddress::setDefault ( const IPSocketAddress & other )

Set missing address and/or port from a default socket address.

Parameters

[in] other Another instance to get default address and/or port.

◆ resolve() [2/2]

virtual bool ts::IPSocketAddress::resolve	(	const UString &	name,
		Report &	report,
		IP	preferred )

overridevirtual

Decode a string containing a socket address in family-specific format.

Parameters

[in]	name	A string containing either a host name or a numerical representation of the address and a port.
[in]	report	Where to report errors.
[in]	preferred	Preferred IP generation of the returned address. Return the first availabale address by default. If no address of that generation is available, return one from the other generation if available.

Returns: True if name was successfully resolved, false otherwise. In the later case, the address is invalidated.

Reimplemented from ts::IPAddress.

◆ operator==() [1/2]

bool ts::IPSocketAddress::operator== ( const IPSocketAddress & other ) const

inline

Equality operator.

Parameters

[in] other Another instance to compare with.

Returns: True if both object contains the same address, false otherwise.

◆ operator<() [1/2]

bool ts::IPSocketAddress::operator< ( const IPSocketAddress & other ) const

Comparison "less than" operator. It does not really makes sense. Only defined to allow usage in containers.

Parameters

[in] other Other instance to compare.

Returns: True if this instance is less than to other.

◆ AnyAddress()

const IPAddress & ts::IPAddress::AnyAddress ( IP gen )

inlinestaticinherited

Get the "any address" template for a given generation of IP protocols.

Parameters

[in] gen Generation of IP protocols.

Returns: A constant reference to the corresponding "any address".

◆ LocalHost()

const IPAddress & ts::IPAddress::LocalHost ( IP gen )

inlinestaticinherited

Get the "local host" address for a given generation of IP protocols.

Parameters

[in] gen Generation of IP protocols.

Returns: A constant reference to the corresponding "local host" address.

◆ AddressBits()

size_t ts::IPAddress::AddressBits ( IP gen )

inlinestaticinherited

Get the address size in bits for a given generation of IP protocols.

Parameters

[in] gen Generation of IP protocols.

Returns: Address size in bits.

◆ operator==() [2/2]

bool ts::IPAddress::operator== ( const IPAddress & other ) const

inherited

Equality operator.

Parameters

[in] other Another instance to compare with.

Returns: True if both object contains the same address, false otherwise.

◆ operator<() [2/2]

bool ts::IPAddress::operator< ( const IPAddress & other ) const

inherited

Comparison "less than" operator. It does not really makes sense. Only defined to allow usage in containers.

Parameters

[in] other Other instance to compare.

Returns: True if this instance is less than to other.

◆ match() [2/2]

bool ts::IPAddress::match ( const IPAddress & other ) const

inherited

Check if this address "matches" another one.

Parameters

[in] other Another instance to compare.

Returns: False if this and other addresses are both specified and are different. True otherwise.

◆ generation()

IP ts::IPAddress::generation ( ) const

inlineinherited

Get the current generation of IP addresses.

Returns: The IP generation of the address currently in this instance. Never IP::Any.

◆ isIPv4Mapped()

bool ts::IPAddress::isIPv4Mapped ( ) const

inherited

Check if the address is an IPv6 address which is mapped to an IPv4 one.

Returns: true if the address is an IPv6 address which is mapped to an IPv4 one.

◆ convert()

bool ts::IPAddress::convert ( IP gen )

inherited

Convert an IP address to another generation, when possible.

Parameters

[in] gen New IP generation to apply. If gen is IP::Any or the same as the current generation, return true. A conversion from IPv4 to IPv6 always works (IPv4-mapped address). The conversion of an IPv6 address into IPv4 is only possible if it is an IPv4-mapped address. For convenience, the IPv4 and IPv6 ampty and loopback addresses are converted to each other.

Returns: True if the conversion was successful, false if the conversion was no possible.

◆ binarySize()

virtual size_t ts::IPAddress::binarySize ( ) const

overridevirtualinherited

Get the maximum binary size in bytes for an address of that class.

Returns: The maximum binary size in bytes for an address of that class.

Implements ts::AbstractNetworkAddress.

◆ familyName()

virtual const UChar * ts::IPAddress::familyName ( ) const

overridevirtualinherited

Get a human-readable family name for an address of that class. This is typically something like "IPv4" or "IPv6".

Returns: A human-readable family name for an address of that class.

Implements ts::AbstractNetworkAddress.

◆ hasAddress()

virtual bool ts::IPAddress::hasAddress ( ) const

overridevirtualinherited

Check if this object is set to a valid address.

Returns: True if this object is set to a valid address, false otherwise.

Implements ts::AbstractNetworkAddress.

◆ getAddress() [1/2]

virtual size_t ts::IPAddress::getAddress	(	void *	addr,
		size_t	size ) const

overridevirtualinherited

Get the network address as binary data.

Parameters

[out]	addr	Address of binary buffer to receive binary data.
[in]	size	Size in bytes of buffer.

Returns: Number of copied bytes on success, zero on error (data too short).

Implements ts::AbstractNetworkAddress.

◆ getAddress() [2/2]

size_t ts::IPAddress::getAddress	(	::sockaddr_storage &	a,
		Port	port ) const

inherited

Copy the address into a system "struct sockaddr_storage" structure (socket API). Note: the structure "sockaddr" is deprecated because it cannot hold an IPv6 socket address. The structure "sockaddr_storage" should be used instead.

Parameters

[out]	a	A system "struct sockaddr_storage" structure. This type of structure is large enough to hold a structure sockaddr_in or sockaddr_in6.
[in]	port	Port number for the socket address.

Returns: Actual number of bytes used in the structure "sockaddr_storage".

◆ setAddress() [1/7]

virtual bool ts::IPAddress::setAddress	(	const void *	addr,
		size_t	size )

overridevirtualinherited

Set the network address from binary data.

Parameters

[in]	addr	Address of binary data.
[in]	size	Size in bytes of binary data.

Returns: True on success, false on error (incorrect data size).

Implements ts::AbstractNetworkAddress.

◆ setAddress() [2/7]

void ts::IPAddress::setAddress ( const IPAddress & other )

inherited

Set the IP address from another IPAddress object. Useful for subclasses to assign the address part only.

Parameters

[in] other Another IP address.

◆ setAddress() [3/7]

bool ts::IPAddress::setAddress ( const ByteBlock & bb )

inlineinherited

Set the IP address from an address in binary format. Useful for subclasses to assign the address part only.

Parameters

[in] bb Byte block containing the address in binary format. If the size is 4, this is an IPv4 address. If the size is 16, this is an IPv6 address. For all other sizes, the address is AnyAddress4.

Returns: True on success, false on error (incorrect data size).

◆ setAddress() [4/7]

bool ts::IPAddress::setAddress ( const ::sockaddr & a )

inherited

Set the IP address from a system "struct sockaddr" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr" structure. Note: the structure "sockaddr" is deprecated because it cannot hold an IPv6 socket address. The structure "sockaddr_storage" should be used instead.

Returns: True on success, false on error (incorrect family type).

◆ setAddress() [5/7]

bool ts::IPAddress::setAddress ( const ::sockaddr_storage & a )

inlineinherited

Set the IP address from a system "struct sockaddr_storage" structure (IPv4 or IPv6).

Parameters

[in] a A system "struct sockaddr_storage" structure.

Returns: True on success, false on error (incorrect family type).

◆ setAddress() [6/7]

bool ts::IPAddress::setAddress ( const ::sockaddr_in & a )

inlineinherited

Set the IPv4 address from a system "struct sockaddr_in" structure.

Parameters

[in] a A system "struct sockaddr_in" structure.

Returns: True on success, false on error (incorrect family type).

◆ setAddress() [7/7]

bool ts::IPAddress::setAddress ( const ::sockaddr_in6 & a )

inlineinherited

Set the IPv6 address from a system "struct sockaddr_in6" structure.

Parameters

[in] a A system "struct sockaddr_in6" structure.

Returns: True on success, false on error (incorrect family type).

◆ clearAddress()

virtual void ts::IPAddress::clearAddress ( )

overridevirtualinherited

Clear the address field.

Implements ts::AbstractNetworkAddress.

◆ isMulticast()

virtual bool ts::IPAddress::isMulticast ( ) const

overridevirtualinherited

Check if the address is a multicast address.

Returns: True if the address is a multicast address, false otherwise.

Implements ts::AbstractNetworkAddress.

◆ isSSM()

bool ts::IPAddress::isSSM ( ) const

inherited

Check if the address is a source specific multicast (SSM) address.

Returns: True if the address is an SSM address, false otherwise.

◆ sameMulticast6()

bool ts::IPAddress::sameMulticast6 ( const IPAddress & mc ) const

inherited

Check if two IPv6 multicast addresses are identical, excluding the "scope" bits. If this address or mc are socket addresses, they must also have the same port.

Parameters

[in] mc Another IPv6 multicast address.

Returns: True if this address and mc are two IPv6 multicast addresses and are identical, excluding the "scope" bits in the comparison. False otherwise.

◆ scopeMulticast6()

uint8_t ts::IPAddress::scopeMulticast6 ( ) const

inherited

Get the IPv6 multicast "scope" bits of this address.

Returns: The IPv6 multicast "scope" bits of this address (from 0x00 ro 0x0F) or 0xFF if not an IPv6 multicast address.

◆ isLinkLocal()

bool ts::IPAddress::isLinkLocal ( ) const

inherited

Check if the address is a link-local address, typically an auto-configured address.

Returns: True if the address is a link-local address, false otherwise.

◆ address4()

uint32_t ts::IPAddress::address4 ( ) const

inlineinherited

Get the IPv4 address as a 32-bit integer value in host byte order.

Returns: The IPv4 address as a 32-bit integer value in host byte order or zero if not an IPv4 address.

◆ address6()

ByteBlock ts::IPAddress::address6 ( ) const

inherited

Get the IPv6 address as a byte block.

Returns: Byte block containing the IPv6 bytes or an empty blcok if not an IPv6 address.

◆ networkPrefix6()

uint64_t ts::IPAddress::networkPrefix6 ( ) const

inherited

Get the IPv6 network prefix (64 most significant bits) of the IPv6 address.

Returns: The network prefix (64 most significant bits) of the IPv6 address.

◆ interfaceIdentifier6()

uint64_t ts::IPAddress::interfaceIdentifier6 ( ) const

inherited

Get the IPv6 interface identifier (64 least significant bits) of the IPv6 address.

Returns: The interface identifier (64 least significant bits) of the IPv6 address.

◆ hexlet6()

uint16_t ts::IPAddress::hexlet6 ( size_t i ) const

inherited

Get one of the 16-bit hexlets in the IPv6 address.

Parameters

[in] i Hexlet index, from 0 to 7.

Returns: The corresponding hexlet or zero if i is out of range.

◆ setAddress4() [1/3]

void ts::IPAddress::setAddress4 ( uint32_t addr )

inherited

Set the IP address from an IPv4 address as a 32-bit integer value in host byte order.

Parameters

[in] addr The IP v4 address as an integer in host byte order.

◆ setAddress4() [2/3]

void ts::IPAddress::setAddress4	(	uint8_t	b1,
		uint8_t	b2,
		uint8_t	b3,
		uint8_t	b4 )

inherited

Set the IP address from 4 bytes (classical IPv4 notation).

Parameters

[in]	b1	First address byte.
[in]	b2	Second address byte.
[in]	b3	Third address byte.
[in]	b4	Fourth address byte.

◆ setAddress4() [3/3]

void ts::IPAddress::setAddress4 ( const ::in_addr & a )

inherited

Set the IPv4 address from a system "struct in_addr" structure.

Parameters

[in] a A system "struct in_addr" structure.

◆ setAddress6() [1/3]

void ts::IPAddress::setAddress6	(	uint16_t	h1,
		uint16_t	h2,
		uint16_t	h3,
		uint16_t	h4,
		uint16_t	h5,
		uint16_t	h6,
		uint16_t	h7,
		uint16_t	h8 )

inherited

Set the IP address from an IPv6 address as 8 hexlets.

Parameters

[in]	h1	First address hexlet.
[in]	h2	2nd address hexlet.
[in]	h3	3rd address hexlet.
[in]	h4	4th address hexlet.
[in]	h5	5th address hexlet.
[in]	h6	6th address hexlet.
[in]	h7	7th address hexlet.
[in]	h8	8th address hexlet.

◆ setAddress6() [2/3]

void ts::IPAddress::setAddress6	(	uint64_t	net,
		uint64_t	ifid )

inherited

Set the IP address from an IPv6 address as network prefix and interface identifier.

Parameters

[in]	net	Network prefix.
[in]	ifid	Interface identifier.

◆ setAddress6() [3/3]

void ts::IPAddress::setAddress6 ( const ::in6_addr & a )

inherited

Set the IPv6 address from a system "struct in6_addr" structure.

Parameters

[in] a A system "struct in6_addr" structure.

◆ getAddress4() [1/2]

bool ts::IPAddress::getAddress4	(	::sockaddr_in &	a,
		Port	port ) const

inherited

Copy the IPv4 address into a system "struct sockaddr_in" structure (socket API).

Parameters

[out]	a	A system "struct sockaddr_in" structure.
[in]	port	Port number for the socket address.

Returns: True on success, false on error (incorrect family type).

◆ getAddress4() [2/2]

bool ts::IPAddress::getAddress4 ( ::in_addr & a ) const

inherited

Copy the IPv4 address into a system "struct in_addr" structure (socket API).

Parameters

[out] a A system "struct in_addr" structure.

Returns: True on success, false on error (incorrect family type).

◆ getAddress6() [1/2]

bool ts::IPAddress::getAddress6	(	::sockaddr_in6 &	a,
		Port	port ) const

inherited

Copy the IPv6 address into a system "struct sockaddr_in6" structure (socket API).

Parameters

[out]	a	A system "struct sockaddr_in6" structure.
[in]	port	Port number for the socket address.

Returns: True on success, false on error (incorrect family type).

◆ getAddress6() [2/2]

bool ts::IPAddress::getAddress6 ( ::in6_addr & a ) const

inherited

Copy the IPv6 address into a system "struct in6_addr" structure (socket API).

Parameters

[out] a A system "struct in6_addr" structure.

Returns: True on success, false on error (incorrect family type).

◆ ResolveAllAddresses()

bool ts::IPAddress::ResolveAllAddresses	(	IPAddressVector &	addresses,
		const UString &	name,
		Report &	report,
		IP	gen = IP::Any )

staticinherited

Decode a host name and get all possible addresses for that host.

Parameters

[out]	addresses	List of possible addresses for name. If name is a valid numerical addresse, only this one is returned.
[in]	name	A string containing either a host name or a numerical representation of the address.
[in,out]	report	Where to report errors.
[in]	gen	IP generation of the returned address. Can be used to restrict the result to IPv4 or IPv6 addresses. Return all by default.

Returns: True if name was successfully resolved, false otherwise.

◆ clear()

virtual void ts::AbstractNetworkAddress::clear ( )

virtualinherited

Clear the object, address and port if there is any.

◆ hasPort()

virtual bool ts::AbstractNetworkAddress::hasPort ( ) const

virtualinherited

Check if a port is set.

Returns: True if port is set.

◆ clearPort()

virtual void ts::AbstractNetworkAddress::clearPort ( )

virtualinherited

Clear the port. The default implementatio sets the port to AnyPort

Member Data Documentation

◆ AnyPort

Port ts::AbstractNetworkAddress::AnyPort = 0

staticconstexprinherited

Wildcard integer value for "any port" or "no port".

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

tsIPSocketAddress.h

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Member Typedef Documentation

◆ Port

Constructor & Destructor Documentation

◆ IPSocketAddress() [1/15]

◆ IPSocketAddress() [2/15]

◆ IPSocketAddress() [3/15]

◆ IPSocketAddress() [4/15]

◆ IPSocketAddress() [5/15]

◆ IPSocketAddress() [6/15]

◆ IPSocketAddress() [7/15]

◆ IPSocketAddress() [8/15]

◆ IPSocketAddress() [9/15]

◆ IPSocketAddress() [10/15]

◆ IPSocketAddress() [11/15]

◆ IPSocketAddress() [12/15]

◆ IPSocketAddress() [13/15]

◆ IPSocketAddress() [14/15]

◆ IPSocketAddress() [15/15]

Member Function Documentation

◆ AnySocketAddress()

◆ port()

◆ setPort()

◆ resolve() [1/2]

◆ toFullString()

◆ toString()

◆ RemovePort()

◆ set() [1/4]

◆ set() [2/4]

◆ set() [3/4]

◆ set() [4/4]

◆ get()

◆ get4()

◆ get6()

◆ match() [1/2]

◆ setDefault()

◆ resolve() [2/2]

◆ operator==() [1/2]

◆ operator<() [1/2]

◆ AnyAddress()

◆ LocalHost()

◆ AddressBits()

◆ operator==() [2/2]

◆ operator<() [2/2]

◆ match() [2/2]

◆ generation()

◆ isIPv4Mapped()

◆ convert()

◆ binarySize()

◆ familyName()

◆ hasAddress()

◆ getAddress() [1/2]

◆ getAddress() [2/2]

◆ setAddress() [1/7]

◆ setAddress() [2/7]

◆ setAddress() [3/7]

◆ setAddress() [4/7]

◆ setAddress() [5/7]

◆ setAddress() [6/7]

◆ setAddress() [7/7]

◆ clearAddress()

◆ isMulticast()

◆ isSSM()

◆ sameMulticast6()

◆ scopeMulticast6()

◆ isLinkLocal()

◆ address4()

◆ address6()

◆ networkPrefix6()

◆ interfaceIdentifier6()

◆ hexlet6()

◆ setAddress4() [1/3]

◆ setAddress4() [2/3]

◆ setAddress4() [3/3]

◆ setAddress6() [1/3]

◆ setAddress6() [2/3]