~ubuntu-branches/ubuntu/wily/qca2/wily-proposed

« back to all changes in this revision

Viewing changes to apidocs/html/providers.html

  • Committer: Bazaar Package Importer
  • Author(s): Jan Niehusmann
  • Date: 2007-10-27 18:51:54 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20071027185154-4ir9ys3h2q9fofrw
Tags: 2.0.0-2
Upload to unstable

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
 
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3
3
<title>Qt Cryptographic Architecture: Providers</title>
4
4
<link href="doxygen.css" rel="stylesheet" type="text/css">
5
5
<link href="tabs.css" rel="stylesheet" type="text/css">
6
6
</head><body>
7
 
<!-- Generated by Doxygen 1.4.6 -->
 
7
<!-- Generated by Doxygen 1.5.2 -->
8
8
<div class="tabs">
9
9
  <ul>
10
10
    <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
 
11
    <li><a href="modules.html"><span>Modules</span></a></li>
11
12
    <li><a href="namespaces.html"><span>Namespaces</span></a></li>
12
13
    <li><a href="annotated.html"><span>Classes</span></a></li>
13
14
    <li><a href="files.html"><span>Files</span></a></li>
14
15
    <li><a href="dirs.html"><span>Directories</span></a></li>
15
16
    <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
16
17
    <li><a href="examples.html"><span>Examples</span></a></li>
17
 
  </ul></div>
 
18
  </ul>
 
19
</div>
18
20
<h1><a class="anchor" name="providers">Providers</a></h1>QCA works on the concept of a "provider".<p>
19
21
There is a limited internal provider (named "default"), but most of the work is done in plugin modules.<p>
20
22
The logic to selection of a provider is fairly simple. The user can specify a provider name - if that name exists, and the provider supports the requested feature, then the named provider is used. If that didn't work, then the available plugins are searched (based on a priority order) for the requested feature. If that doesn't work, then the default provider is searched for the requested feature.<p>
21
23
So the only way to get the default provider is to either have no other support whatsoever, or to specify the default provider directly (this goes for the algorithm constructors as well as setGlobalRNG()).<p>
22
24
You can add your own provider in two ways - as a shared object plugin, and as a part of the client code.<p>
23
25
The shared object plugin needs to be able to be found using the built-in scan logic - this normally means you need to install it into the plugins/crypto subdirectory within the directory that Qt is installed to. This will make it available for all applications.<p>
24
 
If you have a limited application domain (such as a specialist algorithm, or a need to be bug-compatible), you may find it easier to create a client-side provider, and add it using the <a class="el" href="namespaceQCA.html#62a0e1e519e664e2db003c14715f1125">QCA::insertProvider</a> call. There is an example of this - see <a href="aes-cmac_8cpp-example.html">the AES-CMAC example</a>. <hr size="1"><address style="align: right;"><small>Generated on Fri Jul 6 12:14:33 2007 for Qt Cryptographic Architecture by&nbsp;
 
26
If you have a limited application domain (such as a specialist algorithm, or a need to be bug-compatible), you may find it easier to create a client-side provider, and add it using the <a class="el" href="namespaceQCA.html#62a0e1e519e664e2db003c14715f1125" title="Add a provider to the current list of providers.">QCA::insertProvider</a> call. There is an example of this - see <a href="aes-cmac_8cpp-example.html">the AES-CMAC example</a>. <hr size="1"><address style="text-align: right;"><small>Generated on Thu Sep 6 19:13:57 2007 for Qt Cryptographic Architecture by&nbsp;
25
27
<a href="http://www.doxygen.org/index.html">
26
 
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.6 </small></address>
 
28
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.2 </small></address>
27
29
</body>
28
30
</html>