Async Command-Line Options

-A
--version

-h 
--help

-D[D..]

-q
--quiet

-L localdir
--alt-logdir=localdir

--watchd=datastore:host:port

--apply-local-docroot

-N pair
--name=pair

-d ldir
--local-dir=ldir

-r rdir
--remote-dir=rdir

--host=host

The name of the remote host. When host is specified with this option, the characters "@" and ":" are no longer treated specially in the argument to -r, so may appear in any such name. Note that if --host=host is specified, the remote-user name cannot be extracted from the argument to --remote-dir, and therefore must be supplied by a --user=name option or in the environment variable $user (on Windows, %USER%). Thus, allowed forms are as follows:

--remote-dir user@host:/rootdir        # (old method)  
--user user --remote-dir host:/rootdir  
--host host --user user --remote-dir /rootdir  
--remote-dir host:/rootdir             # (uses $user)  
--host host --remote-dir /rootdir      # (uses $user)

The following means the same as the first three lines above:

-r /rootdir --user=user --host=host

For backward compatibility, -r A:/rootdir for any single letter A is still taken as a Windows path, not as --host A -r /rootdir. To specify a one-letter host name A, use an explicit --host=A.

--user=user

-w pass
--pass=pass

-i file
--private-key-path=file

--check-sshfp=fingerprint

-K direction
--direction=direction

-k type
--checksum=type

-P port
--tcp-port=port

-O port
--udp-port=policy

-a policy
--rate-policy=policy

-l rate
--target-rate=rate

-m rate
--min-rate=rate

-g size
--read-block-size=size

-G size
--write-block-size=size

-H val
--scan-intensity=val

-R remdir
--remote-logdir=remdir

-Z mtu
--datagram-size=mtu

-X size
--rexmsg-size=size

-c cipher
--cipher=cipher

-b ldbdir
--local-db-dir=ldbdir

-B rdbdir
--remote-db-dir=rdbdir

-I file
--include-from=file

-E file
--exclude-from=file

--include=pattern

--exclude=pattern

-n action
--symbolic-links=action

Treat symbolic links per the specified action. Permitted values are:

copy - create (or update) the link at the destination. (Not valid for Windows source or destination.)

skip - ignore the link altogether.

follow - treat the link as if it were the file (or directory) it points to, so that at the destination, what was a link will now be a copy of the file (or directory). (Skip, if source is Windows.)

Refer to Configuring Symbolic Links for more information on using symbolic links.

-C
--continuous

-t
--preserve-time

--preserve-access-time

--preserve-modification-time

--preserve-creation-time

-u
--preserve-uid

-j
--preserve-gid

--write-uid=uid

--write-gid=gid

--scan-dir-rename

--scan-file-rename

-o policy
--overwrite=policy

-x
--reset

--assume-no-mods

--ignore-delete

--delete-delay

--keep-dir-local=dir

--keep-dir-remote=dir

--local-mount-signature=signature file

--remote-mount-signature=signature file

--create-dir

--dedup[=mode]

--no-scan

--cooloff=sec

--pending-max=N

--sharing-retry-max=N

--preserve-acls=mode

Preserve the ACL access data from Windows or OS X files if the preservation mode is native or metafile.

If mode is native, async expects that the destination supports the same native ACL format as the source; if not, it generates an error and exits.

If mode is metafile, async writes the access data to a separate file in the same location; the file has same name but with the added extension .aspera-meta. Metafile data is in a generic format that can reside on any platform and also be reconverted to native form if the file is again synced with a system that supports it.

If mode is none, no ACL data is preserved at all.

This feature is only meaningful if both hosts are in a common security domain. If a SID (security ID) in a source file does not exist at a destination, the sync proceeds but no ACL data is saved and the log records that the ACL could not be applied.

--preserve-xattrs=mode

Preserve OS X extended attributes data (xattr) if preservation mode is native or metafile.

If the sync is run by a regular user, only user-level attributes are preserved. If run as superuser, all attributes are preserved.

If mode is native, async expects that the destination supports the same native xattr format as the source; if not, it generates an error and exits.

If mode is metafile, async writes the xattr data to a separate file in the same location; the file has the same name with the added extension .aspera-meta. The aspera-meta files are platform-independent and can be copied between hosts without loss of data. They can be reconverted to the native form if the file is again synced with an OS X system.

If mode is none, no xattr data is preserved at all.

--remote-preserve-acls=mode

--remote-preserve-xattrs=mode

--compression=mode

--transfer-threads=N[:size]

--remove-after-transfer

--scan-interval=duration