|  |  |  | GnomeVFS - Filesystem Abstraction library |  | 
|---|---|---|---|---|
GnomeVFSResult gnome_vfs_inet_connection_create (GnomeVFSInetConnection **connection_return, const gchar *host_name, guint host_port, GnomeVFSCancellation *cancellation); void gnome_vfs_inet_connection_destroy (GnomeVFSInetConnection *connection, GnomeVFSCancellation *cancellation); void gnome_vfs_inet_connection_free (GnomeVFSInetConnection *connection, GnomeVFSCancellation *cancellation); GnomeVFSSocket* gnome_vfs_inet_connection_to_socket (GnomeVFSInetConnection *connection); GnomeVFSSocketBuffer* gnome_vfs_inet_connection_to_socket_buffer (GnomeVFSInetConnection *connection); int gnome_vfs_inet_connection_get_fd (GnomeVFSInetConnection *connection); GnomeVFSResult gnome_vfs_inet_connection_create_from_address (GnomeVFSInetConnection **connection_return, GnomeVFSAddress *address, guint host_port, GnomeVFSCancellation *cancellation); GnomeVFSAddress* gnome_vfs_inet_connection_get_address (GnomeVFSInetConnection *connection); char* gnome_vfs_inet_connection_get_ip (GnomeVFSInetConnection *connection);
A GnomeVFSInetConnection represents a TCP/IP connection. You can either use gnome_vfs_inet_connection_create which will use the gnome_vfs_resolve DNS resolution functions internally or you can do the name resolution yourself and use gnome_vfs_inet_connection_create_from_address to connect to a specific address. After a connection has been established all I/O is done through a GnomeVFSSocket or a GnomeVFSSocketBuffer.
GnomeVFSResult gnome_vfs_inet_connection_create (GnomeVFSInetConnection **connection_return, const gchar *host_name, guint host_port, GnomeVFSCancellation *cancellation);
Creates a connection at connection_return to host_name using
port port.
| connection_return: | pointer to a pointer to a GnomeVFSInetConnection, which will contain an allocated GnomeVFSInetConnection object on return. | 
| host_name: | string indicating the host to establish an internet connection with. | 
| host_port: | port number to connect to. | 
| cancellation: | handle allowing cancellation of the operation. | 
| Returns : | GnomeVFSResult indicating the success of the operation. | 
void        gnome_vfs_inet_connection_destroy
                                            (GnomeVFSInetConnection *connection,
                                             GnomeVFSCancellation *cancellation);
Closes/Destroys connection.
| connection: | connection to destroy. | 
| cancellation: | handle for cancelling the operation. | 
void        gnome_vfs_inet_connection_free  (GnomeVFSInetConnection *connection,
                                             GnomeVFSCancellation *cancellation);
Frees connection without closing the socket.
| connection: | connection to free. | 
| cancellation: | handle for cancelling the operation. | 
GnomeVFSSocket* gnome_vfs_inet_connection_to_socket
                                            (GnomeVFSInetConnection *connection);
Wrap connection inside a standard GnomeVFSSocket for convenience.
| connection: | connection to be wrapped into a GnomeVFSSocket. | 
| Returns : | a newly created GnomeVFSSocket around connection. | 
GnomeVFSSocketBuffer* gnome_vfs_inet_connection_to_socket_buffer
                                            (GnomeVFSInetConnection *connection);
Wrap connection inside a standard GnomeVFSSocketBuffer for convenience.
| connection: | connection to be wrapped into a GnomeVFSSocketBuffer. | 
| Returns : | a newly created GnomeVFSSocketBuffer around connection. | 
int         gnome_vfs_inet_connection_get_fd
                                            (GnomeVFSInetConnection *connection);
Retrieve the UNIX file descriptor corresponding to connection.
| connection: | connection to get the file descriptor from. | 
| Returns : | file descriptor. | 
GnomeVFSResult gnome_vfs_inet_connection_create_from_address (GnomeVFSInetConnection **connection_return, GnomeVFSAddress *address, guint host_port, GnomeVFSCancellation *cancellation);
Creates a connection at connection_return to address using
port port.
| connection_return: | pointer to a pointer to a GnomeVFSInetConnection, which will contain an allocated GnomeVFSInetConnection object on return. | 
| address: | a valid GnomeVFSAddress. | 
| host_port: | port number to connect to. | 
| cancellation: | handle allowing cancellation of the operation. | 
| Returns : | GnomeVFSResult indicating the success of the operation. | 
Since 2.8
GnomeVFSAddress* gnome_vfs_inet_connection_get_address (GnomeVFSInetConnection *connection);
Retrieve the address of the other side of a connected connection.
| connection: | connection to get the address from. | 
| Returns : | a GnomeVFSAddress containing the address. Since 2.8 |