mirror of
https://github.com/curl/curl.git
synced 2025-02-05 14:30:10 +08:00
ef305de95c
The keyword specifies how option works when specified multiple times: - single: the last provided value replaces the earlier ones - append: it supports being provided multiple times - boolean: on/off values - mutex: flag-like option that disable anoter flag The 'gen.pl' script then outputs the proper and unified language for each option's multi-use behavior in the generated man page. The multi: header is requires in each .d file and will cause build error if missing or set to an unknown value. Closes #9759
37 lines
1.6 KiB
Makefile
37 lines
1.6 KiB
Makefile
c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Long: upload-file
|
|
Short: T
|
|
Arg: <file>
|
|
Help: Transfer local FILE to destination
|
|
Category: important upload
|
|
Example: -T file $URL
|
|
Example: -T "img[1-1000].png" ftp://ftp.example.com/
|
|
Example: --upload-file "{file1,file2}" $URL
|
|
Added: 4.0
|
|
See-also: get head
|
|
Multi: append
|
|
---
|
|
This transfers the specified local file to the remote URL. If there is no file
|
|
part in the specified URL, curl will append the local file name. NOTE that you
|
|
must use a trailing / on the last directory to really prove to Curl that there
|
|
is no file name or curl will think that your last directory name is the remote
|
|
file name to use. That will most likely cause the upload operation to fail. If
|
|
this is used on an HTTP(S) server, the PUT command will be used.
|
|
|
|
Use the file name "-" (a single dash) to use stdin instead of a given file.
|
|
Alternately, the file name "." (a single period) may be specified instead of
|
|
"-" to use stdin in non-blocking mode to allow reading server output while
|
|
stdin is being uploaded.
|
|
|
|
You can specify one --upload-file for each URL on the command line. Each
|
|
--upload-file + URL pair specifies what to upload and to where. curl also
|
|
supports "globbing" of the --upload-file argument, meaning that you can upload
|
|
multiple files to a single URL by using the same URL globbing style supported
|
|
in the URL.
|
|
|
|
When uploading to an SMTP server: the uploaded data is assumed to be RFC 5322
|
|
formatted. It has to feature the necessary set of headers and mail body
|
|
formatted correctly by the user as curl will not transcode nor encode it
|
|
further in any way.
|