What does Robocopy mean by tweaked, lonely, and extra?

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?


Solution 1:

"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.

Solution 2:

"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