Take the 2-minute tour ×
Super User is a question and answer site for computer enthusiasts and power users. It's 100% free, no registration required.

The robocopy documentation for the option /it is simply Includes "tweaked" files. What does tweaked mean?

The robocopy documentation for the option /xl is simply Excludes "lonely" files and directories. What does lonely mean?

share|improve this question
add comment

3 Answers

up vote 38 down vote accepted

"Tweaked":

A Tweaked file is defined to be one that exists in both the source and destination, with identical size and timestamp, but different attribute settings.

"Lonely":

A "lonely" file is present in source but not destination; excluding lonely will prevent any new files being added to the destination.

"Extra" (the other one that isn't explained well):

An "extra" file is present in destination but not source; excluding extras will prevent any deletions from the destination.

More info here.

share|improve this answer
    
I think the reply about "extras" is a bit misleading. It does not necessary delete files in the destination just because its listing extras? –  Brimstedt Nov 2 '12 at 12:11
    
According to the documentation, no action is ever performed on "Extra" files. They are simply reported in the program output log. If you include the switch "/XX" then they are not even reported in the program output. I don't know if it actually works that way, but no reason to doubt it... I have never tried it as a test case. –  Kevin Fegan Nov 28 '12 at 18:57
    
The /PURGE option will remove files that are no longer in the source (along with the /MIR option). Granted, I don't know what /XX /PURGE would end up doing... –  Richard Jul 26 '13 at 17:32
add comment

"Tweaked", "Lonely", and "Extra" refer to RoboCopy "Classes" of files.

For each directory processed RoboCopy constructs a list of files matching the Include Filespecs, in both the source and destination directories. The program then cross-references these lists, seeing which files exist where, comparing file times and sizes where possible, and places each selected file in one of the following classes:

File        Exists In   Exists In        Source/Dest     Source/Dest   Source/Dest
Class       Source      Destination      File Times      File Sizes    Attributes
=========== =========== ================ =============== ============= ============
Lonely      Yes         No               n/a             n/a           n/a
Tweaked     Yes         Yes              Equal           Equal         Different
Same        Yes         Yes              Equal           Equal         Equal
Changed     Yes         Yes              Equal           Different     n/a
Newer       Yes         Yes              Source > Dest   n/a           n/a
Older       Yes         Yes              Source < Dest   n/a           n/a
Extra       No          Yes              n/a             n/a           n/a
Mismatched  Yes (file)  Yes (directory)  n/a             n/a           n/a

By default, Lonely files (and directories) are always copied, unless /XL switch is used. Changed, Newer and Older files will be considered to be candidates for copying (subject to further filtering described below), Same files will be skipped (not copied), and Extra and Mismatched files (and directories) will simply be reported in the output log.

Normally, Tweaked files are neither identified nor copied – they are usually identified as Same files by default. Only when switch /IT is used will the distinction between Same and Tweaked files be made, and only then will Tweaked files be copied.

Use the following switches to override this default behaviour:

Switch   Function
======== =====================
/XL      eXclude Lonely files and directories.
/IT      Include Tweaked files.
/IS      Include Same files.
/XC      eXclude Changed files.
/XN      eXclude Newer files.
/XO      eXclude Older files.

Use the following switch to suppress the reporting and processing of Extra files:  
/XX      eXclude eXtra files

I found documentation for RoboCopy versions XP010 (Windows XP) and 1.70. If I find documentation for versions XP026 or XP027 (Windows 7), I will link to them here.

Edit (danpritts) - They don't specify the version number of robocopy but here are (less detailed) Windows 7/8/2008/2012 robocopy Docs

share|improve this answer
    
+1 for documentation PDFs. These looks like the official documentation published by Microsoft. –  Iain Elder Jul 19 '12 at 15:17
add comment

Tweaked and lonely have been answered but wrt to 'extra' I believe using the /PURGE option will delete *EXTRA files and directories.

share|improve this answer
add comment

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.