| Aspera Sync |
243
--pending-max=
N
Allow the maximum number of files that are pending transfer to be no more than the specified
number. This option acts as a buffer. Default: 2000.
--preserve-access-time
Preserve file access time from the source to the destination. Default: disabled.
--preserve-acls={native|metafile|none}
Preserve Access Control Lists (ACL) data for macOS, Windows, and AIX files. To preserve ACL
data for other operating systems, use
--preserve-xattrs
. See also
--remote-preserve-
acls
.
•
native
- Preserve attributes using the native capabilities of the file system. This mode is only
supported for Windows, macOS, and AIX. If the destination and source do not support the same
native ACL format,
async
reports and error and exits.
•
metafile
- Preserve file attributes in a separate file, named
filename
.aspera-
meta
. For example, attributes for
readme.txt
are preserved in a second file named
readme.txt.aspera-meta
. These metafiles are platform independent and can be copied
between hosts without loss of information. This mode is supported on all file systems.
•
none
- (Default) Do not preserve attributes. This mode is supported on all file systems.
Important Usage Information:
• 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 synchronization proceeds but no ACL data
is saved and the log records that the ACL could not be applied.
• Both
--preserve-acls
and
--remote-preserve-acls
must be specified in order for
the target side of a pull to apply the ACLs.
• ACLs are not synchronized when only the ACL is modified, or when only the ACL and filename
are modified. ACLs are not preserved for directories.
• On Windows, the ACLs that are created for files that are transferred into user directories might
restrict file access to specific users. Ensure that the ACLs on the transfer-cache directory
(
destination_path
/
session_name
) are generic enough to allow access to all users
who require it. For more information about the transfer-cache directory, see
on page 228.
--preserve-creation-time
Preserve file creation time from the source to the destination. Valid only on Windows computers.
Default: disabled.
--preserve-modification-time
Preserve file modification time from the source to the destination. Default: disabled.
--preserve-time
Preserve file timestamps. This is equivalent to
--preserve-modification-time
for Unix-
based operating systems, and to
--preserve-modification-time --preserve-
creation-time
on Windows. Default: disabled. Same as
-t
.
--preserve-xattrs={native|metafile|none}
Preserve extended file attributes data (xattr). See also
--remote-preserve-xattrs
.
•
native
- Preserve attributes using the native capabilities of the file system. This mode is
supported only on macOS and Linux. If the destination and source do not support the same
native xattr format,
async
reports and error and exits. If the Linux user is not root, some
attributes such as system group might not be preserved.
•
metafile
- Preserve file attributes in a separate file, named
filename
.aspera-
meta
. For example, attributes for
readme.txt
are preserved in a second file named
readme.txt.aspera-meta
. These metafiles are platform independent and can be copied
between hosts without loss of information. This mode is supported on all file systems.
