/usr/share/doc/libbotan-2-doc/manual/cryptobox.html is in libbotan-2-doc 2.4.0-5ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Cryptobox — Botan</title>
<link rel="stylesheet" href="_static/agogo.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '2.4.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Secure Remote Password" href="srp.html" />
<link rel="prev" title="Password Hashing" href="passhash.html" />
</head>
<body>
<div class="header-wrapper">
<div class="header">
<h1>Botan</h1>
</div>
</div>
<div class="content-wrapper">
<div class="content">
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="cryptobox">
<h1>Cryptobox<a class="headerlink" href="#cryptobox" title="Permalink to this headline">¶</a></h1>
<div class="section" id="encryption-using-a-passphrase">
<h2>Encryption using a passphrase<a class="headerlink" href="#encryption-using-a-passphrase" title="Permalink to this headline">¶</a></h2>
<div class="versionadded">
<p><span class="versionmodified">New in version 1.8.6.</span></p>
</div>
<p>This is a set of simple routines that encrypt some data using a
passphrase. There are defined in the header <cite>cryptobox.h</cite>, inside
namespace <cite>Botan::CryptoBox</cite>.</p>
<p>It generates cipher and MAC keys using 8192 iterations of PBKDF2 with
HMAC(SHA-512), then encrypts using Serpent in CTR mode and authenticates using a
HMAC(SHA-512) mac of the ciphertext, truncated to 160 bits.</p>
<blockquote>
<div><dl class="function">
<dt id="_CPPv27encryptA_K7uint8_t6size_tRKNSt6stringER21RandomNumberGenerator">
<span id="encrypt__uint8_tCA.s.ssCR.RandomNumberGeneratorR"></span>std::string <code class="descclassname"></code><code class="descname">encrypt</code><span class="sig-paren">(</span><em class="property">const</em> uint8_t <em>input</em>[], size_t <em>input_len</em>, <em class="property">const</em> std::string &<em>passphrase</em>, RandomNumberGenerator &<em>rng</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv27encryptA_K7uint8_t6size_tRKNSt6stringER21RandomNumberGenerator" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Encrypt the contents using <em>passphrase</em>.</p>
</dd></dl>
<dl class="function">
<dt id="_CPPv27decryptA_K7uint8_t6size_tRKNSt6stringE">
<span id="decrypt__uint8_tCA.s.ssCR"></span>std::string <code class="descclassname"></code><code class="descname">decrypt</code><span class="sig-paren">(</span><em class="property">const</em> uint8_t <em>input</em>[], size_t <em>input_len</em>, <em class="property">const</em> std::string &<em>passphrase</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv27decryptA_K7uint8_t6size_tRKNSt6stringE" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Decrypts something encrypted with encrypt.</p>
</dd></dl>
<dl class="function">
<dt id="_CPPv27decryptRKNSt6stringERKNSt6stringE">
<span id="decrypt__ssCR.ssCR"></span>std::string <code class="descclassname"></code><code class="descname">decrypt</code><span class="sig-paren">(</span><em class="property">const</em> std::string &<em>input</em>, <em class="property">const</em> std::string &<em>passphrase</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv27decryptRKNSt6stringERKNSt6stringE" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Decrypts something encrypted with encrypt.</p>
</dd></dl>
</div></blockquote>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sidebar">
<h3>Table Of Contents</h3>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="index.html">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="goals.html">Project Goals</a></li>
<li class="toctree-l1"><a class="reference internal" href="support.html">Support Information</a></li>
<li class="toctree-l1"><a class="reference internal" href="building.html">Building The Library</a></li>
<li class="toctree-l1"><a class="reference internal" href="versions.html">Versioning</a></li>
<li class="toctree-l1"><a class="reference internal" href="secmem.html">Memory container</a></li>
<li class="toctree-l1"><a class="reference internal" href="rng.html">Random Number Generators</a></li>
<li class="toctree-l1"><a class="reference internal" href="hash.html">Hash Functions and Checksums</a></li>
<li class="toctree-l1"><a class="reference internal" href="block_cipher.html">Block Ciphers</a></li>
<li class="toctree-l1"><a class="reference internal" href="stream_ciphers.html">Stream Ciphers</a></li>
<li class="toctree-l1"><a class="reference internal" href="message_auth_codes.html">Message Authentication Codes (MAC)</a></li>
<li class="toctree-l1"><a class="reference internal" href="cipher_modes.html">Cipher Modes</a></li>
<li class="toctree-l1"><a class="reference internal" href="pubkey.html">Public Key Cryptography</a></li>
<li class="toctree-l1"><a class="reference internal" href="x509.html">X.509 Certificates and CRLs</a></li>
<li class="toctree-l1"><a class="reference internal" href="tls.html">Transport Layer Security (TLS)</a></li>
<li class="toctree-l1"><a class="reference internal" href="credentials_manager.html">Credentials Manager</a></li>
<li class="toctree-l1"><a class="reference internal" href="bigint.html">BigInt</a></li>
<li class="toctree-l1"><a class="reference internal" href="kdf.html">Key Derivation Functions</a></li>
<li class="toctree-l1"><a class="reference internal" href="pbkdf.html">PBKDF Algorithms</a></li>
<li class="toctree-l1"><a class="reference internal" href="keywrap.html">AES Key Wrapping</a></li>
<li class="toctree-l1"><a class="reference internal" href="passhash.html">Password Hashing</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Cryptobox</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#encryption-using-a-passphrase">Encryption using a passphrase</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="srp.html">Secure Remote Password</a></li>
<li class="toctree-l1"><a class="reference internal" href="psk_db.html">PSK Database</a></li>
<li class="toctree-l1"><a class="reference internal" href="filters.html">Pipe/Filter Message Processing</a></li>
<li class="toctree-l1"><a class="reference internal" href="fpe.html">Format Preserving Encryption</a></li>
<li class="toctree-l1"><a class="reference internal" href="compression.html">Lossless Data Compression</a></li>
<li class="toctree-l1"><a class="reference internal" href="pkcs11.html">PKCS#11</a></li>
<li class="toctree-l1"><a class="reference internal" href="tpm.html">Trusted Platform Module (TPM)</a></li>
<li class="toctree-l1"><a class="reference internal" href="otp.html">One Time Passwords</a></li>
<li class="toctree-l1"><a class="reference internal" href="ffi.html">FFI (C89) Interface</a></li>
<li class="toctree-l1"><a class="reference internal" href="python.html">Python Binding</a></li>
<li class="toctree-l1"><a class="reference internal" href="cli.html">botan</a></li>
<li class="toctree-l1"><a class="reference internal" href="side_channels.html">Side Channels</a></li>
<li class="toctree-l1"><a class="reference internal" href="packaging.html">Notes for Distributors</a></li>
<li class="toctree-l1"><a class="reference internal" href="fuzzing.html">Fuzzing The Library</a></li>
<li class="toctree-l1"><a class="reference internal" href="deprecated.html">Deprecated Features</a></li>
<li class="toctree-l1"><a class="reference internal" href="abi.html">ABI Stability</a></li>
</ul>
<div role="search">
<h3 style="margin-top: 1.5em;">Search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="clearer"></div>
</div>
</div>
<div class="footer-wrapper">
<div class="footer">
<div class="left">
<div role="navigation" aria-label="related navigaton">
<a href="passhash.html" title="Password Hashing"
accesskey="P">previous</a> |
<a href="srp.html" title="Secure Remote Password"
accesskey="N">next</a> |
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |
<a href="genindex.html" title="General Index"
accesskey="I">index</a>
</div>
<div role="note" aria-label="source link">
</div>
</div>
<div class="right">
<div class="footer" role="contentinfo">
Last updated on 2018-04-08.
</div>
</div>
<div class="clearer"></div>
</div>
</div>
</body>
</html>
|