Command option update

Article
05/20/2009

There are some errors in helpfile installed by RichCopy setup program, such as no description of file and directory filtering.

>RichCopy.exe <source path> <destination> <flags>

<n> numbers
<s> string
<t> date/time

RichCopy has a feature to help you generating necessary command parameters.

Switch Basic to Advanced mode from View menu
Change copy setting in property dialog
Change tab to "Other'

You will find command parameters equivalent to what you have confiured.

Command

Description

Conditions to decide if a copy should be copied

/CSSD

Compare the security setting of a file in source and destination.

/CDSD

Compare the security setting of a file in source and destination.

/FSS

Compare size of a file in source and destination.

/FSD

Compare size of a file in source and destination.

/FAS

Compare size of a file in source and destination.

/FAD

Compare attributes of a file in source and destination.

/TSS

Compare time stamp of a file in source and destination. Copy if it is same. This option is used with one of /CCD, /CLA, /CLW flag.

/TSD

Compare time stamp of a file in source and destination. Copy if it is different. This option is used with one of /CCD, /CLA, /CLW flag.

/TSU

Compare time stamp of a file in source and destination. Copy if it is earlier than source. This option is used with one of /CCD, /CLA, /CLW flag.

/CCD

Check create date. This flag is valid when one of /TSS, /TSD or /TSU flag is specified.

/CLA

Check last access date. This flag is valid when one of /TSS, /TSD or /TSU flag is specified.

/CLW

Check last wrote date. This flag is valid when one of /TSS, /TSD or /TSU flag is specified.

/NE

Copy if it does not exist in destination.

/II

Copy if it exist in destination.

This option force to copy files to destination when file already exist with READ-ONLY flag. If this option is not selected, copy will fail otherwise.

/ALWS

This option force to copy files to destination when file already exist with READ-ONLY flag. If this option is not selected, copy will fail otherwise.

/NONE

Do not copy files, but create only directories.

/CNF

Turn off popup system error dialog.

Information to be copied.

/CT

Set same date/time to destination file as source.

/CA

Set same attributes to destination file as source.

/CSA

Copy security settings from source to destination. This flag has to be used with one or some of /CSD, /CSG, /CSO and /CSS.

/CSD

Copy discretional access control information from source file to destination. This is valid only when /CSA flag is set.

/CSG

Copy security group information from source file to destination. This is valid only when /CSA flag is set.

/CSO

Copy owner information from source file to destination. This is valid only when /CSA flag is set.

/CSS

Copy security access control from source file to destination. This is valid only when /CSA flag is set.

Indicate specified date/time will be set to copied files.

/SD <d>

Specify the date/time to be applied.

Copy mode

(This is currently not available) Keep monitoring source directory, and copy if any change is captured.

/PRP

Parse all source directories before starting actual copy process. This makes enable to collect total file counts and size, and know the remained files size to be copied.

Set time to kick copy process. When this flag is set, copy process will not start until reaching to specified date/time. This flag is used with /TM flag.

RichCopy will wait until specified source directory become available.

/NC

Specify not to use system cache for file read and write. If you want to system to directly transfer data to storage system, you may turn of system cache by selecting this option.When this option is selected, the file is being opened with no system caching. This does not affect hard disk caching or memory mapped files. This option may gives maximum asynchronous performance, because the data the I/O does not rely on the synchronous operations of the memory manager. However, some I/O operations take more time, because data is not being held in the cache. RichCopy also does following additional tasks when this option is selected.

Align file access byte offset to integer multiples of the volume sector size.
Align buffer addresses for read and write operation with sector size.
Set file size afterwards

/SZ

Some storage devices are not good at performing simultaneous disk access, such ATA based disk drives especially over the USB. When this option is selected, RichCopy serialize all disk access to the storage, and minimize the overhead at storage device end. This does not mean that RichCopy limits the number of thread running simultaneously.

/TM <t>

Specify date/time to start copy process. This flag is valid only when /T flag is specified.

Copy mode

Files in destination will be removed if it does not exist in source directory. This option is often selected when source and destination directories need to be identical. (Remove files in destination when it is removed in source)

Move files from source to destination. Actual operation is to delete files in source after successfully copying files from source to destination.

RichCopy version 4.0 supports specifying multiple source directories. Default behavior is to create directories with same name as source, and make a copy. When this option is selected, RichCopy copy all sources files and directories into specified destination directory without creating directories with same name as source. See also.

All copied files will be compare with source files after all copy operation successfully completes.

Set or remove file attributes

/+R

Set a file or directory that is read-only.For a file, applications can read the file, but cannot write to it or delete it.For a directory, applications cannot delete it.

/+H

Set a file or directory is hidden. It is not included in an ordinary directory listing.

/+S

Set a file or directory that the operating system uses a part of, or uses exclusively.

/+A

Set a file or directory that is an archive file or directory. Applications use this attribute to mark files for backup or removal.

/+C

Set a file or directory that is compressed. For a file, all of the data in the file is compressed.For a directory, compression is the default for newly created files and subdirectories.

/+I

Set a file is not to be indexed by content indexing service.

/+T

Set a file that is being used for temporary storage. File systems avoid writing data back to mass storage if sufficient cache memory is available, because typically, an application deletes a temporary file after the handle is closed. In that scenario, the system can entirely avoid writing the data. Otherwise, the data is written after the handle is closed.

/+O

Set the data of a file is not available immediately. This attribute indicates that the file data is physically moved to offline storage. This attribute is used by Remote Storage, which is the hierarchical storage management software. Applications should not arbitrarily change this attribute.

/-R

Remove read-only flag. See /+R flag for more detail.

/-H

Remove hidden flag. See /+H flag for more detail.

/-S

Remove system flag. See /+S flag for more detail.

/-A

Remove archive flag. See /+A flag for more detail.

/-C

Remove compressed flag. See /+C flag for more detail.

/-I

Remove none-index flag. See /+I flag for more detail.

/-T

Remove temporary flag. See /+T flag for more detail.

/-O

Remove offline flag. See /+O flag for more detail.

File and directory filtering

/IFR

Copy files if read-only flag is set.

/IFH

Copy files if hidden flag is set.

/IFS

Copy files if system flag is set.

/IFA

Copy files if archive flag is set.

/IFC

Copy files if compress flag is set.

/IFI

Copy files if none-index flag is set.

/IFE

Copy files if encrypted

/IFT

Copy files if temporary flag is set.

/IFO

Copy files if offline flag is set.

/IDR

Copy directories if read-only flag is set.

/IDH

Copy directories if hidden flag is set.

/IDS

Copy directories if system flag is set.

/IDA

Copy directories if archive flag is set.

/IDC

Copy directories if compress flag is set.

/IDI

Copy directories if none-index flag is set.

/IDE

Copy directories if encrypted

/IDT

Copy directories if temporary flag is set.

/IDO

Copy directories if offline flag is set.

/EFR

Don't copy files if read-only flag is set.

/EFH

Don't copy files if hidden flag is set.

/EFS

Don't copy files if system flag is set.

/EFA

Don't copy files if archive flag is set.

/EFC

Don't copy files if compress flag is set.

/EFI

Don't copy files if none-index flag is set.

/EFE

Don't copy files if encrypted

/EFT

Don't copy files if temporary flag is set.

/EFO

Don't copy files if offline flag is set.

/EDR

Don't copy directories if read-only flag is set.

/EDH

Don't copy directories if hidden flag is set.

/EDS

Don't copy directories if system flag is set.

/EDA

Don't copy directories if archive flag is set.

/EDC

Don't copy directories if compress flag is set.

/EDI

Don't copy directories if none-index flag is set.

/EDE

Don't copy directories if encrypted

/EDT

Don't copy directories if temporary flag is set.

/EDO

Don't copy directories if offline flag is set.

/FIF

Filter string for files to be copied. Filter string should be surrounded by double quote character if it includes space.

/FID

Filter string for directories to be copied. Filter string should be surrounded by double quote character if it includes space.

/FEF

Filter string for files to be excluded. Filter string should be surrounded by double quote character if it includes space.

/EDO

Filter string for directories to be excluded. Filter string should be surrounded by double quote character if it includes space.

Directory search configuration

/TS <n>

Specify the number of thread to be used for directory search. Increasing number of thread for directory search is effective when directory structure is rather complex, but it does not contribute to the performance so much when directory structure is simple.

/SC <n>

Number of file information to be stored. If 10 is specified, information of 10 files and/or directories can be stored. It is suggested to specified double size of directory copy thread count. Search cache is traditional FIFO ring cache.

Thread configuration

/TD <n>

Specify the number of thread to be used to copy files. Thread number actually identical to the number of copy process executed simultaneously. When 10 is specified, and then 10 files are copied simultaneously.

/TP <n>

Specified the number of thread to be used to copy a file. This is effective to copy small number of huge file copy. It is not recommended to use more than 1 thread for a file copy as it could consume large size of system resource. (Multiple number of directory copy thread by number of file copy thread. )

/FC <n>

This is the cache size used for file copy. Each file copy transaction will occur per this cache size. The other word, this is the data size read and written by RichCopy. For example, RichCopy read and write 10 times to copy 64K bytes when 7K bytes is set as cache size

Process Priority

/PP <#>

Set process priority of RichCopy. (0 = idle, 5 = critical). Critical means to try using all system resource. Idle means to run copy tasks without impacting other process.

Retry configuration

/R <n>

Number of errors to retry. For example, RichCopy will stop copy process when error occurs three times if three is set.

/RI <n>

Interval to retry. RichCopy will wait specified interval until retry the task.

Command

/XG <s>

Any executable can be specified. If exit code of executed command is none-zero, RichCopy will not process rest of tasks. The other word, command can control whether to start copy process or not by returning zero or non-zero.

/XA <s>

Any executable can be specified.

FTP

/EA <s>

Account to be used when access to FTP server

/EP <s>

Password to be used when access to FTP server

Copy option profile

/PF <s>

Specify copy option profile.

Logging

/QA

Information will be added to the specified file if it exist, otherwise new file will be created.

/QO

The specified file will be deleted file if it exist before writing out information.

/QN

No logging

/QP <s>

Specify the file to be write log information out.

/UE

Write out error information

/US

Write out source path

/UD

Write out destination path

/UC

List all copied file.

/UPF

List purged file list

/UPC

Write out purged file count

/UPS

Write out purged file size

/UFC

Write out copied file count

/UCS

Write out copied file size

/USC

Write out file count in source path

/USS

Write out total file size in source path

/USD

Write out total directory count in source path

/UPR

Write out average of copy performance

/UET

Write elapsed time

Comments

Anonymous
January 01, 2003
Is there any option to set the path length limit to the NTFS limit of 32,767 instead of following the 259 character limit?
Anonymous
January 01, 2003
The comment has been removed
Anonymous
June 28, 2011
Richcopy is BROKEN, BROKEN, BROKEN. It will not clear the archive bit of source files. It will not hold settings. If multithread copying makes you happy, this is for you. If professional level IT tools is what you are looking for, stay from richcopy. YOU GET WHAT YOU PAY FOR.
Anonymous
January 31, 2012
Why is RichCopy setting compression on newely created folders? Why would it be doing that? BTW..I am testing this: www.roadkil.net/program.php
Anonymous
August 05, 2013
Can someone help me use the correct format to set the tiime to do a daily copy: /TM <t> Specify date/time to start copy process. This flag is valid only when /T flag is specified. What should I do? Thanks
Anonymous
June 16, 2014
Any chance on a delete directory option?
Anonymous
November 10, 2014
The file exclusion filter does not work. Even though it's saved in the Xml settings, every time I open the options dialog, the "Use name to filter files" checkbox is unchecked. This has been reported in numerous places online for about 4 years. Can you please fix it? Thanks.
Anonymous
November 03, 2015
The file exclusion filter still does not work. Will this ever be fixed?
Anonymous
January 26, 2016
The comment has been removed

Share via

Command option update

Comments

Additional resources