Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Third Party Openssl
提交
716854d7
T
Third Party Openssl
项目概览
OpenHarmony
/
Third Party Openssl
12 个月 前同步成功
通知
8
Star
18
Fork
1
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
T
Third Party Openssl
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
716854d7
编写于
11月 30, 2015
作者:
R
Richard Levitte
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Document the HMAC changes
Reviewed-by:
N
Rich Salz
<
rsalz@openssl.org
>
上级
25191fff
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
24 addition
and
13 deletion
+24
-13
doc/crypto/hmac.pod
doc/crypto/hmac.pod
+24
-13
未找到文件。
doc/crypto/hmac.pod
浏览文件 @
716854d7
...
...
@@ -2,7 +2,7 @@
=head1 NAME
HMAC, HMAC_CTX_
init, HMAC_Init, HMAC_Init_ex, HMAC_Update, HMAC_Final, HMAC_CTX_cleanup
- HMAC message authentication code
HMAC, HMAC_CTX_
new, HMAC_CTX_reset, HMAC_CTX_free, HMAC_Init, HMAC_Init_ex, HMAC_Update, HMAC_Final
- HMAC message authentication code
=head1 SYNOPSIS
...
...
@@ -12,7 +12,8 @@ HMAC, HMAC_CTX_init, HMAC_Init, HMAC_Init_ex, HMAC_Update, HMAC_Final, HMAC_CTX_
int key_len, const unsigned char *d, int n,
unsigned char *md, unsigned int *md_len);
int HMAC_CTX_init(HMAC_CTX *ctx);
HMAC_CTX *HMAC_CTX_new(void);
int HMAC_CTX_reset(HMAC_CTX *ctx);
int HMAC_Init(HMAC_CTX *ctx, const void *key, int key_len,
const EVP_MD *md);
...
...
@@ -21,7 +22,7 @@ HMAC, HMAC_CTX_init, HMAC_Init, HMAC_Init_ex, HMAC_Update, HMAC_Final, HMAC_CTX_
int HMAC_Update(HMAC_CTX *ctx, const unsigned char *data, int len);
int HMAC_Final(HMAC_CTX *ctx, unsigned char *md, unsigned int *len);
void HMAC_CTX_
cleanup
(HMAC_CTX *ctx);
void HMAC_CTX_
free
(HMAC_CTX *ctx);
=head1 DESCRIPTION
...
...
@@ -40,12 +41,15 @@ the output is placed in B<md_len>, unless it is B<NULL>.
B<evp_md> can be EVP_sha1(), EVP_ripemd160() etc.
HMAC_CTX_init() initialises a B<HMAC_CTX> before first use. It must be
called.
HMAC_CTX_new() creates a new HMAC_CTX in heap memory.
HMAC_CTX_cleanup() erases the key and other data from the B<HMAC_CTX>
and releases any associated resources. It must be called when an
B<HMAC_CTX> is no longer required.
HMAC_CTX_reset() zeroes an existing B<HMAC_CTX> and associated
resources, making it suitable for new computations as if it was newly
created with HMAC_CTX_new().
HMAC_CTX_free() erases the key and other data from the B<HMAC_CTX>,
releases any associated resources and finally frees the B<HMAC_CTX>
itself.
The following functions may be used if the message is not completely
stored in memory:
...
...
@@ -57,8 +61,8 @@ with OpenSSL 0.9.6b.
HMAC_Init_ex() initializes or reuses a B<HMAC_CTX> structure to use
the function B<evp_md> and key B<key>. Either can be NULL, in which
case the existing one will be reused.
HMAC_CTX_init() must have been
called
before the first use of an B<HMAC_CTX> in this
case the existing one will be reused.
B<ctx> must have been created
with HMAC_CTX_new()
before the first use of an B<HMAC_CTX> in this
function. B<N.B. HMAC_Init() had this undocumented behaviour in
previous versions of OpenSSL - failure to switch to HMAC_Init_ex() in
programs that expect it will cause them to stop working>.
...
...
@@ -74,10 +78,13 @@ must have space for the hash function output.
HMAC() returns a pointer to the message authentication code or NULL if
an error occurred.
HMAC_CTX_init(), HMAC_Init_ex(), HMAC_Update() and HMAC_Final() return 1
HMAC_CTX_new() returns a pointer to a new B<HMAC_CTX> on success or
B<NULL> if an error occurred.
HMAC_CTX_reset(), HMAC_Init_ex(), HMAC_Update() and HMAC_Final() return 1
for success or 0 if an error occurred.
HMAC_CTX_
cleanup
() do not return values.
HMAC_CTX_
free
() do not return values.
=head1 CONFORMING TO
...
...
@@ -89,7 +96,11 @@ L<sha(3)>, L<evp(3)>
=head1 HISTORY
HMAC_CTX_init() did not return a value in OpenSSL versions before 1.1.
HMAC_CTX_init() was replaced with HMAC_CTX_reset() in OpenSSL versions 1.1.
HMAC_CTX_cleanup() existed in OpenSSL versions before 1.1.
HMAC_CTX_new() and HMAC_CTX_free() are new in OpenSSL version 1.1.
HMAC_Init_ex(), HMAC_Update() and HMAC_Final() did not return values in
versions of OpenSSL before 1.0.0.
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录