doc: split PKCS 11 table by key size

doc/appendices.rst

@@ -12,51 +12,100 @@ Compatible PKCS #11 Devices
 
 This section has informative character. Knot DNS has been tested with several
 devices which claim to support PKCS #11 interface. The following table
-indicates which algorithms and operations have been seen to work. Please notice
-minimal GnuTLS library version required for particular algorithm support.
+indicates which algorithms and operations have been observed to work. Please
+notice minimal GnuTLS library version required for particular algorithm
+support.
+
+.. |yes| replace:: **yes**
+.. |no| replace:: no
+.. |unknown| replace:: ?
 
 .. list-table::
    :header-rows: 1
    :stub-columns: 1
 
    * -
-     - ECDSA [#ecdsa]_
-     - RSA [#rsa]_
-     - DSA [#dsa]_
-     - key import
-     - key generation
-   * - `SoftHSM <https://www.opendnssec.org/softhsm/>`_ 2.0
-     - yes
-     - yes
-     - yes
-     - yes
-     - yes
-   * - `Luna SA (SafeNet Network HSM) <http://www.safenet-inc.com/data-encryption/hardware-security-modules-hsms/luna-hsms-key-management/luna-sa-network-hsm/>`_
-     - **no**
-     - yes
-     - yes
-     - yes
-     - **no**
+     - Key generate
+     - Key import
+     - ECDSA 256-bit
+     - ECDSA 384-bit
+     - RSA 1024-bit
+     - RSA 2048-bit
+     - RSA 4096-bit
+     - DSA 512-bit
+     - DSA 1024-bit
+   * - `SoftHSM 2.0 <https://www.opendnssec.org/softhsm/>`_
+     - |yes|
+     - |yes|
+     - |yes|
+     - |yes|
+     - |yes|
+     - |yes|
+     - |yes|
+     - |yes|
+     - |yes|
+   * - `SafeNet Network HSM (Luna) <http://www.safenet-inc.com/data-encryption/hardware-security-modules-hsms/luna-hsms-key-management/luna-sa-network-hsm/>`_
+     - |yes|
+     - |no|
+     - |no|
+     - |no|
+     - |yes|
+     - |yes|
+     - |yes|
+     - |unknown|
+     - |unknown|
+   * - `Feitian ePass 2003 <http://www.ftsafe.com/product/epass/epass2003>`_
+     - |yes|
+     - |no|
+     - |no|
+     - |no|
+     - |yes|
+     - |yes|
+     - |no|
+     - |no|
+     - |no|
+
 .. in progress
    * - `Trustway Proteccio NetHSM <http://www.bull.com/fr/cybers%C3%A9curit%C3%A9-trustway-proteccio-nethsm>`_
-     - ?
-     - ?
-     - ?
-     - ?
-     - ?
-   * - ePass 2003
-     - ?
-     - ?
-     - ?
-     - ?
-     - ?
-   * - Yubikey Neo
-     - ?
-     - ?
-     - ?
-     - ?
-     - ?
-
-.. [#ecdsa] DNSSEC algorithm 13. Requires GnuTLS 3.4.8 or newer.
-.. [#rsa]   DNSSEC algorithms 5, 7, 8, and 10. Requires GnuTLS 3.4.6 or newer.
-.. [#dsa]   DNSSEC algorithms 3 and 6. Requries GnuTLS 3.4.10 or newer.
+     - |unknown|
+     - |unknown|
+     - |unknown|
+     - |unknown|
+     - |unknown|
+     - |unknown|
+     - |unknown|
+     - |unknown|
+     - |unknown|
+
+.. in progress: works with small hacks, only one key possible
+   * - `Yubikey NEO <https://www.yubico.com/products/yubikey-hardware/yubikey-neo/>`_
+     - |no|
+     - |no|
+     - |yes|
+     - |yes|
+     - |yes|
+     - |yes|
+     - |no|
+     - |no|
+     - |no|
+
+The following table summarizes supported DNSSEC algorithm numbers and minimal
+GnuTLS library version required. Any algorithm may work with older library,
+however the supported operations may be limited (e.g. private key import).
+
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+
+   * -
+     - `Numbers <https://www.iana.org/assignments/dns-sec-alg-numbers/dns-sec-alg-numbers.xhtml#dns-sec-alg-numbers-1>`_
+     - GnuTLS version
+   * - ECDSA
+     - 13, 14
+     - 3.4.8 or newer
+   * - RSA
+     - 5, 7, 8, 10
+     - 3.4.6 or newer
+   * - DSA
+     - 3, 6
+     - 3.4.10 or newer