Class TIp6Addr

class TIp6Addr;

Description

The 128 bits of IPv6 or IPv4 address stored in network byte order.

IPv4 addresses are stored in IPv4 mapped format.

Members

Defined in TIp6Addr:
IsEqual(), IsLinkLocal(), IsLoopback(), IsMulticast(), IsSiteLocal(), IsUnicast(), IsUnspecified(), IsV4Compat(), IsV4Mapped(), Match(), Scope(), iAddr16, iAddr32, iAddr8, u

IMPORT_C TBool IsUnicast() const;

Description

Tests if the address is IPv6 unicast.

Return value

TBool ETrue, if the address is unicast (not IPv6 unspecified or multicast); EFalse, otherwise.

IMPORT_C TBool IsMulticast() const;

Description

Tests if the IPv6 address is multicast.

Return value

TBool ETrue, if the IP address value is IPv6 multicast (ff00::/8 ); EFalse, otherwise.

IMPORT_C TBool IsLoopback() const;

Description

Tests if the address is IPv6 loopback.

Return value

TBool ETrue, if the address is loopback (::1 ); EFalse, otherwise.

IMPORT_C TBool IsUnspecified() const;

Description

Tests if the address is IPv6 unspecified.

Return value

TBool ETrue, if the IP address value is zero (= :: ); EFalse, otherwise.

IMPORT_C TBool IsLinkLocal() const;

Description

Tests if the address is an IPv6 link-local address.

Return value

TBool ETrue, if this address is an IPv6 link-local address (fe80::/10 ); EFalse, otherwise.

IMPORT_C TBool IsSiteLocal() const;

Description

Tests if this address is an IPv6 site-local address (fec0::/10).

Return value

TBool ETrue, if this is an IPv6 site-local address (fec0::/10 ); EFalse, otherwise.

IMPORT_C TBool IsV4Compat() const;

Description

Tests if this address is an IPv4-compatible address.

Note: returns EFalse for ::0.0.0.0 (= :: ) and ::0.0.0.1 (= ::1 ).

Return value

TBool ETrue, if this is a IPv4-compatible address (::x.x.x.x ); EFalse, otherwise.

IMPORT_C TBool IsV4Mapped() const;

Description

Tests if this address is an IPv4-mapped address.

Return value

TBool ETrue, if this address is an IPv4-mapped address (::ffff:x.x.x.x ); EFalse, otherwise.

IMPORT_C TBool IsEqual(const TIp6Addr &aAddr) const;

Description

Tests if two addresses are equal.

Parameters

const TIp6Addr &aAddr Address to compare with

Return value

TBool ETrue, if the addresses are equal; EFalse, otherwise.

IMPORT_C TInt Match(const TIp6Addr &aAddr) const;

Description

Compares two raw IPv6 addresses from left to right and returns the number of bits that match.

Parameters

const TIp6Addr &aAddr Address to compare with

Return value

TInt The number of bits that match (the common prefix length).

IMPORT_C TInt Scope() const;

Description

Return the scope level of the addres.

All IP addresses (IPv4 and IPv6) have a scope level as defined by this function. The scope level is a positive integer in range [1..16].

This function may also return 0, which is an invalid level. This can happen only, because IPv6 multicast addresses specify their scope level explicitly.

The scope level determines the interpretation of the scope identifier in TInetAddr (see TInetAddr::Scope(), TInetAddr::SetScope()).

Each network interface has a vector of 16 scope identifiers. The scope identifier in the destination address selects a subset of the possible interfaces: only the interfaces which have the correct matching scope identifier in the vector entry matching the scope level, are valid destinations for that address.

The scope level of an IP address is computed as follows:

• ffyz::/10 -- IPv6 multicast addressess, the scope level is extracted from the address (= z)

• fe80::/10 -- IPv6 link local addresses, return KIp6AddrScopeLinkLocal

• fec0::/10 -- IPv6 site local addresses, return KIp6AddrScopeSiteLocal

• ::1/128 -- IPv6 loopback address, return KIp6AddrScopeNodeLocal

• ::/128 -- IPv6 unspecified address, return KIp6AddrScopeNodeLocal

• ::ffff:0.0.0.0 -- IPv4 unspecified address, return KIp6AddrScopeNodeLocal

• ::ffff:169.254.x.x/112 -- IPv4 link local range, return KIp6AddrScopeLinkLocal

• ::ffff:224.0.0.x/120 -- IPv4 link local multicast range, return KIp6AddrScopeLinkLocal

• ::ffff:127.x.x.x/104 -- IPv4 loopback addresses, return KIp6AddrScopeNodeLocal

• ::ffff:0.0.0.0/96 -- all other IPv4 addresses, return KIp6AddrScopeNetwork

• None of the above -- assume global IPv6 addresses, return KIp6AddrScopeGlobal

Return value

TInt The scope value of the address (e.g. KIp6AddrScopeNodeLocal, KIp6AddrScopeLinkLocal, KIp6AddrScopeSiteLocal, KIp6AddrScopeOrganization, KIp6AddrScopeGlobal or KIp6AddrScopeNetwork).

TUint8 iAddr8;

Description

TUint16 iAddr16;

Description

TUint32 iAddr32;

Description

TIp6Addr::@25 u;

Description