Mercurial > hgrepos > Python2 > PyMuPDF

comparison mupdf-source/thirdparty/curl/docs/libcurl/opts/CURLOPT_DEFAULT_PROTOCOL.3 @ 2:b50eed0cc0ef upstream

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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_DEFAULT_PROTOCOL 3 "18 Aug 2015" "libcurl 7.45.0" "curl_easy_setopt options"
24 .SH NAME
25 CURLOPT_DEFAULT_PROTOCOL \- default protocol to use if the URL is missing a
26 scheme name
27 .SH SYNOPSIS
28 #include <curl/curl.h>
29
30 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DEFAULT_PROTOCOL, char
31 *protocol);
32 .SH DESCRIPTION
33 This option tells libcurl to use \fIprotocol\fP if the URL is missing a scheme
34 name.
35
36 Use one of these protocol (scheme) names:
37
38 dict, file, ftp, ftps, gopher, http, https, imap, imaps, ldap, ldaps, pop3,
39 pop3s, rtsp, scp, sftp, smb, smbs, smtp, smtps, telnet, tftp
40
41 An unknown or unsupported protocol causes error
42 \fICURLE_UNSUPPORTED_PROTOCOL\fP when libcurl parses a schemeless URL. Parsing
43 happens when \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP is
44 called. The protocols supported by libcurl will vary depending on how it was
45 built. Use \fIcurl_version_info(3)\fP if you need a list of protocol names
46 supported by the build of libcurl that you are using.
47
48 This option does not change the default proxy protocol (http).
49
50 Without this option libcurl would make a guess based on the host, see
51 \fICURLOPT_URL(3)\fP for details.
52
53 The application does not have to keep the string around after setting this
54 option.
55 .SH DEFAULT
56 NULL (make a guess based on the host)
57 .SH PROTOCOLS
58 All
59 .SH EXAMPLE
60 .nf
61 curl = curl_easy_init();
62 if(curl) {
63 /* set a URL without a scheme */
64 curl_easy_setopt(curl, CURLOPT_URL, "example.com");
65
66 /* set the default protocol (scheme) for schemeless URLs */
67 curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
68
69 /* Perform the request */
70 curl_easy_perform(curl);
71 }
72 .fi
73 .SH AVAILABILITY
74 Added in 7.45.0
75 .SH RETURN VALUE
76 CURLE_OK if the option is supported.
77
78 CURLE_OUT_OF_MEMORY if there was insufficient heap space.
79
80 CURLE_UNKNOWN_OPTION if the option is not supported.
81 .SH "SEE ALSO"
82 .BR CURLOPT_URL "(3), "