From 8318453bf9d4fd50b137ff6c6fc8d1fd22aa6395 Mon Sep 17 00:00:00 2001 From: Daniel Wilhelm Date: Fri, 18 Apr 2014 17:07:15 +0200 Subject: 3.7 --- BUILD/Help/html/Links.html | 6 +- BUILD/Help/html/advanced/Batch Scripting.html | 91 ++++++++++++++++++++++++++ BUILD/Help/html/advanced/CmpSettings.png | Bin 0 -> 17093 bytes BUILD/Help/html/advanced/RealtimeSync.html | 19 +++--- BUILD/Help/html/advanced/RunAsService.html | 23 +++++-- BUILD/Help/html/advanced/ShadowCopy.html | 17 +++-- BUILD/Help/html/advanced/SymbolicLinks.html | 81 ++++++++++++++--------- 7 files changed, 188 insertions(+), 49 deletions(-) create mode 100644 BUILD/Help/html/advanced/Batch Scripting.html create mode 100644 BUILD/Help/html/advanced/CmpSettings.png (limited to 'BUILD/Help/html') diff --git a/BUILD/Help/html/Links.html b/BUILD/Help/html/Links.html index 3986f2a2..f35a3641 100644 --- a/BUILD/Help/html/Links.html +++ b/BUILD/Help/html/Links.html @@ -3,9 +3,9 @@ - + - + + + +

Batch Scripting +(Windows)

In +order to facilitate using FreeFileSync and RealtimeSync in advanced +synchronization scenarios, creating batch files is a good way to +provide additional functionality. The following section will give +some general hints for custom *.cmd and *.bat files.

Example: +(A simple locking facility when sync'ing with multiple computers in +parallel)

+ :tryAgain
if not exist + \\share\folder\lock (
  ::create + the lock
  echo + This is a lock file > \\share\folder\lock
  ::execute + the synchronization batch job synchronously
  "C:\Program + Files\FreeFileSync\FreeFileSync.exe" + "C:\MySyncJob.ffs_batch"
  del + \\share\folder\lock
) else (
  ::wait + 5 seconds then try starting sync again:
  choice + /C:AB /T:5 /D:A > NUL
  goto tryAgain
)

When + starting a batch file from RealtimeSync be sure to make synchronous + calls to FreeFileSync only. This will prevent RealtimeSync from + detecting changes while synchronization is still in progress.
+

+
During + execution of a Batch file a black console window is shown. You can + hide this window by using the Visual Basic script "Invisible.vbs" + located in the FreeFileSync installation directory.
+
Usage:
+
+
+ wscript C:\Program + files\FreeFileSync\Invisible.vbs C:\MyBatchFile.cmd
+
+
+

FreeFileSync + returns with an Errorlevel below zero if unresolved problems remain:
+
+
+ "C:\Program + Files\FreeFileSync\FreeFileSync.exe" + "H:\Silent_Config.ffs_batch"
if not errorlevel 0 + (
  ::if + something went wrong, add special treatment here
  echo + Errors occurred during synchronization...
  pause
)
+
+
+

+ + \ No newline at end of file diff --git a/BUILD/Help/html/advanced/CmpSettings.png b/BUILD/Help/html/advanced/CmpSettings.png new file mode 100644 index 00000000..618f4057 Binary files /dev/null and b/BUILD/Help/html/advanced/CmpSettings.png differ diff --git a/BUILD/Help/html/advanced/RealtimeSync.html b/BUILD/Help/html/advanced/RealtimeSync.html index 156409ba..5aabe112 100644 --- a/BUILD/Help/html/advanced/RealtimeSync.html +++ b/BUILD/Help/html/advanced/RealtimeSync.html @@ -5,7 +5,7 @@ - + @@ -68,8 +68,9 @@ to begin monitoring.

Starting the tool can be automated by passing a RealtimeSync configuration file (*.ffs_real) OR a FreeFileSync Batch file (*.ffs_batch) - as first command-line argument. This allows for integration with - your operating system's autostart facility:

+ as first command-line argument. Latter is implicitly converted to + a *.ffs_real file with default settings. This allows for + integration with your operating system's autostart facility:

@@ -131,15 +132,15 @@ batch file similar to this one:

::first check whether USB-stick contains a sync-configuration at all
@if - exist "H:\Silent_Config.ffs_batch" (
::configuration - found, now execute the synchronization batch job
"C:\Program + exist "H:\Silent_Config.ffs_batch" (
  ::configuration + found, now execute the synchronization batch job
  "C:\Program Files\FreeFileSync\FreeFileSync.exe" - "H:\Silent_Config.ffs_batch"
@if not errorlevel 0 - (
::if + "H:\Silent_Config.ffs_batch"
  @if + not errorlevel 0 (
    ::if something went wrong, start FreeFileSync in GUI - mode
    "C:\Program + mode
    "C:\Program Files\FreeFileSync\FreeFileSync.exe" - "H:\GUI_Config.ffs_gui"
)
)

+ "H:\GUI_Config.ffs_gui"
)
)

diff --git a/BUILD/Help/html/advanced/RunAsService.html b/BUILD/Help/html/advanced/RunAsService.html index ea1e4f2c..499d0d4d 100644 --- a/BUILD/Help/html/advanced/RunAsService.html +++ b/BUILD/Help/html/advanced/RunAsService.html @@ -5,7 +5,7 @@ - + @@ -58,10 +58,8 @@ the new Service with RealtimeSync:

Open the Registry editor (Regedit.exe) and navigate to key "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<ServiceName>"

Add a new key "Parameters".

Add a new String value named "Application" and specify a command line that shall be executed as value.

@@ -72,7 +70,24 @@ the new Service with RealtimeSync:

it!

+ Attention:
When running + RealtimeSync as a service the application has no means to interact + with the user. Therefore any popup dialog will stop the process + flow! Consequently consider the following rules when setting up a + FreeFileSync batch job:

Enable + checkbox "Silent mode" to prevent showing a status + dialog at the end of the process.
+
Set + "Error handling" to either "Exit + instantly" or "Ignore errors".
+

+

+

The new service can now be started via commandline or Windows Service diff --git a/BUILD/Help/html/advanced/ShadowCopy.html b/BUILD/Help/html/advanced/ShadowCopy.html index 09b64e6a..d726ad76 100644 --- a/BUILD/Help/html/advanced/ShadowCopy.html +++ b/BUILD/Help/html/advanced/ShadowCopy.html @@ -5,7 +5,7 @@ - + @@ -33,9 +33,18 @@ Copy of the source drive. To enable this feature go to

- Note:
This functionality - is applied to locked files only. Regular files will not use Volume - Shadow Copy Service when being synchronized.

+ Note:

This + functionality is applied to locked files only. Regular files will + not use Volume Shadow Copy Service when being synchronized.
+
+

Creating + Volume Snapshots using VSS requires the application to be started + with Administrator rights.
+

diff --git a/BUILD/Help/html/advanced/SymbolicLinks.html b/BUILD/Help/html/advanced/SymbolicLinks.html index b85c6bbd..fc385f8f 100644 --- a/BUILD/Help/html/advanced/SymbolicLinks.html +++ b/BUILD/Help/html/advanced/SymbolicLinks.html @@ -5,7 +5,7 @@ - + @@ -28,46 +28,67 @@ Linux)

FreeFileSync -offers the following two advanced options contained in each -*.ffs_gui/*.ffs_batch file to configure processing of Symbolic Links -(also called Symlinks or Soft Links):

+offers three advanced options to configure processing of Symbolic +Links (also called Symlinks or Soft Links). They can be configured +directly within a *.ffs_gui/ffs_batch file via a text editor. Only +the first option is presented on GUI:

Default -Settings (View and edit these in the text editor of your choice):

<CopyFileSymlinks>true</CopyFileSymlinks>
<TraverseDirectorySymlinks>false</TraverseDirectorySymlinks>

+ <IncludeSymlinks> false </IncludeSymlinks>
<TraverseDirectorySymlinks>true </TraverseDirectorySymlinks>
<CopyFileSymlinks> false </CopyFileSymlinks>

Enable + "Include Symbolic Links" in order to process + Symbolic Links at all, i.e. add them to the file and directory + listing.

+
"Traverse + Directory Links" specifies handling of Symbolic Links to + directories:
If this option is enabled, they are traversed like + ordinary directories during comparison. When synchronizing, the + target of the Symbolic Link will be copied. If disabled, Symbolic + Links are not traversed. During synchronization, copying them + results in a copy of the Symbolic Link.

+
"Copy + File Links" defines the behavior for copying Symbolic Links + pointing to files:
If checked, the Symbolic Link itself will be + copied. If unchecked, the target of the Link will be copied instead.

"CopyFileSymlinks" -defines the behavior for copying Symbolic Links pointing to files:

If -set to true it copies the Symbolik Link to its destination.
If -set to false the target of the link, in this case a file, is -being copied instead.

On GUI +only the first option is available for configuration, while "Traverse +Directory Links" is implicitly enabled and "Copy +File Links" disabled.

"TraverseDirectorySymlinks" -specifies handling of Symbolic Links to directories:

If -true, they are being traversed like regular directories during -comparison and are copied as if they were regular directories (i.e. -not as Symbolic Links) during synchronization.
If false is -selected, these Symbolic Links are not traversed at all. During -synchronization copying them results in a direct copy of the Symbolic -Link, not the target directory.

- Note:
As the link's - content is not parsed by FreeFileSync, this usually only makes sense - when you use relative paths within your Symolic Links.

Note:

In + the Windows build the options described above always apply to + "Reparse Points". + Reparse Points are a more general concept including for example + Symbolic Links, Junctions and Mount Points. The term "Symbolic + Link" has + been retained nevertheless for harmonization with Linux.
+
Creating + or copying Symbolic Links requires the application to be started + with Administrator rights.
+