1LSYNCD(1) Lsyncd LSYNCD(1)
2
3
4
6 lsyncd - a daemon to continuously synchronize directory trees
7
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
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
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
79 (128+SIGNUM)
80 Terminated by Signal (143 by TERM)
81
82 -1
83 Failure (syntax, unrecoverable error condition, internal failure)
84
86 Online Manual: https://axkibe.github.io/lsyncd/
87
89 This man page is for lsyncd(1) version 2.2.0
90
92 Axel Kittenberger, <axkibe@gmail.com> 2010-2017
93
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)