![]() | ![]() | ![]() | GnomeVFS - Filesystem Abstraction library | ![]() |
---|
Internet connectionInternet connection — Simple TCP/IP connection functions. |
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 GnomeVFSInetConnection, which will. contain an allocated GnomeVFSInetConnection object on return. |
host_name : | String indicating the host to establish an internet connection with. |
host_port : | The 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);
Wrapper connection inside a standard GnomeVFSSocket for convenience.
connection : | Connection to convert to wrapper in a GnomeVFSSocket. |
Returns : | a newly created GnomeVFSSocket around connection. |
GnomeVFSSocketBuffer* gnome_vfs_inet_connection_to_socket_buffer (GnomeVFSInetConnection *connection);
Wrapper connection inside a standard GnomeVFSSocketBuffer for convenience.
connection : | Connection to convert to wrapper in 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 GnomeVFSInetConnection, which will. contain An allocated GnomeVFSInetConnection object on return. |
address : | A valid GnomeVFSAddress. |
host_port : | The 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 |
<< Unified bufferd network I/O | MIME Registry >> |