|  |  |  | GUPnP Reference Manual |  | 
|---|---|---|---|---|
                    GUPnPContext;
GUPnPContext*       gupnp_context_new                   (GMainContext *main_context,
                                                         const char *host_ip,
                                                         guint port,
                                                         GError **error);
const char*         gupnp_context_get_host_ip           (GUPnPContext *context);
guint               gupnp_context_get_port              (GUPnPContext *context);
SoupServer*         gupnp_context_get_server            (GUPnPContext *context);
void                gupnp_context_set_subscription_timeout
                                                        (GUPnPContext *context,
                                                         guint timeout);
guint               gupnp_context_get_subscription_timeout
                                                        (GUPnPContext *context);
void                gupnp_context_host_path             (GUPnPContext *context,
                                                         const char *local_path,
                                                         const char *server_path);
void                gupnp_context_unhost_path           (GUPnPContext *context,
                                                         const char *server_path);
GUPnPContext wraps the networking bits that are used by the various GUPnP classes. It automatically starts a web server on demand.
GUPnPContext* gupnp_context_new (GMainContext *main_context, const char *host_ip, guint port, GError **error);
| main_context: | A GMainContext, or NULL to use the default one | 
| host_ip: | The local host's IP address, or NULL to use the IP address of the first non-loopback network interface. | 
| port: | Port to run on, or 0 if you don't care what port is used. | 
| error: | A location to store a GError, or NULL | 
| Returns : | A new GUPnPContext object. | 
const char* gupnp_context_get_host_ip (GUPnPContext *context);
| context: | A GUPnPContext | 
| Returns : | The IP address we advertise ourselves as using. Do not free. | 
guint gupnp_context_get_port (GUPnPContext *context);
| context: | A GUPnPContext | 
| Returns : | The port the SOAP server is running on. | 
SoupServer* gupnp_context_get_server (GUPnPContext *context);
| context: | A GUPnPContext | 
| Returns : | The SoupServer HTTP server used by GUPnP. | 
void                gupnp_context_set_subscription_timeout
                                                        (GUPnPContext *context,
                                                         guint timeout);
Sets the event subscription timeout to timeout. Use 0 if you don't
want subscriptions to time out. Note that any client side subscriptions
will automatically be renewed.
| context: | A GUPnPContext | 
| timeout: | Event subscription timeout in seconds | 
guint               gupnp_context_get_subscription_timeout
                                                        (GUPnPContext *context);
| context: | A GUPnPContext | 
| Returns : | The event subscription timeout in seconds, or 0, meaning no timeout. | 
void gupnp_context_host_path (GUPnPContext *context, const char *local_path, const char *server_path);
Start hosting local_path at server_path. Files with the path
local_path.LOCALE (if they exist) will be served up when LOCALE is
specified in the request's Accept-Language header.
| context: | A GUPnPContext | 
| local_path: | Path to the local file or folder to be hosted | 
| server_path: | Web server path where local_pathshould be hosted | 
void gupnp_context_unhost_path (GUPnPContext *context, const char *server_path);
Stop hosting the file or folder at server_path.
| context: | A GUPnPContext | 
| server_path: | Web server path where the file or folder is hosted |