Changeset 6ad69744


Ignore:
Timestamp:
Aug 24, 2014 11:11:56 PM (6 years ago)
Author:
zzz <zzz@…>
Branches:
master
Children:
2b9a368, 7bf1949
Parents:
34d37046
Message:

javadoc warnings about EdDSA raw sigs

File:
1 edited

Legend:

Unmodified
Added
Removed
  • core/java/src/net/i2p/crypto/DSAEngine.java

    r34d37046 r6ad69744  
    5353
    5454/**
    55  *  Sign and verify using DSA-SHA1.
    56  *  Also contains methods to sign and verify using a SHA-256 Hash, used by Syndie only.
     55 *  Sign and verify using DSA-SHA1 and other signature algorithms.
     56 *  Also contains methods to sign and verify using a SHA-256 Hash.
    5757 *
    5858 *  The primary implementation is code from TheCryto.
     
    6969 *  methods for the supported types. Methods encountering an unsupported type
    7070 *  will throw an IllegalArgumentException.
     71 *
     72 *  EdDSA support added in 0.9.15
    7173 */
    7274public class DSAEngine {
     
    8789
    8890    /**
    89      *  Verify using DSA-SHA1 or ECDSA.
     91     *  Verify using any sig type.
    9092     *  Uses TheCrypto code for DSA-SHA1 unless configured to use the java.security libraries.
    9193     */
     
    159161     *  Generic signature type.
    160162     *
     163     *  Warning, nonstandard for EdDSA, double-hashes, not recommended.
     164     *
    161165     *  @param hash SHA1Hash, Hash, Hash384, or Hash512
    162166     *  @since 0.9.9
     
    185189     *  which may be different than the ones defined in SigType.
    186190     *
     191     *  Warning, nonstandard for EdDSA, double-hashes, not recommended.
     192     *
    187193     *  @param hash SHA1Hash, Hash, Hash384, or Hash512
    188194     *  @param pubKey Java key
     
    332338    /**
    333339     *  Generic signature type.
     340     *
     341     *  Warning, nonstandard for EdDSA, double-hashes, not recommended.
    334342     *
    335343     *  @param hash SHA1Hash, Hash, Hash384, or Hash512
     
    358366     *  which may be different than the ones defined in SigType.
    359367     *
     368     *  Warning, nonstandard for EdDSA, double-hashes, not recommended.
     369     *
    360370     *  @param hash SHA1Hash, Hash, Hash384, or Hash512
    361371     *  @param privKey Java key
     
    493503
    494504    /**
    495      *  Generic verify DSA_SHA1, ECDSA, or RSA
     505     *  Generic verify any type.
     506     *
    496507     *  @throws GeneralSecurityException if algorithm unvailable or on other errors
    497508     *  @since 0.9.9 added off/len 0.9.12
     
    519530    /**
    520531     *  Generic raw verify any type
     532     *
     533     *  Warning, nonstandard for EdDSA, double-hashes, not recommended.
     534     *
    521535     *  @throws GeneralSecurityException if algorithm unvailable or on other errors
    522536     *  @since 0.9.9
     
    536550     *  If you have a Java pubkey, use this, so you don't lose the key parameters,
    537551     *  which may be different than the ones defined in SigType.
     552     *
     553     *  Warning, nonstandard for EdDSA, double-hashes, not recommended.
    538554     *
    539555     *  @throws GeneralSecurityException if algorithm unvailable or on other errors
     
    580596
    581597    /**
    582      *  Generic sign DSA_SHA1, ECDSA, or RSA
     598     *  Generic sign any type.
     599     *
    583600     *  @throws GeneralSecurityException if algorithm unvailable or on other errors
    584601     *  @since 0.9.9 added off/len 0.9.12
     
    602619
    603620    /**
    604      *  Generic raw verify any type
     621     *  Generic raw sign any type.
     622     *
     623     *  Warning, nonstandard for EdDSA, double-hashes, not recommended.
     624     *
    605625     *  @param hash SHA1Hash, Hash, Hash384, or Hash512
    606626     *  @throws GeneralSecurityException if algorithm unvailable or on other errors
     
    615635
    616636    /**
    617      *  Generic raw verify any type
     637     *  Generic raw sign any type.
     638     *
     639     *  Warning, nonstandard for EdDSA, double-hashes, not recommended.
     640     *
    618641     *  @param hash SHA1Hash, Hash, Hash384, or Hash512
    619642     *  @param type returns a Signature of this type
Note: See TracChangeset for help on using the changeset viewer.