8
8
<link rel="up" href="reference.html" title="Reference">
9
9
<link rel="prev" href="reference.html" title="Reference">
10
10
<link rel="next" href="p11-kit-URIs.html" title="URIs">
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
37
37
</tr></table></div>
38
38
<div class="refsynopsisdiv">
39
39
<a name="p11-kit-Modules.synopsis"></a><h2>Synopsis</h2>
40
<pre class="synopsis"><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> <a class="link" href="p11-kit-Modules.html#p11-kit-initialize-registered" title="p11_kit_initialize_registered ()">p11_kit_initialize_registered</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
41
<a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> <a class="link" href="p11-kit-Modules.html#p11-kit-finalize-registered" title="p11_kit_finalize_registered ()">p11_kit_finalize_registered</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
42
<a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="returnvalue">CK_FUNCTION_LIST_PTR</span></a> * <a class="link" href="p11-kit-Modules.html#p11-kit-registered-modules" title="p11_kit_registered_modules ()">p11_kit_registered_modules</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
43
<span class="returnvalue">char</span> * <a class="link" href="p11-kit-Modules.html#p11-kit-registered-module-to-name" title="p11_kit_registered_module_to_name ()">p11_kit_registered_module_to_name</a> (<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> module</code></em>);
44
<a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="returnvalue">CK_FUNCTION_LIST_PTR</span></a> <a class="link" href="p11-kit-Modules.html#p11-kit-registered-name-to-module" title="p11_kit_registered_name_to_module ()">p11_kit_registered_name_to_module</a> (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>);
45
<span class="returnvalue">char</span> * <a class="link" href="p11-kit-Modules.html#p11-kit-registered-option" title="p11_kit_registered_option ()">p11_kit_registered_option</a> (<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> module</code></em>,
40
<pre class="synopsis"><span class="returnvalue">CK_RV</span> <a class="link" href="p11-kit-Modules.html#p11-kit-initialize-registered" title="p11_kit_initialize_registered ()">p11_kit_initialize_registered</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
41
<span class="returnvalue">CK_RV</span> <a class="link" href="p11-kit-Modules.html#p11-kit-finalize-registered" title="p11_kit_finalize_registered ()">p11_kit_finalize_registered</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
42
<span class="returnvalue">CK_FUNCTION_LIST_PTR</span> * <a class="link" href="p11-kit-Modules.html#p11-kit-registered-modules" title="p11_kit_registered_modules ()">p11_kit_registered_modules</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
43
<span class="returnvalue">char</span> * <a class="link" href="p11-kit-Modules.html#p11-kit-registered-module-to-name" title="p11_kit_registered_module_to_name ()">p11_kit_registered_module_to_name</a> (<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> module</code></em>);
44
<span class="returnvalue">CK_FUNCTION_LIST_PTR</span> <a class="link" href="p11-kit-Modules.html#p11-kit-registered-name-to-module" title="p11_kit_registered_name_to_module ()">p11_kit_registered_name_to_module</a> (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>);
45
<span class="returnvalue">char</span> * <a class="link" href="p11-kit-Modules.html#p11-kit-registered-option" title="p11_kit_registered_option ()">p11_kit_registered_option</a> (<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> module</code></em>,
46
46
<em class="parameter"><code>const <span class="type">char</span> *field</code></em>);
47
<a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> <a class="link" href="p11-kit-Modules.html#p11-kit-initialize-module" title="p11_kit_initialize_module ()">p11_kit_initialize_module</a> (<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> module</code></em>);
48
<a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> <a class="link" href="p11-kit-Modules.html#p11-kit-load-initialize-module" title="p11_kit_load_initialize_module ()">p11_kit_load_initialize_module</a> (<em class="parameter"><code>const <span class="type">char</span> *module_path</code></em>,
49
<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> *module</code></em>);
50
<a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> <a class="link" href="p11-kit-Modules.html#p11-kit-finalize-module" title="p11_kit_finalize_module ()">p11_kit_finalize_module</a> (<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> module</code></em>);
47
<span class="returnvalue">CK_RV</span> <a class="link" href="p11-kit-Modules.html#p11-kit-initialize-module" title="p11_kit_initialize_module ()">p11_kit_initialize_module</a> (<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> module</code></em>);
48
<span class="returnvalue">CK_RV</span> <a class="link" href="p11-kit-Modules.html#p11-kit-load-initialize-module" title="p11_kit_load_initialize_module ()">p11_kit_load_initialize_module</a> (<em class="parameter"><code>const <span class="type">char</span> *module_path</code></em>,
49
<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> *module</code></em>);
50
<span class="returnvalue">CK_RV</span> <a class="link" href="p11-kit-Modules.html#p11-kit-finalize-module" title="p11_kit_finalize_module ()">p11_kit_finalize_module</a> (<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> module</code></em>);
53
53
<div class="refsect1">
94
94
<a name="p11-kit-Modules.details"></a><h2>Details</h2>
95
95
<div class="refsect2">
96
96
<a name="p11-kit-initialize-registered"></a><h3>p11_kit_initialize_registered ()</h3>
97
<pre class="programlisting"><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> p11_kit_initialize_registered (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
97
<pre class="programlisting"><span class="returnvalue">CK_RV</span> p11_kit_initialize_registered (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
99
99
Initialize all the registered PKCS#11 modules.
123
123
<div class="refsect2">
124
124
<a name="p11-kit-finalize-registered"></a><h3>p11_kit_finalize_registered ()</h3>
125
<pre class="programlisting"><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> p11_kit_finalize_registered (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
125
<pre class="programlisting"><span class="returnvalue">CK_RV</span> p11_kit_finalize_registered (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
127
127
Finalize all the registered PKCS#11 modules. These should have been
128
128
initialized with <a class="link" href="p11-kit-Modules.html#p11-kit-initialize-registered" title="p11_kit_initialize_registered ()"><code class="function">p11_kit_initialize_registered()</code></a>.
148
148
<div class="refsect2">
149
149
<a name="p11-kit-registered-modules"></a><h3>p11_kit_registered_modules ()</h3>
150
<pre class="programlisting"><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="returnvalue">CK_FUNCTION_LIST_PTR</span></a> * p11_kit_registered_modules (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
150
<pre class="programlisting"><span class="returnvalue">CK_FUNCTION_LIST_PTR</span> * p11_kit_registered_modules (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
152
152
Get a list of all the registered PKCS#11 modules. This list will be valid
153
153
once the <a class="link" href="p11-kit-Modules.html#p11-kit-initialize-registered" title="p11_kit_initialize_registered ()"><code class="function">p11_kit_initialize_registered()</code></a> function has been called.
169
169
<div class="refsect2">
170
170
<a name="p11-kit-registered-module-to-name"></a><h3>p11_kit_registered_module_to_name ()</h3>
171
<pre class="programlisting"><span class="returnvalue">char</span> * p11_kit_registered_module_to_name (<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> module</code></em>);</pre>
171
<pre class="programlisting"><span class="returnvalue">char</span> * p11_kit_registered_module_to_name (<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> module</code></em>);</pre>
173
173
Get the name of a registered PKCS#11 module.
196
196
<div class="refsect2">
197
197
<a name="p11-kit-registered-name-to-module"></a><h3>p11_kit_registered_name_to_module ()</h3>
198
<pre class="programlisting"><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="returnvalue">CK_FUNCTION_LIST_PTR</span></a> p11_kit_registered_name_to_module (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>);</pre>
198
<pre class="programlisting"><span class="returnvalue">CK_FUNCTION_LIST_PTR</span> p11_kit_registered_name_to_module (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>);</pre>
200
200
Lookup a registered PKCS#11 module by its name. This name is specified by
201
201
the registered module configuration.
219
219
<div class="refsect2">
220
220
<a name="p11-kit-registered-option"></a><h3>p11_kit_registered_option ()</h3>
221
<pre class="programlisting"><span class="returnvalue">char</span> * p11_kit_registered_option (<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> module</code></em>,
221
<pre class="programlisting"><span class="returnvalue">char</span> * p11_kit_registered_option (<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> module</code></em>,
222
222
<em class="parameter"><code>const <span class="type">char</span> *field</code></em>);</pre>
224
224
Lookup a configured option for a registered PKCS#11 module. If a
249
249
<div class="refsect2">
250
250
<a name="p11-kit-initialize-module"></a><h3>p11_kit_initialize_module ()</h3>
251
<pre class="programlisting"><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> p11_kit_initialize_module (<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> module</code></em>);</pre>
251
<pre class="programlisting"><span class="returnvalue">CK_RV</span> p11_kit_initialize_module (<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> module</code></em>);</pre>
253
253
Initialize an arbitrary PKCS#11 module. Normally using the
254
254
<a class="link" href="p11-kit-Modules.html#p11-kit-initialize-registered" title="p11_kit_initialize_registered ()"><code class="function">p11_kit_initialize_registered()</code></a> is preferred.
297
297
<div class="refsect2">
298
298
<a name="p11-kit-load-initialize-module"></a><h3>p11_kit_load_initialize_module ()</h3>
299
<pre class="programlisting"><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> p11_kit_load_initialize_module (<em class="parameter"><code>const <span class="type">char</span> *module_path</code></em>,
300
<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> *module</code></em>);</pre>
299
<pre class="programlisting"><span class="returnvalue">CK_RV</span> p11_kit_load_initialize_module (<em class="parameter"><code>const <span class="type">char</span> *module_path</code></em>,
300
<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> *module</code></em>);</pre>
302
302
Load an arbitrary PKCS#11 module from a dynamic library file, and
303
303
initialize it. Normally using the <a class="link" href="p11-kit-Modules.html#p11-kit-initialize-registered" title="p11_kit_initialize_registered ()"><code class="function">p11_kit_initialize_registered()</code></a> function
353
353
<div class="refsect2">
354
354
<a name="p11-kit-finalize-module"></a><h3>p11_kit_finalize_module ()</h3>
355
<pre class="programlisting"><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-RV:CAPS"><span class="returnvalue">CK_RV</span></a> p11_kit_finalize_module (<em class="parameter"><code><a href="http://developer.gnome.org/gck/stable/pkcs11-links.html#CK-FUNCTION-LIST-PTR:CAPS"><span class="type">CK_FUNCTION_LIST_PTR</span></a> module</code></em>);</pre>
355
<pre class="programlisting"><span class="returnvalue">CK_RV</span> p11_kit_finalize_module (<em class="parameter"><code><span class="type">CK_FUNCTION_LIST_PTR</span> module</code></em>);</pre>
357
357
Finalize an arbitrary PKCS#11 module. The module must have been initialized
358
358
using <a class="link" href="p11-kit-Modules.html#p11-kit-initialize-module" title="p11_kit_initialize_module ()"><code class="function">p11_kit_initialize_module()</code></a>. In most cases callers will want to use