1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<title>GckSession</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
<link rel="home" href="index.html" title="GCK Reference Manual">
8
<link rel="up" href="ch01.html" title="PKCS#11 GObject Bindings">
9
<link rel="prev" href="GckSlot.html" title="GckSlot">
10
<link rel="next" href="GckObject.html" title="GckObject">
11
<meta name="generator" content="GTK-Doc V1.16 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17
<td><a accesskey="p" href="GckSlot.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
<td><a accesskey="u" href="ch01.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">GCK Reference Manual</th>
21
<td><a accesskey="n" href="GckObject.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23
<tr><td colspan="5" class="shortcuts">
24
<a href="#GckSession.synopsis" class="shortcut">Top</a>
26
<a href="#GckSession.description" class="shortcut">Description</a>
28
<a href="#GckSession.object-hierarchy" class="shortcut">Object Hierarchy</a>
30
<a href="#GckSession.properties" class="shortcut">Properties</a>
32
<a href="#GckSession.signals" class="shortcut">Signals</a>
35
<div class="refentry">
36
<a name="GckSession"></a><div class="titlepage"></div>
37
<div class="refnamediv"><table width="100%"><tr>
39
<h2><span class="refentrytitle"><a name="GckSession.top_of_page"></a>GckSession</span></h2>
40
<p>GckSession — Represents an open PKCS11 session.</p>
42
<td valign="top" align="right"></td>
44
<div class="refsynopsisdiv">
45
<a name="GckSession.synopsis"></a><h2>Synopsis</h2>
46
<pre class="synopsis">struct <a class="link" href="GckSession.html#GckSession-struct" title="struct GckSession">GckSession</a>;
47
<a class="link" href="GckSession.html" title="GckSession"><span class="returnvalue">GckSession</span></a> * <a class="link" href="GckSession.html#gck-session-from-handle" title="gck_session_from_handle ()">gck_session_from_handle</a> (<em class="parameter"><code><a class="link" href="GckSlot.html" title="GckSlot"><span class="type">GckSlot</span></a> *slot</code></em>,
48
<em class="parameter"><code><span class="type">CK_SESSION_HANDLE</span> handle</code></em>,
49
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> options</code></em>);
50
<a class="link" href="GckModule.html" title="GckModule"><span class="returnvalue">GckModule</span></a> * <a class="link" href="GckSession.html#gck-session-get-module" title="gck_session_get_module ()">gck_session_get_module</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>);
51
<a class="link" href="GckSlot.html" title="GckSlot"><span class="returnvalue">GckSlot</span></a> * <a class="link" href="GckSession.html#gck-session-get-slot" title="gck_session_get_slot ()">gck_session_get_slot</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>);
52
<span class="returnvalue">CK_SESSION_HANDLE</span> <a class="link" href="GckSession.html#gck-session-get-handle" title="gck_session_get_handle ()">gck_session_get_handle</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>);
53
<a class="link" href="GckSession.html#GckSessionInfo" title="GckSessionInfo"><span class="returnvalue">GckSessionInfo</span></a> * <a class="link" href="GckSession.html#gck-session-get-info" title="gck_session_get_info ()">gck_session_get_info</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>);
54
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckSession.html#gck-session-login" title="gck_session_login ()">gck_session_login</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
55
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> user_type</code></em>,
56
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *pin</code></em>,
57
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_pin</code></em>,
58
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
59
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
60
<span class="returnvalue">void</span> <a class="link" href="GckSession.html#gck-session-login-async" title="gck_session_login_async ()">gck_session_login_async</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
61
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> user_type</code></em>,
62
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *pin</code></em>,
63
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_pin</code></em>,
64
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
65
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
66
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
67
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckSession.html#gck-session-login-finish" title="gck_session_login_finish ()">gck_session_login_finish</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
68
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
69
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
70
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckSession.html#gck-session-logout" title="gck_session_logout ()">gck_session_logout</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
71
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
72
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
73
<span class="returnvalue">void</span> <a class="link" href="GckSession.html#gck-session-logout-async" title="gck_session_logout_async ()">gck_session_logout_async</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
74
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
75
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
76
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
77
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckSession.html#gck-session-logout-finish" title="gck_session_logout_finish ()">gck_session_logout_finish</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
78
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
79
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
80
<a class="link" href="GckObject.html" title="GckObject"><span class="returnvalue">GckObject</span></a> * <a class="link" href="GckSession.html#gck-session-create-object" title="gck_session_create_object ()">gck_session_create_object</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
81
<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
82
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
83
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
84
<span class="returnvalue">void</span> <a class="link" href="GckSession.html#gck-session-create-object-async" title="gck_session_create_object_async ()">gck_session_create_object_async</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
85
<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
86
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
87
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
88
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
89
<a class="link" href="GckObject.html" title="GckObject"><span class="returnvalue">GckObject</span></a> * <a class="link" href="GckSession.html#gck-session-create-object-finish" title="gck_session_create_object_finish ()">gck_session_create_object_finish</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
90
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
91
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
92
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="GckSession.html#gck-session-find-objects" title="gck_session_find_objects ()">gck_session_find_objects</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
93
<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
94
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
95
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
96
<span class="returnvalue">void</span> <a class="link" href="GckSession.html#gck-session-find-objects-async" title="gck_session_find_objects_async ()">gck_session_find_objects_async</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
97
<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
98
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
99
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
100
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
101
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * <a class="link" href="GckSession.html#gck-session-find-objects-finish" title="gck_session_find_objects_finish ()">gck_session_find_objects_finish</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
102
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
103
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
104
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GckSession.html#gck-session-encrypt" title="gck_session_encrypt ()">gck_session_encrypt</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
105
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
106
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mech_type</code></em>,
107
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
108
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
109
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
110
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
111
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
112
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GckSession.html#gck-session-encrypt-full" title="gck_session_encrypt_full ()">gck_session_encrypt_full</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
113
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
114
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
115
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
116
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
117
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
118
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
119
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
120
<span class="returnvalue">void</span> <a class="link" href="GckSession.html#gck-session-encrypt-async" title="gck_session_encrypt_async ()">gck_session_encrypt_async</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
121
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
122
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
123
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
124
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
125
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
126
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
127
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
128
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GckSession.html#gck-session-encrypt-finish" title="gck_session_encrypt_finish ()">gck_session_encrypt_finish</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
129
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
130
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
131
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
132
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GckSession.html#gck-session-decrypt" title="gck_session_decrypt ()">gck_session_decrypt</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
133
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
134
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mech_type</code></em>,
135
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
136
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
137
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
138
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
139
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
140
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GckSession.html#gck-session-decrypt-full" title="gck_session_decrypt_full ()">gck_session_decrypt_full</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
141
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
142
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
143
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
144
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
145
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
146
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
147
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
148
<span class="returnvalue">void</span> <a class="link" href="GckSession.html#gck-session-decrypt-async" title="gck_session_decrypt_async ()">gck_session_decrypt_async</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
149
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
150
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
151
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
152
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
153
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
154
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
155
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
156
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GckSession.html#gck-session-decrypt-finish" title="gck_session_decrypt_finish ()">gck_session_decrypt_finish</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
157
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
158
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
159
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
160
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GckSession.html#gck-session-sign" title="gck_session_sign ()">gck_session_sign</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
161
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
162
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mech_type</code></em>,
163
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
164
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
165
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
166
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
167
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
168
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GckSession.html#gck-session-sign-full" title="gck_session_sign_full ()">gck_session_sign_full</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
169
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
170
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
171
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
172
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
173
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
174
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
175
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
176
<span class="returnvalue">void</span> <a class="link" href="GckSession.html#gck-session-sign-async" title="gck_session_sign_async ()">gck_session_sign_async</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
177
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
178
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
179
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
180
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
181
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
182
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
183
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
184
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * <a class="link" href="GckSession.html#gck-session-sign-finish" title="gck_session_sign_finish ()">gck_session_sign_finish</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
185
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
186
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
187
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
188
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckSession.html#gck-session-verify" title="gck_session_verify ()">gck_session_verify</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
189
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
190
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mech_type</code></em>,
191
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
192
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
193
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *signature</code></em>,
194
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_signature</code></em>,
195
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
196
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
197
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckSession.html#gck-session-verify-full" title="gck_session_verify_full ()">gck_session_verify_full</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
198
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
199
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
200
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
201
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
202
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *signature</code></em>,
203
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_signature</code></em>,
204
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
205
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
206
<span class="returnvalue">void</span> <a class="link" href="GckSession.html#gck-session-verify-async" title="gck_session_verify_async ()">gck_session_verify_async</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
207
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
208
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
209
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
210
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
211
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *signature</code></em>,
212
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_signature</code></em>,
213
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
214
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
215
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
216
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GckSession.html#gck-session-verify-finish" title="gck_session_verify_finish ()">gck_session_verify_finish</a> (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
217
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
218
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
219
<a class="link" href="GckSession.html#GckSessionInfo" title="GckSessionInfo">GckSessionInfo</a>;
220
<span class="returnvalue">void</span> <a class="link" href="GckSession.html#gck-session-info-free" title="gck_session_info_free ()">gck_session_info_free</a> (<em class="parameter"><code><a class="link" href="GckSession.html#GckSessionInfo" title="GckSessionInfo"><span class="type">GckSessionInfo</span></a> *session_info</code></em>);
221
<a class="link" href="GckSession.html#GckMechanism" title="GckMechanism">GckMechanism</a>;
224
<div class="refsect1">
225
<a name="GckSession.object-hierarchy"></a><h2>Object Hierarchy</h2>
226
<pre class="synopsis">
227
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
231
<div class="refsect1">
232
<a name="GckSession.properties"></a><h2>Properties</h2>
233
<pre class="synopsis">
234
"<a class="link" href="GckSession.html#GckSession--handle" title='The "handle" property'>handle</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> : Read / Write / Construct Only
235
"<a class="link" href="GckSession.html#GckSession--module" title='The "module" property'>module</a>" <a class="link" href="GckModule.html" title="GckModule"><span class="type">GckModule</span></a>* : Read / Write / Construct Only
236
"<a class="link" href="GckSession.html#GckSession--options" title='The "options" property'>options</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read / Write / Construct Only
237
"<a class="link" href="GckSession.html#GckSession--slot" title='The "slot" property'>slot</a>" <a class="link" href="GckSlot.html" title="GckSlot"><span class="type">GckSlot</span></a>* : Read / Write / Construct Only
240
<div class="refsect1">
241
<a name="GckSession.signals"></a><h2>Signals</h2>
242
<pre class="synopsis">
243
"<a class="link" href="GckSession.html#GckSession-discard-handle" title='The "discard-handle" signal'>discard-handle</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
246
<div class="refsect1">
247
<a name="GckSession.description"></a><h2>Description</h2>
249
Before performing any PKCS11 operations, a session must be opened. This is
250
analogous to an open database handle, or a file handle.
253
<div class="refsect1">
254
<a name="GckSession.details"></a><h2>Details</h2>
255
<div class="refsect2">
256
<a name="GckSession-struct"></a><h3>struct GckSession</h3>
257
<pre class="programlisting">struct GckSession;</pre>
259
Represents an open PKCS11 session.
263
<div class="refsect2">
264
<a name="gck-session-from-handle"></a><h3>gck_session_from_handle ()</h3>
265
<pre class="programlisting"><a class="link" href="GckSession.html" title="GckSession"><span class="returnvalue">GckSession</span></a> * gck_session_from_handle (<em class="parameter"><code><a class="link" href="GckSlot.html" title="GckSlot"><span class="type">GckSlot</span></a> *slot</code></em>,
266
<em class="parameter"><code><span class="type">CK_SESSION_HANDLE</span> handle</code></em>,
267
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> options</code></em>);</pre>
269
Initialize a GckSession object from a raw PKCS<span class="type">11</span> session handle.
270
Usually one would use the <a class="link" href="GckSlot.html#gck-slot-open-session" title="gck_slot_open_session ()"><code class="function">gck_slot_open_session()</code></a> function to
273
<div class="variablelist"><table border="0">
274
<col align="left" valign="top">
277
<td><p><span class="term"><em class="parameter"><code>slot</code></em> :</span></p></td>
278
<td>The slot which the session belongs to.</td>
281
<td><p><span class="term"><em class="parameter"><code>handle</code></em> :</span></p></td>
282
<td>The raw PKCS<span class="type">11</span> handle of the session.</td>
285
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
286
<td>Session options. Those which are used during opening a session have no effect.</td>
289
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
290
<td>The new GckSession object.</td>
296
<div class="refsect2">
297
<a name="gck-session-get-module"></a><h3>gck_session_get_module ()</h3>
298
<pre class="programlisting"><a class="link" href="GckModule.html" title="GckModule"><span class="returnvalue">GckModule</span></a> * gck_session_get_module (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>);</pre>
300
Get the PKCS<span class="type">11</span> module to which this session belongs.
302
<div class="variablelist"><table border="0">
303
<col align="left" valign="top">
306
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
307
<td>The session object.</td>
310
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
311
<td>The module, which should be unreffed after use.</td>
317
<div class="refsect2">
318
<a name="gck-session-get-slot"></a><h3>gck_session_get_slot ()</h3>
319
<pre class="programlisting"><a class="link" href="GckSlot.html" title="GckSlot"><span class="returnvalue">GckSlot</span></a> * gck_session_get_slot (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>);</pre>
321
Get the PKCS<span class="type">11</span> slot to which this session belongs.
323
<div class="variablelist"><table border="0">
324
<col align="left" valign="top">
327
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
328
<td>The session object.</td>
331
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
332
<td>The slot, which should be unreffed after use.</td>
338
<div class="refsect2">
339
<a name="gck-session-get-handle"></a><h3>gck_session_get_handle ()</h3>
340
<pre class="programlisting"><span class="returnvalue">CK_SESSION_HANDLE</span> gck_session_get_handle (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>);</pre>
342
Get the raw PKCS<span class="type">11</span> session handle from a GckSession object.
344
<div class="variablelist"><table border="0">
345
<col align="left" valign="top">
348
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
349
<td>The session object.</td>
352
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
353
<td>The raw session handle.</td>
359
<div class="refsect2">
360
<a name="gck-session-get-info"></a><h3>gck_session_get_info ()</h3>
361
<pre class="programlisting"><a class="link" href="GckSession.html#GckSessionInfo" title="GckSessionInfo"><span class="returnvalue">GckSessionInfo</span></a> * gck_session_get_info (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>);</pre>
363
Get information about the session.
365
<div class="variablelist"><table border="0">
366
<col align="left" valign="top">
369
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
370
<td>The session object.</td>
373
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
374
<td>The session info. Use the <a class="link" href="GckSession.html#gck-session-info-free" title="gck_session_info_free ()"><code class="function">gck_session_info_free()</code></a> to release
381
<div class="refsect2">
382
<a name="gck-session-login"></a><h3>gck_session_login ()</h3>
383
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_session_login (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
384
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> user_type</code></em>,
385
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *pin</code></em>,
386
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_pin</code></em>,
387
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
388
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
390
Login the user on the session. This call may block for
391
an indefinite period.
393
<div class="variablelist"><table border="0">
394
<col align="left" valign="top">
397
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
398
<td>Log in to this session.</td>
401
<td><p><span class="term"><em class="parameter"><code>user_type</code></em> :</span></p></td>
402
<td>The type of login user.</td>
405
<td><p><span class="term"><em class="parameter"><code>pin</code></em> :</span></p></td>
406
<td>The user's PIN, or NULL for protected authentication path.</td>
409
<td><p><span class="term"><em class="parameter"><code>n_pin</code></em> :</span></p></td>
410
<td>The length of the PIN.</td>
413
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
414
<td>Optional cancellation object, or NULL.</td>
417
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
418
<td>A location to return an error.</td>
421
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
422
<td>Whether successful or not.</td>
428
<div class="refsect2">
429
<a name="gck-session-login-async"></a><h3>gck_session_login_async ()</h3>
430
<pre class="programlisting"><span class="returnvalue">void</span> gck_session_login_async (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
431
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> user_type</code></em>,
432
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *pin</code></em>,
433
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_pin</code></em>,
434
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
435
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
436
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
438
Login the user on the session. This call will return
439
immediately and completes asynchronously.
441
<div class="variablelist"><table border="0">
442
<col align="left" valign="top">
445
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
446
<td>Log in to this session.</td>
449
<td><p><span class="term"><em class="parameter"><code>user_type</code></em> :</span></p></td>
450
<td>The type of login user.</td>
453
<td><p><span class="term"><em class="parameter"><code>pin</code></em> :</span></p></td>
454
<td>The user's PIN, or NULL for protected authentication path.</td>
457
<td><p><span class="term"><em class="parameter"><code>n_pin</code></em> :</span></p></td>
458
<td>The length of the PIN.</td>
461
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
462
<td>Optional cancellation object, or NULL.</td>
465
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
466
<td>Called when the operation completes.</td>
469
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
470
<td>Data to pass to the callback.</td>
476
<div class="refsect2">
477
<a name="gck-session-login-finish"></a><h3>gck_session_login_finish ()</h3>
478
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_session_login_finish (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
479
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
480
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
482
Get the result of a login operation.
484
<div class="variablelist"><table border="0">
485
<col align="left" valign="top">
488
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
489
<td>The session logged into.</td>
492
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
493
<td>The result passed to the callback.</td>
496
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
497
<td>A location to return an error.</td>
500
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
501
<td>Whether the operation was successful or not.</td>
507
<div class="refsect2">
508
<a name="gck-session-logout"></a><h3>gck_session_logout ()</h3>
509
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_session_logout (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
510
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
511
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
513
Log out of the session. This call may block for an indefinite period.
515
<div class="variablelist"><table border="0">
516
<col align="left" valign="top">
519
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
520
<td>Logout of this session.</td>
523
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
524
<td>Optional cancellation object, or NULL.</td>
527
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
528
<td>A location to return an error.</td>
531
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
532
<td>Whether the logout was successful or not.</td>
538
<div class="refsect2">
539
<a name="gck-session-logout-async"></a><h3>gck_session_logout_async ()</h3>
540
<pre class="programlisting"><span class="returnvalue">void</span> gck_session_logout_async (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
541
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
542
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
543
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
545
Log out of the session. This call returns immediately and completes
548
<div class="variablelist"><table border="0">
549
<col align="left" valign="top">
552
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
553
<td>Logout of this session.</td>
556
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
557
<td>Optional cancellation object, or NULL.</td>
560
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
561
<td>Called when the operation completes.</td>
564
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
565
<td>Data to pass to the callback.</td>
571
<div class="refsect2">
572
<a name="gck-session-logout-finish"></a><h3>gck_session_logout_finish ()</h3>
573
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_session_logout_finish (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
574
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
575
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
577
Get the result of logging out of a session.
579
<div class="variablelist"><table border="0">
580
<col align="left" valign="top">
583
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
584
<td>Logout of this session.</td>
587
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
588
<td>The result passed to the callback.</td>
591
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
592
<td>A location to return an error.</td>
595
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
596
<td>Whether the logout was successful or not.</td>
602
<div class="refsect2">
603
<a name="gck-session-create-object"></a><h3>gck_session_create_object ()</h3>
604
<pre class="programlisting"><a class="link" href="GckObject.html" title="GckObject"><span class="returnvalue">GckObject</span></a> * gck_session_create_object (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
605
<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
606
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
607
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
609
Create a new PKCS<span class="type">11</span> object. This call may block for an
612
<div class="variablelist"><table border="0">
613
<col align="left" valign="top">
616
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
617
<td>The session to create the object on.</td>
620
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
621
<td>The attributes to create the object with.</td>
624
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
625
<td>Optional cancellation object, or NULL.</td>
628
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
629
<td>A location to return an error, or NULL.</td>
632
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
633
<td>The newly created object or NULL if an error occurred.</td>
639
<div class="refsect2">
640
<a name="gck-session-create-object-async"></a><h3>gck_session_create_object_async ()</h3>
641
<pre class="programlisting"><span class="returnvalue">void</span> gck_session_create_object_async (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
642
<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
643
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
644
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
645
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
647
Create a new PKCS<span class="type">11</span> object. This call will return immediately
648
and complete asynchronously.
650
<div class="variablelist"><table border="0">
651
<col align="left" valign="top">
654
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
655
<td>The session to create the object on.</td>
658
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
659
<td>The attributes to create the object with.</td>
662
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
663
<td>Optional cancellation object or NULL.</td>
666
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
667
<td>Called when the operation completes.</td>
670
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
671
<td>Data to pass to the callback.</td>
677
<div class="refsect2">
678
<a name="gck-session-create-object-finish"></a><h3>gck_session_create_object_finish ()</h3>
679
<pre class="programlisting"><a class="link" href="GckObject.html" title="GckObject"><span class="returnvalue">GckObject</span></a> * gck_session_create_object_finish (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
680
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
681
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
683
Get the result of creating a new PKCS<span class="type">11</span> object.
685
<div class="variablelist"><table border="0">
686
<col align="left" valign="top">
689
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
690
<td>The session to create the object on.</td>
693
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
694
<td>The result passed to the callback.</td>
697
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
698
<td>A location to return an error, or NULL.</td>
701
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
702
<td>The newly created object or NULL if an error occurred.</td>
708
<div class="refsect2">
709
<a name="gck-session-find-objects"></a><h3>gck_session_find_objects ()</h3>
710
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * gck_session_find_objects (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
711
<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
712
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
713
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
715
Find the objects matching the passed attributes. This call may
716
block for an indefinite period.
718
<div class="variablelist"><table border="0">
719
<col align="left" valign="top">
722
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
723
<td>The session to find objects on.</td>
726
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
727
<td>The attributes to match.</td>
730
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
731
<td>Optional cancellation object or NULL.</td>
734
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
735
<td>A location to return an error or NULL.</td>
738
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
739
<td>A list of the matching objects, which may be empty.</td>
745
<div class="refsect2">
746
<a name="gck-session-find-objects-async"></a><h3>gck_session_find_objects_async ()</h3>
747
<pre class="programlisting"><span class="returnvalue">void</span> gck_session_find_objects_async (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
748
<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
749
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
750
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
751
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
753
Find the objects matching the passed attributes. This call will
754
return immediately and complete asynchronously.
756
<div class="variablelist"><table border="0">
757
<col align="left" valign="top">
760
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
761
<td>The session to find objects on.</td>
764
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
765
<td>The attributes to match.</td>
768
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
769
<td>Optional cancellation object or NULL.</td>
772
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
773
<td>Called when the operation completes.</td>
776
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
777
<td>Data to pass to the callback.</td>
783
<div class="refsect2">
784
<a name="gck-session-find-objects-finish"></a><h3>gck_session_find_objects_finish ()</h3>
785
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> * gck_session_find_objects_finish (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
786
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
787
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
789
Get the result of a find operation.
791
<div class="variablelist"><table border="0">
792
<col align="left" valign="top">
795
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
796
<td>The session to find objects on.</td>
799
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
800
<td>The attributes to match.</td>
803
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
804
<td>A location to return an error.</td>
807
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
808
<td>A list of the matching objects, which may be empty.</td>
814
<div class="refsect2">
815
<a name="gck-session-encrypt"></a><h3>gck_session_encrypt ()</h3>
816
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gck_session_encrypt (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
817
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
818
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mech_type</code></em>,
819
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
820
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
821
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
822
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
823
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
825
Encrypt data in a mechanism specific manner. This call may
826
block for an indefinite period.
828
<div class="variablelist"><table border="0">
829
<col align="left" valign="top">
832
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
833
<td>The session.</td>
836
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
837
<td>The key to encrypt with.</td>
840
<td><p><span class="term"><em class="parameter"><code>mech_type</code></em> :</span></p></td>
841
<td>The mechanism type to use for encryption.</td>
844
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
845
<td>The data to encrypt.</td>
848
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
849
<td>The length of the data to encrypt.</td>
852
<td><p><span class="term"><em class="parameter"><code>n_result</code></em> :</span></p></td>
853
<td>A location to store the length of the result data.</td>
856
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
857
<td>A location to place error information.</td>
860
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
861
<td>The data that was encrypted, or NULL if an error occured.</td>
867
<div class="refsect2">
868
<a name="gck-session-encrypt-full"></a><h3>gck_session_encrypt_full ()</h3>
869
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gck_session_encrypt_full (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
870
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
871
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
872
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
873
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
874
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
875
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
876
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
878
Encrypt data in a mechanism specific manner. This call may
879
block for an indefinite period.
881
<div class="variablelist"><table border="0">
882
<col align="left" valign="top">
885
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
886
<td>The session.</td>
889
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
890
<td>The key to encrypt with.</td>
893
<td><p><span class="term"><em class="parameter"><code>mechanism</code></em> :</span></p></td>
894
<td>The mechanism type and parameters to use for encryption.</td>
897
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
898
<td>The data to encrypt.</td>
901
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
902
<td>The length of the data to encrypt.</td>
905
<td><p><span class="term"><em class="parameter"><code>n_result</code></em> :</span></p></td>
906
<td>A location to store the length of the result data.</td>
909
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
910
<td>A GCancellable which can be used to cancel the operation.</td>
913
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
914
<td>A location to place error information.</td>
917
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
918
<td>The data that was encrypted, or NULL if an error occured.</td>
924
<div class="refsect2">
925
<a name="gck-session-encrypt-async"></a><h3>gck_session_encrypt_async ()</h3>
926
<pre class="programlisting"><span class="returnvalue">void</span> gck_session_encrypt_async (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
927
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
928
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
929
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
930
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
931
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
932
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
933
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
935
Encrypt data in a mechanism specific manner. This call will
936
return immediately and complete asynchronously.
938
<div class="variablelist"><table border="0">
939
<col align="left" valign="top">
942
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
943
<td>The session.</td>
946
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
947
<td>The key to encrypt with.</td>
950
<td><p><span class="term"><em class="parameter"><code>mechanism</code></em> :</span></p></td>
951
<td>The mechanism type and parameters to use for encryption.</td>
954
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
955
<td>The data to encrypt.</td>
958
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
959
<td>The length of the data to encrypt.</td>
962
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
963
<td>A GCancellable which can be used to cancel the operation.</td>
966
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
967
<td>Called when the operation completes.</td>
970
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
971
<td>A pointer to pass to the callback.</td>
977
<div class="refsect2">
978
<a name="gck-session-encrypt-finish"></a><h3>gck_session_encrypt_finish ()</h3>
979
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gck_session_encrypt_finish (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
980
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
981
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
982
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
984
Get the result of an encryption operation.
986
<div class="variablelist"><table border="0">
987
<col align="left" valign="top">
990
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
991
<td>The session.</td>
994
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
995
<td>The result object passed to the callback.</td>
998
<td><p><span class="term"><em class="parameter"><code>n_result</code></em> :</span></p></td>
999
<td>A location to store the length of the result data.</td>
1002
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1003
<td>A location to place error information.</td>
1006
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1007
<td>The data that was encrypted, or NULL if an error occurred.</td>
1013
<div class="refsect2">
1014
<a name="gck-session-decrypt"></a><h3>gck_session_decrypt ()</h3>
1015
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gck_session_decrypt (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1016
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
1017
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mech_type</code></em>,
1018
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
1019
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
1020
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
1021
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1022
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
1024
Decrypt data in a mechanism specific manner. This call may
1025
block for an indefinite period.
1027
<div class="variablelist"><table border="0">
1028
<col align="left" valign="top">
1031
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1032
<td>The session.</td>
1035
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1036
<td>The key to decrypt with.</td>
1039
<td><p><span class="term"><em class="parameter"><code>mech_type</code></em> :</span></p></td>
1040
<td>The mechanism type to use for decryption.</td>
1043
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
1044
<td>The data to decrypt.</td>
1047
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
1048
<td>The length of the data to decrypt.</td>
1051
<td><p><span class="term"><em class="parameter"><code>n_result</code></em> :</span></p></td>
1052
<td>A location to store the length of the result data.</td>
1055
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1056
<td>A location to place an error.</td>
1059
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1060
<td>The data that was decrypted, or NULL if an error occured.</td>
1066
<div class="refsect2">
1067
<a name="gck-session-decrypt-full"></a><h3>gck_session_decrypt_full ()</h3>
1068
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gck_session_decrypt_full (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1069
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
1070
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
1071
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
1072
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
1073
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
1074
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1075
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
1077
Decrypt data in a mechanism specific manner. This call may
1078
block for an indefinite period.
1080
<div class="variablelist"><table border="0">
1081
<col align="left" valign="top">
1084
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1085
<td>The session.</td>
1088
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1089
<td>The key to decrypt with.</td>
1092
<td><p><span class="term"><em class="parameter"><code>mechanism</code></em> :</span></p></td>
1093
<td>The mechanism type and parameters to use for decryption.</td>
1096
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
1097
<td>The data to decrypt.</td>
1100
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
1101
<td>The length of the data to decrypt.</td>
1104
<td><p><span class="term"><em class="parameter"><code>n_result</code></em> :</span></p></td>
1105
<td>A location to store the length of the result data.</td>
1108
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1109
<td>A GCancellable which can be used to cancel the operation.</td>
1112
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1113
<td>A location to place error information.</td>
1116
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1117
<td>The data that was decrypted, or NULL if an error occured.</td>
1123
<div class="refsect2">
1124
<a name="gck-session-decrypt-async"></a><h3>gck_session_decrypt_async ()</h3>
1125
<pre class="programlisting"><span class="returnvalue">void</span> gck_session_decrypt_async (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1126
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
1127
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
1128
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
1129
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
1130
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1131
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1132
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1134
Decrypt data in a mechanism specific manner. This call will
1135
return immediately and complete asynchronously.
1137
<div class="variablelist"><table border="0">
1138
<col align="left" valign="top">
1141
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1142
<td>The session.</td>
1145
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1146
<td>The key to decrypt with.</td>
1149
<td><p><span class="term"><em class="parameter"><code>mechanism</code></em> :</span></p></td>
1150
<td>The mechanism type and parameters to use for decryption.</td>
1153
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
1154
<td>The data to decrypt.</td>
1157
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
1158
<td>The length of the data to decrypt.</td>
1161
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1162
<td>A GCancellable which can be used to cancel the operation.</td>
1165
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1166
<td>Called when the operation completes.</td>
1169
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1170
<td>A pointer to pass to the callback.</td>
1176
<div class="refsect2">
1177
<a name="gck-session-decrypt-finish"></a><h3>gck_session_decrypt_finish ()</h3>
1178
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gck_session_decrypt_finish (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1179
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1180
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
1181
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
1183
Get the result of an decryption operation.
1185
<div class="variablelist"><table border="0">
1186
<col align="left" valign="top">
1189
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1190
<td>The session.</td>
1193
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1194
<td>The result object passed to the callback.</td>
1197
<td><p><span class="term"><em class="parameter"><code>n_result</code></em> :</span></p></td>
1198
<td>A location to store the length of the result data.</td>
1201
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1202
<td>A location to place error information.</td>
1205
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1206
<td>The data that was decrypted, or NULL if an error occurred.</td>
1212
<div class="refsect2">
1213
<a name="gck-session-sign"></a><h3>gck_session_sign ()</h3>
1214
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gck_session_sign (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1215
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
1216
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mech_type</code></em>,
1217
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
1218
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
1219
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
1220
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1221
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
1223
Sign data in a mechanism specific manner. This call may
1224
block for an indefinite period.
1226
<div class="variablelist"><table border="0">
1227
<col align="left" valign="top">
1230
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1231
<td>The session.</td>
1234
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1235
<td>The key to sign with.</td>
1238
<td><p><span class="term"><em class="parameter"><code>mech_type</code></em> :</span></p></td>
1239
<td>The mechanism type to use for signing.</td>
1242
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
1243
<td>The data to sign.</td>
1246
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
1247
<td>The length of the data to sign.</td>
1250
<td><p><span class="term"><em class="parameter"><code>n_result</code></em> :</span></p></td>
1251
<td>A location to store the length of the result data.</td>
1254
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1255
<td>A location to place an error.</td>
1258
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1259
<td>The data that was signed, or NULL if an error occured.</td>
1265
<div class="refsect2">
1266
<a name="gck-session-sign-full"></a><h3>gck_session_sign_full ()</h3>
1267
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gck_session_sign_full (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1268
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
1269
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
1270
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
1271
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
1272
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
1273
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1274
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
1276
Sign data in a mechanism specific manner. This call may
1277
block for an indefinite period.
1279
<div class="variablelist"><table border="0">
1280
<col align="left" valign="top">
1283
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1284
<td>The session.</td>
1287
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1288
<td>The key to sign with.</td>
1291
<td><p><span class="term"><em class="parameter"><code>mechanism</code></em> :</span></p></td>
1292
<td>The mechanism type and parameters to use for signing.</td>
1295
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
1296
<td>The data to sign.</td>
1299
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
1300
<td>The length of the data to sign.</td>
1303
<td><p><span class="term"><em class="parameter"><code>n_result</code></em> :</span></p></td>
1304
<td>A location to store the length of the result data.</td>
1307
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1308
<td>A GCancellable which can be used to cancel the operation.</td>
1311
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1312
<td>A location to place error information.</td>
1315
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1316
<td>The data that was signed, or NULL if an error occured.</td>
1322
<div class="refsect2">
1323
<a name="gck-session-sign-async"></a><h3>gck_session_sign_async ()</h3>
1324
<pre class="programlisting"><span class="returnvalue">void</span> gck_session_sign_async (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1325
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
1326
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
1327
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
1328
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
1329
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1330
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1331
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1333
Sign data in a mechanism specific manner. This call will
1334
return immediately and complete asynchronously.
1336
<div class="variablelist"><table border="0">
1337
<col align="left" valign="top">
1340
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1341
<td>The session.</td>
1344
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1345
<td>The key to sign with.</td>
1348
<td><p><span class="term"><em class="parameter"><code>mechanism</code></em> :</span></p></td>
1349
<td>The mechanism type and parameters to use for signing.</td>
1352
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
1353
<td>The data to sign.</td>
1356
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
1357
<td>The length of the data to sign.</td>
1360
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1361
<td>A GCancellable which can be used to cancel the operation.</td>
1364
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1365
<td>Called when the operation completes.</td>
1368
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1369
<td>A pointer to pass to the callback.</td>
1375
<div class="refsect2">
1376
<a name="gck-session-sign-finish"></a><h3>gck_session_sign_finish ()</h3>
1377
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="returnvalue">guchar</span></a> * gck_session_sign_finish (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1378
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1379
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *n_result</code></em>,
1380
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
1382
Get the result of an signing operation.
1384
<div class="variablelist"><table border="0">
1385
<col align="left" valign="top">
1388
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1389
<td>The session.</td>
1392
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1393
<td>The result object passed to the callback.</td>
1396
<td><p><span class="term"><em class="parameter"><code>n_result</code></em> :</span></p></td>
1397
<td>A location to store the length of the result data.</td>
1400
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1401
<td>A location to place error information.</td>
1404
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1405
<td>The data that was signed, or NULL if an error occurred.</td>
1411
<div class="refsect2">
1412
<a name="gck-session-verify"></a><h3>gck_session_verify ()</h3>
1413
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_session_verify (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1414
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
1415
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> mech_type</code></em>,
1416
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
1417
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
1418
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *signature</code></em>,
1419
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_signature</code></em>,
1420
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1421
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
1423
Verify data in a mechanism specific manner. This call may
1424
block for an indefinite period.
1426
<div class="variablelist"><table border="0">
1427
<col align="left" valign="top">
1430
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1431
<td>The session.</td>
1434
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1435
<td>The key to verify with.</td>
1438
<td><p><span class="term"><em class="parameter"><code>mech_type</code></em> :</span></p></td>
1439
<td>The mechanism type to use for verifying.</td>
1442
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
1443
<td>The data to verify.</td>
1446
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
1447
<td>The length of the data to verify.</td>
1450
<td><p><span class="term"><em class="parameter"><code>signature</code></em> :</span></p></td>
1451
<td>The signature.</td>
1454
<td><p><span class="term"><em class="parameter"><code>n_signature</code></em> :</span></p></td>
1455
<td>The length of the signature.</td>
1458
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1459
<td>A location to place an error.</td>
1462
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1463
<td>TRUE if the data verified correctly, otherwise a failure or error occurred.</td>
1469
<div class="refsect2">
1470
<a name="gck-session-verify-full"></a><h3>gck_session_verify_full ()</h3>
1471
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_session_verify_full (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1472
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
1473
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
1474
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
1475
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
1476
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *signature</code></em>,
1477
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_signature</code></em>,
1478
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1479
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
1481
Verify data in a mechanism specific manner. This call may
1482
block for an indefinite period.
1484
<div class="variablelist"><table border="0">
1485
<col align="left" valign="top">
1488
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1489
<td>The session.</td>
1492
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1493
<td>The key to verify with.</td>
1496
<td><p><span class="term"><em class="parameter"><code>mechanism</code></em> :</span></p></td>
1497
<td>The mechanism type and parameters to use for signing.</td>
1500
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
1501
<td>The data to verify.</td>
1504
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
1505
<td>The length of the data to verify.</td>
1508
<td><p><span class="term"><em class="parameter"><code>signature</code></em> :</span></p></td>
1509
<td>The signature.</td>
1512
<td><p><span class="term"><em class="parameter"><code>n_signature</code></em> :</span></p></td>
1513
<td>The length of the signature.</td>
1516
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1517
<td>A GCancellable which can be used to cancel the operation.</td>
1520
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1521
<td>A location to place an error.</td>
1524
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1525
<td>TRUE if the data verified correctly, otherwise a failure or error occurred.</td>
1531
<div class="refsect2">
1532
<a name="gck-session-verify-async"></a><h3>gck_session_verify_async ()</h3>
1533
<pre class="programlisting"><span class="returnvalue">void</span> gck_session_verify_async (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1534
<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *key</code></em>,
1535
<em class="parameter"><code><a class="link" href="GckSession.html#GckMechanism" title="GckMechanism"><span class="type">GckMechanism</span></a> *mechanism</code></em>,
1536
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *input</code></em>,
1537
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_input</code></em>,
1538
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *signature</code></em>,
1539
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> n_signature</code></em>,
1540
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
1541
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
1542
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1544
Verify data in a mechanism specific manner. This call returns
1545
immediately and completes asynchronously.
1547
<div class="variablelist"><table border="0">
1548
<col align="left" valign="top">
1551
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1552
<td>The session.</td>
1555
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
1556
<td>The key to verify with.</td>
1559
<td><p><span class="term"><em class="parameter"><code>mechanism</code></em> :</span></p></td>
1560
<td>The mechanism type and parameters to use for signing.</td>
1563
<td><p><span class="term"><em class="parameter"><code>input</code></em> :</span></p></td>
1564
<td>The data to verify.</td>
1567
<td><p><span class="term"><em class="parameter"><code>n_input</code></em> :</span></p></td>
1568
<td>The length of the data to verify.</td>
1571
<td><p><span class="term"><em class="parameter"><code>signature</code></em> :</span></p></td>
1572
<td>The signature.</td>
1575
<td><p><span class="term"><em class="parameter"><code>n_signature</code></em> :</span></p></td>
1576
<td>The length of the signature.</td>
1579
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1580
<td>A GCancellable which can be used to cancel the operation.</td>
1583
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1584
<td>Called when the operation completes.</td>
1587
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1588
<td>A pointer to pass to the callback.</td>
1594
<div class="refsect2">
1595
<a name="gck-session-verify-finish"></a><h3>gck_session_verify_finish ()</h3>
1596
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_session_verify_finish (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *self</code></em>,
1597
<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
1598
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
1600
Get the result of an verify operation.
1602
<div class="variablelist"><table border="0">
1603
<col align="left" valign="top">
1606
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
1607
<td>The session.</td>
1610
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1611
<td>The result object passed to the callback.</td>
1614
<td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
1615
<td>A location to place error information.</td>
1618
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1619
<td>TRUE if the data verified correctly, otherwise a failure or error occurred.</td>
1625
<div class="refsect2">
1626
<a name="GckSessionInfo"></a><h3>GckSessionInfo</h3>
1627
<pre class="programlisting">typedef struct {
1631
gulong device_error;
1635
Information about the session. This is analogous to a CK_SESSION_INFO structure.
1638
When done with this structure, release it using <a class="link" href="GckSession.html#gck-session-info-free" title="gck_session_info_free ()"><code class="function">gck_session_info_free()</code></a>.
1640
<div class="variablelist"><table border="0">
1641
<col align="left" valign="top">
1644
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> <em class="structfield"><code><a name="GckSessionInfo.slot-id"></a>slot_id</code></em>;</span></p></td>
1645
<td>The handle of the PKCS11 slot that this session is opened on.</td>
1648
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> <em class="structfield"><code><a name="GckSessionInfo.state"></a>state</code></em>;</span></p></td>
1649
<td>The user login state of the session.</td>
1652
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> <em class="structfield"><code><a name="GckSessionInfo.flags"></a>flags</code></em>;</span></p></td>
1653
<td>Various PKCS11 flags.</td>
1656
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> <em class="structfield"><code><a name="GckSessionInfo.device-error"></a>device_error</code></em>;</span></p></td>
1657
<td>The last device error that occurred from an operation on this session.</td>
1663
<div class="refsect2">
1664
<a name="gck-session-info-free"></a><h3>gck_session_info_free ()</h3>
1665
<pre class="programlisting"><span class="returnvalue">void</span> gck_session_info_free (<em class="parameter"><code><a class="link" href="GckSession.html#GckSessionInfo" title="GckSessionInfo"><span class="type">GckSessionInfo</span></a> *session_info</code></em>);</pre>
1667
Free the GckSessionInfo structure and all associated memory.
1669
<div class="variablelist"><table border="0">
1670
<col align="left" valign="top">
1672
<td><p><span class="term"><em class="parameter"><code>session_info</code></em> :</span></p></td>
1673
<td>Session info to free.</td>
1678
<div class="refsect2">
1679
<a name="GckMechanism"></a><h3>GckMechanism</h3>
1680
<pre class="programlisting">typedef struct {
1682
gconstpointer parameter;
1687
Represents a mechanism used with crypto operations.
1689
<div class="variablelist"><table border="0">
1690
<col align="left" valign="top">
1693
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> <em class="structfield"><code><a name="GckMechanism.type"></a>type</code></em>;</span></p></td>
1694
<td>The mechanism type</td>
1697
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> <em class="structfield"><code><a name="GckMechanism.parameter"></a>parameter</code></em>;</span></p></td>
1698
<td>Mechanism specific data.</td>
1701
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> <em class="structfield"><code><a name="GckMechanism.n-parameter"></a>n_parameter</code></em>;</span></p></td>
1702
<td>Length of mechanism specific data.</td>
1708
<div class="refsect1">
1709
<a name="GckSession.property-details"></a><h2>Property Details</h2>
1710
<div class="refsect2">
1711
<a name="GckSession--handle"></a><h3>The <code class="literal">"handle"</code> property</h3>
1712
<pre class="programlisting"> "handle" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> : Read / Write / Construct Only</pre>
1714
The raw CK_SESSION_HANDLE handle of this session.
1718
<div class="refsect2">
1719
<a name="GckSession--module"></a><h3>The <code class="literal">"module"</code> property</h3>
1720
<pre class="programlisting"> "module" <a class="link" href="GckModule.html" title="GckModule"><span class="type">GckModule</span></a>* : Read / Write / Construct Only</pre>
1722
The GckModule that this session is opened on.
1726
<div class="refsect2">
1727
<a name="GckSession--options"></a><h3>The <code class="literal">"options"</code> property</h3>
1728
<pre class="programlisting"> "options" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read / Write / Construct Only</pre>
1730
The options this session was opened with.
1732
<p>Default value: 0</p>
1735
<div class="refsect2">
1736
<a name="GckSession--slot"></a><h3>The <code class="literal">"slot"</code> property</h3>
1737
<pre class="programlisting"> "slot" <a class="link" href="GckSlot.html" title="GckSlot"><span class="type">GckSlot</span></a>* : Read / Write / Construct Only</pre>
1739
The GckSlot this session is opened on.
1743
<div class="refsect1">
1744
<a name="GckSession.signal-details"></a><h2>Signal Details</h2>
1745
<div class="refsect2">
1746
<a name="GckSession-discard-handle"></a><h3>The <code class="literal">"discard-handle"</code> signal</h3>
1747
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> user_function (<a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *session,
1748
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> handle,
1749
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
1751
When a GckSession is being disposed of it emits this signal to allow
1752
a session pool to pick up the handle and keep it around.
1755
If no signal handler claims the handle, then it is closed. This is used by
1756
<code class="function">gck_module_set_pool_sessions()</code> to implement the module session pool.
1758
<div class="variablelist"><table border="0">
1759
<col align="left" valign="top">
1762
<td><p><span class="term"><em class="parameter"><code>session</code></em> :</span></p></td>
1763
<td>The session.</td>
1766
<td><p><span class="term"><em class="parameter"><code>handle</code></em> :</span></p></td>
1767
<td>The handle being discarded.</td>
1770
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1771
<td>user data set when the signal handler was connected.</td>
1774
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1775
<td>Whether or not this handle was claimed.</td>
1782
<div class="footer">
1784
Generated by GTK-Doc V1.16</div>
b'\\ No newline at end of file'