CURLOPT_TFTP_NO_OPTIONS man page

CURLOPT_TFTP_NO_OPTIONS — Do not send TFTP options requests.

Synopsis

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TFTP_NO_OPTIONS, long onoff);

Description

Set onoff to 1L to exclude all TFTP options defined in RFC2347, RFC2348 and RFC2349 from read and write requests (RRQs/WRQs).

This option improves interop with some legacy servers that do not acknowledge or properly implement TFTP options. When this option is used CURLOPT_TFTP_BLKSIZE(3) is ignored.

Default

0

Protocols

TFTP

Example

size_t write_callback(char *ptr, size_t size, size_t nmemb, void *fp)
{
  return fwrite(ptr, size, nmemb, (FILE *)fp);
}

CURL *curl = curl_easy_init();
if(curl) {
  FILE *fp = fopen("foo.bin", "wb");
  if(fp) {
    curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)fp);
    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);

    curl_easy_setopt(curl, CURLOPT_URL, "tftp://example.com/foo.bin");

    /* do not send TFTP options requests */
    curl_easy_setopt(curl, CURLOPT_TFTP_NO_OPTIONS, 1L);

    /* Perform the request */
    curl_easy_perform(curl);

    fclose(fp);
  }
  curl_easy_cleanup(curl);
}

Availability

Added in 7.48.0

Return Value

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.

Referenced By

curl_easy_setopt(3).

23 Feb 2016 libcurl 7.48.0 curl_easy_setopt options