docs/reference/html/SignonSecurityContext.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>SignonSecurityContext</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="libgsignon-glib Reference Manual">
   8 <link rel="up" href="credential-management.html" title="Credential management">
   9 <link rel="prev" href="SignonIdentityInfo.html" title="SignonIdentityInfo">
  10 <link rel="next" href="SignonAuthSession.html" title="SignonAuthSession">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  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">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="SignonIdentityInfo.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="credential-management.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">libgsignon-glib Reference Manual</th>
  21 <td><a accesskey="n" href="SignonAuthSession.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#SignonSecurityContext.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#SignonSecurityContext.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#SignonSecurityContext.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29 </td></tr>
  30 </table>
  31 <div class="refentry">
  32 <a name="SignonSecurityContext"></a><div class="titlepage"></div>
  33 <div class="refnamediv"><table width="100%"><tr>
  34 <td valign="top">
  35 <h2><span class="refentrytitle"><a name="SignonSecurityContext.top_of_page"></a>SignonSecurityContext</span></h2>
  36 <p>SignonSecurityContext — representation of a security context.</p>
  37 </td>
  38 <td valign="top" align="right"></td>
  39 </tr></table></div>
  40 <div class="refsynopsisdiv">
  41 <a name="SignonSecurityContext.synopsis"></a><h2>Synopsis</h2>
  42 <pre class="synopsis">struct              <a class="link" href="SignonSecurityContext.html#SignonSecurityContext-struct" title="struct SignonSecurityContext">SignonSecurityContext</a>;
  43 typedef             <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList">SignonSecurityContextList</a>;
  44 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *          <a class="link" href="SignonSecurityContext.html#signon-security-context-build-variant" title="signon_security_context_build_variant ()">signon_security_context_build_variant</a>
  45                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);
  46 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> * <a class="link" href="SignonSecurityContext.html#signon-security-context-copy" title="signon_security_context_copy ()">signon_security_context_copy</a>    (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *src_ctx</code></em>);
  47 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> * <a class="link" href="SignonSecurityContext.html#signon-security-context-deconstruct-variant" title="signon_security_context_deconstruct_variant ()">signon_security_context_deconstruct_variant</a>
  48                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *variant</code></em>);
  49 <span class="returnvalue">void</span>                <a class="link" href="SignonSecurityContext.html#signon-security-context-free" title="signon_security_context_free ()">signon_security_context_free</a>        (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);
  50 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="SignonSecurityContext.html#signon-security-context-get-application-context" title="signon_security_context_get_application_context ()">signon_security_context_get_application_context</a>
  51                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);
  52 const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="SignonSecurityContext.html#signon-security-context-get-system-context" title="signon_security_context_get_system_context ()">signon_security_context_get_system_context</a>
  53                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);
  54 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *          <a class="link" href="SignonSecurityContext.html#signon-security-context-list-build-variant" title="signon_security_context_list_build_variant ()">signon_security_context_list_build_variant</a>
  55                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *list</code></em>);
  56 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> * <a class="link" href="SignonSecurityContext.html#signon-security-context-list-copy" title="signon_security_context_list_copy ()">signon_security_context_list_copy</a>
  57                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *src_list</code></em>);
  58 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> * <a class="link" href="SignonSecurityContext.html#signon-security-context-list-deconstruct-variant" title="signon_security_context_list_deconstruct_variant ()">signon_security_context_list_deconstruct_variant</a>
  59                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *variant</code></em>);
  60 <span class="returnvalue">void</span>                <a class="link" href="SignonSecurityContext.html#signon-security-context-list-free" title="signon_security_context_list_free ()">signon_security_context_list_free</a>   (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *seclist</code></em>);
  61 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> * <a class="link" href="SignonSecurityContext.html#signon-security-context-new" title="signon_security_context_new ()">signon_security_context_new</a>     ();
  62 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> * <a class="link" href="SignonSecurityContext.html#signon-security-context-new-from-values" title="signon_security_context_new_from_values ()">signon_security_context_new_from_values</a>
  63                                                         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *system_context</code></em>,
  64                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application_context</code></em>);
  65 <span class="returnvalue">void</span>                <a class="link" href="SignonSecurityContext.html#signon-security-context-set-application-context" title="signon_security_context_set_application_context ()">signon_security_context_set_application_context</a>
  66                                                         (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>,
  67                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application_context</code></em>);
  68 <span class="returnvalue">void</span>                <a class="link" href="SignonSecurityContext.html#signon-security-context-set-system-context" title="signon_security_context_set_system_context ()">signon_security_context_set_system_context</a>
  69                                                         (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>,
  70                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *system_context</code></em>);
  71 </pre>
  72 </div>
  73 <div class="refsect1">
  74 <a name="SignonSecurityContext.object-hierarchy"></a><h2>Object Hierarchy</h2>
  75 <pre class="synopsis">
  76   GBoxed
  77    +----SignonSecurityContext
  78 </pre>
  79 </div>
  80 <div class="refsect1">
  81 <a name="SignonSecurityContext.description"></a><h2>Description</h2>
  82 <p>
  83 The <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> represents a security context within
  84 system and also within application. Security contexts are used:
  85 </p>
  86 <p>
  87 </p>
  88 <div class="itemizedlist"><ul class="itemizedlist" type="disc">
  89 <li class="listitem"><p>within identities to specify the owner of the identity, and
  90 users of the identity (items on the access control list). See <span class="type">SignonIdentity</span>.</p></li>
  91 <li class="listitem"><p>by gSSO daemon to identify the application accessing the gSSO service and
  92 to determine if the application is an identity's owner, or is on the identity's access
  93 control list, and make access control decisions accordingly.</p></li>
  94 </ul></div>
  95 <p>
  96 </p>
  97 <p>
  98 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> contains two strings: a system context and an
  99 application context.
 100 </p>
 101 <p>
 102 System context can be a binary path, SMACK-label, or MSSF token. Specific
 103 interpretation of the system context value is performed by a gSSO extension module.
 104 The default gSSO extension expects binary paths.
 105 </p>
 106 <p>
 107 Application context identifies a script or a webpage within an application,
 108 and it's used for providing access control to runtime environments (when making an access
 109 control decision requires not only a binary identifier, but also information
 110 about what the binary is doing).
 111 </p>
 112 <p>
 113 System context and application context can contain a wildcard
 114 operator "*" to match 'any', while "" matches 'none' when a default
 115 gSSO extension is used. The system context is always evaluated first
 116 and if a match is found, only then the application context is evaluated.
 117 Check the documentation of a platform specific extension to determine
 118 any particular match rules used by a custom ACM (Access Control Manager).
 119 </p>
 120 </div>
 121 <div class="refsect1">
 122 <a name="SignonSecurityContext.details"></a><h2>Details</h2>
 123 <div class="refsect2">
 124 <a name="SignonSecurityContext-struct"></a><h3>struct SignonSecurityContext</h3>
 125 <pre class="programlisting">struct SignonSecurityContext {
 126     gchar *sys_ctx;
 127     gchar *app_ctx;
 128 };
 129 </pre>
 130 <p>
 131 Security context descriptor used for access control checks.
 132 </p>
 133 <div class="variablelist"><table border="0">
 134 <col align="left" valign="top">
 135 <tbody>
 136 <tr>
 137 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="SignonSecurityContext-struct.sys-ctx"></a>sys_ctx</code></em>;</span></p></td>
 138 <td>system context, such as SMACK-label, MSSF token or just a
 139 binary path.</td>
 140 </tr>
 141 <tr>
 142 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="SignonSecurityContext-struct.app-ctx"></a>app_ctx</code></em>;</span></p></td>
 143 <td>application context, such as a script or a web page.</td>
 144 </tr>
 145 </tbody>
 146 </table></div>
 147 </div>
 148 <hr>
 149 <div class="refsect2">
 150 <a name="SignonSecurityContextList"></a><h3>SignonSecurityContextList</h3>
 151 <pre class="programlisting">typedef GList SignonSecurityContextList;
 152 </pre>
 153 <p>
 154 GList of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> items.
 155 </p>
 156 </div>
 157 <hr>
 158 <div class="refsect2">
 159 <a name="signon-security-context-build-variant"></a><h3>signon_security_context_build_variant ()</h3>
 160 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *          signon_security_context_build_variant
 161                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);</pre>
 162 <p>
 163 Build a GVariant of type "(ss)" from a <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.
 164 </p>
 165 <div class="variablelist"><table border="0">
 166 <col align="left" valign="top">
 167 <tbody>
 168 <tr>
 169 <td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
 170 <td>
 171 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</td>
 172 </tr>
 173 <tr>
 174 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 175 <td>GVariant construct of a <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 176 </td>
 177 </tr>
 178 </tbody>
 179 </table></div>
 180 </div>
 181 <hr>
 182 <div class="refsect2">
 183 <a name="signon-security-context-copy"></a><h3>signon_security_context_copy ()</h3>
 184 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> * signon_security_context_copy    (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *src_ctx</code></em>);</pre>
 185 <p>
 186 Copy a security context item.
 187 </p>
 188 <div class="variablelist"><table border="0">
 189 <col align="left" valign="top">
 190 <tbody>
 191 <tr>
 192 <td><p><span class="term"><em class="parameter"><code>src_ctx</code></em> :</span></p></td>
 193 <td>source security context to copy.</td>
 194 </tr>
 195 <tr>
 196 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 197 <td>a copy of the <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 198 </td>
 199 </tr>
 200 </tbody>
 201 </table></div>
 202 </div>
 203 <hr>
 204 <div class="refsect2">
 205 <a name="signon-security-context-deconstruct-variant"></a><h3>signon_security_context_deconstruct_variant ()</h3>
 206 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> * signon_security_context_deconstruct_variant
 207                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *variant</code></em>);</pre>
 208 <p>
 209 Builds a <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item from a GVariant of type "(ss)".
 210 </p>
 211 <div class="variablelist"><table border="0">
 212 <col align="left" valign="top">
 213 <tbody>
 214 <tr>
 215 <td><p><span class="term"><em class="parameter"><code>variant</code></em> :</span></p></td>
 216 <td>GVariant item with a <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> construct.</td>
 217 </tr>
 218 <tr>
 219 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 220 <td>
 221 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 222 </td>
 223 </tr>
 224 </tbody>
 225 </table></div>
 226 </div>
 227 <hr>
 228 <div class="refsect2">
 229 <a name="signon-security-context-free"></a><h3>signon_security_context_free ()</h3>
 230 <pre class="programlisting"><span class="returnvalue">void</span>                signon_security_context_free        (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);</pre>
 231 <p>
 232 Frees a security context item.
 233 </p>
 234 <div class="variablelist"><table border="0">
 235 <col align="left" valign="top">
 236 <tbody><tr>
 237 <td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
 238 <td>
 239 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> to be freed.</td>
 240 </tr></tbody>
 241 </table></div>
 242 </div>
 243 <hr>
 244 <div class="refsect2">
 245 <a name="signon-security-context-get-application-context"></a><h3>signon_security_context_get_application_context ()</h3>
 246 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       signon_security_context_get_application_context
 247                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);</pre>
 248 <p>
 249 Get the application context part (such as script name or a web page) of
 250 the <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.
 251 </p>
 252 <div class="variablelist"><table border="0">
 253 <col align="left" valign="top">
 254 <tbody>
 255 <tr>
 256 <td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
 257 <td>
 258 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</td>
 259 </tr>
 260 <tr>
 261 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 262 <td>application context. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 263 </td>
 264 </tr>
 265 </tbody>
 266 </table></div>
 267 </div>
 268 <hr>
 269 <div class="refsect2">
 270 <a name="signon-security-context-get-system-context"></a><h3>signon_security_context_get_system_context ()</h3>
 271 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       signon_security_context_get_system_context
 272                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);</pre>
 273 <p>
 274 Get the system context part (such as SMACK label or MSSF token) of the
 275 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.
 276 </p>
 277 <div class="variablelist"><table border="0">
 278 <col align="left" valign="top">
 279 <tbody>
 280 <tr>
 281 <td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
 282 <td>
 283 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</td>
 284 </tr>
 285 <tr>
 286 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 287 <td>system context. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 288 </td>
 289 </tr>
 290 </tbody>
 291 </table></div>
 292 </div>
 293 <hr>
 294 <div class="refsect2">
 295 <a name="signon-security-context-list-build-variant"></a><h3>signon_security_context_list_build_variant ()</h3>
 296 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *          signon_security_context_list_build_variant
 297                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *list</code></em>);</pre>
 298 <p>
 299 Builds a GVariant of type "a(ss)" from a GList of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>
 300 items.
 301 </p>
 302 <div class="variablelist"><table border="0">
 303 <col align="left" valign="top">
 304 <tbody>
 305 <tr>
 306 <td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
 307 <td>
 308 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> item.</td>
 309 </tr>
 310 <tr>
 311 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 312 <td>GVariant construct of a <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 313 </td>
 314 </tr>
 315 </tbody>
 316 </table></div>
 317 </div>
 318 <hr>
 319 <div class="refsect2">
 320 <a name="signon-security-context-list-copy"></a><h3>signon_security_context_list_copy ()</h3>
 321 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> * signon_security_context_list_copy
 322                                                         (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *src_list</code></em>);</pre>
 323 <p>
 324 Copies a GList of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> items.
 325 </p>
 326 <div class="variablelist"><table border="0">
 327 <col align="left" valign="top">
 328 <tbody>
 329 <tr>
 330 <td><p><span class="term"><em class="parameter"><code>src_list</code></em> :</span></p></td>
 331 <td>source <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a>.</td>
 332 </tr>
 333 <tr>
 334 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 335 <td>
 336 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> item. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 337 </td>
 338 </tr>
 339 </tbody>
 340 </table></div>
 341 </div>
 342 <hr>
 343 <div class="refsect2">
 344 <a name="signon-security-context-list-deconstruct-variant"></a><h3>signon_security_context_list_deconstruct_variant ()</h3>
 345 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> * signon_security_context_list_deconstruct_variant
 346                                                         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> *variant</code></em>);</pre>
 347 <p>
 348 Builds a GList of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> items from a GVariant of type
 349 "a(ss)".
 350 </p>
 351 <div class="variablelist"><table border="0">
 352 <col align="left" valign="top">
 353 <tbody>
 354 <tr>
 355 <td><p><span class="term"><em class="parameter"><code>variant</code></em> :</span></p></td>
 356 <td>GVariant item with a list of security context tuples.</td>
 357 </tr>
 358 <tr>
 359 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 360 <td>
 361 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> item. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 362 </td>
 363 </tr>
 364 </tbody>
 365 </table></div>
 366 </div>
 367 <hr>
 368 <div class="refsect2">
 369 <a name="signon-security-context-list-free"></a><h3>signon_security_context_list_free ()</h3>
 370 <pre class="programlisting"><span class="returnvalue">void</span>                signon_security_context_list_free   (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *seclist</code></em>);</pre>
 371 <p>
 372 Frees all items and the GList of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.
 373 </p>
 374 <div class="variablelist"><table border="0">
 375 <col align="left" valign="top">
 376 <tbody><tr>
 377 <td><p><span class="term"><em class="parameter"><code>seclist</code></em> :</span></p></td>
 378 <td>
 379 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> item. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 380 </td>
 381 </tr></tbody>
 382 </table></div>
 383 </div>
 384 <hr>
 385 <div class="refsect2">
 386 <a name="signon-security-context-new"></a><h3>signon_security_context_new ()</h3>
 387 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> * signon_security_context_new     ();</pre>
 388 <p>
 389 Allocates a new security context item.
 390 </p>
 391 <div class="variablelist"><table border="0">
 392 <col align="left" valign="top">
 393 <tbody><tr>
 394 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 395 <td>allocated <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 396 </td>
 397 </tr></tbody>
 398 </table></div>
 399 </div>
 400 <hr>
 401 <div class="refsect2">
 402 <a name="signon-security-context-new-from-values"></a><h3>signon_security_context_new_from_values ()</h3>
 403 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> * signon_security_context_new_from_values
 404                                                         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *system_context</code></em>,
 405                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application_context</code></em>);</pre>
 406 <p>
 407 Allocates and initializes a new security context item.
 408 </p>
 409 <div class="variablelist"><table border="0">
 410 <col align="left" valign="top">
 411 <tbody>
 412 <tr>
 413 <td><p><span class="term"><em class="parameter"><code>system_context</code></em> :</span></p></td>
 414 <td>system security context (such as SMACK/MSSF label/token).</td>
 415 </tr>
 416 <tr>
 417 <td><p><span class="term"><em class="parameter"><code>application_context</code></em> :</span></p></td>
 418 <td>application security context (such as a script name).</td>
 419 </tr>
 420 <tr>
 421 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 422 <td>allocated <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 423 </td>
 424 </tr>
 425 </tbody>
 426 </table></div>
 427 </div>
 428 <hr>
 429 <div class="refsect2">
 430 <a name="signon-security-context-set-application-context"></a><h3>signon_security_context_set_application_context ()</h3>
 431 <pre class="programlisting"><span class="returnvalue">void</span>                signon_security_context_set_application_context
 432                                                         (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>,
 433                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *application_context</code></em>);</pre>
 434 <p>
 435 Sets the application context part (such as a script name or a web page) of
 436 the <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.
 437 </p>
 438 <div class="variablelist"><table border="0">
 439 <col align="left" valign="top">
 440 <tbody>
 441 <tr>
 442 <td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
 443 <td>
 444 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</td>
 445 </tr>
 446 <tr>
 447 <td><p><span class="term"><em class="parameter"><code>application_context</code></em> :</span></p></td>
 448 <td>application security context.</td>
 449 </tr>
 450 </tbody>
 451 </table></div>
 452 </div>
 453 <hr>
 454 <div class="refsect2">
 455 <a name="signon-security-context-set-system-context"></a><h3>signon_security_context_set_system_context ()</h3>
 456 <pre class="programlisting"><span class="returnvalue">void</span>                signon_security_context_set_system_context
 457                                                         (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>,
 458                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *system_context</code></em>);</pre>
 459 <p>
 460 Sets the system context part (such as SMACK label or MSSF token) of the
 461 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.
 462 </p>
 463 <div class="variablelist"><table border="0">
 464 <col align="left" valign="top">
 465 <tbody>
 466 <tr>
 467 <td><p><span class="term"><em class="parameter"><code>ctx</code></em> :</span></p></td>
 468 <td>
 469 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</td>
 470 </tr>
 471 <tr>
 472 <td><p><span class="term"><em class="parameter"><code>system_context</code></em> :</span></p></td>
 473 <td>system security context.</td>
 474 </tr>
 475 </tbody>
 476 </table></div>
 477 </div>
 478 </div>
 479 </div>
 480 <div class="footer">
 481 <hr>
 482           Generated by GTK-Doc V1.18</div>
 483 </body>
 484 </html>