DNS Resolution

DNS Resolution — Generic thread-safe address resolution functions.

Functions

Types and Values

Description

Functions

gnome_vfs_resolve ()

GnomeVFSResult
gnome_vfs_resolve (const char *hostname,
                   GnomeVFSResolveHandle **handle);

Tries to resolve hostname . If the operation was successful you can get the resolved addresses in form of GnomeVFSAddress by calling gnome_vfs_resolve_next_address().

Parameters

hostname

hostname you want to resolve.

 

handle

pointer to a pointer to a GnomeVFSResolveHandle.

 

Returns

A GnomeVFSResult indicating the success of the operation.

Since: 2.8


gnome_vfs_resolve_free ()

void
gnome_vfs_resolve_free (GnomeVFSResolveHandle *handle);

Use this function to free a GnomeVFSResolveHandle returned by gnome_vfs_resolve().

Parameters

handle

a GnomeVFSResolveHandle.

 

Since: 2.8


gnome_vfs_resolve_next_address ()

gboolean
gnome_vfs_resolve_next_address (GnomeVFSResolveHandle *handle,
                                GnomeVFSAddress **address);

Stores the next GnomeVFSAddress available in handle of the former lookup in address .

Parameters

handle

a GnomeVFSResolveHandle.

 

address

a pointer to a pointer to a GnomeVFSAddress.

 

Returns

TRUE if the next address was stored in address or FALSE if no other address is available.

Since: 2.8


gnome_vfs_resolve_reset_to_beginning ()

void
gnome_vfs_resolve_reset_to_beginning (GnomeVFSResolveHandle *handle);

Reset handle so that a following call to gnome_vfs_resolve_next_address() will return the first resolved address.

Parameters

handle

a GnomeVFSResolveHandle.

 

Since: 2.8


gnome_vfs_address_dup ()

GnomeVFSAddress *
gnome_vfs_address_dup (GnomeVFSAddress *address);

Duplicates address .

Parameters

address

A GnomeVFSAddress.

 

Returns

Duplicated address or NULL if address was not valid.

Since: 2.8


gnome_vfs_address_free ()

void
gnome_vfs_address_free (GnomeVFSAddress *address);

Frees the memory allocated for address .

Parameters

address

A GnomeVFSAddress.

 

Since: 2.8


gnome_vfs_address_get_family_type ()

int
gnome_vfs_address_get_family_type (GnomeVFSAddress *address);

Use this function to retrive the address family of address .

Parameters

address

A pointer to a GnomeVFSAddress

 

Returns

The address family of address .

Since: 2.8


gnome_vfs_address_get_ipv4 ()

guint32
gnome_vfs_address_get_ipv4 (GnomeVFSAddress *address);

Parameters

address

A GnomeVFSAddress.

 

Returns

The associated IPv4 address in network byte order.

Note that you should avoid using this function because newly written code should be protocol independent.

Since: 2.8


gnome_vfs_address_get_type ()

GType
gnome_vfs_address_get_type (void);


gnome_vfs_address_new_from_ipv4 ()

GnomeVFSAddress *
gnome_vfs_address_new_from_ipv4 (guint32 ipv4_address);

Creates a new GnomeVFSAddress from ipv4_address .

Note that this function should be avoided because newly written code should be protocol independent.

Parameters

ipv4_address

A IPv4 Address in network byte order

 

Returns

A new GnomeVFSAdress.

Since: 2.8


gnome_vfs_address_new_from_sockaddr ()

GnomeVFSAddress *
gnome_vfs_address_new_from_sockaddr (struct sockaddr *sa,
                                     int len);

Creates a new GnomeVFSAddress from sa .

Parameters

sa

A pointer to a sockaddr.

 

len

The size of sa .

 

Returns

The new GnomeVFSAddress or NULL if sa was invalid or the address family isn't supported.

Since: 2.8


gnome_vfs_address_new_from_string ()

GnomeVFSAddress *
gnome_vfs_address_new_from_string (const char *address);

Creates a new GnomeVFSAddress from the given string or NULL if address isn't a valid.

Parameters

address

A string representation of the address.

 

Returns

The new GnomeVFSAddress.

Since: 2.8


gnome_vfs_address_to_string ()

char *
gnome_vfs_address_to_string (GnomeVFSAddress *address);

Translate address to a printable string.

Parameters

address

A pointer to a GnomeVFSAddress

 

Returns

A newly alloced string representation of address which the caller must free.

Since: 2.8

Types and Values

GnomeVFSAddress

typedef struct _GnomeVFSAddress GnomeVFSAddress;