Mercurial > hgrepos > Python2 > PyMuPDF
comparison mupdf-source/thirdparty/curl/docs/libcurl/opts/CURLOPT_USERAGENT.3 @ 2:b50eed0cc0ef upstream
ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4.
The directory name has changed: no version number in the expanded directory now.
| author | Franz Glasner <fzglas.hg@dom66.de> |
|---|---|
| date | Mon, 15 Sep 2025 11:43:07 +0200 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 1:1d09e1dec1d9 | 2:b50eed0cc0ef |
|---|---|
| 1 .\" ************************************************************************** | |
| 2 .\" * _ _ ____ _ | |
| 3 .\" * Project ___| | | | _ \| | | |
| 4 .\" * / __| | | | |_) | | | |
| 5 .\" * | (__| |_| | _ <| |___ | |
| 6 .\" * \___|\___/|_| \_\_____| | |
| 7 .\" * | |
| 8 .\" * Copyright (C) 1998 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al. | |
| 9 .\" * | |
| 10 .\" * This software is licensed as described in the file COPYING, which | |
| 11 .\" * you should have received as part of this distribution. The terms | |
| 12 .\" * are also available at https://curl.haxx.se/docs/copyright.html. | |
| 13 .\" * | |
| 14 .\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell | |
| 15 .\" * copies of the Software, and permit persons to whom the Software is | |
| 16 .\" * furnished to do so, under the terms of the COPYING file. | |
| 17 .\" * | |
| 18 .\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY | |
| 19 .\" * KIND, either express or implied. | |
| 20 .\" * | |
| 21 .\" ************************************************************************** | |
| 22 .\" | |
| 23 .TH CURLOPT_USERAGENT 3 "17 Jun 2014" "libcurl 7.37.0" "curl_easy_setopt options" | |
| 24 .SH NAME | |
| 25 CURLOPT_USERAGENT \- set HTTP user-agent header | |
| 26 .SH SYNOPSIS | |
| 27 #include <curl/curl.h> | |
| 28 | |
| 29 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERAGENT, char *ua); | |
| 30 .SH DESCRIPTION | |
| 31 Pass a pointer to a zero terminated string as parameter. It will be used to | |
| 32 set the User-Agent: header in the HTTP request sent to the remote server. This | |
| 33 can be used to fool servers or scripts. You can also set any custom header | |
| 34 with \fICURLOPT_HTTPHEADER(3)\fP. | |
| 35 | |
| 36 The application does not have to keep the string around after setting this | |
| 37 option. | |
| 38 .SH DEFAULT | |
| 39 NULL, no User-Agent: header is used by default. | |
| 40 .SH PROTOCOLS | |
| 41 HTTP, HTTPS | |
| 42 .SH EXAMPLE | |
| 43 .nf | |
| 44 CURL *curl = curl_easy_init(); | |
| 45 if(curl) { | |
| 46 curl_easy_setopt(curl, CURLOPT_URL, "http://example.com"); | |
| 47 | |
| 48 curl_easy_setopt(curl, CURLOPT_USERAGENT, "Dark Secret Ninja/1.0"); | |
| 49 | |
| 50 curl_easy_perform(curl); | |
| 51 } | |
| 52 .fi | |
| 53 .SH AVAILABILITY | |
| 54 As long as HTTP is supported | |
| 55 .SH RETURN VALUE | |
| 56 Returns CURLE_OK if HTTP is supported, CURLE_UNKNOWN_OPTION if not, or | |
| 57 CURLE_OUT_OF_MEMORY if there was insufficient heap space. | |
| 58 .SH "SEE ALSO" | |
| 59 .BR CURLOPT_REFERER "(3), " CURLOPT_HTTPHEADER "(3), " |