## GProxyAddress

GProxyAddress — An internet address with proxy information

## Synopsis

                        GProxyAddress;
    struct              GProxyAddressClass;
    const gchar *       g_proxy_address_get_destination_protocol
                                                            (GProxyAddress *proxy);
    const gchar *       g_proxy_address_get_destination_hostname
                                                            (GProxyAddress *proxy);
    guint16             g_proxy_address_get_destination_port
                                                            (GProxyAddress *proxy);
    const gchar *       g_proxy_address_get_password        (GProxyAddress *proxy);
    const gchar *       g_proxy_address_get_protocol        (GProxyAddress *proxy);
    const gchar *       g_proxy_address_get_username        (GProxyAddress *proxy);
    const gchar *       g_proxy_address_get_uri             (GProxyAddress *proxy);
    GSocketAddress *    g_proxy_address_new                 (GInetAddress *inetaddr,
                                                             guint16 port,
                                                             const gchar *protocol,
                                                             const gchar *dest_hostname,
                                                             guint16 dest_port,
                                                             const gchar *username,
                                                             const gchar *password);

## Object Hierarchy

      GObject
       +----GSocketAddress
             +----GInetSocketAddress
                   +----GProxyAddress

## Implemented Interfaces

GProxyAddress implements GSocketConnectable.

## Properties

      "destination-hostname"     gchar*                : Read / Write / Construct Only
      "destination-port"         guint                 : Read / Write / Construct Only
      "destination-protocol"     gchar*                : Read / Write / Construct Only
      "password"                 gchar*                : Read / Write / Construct Only
      "protocol"                 gchar*                : Read / Write / Construct Only
      "uri"                      gchar*                : Read / Write / Construct Only
      "username"                 gchar*                : Read / Write / Construct Only

## Description

Support for proxied GInetSocketAddress.

## Details

### GProxyAddress

    typedef struct _GProxyAddress GProxyAddress;

A GInetSocketAddress representing a connection via a proxy server

Since 2.26

### struct GProxyAddressClass

    struct GProxyAddressClass {
      GInetSocketAddressClass parent_class;
    };

### g_proxy_address_get_destination_protocol ()

    const gchar *       g_proxy_address_get_destination_protocol
                                                            (GProxyAddress *proxy);

Gets the protocol that is being spoken to the destination server; eg, "http" or "ftp".

`proxy` : | a GProxyAddress
Returns : | the `proxy`'s destination protocol

Since 2.34

### g_proxy_address_get_destination_hostname ()

    const gchar *       g_proxy_address_get_destination_hostname
                                                            (GProxyAddress *proxy);

Gets `proxy`'s destination hostname; that is, the name of the host that will be connected to via the proxy, not the name of the proxy itself.

`proxy` : | a GProxyAddress
Returns : | the `proxy`'s destination hostname

Since 2.26

### g_proxy_address_get_destination_port ()

    guint16             g_proxy_address_get_destination_port
                                                            (GProxyAddress *proxy);

Gets `proxy`'s destination port; that is, the port on the destination host that will be connected to via the proxy, not the port number of the proxy itself.

`proxy` : | a GProxyAddress
Returns : | the `proxy`'s destination port

Since 2.26

### g_proxy_address_get_password ()

    const gchar *       g_proxy_address_get_password        (GProxyAddress *proxy);

Gets `proxy`'s password.

`proxy` : | a GProxyAddress
Returns : | the `proxy`'s password

Since 2.26

### g_proxy_address_get_protocol ()

    const gchar *       g_proxy_address_get_protocol        (GProxyAddress *proxy);

Gets `proxy`'s protocol. eg, "socks" or "http"

`proxy` : | a GProxyAddress
Returns : | the `proxy`'s protocol

Since 2.26

### g_proxy_address_get_username ()

    const gchar *       g_proxy_address_get_username        (GProxyAddress *proxy);

Gets `proxy`'s username.

`proxy` : | a GProxyAddress
Returns : | the `proxy`'s username

Since 2.26

### g_proxy_address_get_uri ()

    const gchar *       g_proxy_address_get_uri             (GProxyAddress *proxy);

Gets the proxy URI that `proxy` was constructed from.

`proxy` : | a GProxyAddress
Returns : | the `proxy`'s URI, or `NULL` if unknown

Since 2.34

### g_proxy_address_new ()

    GSocketAddress *    g_proxy_address_new                 (GInetAddress *inetaddr,
                                                             guint16 port,
                                                             const gchar *protocol,
                                                             const gchar *dest_hostname,
                                                             guint16 dest_port,
                                                             const gchar *username,
                                                             const gchar *password);

Creates a new GProxyAddress for `inetaddr` with `protocol` that should tunnel through `dest_hostname` and `dest_port`.

(Note that this method doesn't set the "uri" or "destination-protocol" fields; use `g_object_new()` directly if you want to set those.)

`inetaddr` : | The proxy server GInetAddress.
`port` : | The proxy server port.
`protocol` : | The proxy protocol to support, in lower case (e.g. socks, http).
`dest_hostname` : | The destination hostname the proxy should tunnel to.
`dest_port` : | The destination port to tunnel to.
`username` : | The username to authenticate to the proxy server (or `NULL`). [allow-none]
`password` : | The password to authenticate to the proxy server (or `NULL`). [allow-none]
Returns : | a new GProxyAddress

Since 2.26

## Property Details

### The `"destination-hostname"` property

      "destination-hostname"     gchar*                : Read / Write / Construct Only

The proxy destination hostname.

Default value: NULL

### The `"destination-port"` property

      "destination-port"         guint                 : Read / Write / Construct Only

The proxy destination port.

Allowed values: <= 65535

Default value: 0

### The `"destination-protocol"` property

      "destination-protocol"     gchar*                : Read / Write / Construct Only

The protocol being spoke to the destination host, or `NULL` if the GProxyAddress doesn't know.

Default value: NULL

Since 2.34

### The `"password"` property

      "password"                 gchar*                : Read / Write / Construct Only

The proxy password.

Default value: NULL

### The `"protocol"` property

      "protocol"                 gchar*                : Read / Write / Construct Only

The proxy protocol.

Default value: NULL

### The `"uri"` property

      "uri"                      gchar*                : Read / Write / Construct Only

The URI string that the proxy was constructed from (or `NULL` if the creator didn't specify this).

Default value: NULL

Since 2.34

### The `"username"` property

      "username"                 gchar*                : Read / Write / Construct Only

The proxy username.

Default value: NULL