.\" generated by cd2nroff 0.1 from CURLINFO_NAMELOOKUP_TIME_T.md .TH CURLINFO_NAMELOOKUP_TIME_T 3 "2024-10-20" libcurl .SH NAME CURLINFO_NAMELOOKUP_TIME_T \- get the name lookup time in microseconds .SH SYNOPSIS .nf #include CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_NAMELOOKUP_TIME_T, curl_off_t *timep); .fi .SH DESCRIPTION Pass a pointer to a curl_off_t to receive the total time in microseconds from the start until the name resolving was completed. When a redirect is followed, the time from each request is added together. See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page. .SH PROTOCOLS This functionality affects all supported protocols .SH EXAMPLE .nf int main(void) { CURL *curl = curl_easy_init(); if(curl) { CURLcode res; curl_off_t namelookup; curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); res = curl_easy_perform(curl); if(CURLE_OK == res) { res = curl_easy_getinfo(curl, CURLINFO_NAMELOOKUP_TIME_T, &namelookup); if(CURLE_OK == res) { printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", namelookup / 1000000, (long)(namelookup % 1000000)); } } /* always cleanup */ curl_easy_cleanup(curl); } } .fi .SH AVAILABILITY Added in curl 7.61.0 .SH RETURN VALUE Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. .SH SEE ALSO .BR CURLINFO_NAMELOOKUP_TIME (3), .BR curl_easy_getinfo (3), .BR curl_easy_setopt (3)