diff --git a/README.rst b/README.rst index e5eeb0a5fe642571ab2dfe02ea4de77332ec87aa..f48aee698a33625dd1832be4eca956f65810defd 100644 --- a/README.rst +++ b/README.rst @@ -278,6 +278,10 @@ Security Traps There are issues that might reduce the entropy of the passphrase generated. One of them is the `prefix code`_ problem: + +Prefix Code +........... + If the wordlist contains, for example, the words:: "air", "airport", "portable", "able" @@ -299,6 +303,18 @@ Each of these measures is sufficient to protect you against the `prefix code`_ problem. +Reduced Entropy +............... + +Overall, `diceware` is a kind of mapping input values, dice throws for +instance, onto wordlist entries. We normally want each of the words in the +wordlist to be picked for passphrases with the same probability. + +This, however, is not possible, if the number of dice sides and the number of +wordlist entries are relatively prime. In that case we cut some words of the +wordlist and inform the user about the matter. + + Developer Install -----------------