diff options
author | Jack Lloyd <[email protected]> | 2016-11-28 20:48:11 -0500 |
---|---|---|
committer | Jack Lloyd <[email protected]> | 2016-11-28 20:49:04 -0500 |
commit | 1e53889e902cbd1ad95cde529be5ae7903d30482 (patch) | |
tree | be26357fc7117b0bb8e7876efb07c67124b035f7 | |
parent | 9a8ec147287ab07fac3ee3d918f508da920c30c8 (diff) | |
parent | f633344890006ffeeadf5aedcf3e7ee4d81d12ab (diff) |
Merge GH #742 Add note on RFC 6979
[ci skip]
-rw-r--r-- | doc/manual/index.rst | 4 | ||||
-rw-r--r-- | doc/manual/pubkey.rst | 12 | ||||
-rw-r--r-- | src/build-data/sphinx/conf.py | 6 |
3 files changed, 17 insertions, 5 deletions
diff --git a/doc/manual/index.rst b/doc/manual/index.rst index 1bfc01d30..42f3bceb6 100644 --- a/doc/manual/index.rst +++ b/doc/manual/index.rst @@ -8,3 +8,7 @@ References ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The :ref:`genindex` and :ref:`search` may be useful. + +.. toctree:: + :maxdepth: 1 + :numbered: diff --git a/doc/manual/pubkey.rst b/doc/manual/pubkey.rst index bf47b631d..f401d3512 100644 --- a/doc/manual/pubkey.rst +++ b/doc/manual/pubkey.rst @@ -47,7 +47,7 @@ like key agreement, the two keys *must* use the same group. There are currently two kinds of discrete logarithm groups supported in botan: the integers modulo a prime, represented by :ref:`dl_group`, and elliptic curves in GF(p), represented by :ref:`ec_group`. A rough generalization is that the -larger the group is, the more secure the algorithm is, but coorespondingly the +larger the group is, the more secure the algorithm is, but correspondingly the slower the operations will be. Given a ``DL_Group``, you can create new DSA, Diffie-Hellman, and @@ -71,7 +71,7 @@ Nyberg-Rueppel key pairs with :ref:`pbkdf` for how to do that) as a private key value. Normally, you would leave the value as zero, letting the class generate a new random key. -Finally, given an ``EC_Group`` object, you can create a new ECDSA, +Finally, given an ``EC_Group`` object, you can create a new ECDSA, ECKCDSA, ECGDSA, ECDH, or GOST 34.10-2001 private key with .. cpp:function:: ECDSA_PrivateKey::ECDSA_PrivateKey(RandomNumberGenerator& rng, \ @@ -467,6 +467,14 @@ Signature generation is performed using 34.10-2001, Nyberg-Rueppel, and Rabin-Williams. Other signature schemes may be supported in the future. + .. note:: + + Botan both supports non-deterministic and deterministic (as per RFC + 6979) DSA and ECDSA signatures. Deterministic signatures are compatible + in the way that they can be verified with a non-deterministic implementation. + If the ``rfc6979`` module is enabled, deterministic DSA and ECDSA signatures + will be generated. + Currently available values for *emsa* include EMSA1, EMSA2, EMSA3, EMSA4, and Raw. All of them, except Raw, take a parameter naming a message digest function to hash the message with. The Raw encoding signs the diff --git a/src/build-data/sphinx/conf.py b/src/build-data/sphinx/conf.py index e144944f3..d08bb1d57 100644 --- a/src/build-data/sphinx/conf.py +++ b/src/build-data/sphinx/conf.py @@ -59,7 +59,7 @@ source_encoding = 'utf-8-sig' master_doc = 'contents' project = u'botan' -copyright = u'2000-2014, Jack Lloyd' +copyright = u'2000-2016, Jack Lloyd' version = '%d.%d' % (botan_version.release_major, botan_version.release_minor) @@ -198,8 +198,8 @@ htmlhelp_basename = 'botandoc' # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, author, documentclass [howto/manual]). latex_documents = [ - ('contents', 'botan.tex', u'botan Reference Manual', - u'Jack Lloyd', 'manual'), + ('contents', 'botan.tex', u'Botan Reference Manual', + u'Jack Lloyd \\and Daniel Neus \\and René Korthaus \\and Juraj Somorovsky \\and Tobias Niemann', 'manual'), ] # The name of an image file (relative to this directory) to place at the top of |