Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > by-pkgid > 98d6b53e11e983e268c3e19f14e091a0 > files > 4758

kdepim-devel-doc-3.5.9-9mdv2008.1.x86_64.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">

<head>
  <title>libkpgp: kpgp.cpp Source File (libkpgp)</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

  <meta http-equiv="Content-Style-Type" content="text/css" />

  <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org"  r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org"  r (n 0 s 0 v 0 l 0))' />

  <meta name="trademark" content="KDE e.V." />
  <meta name="description" content="K Desktop Environment Homepage, KDE.org" />
  <meta name="MSSmartTagsPreventParsing" content="true" />
  <meta name="robots" content="all" />

  <link rel="shortcut icon" href="../../favicon.ico" />

<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />



<style type="text/css">
<!--
hr { display: none; }
#content h2 { margin-left: 0px; }
table.mdTable { background-color: #f8f8f8; border: .2em solid #d7d7d7; }
td.mdRow { padding: 8px 20px; }
td.md { font-weight: bold; }
td.mdname1 { font-weight: bold; color: #602020; }
td.mdname { font-weight: bold; color: #602020;  }

-->
</style>

</head>

<body>

<div id="nav_header_top" align="right">
  <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>

  <a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a>
  <span class="doNotDisplay">::</span>
  <img id="nav_header_logo_right" alt="" align="right" src="../../pimlogo.png" border="0" />

  <div id="nav_header_title" align="left">KDE PIM API Reference</div>


</div>

<div id="nav_header_bottom" align="right">
  <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
  <div id="nav_header_bottom_left" style="text-align: left;">
/ <a href="../../">API Reference</a>
 / <a href=".">libkpgp</a>
  </div>
</div>


<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
      <td valign="top" class="menuheader" height="0"></td>

  <td id="contentcolumn" valign="top" rowspan="2" >
    <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
    <h2><a name="content"></a>libkpgp</h2>


<!-- Generated by Doxygen 1.5.5 -->
<h1>kpgp.cpp</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*  -*- mode: C++; c-file-style: "gnu" -*-</span>
<a name="l00002"></a>00002 <span class="comment">    kpgp.cpp</span>
<a name="l00003"></a>00003 <span class="comment"></span>
<a name="l00004"></a>00004 <span class="comment">    Copyright (C) 2001,2002 the KPGP authors</span>
<a name="l00005"></a>00005 <span class="comment">    See file AUTHORS.kpgp for details</span>
<a name="l00006"></a>00006 <span class="comment"></span>
<a name="l00007"></a>00007 <span class="comment">    This file is part of KPGP, the KDE PGP/GnuPG support library.</span>
<a name="l00008"></a>00008 <span class="comment"></span>
<a name="l00009"></a>00009 <span class="comment">    KPGP is free software; you can redistribute it and/or modify</span>
<a name="l00010"></a>00010 <span class="comment">    it under the terms of the GNU General Public License as published by</span>
<a name="l00011"></a>00011 <span class="comment">    the Free Software Foundation; either version 2 of the License, or</span>
<a name="l00012"></a>00012 <span class="comment">    (at your option) any later version.</span>
<a name="l00013"></a>00013 <span class="comment"></span>
<a name="l00014"></a>00014 <span class="comment">    You should have received a copy of the GNU General Public License</span>
<a name="l00015"></a>00015 <span class="comment">    along with this program; if not, write to the Free Software Foundation,</span>
<a name="l00016"></a>00016 <span class="comment">    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA</span>
<a name="l00017"></a>00017 <span class="comment"> */</span>
<a name="l00018"></a>00018 
<a name="l00019"></a>00019 <span class="preprocessor">#include &lt;stdio.h&gt;</span>
<a name="l00020"></a>00020 <span class="preprocessor">#include &lt;time.h&gt;</span>
<a name="l00021"></a>00021 <span class="preprocessor">#include &lt;stdlib.h&gt;</span>
<a name="l00022"></a>00022 <span class="preprocessor">#include &lt;assert.h&gt;</span>
<a name="l00023"></a>00023 <span class="preprocessor">#include &lt;stdarg.h&gt;</span>
<a name="l00024"></a>00024 <span class="preprocessor">#include &lt;fcntl.h&gt;</span>
<a name="l00025"></a>00025 <span class="preprocessor">#include &lt;unistd.h&gt;</span>
<a name="l00026"></a>00026 <span class="preprocessor">#include &lt;string.h&gt;</span>
<a name="l00027"></a>00027 <span class="preprocessor">#include &lt;sys/socket.h&gt;</span>
<a name="l00028"></a>00028 <span class="preprocessor">#include &lt;sys/types.h&gt;</span>
<a name="l00029"></a>00029 <span class="preprocessor">#include &lt;sys/stat.h&gt;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &lt;sys/wait.h&gt;</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include &lt;signal.h&gt;</span>
<a name="l00032"></a>00032 
<a name="l00033"></a>00033 <span class="preprocessor">#include &lt;qlabel.h&gt;</span>
<a name="l00034"></a>00034 <span class="preprocessor">#include &lt;qcursor.h&gt;</span>
<a name="l00035"></a>00035 <span class="preprocessor">#include &lt;qapplication.h&gt;</span>
<a name="l00036"></a>00036 
<a name="l00037"></a>00037 <span class="preprocessor">#include &lt;kdebug.h&gt;</span>
<a name="l00038"></a>00038 <span class="preprocessor">#include &lt;klocale.h&gt;</span>
<a name="l00039"></a>00039 <span class="preprocessor">#include &lt;kmessagebox.h&gt;</span>
<a name="l00040"></a>00040 <span class="preprocessor">#include &lt;kconfigbase.h&gt;</span>
<a name="l00041"></a>00041 <span class="preprocessor">#include &lt;kconfig.h&gt;</span>
<a name="l00042"></a>00042 <span class="preprocessor">#include &lt;kstaticdeleter.h&gt;</span>
<a name="l00043"></a>00043 
<a name="l00044"></a>00044 <span class="preprocessor">#include "kpgpbase.h"</span>
<a name="l00045"></a>00045 <span class="preprocessor">#include "kpgpui.h"</span>
<a name="l00046"></a>00046 <span class="preprocessor">#include "kpgp.h"</span>
<a name="l00047"></a>00047 
<a name="l00048"></a>00048 <span class="keyword">namespace </span>Kpgp {
<a name="l00049"></a>00049 
<a name="l00050"></a>00050 Module *Module::kpgpObject = 0L;
<a name="l00051"></a>00051 <span class="keyword">static</span> KStaticDeleter&lt;Module&gt; kpgpod;
<a name="l00052"></a>00052 
<a name="l00053"></a>00053 Module::Module()
<a name="l00054"></a>00054   : mPublicKeys(),
<a name="l00055"></a>00055     mPublicKeysCached(false),
<a name="l00056"></a>00056     mSecretKeys(),
<a name="l00057"></a>00057     mSecretKeysCached(false),
<a name="l00058"></a>00058     passphrase(0), passphrase_buffer_len(0), havePassPhrase(false)
<a name="l00059"></a>00059 {
<a name="l00060"></a>00060   <span class="keywordflow">if</span> (!kpgpObject) {
<a name="l00061"></a>00061     kdDebug(5100) &lt;&lt; <span class="stringliteral">"creating new pgp object"</span> &lt;&lt; endl;
<a name="l00062"></a>00062   }
<a name="l00063"></a>00063   kpgpObject=kpgpod.setObject(Module::kpgpObject, <span class="keyword">this</span>);
<a name="l00064"></a>00064   pgp = 0;
<a name="l00065"></a>00065 
<a name="l00066"></a>00066   config = <span class="keyword">new</span> KConfig(<span class="stringliteral">"kpgprc"</span>);
<a name="l00067"></a>00067 
<a name="l00068"></a>00068   init();
<a name="l00069"></a>00069 }
<a name="l00070"></a>00070 
<a name="l00071"></a>00071 Module::~Module()
<a name="l00072"></a>00072 {
<a name="l00073"></a>00073   writeAddressData();
<a name="l00074"></a>00074 
<a name="l00075"></a>00075   <span class="keywordflow">if</span> (kpgpObject == <span class="keyword">this</span>) kpgpObject = kpgpod.setObject( Module::kpgpObject, 0, <span class="keyword">false</span> );
<a name="l00076"></a>00076   clear(TRUE);
<a name="l00077"></a>00077   <span class="keyword">delete</span> config;
<a name="l00078"></a>00078   <span class="keyword">delete</span> pgp;
<a name="l00079"></a>00079 }
<a name="l00080"></a>00080 
<a name="l00081"></a>00081 <span class="comment">// ----------------- public methods -------------------------</span>
<a name="l00082"></a>00082 
<a name="l00083"></a>00083 <span class="keywordtype">void</span>
<a name="l00084"></a>00084 Module::init()
<a name="l00085"></a>00085 {
<a name="l00086"></a>00086   wipePassPhrase();
<a name="l00087"></a>00087 
<a name="l00088"></a>00088   <span class="comment">// read kpgp config file entries</span>
<a name="l00089"></a>00089   readConfig();
<a name="l00090"></a>00090 
<a name="l00091"></a>00091   <span class="comment">// read the email address -&gt; { encryption keys, encryption preference }</span>
<a name="l00092"></a>00092   <span class="comment">// associations</span>
<a name="l00093"></a>00093   readAddressData();
<a name="l00094"></a>00094 
<a name="l00095"></a>00095   <span class="comment">// do we have a pgp executable</span>
<a name="l00096"></a>00096   checkForPGP();
<a name="l00097"></a>00097 
<a name="l00098"></a>00098   <span class="comment">// create the Base object later when it is</span>
<a name="l00099"></a>00099   <span class="comment">// needed to avoid the costly check done for</span>
<a name="l00100"></a>00100   <span class="comment">// the autodetection of PGP 2/6</span>
<a name="l00101"></a>00101   <span class="comment">//assignPGPBase();</span>
<a name="l00102"></a>00102   <span class="keyword">delete</span> pgp;
<a name="l00103"></a>00103   pgp=0;
<a name="l00104"></a>00104 }
<a name="l00105"></a>00105 
<a name="l00106"></a>00106 
<a name="l00107"></a>00107 <span class="keywordtype">void</span>
<a name="l00108"></a>00108 Module::readConfig()
<a name="l00109"></a>00109 {
<a name="l00110"></a>00110   storePass = config-&gt;readBoolEntry(<span class="stringliteral">"storePass"</span>, <span class="keyword">false</span>);
<a name="l00111"></a>00111   showEncryptionResult = config-&gt;readBoolEntry(<span class="stringliteral">"showEncryptionResult"</span>, <span class="keyword">true</span>);
<a name="l00112"></a>00112   mShowKeyApprovalDlg = config-&gt;readBoolEntry( <span class="stringliteral">"showKeysForApproval"</span>, <span class="keyword">true</span> );
<a name="l00113"></a>00113   <span class="comment">// We have no config GUI for this key anymore, and the KPGP backend isn't ported,</span>
<a name="l00114"></a>00114   <span class="comment">// so let's just use Auto all the time.  See #92619.</span>
<a name="l00116"></a>00116 <span class="comment"></span>  pgpType = tAuto;
<a name="l00117"></a>00117   flagEncryptToSelf = config-&gt;readBoolEntry(<span class="stringliteral">"encryptToSelf"</span>, <span class="keyword">true</span>);
<a name="l00118"></a>00118 }
<a name="l00119"></a>00119 
<a name="l00120"></a>00120 <span class="keywordtype">void</span>
<a name="l00121"></a>00121 Module::writeConfig(<span class="keywordtype">bool</span> sync)
<a name="l00122"></a>00122 {
<a name="l00123"></a>00123   config-&gt;writeEntry(<span class="stringliteral">"storePass"</span>, storePass);
<a name="l00124"></a>00124   config-&gt;writeEntry(<span class="stringliteral">"showEncryptionResult"</span>, showEncryptionResult);
<a name="l00125"></a>00125   config-&gt;writeEntry( <span class="stringliteral">"showKeysForApproval"</span>, mShowKeyApprovalDlg );
<a name="l00126"></a>00126   <span class="comment">//config-&gt;writeEntry("pgpType", (int) pgpType);</span>
<a name="l00127"></a>00127   config-&gt;writeEntry(<span class="stringliteral">"encryptToSelf"</span>, flagEncryptToSelf);
<a name="l00128"></a>00128 
<a name="l00129"></a>00129   <span class="keywordflow">if</span>(sync)
<a name="l00130"></a>00130     config-&gt;sync();
<a name="l00131"></a>00131 
<a name="l00134"></a>00134   <span class="keyword">delete</span> pgp;
<a name="l00135"></a>00135   pgp = 0;
<a name="l00136"></a>00136 }
<a name="l00137"></a>00137 
<a name="l00138"></a>00138 
<a name="l00139"></a>00139 <span class="keywordtype">void</span>
<a name="l00140"></a>00140 Module::setUser(<span class="keyword">const</span> KeyID&amp; keyID)
<a name="l00141"></a>00141 {
<a name="l00142"></a>00142   <span class="keywordflow">if</span> (pgpUser != keyID) {
<a name="l00143"></a>00143     pgpUser = keyID;
<a name="l00144"></a>00144     wipePassPhrase();
<a name="l00145"></a>00145   }
<a name="l00146"></a>00146 }
<a name="l00147"></a>00147 
<a name="l00148"></a>00148 <span class="keyword">const</span> KeyID
<a name="l00149"></a>00149 Module::user(<span class="keywordtype">void</span>)<span class="keyword"> const</span>
<a name="l00150"></a>00150 <span class="keyword"></span>{
<a name="l00151"></a>00151   <span class="keywordflow">return</span> pgpUser;
<a name="l00152"></a>00152 }
<a name="l00153"></a>00153 
<a name="l00154"></a>00154 
<a name="l00155"></a>00155 <span class="keywordtype">void</span>
<a name="l00156"></a>00156 Module::setEncryptToSelf(<span class="keywordtype">bool</span> flag)
<a name="l00157"></a>00157 {
<a name="l00158"></a>00158   flagEncryptToSelf = flag;
<a name="l00159"></a>00159 }
<a name="l00160"></a>00160 
<a name="l00161"></a>00161 <span class="keywordtype">bool</span>
<a name="l00162"></a>00162 Module::encryptToSelf(<span class="keywordtype">void</span>)<span class="keyword"> const</span>
<a name="l00163"></a>00163 <span class="keyword"></span>{
<a name="l00164"></a>00164   <span class="keywordflow">return</span> flagEncryptToSelf;
<a name="l00165"></a>00165 }
<a name="l00166"></a>00166 
<a name="l00167"></a>00167 
<a name="l00168"></a>00168 <span class="keywordtype">void</span>
<a name="l00169"></a>00169 Module::setStorePassPhrase(<span class="keywordtype">bool</span> flag)
<a name="l00170"></a>00170 {
<a name="l00171"></a>00171   storePass = flag;
<a name="l00172"></a>00172 }
<a name="l00173"></a>00173 
<a name="l00174"></a>00174 <span class="keywordtype">bool</span>
<a name="l00175"></a>00175 Module::storePassPhrase(<span class="keywordtype">void</span>)<span class="keyword"> const</span>
<a name="l00176"></a>00176 <span class="keyword"></span>{
<a name="l00177"></a>00177   <span class="keywordflow">return</span> storePass;
<a name="l00178"></a>00178 }
<a name="l00179"></a>00179 
<a name="l00180"></a>00180 <span class="keywordtype">int</span>
<a name="l00181"></a>00181 Module::prepare( <span class="keywordtype">bool</span> needPassPhrase, Block* block )
<a name="l00182"></a>00182 {
<a name="l00183"></a>00183   <span class="keywordflow">if</span> (0 == pgp) assignPGPBase();
<a name="l00184"></a>00184 
<a name="l00185"></a>00185   <span class="keywordflow">if</span>(!havePgp)
<a name="l00186"></a>00186   {
<a name="l00187"></a>00187     errMsg = i18n(<span class="stringliteral">"Could not find PGP executable.\n"</span>
<a name="l00188"></a>00188                <span class="stringliteral">"Please check your PATH is set correctly."</span>);
<a name="l00189"></a>00189     <span class="keywordflow">return</span> 0;
<a name="l00190"></a>00190   }
<a name="l00191"></a>00191 
<a name="l00192"></a>00192   <span class="keywordflow">if</span>( block &amp;&amp; ( block-&gt;status() &amp; NO_SEC_KEY ) )
<a name="l00193"></a>00193     <span class="keywordflow">return</span> 0;
<a name="l00194"></a>00194 
<a name="l00195"></a>00195   <span class="keywordflow">if</span>(needPassPhrase &amp;&amp; !havePassPhrase) {
<a name="l00196"></a>00196     <span class="keywordflow">if</span>( ( tGPG == pgpType ) &amp;&amp; ( 0 != getenv(<span class="stringliteral">"GPG_AGENT_INFO"</span>) ) ) {
<a name="l00197"></a>00197       <span class="comment">// the user uses gpg-agent which asks itself for the passphrase</span>
<a name="l00198"></a>00198       kdDebug(5100) &lt;&lt; <span class="stringliteral">"user uses gpg-agent -&gt; don't ask for passphrase\n"</span>;
<a name="l00199"></a>00199       <span class="comment">// set dummy passphrase (because else signing doesn't work -&gt; FIXME)</span>
<a name="l00200"></a>00200       setPassPhrase( <span class="stringliteral">"dummy"</span> );
<a name="l00201"></a>00201     }
<a name="l00202"></a>00202     <span class="keywordflow">else</span> {
<a name="l00203"></a>00203       QString ID;
<a name="l00204"></a>00204       <span class="keywordflow">if</span>( block )
<a name="l00205"></a>00205         ID = block-&gt;requiredUserId();
<a name="l00206"></a>00206       PassphraseDialog passdlg(0, i18n(<span class="stringliteral">"OpenPGP Security Check"</span>), <span class="keyword">true</span>, ID);
<a name="l00207"></a>00207       QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00208"></a>00208       <span class="keywordtype">int</span> passdlgResult = passdlg.exec();
<a name="l00209"></a>00209       QApplication::restoreOverrideCursor();
<a name="l00210"></a>00210       <span class="keywordflow">if</span> (passdlgResult == QDialog::Accepted) {
<a name="l00211"></a>00211         <span class="keywordflow">if</span> (!setPassPhrase(passdlg.passphrase())) {
<a name="l00212"></a>00212           <span class="keywordflow">if</span> (strlen(passdlg.passphrase()) &gt;= 1024)
<a name="l00213"></a>00213              errMsg = i18n(<span class="stringliteral">"Passphrase is too long, it must contain fewer than 1024 characters."</span>);
<a name="l00214"></a>00214           <span class="keywordflow">else</span>
<a name="l00215"></a>00215              errMsg = i18n(<span class="stringliteral">"Out of memory."</span>);
<a name="l00216"></a>00216     <span class="keywordflow">return</span> 0;
<a name="l00217"></a>00217         }
<a name="l00218"></a>00218       } <span class="keywordflow">else</span> {
<a name="l00219"></a>00219         wipePassPhrase();
<a name="l00220"></a>00220         <span class="keywordflow">return</span> -1;
<a name="l00221"></a>00221       }
<a name="l00222"></a>00222     }
<a name="l00223"></a>00223   }
<a name="l00224"></a>00224   <span class="keywordflow">return</span> 1;
<a name="l00225"></a>00225 }
<a name="l00226"></a>00226 
<a name="l00227"></a>00227 <span class="keywordtype">void</span>
<a name="l00228"></a>00228 Module::wipePassPhrase(<span class="keywordtype">bool</span> freeMem)
<a name="l00229"></a>00229 {
<a name="l00230"></a>00230   <span class="keywordflow">if</span> ( passphrase ) {
<a name="l00231"></a>00231     <span class="keywordflow">if</span> ( passphrase_buffer_len )
<a name="l00232"></a>00232       memset( passphrase, 0x00, passphrase_buffer_len );
<a name="l00233"></a>00233     <span class="keywordflow">else</span> {
<a name="l00234"></a>00234       kdDebug(5100) &lt;&lt; <span class="stringliteral">"wipePassPhrase: passphrase &amp;&amp; !passphrase_buffer_len ???"</span> &lt;&lt; endl;
<a name="l00235"></a>00235       passphrase = 0;
<a name="l00236"></a>00236     }
<a name="l00237"></a>00237   }
<a name="l00238"></a>00238   <span class="keywordflow">if</span> ( freeMem &amp;&amp; passphrase ) {
<a name="l00239"></a>00239     free( passphrase );
<a name="l00240"></a>00240     passphrase = 0;
<a name="l00241"></a>00241     passphrase_buffer_len = 0;
<a name="l00242"></a>00242   }
<a name="l00243"></a>00243   havePassPhrase = <span class="keyword">false</span>;
<a name="l00244"></a>00244 }
<a name="l00245"></a>00245 
<a name="l00246"></a>00246 <span class="keywordtype">bool</span>
<a name="l00247"></a>00247 Module::verify( Block&amp; block )
<a name="l00248"></a>00248 {
<a name="l00249"></a>00249   <span class="keywordtype">int</span> retval;
<a name="l00250"></a>00250 
<a name="l00251"></a>00251   <span class="keywordflow">if</span> (0 == pgp) assignPGPBase();
<a name="l00252"></a>00252 
<a name="l00253"></a>00253   <span class="comment">// everything ready</span>
<a name="l00254"></a>00254   <span class="keywordflow">if</span>( !prepare( <span class="keyword">false</span>, &amp;block ) )
<a name="l00255"></a>00255     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00256"></a>00256   <span class="comment">// ok now try to verify the message.</span>
<a name="l00257"></a>00257   retval = pgp-&gt;verify( block );
<a name="l00258"></a>00258 
<a name="l00259"></a>00259   <span class="keywordflow">if</span>(retval &amp; ERROR)
<a name="l00260"></a>00260   {
<a name="l00261"></a>00261     errMsg = pgp-&gt;lastErrorMessage();
<a name="l00262"></a>00262     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00263"></a>00263   }
<a name="l00264"></a>00264   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00265"></a>00265 }
<a name="l00266"></a>00266 
<a name="l00267"></a>00267 <span class="keywordtype">bool</span>
<a name="l00268"></a>00268 Module::decrypt( Block&amp; block )
<a name="l00269"></a>00269 {
<a name="l00270"></a>00270   <span class="keywordtype">int</span> retval;
<a name="l00271"></a>00271 
<a name="l00272"></a>00272   <span class="keywordflow">if</span> (0 == pgp) assignPGPBase();
<a name="l00273"></a>00273 
<a name="l00274"></a>00274   <span class="keywordflow">do</span> {
<a name="l00275"></a>00275     <span class="comment">// loop as long as the user enters a wrong passphrase and doesn't abort</span>
<a name="l00276"></a>00276     <span class="comment">// everything ready</span>
<a name="l00277"></a>00277     <span class="keywordflow">if</span>( prepare( <span class="keyword">true</span>, &amp;block ) != 1 )
<a name="l00278"></a>00278       <span class="keywordflow">return</span> FALSE;
<a name="l00279"></a>00279     <span class="comment">// ok now try to decrypt the message.</span>
<a name="l00280"></a>00280     retval = pgp-&gt;decrypt( block, passphrase );
<a name="l00281"></a>00281     <span class="comment">// loop on bad passphrase</span>
<a name="l00282"></a>00282     <span class="keywordflow">if</span>( retval &amp; BADPHRASE ) {
<a name="l00283"></a>00283       wipePassPhrase();
<a name="l00284"></a>00284       QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00285"></a>00285       <span class="keywordtype">int</span> ret = KMessageBox::warningContinueCancel(0,
<a name="l00286"></a>00286          i18n(<span class="stringliteral">"You just entered an invalid passphrase.\n"</span>
<a name="l00287"></a>00287           <span class="stringliteral">"Do you want to try again, or "</span>
<a name="l00288"></a>00288           <span class="stringliteral">"cancel and view the message undecrypted?"</span>),
<a name="l00289"></a>00289          i18n(<span class="stringliteral">"PGP Warning"</span>), i18n(<span class="stringliteral">"&amp;Retry"</span>));
<a name="l00290"></a>00290       QApplication::restoreOverrideCursor();
<a name="l00291"></a>00291       <span class="keywordflow">if</span> ( ret == KMessageBox::Cancel ) <span class="keywordflow">break</span>;
<a name="l00292"></a>00292     } <span class="keywordflow">else</span>
<a name="l00293"></a>00293       <span class="keywordflow">break</span>;
<a name="l00294"></a>00294   } <span class="keywordflow">while</span> ( <span class="keyword">true</span> );
<a name="l00295"></a>00295 
<a name="l00296"></a>00296   <span class="comment">// erase the passphrase if we do not want to keep it</span>
<a name="l00297"></a>00297   cleanupPass();
<a name="l00298"></a>00298 
<a name="l00299"></a>00299   <span class="keywordflow">if</span>(retval &amp; ERROR)
<a name="l00300"></a>00300   {
<a name="l00301"></a>00301     errMsg = pgp-&gt;lastErrorMessage();
<a name="l00302"></a>00302     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00303"></a>00303   }
<a name="l00304"></a>00304   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00305"></a>00305 }
<a name="l00306"></a>00306 
<a name="l00307"></a>00307 Kpgp::Result
<a name="l00308"></a>00308 Module::clearsign( Block&amp; block,
<a name="l00309"></a>00309                    <span class="keyword">const</span> KeyID&amp; keyId, <span class="keyword">const</span> QCString&amp; charset )
<a name="l00310"></a>00310 {
<a name="l00311"></a>00311   <span class="keywordflow">return</span> encrypt( block, QStringList(), keyId, <span class="keyword">true</span>, charset );
<a name="l00312"></a>00312 }
<a name="l00313"></a>00313 
<a name="l00314"></a>00314 Kpgp::Result
<a name="l00315"></a>00315 Module::encrypt( Block&amp; block,
<a name="l00316"></a>00316                  <span class="keyword">const</span> QStringList&amp; receivers, <span class="keyword">const</span> KeyID&amp; keyId,
<a name="l00317"></a>00317                  <span class="keywordtype">bool</span> sign, <span class="keyword">const</span> QCString&amp; charset )
<a name="l00318"></a>00318 {
<a name="l00319"></a>00319   KeyIDList encryptionKeyIds; <span class="comment">// list of keys which are used for encryption</span>
<a name="l00320"></a>00320   <span class="keywordtype">int</span> status = 0;
<a name="l00321"></a>00321   errMsg = <span class="stringliteral">""</span>;
<a name="l00322"></a>00322 
<a name="l00323"></a>00323   <span class="keywordflow">if</span>( 0 == pgp ) assignPGPBase();
<a name="l00324"></a>00324 
<a name="l00325"></a>00325   setUser( keyId );
<a name="l00326"></a>00326 
<a name="l00327"></a>00327   <span class="keywordflow">if</span>( !receivers.empty() ) {
<a name="l00328"></a>00328     Kpgp::Result result = getEncryptionKeys( encryptionKeyIds, receivers,
<a name="l00329"></a>00329                                              keyId );
<a name="l00330"></a>00330     <span class="keywordflow">if</span>( Kpgp::Ok != result ) {
<a name="l00331"></a>00331       <span class="keywordflow">return</span> result;
<a name="l00332"></a>00332     }
<a name="l00333"></a>00333   }
<a name="l00334"></a>00334 
<a name="l00335"></a>00335   status = doEncSign( block, encryptionKeyIds, sign );
<a name="l00336"></a>00336 
<a name="l00337"></a>00337   <span class="keywordflow">if</span>( status &amp; CANCEL )
<a name="l00338"></a>00338     <span class="keywordflow">return</span> Kpgp::Canceled;
<a name="l00339"></a>00339 
<a name="l00340"></a>00340   <span class="comment">// check for bad passphrase</span>
<a name="l00341"></a>00341   <span class="keywordflow">while</span>( status &amp; BADPHRASE ) {
<a name="l00342"></a>00342     wipePassPhrase();
<a name="l00343"></a>00343     QString str = i18n(<span class="stringliteral">"You entered an invalid passphrase.\n"</span>
<a name="l00344"></a>00344                        <span class="stringliteral">"Do you want to try again, continue and leave the "</span>
<a name="l00345"></a>00345                        <span class="stringliteral">"message unsigned, or cancel sending the message?"</span>);
<a name="l00346"></a>00346     QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00347"></a>00347     <span class="keywordtype">int</span> ret = KMessageBox::warningYesNoCancel( 0, str,
<a name="l00348"></a>00348                                                i18n(<span class="stringliteral">"PGP Warning"</span>),
<a name="l00349"></a>00349                                                i18n(<span class="stringliteral">"&amp;Retry"</span>),
<a name="l00350"></a>00350                                                i18n(<span class="stringliteral">"Send &amp;Unsigned"</span>) );
<a name="l00351"></a>00351     QApplication::restoreOverrideCursor();
<a name="l00352"></a>00352     <span class="keywordflow">if</span>( ret == KMessageBox::Cancel ) {
<a name="l00353"></a>00353       <span class="keywordflow">return</span> Kpgp::Canceled;
<a name="l00354"></a>00354     }
<a name="l00355"></a>00355     <span class="keywordflow">if</span>( ret == KMessageBox::No ) {
<a name="l00356"></a>00356       <span class="comment">// the user selected "Send unsigned"</span>
<a name="l00357"></a>00357       <span class="keywordflow">if</span>( encryptionKeyIds.isEmpty() ) {
<a name="l00358"></a>00358         block.reset();
<a name="l00359"></a>00359         <span class="keywordflow">return</span> Kpgp::Ok;
<a name="l00360"></a>00360       }
<a name="l00361"></a>00361       <span class="keywordflow">else</span> {
<a name="l00362"></a>00362         sign = <span class="keyword">false</span>;
<a name="l00363"></a>00363       }
<a name="l00364"></a>00364     }
<a name="l00365"></a>00365     <span class="comment">// ok let's try once again...</span>
<a name="l00366"></a>00366     status = doEncSign( block, encryptionKeyIds, sign );
<a name="l00367"></a>00367   }
<a name="l00368"></a>00368 
<a name="l00369"></a>00369   <span class="comment">// did signing fail?</span>
<a name="l00370"></a>00370   <span class="keywordflow">if</span>( status &amp; ERR_SIGNING ) {
<a name="l00371"></a>00371     QString str = i18n(<span class="stringliteral">"%1 = 'signing failed' error message"</span>,
<a name="l00372"></a>00372                        <span class="stringliteral">"%1\nDo you want to send the message unsigned, "</span>
<a name="l00373"></a>00373                        <span class="stringliteral">"or cancel sending the message?"</span>)
<a name="l00374"></a>00374                   .arg( pgp-&gt;lastErrorMessage() );
<a name="l00375"></a>00375     QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00376"></a>00376     <span class="keywordtype">int</span> ret = KMessageBox::warningContinueCancel( 0, str,
<a name="l00377"></a>00377                                                   i18n(<span class="stringliteral">"PGP Warning"</span>),
<a name="l00378"></a>00378                                                   i18n(<span class="stringliteral">"Send &amp;Unsigned"</span>) );
<a name="l00379"></a>00379     QApplication::restoreOverrideCursor();
<a name="l00380"></a>00380     <span class="keywordflow">if</span>( ret == KMessageBox::Cancel ) {
<a name="l00381"></a>00381       <span class="keywordflow">return</span> Kpgp::Canceled;
<a name="l00382"></a>00382     }
<a name="l00383"></a>00383     sign = <span class="keyword">false</span>;
<a name="l00384"></a>00384     status = doEncSign( block, encryptionKeyIds, sign );
<a name="l00385"></a>00385   }
<a name="l00386"></a>00386 
<a name="l00387"></a>00387   <span class="comment">// check for bad keys</span>
<a name="l00388"></a>00388   <span class="keywordflow">if</span>( status &amp; BADKEYS ) {
<a name="l00389"></a>00389     QString str = i18n(<span class="stringliteral">"%1 = 'bad keys' error message"</span>,
<a name="l00390"></a>00390                        <span class="stringliteral">"%1\nDo you want to encrypt anyway, leave the "</span>
<a name="l00391"></a>00391                        <span class="stringliteral">"message as-is, or cancel sending the message?"</span>)
<a name="l00392"></a>00392                   .arg( pgp-&gt;lastErrorMessage() );
<a name="l00393"></a>00393 
<a name="l00394"></a>00394     QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00395"></a>00395     <span class="keywordtype">int</span> ret = KMessageBox::warningYesNoCancel( 0, str,
<a name="l00396"></a>00396                                                i18n(<span class="stringliteral">"PGP Warning"</span>),
<a name="l00397"></a>00397                                                i18n(<span class="stringliteral">"Send &amp;Encrypted"</span>),
<a name="l00398"></a>00398                                                i18n(<span class="stringliteral">"Send &amp;Unencrypted"</span>) );
<a name="l00399"></a>00399     QApplication::restoreOverrideCursor();
<a name="l00400"></a>00400     <span class="keywordflow">if</span>( ret == KMessageBox::Cancel ) {
<a name="l00401"></a>00401       <span class="keywordflow">return</span> Kpgp::Canceled;
<a name="l00402"></a>00402     }
<a name="l00403"></a>00403     <span class="keywordflow">if</span>( ret == KMessageBox::No ) {
<a name="l00404"></a>00404       <span class="comment">// the user selected "Send unencrypted"</span>
<a name="l00405"></a>00405       <span class="keywordflow">if</span>( sign ) {
<a name="l00406"></a>00406         doEncSign( block, KeyIDList(), sign );
<a name="l00407"></a>00407       }
<a name="l00408"></a>00408       <span class="keywordflow">else</span> {
<a name="l00409"></a>00409         block.reset();
<a name="l00410"></a>00410       }
<a name="l00411"></a>00411       <span class="keywordflow">return</span> Kpgp::Ok;
<a name="l00412"></a>00412     }
<a name="l00413"></a>00413   }
<a name="l00414"></a>00414 
<a name="l00415"></a>00415   <span class="keywordflow">if</span>( status &amp; MISSINGKEY ) {
<a name="l00416"></a>00416     QString str = i18n(<span class="stringliteral">"%1 = 'missing keys' error message"</span>,
<a name="l00417"></a>00417                        <span class="stringliteral">"%1\nDo you want to leave the message as-is, "</span>
<a name="l00418"></a>00418                        <span class="stringliteral">"or cancel sending the message?"</span>)
<a name="l00419"></a>00419                   .arg( pgp-&gt;lastErrorMessage() );
<a name="l00420"></a>00420     QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00421"></a>00421     <span class="keywordtype">int</span> ret = KMessageBox::warningContinueCancel( 0, str,
<a name="l00422"></a>00422                                                   i18n(<span class="stringliteral">"PGP Warning"</span>),
<a name="l00423"></a>00423                                                   i18n(<span class="stringliteral">"&amp;Send As-Is"</span>) );
<a name="l00424"></a>00424     QApplication::restoreOverrideCursor();
<a name="l00425"></a>00425     <span class="keywordflow">if</span>( ret == KMessageBox::Cancel ) {
<a name="l00426"></a>00426       <span class="keywordflow">return</span> Kpgp::Canceled;
<a name="l00427"></a>00427     }
<a name="l00428"></a>00428     block.reset();
<a name="l00429"></a>00429     <span class="keywordflow">return</span> Kpgp::Ok;
<a name="l00430"></a>00430   }
<a name="l00431"></a>00431 
<a name="l00432"></a>00432   <span class="keywordflow">if</span>( status &amp; ERROR ) {
<a name="l00433"></a>00433     <span class="comment">// show error dialog</span>
<a name="l00434"></a>00434     errMsg = i18n( <span class="stringliteral">"The following error occurred:\n%1"</span> )
<a name="l00435"></a>00435              .arg( pgp-&gt;lastErrorMessage() );
<a name="l00436"></a>00436     QString details = i18n( <span class="stringliteral">"This is the error message of %1:\n%2"</span> )
<a name="l00437"></a>00437                       .arg( ( pgpType == tGPG ) ? <span class="stringliteral">"GnuPG"</span> : <span class="stringliteral">"PGP"</span> )
<a name="l00438"></a>00438                       .arg( block.error().data() );
<a name="l00439"></a>00439     QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00440"></a>00440     KMessageBox::detailedSorry( 0, errMsg, details );
<a name="l00441"></a>00441     QApplication::restoreOverrideCursor();
<a name="l00442"></a>00442     <span class="keywordflow">return</span> Kpgp::Failure;
<a name="l00443"></a>00443   }
<a name="l00444"></a>00444 
<a name="l00445"></a>00445   <span class="keywordflow">if</span>( showCipherText() ) {
<a name="l00446"></a>00446     <span class="comment">// show cipher text dialog</span>
<a name="l00447"></a>00447     CipherTextDialog *cipherTextDlg = <span class="keyword">new</span> CipherTextDialog( block.text(), charset );
<a name="l00448"></a>00448     QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00449"></a>00449     <span class="keywordtype">bool</span> result = ( cipherTextDlg-&gt;exec() == QDialog::Accepted );
<a name="l00450"></a>00450     QApplication::restoreOverrideCursor();
<a name="l00451"></a>00451     <span class="keyword">delete</span> cipherTextDlg;
<a name="l00452"></a>00452     <span class="keywordflow">return</span> result == QDialog::Accepted ? Kpgp::Ok : Kpgp::Canceled;
<a name="l00453"></a>00453   }
<a name="l00454"></a>00454   <span class="keywordflow">return</span> Kpgp::Ok;
<a name="l00455"></a>00455 }
<a name="l00456"></a>00456 
<a name="l00457"></a>00457 <span class="keywordtype">int</span>
<a name="l00458"></a>00458 Module::doEncSign( Block&amp; block,
<a name="l00459"></a>00459                    <span class="keyword">const</span> KeyIDList&amp; recipientKeyIds, <span class="keywordtype">bool</span> sign )
<a name="l00460"></a>00460 {
<a name="l00461"></a>00461   <span class="keywordtype">int</span> retval = 0;
<a name="l00462"></a>00462 
<a name="l00463"></a>00463   <span class="keywordflow">if</span>( 0 == pgp ) assignPGPBase();
<a name="l00464"></a>00464 
<a name="l00465"></a>00465   <span class="comment">// to avoid error messages in case pgp is not installed</span>
<a name="l00466"></a>00466   <span class="keywordflow">if</span>( !havePgp ) <span class="keywordflow">return</span> OK;
<a name="l00467"></a>00467 
<a name="l00468"></a>00468   <span class="keywordflow">if</span>( sign ) {
<a name="l00469"></a>00469     <span class="keywordtype">int</span> result = prepare( <span class="keyword">true</span>, &amp;block );
<a name="l00470"></a>00470     <span class="keywordflow">switch</span>( result ) {
<a name="l00471"></a>00471       <span class="keywordflow">case</span> -1:
<a name="l00472"></a>00472         <span class="keywordflow">return</span> CANCEL;
<a name="l00473"></a>00473       <span class="keywordflow">case</span> 0:
<a name="l00474"></a>00474         <span class="keywordflow">return</span> ERROR;
<a name="l00475"></a>00475     }
<a name="l00476"></a>00476     retval = pgp-&gt;encsign( block, recipientKeyIds, passphrase );
<a name="l00477"></a>00477   }
<a name="l00478"></a>00478   <span class="keywordflow">else</span> {
<a name="l00479"></a>00479     <span class="keywordflow">if</span>( !prepare( <span class="keyword">false</span>, &amp;block ) ) <span class="keywordflow">return</span> ERROR;
<a name="l00480"></a>00480     retval = pgp-&gt;encrypt( block, recipientKeyIds );
<a name="l00481"></a>00481   }
<a name="l00482"></a>00482   <span class="comment">// erase the passphrase if we do not want to keep it</span>
<a name="l00483"></a>00483   cleanupPass();
<a name="l00484"></a>00484 
<a name="l00485"></a>00485   <span class="keywordflow">return</span> retval;
<a name="l00486"></a>00486 }
<a name="l00487"></a>00487 
<a name="l00488"></a>00488 Kpgp::Result
<a name="l00489"></a>00489 Module::getEncryptionKeys( KeyIDList&amp; encryptionKeyIds,
<a name="l00490"></a>00490                            <span class="keyword">const</span> QStringList&amp; recipients,
<a name="l00491"></a>00491                            <span class="keyword">const</span> KeyID&amp; keyId )
<a name="l00492"></a>00492 {
<a name="l00493"></a>00493   <span class="keywordflow">if</span>( recipients.empty() ) {
<a name="l00494"></a>00494     encryptionKeyIds.clear();
<a name="l00495"></a>00495     <span class="keywordflow">return</span> Kpgp::Ok;
<a name="l00496"></a>00496   }
<a name="l00497"></a>00497 
<a name="l00498"></a>00498   <span class="comment">// list of lists of encryption keys (one list per recipient + one list</span>
<a name="l00499"></a>00499   <span class="comment">// for the sender)</span>
<a name="l00500"></a>00500   QValueVector&lt;KeyIDList&gt; recipientKeyIds( recipients.count() + 1 );
<a name="l00501"></a>00501   <span class="comment">// add the sender's encryption key(s) to the list of recipient key IDs</span>
<a name="l00502"></a>00502   <span class="keywordflow">if</span>( encryptToSelf() ) {
<a name="l00503"></a>00503     recipientKeyIds[0] = KeyIDList( keyId );
<a name="l00504"></a>00504   }
<a name="l00505"></a>00505   <span class="keywordflow">else</span> {
<a name="l00506"></a>00506     recipientKeyIds[0] = KeyIDList();
<a name="l00507"></a>00507   }
<a name="l00508"></a>00508   <span class="keywordtype">bool</span> showKeysForApproval = <span class="keyword">false</span>;
<a name="l00509"></a>00509   <span class="keywordtype">int</span> i = 1;
<a name="l00510"></a>00510   <span class="keywordflow">for</span>( QStringList::ConstIterator it = recipients.begin();
<a name="l00511"></a>00511        it != recipients.end(); ++it, ++i ) {
<a name="l00512"></a>00512     EncryptPref encrPref = encryptionPreference( *it );
<a name="l00513"></a>00513     <span class="keywordflow">if</span>( ( encrPref == UnknownEncryptPref ) || ( encrPref == NeverEncrypt ) )
<a name="l00514"></a>00514       showKeysForApproval = <span class="keyword">true</span>;
<a name="l00515"></a>00515 
<a name="l00516"></a>00516     KeyIDList keyIds = getEncryptionKeys( *it );
<a name="l00517"></a>00517     <span class="keywordflow">if</span>( keyIds.isEmpty() ) {
<a name="l00518"></a>00518       showKeysForApproval = <span class="keyword">true</span>;
<a name="l00519"></a>00519     }
<a name="l00520"></a>00520     recipientKeyIds[i] = keyIds;
<a name="l00521"></a>00521   }
<a name="l00522"></a>00522 
<a name="l00523"></a>00523   kdDebug(5100) &lt;&lt; <span class="stringliteral">"recipientKeyIds = (\n"</span>;
<a name="l00524"></a>00524   QValueVector&lt;KeyIDList&gt;::const_iterator kit;
<a name="l00525"></a>00525   <span class="keywordflow">for</span>( kit = recipientKeyIds.begin(); kit != recipientKeyIds.end(); ++kit ) {
<a name="l00526"></a>00526     kdDebug(5100) &lt;&lt; <span class="stringliteral">"( 0x"</span> &lt;&lt; (*kit).toStringList().join( <span class="stringliteral">", 0x"</span> )
<a name="l00527"></a>00527                   &lt;&lt; <span class="stringliteral">" ),\n"</span>;
<a name="l00528"></a>00528   }
<a name="l00529"></a>00529   kdDebug(5100) &lt;&lt; <span class="stringliteral">")\n"</span>;
<a name="l00530"></a>00530 
<a name="l00531"></a>00531   <span class="keywordflow">if</span>( showKeysForApproval || mShowKeyApprovalDlg ) {
<a name="l00532"></a>00532     <span class="comment">// #### FIXME: Until we support encryption with untrusted keys only</span>
<a name="l00533"></a>00533     <span class="comment">// ####        trusted keys are allowed</span>
<a name="l00534"></a>00534     <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> allowedKeys = PublicKeys | EncryptionKeys | ValidKeys | TrustedKeys;
<a name="l00535"></a>00535 <span class="preprocessor">#if 0</span>
<a name="l00536"></a>00536 <span class="preprocessor"></span>    <span class="comment">// ### reenable this code when we support encryption with untrusted keys</span>
<a name="l00537"></a>00537     <span class="keywordflow">if</span>( pgpType != tGPG ) {
<a name="l00538"></a>00538       <span class="comment">// usage of untrusted keys is only possible with GnuPG</span>
<a name="l00539"></a>00539       allowedKeys |= TrustedKeys;
<a name="l00540"></a>00540     }
<a name="l00541"></a>00541 <span class="preprocessor">#endif</span>
<a name="l00542"></a>00542 <span class="preprocessor"></span>    <span class="comment">// show the recipients &lt;-&gt; key relation</span>
<a name="l00543"></a>00543     KeyApprovalDialog dlg( recipients, recipientKeyIds, allowedKeys );
<a name="l00544"></a>00544 
<a name="l00545"></a>00545     QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00546"></a>00546     <span class="keywordtype">int</span> ret = dlg.exec();
<a name="l00547"></a>00547 
<a name="l00548"></a>00548     <span class="keywordflow">if</span>( ret == QDialog::Rejected ) {
<a name="l00549"></a>00549         QApplication::restoreOverrideCursor();
<a name="l00550"></a>00550         <span class="keywordflow">return</span> Kpgp::Canceled;
<a name="l00551"></a>00551     }
<a name="l00552"></a>00552 
<a name="l00553"></a>00553     recipientKeyIds = dlg.keys();
<a name="l00554"></a>00554     QApplication::restoreOverrideCursor();
<a name="l00555"></a>00555   }
<a name="l00556"></a>00556 
<a name="l00557"></a>00557   <span class="comment">// flatten the list of lists of key IDs and count empty key ID lists</span>
<a name="l00558"></a>00558   <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> emptyListCount = 0;
<a name="l00559"></a>00559   <span class="keywordflow">for</span>( QValueVector&lt;KeyIDList&gt;::const_iterator it = recipientKeyIds.begin();
<a name="l00560"></a>00560        it != recipientKeyIds.end(); ++it ) {
<a name="l00561"></a>00561     <span class="keywordflow">if</span>( (*it).isEmpty() ) {
<a name="l00562"></a>00562       <span class="comment">// only count empty key ID lists for the recipients</span>
<a name="l00563"></a>00563       <span class="keywordflow">if</span>( it != recipientKeyIds.begin() ) {
<a name="l00564"></a>00564         emptyListCount++;
<a name="l00565"></a>00565       }
<a name="l00566"></a>00566     }
<a name="l00567"></a>00567     <span class="keywordflow">else</span> {
<a name="l00568"></a>00568       <span class="keywordflow">for</span>( KeyIDList::ConstIterator kit = (*it).begin();
<a name="l00569"></a>00569            kit != (*it).end(); kit++ ) {
<a name="l00570"></a>00570         encryptionKeyIds.append( *kit );
<a name="l00571"></a>00571       }
<a name="l00572"></a>00572     }
<a name="l00573"></a>00573   }
<a name="l00574"></a>00574 
<a name="l00575"></a>00575   <span class="comment">// FIXME-AFTER-KDE-3.1: Show warning if message won't be encrypted to self</span>
<a name="l00576"></a>00576 
<a name="l00577"></a>00577   <span class="comment">// show a warning if the user didn't select an encryption key for</span>
<a name="l00578"></a>00578   <span class="comment">// some of the recipients</span>
<a name="l00579"></a>00579   <span class="keywordflow">if</span>( recipientKeyIds.size() == emptyListCount + 1 ) { <span class="comment">// (+1 because of the sender's key)</span>
<a name="l00580"></a>00580     QString str = ( recipients.count() == 1 )
<a name="l00581"></a>00581                   ? i18n(<span class="stringliteral">"You did not select an encryption key for the "</span>
<a name="l00582"></a>00582                          <span class="stringliteral">"recipient of this message; therefore, the message "</span>
<a name="l00583"></a>00583                          <span class="stringliteral">"will not be encrypted."</span>)
<a name="l00584"></a>00584                   : i18n(<span class="stringliteral">"You did not select an encryption key for any of the "</span>
<a name="l00585"></a>00585                          <span class="stringliteral">"recipients of this message; therefore, the message "</span>
<a name="l00586"></a>00586                          <span class="stringliteral">"will not be encrypted."</span>);
<a name="l00587"></a>00587     QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00588"></a>00588     <span class="keywordtype">int</span> ret = KMessageBox::warningContinueCancel( 0, str,
<a name="l00589"></a>00589                                                   i18n(<span class="stringliteral">"PGP Warning"</span>),
<a name="l00590"></a>00590                                                   i18n(<span class="stringliteral">"Send &amp;Unencrypted"</span>) );
<a name="l00591"></a>00591     QApplication::restoreOverrideCursor();
<a name="l00592"></a>00592     <span class="keywordflow">if</span>( ret == KMessageBox::Cancel ) {
<a name="l00593"></a>00593       <span class="keywordflow">return</span> Kpgp::Canceled;
<a name="l00594"></a>00594     }
<a name="l00595"></a>00595     <span class="keywordflow">else</span>
<a name="l00596"></a>00596       encryptionKeyIds.clear();
<a name="l00597"></a>00597   }
<a name="l00598"></a>00598   <span class="keywordflow">else</span> <span class="keywordflow">if</span>( emptyListCount &gt; 0 ) {
<a name="l00599"></a>00599     QString str = ( emptyListCount == 1 )
<a name="l00600"></a>00600                   ? i18n(<span class="stringliteral">"You did not select an encryption key for one of "</span>
<a name="l00601"></a>00601                          <span class="stringliteral">"the recipients; this person will not be able to "</span>
<a name="l00602"></a>00602                          <span class="stringliteral">"decrypt the message if you encrypt it."</span>)
<a name="l00603"></a>00603                   : i18n(<span class="stringliteral">"You did not select encryption keys for some of "</span>
<a name="l00604"></a>00604                          <span class="stringliteral">"the recipients; these persons will not be able to "</span>
<a name="l00605"></a>00605                          <span class="stringliteral">"decrypt the message if you encrypt it."</span> );
<a name="l00606"></a>00606     QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l00607"></a>00607     <span class="keywordtype">int</span> ret = KMessageBox::warningYesNoCancel( 0, str,
<a name="l00608"></a>00608                                                i18n(<span class="stringliteral">"PGP Warning"</span>),
<a name="l00609"></a>00609                                                i18n(<span class="stringliteral">"Send &amp;Encrypted"</span>),
<a name="l00610"></a>00610                                                i18n(<span class="stringliteral">"Send &amp;Unencrypted"</span>) );
<a name="l00611"></a>00611     QApplication::restoreOverrideCursor();
<a name="l00612"></a>00612     <span class="keywordflow">if</span>( ret == KMessageBox::Cancel ) {
<a name="l00613"></a>00613       <span class="keywordflow">return</span> Kpgp::Canceled;
<a name="l00614"></a>00614     }
<a name="l00615"></a>00615     <span class="keywordflow">else</span> <span class="keywordflow">if</span>( ret == KMessageBox::No ) {
<a name="l00616"></a>00616       <span class="comment">// the user selected "Send unencrypted"</span>
<a name="l00617"></a>00617       encryptionKeyIds.clear();
<a name="l00618"></a>00618     }
<a name="l00619"></a>00619   }
<a name="l00620"></a>00620 
<a name="l00621"></a>00621   <span class="keywordflow">return</span> Kpgp::Ok;
<a name="l00622"></a>00622 }
<a name="l00623"></a>00623 
<a name="l00624"></a>00624 <span class="keywordtype">int</span>
<a name="l00625"></a>00625 Module::encryptionPossible( <span class="keyword">const</span> QStringList&amp; recipients )
<a name="l00626"></a>00626 {
<a name="l00627"></a>00627   <span class="keywordflow">if</span>( 0 == pgp ) assignPGPBase();
<a name="l00628"></a>00628 
<a name="l00629"></a>00629   <span class="keywordflow">if</span>( !usePGP() )
<a name="l00630"></a>00630     <span class="keywordflow">return</span> 0;
<a name="l00631"></a>00631 
<a name="l00632"></a>00632   <span class="keywordflow">if</span>( recipients.empty() )
<a name="l00633"></a>00633     <span class="keywordflow">return</span> 0;
<a name="l00634"></a>00634 
<a name="l00635"></a>00635   <span class="keywordtype">int</span> noKey = 0, never = 0, unknown = 0, always = 0, aip = 0, ask = 0,
<a name="l00636"></a>00636       askwp = 0;
<a name="l00637"></a>00637   <span class="keywordflow">for</span>( QStringList::ConstIterator it = recipients.begin();
<a name="l00638"></a>00638        it != recipients.end(); ++it) {
<a name="l00639"></a>00639     <span class="keywordflow">if</span>( haveTrustedEncryptionKey( *it ) ) {
<a name="l00640"></a>00640       EncryptPref encrPref = encryptionPreference( *it );
<a name="l00641"></a>00641       <span class="keywordflow">switch</span>( encrPref ) {
<a name="l00642"></a>00642         <span class="keywordflow">case</span> NeverEncrypt:
<a name="l00643"></a>00643           never++;
<a name="l00644"></a>00644           <span class="keywordflow">break</span>;
<a name="l00645"></a>00645         <span class="keywordflow">case</span> UnknownEncryptPref:
<a name="l00646"></a>00646           unknown++;
<a name="l00647"></a>00647           <span class="keywordflow">break</span>;
<a name="l00648"></a>00648         <span class="keywordflow">case</span> AlwaysEncrypt:
<a name="l00649"></a>00649           always++;
<a name="l00650"></a>00650           <span class="keywordflow">break</span>;
<a name="l00651"></a>00651         <span class="keywordflow">case</span> AlwaysEncryptIfPossible:
<a name="l00652"></a>00652           aip++;
<a name="l00653"></a>00653           <span class="keywordflow">break</span>;
<a name="l00654"></a>00654         <span class="keywordflow">case</span> AlwaysAskForEncryption:
<a name="l00655"></a>00655           ask++;
<a name="l00656"></a>00656           <span class="keywordflow">break</span>;
<a name="l00657"></a>00657         <span class="keywordflow">case</span> AskWheneverPossible:
<a name="l00658"></a>00658           askwp++;
<a name="l00659"></a>00659           <span class="keywordflow">break</span>;
<a name="l00660"></a>00660       }
<a name="l00661"></a>00661     }
<a name="l00662"></a>00662     <span class="keywordflow">else</span> {
<a name="l00663"></a>00663       noKey++;
<a name="l00664"></a>00664     }
<a name="l00665"></a>00665   }
<a name="l00666"></a>00666 
<a name="l00667"></a>00667   <span class="keywordflow">if</span>( ( always+aip &gt; 0 ) &amp;&amp; ( never+unknown+ask+askwp+noKey == 0 ) ) {
<a name="l00668"></a>00668     <span class="keywordflow">return</span> 1; <span class="comment">// encryption possible and desired</span>
<a name="l00669"></a>00669   }
<a name="l00670"></a>00670 
<a name="l00671"></a>00671   <span class="keywordflow">if</span>( ( unknown+ask+askwp &gt; 0 ) &amp;&amp; ( never+noKey == 0 ) ) {
<a name="l00672"></a>00672     <span class="keywordflow">return</span> 2; <span class="comment">// encryption possible, but user has to be asked</span>
<a name="l00673"></a>00673   }
<a name="l00674"></a>00674 
<a name="l00675"></a>00675   <span class="keywordflow">if</span>( ( never+noKey &gt; 0 ) &amp;&amp; ( always+ask == 0 ) ) {
<a name="l00676"></a>00676     <span class="keywordflow">return</span> 0; <span class="comment">// encryption isn't possible or desired</span>
<a name="l00677"></a>00677   }
<a name="l00678"></a>00678 
<a name="l00679"></a>00679   <span class="keywordflow">return</span> -1; <span class="comment">// we can't decide it automatically</span>
<a name="l00680"></a>00680 }
<a name="l00681"></a>00681 
<a name="l00682"></a>00682 <span class="keywordtype">bool</span>
<a name="l00683"></a>00683 Module::signKey(<span class="keyword">const</span> KeyID&amp; keyId)
<a name="l00684"></a>00684 {
<a name="l00685"></a>00685   <span class="keywordflow">if</span> (0 == pgp) assignPGPBase();
<a name="l00686"></a>00686 
<a name="l00687"></a>00687   <span class="keywordflow">if</span>( prepare( <span class="keyword">true</span> ) != 1 )
<a name="l00688"></a>00688     <span class="keywordflow">return</span> FALSE;
<a name="l00689"></a>00689   <span class="keywordflow">if</span>(pgp-&gt;signKey(keyId, passphrase) &amp; ERROR)
<a name="l00690"></a>00690   {
<a name="l00691"></a>00691     errMsg = pgp-&gt;lastErrorMessage();
<a name="l00692"></a>00692     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00693"></a>00693   }
<a name="l00694"></a>00694   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00695"></a>00695 }
<a name="l00696"></a>00696 
<a name="l00697"></a>00697 
<a name="l00698"></a>00698 <span class="keyword">const</span> KeyList
<a name="l00699"></a>00699 Module::publicKeys()
<a name="l00700"></a>00700 {
<a name="l00701"></a>00701   <span class="keywordflow">if</span> (0 == pgp) assignPGPBase();
<a name="l00702"></a>00702 
<a name="l00703"></a>00703   <span class="keywordflow">if</span> (!prepare()) <span class="keywordflow">return</span> KeyList();
<a name="l00704"></a>00704 
<a name="l00705"></a>00705   <span class="keywordflow">if</span>( !mPublicKeysCached ) {
<a name="l00706"></a>00706     readPublicKeys();
<a name="l00707"></a>00707   }
<a name="l00708"></a>00708 
<a name="l00709"></a>00709   <span class="keywordflow">return</span> mPublicKeys;
<a name="l00710"></a>00710 }
<a name="l00711"></a>00711 
<a name="l00712"></a>00712 
<a name="l00713"></a>00713 <span class="keyword">const</span> KeyList
<a name="l00714"></a>00714 Module::secretKeys()
<a name="l00715"></a>00715 {
<a name="l00716"></a>00716   <span class="keywordflow">if</span> (0 == pgp) assignPGPBase();
<a name="l00717"></a>00717 
<a name="l00718"></a>00718   <span class="keywordflow">if</span> (!prepare()) <span class="keywordflow">return</span> KeyList();
<a name="l00719"></a>00719 
<a name="l00720"></a>00720   <span class="keywordflow">if</span>( !mSecretKeysCached ) {
<a name="l00721"></a>00721     readSecretKeys();
<a name="l00722"></a>00722   }
<a name="l00723"></a>00723 
<a name="l00724"></a>00724   <span class="keywordflow">return</span> mSecretKeys;
<a name="l00725"></a>00725 }
<a name="l00726"></a>00726 
<a name="l00727"></a>00727 
<a name="l00728"></a>00728 Key*
<a name="l00729"></a>00729 Module::publicKey(<span class="keyword">const</span> KeyID&amp; keyID)
<a name="l00730"></a>00730 {
<a name="l00731"></a>00731   readPublicKeys();
<a name="l00732"></a>00732 
<a name="l00733"></a>00733   <span class="keywordflow">for</span>( KeyListIterator it( mPublicKeys ); (*it); ++it )
<a name="l00734"></a>00734     <span class="keywordflow">if</span>( keyID == (*it)-&gt;primaryKeyID() ||
<a name="l00735"></a>00735     keyID == (*it)-&gt;primaryFingerprint() )
<a name="l00736"></a>00736       <span class="keywordflow">return</span> (*it);
<a name="l00737"></a>00737 
<a name="l00738"></a>00738   <span class="keywordflow">return</span> 0;
<a name="l00739"></a>00739 }
<a name="l00740"></a>00740 
<a name="l00741"></a>00741 Key*
<a name="l00742"></a>00742 Module::publicKey( <span class="keyword">const</span> QString&amp; userID )
<a name="l00743"></a>00743 {
<a name="l00744"></a>00744   readPublicKeys();
<a name="l00745"></a>00745 
<a name="l00746"></a>00746   <span class="keywordflow">for</span>( KeyListIterator it( mPublicKeys ); (*it); ++it )
<a name="l00747"></a>00747     <span class="keywordflow">if</span>( (*it)-&gt;matchesUserID( userID ) )
<a name="l00748"></a>00748       <span class="keywordflow">return</span> (*it);
<a name="l00749"></a>00749 
<a name="l00750"></a>00750   <span class="keywordflow">return</span> 0;
<a name="l00751"></a>00751 }
<a name="l00752"></a>00752 
<a name="l00753"></a>00753 Key*
<a name="l00754"></a>00754 Module::secretKey(<span class="keyword">const</span> KeyID&amp; keyID)
<a name="l00755"></a>00755 {
<a name="l00756"></a>00756   readSecretKeys();
<a name="l00757"></a>00757 
<a name="l00758"></a>00758   <span class="keywordflow">for</span>( KeyListIterator it( mSecretKeys ); (*it); ++it )
<a name="l00759"></a>00759     <span class="keywordflow">if</span>( keyID == (*it)-&gt;primaryKeyID() ||
<a name="l00760"></a>00760     keyID == (*it)-&gt;primaryFingerprint() )
<a name="l00761"></a>00761       <span class="keywordflow">return</span> (*it);
<a name="l00762"></a>00762 
<a name="l00763"></a>00763   <span class="keywordflow">return</span> 0;
<a name="l00764"></a>00764 }
<a name="l00765"></a>00765 
<a name="l00766"></a>00766 Validity
<a name="l00767"></a>00767 Module::keyTrust( <span class="keyword">const</span> KeyID&amp; keyID )
<a name="l00768"></a>00768 {
<a name="l00769"></a>00769   Key *key = publicKey( keyID );
<a name="l00770"></a>00770 
<a name="l00771"></a>00771   <span class="keywordflow">if</span>( ( 0 == key ) || ( key-&gt;keyTrust() == KPGP_VALIDITY_UNKNOWN ) )
<a name="l00772"></a>00772   { <span class="comment">// (re)check the key if it's unknown or if its trust is unknown</span>
<a name="l00773"></a>00773     key = rereadKey( keyID, <span class="keyword">true</span> );
<a name="l00774"></a>00774     <span class="keywordflow">if</span>( key == 0 )
<a name="l00775"></a>00775       <span class="keywordflow">return</span> KPGP_VALIDITY_UNKNOWN;
<a name="l00776"></a>00776   }
<a name="l00777"></a>00777 
<a name="l00778"></a>00778   <span class="keywordflow">return</span> key-&gt;keyTrust();
<a name="l00779"></a>00779 }
<a name="l00780"></a>00780 
<a name="l00781"></a>00781 Validity
<a name="l00782"></a>00782 Module::keyTrust( <span class="keyword">const</span> QString&amp; userID )
<a name="l00783"></a>00783 {
<a name="l00784"></a>00784   Key *key = publicKey( userID );
<a name="l00785"></a>00785 
<a name="l00786"></a>00786   <span class="keywordflow">if</span>( key == 0 )
<a name="l00787"></a>00787     <span class="keywordflow">return</span> KPGP_VALIDITY_UNKNOWN;
<a name="l00788"></a>00788 
<a name="l00789"></a>00789   <span class="keywordflow">if</span>( key-&gt;keyTrust() == KPGP_VALIDITY_UNKNOWN )
<a name="l00790"></a>00790   {
<a name="l00791"></a>00791     key = rereadKey( key-&gt;primaryKeyID(), true );
<a name="l00792"></a>00792     <span class="keywordflow">if</span>( key == 0 )
<a name="l00793"></a>00793       <span class="keywordflow">return</span> KPGP_VALIDITY_UNKNOWN;
<a name="l00794"></a>00794   }
<a name="l00795"></a>00795 
<a name="l00796"></a>00796   <span class="keywordflow">return</span> key-&gt;keyTrust();
<a name="l00797"></a>00797 }
<a name="l00798"></a>00798 
<a name="l00799"></a>00799 <span class="keywordtype">bool</span>
<a name="l00800"></a>00800 Module::isTrusted( <span class="keyword">const</span> KeyID&amp; keyID )
<a name="l00801"></a>00801 {
<a name="l00802"></a>00802   <span class="keywordflow">return</span> ( keyTrust( keyID ) &gt;= KPGP_VALIDITY_MARGINAL );
<a name="l00803"></a>00803 }
<a name="l00804"></a>00804 
<a name="l00805"></a>00805 Key*
<a name="l00806"></a>00806 Module::rereadKey( <span class="keyword">const</span> KeyID&amp; keyID, <span class="keyword">const</span> <span class="keywordtype">bool</span> readTrust <span class="comment">/* = true */</span> )
<a name="l00807"></a>00807 {
<a name="l00808"></a>00808   <span class="keywordflow">if</span>( 0 == pgp ) assignPGPBase();
<a name="l00809"></a>00809 
<a name="l00810"></a>00810   <span class="comment">// search the old key data in the key list</span>
<a name="l00811"></a>00811   Key* oldKey = publicKey( keyID );
<a name="l00812"></a>00812 
<a name="l00813"></a>00813   Key* newKey = pgp-&gt;readPublicKey( keyID, readTrust, oldKey );
<a name="l00814"></a>00814 
<a name="l00815"></a>00815   <span class="keywordflow">if</span>( ( 0 == oldKey ) &amp;&amp; ( 0 != newKey ) )
<a name="l00816"></a>00816   {
<a name="l00817"></a>00817     mPublicKeys.inSort( newKey );
<a name="l00818"></a>00818     kdDebug(5100) &lt;&lt; <span class="stringliteral">"New public key 0x"</span> &lt;&lt; newKey-&gt;primaryKeyID() &lt;&lt; <span class="stringliteral">" ("</span>
<a name="l00819"></a>00819                   &lt;&lt; newKey-&gt;primaryUserID() &lt;&lt; <span class="stringliteral">").\n"</span>;
<a name="l00820"></a>00820   }
<a name="l00821"></a>00821   <span class="keywordflow">else</span> <span class="keywordflow">if</span>( ( 0 != oldKey ) &amp;&amp; ( 0 == newKey ) )
<a name="l00822"></a>00822   { <span class="comment">// the key has been deleted in the meantime</span>
<a name="l00823"></a>00823     kdDebug(5100) &lt;&lt; <span class="stringliteral">"Public key 0x"</span> &lt;&lt; oldKey-&gt;primaryKeyID() &lt;&lt; <span class="stringliteral">" ("</span>
<a name="l00824"></a>00824                   &lt;&lt; oldKey-&gt;primaryUserID() &lt;&lt; <span class="stringliteral">") will be removed.\n"</span>;
<a name="l00825"></a>00825     mPublicKeys.removeRef( oldKey );
<a name="l00826"></a>00826   }
<a name="l00827"></a>00827 
<a name="l00828"></a>00828   <span class="keywordflow">return</span> newKey;
<a name="l00829"></a>00829 }
<a name="l00830"></a>00830 
<a name="l00831"></a>00831 QCString
<a name="l00832"></a>00832 Module::getAsciiPublicKey(<span class="keyword">const</span> KeyID&amp; keyID)
<a name="l00833"></a>00833 {
<a name="l00834"></a>00834   <span class="keywordflow">if</span> (0 == pgp) assignPGPBase();
<a name="l00835"></a>00835 
<a name="l00836"></a>00836   <span class="keywordflow">return</span> pgp-&gt;getAsciiPublicKey(keyID);
<a name="l00837"></a>00837 }
<a name="l00838"></a>00838 
<a name="l00839"></a>00839 
<a name="l00840"></a>00840 <span class="keywordtype">bool</span> Module::setPassPhrase(<span class="keyword">const</span> <span class="keywordtype">char</span> * aPass)
<a name="l00841"></a>00841 {
<a name="l00842"></a>00842   <span class="comment">// null out old buffer before we touch the new string.  So in case</span>
<a name="l00843"></a>00843   <span class="comment">// aPass isn't properly null-terminated, we don't leak secret data.</span>
<a name="l00844"></a>00844   wipePassPhrase();
<a name="l00845"></a>00845 
<a name="l00846"></a>00846   <span class="keywordflow">if</span> (aPass)
<a name="l00847"></a>00847   {
<a name="l00848"></a>00848     <span class="keywordtype">size_t</span> newlen = strlen( aPass );
<a name="l00849"></a>00849     <span class="keywordflow">if</span> ( newlen &gt;= 1024 ) {
<a name="l00850"></a>00850       <span class="comment">// rediculously long passphrase.</span>
<a name="l00851"></a>00851       <span class="comment">// Maybe someone wants to trick us in malloc()'ing</span>
<a name="l00852"></a>00852       <span class="comment">// huge buffers...</span>
<a name="l00853"></a>00853       <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00854"></a>00854     }
<a name="l00855"></a>00855     <span class="keywordflow">if</span> ( passphrase_buffer_len &lt; newlen + 1 ) {
<a name="l00856"></a>00856       <span class="comment">// too little space in current buffer:</span>
<a name="l00857"></a>00857       <span class="comment">// allocate a larger one.</span>
<a name="l00858"></a>00858       <span class="keywordflow">if</span> ( passphrase )
<a name="l00859"></a>00859     free( passphrase );
<a name="l00860"></a>00860       passphrase_buffer_len = (newlen + 1 + 15) &amp; ~0xF; <span class="comment">// make it a multiple of 16.</span>
<a name="l00861"></a>00861       passphrase = (<span class="keywordtype">char</span>*)malloc( passphrase_buffer_len );
<a name="l00862"></a>00862       <span class="keywordflow">if</span> (!passphrase) {
<a name="l00863"></a>00863     passphrase_buffer_len = 0;
<a name="l00864"></a>00864     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00865"></a>00865       }
<a name="l00866"></a>00866     }
<a name="l00867"></a>00867     memcpy( passphrase, aPass, newlen + 1 );
<a name="l00868"></a>00868     havePassPhrase = <span class="keyword">true</span>;
<a name="l00869"></a>00869   }
<a name="l00870"></a>00870   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00871"></a>00871 }
<a name="l00872"></a>00872 
<a name="l00873"></a>00873 <span class="keywordtype">bool</span>
<a name="l00874"></a>00874 Module::changePassPhrase()
<a name="l00875"></a>00875 {
<a name="l00876"></a>00876   <span class="comment">//FIXME...</span>
<a name="l00877"></a>00877   KMessageBox::information(0,i18n(<span class="stringliteral">"This feature is\nstill missing"</span>));
<a name="l00878"></a>00878   <span class="keywordflow">return</span> FALSE;
<a name="l00879"></a>00879 }
<a name="l00880"></a>00880 
<a name="l00881"></a>00881 <span class="keywordtype">void</span>
<a name="l00882"></a>00882 Module::clear(<span class="keyword">const</span> <span class="keywordtype">bool</span> erasePassPhrase)
<a name="l00883"></a>00883 {
<a name="l00884"></a>00884   <span class="keywordflow">if</span>(erasePassPhrase)
<a name="l00885"></a>00885     wipePassPhrase(<span class="keyword">true</span>);
<a name="l00886"></a>00886 }
<a name="l00887"></a>00887 
<a name="l00888"></a>00888 <span class="keyword">const</span> QString
<a name="l00889"></a>00889 Module::lastErrorMsg(<span class="keywordtype">void</span>)<span class="keyword"> const</span>
<a name="l00890"></a>00890 <span class="keyword"></span>{
<a name="l00891"></a>00891   <span class="keywordflow">return</span> errMsg;
<a name="l00892"></a>00892 }
<a name="l00893"></a>00893 
<a name="l00894"></a>00894 <span class="keywordtype">bool</span>
<a name="l00895"></a>00895 Module::havePGP(<span class="keywordtype">void</span>)<span class="keyword"> const</span>
<a name="l00896"></a>00896 <span class="keyword"></span>{
<a name="l00897"></a>00897   <span class="keywordflow">return</span> havePgp;
<a name="l00898"></a>00898 }
<a name="l00899"></a>00899 
<a name="l00900"></a>00900 <span class="keywordtype">void</span>
<a name="l00901"></a>00901 Module::setShowCipherText(<span class="keyword">const</span> <span class="keywordtype">bool</span> flag)
<a name="l00902"></a>00902 {
<a name="l00903"></a>00903   showEncryptionResult = flag;
<a name="l00904"></a>00904 }
<a name="l00905"></a>00905 
<a name="l00906"></a>00906 <span class="keywordtype">bool</span>
<a name="l00907"></a>00907 Module::showCipherText(<span class="keywordtype">void</span>)<span class="keyword"> const</span>
<a name="l00908"></a>00908 <span class="keyword"></span>{
<a name="l00909"></a>00909   <span class="keywordflow">return</span> showEncryptionResult;
<a name="l00910"></a>00910 }
<a name="l00911"></a>00911 
<a name="l00912"></a>00912 KeyID
<a name="l00913"></a>00913 Module::selectSecretKey( <span class="keyword">const</span> QString&amp; title,
<a name="l00914"></a>00914                          <span class="keyword">const</span> QString&amp; text,
<a name="l00915"></a>00915                          <span class="keyword">const</span> KeyID&amp; keyId )
<a name="l00916"></a>00916 {
<a name="l00917"></a>00917   <span class="keywordflow">if</span>( 0 == pgp ) {
<a name="l00918"></a>00918     assignPGPBase();
<a name="l00919"></a>00919   }
<a name="l00920"></a>00920 
<a name="l00921"></a>00921   <span class="keywordflow">if</span>( usePGP() ) {
<a name="l00922"></a>00922     <span class="keywordflow">return</span> selectKey( secretKeys(), title, text, keyId, SecretKeys );
<a name="l00923"></a>00923   }
<a name="l00924"></a>00924   <span class="keywordflow">else</span> {
<a name="l00925"></a>00925     KMessageBox::sorry( 0, i18n(<span class="stringliteral">"You either do not have GnuPG/PGP installed "</span>
<a name="l00926"></a>00926                                 <span class="stringliteral">"or you chose not to use GnuPG/PGP."</span>) );
<a name="l00927"></a>00927     <span class="keywordflow">return</span> KeyID();
<a name="l00928"></a>00928   }
<a name="l00929"></a>00929 }
<a name="l00930"></a>00930 
<a name="l00931"></a>00931 KeyID
<a name="l00932"></a>00932 Module::selectPublicKey( <span class="keyword">const</span> QString&amp; title,
<a name="l00933"></a>00933                          <span class="keyword">const</span> QString&amp; text <span class="comment">/* = QString::null */</span>,
<a name="l00934"></a>00934                          <span class="keyword">const</span> KeyID&amp; oldKeyId <span class="comment">/* = KeyID() */</span>,
<a name="l00935"></a>00935                          <span class="keyword">const</span> QString&amp; address <span class="comment">/* = QString::null */</span>,
<a name="l00936"></a>00936                          <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> allowedKeys <span class="comment">/* = AllKeys */</span> )
<a name="l00937"></a>00937 {
<a name="l00938"></a>00938   <span class="keywordflow">if</span>( 0 == pgp ) {
<a name="l00939"></a>00939     assignPGPBase();
<a name="l00940"></a>00940   }
<a name="l00941"></a>00941 
<a name="l00942"></a>00942   <span class="keywordflow">if</span>( usePGP() ) {
<a name="l00943"></a>00943     KeyID keyId;
<a name="l00944"></a>00944 
<a name="l00945"></a>00945     <span class="keywordflow">if</span>( address.isEmpty() ) {
<a name="l00946"></a>00946       keyId = selectKey( publicKeys(), title, text, oldKeyId, allowedKeys );
<a name="l00947"></a>00947     }
<a name="l00948"></a>00948     <span class="keywordflow">else</span> {
<a name="l00949"></a>00949       <span class="keywordtype">bool</span> rememberChoice;
<a name="l00950"></a>00950       keyId = selectKey( rememberChoice, publicKeys(), title, text, oldKeyId,
<a name="l00951"></a>00951                          allowedKeys );
<a name="l00952"></a>00952       <span class="keywordflow">if</span>( !keyId.isEmpty() &amp;&amp; rememberChoice ) {
<a name="l00953"></a>00953         setKeysForAddress( address, KeyIDList( keyId ) );
<a name="l00954"></a>00954       }
<a name="l00955"></a>00955     }
<a name="l00956"></a>00956 
<a name="l00957"></a>00957     <span class="keywordflow">return</span> keyId;
<a name="l00958"></a>00958   }
<a name="l00959"></a>00959   <span class="keywordflow">else</span> {
<a name="l00960"></a>00960     KMessageBox::sorry( 0, i18n(<span class="stringliteral">"You either do not have GnuPG/PGP installed "</span>
<a name="l00961"></a>00961                                 <span class="stringliteral">"or you chose not to use GnuPG/PGP."</span>) );
<a name="l00962"></a>00962     <span class="keywordflow">return</span> KeyID();
<a name="l00963"></a>00963   }
<a name="l00964"></a>00964 }
<a name="l00965"></a>00965 
<a name="l00966"></a>00966 
<a name="l00967"></a>00967 KeyIDList
<a name="l00968"></a>00968 Module::selectPublicKeys( <span class="keyword">const</span> QString&amp; title,
<a name="l00969"></a>00969                           <span class="keyword">const</span> QString&amp; text <span class="comment">/* = QString::null */</span>,
<a name="l00970"></a>00970                           <span class="keyword">const</span> KeyIDList&amp; oldKeyIds <span class="comment">/* = KeyIDList() */</span>,
<a name="l00971"></a>00971                           <span class="keyword">const</span> QString&amp; address <span class="comment">/* = QString::null */</span>,
<a name="l00972"></a>00972                           <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> allowedKeys <span class="comment">/* = AllKeys */</span> )
<a name="l00973"></a>00973 {
<a name="l00974"></a>00974   <span class="keywordflow">if</span>( 0 == pgp ) {
<a name="l00975"></a>00975     assignPGPBase();
<a name="l00976"></a>00976   }
<a name="l00977"></a>00977 
<a name="l00978"></a>00978   <span class="keywordflow">if</span>( usePGP() ) {
<a name="l00979"></a>00979     KeyIDList keyIds;
<a name="l00980"></a>00980 
<a name="l00981"></a>00981     <span class="keywordflow">if</span>( address.isEmpty() ) {
<a name="l00982"></a>00982       keyIds = selectKeys( publicKeys(), title, text, oldKeyIds, allowedKeys );
<a name="l00983"></a>00983     }
<a name="l00984"></a>00984     <span class="keywordflow">else</span> {
<a name="l00985"></a>00985       <span class="keywordtype">bool</span> rememberChoice;
<a name="l00986"></a>00986       keyIds = selectKeys( rememberChoice, publicKeys(), title, text,
<a name="l00987"></a>00987                            oldKeyIds, allowedKeys );
<a name="l00988"></a>00988       <span class="keywordflow">if</span>( !keyIds.isEmpty() &amp;&amp; rememberChoice ) {
<a name="l00989"></a>00989         setKeysForAddress( address, keyIds );
<a name="l00990"></a>00990       }
<a name="l00991"></a>00991     }
<a name="l00992"></a>00992 
<a name="l00993"></a>00993     <span class="keywordflow">return</span> keyIds;
<a name="l00994"></a>00994   }
<a name="l00995"></a>00995   <span class="keywordflow">else</span> {
<a name="l00996"></a>00996     KMessageBox::sorry( 0, i18n(<span class="stringliteral">"You either do not have GnuPG/PGP installed "</span>
<a name="l00997"></a>00997                                 <span class="stringliteral">"or you chose not to use GnuPG/PGP."</span>) );
<a name="l00998"></a>00998     <span class="keywordflow">return</span> KeyIDList();
<a name="l00999"></a>00999   }
<a name="l01000"></a>01000 }
<a name="l01001"></a>01001 
<a name="l01002"></a>01002 
<a name="l01003"></a>01003 <span class="comment">// -- static member functions ----------------------------------------------</span>
<a name="l01004"></a>01004 
<a name="l01005"></a>01005 Module *
<a name="l01006"></a>01006 Module::getKpgp()
<a name="l01007"></a>01007 {
<a name="l01008"></a>01008   <span class="keywordflow">if</span> (!kpgpObject)
<a name="l01009"></a>01009   {
<a name="l01010"></a>01010       kdError(5100) &lt;&lt; <span class="stringliteral">"there is no instance of kpgp available"</span> &lt;&lt; endl;
<a name="l01011"></a>01011   }
<a name="l01012"></a>01012   <span class="keywordflow">return</span> kpgpObject;
<a name="l01013"></a>01013 }
<a name="l01014"></a>01014 
<a name="l01015"></a>01015 
<a name="l01016"></a>01016 KConfig *
<a name="l01017"></a>01017 Module::getConfig()
<a name="l01018"></a>01018 {
<a name="l01019"></a>01019   <span class="keywordflow">return</span> getKpgp()-&gt;config;
<a name="l01020"></a>01020 }
<a name="l01021"></a>01021 
<a name="l01022"></a>01022 
<a name="l01023"></a>01023 <span class="keywordtype">bool</span>
<a name="l01024"></a>01024 Module::prepareMessageForDecryption( <span class="keyword">const</span> QCString&amp; msg,
<a name="l01025"></a>01025                                      QPtrList&lt;Block&gt;&amp; pgpBlocks,
<a name="l01026"></a>01026                                      QStrList&amp; nonPgpBlocks )
<a name="l01027"></a>01027 {
<a name="l01028"></a>01028   BlockType pgpBlock = NoPgpBlock;
<a name="l01029"></a>01029   <span class="keywordtype">int</span> start = -1;   <span class="comment">// start of the current PGP block</span>
<a name="l01030"></a>01030   <span class="keywordtype">int</span> lastEnd = -1; <span class="comment">// end of the last PGP block</span>
<a name="l01031"></a>01031 
<a name="l01032"></a>01032   pgpBlocks.setAutoDelete( <span class="keyword">true</span> );
<a name="l01033"></a>01033   pgpBlocks.clear();
<a name="l01034"></a>01034   nonPgpBlocks.setAutoDelete( <span class="keyword">true</span> );
<a name="l01035"></a>01035   nonPgpBlocks.clear();
<a name="l01036"></a>01036 
<a name="l01037"></a>01037   <span class="keywordflow">if</span>( msg.isEmpty() )
<a name="l01038"></a>01038   {
<a name="l01039"></a>01039     nonPgpBlocks.append( <span class="stringliteral">""</span> );
<a name="l01040"></a>01040     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01041"></a>01041   }
<a name="l01042"></a>01042 
<a name="l01043"></a>01043   <span class="keywordflow">if</span>( !strncmp( msg.data(), <span class="stringliteral">"-----BEGIN PGP "</span>, 15 ) )
<a name="l01044"></a>01044     start = 0;
<a name="l01045"></a>01045   <span class="keywordflow">else</span>
<a name="l01046"></a>01046   {
<a name="l01047"></a>01047     start = msg.find( <span class="stringliteral">"\n-----BEGIN PGP"</span> ) + 1;
<a name="l01048"></a>01048     <span class="keywordflow">if</span>( start == 0 )
<a name="l01049"></a>01049     {
<a name="l01050"></a>01050       nonPgpBlocks.append( msg );
<a name="l01051"></a>01051       <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// message doesn't contain an OpenPGP block</span>
<a name="l01052"></a>01052     }
<a name="l01053"></a>01053   }
<a name="l01054"></a>01054 
<a name="l01055"></a>01055   <span class="keywordflow">while</span>( start != -1 )
<a name="l01056"></a>01056   {
<a name="l01057"></a>01057     <span class="keywordtype">int</span> nextEnd, nextStart;
<a name="l01058"></a>01058 
<a name="l01059"></a>01059     <span class="comment">// is the PGP block a clearsigned block?</span>
<a name="l01060"></a>01060     <span class="keywordflow">if</span>( !strncmp( msg.data() + start + 15, <span class="stringliteral">"SIGNED"</span>, 6 ) )
<a name="l01061"></a>01061       pgpBlock = ClearsignedBlock;
<a name="l01062"></a>01062     <span class="keywordflow">else</span>
<a name="l01063"></a>01063       pgpBlock = UnknownBlock;
<a name="l01064"></a>01064 
<a name="l01065"></a>01065     nextEnd = msg.find( <span class="stringliteral">"\n-----END PGP"</span>, start + 15 );
<a name="l01066"></a>01066     <span class="keywordflow">if</span>( nextEnd == -1 )
<a name="l01067"></a>01067     {
<a name="l01068"></a>01068       nonPgpBlocks.append( msg.mid( lastEnd+1 ) );
<a name="l01069"></a>01069       <span class="keywordflow">break</span>;
<a name="l01070"></a>01070     }
<a name="l01071"></a>01071     nextStart = msg.find( <span class="stringliteral">"\n-----BEGIN PGP"</span>, start + 15 );
<a name="l01072"></a>01072 
<a name="l01073"></a>01073     <span class="keywordflow">if</span>( ( nextStart == -1 ) || ( nextEnd &lt; nextStart ) ||
<a name="l01074"></a>01074         ( pgpBlock == ClearsignedBlock ) )
<a name="l01075"></a>01075     { <span class="comment">// most likely we found a PGP block (but we don't check if it's valid)</span>
<a name="l01076"></a>01076       <span class="comment">// store the preceding non-PGP block</span>
<a name="l01077"></a>01077       nonPgpBlocks.append( msg.mid( lastEnd+1, start-lastEnd-1 ) );
<a name="l01078"></a>01078       lastEnd = msg.find( <span class="stringliteral">"\n"</span>, nextEnd + 14 );
<a name="l01079"></a>01079       <span class="keywordflow">if</span>( lastEnd == -1 )
<a name="l01080"></a>01080       {
<a name="l01081"></a>01081         pgpBlocks.append( <span class="keyword">new</span> Block( msg.mid( start ) ) );
<a name="l01082"></a>01082         nonPgpBlocks.append( <span class="stringliteral">""</span> );
<a name="l01083"></a>01083         <span class="keywordflow">break</span>;
<a name="l01084"></a>01084       }
<a name="l01085"></a>01085       <span class="keywordflow">else</span>
<a name="l01086"></a>01086       {
<a name="l01087"></a>01087         pgpBlocks.append( <span class="keyword">new</span> Block( msg.mid( start, lastEnd+1-start ) ) );
<a name="l01088"></a>01088         <span class="keywordflow">if</span>( ( nextStart != -1 ) &amp;&amp; ( nextEnd &gt; nextStart ) )
<a name="l01089"></a>01089           nextStart = msg.find( <span class="stringliteral">"\n-----BEGIN PGP"</span>, lastEnd+1 );
<a name="l01090"></a>01090       }
<a name="l01091"></a>01091     }
<a name="l01092"></a>01092 
<a name="l01093"></a>01093     start = nextStart;
<a name="l01094"></a>01094     <span class="keywordflow">if</span>( start == -1 )
<a name="l01095"></a>01095       nonPgpBlocks.append( msg.mid( lastEnd+1 ) );
<a name="l01096"></a>01096     <span class="keywordflow">else</span>
<a name="l01097"></a>01097       start++; <span class="comment">// move start behind the '\n'</span>
<a name="l01098"></a>01098   }
<a name="l01099"></a>01099 
<a name="l01100"></a>01100   <span class="keywordflow">return</span> ( !pgpBlocks.isEmpty() );
<a name="l01101"></a>01101 }
<a name="l01102"></a>01102 
<a name="l01103"></a>01103 
<a name="l01104"></a>01104 <span class="comment">// --------------------- private functions -------------------</span>
<a name="l01105"></a>01105 
<a name="l01106"></a>01106 <span class="keywordtype">bool</span>
<a name="l01107"></a>01107 Module::haveTrustedEncryptionKey( <span class="keyword">const</span> QString&amp; person )
<a name="l01108"></a>01108 {
<a name="l01109"></a>01109   <span class="keywordflow">if</span>( 0 == pgp ) assignPGPBase();
<a name="l01110"></a>01110 
<a name="l01111"></a>01111   <span class="keywordflow">if</span>( !usePGP() ) <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01112"></a>01112 
<a name="l01113"></a>01113   readPublicKeys();
<a name="l01114"></a>01114 
<a name="l01115"></a>01115   QString address = canonicalAddress( person ).lower();
<a name="l01116"></a>01116 
<a name="l01117"></a>01117   <span class="comment">// First look for this person's address in the address data dictionary</span>
<a name="l01118"></a>01118   KeyIDList keyIds = keysForAddress( address );
<a name="l01119"></a>01119   <span class="keywordflow">if</span>( !keyIds.isEmpty() ) {
<a name="l01120"></a>01120     <span class="comment">// Check if at least one of the keys is a trusted and valid encryption key</span>
<a name="l01121"></a>01121     <span class="keywordflow">for</span>( KeyIDList::ConstIterator it = keyIds.begin();
<a name="l01122"></a>01122          it != keyIds.end(); ++it ) {
<a name="l01123"></a>01123       keyTrust( *it ); <span class="comment">// this is called to make sure that the trust info</span>
<a name="l01124"></a>01124                        <span class="comment">// for this key is read</span>
<a name="l01125"></a>01125       Key *key = publicKey( *it );
<a name="l01126"></a>01126       <span class="keywordflow">if</span>( key &amp;&amp; ( key-&gt;isValidEncryptionKey() ) &amp;&amp;
<a name="l01127"></a>01127           ( key-&gt;keyTrust() &gt;= KPGP_VALIDITY_MARGINAL ) )
<a name="l01128"></a>01128         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01129"></a>01129     }
<a name="l01130"></a>01130   }
<a name="l01131"></a>01131 
<a name="l01132"></a>01132   <span class="comment">// Now search the public keys for matching keys</span>
<a name="l01133"></a>01133   KeyListIterator it( mPublicKeys );
<a name="l01134"></a>01134 
<a name="l01135"></a>01135   <span class="comment">// search a key which matches the complete address</span>
<a name="l01136"></a>01136   <span class="keywordflow">for</span>( it.toFirst(); (*it); ++it ) {
<a name="l01137"></a>01137     <span class="comment">// search case insensitively in the list of userIDs of this key</span>
<a name="l01138"></a>01138     <span class="keywordflow">if</span>( (*it)-&gt;matchesUserID( person, <span class="keyword">false</span> ) ) {
<a name="l01139"></a>01139       keyTrust( (*it)-&gt;primaryKeyID() ); <span class="comment">// this is called to make sure that</span>
<a name="l01140"></a>01140                                          <span class="comment">// the trust info for this key is read</span>
<a name="l01141"></a>01141       <span class="keywordflow">if</span>( ( (*it)-&gt;isValidEncryptionKey() ) &amp;&amp;
<a name="l01142"></a>01142           ( (*it)-&gt;keyTrust() &gt;= KPGP_VALIDITY_MARGINAL ) ) {
<a name="l01143"></a>01143         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01144"></a>01144       }
<a name="l01145"></a>01145     }
<a name="l01146"></a>01146   }
<a name="l01147"></a>01147 
<a name="l01148"></a>01148   <span class="comment">// if no key matches the complete address look for a key which matches</span>
<a name="l01149"></a>01149   <span class="comment">// the canonical mail address</span>
<a name="l01150"></a>01150   <span class="keywordflow">for</span>( it.toFirst(); (*it); ++it ) {
<a name="l01151"></a>01151     <span class="comment">// search case insensitively in the list of userIDs of this key</span>
<a name="l01152"></a>01152     <span class="keywordflow">if</span>( (*it)-&gt;matchesUserID( address, <span class="keyword">false</span> ) ) {
<a name="l01153"></a>01153       keyTrust( (*it)-&gt;primaryKeyID() ); <span class="comment">// this is called to make sure that</span>
<a name="l01154"></a>01154                                          <span class="comment">// the trust info for this key is read</span>
<a name="l01155"></a>01155       <span class="keywordflow">if</span>( ( (*it)-&gt;isValidEncryptionKey() ) &amp;&amp;
<a name="l01156"></a>01156           ( (*it)-&gt;keyTrust() &gt;= KPGP_VALIDITY_MARGINAL ) ) {
<a name="l01157"></a>01157         <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01158"></a>01158       }
<a name="l01159"></a>01159     }
<a name="l01160"></a>01160   }
<a name="l01161"></a>01161 
<a name="l01162"></a>01162   <span class="comment">// no trusted encryption key was found for the given person</span>
<a name="l01163"></a>01163   <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01164"></a>01164 }
<a name="l01165"></a>01165 
<a name="l01166"></a>01166 KeyIDList
<a name="l01167"></a>01167 Module::getEncryptionKeys( <span class="keyword">const</span> QString&amp; person )
<a name="l01168"></a>01168 {
<a name="l01169"></a>01169   <span class="keywordflow">if</span>( 0 == pgp ) assignPGPBase();
<a name="l01170"></a>01170 
<a name="l01171"></a>01171   <span class="keywordflow">if</span>( !usePGP() ) <span class="keywordflow">return</span> KeyIDList();
<a name="l01172"></a>01172 
<a name="l01173"></a>01173   readPublicKeys();
<a name="l01174"></a>01174 
<a name="l01175"></a>01175   QString address = canonicalAddress( person ).lower();
<a name="l01176"></a>01176 
<a name="l01177"></a>01177   <span class="comment">// #### FIXME: Until we support encryption with untrusted keys only</span>
<a name="l01178"></a>01178   <span class="comment">// ####        trusted keys are allowed</span>
<a name="l01179"></a>01179   <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> allowedKeys = PublicKeys | EncryptionKeys | ValidKeys | TrustedKeys;
<a name="l01180"></a>01180 <span class="preprocessor">#if 0</span>
<a name="l01181"></a>01181 <span class="preprocessor"></span>  <span class="comment">// ### reenable this code when we support encryption with untrusted keys</span>
<a name="l01182"></a>01182   <span class="keywordflow">if</span>( pgpType != tGPG ) {
<a name="l01183"></a>01183     <span class="comment">// usage of untrusted keys is only possible with GnuPG</span>
<a name="l01184"></a>01184     allowedKeys |= TrustedKeys;
<a name="l01185"></a>01185   }
<a name="l01186"></a>01186 <span class="preprocessor">#endif</span>
<a name="l01187"></a>01187 <span class="preprocessor"></span>
<a name="l01188"></a>01188   <span class="comment">// First look for this person's address in the address-&gt;key dictionary</span>
<a name="l01189"></a>01189   KeyIDList keyIds = keysForAddress( address );
<a name="l01190"></a>01190   <span class="keywordflow">if</span>( !keyIds.isEmpty() ) {
<a name="l01191"></a>01191     kdDebug(5100) &lt;&lt; <span class="stringliteral">"Using encryption keys 0x"</span>
<a name="l01192"></a>01192                   &lt;&lt; keyIds.toStringList().join( <span class="stringliteral">", 0x"</span> )
<a name="l01193"></a>01193                   &lt;&lt; <span class="stringliteral">" for "</span> &lt;&lt; person &lt;&lt; endl;
<a name="l01194"></a>01194     <span class="comment">// Check if all of the keys are a trusted and valid encryption keys</span>
<a name="l01195"></a>01195     <span class="keywordtype">bool</span> keysOk = <span class="keyword">true</span>;
<a name="l01196"></a>01196     <span class="keywordflow">for</span>( KeyIDList::ConstIterator it = keyIds.begin();
<a name="l01197"></a>01197          it != keyIds.end(); ++it ) {
<a name="l01198"></a>01198       keyTrust( *it ); <span class="comment">// this is called to make sure that the trust info</span>
<a name="l01199"></a>01199                        <span class="comment">// for this key is read</span>
<a name="l01200"></a>01200       Key *key = publicKey( *it );
<a name="l01201"></a>01201       <span class="keywordflow">if</span>( !( key &amp;&amp; ( key-&gt;isValidEncryptionKey() ) &amp;&amp;
<a name="l01202"></a>01202              ( key-&gt;keyTrust() &gt;= KPGP_VALIDITY_MARGINAL ) ) )
<a name="l01203"></a>01203         keysOk = <span class="keyword">false</span>;
<a name="l01204"></a>01204     }
<a name="l01205"></a>01205     <span class="keywordflow">if</span>( keysOk ) {
<a name="l01206"></a>01206       <span class="keywordflow">return</span> keyIds;
<a name="l01207"></a>01207     }
<a name="l01208"></a>01208     <span class="keywordflow">else</span> {
<a name="l01209"></a>01209       <span class="keywordtype">bool</span> rememberChoice;
<a name="l01210"></a>01210       keyIds = selectKeys( rememberChoice, mPublicKeys,
<a name="l01211"></a>01211                            i18n(<span class="stringliteral">"Encryption Key Selection"</span>),
<a name="l01212"></a>01212                            i18n(<span class="stringliteral">"if in your language something like "</span>
<a name="l01213"></a>01213                                 <span class="stringliteral">"'key(s)' isn't possible please "</span>
<a name="l01214"></a>01214                                 <span class="stringliteral">"use the plural in the translation"</span>,
<a name="l01215"></a>01215                                 <span class="stringliteral">"There is a problem with the "</span>
<a name="l01216"></a>01216                                 <span class="stringliteral">"encryption key(s) for \"%1\".\n\n"</span>
<a name="l01217"></a>01217                                 <span class="stringliteral">"Please re-select the key(s) which should "</span>
<a name="l01218"></a>01218                                 <span class="stringliteral">"be used for this recipient."</span>
<a name="l01219"></a>01219                                 ).arg(person),
<a name="l01220"></a>01220                            keyIds,
<a name="l01221"></a>01221                            allowedKeys );
<a name="l01222"></a>01222       <span class="keywordflow">if</span>( !keyIds.isEmpty() ) {
<a name="l01223"></a>01223         <span class="keywordflow">if</span>( rememberChoice ) {
<a name="l01224"></a>01224           setKeysForAddress( person, keyIds );
<a name="l01225"></a>01225         }
<a name="l01226"></a>01226         <span class="keywordflow">return</span> keyIds;
<a name="l01227"></a>01227       }
<a name="l01228"></a>01228     }
<a name="l01229"></a>01229   }
<a name="l01230"></a>01230 
<a name="l01231"></a>01231   <span class="comment">// Now search all public keys for matching keys</span>
<a name="l01232"></a>01232   KeyListIterator it( mPublicKeys );
<a name="l01233"></a>01233   KeyList matchingKeys;
<a name="l01234"></a>01234 
<a name="l01235"></a>01235   <span class="comment">// search all keys which match the complete address</span>
<a name="l01236"></a>01236   kdDebug(5100) &lt;&lt; <span class="stringliteral">"Looking for keys matching "</span> &lt;&lt; person &lt;&lt; <span class="stringliteral">" ...\n"</span>;
<a name="l01237"></a>01237   <span class="keywordflow">for</span>( it.toFirst(); (*it); ++it ) {
<a name="l01238"></a>01238     <span class="comment">// search case insensitively in the list of userIDs of this key</span>
<a name="l01239"></a>01239     <span class="keywordflow">if</span>( (*it)-&gt;matchesUserID( person, <span class="keyword">false</span> ) ) {
<a name="l01240"></a>01240       keyTrust( (*it)-&gt;primaryKeyID() ); <span class="comment">// this is called to make sure that</span>
<a name="l01241"></a>01241                                          <span class="comment">// the trust info for this key is read</span>
<a name="l01242"></a>01242       <span class="keywordflow">if</span>( ( (*it)-&gt;isValidEncryptionKey() ) &amp;&amp;
<a name="l01243"></a>01243           ( (*it)-&gt;keyTrust() &gt;= KPGP_VALIDITY_MARGINAL ) ) {
<a name="l01244"></a>01244         kdDebug(5100) &lt;&lt; <span class="stringliteral">"Matching trusted key found: "</span>
<a name="l01245"></a>01245                       &lt;&lt; (*it)-&gt;primaryKeyID() &lt;&lt; endl;
<a name="l01246"></a>01246         matchingKeys.append( *it );
<a name="l01247"></a>01247       }
<a name="l01248"></a>01248     }
<a name="l01249"></a>01249   }
<a name="l01250"></a>01250 
<a name="l01251"></a>01251   <span class="comment">// if no keys match the complete address look for keys which match</span>
<a name="l01252"></a>01252   <span class="comment">// the canonical mail address</span>
<a name="l01253"></a>01253   kdDebug(5100) &lt;&lt; <span class="stringliteral">"Looking for keys matching "</span> &lt;&lt; address &lt;&lt; <span class="stringliteral">" ...\n"</span>;
<a name="l01254"></a>01254   <span class="keywordflow">if</span>( matchingKeys.isEmpty() ) {
<a name="l01255"></a>01255     <span class="keywordflow">for</span> ( it.toFirst(); (*it); ++it ) {
<a name="l01256"></a>01256       <span class="comment">// search case insensitively in the list of userIDs of this key</span>
<a name="l01257"></a>01257       <span class="keywordflow">if</span>( (*it)-&gt;matchesUserID( address, <span class="keyword">false</span> ) ) {
<a name="l01258"></a>01258         keyTrust( (*it)-&gt;primaryKeyID() ); <span class="comment">// this is called to make sure that</span>
<a name="l01259"></a>01259                                            <span class="comment">// the trust info for this key is read</span>
<a name="l01260"></a>01260         <span class="keywordflow">if</span>( ( (*it)-&gt;isValidEncryptionKey() ) &amp;&amp;
<a name="l01261"></a>01261             ( (*it)-&gt;keyTrust() &gt;= KPGP_VALIDITY_MARGINAL ) ) {
<a name="l01262"></a>01262           kdDebug(5100) &lt;&lt; <span class="stringliteral">"Matching trusted key found: "</span>
<a name="l01263"></a>01263                         &lt;&lt; (*it)-&gt;primaryKeyID() &lt;&lt; endl;
<a name="l01264"></a>01264           matchingKeys.append( *it );
<a name="l01265"></a>01265         }
<a name="l01266"></a>01266       }
<a name="l01267"></a>01267     }
<a name="l01268"></a>01268   }
<a name="l01269"></a>01269 
<a name="l01270"></a>01270   <span class="comment">// no match until now, let the user choose the key</span>
<a name="l01271"></a>01271   <span class="keywordflow">if</span>( matchingKeys.isEmpty() ) {
<a name="l01272"></a>01272     <span class="comment">// FIXME: let user get the key from keyserver</span>
<a name="l01273"></a>01273     <span class="keywordtype">bool</span> rememberChoice;
<a name="l01274"></a>01274     KeyIDList keyIds = selectKeys( rememberChoice, mPublicKeys,
<a name="l01275"></a>01275                                    i18n(<span class="stringliteral">"Encryption Key Selection"</span>),
<a name="l01276"></a>01276                                    i18n(<span class="stringliteral">"if in your language something like "</span>
<a name="l01277"></a>01277                                         <span class="stringliteral">"'key(s)' isn't possible please "</span>
<a name="l01278"></a>01278                                         <span class="stringliteral">"use the plural in the translation"</span>,
<a name="l01279"></a>01279                                         <span class="stringliteral">"No valid and trusted OpenPGP key was "</span>
<a name="l01280"></a>01280                                         <span class="stringliteral">"found for \"%1\".\n\n"</span>
<a name="l01281"></a>01281                                         <span class="stringliteral">"Select the key(s) which should "</span>
<a name="l01282"></a>01282                                         <span class="stringliteral">"be used for this recipient."</span>
<a name="l01283"></a>01283                                         ).arg(person),
<a name="l01284"></a>01284                                    KeyIDList(),
<a name="l01285"></a>01285                                    allowedKeys );
<a name="l01286"></a>01286     <span class="keywordflow">if</span>( !keyIds.isEmpty() ) {
<a name="l01287"></a>01287       <span class="keywordflow">if</span>( rememberChoice ) {
<a name="l01288"></a>01288         setKeysForAddress( person, keyIds );
<a name="l01289"></a>01289       }
<a name="l01290"></a>01290       <span class="keywordflow">return</span> keyIds;
<a name="l01291"></a>01291     }
<a name="l01292"></a>01292   }
<a name="l01293"></a>01293   <span class="comment">// only one key matches</span>
<a name="l01294"></a>01294   <span class="keywordflow">else</span> <span class="keywordflow">if</span>( matchingKeys.count() == 1 ) {
<a name="l01295"></a>01295     <span class="keywordflow">return</span> KeyIDList( matchingKeys.getFirst()-&gt;primaryKeyID() );
<a name="l01296"></a>01296   }
<a name="l01297"></a>01297   <span class="comment">// more than one key matches; let the user choose the key(s)</span>
<a name="l01298"></a>01298   <span class="keywordflow">else</span> {
<a name="l01299"></a>01299     <span class="keywordtype">bool</span> rememberChoice;
<a name="l01300"></a>01300     KeyIDList keyIds = selectKeys( rememberChoice, matchingKeys,
<a name="l01301"></a>01301                                    i18n(<span class="stringliteral">"Encryption Key Selection"</span>),
<a name="l01302"></a>01302                                    i18n(<span class="stringliteral">"if in your language something like "</span>
<a name="l01303"></a>01303                                         <span class="stringliteral">"'key(s)' isn't possible please "</span>
<a name="l01304"></a>01304                                         <span class="stringliteral">"use the plural in the translation"</span>,
<a name="l01305"></a>01305                                         <span class="stringliteral">"More than one key matches \"%1\".\n\n"</span>
<a name="l01306"></a>01306                                         <span class="stringliteral">"Select the key(s) which should "</span>
<a name="l01307"></a>01307                                         <span class="stringliteral">"be used for this recipient."</span>
<a name="l01308"></a>01308                                         ).arg(person),
<a name="l01309"></a>01309                                    KeyIDList(),
<a name="l01310"></a>01310                                    allowedKeys );
<a name="l01311"></a>01311     <span class="keywordflow">if</span>( !keyIds.isEmpty() ) {
<a name="l01312"></a>01312       <span class="keywordflow">if</span>( rememberChoice ) {
<a name="l01313"></a>01313         setKeysForAddress( person, keyIds );
<a name="l01314"></a>01314       }
<a name="l01315"></a>01315       <span class="keywordflow">return</span> keyIds;
<a name="l01316"></a>01316     }
<a name="l01317"></a>01317   }
<a name="l01318"></a>01318 
<a name="l01319"></a>01319   <span class="keywordflow">return</span> KeyIDList();
<a name="l01320"></a>01320 }
<a name="l01321"></a>01321 
<a name="l01322"></a>01322 <span class="comment">// check if pgp 2.6.x or 5.0 is installed</span>
<a name="l01323"></a>01323 <span class="comment">// kpgp will prefer to user pgp 5.0</span>
<a name="l01324"></a>01324 <span class="keywordtype">bool</span>
<a name="l01325"></a>01325 Module::checkForPGP(<span class="keywordtype">void</span>)
<a name="l01326"></a>01326 {
<a name="l01327"></a>01327   <span class="comment">// get path</span>
<a name="l01328"></a>01328   QCString path;
<a name="l01329"></a>01329   QStrList pSearchPaths;
<a name="l01330"></a>01330   <span class="keywordtype">int</span> index = 0;
<a name="l01331"></a>01331   <span class="keywordtype">int</span> lastindex = -1;
<a name="l01332"></a>01332 
<a name="l01333"></a>01333   havePgp=FALSE;
<a name="l01334"></a>01334 
<a name="l01335"></a>01335   path = getenv(<span class="stringliteral">"PATH"</span>);
<a name="l01336"></a>01336   <span class="keywordflow">while</span>((index = path.find(<span class="stringliteral">":"</span>,lastindex+1)) != -1)
<a name="l01337"></a>01337   {
<a name="l01338"></a>01338     pSearchPaths.append(path.mid(lastindex+1,index-lastindex-1));
<a name="l01339"></a>01339     lastindex = index;
<a name="l01340"></a>01340   }
<a name="l01341"></a>01341   <span class="keywordflow">if</span>(lastindex != (<span class="keywordtype">int</span>)path.length() - 1)
<a name="l01342"></a>01342     pSearchPaths.append( path.mid(lastindex+1,path.length()-lastindex) );
<a name="l01343"></a>01343 
<a name="l01344"></a>01344   QStrListIterator it(pSearchPaths);
<a name="l01345"></a>01345 
<a name="l01346"></a>01346   haveGpg=FALSE;
<a name="l01347"></a>01347   <span class="comment">// lets try gpg</span>
<a name="l01348"></a>01348 
<a name="l01349"></a>01349   <span class="keywordflow">for</span> ( it.toFirst() ; it.current() ; ++it )
<a name="l01350"></a>01350   {
<a name="l01351"></a>01351     path = (*it);
<a name="l01352"></a>01352     path += <span class="stringliteral">"/gpg"</span>;
<a name="l01353"></a>01353     <span class="keywordflow">if</span> ( !access( path, X_OK ) )
<a name="l01354"></a>01354     {
<a name="l01355"></a>01355       kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: gpg found"</span> &lt;&lt; endl;
<a name="l01356"></a>01356       havePgp=TRUE;
<a name="l01357"></a>01357       haveGpg=TRUE;
<a name="l01358"></a>01358       <span class="keywordflow">break</span>;
<a name="l01359"></a>01359     }
<a name="l01360"></a>01360   }
<a name="l01361"></a>01361 
<a name="l01362"></a>01362   <span class="comment">// search for pgp5.0</span>
<a name="l01363"></a>01363   havePGP5=FALSE;
<a name="l01364"></a>01364   <span class="keywordflow">for</span> ( it.toFirst() ; it.current() ; ++it )
<a name="l01365"></a>01365   {
<a name="l01366"></a>01366     path = (*it);
<a name="l01367"></a>01367     path += <span class="stringliteral">"/pgpe"</span>;
<a name="l01368"></a>01368     <span class="keywordflow">if</span> ( !access( path, X_OK ) )
<a name="l01369"></a>01369     {
<a name="l01370"></a>01370       kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: pgp 5 found"</span> &lt;&lt; endl;
<a name="l01371"></a>01371       havePgp=TRUE;
<a name="l01372"></a>01372       havePGP5=TRUE;
<a name="l01373"></a>01373       <span class="keywordflow">break</span>;
<a name="l01374"></a>01374     }
<a name="l01375"></a>01375   }
<a name="l01376"></a>01376 
<a name="l01377"></a>01377   <span class="comment">// lets try pgp2.6.x</span>
<a name="l01378"></a>01378   <span class="keywordflow">if</span> (!havePgp) {
<a name="l01379"></a>01379     <span class="keywordflow">for</span> ( it.toFirst() ; it.current() ; ++it )
<a name="l01380"></a>01380     {
<a name="l01381"></a>01381       path = it.current();
<a name="l01382"></a>01382       path += <span class="stringliteral">"/pgp"</span>;
<a name="l01383"></a>01383       <span class="keywordflow">if</span> ( !access( path, X_OK ) )
<a name="l01384"></a>01384       {
<a name="l01385"></a>01385     kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: pgp 2 or 6 found"</span> &lt;&lt; endl;
<a name="l01386"></a>01386     havePgp=TRUE;
<a name="l01387"></a>01387     <span class="keywordflow">break</span>;
<a name="l01388"></a>01388       }
<a name="l01389"></a>01389     }
<a name="l01390"></a>01390   }
<a name="l01391"></a>01391 
<a name="l01392"></a>01392   <span class="keywordflow">if</span> (!havePgp)
<a name="l01393"></a>01393   {
<a name="l01394"></a>01394     kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: no pgp found"</span> &lt;&lt; endl;
<a name="l01395"></a>01395   }
<a name="l01396"></a>01396 
<a name="l01397"></a>01397   <span class="keywordflow">return</span> havePgp;
<a name="l01398"></a>01398 }
<a name="l01399"></a>01399 
<a name="l01400"></a>01400 <span class="keywordtype">void</span>
<a name="l01401"></a>01401 Module::assignPGPBase(<span class="keywordtype">void</span>)
<a name="l01402"></a>01402 {
<a name="l01403"></a>01403   <span class="keywordflow">if</span> (pgp)
<a name="l01404"></a>01404     <span class="keyword">delete</span> pgp;
<a name="l01405"></a>01405 
<a name="l01406"></a>01406   <span class="keywordflow">if</span>(havePgp)
<a name="l01407"></a>01407   {
<a name="l01408"></a>01408     <span class="keywordflow">switch</span> (pgpType)
<a name="l01409"></a>01409     {
<a name="l01410"></a>01410       <span class="keywordflow">case</span> tGPG:
<a name="l01411"></a>01411         kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: assign pgp - gpg"</span> &lt;&lt; endl;
<a name="l01412"></a>01412         pgp = <span class="keyword">new</span> BaseG();
<a name="l01413"></a>01413         <span class="keywordflow">break</span>;
<a name="l01414"></a>01414 
<a name="l01415"></a>01415       <span class="keywordflow">case</span> tPGP2:
<a name="l01416"></a>01416         kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: assign pgp - pgp 2"</span> &lt;&lt; endl;
<a name="l01417"></a>01417         pgp = <span class="keyword">new</span> Base2();
<a name="l01418"></a>01418         <span class="keywordflow">break</span>;
<a name="l01419"></a>01419 
<a name="l01420"></a>01420       <span class="keywordflow">case</span> tPGP5:
<a name="l01421"></a>01421         kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: assign pgp - pgp 5"</span> &lt;&lt; endl;
<a name="l01422"></a>01422         pgp = <span class="keyword">new</span> Base5();
<a name="l01423"></a>01423         <span class="keywordflow">break</span>;
<a name="l01424"></a>01424 
<a name="l01425"></a>01425       <span class="keywordflow">case</span> tPGP6:
<a name="l01426"></a>01426         kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: assign pgp - pgp 6"</span> &lt;&lt; endl;
<a name="l01427"></a>01427         pgp = <span class="keyword">new</span> Base6();
<a name="l01428"></a>01428         <span class="keywordflow">break</span>;
<a name="l01429"></a>01429 
<a name="l01430"></a>01430       <span class="keywordflow">case</span> tOff:
<a name="l01431"></a>01431         <span class="comment">// dummy handler</span>
<a name="l01432"></a>01432         kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: pgpBase is dummy "</span> &lt;&lt; endl;
<a name="l01433"></a>01433         pgp = <span class="keyword">new</span> Base();
<a name="l01434"></a>01434         <span class="keywordflow">break</span>;
<a name="l01435"></a>01435 
<a name="l01436"></a>01436       <span class="keywordflow">case</span> tAuto:
<a name="l01437"></a>01437         kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: assign pgp - auto"</span> &lt;&lt; endl;
<a name="l01438"></a>01438         <span class="comment">// fall through</span>
<a name="l01439"></a>01439       <span class="keywordflow">default</span>:
<a name="l01440"></a>01440         kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: assign pgp - default"</span> &lt;&lt; endl;
<a name="l01441"></a>01441         <span class="keywordflow">if</span> (haveGpg)
<a name="l01442"></a>01442         {
<a name="l01443"></a>01443           kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: pgpBase is gpg "</span> &lt;&lt; endl;
<a name="l01444"></a>01444           pgp = <span class="keyword">new</span> BaseG();
<a name="l01445"></a>01445           pgpType = tGPG;
<a name="l01446"></a>01446         }
<a name="l01447"></a>01447         <span class="keywordflow">else</span> <span class="keywordflow">if</span>(havePGP5)
<a name="l01448"></a>01448         {
<a name="l01449"></a>01449           kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: pgpBase is pgp 5"</span> &lt;&lt; endl;
<a name="l01450"></a>01450           pgp = <span class="keyword">new</span> Base5();
<a name="l01451"></a>01451           pgpType = tPGP5;
<a name="l01452"></a>01452         }
<a name="l01453"></a>01453         <span class="keywordflow">else</span>
<a name="l01454"></a>01454         {
<a name="l01455"></a>01455           Base6 *pgp_v6 = <span class="keyword">new</span> Base6();
<a name="l01456"></a>01456           <span class="keywordflow">if</span> (!pgp_v6-&gt;isVersion6())
<a name="l01457"></a>01457           {
<a name="l01458"></a>01458             kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: pgpBase is pgp 2 "</span> &lt;&lt; endl;
<a name="l01459"></a>01459             <span class="keyword">delete</span> pgp_v6;
<a name="l01460"></a>01460             pgp = <span class="keyword">new</span> Base2();
<a name="l01461"></a>01461             pgpType = tPGP2;
<a name="l01462"></a>01462           }
<a name="l01463"></a>01463           <span class="keywordflow">else</span>
<a name="l01464"></a>01464           {
<a name="l01465"></a>01465             kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: pgpBase is pgp 6 "</span> &lt;&lt; endl;
<a name="l01466"></a>01466             pgp = pgp_v6;
<a name="l01467"></a>01467             pgpType = tPGP6;
<a name="l01468"></a>01468           }
<a name="l01469"></a>01469         }
<a name="l01470"></a>01470     } <span class="comment">// switch</span>
<a name="l01471"></a>01471   }
<a name="l01472"></a>01472   <span class="keywordflow">else</span>
<a name="l01473"></a>01473   {
<a name="l01474"></a>01474     <span class="comment">// dummy handler</span>
<a name="l01475"></a>01475     kdDebug(5100) &lt;&lt; <span class="stringliteral">"Kpgp: pgpBase is dummy "</span> &lt;&lt; endl;
<a name="l01476"></a>01476     pgp = <span class="keyword">new</span> Base();
<a name="l01477"></a>01477     pgpType = tOff;
<a name="l01478"></a>01478   }
<a name="l01479"></a>01479 }
<a name="l01480"></a>01480 
<a name="l01481"></a>01481 QString
<a name="l01482"></a>01482 Module::canonicalAddress( <span class="keyword">const</span> QString&amp; _adress )
<a name="l01483"></a>01483 {
<a name="l01484"></a>01484   <span class="keywordtype">int</span> index,index2;
<a name="l01485"></a>01485 
<a name="l01486"></a>01486   QString address = _adress.simplifyWhiteSpace();
<a name="l01487"></a>01487   address = address.stripWhiteSpace();
<a name="l01488"></a>01488 
<a name="l01489"></a>01489   <span class="comment">// just leave pure e-mail address.</span>
<a name="l01490"></a>01490   <span class="keywordflow">if</span>((index = address.find(<span class="stringliteral">"&lt;"</span>)) != -1)
<a name="l01491"></a>01491     <span class="keywordflow">if</span>((index2 = address.find(<span class="stringliteral">"@"</span>,index+1)) != -1)
<a name="l01492"></a>01492       <span class="keywordflow">if</span>((index2 = address.find(<span class="stringliteral">"&gt;"</span>,index2+1)) != -1)
<a name="l01493"></a>01493     <span class="keywordflow">return</span> address.mid(index,index2-index+1);
<a name="l01494"></a>01494 
<a name="l01495"></a>01495   <span class="keywordflow">if</span>((index = address.find(<span class="stringliteral">"@"</span>)) == -1)
<a name="l01496"></a>01496   {
<a name="l01497"></a>01497     <span class="comment">// local address</span>
<a name="l01498"></a>01498     <span class="comment">//char hostname[1024];</span>
<a name="l01499"></a>01499     <span class="comment">//gethostname(hostname,1024);</span>
<a name="l01500"></a>01500     <span class="comment">//return "&lt;" + address + "@" + hostname + "&gt;";</span>
<a name="l01501"></a>01501     <span class="keywordflow">return</span> <span class="stringliteral">"&lt;"</span> + address + <span class="stringliteral">"@localdomain&gt;"</span>;
<a name="l01502"></a>01502   }
<a name="l01503"></a>01503   <span class="keywordflow">else</span>
<a name="l01504"></a>01504   {
<a name="l01505"></a>01505     <span class="keywordtype">int</span> index1 = address.findRev(<span class="stringliteral">" "</span>,index);
<a name="l01506"></a>01506     <span class="keywordtype">int</span> index2 = address.find(<span class="stringliteral">" "</span>,index);
<a name="l01507"></a>01507     <span class="keywordflow">if</span>(index2 == -1) index2 = address.length();
<a name="l01508"></a>01508     <span class="keywordflow">return</span> <span class="stringliteral">"&lt;"</span> + address.mid(index1+1 ,index2-index1-1) + <span class="stringliteral">"&gt;"</span>;
<a name="l01509"></a>01509   }
<a name="l01510"></a>01510 }
<a name="l01511"></a>01511 
<a name="l01512"></a>01512 <span class="keywordtype">void</span>
<a name="l01513"></a>01513 Module::readPublicKeys( <span class="keywordtype">bool</span> reread )
<a name="l01514"></a>01514 {
<a name="l01515"></a>01515   <span class="keywordflow">if</span>( 0 == pgp ) assignPGPBase();
<a name="l01516"></a>01516 
<a name="l01517"></a>01517   <span class="keywordflow">if</span>( !usePGP() )
<a name="l01518"></a>01518   {
<a name="l01519"></a>01519     mPublicKeys.clear();
<a name="l01520"></a>01520     mPublicKeysCached = <span class="keyword">false</span>;
<a name="l01521"></a>01521     <span class="keywordflow">return</span>;
<a name="l01522"></a>01522   }
<a name="l01523"></a>01523 
<a name="l01524"></a>01524   <span class="keywordflow">if</span>( !mPublicKeysCached || reread )
<a name="l01525"></a>01525   {
<a name="l01526"></a>01526     <span class="keywordflow">if</span>( mPublicKeys.isEmpty() )
<a name="l01527"></a>01527     {
<a name="l01528"></a>01528       mPublicKeys = pgp-&gt;publicKeys();
<a name="l01529"></a>01529     }
<a name="l01530"></a>01530     <span class="keywordflow">else</span>
<a name="l01531"></a>01531     {
<a name="l01532"></a>01532       KeyList newPublicKeyList = pgp-&gt;publicKeys();
<a name="l01533"></a>01533 
<a name="l01534"></a>01534       <span class="comment">// merge the trust info from the old key list into the new key list</span>
<a name="l01535"></a>01535       <span class="comment">// FIXME: This is currently O(K^2) where K = #keys. As the key lists</span>
<a name="l01536"></a>01536       <span class="comment">//        are sorted this can be done in O(K).</span>
<a name="l01537"></a>01537       KeyListIterator it( newPublicKeyList );
<a name="l01538"></a>01538       <span class="keywordflow">for</span>( it.toFirst(); (*it); ++it )
<a name="l01539"></a>01539       {
<a name="l01540"></a>01540         Key* oldKey = publicKey( (*it)-&gt;primaryKeyID() );
<a name="l01541"></a>01541         <span class="keywordflow">if</span>( oldKey )
<a name="l01542"></a>01542         {
<a name="l01543"></a>01543           (*it)-&gt;cloneKeyTrust( oldKey );
<a name="l01544"></a>01544         }
<a name="l01545"></a>01545       }
<a name="l01546"></a>01546 
<a name="l01547"></a>01547       mPublicKeys = newPublicKeyList;
<a name="l01548"></a>01548     }
<a name="l01549"></a>01549 
<a name="l01550"></a>01550     mPublicKeysCached = <span class="keyword">true</span>;
<a name="l01551"></a>01551     mPublicKeys.setAutoDelete( <span class="keyword">true</span> );
<a name="l01552"></a>01552   }
<a name="l01553"></a>01553 }
<a name="l01554"></a>01554 
<a name="l01555"></a>01555 <span class="keywordtype">void</span>
<a name="l01556"></a>01556 Module::readSecretKeys( <span class="keywordtype">bool</span> reread )
<a name="l01557"></a>01557 {
<a name="l01558"></a>01558   <span class="keywordflow">if</span>( 0 == pgp ) assignPGPBase();
<a name="l01559"></a>01559 
<a name="l01560"></a>01560   <span class="keywordflow">if</span>( !usePGP() )
<a name="l01561"></a>01561   {
<a name="l01562"></a>01562     mSecretKeys.clear();
<a name="l01563"></a>01563     mSecretKeysCached = <span class="keyword">false</span>;
<a name="l01564"></a>01564     <span class="keywordflow">return</span>;
<a name="l01565"></a>01565   }
<a name="l01566"></a>01566 
<a name="l01567"></a>01567   <span class="keywordflow">if</span>( mSecretKeys.isEmpty() || reread )
<a name="l01568"></a>01568   {
<a name="l01569"></a>01569     <span class="keywordflow">if</span>( mSecretKeys.isEmpty() )
<a name="l01570"></a>01570     {
<a name="l01571"></a>01571       mSecretKeys = pgp-&gt;secretKeys();
<a name="l01572"></a>01572     }
<a name="l01573"></a>01573     <span class="keywordflow">else</span>
<a name="l01574"></a>01574     {
<a name="l01575"></a>01575       KeyList newSecretKeyList = pgp-&gt;secretKeys();
<a name="l01576"></a>01576 
<a name="l01577"></a>01577       <span class="comment">// merge the trust info from the old key list into the new key list</span>
<a name="l01578"></a>01578       <span class="comment">// FIXME: This is currently O(K^2) where K = #keys. As the key lists</span>
<a name="l01579"></a>01579       <span class="comment">//        are sorted this can be done in O(K).</span>
<a name="l01580"></a>01580       KeyListIterator it( newSecretKeyList );
<a name="l01581"></a>01581       <span class="keywordflow">for</span>( it.toFirst(); (*it); ++it )
<a name="l01582"></a>01582       {
<a name="l01583"></a>01583         Key* oldKey = secretKey( (*it)-&gt;primaryKeyID() );
<a name="l01584"></a>01584         <span class="keywordflow">if</span>( oldKey )
<a name="l01585"></a>01585         {
<a name="l01586"></a>01586           (*it)-&gt;cloneKeyTrust( oldKey );
<a name="l01587"></a>01587         }
<a name="l01588"></a>01588       }
<a name="l01589"></a>01589 
<a name="l01590"></a>01590       mSecretKeys = newSecretKeyList;
<a name="l01591"></a>01591     }
<a name="l01592"></a>01592 
<a name="l01593"></a>01593     mSecretKeysCached = <span class="keyword">true</span>;
<a name="l01594"></a>01594     mSecretKeys.setAutoDelete( <span class="keyword">true</span> );
<a name="l01595"></a>01595   }
<a name="l01596"></a>01596 }
<a name="l01597"></a>01597 
<a name="l01598"></a>01598 KeyID
<a name="l01599"></a>01599 Module::selectKey( <span class="keyword">const</span> KeyList&amp; keys,
<a name="l01600"></a>01600                    <span class="keyword">const</span> QString&amp; title,
<a name="l01601"></a>01601                    <span class="keyword">const</span> QString&amp; text <span class="comment">/* = QString::null */</span> ,
<a name="l01602"></a>01602                    <span class="keyword">const</span> KeyID&amp; keyId <span class="comment">/* = KeyID() */</span> ,
<a name="l01603"></a>01603                    <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> allowedKeys <span class="comment">/* = AllKeys */</span> )
<a name="l01604"></a>01604 {
<a name="l01605"></a>01605   KeyID retval = KeyID();
<a name="l01606"></a>01606 
<a name="l01607"></a>01607   KeySelectionDialog dlg( keys, title, text, KeyIDList( keyId ), <span class="keyword">false</span>,
<a name="l01608"></a>01608                           allowedKeys, <span class="keyword">false</span> );
<a name="l01609"></a>01609 
<a name="l01610"></a>01610   QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l01611"></a>01611   <span class="keywordtype">bool</span> rej = ( dlg.exec() == QDialog::Rejected );
<a name="l01612"></a>01612   QApplication::restoreOverrideCursor();
<a name="l01613"></a>01613 
<a name="l01614"></a>01614   <span class="keywordflow">if</span>( !rej ) {
<a name="l01615"></a>01615     retval = dlg.key();
<a name="l01616"></a>01616   }
<a name="l01617"></a>01617 
<a name="l01618"></a>01618   <span class="keywordflow">return</span> retval;
<a name="l01619"></a>01619 }
<a name="l01620"></a>01620 
<a name="l01621"></a>01621 KeyIDList
<a name="l01622"></a>01622 Module::selectKeys( <span class="keyword">const</span> KeyList&amp; keys,
<a name="l01623"></a>01623                     <span class="keyword">const</span> QString&amp; title,
<a name="l01624"></a>01624                     <span class="keyword">const</span> QString&amp; text <span class="comment">/* = QString::null */</span> ,
<a name="l01625"></a>01625                     <span class="keyword">const</span> KeyIDList&amp; keyIds <span class="comment">/* = KeyIDList() */</span> ,
<a name="l01626"></a>01626                     <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> allowedKeys <span class="comment">/* = AllKeys */</span> )
<a name="l01627"></a>01627 {
<a name="l01628"></a>01628   KeyIDList retval = KeyIDList();
<a name="l01629"></a>01629 
<a name="l01630"></a>01630   KeySelectionDialog dlg( keys, title, text, keyIds, <span class="keyword">false</span>, allowedKeys,
<a name="l01631"></a>01631                           <span class="keyword">true</span> );
<a name="l01632"></a>01632 
<a name="l01633"></a>01633   QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l01634"></a>01634   <span class="keywordtype">bool</span> rej = ( dlg.exec() == QDialog::Rejected );
<a name="l01635"></a>01635   QApplication::restoreOverrideCursor();
<a name="l01636"></a>01636 
<a name="l01637"></a>01637   <span class="keywordflow">if</span>( !rej ) {
<a name="l01638"></a>01638     retval = dlg.keys();
<a name="l01639"></a>01639   }
<a name="l01640"></a>01640 
<a name="l01641"></a>01641   <span class="keywordflow">return</span> retval;
<a name="l01642"></a>01642 }
<a name="l01643"></a>01643 
<a name="l01644"></a>01644 
<a name="l01645"></a>01645 KeyID
<a name="l01646"></a>01646 Module::selectKey( <span class="keywordtype">bool</span>&amp; rememberChoice,
<a name="l01647"></a>01647                    <span class="keyword">const</span> KeyList&amp; keys,
<a name="l01648"></a>01648                    <span class="keyword">const</span> QString&amp; title,
<a name="l01649"></a>01649                    <span class="keyword">const</span> QString&amp; text <span class="comment">/* = QString::null */</span> ,
<a name="l01650"></a>01650                    <span class="keyword">const</span> KeyID&amp; keyId <span class="comment">/* = KeyID() */</span> ,
<a name="l01651"></a>01651                    <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> allowedKeys <span class="comment">/* = AllKeys */</span> )
<a name="l01652"></a>01652 {
<a name="l01653"></a>01653   KeyID retval = KeyID();
<a name="l01654"></a>01654 
<a name="l01655"></a>01655   KeySelectionDialog dlg( keys, title, text, KeyIDList( keyId ), <span class="keyword">false</span>,
<a name="l01656"></a>01656                           allowedKeys, <span class="keyword">false</span> );
<a name="l01657"></a>01657 
<a name="l01658"></a>01658   QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l01659"></a>01659   <span class="keywordtype">bool</span> rej = ( dlg.exec() == QDialog::Rejected );
<a name="l01660"></a>01660   QApplication::restoreOverrideCursor();
<a name="l01661"></a>01661 
<a name="l01662"></a>01662   <span class="keywordflow">if</span>( !rej ) {
<a name="l01663"></a>01663     retval = dlg.key();
<a name="l01664"></a>01664     rememberChoice = dlg.rememberSelection();
<a name="l01665"></a>01665   }
<a name="l01666"></a>01666   <span class="keywordflow">else</span> {
<a name="l01667"></a>01667     rememberChoice = <span class="keyword">false</span>;
<a name="l01668"></a>01668   }
<a name="l01669"></a>01669 
<a name="l01670"></a>01670   <span class="keywordflow">return</span> retval;
<a name="l01671"></a>01671 }
<a name="l01672"></a>01672 
<a name="l01673"></a>01673 KeyIDList
<a name="l01674"></a>01674 Module::selectKeys( <span class="keywordtype">bool</span>&amp; rememberChoice,
<a name="l01675"></a>01675                     <span class="keyword">const</span> KeyList&amp; keys,
<a name="l01676"></a>01676                     <span class="keyword">const</span> QString&amp; title,
<a name="l01677"></a>01677                     <span class="keyword">const</span> QString&amp; text <span class="comment">/* = QString::null */</span> ,
<a name="l01678"></a>01678                     <span class="keyword">const</span> KeyIDList&amp; keyIds <span class="comment">/* = KeyIDList() */</span> ,
<a name="l01679"></a>01679                     <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> allowedKeys <span class="comment">/* = AllKeys */</span> )
<a name="l01680"></a>01680 {
<a name="l01681"></a>01681   KeyIDList retval = KeyIDList();
<a name="l01682"></a>01682 
<a name="l01683"></a>01683   KeySelectionDialog dlg( keys, title, text, keyIds, <span class="keyword">true</span>, allowedKeys,
<a name="l01684"></a>01684                           <span class="keyword">true</span> );
<a name="l01685"></a>01685 
<a name="l01686"></a>01686   QApplication::setOverrideCursor( QCursor(QCursor::ArrowCursor) );
<a name="l01687"></a>01687   <span class="keywordtype">bool</span> rej = ( dlg.exec() == QDialog::Rejected );
<a name="l01688"></a>01688   QApplication::restoreOverrideCursor();
<a name="l01689"></a>01689 
<a name="l01690"></a>01690   <span class="keywordflow">if</span>( !rej ) {
<a name="l01691"></a>01691     retval = dlg.keys();
<a name="l01692"></a>01692     rememberChoice = dlg.rememberSelection();
<a name="l01693"></a>01693   }
<a name="l01694"></a>01694   <span class="keywordflow">else</span> {
<a name="l01695"></a>01695     rememberChoice = <span class="keyword">false</span>;
<a name="l01696"></a>01696   }
<a name="l01697"></a>01697 
<a name="l01698"></a>01698   <span class="keywordflow">return</span> retval;
<a name="l01699"></a>01699 }
<a name="l01700"></a>01700 
<a name="l01701"></a>01701 KeyIDList
<a name="l01702"></a>01702 Module::keysForAddress( <span class="keyword">const</span> QString&amp; address )
<a name="l01703"></a>01703 {
<a name="l01704"></a>01704   <span class="keywordflow">if</span>( address.isEmpty() ) {
<a name="l01705"></a>01705     <span class="keywordflow">return</span> KeyIDList();
<a name="l01706"></a>01706   }
<a name="l01707"></a>01707   QString addr = canonicalAddress( address ).lower();
<a name="l01708"></a>01708   <span class="keywordflow">if</span>( addressDataDict.contains( addr ) ) {
<a name="l01709"></a>01709     <span class="keywordflow">return</span> addressDataDict[addr].keyIds;
<a name="l01710"></a>01710   }
<a name="l01711"></a>01711   <span class="keywordflow">else</span> {
<a name="l01712"></a>01712     <span class="keywordflow">return</span> KeyIDList();
<a name="l01713"></a>01713   }
<a name="l01714"></a>01714 }
<a name="l01715"></a>01715 
<a name="l01716"></a>01716 <span class="keywordtype">void</span>
<a name="l01717"></a>01717 Module::setKeysForAddress( <span class="keyword">const</span> QString&amp; address, <span class="keyword">const</span> KeyIDList&amp; keyIds )
<a name="l01718"></a>01718 {
<a name="l01719"></a>01719   <span class="keywordflow">if</span>( address.isEmpty() ) {
<a name="l01720"></a>01720     <span class="keywordflow">return</span>;
<a name="l01721"></a>01721   }
<a name="l01722"></a>01722   QString addr = canonicalAddress( address ).lower();
<a name="l01723"></a>01723   <span class="keywordflow">if</span>( addressDataDict.contains( addr ) ) {
<a name="l01724"></a>01724     addressDataDict[addr].keyIds = keyIds;
<a name="l01725"></a>01725   }
<a name="l01726"></a>01726   <span class="keywordflow">else</span> {
<a name="l01727"></a>01727     AddressData data;
<a name="l01728"></a>01728     data.encrPref = UnknownEncryptPref;
<a name="l01729"></a>01729     data.keyIds = keyIds;
<a name="l01730"></a>01730     addressDataDict.insert( addr, data );
<a name="l01731"></a>01731   }
<a name="l01732"></a>01732 
<a name="l01733"></a>01733   <span class="comment">//writeAddressData();</span>
<a name="l01734"></a>01734 }
<a name="l01735"></a>01735 
<a name="l01736"></a>01736 <span class="keywordtype">void</span>
<a name="l01737"></a>01737 Module::readAddressData()
<a name="l01738"></a>01738 {
<a name="l01739"></a>01739   QString address;
<a name="l01740"></a>01740   AddressData data;
<a name="l01741"></a>01741 
<a name="l01742"></a>01742   KConfigGroup general( config, <span class="stringliteral">"General"</span> );
<a name="l01743"></a>01743   <span class="keywordtype">int</span> num = general.readNumEntry( <span class="stringliteral">"addressEntries"</span>, 0 );
<a name="l01744"></a>01744 
<a name="l01745"></a>01745   addressDataDict.clear();
<a name="l01746"></a>01746   <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i=1; i&lt;=num; i++ ) {
<a name="l01747"></a>01747     KConfigGroup addrGroup( config, QString(<span class="stringliteral">"Address #%1"</span>).arg(i).local8Bit() );
<a name="l01748"></a>01748     address = addrGroup.readEntry( <span class="stringliteral">"Address"</span> );
<a name="l01749"></a>01749     data.keyIds = KeyIDList::fromStringList( addrGroup.readListEntry( <span class="stringliteral">"Key IDs"</span> ) );
<a name="l01750"></a>01750     data.encrPref = (EncryptPref) addrGroup.readNumEntry( <span class="stringliteral">"EncryptionPreference"</span>,
<a name="l01751"></a>01751                                                           UnknownEncryptPref );
<a name="l01752"></a>01752 <span class="comment">//     kdDebug(5100) &lt;&lt; "Read address " &lt;&lt; i &lt;&lt; ": " &lt;&lt; address</span>
<a name="l01753"></a>01753 <span class="comment">//                   &lt;&lt; "\nKey IDs: 0x" &lt;&lt; data.keyIds.toStringList().join(", 0x")</span>
<a name="l01754"></a>01754 <span class="comment">//                   &lt;&lt; "\nEncryption preference: " &lt;&lt; data.encrPref &lt;&lt; endl;</span>
<a name="l01755"></a>01755     <span class="keywordflow">if</span> ( !address.isEmpty() ) {
<a name="l01756"></a>01756       addressDataDict.insert( address, data );
<a name="l01757"></a>01757     }
<a name="l01758"></a>01758   }
<a name="l01759"></a>01759 }
<a name="l01760"></a>01760 
<a name="l01761"></a>01761 <span class="keywordtype">void</span>
<a name="l01762"></a>01762 Module::writeAddressData()
<a name="l01763"></a>01763 {
<a name="l01764"></a>01764   KConfigGroup general( config, <span class="stringliteral">"General"</span> );
<a name="l01765"></a>01765   general.writeEntry( <span class="stringliteral">"addressEntries"</span>, addressDataDict.count() );
<a name="l01766"></a>01766 
<a name="l01767"></a>01767   <span class="keywordtype">int</span> i;
<a name="l01768"></a>01768   AddressDataDict::Iterator it;
<a name="l01769"></a>01769   <span class="keywordflow">for</span> ( i=1, it = addressDataDict.begin();
<a name="l01770"></a>01770         it != addressDataDict.end();
<a name="l01771"></a>01771         ++it, i++ ) {
<a name="l01772"></a>01772     KConfigGroup addrGroup( config, QString(<span class="stringliteral">"Address #%1"</span>).arg(i).local8Bit() );
<a name="l01773"></a>01773     addrGroup.writeEntry( <span class="stringliteral">"Address"</span>, it.key() );
<a name="l01774"></a>01774     addrGroup.writeEntry( <span class="stringliteral">"Key IDs"</span>, it.data().keyIds.toStringList() );
<a name="l01775"></a>01775     addrGroup.writeEntry( <span class="stringliteral">"EncryptionPreference"</span>, it.data().encrPref );
<a name="l01776"></a>01776   }
<a name="l01777"></a>01777 
<a name="l01778"></a>01778   config-&gt;sync();
<a name="l01779"></a>01779 }
<a name="l01780"></a>01780 
<a name="l01781"></a>01781 EncryptPref
<a name="l01782"></a>01782 Module::encryptionPreference( <span class="keyword">const</span> QString&amp; address )
<a name="l01783"></a>01783 {
<a name="l01784"></a>01784   QString addr = canonicalAddress( address ).lower();
<a name="l01785"></a>01785   <span class="keywordflow">if</span>( addressDataDict.contains( addr ) ) {
<a name="l01786"></a>01786     <span class="keywordflow">return</span> addressDataDict[addr].encrPref;
<a name="l01787"></a>01787   }
<a name="l01788"></a>01788   <span class="keywordflow">else</span> {
<a name="l01789"></a>01789     <span class="keywordflow">return</span> UnknownEncryptPref;
<a name="l01790"></a>01790   }
<a name="l01791"></a>01791 }
<a name="l01792"></a>01792 
<a name="l01793"></a>01793 <span class="keywordtype">void</span>
<a name="l01794"></a>01794 Module::setEncryptionPreference( <span class="keyword">const</span> QString&amp; address,
<a name="l01795"></a>01795                                  <span class="keyword">const</span> EncryptPref pref )
<a name="l01796"></a>01796 {
<a name="l01797"></a>01797   <span class="keywordflow">if</span>( address.isEmpty() ) {
<a name="l01798"></a>01798     <span class="keywordflow">return</span>;
<a name="l01799"></a>01799   }
<a name="l01800"></a>01800   QString addr = canonicalAddress( address ).lower();
<a name="l01801"></a>01801   <span class="keywordflow">if</span>( addressDataDict.contains( addr ) ) {
<a name="l01802"></a>01802     addressDataDict[addr].encrPref = pref;
<a name="l01803"></a>01803   }
<a name="l01804"></a>01804   <span class="keywordflow">else</span> {
<a name="l01805"></a>01805     AddressData data;
<a name="l01806"></a>01806     data.encrPref = pref;
<a name="l01807"></a>01807     addressDataDict.insert( addr, data );
<a name="l01808"></a>01808   }
<a name="l01809"></a>01809 }
<a name="l01810"></a>01810 
<a name="l01811"></a>01811 } <span class="comment">// namespace Kpgp</span>
</pre></div></div>
    </div></div>


      </td>
  </tr>
  <tr>
    <td valign="top" id="leftmenu" width="25%">
      <a name="navigation"></a>
      <div class="menu_box"><h2>libkpgp</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="functions.html">Class Members</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
  <option value="classKpgp_1_1Config.html">kpgp::config</option>,  <option value="classKpgp_1_1Key.html">kpgp::key</option>,  <option value="classKpgp_1_1PassphraseDialog.html">kpgp::passphrasedialog</option>,  <option value="classKpgp_1_1Subkey.html">kpgp::subkey</option>,  <option value="classKpgp_1_1UserID.html">kpgp::userid</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../akregator/html/index.html">akregator</a></li><li>&nbsp;&nbsp;<a href="../../akregator/src/html/index.html">src</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../akregator/src/librss/html/index.html">librss</a></li><li><a href="../../certmanager/html/index.html">certmanager</a></li><li>&nbsp;&nbsp;<a href="../../certmanager/lib/html/index.html">lib</a></li><li><a href="../../kaddressbook/html/index.html">kaddressbook</a></li><li><a href="../../kalarm/html/index.html">kalarm</a></li><li>&nbsp;&nbsp;<a href="../../kalarm/lib/html/index.html">lib</a></li><li><a href="../../kandy/html/index.html">kandy</a></li><li><a href="../../karm/html/index.html">karm</a></li><li><a href="../../kdgantt/html/index.html">kdgantt</a></li><li><a href="../../kgantt/html/index.html">kgantt</a></li><li><a href="../../kioslaves/html/index.html">kioslaves</a></li><li>&nbsp;&nbsp;<a href="../../kioslaves/imap4/html/index.html">imap4</a></li><li>&nbsp;&nbsp;<a href="../../kioslaves/mbox/html/index.html">mbox</a></li><li><a href="../../kitchensync/html/index.html">kitchensync</a></li><li><a href="../../kmail/html/index.html">kmail</a></li><li><a href="../../knotes/html/index.html">knotes</a></li><li><a href="../../konsolekalendar/html/index.html">konsolekalendar</a></li><li><a href="../../kontact/html/index.html">kontact</a></li><li><a href="../../korganizer/html/index.html">korganizer</a></li><li><a href="../../kpilot/html/index.html">kpilot</a></li><li>&nbsp;&nbsp;<a href="../../kpilot/kpilot/html/index.html">kpilot</a></li><li>&nbsp;&nbsp;<a href="../../kpilot/lib/html/index.html">lib</a></li><li><a href="../../libemailfunctions/html/index.html">libemailfunctions</a></li><li><a href="../../libkcal/html/index.html">libkcal</a></li><li><a href="../../libkdepim/html/index.html">libkdepim</a></li><li><a href="../../libkholidays/html/index.html">libkholidays</a></li><li><a href="../../libkmime/html/index.html">libkmime</a></li><li><a href="../../libkpgp/html/index.html">libkpgp</a></li><li><a href="../../libkpimidentities/html/index.html">libkpimidentities</a></li>
</ul></div></div>


        </td>
</tr>
</table>

<span class="doNotDisplay">
  <a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
  <a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
  <a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>


<div style="height: 8px"></div>

<div id="footer">
  <div id="footer_left">
    Maintained by <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;groo&#116;&#64;kde&#46;or&#x67;">Adriaan de Groot</a>
and
<a href="&#109;a&#105;&#108;&#116;&#111;&#58;w&#105;nter&#64;kde&#46;or&#x67">Allen Winter</a>.
<br/>
    KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
    <a href="http://www.kde.org/contact/impressum.php">Legal</a>
  </div>
  <div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>

<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->

</body>
</html>