T is a high-level utility class for connecting to a network host using a connection oriented socket type.

You create a T object, set any options you want, and then call a sync or async connect operation, which returns a Gtk.Gio.GSocketConnection.T subclass on success.

The type of the Gtk.Gio.GSocketConnection.T object returned depends on the type of the underlying socket that is in use. For instance, for a TCP/IP connection it will be a Gtk.Gio.GTcpConnection.T.

Creates a new T with the default options.

Enable proxy protocols to be handled by the application. When the indicated proxy protocol is returned by the Gtk.Gio.GProxyResolver.T, T will consider this protocol as supported but will not try to find a Gtk.Gio.GProxy.T instance to handle handshaking. The application must check for this case by calling Gtk.Gio.GSocketConnection.GetRemoteAddress on the returned Gtk.Gio.GSocketConnection.T, and seeing if it's a Gtk.Gio.GProxyAddress.T of the appropriate type, to determine whether or not it needs to handle the proxy handshaking itself.

This should be used for proxy protocols that are dialects of another protocol such as HTTP proxy. It also allows cohabitation of proxy protocols that are reused between protocols. A good example is HTTP. It can be used to proxy HTTP, FTP and Gopher and can also be use as generic socket proxy through the HTTP CONNECT method.

Tries to resolve the connectable and make a network connection to it.

Upon a successful connection, a new Gtk.Gio.GSocketConnection.T is constructed and returned. The caller owns this new object and must drop their reference to it when finished with it.

The type of the Gtk.Gio.GSocketConnection.T object returned depends on the type of the underlying socket that is used. For instance, for a TCP/IP connection it will be a Gtk.Gio.GTcpConnection.T.

The socket created will be the same family as the address that the connectable resolves to, unless family is set with SetFamily or indirectly via SetLocalAddress. The socket type defaults to Gtk.Gio.GSocketType.Stream but can be set with SetSocketType.

If a local address is specified with SetLocalAddress the socket will be bound to this address before connecting.

This is the asynchronous version of Connect.

When the operation is finished callback will be called. You can then call ConnectFinish to get the result of the operation.

Finishes an async connect operation. See ConnectAsync

This is a helper function for Connect.

Attempts to create a TCP connection to the named host.

host_and_port may be in any of a number of recognized formats; an IPv6 address, an IPv4 address, or a domain name (in which case a DNS lookup is performed). Quoting with [] is supported for all address types. A port override may be specified in the usual way with a colon. Ports may be given as decimal numbers or symbolic names (in which case an /etc/services lookup is performed).

If no port override is given in host_and_port then default_port will be used as the port number to connect to.

In general, host_and_port is expected to be provided by the user (allowing them to give the hostname, and a port override if necessary) and default_port is expected to be provided by the application.

In the case that an IP address is given, a single connection attempt is made. In the case that a name is given, multiple connection attempts may be made, in turn and according to the number of address records in DNS, until a connection succeeds.

Upon a successful connection, a new Gtk.Gio.GSocketConnection.T is constructed and returned. The caller owns this new object and must drop their reference to it when finished with it.

In the event of any failure (DNS error, service not found, no hosts connectable) NULL is returned and error (if non-NULL) is set accordingly.

This is the asynchronous version of ConnectToHost.

When the operation is finished callback will be called. You can then call ConnectToHostFinish to get the result of the operation.

Finishes an async connect operation. See ConnectToHostAsync

Attempts to create a TCP connection to a service.

This call looks up the SRV record for service at domain for the "tcp" protocol. It then attempts to connect, in turn, to each of the hosts providing the service until either a connection succeeds or there are no hosts remaining.

Upon a successful connection, a new Gtk.Gio.GSocketConnection.T is constructed and returned. The caller owns this new object and must drop their reference to it when finished with it.

In the event of any failure (DNS error, service not found, no hosts connectable) NULL is returned and error (if non-NULL) is set accordingly.

This is the asynchronous version of ConnectToService.

Finishes an async connect operation. See ConnectToServiceAsync

This is a helper function for Connect.

Attempts to create a TCP connection with a network URI.

uri may be any valid URI containing an "authority" (hostname/port) component. If a port is not specified in the URI, default_port will be used. TLS will be negotiated if "tls" is TRUE. (T does not know to automatically assume TLS for certain URI schemes.)

Using this rather than Connect or ConnectToHost allows T to determine when to use application-specific proxy protocols.

Upon a successful connection, a new Gtk.Gio.GSocketConnection.T is constructed and returned. The caller owns this new object and must drop their reference to it when finished with it.

In the event of any failure (DNS error, service not found, no hosts connectable) NULL is returned and error (if non-NULL) is set accordingly.

This is the asynchronous version of ConnectToUri.

When the operation is finished callback will be called. You can then call ConnectToUriFinish to get the result of the operation.

Finishes an async connect operation. See ConnectToUriAsync

Gets the proxy enable state; see SetEnableProxy

Gets the socket family of the socket client.

See SetFamily for details.

Gets the local address of the socket client.

See SetLocalAddress for details.

Gets the protocol name type of the socket client.

See SetProtocol for details.

Gets the socket type of the socket client.

See SetSocketType for details.

Gets the I/O timeout time for sockets created by client.

See SetTimeout for details.

Sets whether or not client attempts to make connections via a proxy server. When enabled (the default), T will use a Gtk.Gio.GProxyResolver.T to determine if a proxy protocol such as SOCKS is needed, and automatically do the necessary proxy negotiation.

Sets the socket family of the socket client. If this is set to something other than Gtk.Gio.GSocketFamily.Invalid then the sockets created by this object will be of the specified family.

This might be useful for instance if you want to force the local connection to be an ipv4 socket, even though the address might be an ipv6 mapped to ipv4 address.

Sets the local address of the socket client. The sockets created by this object will bound to the specified address (if not NULL) before connecting.

This is useful if you want to ensure that the local side of the connection is on a specific port, or on a specific interface.

Sets the protocol of the socket client. The sockets created by this object will use of the specified protocol.

If protocol is 0 that means to use the default protocol for the socket family and type.

Sets the socket type of the socket client. The sockets created by this object will be of the specified type.

It doesn't make sense to specify a type of Gtk.Gio.GSocketType.Datagram, as GSocketClient is used for connection oriented services.

Sets the I/O timeout for sockets created by client. timeout is a time in seconds, or 0 for no timeout (the default).

The timeout value affects the initial connection attempt as well, so setting this may cause calls to Connect, etc, to fail with Gtk.Gio.GIOErrorEnum.TimedOut.