decipher command-line utility converts ciphertext to plaintext.
We list a few examples of the
decipher command here to illustrate its usefulness and ease of use. To get started, lets decypt a text file:
decipher README.cip README.txt
Here Alice wands to decipher a secret message from Bob. Alice knows Bob's secret passphrase and has a copy of his private keyring. To restore the original message content, Alice uses this command:
decipher -keyring ./keyring.xdm secret-message.cip message.txt
To ensure your ciphertext is not easily revealed, the decipher program takes these precautions:
If your command line does not include the -passphrase filename option, the passphrase is interactively requested and has a maximum length of 4096 characters and symbols. The phrase can be virtually unlimited if obtained from a file. Try to make your passphrases long and unpredictable.
Your secret key is stored in a private keyring. If you lose your keyring, it is impossible to restore your original message content.
If the decipher program appears to halt it may be waiting for your system to generate entropy. Move your mouse or press keystrokes in another window. Once enough entropy is generated, the decipher program will complete.
If simple mistakes are made, an exception message is displayed. For example if you use '-cpher' instead of '-cipher', decipher complains. However, if anything goes wrong inside the decipher engine, the program exits with a simple status code. This precaution is to prevent information leaks about the decipher process.
decipher command recognizes these options. Click on an option to get more details about how that option works.
|authenticate with this method: Secret or Public
|number of bytes in a chunk
|cipher to decrypt content
|automagically (de)compress BZIP and ZIP files
|display copious debugging information
|increase content entropy
|print program options
|ensure message integrity with this hash
|strengthen the key with this hash
|cipher key length in bits: 256, 512, 1024, or 2048
|add the private key to this keyring
|entropy level: 1 (less entropy) to 9 (more entropy)
|print a list of supported option arguments
|format of debugging information
|mode of decryption
|get the passphrase from this file
|cipher properties to/from this file
|strengthen random data with this hash
|strengthen deciphering with true random numbers
|print detailed information about the secure content
|print version information