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

« back to all changes in this revision

Viewing changes to docs/reference/libedataserver/html/ESourceOpenPGP.html

  • Committer: Package Import Robot
  • Author(s): Robert Ancell
  • Date: 2012-11-13 10:12:28 UTC
  • mfrom: (1.1.107)
  • Revision ID: package-import@ubuntu.com-20121113101228-gvueq2vu386p625x
Tags: 3.6.2-0ubuntu1
* New upstream release
* debian/libcamel-1.2-40.symbols::
  - Updated
* debian/patches/dont-abort-in-e_source_registry_new.patch:
  - Applied upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
46
46
 
47
47
struct              <a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP-struct" title="struct ESourceOpenPGP">ESourceOpenPGP</a>;
48
48
#define             <a class="link" href="ESourceOpenPGP.html#E-SOURCE-EXTENSION-OPENPGP:CAPS" title="E_SOURCE_EXTENSION_OPENPGP">E_SOURCE_EXTENSION_OPENPGP</a>
49
 
<span class="returnvalue">gboolean</span>            <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-always-trust" title="e_source_openpgp_get_always_trust ()">e_source_openpgp_get_always_trust</a>   (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
 
49
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-always-trust" title="e_source_openpgp_get_always_trust ()">e_source_openpgp_get_always_trust</a>   (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
50
50
<span class="returnvalue">void</span>                <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-set-always-trust" title="e_source_openpgp_set_always_trust ()">e_source_openpgp_set_always_trust</a>   (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
51
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> always_trust</code></em>);
52
 
<span class="returnvalue">gboolean</span>            <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-encrypt-to-self" title="e_source_openpgp_get_encrypt_to_self ()">e_source_openpgp_get_encrypt_to_self</a>
 
51
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> always_trust</code></em>);
 
52
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-encrypt-to-self" title="e_source_openpgp_get_encrypt_to_self ()">e_source_openpgp_get_encrypt_to_self</a>
53
53
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
54
54
<span class="returnvalue">void</span>                <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-set-encrypt-to-self" title="e_source_openpgp_set_encrypt_to_self ()">e_source_openpgp_set_encrypt_to_self</a>
55
55
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
56
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> encrypt_to_self</code></em>);
57
 
const <span class="returnvalue">gchar</span> *       <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-key-id" title="e_source_openpgp_get_key_id ()">e_source_openpgp_get_key_id</a>         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
58
 
<span class="returnvalue">gchar</span> *             <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-dup-key-id" title="e_source_openpgp_dup_key_id ()">e_source_openpgp_dup_key_id</a>         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
 
56
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> encrypt_to_self</code></em>);
 
57
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-key-id" title="e_source_openpgp_get_key_id ()">e_source_openpgp_get_key_id</a>         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
 
58
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-dup-key-id" title="e_source_openpgp_dup_key_id ()">e_source_openpgp_dup_key_id</a>         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
59
59
<span class="returnvalue">void</span>                <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-set-key-id" title="e_source_openpgp_set_key_id ()">e_source_openpgp_set_key_id</a>         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
60
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *key_id</code></em>);
61
 
const <span class="returnvalue">gchar</span> *       <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-signing-algorithm" title="e_source_openpgp_get_signing_algorithm ()">e_source_openpgp_get_signing_algorithm</a>
 
60
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key_id</code></em>);
 
61
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-signing-algorithm" title="e_source_openpgp_get_signing_algorithm ()">e_source_openpgp_get_signing_algorithm</a>
62
62
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
63
 
<span class="returnvalue">gchar</span> *             <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-dup-signing-algorithm" title="e_source_openpgp_dup_signing_algorithm ()">e_source_openpgp_dup_signing_algorithm</a>
 
63
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-dup-signing-algorithm" title="e_source_openpgp_dup_signing_algorithm ()">e_source_openpgp_dup_signing_algorithm</a>
64
64
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
65
65
<span class="returnvalue">void</span>                <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-set-signing-algorithm" title="e_source_openpgp_set_signing_algorithm ()">e_source_openpgp_set_signing_algorithm</a>
66
66
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
67
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *signing_algorithm</code></em>);
68
 
<span class="returnvalue">gboolean</span>            <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-sign-by-default" title="e_source_openpgp_get_sign_by_default ()">e_source_openpgp_get_sign_by_default</a>
 
67
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signing_algorithm</code></em>);
 
68
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-sign-by-default" title="e_source_openpgp_get_sign_by_default ()">e_source_openpgp_get_sign_by_default</a>
69
69
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);
70
70
<span class="returnvalue">void</span>                <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-set-sign-by-default" title="e_source_openpgp_set_sign_by_default ()">e_source_openpgp_set_sign_by_default</a>
71
71
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
72
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> sign_by_default</code></em>);
 
72
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> sign_by_default</code></em>);
73
73
</pre>
74
74
</div>
75
75
<div class="refsect1">
76
76
<a name="ESourceOpenPGP.object-hierarchy"></a><h2>Object Hierarchy</h2>
77
77
<pre class="synopsis">
78
 
  GObject
 
78
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
79
79
   +----<a class="link" href="ESourceExtension.html" title="ESourceExtension">ESourceExtension</a>
80
80
         +----ESourceOpenPGP
81
81
</pre>
83
83
<div class="refsect1">
84
84
<a name="ESourceOpenPGP.properties"></a><h2>Properties</h2>
85
85
<pre class="synopsis">
86
 
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--always-trust" title='The "always-trust" property'>always-trust</a>"             <span class="type">gboolean</span>              : Read / Write / Construct
87
 
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--encrypt-to-self" title='The "encrypt-to-self" property'>encrypt-to-self</a>"          <span class="type">gboolean</span>              : Read / Write / Construct
88
 
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--key-id" title='The "key-id" property'>key-id</a>"                   <span class="type">gchar</span>*                : Read / Write / Construct
89
 
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--sign-by-default" title='The "sign-by-default" property'>sign-by-default</a>"          <span class="type">gboolean</span>              : Read / Write / Construct
90
 
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--signing-algorithm" title='The "signing-algorithm" property'>signing-algorithm</a>"        <span class="type">gchar</span>*                : Read / Write / Construct
 
86
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--always-trust" title='The "always-trust" property'>always-trust</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct
 
87
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--encrypt-to-self" title='The "encrypt-to-self" property'>encrypt-to-self</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct
 
88
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--key-id" title='The "key-id" property'>key-id</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct
 
89
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--sign-by-default" title='The "sign-by-default" property'>sign-by-default</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct
 
90
  "<a class="link" href="ESourceOpenPGP.html#ESourceOpenPGP--signing-algorithm" title='The "signing-algorithm" property'>signing-algorithm</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct
91
91
</pre>
92
92
</div>
93
93
<div class="refsect1">
110
110
3
111
111
4
112
112
5</pre></td>
113
 
        <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;libedataserver/e-source-openpgp.h&gt;</span>
114
 
 
115
 
<span class="usertype">ESourceOpenPGP</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">extension</span><span class="symbol">;</span>
116
 
 
117
 
<span class="normal">extension </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="ESource.html#e-source-get-extension">e_source_get_extension</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">source</span><span class="symbol">,</span><span class="normal"> <a href="ESourceOpenPGP.html#E-SOURCE-EXTENSION-OPENPGP:CAPS">E_SOURCE_EXTENSION_OPENPGP</a></span><span class="symbol">);</span></pre></td>
 
113
        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#include &lt;libedataserver/libedataserver.h&gt;</span>
 
114
 
 
115
ESourceOpenPGP <span class="gtkdoc opt">*</span>extension<span class="gtkdoc opt">;</span>
 
116
 
 
117
extension <span class="gtkdoc opt">=</span> <span class="function"><a href="ESource.html#e-source-get-extension">e_source_get_extension</a></span> <span class="gtkdoc opt">(</span>source<span class="gtkdoc opt">,</span> E_SOURCE_EXTENSION_OPENPGP<span class="gtkdoc opt">);</span></pre></td>
118
118
      </tr>
119
119
    </tbody>
120
120
  </table>
148
148
<hr>
149
149
<div class="refsect2">
150
150
<a name="e-source-openpgp-get-always-trust"></a><h3>e_source_openpgp_get_always_trust ()</h3>
151
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            e_source_openpgp_get_always_trust   (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
 
151
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            e_source_openpgp_get_always_trust   (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
152
152
<p>
153
153
Returns whether to skip key validation and assume that used keys are
154
154
always fully trusted.
173
173
<div class="refsect2">
174
174
<a name="e-source-openpgp-set-always-trust"></a><h3>e_source_openpgp_set_always_trust ()</h3>
175
175
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_openpgp_set_always_trust   (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
176
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> always_trust</code></em>);</pre>
 
176
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> always_trust</code></em>);</pre>
177
177
<p>
178
178
Sets whether to skip key validation and assume that used keys are
179
179
always fully trusted.
197
197
<hr>
198
198
<div class="refsect2">
199
199
<a name="e-source-openpgp-get-encrypt-to-self"></a><h3>e_source_openpgp_get_encrypt_to_self ()</h3>
200
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            e_source_openpgp_get_encrypt_to_self
 
200
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            e_source_openpgp_get_encrypt_to_self
201
201
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
202
202
<p>
203
203
Returns whether to "encrypt-to-self" when sending encrypted messages.
223
223
<a name="e-source-openpgp-set-encrypt-to-self"></a><h3>e_source_openpgp_set_encrypt_to_self ()</h3>
224
224
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_openpgp_set_encrypt_to_self
225
225
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
226
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> encrypt_to_self</code></em>);</pre>
 
226
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> encrypt_to_self</code></em>);</pre>
227
227
<p>
228
228
Sets whether to "encrypt-to-self" when sending encrypted messages.
229
229
</p>
246
246
<hr>
247
247
<div class="refsect2">
248
248
<a name="e-source-openpgp-get-key-id"></a><h3>e_source_openpgp_get_key_id ()</h3>
249
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       e_source_openpgp_get_key_id         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
 
249
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       e_source_openpgp_get_key_id         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
250
250
<p>
251
251
Returns the OpenPGP key ID used to sign and encrypt messages.
252
252
</p>
269
269
<hr>
270
270
<div class="refsect2">
271
271
<a name="e-source-openpgp-dup-key-id"></a><h3>e_source_openpgp_dup_key_id ()</h3>
272
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *             e_source_openpgp_dup_key_id         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
 
272
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             e_source_openpgp_dup_key_id         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
273
273
<p>
274
274
Thread-safe variation of <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-key-id" title="e_source_openpgp_get_key_id ()"><code class="function">e_source_openpgp_get_key_id()</code></a>.
275
275
Use this function when accessing <em class="parameter"><code>extension</code></em> from multiple threads.
276
276
</p>
277
277
<p>
278
 
The returned string should be freed with <code class="function">g_free()</code> when no longer needed.
 
278
The returned string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.
279
279
</p>
280
280
<div class="variablelist"><table border="0">
281
281
<col align="left" valign="top">
298
298
<div class="refsect2">
299
299
<a name="e-source-openpgp-set-key-id"></a><h3>e_source_openpgp_set_key_id ()</h3>
300
300
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_openpgp_set_key_id         (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
301
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *key_id</code></em>);</pre>
 
301
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key_id</code></em>);</pre>
302
302
<p>
303
303
Sets the OpenPGP key ID used to sign and encrypt messages.
304
304
</p>
305
305
<p>
306
306
The internal copy of <em class="parameter"><code>key_id</code></em> is automatically stripped of leading and
307
 
trailing whitespace.  If the resulting string is empty, <code class="literal">NULL</code> is set
 
307
trailing whitespace.  If the resulting string is empty, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is set
308
308
instead.
309
309
</p>
310
310
<div class="variablelist"><table border="0">
326
326
<hr>
327
327
<div class="refsect2">
328
328
<a name="e-source-openpgp-get-signing-algorithm"></a><h3>e_source_openpgp_get_signing_algorithm ()</h3>
329
 
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       e_source_openpgp_get_signing_algorithm
 
329
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       e_source_openpgp_get_signing_algorithm
330
330
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
331
331
<p>
332
332
Returns the name of the hash algorithm used to digitally sign outgoing
351
351
<hr>
352
352
<div class="refsect2">
353
353
<a name="e-source-openpgp-dup-signing-algorithm"></a><h3>e_source_openpgp_dup_signing_algorithm ()</h3>
354
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *             e_source_openpgp_dup_signing_algorithm
 
354
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             e_source_openpgp_dup_signing_algorithm
355
355
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
356
356
<p>
357
357
Thread-safe variation of <a class="link" href="ESourceOpenPGP.html#e-source-openpgp-get-signing-algorithm" title="e_source_openpgp_get_signing_algorithm ()"><code class="function">e_source_openpgp_get_signing_algorithm()</code></a>.
358
358
Use this function when accessing <em class="parameter"><code>extension</code></em> from multiple threads.
359
359
</p>
360
360
<p>
361
 
The returned string should be freed with <code class="function">g_free()</code> when no longer needed.
 
361
The returned string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.
362
362
</p>
363
363
<div class="variablelist"><table border="0">
364
364
<col align="left" valign="top">
382
382
<a name="e-source-openpgp-set-signing-algorithm"></a><h3>e_source_openpgp_set_signing_algorithm ()</h3>
383
383
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_openpgp_set_signing_algorithm
384
384
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
385
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *signing_algorithm</code></em>);</pre>
 
385
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signing_algorithm</code></em>);</pre>
386
386
<p>
387
387
Sets the name of the hash algorithm used to digitally sign outgoing
388
388
messages.
390
390
<p>
391
391
The internal copy of <em class="parameter"><code>signing_algorithm</code></em> is automatically stripped of
392
392
leading and trailing whitespace.  If the resulting string is empty,
393
 
<code class="literal">NULL</code> is set instead.
 
393
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is set instead.
394
394
</p>
395
395
<div class="variablelist"><table border="0">
396
396
<col align="left" valign="top">
411
411
<hr>
412
412
<div class="refsect2">
413
413
<a name="e-source-openpgp-get-sign-by-default"></a><h3>e_source_openpgp_get_sign_by_default ()</h3>
414
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            e_source_openpgp_get_sign_by_default
 
414
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            e_source_openpgp_get_sign_by_default
415
415
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>);</pre>
416
416
<p>
417
417
Returns whether to digitally sign outgoing messages by default using
438
438
<a name="e-source-openpgp-set-sign-by-default"></a><h3>e_source_openpgp_set_sign_by_default ()</h3>
439
439
<pre class="programlisting"><span class="returnvalue">void</span>                e_source_openpgp_set_sign_by_default
440
440
                                                        (<em class="parameter"><code><a class="link" href="ESourceOpenPGP.html" title="ESourceOpenPGP"><span class="type">ESourceOpenPGP</span></a> *extension</code></em>,
441
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> sign_by_default</code></em>);</pre>
 
441
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> sign_by_default</code></em>);</pre>
442
442
<p>
443
443
Sets whether to digitally sign outgoing messages by default using
444
444
OpenPGP-compliant software such as GNU Privacy Guard (GnuPG).
464
464
<a name="ESourceOpenPGP.property-details"></a><h2>Property Details</h2>
465
465
<div class="refsect2">
466
466
<a name="ESourceOpenPGP--always-trust"></a><h3>The <code class="literal">"always-trust"</code> property</h3>
467
 
<pre class="programlisting">  "always-trust"             <span class="type">gboolean</span>              : Read / Write / Construct</pre>
 
467
<pre class="programlisting">  "always-trust"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct</pre>
468
468
<p>Always trust keys in my keyring.</p>
469
469
<p>Default value: FALSE</p>
470
470
</div>
471
471
<hr>
472
472
<div class="refsect2">
473
473
<a name="ESourceOpenPGP--encrypt-to-self"></a><h3>The <code class="literal">"encrypt-to-self"</code> property</h3>
474
 
<pre class="programlisting">  "encrypt-to-self"          <span class="type">gboolean</span>              : Read / Write / Construct</pre>
 
474
<pre class="programlisting">  "encrypt-to-self"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct</pre>
475
475
<p>Always encrypt to myself.</p>
476
476
<p>Default value: TRUE</p>
477
477
</div>
478
478
<hr>
479
479
<div class="refsect2">
480
480
<a name="ESourceOpenPGP--key-id"></a><h3>The <code class="literal">"key-id"</code> property</h3>
481
 
<pre class="programlisting">  "key-id"                   <span class="type">gchar</span>*                : Read / Write / Construct</pre>
 
481
<pre class="programlisting">  "key-id"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct</pre>
482
482
<p>PGP/GPG Key ID.</p>
483
483
<p>Default value: NULL</p>
484
484
</div>
485
485
<hr>
486
486
<div class="refsect2">
487
487
<a name="ESourceOpenPGP--sign-by-default"></a><h3>The <code class="literal">"sign-by-default"</code> property</h3>
488
 
<pre class="programlisting">  "sign-by-default"          <span class="type">gboolean</span>              : Read / Write / Construct</pre>
 
488
<pre class="programlisting">  "sign-by-default"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write / Construct</pre>
489
489
<p>Sign outgoing messages by default.</p>
490
490
<p>Default value: FALSE</p>
491
491
</div>
492
492
<hr>
493
493
<div class="refsect2">
494
494
<a name="ESourceOpenPGP--signing-algorithm"></a><h3>The <code class="literal">"signing-algorithm"</code> property</h3>
495
 
<pre class="programlisting">  "signing-algorithm"        <span class="type">gchar</span>*                : Read / Write / Construct</pre>
 
495
<pre class="programlisting">  "signing-algorithm"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct</pre>
496
496
<p>Hash algorithm used to sign messages.</p>
497
497
<p>Default value: NULL</p>
498
498
</div>