|
Server : Apache/2.2.2 (Fedora) System : Linux App1.pathumtani.go.th 2.6.20-1.2320.fc5smp #1 SMP Tue Jun 12 19:40:16 EDT 2007 i686 User : apache ( 48) PHP Version : 5.2.9 Disable Function : NONE Directory : /usr/share/javadoc/cryptix-3.2.0/xjava/security/interfaces/ |
Upload File : |
<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE html PUBLIC "-//gnu.org///DTD XHTML 1.1 plus Target 1.0//EN" "../../../resources/xhtml11-target10.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><title>ElGamalKeyPairGenerator (cryptix JavaDoc)</title><script src="../../../resources/gjdoc.js" type="text/javascript"><!-- this comment required for konqueror 3.2.2 --></script><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"/><meta name="generator" content="GNU Gjdoc Standard Doclet"/><meta name="keywords" content="xjava.security.interfaces.ElGamalKeyPairGenerator class"/><meta name="keywords" content="initialize()"/><meta name="keywords" content="generateParams()"/><link rel="stylesheet" type="text/css" href="../../../resources/gjdochtml-clean-layout.css" title="GNU Clean"/><link rel="stylesheet" type="text/css" href="../../../resources/gjdochtml-clean-color1.css" title="GNU Clean"/></head><body class="content class" onload="if(parent.contentPageLoaded)parent.contentPageLoaded(document.title)"><table class="navbar div top"><tr><td class="navbar div top"><div class="navbar div top"><span class="navbar item enabled"><a href="../../../overview-summary.html">Overview</a></span> <span class="navbar item enabled"><a href="package-summary.html">Package</a></span> <span class="navbar item enabled"><a href="tree.html">Tree</a></span> <span class="navbar item enabled"><a href="../../../alphaindex.html">Index</a></span> <span class="navbar item enabled"><a href="../../../deprecated.html">Deprecated</a></span> <span class="navbar item enabled"><a href="../../../about.html">About</a></span></div></td></tr><tr><td class="navi"><a href="../../../xjava/security/interfaces/ElGamalKey.html">Prev Class</a> | <a href="../../../xjava/security/interfaces/ElGamalParams.html">Next Class</a></td><td class="navi"><a href="../../../index.html" title="Show in a frameset" target="_top">Frames</a> | <a href="ElGamalKeyPairGenerator.html" title="Show without frames" target="_top">No Frames</a> </td></tr><tr><td class="navi">Summary: Nested | Field | <a href="#summary-methods">Method</a> | Constr</td><td class="navi">Detail: Nested | Field | <a href="#detail-methods">Method</a> | Constr</td></tr></table><div class="class title outer"><h3 class="class title-package">xjava.security.interfaces</h3><h1 class="class title-class">Interface ElGamalKeyPairGenerator</h1></div><dl class="class knownimplementing"><dt class="header"><b>Known Implementing Classes:</b></dt><dd class="item"><a href="../../../cryptix/provider/elgamal/BaseElGamalKeyPairGenerator.html" title="Class in cryptix.provider.elgamal">BaseElGamalKeyPairGenerator</a></dd></dl><hr/><div class="class synopsis outer"><div class="class synopsis declaration"><code>public interface <b class="class synopsis name">ElGamalKeyPairGenerator</b></code></div></div><hr/><div class="class description"> An interface to an object capable of generating ElGamal key pairs. The
generator is first initialized, then used to generate one or more
key pairs.
<p/>
Users wishing to indicate the prime or base, and to generate a key
pair suitable for use with the ElGamal signature or encryption algorithms
typically
<ol><li> Get a key pair generator for the ElGamal algorithms by calling the
KeyPairGenerator <code>getInstance</code> method with "ElGamal"
as its argument.<p/>
</li><li> Initialize the generator by casting the result to an
ElGamalKeyPairGenerator and calling one of the <code>initialize</code>
methods from this ElGamalKeyPairGenerator interface.<p/>
</li><li> Generate one or more key pairs by calling the
<code>generateKeyPair</code> method from the KeyPairGenerator
class, as often as desired.
</li></ol>
<p/>
Note: it is not always necessary to do algorithm-specific
initialization for an ElGamal key pair generator. That is, it is not always
necessary to call one of the <code>initialize</code> methods in this
interface.
Algorithm-independent initialization using the <code>initialize</code>
method in the KeyPairGenerator interface is all that is needed when you
accept defaults for algorithm-specific parameters.
<p/><b>$Revision: 1.2 $</b>
</div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>Author:</b></dt><dd class="tag item">David Hopwood</dd></dl></div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>Since:</b></dt><dd>IJCE 1.0.1</dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>See Also:</b></dt><dd><code>java.security.KeyPairGenerator</code></dd></dl></div><div class="taglet"></div><div class="taglet"></div><a name="summary-methods" id="summary-methods"/><dl class="table container"><dd><table class="class summary" border="1" width="100%"><tr class="table header"><td colspan="2"><h2 class="table header">Method Summary</h2></td></tr><tr><td class="left" valign="top"><code class="synopsis"> <a href="../../../xjava/security/interfaces/ElGamalParams.html" title="Interface in xjava.security.interfaces">ElGamalParams</a></code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#generateParams(int,SecureRandom)">generateParams</a>(int primeLen, SecureRandom random)</code></dt><dd class="description"> Generates new parameters, <i>p</i> and <i>g</i>.</dd></dl></td></tr><tr><td class="left" valign="top"><code class="synopsis"> void</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#initialize(BigInteger,BigInteger,SecureRandom)">initialize</a>(BigInteger prime, BigInteger base, SecureRandom random)</code></dt><dd class="description"> Initializes the key pair generator using the specified prime and
base.</dd></dl></td></tr><tr><td class="left" valign="top"><code class="synopsis"> void</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#initialize(int,boolean,SecureRandom)">initialize</a>(int primeLen, boolean genParams, SecureRandom random)</code></dt><dd class="description"> Initializes the key pair generator for a given prime length,
without parameters.</dd></dl></td></tr><tr><td class="left" valign="top"><code class="synopsis"> void</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#initialize(xjava.security.interfaces.ElGamalParams,SecureRandom)">initialize</a>(<a href="../../../xjava/security/interfaces/ElGamalParams.html" title="Interface in xjava.security.interfaces">ElGamalParams</a> params, SecureRandom random)</code></dt><dd class="description"> Initializes the key pair generator using the prime and base from
the specified ElGamalParams object.</dd></dl></td></tr></table></dd></dl><a name="detail-methods" id="detail-methods"/><h2 class="section header">Method Details</h2><div class="section"><a name="generateParams(int,SecureRandom)" id="generateParams(int,SecureRandom)"/><div class="member detail outer"><h3 class="member detail name">generateParams</h3><pre class="member detail synopsis">public <a href="../../../xjava/security/interfaces/ElGamalParams.html" title="Interface in xjava.security.interfaces">ElGamalParams</a> generateParams(int primeLen,
SecureRandom random)
throws InvalidParameterException</pre><blockquote class="member detail name"><div class="member detail description"> Generates new parameters, <i>p</i> and <i>g</i>. This method
does not change the parameters currently being used by
<code>generateKeyPair</code>.
</div><div class="parameter"><dl><dt class="header"><b>Parameters:</b></dt><dd class="item"><code class="name">primeLen</code><span class="separator"> - </span><span class="description">the prime length, in bits. Valid lengths are any
integer >= 512.</span></dd><dd class="item"><code class="name">random</code><span class="separator"> - </span><span class="description">the random bit source to use to generate the parameters.</span></dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div><hr/><a name="initialize(BigInteger,BigInteger,SecureRandom)" id="initialize(BigInteger,BigInteger,SecureRandom)"/><div class="member detail outer"><h3 class="member detail name">initialize</h3><pre class="member detail synopsis">public void initialize(BigInteger prime,
BigInteger base,
SecureRandom random)
throws InvalidParameterException</pre><blockquote class="member detail name"><div class="member detail description"> Initializes the key pair generator using the specified prime and
base. The difficulty of cracking ElGamal by solving the discrete
logarithm problem is dependent on the length of the prime. An
InvalidParameterException will be thrown if the base is not less
than the prime.
</div><div class="parameter"><dl><dt class="header"><b>Parameters:</b></dt><dd class="item"><code class="name">prime</code><span class="separator"> - </span><span class="description">the prime to be used, as a java.math.BigInteger</span></dd><dd class="item"><code class="name">base</code><span class="separator"> - </span><span class="description">the base to be used, as a java.math.BigInteger</span></dd><dd class="item"><code class="name">random</code><span class="separator"> - </span><span class="description">the random bit source to use to generate
key bits.</span></dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div><hr/><a name="initialize(int,boolean,SecureRandom)" id="initialize(int,boolean,SecureRandom)"/><div class="member detail outer"><h3 class="member detail name">initialize</h3><pre class="member detail synopsis">public void initialize(int primeLen,
boolean genParams,
SecureRandom random)
throws InvalidParameterException</pre><blockquote class="member detail name"><div class="member detail description"> Initializes the key pair generator for a given prime length,
without parameters.
<p/>
If <i>genParams</i> is true, this method will generate new
p and g parameters. If it is false, the method will use precomputed
parameters for the prime length requested. If there are no
precomputed parameters for that prime length, an exception will be
thrown. It is guaranteed that there will always be default
parameters for prime lengths of 513, 1025, 1537 and 2049 bits.
</div><div class="parameter"><dl><dt class="header"><b>Parameters:</b></dt><dd class="item"><code class="name">primeLen</code><span class="separator"> - </span><span class="description">the prime length, in bits. Valid lengths are any
integer >= 512.</span></dd><dd class="item"><code class="name">genParams</code><span class="separator"> - </span><span class="description">whether to generate new parameters for the prime
length requested.</span></dd><dd class="item"><code class="name">random</code><span class="separator"> - </span><span class="description">the random bit source to use to generate
key bits.</span></dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div><hr/><a name="initialize(xjava.security.interfaces.ElGamalParams,SecureRandom)" id="initialize(xjava.security.interfaces.ElGamalParams,SecureRandom)"/><div class="member detail outer"><h3 class="member detail name">initialize</h3><pre class="member detail synopsis">public void initialize(<a href="../../../xjava/security/interfaces/ElGamalParams.html" title="Interface in xjava.security.interfaces">ElGamalParams</a> params,
SecureRandom random)
throws InvalidParameterException</pre><blockquote class="member detail name"><div class="member detail description"> Initializes the key pair generator using the prime and base from
the specified ElGamalParams object.
</div><div class="parameter"><dl><dt class="header"><b>Parameters:</b></dt><dd class="item"><code class="name">params</code><span class="separator"> - </span><span class="description">the parameters to use to generate the keys.</span></dd><dd class="item"><code class="name">random</code><span class="separator"> - </span><span class="description">the random bit source to use to generate
key bits.</span></dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div></div><p class="navbar bottom spacer"> </p><table class="navbar div bottom"><tr><td><div class="navbar div top"><span class="navbar item enabled"><a href="../../../overview-summary.html">Overview</a></span> <span class="navbar item enabled"><a href="package-summary.html">Package</a></span> <span class="navbar item enabled"><a href="tree.html">Tree</a></span> <span class="navbar item enabled"><a href="../../../alphaindex.html">Index</a></span> <span class="navbar item enabled"><a href="../../../deprecated.html">Deprecated</a></span> <span class="navbar item enabled"><a href="../../../about.html">About</a></span></div></td></tr></table></body></html>