NiceAddress

NiceAddress — IP address convenience library

Stability Level

Stable, unless otherwise indicated

Functions

Types and Values

Object Hierarchy

    GBoxed
    ╰── NiceAddress

Description

The NiceAddress structure will allow you to easily set/get and modify an IPv4 or IPv6 address in order to communicate with the NiceAgent.

Functions

nice_address_init ()

void
nice_address_init (NiceAddress *addr);

Initialize a NiceAddress into an undefined address

Parameters

addr

The NiceAddress to init

 

nice_address_new ()

NiceAddress *
nice_address_new (void);

Create a new NiceAddress with undefined address You must free it with nice_address_free()

Returns

The new NiceAddress


nice_address_free ()

void
nice_address_free (NiceAddress *addr);

Frees a NiceAddress created with nice_address_new() or nice_address_dup()

Parameters

addr

The NiceAddress to free

 

nice_address_dup ()

NiceAddress *
nice_address_dup (const NiceAddress *addr);

Creates a new NiceAddress with the same address as addr

Parameters

addr

The NiceAddress to dup

 

Returns

The new NiceAddress


nice_address_set_ipv4 ()

void
nice_address_set_ipv4 (NiceAddress *addr,
                       guint32 addr_ipv4);

Set addr to an IPv4 address using the data from addr_ipv4

This function will reset the port to 0, so make sure you call it before nice_address_set_port()

Parameters

addr

The NiceAddress to modify

 

addr_ipv4

The IPv4 address

 

nice_address_set_ipv6 ()

void
nice_address_set_ipv6 (NiceAddress *addr,
                       const guchar *addr_ipv6);

Set addr to an IPv6 address using the data from addr_ipv6

This function will reset the port to 0, so make sure you call it before nice_address_set_port()

Parameters

addr

The NiceAddress to modify

 

addr_ipv6

The IPv6 address

 

nice_address_set_port ()

void
nice_address_set_port (NiceAddress *addr,
                       guint port);

Set the port of addr to port

Parameters

addr

The NiceAddress to modify

 

port

The port to set

 

nice_address_get_port ()

guint
nice_address_get_port (const NiceAddress *addr);

Retreive the port of addr

Parameters

addr

The NiceAddress to query

 

Returns

The port of addr


nice_address_set_from_string ()

gboolean
nice_address_set_from_string (NiceAddress *addr,
                              const gchar *str);

Sets an IPv4 or IPv6 address from the string str

Parameters

addr

The NiceAddress to modify

 

str

The string to set

 

Returns

TRUE if success, FALSE on error


nice_address_set_from_sockaddr ()

void
nice_address_set_from_sockaddr (NiceAddress *addr,
                                const struct sockaddr *sin);

Sets an IPv4 or IPv6 address from the sockaddr structure sin

Parameters

addr

The NiceAddress to modify

 

sin

The sockaddr to set

 

nice_address_copy_to_sockaddr ()

void
nice_address_copy_to_sockaddr (const NiceAddress *addr,
                               struct sockaddr *sin);

Fills the sockaddr structure sin with the address contained in addr

Parameters

addr

The NiceAddress to query

 

sin

The sockaddr to fill

 

nice_address_equal ()

gboolean
nice_address_equal (const NiceAddress *a,
                    const NiceAddress *b);

Compares two NiceAddress structures to see if they contain the same address and the same port.

Parameters

a

First NiceAddress to compare

 

b

Second NiceAddress to compare

 

Returns

TRUE if a and b are the same address, FALSE if they are different


nice_address_equal_no_port ()

gboolean
nice_address_equal_no_port (const NiceAddress *a,
                            const NiceAddress *b);

Compares two NiceAddress structures to see if they contain the same address, ignoring the port.

Parameters

a

First NiceAddress to compare

 

b

Second NiceAddress to compare

 

Returns

TRUE if a and b are the same address, FALSE if they are different

Since: 0.1.8


nice_address_to_string ()

void
nice_address_to_string (const NiceAddress *addr,
                        gchar *dst);

Transforms the address addr into a human readable string

[skip]

Parameters

addr

The NiceAddress to query

 

dst

The string to fill

 

nice_address_dup_string ()

gchar *
nice_address_dup_string (const NiceAddress *addr);

Transforms the address addr into a newly allocated human readable string

Parameters

addr

The NiceAddress to query

 

Returns

the address string.

[transfer full]

Since: 0.1.20


nice_address_is_private ()

gboolean
nice_address_is_private (const NiceAddress *addr);

Verifies if the address in addr is a private address or not

Parameters

addr

The NiceAddress to query

 

Returns

TRUE if addr is a private address, FALSE otherwise


nice_address_is_linklocal ()

gboolean
nice_address_is_linklocal (const NiceAddress *addr);

Verifies if the address in addr is a link-local address or not

Parameters

addr

The NiceAddress to query

 

Returns

TRUE if addr is a link-local address, FALSE otherwise

Since: 0.1.19


nice_address_is_valid ()

gboolean
nice_address_is_valid (const NiceAddress *addr);

Validate whether the NiceAddress addr is a valid IPv4 or IPv6 address

Parameters

addr

The NiceAddress to query

 

Returns

TRUE if addr is valid, FALSE otherwise


nice_address_ip_version ()

int
nice_address_ip_version (const NiceAddress *addr);

Returns the IP version of the address

Parameters

addr

The NiceAddress to query

 

Returns

4 for IPv4, 6 for IPv6 and 0 for undefined address

Types and Values

NiceAddress

typedef struct {
  union
  {
    struct sockaddr     addr;
    struct sockaddr_in  ip4;
    struct sockaddr_in6 ip6;
  } s;
} NiceAddress;

The NiceAddress structure that represents an IPv4 or IPv6 address.


NICE_ADDRESS_STRING_LEN

#define NICE_ADDRESS_STRING_LEN INET6_ADDRSTRLEN

The maximum string length representation of an address. When using nice_address_to_string() make sure the string has a size of at least NICE_ADDRESS_STRING_LEN