docs/cmdline: change to .md for cmdline docs
- switch all invidual files documenting command line options into .md,
as the documentation is now markdown-looking.
- made the parser treat 4-space indents as quotes
- switch to building the curl.1 manpage using the "mainpage.idx" file,
which lists the files to include to generate it, instead of using the
previous page-footer/headers. Also, those files are now also .md
ones, using the same format. I gave them underscore prefixes to make
them sort separately:
_NAME.md, _SYNOPSIS.md, _DESCRIPTION.md, _URL.md, _GLOBBING.md,
_VARIABLES.md, _OUTPUT.md, _PROTOCOLS.md, _PROGRESS.md, _VERSION.md,
_OPTIONS.md, _FILES.md, _ENVIRONMENT.md, _PROXYPREFIX.md,
_EXITCODES.md, _BUGS.md, _AUTHORS.md, _WWW.md, _SEEALSO.md
- updated test cases accordingly
Closes #12751
2024-01-21 01:18:43 +03:00
|
|
|
---
|
2023-01-02 15:51:48 +03:00
|
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
2022-06-14 01:12:03 +03:00
|
|
|
SPDX-License-Identifier: curl
|
2016-11-16 01:44:58 +03:00
|
|
|
Long: ftp-method
|
|
|
|
Arg: <method>
|
|
|
|
Help: Control CWD usage
|
|
|
|
Protocols: FTP
|
|
|
|
Added: 7.15.1
|
2020-07-13 15:15:04 +03:00
|
|
|
Category: ftp
|
2022-10-18 11:39:43 +03:00
|
|
|
Multi: single
|
docs/cmdline: change to .md for cmdline docs
- switch all invidual files documenting command line options into .md,
as the documentation is now markdown-looking.
- made the parser treat 4-space indents as quotes
- switch to building the curl.1 manpage using the "mainpage.idx" file,
which lists the files to include to generate it, instead of using the
previous page-footer/headers. Also, those files are now also .md
ones, using the same format. I gave them underscore prefixes to make
them sort separately:
_NAME.md, _SYNOPSIS.md, _DESCRIPTION.md, _URL.md, _GLOBBING.md,
_VARIABLES.md, _OUTPUT.md, _PROTOCOLS.md, _PROGRESS.md, _VERSION.md,
_OPTIONS.md, _FILES.md, _ENVIRONMENT.md, _PROXYPREFIX.md,
_EXITCODES.md, _BUGS.md, _AUTHORS.md, _WWW.md, _SEEALSO.md
- updated test cases accordingly
Closes #12751
2024-01-21 01:18:43 +03:00
|
|
|
See-also:
|
|
|
|
- list-only
|
|
|
|
Example:
|
|
|
|
- --ftp-method multicwd ftp://example.com/dir1/dir2/file
|
|
|
|
- --ftp-method nocwd ftp://example.com/dir1/dir2/file
|
|
|
|
- --ftp-method singlecwd ftp://example.com/dir1/dir2/file
|
2016-11-16 01:44:58 +03:00
|
|
|
---
|
docs/cmdline: change to .md for cmdline docs
- switch all invidual files documenting command line options into .md,
as the documentation is now markdown-looking.
- made the parser treat 4-space indents as quotes
- switch to building the curl.1 manpage using the "mainpage.idx" file,
which lists the files to include to generate it, instead of using the
previous page-footer/headers. Also, those files are now also .md
ones, using the same format. I gave them underscore prefixes to make
them sort separately:
_NAME.md, _SYNOPSIS.md, _DESCRIPTION.md, _URL.md, _GLOBBING.md,
_VARIABLES.md, _OUTPUT.md, _PROTOCOLS.md, _PROGRESS.md, _VERSION.md,
_OPTIONS.md, _FILES.md, _ENVIRONMENT.md, _PROXYPREFIX.md,
_EXITCODES.md, _BUGS.md, _AUTHORS.md, _WWW.md, _SEEALSO.md
- updated test cases accordingly
Closes #12751
2024-01-21 01:18:43 +03:00
|
|
|
|
|
|
|
# `--ftp-method`
|
|
|
|
|
2016-11-16 01:44:58 +03:00
|
|
|
Control what method curl should use to reach a file on an FTP(S)
|
|
|
|
server. The method argument should be one of the following alternatives:
|
2024-01-09 12:36:14 +03:00
|
|
|
|
|
|
|
## multicwd
|
2024-03-12 12:34:58 +03:00
|
|
|
Do a single CWD operation for each path part in the given URL. For deep
|
|
|
|
hierarchies this means many commands. This is how RFC 1738 says it should be
|
|
|
|
done. This is the default but the slowest behavior.
|
2024-01-09 12:36:14 +03:00
|
|
|
|
|
|
|
## nocwd
|
2024-03-12 12:34:58 +03:00
|
|
|
Do no CWD at all. curl does SIZE, RETR, STOR etc and gives the full path to
|
|
|
|
the server for each of these commands. This is the fastest behavior.
|
2024-01-09 12:36:14 +03:00
|
|
|
|
|
|
|
## singlecwd
|
2024-03-12 12:34:58 +03:00
|
|
|
Do one CWD with the full target directory and then operate on the file
|
2022-08-23 14:42:49 +03:00
|
|
|
"normally" (like in the multicwd case). This is somewhat more standards
|
2024-03-12 12:34:58 +03:00
|
|
|
compliant than `nocwd` but without the full penalty of `multicwd`.
|