summaryrefslogtreecommitdiff
path: root/src-cryptopp/TestVectors/Readme.txt
diff options
context:
space:
mode:
authorMicah Anderson <micah@riseup.net>2013-08-22 16:39:52 -0400
committerMicah Anderson <micah@riseup.net>2013-08-22 16:39:52 -0400
commit5e60e0e3af85f22aa0afe8bf0ecf85619afacfeb (patch)
tree6a91a3de86fa8de0b4167cc947ab72991bf8da31 /src-cryptopp/TestVectors/Readme.txt
parent30e9097985656920f01a72efc1088caa2b8d41b3 (diff)
Imported Upstream version 0.6.0.12upstream/0.6.0.12
Diffstat (limited to 'src-cryptopp/TestVectors/Readme.txt')
-rw-r--r--src-cryptopp/TestVectors/Readme.txt72
1 files changed, 72 insertions, 0 deletions
diff --git a/src-cryptopp/TestVectors/Readme.txt b/src-cryptopp/TestVectors/Readme.txt
new file mode 100644
index 0000000..755a046
--- /dev/null
+++ b/src-cryptopp/TestVectors/Readme.txt
@@ -0,0 +1,72 @@
+Test Data Format
+
+A test data file is an ASCII text file composed of sections separated by
+blank lines. Each section is stand-alone and independent of other
+sections that may be in the same file, and contains one or more tests.
+
+A section is composed of a sequence of fields. Each field is one or more
+lines composed of a field name, followed by a colon (":"), followed by a
+field body. All but the last line of a field must end with a backslash
+("\"). If any line contains a hash mark ("#"), the hash mark and
+everything after it on the same line is not considered part of the field
+body.
+
+Each section must contain fields named AlgorithmType, Name, Source, and
+Test. The presence and semantics of other fields depend on the algorithm
+being tested and the tests to be run.
+
+Each section may contain more than one test and therefore more than one
+field named Test. In that case the order of the fields is significant. A
+test should always use the last field with any given name that occurs
+before the Test field.
+
+Data Types
+
+int - small integer (less than 2^32) in decimal representation
+string - human readable string
+encoded string - can be one of the following
+ - quoted string: "message" means "message" without the quotes
+ or terminating '\0'
+ - hex encoded string: 0x74657374 or 74657374 means "test"
+ - repeated string: r100 "message" to repeat "message" 100 times, or
+ r256 0x0011 to repeat 0x0011 256 times
+
+Field Types
+
+AlgorithmType - string, for example "Signature", "AsymmetricCipher",
+"SymmetricCipher", "MAC", "MessageDigest", or "KeyFactory"
+Name - string, an algorithm name from SCAN
+Test - string, identifies the test to run
+Source - string, text explaining where the test data came from
+Comment - string, other comments about the test data
+KeyFormat - string, specifies the key format. "Component" here means
+each component of the key or key pair is specified separately as a name,
+value pair, with the names depending on the algorithm being tested.
+Otherwise the value names "Key", or "PublicKey" and "PrivateKey" are
+used.
+Key - encoded string
+PublicKey - encoded string
+PrivateKey - encoded string
+Message - encoded string, message to be signed or verified
+Signature - encoded string, signature to be verified or compared
+with
+Plaintext - encoded string
+Ciphertext - encoded string
+Digest - encoded string
+TruncatedSize - int, size of truncated digest in bytes
+Seek - int, seek location for random access ciphers
+(more to come here)
+
+Possible Tests
+
+KeyPairValidAndConsistent - public and private keys are both valid and
+consistent with each other
+PublicKeyInvalid - public key validation should not pass
+PrivateKeyInvalid - private key validation should not pass
+Verify - signature/digest/MAC verification should pass
+VerifyTruncated - truncated digest/MAC verification should pass
+NotVerify - signature/digest/MAC verification should not pass
+DeterministicSign - sign message using given seed, and the resulting
+signature should be equal to the given signature
+DecryptMatch - ciphertext decrypts to plaintext
+(more to come here)