From c0cdb2ad99a1e2a6ade5ce76c91177a79258e669 Mon Sep 17 00:00:00 2001 From: Daniel Wilhelm Date: Fri, 18 Apr 2014 17:10:11 +0200 Subject: 3.14 --- BUILD/Help/html/advanced/Batch Scripting.html | 42 +++++++++++------- BUILD/Help/html/advanced/DaylightSavingTime.html | 16 ++++++- BUILD/Help/html/advanced/ExcludeSubfolder.html | 56 +++++++++++++----------- BUILD/Help/html/advanced/RealtimeSync.html | 12 ++--- 4 files changed, 79 insertions(+), 47 deletions(-) (limited to 'BUILD/Help/html') diff --git a/BUILD/Help/html/advanced/Batch Scripting.html b/BUILD/Help/html/advanced/Batch Scripting.html index c7436792..f7f01a05 100644 --- a/BUILD/Help/html/advanced/Batch Scripting.html +++ b/BUILD/Help/html/advanced/Batch Scripting.html @@ -5,7 +5,7 @@ - + @@ -35,32 +35,44 @@ some general hints for custom *.cmd and *.bat files.

Example: -A simple locking facility – (Note: -FreeFileSync already has a more powerful directory locking mechanism -implemented that allows multiple writers in parallel)

+Shutdown PC after synchronization

+ ::start + FreeFileSync Batch + Job
"C:\Users\ZenJu\Desktop\SyncJob.ffs_batch"
::schedule + shutdown after 10 seconds
shutdown + /s /t 10

Example: +A simple locking facility – (Note: +FreeFileSync already has a more powerful directory locking +mechanism implemented that allows multiple writers in parallel)

:tryAgain
if not exist \\share\folder\lock (
  ::create - the lock
  echo + 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 + 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" @@ -70,7 +82,7 @@ implemented that allows multiple writers in parallel)

wscript C:\Program files\FreeFileSync\Invisible.vbs C:\MyBatchFile.cmd
-
+

::if - something went wrong, add special treatment here

echo - Errors occurred during synchronization...

pause
)

echo + Errors occurred during synchronization...

pause
)

Note:

In + order for FreeFileSync to start handling DST and timezone + differences, an initial full synchronization is required. + Subsequent syncs will never show a time difference again.
+
If + a FAT volume is scanned the first time by FreeFileSync this will + take longer than usual since additional meta data is written for + each file.
+

Exclude via -filter

Exclude files

Excluding -files and directories woks by specifying a phrase that is compared -against a file or directory path. Only if the file/directory matches -at least one entry in the include list and none of the entries in the -exclude list it passes filtering. The phrase is also a file or -directory name, but it must be relative to the base sync-directory -and may additionally include wildcards like '*' or '?'.

Example: +(Exclude all sub directories)

+ Include: *
Exclude: + *\

This +will exclude all objects within the two directories that end with a +'\' +character, which is interpreted as the end of a directory name.

Example: @@ -47,7 +61,7 @@ and may additionally include wildcards like '*' or '?'.

Exclude all *.tmp files - beyond subfolder:
Filter: + within subfolder:
Filter: \sample\subfolder\*.tmp

Exclude all files and folders named CVS @@ -59,6 +73,10 @@ and may additionally include wildcards like '*' or '?'.

as part of their name:

Filter:

*test*

Exclude + multiple entries; separate by semicolon or newlines:
Filter: + *.tmp; + *.doc; *.bak

@@ -77,26 +95,12 @@ and may additionally include wildcards like '*' or '?'.

Example: -(Exclude all sub folders)

- Include: *
Exclude: - *\

This -will exclude all objects within the two directories that end with a -'\' -character, which is interpreted as the end of a directory name.

Note:
In most cases manually specifying a filter phrase is not necessary! You can - exclude files, directories and even whole lists of both directly on - main grid via context menu.

Note:

+ The command-line must NOT + block the progress. If a FreeFileSync batch file is called + make sure it is operating in "silent-mode" and "error + handling” is set to "ignore errors" or "exit + instantly".
+
The settings dialog can be skipped by passing a RealtimeSync configuration file (*.ffs_real) OR a FreeFileSync batch file (*.ffs_batch) @@ -71,10 +77,6 @@ to begin monitoring.
restricted to starting FreeFileSync. It can also be used in other scenarios, like sending an email whenever a certain directory is modified.
-
- The command-line must not block - the progress. If a FreeFileSync batch file is to be called make - sure it is operating in "silent-mode".