OrgZephyr/zephyr
OrgZephyr
/
zephyr
mirror of https://github.com/zephyrproject-rtos/zephyr.git
1
0
Fork 0
Code Issues Releases Wiki Activity
zephyr/subsys/random/Kconfig

56 lines
1.7 KiB
Plaintext
Raw Normal View History

subsys: Add random subsystem Some "random" drivers are not drivers at all: they just implement the function `sys_rand32_get()`. Move those to a random subsystem in preparation for a reorganization. Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 06:45:02 +08:00
# Kconfig - random configuration options
#
# Copyright (c) 2017 Intel Corporation
#
# SPDX-License-Identifier: Apache-2.0
#
config TEST_RANDOM_GENERATOR
subsys: kconfig: Remove 'default n' properties and clean up a bit Bool symbols implicitly default to 'n'. A 'default n' can make sense e.g. in a Kconfig.defconfig file, if you want to override a 'default y' on the base definition of the symbol. It isn't used like that on any of these symbols though. Remove some 'default ""' properties on string symbols too. Also make definitions more consistent by converting some config FOO <type> prompt "foo" definitions to a shorter form: config FOO <type> "foo" This shorthand works for int/hex/string symbols too, not just for bool symbols. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-07-12 19:26:29 +08:00
bool "Non-random number generator"
drivers: Rename `random` to `entropy` This should clear up some of the confusion with random number generators and drivers that obtain entropy from the hardware. Also, many hardware number generators have limited bandwidth, so it's natural for their output to be only used for seeding a random number generator. Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 07:30:55 +08:00
depends on !ENTROPY_HAS_DRIVER
subsys: Add random subsystem Some "random" drivers are not drivers at all: they just implement the function `sys_rand32_get()`. Move those to a random subsystem in preparation for a reorganization. Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 06:45:02 +08:00
help
This option signifies that the kernel's random number APIs are
permitted to return values that are not truly random.
This capability is provided for testing purposes, when a truly random
number generator is not available. The non-random number generator
should not be used in a production environment.
subsys/random: Add Xoroshiro128+ PRNG This adds an implementation of Xoroshiro128+ PRNG, based on the original implementation at [1]. This pseudorandom number generator will use the entropy driver to obtain the seed. While it uses only 128 bits of state, it's pretty robust for non-crypto safe applications. [1] http://vigna.di.unimi.it/xorshift/xoroshiro128plus.c Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 08:07:53 +08:00
choice
prompt "Random generator"
default ENTROPY_DEVICE_RANDOM_GENERATOR
subsys: Add random subsystem Some "random" drivers are not drivers at all: they just implement the function `sys_rand32_get()`. Move those to a random subsystem in preparation for a reorganization. Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 06:45:02 +08:00
config X86_TSC_RANDOM_GENERATOR
subsys: kconfig: Remove 'default n' properties and clean up a bit Bool symbols implicitly default to 'n'. A 'default n' can make sense e.g. in a Kconfig.defconfig file, if you want to override a 'default y' on the base definition of the symbol. It isn't used like that on any of these symbols though. Remove some 'default ""' properties on string symbols too. Also make definitions more consistent by converting some config FOO <type> prompt "foo" definitions to a shorter form: config FOO <type> "foo" This shorthand works for int/hex/string symbols too, not just for bool symbols. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-07-12 19:26:29 +08:00
bool "x86 timestamp counter based number generator"
subsys: Add random subsystem Some "random" drivers are not drivers at all: they just implement the function `sys_rand32_get()`. Move those to a random subsystem in preparation for a reorganization. Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 06:45:02 +08:00
depends on TEST_RANDOM_GENERATOR && X86
help
This options enables number generator based on timestamp counter
of x86 boards, obtained with rdtsc instruction.
config TIMER_RANDOM_GENERATOR
subsys: kconfig: Remove 'default n' properties and clean up a bit Bool symbols implicitly default to 'n'. A 'default n' can make sense e.g. in a Kconfig.defconfig file, if you want to override a 'default y' on the base definition of the symbol. It isn't used like that on any of these symbols though. Remove some 'default ""' properties on string symbols too. Also make definitions more consistent by converting some config FOO <type> prompt "foo" definitions to a shorter form: config FOO <type> "foo" This shorthand works for int/hex/string symbols too, not just for bool symbols. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-07-12 19:26:29 +08:00
bool "System timer clock based number generator"
subsys: Add random subsystem Some "random" drivers are not drivers at all: they just implement the function `sys_rand32_get()`. Move those to a random subsystem in preparation for a reorganization. Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 06:45:02 +08:00
depends on TEST_RANDOM_GENERATOR
help
This options enables number generator based on system timer
clock. This number generator is not random and used for
testing only.
subsys/random: sys_rand32_get() implementation that uses entropy API Instead of every hardware number generator driver providing an implementation of this function, use the random device API to centralize the implementation of this function. This is a very simplistic function that can be seen as a stepping stone to refactor the random number generation in Zephyr. Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 07:06:16 +08:00
config ENTROPY_DEVICE_RANDOM_GENERATOR
subsys: kconfig: Remove 'default n' properties and clean up a bit Bool symbols implicitly default to 'n'. A 'default n' can make sense e.g. in a Kconfig.defconfig file, if you want to override a 'default y' on the base definition of the symbol. It isn't used like that on any of these symbols though. Remove some 'default ""' properties on string symbols too. Also make definitions more consistent by converting some config FOO <type> prompt "foo" definitions to a shorter form: config FOO <type> "foo" This shorthand works for int/hex/string symbols too, not just for bool symbols. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-07-12 19:26:29 +08:00
bool "Use entropy driver to generate random numbers"
subsys/random: sys_rand32_get() implementation that uses entropy API Instead of every hardware number generator driver providing an implementation of this function, use the random device API to centralize the implementation of this function. This is a very simplistic function that can be seen as a stepping stone to refactor the random number generation in Zephyr. Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 07:06:16 +08:00
depends on ENTROPY_HAS_DRIVER
help
Enables a random number generator that uses the enabled
hardware entropy gathering driver to generate random
numbers.
subsys/random: Add Xoroshiro128+ PRNG This adds an implementation of Xoroshiro128+ PRNG, based on the original implementation at [1]. This pseudorandom number generator will use the entropy driver to obtain the seed. While it uses only 128 bits of state, it's pretty robust for non-crypto safe applications. [1] http://vigna.di.unimi.it/xorshift/xoroshiro128plus.c Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 08:07:53 +08:00
config XOROSHIRO_RANDOM_GENERATOR
subsys: kconfig: Remove 'default n' properties and clean up a bit Bool symbols implicitly default to 'n'. A 'default n' can make sense e.g. in a Kconfig.defconfig file, if you want to override a 'default y' on the base definition of the symbol. It isn't used like that on any of these symbols though. Remove some 'default ""' properties on string symbols too. Also make definitions more consistent by converting some config FOO <type> prompt "foo" definitions to a shorter form: config FOO <type> "foo" This shorthand works for int/hex/string symbols too, not just for bool symbols. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-07-12 19:26:29 +08:00
bool "Use Xoroshiro128+ as PRNG"
subsys/random: Add Xoroshiro128+ PRNG This adds an implementation of Xoroshiro128+ PRNG, based on the original implementation at [1]. This pseudorandom number generator will use the entropy driver to obtain the seed. While it uses only 128 bits of state, it's pretty robust for non-crypto safe applications. [1] http://vigna.di.unimi.it/xorshift/xoroshiro128plus.c Signed-off-by: Leandro Pereira <leandro.pereira@intel.com>
2017-10-14 08:07:53 +08:00
depends on ENTROPY_HAS_DRIVER
help
Enables the Xoroshiro128+ pseudo-random number generator, that
uses the entropy driver as a seed source. This is not a
cryptographically secure random number generator.
It is so named because it uses 128 bits of state.
endchoice