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