-
Notifications
You must be signed in to change notification settings - Fork 9
Config file structure
Dušan Klinec edited this page Jul 25, 2019
·
6 revisions
Exemplary config file:
{
"notes" : "AES three rounds with basic setup",
"file_name": "optional/output/file_name.bin",
"seed" : "1fe40505e131963c",
"tv_size" : 16,
"tv_count" : 1000,
"stream" : {
"type" : "block",
"generator" : "pcg32",
"init_frequency" : "only_once",
"algorithm" : "AES",
"round" : 3,
"block_size" : 16,
"plaintext" : {
"type" : "counter"
},
"key_size" : 16,
"key" : {
"type" : "pcg32_stream"
},
"mode" : "ECB",
"iv" : {
"type" : "false_stream"
}
}
}
Stream-specific settings are added separate subtrees linked to the root element. Their structure is described in stream documentation.
-
notes
developer notes (only descriptive) -
file_name
spocify desired output file name -
seed
hexadecimal string value of seed to use. CryptoStreams have to be seeded with 64-bits values, i.e."1fe40505e131963c"
(which is our default seed).
seed value can benull
for random seed computations (common settings, if you do not need experiment reproduction) -
tv_size
number of test vectors in a test set (per set) -
stream
contains description of the stream, for more details, continue to streams documentation
Trivial source-only streams
dummy_stream
file_stream
true_stream
false_stream
const_stream
mt19937_stream
pcg32_stream
counter
random_start_counter
sac
sac_fixed_position
sac_2d_all_positions
hw_counter
Sources with statistical distribution
bernoulli_distribution
binomial_distribution
normal_distribution
poisson_distribution
exponential_distribution
Modifiers -- streams that has other stream as an input (but are used as source before cipher)
single_value_stream
repeating_stream
tuple_stream
Pipes
pipe_in_stream
pipe_out_stream
Postprocessing modifiers -- streams that has cipher stream as an input
xor_stream
column
column_fixed_position
Getting started
Building notes
Running notes
Recommended scenarios
Configuration file structure
Developer notes
Framework components
Submodules
Third party libraries
Coding guide
Testing
Known bugs
User notes
List of streams
Block ciphers
Stream ciphers
Hash functions
PRNGs
WIP CAESAR
Useful links