Changeset View
Changeset View
Standalone View
Standalone View
share/man/man4/random.4
Show All 17 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd August 17, 2015 | .Dd August 23, 2018 XXXX FIXME!!! | ||||
cem: I'm sure you know, but update this on the date you commit it. | |||||
.Dt RANDOM 4 | .Dt RANDOM 4 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm random | .Nm random | ||||
.Nd the entropy device | .Nd the entropy device | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Cd "device random" | .Cd "device random" | ||||
.Cd "options RANDOM_LOADABLE" | .Cd "options RANDOM_LOADABLE" | ||||
▲ Show 20 Lines • Show All 113 Lines • ▼ Show 20 Lines | |||||
When | When | ||||
.Cd "options RANDOM_LOADABLE" | .Cd "options RANDOM_LOADABLE" | ||||
is used, | is used, | ||||
the | the | ||||
.Pa /dev/random | .Pa /dev/random | ||||
device is not created | device is not created | ||||
until an "algorithm module" | until an "algorithm module" | ||||
is loaded. | is loaded. | ||||
Two of these modules | The only module built by default is | ||||
are built by default, | .Em random_fortuna . | ||||
.Em random_fortuna | |||||
and | |||||
.Em random_yarrow . | |||||
The | The | ||||
Done Inline ActionsThis is an awkward sentence. I would suggest something like (ignoring mdoc formatting): "random_fortuna is the only algorithm module available." cem: This is an awkward sentence. I would suggest something like (ignoring mdoc formatting)… | |||||
.Em random_yarrow | .Em random_yarrow | ||||
module is deprecated, | module was removed in | ||||
and will be removed in | |||||
.Fx 12. | .Fx 12 . | ||||
Use of the Yarrow algorithm | Note that this loadable module | ||||
Done Inline ActionsI think this "The" can also be deleted. bcr: I think this "The" can also be deleted. | |||||
Done Inline ActionsFixed, thanks! markm: Fixed, thanks! | |||||
is not encouraged, | is slightly less efficient | ||||
Done Inline ActionsYou are allowed to use the full 79-80 characters in manual page lines :-). cem: You are allowed to use the full 79-80 characters in manual page lines :-). | |||||
Done Inline ActionsI know, but many years ago it was pointed out that breaking sentences into phrases very often made diffs shorter. :-) It seems that nobody else does that any more so I'll stop too. markm: I know, but many years ago it was pointed out that breaking sentences into phrases very often… | |||||
but while still present | than its compiled-in equivalent. | ||||
in the kernel source, | |||||
it can be selected with the | |||||
.Cd "options RANDOM_YARROW" | |||||
kernel option. | |||||
Note that these loadable modules | |||||
are slightly less efficient | |||||
than their compiled-in equivalents. | |||||
This is because some functions | This is because some functions | ||||
must be locked against | must be locked against | ||||
load and unload events, | load and unload events, | ||||
and also must be indirect calls | and also must be indirect calls | ||||
to allow for removal. | to allow for removal. | ||||
.Pp | .Pp | ||||
When | When | ||||
.Cd "options RANDOM_ENABLE_UMA" | .Cd "options RANDOM_ENABLE_UMA" | ||||
▲ Show 20 Lines • Show All 162 Lines • ▼ Show 20 Lines | |||||
It replaces the previous | It replaces the previous | ||||
.Em Yarrow | .Em Yarrow | ||||
implementation, | implementation, | ||||
introduced in | introduced in | ||||
.Fx 5.0 . | .Fx 5.0 . | ||||
The Yarrow algorithm | The Yarrow algorithm | ||||
is no longer supported | is no longer supported | ||||
by its authors, | by its authors, | ||||
and is therefore deprecated. | and is therefore no longer available. | ||||
Done Inline ActionsDitto -- no need for the really short lines and they make it a bit harder to read. cem: Ditto -- no need for the really short lines and they make it a bit harder to read. |
I'm sure you know, but update this on the date you commit it.