222 lines
6.5 KiB
HTML
Executable File
222 lines
6.5 KiB
HTML
Executable File
<?xml version="1.0" ?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<title>EVP_aes_128_gcm</title>
|
|
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
|
<link rev="made" href="mailto:root@localhost" />
|
|
</head>
|
|
|
|
<body style="background-color: white">
|
|
|
|
|
|
<!-- INDEX BEGIN -->
|
|
<div name="index">
|
|
<p><a name="__index__"></a></p>
|
|
|
|
<ul>
|
|
|
|
<li><a href="#name">NAME</a></li>
|
|
<li><a href="#synopsis">SYNOPSIS</a></li>
|
|
<li><a href="#description">DESCRIPTION</a></li>
|
|
<li><a href="#return_values">RETURN VALUES</a></li>
|
|
<li><a href="#see_also">SEE ALSO</a></li>
|
|
<li><a href="#copyright">COPYRIGHT</a></li>
|
|
</ul>
|
|
|
|
<hr name="index" />
|
|
</div>
|
|
<!-- INDEX END -->
|
|
|
|
<p>
|
|
</p>
|
|
<hr />
|
|
<h1><a name="name">NAME</a></h1>
|
|
<p>EVP_aes_128_cbc,
|
|
EVP_aes_192_cbc,
|
|
EVP_aes_256_cbc,
|
|
EVP_aes_128_cfb,
|
|
EVP_aes_192_cfb,
|
|
EVP_aes_256_cfb,
|
|
EVP_aes_128_cfb1,
|
|
EVP_aes_192_cfb1,
|
|
EVP_aes_256_cfb1,
|
|
EVP_aes_128_cfb8,
|
|
EVP_aes_192_cfb8,
|
|
EVP_aes_256_cfb8,
|
|
EVP_aes_128_cfb128,
|
|
EVP_aes_192_cfb128,
|
|
EVP_aes_256_cfb128,
|
|
EVP_aes_128_ctr,
|
|
EVP_aes_192_ctr,
|
|
EVP_aes_256_ctr,
|
|
EVP_aes_128_ecb,
|
|
EVP_aes_192_ecb,
|
|
EVP_aes_256_ecb,
|
|
EVP_aes_128_ofb,
|
|
EVP_aes_192_ofb,
|
|
EVP_aes_256_ofb,
|
|
EVP_aes_128_cbc_hmac_sha1,
|
|
EVP_aes_256_cbc_hmac_sha1,
|
|
EVP_aes_128_cbc_hmac_sha256,
|
|
EVP_aes_256_cbc_hmac_sha256,
|
|
EVP_aes_128_ccm,
|
|
EVP_aes_192_ccm,
|
|
EVP_aes_256_ccm,
|
|
EVP_aes_128_gcm,
|
|
EVP_aes_192_gcm,
|
|
EVP_aes_256_gcm,
|
|
EVP_aes_128_ocb,
|
|
EVP_aes_192_ocb,
|
|
EVP_aes_256_ocb,
|
|
EVP_aes_128_wrap,
|
|
EVP_aes_192_wrap,
|
|
EVP_aes_256_wrap,
|
|
EVP_aes_128_wrap_pad,
|
|
EVP_aes_192_wrap_pad,
|
|
EVP_aes_256_wrap_pad,
|
|
EVP_aes_128_xts,
|
|
EVP_aes_256_xts
|
|
- EVP AES cipher</p>
|
|
<p>
|
|
</p>
|
|
<hr />
|
|
<h1><a name="synopsis">SYNOPSIS</a></h1>
|
|
<pre>
|
|
#include <openssl/evp.h></pre>
|
|
<pre>
|
|
const EVP_CIPHER *EVP_ciphername(void)</pre>
|
|
<p><em>EVP_ciphername</em> is used a placeholder for any of the described cipher
|
|
functions, such as <em>EVP_aes_128_cbc</em>.</p>
|
|
<p>
|
|
</p>
|
|
<hr />
|
|
<h1><a name="description">DESCRIPTION</a></h1>
|
|
<p>The AES encryption algorithm for EVP.</p>
|
|
<dl>
|
|
<dt><strong><a name="evp_aes_128_cbc" class="item">EVP_aes_128_cbc(),
|
|
EVP_aes_192_cbc(),
|
|
EVP_aes_256_cbc(),
|
|
EVP_aes_128_cfb(),
|
|
EVP_aes_192_cfb(),
|
|
EVP_aes_256_cfb(),
|
|
EVP_aes_128_cfb1(),
|
|
EVP_aes_192_cfb1(),
|
|
EVP_aes_256_cfb1(),
|
|
EVP_aes_128_cfb8(),
|
|
EVP_aes_192_cfb8(),
|
|
EVP_aes_256_cfb8(),
|
|
EVP_aes_128_cfb128(),
|
|
EVP_aes_192_cfb128(),
|
|
EVP_aes_256_cfb128(),
|
|
EVP_aes_128_ctr(),
|
|
EVP_aes_192_ctr(),
|
|
EVP_aes_256_ctr(),
|
|
EVP_aes_128_ecb(),
|
|
EVP_aes_192_ecb(),
|
|
EVP_aes_256_ecb(),
|
|
EVP_aes_128_ofb(),
|
|
EVP_aes_192_ofb(),
|
|
EVP_aes_256_ofb()</a></strong></dt>
|
|
|
|
<dd>
|
|
<p>AES for 128, 192 and 256 bit keys in the following modes: CBC, CFB with 128-bit
|
|
shift, CFB with 1-bit shift, CFB with 8-bit shift, CTR, ECB, and OFB.</p>
|
|
</dd>
|
|
<dt><strong><a name="evp_aes_128_cbc_hmac_sha1" class="item">EVP_aes_128_cbc_hmac_sha1(),
|
|
EVP_aes_256_cbc_hmac_sha1()</a></strong></dt>
|
|
|
|
<dd>
|
|
<p>Authenticated encryption with AES in CBC mode using SHA-1 as HMAC, with keys of
|
|
128 and 256 bits length respectively. The authentication tag is 160 bits long.</p>
|
|
<p>WARNING: this is not intended for usage outside of TLS and requires calling of
|
|
some undocumented ctrl functions. These ciphers do not conform to the EVP AEAD
|
|
interface.</p>
|
|
</dd>
|
|
<dt><strong><a name="evp_aes_128_cbc_hmac_sha256" class="item">EVP_aes_128_cbc_hmac_sha256(),
|
|
EVP_aes_256_cbc_hmac_sha256()</a></strong></dt>
|
|
|
|
<dd>
|
|
<p>Authenticated encryption with AES in CBC mode using SHA256 (SHA-2, 256-bits) as
|
|
HMAC, with keys of 128 and 256 bits length respectively. The authentication tag
|
|
is 256 bits long.</p>
|
|
<p>WARNING: this is not intended for usage outside of TLS and requires calling of
|
|
some undocumented ctrl functions. These ciphers do not conform to the EVP AEAD
|
|
interface.</p>
|
|
</dd>
|
|
<dt><strong><a name="evp_aes_128_ccm" class="item">EVP_aes_128_ccm(),
|
|
EVP_aes_192_ccm(),
|
|
EVP_aes_256_ccm(),
|
|
EVP_aes_128_gcm(),
|
|
EVP_aes_192_gcm(),
|
|
EVP_aes_256_gcm(),
|
|
EVP_aes_128_ocb(),
|
|
EVP_aes_192_ocb(),
|
|
EVP_aes_256_ocb()</a></strong></dt>
|
|
|
|
<dd>
|
|
<p>AES for 128, 192 and 256 bit keys in CBC-MAC Mode (CCM), Galois Counter Mode
|
|
(GCM) and OCB Mode respectively. These ciphers require additional control
|
|
operations to function correctly, see the <em>EVP_EncryptInit(3)/AEAD Interface</em>
|
|
section for details.</p>
|
|
</dd>
|
|
<dt><strong><a name="evp_aes_128_wrap" class="item">EVP_aes_128_wrap(),
|
|
EVP_aes_192_wrap(),
|
|
EVP_aes_256_wrap(),
|
|
EVP_aes_128_wrap_pad(),
|
|
EVP_aes_128_wrap(),
|
|
EVP_aes_192_wrap(),
|
|
EVP_aes_256_wrap(),
|
|
EVP_aes_192_wrap_pad(),
|
|
EVP_aes_128_wrap(),
|
|
EVP_aes_192_wrap(),
|
|
EVP_aes_256_wrap(),
|
|
EVP_aes_256_wrap_pad()</a></strong></dt>
|
|
|
|
<dd>
|
|
<p>AES key wrap with 128, 192 and 256 bit keys, as according to <a href="http://www.ietf.org/rfc/rfc3394.txt" class="rfc">RFC 3394</a> section
|
|
2.2.1 ("wrap") and <a href="http://www.ietf.org/rfc/rfc5649.txt" class="rfc">RFC 5649</a> section 4.1 ("wrap with padding") respectively.</p>
|
|
</dd>
|
|
<dt><strong><a name="evp_aes_128_xts" class="item">EVP_aes_128_xts(),
|
|
EVP_aes_256_xts()</a></strong></dt>
|
|
|
|
<dd>
|
|
<p>AES XTS mode (XTS-AES) is standardized in IEEE Std. 1619-2007 and described in NIST
|
|
SP 800-38E. The XTS (XEX-based tweaked-codebook mode with ciphertext stealing)
|
|
mode was designed by Prof. Phillip Rogaway of University of California, Davis,
|
|
intended for encrypting data on a storage device.</p>
|
|
<p>XTS-AES provides confidentiality but not authentication of data. It also
|
|
requires a key of double-length for protection of a certain key size.
|
|
In particular, XTS-AES-128 (<strong>EVP_aes_128_xts</strong>) takes input of a 256-bit key to
|
|
achieve AES 128-bit security, and XTS-AES-256 (<strong>EVP_aes_256_xts</strong>) takes input
|
|
of a 512-bit key to achieve AES 256-bit security.</p>
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
</p>
|
|
<hr />
|
|
<h1><a name="return_values">RETURN VALUES</a></h1>
|
|
<p>These functions return an <strong>EVP_CIPHER</strong> structure that contains the
|
|
implementation of the symmetric cipher. See <em>EVP_CIPHER_meth_new(3)</em> for
|
|
details of the <strong>EVP_CIPHER</strong> structure.</p>
|
|
<p>
|
|
</p>
|
|
<hr />
|
|
<h1><a name="see_also">SEE ALSO</a></h1>
|
|
<p><em>evp(7)</em>,
|
|
<em>EVP_EncryptInit(3)</em>,
|
|
<em>EVP_CIPHER_meth_new(3)</em></p>
|
|
<p>
|
|
</p>
|
|
<hr />
|
|
<h1><a name="copyright">COPYRIGHT</a></h1>
|
|
<p>Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved.</p>
|
|
<p>Licensed under the Apache License 2.0 (the "License"). You may not use
|
|
this file except in compliance with the License. You can obtain a copy
|
|
in the file LICENSE in the source distribution or at
|
|
<a href="https://www.openssl.org/source/license.html">https://www.openssl.org/source/license.html</a>.</p>
|
|
|
|
</body>
|
|
|
|
</html>
|