1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>LassoSession</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Lasso Reference Manual"><link rel="up" href="architecture.html" title="Lasso Architecture"><link rel="prev" href="LassoIdentity.html" title="LassoIdentity"><link rel="next" href="LassoFederation.html" title="LassoFederation"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="lasso.html" title="Lasso & Liberty Alliance Overview"><link rel="chapter" href="architecture.html" title="Lasso Architecture"><link rel="chapter" href="idff.html" title="Identity Federation Framework"><link rel="chapter" href="idwsf.html" title="Identity Web Services Framework"><link rel="chapter" href="xml.html" title="Schemas"><link rel="chapter" href="misc.html" title="Misc"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="LassoIdentity.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="architecture.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Lasso Reference Manual</th><td><a accesskey="n" href="LassoFederation.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="LassoSession"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle">LassoSession</span></h2><p>LassoSession — Principal Session</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
3
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
4
<title>LassoSession</title>
5
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
6
<link rel="start" href="index.html" title="Lasso Reference Manual">
7
<link rel="up" href="architecture.html" title="Lasso Architecture">
8
<link rel="prev" href="LassoIdentity.html" title="LassoIdentity">
9
<link rel="next" href="LassoFederation.html" title="LassoFederation">
10
<meta name="generator" content="GTK-Doc V1.4 (XML mode)">
11
<link rel="stylesheet" href="style.css" type="text/css">
12
<link rel="chapter" href="lasso.html" title="Lasso & Liberty Alliance Overview">
13
<link rel="chapter" href="architecture.html" title="Lasso Architecture">
14
<link rel="chapter" href="idff.html" title="Identity Federation Framework">
15
<link rel="chapter" href="idwsf.html" title="Identity Web Services Framework">
16
<link rel="chapter" href="xml.html" title="Schemas">
17
<link rel="chapter" href="misc.html" title="Misc">
19
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
20
<table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
21
<td><a accesskey="p" href="LassoIdentity.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
22
<td><a accesskey="u" href="architecture.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
23
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
24
<th width="100%" align="center">Lasso Reference Manual</th>
25
<td><a accesskey="n" href="LassoFederation.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
27
<div class="refentry" lang="en">
28
<a name="LassoSession"></a><div class="titlepage"></div>
29
<div class="refnamediv"><table width="100%"><tr>
31
<h2><span class="refentrytitle">LassoSession</span></h2>
32
<p>LassoSession — Principal Session</p>
34
<td valign="top" align="right"></td>
36
<div class="refsynopsisdiv">
38
<pre class="synopsis">
3
40
#include <lasso/lasso.h>
15
52
<GTKDOCLINK HREF="gint">gint</GTKDOCLINK> index);
16
53
<GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK> <a href="LassoSession.html#lasso-session-is-empty">lasso_session_is_empty</a> (<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session);
18
</pre></div><div class="refsect1" lang="en"><a name="id2538825"></a><h2>Object Hierarchy</h2><pre class="synopsis">
57
<div class="refsect1" lang="en">
58
<a name="id2523528"></a><h2>Object Hierarchy</h2>
59
<pre class="synopsis">
20
61
<GTKDOCLINK HREF="GObject">GObject</GTKDOCLINK>
21
62
+----<a href="LassoNode.html" title="LassoNode">LassoNode</a>
23
</pre></div><div class="refsect1" lang="en"><a name="id2538852"></a><h2>Description</h2><p>
66
<div class="refsect1" lang="en">
67
<a name="id2523555"></a><h2>Description</h2>
25
</p></div><div class="refsect1" lang="en"><a name="id2538862"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2538867"></a><h3><a name="LassoSession-struct"></a>LassoSession</h3><a class="indexterm" name="id2538878"></a><pre class="programlisting">typedef struct {
72
<div class="refsect1" lang="en">
73
<a name="id2523565"></a><h2>Details</h2>
74
<div class="refsect2" lang="en">
75
<a name="id2523570"></a><h3>
76
<a name="LassoSession-struct"></a>LassoSession</h3>
77
<a class="indexterm" name="id2523580"></a><pre class="programlisting">typedef struct {
26
78
GHashTable *assertions;
31
</p></div><hr><div class="refsect2" lang="en"><a name="id2538894"></a><h3><a name="lasso-session-new"></a>lasso_session_new ()</h3><a class="indexterm" name="id2538905"></a><pre class="programlisting"><a href="LassoSession.html" title="LassoSession">LassoSession</a>* lasso_session_new (void);</pre><p>
32
Creates a new <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>.</p><p>
34
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> a newly created <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
35
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2538961"></a><h3><a name="lasso-session-new-from-dump"></a>lasso_session_new_from_dump ()</h3><a class="indexterm" name="id2538973"></a><pre class="programlisting"><a href="LassoSession.html" title="LassoSession">LassoSession</a>* lasso_session_new_from_dump (const <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *dump);</pre><p>
36
Restores the <em class="parameter"><code>dump</code></em> to a new <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>.</p><p>
38
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>dump</code></em>�:</span></td><td> XML server dump
39
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> a newly created <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>; or NULL if an error occured
40
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2539056"></a><h3><a name="lasso-session-destroy"></a>lasso_session_destroy ()</h3><a class="indexterm" name="id2539067"></a><pre class="programlisting"><GTKDOCLINK HREF="void">void</GTKDOCLINK> lasso_session_destroy (<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session);</pre><p>
41
Destroys a session.</p><p>
43
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>session</code></em>�:</span></td><td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
44
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2539125"></a><h3><a name="lasso-session-dump"></a>lasso_session_dump ()</h3><a class="indexterm" name="id2539136"></a><pre class="programlisting"><GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK>* lasso_session_dump (<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session);</pre><p>
45
Dumps <em class="parameter"><code>session</code></em> content to an XML string.</p><p>
47
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>session</code></em>�:</span></td><td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
48
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> the dump string. It must be freed by the caller.
49
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2539211"></a><h3><a name="lasso-session-get-assertions"></a>lasso_session_get_assertions ()</h3><a class="indexterm" name="id2539223"></a><pre class="programlisting"><GTKDOCLINK HREF="GList">GList</GTKDOCLINK>* lasso_session_get_assertions (<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session,
50
const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *provider_id);</pre><p>
51
Gets the assertions for the given <em class="parameter"><code>provider_id</code></em>.</p><p>
53
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>session</code></em>�:</span></td><td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
54
</td></tr><tr><td><span class="term"><em class="parameter"><code>provider_id</code></em>�:</span></td><td> the provider ID
55
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> a GList* of <a href="LassoSamlAssertion.html" title="LassoSamlAssertion"><span class="type">LassoSamlAssertion</span></a>. Caller must free the GList
87
<div class="refsect2" lang="en">
88
<a name="id2523597"></a><h3>
89
<a name="lasso-session-new"></a>lasso_session_new ()</h3>
90
<a class="indexterm" name="id2523607"></a><pre class="programlisting"><a href="LassoSession.html" title="LassoSession">LassoSession</a>* lasso_session_new (void);</pre>
92
Creates a new <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>.</p>
96
<div class="variablelist"><table border="0">
97
<col align="left" valign="top">
100
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
101
<td> a newly created <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
107
<div class="refsect2" lang="en">
108
<a name="id2523663"></a><h3>
109
<a name="lasso-session-new-from-dump"></a>lasso_session_new_from_dump ()</h3>
110
<a class="indexterm" name="id2523674"></a><pre class="programlisting"><a href="LassoSession.html" title="LassoSession">LassoSession</a>* lasso_session_new_from_dump (const <GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK> *dump);</pre>
112
Restores the <em class="parameter"><code>dump</code></em> to a new <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>.</p>
116
<div class="variablelist"><table border="0">
117
<col align="left" valign="top">
121
<span class="term"><em class="parameter"><code>dump</code></em> :</span></td>
127
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
128
<td> a newly created <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>; or NULL if an error occured
135
<div class="refsect2" lang="en">
136
<a name="id2523758"></a><h3>
137
<a name="lasso-session-destroy"></a>lasso_session_destroy ()</h3>
138
<a class="indexterm" name="id2523768"></a><pre class="programlisting"><GTKDOCLINK HREF="void">void</GTKDOCLINK> lasso_session_destroy (<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session);</pre>
140
Destroys a session.</p>
144
<div class="variablelist"><table border="0">
145
<col align="left" valign="top">
148
<span class="term"><em class="parameter"><code>session</code></em> :</span></td>
149
<td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
155
<div class="refsect2" lang="en">
156
<a name="id2523826"></a><h3>
157
<a name="lasso-session-dump"></a>lasso_session_dump ()</h3>
158
<a class="indexterm" name="id2523837"></a><pre class="programlisting"><GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK>* lasso_session_dump (<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session);</pre>
160
Dumps <em class="parameter"><code>session</code></em> content to an XML string.</p>
164
<div class="variablelist"><table border="0">
165
<col align="left" valign="top">
169
<span class="term"><em class="parameter"><code>session</code></em> :</span></td>
170
<td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
175
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
176
<td> the dump string. It must be freed by the caller.
183
<div class="refsect2" lang="en">
184
<a name="id2523912"></a><h3>
185
<a name="lasso-session-get-assertions"></a>lasso_session_get_assertions ()</h3>
186
<a class="indexterm" name="id2523923"></a><pre class="programlisting"><GTKDOCLINK HREF="GList">GList</GTKDOCLINK>* lasso_session_get_assertions (<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session,
187
const <GTKDOCLINK HREF="char">char</GTKDOCLINK> *provider_id);</pre>
189
Gets the assertions for the given <em class="parameter"><code>provider_id</code></em>.</p>
193
<div class="variablelist"><table border="0">
194
<col align="left" valign="top">
198
<span class="term"><em class="parameter"><code>session</code></em> :</span></td>
199
<td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
204
<span class="term"><em class="parameter"><code>provider_id</code></em> :</span></td>
210
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
211
<td> a GList* of <a href="LassoSamlAssertion.html" title="LassoSamlAssertion"><span class="type">LassoSamlAssertion</span></a>. Caller must free the GList
56
212
and the assertions it contains.
57
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2539330"></a><h3><a name="lasso-session-get-provider-index"></a>lasso_session_get_provider_index ()</h3><a class="indexterm" name="id2539341"></a><pre class="programlisting"><GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK>* lasso_session_get_provider_index
219
<div class="refsect2" lang="en">
220
<a name="id2524029"></a><h3>
221
<a name="lasso-session-get-provider-index"></a>lasso_session_get_provider_index ()</h3>
222
<a class="indexterm" name="id2524040"></a><pre class="programlisting"><GTKDOCLINK HREF="gchar">gchar</GTKDOCLINK>* lasso_session_get_provider_index
58
223
(<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session,
59
<GTKDOCLINK HREF="gint">gint</GTKDOCLINK> index);</pre><p>
60
Looks up and returns the nth provider id.</p><p>
224
<GTKDOCLINK HREF="gint">gint</GTKDOCLINK> index);</pre>
226
Looks up and returns the nth provider id.</p>
62
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>session</code></em>�:</span></td><td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
63
</td></tr><tr><td><span class="term"><em class="parameter"><code>index</code></em>�:</span></td><td> index of requested provider
64
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> the provider id; or NULL if there were no nth provider. This
230
<div class="variablelist"><table border="0">
231
<col align="left" valign="top">
235
<span class="term"><em class="parameter"><code>session</code></em> :</span></td>
236
<td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
241
<span class="term"><em class="parameter"><code>index</code></em> :</span></td>
242
<td> index of requested provider
247
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
248
<td> the provider id; or NULL if there were no nth provider. This
65
249
string must be freed by the caller.
66
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2539435"></a><h3><a name="lasso-session-is-empty"></a>lasso_session_is_empty ()</h3><a class="indexterm" name="id2539446"></a><pre class="programlisting"><GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK> lasso_session_is_empty (<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session);</pre><p>
67
Returns <code class="literal">TRUE</code> if session is empty.</p><p>
256
<div class="refsect2" lang="en">
257
<a name="id2524134"></a><h3>
258
<a name="lasso-session-is-empty"></a>lasso_session_is_empty ()</h3>
259
<a class="indexterm" name="id2524144"></a><pre class="programlisting"><GTKDOCLINK HREF="gboolean">gboolean</GTKDOCLINK> lasso_session_is_empty (<a href="LassoSession.html" title="LassoSession">LassoSession</a> *session);</pre>
261
Returns <code class="literal">TRUE</code> if session is empty.</p>
69
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>session</code></em>�:</span></td><td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
70
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>�:</span></td><td> <code class="literal">TRUE</code> if empty
71
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="LassoIdentity.html"><b><<�LassoIdentity</b></a></td><td align="right"><a accesskey="n" href="LassoFederation.html"><b>LassoFederation�>></b></a></td></tr></table></body></html>
265
<div class="variablelist"><table border="0">
266
<col align="left" valign="top">
270
<span class="term"><em class="parameter"><code>session</code></em> :</span></td>
271
<td> a <a href="LassoSession.html" title="LassoSession"><span class="type">LassoSession</span></a>
276
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
277
<td> <code class="literal">TRUE</code> if empty
285
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
286
<td align="left"><a accesskey="p" href="LassoIdentity.html"><b><< LassoIdentity</b></a></td>
287
<td align="right"><a accesskey="n" href="LassoFederation.html"><b>LassoFederation >></b></a></td>