diff options
Diffstat (limited to 'secure/lib/libcrypto/man/RAND_add.3')
| -rw-r--r-- | secure/lib/libcrypto/man/RAND_add.3 | 62 |
1 files changed, 33 insertions, 29 deletions
diff --git a/secure/lib/libcrypto/man/RAND_add.3 b/secure/lib/libcrypto/man/RAND_add.3 index f4cf817089513..1dcc9382eec1d 100644 --- a/secure/lib/libcrypto/man/RAND_add.3 +++ b/secure/lib/libcrypto/man/RAND_add.3 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35) +.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== @@ -54,16 +54,20 @@ .\" Avoid warning from groff about undefined register 'F'. .de IX .. -.if !\nF .nr F 0 -.if \nF>0 \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" +.nr rF 0 +.if \n(.g .if rF .nr rF 1 +.if (\n(rF:(\n(.g==0)) \{\ +. if \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" .. -. if !\nF==2 \{\ -. nr % 0 -. nr F 2 +. if !\nF==2 \{\ +. nr % 0 +. nr F 2 +. \} . \} .\} +.rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. @@ -129,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "RAND_ADD 3" -.TH RAND_ADD 3 "2018-11-20" "1.1.1a" "OpenSSL" +.TH RAND_ADD 3 "2019-02-26" "1.1.1b" "OpenSSL" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -163,20 +167,20 @@ Deprecated: These functions can be used to seed the random generator and to check its seeded state. In general, manual (re\-)seeding of the default OpenSSL random generator -(\fIRAND_OpenSSL\fR\|(3)) is not necessary (but allowed), since it does (re\-)seed +(\fBRAND_OpenSSL\fR\|(3)) is not necessary (but allowed), since it does (re\-)seed itself automatically using trusted system entropy sources. This holds unless the default \s-1RAND_METHOD\s0 has been replaced or OpenSSL was -built with automatic reseeding disabled, see \s-1\fIRAND\s0\fR\|(7) for more details. +built with automatic reseeding disabled, see \s-1\fBRAND\s0\fR\|(7) for more details. .PP -\&\fIRAND_status()\fR indicates whether or not the random generator has been sufficiently -seeded. If not, functions such as \fIRAND_bytes\fR\|(3) will fail. +\&\fBRAND_status()\fR indicates whether or not the random generator has been sufficiently +seeded. If not, functions such as \fBRAND_bytes\fR\|(3) will fail. .PP -\&\fIRAND_poll()\fR uses the system's capabilities to seed the random generator using +\&\fBRAND_poll()\fR uses the system's capabilities to seed the random generator using random input obtained from polling various trusted entropy sources. The default choice of the entropy source can be modified at build time, -see \s-1\fIRAND\s0\fR\|(7) for more details. +see \s-1\fBRAND\s0\fR\|(7) for more details. .PP -\&\fIRAND_add()\fR mixes the \fBnum\fR bytes at \fBbuf\fR into the internal state +\&\fBRAND_add()\fR mixes the \fBnum\fR bytes at \fBbuf\fR into the internal state of the random generator. This function will not normally be needed, as mentioned above. The \fBrandomness\fR argument is an estimate of how much randomness is @@ -186,41 +190,41 @@ Details about sources of randomness and how to estimate their randomness can be found in the literature; for example [\s-1NIST SP 800\-90B\s0]. The content of \fBbuf\fR cannot be recovered from subsequent random generator output. Applications that intend to save and restore random state in an external file -should consider using \fIRAND_load_file\fR\|(3) instead. +should consider using \fBRAND_load_file\fR\|(3) instead. .PP -\&\fIRAND_seed()\fR is equivalent to \fIRAND_add()\fR with \fBrandomness\fR set to \fBnum\fR. +\&\fBRAND_seed()\fR is equivalent to \fBRAND_add()\fR with \fBrandomness\fR set to \fBnum\fR. .PP -\&\fIRAND_keep_random_devices_open()\fR is used to control file descriptor +\&\fBRAND_keep_random_devices_open()\fR is used to control file descriptor usage by the random seed sources. Some seed sources maintain open file descriptors by default, which allows such sources to operate in a -\&\fIchroot\fR\|(2) jail without the associated device nodes being available. When +\&\fBchroot\fR\|(2) jail without the associated device nodes being available. When the \fBkeep\fR argument is zero, this call disables the retention of file descriptors. Conversely, a non-zero argument enables the retention of file descriptors. This function is usually called during initialization and it takes effect immediately. .PP -\&\fIRAND_event()\fR and \fIRAND_screen()\fR are equivalent to \fIRAND_poll()\fR and exist +\&\fBRAND_event()\fR and \fBRAND_screen()\fR are equivalent to \fBRAND_poll()\fR and exist for compatibility reasons only. See \s-1HISTORY\s0 section below. .SH "RETURN VALUES" .IX Header "RETURN VALUES" -\&\fIRAND_status()\fR returns 1 if the random generator has been seeded +\&\fBRAND_status()\fR returns 1 if the random generator has been seeded with enough data, 0 otherwise. .PP -\&\fIRAND_poll()\fR returns 1 if it generated seed data, 0 otherwise. +\&\fBRAND_poll()\fR returns 1 if it generated seed data, 0 otherwise. .PP -\&\fIRAND_event()\fR returns \fIRAND_status()\fR. +\&\fBRAND_event()\fR returns \fBRAND_status()\fR. .PP The other functions do not return values. .SH "HISTORY" .IX Header "HISTORY" -\&\fIRAND_event()\fR and \fIRAND_screen()\fR were deprecated in OpenSSL 1.1.0 and should +\&\fBRAND_event()\fR and \fBRAND_screen()\fR were deprecated in OpenSSL 1.1.0 and should not be used. .SH "SEE ALSO" .IX Header "SEE ALSO" -\&\fIRAND_bytes\fR\|(3), -\&\fIRAND_egd\fR\|(3), -\&\fIRAND_load_file\fR\|(3), -\&\s-1\fIRAND\s0\fR\|(7) +\&\fBRAND_bytes\fR\|(3), +\&\fBRAND_egd\fR\|(3), +\&\fBRAND_load_file\fR\|(3), +\&\s-1\fBRAND\s0\fR\|(7) .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright 2000\-2018 The OpenSSL Project Authors. All Rights Reserved. |