1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GUPnPContext</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GUPnP Reference Manual">
8 <link rel="up" href="api-utility.html" title="Utility Functions">
9 <link rel="prev" href="api-utility.html" title="Utility Functions">
10 <link rel="next" href="GUPnPContextManager.html" title="GUPnPContextManager">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="api-utility.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="api-utility.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GUPnP Reference Manual</th>
21 <td><a accesskey="n" href="GUPnPContextManager.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GUPnPContext.synopsis" class="shortcut">Top</a>
26 <a href="#GUPnPContext.description" class="shortcut">Description</a>
28 <a href="#GUPnPContext.object-hierarchy" class="shortcut">Object Hierarchy</a>
30 <a href="#GUPnPContext.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
32 <a href="#GUPnPContext.properties" class="shortcut">Properties</a>
35 <div class="refentry">
36 <a name="GUPnPContext"></a><div class="titlepage"></div>
37 <div class="refnamediv"><table width="100%"><tr>
39 <h2><span class="refentrytitle"><a name="GUPnPContext.top_of_page"></a>GUPnPContext</span></h2>
40 <p>GUPnPContext — Context object wrapping shared networking bits.</p>
42 <td valign="top" align="right"></td>
44 <div class="refsynopsisdiv">
45 <a name="GUPnPContext.synopsis"></a><h2>Synopsis</h2>
46 <pre class="synopsis">struct <a class="link" href="GUPnPContext.html#GUPnPContext-struct" title="struct GUPnPContext">GUPnPContext</a>;
47 <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="returnvalue">GUPnPContext</span></a> * <a class="link" href="GUPnPContext.html#gupnp-context-new" title="gupnp_context_new ()">gupnp_context_new</a> (<em class="parameter"><code><span class="type">GMainContext</span> *main_context</code></em>,
48 <em class="parameter"><code>const <span class="type">char</span> *interface</code></em>,
49 <em class="parameter"><code><span class="type">guint</span> port</code></em>,
50 <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
51 const <span class="returnvalue">char</span> * <a class="link" href="GUPnPContext.html#gupnp-context-get-host-ip" title="gupnp_context_get_host_ip ()">gupnp_context_get_host_ip</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);
52 <span class="returnvalue">guint</span> <a class="link" href="GUPnPContext.html#gupnp-context-get-port" title="gupnp_context_get_port ()">gupnp_context_get_port</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);
53 <span class="returnvalue">SoupServer</span> * <a class="link" href="GUPnPContext.html#gupnp-context-get-server" title="gupnp_context_get_server ()">gupnp_context_get_server</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);
54 <span class="returnvalue">SoupSession</span> * <a class="link" href="GUPnPContext.html#gupnp-context-get-session" title="gupnp_context_get_session ()">gupnp_context_get_session</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);
55 <span class="returnvalue">void</span> <a class="link" href="GUPnPContext.html#gupnp-context-set-subscription-timeout" title="gupnp_context_set_subscription_timeout ()">gupnp_context_set_subscription_timeout</a>
56 (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
57 <em class="parameter"><code><span class="type">guint</span> timeout</code></em>);
58 <span class="returnvalue">guint</span> <a class="link" href="GUPnPContext.html#gupnp-context-get-subscription-timeout" title="gupnp_context_get_subscription_timeout ()">gupnp_context_get_subscription_timeout</a>
59 (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);
60 const <span class="returnvalue">char</span> * <a class="link" href="GUPnPContext.html#gupnp-context-get-default-language" title="gupnp_context_get_default_language ()">gupnp_context_get_default_language</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);
61 <span class="returnvalue">void</span> <a class="link" href="GUPnPContext.html#gupnp-context-set-default-language" title="gupnp_context_set_default_language ()">gupnp_context_set_default_language</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
62 <em class="parameter"><code>const <span class="type">char</span> *language</code></em>);
63 <span class="returnvalue">void</span> <a class="link" href="GUPnPContext.html#gupnp-context-host-path" title="gupnp_context_host_path ()">gupnp_context_host_path</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
64 <em class="parameter"><code>const <span class="type">char</span> *local_path</code></em>,
65 <em class="parameter"><code>const <span class="type">char</span> *server_path</code></em>);
66 <span class="returnvalue">gboolean</span> <a class="link" href="GUPnPContext.html#gupnp-context-host-path-for-agent" title="gupnp_context_host_path_for_agent ()">gupnp_context_host_path_for_agent</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
67 <em class="parameter"><code>const <span class="type">char</span> *local_path</code></em>,
68 <em class="parameter"><code>const <span class="type">char</span> *server_path</code></em>,
69 <em class="parameter"><code><span class="type">GRegex</span> *user_agent</code></em>);
70 <span class="returnvalue">void</span> <a class="link" href="GUPnPContext.html#gupnp-context-unhost-path" title="gupnp_context_unhost_path ()">gupnp_context_unhost_path</a> (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
71 <em class="parameter"><code>const <span class="type">char</span> *server_path</code></em>);
74 <div class="refsect1">
75 <a name="GUPnPContext.object-hierarchy"></a><h2>Object Hierarchy</h2>
76 <pre class="synopsis">
78 +----<a href="../gssdp/GSSDPClient.html">GSSDPClient</a>
82 <div class="refsect1">
83 <a name="GUPnPContext.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
85 GUPnPContext implements
88 <div class="refsect1">
89 <a name="GUPnPContext.properties"></a><h2>Properties</h2>
90 <pre class="synopsis">
91 "<a class="link" href="GUPnPContext.html#GUPnPContext--default-language" title='The "default-language" property'>default-language</a>" <span class="type">gchar</span>* : Read / Write / Construct
92 "<a class="link" href="GUPnPContext.html#GUPnPContext--port" title='The "port" property'>port</a>" <span class="type">guint</span> : Read / Write / Construct Only
93 "<a class="link" href="GUPnPContext.html#GUPnPContext--server" title='The "server" property'>server</a>" <span class="type">SoupServer</span>* : Read
94 "<a class="link" href="GUPnPContext.html#GUPnPContext--session" title='The "session" property'>session</a>" <span class="type">SoupSession</span>* : Read
95 "<a class="link" href="GUPnPContext.html#GUPnPContext--subscription-timeout" title='The "subscription-timeout" property'>subscription-timeout</a>" <span class="type">guint</span> : Read / Write / Construct Only
98 <div class="refsect1">
99 <a name="GUPnPContext.description"></a><h2>Description</h2>
101 <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> wraps the networking bits that are used by the various
102 GUPnP classes. It automatically starts a web server on demand.
105 For debugging, it is possible to see the messages being sent and received by
106 exporting <span class="type">GUPNP_DEBUG</span>.
109 <div class="refsect1">
110 <a name="GUPnPContext.details"></a><h2>Details</h2>
111 <div class="refsect2">
112 <a name="GUPnPContext-struct"></a><h3>struct GUPnPContext</h3>
113 <pre class="programlisting">struct GUPnPContext;</pre>
115 This struct contains private data only, and should be accessed using the
120 <div class="refsect2">
121 <a name="gupnp-context-new"></a><h3>gupnp_context_new ()</h3>
122 <pre class="programlisting"><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="returnvalue">GUPnPContext</span></a> * gupnp_context_new (<em class="parameter"><code><span class="type">GMainContext</span> *main_context</code></em>,
123 <em class="parameter"><code>const <span class="type">char</span> *interface</code></em>,
124 <em class="parameter"><code><span class="type">guint</span> port</code></em>,
125 <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
127 Create a new <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> with the specified <em class="parameter"><code>main_context</code></em>, <em class="parameter"><code>interface</code></em> and
128 <em class="parameter"><code>port</code></em>.
130 <div class="variablelist"><table border="0">
131 <col align="left" valign="top">
134 <td><p><span class="term"><em class="parameter"><code>main_context</code></em> :</span></p></td>
135 <td>Deprecated: 0.17.2: Always set to <code class="literal">NULL</code>. If you
136 want to use a different context, use <code class="function">g_main_context_push_thread_default()</code>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
140 <td><p><span class="term"><em class="parameter"><code>interface</code></em> :</span></p></td>
141 <td>The network interface to use, or <code class="literal">NULL</code> to
142 auto-detect. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
146 <td><p><span class="term"><em class="parameter"><code>port</code></em> :</span></p></td>
147 <td>Port to run on, or 0 if you don't care what port is used.</td>
150 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
151 <td>A location to store a <span class="type">GError</span>, or <code class="literal">NULL</code>
155 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
156 <td>A new <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> object, or <code class="literal">NULL</code> on an error</td>
162 <div class="refsect2">
163 <a name="gupnp-context-get-host-ip"></a><h3>gupnp_context_get_host_ip ()</h3>
164 <pre class="programlisting">const <span class="returnvalue">char</span> * gupnp_context_get_host_ip (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);</pre>
165 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
166 <h3 class="title">Warning</h3>
167 <p><code class="literal">gupnp_context_get_host_ip</code> has been deprecated since version 0.12.7 and should not be used in newly-written code. The "host-ip" property has moved to the base class
168 <a href="../gssdp/GSSDPClient.html"><span class="type">GSSDPClient</span></a> so newer applications should use
169 <a href="../gssdp/GSSDPClient.html#gssdp-client-get-host-ip"><span class="type">gssdp_client_get_host_ip</span></a> instead.</p>
172 Get the IP address we advertise ourselves as using.
174 <div class="variablelist"><table border="0">
175 <col align="left" valign="top">
178 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
179 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
183 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
184 <td>The IP address. This string should not be freed.</td>
190 <div class="refsect2">
191 <a name="gupnp-context-get-port"></a><h3>gupnp_context_get_port ()</h3>
192 <pre class="programlisting"><span class="returnvalue">guint</span> gupnp_context_get_port (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);</pre>
194 Get the port that the SOAP server is running on.
196 <div class="variablelist"><table border="0">
197 <col align="left" valign="top">
200 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
201 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
205 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
206 <td>The port the SOAP server is running on.</td>
212 <div class="refsect2">
213 <a name="gupnp-context-get-server"></a><h3>gupnp_context_get_server ()</h3>
214 <pre class="programlisting"><span class="returnvalue">SoupServer</span> * gupnp_context_get_server (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);</pre>
216 Get the <span class="type">SoupServer</span> HTTP server that GUPnP is using.
218 <div class="variablelist"><table border="0">
219 <col align="left" valign="top">
222 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
223 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
227 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
228 <td>The <span class="type">SoupServer</span> used by GUPnP. Do not unref this when finished. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
235 <div class="refsect2">
236 <a name="gupnp-context-get-session"></a><h3>gupnp_context_get_session ()</h3>
237 <pre class="programlisting"><span class="returnvalue">SoupSession</span> * gupnp_context_get_session (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);</pre>
239 Get the <span class="type">SoupSession</span> object that GUPnP is using.
241 <div class="variablelist"><table border="0">
242 <col align="left" valign="top">
245 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
246 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
250 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
251 <td>The <span class="type">SoupSession</span> used by GUPnP. Do not unref
252 this when finished. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
259 <div class="refsect2">
260 <a name="gupnp-context-set-subscription-timeout"></a><h3>gupnp_context_set_subscription_timeout ()</h3>
261 <pre class="programlisting"><span class="returnvalue">void</span> gupnp_context_set_subscription_timeout
262 (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
263 <em class="parameter"><code><span class="type">guint</span> timeout</code></em>);</pre>
265 Sets the event subscription timeout to <em class="parameter"><code>timeout</code></em>. Use 0 if you don't
266 want subscriptions to time out. Note that any client side subscriptions
267 will automatically be renewed.
269 <div class="variablelist"><table border="0">
270 <col align="left" valign="top">
273 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
274 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
278 <td><p><span class="term"><em class="parameter"><code>timeout</code></em> :</span></p></td>
279 <td>Event subscription timeout in seconds</td>
285 <div class="refsect2">
286 <a name="gupnp-context-get-subscription-timeout"></a><h3>gupnp_context_get_subscription_timeout ()</h3>
287 <pre class="programlisting"><span class="returnvalue">guint</span> gupnp_context_get_subscription_timeout
288 (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);</pre>
290 Get the event subscription timeout (in seconds), or 0 meaning there is no
293 <div class="variablelist"><table border="0">
294 <col align="left" valign="top">
297 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
298 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
302 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
303 <td>The event subscription timeout in seconds.</td>
309 <div class="refsect2">
310 <a name="gupnp-context-get-default-language"></a><h3>gupnp_context_get_default_language ()</h3>
311 <pre class="programlisting">const <span class="returnvalue">char</span> * gupnp_context_get_default_language (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>);</pre>
313 Get the default Content-Language header for this context.
315 <div class="variablelist"><table border="0">
316 <col align="left" valign="top">
319 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
320 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
324 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
325 <td>The default content of the Content-Language
326 header. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
333 <div class="refsect2">
334 <a name="gupnp-context-set-default-language"></a><h3>gupnp_context_set_default_language ()</h3>
335 <pre class="programlisting"><span class="returnvalue">void</span> gupnp_context_set_default_language (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
336 <em class="parameter"><code>const <span class="type">char</span> *language</code></em>);</pre>
338 Set the default language for the Content-Length header to <em class="parameter"><code>language</code></em>.
341 If the client sends an Accept-Language header the UPnP HTTP server
342 is required to send a Content-Language header in return. If there are
343 no files hosted in languages which match the requested ones the
344 Content-Language header is set to this value. The default value is "en".
346 <div class="variablelist"><table border="0">
347 <col align="left" valign="top">
349 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
350 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
351 <em class="parameter"><code>language</code></em> A language tag as defined in RFC 2616 3.10</td>
356 <div class="refsect2">
357 <a name="gupnp-context-host-path"></a><h3>gupnp_context_host_path ()</h3>
358 <pre class="programlisting"><span class="returnvalue">void</span> gupnp_context_host_path (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
359 <em class="parameter"><code>const <span class="type">char</span> *local_path</code></em>,
360 <em class="parameter"><code>const <span class="type">char</span> *server_path</code></em>);</pre>
362 Start hosting <em class="parameter"><code>local_path</code></em> at <em class="parameter"><code>server_path</code></em>. Files with the path
363 <em class="parameter"><code>local_path.LOCALE</code></em> (if they exist) will be served up when LOCALE is
364 specified in the request's Accept-Language header.
366 <div class="variablelist"><table border="0">
367 <col align="left" valign="top">
370 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
371 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
375 <td><p><span class="term"><em class="parameter"><code>local_path</code></em> :</span></p></td>
376 <td>Path to the local file or folder to be hosted</td>
379 <td><p><span class="term"><em class="parameter"><code>server_path</code></em> :</span></p></td>
380 <td>Web server path where <em class="parameter"><code>local_path</code></em> should be hosted</td>
386 <div class="refsect2">
387 <a name="gupnp-context-host-path-for-agent"></a><h3>gupnp_context_host_path_for_agent ()</h3>
388 <pre class="programlisting"><span class="returnvalue">gboolean</span> gupnp_context_host_path_for_agent (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
389 <em class="parameter"><code>const <span class="type">char</span> *local_path</code></em>,
390 <em class="parameter"><code>const <span class="type">char</span> *server_path</code></em>,
391 <em class="parameter"><code><span class="type">GRegex</span> *user_agent</code></em>);</pre>
393 Use this method to serve different local path to specific user-agent(s). The
394 path <em class="parameter"><code>server_path</code></em> must already be hosted by <em class="parameter"><code>context</code></em>.
396 <div class="variablelist"><table border="0">
397 <col align="left" valign="top">
400 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
401 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
405 <td><p><span class="term"><em class="parameter"><code>local_path</code></em> :</span></p></td>
406 <td>Path to the local file or folder to be hosted</td>
409 <td><p><span class="term"><em class="parameter"><code>server_path</code></em> :</span></p></td>
410 <td>Web server path already being hosted</td>
413 <td><p><span class="term"><em class="parameter"><code>user_agent</code></em> :</span></p></td>
414 <td>The user-agent as a <span class="type">GRegex</span>.</td>
417 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
419 <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise.</td>
425 <div class="refsect2">
426 <a name="gupnp-context-unhost-path"></a><h3>gupnp_context_unhost_path ()</h3>
427 <pre class="programlisting"><span class="returnvalue">void</span> gupnp_context_unhost_path (<em class="parameter"><code><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context</code></em>,
428 <em class="parameter"><code>const <span class="type">char</span> *server_path</code></em>);</pre>
430 Stop hosting the file or folder at <em class="parameter"><code>server_path</code></em>.
432 <div class="variablelist"><table border="0">
433 <col align="left" valign="top">
436 <td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
437 <td>A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>
441 <td><p><span class="term"><em class="parameter"><code>server_path</code></em> :</span></p></td>
442 <td>Web server path where the file or folder is hosted</td>
448 <div class="refsect1">
449 <a name="GUPnPContext.property-details"></a><h2>Property Details</h2>
450 <div class="refsect2">
451 <a name="GUPnPContext--default-language"></a><h3>The <code class="literal">"default-language"</code> property</h3>
452 <pre class="programlisting"> "default-language" <span class="type">gchar</span>* : Read / Write / Construct</pre>
454 The content of the Content-Language header id the client
455 sends Accept-Language and no language-specific pages to serve
456 exist. The property defaults to 'en'.
458 <p>Default value: "en"</p>
461 <div class="refsect2">
462 <a name="GUPnPContext--port"></a><h3>The <code class="literal">"port"</code> property</h3>
463 <pre class="programlisting"> "port" <span class="type">guint</span> : Read / Write / Construct Only</pre>
465 The port to run on. Set to 0 if you don't care what port to run on.
467 <p>Default value: 0</p>
470 <div class="refsect2">
471 <a name="GUPnPContext--server"></a><h3>The <code class="literal">"server"</code> property</h3>
472 <pre class="programlisting"> "server" <span class="type">SoupServer</span>* : Read</pre>
474 The <span class="type">SoupServer</span> HTTP server used by GUPnP.
478 <div class="refsect2">
479 <a name="GUPnPContext--session"></a><h3>The <code class="literal">"session"</code> property</h3>
480 <pre class="programlisting"> "session" <span class="type">SoupSession</span>* : Read</pre>
482 The <span class="type">SoupSession</span> object used by GUPnP.
486 <div class="refsect2">
487 <a name="GUPnPContext--subscription-timeout"></a><h3>The <code class="literal">"subscription-timeout"</code> property</h3>
488 <pre class="programlisting"> "subscription-timeout" <span class="type">guint</span> : Read / Write / Construct Only</pre>
490 The preferred subscription timeout: the number of seconds after
491 which subscriptions are renewed. Set to '0' if subscriptions
492 are never to time out.
494 <p>Allowed values: <= 604800</p>
495 <p>Default value: 1800</p>
501 Generated by GTK-Doc V1.18</div>