ProxyIF

Description A GProxy handles connecting to a remote host via a given type of proxy server. It is implemented by the 'gio-proxy' extension point. The extensions are named after their proxy protocol name. As an example, a SOCKS5 proxy implementation can be retrieved with the name 'socks5' using the function g_io_extension_point_get_extension_by_name().

interface ProxyIF {

GProxy* getProxyTStruct();

void* getStruct();

IOStream gProxyConnect(IOStream connection, ProxyAddress proxyAddress, Cancellable cancellable);

void gProxyConnectAsync(IOStream connection, ProxyAddress proxyAddress, Cancellable cancellable, GAsyncReadyCallback callback, void* userData);

IOStream gProxyConnectFinish(AsyncResultIF result);

static ProxyIF gProxyGetDefaultForProtocol(string protocol);

int gProxySupportsHostname();

}

Members

Functions

gProxyConnect IOStream gProxyConnect(IOStream connection, ProxyAddress proxyAddress, Cancellable cancellable): Given connection to communicate with a proxy (eg, a GSocketConnection that is connected to the proxy server), this does the necessary handshake to connect to proxy_address, and if required, wraps the GIOStream to handle proxy payload. Since 2.26
gProxyConnectAsync void gProxyConnectAsync(IOStream connection, ProxyAddress proxyAddress, Cancellable cancellable, GAsyncReadyCallback callback, void* userData): Asynchronous version of g_proxy_connect(). Since 2.26
gProxyConnectFinish IOStream gProxyConnectFinish(AsyncResultIF result): See g_proxy_connect(). Since 2.26
gProxySupportsHostname int gProxySupportsHostname(): Some proxy protocols expect to be passed a hostname, which they will resolve to an IP address themselves. Others, like SOCKS4, do not allow this. This function will return FALSE if proxy is implementing such a protocol. When FALSE is returned, the caller should resolve the destination hostname first, and then pass a GProxyAddress containing the stringified IP address to g_proxy_connect() or g_proxy_connect_async(). Since 2.26
getProxyTStruct GProxy* getProxyTStruct(): Undocumented in source.
getStruct void* getStruct(): the main Gtk struct as a void*

Static functions

gProxyGetDefaultForProtocol ProxyIF gProxyGetDefaultForProtocol(string protocol): Lookup "gio-proxy" extension point for a proxy implementation that supports specified protocol. Since 2.26

ProxyIF

Members

Functions

Static functions

Meta

Source