]> git.ipfire.org Git - thirdparty/openssl.git/blobdiff - doc/man3/DES_random_key.pod
man: clarify the 'random number generator must be seeded' requirement
[thirdparty/openssl.git] / doc / man3 / DES_random_key.pod
index 4f0f25a5a4a0a5d785a81b21f5520b486a5c280a..a1480004e529a6ffe43d678c05d03bd9d79b8507 100644 (file)
@@ -104,9 +104,11 @@ consists of 8 bytes with odd parity.  The least significant bit in
 each byte is the parity bit.  The key schedule is an expanded form of
 the key; it is used to speed the encryption process.
 
-DES_random_key() generates a random key.  The PRNG must be seeded
-prior to using this function (see L<RAND_bytes(3)>).  If the PRNG
-could not generate a secure key, 0 is returned.
+DES_random_key() generates a random key.  The random generator must be
+seeded when calling this function.
+If the automatic seeding or reseeding of the OpenSSL CSPRNG fails due to
+external circumstances (see L<RAND(7)>), the operation will fail.
+If the function fails, 0 is returned.
 
 Before a DES key can be used, it must be converted into the
 architecture dependent I<DES_key_schedule> via the