lsyncd - a daemon to continuously synchronize directory trees
Contents
Copying
Copyright (C) 2010-2017 Axel Kittenberger. Free use of this software is granted under the terms of the
GNU General Public License (GPL) version 2, or any later version. Free redistrubition of this
Documentation (/doc directory) is granted under the terms of the Creative Commons 3.0 Attribution License
(CC-3.0-BY).
Lsyncd 2.2.1 January 2017 LSYNCD(1)
Description
Lsyncd(1) watches local directory trees through an event monitor interface (inotify, fsevents). It aggregates and combines events for a few seconds and then spawns one or more processes to synchronize the changes. By default this is rsync(1). Lsyncd is thus a light-weight asynchronous live mirror solution that is comparatively easy to install not requiring new filesystems or block devices and does not hamper local filesystem performance. Rsync+ssh is an advanced action configuration that uses a SSH(1) to act file and directory moves directly on the target instead of re-transmitting the move destination over the wire. Fine-grained customization can be achieved through the CONFIG-FILE. Custom action configs can even be written from scratch in cascading layers ranging from shell scripts to code written in the LUA(1) language. This way simplicity can be balanced with powerfulness. See the online manual for details on the CONFIG-FILE https://axkibe.github.io/lsyncd/manual/config/file/ . Note that under normal configuration Lsyncd will delete pre-existing files in the target directories that are not present in the respective source directory.
Exit Status
(128+SIGNUM)
Terminated by Signal (143 by TERM)
-1
Failure (syntax, unrecoverable error condition, internal failure)
Name
lsyncd - a daemon to continuously synchronize directory trees
Options
-delaySECS
Overrides the default delay times.
-help
Show a help message.
-insist
Continues start up even if rsync cannot connect.
-logLEVEL
Controls which kind of events are logged. By default Lsyncd logs Normal and Error Messages. -logscarce will make Lsyncd log Error messages only. -logall will log all debug messages.
-logCategory
Turns on a specific debug message. E.g. -logExec will log all processes as they are spawned.
-nodaemon
Lsyncd will not detach from the invoker and log as well to stdout/err.
-pidfileFILE
Lsyncd will write its process ID in FILE.
-runnerFILE
Makes the Lsyncd core load the part of Lsyncd written in Lua from FILE.
-version
Writes version information and exits.
See Also
Online Manual: https://axkibe.github.io/lsyncd/
Synopsis
config file
lsyncd [OPTIONS] CONFIG-FILE
default rsync behaviour
lsyncd [OPTIONS] -rsync SOURCEDIRTARGET ...
default rync+ssh behaviour (moves and deletes through ssh)
lsyncd [OPTIONS] -rsyncssh SOURCEDIRTARGETHOSTTARGETDIR ...
default direct behaviour (local file operations/rsync)
lsyncd [OPTIONS] -direct SOURCEDIRTARGETDIR ...
Version
This man page is for lsyncd(1) version 2.2.0
