Comparison of Ascp and Ascp4 Options

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 -c cipher
--check-sshfp=fingerprint  
  --chunk-size=bytes
  --compare=method
  --compression=method
  --compression-hint=num

-D | -DD | -DDD

 
-d  
  --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 --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

Differences in Option Behavior

--delete-before-transfer
With ascp4, --delete-before-transfer can be used with URI storage. URI storage is not supported for this option in ascp.
--file-list
ascp automatically applies -d if the destination folder does not exist. With ascp4, you must specify -d, otherwise all the files in the filelist are written to a single file.
-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.