lsyncd/lsyncd.lua

2437 lines
55 KiB
Lua
Raw Normal View History

2010-10-25 17:38:57 +00:00
--============================================================================
2010-10-19 10:20:27 +00:00
-- lsyncd.lua Live (Mirror) Syncing Demon
--
-- License: GPLv2 (see COPYING) or any later version
--
-- Authors: Axel Kittenberger <axkibe@gmail.com>
--
-- This is the "runner" part of lsyncd. It containts all its high-level logic.
-- It works closely together with the lsyncd core in lsyncd.c. This means it
-- cannot be runned directly from the standard lua interpreter.
2010-10-25 17:38:57 +00:00
--============================================================================
2010-10-16 18:21:01 +00:00
2010-11-06 16:54:45 +00:00
-----
2010-10-19 10:20:27 +00:00
-- A security measurement.
2010-10-18 17:09:59 +00:00
-- Core will exit if version ids mismatch.
2010-10-25 14:55:40 +00:00
--
2010-10-26 11:26:57 +00:00
if lsyncd_version then
2010-10-22 08:37:15 +00:00
-- checks if the runner is being loaded twice
2010-11-04 13:43:57 +00:00
lsyncd.log("Error",
"You cannot use the lsyncd runner as configuration file!")
lsyncd.terminate(-1) -- ERRNO
2010-10-19 21:56:00 +00:00
end
2010-10-27 11:31:18 +00:00
lsyncd_version = "2.0beta1"
2010-10-18 17:09:59 +00:00
2010-11-05 18:20:33 +00:00
-----
-- Hides the core interface from user scripts
--
2010-11-12 09:45:22 +00:00
local _l = lsyncd
2010-11-05 18:20:33 +00:00
lsyncd = nil
local lsyncd = _l
_l = nil
2010-11-06 16:54:45 +00:00
-----
2010-10-21 12:37:27 +00:00
-- Shortcuts (which user is supposed to be able to use them as well)
2010-10-22 12:58:57 +00:00
--
2010-10-22 10:35:26 +00:00
log = lsyncd.log
2010-10-27 19:34:56 +00:00
terminate = lsyncd.terminate
2010-10-20 18:33:17 +00:00
2010-10-25 17:38:57 +00:00
--============================================================================
2010-11-08 12:14:10 +00:00
-- Lsyncd Prototypes
2010-10-25 17:38:57 +00:00
--============================================================================
2010-10-25 14:55:40 +00:00
2010-10-25 17:38:57 +00:00
-----
2010-11-02 13:18:34 +00:00
-- The array objects are tables that error if accessed with a non-number.
2010-10-25 14:55:40 +00:00
--
2010-11-02 13:18:34 +00:00
local Array = (function()
-- Metatable
local mt = {}
-- on accessing a nil index.
mt.__index = function(t, k)
2010-10-25 17:38:57 +00:00
if type(k) ~= "number" then
2010-11-02 13:18:34 +00:00
error("Key '"..k.."' invalid for Array", 2)
2010-10-25 14:55:40 +00:00
end
2010-10-25 17:38:57 +00:00
return rawget(t, k)
2010-11-02 13:18:34 +00:00
end
-- on assigning a new index.
mt.__newindex = function(t, k, v)
2010-10-25 17:38:57 +00:00
if type(k) ~= "number" then
2010-11-02 13:18:34 +00:00
error("Key '"..k.."' invalid for Array", 2)
2010-10-25 17:38:57 +00:00
end
rawset(t, k, v)
2010-10-25 14:55:40 +00:00
end
2010-11-02 13:18:34 +00:00
-- creates a new object
2010-11-02 17:07:42 +00:00
local function new()
2010-11-02 13:18:34 +00:00
local o = {}
setmetatable(o, mt)
return o
end
-- objects public interface
return {new = new}
end)()
2010-10-25 14:55:40 +00:00
2010-10-25 17:38:57 +00:00
-----
2010-11-02 13:18:34 +00:00
-- The count array objects are tables that error if accessed with a non-number.
-- Additionally they maintain their length as "size" attribute.
2010-10-25 17:38:57 +00:00
-- Lua's # operator does not work on tables which key values are not
-- strictly linear.
--
2010-11-02 13:18:34 +00:00
local CountArray = (function()
-- Metatable
local mt = {}
2010-11-03 11:37:25 +00:00
-----
2010-11-02 13:18:34 +00:00
-- key to native table
local k_nt = {}
2010-11-03 11:37:25 +00:00
-----
2010-11-02 13:18:34 +00:00
-- on accessing a nil index.
mt.__index = function(t, k)
2010-10-25 17:38:57 +00:00
if type(k) ~= "number" then
2010-11-02 13:18:34 +00:00
error("Key '"..k.."' invalid for CountArray", 2)
2010-10-25 17:38:57 +00:00
end
2010-11-02 13:18:34 +00:00
return t[k_nt][k]
end
2010-10-25 17:38:57 +00:00
2010-11-03 11:37:25 +00:00
-----
2010-11-02 13:18:34 +00:00
-- on assigning a new index.
mt.__newindex = function(t, k, v)
2010-10-25 17:38:57 +00:00
if type(k) ~= "number" then
2010-11-02 13:18:34 +00:00
error("Key '"..k.."' invalid for CountArray", 2)
2010-10-25 17:38:57 +00:00
end
2010-11-02 13:18:34 +00:00
-- value before
local vb = t[k_nt][k]
2010-10-25 17:38:57 +00:00
if v and not vb then
2010-11-03 11:37:25 +00:00
t._size = t._size + 1
2010-10-25 17:38:57 +00:00
elseif not v and vb then
2010-11-03 11:37:25 +00:00
t._size = t._size - 1
2010-10-25 17:38:57 +00:00
end
2010-11-02 13:18:34 +00:00
t[k_nt][k] = v
end
2010-11-09 19:15:41 +00:00
-----
-- Walks through all entries in any order.
--
local function walk(self)
return pairs(self[k_nt])
2010-11-02 13:18:34 +00:00
end
2010-11-03 11:37:25 +00:00
2010-11-06 16:54:45 +00:00
-----
2010-11-03 11:37:25 +00:00
-- returns the count
2010-11-09 19:15:41 +00:00
--
2010-11-03 11:37:25 +00:00
local function size(self)
return self._size
end
2010-11-06 16:54:45 +00:00
-----
2010-11-02 13:18:34 +00:00
-- creates a new count array
2010-11-09 19:15:41 +00:00
--
2010-11-02 17:07:42 +00:00
local function new()
2010-11-02 13:18:34 +00:00
-- k_nt is native table, private for this object.
2010-11-09 19:15:41 +00:00
local o = {_size = 0, walk = walk, size = size, [k_nt] = {} }
2010-11-02 13:18:34 +00:00
setmetatable(o, mt)
return o
2010-10-25 14:55:40 +00:00
end
2010-11-02 13:18:34 +00:00
2010-11-09 19:15:41 +00:00
-----
-- public interface
--
2010-11-02 13:18:34 +00:00
return {new = new}
end)()
2010-10-25 14:55:40 +00:00
2010-10-31 22:25:34 +00:00
----
2010-11-01 16:38:39 +00:00
-- Locks globals,
-- no more globals can be created
--
2010-11-06 18:26:59 +00:00
local function lockGlobals()
2010-11-01 16:38:39 +00:00
local t = _G
2010-10-31 22:25:34 +00:00
local mt = getmetatable(t) or {}
2010-11-01 19:57:53 +00:00
mt.__index = function(t, k)
if (k~="_" and string.sub(k, 1, 2) ~= "__") then
2010-11-05 13:34:02 +00:00
error("Access of non-existing global '"..k.."'", 2)
2010-11-01 19:57:53 +00:00
else
rawget(t, k)
end
end
2010-11-01 16:38:39 +00:00
mt.__newindex = function(t, k, v)
if (k~="_" and string.sub(k, 1, 2) ~= "__") then
2010-11-08 12:14:10 +00:00
error("Lsyncd does not allow GLOBALS to be created on the fly. " ..
2010-11-01 16:38:39 +00:00
"Declare '" ..k.."' local or declare global on load.", 2)
else
rawset(t, k, v)
end
end
2010-10-31 22:25:34 +00:00
setmetatable(t, mt)
end
2010-11-02 14:11:26 +00:00
-----
2010-11-10 22:03:02 +00:00
-- Holds information about a delayed event of one Sync.
2010-11-04 13:43:57 +00:00
--
2010-11-02 14:11:26 +00:00
local Delay = (function()
-----
-- Creates a new delay.
--
2010-11-11 19:52:20 +00:00
-- @params see below
--
2010-11-10 09:49:44 +00:00
local function new(etype, alarm, path, path2)
2010-11-02 14:11:26 +00:00
local o = {
2010-11-10 22:03:02 +00:00
-----
-- Type of event.
-- Can be 'Create', 'Modify', 'Attrib', 'Delete' and 'Move'
2010-11-07 09:53:39 +00:00
etype = etype,
2010-11-10 22:03:02 +00:00
-----
-- Latest point in time this should be catered for.
-- This value is in kernel ticks, return of the C's
-- times(NULL) call.
2010-11-02 14:11:26 +00:00
alarm = alarm,
2010-11-10 22:03:02 +00:00
-----
-- path and filename or dirname of the delay relative
-- to the syncs root.
-- for the directories it contains a trailing slash
--
2010-11-06 17:40:12 +00:00
path = path,
2010-11-10 22:03:02 +00:00
------
-- only not nil for 'Move's.
-- path and file/dirname of a move destination.
--
2010-11-10 09:49:44 +00:00
path2 = path2,
2010-11-10 22:03:02 +00:00
------
2010-11-11 15:17:22 +00:00
-- Status of the event. Valid stati are:
-- 'wait' ... the event is ready to be handled.
-- 'active' ... there is process running catering for this event.
-- 'blocked' ... this event waits for another to be handled first.
-- 'done' ... event has been collected. This should never be
-- visible as all references should be droped on
-- collection, nevertheless seperat status for
-- insurrance.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
status = "wait",
2010-11-02 14:11:26 +00:00
}
return o
end
2010-10-31 22:25:34 +00:00
2010-11-02 14:11:26 +00:00
return {new = new}
end)()
2010-11-08 12:14:10 +00:00
-----
-- User interface to grap events
--
2010-11-10 22:03:02 +00:00
-- InletControl is the runners part to control the interface
2010-11-08 12:14:10 +00:00
-- hidden from the user.
--
2010-11-13 19:22:05 +00:00
local getInlet
2010-11-08 12:14:10 +00:00
local Inlet, InletControl = (function()
-- lua runner controlled variables
local sync
2010-11-12 05:58:51 +00:00
-----
2010-11-12 18:52:43 +00:00
-- table to receive the delay of an event.
2010-11-12 05:58:51 +00:00
local e2d = {}
2010-11-12 18:52:43 +00:00
-- doesnt stop the garbage collect to remove entries.
2010-11-12 05:58:51 +00:00
setmetatable(e2d, { __mode = 'kv' })
2010-11-12 18:52:43 +00:00
-- table to receive the delay list of an event list.
local el2dl = {}
-- doesnt stop the garbage collect to remove entries.
setmetatable(el2dl, { __mode = 'kv' })
2010-11-10 11:23:26 +00:00
2010-11-08 12:14:10 +00:00
-----
-- removes the trailing slash from a path
local function cutSlash(path)
if string.byte(path, -1) == 47 then
return string.sub(path, 1, -2)
else
return path
end
end
2010-11-10 11:23:26 +00:00
local function getPath(event)
2010-11-12 09:45:22 +00:00
if event.move ~= "To" then
2010-11-12 05:58:51 +00:00
return e2d[event].path
2010-11-10 11:23:26 +00:00
else
2010-11-12 05:58:51 +00:00
return e2d[event].path2
2010-11-10 11:23:26 +00:00
end
end
2010-11-08 12:14:10 +00:00
-----
2010-11-12 18:52:43 +00:00
-- Interface for user scripts to get event fields.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
local eventFields = {
2010-11-10 22:03:02 +00:00
-----
-- Returns a copy of the configuration as called by sync.
-- But including all inherited data and default values.
--
-- TODO give user a readonly version.
--
2010-11-08 12:14:10 +00:00
config = function(event)
2010-11-12 05:58:51 +00:00
return e2d[event].sync.config
2010-11-08 12:14:10 +00:00
end,
2010-11-13 19:22:05 +00:00
inlet = function(event)
return getInlet()
end,
2010-11-08 12:14:10 +00:00
-----
-- Returns the type of the event.
-- Can be:
2010-11-10 22:03:02 +00:00
-- "Attrib",
-- "Create",
-- "Delete",
-- "Modify",
2010-11-12 18:52:43 +00:00
-- "Move",
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
etype = function(event)
2010-11-12 05:58:51 +00:00
return e2d[event].etype
2010-11-08 12:14:10 +00:00
end,
2010-11-12 09:45:22 +00:00
2010-11-12 18:52:43 +00:00
-----
-- Tells script this isnt a list.
--
isList = function()
return false
end,
2010-11-12 09:45:22 +00:00
-----
-- Returns 'Fr'/'To' for events of moves.
move = function(event)
local d = e2d[event]
if d.move then
return d.move
else
return ""
end
end,
2010-11-11 15:17:22 +00:00
-----
-- Status
status = function(event)
2010-11-12 05:58:51 +00:00
return e2d[event].status
2010-11-11 15:17:22 +00:00
end,
2010-11-08 12:14:10 +00:00
-----
-- Returns true if event relates to a directory.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
isdir = function(event)
2010-11-10 11:23:26 +00:00
return string.byte(getPath(event), -1) == 47
2010-11-08 12:14:10 +00:00
end,
-----
-- Returns the name of the file/dir.
-- Includes a trailing slash for dirs.
2010-11-10 22:03:02 +00:00
--
2010-11-10 11:23:26 +00:00
name = function(event)
return string.match(getPath(event), "[^/]+/?$")
2010-11-08 12:14:10 +00:00
end,
-----
-- Returns the name of the file/dir.
-- Excludes a trailing slash for dirs.
2010-11-10 22:03:02 +00:00
--
2010-11-10 11:23:26 +00:00
basename = function(event)
return string.match(getPath(event), "([^/]+)/?$")
2010-11-08 12:14:10 +00:00
end,
-----
-- Returns the file/dir relative to watch root
-- Includes a trailing slash for dirs.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
path = function(event)
2010-11-10 11:23:26 +00:00
return getPath(event)
2010-11-08 12:14:10 +00:00
end,
-----
-- Returns the file/dir relativ to watch root
-- Excludes a trailing slash for dirs.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
pathname = function(event)
2010-11-10 11:23:26 +00:00
return cutSlash(getPath(event))
2010-11-08 12:14:10 +00:00
end,
------
-- Returns the absolute path of the watch root.
-- All symlinks will have been resolved.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
source = function(event)
return sync.source
end,
------
-- Returns the absolute path of the file/dir.
-- Includes a trailing slash for dirs.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
sourcePath = function(event)
2010-11-12 18:52:43 +00:00
return sync.source .. getPath(event)
2010-11-08 12:14:10 +00:00
end,
------
-- Returns the absolute path of the file/dir.
-- Excludes a trailing slash for dirs.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
sourcePathname = function(event)
2010-11-10 11:23:26 +00:00
return sync.source .. cutSlash(getPath(event))
2010-11-08 12:14:10 +00:00
end,
------
-- Returns the target.
-- Just for user comfort, for most case
-- (Actually except of here, the lsyncd.runner itself
-- does not care event about the existance of "target",
-- this is completly up to the action scripts.)
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
target = function(event)
return sync.config.target
end,
------
-- Returns the relative dir/file appended to the target.
-- Includes a trailing slash for dirs.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
targetPath = function(event)
2010-11-10 11:23:26 +00:00
return sync.config.target .. getPath(event)
2010-11-08 12:14:10 +00:00
end,
------
-- Returns the relative dir/file appended to the target.
-- Excludes a trailing slash for dirs.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
targetPathname = function(event)
2010-11-10 11:23:26 +00:00
return sync.config.target .. cutSlash(getPath(event))
2010-11-08 12:14:10 +00:00
end,
}
2010-11-12 18:52:43 +00:00
2010-11-08 12:14:10 +00:00
-----
2010-11-12 18:52:43 +00:00
-- Retrievs event fields for the user script.
2010-11-10 22:03:02 +00:00
--
2010-11-08 12:14:10 +00:00
local eventMeta = {
__index = function(t, k)
local f = eventFields[k]
if not f then
2010-11-12 05:58:51 +00:00
if k == 'move' then
2010-11-10 11:23:26 +00:00
-- possibly undefined
return nil
end
2010-11-08 12:14:10 +00:00
error("event does not have field '"..k.."'", 2)
end
return f(t)
end
}
2010-11-13 19:22:05 +00:00
-----
-- adds an exclude.
--
local function addExclude(pattern)
sync:addExclude(pattern)
end
2010-11-08 12:14:10 +00:00
2010-11-13 19:22:05 +00:00
-----
-- removes an exclude.
--
local function rmExclude(pattern)
sync:rmExclude(pattern)
end
2010-11-08 12:14:10 +00:00
-----
2010-11-12 18:52:43 +00:00
-- Interface for user scripts to get event fields.
--
local eventListFuncs = {
-----
2010-11-12 20:43:27 +00:00
-- Returns the paths of all events.
2010-11-12 18:52:43 +00:00
--
2010-11-12 20:43:27 +00:00
getPaths = function(elist, delimiter)
2010-11-12 18:52:43 +00:00
local dlist = el2dl[elist]
if not dlist then
error("cannot find delay list from event list.")
end
if not delimiter then
delimiter = '\n'
end
local pl = {}
local i = 1
for k, d in pairs(dlist) do
if type(k) == "number" then
pl[i] = d.path
i = i + 1
if d.path2 then
pl[i] = d.path2
i = i + 1
end
end
end
return table.concat(pl, delimiter) .. delimiter
end,
2010-11-12 20:43:27 +00:00
-----
-- Returns the absolute local paths of all events.
--
getSourcePaths = function(elist, delimiter)
local dlist = el2dl[elist]
if not dlist then
error("cannot find delay list from event list.")
end
if not delimiter then
delimiter = '\n'
end
local pl = {}
local i = 1
for k, d in pairs(dlist) do
if type(k) == "number" then
pl[i] = sync.source .. d.path
i = i + 1
if d.path2 then
pl[i] = sync.source .. d.path2
i = i + 1
end
end
end
return table.concat(pl, delimiter) .. delimiter
end,
2010-11-12 18:52:43 +00:00
}
-----
-- Retrievs event list fields for the user script.
--
local eventListMeta = {
__index = function(t, k)
if k == "isList" then
return true
end
local f = eventListFuncs[k]
if not f then
error("event list does not have function '"..k.."'", 2)
end
return function()
return f(t)
end
end
}
-----
-- Encapsulates a delay into an event for the user script.
2010-11-08 12:14:10 +00:00
--
2010-11-12 09:45:22 +00:00
local function d2e(delay)
2010-11-10 12:59:51 +00:00
if delay.etype ~= "Move" then
if not delay.event then
2010-11-12 05:58:51 +00:00
local event = {}
delay.event = event
setmetatable(event, eventMeta)
e2d[event] = delay
2010-11-10 11:23:26 +00:00
end
2010-11-10 12:59:51 +00:00
return delay.event
else
-- moves have 2 events - origin and destination
if not delay.event then
2010-11-12 05:58:51 +00:00
local event = {}
local event2 = {}
delay.event = event
delay.event2 = event2
setmetatable(event, eventMeta)
setmetatable(event2, eventMeta)
e2d[delay.event] = delay
e2d[delay.event2] = delay
-- move events have a field 'event'
2010-11-12 09:45:22 +00:00
event.move = "Fr"
event2.move = "To"
2010-11-10 12:59:51 +00:00
end
return delay.event, delay.event2
2010-11-08 12:14:10 +00:00
end
end
2010-11-12 18:52:43 +00:00
-----
-- Encapsulates a delay list into an event list for the user script.
--
local function dl2el(dlist)
if not dlist.elist then
local elist = {}
dlist.elist = elist
setmetatable(elist, eventListMeta)
el2dl[elist] = dlist
end
return dlist.elist
end
2010-11-08 12:14:10 +00:00
-----
-- Creates a blanketEvent that blocks everything
-- and is blocked by everything.
--
2010-11-10 09:49:44 +00:00
local function createBlanketEvent()
2010-11-12 09:45:22 +00:00
return d2e(sync:addBlanketDelay())
2010-11-08 12:14:10 +00:00
end
2010-11-11 15:17:22 +00:00
-----
2010-11-12 20:55:22 +00:00
-- Discards a waiting event.
2010-11-11 15:17:22 +00:00
--
2010-11-12 20:55:22 +00:00
local function discardEvent(event)
2010-11-12 05:58:51 +00:00
local delay = e2d[event]
2010-11-11 19:52:20 +00:00
if delay.status ~= "wait" then
2010-11-11 15:17:22 +00:00
log("Error", "Ignored try to cancel a non-waiting event of type ",
event.etype)
return
end
2010-11-13 13:44:51 +00:00
sync:removeDelay(delay)
2010-11-11 15:17:22 +00:00
end
2010-11-08 12:14:10 +00:00
-----
2010-11-10 22:03:02 +00:00
-- Gets the next not blocked event from queue.
2010-11-08 12:14:10 +00:00
--
local function getEvent()
2010-11-12 09:45:22 +00:00
return d2e(sync:getNextDelay(lysncd.now()))
2010-11-08 12:14:10 +00:00
end
2010-11-12 18:52:43 +00:00
-----
-- Gets all events that are not blocked by active events.
--
2010-11-13 18:04:37 +00:00
-- @param if not nil a function to test each delay
--
local function getEvents(test)
local dlist = sync:getDelays(test)
2010-11-12 18:52:43 +00:00
return dl2el(dlist)
end
2010-11-08 12:14:10 +00:00
-----
-- Returns the configuration table specified by sync{}
--
local function getConfig()
-- TODO give a readonly handler only.
return sync.config
end
-----
-- Interface for lsyncd runner to control what
-- the inlet will present the user.
--
2010-11-10 09:49:44 +00:00
local function setSync(setSync)
2010-11-08 12:14:10 +00:00
sync = setSync
end
-----
2010-11-12 18:52:43 +00:00
-- Returns the delay from a event.
-- not to be called from user script.
local function getDelay(event)
return e2d[event]
end
-----
-- Returns the delay list from a event list.
-- not to be called from user script.
local function getDelayList(elist)
return el2dl[elist]
end
-----
-- Return the currentsync
-- not to be called from user script.
local function getSync()
return sync
2010-11-08 12:14:10 +00:00
end
-----
-- public interface.
-- this one is split, one for user one for runner.
return {
2010-11-13 19:22:05 +00:00
addExclude = addExclude,
2010-11-13 13:44:51 +00:00
createBlanketEvent = createBlanketEvent,
2010-11-13 19:22:05 +00:00
discardEvent = discardEvent,
getEvent = getEvent,
getEvents = getEvents,
getConfig = getConfig,
rmExclude = rmExclude,
2010-11-08 12:14:10 +00:00
}, {
2010-11-12 09:45:22 +00:00
d2e = d2e,
2010-11-12 18:52:43 +00:00
dl2el = dl2el,
2010-11-13 13:44:51 +00:00
getDelay = getDelay,
getDelayList = getDelayList,
getSync = getSync,
setSync = setSync,
2010-11-08 12:14:10 +00:00
}
end)()
2010-11-13 19:22:05 +00:00
-----
-- Little dirty workaround to retrieve the Inlet from events in Inlet
getInlet = function()
return Inlet
end
2010-11-13 16:59:46 +00:00
-----
-- A set of exclude patterns
--
local Excludes = (function()
-----
-- Turns a rsync like file pattern to a lua pattern.
--
--
local function toLuaPattern(p)
local o = p
p = string.gsub(p, "%%", "%%")
p = string.gsub(p, "%^", "%^")
p = string.gsub(p, "%$", "%$")
p = string.gsub(p, "%(", "%(")
p = string.gsub(p, "%)", "%)")
p = string.gsub(p, "%.", "%.")
p = string.gsub(p, "%[", "%[")
p = string.gsub(p, "%]", "%]")
p = string.gsub(p, "%+", "%+")
p = string.gsub(p, "%-", "%-")
p = string.gsub(p, "%?", "[^/]")
p = string.gsub(p, "%*", "[^/]*")
-- this was a ** before v
p = string.gsub(p, "%[%^/%]%*%[%^/%]%*", ".*")
p = string.gsub(p, "^/", "^")
p = string.gsub(p, "/$", "/$")
log("Exclude", "toLuaPattern '",o,"' = '",p,'"')
return p
end
-----
-- Adds a pattern to exclude.
--
local function add(self, pattern)
if self.list[pattern] then
-- already in the list
return
end
local lp = toLuaPattern(pattern)
self.list[pattern] = lp
end
2010-11-13 19:22:05 +00:00
-----
-- Removes a pattern to exclude.
--
local function remove(self, pattern)
if not self.list[pattern] then
-- already in the list
log("Normal", "Removing not excluded exclude '"..pattern.."'")
return
end
self.list[pattern] = nil
end
2010-11-13 16:59:46 +00:00
-----
-- Adds a list of patterns to exclude.
--
local function addList(self, plist)
for _, v in plist do
add(self, v)
end
end
-----
-- loads excludes from a file
--
local function loadFile(self, file)
f, err = io.open(file)
if not f then
log("Error", "Cannot open exclude file '",file,"': ", err)
terminate(-1) -- ERRNO
end
for line in f:lines() do
-- lsyncd 2.0 does not support includes
if not string.match(line, "%s*+") then
local p = string.match(line, "%s*-?%s*(.*)")
if p then
add(self, p)
end
end
end
f:close()
end
-----
-- Tests if 'file' is excluded.
--
local function test(self, file)
for _, p in pairs(self.list) do
if (string.match(file, p)) then
return true
end
end
return false
end
-----
-- Cretes a new exclude set
--
local function new()
return {
list = {},
-- functions
2010-11-13 19:22:05 +00:00
add = add,
adList = addList,
2010-11-13 16:59:46 +00:00
loadFile = loadFile,
2010-11-13 19:22:05 +00:00
remove = remove,
test = test,
2010-11-13 16:59:46 +00:00
}
end
-----
-- Public interface
return { new = new }
end)()
2010-11-02 14:11:26 +00:00
-----
2010-11-03 11:37:25 +00:00
-- Holds information about one observed directory inclusively subdirs.
2010-11-02 14:11:26 +00:00
--
2010-11-06 10:10:00 +00:00
local Sync = (function()
2010-11-08 12:14:10 +00:00
2010-11-06 18:26:59 +00:00
-----
2010-11-10 22:03:02 +00:00
-- Syncs that have no name specified by the user script
-- get an incremental default name 'Sync[X]'
2010-11-06 18:26:59 +00:00
--
local nextDefaultName = 1
2010-11-12 20:43:27 +00:00
2010-11-13 19:22:05 +00:00
-----
-- Adds an exclude.
--
local function addExclude(self, pattern)
return self.excludes:add(pattern)
end
-----
-- Removes an exclude.
--
local function rmExclude(self, pattern)
return self.excludes:remove(pattern)
end
2010-11-11 15:17:22 +00:00
-----
-- Removes a delay.
2010-11-12 20:43:27 +00:00
--
2010-11-11 15:17:22 +00:00
local function removeDelay(self, delay)
local found
for i, d in ipairs(self.delays) do
if d == delay then
found = true
table.remove(self.delays, i)
break
end
end
2010-11-12 11:04:45 +00:00
2010-11-11 15:17:22 +00:00
if not found then
error("Did not find a delay to be removed!")
end
2010-11-12 11:04:45 +00:00
-- free all delays blocked by this one.
if delay.blocks then
for i, vd in pairs(delay.blocks) do
vd.status = "wait"
end
end
2010-11-11 15:17:22 +00:00
end
2010-11-08 12:14:10 +00:00
-----
-- Collects a child process
--
local function collect(self, pid, exitcode)
local delay = self.processes[pid]
if not delay then
-- not a child of this sync.
return
end
2010-11-10 22:03:02 +00:00
2010-11-12 18:52:43 +00:00
if delay.status then
-- collected an event
if delay.status ~= "active" then
error("internal fail, collecting a non-active process")
end
InletControl.setSync(self)
local rc = self.config.collect(InletControl.d2e(delay), exitcode)
-- TODO honor return codes of the collect?
2010-11-12 10:07:58 +00:00
2010-11-12 18:52:43 +00:00
removeDelay(self, delay)
log("Delay","Finish of ",delay.etype," on ",
self.source,delay.path," = ",exitcode)
else
log("Delay", "collected a list")
InletControl.setSync(self)
local rc = self.config.collect(InletControl.dl2el(delay), exitcode)
-- TODO honor return codes of collect?
for k, d in pairs(delay) do
if type(k) == "number" then
removeDelay(self, d)
end
end
log("Delay","Finished list = ",exitcode)
end
2010-11-08 12:14:10 +00:00
self.processes[pid] = nil
end
2010-11-06 18:26:59 +00:00
2010-11-12 09:45:22 +00:00
-----
-- Stacks a newDelay on the oldDelay,
-- the oldDelay blocks the new Delay.
--
-- A delay can block 'n' other delays,
-- but is blocked at most by one, the latest delay.
--
local function stack(oldDelay, newDelay)
newDelay.status = "block"
if not oldDelay.blocks then
oldDelay.blocks = {}
end
table.insert(oldDelay.blocks, newDelay)
end
2010-11-06 18:26:59 +00:00
-----
-- Puts an action on the delay stack.
--
2010-11-07 09:53:39 +00:00
local function delay(self, etype, time, path, path2)
2010-11-10 09:49:44 +00:00
log("Function", "delay(", self.config.name,", ",etype,", ",path,")")
2010-11-13 16:59:46 +00:00
if not path2 then
-- test for exclusion
if self.excludes:test(path) then
log("Exclude", "excluded ",etype," on '",path,"'")
return
end
else
2010-11-12 09:45:22 +00:00
log("Function", "+ ",path2)
2010-11-13 16:59:46 +00:00
local ex1 = self.excludes:test(path)
local ex2 = self.excludes:test(path2)
if ex1 and ex2 then
log("Exclude", "excluded '",etype," on '",path,
"' -> '",path2,"'")
return
elseif not ex1 and ex2 then
-- splits the move if only partly excluded
log("Exclude", "excluded destination transformed ",etype,
" to Delete ",path)
delay(self, "Delete", time, path, nil)
return
elseif ex1 and not ex2 then
-- splits the move if only partly excluded
log("Exclude", "excluded origin transformed ",etype,
" to Create.",path2)
delay(self, "Create", time, path2, nil)
return
end
2010-11-10 09:49:44 +00:00
end
2010-11-06 18:26:59 +00:00
2010-11-10 09:49:44 +00:00
if etype == "Move" and not self.config.onMove then
2010-11-12 09:45:22 +00:00
-- if there is no move action defined,
-- split a move as delete/create
2010-11-10 22:03:02 +00:00
log("Delay", "splitting Move into Delete & Create")
2010-11-06 18:26:59 +00:00
delay(self, "Delete", time, path, nil)
delay(self, "Create", time, path2, nil)
return
end
-- creates the new action
local alarm
if time and self.config.delay then
alarm = lsyncd.addtoclock(time, self.config.delay)
else
alarm = lsyncd.now()
end
2010-11-10 09:49:44 +00:00
-- new delay
local nd = Delay.new(etype, alarm, path, path2)
2010-11-10 22:03:02 +00:00
if nd.etype == "Blanket" then
2010-11-12 09:45:22 +00:00
-- always stack blanket events on the last event
2010-11-10 22:03:02 +00:00
log("Delay", "Stacking blanket event.")
2010-11-12 09:45:22 +00:00
if #self.delays > 0 then
stack(self.delays[#self.delays], nd)
end
2010-11-12 20:43:27 +00:00
addDelayPath("", nd)
2010-11-10 09:49:44 +00:00
table.insert(self.delays, nd)
2010-11-10 12:59:51 +00:00
return
2010-11-10 09:49:44 +00:00
end
-----
2010-11-12 09:45:22 +00:00
-- detects blocks and collapses by working from back until
2010-11-10 09:49:44 +00:00
-- front through the fifo
InletControl.setSync(self)
2010-11-12 09:45:22 +00:00
local ne, ne2 = InletControl.d2e(nd)
2010-11-10 09:49:44 +00:00
local il = #self.delays -- last delay
while il > 0 do
2010-11-12 09:45:22 +00:00
-- get 'old' delay
2010-11-10 09:49:44 +00:00
local od = self.delays[il]
2010-11-10 11:23:26 +00:00
-- tries to collapse identical paths
2010-11-12 09:45:22 +00:00
local oe, oe2 = InletControl.d2e(od)
2010-11-10 11:23:26 +00:00
2010-11-10 22:03:02 +00:00
if oe.etype == "Blanket" then
-- everything is blocked by a blanket event.
log("Delay", "Stacking ",nd.etype," upon blanket event.")
2010-11-12 09:45:22 +00:00
stack(od, nd)
2010-11-10 22:03:02 +00:00
table.insert(self.delays, nd)
return
end
-- this mini loop repeats the collapse a second
-- time for move events
2010-11-10 11:23:26 +00:00
local oel = oe
2010-11-12 09:45:22 +00:00
local nel = ne
while oel and nel do
local c = self.config.collapse(oel, nel, self.config)
2010-11-10 11:23:26 +00:00
if c == 0 then
-- events nullificate each ether
2010-11-13 18:04:37 +00:00
od.etype = "None"
table.remove(self.delays, il)
2010-11-10 22:03:02 +00:00
return
2010-11-10 11:23:26 +00:00
elseif c == 1 then
2010-11-10 22:03:02 +00:00
log("Delay",nd.etype," is absored by event ",
od.etype," on ",path)
return
2010-11-10 11:23:26 +00:00
elseif c == 2 then
2010-11-13 07:53:04 +00:00
if od.etype ~= "Move" then
log("Delay",nd.etype," replaces event ",
od.etype," on ",path)
od.etype = nd.etype
if od.path ~= nd.path then
error("Cannot replace events with different paths")
end
else
2010-11-13 08:00:07 +00:00
log("Delay",nd.etype," turns a Move into delete of ",
od.path)
2010-11-13 07:53:04 +00:00
od.etype = "Delete"
od.path2 = nil
table.insert(self.delays, nd)
end
2010-11-10 22:03:02 +00:00
return
2010-11-10 11:23:26 +00:00
elseif c == 3 then
2010-11-10 22:03:02 +00:00
log("Delay", "Stacking ",nd.etype," upon ",
od.etype," on ",path)
2010-11-12 09:45:22 +00:00
stack(od, nd)
2010-11-12 11:04:45 +00:00
table.insert(self.delays, nd)
return
2010-11-10 22:03:02 +00:00
end
2010-11-12 09:45:22 +00:00
-- loops over all oe, oe2, ne, ne2 combos.
if oel == oe and oe2 then
-- do another time for oe2 if present
2010-11-10 11:23:26 +00:00
oel = oe2
2010-11-12 09:45:22 +00:00
elseif nel == ne then
-- do another time for ne2 if present
-- start with first oe
nel = ne2
oel = oe
2010-11-12 11:04:45 +00:00
else
oel = false
2010-11-06 18:26:59 +00:00
end
end
2010-11-10 09:49:44 +00:00
il = il - 1
2010-11-06 18:26:59 +00:00
end
2010-11-12 11:04:45 +00:00
log("Delay", "Registering ",nd.etype," on ",path)
2010-11-10 09:49:44 +00:00
-- there was no hit on collapse or it decided to stack.
table.insert(self.delays, nd)
2010-11-06 18:26:59 +00:00
end
2010-11-06 21:29:22 +00:00
2010-11-10 22:03:02 +00:00
-----
2010-11-08 12:14:10 +00:00
-- Returns the nearest alarm for this Sync.
2010-11-06 21:29:22 +00:00
--
local function getAlarm(self)
-- first checks if more processses could be spawned
if self.processes:size() >= self.config.maxProcesses then
return nil
end
2010-11-11 19:52:20 +00:00
-- finds the nearest delay waiting to be spawned
for _, d in ipairs(self.delays) do
if d.status == "wait" then
return d.alarm
end
2010-11-06 21:29:22 +00:00
end
2010-11-11 19:52:20 +00:00
-- nothing to spawn.
return nil
2010-11-06 21:29:22 +00:00
end
2010-11-11 15:17:22 +00:00
2010-11-12 18:52:43 +00:00
2010-11-08 12:14:10 +00:00
-----
2010-11-12 18:52:43 +00:00
-- Gets all delays that are not blocked by active delays.
2010-11-08 12:14:10 +00:00
--
2010-11-13 18:04:37 +00:00
-- @param test function to test each delay
--
local function getDelays(self, test)
2010-11-12 18:52:43 +00:00
local dlist = {}
local blocks = {}
----
-- inheritly transfers all blocks from delay
--
local function getBlocks(delay)
blocks[delay] = true
2010-11-13 18:04:37 +00:00
if delay.blocks then
for i, d in ipairs(delay.blocks) do
getBlocks(d)
end
2010-11-08 12:14:10 +00:00
end
2010-11-12 18:52:43 +00:00
end
for i, d in ipairs(self.delays) do
2010-11-13 18:04:37 +00:00
if d.status == "active" or
(test and not test(InletControl.d2e(d)))
then
2010-11-12 18:52:43 +00:00
getBlocks(d)
elseif not blocks[d] then
dlist[i] = d
2010-11-08 12:14:10 +00:00
end
end
2010-11-12 18:52:43 +00:00
return dlist
2010-11-08 12:14:10 +00:00
end
2010-11-07 01:06:08 +00:00
-----
-- Creates new actions
--
2010-11-08 12:14:10 +00:00
local function invokeActions(self, now)
log("Function", "invokeActions('",self.config.name,"',",now,")")
2010-11-07 01:06:08 +00:00
if self.processes:size() >= self.config.maxProcesses then
2010-11-08 12:14:10 +00:00
-- no new processes
2010-11-07 01:06:08 +00:00
return
end
2010-11-08 12:14:10 +00:00
for _, d in ipairs(self.delays) do
2010-11-12 20:55:22 +00:00
if #self.delays < self.config.maxDelays then
-- time constrains only are only a concern if not maxed
-- the delay FIFO already.
if d.alarm ~= true and lsyncd.clockbefore(now, d.alarm) then
-- reached point in stack where delays are in future
return
end
2010-11-08 12:14:10 +00:00
end
if d.status == "wait" then
-- found a waiting delay
2010-11-10 09:49:44 +00:00
InletControl.setSync(self)
2010-11-08 12:14:10 +00:00
self.config.action(Inlet)
if self.processes:size() >= self.config.maxProcesses then
-- no further processes
return
end
end
2010-11-07 01:06:08 +00:00
end
end
2010-11-12 18:52:43 +00:00
-----
-- Gets the next event to be processed.
--
local function getNextDelay(self, now)
for i, d in ipairs(self.delays) do
2010-11-12 20:55:22 +00:00
if #self.delays < self.config.maxDelays then
-- time constrains only are only a concern if not maxed
-- the delay FIFO already.
if d.alarm ~= true and lsyncd.clockbefore(now, d.alarm) then
-- reached point in stack where delays are in future
return nil
end
2010-11-12 18:52:43 +00:00
end
if d.status == "wait" then
-- found a waiting delay
return d
end
end
end
2010-11-07 01:06:08 +00:00
2010-11-08 12:14:10 +00:00
2010-11-07 09:53:39 +00:00
------
2010-11-08 12:14:10 +00:00
-- adds and returns a blanket delay thats blocks all
-- (used in startup)
2010-11-07 09:53:39 +00:00
--
2010-11-08 12:14:10 +00:00
local function addBlanketDelay(self)
2010-11-10 22:03:02 +00:00
local newd = Delay.new("Blanket", true, "")
2010-11-08 12:14:10 +00:00
table.insert(self.delays, newd)
return newd
2010-11-07 09:53:39 +00:00
end
2010-11-12 10:07:58 +00:00
-----
-- Writes a status report about delays in this sync.
--
local function statusReport(self, f)
local spaces = " "
f:write(self.config.name," source=",self.source,"\n")
f:write("There are ",#self.delays, " delays\n")
for i, vd in ipairs(self.delays) do
2010-11-12 11:04:45 +00:00
local st = vd.status
f:write(st, string.sub(spaces, 1, 7 - #st))
f:write(vd.etype," ")
2010-11-12 10:07:58 +00:00
-- TODO spaces
f:write(vd.path)
if (vd.path2) then
f:write(" -> ",vd.path2)
end
2010-11-12 11:04:45 +00:00
f:write("\n")
2010-11-12 10:07:58 +00:00
end
2010-11-13 16:59:46 +00:00
f:write("Excluding:\n")
local nothing = true
for t, p in pairs(self.excludes.list) do
nothing = false
f:write(t,"\n")
end
if nothing then
f:write(" nothing.\n")
end
f:write("\n\n")
2010-11-12 10:07:58 +00:00
end
2010-11-07 09:53:39 +00:00
2010-11-06 16:54:45 +00:00
-----
2010-11-06 10:33:26 +00:00
-- Creates a new Sync
2010-11-02 14:11:26 +00:00
--
2010-11-05 15:18:01 +00:00
local function new(config)
2010-11-06 18:26:59 +00:00
local s = {
2010-11-10 09:49:44 +00:00
-- fields
2010-11-02 14:11:26 +00:00
config = config,
delays = CountArray.new(),
2010-11-05 15:18:01 +00:00
source = config.source,
2010-11-02 14:11:26 +00:00
processes = CountArray.new(),
2010-11-13 16:59:46 +00:00
excludes = Excludes.new(),
2010-11-06 21:29:22 +00:00
-- functions
2010-11-13 19:22:05 +00:00
addBlanketDelay = addBlanketDelay,
addExclude = addExclude,
2010-11-08 12:14:10 +00:00
collect = collect,
delay = delay,
getAlarm = getAlarm,
2010-11-12 18:52:43 +00:00
getDelays = getDelays,
2010-11-08 12:14:10 +00:00
getNextDelay = getNextDelay,
invokeActions = invokeActions,
2010-11-11 15:17:22 +00:00
removeDelay = removeDelay,
2010-11-13 19:22:05 +00:00
rmExclude = rmExclude,
2010-11-12 10:07:58 +00:00
statusReport = statusReport,
2010-11-02 14:11:26 +00:00
}
2010-11-06 18:26:59 +00:00
-- provides a default name if needed
if not config.name then
config.name = "Sync" .. nextDefaultName
end
2010-11-08 12:14:10 +00:00
-- increments default nevertheless to cause less confusion
-- so name will be the n-th call to sync{}
2010-11-06 18:26:59 +00:00
nextDefaultName = nextDefaultName + 1
2010-11-13 16:59:46 +00:00
-- loads exclusions
if config.exclude then
s.excludes:addList(config.exclude)
end
if config.excludeFrom then
s.excludes:loadFile(config.excludeFrom)
end
2010-11-06 18:26:59 +00:00
return s
2010-11-02 14:11:26 +00:00
end
2010-11-06 18:26:59 +00:00
-----
2010-11-02 14:11:26 +00:00
-- public interface
2010-11-08 12:14:10 +00:00
--
2010-11-02 14:11:26 +00:00
return {new = new}
end)()
2010-10-25 17:38:57 +00:00
2010-11-02 14:11:26 +00:00
-----
2010-11-06 10:10:00 +00:00
-- Syncs - a singleton
2010-11-02 14:11:26 +00:00
--
-- It maintains all configured directories to be synced.
--
2010-11-06 10:10:00 +00:00
local Syncs = (function()
2010-11-06 18:26:59 +00:00
-----
2010-11-06 10:33:26 +00:00
-- the list of all syncs
2010-11-06 18:26:59 +00:00
--
2010-11-02 14:11:26 +00:00
local list = Array.new()
2010-11-02 20:18:05 +00:00
-----
2010-11-03 11:37:25 +00:00
-- inheritly copies all non integer keys from
2010-11-02 20:18:05 +00:00
-- @cd copy destination
2010-11-03 11:37:25 +00:00
-- to
2010-11-02 20:18:05 +00:00
-- @cs copy source
2010-11-03 11:37:25 +00:00
-- all integer keys are treated as new copy sources
--
2010-11-02 20:18:05 +00:00
local function inherit(cd, cs)
2010-11-03 15:53:20 +00:00
-- first copies from source all
-- non-defined non-integer keyed values
for k, v in pairs(cs) do
if type(k) ~= "number" and not cd[k] then
cd[k] = v
end
end
2010-11-03 11:37:25 +00:00
-- first recurses into all integer keyed tables
for i, v in ipairs(cs) do
if type(v) == "table" then
inherit(cd, v)
end
2010-11-02 20:18:05 +00:00
end
end
-----
2010-11-03 11:37:25 +00:00
-- Adds a new directory to observe.
--
local function add(config)
2010-11-06 10:10:00 +00:00
-----
-- Creates a new config table and inherit all keys/values
-- from integer keyed tables
2010-11-06 18:26:59 +00:00
--
2010-11-03 15:53:20 +00:00
local uconfig = config
config = {}
inherit(config, uconfig)
2010-11-11 15:17:22 +00:00
-- at very first let the userscript 'prepare' function
-- fill out more values.
if type(config.prepare) == "function" then
-- give explicitly a writeable copy of config.
config.prepare(config)
end
if not config["source"] then
local info = debug.getinfo(3, "Sl")
log("Error", info.short_src, ":", info.currentline,
": source missing from sync.")
terminate(-1) -- ERRNO
2010-11-02 20:18:05 +00:00
end
2010-11-11 15:17:22 +00:00
2010-11-02 14:11:26 +00:00
-- absolute path of source
2010-11-10 22:03:02 +00:00
local realsrc = lsyncd.realdir(config.source)
if not realsrc then
2010-11-10 09:49:44 +00:00
log("Error", "Cannot access source directory: ",config.source)
2010-11-02 14:11:26 +00:00
terminate(-1) -- ERRNO
end
2010-11-06 10:10:00 +00:00
config._source = config.source
2010-11-10 22:03:02 +00:00
config.source = realsrc
2010-11-02 20:18:05 +00:00
2010-11-06 10:10:00 +00:00
if not config.action and not config.onAttrib and
2010-11-05 15:18:01 +00:00
not config.onCreate and not config.onModify and
not config.onDelete and not config.onMove
2010-11-02 20:18:05 +00:00
then
2010-11-05 15:18:01 +00:00
local info = debug.getinfo(3, "Sl")
2010-11-02 21:04:01 +00:00
log("Error", info.short_src, ":", info.currentline,
2010-11-02 20:18:05 +00:00
": no actions specified, use e.g. 'config=default.rsync'.")
terminate(-1) -- ERRNO
end
-- loads a default value for an option if not existent
2010-11-13 19:22:05 +00:00
if not settings then
settings = {}
end
2010-11-12 20:55:22 +00:00
local defaultValues = {
'action',
'collapse',
'collapseTable',
'collect',
'init',
'maxDelays',
'maxProcesses',
}
2010-11-10 12:59:51 +00:00
for _, dn in pairs(defaultValues) do
2010-11-10 11:23:26 +00:00
if config[dn] == nil then
2010-11-10 12:59:51 +00:00
config[dn] = settings[dn] or default[dn]
2010-11-02 20:18:05 +00:00
end
end
2010-11-02 14:11:26 +00:00
2010-11-10 11:23:26 +00:00
--- creates the new sync
2010-11-06 10:10:00 +00:00
local s = Sync.new(config)
table.insert(list, s)
2010-11-02 14:11:26 +00:00
end
2010-11-06 18:26:59 +00:00
-----
2010-11-06 10:33:26 +00:00
-- allows to walk through all syncs
2010-11-06 18:26:59 +00:00
--
2010-11-02 17:07:42 +00:00
local function iwalk()
2010-11-02 14:11:26 +00:00
return ipairs(list)
end
2010-11-06 18:26:59 +00:00
-----
2010-11-06 10:33:26 +00:00
-- returns the number of syncs
2010-11-06 18:26:59 +00:00
--
2010-11-02 14:11:26 +00:00
local size = function()
return #list
end
-- public interface
return {add = add, iwalk = iwalk, size = size}
end)()
2010-10-25 17:38:57 +00:00
2010-11-11 18:34:44 +00:00
2010-10-17 15:24:55 +00:00
-----
2010-11-03 11:37:25 +00:00
-- Interface to inotify, watches recursively subdirs and
-- sends events.
2010-10-28 17:56:33 +00:00
--
2010-11-03 11:37:25 +00:00
-- All inotify specific implementation should be enclosed here.
-- So lsyncd can work with other notifications mechanisms just
-- by changing this.
2010-10-21 12:37:27 +00:00
--
2010-11-03 11:37:25 +00:00
local Inotifies = (function()
-----
-- A list indexed by inotifies watch descriptor.
2010-11-06 10:33:26 +00:00
-- Contains a list of all syncs observing this directory
2010-11-03 11:37:25 +00:00
-- (directly or by recurse)
local wdlist = CountArray.new()
2010-10-17 15:24:55 +00:00
2010-11-09 19:15:41 +00:00
-----
-- A list indexed by sync's containing a list of all paths
-- watches by this sync pointing to the watch descriptor.
local syncpaths = {}
2010-11-03 11:37:25 +00:00
-----
-- Adds watches for a directory including all subdirectories.
--
2010-11-05 18:04:29 +00:00
-- @param root+path directory to observe
-- @param recurse true if recursing into subdirs or
-- the relative path to root for recursed inotifies
2010-11-06 10:33:26 +00:00
-- @param sync link to the observer to be notified.
2010-11-05 18:04:29 +00:00
-- Note: Inotifies should handle this opaquely
2010-11-06 10:33:26 +00:00
local function add(root, path, recurse, sync)
2010-11-05 18:04:29 +00:00
log("Function",
2010-11-06 10:33:26 +00:00
"Inotifies.add(",root,", ",path,", ",recurse,", ",sync,")")
2010-11-05 18:04:29 +00:00
-- registers watch
2010-11-09 19:15:41 +00:00
local wd = lsyncd.inotifyadd(root .. path);
2010-11-03 11:37:25 +00:00
if wd < 0 then
2010-11-05 18:04:29 +00:00
log("Error","Failure adding watch ",dir," -> ignored ")
2010-11-03 11:37:25 +00:00
return
end
2010-10-22 08:34:41 +00:00
2010-11-05 18:04:29 +00:00
if not wdlist[wd] then
wdlist[wd] = Array.new()
2010-11-03 11:37:25 +00:00
end
2010-11-05 18:04:29 +00:00
table.insert(wdlist[wd], {
root = root,
path = path,
2010-11-09 19:15:41 +00:00
recurse = recurse,
2010-11-06 10:33:26 +00:00
sync = sync
2010-11-05 18:04:29 +00:00
})
2010-11-09 19:15:41 +00:00
-- create an entry for receival of with sync/path keys
local sp = syncpaths[sync]
if not sp then
sp = {}
syncpaths[sync] = sp
end
sp[path] = wd
2010-11-03 11:37:25 +00:00
-- registers and adds watches for all subdirectories
if recurse then
2010-11-06 15:08:17 +00:00
local subdirs = lsyncd.subdirs(root .. path)
2010-11-03 11:37:25 +00:00
for _, dirname in ipairs(subdirs) do
2010-11-06 10:33:26 +00:00
add(root, path..dirname.."/", true, sync)
2010-11-03 11:37:25 +00:00
end
end
end
2010-10-25 14:55:40 +00:00
2010-11-09 19:15:41 +00:00
-----
-- Removes one event receiver from a directory.
--
2010-11-11 18:34:44 +00:00
local function removeSync(sync, path)
2010-11-09 19:15:41 +00:00
local sp = syncpaths[sync]
if not sp then
2010-11-11 15:17:22 +00:00
error("internal fail, removeSync, nonexisting sync: ")
2010-11-09 19:15:41 +00:00
end
local wd = sp[path]
if not wd then
2010-11-11 15:17:22 +00:00
error("internal fail, removeSync, nonexisting wd.")
2010-11-09 19:15:41 +00:00
end
local ilist = wdlist[wd]
if not ilist then
2010-11-11 15:17:22 +00:00
error("internal fail, removeSync, nonexisting ilist.")
2010-11-09 19:15:41 +00:00
end
-- TODO optimize for 1 entry only case
local i, found
for i, v in ipairs(ilist) do
if v.sync == sync then
found = true
break
end
end
if not found then
2010-11-11 15:17:22 +00:00
error("internal fail, removeSync, nonexisiting i.")
2010-11-09 19:15:41 +00:00
end
table.remove(ilist, i)
if #ilist == 0 then
wdlist[wd] = nil
lsyncd.inotifyrm(wd)
end
sp[path] = nil
end
2010-11-03 11:37:25 +00:00
-----
-- Called when an event has occured.
--
2010-11-07 09:53:39 +00:00
-- @param etype "Attrib", "Mofify", "Create", "Delete", "Move")
2010-11-10 22:03:02 +00:00
-- @param wd watch descriptor (matches lsyncd.inotifyadd())
2010-11-03 11:37:25 +00:00
-- @param isdir true if filename is a directory
-- @param time time of event
-- @param filename string filename without path
-- @param filename2
--
2010-11-11 18:34:44 +00:00
local function event(etype, wd, isdir, time, filename, filename2)
2010-11-03 11:37:25 +00:00
local ftype;
if isdir then
ftype = "directory"
2010-11-05 13:34:02 +00:00
filename = filename .. "/"
if filename2 then
filename2 = filename2 .. "/"
end
2010-11-03 11:37:25 +00:00
end
if filename2 then
2010-11-07 09:53:39 +00:00
log("Inotify", "got event ", etype, " ", filename,
2010-11-03 11:37:25 +00:00
" to ", filename2)
else
2010-11-07 09:53:39 +00:00
log("Inotify", "got event ", etype, " ", filename)
2010-11-03 11:37:25 +00:00
end
2010-10-22 08:34:41 +00:00
2010-11-03 11:37:25 +00:00
local ilist = wdlist[wd]
-- looks up the watch descriptor id
if not ilist then
-- this is normal in case of deleted subdirs
2010-11-05 13:34:02 +00:00
log("Inotify", "event belongs to unknown watch descriptor.")
2010-11-03 11:37:25 +00:00
return
end
-- works through all observers interested in this directory
for _, inotify in ipairs(ilist) do
2010-11-06 17:40:12 +00:00
local path = inotify.path .. filename
local path2
2010-11-03 11:37:25 +00:00
if filename2 then
2010-11-09 19:15:41 +00:00
path2 = inotify.path .. filename2
2010-11-03 11:37:25 +00:00
end
2010-11-07 09:53:39 +00:00
inotify.sync:delay(etype, time, path, path2)
2010-11-04 13:43:57 +00:00
-- adds subdirs for new directories
2010-11-10 11:23:26 +00:00
if isdir and inotify.recurse then
if etype == "Create" then
2010-11-06 17:40:12 +00:00
add(inotify.root, path, true, inotify.sync)
2010-11-07 09:53:39 +00:00
elseif etype == "Delete" then
2010-11-09 19:15:41 +00:00
removeSync(inotify.sync, path)
2010-11-10 11:23:26 +00:00
elseif etype == "Move" then
2010-11-11 15:17:22 +00:00
removeSync(inotify.sync, path)
2010-11-10 11:23:26 +00:00
add(inotify.root, path2, true, inotify.sync)
2010-11-03 11:37:25 +00:00
end
end
end
2010-10-17 15:24:55 +00:00
end
2010-11-03 11:37:25 +00:00
-----
-- Writes a status report about inotifies to a filedescriptor
--
2010-11-10 12:59:51 +00:00
local function statusReport(f)
2010-11-05 18:04:29 +00:00
f:write("Watching ",wdlist:size()," directories\n")
2010-11-09 19:15:41 +00:00
for wd, v in wdlist:walk() do
2010-11-05 18:04:29 +00:00
f:write(" ",wd,": ")
local sep = ""
2010-11-03 11:37:25 +00:00
for _, v in ipairs(v) do
2010-11-05 18:04:29 +00:00
f:write(v.root,"/",v.path or "",sep)
sep = ", "
2010-11-03 11:37:25 +00:00
end
2010-11-05 18:04:29 +00:00
f:write("\n")
2010-11-03 11:37:25 +00:00
end
2010-10-17 15:24:55 +00:00
end
2010-10-22 12:58:57 +00:00
2010-11-03 11:37:25 +00:00
-----
-- Returns the number of directories watched in total.
local function size()
return wdlist:size()
2010-10-22 12:58:57 +00:00
end
2010-10-16 18:21:01 +00:00
2010-11-03 11:37:25 +00:00
-- public interface
2010-11-04 13:43:57 +00:00
return {
add = add,
size = size,
event = event,
2010-11-10 12:59:51 +00:00
statusReport = statusReport
2010-11-04 13:43:57 +00:00
}
2010-11-03 11:37:25 +00:00
end)()
2010-11-13 13:13:51 +00:00
------
-- Writes functions for the user for layer 3 configuration.
--
local functionWriter = (function()
2010-11-13 13:44:51 +00:00
-----
2010-11-13 13:13:51 +00:00
-- all variables for layer 3
transVars = {
{ "%^pathname", "event.pathname" , 1, },
{ "%^path", "event.path" , 1, },
{ "%^sourcePathname", "event.sourcePathname" , 1, },
{ "%^sourcePath", "event.sourcePath" , 1, },
{ "%^source", "event.source" , 1, },
{ "%^targetPathname", "event.targetPathname" , 1, },
{ "%^targetPath", "event.targetPath" , 1, },
{ "%^target", "event.target" , 1, },
{ "%^o%.pathname", "event.pathname" , 1, },
{ "%^o%.path", "event.path" , 1, },
{ "%^o%.sourcePathname", "event.sourcePathname" , 1, },
{ "%^o%.sourcePath", "event.sourcePath" , 1, },
{ "%^o%.targetPathname", "event.targetPathname" , 1, },
{ "%^o%.targetPath", "event.targetPath" , 1, },
{ "%^d%.pathname", "event2.pathname" , 2, },
{ "%^d%.path", "event2.path" , 2, },
{ "%^d%.sourcePathname", "event2.sourcePathname" , 2, },
{ "%^d%.sourcePath", "event2.sourcePath" , 2, },
{ "%^d%.targetPathname", "event2.targetPathname" , 2, },
{ "%^d%.targetPath", "event2.targetPath" , 2, },
}
-----
-- Splits a user string into its arguments
--
-- @param a string where parameters are seperated by spaces.
--
-- @return a table of arguments
--
local function splitStr(str)
local args = {}
while str ~= "" do
-- break where argument stops
local bp = #str
-- in a quote
local inQuote = false
-- tests characters to be space and not within quotes
for i=1,#str do
local c = string.sub(str, i, i)
if c == '"' then
inQuote = not inQuote
elseif c == ' ' and not inQuote then
bp = i - 1
break
end
end
local arg = string.sub(str, 1, bp)
arg = string.gsub(arg, '"', '\\"')
table.insert(args, arg)
str = string.sub(str, bp + 1, -1)
str = string.match(str, "^%s*(.-)%s*$")
end
return args
end
-----
-- Translates a call to a binary to a lua function.
--
-- TODO this has a little too much coding blocks.
--
2010-11-13 13:44:51 +00:00
local function translateBinary(str)
2010-11-13 13:13:51 +00:00
-- splits the string
local args = splitStr(str)
-- true if there is a second event
local haveEvent2 = false
for ia, iv in ipairs(args) do
-- a list of arguments this arg is split to
local a = {{true, iv}}
-- goes through all translates
for _, v in ipairs(transVars) do
ai = 1
while ai <= #a do
if a[ai][1] then
local pre, post =
string.match(a[ai][2], "(.*)"..v[1].."(.*)")
if pre then
if pre ~= "" then
table.insert(a, ai, {true, pre})
ai = ai + 1
end
a[ai] = {false, v[2]}
if post ~= "" then
table.insert(a, ai + 1, {true, post})
end
end
end
ai = ai + 1
end
end
local as = ""
local first = true
for _, v in ipairs(a) do
if not first then
as = as .. " .. "
end
if v[1] then
as = as .. '"' .. v[2] .. '"'
else
as = as .. v[2]
end
first = false
end
args[ia] = as
end
local ft
if not haveEvent2 then
ft = "function(event)\n"
else
ft = "function(event, event2)\n"
end
ft = ft .. ' log("Normal", "Event " .. event.etype ..\n'
ft = ft .. " [[ spawns action '" .. str .. '\']])\n'
ft = ft .. " spawn(event"
for _, v in ipairs(args) do
ft = ft .. ",\n " .. v
end
ft = ft .. ")\nend"
return ft
end
-----
-- Translates a call using a shell to a lua function
--
2010-11-13 13:44:51 +00:00
local function translateShell(str)
2010-11-13 13:13:51 +00:00
local argn = 1
local args = {}
local cmd = str
2010-11-13 13:44:51 +00:00
local lc = str
2010-11-13 13:13:51 +00:00
-- true if there is a second event
local haveEvent2 = false
for _, v in ipairs(transVars) do
local occur = false
cmd = string.gsub(cmd, v[1],
2010-11-13 13:44:51 +00:00
function()
occur = true
return '"$'..argn..'"'
end)
lc = string.gsub(lc, v[1], ']]..'..v[2]..'..[[')
2010-11-13 13:13:51 +00:00
if occur then
argn = argn + 1
table.insert(args, v[2])
if v[3] > 1 then
haveEvent2 = true
end
end
end
local ft
if not haveEvent2 then
ft = "function(event)\n"
else
ft = "function(event, event2)\n"
end
ft = ft .. ' log("Normal", "Event " .. event.etype ..\n'
2010-11-13 13:44:51 +00:00
ft = ft .. " [[ spawns shell '" .. lc .. '\']])\n'
2010-11-13 13:13:51 +00:00
ft = ft .. " spawnShell(event, [[" .. cmd .. "]]"
for _, v in ipairs(args) do
ft = ft .. ",\n " .. v
end
ft = ft .. ")\nend"
return ft
end
-----
-- writes a lua function for a layer 3 user script.
2010-11-13 13:44:51 +00:00
local function translate(str)
2010-11-13 13:13:51 +00:00
-- trim spaces
str = string.match(str, "^%s*(.-)%s*$")
local ft
if string.byte(str, 1, 1) == 47 then
ft = translateBinary(str)
else
ft = translateShell(str)
end
2010-11-13 13:44:51 +00:00
log("FWrite","translated [[",str,"]] to \n",ft)
2010-11-13 13:13:51 +00:00
return ft
end
-----
-- public interface
--
return {translate = translate}
2010-11-13 13:44:51 +00:00
end)()
2010-11-13 13:13:51 +00:00
2010-10-28 17:56:33 +00:00
----
2010-11-06 10:10:57 +00:00
-- Writes a status report file at most every [statusintervall] seconds.
2010-10-28 17:56:33 +00:00
--
2010-11-06 10:10:57 +00:00
--
local StatusFile = (function()
-----
-- Timestamp when the status file has been written.
local lastWritten = false
-----
2010-11-12 11:04:45 +00:00
-- Timestamp when a status file should be written
2010-11-06 10:10:57 +00:00
local alarm = false
-----
2010-11-12 11:04:45 +00:00
-- Returns when the status file should be written
2010-11-06 10:10:57 +00:00
--
local function getAlarm()
return alarm
end
-----
-- Called to check if to write a status file.
--
local function write(now)
log("Function", "write(", now, ")")
-- some logic to not write too often
if settings.statusIntervall > 0 then
-- already waiting
2010-11-06 17:40:12 +00:00
if alarm and lsyncd.clockbefore(now, alarm) then
2010-11-06 10:33:26 +00:00
log("Statusfile", "waiting(",now," < ",alarm,")")
2010-11-06 10:10:57 +00:00
return
end
2010-11-06 10:33:26 +00:00
-- determines when a next write will be possible
2010-11-06 10:10:57 +00:00
if not alarm then
local nextWrite = lastWritten and
2010-11-06 15:08:17 +00:00
lsyncd.addtoclock(now, settings.statusIntervall)
2010-11-06 17:40:12 +00:00
if nextWrite and lsyncd.clockbefore(now, nextWrite) then
2010-11-06 10:33:26 +00:00
log("Statusfile", "setting alarm: ", nextWrite)
2010-11-06 10:10:57 +00:00
alarm = nextWrite
return
end
end
lastWritten = now
alarm = false
end
log("Statusfile", "writing now")
2010-11-12 11:04:45 +00:00
local f, err = io.open(settings.statusFile, "w")
2010-11-06 10:10:57 +00:00
if not f then
2010-11-12 11:04:45 +00:00
log("Error", "Cannot open status file '"..settings.statusFile..
2010-11-06 10:10:57 +00:00
"' :"..err)
return
end
f:write("Lsyncd status report at ", os.date(), "\n\n")
2010-11-12 10:07:58 +00:00
for i, s in Syncs.iwalk() do
s:statusReport(f)
f:write("\n")
end
2010-11-10 12:59:51 +00:00
Inotifies.statusReport(f)
2010-11-06 10:10:57 +00:00
f:close()
2010-11-05 18:04:29 +00:00
end
2010-11-06 10:10:57 +00:00
-- public interface
return {write = write, getAlarm = getAlarm}
end)()
2010-10-28 17:56:33 +00:00
2010-11-10 15:57:37 +00:00
--============================================================================
-- lsyncd runner plugs. These functions will be called from core.
--============================================================================
-----
2010-11-11 19:52:20 +00:00
-- Current status of lsyncd.
2010-11-10 15:57:37 +00:00
--
2010-11-11 19:52:20 +00:00
-- "init" ... on (re)init
-- "run" ... normal operation
-- "fade" ... waits for remaining processes
--
local lsyncdStatus = "init"
2010-11-10 15:57:37 +00:00
----
-- the cores interface to the runner
local runner = {}
-----
-- Called from core whenever lua code failed.
-- Logs a backtrace
--
function runner.callError(message)
log("Error", "IN LUA: ", message)
-- prints backtrace
local level = 2
while true do
local info = debug.getinfo(level, "Sl")
if not info then
terminate(-1) -- ERRNO
end
log("Error", "Backtrace ", level - 1, " :",
info.short_src, ":", info.currentline)
level = level + 1
end
end
-----
-- Called from code whenever a child process finished and
-- zombie process was collected by core.
--
2010-11-10 22:03:02 +00:00
function runner.collectProcess(pid, exitcode)
2010-11-10 15:57:37 +00:00
for _, s in Syncs.iwalk() do
if s:collect(pid, exitcode) then
return
end
end
end
2010-10-22 23:14:11 +00:00
----
2010-11-05 18:04:29 +00:00
-- Called from core everytime a masterloop cycle runs through.
-- This happens in case of
-- * an expired alarm.
-- * a returned child process.
-- * received inotify events.
-- * received a HUP or TERM signal.
2010-10-23 12:36:55 +00:00
--
2010-11-05 18:04:29 +00:00
-- @param now the current kernel time (in jiffies)
2010-10-23 12:36:55 +00:00
--
2010-11-10 15:57:37 +00:00
function runner.cycle(now)
2010-11-08 12:14:10 +00:00
-- goes through all syncs and spawns more actions
2010-10-24 13:52:28 +00:00
-- if possible
2010-11-08 12:14:10 +00:00
for _, s in Syncs.iwalk() do
s:invokeActions(now)
end
2010-11-12 11:04:45 +00:00
if settings.statusFile then
2010-11-06 10:10:57 +00:00
StatusFile.write(now)
2010-11-05 18:04:29 +00:00
end
2010-10-22 23:14:11 +00:00
end
2010-10-27 09:06:13 +00:00
-----
-- Called by core before anything is "-help" or "--help" is in
-- the arguments.
--
2010-11-10 15:57:37 +00:00
function runner.help()
2010-10-27 19:34:56 +00:00
io.stdout:write(
2010-11-04 13:43:57 +00:00
[[
USAGE:
run a config file:
lsyncd [OPTIONS] [CONFIG-FILE]
default rsync behaviour:
lsyncd [OPTIONS] -rsync [SOURCE] [TARGET1] [TARGET2] ...
OPTIONS:
-help Shows this
-log all Logs everything
-log scarce Logs errors only
2010-11-04 14:23:34 +00:00
-log [Category] Turns on logging for a debug category
-runner FILE Loads lsyncds lua part from FILE
2010-11-04 13:43:57 +00:00
LICENSE:
GPLv2 or any later version.
SEE:
`man lsyncd` for further information.
2010-10-27 09:06:13 +00:00
]])
os.exit(-1) -- ERRNO
end
2010-11-03 21:02:14 +00:00
-----
-- Called from core to parse the command line arguments
-- @returns a string as user script to load.
-- or simply 'true' if running with rsync bevaiour
-- terminates on invalid arguments
--
2010-11-10 15:57:37 +00:00
function runner.configure(args)
2010-11-03 21:02:14 +00:00
-- a list of all valid --options
local options = {
-- log is handled by core already.
log = {1},
}
-- filled with all args that were non --options
local nonopts = {}
local i = 1
while i <= #args do
local a = args[i]
if a:sub(1, 1) ~= "-" then
table.insert(nonopts, args[i])
else
if a:sub(1, 2) == "--" then
a = a:sub(3)
else
a = a:sub(2)
end
local o = options[a]
2010-11-06 10:10:00 +00:00
if o then
2010-11-03 21:02:14 +00:00
-- TODO --
i = i + o[1]
2010-11-13 08:55:44 +00:00
else
2010-11-13 13:13:51 +00:00
log("Error","unknown option command line option ", args[i])
2010-11-13 08:55:44 +00:00
os.exit(-1) -- ERRNO
2010-11-03 21:02:14 +00:00
end
end
i = i + 1
end
if #nonopts == 0 then
2010-11-10 22:03:02 +00:00
runner.help(args[0])
2010-11-03 21:02:14 +00:00
elseif #nonopts == 1 then
return nonopts[1]
else
2010-11-13 08:55:44 +00:00
log("Error", "There can only be one config file in command line.")
os.exit(-1) -- ERRNO
2010-11-03 21:02:14 +00:00
end
end
2010-10-17 15:24:55 +00:00
----
-- Called from core on init or restart after user configuration.
--
2010-11-10 15:57:37 +00:00
function runner.initialize()
2010-10-27 19:34:56 +00:00
-- creates settings if user didnt
settings = settings or {}
2010-10-25 14:55:40 +00:00
-- From this point on, no globals may be created anymore
2010-11-06 18:26:59 +00:00
lockGlobals()
2010-10-25 14:55:40 +00:00
2010-11-10 12:59:51 +00:00
-----
-- transfers some defaults to settings
-- TODO: loop
2010-11-06 10:33:26 +00:00
if settings.statusIntervall == nil then
settings.statusIntervall = default.statusIntervall
2010-10-27 09:06:13 +00:00
end
2010-10-25 21:41:45 +00:00
2010-10-21 12:37:27 +00:00
-- makes sure the user gave lsyncd anything to do
2010-11-06 10:10:00 +00:00
if Syncs.size() == 0 then
2010-11-02 21:04:01 +00:00
log("Error", "Nothing to watch!")
log("Error", "Use sync(SOURCE, TARGET, BEHAVIOR) in your config file.");
2010-10-27 19:34:56 +00:00
terminate(-1) -- ERRNO
2010-10-21 12:37:27 +00:00
end
2010-11-03 11:37:25 +00:00
-- from now on use logging as configured instead of stdout/err.
2010-11-11 19:52:20 +00:00
lsyncdStatus = "run";
2010-11-01 18:08:03 +00:00
lsyncd.configure("running");
2010-11-13 13:44:51 +00:00
local ufuncs = {
"onAttrib", "onCreate", "onDelete",
"onModify", "onMove", "onStartup"
}
-- translates layer 3 scripts
for _, s in Syncs.iwalk() do
-- checks if any user functions is a layer 3 string.
local config = s.config
for _, fn in ipairs(ufuncs) do
if type(config[fn]) == 'string' then
local ft = functionWriter.translate(config[fn])
config[fn] = assert(loadstring("return " .. ft))()
end
end
end
2010-11-07 09:53:39 +00:00
-- runs through the syncs table filled by user calling directory()
for _, s in Syncs.iwalk() do
Inotifies.add(s.source, "", true, s)
if s.config.init then
2010-11-10 09:49:44 +00:00
InletControl.setSync(s)
2010-11-07 09:53:39 +00:00
s.config.init(Inlet)
2010-10-22 10:35:26 +00:00
end
end
2010-10-17 15:24:55 +00:00
end
2010-10-19 10:12:11 +00:00
----
2010-10-21 12:37:27 +00:00
-- Called by core to query soonest alarm.
2010-10-19 10:12:11 +00:00
--
2010-11-05 18:20:33 +00:00
-- @return false ... no alarm, core can in untimed sleep, or
2010-11-08 12:14:10 +00:00
-- true ... immediate action
2010-11-05 18:20:33 +00:00
-- times ... the alarm time (only read if number is 1)
--
2010-11-10 22:03:02 +00:00
function runner.getAlarm()
2010-11-05 18:20:33 +00:00
local alarm = false
2010-11-06 21:29:22 +00:00
----
-- checks if current nearest alarm or a is earlier
--
local function checkAlarm(a)
2010-11-08 12:14:10 +00:00
if alarm == true or not a then
-- already immediate or no new alarm
2010-11-06 21:29:22 +00:00
return
end
if not alarm then
alarm = a
else
alarm = lsyncd.earlier(alarm, a)
2010-10-24 16:41:58 +00:00
end
end
2010-11-06 21:29:22 +00:00
-- checks all syncs for their earliest alarm
for _, s in Syncs.iwalk() do
checkAlarm(s:getAlarm())
2010-11-06 10:10:57 +00:00
end
2010-11-06 21:29:22 +00:00
-- checks if a statusfile write has been delayed
checkAlarm(StatusFile.getAlarm())
2010-11-06 10:10:57 +00:00
2010-11-10 22:03:02 +00:00
log("Debug", "getAlarm returns: ",alarm)
2010-11-05 18:20:33 +00:00
return alarm
2010-10-19 10:12:11 +00:00
end
2010-10-17 15:24:55 +00:00
2010-11-10 15:57:37 +00:00
-----
-- Called when an inotify event arrived.
-- Simply forwards it directly to the object.
2010-11-10 22:03:02 +00:00
runner.inotifyEvent = Inotifies.event
2010-10-21 12:37:27 +00:00
-----
2010-10-24 13:52:28 +00:00
-- Collector for every child process that finished in startup phase
2010-10-21 12:37:27 +00:00
--
-- Parameters are pid and exitcode of child process
--
-- Can return either a new pid if one other child process
-- has been spawned as replacement (e.g. retry) or 0 if
-- finished/ok.
--
2010-11-10 15:57:37 +00:00
function runner.collector(pid, exitcode)
2010-10-21 12:37:27 +00:00
if exitcode ~= 0 then
2010-11-02 21:04:01 +00:00
log("Error", "Startup process", pid, " failed")
2010-10-27 19:34:56 +00:00
terminate(-1) -- ERRNO
2010-10-20 13:01:26 +00:00
end
2010-10-21 12:37:27 +00:00
return 0
2010-10-20 10:25:34 +00:00
end
2010-11-10 15:57:37 +00:00
----
-- Called by core when an overflow happened.
--
function runner.overflow()
log("Error", "--- OVERFLOW on inotify event queue ---")
terminate(-1) -- TODO reset instead.
end
2010-10-21 12:37:27 +00:00
2010-10-25 17:38:57 +00:00
--============================================================================
2010-10-17 15:24:55 +00:00
-- lsyncd user interface
2010-10-25 17:38:57 +00:00
--============================================================================
2010-10-17 15:24:55 +00:00
2010-11-05 15:18:01 +00:00
-----
-- Main utility to create new observations.
--
function sync(opts)
2010-11-11 19:52:20 +00:00
if lsyncdStatus ~= "init" then
error("Sync can only be created on initialization.", 2)
2010-11-05 15:18:01 +00:00
end
2010-11-06 10:10:00 +00:00
Syncs.add(opts)
2010-11-05 15:18:01 +00:00
end
2010-10-17 15:24:55 +00:00
2010-10-19 16:40:49 +00:00
2010-10-27 11:31:18 +00:00
-----
2010-11-07 01:06:08 +00:00
-- Spawn a new child process
2010-10-27 11:31:18 +00:00
--
2010-11-07 01:06:08 +00:00
-- @param agent the reason why a process is spawned.
-- normally this is a delay/event of a sync.
-- it will mark the related files as blocked.
-- or it is a string saying "all", that this
-- process blocks all events and is blocked by all
-- this is used on startup.
-- @param collect a table of exitvalues and the action that shall taken.
2010-11-07 09:53:39 +00:00
-- @param binary binary to call
-- @param ... arguments
2010-11-07 01:06:08 +00:00
--
2010-11-11 09:36:56 +00:00
function spawn(agent, binary, ...)
2010-11-12 15:39:43 +00:00
if agent == nil or type(agent) ~= "table" then
error("spawning with an invalid agent", 2)
2010-11-11 15:17:22 +00:00
end
2010-11-07 09:53:39 +00:00
local pid = lsyncd.exec(binary, ...)
2010-11-07 01:06:08 +00:00
if pid and pid > 0 then
2010-11-12 18:52:43 +00:00
local sync = InletControl.getSync()
local delay = InletControl.getDelay(agent)
if delay then
delay.status = "active"
sync.processes[pid] = delay
else
local dlist = InletControl.getDelayList(agent)
if not dlist then
error("spawning with an unknown agent", 2)
end
for k, d in pairs(dlist) do
if type(k) == "number" then
d.status = "active"
end
end
sync.processes[pid] = dlist
end
2010-11-07 01:06:08 +00:00
end
2010-11-05 13:34:02 +00:00
end
2010-11-07 01:06:08 +00:00
-----
-- Spawns a child process using bash.
--
2010-11-11 09:36:56 +00:00
function spawnShell(agent, command, ...)
return spawn(agent, "/bin/sh", "-c", command, "/bin/sh", ...)
2010-10-27 11:31:18 +00:00
end
2010-11-10 11:23:26 +00:00
-----
-- Comfort routine also for user.
-- Returns true if 'String' starts with 'Start'
--
function string.starts(String,Start)
return string.sub(String,1,string.len(Start))==Start
end
-----
-- Comfort routine also for user.
-- Returns true if 'String' ends with 'End'
--
function string.ends(String,End)
return End=='' or string.sub(String,-string.len(End))==End
end
2010-10-26 11:26:57 +00:00
--============================================================================
-- lsyncd default settings
--============================================================================
2010-10-27 19:34:56 +00:00
-----
-- lsyncd classic - sync with rsync
--
2010-11-13 18:04:37 +00:00
local default_rsync = {
2010-11-06 16:54:45 +00:00
-----
2010-11-12 20:43:27 +00:00
-- Spawns rsync for a list of events
2010-11-12 18:52:43 +00:00
--
action = function(inlet)
local elist = inlet.getEvents()
2010-11-12 20:43:27 +00:00
local config = inlet.getConfig()
2010-11-13 18:04:37 +00:00
local paths = elist.getPaths()
log("Normal", "rsyncing list\n", paths)
2010-11-12 20:43:27 +00:00
spawn(elist, "/usr/bin/rsync",
2010-11-13 18:04:37 +00:00
"<", paths,
2010-11-12 20:43:27 +00:00
"--delete",
2010-11-13 18:04:37 +00:00
config.rsyncOps .. "d",
2010-11-12 20:43:27 +00:00
"--include-from=-",
2010-11-13 18:04:37 +00:00
"--exclude=*",
2010-11-12 20:43:27 +00:00
config.source, config.target)
2010-10-27 19:34:56 +00:00
end,
2010-11-12 20:43:27 +00:00
-----
-- Spawns the recursive startup sync
--
init = function(inlet)
local config = inlet.getConfig()
local event = inlet.createBlanketEvent()
if string.sub(config.target, -1) ~= "/" then
config.target = config.target .. "/"
end
log("Normal", "recursive startup rsync: ", config.source,
" -> ", config.target)
spawn(event, "/usr/bin/rsync",
"--delete",
2010-11-13 18:04:37 +00:00
config.rsyncOps .. "r",
2010-11-12 20:43:27 +00:00
config.source,
config.target)
end,
-----
-- Calls rsync with this options
--
rsyncOps = "-lts",
2010-11-12 18:52:43 +00:00
-----
-- Default delay 3 seconds
2010-11-12 20:43:27 +00:00
--
2010-11-13 18:04:37 +00:00
delay = 20,
}
-----
-- lsyncd classic - sync with rsync
--
local default_rssh = {
-----
-- Spawns rsync for a list of events
--
action = function(inlet)
local event = inlet.getEvent()
local config = inlet.getConfig()
if event.etype == 'Move' then
-- makes move local on host
spawn(event, "/usr/bin/ssh",
config.host, "mv",
config.targetdir .. event.path,
config.targetdir .. event.path2)
return
end
-- for everything else spawn a rsync
-- gets all events that are not Move
local elist = inlet.getEvents(function(e)
return e.etype ~= "Move"
end)
local spaths = elist.getPaths()
log("Normal", "rsyncing list\n", spaths)
spawn(elist, "/usr/bin/rsync",
"<", spaths,
config.rsyncOps .. "d",
"--delete",
"--include-from=-",
"--exclude=*",
config.source,
config.host .. ":" .. config.targetdir)
end,
-----
-- Spawns the recursive startup sync
--
init = function(inlet)
local config = inlet.getConfig()
local event = inlet.createBlanketEvent()
if string.sub(config.targetdir, -1) ~= "/" then
config.targetdir = config.targetdir .. "/"
end
log("Normal", "recursive startup rsync: ", config.source,
" -> ", config.host .. ":" .. config.targetdir)
spawn(event, "/usr/bin/rsync",
"--delete",
config.rsyncOps .. "r",
config.source,
config.host .. ":" .. config.targetdir)
end,
-----
-- Calls rsync with this options
--
rsyncOps = "-lts",
-----
-- allow several processes
--
maxProcesses = 10,
-----
-- Default delay 3 seconds
--
delay = 10,
2010-10-27 19:34:56 +00:00
}
-----
2010-11-02 20:18:05 +00:00
-- The default table for the user to access
-- TODO make readonly
--
default = {
2010-11-11 19:52:20 +00:00
2010-11-02 20:18:05 +00:00
-----
2010-11-11 19:52:20 +00:00
-- Default action calls user scripts on**** functions.
2010-11-02 20:18:05 +00:00
--
action = function(inlet)
2010-11-10 11:23:26 +00:00
-- in case of moves getEvent returns the origin and dest of the move
local event, event2 = inlet.getEvent()
2010-11-08 12:14:10 +00:00
local config = inlet.getConfig()
2010-11-05 15:18:01 +00:00
local func = config["on".. event.etype]
2010-11-02 20:18:05 +00:00
if func then
2010-11-10 11:23:26 +00:00
func(event, event2)
2010-11-02 20:18:05 +00:00
end
2010-11-12 11:04:45 +00:00
-- if function didnt change the wait status its not interested
-- in this event -> drop it.
if event.status == "wait" then
2010-11-12 20:55:22 +00:00
inlet.discardEvent(event)
2010-11-12 11:04:45 +00:00
end
2010-11-02 20:18:05 +00:00
end,
2010-11-10 09:49:44 +00:00
-----
2010-11-11 19:52:20 +00:00
-- Called to see if two events can be collapsed.
--
-- Default function uses the collapseTable.
--
2010-11-10 09:49:44 +00:00
-- @param event1 first event
-- @param event2 second event
2010-11-10 11:23:26 +00:00
-- @return -1 ... no interconnection
-- 0 ... drop both events.
-- 1 ... keep first event only
-- 2 ... keep second event only
-- 3 ... events block.
--
2010-11-10 09:49:44 +00:00
collapse = function(event1, event2, config)
2010-11-13 18:04:37 +00:00
print(event1.path, event2.path)
print(event1.etype, event1.move)
print(event2.etype, event2.move)
2010-11-10 11:23:26 +00:00
if event1.path == event2.path then
2010-11-12 09:45:22 +00:00
local e1 = event1.etype .. event1.move
local e2 = event2.etype .. event2.move
return config.collapseTable[e1][e2]
2010-11-10 11:23:26 +00:00
end
-----
-- Block events if one is a parent directory of another
--
2010-11-10 22:03:02 +00:00
if event1.isdir and string.starts(event2.path, event1.path) then
2010-11-10 11:23:26 +00:00
return 3
end
2010-11-10 22:03:02 +00:00
if event2.isdir and string.starts(event1.path, event2.path) then
2010-11-10 09:49:44 +00:00
return 3
end
2010-11-10 11:23:26 +00:00
return -1
2010-11-10 09:49:44 +00:00
end,
-----
2010-11-12 09:45:22 +00:00
-- Used by default collapse function.
-- Specifies how two event should be collapsed when here
-- horizontal event meets upon a vertical event.
-- values:
-- 0 ... nullification of both events.
-- 1 ... absorbtion of horizontal event.
-- 2 ... replace of vertical event.
-- 3 ... stack both events, vertical blocking horizonal.
-- 9 ... combines two move events.
2010-11-10 09:49:44 +00:00
--
collapseTable = {
2010-11-12 09:45:22 +00:00
Attrib = {Attrib=1, Modify=2, Create=2, Delete=2, MoveFr=3, MoveTo= 2},
Modify = {Attrib=1, Modify=1, Create=2, Delete=2, MoveFr=3, MoveTo= 2},
Create = {Attrib=1, Modify=1, Create=1, Delete=0, MoveFr=3, MoveTo= 2},
Delete = {Attrib=1, Modify=1, Create=3, Delete=1, MoveFr=3, MoveTo= 2},
MoveFr = {Attrib=3, Modify=3, Create=3, Delete=3, MoveFr=3, MoveTo= 3},
-- MoveTo = {Attrib=3, Modify=3, Create=2, Delete=2, MoveFr=9, MoveTo= 2}, TODO 9
MoveTo = {Attrib=3, Modify=3, Create=2, Delete=2, MoveFr=3, MoveTo= 2},
2010-11-10 09:49:44 +00:00
},
2010-11-11 09:36:56 +00:00
-----
-- Called when collecting a finished child process
--
2010-11-12 18:52:43 +00:00
collect = function(agent, exitcode)
if agent.isList then
log("Normal", "Finished a list = ",exitcode)
else
if agent.etype == "Blanket" then
if exitcode == 0 then
log("Normal", "Startup of '",agent.source,"' finished.")
else
log("Error", "Failure on startup of '",agent.source,"'.")
terminate(-1) -- ERRNO
end
return
2010-11-11 09:36:56 +00:00
end
2010-11-12 18:52:43 +00:00
log("Normal", "Finished ",agent.etype,
" on ",agent.sourcePath," = ",exitcode)
2010-11-11 09:36:56 +00:00
end
end,
-----
-- called on (re)initalizing of lsyncd.
--
init = function(inlet)
local config = inlet.getConfig()
2010-11-13 13:13:51 +00:00
-- user functions
-- calls a startup if given by user script.
2010-11-11 09:36:56 +00:00
if type(config.onStartup) == "function" then
local event = inlet.createBlanketEvent()
2010-11-11 15:17:22 +00:00
local startup = config.onStartup(event)
2010-11-11 19:52:20 +00:00
if event.status == "wait" then
2010-11-11 15:17:22 +00:00
-- user script did not spawn anything
-- thus the blanket event is deleted again.
2010-11-12 20:55:22 +00:00
inlet.discardEvent(event)
2010-11-11 15:17:22 +00:00
end
-- TODO honor some return codes of startup like "warmstart".
2010-11-11 09:36:56 +00:00
end
end,
2010-10-26 11:26:57 +00:00
-----
2010-11-11 15:17:22 +00:00
-- The maximum number of processes lsyncd will spawn simultanously for
-- one sync.
2010-10-26 11:26:57 +00:00
--
2010-11-06 10:10:57 +00:00
maxProcesses = 1,
2010-11-12 20:55:22 +00:00
-----
-- Try not to have more than these delays.
-- not too large, since total calculation for stacking
-- events is n*log(n) or so..
--
maxDelays = 1000,
2010-11-06 16:54:45 +00:00
-----
2010-11-10 09:49:44 +00:00
-- a default rsync configuration for easy usage.
2010-11-11 15:17:22 +00:00
--
2010-11-13 18:04:37 +00:00
rsync = default_rsync,
-----
-- a default rsync configuration with ssh'd move and rm actions
--
rssh = default_rssh,
2010-10-27 19:34:56 +00:00
2010-11-06 16:54:45 +00:00
-----
2010-11-10 09:49:44 +00:00
-- Minimum seconds between two writes of a status file.
2010-10-26 11:26:57 +00:00
--
2010-11-10 09:49:44 +00:00
statusIntervall = 10,
2010-10-26 11:26:57 +00:00
}
2010-11-11 15:17:22 +00:00
-----
-- Returns the core the runners function interface.
--
2010-11-10 15:57:37 +00:00
return runner