diff mbox series

crypto: jitterentopy: drop kernel-doc notation

Message ID 20210824210513.25503-1-rdunlap@infradead.org
State Accepted
Commit 04cb788ecee8369c11edb7104775f30ed6247a26
Headers show
Series crypto: jitterentopy: drop kernel-doc notation | expand

Commit Message

Randy Dunlap Aug. 24, 2021, 9:05 p.m. UTC
Drop "begin kernel-doc (/**)" entries in jitterentropy.c
since they are not in kernel-doc format and they cause
many complaints (warnings) from scripts/kernel-doc.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Stephan Mueller <smueller@chronox.de>
Cc: Herbert Xu <herbert@gondor.apana.org.au>
Cc: "David S. Miller" <davem@davemloft.net>
Cc: linux-crypto@vger.kernel.org
---
 crypto/jitterentropy.c |   24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

Comments

Herbert Xu Sept. 17, 2021, 3:18 a.m. UTC | #1
Randy Dunlap <rdunlap@infradead.org> wrote:
> 

> Drop "begin kernel-doc (/**)" entries in jitterentropy.c

> since they are not in kernel-doc format and they cause

> many complaints (warnings) from scripts/kernel-doc.

> 

> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

> Cc: Stephan Mueller <smueller@chronox.de>

> Cc: Herbert Xu <herbert@gondor.apana.org.au>

> Cc: "David S. Miller" <davem@davemloft.net>

> Cc: linux-crypto@vger.kernel.org

> ---

> crypto/jitterentropy.c |   24 ++++++++++++------------

> 1 file changed, 12 insertions(+), 12 deletions(-)


Patch applied.  Thanks.
-- 
Email: Herbert Xu <herbert@gondor.apana.org.au>
Home Page: http://gondor.apana.org.au/~herbert/
PGP Key: http://gondor.apana.org.au/~herbert/pubkey.txt
diff mbox series

Patch

--- linux-next-20210824.orig/crypto/jitterentropy.c
+++ linux-next-20210824/crypto/jitterentropy.c
@@ -125,7 +125,7 @@  struct rand_data {
  * This test complies with SP800-90B section 4.4.2.
  ***************************************************************************/
 
-/**
+/*
  * Reset the APT counter
  *
  * @ec [in] Reference to entropy collector
@@ -138,7 +138,7 @@  static void jent_apt_reset(struct rand_d
 	ec->apt_observations = 0;
 }
 
-/**
+/*
  * Insert a new entropy event into APT
  *
  * @ec [in] Reference to entropy collector
@@ -182,7 +182,7 @@  static void jent_apt_insert(struct rand_
  * the end. The caller of the Jitter RNG is informed with an error code.
  ***************************************************************************/
 
-/**
+/*
  * Repetition Count Test as defined in SP800-90B section 4.4.1
  *
  * @ec [in] Reference to entropy collector
@@ -223,7 +223,7 @@  static void jent_rct_insert(struct rand_
 	}
 }
 
-/**
+/*
  * Is there an RCT health test failure?
  *
  * @ec [in] Reference to entropy collector
@@ -246,7 +246,7 @@  static inline __u64 jent_delta(__u64 pre
 			       (JENT_UINT64_MAX - prev + 1 + next);
 }
 
-/**
+/*
  * Stuck test by checking the:
  * 	1st derivative of the jitter measurement (time delta)
  * 	2nd derivative of the jitter measurement (delta of time deltas)
@@ -288,7 +288,7 @@  static int jent_stuck(struct rand_data *
 	return 0;
 }
 
-/**
+/*
  * Report any health test failures
  *
  * @ec [in] Reference to entropy collector
@@ -310,7 +310,7 @@  static int jent_health_failure(struct ra
  * Noise sources
  ***************************************************************************/
 
-/**
+/*
  * Update of the loop count used for the next round of
  * an entropy collection.
  *
@@ -353,7 +353,7 @@  static __u64 jent_loop_shuffle(struct ra
 	return (shuffle + (1<<min));
 }
 
-/**
+/*
  * CPU Jitter noise source -- this is the noise source based on the CPU
  *			      execution time jitter
  *
@@ -435,7 +435,7 @@  static void jent_lfsr_time(struct rand_d
 		ec->data = new;
 }
 
-/**
+/*
  * Memory Access noise source -- this is a noise source based on variations in
  *				 memory access times
  *
@@ -500,7 +500,7 @@  static void jent_memaccess(struct rand_d
 /***************************************************************************
  * Start of entropy processing logic
  ***************************************************************************/
-/**
+/*
  * This is the heart of the entropy generation: calculate time deltas and
  * use the CPU jitter in the time deltas. The jitter is injected into the
  * entropy pool.
@@ -539,7 +539,7 @@  static int jent_measure_jitter(struct ra
 	return stuck;
 }
 
-/**
+/*
  * Generator of one 64 bit random number
  * Function fills rand_data->data
  *
@@ -566,7 +566,7 @@  static void jent_gen_entropy(struct rand
 	}
 }
 
-/**
+/*
  * Entry function: Obtain entropy for the caller.
  *
  * This function invokes the entropy gathering logic as often to generate