linux-6.12.1/crypto/jitterentropy.c

63 /* The entropy pool */
71 	void *hash_state;		/* SENSITIVE hash state entropy pool */
110 					   * entropy, saves MEMORY_SIZE RAM for
111 					   * entropy collector */
134  * The output n bits can receive more than n bits of min entropy, of course,
136  * approach the output size bits of min entropy, not attain that bound. Random
138  * output entropy (that is what SP 800-90B Section 3.1.5.1.2 attempts to bound).
142  * that a string can be considered "full entropy" if you can bound the min
143  * entropy in each bit of output to at least 1-epsilon, where epsilon is
186 	 * Establish the apt_cutoff based on the presumed entropy rate of  in jent_apt_init()
203  * @ec [in] Reference to entropy collector
214  * Insert a new entropy event into APT
216  * @ec [in] Reference to entropy collector
263  * @ec [in] Reference to entropy collector
274 		 * In addition, we require an entropy value H of 1/osr as this  in jent_rct_insert()
275 		 * is the minimum entropy required to provide full entropy.  in jent_rct_insert()
277 		 * deltas for inserting them into the entropy pool which should  in jent_rct_insert()
278 		 * then have (close to) DATA_SIZE_BITS bits of entropy in the  in jent_rct_insert()
315  * @ec [in] Reference to entropy collector
351  * @ec [in] Reference to entropy collector
375  * an entropy collection.
414  * entropy pool using a hash.
416  * ec [in] entropy collector
421  * updated hash context in the entropy collector or error code
460  * @ec [in] Reference to the entropy collector with the memory access data -- if
505  * Start of entropy processing logic
508  * This is the heart of the entropy generation: calculate time deltas and
510  * entropy pool.
516  * @ec [in] Reference to entropy collector
544 	/* return the raw entropy value */  in jent_measure_jitter()
555  * @ec [in] Reference to entropy collector
582  * Entry function: Obtain entropy for the caller.
584  * This function invokes the entropy gathering logic as often to generate
585  * as many bytes as requested by the caller. The entropy gathering logic
588  * This function truncates the last 64 bit entropy value output to the exact
591  * @ec [in] Reference to entropy collector
712 	 * health test entropy data is used to further still the available  in jent_entropy_init()
713 	 * entropy pool.  in jent_entropy_init()
742 	 * jitter entropy that could potentially be caught here. But  in jent_entropy_init()
765 		/* Invoke core entropy collection logic */  in jent_entropy_init()