linux-6.8/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
185 	 * Establish the apt_cutoff based on the presumed entropy rate of  in jent_apt_init()
202  * @ec [in] Reference to entropy collector
213  * Insert a new entropy event into APT
215  * @ec [in] Reference to entropy collector
262  * @ec [in] Reference to entropy collector
273 		 * In addition, we require an entropy value H of 1/osr as this  in jent_rct_insert()
274 		 * is the minimum entropy required to provide full entropy.  in jent_rct_insert()
276 		 * deltas for inserting them into the entropy pool which should  in jent_rct_insert()
277 		 * then have (close to) DATA_SIZE_BITS bits of entropy in the  in jent_rct_insert()
314  * @ec [in] Reference to entropy collector
350  * @ec [in] Reference to entropy collector
374  * an entropy collection.
413  * entropy pool using a hash.
415  * ec [in] entropy collector
420  * updated hash context in the entropy collector or error code
459  * @ec [in] Reference to the entropy collector with the memory access data -- if
504  * Start of entropy processing logic
507  * This is the heart of the entropy generation: calculate time deltas and
509  * entropy pool.
515  * @ec [in] Reference to entropy collector
543 	/* return the raw entropy value */  in jent_measure_jitter()
554  * @ec [in] Reference to entropy collector
581  * Entry function: Obtain entropy for the caller.
583  * This function invokes the entropy gathering logic as often to generate
584  * as many bytes as requested by the caller. The entropy gathering logic
587  * This function truncates the last 64 bit entropy value output to the exact
590  * @ec [in] Reference to entropy collector
714 	 * health test entropy data is used to further still the available  in jent_entropy_init()
715 	 * entropy pool.  in jent_entropy_init()
744 	 * jitter entropy that could potentially be caught here. But  in jent_entropy_init()
767 		/* Invoke core entropy collection logic */  in jent_entropy_init()