| 1 | |
|---|
| 2 | <?xml version="1.0" encoding="UTF-8"?> |
|---|
| 3 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
|---|
| 4 | <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"> |
|---|
| 5 | <head> |
|---|
| 6 | <style type="text/css"><!-- |
|---|
| 7 | @import url("../www/wizard.css"); |
|---|
| 8 | //--></style> |
|---|
| 9 | <title>Wizard's Toolkit: Command-line Tools: Decipher</title> |
|---|
| 10 | <meta http-equiv="Content-Language" content="en-US"/> |
|---|
| 11 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> |
|---|
| 12 | <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/> |
|---|
| 13 | <meta name="Generator" content="PHP"/> |
|---|
| 14 | <meta name="Keywords" content="command-line, tools:, decipher, WizardsToolkit, Wizard's, Toolkit"/> |
|---|
| 15 | <meta name="Description" content="The Wizard's Toolkit, version 1.0.2, is a free C API that includes a number of methods most developers will find useful in their projects."/> |
|---|
| 16 | <meta name="Rating" content="INDEX, FOLLOW"/> |
|---|
| 17 | <meta name="Robots" content="ALL"/> |
|---|
| 18 | <meta name="Generator" content="ImageMagick Studio LLC"/> |
|---|
| 19 | <meta name="Author" content="ImageMagick Studio LLC"/> |
|---|
| 20 | <meta name="Revisit-after" content="2 DAYS"/> |
|---|
| 21 | <meta name="Resource-type" content="document"/> |
|---|
| 22 | <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/> |
|---|
| 23 | <meta name="Distribution" content="Global"/> |
|---|
| 24 | <link rel="shortcut icon" href="../images/wand.ico" type="images/vnd.microsoft.icon"/> |
|---|
| 25 | </head> |
|---|
| 26 | |
|---|
| 27 | <body id="www-wizards-toolkit.org"> |
|---|
| 28 | <table id="titlebar" style="width: 100%;background-color: #f5f5f5" cellpadding="0" cellspacing="0" border="0" summary="Wizard's Toolkit"> |
|---|
| 29 | <tbody> |
|---|
| 30 | <tr valign="top"> |
|---|
| 31 | <td align="left"><a href="../index.html"><img id="titlebar-west" src="../images/script.png" alt="[Wizard's Toolkit]" width="400" height="60" border="0" vspace="28" name="titlebar-west" /></a></td> |
|---|
| 32 | <td align="left"><a href="http://www.wizards-toolkit.org/" target="1133842042"><img id="titlebar-west" src="../images/sponsor.jpg" alt="[sponsor]" border="0" vspace="28" name="titlebar-west" /></a></td> |
|---|
| 33 | <td width="99%"><br /></td> |
|---|
| 34 | <td style="background-color: white" align="right"><a href="../index.html"><img src="../images/sprite.jpg" alt="" width="114" height="118" border="0" name="titlebar-east" /></a></td> |
|---|
| 35 | <td style="background-color: white" align="right"><a href="http://www.wizards-toolkit.org/discourse-server/viewforum.html?f=17" target="1413334484"><img id="titlebar-east" src="../images/logo.jpg" alt="" width="114" height="118" border="0" name="titlebar-east" /></a></td> |
|---|
| 36 | </tr> |
|---|
| 37 | </tbody> |
|---|
| 38 | </table> |
|---|
| 39 | |
|---|
| 40 | <table style="width: 100%" border="0" cellpadding="0" cellspacing="0" summary=""> |
|---|
| 41 | <tbody> |
|---|
| 42 | |
|---|
| 43 | <tr valign="top" style="height: 100%;"> |
|---|
| 44 | <td id="menu" width="1%" height="100%"> |
|---|
| 45 | <p><a href="#main">Skip to page contents</a></p> |
|---|
| 46 | <font size="-1"> |
|---|
| 47 | <span>[</span> |
|---|
| 48 | <a href="../index.html">About the<br />Wizard's Toolkit</a> |
|---|
| 49 | <span>]</span><br /><span>[</span> |
|---|
| 50 | <a href="../www/command-line-tools.html">Command-line Tools</a> |
|---|
| 51 | <span>]</span><br /><span>[</span> |
|---|
| 52 | <a href="../www/api.html">Application Program<br />Interface</a> |
|---|
| 53 | <span>]</span><br /><span>[</span> |
|---|
| 54 | <a href="../www/install-source.html">Install from Source</a> |
|---|
| 55 | <a href="../www/install-source.html#unix" class="sub">Unix</a> |
|---|
| 56 | <a href="../www/install-source.html#windows" class="sub">Windows</a> |
|---|
| 57 | <a href="../www/binary-releases.html">Binary Releases</a> |
|---|
| 58 | <a href="../www/binary-releases.html#unix" class="sub">Unix</a> |
|---|
| 59 | <a href="../www/binary-releases.html#windows" class="sub">Windows</a> |
|---|
| 60 | <span>]</span><br /><span>[</span> |
|---|
| 61 | <a href="../www/download.html">Download</a> |
|---|
| 62 | <span>]</span><br /><span>[</span> |
|---|
| 63 | <a href="../www/sponsors.html">Sponsors:</a> |
|---|
| 64 | <fieldset> |
|---|
| 65 | <a href="http://www.anxietyspinnerrings.com" class="sponsor" target="sponsor">Silver Rings</a><!-- 200904010140 --> |
|---|
| 66 | <br /> |
|---|
| 67 | </fieldset> |
|---|
| 68 | <span>]</span> |
|---|
| 69 | </font> |
|---|
| 70 | </td> |
|---|
| 71 | |
|---|
| 72 | <td id="main" valign="top"> |
|---|
| 73 | <p class="navigation-index">[<a href="#usage">Example Usage</a> • <a href="#options">Option Summary</a>]</p> |
|---|
| 74 | |
|---|
| 75 | <p>The <kbd>decipher</kbd> command-line utility converts ciphertext to plaintext.</p> |
|---|
| 76 | |
|---|
| 77 | <div style="margin: auto;"> |
|---|
| 78 | <h2><a name="usage"></a>Example Usage</h2> |
|---|
| 79 | </div> |
|---|
| 80 | |
|---|
| 81 | <p>We list a few examples of the <kbd>decipher</kbd> command here to illustrate its usefulness and ease of use. To get started, lets decypt a text file:</p> |
|---|
| 82 | |
|---|
| 83 | <pre class="text"> |
|---|
| 84 | decipher README.cip README.txt |
|---|
| 85 | </pre> |
|---|
| 86 | |
|---|
| 87 | <p>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:</p> |
|---|
| 88 | |
|---|
| 89 | <pre class="text"> |
|---|
| 90 | decipher -keyring ./keyring.xdm secret-message.cip message.txt |
|---|
| 91 | </pre> |
|---|
| 92 | |
|---|
| 93 | <p>To ensure your ciphertext is not easily revealed, the decipher program takes these precautions:</p> |
|---|
| 94 | |
|---|
| 95 | <h5>Passphrase</h5> |
|---|
| 96 | <p>If your command line does not include the <a href="../www/command-line-options.html#passphrase" target="wizard-options">-passphrase <em class="option">filename</em></a> 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.</p> |
|---|
| 97 | <h5>Keyring</h5> |
|---|
| 98 | <p>Your secret key is stored in a private keyring. If you lose your keyring, it |
|---|
| 99 | is impossible to restore your original message content.</p> |
|---|
| 100 | <h5>Entropy</h5> |
|---|
| 101 | <p>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.</p> |
|---|
| 102 | <h5>Exceptions</h5> |
|---|
| 103 | <p>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.</p> |
|---|
| 104 | |
|---|
| 105 | <div style="margin: auto;"> |
|---|
| 106 | <h2><a name="options"></a>Option Summary</h2> |
|---|
| 107 | </div> |
|---|
| 108 | |
|---|
| 109 | <p>The <kbd>decipher</kbd> command recognizes these options. Click on an option to get more details about how that option works.</p> |
|---|
| 110 | |
|---|
| 111 | <table id="table" cellpadding="2" cellspacing="0" style="width: 93%"> |
|---|
| 112 | <tbody> |
|---|
| 113 | <tr> |
|---|
| 114 | <th align="left">Option</th> |
|---|
| 115 | <th align="left">Description</th> |
|---|
| 116 | </tr> |
|---|
| 117 | |
|---|
| 118 | <tr> |
|---|
| 119 | <td valign="top"><a href="../www/command-line-options.html#authenticate" target="wizard-options">-authenticate <em class="option">method</em></a></td> |
|---|
| 120 | <td valign="top">authenticate with this method: Secret or Public</td> |
|---|
| 121 | </tr> |
|---|
| 122 | |
|---|
| 123 | <tr> |
|---|
| 124 | <td valign="top"><a href="../www/command-line-options.html#chunksize" target="wizard-options">-chunksize <em class="option">bytes</em></a></td> |
|---|
| 125 | <td valign="top">number of bytes in a chunk</td> |
|---|
| 126 | </tr> |
|---|
| 127 | |
|---|
| 128 | <tr> |
|---|
| 129 | <td valign="top"><a href="../www/command-line-options.html#cipher" target="wizard-options">-cipher <em class="option">type</em></a></td> |
|---|
| 130 | <td valign="top">cipher to decrypt content</td> |
|---|
| 131 | </tr> |
|---|
| 132 | |
|---|
| 133 | <tr> |
|---|
| 134 | <td valign="top"><a href="../www/command-line-options.html#(de)compress" target="wizard-options">-(de)compress</a></td> |
|---|
| 135 | <td valign="top">automagically (de)compress BZIP and ZIP files</td> |
|---|
| 136 | </tr> |
|---|
| 137 | |
|---|
| 138 | <tr> |
|---|
| 139 | <td valign="top"><a href="../www/command-line-options.html#debug" target="wizard-options">-debug <em class="option">events</em></a></td> |
|---|
| 140 | <td valign="top">display copious debugging information</td> |
|---|
| 141 | </tr> |
|---|
| 142 | |
|---|
| 143 | <tr> |
|---|
| 144 | <td valign="top"><a href="../www/command-line-options.html#entropy" target="wizard-options">-entropy <em class="option">type</em></a></td> |
|---|
| 145 | <td valign="top">increase content entropy</td> |
|---|
| 146 | </tr> |
|---|
| 147 | |
|---|
| 148 | <tr> |
|---|
| 149 | <td valign="top"><a href="../www/command-line-options.html#help" target="wizard-options">-help</a></td> |
|---|
| 150 | <td valign="top">print program options</td> |
|---|
| 151 | </tr> |
|---|
| 152 | |
|---|
| 153 | <tr> |
|---|
| 154 | <td valign="top"><a href="../www/command-line-options.html#hmac" target="wizard-options">-hmac <em class="option">hash</em></a></td> |
|---|
| 155 | <td valign="top">ensure message integrity with this hash</td> |
|---|
| 156 | </tr> |
|---|
| 157 | |
|---|
| 158 | <tr> |
|---|
| 159 | <td valign="top"><a href="../www/command-line-options.html#key" target="wizard-options">-key <em class="option">hash</em></a></td> |
|---|
| 160 | <td valign="top">strengthen the key with this hash</td> |
|---|
| 161 | </tr> |
|---|
| 162 | |
|---|
| 163 | <tr> |
|---|
| 164 | <td valign="top"><a href="../www/command-line-options.html#key-length" target="wizard-options">-key-length <em class="option">value</em></a></td> |
|---|
| 165 | <td valign="top">cipher key length in bits: 256, 512, 1024, or 2048</td> |
|---|
| 166 | </tr> |
|---|
| 167 | |
|---|
| 168 | <tr> |
|---|
| 169 | <td valign="top"><a href="../www/command-line-options.html#keyring" target="wizard-options">-keyring <em class="option">filename</em></a></td> |
|---|
| 170 | <td valign="top">add the private key to this keyring</td> |
|---|
| 171 | </tr> |
|---|
| 172 | |
|---|
| 173 | <tr> |
|---|
| 174 | <td valign="top"><a href="../www/command-line-options.html#level" target="wizard-options">-level <em class="option">value</em></a></td> |
|---|
| 175 | <td valign="top">entropy level: 1 (less entropy) to 9 (more entropy)</td> |
|---|
| 176 | </tr> |
|---|
| 177 | |
|---|
| 178 | <tr> |
|---|
| 179 | <td valign="top"><a href="../www/command-line-options.html#list" target="wizard-options">-list <em class="option">type</em></a></td> |
|---|
| 180 | <td valign="top">print a list of supported option arguments</td> |
|---|
| 181 | </tr> |
|---|
| 182 | |
|---|
| 183 | <tr> |
|---|
| 184 | <td valign="top"><a href="../www/command-line-options.html#log" target="wizard-options">-log <em class="option">format</em></a></td> |
|---|
| 185 | <td valign="top">format of debugging information</td> |
|---|
| 186 | </tr> |
|---|
| 187 | |
|---|
| 188 | <tr> |
|---|
| 189 | <td valign="top"><a href="../www/command-line-options.html#mode" target="wizard-options">-mode <em class="option">type</em></a></td> |
|---|
| 190 | <td valign="top">mode of decryption</td> |
|---|
| 191 | </tr> |
|---|
| 192 | |
|---|
| 193 | <tr> |
|---|
| 194 | <td valign="top"><a href="../www/command-line-options.html#passphrase" target="wizard-options">-passphrase <em class="option">filename</em></a></td> |
|---|
| 195 | <td valign="top">get the passphrase from this file</td> |
|---|
| 196 | </tr> |
|---|
| 197 | |
|---|
| 198 | <tr> |
|---|
| 199 | <td valign="top"><a href="../www/command-line-options.html#properties" target="wizard-options">-properties <em class="option">filename</em></a></td> |
|---|
| 200 | <td valign="top">cipher properties to/from this file</td> |
|---|
| 201 | </tr> |
|---|
| 202 | |
|---|
| 203 | <tr> |
|---|
| 204 | <td valign="top"><a href="../www/command-line-options.html#random" target="wizard-options">-random <em class="option">hash</em></a></td> |
|---|
| 205 | <td valign="top">strengthen random data with this hash</td> |
|---|
| 206 | </tr> |
|---|
| 207 | |
|---|
| 208 | <tr> |
|---|
| 209 | <td valign="top"><a href="../www/command-line-options.html#true-random" target="wizard-options">-true-random</a></td> |
|---|
| 210 | <td valign="top">strengthen deciphering with true random numbers</td> |
|---|
| 211 | </tr> |
|---|
| 212 | |
|---|
| 213 | <tr> |
|---|
| 214 | <td valign="top"><a href="../www/command-line-options.html#verbose" target="wizard-options">-verbose</a></td> |
|---|
| 215 | <td valign="top">print detailed information about the secure content</td> |
|---|
| 216 | </tr> |
|---|
| 217 | |
|---|
| 218 | <tr> |
|---|
| 219 | <td valign="top"><a href="../www/command-line-options.html#version" target="wizard-options">-version</a></td> |
|---|
| 220 | <td valign="top">print version information</td> |
|---|
| 221 | </tr> |
|---|
| 222 | |
|---|
| 223 | </tbody> |
|---|
| 224 | </table> |
|---|
| 225 | </td> |
|---|
| 226 | <td id="margin" width="1%" height="100%" valign="top" align="right"> </td> |
|---|
| 227 | </tr> |
|---|
| 228 | </tbody> |
|---|
| 229 | </table> |
|---|
| 230 | <div id="linkbar"> |
|---|
| 231 | <a href="http://www.wizards-toolkit.org/discourse-server/viewforum.html?f=17" target="1948086938">Discourse Server</a> | |
|---|
| 232 | <a href="../www/license.html">License</a> | |
|---|
| 233 | <a href="../www/notice.html">Notice</a> |
|---|
| 234 | </div> |
|---|
| 235 | <div id="footer"> |
|---|
| 236 | <span id="footer-west">© 1999-2009 ImageMagick Studio LLC</span> |
|---|
| 237 | </div> |
|---|
| 238 | <div style="clear: both; margin: 0; width: 100%; "></div> |
|---|
| 239 | </body> |
|---|
| 240 | </html> |
|---|
