← Back to branch summary

~ubuntu-branches/ubuntu/maverick/evolution-data-server/maverick-proposed

« back to all changes in this revision

Viewing changes to docs/reference/camel/html/camel-CamelCipherContext.html

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2010-05-17 17:02:06 UTC
  • mfrom: (1.1.79 upstream) (1.6.12 experimental)
  • Revision ID: james.westby@ubuntu.com-20100517170206-4ufr52vwrhh26yh0
Tags: 2.30.1-1ubuntu1
https://launchpad.net/bugs/42199
https://launchpad.net/bugs/229669
https://launchpad.net/bugs/173703
https://launchpad.net/bugs/360344
https://launchpad.net/bugs/508494
* Merge from debian experimental. Remaining change:
  (LP: #42199, #229669, #173703, #360344, #508494)
  + debian/control:
    - add Vcs-Bzr tag
    - don't use libgnome
    - Use Breaks instead of Conflicts against evolution 2.25 and earlier.
  + debian/evolution-data-server.install,
    debian/patches/45_libcamel_providers_version.patch:
    - use the upstream versioning, not a Debian-specific one 
  + debian/libedata-book1.2-dev.install, debian/libebackend-1.2-dev.install,
    debian/libcamel1.2-dev.install, debian/libedataserverui1.2-dev.install:
    - install html documentation
  + debian/rules:
    - don't build documentation it's shipped with the tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/camel/html/camel-CamelCipherContext.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>CamelCipherContext</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
7
<link rel="home" href="index.html" title="Camel Reference Manual">
8
8
<link rel="up" href="Crypto.html" title="Crypto Contexts">
9
9
<link rel="prev" href="Crypto.html" title="Crypto Contexts">
26
26
                  <a href="#camel-CamelCipherContext.description" class="shortcut">Description</a>
27
27
</td></tr>
28
28
</table>
29
 
<div class="refentry" lang="en">
 
29
<div class="refentry" title="CamelCipherContext">
30
30
<a name="camel-CamelCipherContext"></a><div class="titlepage"></div>
31
31
<div class="refnamediv"><table width="100%"><tr>
32
32
<td valign="top">
35
35
</td>
36
36
<td valign="top" align="right"></td>
37
37
</tr></table></div>
38
 
<div class="refsynopsisdiv">
 
38
<div class="refsynopsisdiv" title="Synopsis">
39
39
<a name="camel-CamelCipherContext.synopsis"></a><h2>Synopsis</h2>
40
40
<pre class="synopsis">                    <a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext">CamelCipherContext</a>;
41
41
                    <a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity">CamelCipherValidity</a>;
93
93
                                                         <em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#camel-cipher-validity-mode-t" title="enum camel_cipher_validity_mode_t"><span class="type">camel_cipher_validity_mode_t</span></a> mode</code></em>,
94
94
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
95
95
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *email</code></em>);
 
96
<span class="returnvalue">void</span>                <a class="link" href="camel-CamelCipherContext.html#camel-cipher-validity-add-certinfo-ex" title="camel_cipher_validity_add_certinfo_ex ()">camel_cipher_validity_add_certinfo_ex</a>
 
97
                                                        (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *vin</code></em>,
 
98
                                                         <em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#camel-cipher-validity-mode-t" title="enum camel_cipher_validity_mode_t"><span class="type">camel_cipher_validity_mode_t</span></a> mode</code></em>,
 
99
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
100
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *email</code></em>,
 
101
                                                         <em class="parameter"><code><span class="type">gpointer</span> cert_data</code></em>,
 
102
                                                         <em class="parameter"><code><span class="type">void</span> (cert_data_freegpointer cert_data) ()</code></em>,
 
103
                                                         <em class="parameter"><code><span class="type">gpointer</span> (cert_data_clonegpointer cert_data) ()</code></em>);
96
104
<span class="returnvalue">void</span>                <a class="link" href="camel-CamelCipherContext.html#camel-cipher-validity-envelope" title="camel_cipher_validity_envelope ()">camel_cipher_validity_envelope</a>      (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *parent</code></em>,
97
105
                                                         <em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *valid</code></em>);
98
106
<span class="returnvalue">void</span>                <a class="link" href="camel-CamelCipherContext.html#camel-cipher-validity-free" title="camel_cipher_validity_free ()">camel_cipher_validity_free</a>          (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *validity</code></em>);
101
109
                                                         <em class="parameter"><code><a class="link" href="camel-CamelStream.html#CamelStream" title="struct CamelStream"><span class="type">CamelStream</span></a> *ostream</code></em>);
102
110
</pre>
103
111
</div>
104
 
<div class="refsect1" lang="en">
 
112
<div class="refsect1" title="Description">
105
113
<a name="camel-CamelCipherContext.description"></a><h2>Description</h2>
106
114
<p>
107
115
</p>
108
116
</div>
109
 
<div class="refsect1" lang="en">
 
117
<div class="refsect1" title="Details">
110
118
<a name="camel-CamelCipherContext.details"></a><h2>Details</h2>
111
 
<div class="refsect2" lang="en">
 
119
<div class="refsect2" title="CamelCipherContext">
112
120
<a name="CamelCipherContext"></a><h3>CamelCipherContext</h3>
113
121
<pre class="programlisting">typedef struct {
114
122
        CamelObject parent_object;
127
135
</p>
128
136
</div>
129
137
<hr>
130
 
<div class="refsect2" lang="en">
 
138
<div class="refsect2" title="CamelCipherValidity">
131
139
<a name="CamelCipherValidity"></a><h3>CamelCipherValidity</h3>
132
140
<pre class="programlisting">typedef struct {
133
141
        struct _CamelCipherValidity *next;
150
158
</p>
151
159
</div>
152
160
<hr>
153
 
<div class="refsect2" lang="en">
 
161
<div class="refsect2" title="CamelCipherCertInfo">
154
162
<a name="CamelCipherCertInfo"></a><h3>CamelCipherCertInfo</h3>
155
163
<pre class="programlisting">typedef struct {
156
164
        struct _CamelCipherCertInfo *next;
158
166
 
159
167
        gchar *name;            /* common name */
160
168
        gchar *email;
 
169
 
 
170
        gpointer cert_data;  /* custom certificate data; can be NULL */
 
171
        void (*cert_data_free) (gpointer cert_data); /* called to free cert_data; can be NULL only if cert_data is NULL */
 
172
        gpointer (*cert_data_clone) (gpointer cert_data); /* called to clone cert_data; can be NULL only if cert_data is NULL */
161
173
} CamelCipherCertInfo;
162
174
</pre>
163
175
<p>
164
176
</p>
165
177
</div>
166
178
<hr>
167
 
<div class="refsect2" lang="en">
 
179
<div class="refsect2" title="enum CamelCipherHash">
168
180
<a name="CamelCipherHash"></a><h3>enum CamelCipherHash</h3>
169
181
<pre class="programlisting">typedef enum {
170
182
        CAMEL_CIPHER_HASH_DEFAULT,
180
192
</p>
181
193
</div>
182
194
<hr>
183
 
<div class="refsect2" lang="en">
 
195
<div class="refsect2" title="enum camel_cipher_validity_sign_t">
184
196
<a name="camel-cipher-validity-sign-t"></a><h3>enum camel_cipher_validity_sign_t</h3>
185
197
<pre class="programlisting">typedef enum _camel_cipher_validity_sign_t {
186
198
        CAMEL_CIPHER_VALIDITY_SIGN_NONE,
194
206
</p>
195
207
</div>
196
208
<hr>
197
 
<div class="refsect2" lang="en">
 
209
<div class="refsect2" title="enum camel_cipher_validity_encrypt_t">
198
210
<a name="camel-cipher-validity-encrypt-t"></a><h3>enum camel_cipher_validity_encrypt_t</h3>
199
211
<pre class="programlisting">typedef enum _camel_cipher_validity_encrypt_t {
200
212
        CAMEL_CIPHER_VALIDITY_ENCRYPT_NONE,
207
219
</p>
208
220
</div>
209
221
<hr>
210
 
<div class="refsect2" lang="en">
 
222
<div class="refsect2" title="enum camel_cipher_validity_mode_t">
211
223
<a name="camel-cipher-validity-mode-t"></a><h3>enum camel_cipher_validity_mode_t</h3>
212
224
<pre class="programlisting">typedef enum _camel_cipher_validity_mode_t {
213
225
        CAMEL_CIPHER_VALIDITY_SIGN,
218
230
</p>
219
231
</div>
220
232
<hr>
221
 
<div class="refsect2" lang="en">
 
233
<div class="refsect2" title="camel_cipher_context_new ()">
222
234
<a name="camel-cipher-context-new"></a><h3>camel_cipher_context_new ()</h3>
223
235
<pre class="programlisting"><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="returnvalue">CamelCipherContext</span></a> * camel_cipher_context_new           (<em class="parameter"><code><a class="link" href="camel-CamelSession.html#CamelSession" title="struct CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);</pre>
224
236
<p>
225
237
This creates a new CamelCipherContext object which is used to sign,
226
 
verify, encrypt and decrypt streams.</p>
 
238
verify, encrypt and decrypt streams.
 
239
</p>
227
240
<div class="variablelist"><table border="0">
228
241
<col align="left" valign="top">
229
242
<tbody>
241
254
</table></div>
242
255
</div>
243
256
<hr>
244
 
<div class="refsect2" lang="en">
 
257
<div class="refsect2" title="camel_cipher_context_construct ()">
245
258
<a name="camel-cipher-context-construct"></a><h3>camel_cipher_context_construct ()</h3>
246
259
<pre class="programlisting"><span class="returnvalue">void</span>                camel_cipher_context_construct      (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="type">CamelCipherContext</span></a> *context</code></em>,
247
260
                                                         <em class="parameter"><code><a class="link" href="camel-CamelSession.html#CamelSession" title="struct CamelSession"><span class="type">CamelSession</span></a> *session</code></em>);</pre>
248
261
<p>
249
 
Constucts the CamelCipherContext</p>
 
262
Constucts the CamelCipherContext
 
263
</p>
250
264
<div class="variablelist"><table border="0">
251
265
<col align="left" valign="top">
252
266
<tbody>
264
278
</table></div>
265
279
</div>
266
280
<hr>
267
 
<div class="refsect2" lang="en">
 
281
<div class="refsect2" title="camel_cipher_id_to_hash ()">
268
282
<a name="camel-cipher-id-to-hash"></a><h3>camel_cipher_id_to_hash ()</h3>
269
283
<pre class="programlisting"><a class="link" href="camel-CamelCipherContext.html#CamelCipherHash" title="enum CamelCipherHash"><span class="returnvalue">CamelCipherHash</span></a>     camel_cipher_id_to_hash             (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="type">CamelCipherContext</span></a> *context</code></em>,
270
284
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *id</code></em>);</pre>
292
306
</table></div>
293
307
</div>
294
308
<hr>
295
 
<div class="refsect2" lang="en">
 
309
<div class="refsect2" title="camel_cipher_hash_to_id ()">
296
310
<a name="camel-cipher-hash-to-id"></a><h3>camel_cipher_hash_to_id ()</h3>
297
311
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       camel_cipher_hash_to_id             (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="type">CamelCipherContext</span></a> *context</code></em>,
298
312
                                                         <em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherHash" title="enum CamelCipherHash"><span class="type">CamelCipherHash</span></a> hash</code></em>);</pre>
320
334
</table></div>
321
335
</div>
322
336
<hr>
323
 
<div class="refsect2" lang="en">
 
337
<div class="refsect2" title="camel_cipher_sign ()">
324
338
<a name="camel-cipher-sign"></a><h3>camel_cipher_sign ()</h3>
325
339
<pre class="programlisting"><span class="returnvalue">gint</span>                camel_cipher_sign                   (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="type">CamelCipherContext</span></a> *context</code></em>,
326
340
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *userid</code></em>,
330
344
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
331
345
<p>
332
346
Converts the (unsigned) part <em class="parameter"><code>ipart</code></em> into a new self-contained mime part <em class="parameter"><code>opart</code></em>.
333
 
This may be a multipart/signed part, or a simple part for enveloped types.</p>
 
347
This may be a multipart/signed part, or a simple part for enveloped types.
 
348
</p>
334
349
<div class="variablelist"><table border="0">
335
350
<col align="left" valign="top">
336
351
<tbody>
373
388
</table></div>
374
389
</div>
375
390
<hr>
376
 
<div class="refsect2" lang="en">
 
391
<div class="refsect2" title="camel_cipher_verify ()">
377
392
<a name="camel-cipher-verify"></a><h3>camel_cipher_verify ()</h3>
378
393
<pre class="programlisting"><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="returnvalue">CamelCipherValidity</span></a> * camel_cipher_verify               (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="type">CamelCipherContext</span></a> *context</code></em>,
379
394
                                                         <em class="parameter"><code><span class="type">struct _CamelMimePart</span> *ipart</code></em>,
382
397
Verifies the signature. If <em class="parameter"><code>istream</code></em> is a clearsigned stream,
383
398
you should pass <code class="literal">NULL</code> as the sigstream parameter. Otherwise
384
399
<em class="parameter"><code>sigstream</code></em> is assumed to be the signature stream and is used to
385
 
verify the integirity of the <em class="parameter"><code>istream</code></em>.</p>
 
400
verify the integirity of the <em class="parameter"><code>istream</code></em>.
 
401
</p>
386
402
<div class="variablelist"><table border="0">
387
403
<col align="left" valign="top">
388
404
<tbody>
412
428
</table></div>
413
429
</div>
414
430
<hr>
415
 
<div class="refsect2" lang="en">
 
431
<div class="refsect2" title="camel_cipher_encrypt ()">
416
432
<a name="camel-cipher-encrypt"></a><h3>camel_cipher_encrypt ()</h3>
417
433
<pre class="programlisting"><span class="returnvalue">gint</span>                camel_cipher_encrypt                (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="type">CamelCipherContext</span></a> *context</code></em>,
418
434
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *userid</code></em>,
422
438
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
423
439
<p>
424
440
Encrypts (and optionally signs) the cleartext input stream and
425
 
writes the resulting ciphertext to the output stream.</p>
 
441
writes the resulting ciphertext to the output stream.
 
442
</p>
426
443
<div class="variablelist"><table border="0">
427
444
<col align="left" valign="top">
428
445
<tbody>
465
482
</table></div>
466
483
</div>
467
484
<hr>
468
 
<div class="refsect2" lang="en">
 
485
<div class="refsect2" title="camel_cipher_decrypt ()">
469
486
<a name="camel-cipher-decrypt"></a><h3>camel_cipher_decrypt ()</h3>
470
487
<pre class="programlisting"><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="returnvalue">CamelCipherValidity</span></a> * camel_cipher_decrypt              (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="type">CamelCipherContext</span></a> *context</code></em>,
471
488
                                                         <em class="parameter"><code><span class="type">struct _CamelMimePart</span> *ipart</code></em>,
472
489
                                                         <em class="parameter"><code><span class="type">struct _CamelMimePart</span> *opart</code></em>,
473
490
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
474
491
<p>
475
 
Decrypts <em class="parameter"><code>ipart</code></em> into <em class="parameter"><code>opart</code></em>.</p>
 
492
Decrypts <em class="parameter"><code>ipart</code></em> into <em class="parameter"><code>opart</code></em>.
 
493
</p>
476
494
<div class="variablelist"><table border="0">
477
495
<col align="left" valign="top">
478
496
<tbody><tr>
483
501
</table></div>
484
502
</div>
485
503
<hr>
486
 
<div class="refsect2" lang="en">
 
504
<div class="refsect2" title="camel_cipher_import_keys ()">
487
505
<a name="camel-cipher-import-keys"></a><h3>camel_cipher_import_keys ()</h3>
488
506
<pre class="programlisting"><span class="returnvalue">gint</span>                camel_cipher_import_keys            (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="type">CamelCipherContext</span></a> *context</code></em>,
489
507
                                                         <em class="parameter"><code><span class="type">struct _CamelStream</span> *istream</code></em>,
490
508
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
491
509
<p>
492
510
Imports a stream of keys/certificates contained within <em class="parameter"><code>istream</code></em>
493
 
into the key/certificate database controlled by <em class="parameter"><code>ctx</code></em>.</p>
 
511
into the key/certificate database controlled by <em class="parameter"><code>ctx</code></em>.
 
512
</p>
494
513
<div class="variablelist"><table border="0">
495
514
<col align="left" valign="top">
496
515
<tbody>
518
537
</table></div>
519
538
</div>
520
539
<hr>
521
 
<div class="refsect2" lang="en">
 
540
<div class="refsect2" title="camel_cipher_export_keys ()">
522
541
<a name="camel-cipher-export-keys"></a><h3>camel_cipher_export_keys ()</h3>
523
542
<pre class="programlisting"><span class="returnvalue">gint</span>                camel_cipher_export_keys            (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherContext" title="CamelCipherContext"><span class="type">CamelCipherContext</span></a> *context</code></em>,
524
543
                                                         <em class="parameter"><code><span class="type">GPtrArray</span> *keys</code></em>,
526
545
                                                         <em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
527
546
<p>
528
547
Exports the keys/certificates in <em class="parameter"><code>keys</code></em> to the stream <em class="parameter"><code>ostream</code></em> from
529
 
the key/certificate database controlled by <em class="parameter"><code>ctx</code></em>.</p>
 
548
the key/certificate database controlled by <em class="parameter"><code>ctx</code></em>.
 
549
</p>
530
550
<div class="variablelist"><table border="0">
531
551
<col align="left" valign="top">
532
552
<tbody>
559
579
</table></div>
560
580
</div>
561
581
<hr>
562
 
<div class="refsect2" lang="en">
 
582
<div class="refsect2" title="camel_cipher_validity_new ()">
563
583
<a name="camel-cipher-validity-new"></a><h3>camel_cipher_validity_new ()</h3>
564
584
<pre class="programlisting"><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="returnvalue">CamelCipherValidity</span></a> * camel_cipher_validity_new         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
565
585
<p>
574
594
</table></div>
575
595
</div>
576
596
<hr>
577
 
<div class="refsect2" lang="en">
 
597
<div class="refsect2" title="camel_cipher_validity_init ()">
578
598
<a name="camel-cipher-validity-init"></a><h3>camel_cipher_validity_init ()</h3>
579
599
<pre class="programlisting"><span class="returnvalue">void</span>                camel_cipher_validity_init          (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *validity</code></em>);</pre>
580
600
<p>
589
609
</table></div>
590
610
</div>
591
611
<hr>
592
 
<div class="refsect2" lang="en">
 
612
<div class="refsect2" title="camel_cipher_validity_get_valid ()">
593
613
<a name="camel-cipher-validity-get-valid"></a><h3>camel_cipher_validity_get_valid ()</h3>
594
614
<pre class="programlisting"><span class="returnvalue">gboolean</span>            camel_cipher_validity_get_valid     (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *validity</code></em>);</pre>
595
615
<p>
611
631
</table></div>
612
632
</div>
613
633
<hr>
614
 
<div class="refsect2" lang="en">
 
634
<div class="refsect2" title="camel_cipher_validity_set_valid ()">
615
635
<a name="camel-cipher-validity-set-valid"></a><h3>camel_cipher_validity_set_valid ()</h3>
616
636
<pre class="programlisting"><span class="returnvalue">void</span>                camel_cipher_validity_set_valid     (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *validity</code></em>,
617
637
                                                         <em class="parameter"><code><span class="type">gboolean</span> valid</code></em>);</pre>
634
654
</table></div>
635
655
</div>
636
656
<hr>
637
 
<div class="refsect2" lang="en">
 
657
<div class="refsect2" title="camel_cipher_validity_get_description ()">
638
658
<a name="camel-cipher-validity-get-description"></a><h3>camel_cipher_validity_get_description ()</h3>
639
659
<pre class="programlisting"><span class="returnvalue">gchar</span> *             camel_cipher_validity_get_description
640
660
                                                        (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *validity</code></em>);</pre>
657
677
</table></div>
658
678
</div>
659
679
<hr>
660
 
<div class="refsect2" lang="en">
 
680
<div class="refsect2" title="camel_cipher_validity_set_description ()">
661
681
<a name="camel-cipher-validity-set-description"></a><h3>camel_cipher_validity_set_description ()</h3>
662
682
<pre class="programlisting"><span class="returnvalue">void</span>                camel_cipher_validity_set_description
663
683
                                                        (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *validity</code></em>,
681
701
</table></div>
682
702
</div>
683
703
<hr>
684
 
<div class="refsect2" lang="en">
 
704
<div class="refsect2" title="camel_cipher_validity_clear ()">
685
705
<a name="camel-cipher-validity-clear"></a><h3>camel_cipher_validity_clear ()</h3>
686
706
<pre class="programlisting"><span class="returnvalue">void</span>                camel_cipher_validity_clear         (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *validity</code></em>);</pre>
687
707
<p>
696
716
</table></div>
697
717
</div>
698
718
<hr>
699
 
<div class="refsect2" lang="en">
 
719
<div class="refsect2" title="camel_cipher_validity_clone ()">
700
720
<a name="camel-cipher-validity-clone"></a><h3>camel_cipher_validity_clone ()</h3>
701
721
<pre class="programlisting"><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="returnvalue">CamelCipherValidity</span></a> * camel_cipher_validity_clone       (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *vin</code></em>);</pre>
702
722
<p>
718
738
</table></div>
719
739
</div>
720
740
<hr>
721
 
<div class="refsect2" lang="en">
 
741
<div class="refsect2" title="camel_cipher_validity_add_certinfo ()">
722
742
<a name="camel-cipher-validity-add-certinfo"></a><h3>camel_cipher_validity_add_certinfo ()</h3>
723
743
<pre class="programlisting"><span class="returnvalue">void</span>                camel_cipher_validity_add_certinfo  (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *vin</code></em>,
724
744
                                                         <em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#camel-cipher-validity-mode-t" title="enum camel_cipher_validity_mode_t"><span class="type">camel_cipher_validity_mode_t</span></a> mode</code></em>,
725
745
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
726
746
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *email</code></em>);</pre>
727
747
<p>
728
 
Add a cert info to the signer or encrypter info.</p>
729
 
</div>
730
 
<hr>
731
 
<div class="refsect2" lang="en">
 
748
Add a cert info to the signer or encrypter info.
 
749
</p>
 
750
</div>
 
751
<hr>
 
752
<div class="refsect2" title="camel_cipher_validity_add_certinfo_ex ()">
 
753
<a name="camel-cipher-validity-add-certinfo-ex"></a><h3>camel_cipher_validity_add_certinfo_ex ()</h3>
 
754
<pre class="programlisting"><span class="returnvalue">void</span>                camel_cipher_validity_add_certinfo_ex
 
755
                                                        (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *vin</code></em>,
 
756
                                                         <em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#camel-cipher-validity-mode-t" title="enum camel_cipher_validity_mode_t"><span class="type">camel_cipher_validity_mode_t</span></a> mode</code></em>,
 
757
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
 
758
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *email</code></em>,
 
759
                                                         <em class="parameter"><code><span class="type">gpointer</span> cert_data</code></em>,
 
760
                                                         <em class="parameter"><code><span class="type">void</span> (cert_data_freegpointer cert_data) ()</code></em>,
 
761
                                                         <em class="parameter"><code><span class="type">gpointer</span> (cert_data_clonegpointer cert_data) ()</code></em>);</pre>
 
762
<p>
 
763
Add a cert info to the signer or encrypter info, with extended data set.
 
764
</p>
 
765
<div class="variablelist"><table border="0">
 
766
<col align="left" valign="top">
 
767
<tbody>
 
768
<tr>
 
769
<td><p><span class="term"><em class="parameter"><code>vin</code></em> :</span></p></td>
 
770
<td>
 
771
</td>
 
772
</tr>
 
773
<tr>
 
774
<td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
 
775
<td>
 
776
</td>
 
777
</tr>
 
778
<tr>
 
779
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 
780
<td>
 
781
</td>
 
782
</tr>
 
783
<tr>
 
784
<td><p><span class="term"><em class="parameter"><code>email</code></em> :</span></p></td>
 
785
<td>
 
786
</td>
 
787
</tr>
 
788
<tr>
 
789
<td><p><span class="term"><em class="parameter"><code>cert_data</code></em> :</span></p></td>
 
790
<td>
 
791
<em class="parameter"><code>gpointer</code></em> cert_data:
 
792
<em class="parameter"><code>gpointer</code></em> cert_data:
 
793
</td>
 
794
</tr>
 
795
</tbody>
 
796
</table></div>
 
797
<p class="since">Since 2.30</p>
 
798
</div>
 
799
<hr>
 
800
<div class="refsect2" title="camel_cipher_validity_envelope ()">
732
801
<a name="camel-cipher-validity-envelope"></a><h3>camel_cipher_validity_envelope ()</h3>
733
802
<pre class="programlisting"><span class="returnvalue">void</span>                camel_cipher_validity_envelope      (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *parent</code></em>,
734
803
                                                         <em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *valid</code></em>);</pre>
735
804
<p>
736
805
Calculate a conglomerate validity based on wrapping one secure part inside
737
 
another one.</p>
 
806
another one.
 
807
</p>
738
808
</div>
739
809
<hr>
740
 
<div class="refsect2" lang="en">
 
810
<div class="refsect2" title="camel_cipher_validity_free ()">
741
811
<a name="camel-cipher-validity-free"></a><h3>camel_cipher_validity_free ()</h3>
742
812
<pre class="programlisting"><span class="returnvalue">void</span>                camel_cipher_validity_free          (<em class="parameter"><code><a class="link" href="camel-CamelCipherContext.html#CamelCipherValidity" title="CamelCipherValidity"><span class="type">CamelCipherValidity</span></a> *validity</code></em>);</pre>
743
813
<p>
752
822
</table></div>
753
823
</div>
754
824
<hr>
755
 
<div class="refsect2" lang="en">
 
825
<div class="refsect2" title="camel_cipher_canonical_to_stream ()">
756
826
<a name="camel-cipher-canonical-to-stream"></a><h3>camel_cipher_canonical_to_stream ()</h3>
757
827
<pre class="programlisting"><span class="returnvalue">gint</span>                camel_cipher_canonical_to_stream    (<em class="parameter"><code><a class="link" href="camel-CamelMimePart.html#CamelMimePart" title="struct CamelMimePart"><span class="type">CamelMimePart</span></a> *part</code></em>,
758
828
                                                         <em class="parameter"><code><span class="type">guint32</span> flags</code></em>,
761
831
Writes a part to a stream in a canonicalised format, suitable for signing/encrypting.
762
832
</p>
763
833
<p>
764
 
The transfer encoding paramaters for the part may be changed by this function.</p>
 
834
The transfer encoding paramaters for the part may be changed by this function.
 
835
</p>
765
836
<div class="variablelist"><table border="0">
766
837
<col align="left" valign="top">
767
838
<tbody>