sam.core
Class Settings.Constants.Key

java.lang.Object
  |
  +--sam.core.Settings.Constants.Key
Enclosing class:
Settings.Constants

public static class Settings.Constants.Key
extends java.lang.Object

Central repository of settings related to cipher keys.

See Also:
Key

Field Summary
static boolean ALWAYS_SILENT
          Wether to be totally silent about key material.
static boolean IGNORE_EMPTY
          Wether to discard ciphers whose Key is empty.
static boolean LOG_EXPANSIONS
          Wether to issue a log whenever a key is turncated to match a ciphers specific key size.
static boolean LOG_KEY_INSTANTIATION
          Wether to issue a log whenever a new key is created.
static boolean LOG_KEY_MATERIAL_LENGTH
          Wether to include effective key material length while logging key instantiation.
static boolean LOG_TRUNCATIONS
          Wether to issue a log whenever a key is turncated to match a ciphers specific key size.
static boolean WARN_EMPTY
          Wether to issue a warning if a key is built empty.
static boolean WARN_EXPANSIONS
          Wether to issue a warning whenever a key is turncated to match a ciphers specific key size.
static boolean WARN_SUBCLASSES_INVERSION
          Wether to issue a warning whenever a sam.cipher.Key subclass is inversed through the sam.cipher.Key.inverse() method which returns an new instance of sam.cipher.Key instead of the subclass.
static boolean WARN_TRUNCATIONS
          Wether to issue a warning whenever a key is turncated to match a ciphers specific key size.
 
Constructor Summary
Settings.Constants.Key()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ALWAYS_SILENT

public static final boolean ALWAYS_SILENT
Wether to be totally silent about key material. This is a paranoļa setting. This setting takes precedence on all other key-related log settings.

See Also:
Constant Field Values

LOG_KEY_INSTANTIATION

public static final boolean LOG_KEY_INSTANTIATION
Wether to issue a log whenever a new key is created.

See Also:
Constant Field Values

LOG_KEY_MATERIAL_LENGTH

public static final boolean LOG_KEY_MATERIAL_LENGTH
Wether to include effective key material length while logging key instantiation. Note that this setting has no effect unless LOG_KEY_INSTANTIATION is true.

See Also:
Constant Field Values

LOG_TRUNCATIONS

public static final boolean LOG_TRUNCATIONS
Wether to issue a log whenever a key is turncated to match a ciphers specific key size.

See Also:
Constant Field Values

WARN_TRUNCATIONS

public static boolean WARN_TRUNCATIONS
Wether to issue a warning whenever a key is turncated to match a ciphers specific key size.


LOG_EXPANSIONS

public static final boolean LOG_EXPANSIONS
Wether to issue a log whenever a key is turncated to match a ciphers specific key size. Warning: key expansion is inherently unsafe as it reduces the key relative entropy.

See Also:
Constant Field Values

WARN_EXPANSIONS

public static final boolean WARN_EXPANSIONS
Wether to issue a warning whenever a key is turncated to match a ciphers specific key size. Warning: key expansion is inherently unsafe as it reduces the key relative entropy.

See Also:
Constant Field Values

IGNORE_EMPTY

public static final boolean IGNORE_EMPTY
Wether to discard ciphers whose Key is empty. Warning: it is necessary for Key subclasses to override the Key.isEmpty() method adequately to avoid not-really empty keys be discarded.

See Also:
Key.isEmpty(), Constant Field Values

WARN_EMPTY

public static final boolean WARN_EMPTY
Wether to issue a warning if a key is built empty.

See Also:
Constant Field Values

WARN_SUBCLASSES_INVERSION

public static final boolean WARN_SUBCLASSES_INVERSION
Wether to issue a warning whenever a sam.cipher.Key subclass is inversed through the sam.cipher.Key.inverse() method which returns an new instance of sam.cipher.Key instead of the subclass.

See Also:
Constant Field Values
Constructor Detail

Settings.Constants.Key

public Settings.Constants.Key()