The DRNG switch support allows replacing the DRNG mechanism of the
LRNG. The switching support rests on the interface definition of
include/linux/lrng.h. A new DRNG is implemented by filling in the
interface defined in this header file.
In addition to the DRNG, the extension also has to provide a hash
implementation that is used to hash the entropy pool for random number
extraction.
Note: It is permissible to implement a DRNG whose operations may sleep.
However, the hash function must not sleep.
The switchable DRNG support allows replacing the DRNG at runtime.
However, only one DRNG extension is allowed to be loaded at any given
time. Before replacing it with another DRNG implementation, the possibly
existing DRNG extension must be unloaded.
The switchable DRNG extension activates the new DRNG during load time.
It is expected, however, that such a DRNG switch would be done only once
by an administrator to load the intended DRNG implementation.
It is permissible to compile DRNG extensions either as kernel modules or
statically. The initialization of the DRNG extension should be performed
with a late_initcall to ensure the extension is available when user
space starts but after all other initialization completed.
The initialization is performed by registering the function call data
structure with the lrng_set_drng_cb function. In order to unload the
DRNG extension, lrng_set_drng_cb must be invoked with the NULL
parameter.
The DRNG extension should always provide a security strength that is at
least as strong as LRNG_DRNG_SECURITY_STRENGTH_BITS.
CC: "Eric W. Biederman" <ebiederm@xxxxxxxxxxxx>
CC: "Alexander E. Patrakov" <patrakov@xxxxxxxxx>
CC: "Ahmed S. Darwish" <darwish.07@xxxxxxxxx>
CC: "Theodore Y. Ts'o" <tytso@xxxxxxx>
CC: Willy Tarreau <w@xxxxxx>
CC: Matthew Garrett <mjg59@xxxxxxxxxxxxx>
CC: Vito Caputo <vcaputo@xxxxxxxxxxx>
CC: Andreas Dilger <adilger.kernel@xxxxxxxxx>
CC: Jan Kara <jack@xxxxxxx>
CC: Ray Strode <rstrode@xxxxxxxxxx>
CC: William Jon McCann <mccann@xxxxxxx>
CC: zhangjs <zachary@xxxxxxxxxxxxxxxx>
CC: Andy Lutomirski <luto@xxxxxxxxxx>
CC: Florian Weimer <fweimer@xxxxxxxxxx>
CC: Lennart Poettering <mzxreary@xxxxxxxxxxx>
CC: Nicolai Stange <nstange@xxxxxxx>
Reviewed-by: Marcelo Henrique Cerri <marcelo.cerri@xxxxxxxxxxxxx>
Reviewed-by: Roman Drahtmueller <draht@xxxxxxxxxxxxxx>
Tested-by: Roman Drahtmüller <draht@xxxxxxxxxxxxxx>
Tested-by: Marcelo Henrique Cerri <marcelo.cerri@xxxxxxxxxxxxx>
Tested-by: Neil Horman <nhorman@xxxxxxxxxx>
Signed-off-by: Stephan Mueller <smueller@xxxxxxxxxx>
---
drivers/char/lrng/Kconfig | 7 ++
drivers/char/lrng/Makefile | 1 +
drivers/char/lrng/lrng_switch.c | 198 ++++++++++++++++++++++++++++++++
3 files changed, 206 insertions(+)
create mode 100644 drivers/char/lrng/lrng_switch.c
diff --git a/drivers/char/lrng/Kconfig b/drivers/char/lrng/Kconfig
index edf8be6aa0b1..a468d8292bac 100644
--- a/drivers/char/lrng/Kconfig
+++ b/drivers/char/lrng/Kconfig
@@ -52,4 +52,11 @@ config LRNG_POOL_SIZE
default 4 if LRNG_POOL_SIZE_65536
default 5 if LRNG_POOL_SIZE_131072
+menuconfig LRNG_DRNG_SWITCH
+ bool "Support DRNG runtime switching"
+ help
+ The Linux RNG per default uses a ChaCha20 DRNG that is
+ accessible via the external interfaces. With this configuration
+ option other DRNGs can be selected and loaded at runtime.
+
endif # LRNG
diff --git a/drivers/char/lrng/Makefile b/drivers/char/lrng/Makefile
index b6240b73e33d..6bac97638767 100644
--- a/drivers/char/lrng/Makefile
+++ b/drivers/char/lrng/Makefile
@@ -10,3 +10,4 @@ obj-y += lrng_pool.o lrng_aux.o \
obj-$(CONFIG_NUMA) += lrng_numa.o
obj-$(CONFIG_SYSCTL) += lrng_proc.o
+obj-$(CONFIG_LRNG_DRNG_SWITCH) += lrng_switch.o
diff --git a/drivers/char/lrng/lrng_switch.c b/drivers/char/lrng/lrng_switch.c
new file mode 100644
index 000000000000..55eb4ed73258
--- /dev/null
+++ b/drivers/char/lrng/lrng_switch.c
@@ -0,0 +1,198 @@
+// SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause
+/*
+ * LRNG DRNG switching support
+ *
+ * Copyright (C) 2016 - 2019, Stephan Mueller <smueller@xxxxxxxxxx>
+ *
+ * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
+ * WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL THE AUTHOR 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 NOT ADVISED OF THE POSSIBILITY OF SUCH
+ * DAMAGE.
+ */
+
+#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
+
+#include <linux/lrng.h>
+
+#include "lrng_internal.h"
+
+static void lrng_sdrng_switch(struct lrng_sdrng *sdrng_store,
+ const struct lrng_crypto_cb *cb, int node)
+{
+ const struct lrng_crypto_cb *old_cb;
+ unsigned long flags = 0;
+ int ret;
+ u8 seed[LRNG_DRNG_SECURITY_STRENGTH_BYTES];
+ void *new_sdrng =
+ cb->lrng_drng_alloc(LRNG_DRNG_SECURITY_STRENGTH_BYTES);
+ void *old_sdrng, *new_hash = NULL, *old_hash = NULL;
+ bool sl = false, reset_sdrng = !lrng_get_available();
+
+ if (IS_ERR(new_sdrng)) {
+ pr_warn("could not allocate new secondary DRNG for NUMA node "
+ "%d (%ld)\n", node, PTR_ERR(new_sdrng));
+ return;
+ }
+
+#ifndef CONFIG_LRNG_TRNG_SUPPORT
+ new_hash = cb->lrng_hash_alloc(seed, sizeof(seed));
+#endif /* CONFIG_LRNG_TRNG_SUPPORT */
+ if (IS_ERR(new_hash)) {
+ pr_warn("could not allocate new LRNG pool hash (%ld)\n",
+ PTR_ERR(new_hash));
+ cb->lrng_drng_dealloc(new_sdrng);
+ return;
+ }
+
+ lrng_sdrng_lock(sdrng_store, &flags);
+
+ /*
+ * Pull from existing DRNG to seed new DRNG regardless of seed status
+ * of old DRNG -- the entropy state for the secondary DRNG is left
+ * unchanged which implies that als the new DRNG is reseeded when deemed
+ * necessary. This seeding of the new DRNG shall only ensure that the
+ * new DRNG has the same entropy as the old DRNG.
+ */
+ ret = sdrng_store->crypto_cb->lrng_drng_generate_helper(
+ sdrng_store->sdrng, seed, sizeof(seed));
+ lrng_sdrng_unlock(sdrng_store, &flags);
+
+ if (ret < 0) {
+ reset_sdrng = true;
+ pr_warn("getting random data from secondary DRNG failed for "
+ "NUMA node %d (%d)\n", node, ret);
+ } else {
+ /* seed new DRNG with data */
+ ret = cb->lrng_drng_seed_helper(new_sdrng, seed, ret);
+ if (ret < 0) {
+ reset_sdrng = true;
+ pr_warn("seeding of new secondary DRNG failed for NUMA "
+ "node %d (%d)\n", node, ret);
+ } else {
+ pr_debug("seeded new secondary DRNG of NUMA node %d "
+ "instance from old secondary DRNG instance\n",
+ node);
+ }
+ }
+
+ mutex_lock(&sdrng_store->lock);
+ /*
+ * If we switch the secondary DRNG from the initial ChaCha20 DRNG to
+ * something else, there is a lock transition from spin lock to mutex
+ * (see lrng_sdrng_is_atomic and how the lock is taken in
+ * lrng_sdrng_lock). Thus, we need to take both locks during the
+ * transition phase.
+ */
+ if (lrng_sdrng_is_atomic(sdrng_store)) {
+ spin_lock_irqsave(&sdrng_store->spin_lock, flags);
+ sl = true;
+ }
+
+ if (reset_sdrng)
+ lrng_sdrng_reset(sdrng_store);
+
+ old_sdrng = sdrng_store->sdrng;
+ old_cb = sdrng_store->crypto_cb;
+ sdrng_store->sdrng = new_sdrng;
+ sdrng_store->crypto_cb = cb;
+
+ if (new_hash) {
+ old_hash = sdrng_store->hash;
+ sdrng_store->hash = new_hash;
+ pr_info("Entropy pool read-hash allocated for DRNG for NUMA "
+ "node %d\n", node);
+ }
+
+ if (sl)
+ spin_unlock_irqrestore(&sdrng_store->spin_lock, flags);
+ mutex_unlock(&sdrng_store->lock);
+
+ /* Secondary ChaCha20 serves as atomic instance left untouched. */
+ if (old_sdrng != &secondary_chacha20) {
+ old_cb->lrng_drng_dealloc(old_sdrng);
+ if (old_hash)
+ old_cb->lrng_hash_dealloc(old_hash);
+ }
+
+ pr_info("secondary DRNG of NUMA node %d switched\n", node);
+}
+
+/**
+ * Switch the existing DRNG instances with new using the new crypto callbacks.
+ * The caller must hold the lrng_crypto_cb_update lock.
+ */
+static int lrng_drngs_switch(const struct lrng_crypto_cb *cb)
+{
+ struct lrng_sdrng **lrng_sdrng = lrng_sdrng_instances();
+ struct lrng_sdrng *lrng_sdrng_init = lrng_sdrng_init_instance();
+ int ret = lrng_trng_switch(cb);
+
+ if (ret)
+ return ret;
+
+ /* Update secondary DRNG */
+ if (lrng_sdrng) {
+ u32 node;
+
+ for_each_online_node(node) {
+ if (lrng_sdrng[node])
+ lrng_sdrng_switch(lrng_sdrng[node], cb, node);
+ }
+ } else
+ lrng_sdrng_switch(lrng_sdrng_init, cb, 0);
+
+ lrng_set_available();
+
+ return 0;
+}
+
+/**
+ * lrng_set_drng_cb - Register new cryptographic callback functions for DRNG
+ * The registering implies that all old DRNG states are replaced with new
+ * DRNG states.
+ * @cb: Callback functions to be registered -- if NULL, use the default
+ * callbacks pointing to the ChaCha20 DRNG.
+ * @return: 0 on success, < 0 on error
+ */
+int lrng_set_drng_cb(const struct lrng_crypto_cb *cb)
+{
+ struct lrng_sdrng *lrng_sdrng_init = lrng_sdrng_init_instance();
+ int ret;
+
+ if (!cb)
+ cb = &lrng_cc20_crypto_cb;
+
+ mutex_lock(&lrng_crypto_cb_update);
+
+ /*
+ * If a callback other than the default is set, allow it only to be
+ * set back to the default callback. This ensures that multiple
+ * different callbacks can be registered at the same time. If a
+ * callback different from the current callback and the default
+ * callback shall be set, the current callback must be deregistered
+ * (e.g. the kernel module providing it must be unloaded) and the new
+ * implementation can be registered.
+ */
+ if ((cb != &lrng_cc20_crypto_cb) &&
+ (lrng_sdrng_init->crypto_cb != &lrng_cc20_crypto_cb)) {
+ pr_warn("disallow setting new cipher callbacks, unload the old "
+ "callbacks first!\n");
+ ret = -EINVAL;
+ goto out;
+ }
+
+ ret = lrng_drngs_switch(cb);
+
+out:
+ mutex_unlock(&lrng_crypto_cb_update);
+ return ret;
+}
+EXPORT_SYMBOL(lrng_set_drng_cb);
--
2.23.0
