summaryrefslogtreecommitdiffstats
path: root/lib/sm3.h
diff options
context:
space:
mode:
Diffstat (limited to 'lib/sm3.h')
-rw-r--r--lib/sm3.h111
1 files changed, 111 insertions, 0 deletions
diff --git a/lib/sm3.h b/lib/sm3.h
new file mode 100644
index 0000000..5d606fe
--- /dev/null
+++ b/lib/sm3.h
@@ -0,0 +1,111 @@
+/* Declarations of functions and data types used for SM3 sum library
+ function.
+ Copyright (C) 2017-2022 Free Software Foundation, Inc.
+
+ This file is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Lesser General Public License as
+ published by the Free Software Foundation; either version 2.1 of the
+ License, or (at your option) any later version.
+
+ This file is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>. */
+
+/* This module can be used to compute SM3 message digest of files or
+ memory blocks according to the specification GM/T 004-2012
+ Cryptographic Hash Algorithm SM3, published by State Cryptography
+ Administration, China.
+
+ The official SM3 cryptographic hash algorithm specification is
+ available at
+ <http://www.sca.gov.cn/sca/xwdt/2010-12/17/content_1002389.shtml>. */
+
+#ifndef SM3_H
+# define SM3_H 1
+
+# include <stdio.h>
+# include <stdint.h>
+
+# if HAVE_OPENSSL_SM3
+# include <openssl/sm3.h>
+# endif
+
+# ifdef __cplusplus
+extern "C" {
+# endif
+
+enum { SM3_DIGEST_SIZE = 256 / 8 };
+
+# if HAVE_OPENSSL_SM3
+# define GL_OPENSSL_NAME 3
+# include "gl_openssl.h"
+# else
+/* Structure to save state of computation between the single steps. */
+struct sm3_ctx
+{
+ uint32_t state[8];
+
+ uint32_t total[2];
+ size_t buflen; /* ≥ 0, ≤ 128 */
+ uint32_t buffer[32]; /* 128 bytes; the first buflen bytes are in use */
+};
+
+/* Initialize structure containing state of computation. */
+extern void sm3_init_ctx (struct sm3_ctx *ctx);
+
+/* Starting with the result of former calls of this function (or the
+ initialization function update the context for the next LEN bytes
+ starting at BUFFER.
+ It is necessary that LEN is a multiple of 64!!! */
+extern void sm3_process_block (const void *buffer, size_t len,
+ struct sm3_ctx *ctx);
+
+/* Starting with the result of former calls of this function (or the
+ initialization function update the context for the next LEN bytes
+ starting at BUFFER.
+ It is NOT required that LEN is a multiple of 64. */
+extern void sm3_process_bytes (const void *buffer, size_t len,
+ struct sm3_ctx *ctx);
+
+/* Process the remaining bytes in the buffer and put result from CTX
+ in first 32 bytes following RESBUF. The result is always in little
+ endian byte order, so that a byte-wise output yields to the wanted
+ ASCII representation of the message digest. */
+extern void *sm3_finish_ctx (struct sm3_ctx *ctx, void *restrict resbuf);
+
+/* Put result from CTX in first 32 bytes following RESBUF. The result is
+ always in little endian byte order, so that a byte-wise output yields
+ to the wanted ASCII representation of the message digest. */
+extern void *sm3_read_ctx (const struct sm3_ctx *ctx, void *restrict resbuf);
+
+/* Compute SM3 message digest for LEN bytes beginning at BUFFER. The
+ result is always in little endian byte order, so that a byte-wise
+ output yields to the wanted ASCII representation of the message
+ digest. */
+extern void *sm3_buffer (const char *buffer, size_t len,
+ void *restrict resblock);
+
+# endif
+
+/* Compute SM3 message digest for bytes read from STREAM. The
+ resulting message digest number will be written into the 32 bytes
+ beginning at RESBLOCK. */
+extern int sm3_stream (FILE *stream, void *resblock);
+
+
+# ifdef __cplusplus
+}
+# endif
+
+#endif
+
+/*
+ * Hey Emacs!
+ * Local Variables:
+ * coding: utf-8
+ * End:
+ */