lsyncd(1)

1LSYNCD(1)                           Lsyncd                           LSYNCD(1)
2
3
4

NAME

6       lsyncd - a daemon to continuously synchronize directory trees
7

SYNOPSIS

9       config file
10             lsyncd [OPTIONS] CONFIG-FILE
11
12       default rsync behaviour
13             lsyncd [OPTIONS] -rsync SOURCEDIR TARGET ...
14
15       default rync+ssh behaviour (moves and deletes through ssh)
16             lsyncd [OPTIONS] -rsyncssh SOURCEDIR TARGETHOST TARGETDIR ...
17
18       default direct behaviour (local file operations/rsync)
19             lsyncd [OPTIONS] -direct SOURCEDIR TARGETDIR ...
20

DESCRIPTION

22       Lsyncd(1) watches local directory trees through an event monitor
23       interface (inotify, fsevents). It aggregates and combines events for a
24       few seconds and then spawns one or more processes to synchronize the
25       changes. By default this is rsync(1). Lsyncd is thus a light-weight
26       asynchronous live mirror solution that is comparatively easy to install
27       not requiring new filesystems or block devices and does not hamper
28       local filesystem performance.
29
30       Rsync+ssh is an advanced action configuration that uses a SSH(1) to act
31       file and directory moves directly on the target instead of
32       re-transmitting the move destination over the wire.
33
34       Fine-grained customization can be achieved through the CONFIG-FILE.
35       Custom action configs can even be written from scratch in cascading
36       layers ranging from shell scripts to code written in the LUA(1)
37       language. This way simplicity can be balanced with powerfulness. See
38       the online manual for details on the CONFIG-FILE
39       https://axkibe.github.io/lsyncd/manual/config/file/ .
40
41       Note that under normal configuration Lsyncd will delete pre-existing
42       files in the target directories that are not present in the respective
43       source directory.
44

OPTIONS

46       -delay SECS
47           Overrides the default delay times.
48
49       -help
50           Show a help message.
51
52       -insist
53           Continues start up even if rsync cannot connect.
54
55       -log LEVEL
56           Controls which kind of events are logged. By default Lsyncd logs
57           Normal and Error Messages.  -log scarce will make Lsyncd log Error
58           messages only.  -log all will log all debug messages.
59
60       -log Category
61           Turns on a specific debug message. E.g.  -log Exec will log all
62           processes as they are spawned.
63
64       -nodaemon
65           Lsyncd will not detach from the invoker and log as well to
66           stdout/err.
67
68       -pidfile FILE
69           Lsyncd will write its process ID in FILE.
70
71       -runner FILE
72           Makes the Lsyncd core load the part of Lsyncd written in Lua from
73           FILE.
74
75       -version
76           Writes version information and exits.
77

EXIT STATUS

79       (128+SIGNUM)
80           Terminated by Signal (143 by TERM)
81
82       -1
83           Failure (syntax, unrecoverable error condition, internal failure)
84

VERSION

89       This man page is for lsyncd(1) version 2.2.0
90

AUTHOR

92       Axel Kittenberger, <axkibe@gmail.com> 2010-2017
93

COPYING

95       Copyright (C) 2010-2017 Axel Kittenberger. Free use of this software is
96       granted under the terms of the GNU General Public License (GPL) version
97       2, or any later version. Free redistrubition of this Documentation
98       (/doc directory) is granted under the terms of the Creative Commons 3.0
99       Attribution License (CC-3.0-BY).
100
101
102
103Lsyncd 2.2.1                     January 2017                        LSYNCD(1)