| RAND_set_rand_method.3 (279264) | RAND_set_rand_method.3 (273399) |
|---|---|
| 1.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28) | 1.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.28) |
| 2.\" 3.\" Standard preamble: 4.\" ======================================================================== 5.de Sp \" Vertical space (when we can't use .PP) 6.if t .sp .5v 7.if n .sp 8.. 9.de Vb \" Begin verbatim text --- 23 unchanged lines hidden (view full) --- 33. ds C` "" 34. ds C' "" 35'br\} 36.el\{\ 37. ds -- \|\(em\| 38. ds PI \(*p 39. ds L" `` 40. ds R" '' | 2.\" 3.\" Standard preamble: 4.\" ======================================================================== 5.de Sp \" Vertical space (when we can't use .PP) 6.if t .sp .5v 7.if n .sp 8.. 9.de Vb \" Begin verbatim text --- 23 unchanged lines hidden (view full) --- 33. ds C` "" 34. ds C' "" 35'br\} 36.el\{\ 37. ds -- \|\(em\| 38. ds PI \(*p 39. ds L" `` 40. ds R" '' |
| 41. ds C` 42. ds C' | |
| 43'br\} 44.\" 45.\" Escape single quotes in literal strings from groff's Unicode transform. 46.ie \n(.g .ds Aq \(aq 47.el .ds Aq ' 48.\" 49.\" If the F register is turned on, we'll generate index entries on stderr for 50.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index 51.\" entries marked with X<> in POD. Of course, you'll have to process the 52.\" output yourself in some meaningful fashion. | 41'br\} 42.\" 43.\" Escape single quotes in literal strings from groff's Unicode transform. 44.ie \n(.g .ds Aq \(aq 45.el .ds Aq ' 46.\" 47.\" If the F register is turned on, we'll generate index entries on stderr for 48.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index 49.\" entries marked with X<> in POD. Of course, you'll have to process the 50.\" output yourself in some meaningful fashion. |
| 53.\" 54.\" Avoid warning from groff about undefined register 'F'. 55.de IX | 51.ie \nF \{\ 52. de IX 53. tm Index:\\$1\t\\n%\t"\\$2" |
| 56.. | 54.. |
| 57.nr rF 0 58.if \n(.g .if rF .nr rF 1 59.if (\n(rF:(\n(.g==0)) \{ 60. if \nF \{ 61. de IX 62. tm Index:\\$1\t\\n%\t"\\$2" | 55. nr % 0 56. rr F 57.\} 58.el \{\ 59. de IX |
| 63.. | 60.. |
| 64. if !\nF==2 \{ 65. nr % 0 66. nr F 2 67. \} 68. \} | |
| 69.\} | 61.\} |
| 70.rr rF | |
| 71.\" 72.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). 73.\" Fear. Run. Save yourself. No user-serviceable parts. 74. \" fudge factors for nroff and troff 75.if n \{\ 76. ds #H 0 77. ds #V .8m 78. ds #F .3m --- 49 unchanged lines hidden (view full) --- 128. ds Th \o'LP' 129. ds ae ae 130. ds Ae AE 131.\} 132.rm #[ #] #H #V #F C 133.\" ======================================================================== 134.\" 135.IX Title "RAND_set_rand_method 3" | 62.\" 63.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). 64.\" Fear. Run. Save yourself. No user-serviceable parts. 65. \" fudge factors for nroff and troff 66.if n \{\ 67. ds #H 0 68. ds #V .8m 69. ds #F .3m --- 49 unchanged lines hidden (view full) --- 119. ds Th \o'LP' 120. ds ae ae 121. ds Ae AE 122.\} 123.rm #[ #] #H #V #F C 124.\" ======================================================================== 125.\" 126.IX Title "RAND_set_rand_method 3" |
| 136.TH RAND_set_rand_method 3 "2015-01-15" "1.0.1l" "OpenSSL" | 127.TH RAND_set_rand_method 3 "2014-10-15" "1.0.1j" "OpenSSL" |
| 137.\" For nroff, turn off justification. Always turn off hyphenation; it makes 138.\" way too many mistakes in technical documents. 139.if n .ad l 140.nh 141.SH "NAME" 142RAND_set_rand_method, RAND_get_rand_method, RAND_SSLeay \- select RAND method 143.SH "SYNOPSIS" 144.IX Header "SYNOPSIS" --- 6 unchanged lines hidden (view full) --- 151\& 152\& RAND_METHOD *RAND_SSLeay(void); 153.Ve 154.SH "DESCRIPTION" 155.IX Header "DESCRIPTION" 156A \fB\s-1RAND_METHOD\s0\fR specifies the functions that OpenSSL uses for random number 157generation. By modifying the method, alternative implementations such as 158hardware RNGs may be used. \s-1IMPORTANT:\s0 See the \s-1NOTES\s0 section for important | 128.\" For nroff, turn off justification. Always turn off hyphenation; it makes 129.\" way too many mistakes in technical documents. 130.if n .ad l 131.nh 132.SH "NAME" 133RAND_set_rand_method, RAND_get_rand_method, RAND_SSLeay \- select RAND method 134.SH "SYNOPSIS" 135.IX Header "SYNOPSIS" --- 6 unchanged lines hidden (view full) --- 142\& 143\& RAND_METHOD *RAND_SSLeay(void); 144.Ve 145.SH "DESCRIPTION" 146.IX Header "DESCRIPTION" 147A \fB\s-1RAND_METHOD\s0\fR specifies the functions that OpenSSL uses for random number 148generation. By modifying the method, alternative implementations such as 149hardware RNGs may be used. \s-1IMPORTANT:\s0 See the \s-1NOTES\s0 section for important |
| 159information about how these \s-1RAND API\s0 functions are affected by the use of | 150information about how these \s-1RAND\s0 \s-1API\s0 functions are affected by the use of |
| 160\&\fB\s-1ENGINE\s0\fR \s-1API\s0 calls. 161.PP 162Initially, the default \s-1RAND_METHOD\s0 is the OpenSSL internal implementation, as 163returned by \fIRAND_SSLeay()\fR. 164.PP 165\&\fIRAND_set_default_method()\fR makes \fBmeth\fR the method for \s-1PRNG\s0 use. \fB\s-1NB\s0\fR: This is | 151\&\fB\s-1ENGINE\s0\fR \s-1API\s0 calls. 152.PP 153Initially, the default \s-1RAND_METHOD\s0 is the OpenSSL internal implementation, as 154returned by \fIRAND_SSLeay()\fR. 155.PP 156\&\fIRAND_set_default_method()\fR makes \fBmeth\fR the method for \s-1PRNG\s0 use. \fB\s-1NB\s0\fR: This is |
| 166true only whilst no \s-1ENGINE\s0 has been set as a default for \s-1RAND,\s0 so this function | 157true only whilst no \s-1ENGINE\s0 has been set as a default for \s-1RAND\s0, so this function |
| 167is no longer recommended. 168.PP | 158is no longer recommended. 159.PP |
| 169\&\fIRAND_get_default_method()\fR returns a pointer to the current \s-1RAND_METHOD.\s0 170However, the meaningfulness of this result is dependent on whether the \s-1ENGINE 171API\s0 is being used, so this function is no longer recommended. | 160\&\fIRAND_get_default_method()\fR returns a pointer to the current \s-1RAND_METHOD\s0. 161However, the meaningfulness of this result is dependent on whether the \s-1ENGINE\s0 162\&\s-1API\s0 is being used, so this function is no longer recommended. |
| 172.SH "THE RAND_METHOD STRUCTURE" 173.IX Header "THE RAND_METHOD STRUCTURE" 174.Vb 9 175\& typedef struct rand_meth_st 176\& { 177\& void (*seed)(const void *buf, int num); 178\& int (*bytes)(unsigned char *buf, int num); 179\& void (*cleanup)(void); --- 9 unchanged lines hidden (view full) --- 189Each component may be \s-1NULL\s0 if the function is not implemented. 190.SH "RETURN VALUES" 191.IX Header "RETURN VALUES" 192\&\fIRAND_set_rand_method()\fR returns no value. \fIRAND_get_rand_method()\fR and 193\&\fIRAND_SSLeay()\fR return pointers to the respective methods. 194.SH "NOTES" 195.IX Header "NOTES" 196As of version 0.9.7, \s-1RAND_METHOD\s0 implementations are grouped together with other | 163.SH "THE RAND_METHOD STRUCTURE" 164.IX Header "THE RAND_METHOD STRUCTURE" 165.Vb 9 166\& typedef struct rand_meth_st 167\& { 168\& void (*seed)(const void *buf, int num); 169\& int (*bytes)(unsigned char *buf, int num); 170\& void (*cleanup)(void); --- 9 unchanged lines hidden (view full) --- 180Each component may be \s-1NULL\s0 if the function is not implemented. 181.SH "RETURN VALUES" 182.IX Header "RETURN VALUES" 183\&\fIRAND_set_rand_method()\fR returns no value. \fIRAND_get_rand_method()\fR and 184\&\fIRAND_SSLeay()\fR return pointers to the respective methods. 185.SH "NOTES" 186.IX Header "NOTES" 187As of version 0.9.7, \s-1RAND_METHOD\s0 implementations are grouped together with other |
| 197algorithmic APIs (eg. \s-1RSA_METHOD, EVP_CIPHER,\s0 etc) in \fB\s-1ENGINE\s0\fR modules. If a 198default \s-1ENGINE\s0 is specified for \s-1RAND\s0 functionality using an \s-1ENGINE API\s0 function, 199that will override any \s-1RAND\s0 defaults set using the \s-1RAND API \s0(ie. 200\&\fIRAND_set_rand_method()\fR). For this reason, the \s-1ENGINE API\s0 is the recommended way | 188algorithmic APIs (eg. \s-1RSA_METHOD\s0, \s-1EVP_CIPHER\s0, etc) in \fB\s-1ENGINE\s0\fR modules. If a 189default \s-1ENGINE\s0 is specified for \s-1RAND\s0 functionality using an \s-1ENGINE\s0 \s-1API\s0 function, 190that will override any \s-1RAND\s0 defaults set using the \s-1RAND\s0 \s-1API\s0 (ie. 191\&\fIRAND_set_rand_method()\fR). For this reason, the \s-1ENGINE\s0 \s-1API\s0 is the recommended way |
| 201to control default implementations for use in \s-1RAND\s0 and other cryptographic 202algorithms. 203.SH "SEE ALSO" 204.IX Header "SEE ALSO" 205\&\fIrand\fR\|(3), \fIengine\fR\|(3) 206.SH "HISTORY" 207.IX Header "HISTORY" 208\&\fIRAND_set_rand_method()\fR, \fIRAND_get_rand_method()\fR and \fIRAND_SSLeay()\fR are 209available in all versions of OpenSSL. 210.PP 211In the engine version of version 0.9.6, \fIRAND_set_rand_method()\fR was altered to 212take an \s-1ENGINE\s0 pointer as its argument. As of version 0.9.7, that has been | 192to control default implementations for use in \s-1RAND\s0 and other cryptographic 193algorithms. 194.SH "SEE ALSO" 195.IX Header "SEE ALSO" 196\&\fIrand\fR\|(3), \fIengine\fR\|(3) 197.SH "HISTORY" 198.IX Header "HISTORY" 199\&\fIRAND_set_rand_method()\fR, \fIRAND_get_rand_method()\fR and \fIRAND_SSLeay()\fR are 200available in all versions of OpenSSL. 201.PP 202In the engine version of version 0.9.6, \fIRAND_set_rand_method()\fR was altered to 203take an \s-1ENGINE\s0 pointer as its argument. As of version 0.9.7, that has been |
| 213reverted as the \s-1ENGINE API\s0 transparently overrides \s-1RAND\s0 defaults if used, 214otherwise \s-1RAND API\s0 functions work as before. \fIRAND_set_rand_engine()\fR was also | 204reverted as the \s-1ENGINE\s0 \s-1API\s0 transparently overrides \s-1RAND\s0 defaults if used, 205otherwise \s-1RAND\s0 \s-1API\s0 functions work as before. \fIRAND_set_rand_engine()\fR was also |
| 215introduced in version 0.9.7. | 206introduced in version 0.9.7. |