xref: /curl/docs/libcurl/opts/CURLOPT_EGDSOCKET.md (revision e3fe0200)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_EGDSOCKET
5Section: 3
6Source: libcurl
7See-also:
8  - CURLOPT_RANDOM_FILE (3)
9Protocol:
10  - TLS
11TLS-backend:
12  - OpenSSL
13---
14
15# NAME
16
17CURLOPT_EGDSOCKET - EGD socket path
18
19# SYNOPSIS
20
21~~~c
22#include <curl/curl.h>
23
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_EGDSOCKET, char *path);
25~~~
26
27# DESCRIPTION
28
29Deprecated option. It serves no purpose anymore.
30
31Pass a char pointer to the null-terminated path name to the Entropy Gathering
32Daemon socket. It is used to seed the random engine for TLS.
33
34The application does not have to keep the string around after setting this
35option.
36
37# DEFAULT
38
39NULL
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_EGDSOCKET, "/var/egd.socket");
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 if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
66CURLE_OUT_OF_MEMORY if there was insufficient heap space.
67