1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_RANDOM_FILE
5Section: 3
6Source: libcurl
7See-also:
8  - CURLOPT_EGDSOCKET (3)
9Protocol:
10  - TLS
11TLS-backend:
12  - OpenSSL
13---
14
15# NAME
16
17CURLOPT_RANDOM_FILE - file to read random data from
18
19# SYNOPSIS
20
21~~~c
22#include <curl/curl.h>
23
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RANDOM_FILE, char *path);
25~~~
26
27# DESCRIPTION
28
29Deprecated option. It serves no purpose anymore.
30
31Pass a char pointer to a null-terminated filename. The file might be used to
32read from to seed the random engine for SSL and more.
33
34The application does not have to keep the string around after setting this
35option.
36
37# DEFAULT
38
39NULL, not used
40
41# EXAMPLE
42
43~~~c
44int main(void)
45{
46  CURL *curl = curl_easy_init();
47  if(curl) {
48    CURLcode res;
49    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
50    curl_easy_setopt(curl, CURLOPT_RANDOM_FILE, "junk.txt");
51    res = curl_easy_perform(curl);
52    curl_easy_cleanup(curl);
53  }
54}
55~~~
56
57# AVAILABILITY
58
59Only with OpenSSL versions before 1.1.0.
60
61This option was deprecated in 7.84.0.
62
63# RETURN VALUE
64
65Returns CURLE_OK on success or
66CURLE_OUT_OF_MEMORY if there was insufficient heap space.
67