octoleo/lsyncd
1
0
Fork 0
mirror of https://github.com/octoleo/lsyncd.git synced 2025-01-23 07:08:33 +00:00
Code Issues Packages Projects Releases Wiki Activity

Docs. Preparing 2.0.5

Browse Source
This commit is contained in:
Axel Kittenberger 2011-08-25 11:34:44 +00:00
parent b74e517b07
commit ce35d4ac77
4 changed files with 39 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
ChangeLog
View File

@ -1,28 +1,31 @@
??-??-2011: 2.0.5 25-08-2011: 2.0.5
fix: Lsyncd will now terminate if it inotify watches exeed their limit. fix: Lsyncd will now terminate if it inotify watching exceeds
its preset limit.
fix: rsync error exit code 12 now results in retries. fix: rsync error exit code 12 now results in retries.
fix: Lsyncd 2.0.5 should now compile better on a little elder fix: Lsyncd 2.0.5 should now compile better on a bit elder
GNU/Linux versions. GNU/Linux versions.
fix: examples are now installed in the configured document directory. fix: examples are now installed in the configured document directory.
fix: partial transfers during startup are considered ok. Lsyncd will fix: partial transfers during startup are considered ok. Lsyncd will
rework the specified files anyway. rework the specified files anyway.
change: Layer 1 interface init() now receives an "Init" event instead change: Layer 1 interface init() now receives an "Init" event instead
of the inlet. of an inlet.
change: builtin code now loaded via c-array. Now more portable and change: builtin Lua code is now loaded via a c-array.
correct memory bits set. Now more portable and correct memory flags are set.
change: Lsyncd will now bail on unknown error codes. change: Lsyncd will now bail on unknown error codes.
enhancement: settings.maxProcesses is now a global limit of childprocesses enhancement: settings.maxProcesses can now be set as a global limit
enhancement: Lsyncd will refuse to startup when any startup rsync of childprocesses
does not work and returns "again", unless settings.insist or enhancement: Lsyncd will refuse to start when any startup rsync
--insist is specified, then Lsyncd will retry until it works. does not work cleanly and returns "again" unless settings.insist or
--insist is specified, then Lsyncd will keep retrying until it works.
enhancement: option "rsyncBinary" determines which rsync Lsyncd calls. enhancement: option "rsyncBinary" determines which rsync Lsyncd calls.
Default is "/usr/bin/rsync" Default is "/usr/bin/rsync"
enhancement: fsevents ("inotify for OSX") fixed for Snowleopard. enhancement: fsevents ("inotify for OSX") fixed for Snowleopard.
and available by default. and is available to configure by default.
enhancement: settings.inotifyMode: the actualy Modification event enhancement: settings.inotifyMode: the actualy Modification event
Lsyncd reacts to can now be configured. Default is to react on Lsyncd reacts to can now be configured. Default is to react on
file closing in write mode. file closing in write mode.
enhancement: readdir(path) is available to userscripts. enhancement: readdir(path) is available to userscripts, reads the contents
of a directory.
27-03-2011: 2.0.4 27-03-2011: 2.0.4
enhancement: new setting options logident, logfacility enhancement: new setting options logident, logfacility

2
configure.ac
View File

@ -1,7 +1,7 @@
# -*- Autoconf -*- # -*- Autoconf -*-
# Process this file with autoconf to produce a configure script. # Process this file with autoconf to produce a configure script.
#AC_PREREQ(2.60) #AC_PREREQ(2.60)
AC_INIT(lsyncd, 2.0.5-beta, axkibe@gmail.com) AC_INIT(lsyncd, 2.0.5, axkibe@gmail.com)
AC_CONFIG_SRCDIR([lsyncd.c]) AC_CONFIG_SRCDIR([lsyncd.c])
AC_CONFIG_HEADER([config.h]) AC_CONFIG_HEADER([config.h])
AM_INIT_AUTOMAKE(AC_PACKAGE_NAME, AC_PACKAGE_VERSION) AM_INIT_AUTOMAKE(AC_PACKAGE_NAME, AC_PACKAGE_VERSION)

38
doc/lsyncd.1.txt
View File

@ -3,8 +3,8 @@ lsyncd(1)
:doctype: manpage :doctype: manpage
:man source: Lsyncd :man source: Lsyncd
:man manual: Lsyncd :man manual: Lsyncd
:man version: 2.0.0 :man version: 2.0.5
:date: December 2010 :date: August 2011
NAME NAME
---- ----
@ -26,22 +26,25 @@ default direct bevahiour (local file operations/rsync):::
DESCRTIPTION DESCRTIPTION
------------ ------------
Lsyncd(1) watches a local directory trees event monitor interface (inotify). Lsyncd(1) watches local directory trees through an event monitor interface
It aggregates and combines events for a few seconds and then spawns one (or (inotify, fsevents). It aggregates and combines events for a few seconds and
more) process(es) to synchronize the changes. By default this is rsync(1). then spawns one or more processes to synchronize the changes. By default this
Lsyncd is thus a light-weight live mirror solution that is comparatively easy is rsync(1). Lsyncd is thus a light-weight asynchronous live mirror solution
to install not requiring new filesystems or blockdevices and does not hamper that is comparatively easy to install not requiring new filesystems or
local filesystem performance. blockdevices and does not hamper local filesystem performance.
Rsync+ssh is an advanced action configuration that uses a SSH(1) to act file Rsync+ssh is an advanced action configuration that uses a SSH(1) to act file
and directory moves directly on the target instead of retransmitting the move and directory moves directly on the target instead of retransmitting the move
destination over the wire. destination over the wire.
Fine-grained customizaton can be achieved through the CONFIG-FILE. Custom Fine-grained customization can be achieved through the CONFIG-FILE. Custom
action configs can even be written from scratch in cascading layers action configs can even be written from scratch in cascading layers ranging
ranging from shell scripts to code written in the LUA(1) language. This way from shell scripts to code written in the LUA(1) language. This way simplicity
simplicity can be balanced with powerfulness. See the online manual for can be balanced with powerfulness. See the online manual for details on the
details on the CONFIG-FILE http://code.google.com/p/lsyncd/wiki/Lsyncd20Manual CONFIG-FILE http://code.google.com/p/lsyncd/wiki/Lsyncd20Manual
Note that under normal configuration Lsyncd will delete pre-existing files in
the target directories that are not present in the respective source directory.
OPTIONS OPTIONS
------- -------
@ -51,6 +54,9 @@ OPTIONS
*-help*:: *-help*::
Show a help message. Show a help message.
*-insist*::
Continues startup even if a startup rsync cannot connect.
*-log* 'LEVEL':: *-log* 'LEVEL'::
Controls which kind of events are logged. By default Lsyncd logs 'Normal' Controls which kind of events are logged. By default Lsyncd logs 'Normal'
and 'Error' Messages. *-log scarce* will make Lsyncd log Error messages and 'Error' Messages. *-log scarce* will make Lsyncd log Error messages
@ -87,15 +93,15 @@ Online Manual: http://code.google.com/p/lsyncd/wiki/Lsyncd2
VERSION VERSION
------ ------
This man page is for lsyncd(1) version 2.0.0 This man page is for lsyncd(1) version 2.0.5
AUTHOR AUTHOR
------ ------
Axel Kittenberger, <axkibe@gmail.com> 2010 Axel Kittenberger, <axkibe@gmail.com> 2010-2011
COPYING COPYING
------- -------
Copyright \(C) 2010 Axel Kittenberger. Free use of this software is granted Copyright \(C) 2010-2011 Axel Kittenberger. Free use of this software is granted
under the terms of the GNU General Public License (GPL) version 2, or any later 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 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). under the terms of the Creative Commons 3.0 Attribution License (CC-3.0-BY).

2
lsyncd.lua
View File

@ -22,7 +22,7 @@ if lsyncd_version then
"You cannot use the lsyncd runner as configuration file!") "You cannot use the lsyncd runner as configuration file!")
lsyncd.terminate(-1) -- ERRNO lsyncd.terminate(-1) -- ERRNO
end end
lsyncd_version = "2.0.5-beta" lsyncd_version = "2.0.5"
----- -----
-- Hides the core interface from user scripts -- Hides the core interface from user scripts