Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use randomness not entropy #3773

Closed
wants to merge 1 commit into from
Closed

Use randomness not entropy #3773

wants to merge 1 commit into from

Conversation

richsalz
Copy link
Contributor

This PR does not touch the crypto/rand directory which is being handled separately.

@richsalz richsalz added branch: master Merge to master branch approval: review pending This pull request needs review by a committer labels Jun 26, 2017
@richsalz richsalz self-assigned this Jun 26, 2017
sources of randomness and how to estimate their entropy can be found
in the literature, e.g. RFC 1750.
B<randomness> argument is an estimate of how much randomness is contained in
B<buf> and should be a nujbmer between zero and B<num>.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

number

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's no longer saying that it's in bytes, it might also be expressed in bits.

The contents of B<buf> is mixed into the entropy pool before retrieving
the new pseudo-random bytes unless disabled at compile time (see FAQ).
The contents of B<buf> is mixed into the randomness pool before retrieving
the new pseudo-random bytes.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is actually no longer the case.

@richsalz
Copy link
Contributor Author

Added a commit that addresses your feedback so far, @kroeckx .

@richsalz
Copy link
Contributor Author

ping. i have some more doc fixes to do after this.

apps/app_rand.c Outdated
/*
* If we did not manage to read the seed file, we should not write a
* low-entropy seed file back -- it would suppress a crucial warning
* low-random seed file back -- it would suppress a crucial warning
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"low-random" doesn't parse as English.

the EGD entropy gathering daemon can be used to collect entropy. It provides
a socket interface through which entropy can be gathered in chunks up to
On systems without /dev/*random devices providing randomness from the kernel,
EGD. It provides
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not a complete sentence.

@richsalz
Copy link
Contributor Author

Added commit with @kaduk's comments addressed.

apps/app_rand.c Outdated
* low-random seed file back -- it would suppress a crucial warning
* the next time we want to use it.
* If we didn't manage to read the seed file, don't write a
* file out -- it would suppress a crucial warning the next
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

side note: FreeBSD documentation style guide says to not use contractions. But of course we can have our own style.

levitte pushed a commit that referenced this pull request Jun 27, 2017
Reviewed-by: Ben Kaduk <kaduk@mit.edu>
(Merged from #3773)
@richsalz
Copy link
Contributor Author

thanks.
side-note: documentation, not code comments. :)
but now you've made me look at it. new PR coming up I think. It's a change from RAND work.

@richsalz richsalz closed this Jun 27, 2017
@richsalz richsalz deleted the randomness-not-entropy branch June 27, 2017 16:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approval: review pending This pull request needs review by a committer branch: master Merge to master branch
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants