gupnp_context_new ()

GUPnPContext *
gupnp_context_new (GMainContext *main_context,
                   const char *iface,
                   guint port,
                   GError **error);

Create a new GUPnPContext with the specified main_context , iface and port .

gupnp_context_get_host_ip ()

const char *
gupnp_context_get_host_ip (GUPnPContext *context);

Get the IP address we advertise ourselves as using.

gupnp_context_get_port ()

guint
gupnp_context_get_port (GUPnPContext *context);

Get the port that the SOAP server is running on.

gupnp_context_get_server ()

SoupServer *
gupnp_context_get_server (GUPnPContext *context);

Get the SoupServer HTTP server that GUPnP is using.

gupnp_context_get_session ()

SoupSession *
gupnp_context_get_session (GUPnPContext *context);

Get the SoupSession object that GUPnP is using.

Since: 0.12.3

gupnp_context_set_subscription_timeout ()

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.

gupnp_context_get_subscription_timeout ()

guint
gupnp_context_get_subscription_timeout
                               (GUPnPContext *context);

Get the event subscription timeout (in seconds), or 0 meaning there is no timeout.

gupnp_context_get_default_language ()

const char *
gupnp_context_get_default_language (GUPnPContext *context);

Get the default Content-Language header for this context.

Since: 0.17.0

gupnp_context_set_default_language ()

void
gupnp_context_set_default_language (GUPnPContext *context,
                                    const char *language);

Set the default language for the Content-Length header to language .

If the client sends an Accept-Language header the UPnP HTTP server is required to send a Content-Language header in return. If there are no files hosted in languages which match the requested ones the Content-Language header is set to this value. The default value is "en".

Since: 0.17.0

gupnp_context_add_server_handler ()

void
gupnp_context_add_server_handler (GUPnPContext *context,
                                  gboolean use_acl,
                                  const char *path,
                                  SoupServerCallback callback,
                                  gpointer user_data,
                                  GDestroyNotify destroy);

Add a SoupServerCallback to the GUPnPContext's SoupServer.

Since: 0.20.11

gupnp_context_remove_server_handler ()

void
gupnp_context_remove_server_handler (GUPnPContext *context,
                                     const char *path);

Remove a SoupServerCallback from the GUPnPContext's SoupServer.

Since: 0.20.11

gupnp_context_host_path ()

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.

gupnp_context_host_path_for_agent ()

gboolean
gupnp_context_host_path_for_agent (GUPnPContext *context,
                                   const char *local_path,
                                   const char *server_path,
                                   GRegex *user_agent);

Use this method to serve different local path to specific user-agent(s). The path server_path must already be hosted by context .

Since: 0.13.3

gupnp_context_unhost_path ()

void
gupnp_context_unhost_path (GUPnPContext *context,
                           const char *server_path);

Stop hosting the file or folder at server_path .

gupnp_context_get_acl ()

GUPnPAcl *
gupnp_context_get_acl (GUPnPContext *context);

Since: 0.20.11

gupnp_context_set_acl ()

void
gupnp_context_set_acl (GUPnPContext *context,
                       GUPnPAcl *acl);

Since: 0.20.11

struct GUPnPContext

struct GUPnPContext;

This struct contains private data only, and should be accessed using the functions below.

The “acl” property

  “acl”                      GUPnPAcl *

An access control list.

Flags: Read / Write / Construct

Since: 0.20.11

The “default-language” property

  “default-language”         gchar *

The content of the Content-Language header id the client sends Accept-Language and no language-specific pages to serve exist. The property defaults to 'en'.

Flags: Read / Write / Construct

Default value: "en"

Since: 0.17.0

The “port” property

  “port”                     guint

The port to run on. Set to 0 if you don't care what port to run on.

Flags: Read / Write / Construct Only

Default value: 0

The “server” property

  “server”                   SoupServer *

The SoupServer HTTP server used by GUPnP.

Flags: Read

The “session” property

  “session”                  SoupSession *

The SoupSession object used by GUPnP.

Flags: Read

The “subscription-timeout” property

  “subscription-timeout”     guint

The preferred subscription timeout: the number of seconds after which subscriptions are renewed. Set to '0' if subscriptions are never to time out.

Flags: Read / Write / Construct Only

Allowed values: <= 604800

Default value: 1800