mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-22 02:20:40 +00:00
crypto: jitter - drop kernel-doc notation
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 Signed-off-by: Herbert Xu <herbert@gondor.apana.org.au>
This commit is contained in:
parent
6880fa6c56
commit
04cb788ece
1 changed files with 12 additions and 12 deletions
|
@ -125,7 +125,7 @@ struct rand_data {
|
||||||
* This test complies with SP800-90B section 4.4.2.
|
* This test complies with SP800-90B section 4.4.2.
|
||||||
***************************************************************************/
|
***************************************************************************/
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Reset the APT counter
|
* Reset the APT counter
|
||||||
*
|
*
|
||||||
* @ec [in] Reference to entropy collector
|
* @ec [in] Reference to entropy collector
|
||||||
|
@ -138,7 +138,7 @@ static void jent_apt_reset(struct rand_data *ec, unsigned int delta_masked)
|
||||||
ec->apt_observations = 0;
|
ec->apt_observations = 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Insert a new entropy event into APT
|
* Insert a new entropy event into APT
|
||||||
*
|
*
|
||||||
* @ec [in] Reference to entropy collector
|
* @ec [in] Reference to entropy collector
|
||||||
|
@ -182,7 +182,7 @@ static void jent_apt_insert(struct rand_data *ec, unsigned int delta_masked)
|
||||||
* the end. The caller of the Jitter RNG is informed with an error code.
|
* 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
|
* Repetition Count Test as defined in SP800-90B section 4.4.1
|
||||||
*
|
*
|
||||||
* @ec [in] Reference to entropy collector
|
* @ec [in] Reference to entropy collector
|
||||||
|
@ -223,7 +223,7 @@ static void jent_rct_insert(struct rand_data *ec, int stuck)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Is there an RCT health test failure?
|
* Is there an RCT health test failure?
|
||||||
*
|
*
|
||||||
* @ec [in] Reference to entropy collector
|
* @ec [in] Reference to entropy collector
|
||||||
|
@ -246,7 +246,7 @@ static inline __u64 jent_delta(__u64 prev, __u64 next)
|
||||||
(JENT_UINT64_MAX - prev + 1 + next);
|
(JENT_UINT64_MAX - prev + 1 + next);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Stuck test by checking the:
|
* Stuck test by checking the:
|
||||||
* 1st derivative of the jitter measurement (time delta)
|
* 1st derivative of the jitter measurement (time delta)
|
||||||
* 2nd derivative of the jitter measurement (delta of time deltas)
|
* 2nd derivative of the jitter measurement (delta of time deltas)
|
||||||
|
@ -288,7 +288,7 @@ static int jent_stuck(struct rand_data *ec, __u64 current_delta)
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Report any health test failures
|
* Report any health test failures
|
||||||
*
|
*
|
||||||
* @ec [in] Reference to entropy collector
|
* @ec [in] Reference to entropy collector
|
||||||
|
@ -310,7 +310,7 @@ static int jent_health_failure(struct rand_data *ec)
|
||||||
* Noise sources
|
* Noise sources
|
||||||
***************************************************************************/
|
***************************************************************************/
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Update of the loop count used for the next round of
|
* Update of the loop count used for the next round of
|
||||||
* an entropy collection.
|
* an entropy collection.
|
||||||
*
|
*
|
||||||
|
@ -353,7 +353,7 @@ static __u64 jent_loop_shuffle(struct rand_data *ec,
|
||||||
return (shuffle + (1<<min));
|
return (shuffle + (1<<min));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* CPU Jitter noise source -- this is the noise source based on the CPU
|
* CPU Jitter noise source -- this is the noise source based on the CPU
|
||||||
* execution time jitter
|
* execution time jitter
|
||||||
*
|
*
|
||||||
|
@ -435,7 +435,7 @@ static void jent_lfsr_time(struct rand_data *ec, __u64 time, __u64 loop_cnt,
|
||||||
ec->data = new;
|
ec->data = new;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Memory Access noise source -- this is a noise source based on variations in
|
* Memory Access noise source -- this is a noise source based on variations in
|
||||||
* memory access times
|
* memory access times
|
||||||
*
|
*
|
||||||
|
@ -500,7 +500,7 @@ static void jent_memaccess(struct rand_data *ec, __u64 loop_cnt)
|
||||||
/***************************************************************************
|
/***************************************************************************
|
||||||
* Start of entropy processing logic
|
* Start of entropy processing logic
|
||||||
***************************************************************************/
|
***************************************************************************/
|
||||||
/**
|
/*
|
||||||
* This is the heart of the entropy generation: calculate time deltas and
|
* 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
|
* use the CPU jitter in the time deltas. The jitter is injected into the
|
||||||
* entropy pool.
|
* entropy pool.
|
||||||
|
@ -539,7 +539,7 @@ static int jent_measure_jitter(struct rand_data *ec)
|
||||||
return stuck;
|
return stuck;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Generator of one 64 bit random number
|
* Generator of one 64 bit random number
|
||||||
* Function fills rand_data->data
|
* Function fills rand_data->data
|
||||||
*
|
*
|
||||||
|
@ -566,7 +566,7 @@ static void jent_gen_entropy(struct rand_data *ec)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/*
|
||||||
* Entry function: Obtain entropy for the caller.
|
* Entry function: Obtain entropy for the caller.
|
||||||
*
|
*
|
||||||
* This function invokes the entropy gathering logic as often to generate
|
* This function invokes the entropy gathering logic as often to generate
|
||||||
|
|
Loading…
Reference in a new issue