From b55a697c676bec213476fdf1525e9291c5d4aaf6 Mon Sep 17 00:00:00 2001
From: schwarze <>
Date: Thu, 3 Nov 2016 15:48:22 +0000
Subject: convert RAND manuals from pod to mdoc

---
 src/lib/libcrypto/man/RAND_load_file.3 | 68 ++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 src/lib/libcrypto/man/RAND_load_file.3

(limited to 'src/lib/libcrypto/man/RAND_load_file.3')

diff --git a/src/lib/libcrypto/man/RAND_load_file.3 b/src/lib/libcrypto/man/RAND_load_file.3
new file mode 100644
index 0000000000..fb521a8e9c
--- /dev/null
+++ b/src/lib/libcrypto/man/RAND_load_file.3
@@ -0,0 +1,68 @@
+.Dd $Mdocdate: November 3 2016 $
+.Dt RAND_LOAD_FILE 3
+.Os
+.Sh NAME
+.Nm RAND_load_file ,
+.Nm RAND_write_file ,
+.Nm RAND_file_name
+.Nd PRNG seed file
+.Sh SYNOPSIS
+.In openssl/rand.h
+.Ft const char *
+.Fo RAND_file_name
+.Fa "char *buf"
+.Fa "size_t num"
+.Fc
+.Ft int
+.Fo RAND_load_file
+.Fa "const char *filename"
+.Fa "long max_bytes"
+.Fc
+.Ft int
+.Fo RAND_write_file
+.Fa "const char *filename"
+.Fc
+.Sh DESCRIPTION
+.Fn RAND_file_name
+returns a default path for the random seed file.
+.Fa buf
+points to a buffer of size
+.Fa num
+in which to store the filename.
+If
+.Fa num
+is too small for the path name, an error occurs.
+.Pp
+.Fn RAND_load_file
+used to allow for the state of the random number generator to be
+controlled by external sources.
+.Pp
+It is kept for ABI compatibility but is no longer functional, and should
+not used in new programs.
+.Pp
+.Fn RAND_write_file
+writes a number of random bytes (currently 1024) to file
+.Fa filename .
+.Sh RETURN VALUES
+.Fn RAND_load_file
+always returns 0.
+.Pp
+.Fn RAND_write_file
+returns the number of bytes written, and -1 if the bytes written were
+generated without appropriate seed.
+.Pp
+.Fn RAND_file_name
+returns a pointer to
+.Fa buf
+on success, and
+.Dv NULL
+on error.
+.Sh SEE ALSO
+.Xr RAND_add 3 ,
+.Xr RAND_cleanup 3
+.Sh HISTORY
+.Fn RAND_load_file ,
+.Fn RAND_write_file ,
+and
+.Fn RAND_file_name
+are available in all versions of SSLeay and OpenSSL.
-- 
cgit v1.2.3-55-g6feb