| SOUP Reference Manual |
|---|
void soup_load_config (gchar *config_file); void soup_shutdown (void); void soup_set_proxy (SoupContext *context); SoupContext* soup_get_proxy (void); void soup_set_connection_limit (guint max_conn); guint soup_get_connection_limit (void); enum SoupSecurityPolicy; void soup_set_security_policy (SoupSecurityPolicy policy); SoupSecurityPolicy soup_get_security_policy (void); void soup_debug_print_headers (SoupMessage *req); void soup_debug_print_uri (SoupUri *uri);
void soup_load_config (gchar *config_file);
Load the Soup configuration from file. First attempt to load the system configuration from SYSCONFDIR/souprc, then from either the config file name passed in config_file, or from .souprc in the user's home directory.
The first time a message is sent using Soup, the configuration is loaded from the system souprc file, and the user's souprc file.
soup_load_config can be called multiple times. Each time settings will be reset and reread from scratch.
| config_file : | The file to load configuration from. If NULL, load from .souprc in user's home directory. |
void soup_shutdown (void);
Shut down the Soup engine.
The pending message queue is flushed by calling soup_message_cancel on all active requests.
void soup_set_proxy (SoupContext *context);
Use context as the SoupContext to connect to instead of the actual destination specified in a SoupMessage. Messages will be routed through the proxy host on their way to the actual specified destination. The URL for this context should be of the form: [http|https|socks4|socks5]://<USERNAME>:<PASSWORD>@<PROXYHOST>
| context : | a SoupContext to use as the proxy context for all outgoing connections. |
SoupContext* soup_get_proxy (void);
Get the current proxy SoupContext.
| Returns : | the current proxy context. |
void soup_set_connection_limit (guint max_conn);
Set the maximum concurrent connection limit for outgoing requests.
| max_conn : | the number of connections. |
guint soup_get_connection_limit (void);
| Returns : | The maximum concurrent connection limit for outgoing requests. |
typedef enum {
SOUP_SECURITY_DOMESTIC = 1,
SOUP_SECURITY_EXPORT = 2,
SOUP_SECURITY_FRANCE = 3
} SoupSecurityPolicy;void soup_set_security_policy (SoupSecurityPolicy policy);
Set the security policy for all secure SSL connections. The security policy dictates which algorithms and encryption levels can be used in order to conform to your country's security legislation.
| policy : | the SoupSecurityPolicy to use. |
SoupSecurityPolicy soup_get_security_policy (void);
| Returns : | The security policy to use for secure SSL connections. |
| <<< soup-message | soup-parser >>> |