Newer
Older
/* NEVER EVER edit this manually, fix the mkhelp script instead! */
#include <stdio.h>
void hugehelp(void)
{
puts (
" _ _ ____ _ \n"
" Project ___| | | | _ \\| | \n"
" / __| | | | |_) | | \n"
" | (__| |_| | _ <| |___ \n"
" \\___|\\___/|_| \\_\\_____|\n"
"NAME\n"
" curl - get a URL with FTP, TELNET, LDAP, GOPHER, DICT,\n"
" FILE, HTTP or HTTPS syntax.\n"
" curl is a client to get documents/files from servers,\n"
" using any of the supported protocols. The command is\n"
" designed to work without user interaction or any kind of\n"
" interactivity.\n"
" curl offers a busload of useful tricks like proxy support,\n"
" user authentication, ftp upload, HTTP post, SSL (https:)\n"
" connections, cookies, file transfer resume and more.\n"
" The URL syntax is protocol dependent. You'll find a\n"
" detailed description in RFC 2396.\n"
" You can specify multiple URLs or parts of URLs by writing\n"
" part sets within braces as in:\n"
" or you can get sequences of alphanumeric series by using\n"
" [] as in:\n"
" ftp://ftp.numericals.com/file[1-100].txt\n"
" ftp://ftp.numericals.com/file[001-100].txt (with lead-\n"
" ing zeros)\n"
" ftp://ftp.letters.com/file[a-z].txt\n"
" It is possible to specify up to 9 sets or series for a\n"
" URL, but no nesting is supported at the moment:\n"
" http://www.any.org/archive[1996-1999]/vol-\n"
" ume[1-4]part{a,b,c,index}.html\n"
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
" -a/--append\n"
" (FTP) When used in a ftp upload, this will tell\n"
" curl to append to the target file instead of over-\n"
" writing it. If the file doesn't exist, it will be\n"
" created.\n"
"\n"
" -A/--user-agent <agent string>\n"
" (HTTP) Specify the User-Agent string to send to the\n"
" HTTP server. Some badly done CGIs fail if its not\n"
" set to \"Mozilla/4.0\". To encode blanks in the\n"
" string, surround the string with single quote\n"
" marks. This can also be set with the -H/--header\n"
" flag of course.\n"
" -b/--cookie <name=data>\n"
" (HTTP) Pass the data to the HTTP server as a\n"
" cookie. It is supposedly the data previously\n"
" received from the server in a \"Set-Cookie:\" line.\n"
" The data should be in the format \"NAME1=VALUE1;\n"
" NAME2=VALUE2\".\n"
"\n"
" If no '=' letter is used in the line, it is treated\n"
" as a filename to use to read previously stored\n"
" cookie lines from, which should be used in this\n"
" session if they match. Using this method also acti-\n"
" vates the \"cookie parser\" which will make curl\n"
" record incoming cookies too, which may be handy if\n"
" you're using this in combination with the\n"
" -L/--location option. The file format of the file\n"
" to read cookies from should be plain HTTP headers\n"
" or the netscape cookie file format.\n"
"\n"
" NOTE that the file specified with -b/--cookie is\n"
" only used as input. No cookies will be stored in\n"
" the file. To store cookies, save the HTTP headers\n"
" to a file using -D/--dump-header!\n"
"\n"
" -B/--ftp-ascii\n"
" (FTP/LDAP) Use ASCII transfer when getting an FTP\n"
" file or LDAP info. For FTP, this can also be\n"
" enforced by using an URL that ends with \";type=A\".\n"
"\n"
" -c/--continue\n"
" Continue/Resume a previous file transfer. This\n"
" instructs curl to continue appending data on the\n"
" file where it was previously left, possibly because\n"
" of a broken connection to the server. There must be\n"
" a named physical file to append to for this to\n"
" work. Note: Upload resume is depening on a command\n"
" named SIZE not always present in all ftp servers!\n"
" Upload resume is for FTP only. HTTP resume is only\n"
" possible with HTTP/1.1 or later servers.\n"
"\n"
" -C/--continue-at <offset>\n"
" Continue/Resume a previous file transfer at the\n"
" given offset. The given offset is the exact number\n"
" of bytes that will be skipped counted from the\n"
" beginning of the source file before it is trans-\n"
" fered to the destination. If used with uploads,\n"
" the ftp server command SIZE will not be used by\n"
" curl. Upload resume is for FTP only. HTTP resume\n"
" is only possible with HTTP/1.1 or later servers.\n"
"\n"
" -d/--data <data>\n"
" (HTTP) Sends the specified data in a POST request\n"
" to the HTTP server. Note that the data is sent\n"
" exactly as specified with no extra processing. The\n"
" data is expected to be \"url-encoded\". This will\n"
" cause curl to pass the data to the server using the\n"
" content-type application/x-www-form-urlencoded.\n"
" Compare to -F.\n"
"\n"
" If you start the data with the letter @, the rest\n"
" should be a file name to read the data from, or -\n"
" if you want curl to read the data from stdin. The\n"
" contents of the file must already be url-encoded.\n"
"\n"
" -D/--dump-header <file>\n"
" (HTTP/FTP) Write the HTTP headers to this file.\n"
" Write the FTP file info to this file if -I/--head\n"
" is used.\n"
"\n"
" This option is handy to use when you want to store\n"
" the cookies that a HTTP site sends to you. The\n"
" cookies could then be read in a second curl invoke\n"
" by using the -b/--cookie option!\n"
"\n"
" -e/--referer <URL>\n"
" (HTTP) Sends the \"Referer Page\" information to the\n"
" HTTP server. Some badly done CGIs fail if it's not\n"
" set. This can also be set with the -H/--header flag\n"
" of course.\n"
"\n"
" -E/--cert <certificate[:password]>\n"
" (HTTPS) Tells curl to use the specified certificate\n"
" file when getting a file with HTTPS. The certifi-\n"
" cate must be in PEM format. If the optional pass-\n"
" word isn't specified, it will be queried for on the\n"
" terminal. Note that this certificate is the private\n"
" key and the private certificate concatenated!\n"
"\n"
" -f/--fail\n"
" (HTTP) Fail silently (no output at all) on server\n"
" errors. This is mostly done like this to better\n"
" enable scripts etc to better deal with failed\n"
" attempts. In normal cases when a HTTP server fails\n"
" to deliver a document, it returns a HTML document\n"
" stating so (which often also describes why and\n"
" more). This flag will prevent curl from outputting\n"
" that and fail silently instead.\n"
"\n"
" -F/--form <name=content>\n"
" (HTTP) This lets curl emulate a filled in form in\n"
" which a user has pressed the submit button. This\n"
" causes curl to POST data using the content-type\n"
" multipart/form-data according to RFC1867. This\n"
" enables uploading of binary files etc. To force the\n"
" 'content' part to be read from a file, prefix the\n"
" file name with an @ sign. Example, to send your\n"
" password file to the server, where 'password' is\n"
" the name of the form-field to which /etc/passwd\n"
" will be the input:\n"
" curl -F password=@/etc/passwd www.mypasswords.com\n"
"\n"
" To read the file's content from stdin insted of a\n"
" file, use - where the file name should've been.\n"
"\n"
" -h/--help\n"
" Usage help.\n"
"\n"
" -H/--header <header>\n"
" (HTTP) Extra header to use when getting a web page.\n"
" You may specify any number of extra headers. Note\n"
" that if you should add a custom header that has the\n"
" same name as one of the internal ones curl would\n"
" use, your externally set header will be used\n"
" instead of the internal one. This allows you to\n"
" make even trickier stuff than curl would normally\n"
" do. You should not replace internally set headers\n"
" without knowing perfectly well what you're doing.\n"
"\n"
" -i/--include\n"
" (HTTP) Include the HTTP-header in the output. The\n"
" HTTP-header includes things like server-name, date\n"
" of the document, HTTP-version and more...\n"
"\n"
" -I/--head\n"
" (HTTP/FTP) Fetch the HTTP-header only! HTTP-servers\n"
" feature the command HEAD which this uses to get\n"
" nothing but the header of a document. When used on\n"
Loading
Loading full blame…