| ascp: Transferring from the Command Line | |
Many command-line options are the same for ascp and ascp4; however, some options are available for only one or the behavior of an option is different. The following table lists the options that are available only for ascp or ascp4, and the options that are available with both. If the option behavior is different, the ascp option has ** added to the end and the difference is described following the table.
| ascp | ascp4 |
|---|---|
| -6 | |
| -@[range_low:range_high] | |
| -A, --version | -A, --version |
| --apply-local-docroot | |
| -C nodeid:nodecount | |
| -c cipher | |
| --check-sshfp=fingerprint | |
| --chunk-size=bytes | |
| --compare=method | |
| --compression=method | |
| --compression-hint=num | |
|
-D | -DD | -DDD |
|
| -d | |
| --delete-after | |
| --delete-before | |
| --delete-before-transfer** | --delete-before-transfer** |
| --dest64 | |
| -E pattern | -E pattern |
| -e prepost_filepath | |
| --exclude-newer-than=mtime | |
| --exclude-older-than=mtime | |
| -f config_file | |
| --faspmgr-io | |
| --file-checksum=hash | |
| --file-crypt={encrypt|decrypt} | |
| --file-list=filepath | --file-list=filepath |
| --file-manifest={none|text} | |
| --file-manifest-path=directory | |
| --file-manifest-inprogress-suffix=suffix | |
| --file-pair-list=filepath | |
| -G write_size | |
| -g read_size | |
| -h, --help | -h, --help |
| -i private_key_file_path** | -i private_key_file_path |
| -K probe_rate | |
| -k {0|1|2|3} | -k {0|1|2|3} |
| --keepalive | |
| -l max_rate | -l max_rate |
| -L local_log_dir[:size] | -L local_log_dir[:size] |
| -m min_rate | -m min_rate |
| --memory=bytes | |
| --meta-threads=num | |
| --mode={send|recv} | --mode={send|recv} |
|
--move-after-transfer=archivedir |
|
| --multi-session-threshold=threshold | |
| -N pattern | -N pattern |
| --no-open | |
| --no-read | |
| --no-write | |
|
-O fasp_port |
-O fasp_port |
| --overwrite=method** | --overwrite=method** |
| -P ssh-port | -P ssh-port |
| -p | -p |
| --partial-file-suffix=suffix | |
| --policy={fixed|high|fair|low} | --policy={fixed|high|fair|low} |
| --precalculate-job-size | |
| --preserve-access-time | |
| --preserve-acls=mode | |
| --preserve-creation-time | |
| --preserve-file-owner-gid | --preserve-file-owner-gid |
| --preserve-file-owner-uid | --preserve-file-owner-uid |
| --preserve-modification-time | |
| --preserve-source-access-time | |
| --preserve-xattrs=mode | |
| --proxy=proxy_url | |
| -q | -q |
| -R remote_log_dir | -R remote_log_dir |
| --read-threads=num | |
| --remote-memory=bytes | |
| --remote-preserve-acls=mode | |
| --remote-preserve-xattrs=mode | |
| --remove-after-transfer | |
| --remove-empty-directories | |
| --remove-empty-source-directory | |
| --resume (similar to -k) | |
| --retry-timeout=secs | |
| -S remote_ascp | |
| --save-before-overwrite | |
| --scan-threads=num | |
| --source-prefix=prefix | |
| --source-prefix64=prefix | |
| --sparse-file | |
| --src-base=prefix | --src-base=prefix |
|
--symbolic-links=method** |
--symbolic-links=method** |
| -T | -T |
| -u user_string | -u user_string |
| --user=username | --user=username |
| -v | |
| -W token_string | @token_filepath | |
| -w{r|f} | |
| -X rexmsg_size | -X rexmsg_size |
| -Z dgram_size | -Z dgram_size |
--delete-before-transfer
With ascp4, --delete-before-transfer can be used with URI storage. URI storage is not supported for this option in ascp.
-i, SSH key authentication
With ascp, the argument for -i can be just the file name of the private key file and ascp automatically looks in the .ssh directory of the user's home directory. With ascp4, the full or relative path to the private key file must be specified.
--overwrite=method
The default overwrite method is "diff" for ascp and "always" for ascp4.
--symbolic-links
Both ascp and ascp4 support follow, copy, and skip, but only ascp supports copy+force.