[PATCH 05/10] score: Add Hash Handler
Sebastian Huber
sebastian.huber at embedded-brains.de
Wed Feb 24 13:57:25 UTC 2021
Update #4267.
---
cpukit/include/rtems/score/hash.h | 168 ++++++++++++++++++++++++++++++
cpukit/score/src/hash.c | 76 ++++++++++++++
spec/build/cpukit/librtemscpu.yml | 1 +
3 files changed, 245 insertions(+)
create mode 100644 cpukit/include/rtems/score/hash.h
create mode 100644 cpukit/score/src/hash.c
diff --git a/cpukit/include/rtems/score/hash.h b/cpukit/include/rtems/score/hash.h
new file mode 100644
index 0000000000..8a269cc548
--- /dev/null
+++ b/cpukit/include/rtems/score/hash.h
@@ -0,0 +1,168 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreHash
+ *
+ * @brief This header file provides the interfaces of the
+ * @ref RTEMSScoreHash.
+ */
+
+/*
+ * Copyright (C) 2021 embedded brains GmbH (http://www.embedded-brains.de)
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef _RTEMS_SCORE_HASH_H
+#define _RTEMS_SCORE_HASH_H
+
+#include <rtems/score/basedefs.h>
+
+#include <sha256.h>
+#include <string.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup RTEMSScoreHash Hash Handler
+ *
+ * @brief This group contains the Hash Handler implementation.
+ *
+ * @{
+ */
+
+/**
+ * @brief This constant represents the size of a hash string.
+ *
+ * Accounts for a NUL termination of the hash string.
+ */
+#define HASH_CONTROL_STRING_SIZE 45
+
+/**
+ * @brief This type represents a hash value.
+ *
+ * The hash value is produced by _Hash_Finalize().
+ */
+typedef struct {
+ /**
+ * @brief This member contains the hash value encoded as a base64url string.
+ *
+ * The string is NUL-terminated.
+ */
+ char chars[ HASH_CONTROL_STRING_SIZE ];
+} Hash_Control;
+
+/**
+ * @brief Gets the hash value as a NUL-terminated string.
+ *
+ * @param hash is the hash value.
+ *
+ * @return Returns the hash value as a NUL-terminated string.
+ */
+RTEMS_INLINE_ROUTINE const char *_Hash_Get_string( const Hash_Control *hash )
+{
+ return &hash->chars[ 0 ];
+}
+
+/**
+ * @brief This type represents the context to compute a hash value.
+ */
+typedef struct {
+ /**
+ * @brief This member contains the hash algorithm context.
+ */
+ SHA256_CTX Context;
+
+ /**
+ * @brief This member references a hash value if needed.
+ */
+ Hash_Control *hash;
+
+ /**
+ * @brief This member contains an index into the hash value bytes if needed.
+ */
+ size_t index;
+} Hash_Context;
+
+/**
+ * @brief Initializes the hash context.
+ *
+ * @param[out] context is the hash context to initialize.
+ */
+RTEMS_INLINE_ROUTINE void _Hash_Initialize( Hash_Context *context )
+{
+ SHA256_Init( &context->Context );
+}
+
+/**
+ * @brief Adds the data to the hash value.
+ *
+ * @param[in, out] context is the hash context.
+ *
+ * @param begin is the begin address of the data to add.
+ *
+ * @param size is the size of the data in bytes.
+ */
+RTEMS_INLINE_ROUTINE void _Hash_Add_data(
+ Hash_Context *context,
+ const void *begin,
+ size_t size
+)
+{
+ SHA256_Update( &context->Context, begin, size );
+}
+
+/**
+ * @brief Adds the string to the hash value.
+ *
+ * @param[in, out] context is the hash context.
+ *
+ * @param str is the string to add.
+ */
+RTEMS_INLINE_ROUTINE void _Hash_Add_string(
+ Hash_Context *context,
+ const char *str
+)
+{
+ SHA256_Update( &context->Context, str, strlen( str ) );
+}
+
+/**
+ * @brief Finalizes the hash value computation and produces the hash value.
+ *
+ * @param[in, out] context is the hash context.
+ *
+ * @param[out] hash is the hash control to store the produced hash value.
+ */
+void _Hash_Finalize( Hash_Context *context, Hash_Control *hash );
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _RTEMS_SCORE_HASH_H */
diff --git a/cpukit/score/src/hash.c b/cpukit/score/src/hash.c
new file mode 100644
index 0000000000..42ea7f0582
--- /dev/null
+++ b/cpukit/score/src/hash.c
@@ -0,0 +1,76 @@
+/* SPDX-License-Identifier: BSD-2-Clause */
+
+/**
+ * @file
+ *
+ * @ingroup RTEMSScoreHash
+ *
+ * @brief This source file the implementation of _Hash_Finalize().
+ */
+
+/*
+ * Copyright (C) 2021 embedded brains GmbH (http://www.embedded-brains.de)
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <rtems/score/hash.h>
+#include <rtems/score/assert.h>
+#include <rtems/score/io.h>
+
+#include <limits.h>
+
+static void _Hash_Put_char( int c, void *arg )
+{
+ Hash_Context *context;
+ size_t index;
+
+ context = arg;
+ index = context->index;
+ _Assert( index < sizeof( context->hash->chars ) );
+ context->hash->chars[ context->index ] = (char) c;
+ context->index = index + 1;
+}
+
+void _Hash_Finalize( Hash_Context *context, Hash_Control *hash )
+{
+ unsigned char digest[ 32 ];
+ int n;
+
+ SHA256_Final( digest, &context->Context );
+ context->hash = hash;
+ context->index = 0;
+ hash->chars[ sizeof( *hash ) - 1 ] = '\0';
+ n = _IO_Base64url(
+ _Hash_Put_char,
+ context,
+ digest,
+ sizeof( digest ),
+ NULL,
+ INT_MAX
+ );
+ _Assert_Unused_variable_equals( n, sizeof( *hash ) - 1 );
+}
diff --git a/spec/build/cpukit/librtemscpu.yml b/spec/build/cpukit/librtemscpu.yml
index c79d046af1..0eac92906c 100644
--- a/spec/build/cpukit/librtemscpu.yml
+++ b/spec/build/cpukit/librtemscpu.yml
@@ -1399,6 +1399,7 @@ source:
- cpukit/score/src/debugisthreaddispatchingallowed.c
- cpukit/score/src/freechain.c
- cpukit/score/src/futex.c
+- cpukit/score/src/hash.c
- cpukit/score/src/heap.c
- cpukit/score/src/heapallocate.c
- cpukit/score/src/heapextend.c
--
2.26.2
More information about the devel
mailing list