GskUrlTransferHttp

GskUrlTransferHttp — An HTTP- or HTTPS-based transfer.

Synopsis

                    GskUrlTransferHttp;
void                gsk_url_transfer_http_set_ssl_cert  (GskUrlTransferHttp *http,
                                                         const char *cert_fname);
void                gsk_url_transfer_http_set_ssl_key   (GskUrlTransferHttp *http,
                                                         const char *key_fname);
void                gsk_url_transfer_http_set_ssl_password
                                                        (GskUrlTransferHttp *http,
                                                         const char *password);
void                gsk_url_transfer_http_set_user_agent
                                                        (GskUrlTransferHttp *http,
                                                         const char *user_agent);
void                gsk_url_transfer_http_add_extra_header
                                                        (GskUrlTransferHttp *http,
                                                         const char *key,
                                                         const char *value);
void                gsk_url_transfer_http_set_proxy_address
                                                        (GskUrlTransferHttp *http,
                                                         GskSocketAddress *proxy_address);
void                (*GskUrlTransferHttpRequestModifierFunc)
                                                        (GskHttpRequest *request,
                                                         gpointer mod_data);
void                gsk_url_transfer_http_add_modifier  (GskUrlTransferHttp *http,
                                                         GskUrlTransferHttpRequestModifierFunc modifier,
                                                         gpointer data,
                                                         GDestroyNotify destroy);

Object Hierarchy

  GObject
   +----GskUrlTransfer
         +----GskUrlTransferHttp

Description

A transfer with an HTTP-based URL. In particular, this class defines many HTTP specific configurations.

Details

GskUrlTransferHttp

typedef struct _GskUrlTransferHttp GskUrlTransferHttp;


gsk_url_transfer_http_set_ssl_cert ()

void                gsk_url_transfer_http_set_ssl_cert  (GskUrlTransferHttp *http,
                                                         const char *cert_fname);

Set the SSL certificate file for this connection.

http :

the transfer to affect.

cert_fname :

the certificate filename.

gsk_url_transfer_http_set_ssl_key ()

void                gsk_url_transfer_http_set_ssl_key   (GskUrlTransferHttp *http,
                                                         const char *key_fname);

http :

key_fname :


gsk_url_transfer_http_set_ssl_password ()

void                gsk_url_transfer_http_set_ssl_password
                                                        (GskUrlTransferHttp *http,
                                                         const char *password);

http :

password :


gsk_url_transfer_http_set_user_agent ()

void                gsk_url_transfer_http_set_user_agent
                                                        (GskUrlTransferHttp *http,
                                                         const char *user_agent);

Set the User-Agent to use for this HTTP transaction.

http :

the transfer to affect.

user_agent :

the User-Agent: header's value for this transfer.

gsk_url_transfer_http_add_extra_header ()

void                gsk_url_transfer_http_add_extra_header
                                                        (GskUrlTransferHttp *http,
                                                         const char *key,
                                                         const char *value);

Add an arbitrary header to the HTTP request.

http :

the transfer to affect.

key :

a HTTP header name

value :

the value of that HTTP header.

gsk_url_transfer_http_set_proxy_address ()

void                gsk_url_transfer_http_set_proxy_address
                                                        (GskUrlTransferHttp *http,
                                                         GskSocketAddress *proxy_address);

Set an HTTP proxy for this transfer.

http :

the transfer to affect.

proxy_address :

the socket-address to really connect to.

GskUrlTransferHttpRequestModifierFunc ()

void                (*GskUrlTransferHttpRequestModifierFunc)
                                                        (GskHttpRequest *request,
                                                         gpointer mod_data);

request :

mod_data :


gsk_url_transfer_http_add_modifier ()

void                gsk_url_transfer_http_add_modifier  (GskUrlTransferHttp *http,
                                                         GskUrlTransferHttpRequestModifierFunc modifier,
                                                         gpointer data,
                                                         GDestroyNotify destroy);

Add a generic transformation to do to the HTTP request header.

http :

the transfer to affect.

modifier :

function to call to modify the HTTP request header.

data :

data to pass to modifier.

destroy :

called with data when the modifier is destroyed.

See Also

GskUrlTransfer.