aboutsummaryrefslogtreecommitdiffstats
path: root/docs/hazmat/backends
diff options
context:
space:
mode:
authorPaul Kehrer <paul.l.kehrer@gmail.com>2014-06-27 14:07:59 -0600
committerPaul Kehrer <paul.l.kehrer@gmail.com>2014-06-27 14:07:59 -0600
commit298effd54c11ed47077f580f74d9204f7acce3f5 (patch)
tree107f5a5ee3d0ae4a6efe6dae93511356e7425b65 /docs/hazmat/backends
parentdacb5f9951064d19ac69c1198985af136f71a6db (diff)
downloadcryptography-298effd54c11ed47077f580f74d9204f7acce3f5.tar.gz
cryptography-298effd54c11ed47077f580f74d9204f7acce3f5.tar.bz2
cryptography-298effd54c11ed47077f580f74d9204f7acce3f5.zip
rename backend method, add some docs
Diffstat (limited to 'docs/hazmat/backends')
-rw-r--r--docs/hazmat/backends/interfaces.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/hazmat/backends/interfaces.rst b/docs/hazmat/backends/interfaces.rst
index 5cbd47d1..fea935ce 100644
--- a/docs/hazmat/backends/interfaces.rst
+++ b/docs/hazmat/backends/interfaces.rst
@@ -421,6 +421,22 @@ A specific ``backend`` may provide one or more of these interfaces.
1.0.0 and the key size is larger than 1024; older OpenSSL versions
do not support keys larger than 1024 bits.
+ .. method:: generate_dsa_private_key_and_parameters(key_size)
+
+ :param int key_size: The length of the modulus in bits. It should be
+ either 1024, 2048 or 3072. For keys generated in 2014 this should
+ be at least 2048.
+ Note that some applications (such as SSH) have not yet gained
+ support for larger key sizes specified in FIPS 186-3 and are still
+ restricted to only the 1024-bit keys specified in FIPS 186-2.
+
+ :return: A new instance of a
+ :class:`~cryptography.hazmat.primitives.interfaces.DSAPrivateKey`
+ provider.
+
+ :raises ValueError: This is raised if the key size is not supported
+ by the backend.
+
.. method:: create_dsa_signature_ctx(private_key, algorithm)
:param private_key: An instance of a