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>libgsignon-glib Reference Manual: SignonSecurityContext</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.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.20 (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="10"><tr valign="middle">
  16 <td width="100%" align="left" class="shortcuts">
  17 <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
  18                   <a href="#SignonSecurityContext.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
  19                   <a href="#SignonSecurityContext.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
  20 </td>
  21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  22 <td><a accesskey="u" href="credential-management.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
  23 <td><a accesskey="p" href="SignonIdentityInfo.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  24 <td><a accesskey="n" href="SignonAuthSession.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  25 </tr></table>
  26 <div class="refentry">
  27 <a name="SignonSecurityContext"></a><div class="titlepage"></div>
  28 <div class="refnamediv"><table width="100%"><tr>
  29 <td valign="top">
  30 <h2><span class="refentrytitle"><a name="SignonSecurityContext.top_of_page"></a>SignonSecurityContext</span></h2>
  31 <p>SignonSecurityContext — representation of a security context.</p>
  32 </td>
  33 <td class="gallery_image" valign="top" align="right"></td>
  34 </tr></table></div>
  35 <div class="refsect1">
  36 <a name="SignonSecurityContext.functions"></a><h2>Functions</h2>
  37 <div class="informaltable"><table width="100%" border="0">
  38 <colgroup>
  39 <col width="150px" class="functions_return">
  40 <col class="functions_name">
  41 </colgroup>
  42 <tbody>
  43 <tr>
  44 <td class="function_type">
  45 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
  46 </td>
  47 <td class="function_name">
  48 <a class="link" href="SignonSecurityContext.html#signon-security-context-build-variant" title="signon_security_context_build_variant ()">signon_security_context_build_variant</a> <span class="c_punctuation">()</span>
  49 </td>
  50 </tr>
  51 <tr>
  52 <td class="function_type">
  53 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
  54 </td>
  55 <td class="function_name">
  56 <a class="link" href="SignonSecurityContext.html#signon-security-context-copy" title="signon_security_context_copy ()">signon_security_context_copy</a> <span class="c_punctuation">()</span>
  57 </td>
  58 </tr>
  59 <tr>
  60 <td class="function_type">
  61 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
  62 </td>
  63 <td class="function_name">
  64 <a class="link" href="SignonSecurityContext.html#signon-security-context-deconstruct-variant" title="signon_security_context_deconstruct_variant ()">signon_security_context_deconstruct_variant</a> <span class="c_punctuation">()</span>
  65 </td>
  66 </tr>
  67 <tr>
  68 <td class="function_type">
  69 <span class="returnvalue">void</span>
  70 </td>
  71 <td class="function_name">
  72 <a class="link" href="SignonSecurityContext.html#signon-security-context-free" title="signon_security_context_free ()">signon_security_context_free</a> <span class="c_punctuation">()</span>
  73 </td>
  74 </tr>
  75 <tr>
  76 <td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
  77 </td>
  78 <td class="function_name">
  79 <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> <span class="c_punctuation">()</span>
  80 </td>
  81 </tr>
  82 <tr>
  83 <td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
  84 </td>
  85 <td class="function_name">
  86 <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> <span class="c_punctuation">()</span>
  87 </td>
  88 </tr>
  89 <tr>
  90 <td class="function_type">
  91 <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
  92 </td>
  93 <td class="function_name">
  94 <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> <span class="c_punctuation">()</span>
  95 </td>
  96 </tr>
  97 <tr>
  98 <td class="function_type">
  99 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> *
 100 </td>
 101 <td class="function_name">
 102 <a class="link" href="SignonSecurityContext.html#signon-security-context-list-copy" title="signon_security_context_list_copy ()">signon_security_context_list_copy</a> <span class="c_punctuation">()</span>
 103 </td>
 104 </tr>
 105 <tr>
 106 <td class="function_type">
 107 <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> *
 108 </td>
 109 <td class="function_name">
 110 <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> <span class="c_punctuation">()</span>
 111 </td>
 112 </tr>
 113 <tr>
 114 <td class="function_type">
 115 <span class="returnvalue">void</span>
 116 </td>
 117 <td class="function_name">
 118 <a class="link" href="SignonSecurityContext.html#signon-security-context-list-free" title="signon_security_context_list_free ()">signon_security_context_list_free</a> <span class="c_punctuation">()</span>
 119 </td>
 120 </tr>
 121 <tr>
 122 <td class="function_type">
 123 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
 124 </td>
 125 <td class="function_name">
 126 <a class="link" href="SignonSecurityContext.html#signon-security-context-new" title="signon_security_context_new ()">signon_security_context_new</a> <span class="c_punctuation">()</span>
 127 </td>
 128 </tr>
 129 <tr>
 130 <td class="function_type">
 131 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
 132 </td>
 133 <td class="function_name">
 134 <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> <span class="c_punctuation">()</span>
 135 </td>
 136 </tr>
 137 <tr>
 138 <td class="function_type">
 139 <span class="returnvalue">void</span>
 140 </td>
 141 <td class="function_name">
 142 <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> <span class="c_punctuation">()</span>
 143 </td>
 144 </tr>
 145 <tr>
 146 <td class="function_type">
 147 <span class="returnvalue">void</span>
 148 </td>
 149 <td class="function_name">
 150 <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> <span class="c_punctuation">()</span>
 151 </td>
 152 </tr>
 153 </tbody>
 154 </table></div>
 155 </div>
 156 <div class="refsect1">
 157 <a name="SignonSecurityContext.other"></a><h2>Types and Values</h2>
 158 <div class="informaltable"><table width="100%" border="0">
 159 <colgroup>
 160 <col width="150px" class="name">
 161 <col class="description">
 162 </colgroup>
 163 <tbody>
 164 <tr>
 165 <td class="datatype_keyword">struct</td>
 166 <td class="function_name"><a class="link" href="SignonSecurityContext.html#SignonSecurityContext-struct" title="struct SignonSecurityContext">SignonSecurityContext</a></td>
 167 </tr>
 168 <tr>
 169 <td class="typedef_keyword">typedef</td>
 170 <td class="function_name"><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList">SignonSecurityContextList</a></td>
 171 </tr>
 172 </tbody>
 173 </table></div>
 174 </div>
 175 <div class="refsect1">
 176 <a name="SignonSecurityContext.object-hierarchy"></a><h2>Object Hierarchy</h2>
 177 <pre class="screen">    GBoxed
 178     <span class="lineart">╰──</span> SignonSecurityContext
 179 </pre>
 180 </div>
 181 <div class="refsect1">
 182 <a name="SignonSecurityContext.description"></a><h2>Description</h2>
 183 <p>The <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> represents a security context within
 184 system and also within application. Security contexts are used:</p>
 185 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 186 <li class="listitem"><p>within identities to specify the owner of the identity, and
 187 users of the identity (items on the access control list). See <a class="link" href="SignonIdentity.html" title="SignonIdentity"><span class="type">SignonIdentity</span></a>.</p></li>
 188 <li class="listitem"><p>by gSSO daemon to identify the application accessing the gSSO service and
 189 to determine if the application is an identity's owner, or is on the identity's access
 190 control list, and make access control decisions accordingly.</p></li>
 191 </ul></div>
 192 <p><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> contains two strings: a system context and an
 193 application context.</p>
 194 <p>System context can be a binary path, SMACK-label, or MSSF token. Specific
 195 interpretation of the system context value is performed by a gSSO extension module.
 196 The default gSSO extension expects binary paths.</p>
 197 <p>Application context identifies a script or a webpage within an application,
 198 and it's used for providing access control to runtime environments (when making an access
 199 control decision requires not only a binary identifier, but also information
 200 about what the binary is doing). </p>
 201 <p>System context and application context can contain a wildcard
 202 operator "*" to match 'any', while "" matches 'none' when a default
 203 gSSO extension is used. The system context is always evaluated first
 204 and if a match is found, only then the application context is evaluated.
 205 Check the documentation of a platform specific extension to determine
 206 any particular match rules used by a custom ACM (Access Control Manager).</p>
 207 </div>
 208 <div class="refsect1">
 209 <a name="SignonSecurityContext.functions_details"></a><h2>Functions</h2>
 210 <div class="refsect2">
 211 <a name="signon-security-context-build-variant"></a><h3>signon_security_context_build_variant ()</h3>
 212 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 213 signon_security_context_build_variant (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);</pre>
 214 <p>Build a GVariant of type "(ss)" from a <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</p>
 215 <div class="refsect3">
 216 <a name="id-1.3.3.5.7.2.5"></a><h4>Parameters</h4>
 217 <div class="informaltable"><table width="100%" border="0">
 218 <colgroup>
 219 <col width="150px" class="parameters_name">
 220 <col class="parameters_description">
 221 <col width="200px" class="parameters_annotations">
 222 </colgroup>
 223 <tbody><tr>
 224 <td class="parameter_name"><p>ctx</p></td>
 225 <td class="parameter_description"><p><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</p></td>
 226 <td class="parameter_annotations"> </td>
 227 </tr></tbody>
 228 </table></div>
 229 </div>
 230 <div class="refsect3">
 231 <a name="id-1.3.3.5.7.2.6"></a><h4>Returns</h4>
 232 <p> GVariant construct of a <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>. </p>
 233 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 234 </div>
 235 </div>
 236 <hr>
 237 <div class="refsect2">
 238 <a name="signon-security-context-copy"></a><h3>signon_security_context_copy ()</h3>
 239 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
 240 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>
 241 <p>Copy a security context item.</p>
 242 <div class="refsect3">
 243 <a name="id-1.3.3.5.7.3.5"></a><h4>Parameters</h4>
 244 <div class="informaltable"><table width="100%" border="0">
 245 <colgroup>
 246 <col width="150px" class="parameters_name">
 247 <col class="parameters_description">
 248 <col width="200px" class="parameters_annotations">
 249 </colgroup>
 250 <tbody><tr>
 251 <td class="parameter_name"><p>src_ctx</p></td>
 252 <td class="parameter_description"><p>source security context to copy.</p></td>
 253 <td class="parameter_annotations"> </td>
 254 </tr></tbody>
 255 </table></div>
 256 </div>
 257 <div class="refsect3">
 258 <a name="id-1.3.3.5.7.3.6"></a><h4>Returns</h4>
 259 <p> a copy of the <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item. </p>
 260 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 261 </div>
 262 </div>
 263 <hr>
 264 <div class="refsect2">
 265 <a name="signon-security-context-deconstruct-variant"></a><h3>signon_security_context_deconstruct_variant ()</h3>
 266 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
 267 signon_security_context_deconstruct_variant
 268                                (<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>
 269 <p>Builds a <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item from a GVariant of type "(ss)".</p>
 270 <div class="refsect3">
 271 <a name="id-1.3.3.5.7.4.5"></a><h4>Parameters</h4>
 272 <div class="informaltable"><table width="100%" border="0">
 273 <colgroup>
 274 <col width="150px" class="parameters_name">
 275 <col class="parameters_description">
 276 <col width="200px" class="parameters_annotations">
 277 </colgroup>
 278 <tbody><tr>
 279 <td class="parameter_name"><p>variant</p></td>
 280 <td class="parameter_description"><p>GVariant item with a <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> construct.</p></td>
 281 <td class="parameter_annotations"> </td>
 282 </tr></tbody>
 283 </table></div>
 284 </div>
 285 <div class="refsect3">
 286 <a name="id-1.3.3.5.7.4.6"></a><h4>Returns</h4>
 287 <p> <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item. </p>
 288 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 289 </div>
 290 </div>
 291 <hr>
 292 <div class="refsect2">
 293 <a name="signon-security-context-free"></a><h3>signon_security_context_free ()</h3>
 294 <pre class="programlisting"><span class="returnvalue">void</span>
 295 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>
 296 <p>Frees a security context item.</p>
 297 <div class="refsect3">
 298 <a name="id-1.3.3.5.7.5.5"></a><h4>Parameters</h4>
 299 <div class="informaltable"><table width="100%" border="0">
 300 <colgroup>
 301 <col width="150px" class="parameters_name">
 302 <col class="parameters_description">
 303 <col width="200px" class="parameters_annotations">
 304 </colgroup>
 305 <tbody><tr>
 306 <td class="parameter_name"><p>ctx</p></td>
 307 <td class="parameter_description"><p><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> to be freed.</p></td>
 308 <td class="parameter_annotations"> </td>
 309 </tr></tbody>
 310 </table></div>
 311 </div>
 312 </div>
 313 <hr>
 314 <div class="refsect2">
 315 <a name="signon-security-context-get-application-context"></a><h3>signon_security_context_get_application_context ()</h3>
 316 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 317 signon_security_context_get_application_context
 318                                (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);</pre>
 319 <p>Get the application context part (such as script name or a web page) of
 320 the <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.</p>
 321 <div class="refsect3">
 322 <a name="id-1.3.3.5.7.6.5"></a><h4>Parameters</h4>
 323 <div class="informaltable"><table width="100%" border="0">
 324 <colgroup>
 325 <col width="150px" class="parameters_name">
 326 <col class="parameters_description">
 327 <col width="200px" class="parameters_annotations">
 328 </colgroup>
 329 <tbody><tr>
 330 <td class="parameter_name"><p>ctx</p></td>
 331 <td class="parameter_description"><p><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</p></td>
 332 <td class="parameter_annotations"> </td>
 333 </tr></tbody>
 334 </table></div>
 335 </div>
 336 <div class="refsect3">
 337 <a name="id-1.3.3.5.7.6.6"></a><h4>Returns</h4>
 338 <p> application context. </p>
 339 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 340 </div>
 341 </div>
 342 <hr>
 343 <div class="refsect2">
 344 <a name="signon-security-context-get-system-context"></a><h3>signon_security_context_get_system_context ()</h3>
 345 <pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 346 signon_security_context_get_system_context
 347                                (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>);</pre>
 348 <p>Get the system context part (such as SMACK label or MSSF token) of the
 349 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.</p>
 350 <div class="refsect3">
 351 <a name="id-1.3.3.5.7.7.5"></a><h4>Parameters</h4>
 352 <div class="informaltable"><table width="100%" border="0">
 353 <colgroup>
 354 <col width="150px" class="parameters_name">
 355 <col class="parameters_description">
 356 <col width="200px" class="parameters_annotations">
 357 </colgroup>
 358 <tbody><tr>
 359 <td class="parameter_name"><p>ctx</p></td>
 360 <td class="parameter_description"><p><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</p></td>
 361 <td class="parameter_annotations"> </td>
 362 </tr></tbody>
 363 </table></div>
 364 </div>
 365 <div class="refsect3">
 366 <a name="id-1.3.3.5.7.7.6"></a><h4>Returns</h4>
 367 <p> system context. </p>
 368 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
 369 </div>
 370 </div>
 371 <hr>
 372 <div class="refsect2">
 373 <a name="signon-security-context-list-build-variant"></a><h3>signon_security_context_list_build_variant ()</h3>
 374 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="returnvalue">GVariant</span></a> *
 375 signon_security_context_list_build_variant
 376                                (<em class="parameter"><code>const <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> *list</code></em>);</pre>
 377 <p>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>
 378 items.</p>
 379 <div class="refsect3">
 380 <a name="id-1.3.3.5.7.8.5"></a><h4>Parameters</h4>
 381 <div class="informaltable"><table width="100%" border="0">
 382 <colgroup>
 383 <col width="150px" class="parameters_name">
 384 <col class="parameters_description">
 385 <col width="200px" class="parameters_annotations">
 386 </colgroup>
 387 <tbody><tr>
 388 <td class="parameter_name"><p>list</p></td>
 389 <td class="parameter_description"><p><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> item.</p></td>
 390 <td class="parameter_annotations"> </td>
 391 </tr></tbody>
 392 </table></div>
 393 </div>
 394 <div class="refsect3">
 395 <a name="id-1.3.3.5.7.8.6"></a><h4>Returns</h4>
 396 <p> GVariant construct of a <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a>. </p>
 397 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 398 </div>
 399 </div>
 400 <hr>
 401 <div class="refsect2">
 402 <a name="signon-security-context-list-copy"></a><h3>signon_security_context_list_copy ()</h3>
 403 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> *
 404 signon_security_context_list_copy (<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>
 405 <p>Copies a GList of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> items.</p>
 406 <div class="refsect3">
 407 <a name="id-1.3.3.5.7.9.5"></a><h4>Parameters</h4>
 408 <div class="informaltable"><table width="100%" border="0">
 409 <colgroup>
 410 <col width="150px" class="parameters_name">
 411 <col class="parameters_description">
 412 <col width="200px" class="parameters_annotations">
 413 </colgroup>
 414 <tbody><tr>
 415 <td class="parameter_name"><p>src_list</p></td>
 416 <td class="parameter_description"><p>source <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a>.</p></td>
 417 <td class="parameter_annotations"> </td>
 418 </tr></tbody>
 419 </table></div>
 420 </div>
 421 <div class="refsect3">
 422 <a name="id-1.3.3.5.7.9.6"></a><h4>Returns</h4>
 423 <p> <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> item. </p>
 424 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 425 </div>
 426 </div>
 427 <hr>
 428 <div class="refsect2">
 429 <a name="signon-security-context-list-deconstruct-variant"></a><h3>signon_security_context_list_deconstruct_variant ()</h3>
 430 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="returnvalue">SignonSecurityContextList</span></a> *
 431 signon_security_context_list_deconstruct_variant
 432                                (<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>
 433 <p>Builds a GList of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> items from a GVariant of type
 434 "a(ss)".</p>
 435 <div class="refsect3">
 436 <a name="id-1.3.3.5.7.10.5"></a><h4>Parameters</h4>
 437 <div class="informaltable"><table width="100%" border="0">
 438 <colgroup>
 439 <col width="150px" class="parameters_name">
 440 <col class="parameters_description">
 441 <col width="200px" class="parameters_annotations">
 442 </colgroup>
 443 <tbody><tr>
 444 <td class="parameter_name"><p>variant</p></td>
 445 <td class="parameter_description"><p>GVariant item with a list of security context tuples.</p></td>
 446 <td class="parameter_annotations"> </td>
 447 </tr></tbody>
 448 </table></div>
 449 </div>
 450 <div class="refsect3">
 451 <a name="id-1.3.3.5.7.10.6"></a><h4>Returns</h4>
 452 <p> <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> item. </p>
 453 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 454 </div>
 455 </div>
 456 <hr>
 457 <div class="refsect2">
 458 <a name="signon-security-context-list-free"></a><h3>signon_security_context_list_free ()</h3>
 459 <pre class="programlisting"><span class="returnvalue">void</span>
 460 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>
 461 <p>Frees all items and the GList of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.</p>
 462 <div class="refsect3">
 463 <a name="id-1.3.3.5.7.11.5"></a><h4>Parameters</h4>
 464 <div class="informaltable"><table width="100%" border="0">
 465 <colgroup>
 466 <col width="150px" class="parameters_name">
 467 <col class="parameters_description">
 468 <col width="200px" class="parameters_annotations">
 469 </colgroup>
 470 <tbody><tr>
 471 <td class="parameter_name"><p>seclist</p></td>
 472 <td class="parameter_description"><p> <a class="link" href="SignonSecurityContext.html#SignonSecurityContextList" title="SignonSecurityContextList"><span class="type">SignonSecurityContextList</span></a> item. </p></td>
 473 <td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
 474 </tr></tbody>
 475 </table></div>
 476 </div>
 477 </div>
 478 <hr>
 479 <div class="refsect2">
 480 <a name="signon-security-context-new"></a><h3>signon_security_context_new ()</h3>
 481 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
 482 signon_security_context_new ();</pre>
 483 <p>Allocates a new security context item.</p>
 484 <div class="refsect3">
 485 <a name="id-1.3.3.5.7.12.5"></a><h4>Returns</h4>
 486 <p> allocated <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>. </p>
 487 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 488 </div>
 489 </div>
 490 <hr>
 491 <div class="refsect2">
 492 <a name="signon-security-context-new-from-values"></a><h3>signon_security_context_new_from_values ()</h3>
 493 <pre class="programlisting"><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="returnvalue">SignonSecurityContext</span></a> *
 494 signon_security_context_new_from_values
 495                                (<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>,
 496                                 <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>
 497 <p>Allocates and initializes a new security context item.</p>
 498 <div class="refsect3">
 499 <a name="id-1.3.3.5.7.13.5"></a><h4>Parameters</h4>
 500 <div class="informaltable"><table width="100%" border="0">
 501 <colgroup>
 502 <col width="150px" class="parameters_name">
 503 <col class="parameters_description">
 504 <col width="200px" class="parameters_annotations">
 505 </colgroup>
 506 <tbody>
 507 <tr>
 508 <td class="parameter_name"><p>system_context</p></td>
 509 <td class="parameter_description"><p>system security context (such as SMACK/MSSF label/token).</p></td>
 510 <td class="parameter_annotations"> </td>
 511 </tr>
 512 <tr>
 513 <td class="parameter_name"><p>application_context</p></td>
 514 <td class="parameter_description"><p>application security context (such as a script name).</p></td>
 515 <td class="parameter_annotations"> </td>
 516 </tr>
 517 </tbody>
 518 </table></div>
 519 </div>
 520 <div class="refsect3">
 521 <a name="id-1.3.3.5.7.13.6"></a><h4>Returns</h4>
 522 <p> allocated <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>. </p>
 523 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 524 </div>
 525 </div>
 526 <hr>
 527 <div class="refsect2">
 528 <a name="signon-security-context-set-application-context"></a><h3>signon_security_context_set_application_context ()</h3>
 529 <pre class="programlisting"><span class="returnvalue">void</span>
 530 signon_security_context_set_application_context
 531                                (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>,
 532                                 <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>
 533 <p>Sets the application context part (such as a script name or a web page) of
 534 the <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.</p>
 535 <div class="refsect3">
 536 <a name="id-1.3.3.5.7.14.5"></a><h4>Parameters</h4>
 537 <div class="informaltable"><table width="100%" border="0">
 538 <colgroup>
 539 <col width="150px" class="parameters_name">
 540 <col class="parameters_description">
 541 <col width="200px" class="parameters_annotations">
 542 </colgroup>
 543 <tbody>
 544 <tr>
 545 <td class="parameter_name"><p>ctx</p></td>
 546 <td class="parameter_description"><p><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</p></td>
 547 <td class="parameter_annotations"> </td>
 548 </tr>
 549 <tr>
 550 <td class="parameter_name"><p>application_context</p></td>
 551 <td class="parameter_description"><p>application security context.</p></td>
 552 <td class="parameter_annotations"> </td>
 553 </tr>
 554 </tbody>
 555 </table></div>
 556 </div>
 557 </div>
 558 <hr>
 559 <div class="refsect2">
 560 <a name="signon-security-context-set-system-context"></a><h3>signon_security_context_set_system_context ()</h3>
 561 <pre class="programlisting"><span class="returnvalue">void</span>
 562 signon_security_context_set_system_context
 563                                (<em class="parameter"><code><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> *ctx</code></em>,
 564                                 <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>
 565 <p>Sets the system context part (such as SMACK label or MSSF token) of the
 566 <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a>.</p>
 567 <div class="refsect3">
 568 <a name="id-1.3.3.5.7.15.5"></a><h4>Parameters</h4>
 569 <div class="informaltable"><table width="100%" border="0">
 570 <colgroup>
 571 <col width="150px" class="parameters_name">
 572 <col class="parameters_description">
 573 <col width="200px" class="parameters_annotations">
 574 </colgroup>
 575 <tbody>
 576 <tr>
 577 <td class="parameter_name"><p>ctx</p></td>
 578 <td class="parameter_description"><p><a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> item.</p></td>
 579 <td class="parameter_annotations"> </td>
 580 </tr>
 581 <tr>
 582 <td class="parameter_name"><p>system_context</p></td>
 583 <td class="parameter_description"><p>system security context.</p></td>
 584 <td class="parameter_annotations"> </td>
 585 </tr>
 586 </tbody>
 587 </table></div>
 588 </div>
 589 </div>
 590 </div>
 591 <div class="refsect1">
 592 <a name="SignonSecurityContext.other_details"></a><h2>Types and Values</h2>
 593 <div class="refsect2">
 594 <a name="SignonSecurityContext-struct"></a><h3>struct SignonSecurityContext</h3>
 595 <pre class="programlisting">struct SignonSecurityContext {
 596     gchar *sys_ctx;
 597     gchar *app_ctx;
 598 };
 599 </pre>
 600 <p>Security context descriptor used for access control checks.</p>
 601 <div class="refsect3">
 602 <a name="id-1.3.3.5.8.2.5"></a><h4>Members</h4>
 603 <div class="informaltable"><table width="100%" border="0">
 604 <colgroup>
 605 <col width="300px" class="struct_members_name">
 606 <col class="struct_members_description">
 607 <col width="200px" class="struct_members_annotations">
 608 </colgroup>
 609 <tbody>
 610 <tr>
 611 <td class="struct_member_name"><p><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>;</p></td>
 612 <td class="struct_member_description"><p>system context, such as SMACK-label, MSSF token or just a
 613 binary path.</p></td>
 614 <td class="struct_member_annotations"> </td>
 615 </tr>
 616 <tr>
 617 <td class="struct_member_name"><p><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>;</p></td>
 618 <td class="struct_member_description"><p>application context, such as a script or a web page.</p></td>
 619 <td class="struct_member_annotations"> </td>
 620 </tr>
 621 </tbody>
 622 </table></div>
 623 </div>
 624 </div>
 625 <hr>
 626 <div class="refsect2">
 627 <a name="SignonSecurityContextList"></a><h3>SignonSecurityContextList</h3>
 628 <pre class="programlisting">typedef GList SignonSecurityContextList;
 629 </pre>
 630 <p>GList of <a class="link" href="SignonSecurityContext.html" title="SignonSecurityContext"><span class="type">SignonSecurityContext</span></a> items.</p>
 631 </div>
 632 </div>
 633 </div>
 634 <div class="footer">
 635 <hr>
 636           Generated by GTK-Doc V1.20</div>
 637 </body>
 638 </html>