## GProxyAddress

GProxyAddress — An internet address with proxy information

## Synopsis

                        GProxyAddress;
                        GProxyAddressClass;
    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);
    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
      "password"                 gchar*                : Read / Write / Construct Only
      "protocol"                 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

### GProxyAddressClass

    typedef struct {
      GInetSocketAddressClass parent_class;
    } GProxyAddressClass;

### g_proxy_address_get_destination_hostname ()

    const gchar *       g_proxy_address_get_destination_hostname
                                                            (GProxyAddress *proxy);

Gets `proxy`'s destination hostname.

`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.

`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.

`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_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`.

`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 the proxy should tunnel to.
`dest_port` : | The destination port to tunnel to.
`username` : | The username to authenticate to the proxy server (or `NULL`).
`password` : | The password to authenticate to the proxy server (or `NULL`).
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 `"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 `"username"` property

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

The proxy username.

Default value: NULL