Command option update


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.



  1. Switch Basic to Advanced mode from View menu
  2. Change copy setting in property dialog
  3. 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.
/O 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.
/L Indicate specified date/time will be set to copied files.
/SD <d> Specify the date/time to be applied.
  Copy mode
/N (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.
/T 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.
/W 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
/P 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)
/M Move files from source to destination. Actual operation is to delete files in source after successfully copying files from source to destination.
/C 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.
/V 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 (9)

  1. Anonymous says:

    Is there any option to set the path length limit to the NTFS limit of 32,767 instead of following the 259 character limit?

  2. Anonymous says:

    How do I format a command line parameter to include or exclude files based on a date?

  3. Tom Jones says:

    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.

  4. Chad says:

    Why is RichCopy setting compression on newely created folders?  Why would it be doing that?  BTW..I am testing this: http://www.roadkil.net/program.php

  5. Gary says:

    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

  6. Mark Poulton says:

    Any chance on a delete directory option?

  7. Matt says:

    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.

  8. cathal says:

    The file exclusion filter still does not work. Will this ever be fixed?

  9. Dave Savage says:

    Is there any way to copy to multiple destinations? I have a need to copy files to one location and then move them to another. I can do it with 2 command line entries but source directory is fluid and I fear having some files that show up after the copy
    but before the move.

Skip to main content