SynchronEX for Linux & Windows
Version 3.0.7.27

Powerful multi-directional file synchronizer with backup & network options.

Supports: Local Paths, ZIP, SFTP/SSH2, FTP, FTPS/TLS, WebDAV/HTTP(S) & more

Main features: 
    Simulation mode; Collision detection; True synchronization of removed 
    files & directories; Multi-directional synchronization (more than 
    2 locations); Super projects with configuration inheritance; Multi-Sync' 
    projects; Sync' between nested directories; automatic journaling of 
    changed & removed files ("XVS version tracking"); Logs & Statistics; 
    Support for unicode filesystems; Bahavior can be extended, altered and 
    subclassed by builtin Python OO script language.

README for Linux
================

SynchronEX for Linux works in the same style as SynchronEX for Windows.
The project script/config files are compatible. SynchronEX for Linux
is a commandline-only tool so far. SynchronEX can be used up to 14 days as 
unregistered free trial. After that period you MUST PURCHASE A LICENSE.

Software home page: http://xellsoft.com/SynchronEX.html
Main documentation: http://xellsoft.com/synchronex_readme.html

INSTALLATION
============

1. SynchronEX for Linux is delivered as synchronex.tgz archive or
   synchronex-<version>.tgz
2. Unpack it for example in /usr/local/lib and create a link in /usr/local/bin:

   cd /usr/local/lib
   tar xfz /downloadpath/synchronex.tgz
   cd /usr/local/bin
   ln -s /usr/local/lib/synchronex/synctree synctree

LICENCE KEY INSTALLATION (after free trial period)
========================
There are 2 alternative possibilities:
Admin installation: create a file "/usr/local/lib/synchronex/sx_license.key" 
    ("sx_license.key" next to the "synctree" binary). The file must contain 
    the bare key string. 
User installation: run "synctree --regkey" interactively and enter/paste the 
    license key string at the question mark. Or store the bare key in a keyfile 
    and run "synctree --regkey < keyfile".

GETTING STARTED
===============

1. Run 'synctree'  or 'synctree --help' to see quick reference and version
 
2. Create a first sync-config script (or start with simple.syncpy) - e.g.:

#/home/user/texts/my.syncpy
roots=[ '/home/user/texts' , '/laptop/cc/texts' ]
excludefiles_rel=['*.bak','bigfile.doc']

3. Run 'synctree -s my.syncpy' for a simulation run

4. Run 'synctree my.syncpy' for an execution run

5. template.syncpy inside the .tgz archive is useful for starting a more 
   complex script project. 
   Find details in the manual : http://xellsoft.com/synchronex_readme.html 

6. The Windows version of SynchronEX can be used to create
   project template scripts using the GUI Wizards. On Linux usually you'd
   only have to adapt the paths.

UNIX SPECIFIC BEHAVIOUR
=======================

By default SynchronEX doesn't follow symbolic links. Following smybolic links
can be enabled by option "symlink_follow=1" in the project script (.syncpy)

COMMANDLINE SYNTAX
==================

Usage: synctree [OPTIONs] [PROJECTFILE]

PROJECTFILE: project configuration file. e.g.: backup.syncpy

OPTIONs:
-s           force simulation run; files are not really copied
-y           use a sync database (.syncdb) and detect Y-collisions
-z           dont use config file (OPTIONSs only mode)
-n0,2        1st and 3rd root directory are not sources
-r /foo      directory "/foo" is added to the roots list
-e foo.c     "foo.c" is added to the excludefiles_rel
-i foo.obj   "foo.obj" is added to the includefiles_rel
-x tmp       "tmp" is added to the excludedirs_rel
-k foo.tmp   "foo.tmp" is killed everywhere
-d 1.2.02    set threshold date
-t 13:20     set threshold time
-v           verbose list (incl. filemtime, size)
-w  / -W     don't wait for ENTER at the end (-W : wait if error)
-l src.log   create log list of all source files
-L sync.log  full log of console output to file (append mode)
-+           sync also file removals (syncremove=1)
-h           small help
--remove src.lst :remove files in the list! (create with '-l -s')
--gui        start the GUI
--help       big help

Find more details in manual: http://www.xellsoft.com/synchronex_readme.html

<End of SYNTAX>
<End of README for SynchronEX for Linux>